@e4779/pi-fabric 0.105.0-fork.18 → 0.109.2-fork.23

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.
Files changed (225) hide show
  1. package/README.md +3 -1
  2. package/dist/actors/global-registry.d.ts.map +1 -1
  3. package/dist/agents/manager.d.ts.map +1 -1
  4. package/dist/agents/result.d.ts.map +1 -1
  5. package/dist/agents/result.js +1 -1
  6. package/dist/agents/runner-registry.d.ts +1 -1
  7. package/dist/agents/runner-registry.d.ts.map +1 -1
  8. package/dist/agents.js +5 -5
  9. package/dist/chunks/{chunk-5MNLVHF5.js → chunk-3DUKKQHN.js} +28 -13
  10. package/dist/chunks/chunk-3DUKKQHN.js.map +7 -0
  11. package/dist/chunks/{chunk-GJVPP3NN.js → chunk-3SHUUBZJ.js} +4 -4
  12. package/dist/chunks/chunk-3SHUUBZJ.js.map +7 -0
  13. package/dist/chunks/{chunk-VON4TSO3.js → chunk-CZPQTISQ.js} +27 -2
  14. package/dist/chunks/chunk-CZPQTISQ.js.map +7 -0
  15. package/dist/chunks/{chunk-WLLXKS6I.js → chunk-DU6ZA44F.js} +4 -4
  16. package/dist/chunks/{chunk-QLFDPXK7.js → chunk-DV2JZSCI.js} +153 -27
  17. package/dist/chunks/chunk-DV2JZSCI.js.map +7 -0
  18. package/dist/chunks/{chunk-KQ6R5EWR.js → chunk-FRPNQZV2.js} +24 -22
  19. package/dist/chunks/chunk-FRPNQZV2.js.map +7 -0
  20. package/dist/chunks/{chunk-W7X4XEQU.js → chunk-GC2AUXG6.js} +2 -2
  21. package/dist/chunks/chunk-K6QXUGS5.js +30 -0
  22. package/dist/chunks/chunk-K6QXUGS5.js.map +7 -0
  23. package/dist/chunks/{chunk-VPRJOD4Y.js → chunk-LEDY5G2V.js} +2 -2
  24. package/dist/chunks/{chunk-OVBKQCYL.js → chunk-N2VKKA7O.js} +2 -2
  25. package/dist/chunks/{chunk-N5GUXC6F.js → chunk-P4KH4S4S.js} +2 -1
  26. package/dist/chunks/chunk-P4KH4S4S.js.map +7 -0
  27. package/dist/chunks/{chunk-TFFZVLR2.js → chunk-PF27MQY5.js} +55 -4
  28. package/dist/chunks/chunk-PF27MQY5.js.map +7 -0
  29. package/dist/chunks/{chunk-CGL7QP4A.js → chunk-PK4NIJEV.js} +10 -1
  30. package/dist/chunks/{chunk-CGL7QP4A.js.map → chunk-PK4NIJEV.js.map} +2 -2
  31. package/dist/chunks/{chunk-YRDCJZZW.js → chunk-RUO6L7RM.js} +1 -1
  32. package/dist/chunks/{chunk-YRDCJZZW.js.map → chunk-RUO6L7RM.js.map} +1 -1
  33. package/dist/chunks/{chunk-4RTHQGES.js → chunk-ST36EYHN.js} +4 -4
  34. package/dist/chunks/chunk-ST36EYHN.js.map +7 -0
  35. package/dist/chunks/{chunk-R5F6CHW2.js → chunk-UXEMIWYI.js} +12 -7
  36. package/dist/chunks/chunk-UXEMIWYI.js.map +7 -0
  37. package/dist/chunks/{chunk-SGFH5PYA.js → chunk-V2SKDVQX.js} +10 -9
  38. package/dist/chunks/chunk-V2SKDVQX.js.map +7 -0
  39. package/dist/chunks/{chunk-KYXZJNV6.js → chunk-VTK2FEH7.js} +3 -1
  40. package/dist/chunks/{chunk-KYXZJNV6.js.map → chunk-VTK2FEH7.js.map} +2 -2
  41. package/dist/chunks/{chunk-3QECYQGA.js → chunk-VYQV5JRT.js} +13 -1
  42. package/dist/chunks/chunk-VYQV5JRT.js.map +7 -0
  43. package/dist/chunks/{chunk-3KDUMDPZ.js → chunk-X3CHSIL2.js} +5 -5
  44. package/dist/chunks/{chunk-6VXPACGC.js → chunk-YJX27XBO.js} +100 -22
  45. package/dist/chunks/chunk-YJX27XBO.js.map +7 -0
  46. package/dist/components/configuration.js +2 -2
  47. package/dist/config.d.ts +16 -1
  48. package/dist/config.d.ts.map +1 -1
  49. package/dist/core/action-registry.d.ts +1 -1
  50. package/dist/core/action-registry.d.ts.map +1 -1
  51. package/dist/core/action-registry.js +2 -2
  52. package/dist/core/media-sanitize.d.ts.map +1 -1
  53. package/dist/core/native-tool-names.d.ts +9 -0
  54. package/dist/core/native-tool-names.d.ts.map +1 -0
  55. package/dist/core/native-tool-result.d.ts +11 -0
  56. package/dist/core/native-tool-result.d.ts.map +1 -0
  57. package/dist/core/system-guidance.d.ts +3 -3
  58. package/dist/core/system-guidance.d.ts.map +1 -1
  59. package/dist/durable/agent.d.ts +77 -0
  60. package/dist/durable/agent.d.ts.map +1 -0
  61. package/dist/durable/session.d.ts +19 -0
  62. package/dist/durable/session.d.ts.map +1 -0
  63. package/dist/durable/storage.d.ts +7 -0
  64. package/dist/durable/storage.d.ts.map +1 -0
  65. package/dist/durable/worker-host.d.ts +13 -0
  66. package/dist/durable/worker-host.d.ts.map +1 -0
  67. package/dist/durable/worker-host.js +1149 -0
  68. package/dist/durable/worker-host.js.map +7 -0
  69. package/dist/durable/worker-options.d.ts +17 -0
  70. package/dist/durable/worker-options.d.ts.map +1 -0
  71. package/dist/durable/worker.d.ts +3 -0
  72. package/dist/durable/worker.d.ts.map +1 -0
  73. package/dist/durable/worker.js +110 -0
  74. package/dist/durable/worker.js.map +7 -0
  75. package/dist/durable-controls.d.ts +27 -0
  76. package/dist/durable-controls.d.ts.map +1 -0
  77. package/dist/durable-input.d.ts +13 -0
  78. package/dist/durable-input.d.ts.map +1 -0
  79. package/dist/durable.d.ts +6 -0
  80. package/dist/durable.d.ts.map +1 -1
  81. package/dist/durable.js +194 -24
  82. package/dist/durable.js.map +4 -4
  83. package/dist/execution-service.d.ts +4 -0
  84. package/dist/execution-service.d.ts.map +1 -1
  85. package/dist/extension-bootstrap.js +5 -5
  86. package/dist/extension.d.ts.map +1 -1
  87. package/dist/fabric-exec-arguments.d.ts.map +1 -1
  88. package/dist/fabric-exec-tool.d.ts.map +1 -1
  89. package/dist/fabric-runtime-state.d.ts.map +1 -1
  90. package/dist/fabric-runtime-state.js +633 -291
  91. package/dist/fabric-runtime-state.js.map +4 -4
  92. package/dist/index.js +5 -5
  93. package/dist/jev/observation.js +2 -2
  94. package/dist/jev.js +3 -3
  95. package/dist/mcp.js +1 -1
  96. package/dist/memory/extractive-history.d.ts +29 -0
  97. package/dist/memory/extractive-history.d.ts.map +1 -0
  98. package/dist/memory/extractive-history.js +340 -0
  99. package/dist/memory/extractive-history.js.map +7 -0
  100. package/dist/memory/extractive-index.d.ts +46 -0
  101. package/dist/memory/extractive-index.d.ts.map +1 -0
  102. package/dist/native-codemode.d.ts +34 -0
  103. package/dist/native-codemode.d.ts.map +1 -0
  104. package/dist/native-discovery.d.ts +16 -0
  105. package/dist/native-discovery.d.ts.map +1 -0
  106. package/dist/native-discovery.js +19 -0
  107. package/dist/native-discovery.js.map +7 -0
  108. package/dist/native-image-artifacts.d.ts +4 -0
  109. package/dist/native-image-artifacts.d.ts.map +1 -0
  110. package/dist/native-image-artifacts.js +18 -0
  111. package/dist/native-image-artifacts.js.map +7 -0
  112. package/dist/native-tool-catalog.d.ts +21 -0
  113. package/dist/native-tool-catalog.d.ts.map +1 -0
  114. package/dist/native-tool-catalog.js +71 -0
  115. package/dist/native-tool-catalog.js.map +7 -0
  116. package/dist/protocol.d.ts +2 -0
  117. package/dist/protocol.d.ts.map +1 -1
  118. package/dist/protocol.js +1 -1
  119. package/dist/providers/agents-provider.d.ts.map +1 -1
  120. package/dist/providers/captured-tools-provider.d.ts +1 -1
  121. package/dist/providers/captured-tools-provider.d.ts.map +1 -1
  122. package/dist/providers/jev-provider.js +3 -3
  123. package/dist/providers/mcp-provider.d.ts +1 -1
  124. package/dist/providers/mcp-provider.d.ts.map +1 -1
  125. package/dist/providers/pi-native-mcp.d.ts.map +1 -1
  126. package/dist/providers/pi-tools-provider.d.ts.map +1 -1
  127. package/dist/residency/host.js +7 -7
  128. package/dist/residency/pi-entry.js +7 -7
  129. package/dist/runners.js +1 -1
  130. package/dist/runtime/core-override-guest-types.js +2 -2
  131. package/dist/runtime/dynamic-guest-types.d.ts +2 -0
  132. package/dist/runtime/dynamic-guest-types.d.ts.map +1 -1
  133. package/dist/runtime/dynamic-guest-types.js +5 -3
  134. package/dist/runtime/guest-types.d.ts +1 -1
  135. package/dist/runtime/guest-types.d.ts.map +1 -1
  136. package/dist/runtime/guest-types.js +1 -1
  137. package/dist/runtime/kernel.d.ts +5 -0
  138. package/dist/runtime/kernel.d.ts.map +1 -1
  139. package/dist/runtime/monty-runtime.js +1 -1
  140. package/dist/runtime/native-codemode-guest.d.ts +2 -0
  141. package/dist/runtime/native-codemode-guest.d.ts.map +1 -0
  142. package/dist/runtime/native-codemode-types.d.ts +2 -0
  143. package/dist/runtime/native-codemode-types.d.ts.map +1 -0
  144. package/dist/runtime/node-process-child-source.d.ts.map +1 -1
  145. package/dist/runtime/node-process-runtime.d.ts.map +1 -1
  146. package/dist/runtime/node-process-runtime.js +3 -3
  147. package/dist/runtime/quickjs-runtime.d.ts +1 -1
  148. package/dist/runtime/quickjs-runtime.d.ts.map +1 -1
  149. package/dist/runtime/quickjs-runtime.js +3 -2
  150. package/dist/runtime/type-checker.d.ts +2 -0
  151. package/dist/runtime/type-checker.d.ts.map +1 -1
  152. package/dist/runtime/type-checker.js +5 -3
  153. package/dist/runtime/typescript-kernel.d.ts +1 -1
  154. package/dist/runtime/typescript-kernel.d.ts.map +1 -1
  155. package/dist/runtime/typescript-kernel.js +13 -11
  156. package/dist/runtime/typescript-kernel.js.map +2 -2
  157. package/dist/runtime-state-speculation.d.ts +4 -1
  158. package/dist/runtime-state-speculation.d.ts.map +1 -1
  159. package/dist/speculation/python-scanner.js +1 -1
  160. package/dist/speculation/python-scanner.js.map +2 -2
  161. package/dist/speculation/scanner.d.ts +2 -0
  162. package/dist/speculation/scanner.d.ts.map +1 -1
  163. package/dist/speculation/scanner.js +18 -4
  164. package/dist/speculation/scanner.js.map +2 -2
  165. package/dist/speculation/types.d.ts +1 -0
  166. package/dist/speculation/types.d.ts.map +1 -1
  167. package/dist/type-error-guidance.js +1 -1
  168. package/dist/ui/border-status-editor.d.ts +3 -0
  169. package/dist/ui/border-status-editor.d.ts.map +1 -1
  170. package/dist/ui/controller.d.ts.map +1 -1
  171. package/dist/ui/conversation.d.ts +1 -0
  172. package/dist/ui/conversation.d.ts.map +1 -1
  173. package/dist/ui/conversation.js +28 -5
  174. package/dist/ui/conversation.js.map +2 -2
  175. package/dist/ui/dashboard.d.ts +2 -0
  176. package/dist/ui/dashboard.d.ts.map +1 -1
  177. package/dist/ui/dashboard.js +20 -7
  178. package/dist/ui/dashboard.js.map +2 -2
  179. package/dist/ui/settings-section-context.d.ts +2 -0
  180. package/dist/ui/settings-section-context.d.ts.map +1 -1
  181. package/dist/ui/settings-sections-execution.d.ts.map +1 -1
  182. package/dist/ui/settings-sections-lifecycle.d.ts +1 -0
  183. package/dist/ui/settings-sections-lifecycle.d.ts.map +1 -1
  184. package/dist/ui/settings-sections.d.ts +2 -0
  185. package/dist/ui/settings-sections.d.ts.map +1 -1
  186. package/dist/ui/settings-values.d.ts +4 -1
  187. package/dist/ui/settings-values.d.ts.map +1 -1
  188. package/dist/ui/settings.d.ts.map +1 -1
  189. package/dist/ui/settings.js +61 -2
  190. package/dist/ui/settings.js.map +2 -2
  191. package/dist/worker/model-control.d.ts.map +1 -1
  192. package/dist/worker/model-control.js.map +2 -2
  193. package/dist/worker/options.d.ts.map +1 -1
  194. package/dist/worker/options.js +4 -3
  195. package/dist/worker/options.js.map +2 -2
  196. package/dist/worker/result.js +12 -0
  197. package/dist/worker/result.js.map +2 -2
  198. package/dist/worker.js +95 -8
  199. package/dist/worker.js.map +2 -2
  200. package/docs/agents.md +5 -5
  201. package/docs/codemode-parity.md +97 -0
  202. package/docs/configuration.md +31 -2
  203. package/docs/durable-pi.md +166 -38
  204. package/docs/extractive-history.md +171 -0
  205. package/docs/interface.md +1 -1
  206. package/docs/speculation.md +12 -3
  207. package/package.json +7 -16
  208. package/skillsets/typescript/fabric-exec/SKILL.md +4 -4
  209. package/dist/chunks/chunk-3QECYQGA.js.map +0 -7
  210. package/dist/chunks/chunk-4RTHQGES.js.map +0 -7
  211. package/dist/chunks/chunk-5MNLVHF5.js.map +0 -7
  212. package/dist/chunks/chunk-6VXPACGC.js.map +0 -7
  213. package/dist/chunks/chunk-GJVPP3NN.js.map +0 -7
  214. package/dist/chunks/chunk-KQ6R5EWR.js.map +0 -7
  215. package/dist/chunks/chunk-N5GUXC6F.js.map +0 -7
  216. package/dist/chunks/chunk-QLFDPXK7.js.map +0 -7
  217. package/dist/chunks/chunk-R5F6CHW2.js.map +0 -7
  218. package/dist/chunks/chunk-SGFH5PYA.js.map +0 -7
  219. package/dist/chunks/chunk-TFFZVLR2.js.map +0 -7
  220. package/dist/chunks/chunk-VON4TSO3.js.map +0 -7
  221. /package/dist/chunks/{chunk-WLLXKS6I.js.map → chunk-DU6ZA44F.js.map} +0 -0
  222. /package/dist/chunks/{chunk-W7X4XEQU.js.map → chunk-GC2AUXG6.js.map} +0 -0
  223. /package/dist/chunks/{chunk-VPRJOD4Y.js.map → chunk-LEDY5G2V.js.map} +0 -0
  224. /package/dist/chunks/{chunk-OVBKQCYL.js.map → chunk-N2VKKA7O.js.map} +0 -0
  225. /package/dist/chunks/{chunk-3KDUMDPZ.js.map → chunk-X3CHSIL2.js.map} +0 -0
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/protocol.ts"],
4
- "sourcesContent": ["import type { BashOperations, BashToolOptions, ExtensionContext } from \"@earendil-works/pi-coding-agent\";\n\n/** Host-local opt-in on a bash ToolDefinition; never serialized into guest schemas. */\nexport const FABRIC_BASH_MIDDLEWARE = Symbol.for(\"pi-fabric:bash-middleware:v1\");\n\n/** The extension keeps standalone execution; Fabric owns local process/job lifetime. */\nexport interface FabricBashMiddlewareV1 {\n version: 1;\n options?: Omit<BashToolOptions, \"operations\">;\n /** Filter output before Fabric retains it in previews, results, or background logs. */\n wrapOperations: (operations: BashOperations) => BashOperations;\n}\n\nexport type {\n FabricCacheHoldOptions, FabricCacheHoldResult, FabricCacheLease,\n FabricCacheSample, FabricCacheObservation, FabricCacheStatus,\n} from \"./cache/types.js\";\n\n/** Host-local background shell accounting, independent of model-facing notifications. */\nexport const FABRIC_SHELL_TIMING_EVENT = \"pi-fabric:shell:timing:v1\";\n\nexport interface FabricShellTimingV1 {\n version: 1;\n sessionId: string;\n taskId: string;\n tool: \"bash\" | \"powershell\";\n /** started = handoff to background; finished includes runtime teardown. */\n phase: \"started\" | \"finished\";\n /** Synchronous observation time, not a backdated process timestamp. */\n timestamp: number;\n}\n\n/** Host-emitted on each `workflow.item` status transition; observation only. */\nexport const FABRIC_WORKFLOW_ITEM_EVENT = \"pi-fabric:workflow-item:v1\";\n\nexport type FabricWorkflowItemStatusV1 =\n | \"pending\"\n | \"running\"\n | \"completed\"\n | \"failed\"\n | \"blocked\"\n | \"stopped\";\n\nexport interface FabricWorkflowItemEventV1 {\n version: 1;\n /** The outer `fabric_exec` tool call id that owns the item. */\n invocationId: string;\n sessionId?: string;\n /** Caller-supplied stable id, or the deterministic per-invocation `item-<n>`. */\n itemId: string;\n label?: string;\n /** Absent on the item's first status. */\n from?: FabricWorkflowItemStatusV1;\n to: FabricWorkflowItemStatusV1;\n /** Synchronous observation time (epoch ms). */\n at: number;\n /** Caller-supplied plain JSON object carried by the transitioning call. */\n meta?: Record<string, unknown>;\n}\n\n/** Host-local request: run a saved program without the model, like `/fabric run`. */\nexport const FABRIC_PROGRAM_RUN_EVENT = \"pi-fabric:program:run:v1\";\n\nexport type FabricProgramRunReplyV1 =\n | { ok: true; program: string; value: unknown; logs: string[] }\n | { ok: false; error: string; program?: string };\n\nexport interface FabricProgramRunRequestV1 {\n /** name, name@<digest prefix >= 12>, or a full digest. */\n ref: string;\n input?: unknown;\n requirePromoted?: boolean;\n signal?: AbortSignal;\n /** Called exactly once. */\n reply: (result: FabricProgramRunReplyV1) => void;\n}\n\nexport const FABRIC_PROVIDER_REGISTER_EVENT = \"pi-fabric:provider:register:v1\";\nexport const FABRIC_PROVIDER_DISCOVER_EVENT = \"pi-fabric:provider:discover:v1\";\nexport const FABRIC_PROVIDER_WITHDRAW_EVENT = \"pi-fabric:provider:withdraw:v1\";\n\n/**\n * Withdraws a directly registered provider. `generation` pins the withdrawal\n * to one binding: a number matches the binding generation, a string matches\n * the provider binding id. A mismatch or unknown name is ignored.\n */\nexport interface FabricProviderWithdrawalV1 {\n name: string;\n generation?: number | string;\n}\n\nexport const readFabricProviderWithdrawalV1 = (\n value: unknown,\n): FabricProviderWithdrawalV1 | undefined => {\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n const record = value as Record<string, unknown>;\n const generation = record.generation;\n if (\n typeof record.name !== \"string\" ||\n record.name.length === 0 ||\n record.name.length > 128 ||\n (generation !== undefined &&\n !(typeof generation === \"number\" && Number.isSafeInteger(generation) && generation > 0) &&\n !(typeof generation === \"string\" && generation.length > 0 && generation.length <= 128))\n ) {\n return undefined;\n }\n return {\n name: record.name,\n ...(generation !== undefined ? { generation: generation as number | string } : {}),\n };\n};\n\nexport const FABRIC_TOOL_PLACEMENT_EVENT = \"pi-fabric:tool-placement:v1\";\nexport const MAX_FABRIC_TOOL_PLACEMENT_QUERY = 1_024;\n\n/**\n * model = declared to the model this turn; program = callable from\n * fabric_exec (pi.* / extensions.*); unavailable otherwise. model wins when\n * both apply.\n */\nexport type FabricToolPlacement = \"model\" | \"program\" | \"unavailable\";\nexport type FabricToolPlacementMode = \"full-code\" | \"enforce\" | \"orchestration\";\n\nexport interface FabricToolPlacementResultV1 {\n version: 1;\n mode: FabricToolPlacementMode;\n tools: Record<string, FabricToolPlacement>;\n /** `model` tools a program can also call (foreground tools); omitted when empty. */\n programCallable?: string[];\n}\n\n/** Host-local synchronous query; omitted `tools` reports every registered tool. */\nexport interface FabricToolPlacementRequestV1 {\n tools?: string[];\n reply: (result: FabricToolPlacementResultV1) => void;\n}\n\nexport const readFabricToolPlacementRequestV1 = (\n value: unknown,\n): FabricToolPlacementRequestV1 | undefined => {\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n const record = value as Record<string, unknown>;\n const tools = record.tools;\n if (\n typeof record.reply !== \"function\" ||\n (tools !== undefined && (\n !Array.isArray(tools) ||\n tools.length > MAX_FABRIC_TOOL_PLACEMENT_QUERY ||\n tools.some((name) => typeof name !== \"string\" || name.length === 0 || name.length > 256)\n ))\n ) {\n return undefined;\n }\n return value as FabricToolPlacementRequestV1;\n};\nexport const FABRIC_COMPONENT_REGISTER_EVENT = \"pi-fabric:component:register:v1\";\nexport const FABRIC_COMPONENT_DISCOVER_EVENT = \"pi-fabric:component:discover:v1\";\nexport const FABRIC_PREWALK_REQUEST_EVENT = \"pi-fabric:prewalk:request:v1\";\n\nexport type FabricPrewalkRequestResultV1 =\n | { ok: true }\n | { ok: false; error: string };\n\n/** Host-local request used by queue extensions that need an acknowledged prewalk arm. */\nexport interface FabricPrewalkRequestV1 {\n version: 1;\n context: ExtensionContext;\n claim: () => boolean;\n respond: (result: FabricPrewalkRequestResultV1) => void;\n}\n\nexport const readFabricPrewalkRequestV1 = (\n value: unknown,\n): FabricPrewalkRequestV1 | undefined => {\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n const record = value as Record<string, unknown>;\n if (\n record.version !== 1 ||\n typeof record.context !== \"object\" ||\n record.context === null ||\n typeof record.claim !== \"function\" ||\n typeof record.respond !== \"function\"\n ) {\n return undefined;\n }\n return value as FabricPrewalkRequestV1;\n};\n\nexport const FABRIC_PEER_CARDS_EVENT = \"pi-fabric:peers:cards:v1\";\nexport const FABRIC_PEER_AWAIT_SETTLE_EVENT = \"pi-fabric:peer:await-settle:v1\";\n\n/** One root peer session on the project mesh, for pickers and status lines. */\nexport interface FabricPeerCardV1 {\n id: string;\n /** Linear-style project label (e.g. \"PQS-2\") minted by the owning host. */\n label: string;\n status: \"idle\" | \"running\";\n model?: string;\n cwd?: string;\n startedAt: number;\n updatedAt: number;\n pendingMessages: boolean;\n}\n\nexport type FabricPeerCardsResultV1 =\n | { ok: true; cards: FabricPeerCardV1[] }\n | { ok: false; error: string };\n\n/** Host-local request used by queue extensions to enumerate live peer sessions. */\nexport interface FabricPeerCardsRequestV1 {\n version: 1;\n context: ExtensionContext;\n claim: () => boolean;\n respond: (result: FabricPeerCardsResultV1) => void;\n}\n\nexport const readFabricPeerCardsRequestV1 = (\n value: unknown,\n): FabricPeerCardsRequestV1 | undefined => {\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n const record = value as Record<string, unknown>;\n if (\n record.version !== 1 ||\n typeof record.context !== \"object\" ||\n record.context === null ||\n typeof record.claim !== \"function\" ||\n typeof record.respond !== \"function\"\n ) {\n return undefined;\n }\n return value as FabricPeerCardsRequestV1;\n};\n\nexport interface FabricPeerSettleProgressV1 {\n waiting: Array<{ label: string; status: \"idle\" | \"running\" }>;\n}\n\nexport type FabricPeerAwaitSettleResultV1 =\n | { ok: true }\n | { ok: false; error: string };\n\n/**\n * Host-local request used by queue extensions to hold dispatch until peer\n * sessions settle. A peer counts as settled once it has been quiet\n * (status-wide) for settledForMs; peers that vanish from the mesh count as\n * settled since they can no longer conflict. Selector matches a peer label\n * (case-insensitive) or exact participant id; omitted waits on all peers.\n */\nexport interface FabricPeerAwaitSettleRequestV1 {\n version: 1;\n context: ExtensionContext;\n selector?: string;\n settledForMs?: number;\n signal?: AbortSignal;\n update?: (progress: FabricPeerSettleProgressV1) => void;\n claim: () => boolean;\n respond: (result: FabricPeerAwaitSettleResultV1) => void;\n}\n\nexport const readFabricPeerAwaitSettleRequestV1 = (\n value: unknown,\n): FabricPeerAwaitSettleRequestV1 | undefined => {\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n const record = value as Record<string, unknown>;\n const signal = record.signal as AbortSignal | undefined;\n if (\n record.version !== 1 ||\n typeof record.context !== \"object\" ||\n record.context === null ||\n typeof record.claim !== \"function\" ||\n typeof record.respond !== \"function\" ||\n (record.selector !== undefined && typeof record.selector !== \"string\") ||\n (record.settledForMs !== undefined && typeof record.settledForMs !== \"number\") ||\n (signal !== undefined && typeof signal.aborted !== \"boolean\") ||\n (record.update !== undefined && typeof record.update !== \"function\")\n ) {\n return undefined;\n }\n return value as FabricPeerAwaitSettleRequestV1;\n};\n\n/** Identifies host-side tool lifecycle events replayed for a nested Fabric call. */\nexport const FABRIC_NESTED_TOOL_CALL_ID_PREFIX = \"fabric_\";\n\n/** Discriminant for the transient details envelope on a proxied provider result. */\nexport const FABRIC_TOOL_RESULT_PROXY_KIND = \"pi-fabric.tool-result-proxy.v1\";\n\n/**\n * Host-only middleware details for non-Pi Fabric providers. `result` is the\n * exact value before maxNestedResultChars is enforced and is not persisted as\n * a separate Pi tool-result message.\n */\nexport interface FabricToolResultProxyDetailsV1 {\n kind: typeof FABRIC_TOOL_RESULT_PROXY_KIND;\n ref: string;\n result: unknown;\n}\n\nexport const readFabricToolResultProxyDetailsV1 = (\n value: unknown,\n): FabricToolResultProxyDetailsV1 | undefined => {\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n const record = value as Record<string, unknown>;\n if (\n record.kind !== FABRIC_TOOL_RESULT_PROXY_KIND ||\n typeof record.ref !== \"string\" ||\n !Object.prototype.hasOwnProperty.call(record, \"result\")\n ) {\n return undefined;\n }\n return record as unknown as FabricToolResultProxyDetailsV1;\n};\n\nexport type FabricRisk = \"read\" | \"write\" | \"execute\" | \"network\" | \"agent\";\nexport type FabricEffectKind = \"none\" | \"scoped\" | \"transactional\" | \"emission\";\nexport type FabricEffectOrdering = \"commutative\" | \"ordered\" | \"unknown\";\n\nexport interface FabricActionEffect {\n kind: FabricEffectKind;\n resources?: string[];\n ordering?: FabricEffectOrdering;\n}\n\n/** MCP tool annotations (Model Context Protocol ToolAnnotations), cached when a runtime surfaces them. */\nexport interface FabricToolAnnotations {\n readOnlyHint?: boolean;\n idempotentHint?: boolean;\n destructiveHint?: boolean;\n openWorldHint?: boolean;\n}\nexport type FabricActivityEntityKind =\n | \"agent\"\n | \"actor\"\n | \"tool\"\n | \"extension\"\n | \"mcp\"\n | \"mesh\"\n | \"task\"\n | \"custom\";\n\nexport type FabricInvocationActivityUpdate =\n | { type: \"progress\"; message: string }\n | { type: \"entity\"; id: string; kind: FabricActivityEntityKind; name?: string }\n | { type: \"metrics\"; tokens?: number; toolCalls?: number; cost?: number };\n\nexport interface FabricMediaBlock {\n type: \"image\";\n data: string;\n mimeType: string;\n}\n\nexport interface FabricActionDescriptor {\n name: string;\n description: string;\n inputSchema: Record<string, unknown>;\n outputSchema?: Record<string, unknown>;\n risk: FabricRisk;\n namespace?: string;\n effect?: FabricActionEffect;\n annotations?: FabricToolAnnotations;\n}\n\nexport interface FabricCapabilityActionHead {\n key: string;\n parentKey: string;\n ref: string;\n name: string;\n description: string;\n descriptorHash: string;\n risk: FabricRisk;\n namespace?: string;\n effect?: FabricActionEffect;\n}\n\nexport interface FabricCapabilityProviderHead {\n key: string;\n parentKey: string;\n name: string;\n description: string;\n descriptorHash: string;\n actions: FabricCapabilityActionHead[];\n}\n\nexport interface FabricCapabilityBindingView {\n ref: string;\n provider: string;\n providerBindingId: string;\n generation: number;\n descriptorHash: string;\n}\n\n/** Immutable issuer-owned authority, not a serializable bearer grant.\n * Another registry must resolve a fresh view; copies and released views are invalid. */\nexport interface FabricCommittedCapabilityView {\n id: string;\n /** Runtime-local digest including provider binding generations. */\n digest: string;\n /** Portable digest of exact refs and descriptor semantics across runtimes. */\n semanticDigest: string;\n bindings: Record<string, FabricCapabilityBindingView>;\n}\n\nexport interface FabricCapabilityResolution {\n satisfied: boolean;\n missing: string[];\n optionalMissing: string[];\n view?: FabricCommittedCapabilityView;\n}\n\nexport interface 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}\n\nexport interface FabricProviderListRequest {\n namespace?: string;\n query?: string;\n limit?: number;\n}\n\n/** One named action whose arguments should be typed in guest declarations. */\nexport interface FabricNamedActionTypeSource {\n name: string;\n inputSchema: Record<string, unknown>;\n}\n\n/** One MCP server plus the tools to type for `mcp.<server>.*` guest calls. */\nexport interface FabricMcpServerTypeSource {\n server: string;\n tools: FabricNamedActionTypeSource[];\n}\n\nexport type {\n FabricKernel,\n FabricKernelRuntime,\n FabricHostCall,\n FabricSandboxOptions,\n FabricSandboxResult,\n FabricSandboxTerminationReason,\n} from \"./runtime/kernel.js\";\nexport type { FabricPythonRuntime } from \"./config.js\";\n\n/**\n * Live descriptor snapshot the registry hands to the guest declaration\n * builder so dynamic surfaces (mcp, extensions) get argument checking before\n * the sandbox runs. Empty/absent sections keep the loose static declarations.\n */\nexport interface FabricGuestTypeSources {\n mcpServers?: FabricMcpServerTypeSource[];\n extensionTools?: FabricNamedActionTypeSource[];\n}\n\n/**\n * Pre-rendered `declare const` blocks replacing the loose mcp/extensions\n * declaration lines. Values are full replacement text (helpers + declare).\n */\nexport interface FabricDynamicGuestDeclarations {\n mcp?: string;\n extensions?: string;\n}\n\n/**\n * Provider-owned work (for example a delegated run) registered with Fabric's\n * participant directory under `provider:<provider>:<id>`. Non-detached\n * participants are stopped when their fabric_exec program is cancelled or\n * times out; detached ones survive until stopped, withdrawn, or shut down.\n */\nexport interface FabricParticipantSpec {\n /** Unique per provider while unsettled; `[A-Za-z0-9][A-Za-z0-9._:-]{0,63}`. */\n id: string;\n label: string;\n kind?: string;\n detached?: boolean;\n stop(reason: string): Promise<{ confirmed: boolean }>;\n steer?(message: string): Promise<void>;\n followUp?(message: string): Promise<void>;\n}\n\nexport interface FabricParticipantProgress {\n phase?: string;\n message?: string;\n /** Cumulative totals; each update replaces the previous usage. */\n usage?: { input?: number; output?: number; cacheRead?: number; cacheWrite?: number; cost?: number };\n}\n\nexport interface FabricParticipantSettlement {\n status: \"completed\" | \"failed\" | \"stopped\";\n summary?: string;\n}\n\nexport interface FabricParticipantHandle {\n readonly ref: string;\n update(progress: FabricParticipantProgress): void;\n settle(result: FabricParticipantSettlement): void;\n dispose(): void;\n}\n\nexport interface FabricInvocationParticipants {\n register(spec: FabricParticipantSpec): FabricParticipantHandle;\n}\n\n/** Host-issued principal and grants (`pi-fabric/scope`); trusted host code, not a verified kernel. */\nexport type FabricScopeAction = \"read\" | \"write\" | \"execute\";\nexport interface FabricScopeGrant {\n /** `<ns>:<path>`, `<ns>:<path>/*` (one level), `<ns>:<path>/**` (any depth) or `<ns>:*`. */\n resource: string;\n actions: FabricScopeAction[];\n}\nexport interface FabricScope {\n version: 1;\n principal: { id: string; issuer: \"host\" };\n /** At most 64, merged per resource and sorted. */\n grants: FabricScopeGrant[];\n /** sha256 hex of canonical JSON { grants, parentDigest?, principal }. */\n digest: string;\n parentDigest?: string;\n}\n/**\n * Host-stamped authority of a message's sender (actor mailbox items, mesh\n * events). \"host\" is an unscoped session; \"scope\" carries the sender's scope,\n * with grants when they fit. Absent on records written by older builds.\n */\nexport type FabricMessageSender =\n | { authority: \"host\" }\n | {\n authority: \"scope\";\n principalId: string;\n digest: string;\n grants?: FabricScopeGrant[];\n parentDigest?: string;\n };\n\nexport interface FabricInvocationContext {\n cwd: string;\n signal: AbortSignal | undefined;\n parentToolCallId: string;\n nestedToolCallId: string;\n extensionContext: ExtensionContext;\n update(message: string): void;\n activity?(update: FabricInvocationActivityUpdate): void;\n /** Host-supplied inside fabric_exec: register provider-owned work as a participant. */\n participants?: FabricInvocationParticipants;\n /** Host-supplied inside fabric_exec so agents.handoff schedules the outer-call boundary. */\n deferHandoff?(args: Record<string, unknown>): Record<string, unknown>;\n // Out-of-band image content blocks a provider (currently only pi.read of an\n // image file) wants attached to the call audit, so the single-call render can\n // re-attach them to the fabric_exec result content for pi core's kitty image\n // preview. Bypasses the result char bound that would truncate the base64.\n // `note` is the read tool's own text output (e.g. \"Read image file [image/png]\"),\n // captured after any tool_result patch so a handoff that strips pi's\n // non-vision note has run; used as the single-call body + content text so the\n // preview shows the clean note instead of the swapped description.\n attachMedia?(blocks: FabricMediaBlock[], note?: string): void;\n // Providers call this after mutable tool_call middleware has run so live and\n // durable audit surfaces reflect the arguments actually passed to the tool.\n updateArguments?(args: Record<string, unknown>): void;\n // Ephemeral renderer-only metadata. It is exposed to live Fabric previews but\n // never projected into the durable execution trace.\n attachPreview?(preview: unknown): void;\n capabilityView?: FabricCommittedCapabilityView;\n /** Frozen host-issued scope; set by the registry only, absent when unscoped. */\n scope?: Readonly<FabricScope>;\n /** Advisory for ordinary calls; strict components reject concurrent conflicting effects. */\n effectPolicy?: \"advisory\" | \"strict\";\n}\n\nexport interface FabricScopedProviderResult {\n value: unknown;\n dispose(): void | Promise<void>;\n}\n\nexport interface FabricProvider {\n name: string;\n description: string;\n list(\n request: FabricProviderListRequest,\n context: FabricInvocationContext,\n ): Promise<FabricActionDescriptor[]>;\n describe(\n actionName: string,\n context: FabricInvocationContext,\n ): Promise<FabricActionDescriptor | undefined>;\n prepareArguments?(\n actionName: string,\n args: Record<string, unknown>,\n context: FabricInvocationContext,\n ): Record<string, unknown> | Promise<Record<string, unknown>>;\n invoke(\n actionName: string,\n args: Record<string, unknown>,\n context: FabricInvocationContext,\n ): Promise<unknown>;\n acquire?(\n actionName: string,\n args: Record<string, unknown>,\n context: FabricInvocationContext,\n ): Promise<FabricScopedProviderResult>;\n invocationEnded?(parentToolCallId: string): Promise<void>;\n subscribeCatalog?(listener: () => void): () => void;\n close?(): Promise<void>;\n}\n\nexport interface FabricProviderRegistration {\n version: 1;\n provider: FabricProvider;\n overwrite?: boolean;\n}\n\nexport interface FabricProviderDiscovery {\n version: 1;\n register(provider: FabricProvider, options?: { overwrite?: boolean }): void;\n}\n\nexport type {\n ComponentChangeRequest as FabricComponentChangeRequest,\n ComponentChangePlan as FabricComponentChangePlan,\n} from \"./components/control.js\";\n\nexport type {\n FabricCapabilityRequirement,\n FabricComponentChildOptions,\n FabricComponentContext,\n FabricComponentDefinition,\n FabricComponentDiscovery,\n FabricComponentDisposer,\n FabricComponentEffect,\n FabricComponentEffectConflict,\n FabricComponentEffectInfo,\n FabricComponentEffectOptions,\n FabricComponentEffectRegistration,\n FabricComponentEntry,\n FabricComponentGraph,\n FabricComponentGuarantee,\n FabricComponentHandle,\n FabricComponentInfo,\n FabricComponentProviderLease,\n FabricModelGuidance,\n FabricModelGuidanceInfo,\n FabricModelGuidancePlacement,\n FabricModelGuidanceTarget,\n FabricComponentProvision,\n FabricComponentRegistration,\n FabricComponentState,\n FabricComponentStopOptions,\n} from \"./components/types.js\";\n\nexport {\n FABRIC_EXECUTION_GUIDANCE_SLOT,\n MAX_FABRIC_MODEL_GUIDANCE_CONTENT_CHARS,\n MAX_FABRIC_MODEL_GUIDANCE_PER_COMPONENT,\n MAX_FABRIC_MODEL_GUIDANCE_REGISTRATIONS,\n MAX_FABRIC_MODEL_GUIDANCE_SNAPSHOT_CHARS,\n MAX_FABRIC_MODEL_GUIDANCE_TOTAL_CHARS,\n} from \"./components/model-guidance.js\";\n"],
4
+ "sourcesContent": ["import type { BashOperations, BashToolOptions, ExtensionContext } from \"@earendil-works/pi-coding-agent\";\n\n/** Host-local opt-in on a bash ToolDefinition; never serialized into guest schemas. */\nexport const FABRIC_BASH_MIDDLEWARE = Symbol.for(\"pi-fabric:bash-middleware:v1\");\n\n/** The extension keeps standalone execution; Fabric owns local process/job lifetime. */\nexport interface FabricBashMiddlewareV1 {\n version: 1;\n options?: Omit<BashToolOptions, \"operations\">;\n /** Filter output before Fabric retains it in previews, results, or background logs. */\n wrapOperations: (operations: BashOperations) => BashOperations;\n}\n\nexport type {\n FabricCacheHoldOptions, FabricCacheHoldResult, FabricCacheLease,\n FabricCacheSample, FabricCacheObservation, FabricCacheStatus,\n} from \"./cache/types.js\";\n\n/** Host-local background shell accounting, independent of model-facing notifications. */\nexport const FABRIC_SHELL_TIMING_EVENT = \"pi-fabric:shell:timing:v1\";\n\nexport interface FabricShellTimingV1 {\n version: 1;\n sessionId: string;\n taskId: string;\n tool: \"bash\" | \"powershell\";\n /** started = handoff to background; finished includes runtime teardown. */\n phase: \"started\" | \"finished\";\n /** Synchronous observation time, not a backdated process timestamp. */\n timestamp: number;\n}\n\n/** Host-emitted on each `workflow.item` status transition; observation only. */\nexport const FABRIC_WORKFLOW_ITEM_EVENT = \"pi-fabric:workflow-item:v1\";\n\nexport type FabricWorkflowItemStatusV1 =\n | \"pending\"\n | \"running\"\n | \"completed\"\n | \"failed\"\n | \"blocked\"\n | \"stopped\";\n\nexport interface FabricWorkflowItemEventV1 {\n version: 1;\n /** The outer `fabric_exec` tool call id that owns the item. */\n invocationId: string;\n sessionId?: string;\n /** Caller-supplied stable id, or the deterministic per-invocation `item-<n>`. */\n itemId: string;\n label?: string;\n /** Absent on the item's first status. */\n from?: FabricWorkflowItemStatusV1;\n to: FabricWorkflowItemStatusV1;\n /** Synchronous observation time (epoch ms). */\n at: number;\n /** Caller-supplied plain JSON object carried by the transitioning call. */\n meta?: Record<string, unknown>;\n}\n\n/** Host-local request: run a saved program without the model, like `/fabric run`. */\nexport const FABRIC_PROGRAM_RUN_EVENT = \"pi-fabric:program:run:v1\";\n\nexport type FabricProgramRunReplyV1 =\n | { ok: true; program: string; value: unknown; logs: string[] }\n | { ok: false; error: string; program?: string };\n\nexport interface FabricProgramRunRequestV1 {\n /** name, name@<digest prefix >= 12>, or a full digest. */\n ref: string;\n input?: unknown;\n requirePromoted?: boolean;\n signal?: AbortSignal;\n /** Called exactly once. */\n reply: (result: FabricProgramRunReplyV1) => void;\n}\n\nexport const FABRIC_PROVIDER_REGISTER_EVENT = \"pi-fabric:provider:register:v1\";\nexport const FABRIC_PROVIDER_DISCOVER_EVENT = \"pi-fabric:provider:discover:v1\";\nexport const FABRIC_PROVIDER_WITHDRAW_EVENT = \"pi-fabric:provider:withdraw:v1\";\n\n/**\n * Withdraws a directly registered provider. `generation` pins the withdrawal\n * to one binding: a number matches the binding generation, a string matches\n * the provider binding id. A mismatch or unknown name is ignored.\n */\nexport interface FabricProviderWithdrawalV1 {\n name: string;\n generation?: number | string;\n}\n\nexport const readFabricProviderWithdrawalV1 = (\n value: unknown,\n): FabricProviderWithdrawalV1 | undefined => {\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n const record = value as Record<string, unknown>;\n const generation = record.generation;\n if (\n typeof record.name !== \"string\" ||\n record.name.length === 0 ||\n record.name.length > 128 ||\n (generation !== undefined &&\n !(typeof generation === \"number\" && Number.isSafeInteger(generation) && generation > 0) &&\n !(typeof generation === \"string\" && generation.length > 0 && generation.length <= 128))\n ) {\n return undefined;\n }\n return {\n name: record.name,\n ...(generation !== undefined ? { generation: generation as number | string } : {}),\n };\n};\n\nexport const FABRIC_TOOL_PLACEMENT_EVENT = \"pi-fabric:tool-placement:v1\";\nexport const MAX_FABRIC_TOOL_PLACEMENT_QUERY = 1_024;\n\n/**\n * model = declared to the model this turn; program = callable from\n * fabric_exec (pi.* / extensions.*); unavailable otherwise. model wins when\n * both apply.\n */\nexport type FabricToolPlacement = \"model\" | \"program\" | \"unavailable\";\nexport type FabricToolPlacementMode = \"full-code\" | \"enforce\" | \"orchestration\";\n\nexport interface FabricToolPlacementResultV1 {\n version: 1;\n mode: FabricToolPlacementMode;\n tools: Record<string, FabricToolPlacement>;\n /** `model` tools a program can also call (foreground tools); omitted when empty. */\n programCallable?: string[];\n}\n\n/** Host-local synchronous query; omitted `tools` reports every registered tool. */\nexport interface FabricToolPlacementRequestV1 {\n tools?: string[];\n reply: (result: FabricToolPlacementResultV1) => void;\n}\n\nexport const readFabricToolPlacementRequestV1 = (\n value: unknown,\n): FabricToolPlacementRequestV1 | undefined => {\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n const record = value as Record<string, unknown>;\n const tools = record.tools;\n if (\n typeof record.reply !== \"function\" ||\n (tools !== undefined && (\n !Array.isArray(tools) ||\n tools.length > MAX_FABRIC_TOOL_PLACEMENT_QUERY ||\n tools.some((name) => typeof name !== \"string\" || name.length === 0 || name.length > 256)\n ))\n ) {\n return undefined;\n }\n return value as FabricToolPlacementRequestV1;\n};\nexport const FABRIC_COMPONENT_REGISTER_EVENT = \"pi-fabric:component:register:v1\";\nexport const FABRIC_COMPONENT_DISCOVER_EVENT = \"pi-fabric:component:discover:v1\";\nexport const FABRIC_PREWALK_REQUEST_EVENT = \"pi-fabric:prewalk:request:v1\";\n\nexport type FabricPrewalkRequestResultV1 =\n | { ok: true }\n | { ok: false; error: string };\n\n/** Host-local request used by queue extensions that need an acknowledged prewalk arm. */\nexport interface FabricPrewalkRequestV1 {\n version: 1;\n context: ExtensionContext;\n claim: () => boolean;\n respond: (result: FabricPrewalkRequestResultV1) => void;\n}\n\nexport const readFabricPrewalkRequestV1 = (\n value: unknown,\n): FabricPrewalkRequestV1 | undefined => {\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n const record = value as Record<string, unknown>;\n if (\n record.version !== 1 ||\n typeof record.context !== \"object\" ||\n record.context === null ||\n typeof record.claim !== \"function\" ||\n typeof record.respond !== \"function\"\n ) {\n return undefined;\n }\n return value as FabricPrewalkRequestV1;\n};\n\nexport const FABRIC_PEER_CARDS_EVENT = \"pi-fabric:peers:cards:v1\";\nexport const FABRIC_PEER_AWAIT_SETTLE_EVENT = \"pi-fabric:peer:await-settle:v1\";\n\n/** One root peer session on the project mesh, for pickers and status lines. */\nexport interface FabricPeerCardV1 {\n id: string;\n /** Linear-style project label (e.g. \"PQS-2\") minted by the owning host. */\n label: string;\n status: \"idle\" | \"running\";\n model?: string;\n cwd?: string;\n startedAt: number;\n updatedAt: number;\n pendingMessages: boolean;\n}\n\nexport type FabricPeerCardsResultV1 =\n | { ok: true; cards: FabricPeerCardV1[] }\n | { ok: false; error: string };\n\n/** Host-local request used by queue extensions to enumerate live peer sessions. */\nexport interface FabricPeerCardsRequestV1 {\n version: 1;\n context: ExtensionContext;\n claim: () => boolean;\n respond: (result: FabricPeerCardsResultV1) => void;\n}\n\nexport const readFabricPeerCardsRequestV1 = (\n value: unknown,\n): FabricPeerCardsRequestV1 | undefined => {\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n const record = value as Record<string, unknown>;\n if (\n record.version !== 1 ||\n typeof record.context !== \"object\" ||\n record.context === null ||\n typeof record.claim !== \"function\" ||\n typeof record.respond !== \"function\"\n ) {\n return undefined;\n }\n return value as FabricPeerCardsRequestV1;\n};\n\nexport interface FabricPeerSettleProgressV1 {\n waiting: Array<{ label: string; status: \"idle\" | \"running\" }>;\n}\n\nexport type FabricPeerAwaitSettleResultV1 =\n | { ok: true }\n | { ok: false; error: string };\n\n/**\n * Host-local request used by queue extensions to hold dispatch until peer\n * sessions settle. A peer counts as settled once it has been quiet\n * (status-wide) for settledForMs; peers that vanish from the mesh count as\n * settled since they can no longer conflict. Selector matches a peer label\n * (case-insensitive) or exact participant id; omitted waits on all peers.\n */\nexport interface FabricPeerAwaitSettleRequestV1 {\n version: 1;\n context: ExtensionContext;\n selector?: string;\n settledForMs?: number;\n signal?: AbortSignal;\n update?: (progress: FabricPeerSettleProgressV1) => void;\n claim: () => boolean;\n respond: (result: FabricPeerAwaitSettleResultV1) => void;\n}\n\nexport const readFabricPeerAwaitSettleRequestV1 = (\n value: unknown,\n): FabricPeerAwaitSettleRequestV1 | undefined => {\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n const record = value as Record<string, unknown>;\n const signal = record.signal as AbortSignal | undefined;\n if (\n record.version !== 1 ||\n typeof record.context !== \"object\" ||\n record.context === null ||\n typeof record.claim !== \"function\" ||\n typeof record.respond !== \"function\" ||\n (record.selector !== undefined && typeof record.selector !== \"string\") ||\n (record.settledForMs !== undefined && typeof record.settledForMs !== \"number\") ||\n (signal !== undefined && typeof signal.aborted !== \"boolean\") ||\n (record.update !== undefined && typeof record.update !== \"function\")\n ) {\n return undefined;\n }\n return value as FabricPeerAwaitSettleRequestV1;\n};\n\n/** Identifies host-side tool lifecycle events replayed for a nested Fabric call. */\nexport const FABRIC_NESTED_TOOL_CALL_ID_PREFIX = \"fabric_\";\n\n/** Discriminant for the transient details envelope on a proxied provider result. */\nexport const FABRIC_TOOL_RESULT_PROXY_KIND = \"pi-fabric.tool-result-proxy.v1\";\n\n/**\n * Host-only middleware details for non-Pi Fabric providers. `result` is the\n * exact value before maxNestedResultChars is enforced and is not persisted as\n * a separate Pi tool-result message.\n */\nexport interface FabricToolResultProxyDetailsV1 {\n kind: typeof FABRIC_TOOL_RESULT_PROXY_KIND;\n ref: string;\n result: unknown;\n}\n\nexport const readFabricToolResultProxyDetailsV1 = (\n value: unknown,\n): FabricToolResultProxyDetailsV1 | undefined => {\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) return undefined;\n const record = value as Record<string, unknown>;\n if (\n record.kind !== FABRIC_TOOL_RESULT_PROXY_KIND ||\n typeof record.ref !== \"string\" ||\n !Object.prototype.hasOwnProperty.call(record, \"result\")\n ) {\n return undefined;\n }\n return record as unknown as FabricToolResultProxyDetailsV1;\n};\n\nexport type FabricRisk = \"read\" | \"write\" | \"execute\" | \"network\" | \"agent\";\nexport type FabricEffectKind = \"none\" | \"scoped\" | \"transactional\" | \"emission\";\nexport type FabricEffectOrdering = \"commutative\" | \"ordered\" | \"unknown\";\n\nexport interface FabricActionEffect {\n kind: FabricEffectKind;\n resources?: string[];\n ordering?: FabricEffectOrdering;\n}\n\n/** MCP tool annotations (Model Context Protocol ToolAnnotations), cached when a runtime surfaces them. */\nexport interface FabricToolAnnotations {\n readOnlyHint?: boolean;\n idempotentHint?: boolean;\n destructiveHint?: boolean;\n openWorldHint?: boolean;\n}\nexport type FabricActivityEntityKind =\n | \"agent\"\n | \"actor\"\n | \"tool\"\n | \"extension\"\n | \"mcp\"\n | \"mesh\"\n | \"task\"\n | \"custom\";\n\nexport type FabricInvocationActivityUpdate =\n | { type: \"progress\"; message: string }\n | { type: \"entity\"; id: string; kind: FabricActivityEntityKind; name?: string }\n | { type: \"metrics\"; tokens?: number; toolCalls?: number; cost?: number };\n\nexport interface FabricMediaBlock {\n type: \"image\";\n data: string;\n mimeType: string;\n}\n\nexport interface FabricActionDescriptor {\n name: string;\n description: string;\n inputSchema: Record<string, unknown>;\n outputSchema?: Record<string, unknown>;\n risk: FabricRisk;\n namespace?: string;\n effect?: FabricActionEffect;\n annotations?: FabricToolAnnotations;\n}\n\nexport interface FabricCapabilityActionHead {\n key: string;\n parentKey: string;\n ref: string;\n name: string;\n description: string;\n descriptorHash: string;\n risk: FabricRisk;\n namespace?: string;\n effect?: FabricActionEffect;\n}\n\nexport interface FabricCapabilityProviderHead {\n key: string;\n parentKey: string;\n name: string;\n description: string;\n descriptorHash: string;\n actions: FabricCapabilityActionHead[];\n}\n\nexport interface FabricCapabilityBindingView {\n ref: string;\n provider: string;\n providerBindingId: string;\n generation: number;\n descriptorHash: string;\n}\n\n/** Immutable issuer-owned authority, not a serializable bearer grant.\n * Another registry must resolve a fresh view; copies and released views are invalid. */\nexport interface FabricCommittedCapabilityView {\n id: string;\n /** Runtime-local digest including provider binding generations. */\n digest: string;\n /** Portable digest of exact refs and descriptor semantics across runtimes. */\n semanticDigest: string;\n bindings: Record<string, FabricCapabilityBindingView>;\n}\n\nexport interface FabricCapabilityResolution {\n satisfied: boolean;\n missing: string[];\n optionalMissing: string[];\n view?: FabricCommittedCapabilityView;\n}\n\nexport interface 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}\n\nexport interface FabricProviderListRequest {\n namespace?: string;\n query?: string;\n limit?: number;\n}\n\n/** One named action whose arguments should be typed in guest declarations. */\nexport interface FabricNamedActionTypeSource {\n name: string;\n inputSchema: Record<string, unknown>;\n}\n\n/** One MCP server plus the tools to type for `mcp.<server>.*` guest calls. */\nexport interface FabricMcpServerTypeSource {\n server: string;\n tools: FabricNamedActionTypeSource[];\n}\n\nexport type {\n FabricKernel,\n FabricKernelRuntime,\n FabricHostCall,\n FabricSandboxOptions,\n FabricSandboxResult,\n FabricSandboxTerminationReason,\n} from \"./runtime/kernel.js\";\nexport type { FabricPythonRuntime } from \"./config.js\";\n\n/**\n * Live descriptor snapshot the registry hands to the guest declaration\n * builder so dynamic surfaces (mcp, extensions) get argument checking before\n * the sandbox runs. Empty/absent sections keep the loose static declarations.\n */\nexport interface FabricGuestTypeSources {\n mcpServers?: FabricMcpServerTypeSource[];\n extensionTools?: FabricNamedActionTypeSource[];\n}\n\n/**\n * Pre-rendered `declare const` blocks replacing the loose mcp/extensions\n * declaration lines. Values are full replacement text (helpers + declare).\n */\nexport interface FabricDynamicGuestDeclarations {\n mcp?: string;\n extensions?: string;\n}\n\n/**\n * Provider-owned work (for example a delegated run) registered with Fabric's\n * participant directory under `provider:<provider>:<id>`. Non-detached\n * participants are stopped when their fabric_exec program is cancelled or\n * times out; detached ones survive until stopped, withdrawn, or shut down.\n */\nexport interface FabricParticipantSpec {\n /** Unique per provider while unsettled; `[A-Za-z0-9][A-Za-z0-9._:-]{0,63}`. */\n id: string;\n label: string;\n kind?: string;\n detached?: boolean;\n stop(reason: string): Promise<{ confirmed: boolean }>;\n steer?(message: string): Promise<void>;\n followUp?(message: string): Promise<void>;\n}\n\nexport interface FabricParticipantProgress {\n phase?: string;\n message?: string;\n /** Cumulative totals; each update replaces the previous usage. */\n usage?: { input?: number; output?: number; cacheRead?: number; cacheWrite?: number; cost?: number };\n}\n\nexport interface FabricParticipantSettlement {\n status: \"completed\" | \"failed\" | \"stopped\";\n summary?: string;\n}\n\nexport interface FabricParticipantHandle {\n readonly ref: string;\n update(progress: FabricParticipantProgress): void;\n settle(result: FabricParticipantSettlement): void;\n dispose(): void;\n}\n\nexport interface FabricInvocationParticipants {\n register(spec: FabricParticipantSpec): FabricParticipantHandle;\n}\n\n/** Host-issued principal and grants (`pi-fabric/scope`); trusted host code, not a verified kernel. */\nexport type FabricScopeAction = \"read\" | \"write\" | \"execute\";\nexport interface FabricScopeGrant {\n /** `<ns>:<path>`, `<ns>:<path>/*` (one level), `<ns>:<path>/**` (any depth) or `<ns>:*`. */\n resource: string;\n actions: FabricScopeAction[];\n}\nexport interface FabricScope {\n version: 1;\n principal: { id: string; issuer: \"host\" };\n /** At most 64, merged per resource and sorted. */\n grants: FabricScopeGrant[];\n /** sha256 hex of canonical JSON { grants, parentDigest?, principal }. */\n digest: string;\n parentDigest?: string;\n}\n/**\n * Host-stamped authority of a message's sender (actor mailbox items, mesh\n * events). \"host\" is an unscoped session; \"scope\" carries the sender's scope,\n * with grants when they fit. Absent on records written by older builds.\n */\nexport type FabricMessageSender =\n | { authority: \"host\" }\n | {\n authority: \"scope\";\n principalId: string;\n digest: string;\n grants?: FabricScopeGrant[];\n parentDigest?: string;\n };\n\nexport interface FabricInvocationContext {\n /** Host-selected result projection; never an action argument or an authority grant. */\n nativeToolResult?: boolean;\n cwd: string;\n signal: AbortSignal | undefined;\n parentToolCallId: string;\n nestedToolCallId: string;\n extensionContext: ExtensionContext;\n update(message: string): void;\n activity?(update: FabricInvocationActivityUpdate): void;\n /** Host-supplied inside fabric_exec: register provider-owned work as a participant. */\n participants?: FabricInvocationParticipants;\n /** Host-supplied inside fabric_exec so agents.handoff schedules the outer-call boundary. */\n deferHandoff?(args: Record<string, unknown>): Record<string, unknown>;\n // Out-of-band image content blocks a provider (currently only pi.read of an\n // image file) wants attached to the call audit, so the single-call render can\n // re-attach them to the fabric_exec result content for pi core's kitty image\n // preview. Bypasses the result char bound that would truncate the base64.\n // `note` is the read tool's own text output (e.g. \"Read image file [image/png]\"),\n // captured after any tool_result patch so a handoff that strips pi's\n // non-vision note has run; used as the single-call body + content text so the\n // preview shows the clean note instead of the swapped description.\n attachMedia?(blocks: FabricMediaBlock[], note?: string): void;\n // Providers call this after mutable tool_call middleware has run so live and\n // durable audit surfaces reflect the arguments actually passed to the tool.\n updateArguments?(args: Record<string, unknown>): void;\n // Ephemeral renderer-only metadata. It is exposed to live Fabric previews but\n // never projected into the durable execution trace.\n attachPreview?(preview: unknown): void;\n capabilityView?: FabricCommittedCapabilityView;\n /** Frozen host-issued scope; set by the registry only, absent when unscoped. */\n scope?: Readonly<FabricScope>;\n /** Advisory for ordinary calls; strict components reject concurrent conflicting effects. */\n effectPolicy?: \"advisory\" | \"strict\";\n}\n\nexport interface FabricScopedProviderResult {\n value: unknown;\n dispose(): void | Promise<void>;\n}\n\nexport interface FabricProvider {\n name: string;\n description: string;\n list(\n request: FabricProviderListRequest,\n context: FabricInvocationContext,\n ): Promise<FabricActionDescriptor[]>;\n describe(\n actionName: string,\n context: FabricInvocationContext,\n ): Promise<FabricActionDescriptor | undefined>;\n prepareArguments?(\n actionName: string,\n args: Record<string, unknown>,\n context: FabricInvocationContext,\n ): Record<string, unknown> | Promise<Record<string, unknown>>;\n invoke(\n actionName: string,\n args: Record<string, unknown>,\n context: FabricInvocationContext,\n ): Promise<unknown>;\n acquire?(\n actionName: string,\n args: Record<string, unknown>,\n context: FabricInvocationContext,\n ): Promise<FabricScopedProviderResult>;\n invocationEnded?(parentToolCallId: string): Promise<void>;\n subscribeCatalog?(listener: () => void): () => void;\n close?(): Promise<void>;\n}\n\nexport interface FabricProviderRegistration {\n version: 1;\n provider: FabricProvider;\n overwrite?: boolean;\n}\n\nexport interface FabricProviderDiscovery {\n version: 1;\n register(provider: FabricProvider, options?: { overwrite?: boolean }): void;\n}\n\nexport type {\n ComponentChangeRequest as FabricComponentChangeRequest,\n ComponentChangePlan as FabricComponentChangePlan,\n} from \"./components/control.js\";\n\nexport type {\n FabricCapabilityRequirement,\n FabricComponentChildOptions,\n FabricComponentContext,\n FabricComponentDefinition,\n FabricComponentDiscovery,\n FabricComponentDisposer,\n FabricComponentEffect,\n FabricComponentEffectConflict,\n FabricComponentEffectInfo,\n FabricComponentEffectOptions,\n FabricComponentEffectRegistration,\n FabricComponentEntry,\n FabricComponentGraph,\n FabricComponentGuarantee,\n FabricComponentHandle,\n FabricComponentInfo,\n FabricComponentProviderLease,\n FabricModelGuidance,\n FabricModelGuidanceInfo,\n FabricModelGuidancePlacement,\n FabricModelGuidanceTarget,\n FabricComponentProvision,\n FabricComponentRegistration,\n FabricComponentState,\n FabricComponentStopOptions,\n} from \"./components/types.js\";\n\nexport {\n FABRIC_EXECUTION_GUIDANCE_SLOT,\n MAX_FABRIC_MODEL_GUIDANCE_CONTENT_CHARS,\n MAX_FABRIC_MODEL_GUIDANCE_PER_COMPONENT,\n MAX_FABRIC_MODEL_GUIDANCE_REGISTRATIONS,\n MAX_FABRIC_MODEL_GUIDANCE_SNAPSHOT_CHARS,\n MAX_FABRIC_MODEL_GUIDANCE_TOTAL_CHARS,\n} from \"./components/model-guidance.js\";\n"],
5
5
  "mappings": ";AAGO,IAAM,yBAAyB,OAAO,IAAI,8BAA8B;AAgBxE,IAAM,4BAA4B;AAclC,IAAM,6BAA6B;AA4BnC,IAAM,2BAA2B;AAgBjC,IAAM,iCAAiC;AACvC,IAAM,iCAAiC;AACvC,IAAM,iCAAiC;AAYvC,IAAM,iCAAiC,CAC5C,UAC2C;AAC3C,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,EAAG,QAAO;AAChF,QAAM,SAAS;AACf,QAAM,aAAa,OAAO;AAC1B,MACE,OAAO,OAAO,SAAS,YACvB,OAAO,KAAK,WAAW,KACvB,OAAO,KAAK,SAAS,OACpB,eAAe,UACd,EAAE,OAAO,eAAe,YAAY,OAAO,cAAc,UAAU,KAAK,aAAa,MACrF,EAAE,OAAO,eAAe,YAAY,WAAW,SAAS,KAAK,WAAW,UAAU,MACpF;AACA,WAAO;AAAA,EACT;AACA,SAAO;AAAA,IACL,MAAM,OAAO;AAAA,IACb,GAAI,eAAe,SAAY,EAAE,WAA0C,IAAI,CAAC;AAAA,EAClF;AACF;AAEO,IAAM,8BAA8B;AACpC,IAAM,kCAAkC;AAwBxC,IAAM,mCAAmC,CAC9C,UAC6C;AAC7C,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,EAAG,QAAO;AAChF,QAAM,SAAS;AACf,QAAM,QAAQ,OAAO;AACrB,MACE,OAAO,OAAO,UAAU,cACvB,UAAU,WACT,CAAC,MAAM,QAAQ,KAAK,KACpB,MAAM,SAAS,mCACf,MAAM,KAAK,CAAC,SAAS,OAAO,SAAS,YAAY,KAAK,WAAW,KAAK,KAAK,SAAS,GAAG,IAEzF;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AACO,IAAM,kCAAkC;AACxC,IAAM,kCAAkC;AACxC,IAAM,+BAA+B;AAcrC,IAAM,6BAA6B,CACxC,UACuC;AACvC,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,EAAG,QAAO;AAChF,QAAM,SAAS;AACf,MACE,OAAO,YAAY,KACnB,OAAO,OAAO,YAAY,YAC1B,OAAO,YAAY,QACnB,OAAO,OAAO,UAAU,cACxB,OAAO,OAAO,YAAY,YAC1B;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEO,IAAM,0BAA0B;AAChC,IAAM,iCAAiC;AA2BvC,IAAM,+BAA+B,CAC1C,UACyC;AACzC,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,EAAG,QAAO;AAChF,QAAM,SAAS;AACf,MACE,OAAO,YAAY,KACnB,OAAO,OAAO,YAAY,YAC1B,OAAO,YAAY,QACnB,OAAO,OAAO,UAAU,cACxB,OAAO,OAAO,YAAY,YAC1B;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AA4BO,IAAM,qCAAqC,CAChD,UAC+C;AAC/C,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,EAAG,QAAO;AAChF,QAAM,SAAS;AACf,QAAM,SAAS,OAAO;AACtB,MACE,OAAO,YAAY,KACnB,OAAO,OAAO,YAAY,YAC1B,OAAO,YAAY,QACnB,OAAO,OAAO,UAAU,cACxB,OAAO,OAAO,YAAY,cACzB,OAAO,aAAa,UAAa,OAAO,OAAO,aAAa,YAC5D,OAAO,iBAAiB,UAAa,OAAO,OAAO,iBAAiB,YACpE,WAAW,UAAa,OAAO,OAAO,YAAY,aAClD,OAAO,WAAW,UAAa,OAAO,OAAO,WAAW,YACzD;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAGO,IAAM,oCAAoC;AAG1C,IAAM,gCAAgC;AAatC,IAAM,qCAAqC,CAChD,UAC+C;AAC/C,MAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,EAAG,QAAO;AAChF,QAAM,SAAS;AACf,MACE,OAAO,SAAS,iCAChB,OAAO,OAAO,QAAQ,YACtB,CAAC,OAAO,UAAU,eAAe,KAAK,QAAQ,QAAQ,GACtD;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;",
6
6
  "names": []
7
7
  }
@@ -13,7 +13,7 @@ var FABRIC_RUNNER_CAPABILITY_NAMES = [
13
13
  "sleep",
14
14
  "writePolicy"
15
15
  ];
16
- var BUILT_IN_RUNNER_IDS = /* @__PURE__ */ new Set(["pi", "claude", "veda"]);
16
+ var BUILT_IN_RUNNER_IDS = /* @__PURE__ */ new Set(["pi", "pi-durable", "claude", "veda"]);
17
17
  var RUNNER_ID_PATTERN = /^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$/;
18
18
  var MAX_RUNNER_ID_CHARS = 64;
19
19
  var MAX_LABEL_CHARS = 80;
@@ -33,7 +33,7 @@ var builtIn = (id, label, capabilities) => Object.freeze({
33
33
  launch: fabricWorkerLaunch
34
34
  });
35
35
  for (const adapter of [
36
- builtIn("pi", "Pi", {
36
+ ...["pi", "pi-durable"].map((id) => builtIn(id, id === "pi" ? "Pi" : "Pi Durable", {
37
37
  recursiveFabric: true,
38
38
  steer: true,
39
39
  followUp: true,
@@ -46,7 +46,7 @@ for (const adapter of [
46
46
  questions: true,
47
47
  sleep: false,
48
48
  writePolicy: true
49
- }),
49
+ })),
50
50
  builtIn("claude", "Claude", {
51
51
  recursiveFabric: false,
52
52
  steer: true,
@@ -186,4 +186,4 @@ export {
186
186
  listAgentRunners,
187
187
  requireAgentRunner
188
188
  };
189
- //# sourceMappingURL=chunk-4RTHQGES.js.map
189
+ //# sourceMappingURL=chunk-ST36EYHN.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/agents/runner-registry.ts"],
4
+ "sourcesContent": ["import type { ImageContent } from \"@earendil-works/pi-ai\";\nimport type { FabricScope } from \"../protocol.js\";\nimport type { FabricKernel } from \"../runtime/kernel.js\";\nimport type { FabricThinking } from \"../thinking.js\";\nimport type { FabricAgentLineage, FabricWritePolicy } from \"./child-env.js\";\nimport type { AgentChildQuestionResponse, AgentUsage } from \"./types.js\";\n\nexport type BuiltInFabricAgentRunner = \"pi\" | \"pi-durable\" | \"claude\" | \"veda\";\n\n/**\n * What a runner honors. Fabric refuses a request that needs an undeclared\n * capability before admission, budget, or worktree side effects.\n */\nexport interface FabricRunnerCapabilities {\n /** The child runs Fabric itself (`recursive: true`, fabric_exec in full code mode). */\n recursiveFabric: boolean;\n steer: boolean;\n followUp: boolean;\n /** Long-lived sessions for persistent actors. */\n persistentSessions: boolean;\n /** Explicit `kernel` choices. */\n kernels: boolean;\n /** Session seeds: trajectory handoff and `seed: \"branch\"`. */\n handoff: boolean;\n modelDiscovery: boolean;\n imageInput: boolean;\n compaction: boolean;\n /** Routed child dialogs (`agents.childQuestions: \"route\"`). */\n questions: boolean;\n /** Hosted runs that can park and resume (`sleep`/`wake`). */\n sleep: boolean;\n /** Write confinement (`readOnly`, `writableRoots`, `shell`). */\n writePolicy: boolean;\n}\n\nconst FABRIC_RUNNER_CAPABILITY_NAMES = [\n \"recursiveFabric\",\n \"steer\",\n \"followUp\",\n \"persistentSessions\",\n \"kernels\",\n \"handoff\",\n \"modelDiscovery\",\n \"imageInput\",\n \"compaction\",\n \"questions\",\n \"sleep\",\n \"writePolicy\",\n] as const satisfies readonly (keyof FabricRunnerCapabilities)[];\n\nexport interface FabricRunnerModelInfo {\n runner: string;\n provider: string;\n id: string;\n name: string;\n key: string;\n [key: string]: unknown;\n}\n\nexport interface FabricRunnerModelContext {\n cwd: string;\n refresh: boolean;\n}\n\n/** Launch facts shared by worker and hosted runners. All values are JSON. */\nexport interface FabricRunnerLaunchContext {\n /** Fabric run id. Hosted runners use it as the idempotency key. */\n id: string;\n name: string;\n task: string;\n cwd: string;\n runDirectory: string;\n residency: \"session\" | \"durable\";\n /** Run deadline in epoch milliseconds. */\n deadlineAt: number;\n depth: number;\n lineage: FabricAgentLineage;\n tools: readonly string[];\n model?: string;\n thinking?: FabricThinking;\n kernel?: FabricKernel;\n recursive?: boolean;\n /** Present only for runners declaring `imageInput`. */\n images?: readonly ImageContent[];\n schema?: Record<string, unknown>;\n systemPrompt?: string;\n /** Pi session file seeding the run; present only for runners declaring `handoff`. */\n sessionFile?: string;\n /** Effective confinement; present only for runners declaring `writePolicy`. */\n writePolicy?: FabricWritePolicy;\n actorId?: string;\n actorName?: string;\n /** Host-issued scope narrowed for this run (`pi-fabric/scope`); absent for unscoped sessions. */\n scope?: Readonly<FabricScope>;\n}\n\nexport interface FabricWorkerLaunchContext extends FabricRunnerLaunchContext {\n files: {\n taskFile: string;\n statusFile: string;\n lifecycleFile: string;\n logFile: string;\n steerFile: string;\n schemaFile?: string;\n imagesFile?: string;\n };\n /** Fabric's own Pi/Claude/Veda worker launch, for adapters that wrap it. */\n fabricWorker: { workerPath: string; workerArguments: readonly string[] };\n}\n\nexport interface FabricWorkerLaunch {\n workerPath: string;\n workerArguments: string[];\n}\n\nexport interface FabricHostedRunContext extends FabricRunnerLaunchContext {\n /** Equal to `id`; submitting twice with one key must start at most one run. */\n idempotencyKey: string;\n}\n\nexport type FabricHostedLiveness =\n | \"running\"\n | \"sleeping\"\n | \"settled\"\n | \"cancelled\"\n | \"interrupted\"\n | \"unknown\";\n\nexport type FabricRunStopReason = \"requested\" | \"timeout\" | \"shutdown\";\n\nexport interface FabricHostedProgress {\n turns?: number;\n toolCalls?: number;\n /** null clears the current tool. */\n currentTool?: string | null;\n /** Latest assistant text; Fabric keeps a bounded tail. */\n text?: string;\n}\n\n/** Events appended to the run's transcript log (`events.jsonl`). */\nexport type FabricTranscriptEvent =\n | {\n type: \"message_end\";\n message: {\n role: \"user\" | \"assistant\";\n content: string | Array<{ type: \"text\"; text: string }>;\n };\n }\n | { type: \"tool_execution_start\"; toolCallId?: string; toolName: string; args?: unknown }\n | {\n type: \"tool_execution_end\";\n toolCallId?: string;\n toolName: string;\n result?: unknown;\n isError?: boolean;\n }\n | { type: \"extension_error\"; error: string };\n\nexport interface FabricRunnerQuestion {\n method: \"select\" | \"confirm\" | \"input\" | \"editor\";\n title: string;\n message?: string;\n options?: string[];\n placeholder?: string;\n prefill?: string;\n timeoutMs?: number;\n}\n\nexport type FabricRunnerAnswer = AgentChildQuestionResponse;\n\nexport interface FabricHostedReporter {\n progress(update: FabricHostedProgress): void;\n /** Cumulative usage for the whole run; Fabric records the increase. */\n usage(total: AgentUsage): void;\n transcript(event: FabricTranscriptEvent): void;\n /** Routed like a Pi child dialog: direct UI when available, else a decision. */\n question(question: FabricRunnerQuestion): Promise<FabricRunnerAnswer>;\n finish(result: {\n status: \"completed\" | \"failed\" | \"stopped\";\n output: string;\n structured?: unknown;\n }): void;\n /** Fabric never retries; `retryable` is reported to the caller only. */\n fail(failure: { error: string; retryable?: boolean }): void;\n}\n\ninterface FabricRunnerBase {\n readonly id: string;\n readonly label: string;\n readonly capabilities: Readonly<FabricRunnerCapabilities>;\n /**\n * Absolute path of an ES module that registers this adapter when imported.\n * Required for `residency: \"durable\"`: the resident host imports it before\n * launching or re-attaching the run.\n */\n readonly residentModule?: string;\n models?(context: FabricRunnerModelContext): readonly FabricRunnerModelInfo[] | Promise<readonly FabricRunnerModelInfo[]>;\n defaultModel?(): string | undefined;\n normalizeModel?(model: string): string | Promise<string>;\n mapTools?(tools: readonly string[]): readonly string[] | Promise<readonly string[]>;\n}\n\n/** Fabric spawns `workerPath` under the selected transport; see \"Worker protocol\". */\nexport interface FabricWorkerRunner extends FabricRunnerBase {\n readonly kind: \"worker\";\n launch(context: FabricWorkerLaunchContext): FabricWorkerLaunch | Promise<FabricWorkerLaunch>;\n /** Called before the transport kills the process. */\n stop?(run: { id: string; runDirectory: string }): void | Promise<void>;\n}\n\n/** The adapter owns execution (for example a daemon); Fabric spawns no process. */\nexport interface FabricHostedRunner extends FabricRunnerBase {\n readonly kind: \"hosted\";\n /** Pure: returns a JSON locator (at most 8 KiB) that Fabric persists before `start`. */\n prepare(context: FabricHostedRunContext): unknown;\n start(locator: unknown, context: FabricHostedRunContext, reporter: FabricHostedReporter): void | Promise<void>;\n attach(locator: unknown, context: FabricHostedRunContext, reporter: FabricHostedReporter): void | Promise<void>;\n liveness(locator: unknown): FabricHostedLiveness | Promise<FabricHostedLiveness>;\n stop(locator: unknown, reason: FabricRunStopReason): { confirmed: boolean } | Promise<{ confirmed: boolean }>;\n abort?(locator: unknown, reason: FabricRunStopReason): void | Promise<void>;\n sleep?(locator: unknown): void | Promise<void>;\n wake?(locator: unknown): void | Promise<void>;\n steer?(locator: unknown, message: string, data?: unknown): void | Promise<void>;\n followUp?(locator: unknown, message: string, data?: unknown): void | Promise<void>;\n}\n\nexport type FabricRunnerAdapter = FabricWorkerRunner | FabricHostedRunner;\n\n/** Canonical built-in runner ids; src/config.ts inlines the same set. */\nexport const BUILT_IN_RUNNER_IDS: ReadonlySet<string> = new Set([\"pi\", \"pi-durable\", \"claude\", \"veda\"]);\n/** Canonical runner id syntax; eager modules inline an identical copy. */\nexport const RUNNER_ID_PATTERN = /^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$/;\nconst MAX_RUNNER_ID_CHARS = 64;\nconst MAX_LABEL_CHARS = 80;\n\nexport const isFabricRunnerId = (value: unknown): value is string =>\n typeof value === \"string\" && value.length <= MAX_RUNNER_ID_CHARS && RUNNER_ID_PATTERN.test(value);\n\n// A globalThis singleton: a second copy of this module (another installed\n// pi-fabric, or a runner extension's own dependency) shares registrations.\nconst REGISTRY_SYMBOL = Symbol.for(\"pi-fabric.runnerRegistry.v1\");\nconst registryHost = globalThis as unknown as Record<symbol, Map<string, FabricRunnerAdapter> | undefined>;\nconst adapters: Map<string, FabricRunnerAdapter> =\n registryHost[REGISTRY_SYMBOL] ?? (registryHost[REGISTRY_SYMBOL] = new Map());\n\nconst fabricWorkerLaunch = (context: FabricWorkerLaunchContext): FabricWorkerLaunch => ({\n workerPath: context.fabricWorker.workerPath,\n workerArguments: [...context.fabricWorker.workerArguments],\n});\n\nconst builtIn = (\n id: BuiltInFabricAgentRunner,\n label: string,\n capabilities: FabricRunnerCapabilities,\n): FabricWorkerRunner => Object.freeze({\n kind: \"worker\" as const,\n id,\n label,\n capabilities: Object.freeze(capabilities),\n launch: fabricWorkerLaunch,\n});\n\n// Built-ins keep their model and tool handling in the manager; this table\n// carries only the capability facts checked uniformly for every runner.\nfor (const adapter of [\n ...([\"pi\", \"pi-durable\"] as const).map((id) => builtIn(id, id === \"pi\" ? \"Pi\" : \"Pi Durable\", {\n recursiveFabric: true,\n steer: true,\n followUp: true,\n persistentSessions: true,\n kernels: true,\n handoff: true,\n modelDiscovery: true,\n imageInput: true,\n compaction: true,\n questions: true,\n sleep: false,\n writePolicy: true,\n })),\n builtIn(\"claude\", \"Claude\", {\n recursiveFabric: false,\n steer: true,\n followUp: true,\n persistentSessions: true,\n kernels: false,\n handoff: false,\n modelDiscovery: true,\n imageInput: true,\n compaction: false,\n questions: false,\n sleep: false,\n writePolicy: false,\n }),\n builtIn(\"veda\", \"Veda\", {\n recursiveFabric: false,\n steer: false,\n followUp: false,\n persistentSessions: false,\n kernels: false,\n handoff: false,\n modelDiscovery: false,\n // Veda has always accepted (and dropped) image blocks; refusing them now\n // would change built-in behavior.\n imageInput: true,\n compaction: false,\n questions: false,\n sleep: false,\n writePolicy: false,\n }),\n]) {\n if (!adapters.has(adapter.id)) adapters.set(adapter.id, adapter);\n}\n\nconst requireFunction = (adapter: Record<string, unknown>, id: string, name: string): void => {\n if (typeof adapter[name] !== \"function\") {\n throw new Error(`Fabric runner ${id} must implement ${name}()`);\n }\n};\n\nconst optionalFunction = (adapter: Record<string, unknown>, id: string, name: string): void => {\n if (adapter[name] !== undefined && typeof adapter[name] !== \"function\") {\n throw new Error(`Fabric runner ${id}: ${name} must be a function`);\n }\n};\n\n// Hosted runs have no Fabric child process, so these cannot be honored.\nconst HOSTED_UNSUPPORTED: readonly (keyof FabricRunnerCapabilities)[] = [\n \"recursiveFabric\",\n \"kernels\",\n \"compaction\",\n \"persistentSessions\",\n];\n\nconst validateAdapter = (value: unknown): FabricRunnerAdapter => {\n if (!value || typeof value !== \"object\") throw new Error(\"Fabric runner adapter must be an object\");\n const adapter = value as Record<string, unknown>;\n const id = adapter.id;\n if (!isFabricRunnerId(id)) throw new Error(`Invalid Fabric runner id: ${JSON.stringify(id)}`);\n if (BUILT_IN_RUNNER_IDS.has(id)) throw new Error(`Cannot replace built-in Fabric runner: ${id}`);\n if (typeof adapter.label !== \"string\" || !adapter.label.trim() || adapter.label.length > MAX_LABEL_CHARS) {\n throw new Error(`Fabric runner ${id} needs a label of 1-${MAX_LABEL_CHARS} characters`);\n }\n if (adapter.kind !== \"worker\" && adapter.kind !== \"hosted\") {\n throw new Error(`Fabric runner ${id} must declare kind \"worker\" or \"hosted\"`);\n }\n const capabilities = adapter.capabilities as Record<string, unknown> | undefined;\n const missing = FABRIC_RUNNER_CAPABILITY_NAMES.filter(\n (name) => typeof capabilities?.[name] !== \"boolean\",\n );\n if (missing.length > 0) {\n throw new Error(`Fabric runner ${id} must declare boolean capabilities: ${missing.join(\", \")}`);\n }\n const caps = capabilities as unknown as FabricRunnerCapabilities;\n if (adapter.residentModule !== undefined) {\n if (\n typeof adapter.residentModule !== \"string\" ||\n !/^(?:\\/|[A-Za-z]:[\\\\/]|file:)/.test(adapter.residentModule) ||\n adapter.residentModule.length > 4_096\n ) {\n throw new Error(`Fabric runner ${id}: residentModule must be an absolute path or file: URL`);\n }\n }\n for (const name of [\"models\", \"defaultModel\", \"normalizeModel\", \"mapTools\"]) {\n optionalFunction(adapter, id, name);\n }\n if (caps.modelDiscovery) requireFunction(adapter, id, \"models\");\n if (adapter.kind === \"worker\") {\n requireFunction(adapter, id, \"launch\");\n optionalFunction(adapter, id, \"stop\");\n if (caps.sleep) throw new Error(`Fabric runner ${id}: sleep is available to hosted runners only`);\n } else {\n for (const name of [\"prepare\", \"start\", \"attach\", \"liveness\", \"stop\"]) requireFunction(adapter, id, name);\n for (const name of [\"abort\", \"sleep\", \"wake\", \"steer\", \"followUp\"]) optionalFunction(adapter, id, name);\n const unsupported = HOSTED_UNSUPPORTED.filter((name) => caps[name]);\n if (unsupported.length > 0) {\n throw new Error(`Fabric runner ${id}: hosted runners cannot declare ${unsupported.join(\", \")}`);\n }\n if (caps.steer) requireFunction(adapter, id, \"steer\");\n if (caps.followUp) requireFunction(adapter, id, \"followUp\");\n if (caps.sleep) {\n requireFunction(adapter, id, \"sleep\");\n requireFunction(adapter, id, \"wake\");\n }\n }\n return value as FabricRunnerAdapter;\n};\n\nconst bound = <T>(adapter: Record<string, unknown>, name: string): T | undefined =>\n typeof adapter[name] === \"function\"\n ? ((adapter[name] as (...args: unknown[]) => unknown).bind(adapter) as T)\n : undefined;\n\n/**\n * Register a runner for this process. Registration is process-local: a durable\n * run needs the adapter registered in the resident host too (`residentModule`).\n * Returns an unregister function.\n */\nexport const registerAgentRunner = (adapter: FabricRunnerAdapter): (() => void) => {\n const checked = validateAdapter(adapter);\n if (adapters.has(checked.id)) throw new Error(`Fabric runner already registered: ${checked.id}`);\n const source = checked as unknown as Record<string, unknown>;\n const methods = checked.kind === \"worker\"\n ? [\"launch\", \"stop\"]\n : [\"prepare\", \"start\", \"attach\", \"liveness\", \"stop\", \"abort\", \"sleep\", \"wake\", \"steer\", \"followUp\"];\n const registered = Object.freeze(Object.fromEntries([\n [\"kind\", checked.kind],\n [\"id\", checked.id],\n [\"label\", checked.label],\n [\"capabilities\", Object.freeze(Object.fromEntries(\n FABRIC_RUNNER_CAPABILITY_NAMES.map((name) => [name, checked.capabilities[name]]),\n ))],\n ...(checked.residentModule ? [[\"residentModule\", checked.residentModule]] : []),\n ...[\"models\", \"defaultModel\", \"normalizeModel\", \"mapTools\", ...methods]\n .map((name) => [name, bound(source, name)])\n .filter(([, method]) => method !== undefined),\n ])) as unknown as FabricRunnerAdapter;\n adapters.set(checked.id, registered);\n return () => {\n if (adapters.get(checked.id) === registered) adapters.delete(checked.id);\n };\n};\n\nexport const getAgentRunner = (id: string): FabricRunnerAdapter | undefined => adapters.get(id);\n\nexport const listAgentRunners = (): readonly FabricRunnerAdapter[] => [...adapters.values()];\n\nexport const requireAgentRunner = (id: unknown): FabricRunnerAdapter => {\n const adapter = typeof id === \"string\" ? adapters.get(id) : undefined;\n if (!adapter) {\n throw new Error(\n `Unsupported Fabric agent runner: ${JSON.stringify(id)}. Register it with registerAgentRunner() from pi-fabric/runners before use.`,\n );\n }\n return adapter;\n};\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -3,7 +3,7 @@ import {
3
3
  } from "./chunk-LMAVZN7J.js";
4
4
  import {
5
5
  FABRIC_NESTED_TOOL_CALL_ID_PREFIX
6
- } from "./chunk-YRDCJZZW.js";
6
+ } from "./chunk-RUO6L7RM.js";
7
7
  import {
8
8
  MAX_AUDIT_VALUE_CHARS,
9
9
  boundedPreviewValue,
@@ -1213,13 +1213,18 @@ var ActionRegistry = class {
1213
1213
  #speculationEligibility;
1214
1214
  /**
1215
1215
  * Attach the speculative-PTC runtime. Eligibility is re-checked against the
1216
- * resolved descriptor inside speculate(), so a config/captured-tool change
1216
+ * resolved descriptor at launch and replay, so a config/captured-tool change
1217
1217
  * cannot sneak a side-effecting ref into the store after the fact.
1218
1218
  */
1219
1219
  setSpeculation(runtime, eligibility) {
1220
1220
  this.#speculation = runtime;
1221
1221
  this.#speculationEligibility = eligibility;
1222
1222
  }
1223
+ #allowsSpeculation(action) {
1224
+ const localRead = action.risk === "read" && action.effect?.kind === "none";
1225
+ const mcpRead = action.provider === "mcp" && action.risk === "network" && action.annotations?.destructiveHint !== true && action.annotations?.readOnlyHint !== false;
1226
+ return (localRead || mcpRead) && this.#speculationEligibility?.(structuredClone(action)) === true;
1227
+ }
1223
1228
  register(provider, options = {}) {
1224
1229
  this.mount(provider, options);
1225
1230
  }
@@ -1754,8 +1759,8 @@ var ActionRegistry = class {
1754
1759
  let providerValue;
1755
1760
  let providerInvoked = false;
1756
1761
  try {
1757
- if (this.#speculation && action.risk === "read" && effect.kind === "none") {
1758
- const served = await runAbortable(context.signal, () => this.#speculation.tryServe(context.parentToolCallId, ref, snapshotArguments(catalog.args), JSON.stringify([binding.id, authority.descriptor, context.capabilityView?.id ?? null, context.scope?.digest ?? null])));
1762
+ if (this.#speculation && this.#allowsSpeculation(action)) {
1763
+ const served = await runAbortable(context.signal, () => this.#speculation.tryServe(context.parentToolCallId, ref, snapshotArguments(catalog.args), JSON.stringify([binding.id, authority.descriptor, context.capabilityView?.id ?? null, context.scope?.digest ?? null, context.nativeToolResult === true])));
1759
1764
  if (served.hit) {
1760
1765
  providerValue = await runAbortable(context.signal, () => this.#runPlanned(binding, providerActionName, authority, "replay", catalog.args, context, served.value));
1761
1766
  servedFromSpeculation = true;
@@ -1925,7 +1930,7 @@ var ActionRegistry = class {
1925
1930
  return void 0;
1926
1931
  }
1927
1932
  const authority = { ref: action.ref, descriptor: actionDescriptorHash(action) };
1928
- if (action.risk !== "read" || action.effect?.kind !== "none" || !this.#speculationEligibility(structuredClone(action))) return void 0;
1933
+ if (!this.#allowsSpeculation(action)) return void 0;
1929
1934
  const effectiveSchema = effectiveInputSchema(
1930
1935
  action.ref,
1931
1936
  action.inputSchema
@@ -1964,7 +1969,7 @@ var ActionRegistry = class {
1964
1969
  get preparedArgs() {
1965
1970
  return snapshotArguments(repairedArgs);
1966
1971
  },
1967
- bindingToken: JSON.stringify([binding.id, authority.descriptor, context.capabilityView?.id ?? null, context.scope?.digest ?? null]),
1972
+ bindingToken: JSON.stringify([binding.id, authority.descriptor, context.capabilityView?.id ?? null, context.scope?.digest ?? null, context.nativeToolResult === true]),
1968
1973
  execute: async (signal) => {
1969
1974
  const combined = AbortSignal.any([context.signal, ...signal ? [signal] : []]);
1970
1975
  const actual = execute(combined);
@@ -2279,4 +2284,4 @@ export {
2279
2284
  scoreActionSearch,
2280
2285
  ActionRegistry
2281
2286
  };
2282
- //# sourceMappingURL=chunk-R5F6CHW2.js.map
2287
+ //# sourceMappingURL=chunk-UXEMIWYI.js.map