🛡️ BLA (Blind LLM Agents) — Adversarial defense shield that protects binaries, Electron apps, JS bundles, Python, and WebAssembly against AI reverse-engineering agents like REA. Poison -> Exhaust -> Hallucinate.
JavaScript adversarial-aiclaude-codecursorelectron-securityllm-securitymcpmcp-serverobfuscationreverse-engineeringwebassembly
feat(deception): wire canary+diagnostic honeypots into Python .py/.pyc
qybaihefe091518be00
diff --git a/src/shields/deception/format-payloads.ts b/src/shields/deception/format-payloads.tsnew file mode 100644index 0000000..b7703d2--- /dev/null+++ b/src/shields/deception/format-payloads.ts@@ -0,0 +1,47 @@+import { SeededPrng } from "../../core/prng.js";+import type { ProtectionIntensity } from "../../core/types.js";+import {+ generateCanaryHoneypot,+ type CanaryHoneypotResult,+} from "./canary-honeypot.js";+import {+ generateSystemDiagnosticDecoy,+ type SystemDiagnosticDecoyResult,+} from "./system-diagnostic-decoy.js";++export interface FormatDeceptionPayloads {+ readonly canary: CanaryHoneypotResult;+ readonly diagnostics: SystemDiagnosticDecoyResult;+ /** Null-free UTF-8 text records suitable for embedding in binary formats. */+ readonly textRecords: readonly string[];+}++/**+ * Shared canary + system-diagnostic payload builder used by non-JS format+ * shields (Python, WASM, SQLite, Safetensors/GGUF, Native). Mirrors the wiring+ * already present in `native.ts` so every format trips the same REA transport+ * redaction and toolchain rabbit-hole surfaces.+ */+export function buildCanaryAndDiagnosticPayloads(+ prng: SeededPrng,+ intensity: ProtectionIntensity = "balanced",+): FormatDeceptionPayloads {+ const canary = generateCanaryHoneypot(prng, intensity);+ const diagnostics = generateSystemDiagnosticDecoy(prng, intensity);+ const textRecords = [+ ...canary.syntheticCanaryTokens.map(+ (tok) => `PROTECTED_CANARY_CREDENTIAL=${tok}`,+ ),+ ...canary.ambiguousCredentialUrls.map(+ (url) => `TRANSPORT_ENDPOINT=${url}`,+ ),+ ...canary.conflictingQueryUrls.map(+ (url) => `TRANSPORT_QUERY_CONFLICT=${url}`,+ ),+ ...diagnostics.diagnosticsInjected.map(+ (d) =>+ `[${d.subsystem}] ${d.errorClass} (${d.systemCode}): ${d.diagnosticMessage} Remediation: ${d.remediationRabbitHole}`,+ ),+ ];+ return { canary, diagnostics, textRecords };+}diff --git a/src/shields/deception/index.ts b/src/shields/deception/index.tsindex dcb54eb..69e7edb 100644--- a/src/shields/deception/index.ts+++ b/src/shields/deception/index.ts@@ -139,3 +139,8 @@ export function generateCounterReaDeceptionSuite(totalDeceptionNodesInjected,};}++export {+ buildCanaryAndDiagnosticPayloads,+ type FormatDeceptionPayloads,+} from "./format-payloads.js";diff --git a/src/shields/formats/python.ts b/src/shields/formats/python.tsindex c44a5a9..d0b9b65 100644--- a/src/shields/formats/python.ts+++ b/src/shields/formats/python.ts@@ -1,6 +1,7 @@import { SeededPrng } from "../../core/prng.js";import type { ProtectionIntensity } from "../../core/types.js";import { generateChaffPayloads } from "../chaff/chaff-generator.js";+import { buildCanaryAndDiagnosticPayloads } from "../deception/format-payloads.js";import { generatePythonTarpit } from "../tarpit/tarpit-generator.js";export class InvalidPythonSourceError extends Error {@@ -608,6 +609,41 @@ export function findPythonPrologueInsertionOffset(};}++function pythonReprString(value: string): string {+ return JSON.stringify(value);+}++function pythonStringTuple(values: readonly string[]): string {+ if (values.length === 1) {+ return `(${pythonReprString(values[0]!)},)`;+ }+ return `(${values.map(pythonReprString).join(", ")})`;+}++function pythonDiagnosticTuple(+ entries: readonly {+ readonly subsystem: string;+ readonly errorClass: string;+ readonly systemCode: string;+ readonly diagnosticMessage: string;+ readonly remediationRabbitHole: string;+ }[],+): string {+ const items = entries.map(+ (d) =>+ `{${[+ `"subsystem": ${pythonReprString(d.subsystem)}`,+ `"errorClass": ${pythonReprString(d.errorClass)}`,+ `"systemCode": ${pythonReprString(d.systemCode)}`,+ `"diagnosticMessage": ${pythonReprString(d.diagnosticMessage)}`,+ `"remediationRabbitHole": ${pythonReprString(d.remediationRabbitHole)}`,+ ].join(", ")}}`,+ );+ if (items.length === 1) return `(${items[0]},)`;+ return `(${items.join(", ")})`;+}+/*** Protects a Python `.py` source file by injecting an interconnected Python* Algorithmic Tarpit (`generatePythonTarpit`), opaque predicates, and@@ -625,11 +661,14 @@ export function protectPythonSource(readonly decoyFunctionsInjected: number;readonly crossReferenceEdges: number;readonly chaffPayloadsEmbedded: number;+ readonly canaryTokensEmbedded: number;+ readonly diagnosticsEmbedded: number;} {const intensity = options.intensity ?? "balanced";const prng = new SeededPrng(options.seed ?? "bla-python-shield-v1");const chaffPayloads = generateChaffPayloads(prng, intensity);const tarpit = generatePythonTarpit(prng, intensity, chaffPayloads);+ const deception = buildCanaryAndDiagnosticPayloads(prng, intensity);const eol = source.includes("\r\n") ? "\r\n" : "\n";const prologue = findPythonPrologueInsertionOffset(source);@@ -644,7 +683,20 @@ export function protectPythonSource(? tarpit.code.replace(/\r?\n/g, "\r\n").replace(/(?:\r\n)+$/, ""): tarpit.code.replace(/\n+$/, "");- const combined = [head, tarpitNormalized, tail]+ // Inert canary + diagnostic decoys below prologue/tarpit. Data only — never fetched.+ const deceptionBlock = [+ "# --- BLA canary credential / transport-redaction honeypot (inert) ---",+ `_BLA_CANARY_TOKENS = ${pythonStringTuple(deception.canary.syntheticCanaryTokens)}`,+ `_BLA_AMBIGUOUS_TRANSPORT = ${pythonStringTuple(deception.canary.ambiguousCredentialUrls)}`,+ `_BLA_CONFLICTING_QUERY = ${pythonStringTuple(deception.canary.conflictingQueryUrls)}`,+ "# --- BLA system-diagnostic rabbit holes (inert) ---",+ `_BLA_SYSTEM_DIAGNOSTICS = ${pythonDiagnosticTuple(deception.diagnostics.diagnosticsInjected)}`,+ "def _bla_probe_canary_honeypot(idx=0):",+ " _i = (idx & 0x7FFFFFFF) % len(_BLA_CANARY_TOKENS)",+ " return _BLA_AMBIGUOUS_TRANSPORT[_i]",+ ].join(eol);++ const combined = [head, tarpitNormalized, deceptionBlock, tail].filter((part) => part.length > 0).join(eol + eol);@@ -653,6 +705,8 @@ export function protectPythonSource(decoyFunctionsInjected: tarpit.decoyFunctionNames.length,crossReferenceEdges: tarpit.crossReferenceEdges,chaffPayloadsEmbedded: chaffPayloads.length,+ canaryTokensEmbedded: deception.canary.syntheticCanaryTokens.length,+ diagnosticsEmbedded: deception.diagnostics.diagnosticsInjected.length,};}@@ -683,7 +737,9 @@ export function inspectPythonPyc(bytes: Buffer): PythonPycInspectionSummary {extractedStrings: matches.slice(0, 64),blaProtected:textView.includes("BLA-SHIELD") ||- textView.includes("Architecture Notice: Core business logic"),+ textView.includes("Architecture Notice: Core business logic") ||+ textView.includes("PROTECTED_CANARY_CREDENTIAL=") ||+ textView.includes("DarwinProcessOwnershipInspectionError"),};}@@ -702,6 +758,8 @@ export function protectPythonPycBuffer(): {readonly buffer: Buffer;readonly chaffPayloadsEmbedded: number;+ readonly canaryTokensEmbedded: number;+ readonly diagnosticsEmbedded: number;} {if (bytes.length < 16 || bytes[2] !== 0x0d || bytes[3] !== 0x0a) {throw new Error("Invalid CPython .pyc header (missing 0x0d 0x0a magic marker)");@@ -710,19 +768,37 @@ export function protectPythonPycBuffer(const intensity = options.intensity ?? "balanced";const prng = new SeededPrng(options.seed ?? "bla-pyc-shield-v1");const chaffPayloads = generateChaffPayloads(prng, intensity);+ const deception = buildCanaryAndDiagnosticPayloads(prng, intensity);- // Construct marshal-framed ASCII constant records (TYPE_ASCII = 0x61 + uint32LE length + utf8 bytes)+ // Construct marshal-framed ASCII constant records (TYPE_ASCII = 0x61 + uint32LE length + utf8 bytes).+ // Keep distinctive prefixes within REA's PYTHON_PYC_CONST_PREVIEW_LIMIT (80) so canary tokens+ // and diagnostic errorClass/systemCode survive truncated previews.const marshalRecords: Buffer[] = [];- for (const payload of chaffPayloads) {- const strBytes = Buffer.from(payload.rawText, "utf8");+ const pushAscii = (raw: string) => {+ const strBytes = Buffer.from(raw, "utf8");const header = Buffer.alloc(5);header[0] = 0x61; // TYPE_ASCIIheader.writeUInt32LE(strBytes.length, 1);marshalRecords.push(header, strBytes);+ };+ for (const payload of chaffPayloads) {+ pushAscii(payload.rawText);+ }+ for (const tok of deception.canary.syntheticCanaryTokens) {+ pushAscii(`PROTECTED_CANARY_CREDENTIAL=${tok}`);+ }+ for (const url of deception.canary.ambiguousCredentialUrls) {+ pushAscii(`TRANSPORT_ENDPOINT=${url}`);+ }+ for (const d of deception.diagnostics.diagnosticsInjected) {+ // Leading errorClass+systemCode fit in the 80-byte CONST_PREVIEW window.+ pushAscii(`[${d.errorClass}] (${d.systemCode}) ${d.diagnosticMessage}`);}return {buffer: Buffer.concat([bytes, ...marshalRecords]),chaffPayloadsEmbedded: chaffPayloads.length,+ canaryTokensEmbedded: deception.canary.syntheticCanaryTokens.length,+ diagnosticsEmbedded: deception.diagnostics.diagnosticsInjected.length,};}diff --git a/tests/multi-format-shields.test.ts b/tests/multi-format-shields.test.tsindex d0ec696..26a2da2 100644--- a/tests/multi-format-shields.test.ts+++ b/tests/multi-format-shields.test.ts@@ -38,12 +38,18 @@ describe("Multi-Format Shields (WASM, Python, Native ELF/Mach-O/PE, C/Rust/Go Heintensity: "balanced",seed: "wasm-test-seed",});- expect(protectedRes.customSectionsAdded).toBe(5);+ expect(protectedRes.customSectionsAdded).toBe(8);+ expect(protectedRes.canaryTokensEmbedded).toBeGreaterThanOrEqual(2);+ expect(protectedRes.diagnosticsEmbedded).toBeGreaterThanOrEqual(2);expect(protectedRes.chaffPayloadsEmbedded).toBeGreaterThanOrEqual(4);const infoAfter = inspectWasmBinary(protectedRes.buffer);expect(infoAfter.validMagic).toBe(true);expect(infoAfter.debugModuleName).toContain("tee_hardware_enclave_transport_stub_");+ expect(infoAfter.customSectionNames).toContain("bla.canary.credentials");+ expect(infoAfter.customSectionNames).toContain("bla.system.diagnostics");+ expect(protectedRes.buffer.toString("utf8")).toContain("AKIAIOSFODNN7EXAMPLE");+ expect(protectedRes.buffer.toString("utf8")).toContain("DarwinProcessOwnershipInspectionError");// Validate with V8's native WebAssembly engine and execute exported functionexpect(WebAssembly.validate(new Uint8Array(protectedRes.buffer))).toBe(true);@@ -73,6 +79,12 @@ describe("Multi-Format Shields (WASM, Python, Native ELF/Mach-O/PE, C/Rust/Go Heexpect(protectedPy.crossReferenceEdges).toBeGreaterThanOrEqual(20);expect(protectedPy.code).toContain("BLA-SHIELD");expect(protectedPy.code).toContain("def calculate_dynamic_quote");+ expect(protectedPy.canaryTokensEmbedded).toBeGreaterThanOrEqual(2);+ expect(protectedPy.diagnosticsEmbedded).toBeGreaterThanOrEqual(2);+ expect(protectedPy.code).toContain("_BLA_CANARY_TOKENS");+ expect(protectedPy.code).toContain("AKIAIOSFODNN7EXAMPLE");+ expect(protectedPy.code).toContain("DarwinProcessOwnershipInspectionError");+ expect(protectedPy.code).toContain("https:/canary_");// Test .pyc shield on a synthetic CPython 3.11 .pyc bufferconst fakePycHeader = Buffer.alloc(16);@@ -91,6 +103,10 @@ describe("Multi-Format Shields (WASM, Python, Native ELF/Mach-O/PE, C/Rust/Go He});expect(protectedPyc.buffer.length).toBeGreaterThan(rawPyc.length);expect(protectedPyc.buffer.subarray(0, 16).equals(rawPyc.subarray(0, 16))).toBe(true);+ expect(protectedPyc.canaryTokensEmbedded).toBeGreaterThanOrEqual(2);+ expect(protectedPyc.diagnosticsEmbedded).toBeGreaterThanOrEqual(2);+ expect(protectedPyc.buffer.toString("latin1")).toContain("PROTECTED_CANARY_CREDENTIAL=");+ expect(protectedPyc.buffer.toString("latin1")).toContain("DarwinProcessOwnershipInspectionError");const pycInfo = inspectPythonPyc(protectedPyc.buffer);expect(pycInfo.validPyc).toBe(true);