@e4779/pi-fabric 0.92.28-fork.5 → 0.92.41-fork.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -1
- package/dist/actors/types.d.ts +1 -1
- package/dist/actors/types.d.ts.map +1 -1
- package/dist/agents/completion-inbox.d.ts +15 -0
- package/dist/agents/completion-inbox.d.ts.map +1 -0
- package/dist/agents/handoff.d.ts.map +1 -1
- package/dist/agents/manager.d.ts +1 -0
- package/dist/agents/manager.d.ts.map +1 -1
- package/dist/agents/thinking-transfer.d.ts.map +1 -1
- package/dist/agents/transports/process-utils.d.ts.map +1 -1
- package/dist/agents.js +3 -3
- package/dist/build-identity.d.ts +21 -0
- package/dist/build-identity.d.ts.map +1 -0
- package/dist/chunks/{chunk-CIODQX77.js → chunk-2A2NWQ36.js} +3 -3
- package/dist/chunks/{chunk-OTCASLY2.js → chunk-2QAOC3BO.js} +1 -1
- package/dist/chunks/chunk-2QAOC3BO.js.map +7 -0
- package/dist/chunks/{chunk-BYOGRJME.js → chunk-2SWRVIYJ.js} +10 -7
- package/dist/chunks/chunk-2SWRVIYJ.js.map +7 -0
- package/dist/chunks/{chunk-ZHJNWM6A.js → chunk-36B4AIRT.js} +2 -2
- package/dist/chunks/{chunk-JOEFBOFN.js → chunk-3TXOQ5MG.js} +55 -45
- package/dist/chunks/chunk-3TXOQ5MG.js.map +7 -0
- package/dist/chunks/{chunk-G7UJLM33.js → chunk-4NUTVNS2.js} +40 -6
- package/dist/chunks/chunk-4NUTVNS2.js.map +7 -0
- package/dist/chunks/{chunk-X7G62ZGH.js → chunk-7BG5COXB.js} +8 -3
- package/dist/chunks/{chunk-X7G62ZGH.js.map → chunk-7BG5COXB.js.map} +2 -2
- package/dist/chunks/{chunk-IYQ5MNCW.js → chunk-7VAZ4N43.js} +42 -24
- package/dist/chunks/chunk-7VAZ4N43.js.map +7 -0
- package/dist/chunks/{chunk-KI277YNS.js → chunk-A4VP7HDF.js} +10 -2
- package/dist/chunks/chunk-A4VP7HDF.js.map +7 -0
- package/dist/chunks/chunk-B54Z662X.js +127 -0
- package/dist/chunks/chunk-B54Z662X.js.map +7 -0
- package/dist/chunks/{chunk-QLV2IZ3F.js → chunk-CGL7QP4A.js} +58 -7
- package/dist/chunks/chunk-CGL7QP4A.js.map +7 -0
- package/dist/chunks/{chunk-WG24VI7K.js → chunk-FLKGJPCN.js} +44 -2
- package/dist/chunks/chunk-FLKGJPCN.js.map +7 -0
- package/dist/chunks/{chunk-M7W57BRC.js → chunk-GGETIGM5.js} +487 -707
- package/dist/chunks/chunk-GGETIGM5.js.map +7 -0
- package/dist/chunks/{chunk-FAMBJFFF.js → chunk-IJL3QK3J.js} +3 -1
- package/dist/chunks/chunk-IJL3QK3J.js.map +7 -0
- package/dist/chunks/{chunk-RZKN534S.js → chunk-IK6PPFWG.js} +17 -6
- package/dist/chunks/chunk-IK6PPFWG.js.map +7 -0
- package/dist/chunks/{chunk-D6YSBP3R.js → chunk-IUCVOZRX.js} +3 -3
- package/dist/chunks/{chunk-ULLIZPBH.js → chunk-K6DHXXF5.js} +9 -7
- package/dist/chunks/chunk-K6DHXXF5.js.map +7 -0
- package/dist/chunks/{chunk-NPHCGLGH.js → chunk-MW5VI7IW.js} +135 -31
- package/dist/chunks/chunk-MW5VI7IW.js.map +7 -0
- package/dist/chunks/{chunk-RWDKJ24D.js → chunk-NHMICIEU.js} +2 -2
- package/dist/chunks/{chunk-M3ZNZ6EZ.js → chunk-PMSIZLV6.js} +2 -1
- package/dist/chunks/chunk-PMSIZLV6.js.map +7 -0
- package/dist/chunks/{chunk-RAEGNBRA.js → chunk-Q4XJ4PYL.js} +529 -168
- package/dist/chunks/chunk-Q4XJ4PYL.js.map +7 -0
- package/dist/chunks/{chunk-7TX532EG.js → chunk-RKRVOBVO.js} +2 -2
- package/dist/chunks/{chunk-M3S7XITB.js → chunk-TGAVMUOS.js} +29 -13
- package/dist/chunks/chunk-TGAVMUOS.js.map +7 -0
- package/dist/chunks/{chunk-JNMTTJMQ.js → chunk-TX6E5W7H.js} +1 -1
- package/dist/chunks/{chunk-JNMTTJMQ.js.map → chunk-TX6E5W7H.js.map} +1 -1
- package/dist/chunks/{chunk-X3OD47CL.js → chunk-UR2K6WK6.js} +8 -11
- package/dist/chunks/chunk-UR2K6WK6.js.map +7 -0
- package/dist/chunks/{chunk-Z63R5GVN.js → chunk-WHBJDTCR.js} +6 -2
- package/dist/chunks/chunk-WHBJDTCR.js.map +7 -0
- package/dist/chunks/{chunk-RRGTKHXZ.js → chunk-X7XFT57O.js} +9 -140
- package/dist/chunks/{chunk-RRGTKHXZ.js.map → chunk-X7XFT57O.js.map} +4 -4
- package/dist/chunks/chunk-YV2PHCDB.js +108 -0
- package/dist/chunks/chunk-YV2PHCDB.js.map +7 -0
- package/dist/chunks/chunk-Z64PRP7A.js +156 -0
- package/dist/chunks/chunk-Z64PRP7A.js.map +7 -0
- package/dist/components/configuration.js +5 -4
- package/dist/components/provider-component.d.ts +1 -1
- package/dist/components/provider-component.d.ts.map +1 -1
- package/dist/config.d.ts +10 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/core/action-registry.d.ts +8 -0
- package/dist/core/action-registry.d.ts.map +1 -1
- package/dist/core/action-registry.js +6 -4
- package/dist/core/approval-controller.d.ts +5 -1
- package/dist/core/approval-controller.d.ts.map +1 -1
- package/dist/core/auto-approval-classifier.d.ts +11 -0
- package/dist/core/auto-approval-classifier.d.ts.map +1 -1
- package/dist/core/compact-controller.d.ts.map +1 -1
- package/dist/core/fabric-state-paths.d.ts +2 -0
- package/dist/core/fabric-state-paths.d.ts.map +1 -0
- package/dist/core/media-sanitize.d.ts +3 -2
- package/dist/core/media-sanitize.d.ts.map +1 -1
- package/dist/core/model-resolution.d.ts +3 -2
- package/dist/core/model-resolution.d.ts.map +1 -1
- package/dist/core/semantic-search.d.ts +56 -0
- package/dist/core/semantic-search.d.ts.map +1 -0
- package/dist/core/shell-jobs.d.ts.map +1 -1
- package/dist/core/shell-middleware.d.ts +4 -0
- package/dist/core/shell-middleware.d.ts.map +1 -0
- package/dist/execution-service.d.ts.map +1 -1
- package/dist/fabric-exec-tool.d.ts.map +1 -1
- package/dist/fabric-runtime-state.d.ts +2 -0
- package/dist/fabric-runtime-state.d.ts.map +1 -1
- package/dist/fabric-runtime-state.js +1213 -208
- package/dist/fabric-runtime-state.js.map +4 -4
- package/dist/fabric-state.d.ts +2 -0
- package/dist/fabric-state.d.ts.map +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +226 -49
- package/dist/index.js.map +4 -4
- package/dist/jev/client.d.ts +8 -2
- package/dist/jev/client.d.ts.map +1 -1
- package/dist/jev/client.js +3 -2
- package/dist/jev/config.d.ts.map +1 -1
- package/dist/jev/model-key.d.ts +9 -2
- package/dist/jev/model-key.d.ts.map +1 -1
- package/dist/jev/observation.js +4 -4
- package/dist/jev/routes.d.ts +69 -0
- package/dist/jev/routes.d.ts.map +1 -0
- package/dist/jev/validation.d.ts.map +1 -1
- package/dist/jev.d.ts +1 -0
- package/dist/jev.d.ts.map +1 -1
- package/dist/jev.js +34 -9
- package/dist/mcp.d.ts.map +1 -1
- package/dist/mcp.js +9 -2
- package/dist/mcp.js.map +2 -2
- package/dist/prewalk/arm.d.ts.map +1 -1
- package/dist/prewalk/controller.d.ts +57 -6
- package/dist/prewalk/controller.d.ts.map +1 -1
- package/dist/prewalk/fs-drift.d.ts.map +1 -1
- package/dist/prewalk/handoff.d.ts +5 -25
- package/dist/prewalk/handoff.d.ts.map +1 -1
- package/dist/prewalk/messages.d.ts +24 -0
- package/dist/prewalk/messages.d.ts.map +1 -0
- package/dist/prewalk/model-switch.d.ts +3 -0
- package/dist/prewalk/model-switch.d.ts.map +1 -0
- package/dist/prewalk/plan.d.ts +46 -0
- package/dist/prewalk/plan.d.ts.map +1 -0
- package/dist/prewalk/return.d.ts +16 -0
- package/dist/prewalk/return.d.ts.map +1 -0
- package/dist/protocol.d.ts +10 -1
- package/dist/protocol.d.ts.map +1 -1
- package/dist/protocol.js +3 -1
- package/dist/providers/agents-actions.d.ts.map +1 -1
- package/dist/providers/agents-provider.d.ts.map +1 -1
- package/dist/providers/jev-provider.d.ts +2 -0
- package/dist/providers/jev-provider.d.ts.map +1 -1
- package/dist/providers/jev-provider.js +8 -8
- package/dist/providers/mcp-descriptor-cache.d.ts +2 -0
- package/dist/providers/mcp-descriptor-cache.d.ts.map +1 -1
- package/dist/providers/pi-tools-provider.d.ts.map +1 -1
- package/dist/providers/prewalk-provider.d.ts +19 -0
- package/dist/providers/prewalk-provider.d.ts.map +1 -0
- package/dist/repeat-guard.d.ts +4 -0
- package/dist/repeat-guard.d.ts.map +1 -1
- package/dist/residency/actor-client.js +2 -2
- package/dist/residency/client.d.ts +3 -0
- package/dist/residency/client.d.ts.map +1 -1
- package/dist/residency/host.d.ts.map +1 -1
- package/dist/residency/host.js +10 -9
- package/dist/residency/pi-entry.js +10 -9
- package/dist/residency/pi-entry.js.map +1 -1
- package/dist/residency/protocol.d.ts +4 -0
- package/dist/residency/protocol.d.ts.map +1 -1
- package/dist/runtime/core-override-guest-types.js +2 -2
- package/dist/runtime/cpython-runtime.d.ts +2 -0
- package/dist/runtime/cpython-runtime.d.ts.map +1 -1
- package/dist/runtime/cpython-runtime.js +7 -3
- package/dist/runtime/cpython-runtime.js.map +2 -2
- package/dist/runtime/guest-types.d.ts +1 -1
- package/dist/runtime/guest-types.d.ts.map +1 -1
- package/dist/runtime/guest-types.js +1 -1
- package/dist/runtime/monty-runtime.js +5 -4
- package/dist/runtime/monty-runtime.js.map +2 -2
- package/dist/runtime/node-process-runtime.js +3 -3
- package/dist/runtime/quickjs-runtime.d.ts.map +1 -1
- package/dist/runtime/quickjs-runtime.js +1 -1
- package/dist/runtime/typescript-kernel.js +5 -5
- package/dist/runtime-state-builtins.d.ts.map +1 -1
- package/dist/ui/code-preview-shell.d.ts.map +1 -1
- package/dist/ui/conversation-native-reader.d.ts.map +1 -1
- package/dist/ui/conversation-native-reader.js.map +2 -2
- package/dist/ui/dashboard.js +2 -2
- package/dist/ui/settings-section-context.d.ts +1 -0
- package/dist/ui/settings-section-context.d.ts.map +1 -1
- package/dist/ui/settings-sections-agents.d.ts.map +1 -1
- package/dist/ui/settings-sections-execution.d.ts +1 -1
- package/dist/ui/settings-sections-execution.d.ts.map +1 -1
- package/dist/ui/settings-sections.d.ts +1 -0
- package/dist/ui/settings-sections.d.ts.map +1 -1
- package/dist/ui/settings-values.d.ts +1 -0
- package/dist/ui/settings-values.d.ts.map +1 -1
- package/dist/ui/settings.d.ts.map +1 -1
- package/dist/ui/settings.js +57 -18
- package/dist/ui/settings.js.map +2 -2
- package/dist/ui/spinner.d.ts +8 -1
- package/dist/ui/spinner.d.ts.map +1 -1
- package/dist/worker.js +3 -13
- package/dist/worker.js.map +2 -2
- package/docs/agents.md +35 -11
- package/docs/configuration.md +18 -12
- package/docs/foreman.md +65 -0
- package/docs/jev.md +11 -3
- package/docs/programmatic-compaction.md +12 -7
- package/docs/shell-middleware.md +61 -0
- package/docs/skills.md +2 -1
- package/package.json +5 -4
- package/skillsets/python/fabric-exec/SKILL.md +1 -1
- package/skillsets/python/fabric-exec/references/agents.md +1 -1
- package/skillsets/python/fabric-exec/references/mcp.md +1 -1
- package/skillsets/python/fabric-foreman/SKILL.md +249 -0
- package/skillsets/python/fabric-guide/SKILL.md +2 -1
- package/skillsets/python/fabric-jev/SKILL.md +2 -2
- package/skillsets/typescript/fabric-exec/SKILL.md +4 -2
- package/skillsets/typescript/fabric-exec/references/agents.md +3 -3
- package/skillsets/typescript/fabric-foreman/SKILL.md +240 -0
- package/skillsets/typescript/fabric-guide/SKILL.md +2 -1
- package/skillsets/typescript/fabric-jev/SKILL.md +2 -2
- package/dist/chunks/chunk-2IAVP4O2.js +0 -447
- package/dist/chunks/chunk-2IAVP4O2.js.map +0 -7
- package/dist/chunks/chunk-BJOJX2UW.js +0 -59
- package/dist/chunks/chunk-BJOJX2UW.js.map +0 -7
- package/dist/chunks/chunk-BYOGRJME.js.map +0 -7
- package/dist/chunks/chunk-FAMBJFFF.js.map +0 -7
- package/dist/chunks/chunk-G7UJLM33.js.map +0 -7
- package/dist/chunks/chunk-IYQ5MNCW.js.map +0 -7
- package/dist/chunks/chunk-JOEFBOFN.js.map +0 -7
- package/dist/chunks/chunk-KI277YNS.js.map +0 -7
- package/dist/chunks/chunk-M3S7XITB.js.map +0 -7
- package/dist/chunks/chunk-M3ZNZ6EZ.js.map +0 -7
- package/dist/chunks/chunk-M7W57BRC.js.map +0 -7
- package/dist/chunks/chunk-NPHCGLGH.js.map +0 -7
- package/dist/chunks/chunk-OTCASLY2.js.map +0 -7
- package/dist/chunks/chunk-QLV2IZ3F.js.map +0 -7
- package/dist/chunks/chunk-RAEGNBRA.js.map +0 -7
- package/dist/chunks/chunk-RZKN534S.js.map +0 -7
- package/dist/chunks/chunk-ULLIZPBH.js.map +0 -7
- package/dist/chunks/chunk-WG24VI7K.js.map +0 -7
- package/dist/chunks/chunk-X3OD47CL.js.map +0 -7
- package/dist/chunks/chunk-Z63R5GVN.js.map +0 -7
- /package/dist/chunks/{chunk-CIODQX77.js.map → chunk-2A2NWQ36.js.map} +0 -0
- /package/dist/chunks/{chunk-ZHJNWM6A.js.map → chunk-36B4AIRT.js.map} +0 -0
- /package/dist/chunks/{chunk-D6YSBP3R.js.map → chunk-IUCVOZRX.js.map} +0 -0
- /package/dist/chunks/{chunk-RWDKJ24D.js.map → chunk-NHMICIEU.js.map} +0 -0
- /package/dist/chunks/{chunk-7TX532EG.js.map → chunk-RKRVOBVO.js.map} +0 -0
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"version": 3,
|
|
3
3
|
"sources": ["../../src/runtime/cpython-runtime.ts", "../../src/runtime/cpython-child-source.ts", "../../src/runtime/cpython-linux-sandbox.ts"],
|
|
4
|
-
"sourcesContent": ["import { spawn } from \"node:child_process\";\nimport { randomBytes } from \"node:crypto\";\nimport { constants } from \"node:fs\";\nimport { access, realpath } from \"node:fs/promises\";\nimport net from \"node:net\";\nimport path from \"node:path\";\nimport type { Duplex } from \"node:stream\";\nimport { StringDecoder } from \"node:string_decoder\";\nimport { runAbortable, settleWithin } from \"../async-settlement.js\";\nimport { piBashExitMetadata } from \"../core/pi-bash-error.js\";\nimport { isPiShellRef } from \"../core/pi-tools.js\";\nimport type { FabricHostCall, FabricKernelRuntime, FabricSandboxOptions, FabricSandboxResult } from \"./kernel.js\";\nimport { CPYTHON_CHILD_SOURCE } from \"./cpython-child-source.js\";\nimport { linuxCPythonNetworkFilter } from \"./cpython-linux-sandbox.js\";\n\nconst MAX_FRAME_BYTES = 16 * 1024 * 1024;\nconst HOST_SETTLE_MS = 250;\n// No blanket mach* allowance: Mach services can broker effects outside the\n// file/network policy. CPython's standard-library startup needs none here.\nconst MACOS_PROFILE = \"(version 1) (deny default) (allow process-exec) (allow process-fork) (allow file-read*) (allow sysctl-read)\";\n\nconst record = (value: unknown): value is Record<string, unknown> =>\n typeof value === \"object\" && value !== null && !Array.isArray(value);\nconst errorText = (error: unknown): string => error instanceof Error ? error.message : String(error);\n\nconst executable = async (binary: string, cwd: string): Promise<string> => {\n // Windows stores executables with PATHEXT suffixes (\"python3\" -> \"python3.exe\");\n // probe the variants spawn would find instead of failing on the bare name.\n const extensions = process.platform === \"win32\"\n ? String(process.env.PATHEXT ?? \".COM;.EXE;.BAT;.CMD\").split(\";\").filter(Boolean)\n : [];\n const variants = (candidate: string): string[] =>\n extensions.length && !/\\.[A-Za-z0-9]+$/.test(candidate)\n ? [candidate, ...extensions.map((extension) => candidate + extension)]\n : [candidate];\n const candidates = path.isAbsolute(binary) || binary.includes(\"/\") || binary.includes(\"\\\\\")\n ? [path.resolve(cwd, binary)]\n : (process.env.PATH ?? \"\").split(path.delimiter).map((directory) => path.resolve(cwd, directory || \".\", binary));\n for (const candidate of candidates) {\n for (const variant of variants(candidate)) {\n try {\n await access(variant, constants.X_OK);\n return await realpath(variant);\n } catch {\n // Continue only during executable discovery, never after a failed spawn.\n }\n }\n }\n throw new Error(`CPython executable not found: ${binary}. Install Python 3 or set executor.cpython.binary to a trusted executable's absolute path.`);\n};\n\nconst launch = async (binary: string, enforce: boolean, cwd: string): Promise<{ command: string; args: string[]; seccomp?: Buffer }> => {\n const python = await executable(binary, cwd);\n const args = [\"-I\", \"-B\", \"-u\", \"-c\", CPYTHON_CHILD_SOURCE];\n if (!enforce) return { command: python, args };\n if (process.platform === \"darwin\") {\n try { await access(\"/usr/bin/sandbox-exec\", constants.X_OK); }\n catch { throw new Error(\"Schema enforce CPython requires /usr/bin/sandbox-exec on macOS; no unsandboxed fallback is permitted.\"); }\n return { command: \"/usr/bin/sandbox-exec\", args: [\"-p\", MACOS_PROFILE, python, ...args] };\n }\n if (process.platform === \"linux\") {\n // Only system locations: a workspace/PATH shim must not masquerade as the\n // security boundary. The selected interpreter itself is trusted config.\n let bwrap: string | undefined;\n for (const candidate of [\"/usr/bin/bwrap\", \"/bin/bwrap\"]) {\n try { await access(candidate, constants.X_OK); bwrap = candidate; break; } catch { /* Try the other system path. */ }\n }\n if (!bwrap) throw new Error(\"Schema enforce CPython requires bubblewrap (/usr/bin/bwrap). Install bubblewrap and enable unprivileged user namespaces; no unsandboxed fallback is permitted.\");\n return {\n command: bwrap,\n args: [\"--ro-bind\", \"/\", \"/\", \"--unshare-all\", \"--die-with-parent\", \"--new-session\", \"--proc\", \"/proc\", \"--dev\", \"/dev\", \"--preserve-fds\", \"1\", \"--seccomp\", \"4\", \"--chdir\", cwd, \"--\", python, ...args],\n seccomp: linuxCPythonNetworkFilter(process.arch),\n };\n }\n throw new Error(`Schema enforce CPython has no supported OS sandbox on ${process.platform}; no unsandboxed fallback is permitted.`);\n};\n\n// Windows stdio[3] is an anonymous pipe, not a socket, so the child dials a\n// loopback listener instead; a one-time token proves the caller is our child.\nconst createIpcListener = (): Promise<{ server: net.Server; port: number; token: string }> =>\n new Promise((resolve, reject) => {\n const server = net.createServer();\n const token = randomBytes(32).toString(\"hex\");\n server.once(\"error\", reject);\n server.listen(0, \"127.0.0.1\", () => {\n const address = server.address();\n if (address === null || typeof address === \"string\") reject(new Error(\"Fabric CPython IPC listener failed to bind\"));\n else resolve({ server, port: address.port, token });\n });\n });\n\n/** A fresh CPython process per call. Only enforce=true adds an OS security boundary. */\nexport class CPythonRuntime implements FabricKernelRuntime {\n constructor(readonly binary = \"python3\", readonly enforce = false) {}\n\n async execute(code: string, hostCall: FabricHostCall, options: FabricSandboxOptions): Promise<FabricSandboxResult> {\n const failure = (terminationReason: FabricSandboxResult[\"terminationReason\"], error: string): FabricSandboxResult =>\n ({ value: undefined, logs: [], terminationReason, error });\n if (options.signal?.aborted) return failure(\"aborted\", \"Execution cancelled\");\n if (!Number.isSafeInteger(options.memoryLimitBytes) || options.memoryLimitBytes < 1) {\n return failure(\"runtime_error\", \"CPython memory limit must be a positive safe integer\");\n }\n if (!Number.isFinite(options.timeoutMs) || options.timeoutMs < 1) return failure(\"runtime_error\", \"CPython timeout must be positive\");\n const startedAt = Date.now();\n let command: Awaited<ReturnType<typeof launch>>;\n try { command = await launch(this.binary, this.enforce, options.cwd ?? process.cwd()); }\n catch (error) { return failure(\"runtime_error\", errorText(error)); }\n // Resolve first, then check before spawn: no orphan on cancellation during discovery.\n if (options.signal?.aborted) return failure(\"aborted\", \"Execution cancelled\");\n // Windows cannot inherit a socket through stdio; the child connects back instead.\n const ipc = process.platform === \"win32\" ? await createIpcListener() : undefined;\n\n return new Promise<FabricSandboxResult>((resolve) => {\n const hostAbort = new AbortController();\n const hostTasks = new Set<Promise<void>>();\n const callIds = new Set<number>();\n const logs: string[] = [];\n const partialLogs = [\"\", \"\"];\n const decoders = [new StringDecoder(\"utf8\"), new StringDecoder(\"utf8\")];\n const maxLogChars = Math.max(0, options.maxLogChars ?? 100_000);\n let logChars = 0;\n let truncated = false;\n let settled = false;\n let finishing = false;\n let deadline: NodeJS.Timeout | undefined;\n let deadlineAt = startedAt + options.timeoutMs;\n let buffer = Buffer.alloc(0);\n let child: ReturnType<typeof spawn>;\n try {\n child = spawn(command.command, command.args, {\n cwd: options.cwd ?? process.cwd(),\n // -I ignores PYTHON* and user site packages; -B avoids bytecode writes.\n // Keep ordinary environment for trusted native code, not a false secrecy claim.\n env: ipc ? { ...process.env, FABRIC_IPC_PORT: String(ipc.port), FABRIC_IPC_TOKEN: ipc.token } : process.env,\n detached: process.platform !== \"win32\",\n stdio: command.seccomp ? [\"ignore\", \"pipe\", \"pipe\", \"pipe\", \"pipe\"] : [\"ignore\", \"pipe\", \"pipe\", \"pipe\"],\n });\n } catch (error) {\n ipc?.server.close();\n resolve(failure(\"runtime_error\", `CPython process failed: ${errorText(error)}`));\n return;\n }\n let channel: Duplex | net.Socket | undefined;\n let expectedToken: string | undefined = ipc?.token;\n let childExited = child.pid === undefined;\n child.once(\"exit\", () => { childExited = true; });\n const appendLog = (index: number, text: string): void => {\n if (settled || truncated) return;\n const available = Math.max(0, maxLogChars - logChars);\n const retained = text.slice(0, available);\n logChars += retained.length;\n const lines = ((partialLogs[index] ?? \"\") + retained).split(\"\\n\");\n partialLogs[index] = lines.pop() ?? \"\";\n for (const line of lines) logs.push(line.replace(/\\r$/, \"\"));\n if (retained.length !== text.length) truncated = true;\n };\n const finish = async (result: Omit<FabricSandboxResult, \"logs\">): Promise<void> => {\n if (settled) return;\n for (let index = 0; index < decoders.length; index++) appendLog(index, decoders[index]!.end());\n settled = true;\n if (deadline) clearTimeout(deadline);\n options.signal?.removeEventListener(\"abort\", abort);\n if (!hostAbort.signal.aborted) hostAbort.abort(new Error(result.error ?? \"CPython execution ended\"));\n channel?.destroy();\n ipc?.server.close();\n child.stdout?.destroy();\n child.stderr?.destroy();\n if (child.pid && process.platform !== \"win32\") {\n try { process.kill(-child.pid, \"SIGKILL\"); } catch { /* The process group may already have exited. */ }\n }\n child.kill(\"SIGKILL\");\n // Let the terminated child release its working directory before the\n // caller observes the result; Windows rmdir fails with EBUSY while held.\n if (!childExited) {\n await new Promise<void>((done) => {\n const timer = setTimeout(done, 250);\n timer.unref?.();\n child.once(\"exit\", () => { clearTimeout(timer); done(); });\n });\n }\n for (const text of partialLogs) if (text) logs.push(text);\n if (truncated) logs.push(\"[Pi Fabric log output truncated]\");\n resolve({ ...result, logs });\n };\n const abort = (): void => void finish({ value: undefined, terminationReason: \"aborted\", error: \"Execution cancelled\" });\n const fail = (message: string): void => void finish({ value: undefined, terminationReason: \"runtime_error\", error: message });\n const scheduleDeadline = (): void => {\n if (deadline) clearTimeout(deadline);\n deadline = setTimeout(() => void finish({\n value: undefined, terminationReason: \"timed_out\", error: `Execution timed out after ${deadlineAt - startedAt}ms`,\n }), Math.max(0, deadlineAt - Date.now()));\n deadline.unref?.();\n };\n const send = (message: unknown): void => {\n // A terminal guest result closes its reply channel while issued host\n // work may still be settling. Its late replies are no longer consumed.\n if (settled || finishing || !channel || channel.destroyed) return;\n try {\n const frame = JSON.stringify(message) + \"\\n\";\n const bytes = Buffer.byteLength(frame);\n if (bytes > MAX_FRAME_BYTES || channel.writableLength + bytes > MAX_FRAME_BYTES * 2) {\n fail(\"CPython IPC frame or write buffer exceeds its 16 MiB frame limit\");\n return;\n }\n channel.write(frame, (error) => { if (error && !settled && !finishing) fail(`CPython IPC failed: ${error.message}`); });\n } catch (error) { fail(`CPython IPC serialization failed: ${errorText(error)}`); }\n };\n const handleMessage = (message: unknown): void => {\n if (settled || finishing) return;\n if (!record(message)) { fail(\"Invalid CPython IPC message\"); return; }\n if (message.type === \"result\") {\n const result = message.result;\n if (!record(result) || ![\"completed\", \"runtime_error\"].includes(String(result.terminationReason)) ||\n (result.error !== undefined && typeof result.error !== \"string\")) {\n fail(\"Invalid CPython terminal result\"); return;\n }\n finishing = true;\n if (result.terminationReason !== \"completed\") hostAbort.abort(new Error(String(result.error ?? \"Python guest failed\")));\n void (async () => {\n const done = await settleWithin(hostTasks, HOST_SETTLE_MS);\n if (!done) {\n hostAbort.abort(new Error(\"Fabric guest execution ended before its host calls settled\"));\n await settleWithin(hostTasks, HOST_SETTLE_MS);\n }\n // stdout/stderr are separate channels; allow their ready data to drain.\n await new Promise<void>((done) => setImmediate(done));\n finish({\n value: result.value,\n terminationReason: result.terminationReason as \"completed\" | \"runtime_error\",\n ...(typeof result.error === \"string\" ? { error: result.error } : {}),\n });\n })();\n return;\n }\n if (message.type !== \"call\" || !Number.isSafeInteger(message.id) || (message.id as number) < 1 ||\n typeof message.ref !== \"string\" || !message.ref || message.ref.length > 512 || !record(message.args) ||\n callIds.has(message.id as number) || hostTasks.size >= 256) {\n fail(\"Invalid or excessive CPython host call\"); return;\n }\n const id = message.id as number;\n const ref = message.ref;\n const args = message.args;\n callIds.add(id);\n try {\n const floor = options.minimumTimeoutMsForHostCall?.(ref, args);\n if (typeof floor === \"number\" && Number.isFinite(floor) && Date.now() + floor > deadlineAt) {\n deadlineAt = Date.now() + Math.max(1, Math.floor(floor));\n scheduleDeadline();\n }\n } catch (error) { fail(`CPython deadline policy failed: ${errorText(error)}`); return; }\n const task = runAbortable(hostAbort.signal, () => hostCall(ref, args, hostAbort.signal)).then(\n (value) => send({ type: \"response\", id, ok: true, value }),\n (error) => send({ type: \"response\", id, ok: false, error: errorText(error), ...(isPiShellRef(ref) ? { bashExit: piBashExitMetadata(error) } : {}) }),\n ).finally(() => { hostTasks.delete(task); callIds.delete(id); });\n hostTasks.add(task);\n };\n const onData = (chunk: Buffer): void => {\n if (settled || finishing) return;\n buffer = Buffer.concat([buffer, chunk]);\n if (expectedToken !== undefined) {\n const handshake = buffer.indexOf(10);\n if (handshake === -1) {\n if (buffer.length > 4096) fail(\"Invalid CPython IPC handshake\");\n return;\n }\n let verified = false;\n try {\n const hello = JSON.parse(buffer.subarray(0, handshake).toString(\"utf8\"));\n verified = record(hello) && hello.type === \"hello\" && hello.token === expectedToken;\n } catch { /* Fail closed below. */ }\n if (!verified) { fail(\"Invalid CPython IPC handshake\"); return; }\n buffer = buffer.subarray(handshake + 1);\n expectedToken = undefined;\n send({ type: \"execute\", code, strings: options.strings ?? {}, memoryLimitBytes: options.memoryLimitBytes });\n if (settled || finishing) return;\n }\n let newline: number;\n while ((newline = buffer.indexOf(10)) !== -1) {\n if (newline > MAX_FRAME_BYTES) { fail(\"CPython IPC frame exceeds 16 MiB\"); return; }\n const frame = buffer.subarray(0, newline).toString(\"utf8\");\n buffer = buffer.subarray(newline + 1);\n try { handleMessage(JSON.parse(frame)); }\n catch (error) { fail(`Invalid CPython IPC: ${errorText(error)}`); return; }\n if (settled || finishing) return;\n }\n if (buffer.length > MAX_FRAME_BYTES) fail(\"CPython IPC frame exceeds 16 MiB\");\n };\n const attach = (socket: Duplex | net.Socket): void => {\n channel = socket;\n if (socket instanceof net.Socket) socket.setNoDelay(true);\n socket.on(\"data\", onData);\n socket.on(\"error\", (error) => { if (!settled && !finishing) fail(`CPython IPC failed: ${error.message}`); });\n };\n child.stdout?.on(\"data\", (chunk: Buffer) => appendLog(0, decoders[0]!.write(chunk)));\n child.stderr?.on(\"data\", (chunk: Buffer) => appendLog(1, decoders[1]!.write(chunk)));\n child.on(\"error\", (error) => fail(`CPython process failed: ${error.message}${this.enforce ? \"; OS sandbox is required (no native fallback)\" : \"\"}`));\n child.on(\"close\", (exitCode, signal) => {\n if (settled || finishing) return;\n const diagnostics = [...logs, ...partialLogs].join(\"\\n\").slice(-4000);\n fail(`CPython ${this.enforce ? \"sandbox \" : \"\"}process exited before returning a result (${signal ?? exitCode}).${this.enforce ? \" Verify OS sandbox availability/user namespaces; no unsandboxed fallback is permitted.\" : \"\"}${diagnostics ? `\\n${diagnostics}` : \"\"}`);\n });\n options.signal?.addEventListener(\"abort\", abort, { once: true });\n if (options.signal?.aborted) { abort(); return; }\n if (command.seccomp) {\n const filterPipe = child.stdio[4] as Duplex;\n filterPipe.on(\"error\", (error) => { if (!settled) fail(`CPython sandbox filter failed: ${error.message}`); });\n filterPipe.end(command.seccomp);\n }\n scheduleDeadline();\n if (ipc) {\n // Windows: the child dials the loopback listener and proves the token first.\n ipc.server.on(\"connection\", (socket) => {\n if (channel) { socket.destroy(); return; }\n ipc.server.close();\n attach(socket);\n });\n } else {\n attach(child.stdio[3] as Duplex);\n send({ type: \"execute\", code, strings: options.strings ?? {}, memoryLimitBytes: options.memoryLimitBytes });\n }\n });\n }\n}\n", "// Embedded so installed bundles do not depend on a source-tree Python asset.\nexport const CPYTHON_CHILD_SOURCE = String.raw`\nimport sys\nif sys.implementation.name != \"cpython\" or sys.version_info < (3, 10):\n sys.stderr.write(\"Fabric requires CPython 3.10 or newer; set executor.cpython.binary to a supported interpreter.\\n\")\n sys.exit(1)\n\nimport ast\nimport asyncio\nimport json\nimport math\nimport os\nimport socket\nimport sys\nimport traceback\n\n_MAX_FRAME = 16 * 1024 * 1024\n_MAX_INTEGER = 9007199254740991\n_pending = {}\n_next_id = 0\n_writer = None\n\n\ndef _json_value(value):\n if value is None or isinstance(value, (str, bool)):\n return value\n if isinstance(value, int):\n if abs(value) > _MAX_INTEGER:\n raise ValueError(\"Fabric JSON integers must fit JavaScript's safe integer range; return a string instead\")\n return value\n if isinstance(value, float) and math.isfinite(value):\n return value\n if isinstance(value, (list, tuple)):\n return [_json_value(item) for item in value]\n if isinstance(value, dict) and all(isinstance(key, str) for key in value):\n return {key: _json_value(item) for key, item in value.items()}\n raise TypeError(\"Fabric values must be JSON-compatible (no bytes, non-finite numbers, callables, or custom objects)\")\n\n\nasync def _send(message):\n data = (json.dumps(_json_value(message), ensure_ascii=True, allow_nan=False) + \"\\n\").encode(\"utf-8\")\n if len(data) > _MAX_FRAME:\n raise ValueError(\"Fabric IPC frame exceeds 16 MiB\")\n _writer.write(data)\n await _writer.drain()\n\n\nclass _HostError(Exception):\n def __init__(self, message, bash_exit=None):\n super().__init__(message)\n self.bash_exit = bash_exit\n\n\nasync def _call(ref, args):\n global _next_id\n if len(_pending) >= 256:\n raise RuntimeError(\"Fabric allows at most 256 outstanding host calls\")\n _next_id += 1\n call_id = _next_id\n future = asyncio.get_running_loop().create_future()\n _pending[call_id] = future\n try:\n await _send({\"type\": \"call\", \"id\": call_id, \"ref\": ref, \"args\": args})\n return await future\n finally:\n _pending.pop(call_id, None)\n\n\nasync def _responses(reader):\n try:\n while True:\n line = await reader.readline()\n if not line:\n raise RuntimeError(\"Fabric host IPC closed\")\n message = json.loads(line)\n if message.get(\"type\") != \"response\":\n raise RuntimeError(\"Invalid Fabric host response\")\n future = _pending.get(message.get(\"id\"))\n if future is None or future.done():\n continue\n if message.get(\"ok\") is True:\n future.set_result(message.get(\"value\"))\n else:\n future.set_exception(_HostError(message.get(\"error\", \"Host call failed\"), message.get(\"bashExit\")))\n except Exception as error:\n for future in tuple(_pending.values()):\n if not future.done():\n future.set_exception(error)\n\n\n_PRIMARY = {\"read\": \"path\", \"ls\": \"path\", \"bash\": \"command\", \"powershell\": \"command\", \"grep\": \"pattern\", \"find\": \"pattern\"}\n_POSITIONAL = {\"read\": [\"path\", \"offset\", \"limit\"], \"ls\": [\"path\", \"limit\"], \"grep\": [\"pattern\", \"path\", \"limit\"], \"find\": [\"pattern\", \"path\", \"limit\"], \"write\": [\"path\", \"content\"], \"edit\": [\"path\", \"oldText\", \"newText\"], \"bash\": [\"command\"], \"powershell\": [\"command\"]}\n_DISCOVERY = {\"providers\", \"catalog\", \"list\", \"search\", \"describe\", \"call\", \"models\", \"progress\"}\n\n\ndef _arguments(ref, positional, keywords):\n args = dict(keywords)\n if not positional:\n return args\n if len(positional) == 1 and isinstance(positional[0], dict):\n if args.keys() & positional[0].keys():\n raise TypeError(\"Duplicate Fabric argument keys\")\n return {**positional[0], **args}\n if ref == \"tools.search\" and len(positional) == 1 and isinstance(positional[0], str):\n return {**args, \"query\": positional[0]}\n if ref.startswith(\"pi.\"):\n name = ref[3:]\n primary = _PRIMARY.get(name)\n if primary and len(positional) == 2 and isinstance(positional[0], str) and isinstance(positional[1], dict):\n return {**positional[1], **args, primary: positional[0]}\n fields = _POSITIONAL.get(name, [])\n if len(positional) <= len(fields):\n args.update(zip(fields, positional))\n if name == \"edit\" and (\"oldText\" in args or \"newText\" in args):\n args[\"edits\"] = [{key: args.pop(key) for key in (\"oldText\", \"newText\") if key in args}]\n return args\n raise TypeError(\"Fabric calls accept a dictionary or keyword arguments; Pi tools also accept their documented positional arguments\")\n\n\nclass _Proxy:\n def __init__(self, ref):\n self._ref = ref\n\n def __getattr__(self, name):\n if name.startswith(\"__\"):\n raise AttributeError(name)\n return _Proxy(self._ref + \".\" + name)\n\n async def __call__(self, *positional, **keywords):\n ref = self._ref\n args = _arguments(ref, positional, keywords)\n if ref == \"pi.edit\" and \"edits\" not in args and (\"oldText\" in args or \"newText\" in args):\n args[\"edits\"] = [{key: args.pop(key) for key in (\"oldText\", \"newText\") if key in args}]\n if ref.startswith(\"tools.\"):\n name = ref[6:]\n if name not in _DISCOVERY:\n raise AttributeError(\"tools is discovery/generic calls only; use pi for core tools\")\n ref = \"fabric.$\" + name\n if ref in (\"pi.bash\", \"pi.powershell\") and \"settle\" in args and type(args[\"settle\"]) is not bool:\n raise TypeError(\"pi shell settle must be a boolean; use settle=True or settle=False\")\n if ref in (\"pi.bash\", \"pi.powershell\") and \"background\" in args and type(args[\"background\"]) is not bool:\n raise TypeError(\"pi shell background must be a boolean; use background=True or background=False\")\n settle = ref in (\"pi.bash\", \"pi.powershell\") and args.pop(\"settle\", False) is True\n try:\n return await _call(ref, args)\n except _HostError as error:\n exit_info = error.bash_exit\n if settle and isinstance(exit_info, dict) and type(exit_info.get(\"exitCode\")) is int and exit_info[\"exitCode\"] > 0 and isinstance(exit_info.get(\"output\"), str):\n return {\"ok\": False, \"output\": exit_info[\"output\"], \"details\": None, \"exitCode\": exit_info[\"exitCode\"], \"error\": str(error)}\n raise\n\n\nclass _Payloads:\n def __init__(self, values):\n self._values = dict(values)\n\n def __getitem__(self, name):\n if name not in self._values:\n raise KeyError(\"Payload \" + repr(name) + \" is missing; pass it in fabric_exec.payloads\")\n return self._values[name]\n\n def __getattr__(self, name):\n return self[name]\n\n\ndef _error_text(error, source):\n # Keep user/library frames and exception chaining, not the embedded bridge.\n rendered = traceback.TracebackException.from_exception(error, limit=-24, capture_locals=False)\n lines = source.splitlines()\n pending = [(rendered, error)]\n seen = set()\n while pending:\n current, original = pending.pop()\n if id(current) in seen:\n continue\n seen.add(id(current))\n internal = set()\n tb = original.__traceback__\n while tb is not None:\n if tb.tb_frame.f_globals is globals():\n internal.add((tb.tb_frame.f_code.co_filename, tb.tb_lineno, tb.tb_frame.f_code.co_name))\n tb = tb.tb_next\n frames = []\n for frame in current.stack:\n if (frame.filename, frame.lineno, frame.name) in internal:\n continue\n if frame.filename == \"fabric-exec.py\":\n line = lines[frame.lineno - 1] if 0 < frame.lineno <= len(lines) else None\n frame = traceback.FrameSummary(frame.filename, frame.lineno,\n \"<fabric_exec>\" if frame.name == \"__fabric_program\" else frame.name,\n lookup_line=False, line=line)\n frames.append(frame)\n if isinstance(original, SyntaxError) and original.filename == \"fabric-exec.py\":\n frames = []\n current.stack = traceback.StackSummary.from_list(frames)\n if current.exc_type is _HostError:\n current.exc_type = RuntimeError\n if len(seen) >= 8:\n current.__cause__ = None\n current.__context__ = None\n if hasattr(current, \"exceptions\"):\n current.exceptions = None\n continue\n for field in (\"__cause__\", \"__context__\"):\n item = getattr(current, field)\n if item is not None:\n pending.append((item, getattr(original, field)))\n pending.extend(zip(getattr(current, \"exceptions\", None) or [], getattr(original, \"exceptions\", [])))\n text = \"\".join(rendered.format())\n if len(text) > 16000:\n text = text[:7900] + \"\\n[Python traceback truncated]\\n\" + text[-8000:]\n return text\n\nasync def _main():\n global _writer\n # Descriptor 3 is a dedicated inherited socket, never stdout/stderr. Windows\n # cannot inherit a socket through stdio, so there the child dials a loopback\n # TCP listener and proves a one-time token from the environment instead.\n port = os.environ.get(\"FABRIC_IPC_PORT\")\n token = os.environ.get(\"FABRIC_IPC_TOKEN\")\n if port and token:\n reader, _writer = await asyncio.open_connection(\"127.0.0.1\", int(port), limit=_MAX_FRAME)\n await _send({\"type\": \"hello\", \"token\": token})\n else:\n channel = socket.socket(fileno=3)\n reader, _writer = await asyncio.open_connection(sock=channel, limit=_MAX_FRAME)\n request = json.loads(await reader.readline())\n if request.get(\"type\") != \"execute\":\n raise RuntimeError(\"Invalid Fabric execution request\")\n response_task = asyncio.create_task(_responses(reader))\n try:\n # macOS does not provide a dependable address-space limit for CPython.\n # Linux bounds allocations; the parent owns the wall-clock deadline.\n if sys.platform.startswith(\"linux\"):\n import resource\n resource.setrlimit(resource.RLIMIT_AS, (request[\"memoryLimitBytes\"], request[\"memoryLimitBytes\"]))\n source = request[\"code\"]\n parsed = ast.parse(source, filename=\"fabric-exec.py\", mode=\"exec\")\n provided = request.get(\"strings\", {})\n missing = set()\n for node in ast.walk(parsed):\n key = None\n if isinstance(node, ast.Attribute) and isinstance(node.value, ast.Name) and node.value.id in (\"\u03C0\", \"payloads\") and isinstance(node.ctx, ast.Load):\n key = node.attr\n elif isinstance(node, ast.Subscript) and isinstance(node.value, ast.Name) and node.value.id in (\"\u03C0\", \"payloads\") and isinstance(node.slice, ast.Constant) and isinstance(node.slice.value, str) and isinstance(node.ctx, ast.Load):\n key = node.slice.value\n if key is not None and key not in provided:\n missing.add(key)\n if missing:\n raise KeyError(\"Pre-execution check: missing payloads \" + \", \".join(sorted(missing)) + \"; pass these keys in fabric_exec.payloads\")\n function = ast.parse(\"async def __fabric_program():\\n pass\\n\").body[0]\n function.body = parsed.body or function.body\n function.end_lineno = max(2, len(source.splitlines()))\n program = ast.fix_missing_locations(ast.Module(body=[function], type_ignores=[]))\n namespace = {name: _Proxy(name) for name in (\"pi\", \"tools\", \"mcp\", \"extensions\", \"memory\", \"state\", \"schema\", \"components\", \"compact\", \"agents\", \"mesh\")}\n payloads = _Payloads(request.get(\"strings\", {}))\n namespace.update({\"\u03C0\": payloads, \"payloads\": payloads, \"asyncio\": asyncio, \"__name__\": \"__fabric_guest__\"})\n exec(compile(program, \"fabric-exec.py\", \"exec\"), namespace)\n value = await namespace[\"__fabric_program\"]()\n sys.stdout.flush()\n sys.stderr.flush()\n await _send({\"type\": \"result\", \"result\": {\"value\": value, \"terminationReason\": \"completed\"}})\n except BaseException:\n await _send({\"type\": \"result\", \"result\": {\"terminationReason\": \"runtime_error\", \"error\": _error_text(sys.exception() if hasattr(sys, \"exception\") else sys.exc_info()[1], locals().get(\"source\", \"\"))}})\n finally:\n response_task.cancel()\n await asyncio.gather(response_task, return_exceptions=True)\n\n\ntry:\n asyncio.run(_main())\nexcept BaseException:\n traceback.print_exc()\n sys.exit(1)\n`;\n", "// Classic BPF consumed by bubblewrap --seccomp. A read-only root and a new\n// network namespace alone still expose host pathname Unix sockets. Deny new\n// sockets, endpoint changes, and io_uring's alternate socket path. Existing\n// fd3 writes (sendto with a null destination) and local asyncio socketpairs work.\nexport const linuxCPythonNetworkFilter = (architecture: string): Buffer => {\n const platform = architecture === \"x64\"\n ? { audit: 0xc000003e, socket: 41, connect: 42, bind: 49, sendto: 44, sendmsg: 46, sendmmsg: 307 }\n : architecture === \"arm64\"\n ? { audit: 0xc00000b7, socket: 198, connect: 203, bind: 200, sendto: 206, sendmsg: 211, sendmmsg: 269 }\n : undefined;\n if (!platform) throw new Error(`Schema enforce CPython seccomp is unsupported on ${architecture}; no unsandboxed fallback is permitted.`);\n const instructions: Array<[number, number, number, number]> = [];\n const load = (offset: number): void => { instructions.push([0x20, 0, 0, offset]); };\n const equal = (value: number, yes: number, no: number): void => { instructions.push([0x15, yes, no, value]); };\n const ret = (value: number): void => { instructions.push([0x06, 0, 0, value]); };\n const deny = 0x00050001; // SECCOMP_RET_ERRNO | EPERM\n const allow = 0x7fff0000;\n load(4); // seccomp_data.arch\n equal(platform.audit, 1, 0);\n ret(0x80000000); // KILL_PROCESS for alternate syscall ABIs\n load(0); // seccomp_data.nr\n instructions.push([0x45, 0, 1, 0x40000000]); // Refuse x32 ABI syscall numbers.\n ret(deny);\n for (const syscall of [platform.socket, platform.connect, platform.bind, platform.sendmsg, platform.sendmmsg, 425, 426, 427]) {\n equal(syscall, 0, 1);\n ret(deny);\n }\n equal(platform.sendto, 1, 0);\n ret(allow);\n load(48); // sendto argument 4: sockaddr pointer (low word)\n equal(0, 1, 0);\n ret(deny);\n load(52); // high word, both supported architectures are little-endian\n equal(0, 1, 0);\n ret(deny);\n ret(allow);\n const bytes = Buffer.alloc(instructions.length * 8);\n for (const [index, [code, yes, no, value]] of instructions.entries()) {\n bytes.writeUInt16LE(code, index * 8);\n bytes[index * 8 + 2] = yes;\n bytes[index * 8 + 3] = no;\n bytes.writeUInt32LE(value, index * 8 + 4);\n }\n return bytes;\n};\n"],
|
|
5
|
-
"mappings": ";;;;;;;;;;;;AAAA,SAAS,aAAa;AACtB,SAAS,mBAAmB;AAC5B,SAAS,iBAAiB;AAC1B,SAAS,QAAQ,gBAAgB;AACjC,OAAO,SAAS;AAChB,OAAO,UAAU;AAEjB,SAAS,qBAAqB;;;ACNvB,IAAM,uBAAuB,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGpC,IAAM,4BAA4B,CAAC,iBAAiC;AACzE,QAAM,WAAW,iBAAiB,QAC9B,EAAE,OAAO,YAAY,QAAQ,IAAI,SAAS,IAAI,MAAM,IAAI,QAAQ,IAAI,SAAS,IAAI,UAAU,IAAI,IAC/F,iBAAiB,UACf,EAAE,OAAO,YAAY,QAAQ,KAAK,SAAS,KAAK,MAAM,KAAK,QAAQ,KAAK,SAAS,KAAK,UAAU,IAAI,IACpG;AACN,MAAI,CAAC,SAAU,OAAM,IAAI,MAAM,oDAAoD,YAAY,yCAAyC;AACxI,QAAM,eAAwD,CAAC;AAC/D,QAAM,OAAO,CAAC,WAAyB;AAAE,iBAAa,KAAK,CAAC,IAAM,GAAG,GAAG,MAAM,CAAC;AAAA,EAAG;AAClF,QAAM,QAAQ,CAAC,OAAe,KAAa,OAAqB;AAAE,iBAAa,KAAK,CAAC,IAAM,KAAK,IAAI,KAAK,CAAC;AAAA,EAAG;AAC7G,QAAM,MAAM,CAAC,UAAwB;AAAE,iBAAa,KAAK,CAAC,GAAM,GAAG,GAAG,KAAK,CAAC;AAAA,EAAG;AAC/E,QAAM,OAAO;AACb,QAAM,QAAQ;AACd,OAAK,CAAC;AACN,QAAM,SAAS,OAAO,GAAG,CAAC;AAC1B,MAAI,UAAU;AACd,OAAK,CAAC;AACN,eAAa,KAAK,CAAC,IAAM,GAAG,GAAG,UAAU,CAAC;AAC1C,MAAI,IAAI;AACR,aAAW,WAAW,CAAC,SAAS,QAAQ,SAAS,SAAS,SAAS,MAAM,SAAS,SAAS,SAAS,UAAU,KAAK,KAAK,GAAG,GAAG;AAC5H,UAAM,SAAS,GAAG,CAAC;AACnB,QAAI,IAAI;AAAA,EACV;AACA,QAAM,SAAS,QAAQ,GAAG,CAAC;AAC3B,MAAI,KAAK;AACT,OAAK,EAAE;AACP,QAAM,GAAG,GAAG,CAAC;AACb,MAAI,IAAI;AACR,OAAK,EAAE;AACP,QAAM,GAAG,GAAG,CAAC;AACb,MAAI,IAAI;AACR,MAAI,KAAK;AACT,QAAM,QAAQ,OAAO,MAAM,aAAa,SAAS,CAAC;AAClD,aAAW,CAAC,OAAO,CAAC,MAAM,KAAK,IAAI,KAAK,CAAC,KAAK,aAAa,QAAQ,GAAG;AACpE,UAAM,cAAc,MAAM,QAAQ,CAAC;AACnC,UAAM,QAAQ,IAAI,CAAC,IAAI;AACvB,UAAM,QAAQ,IAAI,CAAC,IAAI;AACvB,UAAM,cAAc,OAAO,QAAQ,IAAI,CAAC;AAAA,EAC1C;AACA,SAAO;AACT;;;AF7BA,IAAM,kBAAkB,KAAK,OAAO;AACpC,IAAM,iBAAiB;AAGvB,IAAM,gBAAgB;AAEtB,IAAM,SAAS,CAAC,UACd,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AACrE,IAAM,YAAY,CAAC,UAA2B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAEnG,IAAM,aAAa,OAAO,QAAgB,QAAiC;AAGzE,QAAM,aAAa,QAAQ,aAAa,UACpC,OAAO,QAAQ,IAAI,WAAW,qBAAqB,EAAE,MAAM,GAAG,EAAE,OAAO,OAAO,IAC9E,CAAC;AACL,QAAM,WAAW,CAAC,cAChB,WAAW,UAAU,CAAC,kBAAkB,KAAK,SAAS,IAClD,CAAC,WAAW,GAAG,WAAW,IAAI,CAAC,cAAc,YAAY,SAAS,CAAC,IACnE,CAAC,SAAS;AAChB,QAAM,aAAa,KAAK,WAAW,MAAM,KAAK,OAAO,SAAS,GAAG,KAAK,OAAO,SAAS,IAAI,IACtF,CAAC,KAAK,QAAQ,KAAK,MAAM,CAAC,KACzB,QAAQ,IAAI,QAAQ,IAAI,MAAM,KAAK,SAAS,EAAE,IAAI,CAAC,cAAc,KAAK,QAAQ,KAAK,aAAa,KAAK,MAAM,CAAC;AACjH,aAAW,aAAa,YAAY;AAClC,eAAW,WAAW,SAAS,SAAS,GAAG;AACzC,UAAI;AACF,cAAM,OAAO,SAAS,UAAU,IAAI;AACpC,eAAO,MAAM,SAAS,OAAO;AAAA,MAC/B,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACA,QAAM,IAAI,MAAM,iCAAiC,MAAM,4FAA4F;AACrJ;AAEA,IAAM,SAAS,OAAO,QAAgB,SAAkB,QAAgF;AACtI,QAAM,SAAS,MAAM,WAAW,QAAQ,GAAG;AAC3C,QAAM,OAAO,CAAC,MAAM,MAAM,MAAM,MAAM,oBAAoB;AAC1D,MAAI,CAAC,QAAS,QAAO,EAAE,SAAS,QAAQ,KAAK;AAC7C,MAAI,QAAQ,aAAa,UAAU;AACjC,QAAI;AAAE,YAAM,OAAO,yBAAyB,UAAU,IAAI;AAAA,IAAG,QACvD;AAAE,YAAM,IAAI,MAAM,uGAAuG;AAAA,IAAG;AAClI,WAAO,EAAE,SAAS,yBAAyB,MAAM,CAAC,MAAM,eAAe,QAAQ,GAAG,IAAI,EAAE;AAAA,EAC1F;AACA,MAAI,QAAQ,aAAa,SAAS;AAGhC,QAAI;AACJ,eAAW,aAAa,CAAC,kBAAkB,YAAY,GAAG;AACxD,UAAI;AAAE,cAAM,OAAO,WAAW,UAAU,IAAI;AAAG,gBAAQ;AAAW;AAAA,MAAO,QAAQ;AAAA,MAAmC;AAAA,IACtH;AACA,QAAI,CAAC,MAAO,OAAM,IAAI,MAAM,gKAAgK;AAC5L,WAAO;AAAA,MACL,SAAS;AAAA,MACT,MAAM,CAAC,aAAa,KAAK,KAAK,iBAAiB,qBAAqB,iBAAiB,UAAU,SAAS,SAAS,QAAQ,kBAAkB,KAAK,aAAa,KAAK,WAAW,KAAK,MAAM,QAAQ,GAAG,IAAI;AAAA,MACvM,SAAS,0BAA0B,QAAQ,IAAI;AAAA,IACjD;AAAA,EACF;AACA,QAAM,IAAI,MAAM,yDAAyD,QAAQ,QAAQ,yCAAyC;AACpI;AAIA,IAAM,oBAAoB,MACxB,IAAI,QAAQ,CAAC,SAAS,WAAW;AAC/B,QAAM,SAAS,IAAI,aAAa;AAChC,QAAM,QAAQ,YAAY,EAAE,EAAE,SAAS,KAAK;AAC5C,SAAO,KAAK,SAAS,MAAM;AAC3B,SAAO,OAAO,GAAG,aAAa,MAAM;AAClC,UAAM,UAAU,OAAO,QAAQ;AAC/B,QAAI,YAAY,QAAQ,OAAO,YAAY,SAAU,QAAO,IAAI,MAAM,4CAA4C,CAAC;AAAA,QAC9G,SAAQ,EAAE,QAAQ,MAAM,QAAQ,MAAM,MAAM,CAAC;AAAA,EACpD,CAAC;AACH,CAAC;AAGI,IAAM,iBAAN,MAAoD;AAAA,EACzD,YAAqB,SAAS,WAAoB,UAAU,OAAO;AAA9C;AAA6B;AAAA,EAAkB;AAAA,EAEpE,MAAM,QAAQ,MAAc,UAA0B,SAA6D;AACjH,UAAM,UAAU,CAAC,mBAA6D,WAC3E,EAAE,OAAO,QAAW,MAAM,CAAC,GAAG,mBAAmB,MAAM;AAC1D,QAAI,QAAQ,QAAQ,QAAS,QAAO,QAAQ,WAAW,qBAAqB;AAC5E,QAAI,CAAC,OAAO,cAAc,QAAQ,gBAAgB,KAAK,QAAQ,mBAAmB,GAAG;AACnF,aAAO,QAAQ,iBAAiB,sDAAsD;AAAA,IACxF;AACA,QAAI,CAAC,OAAO,SAAS,QAAQ,SAAS,KAAK,QAAQ,YAAY,EAAG,QAAO,QAAQ,iBAAiB,kCAAkC;AACpI,UAAM,YAAY,KAAK,IAAI;AAC3B,QAAI;AACJ,QAAI;AAAE,gBAAU,MAAM,OAAO,KAAK,QAAQ,KAAK,SAAS,QAAQ,OAAO,QAAQ,IAAI,CAAC;AAAA,IAAG,SAChF,OAAO;AAAE,aAAO,QAAQ,iBAAiB,UAAU,KAAK,CAAC;AAAA,IAAG;AAEnE,QAAI,QAAQ,QAAQ,QAAS,QAAO,QAAQ,WAAW,qBAAqB;AAE5E,UAAM,MAAM,QAAQ,aAAa,UAAU,MAAM,kBAAkB,IAAI;AAEvE,WAAO,IAAI,QAA6B,CAAC,YAAY;AACnD,YAAM,YAAY,IAAI,gBAAgB;AACtC,YAAM,YAAY,oBAAI,IAAmB;AACzC,YAAM,UAAU,oBAAI,IAAY;AAChC,YAAM,OAAiB,CAAC;AACxB,YAAM,cAAc,CAAC,IAAI,EAAE;AAC3B,YAAM,WAAW,CAAC,IAAI,cAAc,MAAM,GAAG,IAAI,cAAc,MAAM,CAAC;AACtE,YAAM,cAAc,KAAK,IAAI,GAAG,QAAQ,eAAe,GAAO;AAC9D,UAAI,WAAW;AACf,UAAI,YAAY;AAChB,UAAI,UAAU;AACd,UAAI,YAAY;AAChB,UAAI;AACJ,UAAI,aAAa,YAAY,QAAQ;AACrC,UAAI,SAAS,OAAO,MAAM,CAAC;AAC3B,UAAI;AACJ,UAAI;AACF,gBAAQ,MAAM,QAAQ,SAAS,QAAQ,MAAM;AAAA,UAC3C,KAAK,QAAQ,OAAO,QAAQ,IAAI;AAAA;AAAA;AAAA,UAGhC,KAAK,MAAM,EAAE,GAAG,QAAQ,KAAK,iBAAiB,OAAO,IAAI,IAAI,GAAG,kBAAkB,IAAI,MAAM,IAAI,QAAQ;AAAA,UACxG,UAAU,QAAQ,aAAa;AAAA,UAC/B,OAAO,QAAQ,UAAU,CAAC,UAAU,QAAQ,QAAQ,QAAQ,MAAM,IAAI,CAAC,UAAU,QAAQ,QAAQ,MAAM;AAAA,QACzG,CAAC;AAAA,MACH,SAAS,OAAO;AACd,aAAK,OAAO,MAAM;AAClB,gBAAQ,QAAQ,iBAAiB,2BAA2B,UAAU,KAAK,CAAC,EAAE,CAAC;AAC/E;AAAA,MACF;AACA,UAAI;AACJ,UAAI,gBAAoC,KAAK;AAC7C,UAAI,cAAc,MAAM,QAAQ;AAChC,YAAM,KAAK,QAAQ,MAAM;AAAE,sBAAc;AAAA,MAAM,CAAC;AAChD,YAAM,YAAY,CAAC,OAAe,SAAuB;AACvD,YAAI,WAAW,UAAW;AAC1B,cAAM,YAAY,KAAK,IAAI,GAAG,cAAc,QAAQ;AACpD,cAAM,WAAW,KAAK,MAAM,GAAG,SAAS;AACxC,oBAAY,SAAS;AACrB,cAAM,UAAU,YAAY,KAAK,KAAK,MAAM,UAAU,MAAM,IAAI;AAChE,oBAAY,KAAK,IAAI,MAAM,IAAI,KAAK;AACpC,mBAAW,QAAQ,MAAO,MAAK,KAAK,KAAK,QAAQ,OAAO,EAAE,CAAC;AAC3D,YAAI,SAAS,WAAW,KAAK,OAAQ,aAAY;AAAA,MACnD;AACA,YAAM,SAAS,OAAO,WAA6D;AACjF,YAAI,QAAS;AACb,iBAAS,QAAQ,GAAG,QAAQ,SAAS,QAAQ,QAAS,WAAU,OAAO,SAAS,KAAK,EAAG,IAAI,CAAC;AAC7F,kBAAU;AACV,YAAI,SAAU,cAAa,QAAQ;AACnC,gBAAQ,QAAQ,oBAAoB,SAAS,KAAK;AAClD,YAAI,CAAC,UAAU,OAAO,QAAS,WAAU,MAAM,IAAI,MAAM,OAAO,SAAS,yBAAyB,CAAC;AACnG,iBAAS,QAAQ;AACjB,aAAK,OAAO,MAAM;AAClB,cAAM,QAAQ,QAAQ;AACtB,cAAM,QAAQ,QAAQ;AACtB,YAAI,MAAM,OAAO,QAAQ,aAAa,SAAS;AAC7C,cAAI;AAAE,oBAAQ,KAAK,CAAC,MAAM,KAAK,SAAS;AAAA,UAAG,QAAQ;AAAA,UAAmD;AAAA,QACxG;AACA,cAAM,KAAK,SAAS;AAGpB,YAAI,CAAC,aAAa;AAChB,gBAAM,IAAI,QAAc,CAAC,SAAS;AAChC,kBAAM,QAAQ,WAAW,MAAM,GAAG;AAClC,kBAAM,QAAQ;AACd,kBAAM,KAAK,QAAQ,MAAM;AAAE,2BAAa,KAAK;AAAG,mBAAK;AAAA,YAAG,CAAC;AAAA,UAC3D,CAAC;AAAA,QACH;AACA,mBAAW,QAAQ,YAAa,KAAI,KAAM,MAAK,KAAK,IAAI;AACxD,YAAI,UAAW,MAAK,KAAK,kCAAkC;AAC3D,gBAAQ,EAAE,GAAG,QAAQ,KAAK,CAAC;AAAA,MAC7B;AACA,YAAM,QAAQ,MAAY,KAAK,OAAO,EAAE,OAAO,QAAW,mBAAmB,WAAW,OAAO,sBAAsB,CAAC;AACtH,YAAM,OAAO,CAAC,YAA0B,KAAK,OAAO,EAAE,OAAO,QAAW,mBAAmB,iBAAiB,OAAO,QAAQ,CAAC;AAC5H,YAAM,mBAAmB,MAAY;AACnC,YAAI,SAAU,cAAa,QAAQ;AACnC,mBAAW,WAAW,MAAM,KAAK,OAAO;AAAA,UACtC,OAAO;AAAA,UAAW,mBAAmB;AAAA,UAAa,OAAO,6BAA6B,aAAa,SAAS;AAAA,QAC9G,CAAC,GAAG,KAAK,IAAI,GAAG,aAAa,KAAK,IAAI,CAAC,CAAC;AACxC,iBAAS,QAAQ;AAAA,MACnB;AACA,YAAM,OAAO,CAAC,YAA2B;AAGvC,YAAI,WAAW,aAAa,CAAC,WAAW,QAAQ,UAAW;AAC3D,YAAI;AACF,gBAAM,QAAQ,KAAK,UAAU,OAAO,IAAI;AACxC,gBAAM,QAAQ,OAAO,WAAW,KAAK;AACrC,cAAI,QAAQ,mBAAmB,QAAQ,iBAAiB,QAAQ,kBAAkB,GAAG;AACnF,iBAAK,kEAAkE;AACvE;AAAA,UACF;AACA,kBAAQ,MAAM,OAAO,CAAC,UAAU;AAAE,gBAAI,SAAS,CAAC,WAAW,CAAC,UAAW,MAAK,uBAAuB,MAAM,OAAO,EAAE;AAAA,UAAG,CAAC;AAAA,QACxH,SAAS,OAAO;AAAE,eAAK,qCAAqC,UAAU,KAAK,CAAC,EAAE;AAAA,QAAG;AAAA,MACnF;AACA,YAAM,gBAAgB,CAAC,YAA2B;AAChD,YAAI,WAAW,UAAW;AAC1B,YAAI,CAAC,OAAO,OAAO,GAAG;AAAE,eAAK,6BAA6B;AAAG;AAAA,QAAQ;AACrE,YAAI,QAAQ,SAAS,UAAU;AAC7B,gBAAM,SAAS,QAAQ;AACvB,cAAI,CAAC,OAAO,MAAM,KAAK,CAAC,CAAC,aAAa,eAAe,EAAE,SAAS,OAAO,OAAO,iBAAiB,CAAC,KAC3F,OAAO,UAAU,UAAa,OAAO,OAAO,UAAU,UAAW;AACpE,iBAAK,iCAAiC;AAAG;AAAA,UAC3C;AACA,sBAAY;AACZ,cAAI,OAAO,sBAAsB,YAAa,WAAU,MAAM,IAAI,MAAM,OAAO,OAAO,SAAS,qBAAqB,CAAC,CAAC;AACtH,gBAAM,YAAY;AAChB,kBAAM,OAAO,MAAM,aAAa,WAAW,cAAc;AACzD,gBAAI,CAAC,MAAM;AACT,wBAAU,MAAM,IAAI,MAAM,4DAA4D,CAAC;AACvF,oBAAM,aAAa,WAAW,cAAc;AAAA,YAC9C;AAEA,kBAAM,IAAI,QAAc,CAACA,UAAS,aAAaA,KAAI,CAAC;AACpD,mBAAO;AAAA,cACL,OAAO,OAAO;AAAA,cACd,mBAAmB,OAAO;AAAA,cAC1B,GAAI,OAAO,OAAO,UAAU,WAAW,EAAE,OAAO,OAAO,MAAM,IAAI,CAAC;AAAA,YACpE,CAAC;AAAA,UACH,GAAG;AACH;AAAA,QACF;AACA,YAAI,QAAQ,SAAS,UAAU,CAAC,OAAO,cAAc,QAAQ,EAAE,KAAM,QAAQ,KAAgB,KACzF,OAAO,QAAQ,QAAQ,YAAY,CAAC,QAAQ,OAAO,QAAQ,IAAI,SAAS,OAAO,CAAC,OAAO,QAAQ,IAAI,KACnG,QAAQ,IAAI,QAAQ,EAAY,KAAK,UAAU,QAAQ,KAAK;AAC9D,eAAK,wCAAwC;AAAG;AAAA,QAClD;AACA,cAAM,KAAK,QAAQ;AACnB,cAAM,MAAM,QAAQ;AACpB,cAAM,OAAO,QAAQ;AACrB,gBAAQ,IAAI,EAAE;AACd,YAAI;AACF,gBAAM,QAAQ,QAAQ,8BAA8B,KAAK,IAAI;AAC7D,cAAI,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,KAAK,KAAK,IAAI,IAAI,QAAQ,YAAY;AAC1F,yBAAa,KAAK,IAAI,IAAI,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,CAAC;AACvD,6BAAiB;AAAA,UACnB;AAAA,QACF,SAAS,OAAO;AAAE,eAAK,mCAAmC,UAAU,KAAK,CAAC,EAAE;AAAG;AAAA,QAAQ;AACvF,cAAM,OAAO,aAAa,UAAU,QAAQ,MAAM,SAAS,KAAK,MAAM,UAAU,MAAM,CAAC,EAAE;AAAA,UACvF,CAAC,UAAU,KAAK,EAAE,MAAM,YAAY,IAAI,IAAI,MAAM,MAAM,CAAC;AAAA,UACzD,CAAC,UAAU,KAAK,EAAE,MAAM,YAAY,IAAI,IAAI,OAAO,OAAO,UAAU,KAAK,GAAG,GAAI,aAAa,GAAG,IAAI,EAAE,UAAU,mBAAmB,KAAK,EAAE,IAAI,CAAC,EAAG,CAAC;AAAA,QACrJ,EAAE,QAAQ,MAAM;AAAE,oBAAU,OAAO,IAAI;AAAG,kBAAQ,OAAO,EAAE;AAAA,QAAG,CAAC;AAC/D,kBAAU,IAAI,IAAI;AAAA,MACpB;AACA,YAAM,SAAS,CAAC,UAAwB;AACtC,YAAI,WAAW,UAAW;AAC1B,iBAAS,OAAO,OAAO,CAAC,QAAQ,KAAK,CAAC;AACtC,YAAI,kBAAkB,QAAW;AAC/B,gBAAM,YAAY,OAAO,QAAQ,EAAE;AACnC,cAAI,cAAc,IAAI;AACpB,gBAAI,OAAO,SAAS,KAAM,MAAK,+BAA+B;AAC9D;AAAA,UACF;AACA,cAAI,WAAW;AACf,cAAI;AACF,kBAAM,QAAQ,KAAK,MAAM,OAAO,SAAS,GAAG,SAAS,EAAE,SAAS,MAAM,CAAC;AACvE,uBAAW,OAAO,KAAK,KAAK,MAAM,SAAS,WAAW,MAAM,UAAU;AAAA,UACxE,QAAQ;AAAA,UAA2B;AACnC,cAAI,CAAC,UAAU;AAAE,iBAAK,+BAA+B;AAAG;AAAA,UAAQ;AAChE,mBAAS,OAAO,SAAS,YAAY,CAAC;AACtC,0BAAgB;AAChB,eAAK,EAAE,MAAM,WAAW,MAAM,SAAS,QAAQ,WAAW,CAAC,GAAG,kBAAkB,QAAQ,iBAAiB,CAAC;AAC1G,cAAI,WAAW,UAAW;AAAA,QAC5B;AACA,YAAI;AACJ,gBAAQ,UAAU,OAAO,QAAQ,EAAE,OAAO,IAAI;AAC5C,cAAI,UAAU,iBAAiB;AAAE,iBAAK,kCAAkC;AAAG;AAAA,UAAQ;AACnF,gBAAM,QAAQ,OAAO,SAAS,GAAG,OAAO,EAAE,SAAS,MAAM;AACzD,mBAAS,OAAO,SAAS,UAAU,CAAC;AACpC,cAAI;AAAE,0BAAc,KAAK,MAAM,KAAK,CAAC;AAAA,UAAG,SACjC,OAAO;AAAE,iBAAK,wBAAwB,UAAU,KAAK,CAAC,EAAE;AAAG;AAAA,UAAQ;AAC1E,cAAI,WAAW,UAAW;AAAA,QAC5B;AACA,YAAI,OAAO,SAAS,gBAAiB,MAAK,kCAAkC;AAAA,MAC9E;AACA,YAAM,SAAS,CAAC,WAAsC;AACpD,kBAAU;AACV,YAAI,kBAAkB,IAAI,OAAQ,QAAO,WAAW,IAAI;AACxD,eAAO,GAAG,QAAQ,MAAM;AACxB,eAAO,GAAG,SAAS,CAAC,UAAU;AAAE,cAAI,CAAC,WAAW,CAAC,UAAW,MAAK,uBAAuB,MAAM,OAAO,EAAE;AAAA,QAAG,CAAC;AAAA,MAC7G;AACA,YAAM,QAAQ,GAAG,QAAQ,CAAC,UAAkB,UAAU,GAAG,SAAS,CAAC,EAAG,MAAM,KAAK,CAAC,CAAC;AACnF,YAAM,QAAQ,GAAG,QAAQ,CAAC,UAAkB,UAAU,GAAG,SAAS,CAAC,EAAG,MAAM,KAAK,CAAC,CAAC;AACnF,YAAM,GAAG,SAAS,CAAC,UAAU,KAAK,2BAA2B,MAAM,OAAO,GAAG,KAAK,UAAU,kDAAkD,EAAE,EAAE,CAAC;AACnJ,YAAM,GAAG,SAAS,CAAC,UAAU,WAAW;AACtC,YAAI,WAAW,UAAW;AAC1B,cAAM,cAAc,CAAC,GAAG,MAAM,GAAG,WAAW,EAAE,KAAK,IAAI,EAAE,MAAM,IAAK;AACpE,aAAK,WAAW,KAAK,UAAU,aAAa,EAAE,6CAA6C,UAAU,QAAQ,KAAK,KAAK,UAAU,2FAA2F,EAAE,GAAG,cAAc;AAAA,EAAK,WAAW,KAAK,EAAE,EAAE;AAAA,MAC1Q,CAAC;AACD,cAAQ,QAAQ,iBAAiB,SAAS,OAAO,EAAE,MAAM,KAAK,CAAC;AAC/D,UAAI,QAAQ,QAAQ,SAAS;AAAE,cAAM;AAAG;AAAA,MAAQ;AAChD,UAAI,QAAQ,SAAS;AACnB,cAAM,aAAa,MAAM,MAAM,CAAC;AAChC,mBAAW,GAAG,SAAS,CAAC,UAAU;AAAE,cAAI,CAAC,QAAS,MAAK,kCAAkC,MAAM,OAAO,EAAE;AAAA,QAAG,CAAC;AAC5G,mBAAW,IAAI,QAAQ,OAAO;AAAA,MAChC;AACA,uBAAiB;AACjB,UAAI,KAAK;AAEP,YAAI,OAAO,GAAG,cAAc,CAAC,WAAW;AACtC,cAAI,SAAS;AAAE,mBAAO,QAAQ;AAAG;AAAA,UAAQ;AACzC,cAAI,OAAO,MAAM;AACjB,iBAAO,MAAM;AAAA,QACf,CAAC;AAAA,MACH,OAAO;AACL,eAAO,MAAM,MAAM,CAAC,CAAW;AAC/B,aAAK,EAAE,MAAM,WAAW,MAAM,SAAS,QAAQ,WAAW,CAAC,GAAG,kBAAkB,QAAQ,iBAAiB,CAAC;AAAA,MAC5G;AAAA,IACF,CAAC;AAAA,EACH;AACF;",
|
|
4
|
+
"sourcesContent": ["import { spawn } from \"node:child_process\";\nimport { randomBytes } from \"node:crypto\";\nimport { constants } from \"node:fs\";\nimport { access, realpath } from \"node:fs/promises\";\nimport net from \"node:net\";\nimport path from \"node:path\";\nimport type { Duplex } from \"node:stream\";\nimport { StringDecoder } from \"node:string_decoder\";\nimport { runAbortable, settleWithin } from \"../async-settlement.js\";\nimport { piBashExitMetadata } from \"../core/pi-bash-error.js\";\nimport { isPiShellRef } from \"../core/pi-tools.js\";\nimport type { FabricHostCall, FabricKernelRuntime, FabricSandboxOptions, FabricSandboxResult } from \"./kernel.js\";\nimport { CPYTHON_CHILD_SOURCE } from \"./cpython-child-source.js\";\nimport { linuxCPythonNetworkFilter } from \"./cpython-linux-sandbox.js\";\n\nconst MAX_FRAME_BYTES = 16 * 1024 * 1024;\nconst HOST_SETTLE_MS = 250;\n// No blanket mach* allowance: Mach services can broker effects outside the\n// file/network policy. CPython's standard-library startup needs none here.\nconst MACOS_PROFILE = \"(version 1) (deny default) (allow process-exec) (allow process-fork) (allow file-read*) (allow sysctl-read)\";\n\nconst record = (value: unknown): value is Record<string, unknown> =>\n typeof value === \"object\" && value !== null && !Array.isArray(value);\nconst errorText = (error: unknown): string => error instanceof Error ? error.message : String(error);\n\nconst executable = async (binary: string, cwd: string): Promise<string> => {\n // Windows stores executables with PATHEXT suffixes (\"python3\" -> \"python3.exe\");\n // probe the variants spawn would find instead of failing on the bare name.\n const extensions = process.platform === \"win32\"\n ? String(process.env.PATHEXT ?? \".COM;.EXE;.BAT;.CMD\").split(\";\").filter(Boolean)\n : [];\n const variants = (candidate: string): string[] =>\n extensions.length && !/\\.[A-Za-z0-9]+$/.test(candidate)\n ? [candidate, ...extensions.map((extension) => candidate + extension)]\n : [candidate];\n const candidates = path.isAbsolute(binary) || binary.includes(\"/\") || binary.includes(\"\\\\\")\n ? [path.resolve(cwd, binary)]\n : (process.env.PATH ?? \"\").split(path.delimiter).map((directory) => path.resolve(cwd, directory || \".\", binary));\n for (const candidate of candidates) {\n for (const variant of variants(candidate)) {\n try {\n await access(variant, constants.X_OK);\n return await realpath(variant);\n } catch {\n // Continue only during executable discovery, never after a failed spawn.\n }\n }\n }\n throw new Error(`CPython executable not found: ${binary}. Install Python 3 or set executor.cpython.binary to a trusted executable's absolute path.`);\n};\n\n// The isolation flags are exported so the sandbox tests can probe whether this\n// kernel can actually start the same sandbox, instead of treating an installed\n// bwrap as a usable one. The seccomp filter rides in on fd 4, so a probe can\n// leave the seccomp arguments off.\nexport const LINUX_BWRAP_ISOLATION_ARGS = [\"--ro-bind\", \"/\", \"/\", \"--unshare-all\", \"--die-with-parent\", \"--new-session\", \"--proc\", \"/proc\", \"--dev\", \"/dev\"] as const;\nexport const LINUX_BWRAP_SECCOMP_ARGS = [\"--seccomp\", \"4\"] as const;\n\nconst launch = async (binary: string, enforce: boolean, cwd: string): Promise<{ command: string; args: string[]; seccomp?: Buffer }> => {\n const python = await executable(binary, cwd);\n const args = [\"-I\", \"-B\", \"-u\", \"-c\", CPYTHON_CHILD_SOURCE];\n if (!enforce) return { command: python, args };\n if (process.platform === \"darwin\") {\n try { await access(\"/usr/bin/sandbox-exec\", constants.X_OK); }\n catch { throw new Error(\"Schema enforce CPython requires /usr/bin/sandbox-exec on macOS; no unsandboxed fallback is permitted.\"); }\n return { command: \"/usr/bin/sandbox-exec\", args: [\"-p\", MACOS_PROFILE, python, ...args] };\n }\n if (process.platform === \"linux\") {\n // Only system locations: a workspace/PATH shim must not masquerade as the\n // security boundary. The selected interpreter itself is trusted config.\n let bwrap: string | undefined;\n for (const candidate of [\"/usr/bin/bwrap\", \"/bin/bwrap\"]) {\n try { await access(candidate, constants.X_OK); bwrap = candidate; break; } catch { /* Try the other system path. */ }\n }\n if (!bwrap) throw new Error(\"Schema enforce CPython requires bubblewrap (/usr/bin/bwrap). Install bubblewrap and enable unprivileged user namespaces; no unsandboxed fallback is permitted.\");\n return {\n command: bwrap,\n args: [...LINUX_BWRAP_ISOLATION_ARGS, ...LINUX_BWRAP_SECCOMP_ARGS, \"--chdir\", cwd, \"--\", python, ...args],\n seccomp: linuxCPythonNetworkFilter(process.arch),\n };\n }\n throw new Error(`Schema enforce CPython has no supported OS sandbox on ${process.platform}; no unsandboxed fallback is permitted.`);\n};\n\n// Windows stdio[3] is an anonymous pipe, not a socket, so the child dials a\n// loopback listener instead; a one-time token proves the caller is our child.\nconst createIpcListener = (): Promise<{ server: net.Server; port: number; token: string }> =>\n new Promise((resolve, reject) => {\n const server = net.createServer();\n const token = randomBytes(32).toString(\"hex\");\n server.once(\"error\", reject);\n server.listen(0, \"127.0.0.1\", () => {\n const address = server.address();\n if (address === null || typeof address === \"string\") reject(new Error(\"Fabric CPython IPC listener failed to bind\"));\n else resolve({ server, port: address.port, token });\n });\n });\n\n/** A fresh CPython process per call. Only enforce=true adds an OS security boundary. */\nexport class CPythonRuntime implements FabricKernelRuntime {\n constructor(readonly binary = \"python3\", readonly enforce = false) {}\n\n async execute(code: string, hostCall: FabricHostCall, options: FabricSandboxOptions): Promise<FabricSandboxResult> {\n const failure = (terminationReason: FabricSandboxResult[\"terminationReason\"], error: string): FabricSandboxResult =>\n ({ value: undefined, logs: [], terminationReason, error });\n if (options.signal?.aborted) return failure(\"aborted\", \"Execution cancelled\");\n if (!Number.isSafeInteger(options.memoryLimitBytes) || options.memoryLimitBytes < 1) {\n return failure(\"runtime_error\", \"CPython memory limit must be a positive safe integer\");\n }\n if (!Number.isFinite(options.timeoutMs) || options.timeoutMs < 1) return failure(\"runtime_error\", \"CPython timeout must be positive\");\n const startedAt = Date.now();\n let command: Awaited<ReturnType<typeof launch>>;\n try { command = await launch(this.binary, this.enforce, options.cwd ?? process.cwd()); }\n catch (error) { return failure(\"runtime_error\", errorText(error)); }\n // Resolve first, then check before spawn: no orphan on cancellation during discovery.\n if (options.signal?.aborted) return failure(\"aborted\", \"Execution cancelled\");\n // Windows cannot inherit a socket through stdio; the child connects back instead.\n const ipc = process.platform === \"win32\" ? await createIpcListener() : undefined;\n\n return new Promise<FabricSandboxResult>((resolve) => {\n const hostAbort = new AbortController();\n const hostTasks = new Set<Promise<void>>();\n const callIds = new Set<number>();\n const logs: string[] = [];\n const partialLogs = [\"\", \"\"];\n const decoders = [new StringDecoder(\"utf8\"), new StringDecoder(\"utf8\")];\n const maxLogChars = Math.max(0, options.maxLogChars ?? 100_000);\n let logChars = 0;\n let truncated = false;\n let settled = false;\n let finishing = false;\n let deadline: NodeJS.Timeout | undefined;\n let deadlineAt = startedAt + options.timeoutMs;\n let buffer = Buffer.alloc(0);\n let child: ReturnType<typeof spawn>;\n try {\n child = spawn(command.command, command.args, {\n cwd: options.cwd ?? process.cwd(),\n // -I ignores PYTHON* and user site packages; -B avoids bytecode writes.\n // Keep ordinary environment for trusted native code, not a false secrecy claim.\n env: ipc ? { ...process.env, FABRIC_IPC_PORT: String(ipc.port), FABRIC_IPC_TOKEN: ipc.token } : process.env,\n detached: process.platform !== \"win32\",\n stdio: command.seccomp ? [\"ignore\", \"pipe\", \"pipe\", \"pipe\", \"pipe\"] : [\"ignore\", \"pipe\", \"pipe\", \"pipe\"],\n });\n } catch (error) {\n ipc?.server.close();\n resolve(failure(\"runtime_error\", `CPython process failed: ${errorText(error)}`));\n return;\n }\n let channel: Duplex | net.Socket | undefined;\n let expectedToken: string | undefined = ipc?.token;\n let childExited = child.pid === undefined;\n child.once(\"exit\", () => { childExited = true; });\n const appendLog = (index: number, text: string): void => {\n if (settled || truncated) return;\n const available = Math.max(0, maxLogChars - logChars);\n const retained = text.slice(0, available);\n logChars += retained.length;\n const lines = ((partialLogs[index] ?? \"\") + retained).split(\"\\n\");\n partialLogs[index] = lines.pop() ?? \"\";\n for (const line of lines) logs.push(line.replace(/\\r$/, \"\"));\n if (retained.length !== text.length) truncated = true;\n };\n const finish = async (result: Omit<FabricSandboxResult, \"logs\">): Promise<void> => {\n if (settled) return;\n for (let index = 0; index < decoders.length; index++) appendLog(index, decoders[index]!.end());\n settled = true;\n if (deadline) clearTimeout(deadline);\n options.signal?.removeEventListener(\"abort\", abort);\n if (!hostAbort.signal.aborted) hostAbort.abort(new Error(result.error ?? \"CPython execution ended\"));\n channel?.destroy();\n ipc?.server.close();\n child.stdout?.destroy();\n child.stderr?.destroy();\n if (child.pid && process.platform !== \"win32\") {\n try { process.kill(-child.pid, \"SIGKILL\"); } catch { /* The process group may already have exited. */ }\n }\n child.kill(\"SIGKILL\");\n // Let the terminated child release its working directory before the\n // caller observes the result; Windows rmdir fails with EBUSY while held.\n if (!childExited) {\n await new Promise<void>((done) => {\n const timer = setTimeout(done, 250);\n timer.unref?.();\n child.once(\"exit\", () => { clearTimeout(timer); done(); });\n });\n }\n for (const text of partialLogs) if (text) logs.push(text);\n if (truncated) logs.push(\"[Pi Fabric log output truncated]\");\n resolve({ ...result, logs });\n };\n const abort = (): void => void finish({ value: undefined, terminationReason: \"aborted\", error: \"Execution cancelled\" });\n const fail = (message: string): void => void finish({ value: undefined, terminationReason: \"runtime_error\", error: message });\n const scheduleDeadline = (): void => {\n if (deadline) clearTimeout(deadline);\n deadline = setTimeout(() => void finish({\n value: undefined, terminationReason: \"timed_out\", error: `Execution timed out after ${deadlineAt - startedAt}ms`,\n }), Math.max(0, deadlineAt - Date.now()));\n deadline.unref?.();\n };\n const send = (message: unknown): void => {\n // A terminal guest result closes its reply channel while issued host\n // work may still be settling. Its late replies are no longer consumed.\n if (settled || finishing || !channel || channel.destroyed) return;\n try {\n const frame = JSON.stringify(message) + \"\\n\";\n const bytes = Buffer.byteLength(frame);\n if (bytes > MAX_FRAME_BYTES || channel.writableLength + bytes > MAX_FRAME_BYTES * 2) {\n fail(\"CPython IPC frame or write buffer exceeds its 16 MiB frame limit\");\n return;\n }\n channel.write(frame, (error) => { if (error && !settled && !finishing) fail(`CPython IPC failed: ${error.message}`); });\n } catch (error) { fail(`CPython IPC serialization failed: ${errorText(error)}`); }\n };\n const handleMessage = (message: unknown): void => {\n if (settled || finishing) return;\n if (!record(message)) { fail(\"Invalid CPython IPC message\"); return; }\n if (message.type === \"result\") {\n const result = message.result;\n if (!record(result) || ![\"completed\", \"runtime_error\"].includes(String(result.terminationReason)) ||\n (result.error !== undefined && typeof result.error !== \"string\")) {\n fail(\"Invalid CPython terminal result\"); return;\n }\n finishing = true;\n if (result.terminationReason !== \"completed\") hostAbort.abort(new Error(String(result.error ?? \"Python guest failed\")));\n void (async () => {\n const done = await settleWithin(hostTasks, HOST_SETTLE_MS);\n if (!done) {\n hostAbort.abort(new Error(\"Fabric guest execution ended before its host calls settled\"));\n await settleWithin(hostTasks, HOST_SETTLE_MS);\n }\n // stdout/stderr are separate channels; allow their ready data to drain.\n await new Promise<void>((done) => setImmediate(done));\n finish({\n value: result.value,\n terminationReason: result.terminationReason as \"completed\" | \"runtime_error\",\n ...(typeof result.error === \"string\" ? { error: result.error } : {}),\n });\n })();\n return;\n }\n if (message.type !== \"call\" || !Number.isSafeInteger(message.id) || (message.id as number) < 1 ||\n typeof message.ref !== \"string\" || !message.ref || message.ref.length > 512 || !record(message.args) ||\n callIds.has(message.id as number) || hostTasks.size >= 256) {\n fail(\"Invalid or excessive CPython host call\"); return;\n }\n const id = message.id as number;\n const ref = message.ref;\n const args = message.args;\n callIds.add(id);\n try {\n const floor = options.minimumTimeoutMsForHostCall?.(ref, args);\n if (typeof floor === \"number\" && Number.isFinite(floor) && Date.now() + floor > deadlineAt) {\n deadlineAt = Date.now() + Math.max(1, Math.floor(floor));\n scheduleDeadline();\n }\n } catch (error) { fail(`CPython deadline policy failed: ${errorText(error)}`); return; }\n const task = runAbortable(hostAbort.signal, () => hostCall(ref, args, hostAbort.signal)).then(\n (value) => send({ type: \"response\", id, ok: true, value }),\n (error) => send({ type: \"response\", id, ok: false, error: errorText(error), ...(isPiShellRef(ref) ? { bashExit: piBashExitMetadata(error) } : {}) }),\n ).finally(() => { hostTasks.delete(task); callIds.delete(id); });\n hostTasks.add(task);\n };\n const onData = (chunk: Buffer): void => {\n if (settled || finishing) return;\n buffer = Buffer.concat([buffer, chunk]);\n if (expectedToken !== undefined) {\n const handshake = buffer.indexOf(10);\n if (handshake === -1) {\n if (buffer.length > 4096) fail(\"Invalid CPython IPC handshake\");\n return;\n }\n let verified = false;\n try {\n const hello = JSON.parse(buffer.subarray(0, handshake).toString(\"utf8\"));\n verified = record(hello) && hello.type === \"hello\" && hello.token === expectedToken;\n } catch { /* Fail closed below. */ }\n if (!verified) { fail(\"Invalid CPython IPC handshake\"); return; }\n buffer = buffer.subarray(handshake + 1);\n expectedToken = undefined;\n send({ type: \"execute\", code, strings: options.strings ?? {}, memoryLimitBytes: options.memoryLimitBytes });\n if (settled || finishing) return;\n }\n let newline: number;\n while ((newline = buffer.indexOf(10)) !== -1) {\n if (newline > MAX_FRAME_BYTES) { fail(\"CPython IPC frame exceeds 16 MiB\"); return; }\n const frame = buffer.subarray(0, newline).toString(\"utf8\");\n buffer = buffer.subarray(newline + 1);\n try { handleMessage(JSON.parse(frame)); }\n catch (error) { fail(`Invalid CPython IPC: ${errorText(error)}`); return; }\n if (settled || finishing) return;\n }\n if (buffer.length > MAX_FRAME_BYTES) fail(\"CPython IPC frame exceeds 16 MiB\");\n };\n const attach = (socket: Duplex | net.Socket): void => {\n channel = socket;\n if (socket instanceof net.Socket) socket.setNoDelay(true);\n socket.on(\"data\", onData);\n socket.on(\"error\", (error) => { if (!settled && !finishing) fail(`CPython IPC failed: ${error.message}`); });\n };\n child.stdout?.on(\"data\", (chunk: Buffer) => appendLog(0, decoders[0]!.write(chunk)));\n child.stderr?.on(\"data\", (chunk: Buffer) => appendLog(1, decoders[1]!.write(chunk)));\n child.on(\"error\", (error) => fail(`CPython process failed: ${error.message}${this.enforce ? \"; OS sandbox is required (no native fallback)\" : \"\"}`));\n child.on(\"close\", (exitCode, signal) => {\n if (settled || finishing) return;\n const diagnostics = [...logs, ...partialLogs].join(\"\\n\").slice(-4000);\n fail(`CPython ${this.enforce ? \"sandbox \" : \"\"}process exited before returning a result (${signal ?? exitCode}).${this.enforce ? \" Verify OS sandbox availability/user namespaces; no unsandboxed fallback is permitted.\" : \"\"}${diagnostics ? `\\n${diagnostics}` : \"\"}`);\n });\n options.signal?.addEventListener(\"abort\", abort, { once: true });\n if (options.signal?.aborted) { abort(); return; }\n if (command.seccomp) {\n const filterPipe = child.stdio[4] as Duplex;\n filterPipe.on(\"error\", (error) => { if (!settled) fail(`CPython sandbox filter failed: ${error.message}`); });\n filterPipe.end(command.seccomp);\n }\n scheduleDeadline();\n if (ipc) {\n // Windows: the child dials the loopback listener and proves the token first.\n ipc.server.on(\"connection\", (socket) => {\n if (channel) { socket.destroy(); return; }\n ipc.server.close();\n attach(socket);\n });\n } else {\n attach(child.stdio[3] as Duplex);\n send({ type: \"execute\", code, strings: options.strings ?? {}, memoryLimitBytes: options.memoryLimitBytes });\n }\n });\n }\n}\n", "// Embedded so installed bundles do not depend on a source-tree Python asset.\nexport const CPYTHON_CHILD_SOURCE = String.raw`\nimport sys\nif sys.implementation.name != \"cpython\" or sys.version_info < (3, 10):\n sys.stderr.write(\"Fabric requires CPython 3.10 or newer; set executor.cpython.binary to a supported interpreter.\\n\")\n sys.exit(1)\n\nimport ast\nimport asyncio\nimport json\nimport math\nimport os\nimport socket\nimport sys\nimport traceback\n\n_MAX_FRAME = 16 * 1024 * 1024\n_MAX_INTEGER = 9007199254740991\n_pending = {}\n_next_id = 0\n_writer = None\n\n\ndef _json_value(value):\n if value is None or isinstance(value, (str, bool)):\n return value\n if isinstance(value, int):\n if abs(value) > _MAX_INTEGER:\n raise ValueError(\"Fabric JSON integers must fit JavaScript's safe integer range; return a string instead\")\n return value\n if isinstance(value, float) and math.isfinite(value):\n return value\n if isinstance(value, (list, tuple)):\n return [_json_value(item) for item in value]\n if isinstance(value, dict) and all(isinstance(key, str) for key in value):\n return {key: _json_value(item) for key, item in value.items()}\n raise TypeError(\"Fabric values must be JSON-compatible (no bytes, non-finite numbers, callables, or custom objects)\")\n\n\nasync def _send(message):\n data = (json.dumps(_json_value(message), ensure_ascii=True, allow_nan=False) + \"\\n\").encode(\"utf-8\")\n if len(data) > _MAX_FRAME:\n raise ValueError(\"Fabric IPC frame exceeds 16 MiB\")\n _writer.write(data)\n await _writer.drain()\n\n\nclass _HostError(Exception):\n def __init__(self, message, bash_exit=None):\n super().__init__(message)\n self.bash_exit = bash_exit\n\n\nasync def _call(ref, args):\n global _next_id\n if len(_pending) >= 256:\n raise RuntimeError(\"Fabric allows at most 256 outstanding host calls\")\n _next_id += 1\n call_id = _next_id\n future = asyncio.get_running_loop().create_future()\n _pending[call_id] = future\n try:\n await _send({\"type\": \"call\", \"id\": call_id, \"ref\": ref, \"args\": args})\n return await future\n finally:\n _pending.pop(call_id, None)\n\n\nasync def _responses(reader):\n try:\n while True:\n line = await reader.readline()\n if not line:\n raise RuntimeError(\"Fabric host IPC closed\")\n message = json.loads(line)\n if message.get(\"type\") != \"response\":\n raise RuntimeError(\"Invalid Fabric host response\")\n future = _pending.get(message.get(\"id\"))\n if future is None or future.done():\n continue\n if message.get(\"ok\") is True:\n future.set_result(message.get(\"value\"))\n else:\n future.set_exception(_HostError(message.get(\"error\", \"Host call failed\"), message.get(\"bashExit\")))\n except Exception as error:\n for future in tuple(_pending.values()):\n if not future.done():\n future.set_exception(error)\n\n\n_PRIMARY = {\"read\": \"path\", \"ls\": \"path\", \"bash\": \"command\", \"powershell\": \"command\", \"grep\": \"pattern\", \"find\": \"pattern\"}\n_POSITIONAL = {\"read\": [\"path\", \"offset\", \"limit\"], \"ls\": [\"path\", \"limit\"], \"grep\": [\"pattern\", \"path\", \"limit\"], \"find\": [\"pattern\", \"path\", \"limit\"], \"write\": [\"path\", \"content\"], \"edit\": [\"path\", \"oldText\", \"newText\"], \"bash\": [\"command\"], \"powershell\": [\"command\"]}\n_DISCOVERY = {\"providers\", \"catalog\", \"list\", \"search\", \"describe\", \"call\", \"models\", \"progress\"}\n\n\ndef _arguments(ref, positional, keywords):\n args = dict(keywords)\n if not positional:\n return args\n if len(positional) == 1 and isinstance(positional[0], dict):\n if args.keys() & positional[0].keys():\n raise TypeError(\"Duplicate Fabric argument keys\")\n return {**positional[0], **args}\n if ref == \"tools.search\" and len(positional) == 1 and isinstance(positional[0], str):\n return {**args, \"query\": positional[0]}\n if ref.startswith(\"pi.\"):\n name = ref[3:]\n primary = _PRIMARY.get(name)\n if primary and len(positional) == 2 and isinstance(positional[0], str) and isinstance(positional[1], dict):\n return {**positional[1], **args, primary: positional[0]}\n fields = _POSITIONAL.get(name, [])\n if len(positional) <= len(fields):\n args.update(zip(fields, positional))\n if name == \"edit\" and (\"oldText\" in args or \"newText\" in args):\n args[\"edits\"] = [{key: args.pop(key) for key in (\"oldText\", \"newText\") if key in args}]\n return args\n raise TypeError(\"Fabric calls accept a dictionary or keyword arguments; Pi tools also accept their documented positional arguments\")\n\n\nclass _Proxy:\n def __init__(self, ref):\n self._ref = ref\n\n def __getattr__(self, name):\n if name.startswith(\"__\"):\n raise AttributeError(name)\n return _Proxy(self._ref + \".\" + name)\n\n async def __call__(self, *positional, **keywords):\n ref = self._ref\n args = _arguments(ref, positional, keywords)\n if ref == \"pi.edit\" and \"edits\" not in args and (\"oldText\" in args or \"newText\" in args):\n args[\"edits\"] = [{key: args.pop(key) for key in (\"oldText\", \"newText\") if key in args}]\n if ref.startswith(\"tools.\"):\n name = ref[6:]\n if name not in _DISCOVERY:\n raise AttributeError(\"tools is discovery/generic calls only; use pi for core tools\")\n ref = \"fabric.$\" + name\n if ref in (\"pi.bash\", \"pi.powershell\") and \"settle\" in args and type(args[\"settle\"]) is not bool:\n raise TypeError(\"pi shell settle must be a boolean; use settle=True or settle=False\")\n if ref in (\"pi.bash\", \"pi.powershell\") and \"background\" in args and type(args[\"background\"]) is not bool:\n raise TypeError(\"pi shell background must be a boolean; use background=True or background=False\")\n settle = ref in (\"pi.bash\", \"pi.powershell\") and args.pop(\"settle\", False) is True\n try:\n return await _call(ref, args)\n except _HostError as error:\n exit_info = error.bash_exit\n if settle and isinstance(exit_info, dict) and type(exit_info.get(\"exitCode\")) is int and exit_info[\"exitCode\"] > 0 and isinstance(exit_info.get(\"output\"), str):\n return {\"ok\": False, \"output\": exit_info[\"output\"], \"details\": None, \"exitCode\": exit_info[\"exitCode\"], \"error\": str(error)}\n raise\n\n\nclass _Payloads:\n def __init__(self, values):\n self._values = dict(values)\n\n def __getitem__(self, name):\n if name not in self._values:\n raise KeyError(\"Payload \" + repr(name) + \" is missing; pass it in fabric_exec.payloads\")\n return self._values[name]\n\n def __getattr__(self, name):\n return self[name]\n\n\ndef _error_text(error, source):\n # Keep user/library frames and exception chaining, not the embedded bridge.\n rendered = traceback.TracebackException.from_exception(error, limit=-24, capture_locals=False)\n lines = source.splitlines()\n pending = [(rendered, error)]\n seen = set()\n while pending:\n current, original = pending.pop()\n if id(current) in seen:\n continue\n seen.add(id(current))\n internal = set()\n tb = original.__traceback__\n while tb is not None:\n if tb.tb_frame.f_globals is globals():\n internal.add((tb.tb_frame.f_code.co_filename, tb.tb_lineno, tb.tb_frame.f_code.co_name))\n tb = tb.tb_next\n frames = []\n for frame in current.stack:\n if (frame.filename, frame.lineno, frame.name) in internal:\n continue\n if frame.filename == \"fabric-exec.py\":\n line = lines[frame.lineno - 1] if 0 < frame.lineno <= len(lines) else None\n frame = traceback.FrameSummary(frame.filename, frame.lineno,\n \"<fabric_exec>\" if frame.name == \"__fabric_program\" else frame.name,\n lookup_line=False, line=line)\n frames.append(frame)\n if isinstance(original, SyntaxError) and original.filename == \"fabric-exec.py\":\n frames = []\n current.stack = traceback.StackSummary.from_list(frames)\n if current.exc_type is _HostError:\n current.exc_type = RuntimeError\n if len(seen) >= 8:\n current.__cause__ = None\n current.__context__ = None\n if hasattr(current, \"exceptions\"):\n current.exceptions = None\n continue\n for field in (\"__cause__\", \"__context__\"):\n item = getattr(current, field)\n if item is not None:\n pending.append((item, getattr(original, field)))\n pending.extend(zip(getattr(current, \"exceptions\", None) or [], getattr(original, \"exceptions\", [])))\n text = \"\".join(rendered.format())\n if len(text) > 16000:\n text = text[:7900] + \"\\n[Python traceback truncated]\\n\" + text[-8000:]\n return text\n\nasync def _main():\n global _writer\n # Descriptor 3 is a dedicated inherited socket, never stdout/stderr. Windows\n # cannot inherit a socket through stdio, so there the child dials a loopback\n # TCP listener and proves a one-time token from the environment instead.\n port = os.environ.get(\"FABRIC_IPC_PORT\")\n token = os.environ.get(\"FABRIC_IPC_TOKEN\")\n if port and token:\n reader, _writer = await asyncio.open_connection(\"127.0.0.1\", int(port), limit=_MAX_FRAME)\n await _send({\"type\": \"hello\", \"token\": token})\n else:\n channel = socket.socket(fileno=3)\n reader, _writer = await asyncio.open_connection(sock=channel, limit=_MAX_FRAME)\n request = json.loads(await reader.readline())\n if request.get(\"type\") != \"execute\":\n raise RuntimeError(\"Invalid Fabric execution request\")\n response_task = asyncio.create_task(_responses(reader))\n try:\n # macOS does not provide a dependable address-space limit for CPython.\n # Linux bounds allocations; the parent owns the wall-clock deadline.\n if sys.platform.startswith(\"linux\"):\n import resource\n resource.setrlimit(resource.RLIMIT_AS, (request[\"memoryLimitBytes\"], request[\"memoryLimitBytes\"]))\n source = request[\"code\"]\n parsed = ast.parse(source, filename=\"fabric-exec.py\", mode=\"exec\")\n provided = request.get(\"strings\", {})\n missing = set()\n for node in ast.walk(parsed):\n key = None\n if isinstance(node, ast.Attribute) and isinstance(node.value, ast.Name) and node.value.id in (\"\u03C0\", \"payloads\") and isinstance(node.ctx, ast.Load):\n key = node.attr\n elif isinstance(node, ast.Subscript) and isinstance(node.value, ast.Name) and node.value.id in (\"\u03C0\", \"payloads\") and isinstance(node.slice, ast.Constant) and isinstance(node.slice.value, str) and isinstance(node.ctx, ast.Load):\n key = node.slice.value\n if key is not None and key not in provided:\n missing.add(key)\n if missing:\n raise KeyError(\"Pre-execution check: missing payloads \" + \", \".join(sorted(missing)) + \"; pass these keys in fabric_exec.payloads\")\n function = ast.parse(\"async def __fabric_program():\\n pass\\n\").body[0]\n function.body = parsed.body or function.body\n function.end_lineno = max(2, len(source.splitlines()))\n program = ast.fix_missing_locations(ast.Module(body=[function], type_ignores=[]))\n namespace = {name: _Proxy(name) for name in (\"pi\", \"tools\", \"mcp\", \"extensions\", \"memory\", \"state\", \"schema\", \"components\", \"compact\", \"prewalk\", \"agents\", \"mesh\")}\n payloads = _Payloads(request.get(\"strings\", {}))\n namespace.update({\"\u03C0\": payloads, \"payloads\": payloads, \"asyncio\": asyncio, \"__name__\": \"__fabric_guest__\"})\n exec(compile(program, \"fabric-exec.py\", \"exec\"), namespace)\n value = await namespace[\"__fabric_program\"]()\n sys.stdout.flush()\n sys.stderr.flush()\n await _send({\"type\": \"result\", \"result\": {\"value\": value, \"terminationReason\": \"completed\"}})\n except BaseException:\n await _send({\"type\": \"result\", \"result\": {\"terminationReason\": \"runtime_error\", \"error\": _error_text(sys.exception() if hasattr(sys, \"exception\") else sys.exc_info()[1], locals().get(\"source\", \"\"))}})\n finally:\n response_task.cancel()\n await asyncio.gather(response_task, return_exceptions=True)\n\n\ntry:\n asyncio.run(_main())\nexcept BaseException:\n traceback.print_exc()\n sys.exit(1)\n`;\n", "// Classic BPF consumed by bubblewrap --seccomp. A read-only root and a new\n// network namespace alone still expose host pathname Unix sockets. Deny new\n// sockets, endpoint changes, and io_uring's alternate socket path. Existing\n// fd3 writes (sendto with a null destination) and local asyncio socketpairs work.\nexport const linuxCPythonNetworkFilter = (architecture: string): Buffer => {\n const platform = architecture === \"x64\"\n ? { audit: 0xc000003e, socket: 41, connect: 42, bind: 49, sendto: 44, sendmsg: 46, sendmmsg: 307 }\n : architecture === \"arm64\"\n ? { audit: 0xc00000b7, socket: 198, connect: 203, bind: 200, sendto: 206, sendmsg: 211, sendmmsg: 269 }\n : undefined;\n if (!platform) throw new Error(`Schema enforce CPython seccomp is unsupported on ${architecture}; no unsandboxed fallback is permitted.`);\n const instructions: Array<[number, number, number, number]> = [];\n const load = (offset: number): void => { instructions.push([0x20, 0, 0, offset]); };\n const equal = (value: number, yes: number, no: number): void => { instructions.push([0x15, yes, no, value]); };\n const ret = (value: number): void => { instructions.push([0x06, 0, 0, value]); };\n const deny = 0x00050001; // SECCOMP_RET_ERRNO | EPERM\n const allow = 0x7fff0000;\n load(4); // seccomp_data.arch\n equal(platform.audit, 1, 0);\n ret(0x80000000); // KILL_PROCESS for alternate syscall ABIs\n load(0); // seccomp_data.nr\n instructions.push([0x45, 0, 1, 0x40000000]); // Refuse x32 ABI syscall numbers.\n ret(deny);\n for (const syscall of [platform.socket, platform.connect, platform.bind, platform.sendmsg, platform.sendmmsg, 425, 426, 427]) {\n equal(syscall, 0, 1);\n ret(deny);\n }\n equal(platform.sendto, 1, 0);\n ret(allow);\n load(48); // sendto argument 4: sockaddr pointer (low word)\n equal(0, 1, 0);\n ret(deny);\n load(52); // high word, both supported architectures are little-endian\n equal(0, 1, 0);\n ret(deny);\n ret(allow);\n const bytes = Buffer.alloc(instructions.length * 8);\n for (const [index, [code, yes, no, value]] of instructions.entries()) {\n bytes.writeUInt16LE(code, index * 8);\n bytes[index * 8 + 2] = yes;\n bytes[index * 8 + 3] = no;\n bytes.writeUInt32LE(value, index * 8 + 4);\n }\n return bytes;\n};\n"],
|
|
5
|
+
"mappings": "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",
|
|
6
6
|
"names": ["done"]
|
|
7
7
|
}
|
|
@@ -19,7 +19,7 @@ export declare const PI_CORE_NUMERIC_FIELDS: {
|
|
|
19
19
|
readonly find: readonly ["limit"];
|
|
20
20
|
readonly ls: readonly ["limit"];
|
|
21
21
|
};
|
|
22
|
-
export declare const GUEST_TYPE_DECLARATIONS = "\ntype JsonPrimitive = string | number | boolean | null;\ntype JsonValue = JsonPrimitive | JsonValue[] | { [key: string]: JsonValue };\ntype FabricTransport = \"auto\" | \"process\" | \"tmux\" | \"screen\" | \"localterm\" | \"herdr\";\ntype FabricAgentRunner = \"pi\" | \"claude\" | \"veda\";\ntype FabricKernel = \"typescript\" | \"python\";\ntype FabricThinking = \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\";\ninterface FabricActionEffect {\n kind: \"none\" | \"scoped\" | \"transactional\" | \"emission\";\n resources?: string[];\n ordering?: \"commutative\" | \"ordered\" | \"unknown\";\n}\ninterface FabricAction {\n ref: string;\n provider: string;\n name: string;\n description: string;\n inputSchema: Record<string, unknown>;\n outputSchema?: Record<string, unknown>;\n risk: \"read\" | \"write\" | \"execute\" | \"network\" | \"agent\";\n namespace?: string;\n effect?: FabricActionEffect;\n}\ninterface FabricAgentRequest {\n /** Omitted/inherit uses caller executor.kernel; concrete choices require Pi with extensions. */\n kernel?: FabricKernel | \"inherit\";\n task: string;\n name?: string;\n runner?: FabricAgentRunner;\n transport?: FabricTransport;\n model?: string;\n persona?: string;\n thinking?: FabricThinking;\n tools?: string[];\n timeoutMs?: number;\n extensions?: boolean;\n recursive?: boolean;\n /** Filesystem execution directory; relative paths resolve from the parent agent cwd. */\n cwd?: string;\n worktree?: boolean;\n schema?: Record<string, unknown>;\n prompt?: string;\n instructions?: string;\n timeout_ms?: number;\n residency?: FabricParticipantResidency;\n}\ninterface FabricHandoffCall {\n readonly ref: string;\n}\ninterface FabricHandoffFacts {\n readonly calls: readonly FabricHandoffCall[];\n count(ref?: string | readonly string[]): number;\n}\ntype FabricHandoffPredicate = (facts: Readonly<FabricHandoffFacts>) => boolean;\ninterface FabricHandoffRequest {\n kernel?: FabricKernel | \"inherit\";\n model: string;\n task?: string;\n when?: FabricHandoffPredicate;\n name?: string;\n transport?: FabricTransport;\n thinking?: FabricThinking;\n tools?: string[];\n timeoutMs?: number;\n extensions?: boolean;\n recursive?: boolean;\n schema?: Record<string, unknown>;\n prompt?: string;\n instructions?: string;\n timeout_ms?: number;\n}\ninterface FabricHandoffResult {\n scheduled: true;\n status: \"deferred\";\n boundary: \"fabric_exec_end\";\n}\ninterface FabricMainAgentInfo {\n id: string;\n name: \"Main\";\n kind: \"main\";\n status: \"idle\" | \"running\" | \"remote\";\n runner: \"pi\";\n transport: \"host\";\n cwd?: string;\n sessionId?: string;\n model?: string;\n thinking?: string;\n startedAt?: number;\n updatedAt: number;\n pendingMessages: boolean;\n local: boolean;\n}\ninterface FabricPeerInfo {\n id: string;\n name: string;\n kind: \"peer\";\n status: \"idle\" | \"running\";\n runner: \"pi\";\n transport: \"host\";\n cwd: string;\n sessionId: string;\n model?: string;\n thinking?: string;\n startedAt: number;\n updatedAt: number;\n pendingMessages: boolean;\n local: false;\n}\ntype FabricParticipantKind = \"root\" | \"agent\" | \"actor\";\ntype FabricParticipantResidency = \"session\" | \"durable\";\ntype FabricParticipantScope = \"local\" | \"lineage\" | \"project\";\ntype FabricParticipantCapability = \"steer\" | \"followUp\" | \"stop\" | \"ask\" | \"actor-bindings\" | \"attach\" | \"fabric\";\ninterface FabricParticipantInfo {\n format: 1;\n id: string;\n kind: FabricParticipantKind;\n rootId: string;\n ownerHostId: string;\n ownerIdentityId: string;\n parentId?: string;\n name: string;\n status: string;\n runner: FabricAgentRunner;\n transport: FabricTransport | \"host\";\n capabilities: FabricParticipantCapability[];\n cwd?: string;\n sessionId?: string;\n model?: string;\n thinking?: string;\n startedAt: number;\n updatedAt: number;\n finishedAt?: number;\n pendingMessages?: boolean;\n currentTool?: string;\n turns?: number;\n toolCalls?: number;\n usage?: { input: number; output: number; cacheRead: number; cacheWrite: number; cost: number };\n actorQueued?: number;\n actorMessages?: number;\n controlProtocol: \"v1\" | \"legacy\";\n residency: FabricParticipantResidency;\n local: boolean;\n stale: boolean;\n}\ntype FabricLifecycleEventType =\n | \"pi.input\"\n | \"pi.agent_start\"\n | \"pi.agent_end\"\n | \"pi.turn_end\"\n | \"pi.agent_settled\"\n | \"pi.tool_error\"\n | \"pi.session_compact\"\n | \"run.completed\"\n | \"run.failed\"\n | \"run.stopped\"\n | \"run.timed_out\"\n | \"run.resumed\"\n | \"run.detached\"\n | \"tokens.usage\"\n | \"component.state\";\ntype FabricLifecycleDelivery = \"steer\" | \"followUp\";\ninterface FabricLifecycleSource {\n id: string;\n name: string;\n kind: FabricParticipantKind;\n rootId: string;\n runner: FabricAgentRunner;\n ownerHostId?: string;\n ownerIdentityId?: string;\n}\ninterface FabricLifecycleEvent {\n version: 1;\n id: string;\n sequence: number;\n event: FabricLifecycleEventType;\n source: FabricLifecycleSource;\n occurredAt: number;\n publishedAt: number;\n runId?: string;\n status?: string;\n data?: unknown;\n}\ninterface FabricLifecycleSubscription {\n format: 1;\n id: string;\n from: string;\n events: FabricLifecycleEventType[];\n to: string;\n delivery: FabricLifecycleDelivery;\n triggerTurn: boolean;\n once: boolean;\n afterSequence: number;\n createdAt: number;\n updatedAt: number;\n createdBy: { id: string; name: string; kind: \"main\" | \"agent\" | \"actor\"; sessionId?: string };\n lastDeliveredAt?: number;\n lastEventId?: string;\n lastError?: string;\n}\ninterface FabricAgentHandle {\n /** Resolved Fabric kernel, absent for non-Fabric runners. */\n kernel?: FabricKernel;\n id: string;\n name: string;\n status: string;\n runner: FabricAgentRunner;\n /** Local execution metadata is absent for hosted participants. */\n transport?: FabricTransport;\n cwd?: string;\n rootId?: string;\n parentId?: string;\n depth?: number;\n generation?: number;\n model?: string;\n thinking?: FabricThinking;\n actorId?: string;\n actorName?: string;\n sessionId?: string;\n runnerSessionId?: string;\n attachCommand?: string;\n branch?: string;\n worktree?: string;\n text?: string;\n value?: unknown;\n error?: string;\n logFile?: string;\n residency?: FabricParticipantResidency;\n}\ninterface FabricRemoteControlResult {\n queued: true;\n messageId: string;\n routed: \"mesh\";\n acknowledged: true;\n}\ninterface FabricAgentResult extends FabricAgentHandle {\n task: string;\n startedAt: number;\n finishedAt?: number;\n turns: number;\n toolCalls: number;\n text: string;\n value?: unknown;\n error?: string;\n usage: { input: number; output: number; cacheRead: number; cacheWrite: number; cost: number };\n pendingMessages?: { steering: string[]; followUp: string[] };\n}\ninterface FabricModelInfo {\n runner?: FabricAgentRunner;\n provider: string;\n id: string;\n name: string;\n key: string;\n value?: string;\n resolvedModel?: string;\n displayName?: string;\n description?: string;\n supportsEffort?: boolean;\n supportedEffortLevels?: string[];\n supportsAdaptiveThinking?: boolean;\n supportsFastMode?: boolean;\n supportsAutoMode?: boolean;\n}\ninterface FabricLogLine {\n index?: number;\n offset: number;\n raw: string;\n parsed?: unknown;\n}\ninterface FabricAgentLog {\n id: string;\n runDirectory: string;\n logFile: string;\n status?: FabricAgentResult;\n events: FabricLogLine[];\n hasMore: boolean;\n before?: number;\n}\ninterface FabricActorLog {\n actorId: string;\n actorName: string;\n sessionFile: string;\n logDir: string;\n session: FabricLogLine[];\n sessionHasMore: boolean;\n sessionBefore?: number;\n run?: {\n runId: string;\n eventsFile: string;\n status?: FabricAgentResult;\n events: FabricLogLine[];\n hasMore: boolean;\n before?: number;\n };\n retainedRuns: string[];\n}\ninterface FabricCapabilityActionHead {\n key: string;\n parentKey: string;\n ref: string;\n name: string;\n description: string;\n descriptorHash: string;\n risk: \"read\" | \"write\" | \"execute\" | \"network\" | \"agent\";\n namespace?: string;\n effect?: FabricActionEffect;\n}\ninterface FabricCapabilityProviderHead {\n key: string;\n parentKey: string;\n name: string;\n description: string;\n descriptorHash: string;\n actions: FabricCapabilityActionHead[];\n}\ninterface FabricCapabilityCatalog {\n kind: \"pi-fabric.capability-catalog\";\n version: 1;\n root: {\n key: \"capability:fabric\";\n name: \"Fabric capabilities\";\n description: string;\n descriptorHash: string;\n };\n providers: FabricCapabilityProviderHead[];\n totalActions: number;\n indexedActions: number;\n complete: boolean;\n reasons: string[];\n}\ninterface FabricToolsApi {\ninterface FabricActionListEnvelope {\n kind: \"pi-fabric.action-list\";\n version: 1;\n actions: FabricAction[];\n /** Full visible-action count before paging. */\n total: number;\n /** True when total exceeds the returned page: more actions exist. */\n truncated: boolean;\n limit: number;\n}\ninterface FabricToolsApi {\n providers(): Promise<Array<{ name: string; description: string }>>;\n catalog(args?: { provider?: string; limit?: number }): Promise<FabricCapabilityCatalog>;\n /**\n * Capped discovery page: default 100 entries, silently truncated (hard cap\n * 1000). A short result never proves an action is absent \u2014 confirm with\n * search() or pass envelope: true to get totals and a truncated flag.\n */\n list(args?: { provider?: string; namespace?: string; query?: string; limit?: number; envelope?: boolean }): Promise<FabricAction[] | FabricActionListEnvelope>;\n search(args: { query: string; limit?: number }): Promise<FabricAction[]>;\n describe(args: { ref: string }): Promise<FabricAction>;\n call(args: { ref: string; args?: Record<string, unknown> }): Promise<unknown>;\n progress(args: { message: string }): Promise<void>;\n models(): Promise<FabricModelInfo[]>;\n}\ninterface FabricCapturedToolResult {\n content: Array<{ type: string; text?: string; [key: string]: unknown }>;\n text: string;\n details?: unknown;\n isError: boolean;\n terminate?: boolean;\n source: { path: string; source: string; scope: string; origin: string; baseDir?: string };\n}\ninterface FabricCapturedTool {\n (args?: Record<string, unknown>): Promise<FabricCapturedToolResult>;\n}\ntype FabricExtensionsApi = Record<string, FabricCapturedTool>;\n// String-primary tools (read/bash/powershell/grep/find/ls) accept a bare string; the\n// runtime proxy coerces it to { <primaryField>: string }. Lets the model write\n// the natural form (pi.bash(\"ls\")) instead of pi.bash({ command: \"ls\" }).\n// Return shapes differ by tool: read/grep/find/ls return their text as a bare\n// string (e.g. const src: string = await pi.read({ path })); shell/edit/write\n// return { ok, output, details } (e.g. const { output } = await pi.bash(...)).\n// Common alias keys (cmd\u2192command, query\u2192pattern, file\u2192path, dir\u2192path) and a\n// flat edit shape ({ path, oldText, newText }) are also accepted; the runtime\n// proxy normalizes them to the canonical form before the host validates args.\n// Bash timeout is measured in seconds; timeoutMs is converted from milliseconds.\n// After executor.shellHangMs the await still resolves ok: true with a still-running\n// notice, pid, and live output path in details; background: true (alias\n// run_in_background) detaches immediately. The process keeps writing that file.\n// Extended near-miss repairs: find's name/filename/glob \u2192 pattern, write's\n// data \u2192 content, ls's folder \u2192 path, bash's script \u2192 command; numeric option\n// fields (limit/offset/context/timeout) also accept numeric strings, coerced\n// at runtime (2322 diagnostics are suppressed by the type-checker by design).\n// String-primary tools also take a two-arg (primary, options) form \u2014\n// pi.read(\"index.ts\", { limit: 120 }) merges to { path, ...options } at\n// runtime, the positional string winning the primary field on conflict.\n// shell/edit/write envelopes are proxy-guarded so string-method access\n// (.trim(), .split(), iteration) fails with an actionable TypeError pointing\n// at .output instead of QuickJS's context-free \"not a function\" \u2014 property-\n// miss (2339) checks are suppressed by design, so the runtime gives the hint.\ntype PiPathArgument = {\n path?: string;\n file?: string;\n absolutePath?: string;\n file_path?: string;\n filePath?: string;\n filepath?: string;\n pathname?: string;\n target_file?: string;\n targetFile?: string;\n absolute_path?: string;\n fileAbsolutePath?: string;\n};\ntype PiOptionalPathArgument = {\n path?: string;\n file?: string;\n absolutePath?: string;\n file_path?: string;\n filePath?: string;\n filepath?: string;\n pathname?: string;\n target_file?: string;\n targetFile?: string;\n absolute_path?: string;\n fileAbsolutePath?: string;\n dir?: string;\n folder?: string;\n directory?: string;\n directoryPath?: string;\n};\ntype PiOldTextArgument = {\n oldText?: string;\n old?: string;\n old_string?: string;\n oldString?: string;\n old_str?: string;\n oldStr?: string;\n from?: string;\n old_value?: string;\n old_text?: string;\n oldContent?: string;\n old_content?: string;\n};\ntype PiNewTextArgument = {\n newText?: string;\n new?: string;\n replacement?: string;\n new_string?: string;\n newString?: string;\n new_str?: string;\n newStr?: string;\n to?: string;\n new_value?: string;\n new_text?: string;\n newContent?: string;\n new_content?: string;\n};\ntype PiEditOperation = PiOldTextArgument & PiNewTextArgument & { all?: boolean };\ntype PiCommandArgument = { command?: string; cmd?: string; shell?: string; cmdline?: string; script?: string; commandLine?: string };\ntype PiContentArgument = { content?: string; contents?: string; body?: string; text?: string; data?: string; fileContent?: string };\ntype PiGrepPatternArgument = { pattern?: string; query?: string; regex?: string; search?: string; q?: string; expression?: string; text?: string };\ntype PiFindPatternArgument = { pattern?: string; query?: string; regex?: string; search?: string; name?: string; filename?: string; glob?: string; expression?: string; include?: string };\n// Two-arg (primary, options) bags for the string-primary tools. Only option\n// aliases belong here (max/start/ctx/ic/...), never primary-field aliases \u2014\n// the primary field comes from the positional string.\ntype PiReadOptions = { offset?: number; limit?: number; start?: number; max?: number };\n// cwd is honored per call by the pi provider, which binds the command to a\n// shell definition rooted there; relative paths resolve from the session cwd.\n// The alias spellings mirror the shell entries in __piArgAliases: the\n// runtime repairs them, so the checker has to accept the same spellings or a\n// repairable call is rejected before it ever reaches the sandbox.\ntype PiShellOptions = {\n timeout?: number; timeoutMs?: number; settle?: boolean;\n background?: boolean; run_in_background?: boolean;\n cwd?: string; workdir?: string; directory?: string; workingDirectory?: string;\n};\ntype PiBashOptions = PiShellOptions;\ntype PiPowerShellOptions = PiShellOptions;\ntype PiGrepOptions = { path?: string; glob?: string; globPattern?: string; ignoreCase?: boolean; ic?: boolean; caseInsensitive?: boolean; literal?: boolean; context?: number; ctx?: number; limit?: number; max?: number };\ntype PiFindOptions = { path?: string; limit?: number; max?: number };\ntype PiLsOptions = { limit?: number; max?: number };\ntype PiReadArgument = string | (PiPathArgument & PiReadOptions);\ntype PiBashArgument = string | (PiCommandArgument & PiBashOptions);\ntype PiPowerShellArgument = string | (PiCommandArgument & PiPowerShellOptions);\ntype PiEditFlatArgument = PiPathArgument & PiOldTextArgument & PiNewTextArgument & { all?: boolean };\ntype PiEditArgument = PiPathArgument & ({ edits: PiEditOperation[]; all?: boolean } | PiEditFlatArgument);\ntype PiWriteArgument = string | (PiPathArgument & PiContentArgument);\ntype PiGrepArgument = string | (PiGrepPatternArgument & PiGrepOptions);\ntype PiFindArgument = string | (PiFindPatternArgument & PiFindOptions);\ntype PiLsArgument = string | (PiOptionalPathArgument & PiLsOptions);\ntype PiNumericString<T> = T extends number ? T | string : T;\ntype PiNumericStringOptions<T> = { [K in keyof T]: PiNumericString<T[K]> };\ntype PiReadCompatibilityArgument = string | (PiPathArgument & PiNumericStringOptions<PiReadOptions>);\ntype PiBashCompatibilityArgument = string | (PiCommandArgument & PiNumericStringOptions<PiBashOptions>);\ntype PiPowerShellCompatibilityArgument = string | (PiCommandArgument & PiNumericStringOptions<PiPowerShellOptions>);\ntype PiEditCompatibilityArgument = PiEditFlatArgument;\ntype PiWriteCompatibilityArgument = PiWriteArgument;\ntype PiGrepCompatibilityArgument = string | (PiGrepPatternArgument & PiNumericStringOptions<PiGrepOptions>);\ntype PiFindCompatibilityArgument = string | (PiFindPatternArgument & PiNumericStringOptions<PiFindOptions>);\ntype PiLsCompatibilityArgument = string | (PiOptionalPathArgument & PiNumericStringOptions<PiLsOptions>);\ninterface PiToolsApi {\n read(args: PiReadArgument, options?: PiReadOptions): Promise<string>;\n bash(args: PiBashArgument, options?: PiBashOptions): Promise<{ ok: true; output: string; details: unknown } | { ok: false; output: string; details: null; exitCode: number; error: string }>;\n powershell(args: PiPowerShellArgument, options?: PiPowerShellOptions): Promise<{ ok: true; output: string; details: unknown } | { ok: false; output: string; details: null; exitCode: number; error: string }>;\n edit(args: PiEditArgument): Promise<{ ok: true; output: string; details: unknown }>;\n edit(path: string, oldText: string, newText: string): Promise<{ ok: true; output: string; details: unknown }>;\n write(args: PiWriteArgument): Promise<{ ok: true; output: string; details: unknown }>;\n write(path: string, content: string): Promise<{ ok: true; output: string; details: unknown }>;\n grep(args: PiGrepArgument): Promise<string>;\n grep(pattern: string, path?: string | PiGrepOptions, limit?: number): Promise<string>;\n find(args: PiFindArgument): Promise<string>;\n find(pattern: string, path?: string | PiFindOptions, limit?: number): Promise<string>;\n ls(args?: PiLsArgument, options?: PiLsOptions): Promise<string>;\n}\ntype FabricActorHostEvent =\n | \"resources_discover\"\n | \"session_start\"\n | \"session_info_changed\"\n | \"session_before_switch\"\n | \"session_before_fork\"\n | \"session_before_compact\"\n | \"session_compact\"\n | \"session_shutdown\"\n | \"session_before_tree\"\n | \"session_tree\"\n | \"input\"\n | \"before_agent_start\"\n | \"agent_start\"\n | \"agent_end\"\n | \"agent_settled\"\n | \"turn_start\"\n | \"turn_end\"\n | \"message_start\"\n | \"message_update\"\n | \"message_end\"\n | \"context\"\n | \"before_provider_headers\"\n | \"before_provider_request\"\n | \"after_provider_response\"\n | \"tool_execution_start\"\n | \"tool_call\"\n | \"tool_execution_update\"\n | \"tool_result\"\n | \"tool_execution_end\"\n | \"model_select\"\n | \"thinking_level_select\"\n | \"user_bash\"\n | \"tool_error\";\ntype FabricActorDelivery = \"mailbox\" | \"steer\" | \"followUp\" | \"nextTurn\";\ninterface FabricActorHostMediaDescriptor {\n readonly type: \"image\";\n readonly mediaIndex: number;\n readonly mimeType: string;\n}\ninterface FabricActorHostSignal {\n readonly payload: unknown;\n readonly media?: readonly FabricActorHostMediaDescriptor[];\n readonly idle: boolean;\n readonly observedAt: number;\n}\ntype FabricActorActivation =\n | { readonly kind: \"hostEvent\"; readonly id: string; readonly source: string; readonly sequence: number; readonly createdAt: number; readonly event: FabricActorHostEvent; readonly mainRevision: number; readonly taskRevision: number; readonly signal?: FabricActorHostSignal }\n | { readonly kind: \"direct\"; readonly id: string; readonly source: string; readonly sequence: number; readonly createdAt: number }\n | { readonly kind: \"mesh\"; readonly id: string; readonly source: string; readonly sequence: number; readonly createdAt: number; readonly topic: string };\ninterface FabricActorValidityFacts {\n readonly activation: Readonly<FabricActorActivation>;\n readonly current: Readonly<{ latestActivationSequence: number; mainRevision: number; taskRevision: number; idle: boolean; now: number }>;\n}\ntype FabricActorValidityDecision = boolean | { valid: boolean; reason?: string };\ntype FabricActorBindingScope = \"session\" | \"project\";\ninterface FabricActorRunBinding { model?: string; thinking?: FabricThinking }\ntype FabricActorValidWhile = (facts: Readonly<FabricActorValidityFacts>) => FabricActorValidityDecision;\ninterface FabricActorRequestBase {\n /** Fixed at creation; ask/tell cannot change language. Global templates resolve inheritance on import. */\n kernel?: FabricKernel | \"inherit\";\n scope?: \"session\" | \"project\" | \"global\";\n name: string;\n instructions: string;\n events?: FabricActorHostEvent[];\n topics?: string[];\n responseMode?: \"text\" | \"directive\";\n coalesce?: boolean;\n runner?: FabricAgentRunner;\n model?: string;\n thinking?: FabricThinking;\n tools?: string[];\n transport?: FabricTransport;\n timeoutMs?: number;\n timeout_ms?: number;\n extensions?: boolean;\n requires?: Array<string | { ref: string; optional?: boolean }>;\n validWhile?: FabricActorValidWhile;\n residency?: FabricParticipantResidency;\n}\ntype FabricActorRequest = FabricActorRequestBase & (\n | { delivery?: \"mailbox\"; triggerTurn?: false }\n | { delivery: \"nextTurn\"; triggerTurn?: false }\n | { delivery: \"steer\" | \"followUp\"; triggerTurn: boolean }\n);\ninterface FabricActorInfo {\n kernel?: FabricKernel;\n pythonRuntime?: \"cpython\" | \"monty\";\n id: string;\n scope: \"session\" | \"project\";\n name: string;\n status: \"idle\" | \"queued\" | \"running\" | \"stopped\";\n runner: FabricAgentRunner;\n events: FabricActorHostEvent[];\n topics: string[];\n delivery: FabricActorDelivery;\n responseMode: \"text\" | \"directive\";\n triggerTurn: boolean;\n coalesce: boolean;\n model?: string;\n thinking?: FabricThinking;\n binding?: FabricActorRunBinding & { scope: \"session\"; sessionId: string; updatedAt?: number };\n projectDefaults?: FabricActorRunBinding & { scope: \"project\" };\n tools?: string[];\n timeoutMs?: number;\n extensions?: boolean;\n requirements?: Array<{ ref: string; optional?: boolean }>;\n capabilityDigest?: string;\n missingCapabilities?: string[];\n validWhile?: { version: 1; source: string };\n residency: FabricParticipantResidency;\n queued: number;\n messages: number;\n createdAt: number;\n updatedAt: number;\n lastRunId?: string;\n lastError?: string;\n sessionFile?: string;\n logDir?: string;\n}\ninterface FabricModelSwitchRequest {\n /** provider/id, a models.aliases name, or a search term; resolution tries aliases first, then exact matches, then the closest fuzzy match (recency from pi-model-sort breaks ties) against authenticated models. */\n model: string;\n /** Optional provider filter applied before matching (e.g. \"anthropic\"). */\n provider?: string;\n}\ninterface FabricModelSwitchResult {\n switched: boolean;\n /** Active model as provider/id after the call (unchanged when reason is \"already-active\"). */\n model: string;\n name?: string;\n /** Previously active provider/id when known. Absent for already-active results. */\n previous?: string;\n /** Set when the selector resolved through a configured models.aliases name. */\n alias?: string;\n /** How the selector resolved: the alias name, or one of closest/recent/latest for inexact picks. Absent for exact provider/id or bare-id matches. */\n via?: string;\n reason?: \"already-active\";\n}\ninterface FabricActorMessage {\n id: string;\n actorId: string;\n actorName: string;\n direction: \"in\" | \"out\";\n source: string;\n createdAt: number;\n text?: string;\n data?: unknown;\n action?: \"silent\" | \"message\" | \"stop\";\n runId?: string;\n error?: string;\n stale?: boolean;\n reason?: string;\n}\n// agentId/agent_id spellings repair to id during agent arg normalization.\ntype FabricAgentTargetArgs = { id: string; agentId?: string; agent_id?: string };\ninterface FabricAgentsApi {\n run(args: FabricAgentRequest): Promise<FabricAgentResult>;\n /** Hosted capability only; resumes a paused direct child without exposing its checkpoint. */\n resume(args: FabricAgentTargetArgs & { task?: string }): Promise<FabricAgentResult>;\n handoff(args: FabricHandoffRequest): Promise<FabricHandoffResult>;\n spawn(args: FabricAgentRequest): Promise<FabricAgentHandle>;\n wait(args: FabricAgentTargetArgs): Promise<FabricAgentResult>;\n /** Alias for wait. */\n join(args: FabricAgentTargetArgs): Promise<FabricAgentResult>;\n status(args: FabricAgentTargetArgs): Promise<FabricAgentResult | FabricAgentHandle | FabricMainAgentInfo | FabricActorInfo | FabricParticipantInfo>;\n list(args?: { scope?: FabricParticipantScope }): Promise<Array<FabricAgentResult | FabricAgentHandle | FabricParticipantInfo>>;\n members(args?: { scope?: FabricParticipantScope; kinds?: FabricParticipantKind[]; includeStale?: boolean }): Promise<FabricParticipantInfo[]>;\n self(): Promise<FabricParticipantInfo>;\n main(): Promise<FabricMainAgentInfo>;\n sessions(): Promise<FabricParticipantInfo[]>;\n peers(): Promise<FabricPeerInfo[]>;\n subscribe(args: {\n from: string;\n events: FabricLifecycleEventType[];\n to?: string;\n delivery: FabricLifecycleDelivery;\n triggerTurn: boolean;\n once?: boolean;\n }): Promise<FabricLifecycleSubscription>;\n subscriptions(args?: { from?: string; to?: string }): Promise<FabricLifecycleSubscription[]>;\n unsubscribe(args: FabricAgentTargetArgs): Promise<{ removed: boolean }>;\n models(args?: { runner?: FabricAgentRunner; refresh?: boolean }): Promise<FabricModelInfo[]>;\n stop(args: FabricAgentTargetArgs): Promise<FabricAgentResult | FabricActorInfo | FabricRemoteControlResult>;\n cleanup(args: FabricAgentTargetArgs & { deleteBranch?: boolean; delete_branch?: boolean }): Promise<{ cleaned: boolean }>;\n create(args: FabricActorRequest): Promise<FabricActorInfo>;\n setModel(args: { id: string; model?: string; scope?: FabricActorBindingScope }): Promise<FabricActorInfo>;\n switchModel(args: FabricModelSwitchRequest): Promise<FabricModelSwitchResult>;\n setThinking(args: { id: string; thinking?: FabricThinking; scope?: FabricActorBindingScope }): Promise<FabricActorInfo>;\n setTools(args: { id: string; tools: string[]; scope?: \"project\" | \"global\" }): Promise<FabricActorInfo>;\n setEvents(args: { id: string; events: FabricActorHostEvent[] }): Promise<FabricActorInfo>;\n setDeliveryPolicy(args: {\n id: string;\n delivery: FabricActorDelivery;\n triggerTurn: boolean;\n scope?: \"project\" | \"global\";\n }): Promise<FabricActorInfo>;\n setInstructions(args: {\n id: string;\n instructions: string;\n scope?: \"project\" | \"global\";\n }): Promise<FabricActorInfo>;\n ask(args: { id: string; message: string; data?: unknown; model?: string; thinking?: FabricThinking }): Promise<FabricActorMessage>;\n tell(args: { id: string; message: string; data?: unknown; model?: string; thinking?: FabricThinking }): Promise<{ queued: true; messageId: string }>;\n steer(args: { id: string; message: string; data?: unknown }): Promise<{ queued: true; messageId: string; routed?: \"local\" | \"main\" | \"mesh\"; acknowledged?: boolean }>;\n followUp(args: { id: string; message: string; data?: unknown }): Promise<{ queued: true; messageId: string; routed?: \"local\" | \"main\" | \"mesh\"; acknowledged?: boolean }>;\n setSteeringMode(args: { id: string; mode: \"all\" | \"one-at-a-time\" }): Promise<{ queued: true; messageId: string }>;\n setFollowUpMode(args: { id: string; mode: \"all\" | \"one-at-a-time\" }): Promise<{ queued: true; messageId: string }>;\n /** Advisory compaction of a running Pi-runner child at its next safe turn boundary. */\n compact(args: { id: string; instructions?: string }): Promise<{ queued: true; messageId: string }>;\n actorStatus(args: FabricAgentTargetArgs): Promise<FabricActorInfo>;\n actors(): Promise<FabricActorInfo[]>;\n messages(args: { id: string; limit?: number }): Promise<FabricActorMessage[]>;\n remove(args: { id: string }): Promise<{ removed: boolean }>;\n /** Drop an actor's mailbox history without stopping the actor. */\n clearMessages(args: { id: string }): Promise<FabricActorInfo>;\n /** Stamp a global template into the current project as a fresh live actor with no inherited history. */\n \"import\"(args: { id?: string; name?: string; as?: string }): Promise<FabricActorInfo>;\n /** Export a live project actor's definition to the global registry as a project-independent template. */\n \"export\"(args: { id: string; overwrite?: boolean }): Promise<FabricActorRequest & { id: string; createdAt: number; updatedAt: number }>;\n log(args: {\n id: string;\n type?: \"session\" | \"run\" | \"all\";\n lines?: number;\n before?: number;\n runId?: string;\n }): Promise<FabricActorLog | FabricAgentLog>;\n}\ninterface FabricMcpResult {\n text: string;\n content: unknown[];\n structuredContent: unknown;\n}\ninterface FabricMcpTool {\n (args?: Record<string, unknown>): Promise<FabricMcpResult | unknown>;\n}\ninterface FabricMcpServer {\n [tool: string]: FabricMcpTool;\n}\n// Management verbs stay members of mcp even when the declare line below is\n// replaced by generated per-server declarations (see the dynamic option on\n// guestTypeDeclarations), so generated surfaces intersect with this type\n// rather than re-declaring them.\ninterface FabricMcpManagement {\n servers(): Promise<Array<{ name: string; description: string | null; transport: \"http\" | \"stdio\" }>>;\n reload(): Promise<{ servers: string[] }>;\n register(args: {\n name: string;\n description?: string;\n command?: string;\n args?: string[];\n cwd?: string;\n baseUrl?: string;\n headers?: Record<string, string>;\n env?: Record<string, string>;\n overwrite?: boolean;\n }): Promise<{ registered: string }>;\n call(args: { server: string; tool: string; args?: Record<string, unknown> }): Promise<unknown>;\n}\n// Loose static surface: any server/tool name compiles and argument shapes are\n// enforced at dispatch by the registry. With descriptor data available the\n// execution service replaces the declare-const-mcp line below with a\n// schema-typed rendering of the live cache (runtime/dynamic-guest-types.ts).\ntype FabricMcpApi = Record<string, FabricMcpServer> & FabricMcpManagement;\ninterface FabricCouncilRunOptions extends FabricAgentRequest {\n roles: string[];\n}\ninterface FabricCouncilApi {\n run(args: FabricCouncilRunOptions & { synthesize?: true }): Promise<FabricAgentResult>;\n run(args: FabricCouncilRunOptions & { synthesize: false }): Promise<FabricAgentResult[]>;\n}\ninterface FabricMeshIdentity {\n id: string;\n name: string;\n kind: \"main\" | \"actor\" | \"agent\";\n sessionId?: string;\n}\ninterface FabricMeshEvent {\n id: string;\n sequence: number;\n topic: string;\n kind: string;\n from: FabricMeshIdentity;\n to?: string;\n text?: string;\n data?: unknown;\n createdAt: number;\n}\ninterface FabricMeshStateEntry<T = unknown> {\n key: string;\n value: T;\n version: number;\n updatedAt: number;\n updatedBy: FabricMeshIdentity;\n}\ninterface FabricMeshApi {\n self(): Promise<FabricMeshIdentity>;\n publish(args: { topic: string; kind?: string; to?: string; text?: string; data?: unknown; message?: string; body?: string }): Promise<FabricMeshEvent>;\n read(args?: { after?: number; topic?: string; to?: string; limit?: number; max?: number }): Promise<FabricMeshEvent[]>;\n members(args?: { scope?: FabricParticipantScope; kinds?: FabricParticipantKind[]; includeStale?: boolean; limit?: number; max?: number; include_stale?: boolean }): Promise<FabricParticipantInfo[]>;\n get<T = unknown>(args: { key: string }): Promise<FabricMeshStateEntry<T> | null>;\n list<T = unknown>(args?: { prefix?: string; limit?: number; max?: number }): Promise<Array<FabricMeshStateEntry<T>>>;\n put<T = unknown>(args: { key: string; value: T; ifVersion?: number; if_version?: number; version?: number }): Promise<FabricMeshStateEntry<T>>;\n delete(args: { key: string; ifVersion?: number; if_version?: number; version?: number }): Promise<{ deleted: boolean; version?: number }>;\n}\n// Stable-provider argument bags declare the canonical keys plus the\n// near-miss spellings repaired during argument normalization\n// (providers/arg-normalization.ts and each provider's per-action table). The\n// registry's prepare stage repairs aliases before schema validation, so a\n// call spelled with an alias typechecks instead of tripping the\n// excess-property check; the canonical key wins on conflict, and anything\n// else fails additionalProperties:false validation with the offending\n// property path named. Keep these spillover fields in sync with the provider\n// normalization tables.\ntype FabricMemoryBranches = \"active\" | \"all\";\ntype FabricMemoryQueryMode = \"literal\" | \"phrase\" | \"regex\";\ntype FabricMemoryQueryMatch = \"all\" | \"any\";\ninterface FabricMemoryEntryRange {\n first: number;\n last: number;\n}\ninterface FabricMemoryRecallArgs {\n source?: string;\n query?: string;\n queryMode?: FabricMemoryQueryMode;\n queryMatch?: FabricMemoryQueryMatch;\n expectedSourceHash?: string;\n expectedLineageFingerprint?: string;\n branches?: FabricMemoryBranches;\n scope?: string;\n offset?: number;\n pageSize?: number;\n snippetChars?: number;\n role?: string;\n tool?: string;\n ref?: string;\n provider?: string;\n action?: string;\n outcome?: \"succeeded\" | \"failed\" | \"aborted\" | \"timed_out\";\n since?: number;\n until?: number;\n entryRange?: FabricMemoryEntryRange;\n q?: string;\n limit?: number;\n max?: number;\n page_size?: number;\n snippet_chars?: number;\n query_mode?: FabricMemoryQueryMode;\n query_match?: FabricMemoryQueryMatch;\n entry_range?: FabricMemoryEntryRange;\n}\ninterface FabricMemoryExpandArgs {\n source?: string;\n session: string;\n expectedSourceHash?: string;\n expectedLineageFingerprint?: string;\n branches?: FabricMemoryBranches;\n indices?: number[];\n entryIds?: string[];\n operationAddresses?: string[];\n entryRange?: FabricMemoryEntryRange;\n before?: number;\n after?: number;\n entryOffset?: number;\n textOffset?: number;\n maxChars?: number;\n maxEntries?: number;\n id?: string;\n file?: string;\n path?: string;\n session_id?: string;\n index?: number;\n entry_ids?: string[];\n operation_addresses?: string[];\n entry_range?: FabricMemoryEntryRange;\n entry_offset?: number;\n text_offset?: number;\n max_chars?: number;\n max_entries?: number;\n}\ninterface FabricMemoryCall<Ref extends string, Args> {\n ref: Ref;\n args: Args;\n}\ninterface FabricMemoryRecallEntryHit {\n kind: \"entry\";\n sessionId: string;\n tier: \"hot\" | \"cold\";\n index: number;\n entryId: string | null;\n parentId: string | null;\n operationAddress: string | null;\n type: string;\n role: string | null;\n tool: string | null;\n ref: string | null;\n provider: string | null;\n action: string | null;\n timestamp: number | null;\n isError: boolean;\n outcome?: \"succeeded\" | \"failed\" | \"aborted\" | \"timed_out\";\n score: number;\n snippet: string;\n truncated: boolean;\n follow: FabricMemoryCall<\"memory.expand\", FabricMemoryExpandArgs>;\n}\ninterface FabricMemoryRecallSessionHit {\n kind: \"session\";\n sessionId: string;\n tier: \"cold\";\n cwd: string;\n lastTimestamp: number | null;\n score: number;\n matchedTerms: number;\n matchedStructuralEntries: number;\n follow: FabricMemoryCall<\"memory.recall\", FabricMemoryRecallArgs>;\n}\ntype FabricMemoryRecallHit = FabricMemoryRecallEntryHit | FabricMemoryRecallSessionHit;\ninterface FabricMemoryError {\n code: string;\n message: string;\n [key: string]: unknown;\n}\ninterface FabricMemoryCoverage {\n complete: boolean;\n indexedSessions: number;\n eligibleSessions: number;\n staleSessions: number;\n incompleteSessions: number;\n reasons: string[];\n error?: FabricMemoryError;\n}\ninterface FabricMemoryRecallResult {\n total: number;\n hits: FabricMemoryRecallHit[];\n next: FabricMemoryCall<\"memory.recall\", FabricMemoryRecallArgs> | null;\n coverage: FabricMemoryCoverage;\n error?: FabricMemoryError;\n}\ninterface FabricMemoryExpandedEntry {\n index: number;\n entryId: string | null;\n parentId: string | null;\n type: string | null;\n role: string | null;\n timestamp: number | null;\n isError: boolean;\n anchor?: boolean;\n text: string;\n textRange: { start: number; end: number; total: number; complete: boolean };\n parentEntryId?: string | null;\n operationAddress?: string | null;\n tool?: string | null;\n ref?: string | null;\n provider?: string | null;\n action?: string | null;\n outcome?: \"succeeded\" | \"failed\" | \"aborted\" | \"timed_out\";\n filesTouched?: Array<string | null>;\n operation?: unknown;\n branchFact?: unknown;\n structuredTruncated?: boolean;\n factAddress?: string | null;\n carrierEntryId?: string | null;\n carrierParentId?: string | null;\n carrierFromId?: string | null;\n}\ninterface FabricMemoryExpandResult {\n session?: string;\n sourceHash?: string;\n branches?: FabricMemoryBranches;\n lineageFingerprint?: string;\n entryCount?: number;\n entries: FabricMemoryExpandedEntry[];\n next?: FabricMemoryCall<\"memory.expand\", FabricMemoryExpandArgs> | null;\n error?: FabricMemoryError;\n}\ninterface FabricMemoryWalkResult {\n visited: number;\n stopped: boolean;\n error?: FabricMemoryError;\n}\ninterface FabricMemorySessionInfo {\n id: string;\n file: string;\n cwd: string;\n mtime: number;\n entryCount: number;\n tier: \"hot\" | \"cold\";\n branches: FabricMemoryBranches;\n lineageFingerprint: string | null;\n}\ninterface FabricMemoryApi {\n recall(args?: FabricMemoryRecallArgs): Promise<FabricMemoryRecallResult>;\n expand(args: FabricMemoryExpandArgs): Promise<FabricMemoryExpandResult>;\n walk(\n args: FabricMemoryExpandArgs,\n visitor: (\n entry: FabricMemoryExpandedEntry,\n index: number,\n ) => boolean | void | Promise<boolean | void>,\n ): Promise<FabricMemoryWalkResult>;\n sessions(args?: {\n source?: string;\n scope?: string;\n branches?: FabricMemoryBranches;\n limit?: number;\n max?: number;\n }): Promise<{\n scope?: string;\n branches?: FabricMemoryBranches;\n sessions?: FabricMemorySessionInfo[];\n error?: FabricMemoryError;\n }>;\n}\ninterface FabricStateTransitionArgs {\n label: string;\n from?: string;\n to: string;\n summary: string;\n evidence?: string[];\n tags?: string[];\n kind?: \"state\" | \"representation\";\n complexity?: { files: string[] };\n force?: boolean;\n name?: string;\n description?: string;\n}\ninterface FabricStateComplexityFile {\n file: string;\n supported: boolean;\n language?: string;\n current?: number;\n recorded?: number;\n delta?: number;\n recordedDelta?: number;\n}\ninterface FabricStateVerificationResult {\n certified: boolean;\n violated: boolean;\n certificationStatus: \"certified\" | \"failed\";\n results: unknown[];\n failures: unknown[];\n certificate?: unknown;\n reportingError?: string;\n evidenceDigest: string;\n resultDigest: string;\n}\ninterface FabricStateApi {\n transition(args: FabricStateTransitionArgs): Promise<{ event: FabricMeshEvent; head: unknown }>;\n get(): Promise<{\n head: unknown | null;\n goal: { check: string; description?: string } | null;\n complexity: { files: number; decisionPoints: number; lastNetDelta: number };\n certification: { current: unknown | null; recent: unknown[] };\n recentLabels: string[];\n }>;\n history(args?: { label?: string; limit?: number; includeArchived?: boolean; name?: string; max?: number }): Promise<{\n transitions: unknown[];\n labels: string[];\n certifications: unknown[];\n }>;\n complexity(args?: { files?: string[]; paths?: string[] }): Promise<{ files: FabricStateComplexityFile[]; netDelta: number }>;\n verify(args?: { labels?: string[]; includeArchived?: boolean; timeoutMs?: number; label?: string }): Promise<FabricStateVerificationResult>;\n goal(args: { check: string; description?: string; command?: string; cmd?: string; predicate?: string }): Promise<FabricMeshStateEntry<{ check: string; description?: string }>>;\n checkGoal(args?: { timeoutMs?: number }): Promise<{\n passed: boolean;\n output: string;\n exitCode: number | null;\n error?: string;\n }>;\n}\ntype FabricSchemaEvidence =\n | { kind: \"file_exists\"; path: string }\n | { kind: \"file_absent\"; path: string }\n | { kind: \"file_contains\"; path: string; literal: string }\n | { kind: \"file_sha256\"; path: string; sha256: string }\n | { kind: \"trusted_command\"; name: string };\ntype FabricSchemaFileOperation =\n | { kind: \"write\"; path: string; content: string; expected: { absent: true } | { sha256: string } }\n | { kind: \"edit\"; path: string; oldText: string; newText: string; expectedSha256: string }\n | { kind: \"delete\"; path: string; expectedSha256: string };\ninterface FabricSchemaEvidenceResult {\n evidence: FabricSchemaEvidence;\n status: \"confirmed\" | \"nonconfirmed\" | \"error\";\n detail: string;\n exitCode?: number | null;\n output?: string;\n observedSha256?: string;\n}\ninterface FabricSchemaStatus {\n mode: \"off\" | \"audit\" | \"enforce\";\n certificateTtlMs: number;\n maxFiles: number;\n maxBytes: number;\n trustedCommands: string[];\n generation: number;\n lastOutcome: \"committed\" | \"rolled_back\" | \"quarantined\" | null;\n hypotheses: Array<{\n id: string;\n label: string;\n status: string;\n generation: number;\n updatedAt: number;\n }>;\n}\ninterface FabricSchemaVerificationResult {\n verified: boolean;\n hypothesisId: string;\n certificate?: string;\n issuedAt?: number;\n expiresAt?: number;\n reason?: string;\n results: FabricSchemaEvidenceResult[];\n}\ninterface FabricSchemaCommitResult {\n outcome: \"committed\" | \"rolled_back\" | \"quarantined\";\n transactionId: string;\n generation?: number;\n paths?: string[];\n postconditions?: FabricSchemaEvidenceResult[];\n complexityReductionCertified?: boolean;\n stateTransition?: unknown;\n error?: string;\n rollbackError?: string;\n}\ninterface FabricSchemaApi {\n status(): Promise<FabricSchemaStatus>;\n hypothesize(args: {\n label: string;\n summary: string;\n evidence: FabricSchemaEvidence[];\n complexityReduction?: boolean;\n name?: string;\n description?: string;\n complexity_reduction?: boolean;\n }): Promise<{\n hypothesisId: string;\n status: string;\n state: unknown;\n fingerprint: string;\n generation: number;\n }>;\n verify(args: { hypothesisId: string; id?: string; hypothesis_id?: string }): Promise<FabricSchemaVerificationResult>;\n commit(args: {\n hypothesisId: string;\n certificate: string;\n operations: FabricSchemaFileOperation[];\n postconditions: FabricSchemaEvidence[];\n id?: string;\n hypothesis_id?: string;\n }): Promise<FabricSchemaCommitResult>;\n abort(args: { hypothesisId: string; certificate?: string; id?: string; hypothesis_id?: string }): Promise<{\n aborted: true;\n hypothesisId: string;\n }>;\n}\ninterface FabricCompactPendingIntent {\n reason?: string;\n instructions?: string;\n preserve?: string[];\n requestedBy: string;\n requestedAt: number;\n}\ninterface FabricCompactLastCommit {\n at: number;\n requestedBy: string;\n status: \"committed\" | \"cancelled\" | \"failed\";\n summary?: string;\n tokensBefore?: number;\n estimatedTokensAfter?: number;\n error?: string;\n}\ntype FabricComponentState = \"waiting\" | \"loading\" | \"active\" | \"unloading\" | \"failed\" | \"quarantined\" | \"disposed\";\ninterface FabricComponentEffectInfo {\n label: string;\n kind: \"none\" | \"scoped\" | \"transactional\" | \"emission\";\n resources: string[];\n ordering: \"commutative\" | \"ordered\" | \"unknown\";\n}\ninterface FabricComponentEffectConflict {\n withComponent: string;\n resources: string[];\n reason: \"shared_resource\" | \"unknown_resource\";\n}\ninterface FabricComponentInfo {\n id: string;\n component: string;\n parentId?: string;\n state: FabricComponentState;\n guarantee: \"managed\" | \"revertible\";\n requirements: string[];\n provisions: string[];\n missing: string[];\n optionalMissing: string[];\n effects?: FabricComponentEffectInfo[];\n effectConflicts?: FabricComponentEffectConflict[];\n targetDigest?: string;\n error?: string;\n cleanupErrors?: string[];\n revision: number;\n createdAt: number;\n updatedAt: number;\n}\ninterface FabricComponentEntry {\n id: string;\n component: string;\n config?: unknown;\n disabled?: boolean;\n}\ninterface FabricComponentDefinitionInfo {\n name: string;\n description?: string;\n revision: number;\n configSchema?: Record<string, unknown>;\n requirements: string[];\n provisions: string[];\n}\ninterface FabricComponentConfigSource {\n scope: \"global\" | \"project\";\n path: string;\n trusted: boolean;\n present: boolean;\n selected: boolean;\n}\ninterface FabricComponentConfigurationInfo {\n sources: FabricComponentConfigSource[];\n warnings: string[];\n sessionOverrides: string[];\n removalPolicy: \"drain\";\n error?: string;\n}\ninterface FabricComponentChangeRequest {\n scope?: \"session\" | \"global\" | \"project\";\n entries?: FabricComponentEntry[];\n remove?: string[];\n reset?: string[];\n}\ninterface FabricComponentChangePlan {\n revision: string;\n request: Required<FabricComponentChangeRequest>;\n changes: Array<{ id: string; operation: \"add\" | \"replace\" | \"remove\"; component: string; requirements: string[]; provisions: string[] }>;\n warnings: string[];\n sources: FabricComponentConfigSource[];\n}\ninterface FabricComponentsApi {\n list(): Promise<{\n definitions: FabricComponentDefinitionInfo[];\n components: FabricComponentInfo[];\n configuration: FabricComponentConfigurationInfo;\n }>;\n describe(args: { component: string }): Promise<FabricComponentDefinitionInfo & { instances: FabricComponentInfo[] }>;\n plan(args: FabricComponentChangeRequest): Promise<FabricComponentChangePlan>;\n apply(args: FabricComponentChangeRequest & { expectedRevision: string }): Promise<{ components: FabricComponentInfo[]; configuration: FabricComponentConfigurationInfo; scope: \"session\" | \"global\" | \"project\" }>;\n reconcile(): Promise<{ components: FabricComponentInfo[]; configuration: FabricComponentConfigurationInfo }>;\n status(args: { id: string }): Promise<FabricComponentInfo>;\n graph(): Promise<{\n components: FabricComponentInfo[];\n edges: Array<{ from: string; to: string; ref: string; kind?: \"dependency\" | \"ownership\" }>;\n cycles: string[][];\n }>;\n reload(args?: { id?: string }): Promise<{ components: FabricComponentInfo[] }>;\n}\n\ninterface FabricCompactApi {\n request(args?: {\n reason?: string;\n instructions?: string;\n preserve?: string[];\n requestedBy?: string;\n instruction?: string;\n requested_by?: string;\n }): Promise<{ requested: true; intent: FabricCompactPendingIntent }>;\n status(): Promise<{ pending?: FabricCompactPendingIntent; last?: FabricCompactLastCommit }>;\n cancel(): Promise<{ cancelled: true }>;\n}\n\ninterface FabricWorkflowAgentOptions extends Omit<FabricAgentRequest, \"task\"> {\n label?: string;\n}\ntype FabricActivityStatus = \"pending\" | \"running\" | \"completed\" | \"failed\" | \"blocked\" | \"stopped\";\ntype FabricActivityKind = \"agent\" | \"actor\" | \"tool\" | \"extension\" | \"mcp\" | \"mesh\" | \"task\" | \"custom\";\ninterface FabricWorkflowDisplay {\n name?: string;\n description?: string;\n}\ninterface FabricWorkflowPhaseOptions {\n id?: string;\n description?: string;\n total?: number;\n}\ninterface FabricWorkflowPhaseInput extends FabricWorkflowPhaseOptions {\n name: string;\n}\ninterface FabricWorkflowItem {\n id: string;\n label: string;\n status?: FabricActivityStatus;\n phase?: string;\n detail?: string;\n kind?: FabricActivityKind;\n current?: string;\n total?: number;\n completed?: number;\n data?: unknown;\n}\ninterface FabricWorkflowApi {\n agent<T = string>(prompt: string, options?: FabricWorkflowAgentOptions): Promise<T>;\n parallel<T, R>(items: T[], mapper: (item: T, index: number) => Promise<R> | R, concurrency?: number | { concurrency?: number }): Promise<R[]>;\n parallel<T>(thunks: Array<() => Promise<T> | T>, concurrency?: number | { concurrency?: number }): Promise<T[]>;\n pipeline<T>(items: T[], ...stages: Array<(value: unknown, original: T, index: number) => Promise<unknown> | unknown>): Promise<unknown[]>;\n configure(display: FabricWorkflowDisplay): Promise<FabricWorkflowDisplay>;\n phase(name: string, options?: FabricWorkflowPhaseOptions): Promise<{ name: string; index: number; id?: string }>;\n phase(input: FabricWorkflowPhaseInput): Promise<{ name: string; index: number; id?: string }>;\n item(item: FabricWorkflowItem): Promise<FabricWorkflowItem>;\n event(event: { message: string; level?: \"info\" | \"success\" | \"warning\" | \"error\"; data?: unknown }): Promise<void>;\n log(...values: unknown[]): void;\n budget: { total: number; spent(): number; remaining(): number };\n}\ndeclare const tools: FabricToolsApi;\ndeclare const pi: PiToolsApi;\ndeclare const extensions: FabricExtensionsApi;\ndeclare const agents: FabricAgentsApi;\ndeclare const mesh: FabricMeshApi;\ndeclare const mcp: FabricMcpApi;\ndeclare const memory: FabricMemoryApi;\ndeclare const state: FabricStateApi;\ndeclare const schema: FabricSchemaApi;\ndeclare const components: FabricComponentsApi;\ndeclare const compact: FabricCompactApi;\n\ntype FabricJevJson = null | boolean | number | string | FabricJevJson[] | { [key: string]: FabricJevJson };\ntype FabricJevDescription = string | FabricJevJson[] | { [key: string]: FabricJevJson };\ntype FabricJevQuestion =\n | { type: \"noul\"; instructions: FabricJevDescription; criteria?: { true?: FabricJevDescription; false?: FabricJevDescription } }\n | { type: \"choice\"; instructions: FabricJevDescription; criteria: Record<string, FabricJevDescription | null> }\n | { type: \"score\"; instructions: FabricJevDescription; criteria: FabricJevDescription[] };\ntype FabricJevAnswer<Q extends FabricJevQuestion> = Q extends { type: \"noul\" }\n ? { type: \"noul\"; noul: number }\n : Q extends { type: \"choice\"; criteria: infer C }\n ? { type: \"choice\"; choice: Extract<keyof C, string>; confidence: number; probabilities: Record<Extract<keyof C, string>, number> }\n : { type: \"score\"; score: number; confidence: number; probabilities: Record<string, number>; legend: Record<string, FabricJevJson> };\ninterface FabricJevProgram {\n name: string;\n code: string;\n inputSchema: Record<string, unknown>;\n outputSchema: Record<string, unknown>;\n requires: string[];\n limits?: { timeoutMs?: number; maxEvaluations?: number; maxToolCalls?: number; maxTokens?: number };\n}\ntype FabricJevHostEventName = \"input\" | \"turn_end\" | \"tool_error\" | \"agent_end\" | \"agent_settled\";\ninterface FabricJevObserve {\n events: FabricJevHostEventName[];\n include?: Array<\"inputText\" | \"assistantText\" | \"toolResults\">;\n maxChars?: number; queueSize?: number; maxEventAgeMs?: number;\n delivery?: \"steer\" | \"followUp\"; triggerTurn?: boolean; maxAdvice?: number;\n}\ninterface FabricJevHostEvent {\n id: string; sequence: number; event: FabricJevHostEventName; source: \"main\";\n sessionId: string; revision: number; at: number; payload: FabricJevJson; truncated: boolean;\n}\ninterface FabricJevObservationStats {\n events: FabricJevHostEventName[]; received: number; consumed: number; dropped: number; queued: number;\n adviceDelivered: number; adviceSuppressed: number;\n}\ninterface FabricJevAdviceResult {\n delivered: boolean;\n reason?: \"disabled\" | \"stale\" | \"duplicate\" | \"budget\" | \"feedback\" | \"delivery_failed\";\n}\ninterface FabricJevRun<T = unknown> {\n id: string; name: string; state: \"running\" | \"completed\" | \"failed\" | \"cancelled\" | \"timed_out\";\n background: boolean; startedAt: number; endedAt?: number; result?: T; error?: string;\n evaluations: number; toolCalls: number; usage: { input_tokens: number; output_tokens: number };\n events: Array<{ sequence: number; at: number; value: FabricJevJson }>; nextSequence: number; logs: string[];\n observation?: FabricJevObservationStats;\n}\ninterface FabricJevApi {\n evaluate<Q extends Record<string, FabricJevQuestion>>(args: {\n state: string | FabricJevJson[] | { [key: string]: FabricJevJson }; questions: Q; model?: string;\n }): Promise<{ model: string; answers: { [K in keyof Q]: FabricJevAnswer<Q[K]> }; usage: { input_tokens: number; output_tokens: number } }>;\n run<T = unknown>(args: { program: FabricJevProgram; input: FabricJevJson }): Promise<FabricJevRun<T>>;\n spawn(args: { program: FabricJevProgram; input: FabricJevJson; observe?: FabricJevObserve }): Promise<FabricJevRun>;\n status(args?: { id?: never; after?: never }): Promise<{ credentials: { configured: boolean; source: \"pi\" | \"environment\" | \"command\" | \"missing\"; verified: boolean }; model: string; runs: Array<{ id: string; name: string; state: string; background: boolean; startedAt: number; evaluations: number; toolCalls: number; observation?: FabricJevObservationStats }> }>;\n status<T = unknown>(args: { id: string; after?: number }): Promise<FabricJevRun<T>>;\n wait<T = unknown>(args: { id: string }): Promise<FabricJevRun<T>>;\n /** Alias for wait. */\n join<T = unknown>(args: { id: string }): Promise<FabricJevRun<T>>;\n advise(args: { id: string; eventId: string; message: string }): Promise<FabricJevAdviceResult>;\n stop(args: { id: string }): Promise<FabricJevRun>;\n}\ndeclare const jev: FabricJevApi;\n\ndeclare const council: FabricCouncilApi;\ndeclare const workflow: FabricWorkflowApi;\ndeclare function agent<T = string>(prompt: string, options?: FabricWorkflowAgentOptions): Promise<T>;\ndeclare function parallel<T, R>(items: T[], mapper: (item: T, index: number) => Promise<R> | R, concurrency?: number | { concurrency?: number }): Promise<R[]>;\ndeclare function parallel<T>(thunks: Array<() => Promise<T> | T>, concurrency?: number | { concurrency?: number }): Promise<T[]>;\ndeclare function pipeline<T>(items: T[], ...stages: Array<(value: unknown, original: T, index: number) => Promise<unknown> | unknown>): Promise<unknown[]>;\ndeclare function phase(name: string, options?: FabricWorkflowPhaseOptions): Promise<{ name: string; index: number; id?: string }>;\ndeclare function phase(input: FabricWorkflowPhaseInput): Promise<{ name: string; index: number; id?: string }>;\ndeclare function log(...values: unknown[]): void;\ndeclare const budget: FabricWorkflowApi[\"budget\"];\ntype FabricRlmRequest = Omit<FabricAgentRequest, \"runner\" | \"recursive\"> & { runner?: \"pi\" };\ndeclare const rlm: { query(args: FabricRlmRequest): Promise<FabricAgentResult> };\ninterface FabricConsole {\n log(...args: unknown[]): void;\n info(...args: unknown[]): void;\n warn(...args: unknown[]): void;\n error(...args: unknown[]): void;\n}\ndeclare const console: FabricConsole;\ndeclare const \u03C0: Readonly<Record<string, string>>;\n// Process runtimes only: node/bun children bridge native-module imports;\n// quickjs has no module loader and rejects __fabricImport at runtime.\ndeclare function __fabricImport(specifier: string): Promise<any>;\ndeclare function print(...args: unknown[]): void;\ndeclare function setTimeout(handler: (...args: any[]) => void, timeout?: number): number;\ndeclare function clearTimeout(handle: number): void;\ndeclare function setInterval(handler: (...args: any[]) => void, timeout?: number): number;\ndeclare function clearInterval(handle: number): void;\n// Process runtimes only: the bun-process child binds the host's real Bun\n// module namespace as __bun; undefined under node-process and quickjs.\ndeclare const __bun: any;\n";
|
|
22
|
+
export declare const GUEST_TYPE_DECLARATIONS = "\ntype JsonPrimitive = string | number | boolean | null;\ntype JsonValue = JsonPrimitive | JsonValue[] | { [key: string]: JsonValue };\ntype FabricTransport = \"auto\" | \"process\" | \"tmux\" | \"screen\" | \"localterm\" | \"herdr\";\ntype FabricAgentRunner = \"pi\" | \"claude\" | \"veda\";\ntype FabricKernel = \"typescript\" | \"python\";\ntype FabricThinking = \"off\" | \"minimal\" | \"low\" | \"medium\" | \"high\" | \"xhigh\" | \"max\";\ninterface FabricActionEffect {\n kind: \"none\" | \"scoped\" | \"transactional\" | \"emission\";\n resources?: string[];\n ordering?: \"commutative\" | \"ordered\" | \"unknown\";\n}\ninterface FabricAction {\n ref: string;\n provider: string;\n name: string;\n description: string;\n inputSchema: Record<string, unknown>;\n outputSchema?: Record<string, unknown>;\n risk: \"read\" | \"write\" | \"execute\" | \"network\" | \"agent\";\n namespace?: string;\n effect?: FabricActionEffect;\n}\ninterface FabricAgentRequest {\n /** Omitted/inherit uses caller executor.kernel; concrete choices require Pi with extensions. */\n kernel?: FabricKernel | \"inherit\";\n task: string;\n name?: string;\n runner?: FabricAgentRunner;\n transport?: FabricTransport;\n model?: string;\n persona?: string;\n thinking?: FabricThinking;\n tools?: string[];\n timeoutMs?: number;\n extensions?: boolean;\n recursive?: boolean;\n /** Filesystem execution directory; relative paths resolve from the parent agent cwd. */\n cwd?: string;\n worktree?: boolean;\n schema?: Record<string, unknown>;\n prompt?: string;\n instructions?: string;\n timeout_ms?: number;\n residency?: FabricParticipantResidency;\n}\ninterface FabricHandoffCall {\n readonly ref: string;\n}\ninterface FabricHandoffFacts {\n readonly calls: readonly FabricHandoffCall[];\n count(ref?: string | readonly string[]): number;\n}\ntype FabricHandoffPredicate = (facts: Readonly<FabricHandoffFacts>) => boolean;\ninterface FabricHandoffRequest {\n kernel?: FabricKernel | \"inherit\";\n model: string;\n task?: string;\n when?: FabricHandoffPredicate;\n name?: string;\n transport?: FabricTransport;\n thinking?: FabricThinking;\n tools?: string[];\n timeoutMs?: number;\n extensions?: boolean;\n recursive?: boolean;\n schema?: Record<string, unknown>;\n prompt?: string;\n instructions?: string;\n timeout_ms?: number;\n}\ninterface FabricHandoffResult {\n scheduled: true;\n status: \"deferred\";\n boundary: \"fabric_exec_end\";\n}\ninterface FabricMainAgentInfo {\n id: string;\n name: \"Main\";\n kind: \"main\";\n status: \"idle\" | \"running\" | \"remote\";\n runner: \"pi\";\n transport: \"host\";\n cwd?: string;\n sessionId?: string;\n model?: string;\n thinking?: string;\n startedAt?: number;\n updatedAt: number;\n pendingMessages: boolean;\n local: boolean;\n}\ninterface FabricPeerInfo {\n id: string;\n name: string;\n kind: \"peer\";\n status: \"idle\" | \"running\";\n runner: \"pi\";\n transport: \"host\";\n cwd: string;\n sessionId: string;\n model?: string;\n thinking?: string;\n startedAt: number;\n updatedAt: number;\n pendingMessages: boolean;\n local: false;\n}\ntype FabricParticipantKind = \"root\" | \"agent\" | \"actor\";\ntype FabricParticipantResidency = \"session\" | \"durable\";\ntype FabricParticipantScope = \"local\" | \"lineage\" | \"project\";\ntype FabricParticipantCapability = \"steer\" | \"followUp\" | \"stop\" | \"ask\" | \"actor-bindings\" | \"attach\" | \"fabric\";\ninterface FabricParticipantInfo {\n format: 1;\n id: string;\n kind: FabricParticipantKind;\n rootId: string;\n ownerHostId: string;\n ownerIdentityId: string;\n parentId?: string;\n name: string;\n status: string;\n runner: FabricAgentRunner;\n transport: FabricTransport | \"host\";\n capabilities: FabricParticipantCapability[];\n cwd?: string;\n sessionId?: string;\n model?: string;\n thinking?: string;\n startedAt: number;\n updatedAt: number;\n finishedAt?: number;\n pendingMessages?: boolean;\n currentTool?: string;\n turns?: number;\n toolCalls?: number;\n usage?: { input: number; output: number; cacheRead: number; cacheWrite: number; cost: number };\n actorQueued?: number;\n actorMessages?: number;\n controlProtocol: \"v1\" | \"legacy\";\n residency: FabricParticipantResidency;\n local: boolean;\n stale: boolean;\n}\ntype FabricLifecycleEventType =\n | \"pi.input\"\n | \"pi.agent_start\"\n | \"pi.agent_end\"\n | \"pi.turn_end\"\n | \"pi.agent_settled\"\n | \"pi.tool_error\"\n | \"pi.session_compact\"\n | \"run.completed\"\n | \"run.failed\"\n | \"run.stopped\"\n | \"run.timed_out\"\n | \"run.resumed\"\n | \"run.detached\"\n | \"tokens.usage\"\n | \"component.state\";\ntype FabricLifecycleDelivery = \"steer\" | \"followUp\";\ninterface FabricLifecycleSource {\n id: string;\n name: string;\n kind: FabricParticipantKind;\n rootId: string;\n runner: FabricAgentRunner;\n ownerHostId?: string;\n ownerIdentityId?: string;\n}\ninterface FabricLifecycleEvent {\n version: 1;\n id: string;\n sequence: number;\n event: FabricLifecycleEventType;\n source: FabricLifecycleSource;\n occurredAt: number;\n publishedAt: number;\n runId?: string;\n status?: string;\n data?: unknown;\n}\ninterface FabricLifecycleSubscription {\n format: 1;\n id: string;\n from: string;\n events: FabricLifecycleEventType[];\n to: string;\n delivery: FabricLifecycleDelivery;\n triggerTurn: boolean;\n once: boolean;\n afterSequence: number;\n createdAt: number;\n updatedAt: number;\n createdBy: { id: string; name: string; kind: \"main\" | \"agent\" | \"actor\"; sessionId?: string };\n lastDeliveredAt?: number;\n lastEventId?: string;\n lastError?: string;\n}\ninterface FabricAgentHandle {\n /** Resolved Fabric kernel, absent for non-Fabric runners. */\n kernel?: FabricKernel;\n id: string;\n name: string;\n status: string;\n runner: FabricAgentRunner;\n /** Local execution metadata is absent for hosted participants. */\n transport?: FabricTransport;\n cwd?: string;\n rootId?: string;\n parentId?: string;\n depth?: number;\n generation?: number;\n model?: string;\n thinking?: FabricThinking;\n actorId?: string;\n actorName?: string;\n sessionId?: string;\n runnerSessionId?: string;\n attachCommand?: string;\n branch?: string;\n worktree?: string;\n text?: string;\n value?: unknown;\n error?: string;\n logFile?: string;\n residency?: FabricParticipantResidency;\n}\ninterface FabricRemoteControlResult {\n queued: true;\n messageId: string;\n routed: \"mesh\";\n acknowledged: true;\n}\ninterface FabricAgentResult extends FabricAgentHandle {\n task: string;\n startedAt: number;\n finishedAt?: number;\n turns: number;\n toolCalls: number;\n text: string;\n value?: unknown;\n error?: string;\n usage: { input: number; output: number; cacheRead: number; cacheWrite: number; cost: number };\n pendingMessages?: { steering: string[]; followUp: string[] };\n}\ninterface FabricModelInfo {\n runner?: FabricAgentRunner;\n provider: string;\n id: string;\n name: string;\n key: string;\n value?: string;\n resolvedModel?: string;\n displayName?: string;\n description?: string;\n supportsEffort?: boolean;\n supportedEffortLevels?: string[];\n supportsAdaptiveThinking?: boolean;\n supportsFastMode?: boolean;\n supportsAutoMode?: boolean;\n}\ninterface FabricLogLine {\n index?: number;\n offset: number;\n raw: string;\n parsed?: unknown;\n}\ninterface FabricAgentLog {\n id: string;\n runDirectory: string;\n logFile: string;\n status?: FabricAgentResult;\n events: FabricLogLine[];\n hasMore: boolean;\n before?: number;\n}\ninterface FabricActorLog {\n actorId: string;\n actorName: string;\n sessionFile: string;\n logDir: string;\n session: FabricLogLine[];\n sessionHasMore: boolean;\n sessionBefore?: number;\n run?: {\n runId: string;\n eventsFile: string;\n status?: FabricAgentResult;\n events: FabricLogLine[];\n hasMore: boolean;\n before?: number;\n };\n retainedRuns: string[];\n}\ninterface FabricCapabilityActionHead {\n key: string;\n parentKey: string;\n ref: string;\n name: string;\n description: string;\n descriptorHash: string;\n risk: \"read\" | \"write\" | \"execute\" | \"network\" | \"agent\";\n namespace?: string;\n effect?: FabricActionEffect;\n}\ninterface FabricCapabilityProviderHead {\n key: string;\n parentKey: string;\n name: string;\n description: string;\n descriptorHash: string;\n actions: FabricCapabilityActionHead[];\n}\ninterface FabricCapabilityCatalog {\n kind: \"pi-fabric.capability-catalog\";\n version: 1;\n root: {\n key: \"capability:fabric\";\n name: \"Fabric capabilities\";\n description: string;\n descriptorHash: string;\n };\n providers: FabricCapabilityProviderHead[];\n totalActions: number;\n indexedActions: number;\n complete: boolean;\n reasons: string[];\n}\ninterface FabricToolsApi {\ninterface FabricActionListEnvelope {\n kind: \"pi-fabric.action-list\";\n version: 1;\n actions: FabricAction[];\n /** Full visible-action count before paging. */\n total: number;\n /** True when total exceeds the returned page: more actions exist. */\n truncated: boolean;\n limit: number;\n}\ninterface FabricActionSearchBackend {\n requested: \"semantic\";\n used: \"semantic\" | \"lexical\";\n degraded: boolean;\n model?: string;\n usage?: { inputTokens: number; outputTokens: number };\n abstained?: boolean;\n reason?: \"timeout\" | \"rate_limited\" | \"service_unavailable\";\n}\ninterface FabricActionSearchEnvelope {\n kind: \"pi-fabric.action-search\";\n version: 1;\n actions: FabricAction[];\n backend: FabricActionSearchBackend;\n}\ninterface FabricToolsApi {\n providers(): Promise<Array<{ name: string; description: string }>>;\n catalog(args?: { provider?: string; limit?: number }): Promise<FabricCapabilityCatalog>;\n /**\n * Capped discovery page: default 100 entries, silently truncated (hard cap\n * 1000). A short result never proves an action is absent \u2014 confirm with\n * search() or pass envelope: true to get totals and a truncated flag.\n */\n list(args?: { provider?: string; namespace?: string; query?: string; limit?: number; envelope?: boolean }): Promise<FabricAction[] | FabricActionListEnvelope>;\n search(args: { query: string; limit?: number; searchMode?: \"lexical\" | \"semantic\" }): Promise<FabricAction[] | FabricActionSearchEnvelope>;\n describe(args: { ref: string }): Promise<FabricAction>;\n call(args: { ref: string; args?: Record<string, unknown> }): Promise<unknown>;\n progress(args: { message: string }): Promise<void>;\n models(): Promise<FabricModelInfo[]>;\n}\ninterface FabricCapturedToolResult {\n content: Array<{ type: string; text?: string; [key: string]: unknown }>;\n text: string;\n details?: unknown;\n isError: boolean;\n terminate?: boolean;\n source: { path: string; source: string; scope: string; origin: string; baseDir?: string };\n}\ninterface FabricCapturedTool {\n (args?: Record<string, unknown>): Promise<FabricCapturedToolResult>;\n}\ntype FabricExtensionsApi = Record<string, FabricCapturedTool>;\n// String-primary tools (read/bash/powershell/grep/find/ls) accept a bare string; the\n// runtime proxy coerces it to { <primaryField>: string }. Lets the model write\n// the natural form (pi.bash(\"ls\")) instead of pi.bash({ command: \"ls\" }).\n// Return shapes differ by tool: read/grep/find/ls return their text as a bare\n// string (e.g. const src: string = await pi.read({ path })); shell/edit/write\n// return { ok, output, details } (e.g. const { output } = await pi.bash(...)).\n// Common alias keys (cmd\u2192command, query\u2192pattern, file\u2192path, dir\u2192path) and a\n// flat edit shape ({ path, oldText, newText }) are also accepted; the runtime\n// proxy normalizes them to the canonical form before the host validates args.\n// Bash timeout is measured in seconds; timeoutMs is converted from milliseconds.\n// After executor.shellHangMs the await still resolves ok: true with a still-running\n// notice, pid, and live output path in details; background: true (alias\n// run_in_background) detaches immediately. The process keeps writing that file.\n// Extended near-miss repairs: find's name/filename/glob \u2192 pattern, write's\n// data \u2192 content, ls's folder \u2192 path, bash's script \u2192 command; numeric option\n// fields (limit/offset/context/timeout) also accept numeric strings, coerced\n// at runtime (2322 diagnostics are suppressed by the type-checker by design).\n// String-primary tools also take a two-arg (primary, options) form \u2014\n// pi.read(\"index.ts\", { limit: 120 }) merges to { path, ...options } at\n// runtime, the positional string winning the primary field on conflict.\n// shell/edit/write envelopes are proxy-guarded so string-method access\n// (.trim(), .split(), iteration) fails with an actionable TypeError pointing\n// at .output instead of QuickJS's context-free \"not a function\" \u2014 property-\n// miss (2339) checks are suppressed by design, so the runtime gives the hint.\ntype PiPathArgument = {\n path?: string;\n file?: string;\n absolutePath?: string;\n file_path?: string;\n filePath?: string;\n filepath?: string;\n pathname?: string;\n target_file?: string;\n targetFile?: string;\n absolute_path?: string;\n fileAbsolutePath?: string;\n};\ntype PiOptionalPathArgument = {\n path?: string;\n file?: string;\n absolutePath?: string;\n file_path?: string;\n filePath?: string;\n filepath?: string;\n pathname?: string;\n target_file?: string;\n targetFile?: string;\n absolute_path?: string;\n fileAbsolutePath?: string;\n dir?: string;\n folder?: string;\n directory?: string;\n directoryPath?: string;\n};\ntype PiOldTextArgument = {\n oldText?: string;\n old?: string;\n old_string?: string;\n oldString?: string;\n old_str?: string;\n oldStr?: string;\n from?: string;\n old_value?: string;\n old_text?: string;\n oldContent?: string;\n old_content?: string;\n};\ntype PiNewTextArgument = {\n newText?: string;\n new?: string;\n replacement?: string;\n new_string?: string;\n newString?: string;\n new_str?: string;\n newStr?: string;\n to?: string;\n new_value?: string;\n new_text?: string;\n newContent?: string;\n new_content?: string;\n};\ntype PiEditOperation = PiOldTextArgument & PiNewTextArgument & { all?: boolean };\ntype PiCommandArgument = { command?: string; cmd?: string; shell?: string; cmdline?: string; script?: string; commandLine?: string };\ntype PiContentArgument = { content?: string; contents?: string; body?: string; text?: string; data?: string; fileContent?: string };\ntype PiGrepPatternArgument = { pattern?: string; query?: string; regex?: string; search?: string; q?: string; expression?: string; text?: string };\ntype PiFindPatternArgument = { pattern?: string; query?: string; regex?: string; search?: string; name?: string; filename?: string; glob?: string; expression?: string; include?: string };\n// Two-arg (primary, options) bags for the string-primary tools. Only option\n// aliases belong here (max/start/ctx/ic/...), never primary-field aliases \u2014\n// the primary field comes from the positional string.\ntype PiReadOptions = { offset?: number; limit?: number; start?: number; max?: number };\n// cwd is honored per call by the pi provider, which binds the command to a\n// shell definition rooted there; relative paths resolve from the session cwd.\n// The alias spellings mirror the shell entries in __piArgAliases: the\n// runtime repairs them, so the checker has to accept the same spellings or a\n// repairable call is rejected before it ever reaches the sandbox.\ntype PiShellOptions = {\n timeout?: number; timeoutMs?: number; settle?: boolean;\n background?: boolean; run_in_background?: boolean;\n cwd?: string; workdir?: string; directory?: string; workingDirectory?: string;\n};\ntype PiBashOptions = PiShellOptions;\ntype PiPowerShellOptions = PiShellOptions;\ntype PiGrepOptions = { path?: string; glob?: string; globPattern?: string; ignoreCase?: boolean; ic?: boolean; caseInsensitive?: boolean; literal?: boolean; context?: number; ctx?: number; limit?: number; max?: number };\ntype PiFindOptions = { path?: string; limit?: number; max?: number };\ntype PiLsOptions = { limit?: number; max?: number };\ntype PiReadArgument = string | (PiPathArgument & PiReadOptions);\ntype PiBashArgument = string | (PiCommandArgument & PiBashOptions);\ntype PiPowerShellArgument = string | (PiCommandArgument & PiPowerShellOptions);\ntype PiEditFlatArgument = PiPathArgument & PiOldTextArgument & PiNewTextArgument & { all?: boolean };\ntype PiEditArgument = PiPathArgument & ({ edits: PiEditOperation[]; all?: boolean } | PiEditFlatArgument);\ntype PiWriteArgument = string | (PiPathArgument & PiContentArgument);\ntype PiGrepArgument = string | (PiGrepPatternArgument & PiGrepOptions);\ntype PiFindArgument = string | (PiFindPatternArgument & PiFindOptions);\ntype PiLsArgument = string | (PiOptionalPathArgument & PiLsOptions);\ntype PiNumericString<T> = T extends number ? T | string : T;\ntype PiNumericStringOptions<T> = { [K in keyof T]: PiNumericString<T[K]> };\ntype PiReadCompatibilityArgument = string | (PiPathArgument & PiNumericStringOptions<PiReadOptions>);\ntype PiBashCompatibilityArgument = string | (PiCommandArgument & PiNumericStringOptions<PiBashOptions>);\ntype PiPowerShellCompatibilityArgument = string | (PiCommandArgument & PiNumericStringOptions<PiPowerShellOptions>);\ntype PiEditCompatibilityArgument = PiEditFlatArgument;\ntype PiWriteCompatibilityArgument = PiWriteArgument;\ntype PiGrepCompatibilityArgument = string | (PiGrepPatternArgument & PiNumericStringOptions<PiGrepOptions>);\ntype PiFindCompatibilityArgument = string | (PiFindPatternArgument & PiNumericStringOptions<PiFindOptions>);\ntype PiLsCompatibilityArgument = string | (PiOptionalPathArgument & PiNumericStringOptions<PiLsOptions>);\ninterface PiToolsApi {\n read(args: PiReadArgument, options?: PiReadOptions): Promise<string>;\n bash(args: PiBashArgument, options?: PiBashOptions): Promise<{ ok: true; output: string; details: unknown } | { ok: false; output: string; details: null; exitCode: number; error: string }>;\n powershell(args: PiPowerShellArgument, options?: PiPowerShellOptions): Promise<{ ok: true; output: string; details: unknown } | { ok: false; output: string; details: null; exitCode: number; error: string }>;\n edit(args: PiEditArgument): Promise<{ ok: true; output: string; details: unknown }>;\n edit(path: string, oldText: string, newText: string): Promise<{ ok: true; output: string; details: unknown }>;\n write(args: PiWriteArgument): Promise<{ ok: true; output: string; details: unknown }>;\n write(path: string, content: string): Promise<{ ok: true; output: string; details: unknown }>;\n grep(args: PiGrepArgument): Promise<string>;\n grep(pattern: string, path?: string | PiGrepOptions, limit?: number): Promise<string>;\n find(args: PiFindArgument): Promise<string>;\n find(pattern: string, path?: string | PiFindOptions, limit?: number): Promise<string>;\n ls(args?: PiLsArgument, options?: PiLsOptions): Promise<string>;\n}\ntype FabricActorHostEvent =\n | \"resources_discover\"\n | \"session_start\"\n | \"session_info_changed\"\n | \"session_before_switch\"\n | \"session_before_fork\"\n | \"session_before_compact\"\n | \"session_compact\"\n | \"session_shutdown\"\n | \"session_before_tree\"\n | \"session_tree\"\n | \"input\"\n | \"before_agent_start\"\n | \"agent_start\"\n | \"agent_end\"\n | \"agent_settled\"\n | \"turn_start\"\n | \"turn_end\"\n | \"message_start\"\n | \"message_update\"\n | \"message_end\"\n | \"context\"\n | \"before_provider_headers\"\n | \"before_provider_request\"\n | \"after_provider_response\"\n | \"tool_execution_start\"\n | \"tool_call\"\n | \"tool_execution_update\"\n | \"tool_result\"\n | \"tool_execution_end\"\n | \"model_select\"\n | \"thinking_level_select\"\n | \"user_bash\"\n | \"tool_error\";\ntype FabricActorDelivery = \"mailbox\" | \"steer\" | \"followUp\" | \"nextTurn\";\ninterface FabricActorHostMediaDescriptor {\n readonly type: \"image\";\n readonly mediaIndex: number;\n readonly mimeType: string;\n}\ninterface FabricActorHostSignal {\n readonly payload: unknown;\n readonly media?: readonly FabricActorHostMediaDescriptor[];\n readonly idle: boolean;\n readonly observedAt: number;\n}\ntype FabricActorActivation =\n | { readonly kind: \"hostEvent\"; readonly id: string; readonly source: string; readonly sequence: number; readonly createdAt: number; readonly event: FabricActorHostEvent; readonly mainRevision: number; readonly taskRevision: number; readonly signal?: FabricActorHostSignal }\n | { readonly kind: \"direct\"; readonly id: string; readonly source: string; readonly sequence: number; readonly createdAt: number }\n | { readonly kind: \"mesh\"; readonly id: string; readonly source: string; readonly sequence: number; readonly createdAt: number; readonly topic: string };\ninterface FabricActorValidityFacts {\n readonly activation: Readonly<FabricActorActivation>;\n readonly current: Readonly<{ latestActivationSequence: number; mainRevision: number; taskRevision: number; idle: boolean; now: number }>;\n}\ntype FabricActorValidityDecision = boolean | { valid: boolean; reason?: string };\ntype FabricActorBindingScope = \"session\" | \"project\";\ninterface FabricActorRunBinding { model?: string; thinking?: FabricThinking }\ntype FabricActorValidWhile = (facts: Readonly<FabricActorValidityFacts>) => FabricActorValidityDecision;\ninterface FabricActorRequestBase {\n /** Fixed at creation; ask/tell cannot change language. Global templates resolve inheritance on import. */\n kernel?: FabricKernel | \"inherit\";\n scope?: \"session\" | \"project\" | \"global\";\n name: string;\n instructions: string;\n events?: FabricActorHostEvent[];\n topics?: string[];\n responseMode?: \"text\" | \"directive\";\n coalesce?: boolean;\n runner?: FabricAgentRunner;\n model?: string;\n thinking?: FabricThinking;\n tools?: string[];\n transport?: FabricTransport;\n timeoutMs?: number;\n timeout_ms?: number;\n extensions?: boolean;\n requires?: Array<string | { ref: string; optional?: boolean }>;\n validWhile?: FabricActorValidWhile;\n residency?: FabricParticipantResidency;\n}\ntype FabricActorRequest = FabricActorRequestBase & (\n | { delivery?: \"mailbox\"; triggerTurn?: false }\n | { delivery: \"nextTurn\"; triggerTurn?: false }\n | { delivery: \"steer\" | \"followUp\"; triggerTurn: boolean }\n);\ninterface FabricActorInfo {\n kernel?: FabricKernel;\n pythonRuntime?: \"cpython\" | \"monty\";\n id: string;\n scope: \"session\" | \"project\";\n name: string;\n status: \"idle\" | \"queued\" | \"running\" | \"stopped\";\n runner: FabricAgentRunner;\n events: FabricActorHostEvent[];\n topics: string[];\n delivery: FabricActorDelivery;\n responseMode: \"text\" | \"directive\";\n triggerTurn: boolean;\n coalesce: boolean;\n model?: string;\n thinking?: FabricThinking;\n binding?: FabricActorRunBinding & { scope: \"session\"; sessionId: string; updatedAt?: number };\n projectDefaults?: FabricActorRunBinding & { scope: \"project\" };\n tools?: string[];\n timeoutMs?: number;\n extensions?: boolean;\n requirements?: Array<{ ref: string; optional?: boolean }>;\n capabilityDigest?: string;\n missingCapabilities?: string[];\n validWhile?: { version: 1; source: string };\n residency: FabricParticipantResidency;\n queued: number;\n messages: number;\n createdAt: number;\n updatedAt: number;\n lastRunId?: string;\n lastError?: string;\n sessionFile?: string;\n logDir?: string;\n}\ninterface FabricModelSwitchRequest {\n /** provider/id, a models.aliases name, or a search term; resolution tries aliases first, then exact matches, then the closest fuzzy match (recency from pi-model-sort breaks ties) against authenticated models. */\n model: string;\n /** Optional provider filter applied before matching (e.g. \"anthropic\"). */\n provider?: string;\n}\ninterface FabricModelSwitchResult {\n switched: boolean;\n /** Active model as provider/id after the call (unchanged when reason is \"already-active\"). */\n model: string;\n name?: string;\n /** Previously active provider/id when known. Absent for already-active results. */\n previous?: string;\n /** Set when the selector resolved through a configured models.aliases name. */\n alias?: string;\n /** How the selector resolved: the alias name, or one of closest/recent/latest for inexact picks. Absent for exact provider/id or bare-id matches. */\n via?: string;\n reason?: \"already-active\";\n}\ninterface FabricActorMessage {\n id: string;\n actorId: string;\n actorName: string;\n direction: \"in\" | \"out\";\n source: string;\n createdAt: number;\n text?: string;\n data?: unknown;\n action?: \"silent\" | \"message\" | \"stop\";\n runId?: string;\n error?: string;\n stale?: boolean;\n reason?: string;\n}\n// agentId/agent_id spellings repair to id during agent arg normalization.\ntype FabricAgentTargetArgs = { id: string; agentId?: string; agent_id?: string };\ninterface FabricAgentsApi {\n run(args: FabricAgentRequest): Promise<FabricAgentResult>;\n /** Hosted capability only; resumes a paused direct child without exposing its checkpoint. */\n resume(args: FabricAgentTargetArgs & { task?: string }): Promise<FabricAgentResult>;\n handoff(args: FabricHandoffRequest): Promise<FabricHandoffResult>;\n spawn(args: FabricAgentRequest): Promise<FabricAgentHandle>;\n wait(args: FabricAgentTargetArgs): Promise<FabricAgentResult>;\n /** Alias for wait. */\n join(args: FabricAgentTargetArgs): Promise<FabricAgentResult>;\n status(args: FabricAgentTargetArgs): Promise<FabricAgentResult | FabricAgentHandle | FabricMainAgentInfo | FabricActorInfo | FabricParticipantInfo>;\n list(args?: { scope?: FabricParticipantScope }): Promise<Array<FabricAgentResult | FabricAgentHandle | FabricParticipantInfo>>;\n members(args?: { scope?: FabricParticipantScope; kinds?: FabricParticipantKind[]; includeStale?: boolean }): Promise<FabricParticipantInfo[]>;\n self(): Promise<FabricParticipantInfo>;\n main(): Promise<FabricMainAgentInfo>;\n sessions(): Promise<FabricParticipantInfo[]>;\n peers(): Promise<FabricPeerInfo[]>;\n subscribe(args: {\n from: string;\n events: FabricLifecycleEventType[];\n to?: string;\n delivery: FabricLifecycleDelivery;\n triggerTurn: boolean;\n once?: boolean;\n }): Promise<FabricLifecycleSubscription>;\n subscriptions(args?: { from?: string; to?: string }): Promise<FabricLifecycleSubscription[]>;\n unsubscribe(args: FabricAgentTargetArgs): Promise<{ removed: boolean }>;\n models(args?: { runner?: FabricAgentRunner; refresh?: boolean }): Promise<FabricModelInfo[]>;\n stop(args: FabricAgentTargetArgs): Promise<FabricAgentResult | FabricActorInfo | FabricRemoteControlResult>;\n cleanup(args: FabricAgentTargetArgs & { deleteBranch?: boolean; delete_branch?: boolean }): Promise<{ cleaned: boolean }>;\n create(args: FabricActorRequest): Promise<FabricActorInfo>;\n setModel(args: { id: string; model?: string; scope?: FabricActorBindingScope }): Promise<FabricActorInfo>;\n switchModel(args: FabricModelSwitchRequest): Promise<FabricModelSwitchResult>;\n setThinking(args: { id: string; thinking?: FabricThinking; scope?: FabricActorBindingScope }): Promise<FabricActorInfo>;\n setTools(args: { id: string; tools: string[]; scope?: \"project\" | \"global\" }): Promise<FabricActorInfo>;\n setEvents(args: { id: string; events: FabricActorHostEvent[] }): Promise<FabricActorInfo>;\n setDeliveryPolicy(args: {\n id: string;\n delivery: FabricActorDelivery;\n triggerTurn: boolean;\n scope?: \"project\" | \"global\";\n }): Promise<FabricActorInfo>;\n setInstructions(args: {\n id: string;\n instructions: string;\n scope?: \"project\" | \"global\";\n }): Promise<FabricActorInfo>;\n ask(args: { id: string; message: string; data?: unknown; model?: string; thinking?: FabricThinking }): Promise<FabricActorMessage>;\n tell(args: { id: string; message: string; data?: unknown; model?: string; thinking?: FabricThinking }): Promise<{ queued: true; messageId: string }>;\n steer(args: { id: string; message: string; data?: unknown }): Promise<{ queued: true; messageId: string; routed?: \"local\" | \"main\" | \"mesh\"; acknowledged?: boolean }>;\n followUp(args: { id: string; message: string; data?: unknown }): Promise<{ queued: true; messageId: string; routed?: \"local\" | \"main\" | \"mesh\"; acknowledged?: boolean }>;\n setSteeringMode(args: { id: string; mode: \"all\" | \"one-at-a-time\" }): Promise<{ queued: true; messageId: string }>;\n setFollowUpMode(args: { id: string; mode: \"all\" | \"one-at-a-time\" }): Promise<{ queued: true; messageId: string }>;\n /** Advisory compaction of a running Pi-runner child at its next safe turn boundary. */\n compact(args: { id: string; instructions?: string }): Promise<{ queued: true; messageId: string }>;\n actorStatus(args: FabricAgentTargetArgs): Promise<FabricActorInfo>;\n actors(): Promise<FabricActorInfo[]>;\n messages(args: { id: string; limit?: number }): Promise<FabricActorMessage[]>;\n remove(args: { id: string }): Promise<{ removed: boolean }>;\n /** Drop an actor's mailbox history without stopping the actor. */\n clearMessages(args: { id: string }): Promise<FabricActorInfo>;\n /** Stamp a global template into the current project as a fresh live actor with no inherited history. */\n \"import\"(args: { id?: string; name?: string; as?: string }): Promise<FabricActorInfo>;\n /** Export a live project actor's definition to the global registry as a project-independent template. */\n \"export\"(args: { id: string; overwrite?: boolean }): Promise<FabricActorRequest & { id: string; createdAt: number; updatedAt: number }>;\n log(args: {\n id: string;\n type?: \"session\" | \"run\" | \"all\";\n lines?: number;\n before?: number;\n runId?: string;\n }): Promise<FabricActorLog | FabricAgentLog>;\n}\ninterface FabricMcpResult {\n text: string;\n content: unknown[];\n structuredContent: unknown;\n}\ninterface FabricMcpTool {\n (args?: Record<string, unknown>): Promise<FabricMcpResult | unknown>;\n}\ninterface FabricMcpServer {\n [tool: string]: FabricMcpTool;\n}\n// Management verbs stay members of mcp even when the declare line below is\n// replaced by generated per-server declarations (see the dynamic option on\n// guestTypeDeclarations), so generated surfaces intersect with this type\n// rather than re-declaring them.\ninterface FabricMcpManagement {\n servers(): Promise<Array<{ name: string; description: string | null; transport: \"http\" | \"stdio\" }>>;\n reload(): Promise<{ servers: string[] }>;\n register(args: {\n name: string;\n description?: string;\n command?: string;\n args?: string[];\n cwd?: string;\n baseUrl?: string;\n headers?: Record<string, string>;\n env?: Record<string, string>;\n overwrite?: boolean;\n }): Promise<{ registered: string }>;\n call(args: { server: string; tool: string; args?: Record<string, unknown> }): Promise<unknown>;\n}\n// Loose static surface: any server/tool name compiles and argument shapes are\n// enforced at dispatch by the registry. With descriptor data available the\n// execution service replaces the declare-const-mcp line below with a\n// schema-typed rendering of the live cache (runtime/dynamic-guest-types.ts).\ntype FabricMcpApi = Record<string, FabricMcpServer> & FabricMcpManagement;\ninterface FabricCouncilRunOptions extends FabricAgentRequest {\n roles: string[];\n}\ninterface FabricCouncilApi {\n run(args: FabricCouncilRunOptions & { synthesize?: true }): Promise<FabricAgentResult>;\n run(args: FabricCouncilRunOptions & { synthesize: false }): Promise<FabricAgentResult[]>;\n}\ninterface FabricMeshIdentity {\n id: string;\n name: string;\n kind: \"main\" | \"actor\" | \"agent\";\n sessionId?: string;\n}\ninterface FabricMeshEvent {\n id: string;\n sequence: number;\n topic: string;\n kind: string;\n from: FabricMeshIdentity;\n to?: string;\n text?: string;\n data?: unknown;\n createdAt: number;\n}\ninterface FabricMeshStateEntry<T = unknown> {\n key: string;\n value: T;\n version: number;\n updatedAt: number;\n updatedBy: FabricMeshIdentity;\n}\ninterface FabricMeshApi {\n self(): Promise<FabricMeshIdentity>;\n publish(args: { topic: string; kind?: string; to?: string; text?: string; data?: unknown; message?: string; body?: string }): Promise<FabricMeshEvent>;\n read(args?: { after?: number; topic?: string; to?: string; limit?: number; max?: number }): Promise<FabricMeshEvent[]>;\n members(args?: { scope?: FabricParticipantScope; kinds?: FabricParticipantKind[]; includeStale?: boolean; limit?: number; max?: number; include_stale?: boolean }): Promise<FabricParticipantInfo[]>;\n get<T = unknown>(args: { key: string }): Promise<FabricMeshStateEntry<T> | null>;\n list<T = unknown>(args?: { prefix?: string; limit?: number; max?: number }): Promise<Array<FabricMeshStateEntry<T>>>;\n put<T = unknown>(args: { key: string; value: T; ifVersion?: number; if_version?: number; version?: number }): Promise<FabricMeshStateEntry<T>>;\n delete(args: { key: string; ifVersion?: number; if_version?: number; version?: number }): Promise<{ deleted: boolean; version?: number }>;\n}\n// Stable-provider argument bags declare the canonical keys plus the\n// near-miss spellings repaired during argument normalization\n// (providers/arg-normalization.ts and each provider's per-action table). The\n// registry's prepare stage repairs aliases before schema validation, so a\n// call spelled with an alias typechecks instead of tripping the\n// excess-property check; the canonical key wins on conflict, and anything\n// else fails additionalProperties:false validation with the offending\n// property path named. Keep these spillover fields in sync with the provider\n// normalization tables.\ntype FabricMemoryBranches = \"active\" | \"all\";\ntype FabricMemoryQueryMode = \"literal\" | \"phrase\" | \"regex\";\ntype FabricMemoryQueryMatch = \"all\" | \"any\";\ninterface FabricMemoryEntryRange {\n first: number;\n last: number;\n}\ninterface FabricMemoryRecallArgs {\n source?: string;\n query?: string;\n queryMode?: FabricMemoryQueryMode;\n queryMatch?: FabricMemoryQueryMatch;\n expectedSourceHash?: string;\n expectedLineageFingerprint?: string;\n branches?: FabricMemoryBranches;\n scope?: string;\n offset?: number;\n pageSize?: number;\n snippetChars?: number;\n role?: string;\n tool?: string;\n ref?: string;\n provider?: string;\n action?: string;\n outcome?: \"succeeded\" | \"failed\" | \"aborted\" | \"timed_out\";\n since?: number;\n until?: number;\n entryRange?: FabricMemoryEntryRange;\n q?: string;\n limit?: number;\n max?: number;\n page_size?: number;\n snippet_chars?: number;\n query_mode?: FabricMemoryQueryMode;\n query_match?: FabricMemoryQueryMatch;\n entry_range?: FabricMemoryEntryRange;\n}\ninterface FabricMemoryExpandArgs {\n source?: string;\n session: string;\n expectedSourceHash?: string;\n expectedLineageFingerprint?: string;\n branches?: FabricMemoryBranches;\n indices?: number[];\n entryIds?: string[];\n operationAddresses?: string[];\n entryRange?: FabricMemoryEntryRange;\n before?: number;\n after?: number;\n entryOffset?: number;\n textOffset?: number;\n maxChars?: number;\n maxEntries?: number;\n id?: string;\n file?: string;\n path?: string;\n session_id?: string;\n index?: number;\n entry_ids?: string[];\n operation_addresses?: string[];\n entry_range?: FabricMemoryEntryRange;\n entry_offset?: number;\n text_offset?: number;\n max_chars?: number;\n max_entries?: number;\n}\ninterface FabricMemoryCall<Ref extends string, Args> {\n ref: Ref;\n args: Args;\n}\ninterface FabricMemoryRecallEntryHit {\n kind: \"entry\";\n sessionId: string;\n tier: \"hot\" | \"cold\";\n index: number;\n entryId: string | null;\n parentId: string | null;\n operationAddress: string | null;\n type: string;\n role: string | null;\n tool: string | null;\n ref: string | null;\n provider: string | null;\n action: string | null;\n timestamp: number | null;\n isError: boolean;\n outcome?: \"succeeded\" | \"failed\" | \"aborted\" | \"timed_out\";\n score: number;\n snippet: string;\n truncated: boolean;\n follow: FabricMemoryCall<\"memory.expand\", FabricMemoryExpandArgs>;\n}\ninterface FabricMemoryRecallSessionHit {\n kind: \"session\";\n sessionId: string;\n tier: \"cold\";\n cwd: string;\n lastTimestamp: number | null;\n score: number;\n matchedTerms: number;\n matchedStructuralEntries: number;\n follow: FabricMemoryCall<\"memory.recall\", FabricMemoryRecallArgs>;\n}\ntype FabricMemoryRecallHit = FabricMemoryRecallEntryHit | FabricMemoryRecallSessionHit;\ninterface FabricMemoryError {\n code: string;\n message: string;\n [key: string]: unknown;\n}\ninterface FabricMemoryCoverage {\n complete: boolean;\n indexedSessions: number;\n eligibleSessions: number;\n staleSessions: number;\n incompleteSessions: number;\n reasons: string[];\n error?: FabricMemoryError;\n}\ninterface FabricMemoryRecallResult {\n total: number;\n hits: FabricMemoryRecallHit[];\n next: FabricMemoryCall<\"memory.recall\", FabricMemoryRecallArgs> | null;\n coverage: FabricMemoryCoverage;\n error?: FabricMemoryError;\n}\ninterface FabricMemoryExpandedEntry {\n index: number;\n entryId: string | null;\n parentId: string | null;\n type: string | null;\n role: string | null;\n timestamp: number | null;\n isError: boolean;\n anchor?: boolean;\n text: string;\n textRange: { start: number; end: number; total: number; complete: boolean };\n parentEntryId?: string | null;\n operationAddress?: string | null;\n tool?: string | null;\n ref?: string | null;\n provider?: string | null;\n action?: string | null;\n outcome?: \"succeeded\" | \"failed\" | \"aborted\" | \"timed_out\";\n filesTouched?: Array<string | null>;\n operation?: unknown;\n branchFact?: unknown;\n structuredTruncated?: boolean;\n factAddress?: string | null;\n carrierEntryId?: string | null;\n carrierParentId?: string | null;\n carrierFromId?: string | null;\n}\ninterface FabricMemoryExpandResult {\n session?: string;\n sourceHash?: string;\n branches?: FabricMemoryBranches;\n lineageFingerprint?: string;\n entryCount?: number;\n entries: FabricMemoryExpandedEntry[];\n next?: FabricMemoryCall<\"memory.expand\", FabricMemoryExpandArgs> | null;\n error?: FabricMemoryError;\n}\ninterface FabricMemoryWalkResult {\n visited: number;\n stopped: boolean;\n error?: FabricMemoryError;\n}\ninterface FabricMemorySessionInfo {\n id: string;\n file: string;\n cwd: string;\n mtime: number;\n entryCount: number;\n tier: \"hot\" | \"cold\";\n branches: FabricMemoryBranches;\n lineageFingerprint: string | null;\n}\ninterface FabricMemoryApi {\n recall(args?: FabricMemoryRecallArgs): Promise<FabricMemoryRecallResult>;\n expand(args: FabricMemoryExpandArgs): Promise<FabricMemoryExpandResult>;\n walk(\n args: FabricMemoryExpandArgs,\n visitor: (\n entry: FabricMemoryExpandedEntry,\n index: number,\n ) => boolean | void | Promise<boolean | void>,\n ): Promise<FabricMemoryWalkResult>;\n sessions(args?: {\n source?: string;\n scope?: string;\n branches?: FabricMemoryBranches;\n limit?: number;\n max?: number;\n }): Promise<{\n scope?: string;\n branches?: FabricMemoryBranches;\n sessions?: FabricMemorySessionInfo[];\n error?: FabricMemoryError;\n }>;\n}\ninterface FabricStateTransitionArgs {\n label: string;\n from?: string;\n to: string;\n summary: string;\n evidence?: string[];\n tags?: string[];\n kind?: \"state\" | \"representation\";\n complexity?: { files: string[] };\n force?: boolean;\n name?: string;\n description?: string;\n}\ninterface FabricStateComplexityFile {\n file: string;\n supported: boolean;\n language?: string;\n current?: number;\n recorded?: number;\n delta?: number;\n recordedDelta?: number;\n}\ninterface FabricStateVerificationResult {\n certified: boolean;\n violated: boolean;\n certificationStatus: \"certified\" | \"failed\";\n results: unknown[];\n failures: unknown[];\n certificate?: unknown;\n reportingError?: string;\n evidenceDigest: string;\n resultDigest: string;\n}\ninterface FabricStateApi {\n transition(args: FabricStateTransitionArgs): Promise<{ event: FabricMeshEvent; head: unknown }>;\n get(): Promise<{\n head: unknown | null;\n goal: { check: string; description?: string } | null;\n complexity: { files: number; decisionPoints: number; lastNetDelta: number };\n certification: { current: unknown | null; recent: unknown[] };\n recentLabels: string[];\n }>;\n history(args?: { label?: string; limit?: number; includeArchived?: boolean; name?: string; max?: number }): Promise<{\n transitions: unknown[];\n labels: string[];\n certifications: unknown[];\n }>;\n complexity(args?: { files?: string[]; paths?: string[] }): Promise<{ files: FabricStateComplexityFile[]; netDelta: number }>;\n verify(args?: { labels?: string[]; includeArchived?: boolean; timeoutMs?: number; label?: string }): Promise<FabricStateVerificationResult>;\n goal(args: { check: string; description?: string; command?: string; cmd?: string; predicate?: string }): Promise<FabricMeshStateEntry<{ check: string; description?: string }>>;\n checkGoal(args?: { timeoutMs?: number }): Promise<{\n passed: boolean;\n output: string;\n exitCode: number | null;\n error?: string;\n }>;\n}\ntype FabricSchemaEvidence =\n | { kind: \"file_exists\"; path: string }\n | { kind: \"file_absent\"; path: string }\n | { kind: \"file_contains\"; path: string; literal: string }\n | { kind: \"file_sha256\"; path: string; sha256: string }\n | { kind: \"trusted_command\"; name: string };\ntype FabricSchemaFileOperation =\n | { kind: \"write\"; path: string; content: string; expected: { absent: true } | { sha256: string } }\n | { kind: \"edit\"; path: string; oldText: string; newText: string; expectedSha256: string }\n | { kind: \"delete\"; path: string; expectedSha256: string };\ninterface FabricSchemaEvidenceResult {\n evidence: FabricSchemaEvidence;\n status: \"confirmed\" | \"nonconfirmed\" | \"error\";\n detail: string;\n exitCode?: number | null;\n output?: string;\n observedSha256?: string;\n}\ninterface FabricSchemaStatus {\n mode: \"off\" | \"audit\" | \"enforce\";\n certificateTtlMs: number;\n maxFiles: number;\n maxBytes: number;\n trustedCommands: string[];\n generation: number;\n lastOutcome: \"committed\" | \"rolled_back\" | \"quarantined\" | null;\n hypotheses: Array<{\n id: string;\n label: string;\n status: string;\n generation: number;\n updatedAt: number;\n }>;\n}\ninterface FabricSchemaVerificationResult {\n verified: boolean;\n hypothesisId: string;\n certificate?: string;\n issuedAt?: number;\n expiresAt?: number;\n reason?: string;\n results: FabricSchemaEvidenceResult[];\n}\ninterface FabricSchemaCommitResult {\n outcome: \"committed\" | \"rolled_back\" | \"quarantined\";\n transactionId: string;\n generation?: number;\n paths?: string[];\n postconditions?: FabricSchemaEvidenceResult[];\n complexityReductionCertified?: boolean;\n stateTransition?: unknown;\n error?: string;\n rollbackError?: string;\n}\ninterface FabricSchemaApi {\n status(): Promise<FabricSchemaStatus>;\n hypothesize(args: {\n label: string;\n summary: string;\n evidence: FabricSchemaEvidence[];\n complexityReduction?: boolean;\n name?: string;\n description?: string;\n complexity_reduction?: boolean;\n }): Promise<{\n hypothesisId: string;\n status: string;\n state: unknown;\n fingerprint: string;\n generation: number;\n }>;\n verify(args: { hypothesisId: string; id?: string; hypothesis_id?: string }): Promise<FabricSchemaVerificationResult>;\n commit(args: {\n hypothesisId: string;\n certificate: string;\n operations: FabricSchemaFileOperation[];\n postconditions: FabricSchemaEvidence[];\n id?: string;\n hypothesis_id?: string;\n }): Promise<FabricSchemaCommitResult>;\n abort(args: { hypothesisId: string; certificate?: string; id?: string; hypothesis_id?: string }): Promise<{\n aborted: true;\n hypothesisId: string;\n }>;\n}\ninterface FabricCompactPendingIntent {\n reason?: string;\n instructions?: string;\n preserve?: string[];\n requestedBy: string;\n requestedAt: number;\n}\ninterface FabricCompactLastCommit {\n at: number;\n requestedBy: string;\n status: \"committed\" | \"cancelled\" | \"failed\";\n summary?: string;\n tokensBefore?: number;\n estimatedTokensAfter?: number;\n error?: string;\n}\ntype FabricComponentState = \"waiting\" | \"loading\" | \"active\" | \"unloading\" | \"failed\" | \"quarantined\" | \"disposed\";\ninterface FabricComponentEffectInfo {\n label: string;\n kind: \"none\" | \"scoped\" | \"transactional\" | \"emission\";\n resources: string[];\n ordering: \"commutative\" | \"ordered\" | \"unknown\";\n}\ninterface FabricComponentEffectConflict {\n withComponent: string;\n resources: string[];\n reason: \"shared_resource\" | \"unknown_resource\";\n}\ninterface FabricComponentInfo {\n id: string;\n component: string;\n parentId?: string;\n state: FabricComponentState;\n guarantee: \"managed\" | \"revertible\";\n requirements: string[];\n provisions: string[];\n missing: string[];\n optionalMissing: string[];\n effects?: FabricComponentEffectInfo[];\n effectConflicts?: FabricComponentEffectConflict[];\n targetDigest?: string;\n error?: string;\n cleanupErrors?: string[];\n revision: number;\n createdAt: number;\n updatedAt: number;\n}\ninterface FabricComponentEntry {\n id: string;\n component: string;\n config?: unknown;\n disabled?: boolean;\n}\ninterface FabricComponentDefinitionInfo {\n name: string;\n description?: string;\n revision: number;\n configSchema?: Record<string, unknown>;\n requirements: string[];\n provisions: string[];\n}\ninterface FabricComponentConfigSource {\n scope: \"global\" | \"project\";\n path: string;\n trusted: boolean;\n present: boolean;\n selected: boolean;\n}\ninterface FabricComponentConfigurationInfo {\n sources: FabricComponentConfigSource[];\n warnings: string[];\n sessionOverrides: string[];\n removalPolicy: \"drain\";\n error?: string;\n}\ninterface FabricComponentChangeRequest {\n scope?: \"session\" | \"global\" | \"project\";\n entries?: FabricComponentEntry[];\n remove?: string[];\n reset?: string[];\n}\ninterface FabricComponentChangePlan {\n revision: string;\n request: Required<FabricComponentChangeRequest>;\n changes: Array<{ id: string; operation: \"add\" | \"replace\" | \"remove\"; component: string; requirements: string[]; provisions: string[] }>;\n warnings: string[];\n sources: FabricComponentConfigSource[];\n}\ninterface FabricComponentsApi {\n list(): Promise<{\n definitions: FabricComponentDefinitionInfo[];\n components: FabricComponentInfo[];\n configuration: FabricComponentConfigurationInfo;\n }>;\n describe(args: { component: string }): Promise<FabricComponentDefinitionInfo & { instances: FabricComponentInfo[] }>;\n plan(args: FabricComponentChangeRequest): Promise<FabricComponentChangePlan>;\n apply(args: FabricComponentChangeRequest & { expectedRevision: string }): Promise<{ components: FabricComponentInfo[]; configuration: FabricComponentConfigurationInfo; scope: \"session\" | \"global\" | \"project\" }>;\n reconcile(): Promise<{ components: FabricComponentInfo[]; configuration: FabricComponentConfigurationInfo }>;\n status(args: { id: string }): Promise<FabricComponentInfo>;\n graph(): Promise<{\n components: FabricComponentInfo[];\n edges: Array<{ from: string; to: string; ref: string; kind?: \"dependency\" | \"ownership\" }>;\n cycles: string[][];\n }>;\n reload(args?: { id?: string }): Promise<{ components: FabricComponentInfo[] }>;\n}\n\ninterface FabricCompactApi {\n request(args?: {\n reason?: string;\n instructions?: string;\n preserve?: string[];\n requestedBy?: string;\n instruction?: string;\n requested_by?: string;\n }): Promise<{ requested: true; intent: FabricCompactPendingIntent }>;\n status(): Promise<{ pending?: FabricCompactPendingIntent; last?: FabricCompactLastCommit }>;\n cancel(): Promise<{ cancelled: true }>;\n}\n\ninterface FabricPrewalkFileIdentityStatus {\n path: string;\n loadedSha256: string;\n diskSha256: string;\n stale: boolean;\n}\ninterface FabricPrewalkApi {\n plan(args: {\n outcome: string;\n steps: string[];\n verification: string[];\n risks: string;\n }): Promise<{ recorded: true; readiness: \"ready\"; plan: string }>;\n status(): Promise<{\n state: \"idle\" | \"armed\" | \"handing_off\" | \"continuation_pending\";\n planRequired: boolean;\n planReady: boolean;\n planPrompts: number;\n claimedReadiness: \"planned\" | \"disabled\" | \"unplanned\" | null;\n runtime?: {\n entry: FabricPrewalkFileIdentityStatus | null;\n lazyRuntime: FabricPrewalkFileIdentityStatus | null;\n };\n }>;\n}\n\ninterface FabricWorkflowAgentOptions extends Omit<FabricAgentRequest, \"task\"> {\n label?: string;\n}\ntype FabricActivityStatus = \"pending\" | \"running\" | \"completed\" | \"failed\" | \"blocked\" | \"stopped\";\ntype FabricActivityKind = \"agent\" | \"actor\" | \"tool\" | \"extension\" | \"mcp\" | \"mesh\" | \"task\" | \"custom\";\ninterface FabricWorkflowDisplay {\n name?: string;\n description?: string;\n}\ninterface FabricWorkflowPhaseOptions {\n id?: string;\n description?: string;\n total?: number;\n}\ninterface FabricWorkflowPhaseInput extends FabricWorkflowPhaseOptions {\n name: string;\n}\ninterface FabricWorkflowItem {\n id: string;\n label: string;\n status?: FabricActivityStatus;\n phase?: string;\n detail?: string;\n kind?: FabricActivityKind;\n current?: string;\n total?: number;\n completed?: number;\n data?: unknown;\n}\ninterface FabricWorkflowApi {\n agent<T = string>(prompt: string, options?: FabricWorkflowAgentOptions): Promise<T>;\n parallel<T, R>(items: T[], mapper: (item: T, index: number) => Promise<R> | R, concurrency?: number | { concurrency?: number }): Promise<R[]>;\n parallel<T>(thunks: Array<() => Promise<T> | T>, concurrency?: number | { concurrency?: number }): Promise<T[]>;\n pipeline<T>(items: T[], ...stages: Array<(value: unknown, original: T, index: number) => Promise<unknown> | unknown>): Promise<unknown[]>;\n configure(display: FabricWorkflowDisplay): Promise<FabricWorkflowDisplay>;\n phase(name: string, options?: FabricWorkflowPhaseOptions): Promise<{ name: string; index: number; id?: string }>;\n phase(input: FabricWorkflowPhaseInput): Promise<{ name: string; index: number; id?: string }>;\n item(item: FabricWorkflowItem): Promise<FabricWorkflowItem>;\n event(event: { message: string; level?: \"info\" | \"success\" | \"warning\" | \"error\"; data?: unknown }): Promise<void>;\n log(...values: unknown[]): void;\n budget: { total: number; spent(): number; remaining(): number };\n}\ndeclare const tools: FabricToolsApi;\ndeclare const pi: PiToolsApi;\ndeclare const extensions: FabricExtensionsApi;\ndeclare const agents: FabricAgentsApi;\ndeclare const mesh: FabricMeshApi;\ndeclare const mcp: FabricMcpApi;\ndeclare const memory: FabricMemoryApi;\ndeclare const state: FabricStateApi;\ndeclare const schema: FabricSchemaApi;\ndeclare const components: FabricComponentsApi;\ndeclare const compact: FabricCompactApi;\ndeclare const prewalk: FabricPrewalkApi;\n\ntype FabricJevJson = null | boolean | number | string | FabricJevJson[] | { [key: string]: FabricJevJson };\ntype FabricJevDescription = string | FabricJevJson[] | { [key: string]: FabricJevJson };\ntype FabricJevQuestion =\n | { type: \"noul\"; instructions: FabricJevDescription; criteria?: { true?: FabricJevDescription; false?: FabricJevDescription } }\n | { type: \"choice\"; instructions: FabricJevDescription; criteria: Record<string, FabricJevDescription | null> }\n | { type: \"score\"; instructions: FabricJevDescription; criteria: FabricJevDescription[] };\ntype FabricJevAnswer<Q extends FabricJevQuestion> = Q extends { type: \"noul\" }\n ? { type: \"noul\"; noul: number }\n : Q extends { type: \"choice\"; criteria: infer C }\n ? { type: \"choice\"; choice: Extract<keyof C, string>; confidence: number; probabilities: Record<Extract<keyof C, string>, number> }\n : { type: \"score\"; score: number; confidence: number; probabilities: Record<string, number>; legend: Record<string, FabricJevJson> };\ninterface FabricJevProgram {\n name: string;\n code: string;\n inputSchema: Record<string, unknown>;\n outputSchema: Record<string, unknown>;\n requires: string[];\n limits?: { timeoutMs?: number; maxEvaluations?: number; maxToolCalls?: number; maxTokens?: number };\n}\ntype FabricJevHostEventName = \"input\" | \"turn_end\" | \"tool_error\" | \"agent_end\" | \"agent_settled\";\ninterface FabricJevObserve {\n events: FabricJevHostEventName[];\n include?: Array<\"inputText\" | \"assistantText\" | \"toolResults\">;\n maxChars?: number; queueSize?: number; maxEventAgeMs?: number;\n delivery?: \"steer\" | \"followUp\"; triggerTurn?: boolean; maxAdvice?: number;\n}\ninterface FabricJevHostEvent {\n id: string; sequence: number; event: FabricJevHostEventName; source: \"main\";\n sessionId: string; revision: number; at: number; payload: FabricJevJson; truncated: boolean;\n}\ninterface FabricJevObservationStats {\n events: FabricJevHostEventName[]; received: number; consumed: number; dropped: number; queued: number;\n adviceDelivered: number; adviceSuppressed: number;\n}\ninterface FabricJevAdviceResult {\n delivered: boolean;\n reason?: \"disabled\" | \"stale\" | \"duplicate\" | \"budget\" | \"feedback\" | \"delivery_failed\";\n}\ninterface FabricJevRun<T = unknown> {\n id: string; name: string; state: \"running\" | \"completed\" | \"failed\" | \"cancelled\" | \"timed_out\";\n background: boolean; startedAt: number; endedAt?: number; result?: T; error?: string;\n evaluations: number; toolCalls: number; usage: { input_tokens: number; output_tokens: number };\n events: Array<{ sequence: number; at: number; value: FabricJevJson }>; nextSequence: number; logs: string[];\n observation?: FabricJevObservationStats;\n}\ninterface FabricJevApi {\n evaluate<Q extends Record<string, FabricJevQuestion>>(args: {\n state: string | FabricJevJson[] | { [key: string]: FabricJevJson }; questions: Q; model?: string;\n }): Promise<{ model: string; answers: { [K in keyof Q]: FabricJevAnswer<Q[K]> }; usage: { input_tokens: number; output_tokens: number } }>;\n run<T = unknown>(args: { program: FabricJevProgram; input: FabricJevJson }): Promise<FabricJevRun<T>>;\n spawn(args: { program: FabricJevProgram; input: FabricJevJson; observe?: FabricJevObserve }): Promise<FabricJevRun>;\n status(args?: { id?: never; after?: never }): Promise<{ credentials: { configured: boolean; source: \"pi\" | \"environment\" | \"command\" | \"missing\"; verified: boolean }; model: string; runs: Array<{ id: string; name: string; state: string; background: boolean; startedAt: number; evaluations: number; toolCalls: number; observation?: FabricJevObservationStats }> }>;\n status<T = unknown>(args: { id: string; after?: number }): Promise<FabricJevRun<T>>;\n wait<T = unknown>(args: { id: string }): Promise<FabricJevRun<T>>;\n /** Alias for wait. */\n join<T = unknown>(args: { id: string }): Promise<FabricJevRun<T>>;\n advise(args: { id: string; eventId: string; message: string }): Promise<FabricJevAdviceResult>;\n stop(args: { id: string }): Promise<FabricJevRun>;\n}\ndeclare const jev: FabricJevApi;\n\ndeclare const council: FabricCouncilApi;\ndeclare const workflow: FabricWorkflowApi;\ndeclare function agent<T = string>(prompt: string, options?: FabricWorkflowAgentOptions): Promise<T>;\ndeclare function parallel<T, R>(items: T[], mapper: (item: T, index: number) => Promise<R> | R, concurrency?: number | { concurrency?: number }): Promise<R[]>;\ndeclare function parallel<T>(thunks: Array<() => Promise<T> | T>, concurrency?: number | { concurrency?: number }): Promise<T[]>;\ndeclare function pipeline<T>(items: T[], ...stages: Array<(value: unknown, original: T, index: number) => Promise<unknown> | unknown>): Promise<unknown[]>;\ndeclare function phase(name: string, options?: FabricWorkflowPhaseOptions): Promise<{ name: string; index: number; id?: string }>;\ndeclare function phase(input: FabricWorkflowPhaseInput): Promise<{ name: string; index: number; id?: string }>;\ndeclare function log(...values: unknown[]): void;\ndeclare const budget: FabricWorkflowApi[\"budget\"];\ntype FabricRlmRequest = Omit<FabricAgentRequest, \"runner\" | \"recursive\"> & { runner?: \"pi\" };\ndeclare const rlm: { query(args: FabricRlmRequest): Promise<FabricAgentResult> };\ninterface FabricConsole {\n log(...args: unknown[]): void;\n info(...args: unknown[]): void;\n warn(...args: unknown[]): void;\n error(...args: unknown[]): void;\n}\ndeclare const console: FabricConsole;\ndeclare const \u03C0: Readonly<Record<string, string>>;\n// Process runtimes only: node/bun children bridge native-module imports;\n// quickjs has no module loader and rejects __fabricImport at runtime.\ndeclare function __fabricImport(specifier: string): Promise<any>;\ndeclare function print(...args: unknown[]): void;\ndeclare function setTimeout(handler: (...args: any[]) => void, timeout?: number): number;\ndeclare function clearTimeout(handle: number): void;\ndeclare function setInterval(handler: (...args: any[]) => void, timeout?: number): number;\ndeclare function clearInterval(handle: number): void;\n// Process runtimes only: the bun-process child binds the host's real Bun\n// module namespace as __bun; undefined under node-process and quickjs.\ndeclare const __bun: any;\n";
|
|
23
23
|
export interface FabricGuestDeclarationOptions {
|
|
24
24
|
/** Global names to omit (for example providers disabled by configuration). */
|
|
25
25
|
excludeGlobals?: readonly string[];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"guest-types.d.ts","sourceRoot":"","sources":["../../src/runtime/guest-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AASrE,eAAO,MAAM,yCAAyC;;;;;;;;;CAS5C,CAAC;AAEX,eAAO,MAAM,sBAAsB;;;;;;;;;CASzB,CAAC;AAEX,eAAO,MAAM,uBAAuB,
|
|
1
|
+
{"version":3,"file":"guest-types.d.ts","sourceRoot":"","sources":["../../src/runtime/guest-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AASrE,eAAO,MAAM,yCAAyC;;;;;;;;;CAS5C,CAAC;AAEX,eAAO,MAAM,sBAAsB;;;;;;;;;CASzB,CAAC;AAEX,eAAO,MAAM,uBAAuB,m7xDAg4CnC,CAAC;AAWF,MAAM,WAAW,6BAA6B;IAC5C,8EAA8E;IAC9E,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,8BAA8B,CAAC;IACzC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAQD,eAAO,MAAM,qBAAqB,GAChC,cAAc,OAAO,EACrB,UAAS,6BAAkC,KAC1C,MA8BF,CAAC"}
|
|
@@ -12,13 +12,14 @@ import {
|
|
|
12
12
|
} from "../chunks/chunk-7TB7NXSL.js";
|
|
13
13
|
import {
|
|
14
14
|
MAX_EXECUTOR_TIMEOUT_MS
|
|
15
|
-
} from "../chunks/chunk-
|
|
15
|
+
} from "../chunks/chunk-4NUTVNS2.js";
|
|
16
16
|
import "../chunks/chunk-OKOHRXGF.js";
|
|
17
17
|
import "../chunks/chunk-RAO6TQFP.js";
|
|
18
18
|
import "../chunks/chunk-KAD7UWT2.js";
|
|
19
|
-
import "../chunks/chunk-
|
|
19
|
+
import "../chunks/chunk-A4VP7HDF.js";
|
|
20
20
|
import "../chunks/chunk-MGWQOKBV.js";
|
|
21
|
-
import "../chunks/chunk-
|
|
21
|
+
import "../chunks/chunk-UR2K6WK6.js";
|
|
22
|
+
import "../chunks/chunk-B54Z662X.js";
|
|
22
23
|
import {
|
|
23
24
|
isPiShellRef
|
|
24
25
|
} from "../chunks/chunk-YU62DDKK.js";
|
|
@@ -28,7 +29,7 @@ import { createRequire } from "node:module";
|
|
|
28
29
|
|
|
29
30
|
// src/runtime/monty-bridge.ts
|
|
30
31
|
import { randomUUID } from "node:crypto";
|
|
31
|
-
var ROOTS = ["pi", "tools", "mcp", "extensions", "memory", "state", "schema", "components", "compact", "agents", "mesh"];
|
|
32
|
+
var ROOTS = ["pi", "tools", "mcp", "extensions", "memory", "state", "schema", "components", "compact", "prewalk", "agents", "mesh"];
|
|
32
33
|
var DISCOVERY = /* @__PURE__ */ new Set(["providers", "catalog", "list", "search", "describe", "call", "models", "progress"]);
|
|
33
34
|
var FORBIDDEN = /* @__PURE__ */ new Set(["constructor", "prototype", "__proto__", "arguments", "caller"]);
|
|
34
35
|
function montyBindings(native, call) {
|