@e4779/pi-fabric 0.105.0-fork.22 → 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-EXWS4ZS3.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 +604 -284
  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-EXWS4ZS3.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
  import {
2
2
  PI_CORE_COMPATIBILITY_ARGUMENT_TYPE_NAMES,
3
3
  PI_CORE_NUMERIC_FIELDS
4
- } from "./chunk-TFFZVLR2.js";
4
+ } from "./chunk-PF27MQY5.js";
5
5
  import {
6
6
  PI_CORE_TOOL_NAMES
7
7
  } from "./chunk-YU62DDKK.js";
@@ -284,4 +284,4 @@ var buildCoreOverrideGuestDeclarations = (sources) => {
284
284
  export {
285
285
  buildCoreOverrideGuestDeclarations
286
286
  };
287
- //# sourceMappingURL=chunk-W7X4XEQU.js.map
287
+ //# sourceMappingURL=chunk-GC2AUXG6.js.map
@@ -0,0 +1,30 @@
1
+ // src/core/native-tool-names.ts
2
+ var NATIVE_CORE_TOOLS = /* @__PURE__ */ new Set(["read", "bash", "powershell", "edit", "write", "grep", "find", "ls"]);
3
+ var FABRIC_TOOLS_MEMBERS = /* @__PURE__ */ new Set(["providers", "catalog", "list", "search", "describe", "call", "progress", "models"]);
4
+ var nativeToolIdentifier = (name) => {
5
+ const identifier = name.replace(/[^a-zA-Z0-9_$]/g, "_");
6
+ return /^[a-zA-Z_$]/.test(identifier) ? identifier : `_${identifier}`;
7
+ };
8
+ function nativeToolRef(tool, identify) {
9
+ if (NATIVE_CORE_TOOLS.has(tool.name)) return `pi.${tool.name}`;
10
+ const identity = identify(tool);
11
+ return identity ? `mcp.${identity.server}.${identity.tool}` : `extensions.${tool.name}`;
12
+ }
13
+ function speculativeNativeRef(name, definitions = [], identify) {
14
+ const refs = /* @__PURE__ */ new Set();
15
+ if (NATIVE_CORE_TOOLS.has(name)) refs.add(`pi.${name}`);
16
+ for (const tool of definitions) {
17
+ if (tool.exposure === "hidden" || tool.exposure === "model-only" || tool.name === "codemode") continue;
18
+ if (!identify) return void 0;
19
+ if (nativeToolIdentifier(tool.name) === name) refs.add(nativeToolRef(tool, identify));
20
+ }
21
+ return refs.size === 1 ? [...refs][0] : void 0;
22
+ }
23
+
24
+ export {
25
+ FABRIC_TOOLS_MEMBERS,
26
+ nativeToolIdentifier,
27
+ nativeToolRef,
28
+ speculativeNativeRef
29
+ };
30
+ //# sourceMappingURL=chunk-K6QXUGS5.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/core/native-tool-names.ts"],
4
+ "sourcesContent": ["import type { ToolDefinition } from \"@earendil-works/pi-coding-agent\";\nimport type { nativeMcpIdentity } from \"./native-mcp-identity.js\";\n\nexport const NATIVE_CORE_TOOLS = new Set([\"read\", \"bash\", \"powershell\", \"edit\", \"write\", \"grep\", \"find\", \"ls\"]);\nexport const FABRIC_TOOLS_MEMBERS = new Set([\"providers\", \"catalog\", \"list\", \"search\", \"describe\", \"call\", \"progress\", \"models\"]);\nexport const nativeToolIdentifier = (name: string): string => {\n const identifier = name.replace(/[^a-zA-Z0-9_$]/g, \"_\");\n return /^[a-zA-Z_$]/.test(identifier) ? identifier : `_${identifier}`;\n};\nexport function nativeToolRef(tool: Pick<ToolDefinition, \"name\" | \"label\" | \"namespace\">, identify: typeof nativeMcpIdentity): string {\n if (NATIVE_CORE_TOOLS.has(tool.name)) return `pi.${tool.name}`;\n const identity = identify(tool);\n return identity ? `mcp.${identity.server}.${identity.tool}` : `extensions.${tool.name}`;\n}\n/** Metadata-only resolution for streaming speculation; ambiguity always skips warming. */\nexport function speculativeNativeRef(name: string, definitions: readonly ToolDefinition[] = [], identify?: typeof nativeMcpIdentity): string | undefined {\n const refs = new Set<string>();\n if (NATIVE_CORE_TOOLS.has(name)) refs.add(`pi.${name}`);\n for (const tool of definitions) {\n if (tool.exposure === \"hidden\" || tool.exposure === \"model-only\" || tool.name === \"codemode\") continue;\n if (!identify) return undefined;\n if (nativeToolIdentifier(tool.name) === name) refs.add(nativeToolRef(tool, identify));\n }\n return refs.size === 1 ? [...refs][0] : undefined;\n}\n"],
5
+ "mappings": ";AAGO,IAAM,oBAAoB,oBAAI,IAAI,CAAC,QAAQ,QAAQ,cAAc,QAAQ,SAAS,QAAQ,QAAQ,IAAI,CAAC;AACvG,IAAM,uBAAuB,oBAAI,IAAI,CAAC,aAAa,WAAW,QAAQ,UAAU,YAAY,QAAQ,YAAY,QAAQ,CAAC;AACzH,IAAM,uBAAuB,CAAC,SAAyB;AAC5D,QAAM,aAAa,KAAK,QAAQ,mBAAmB,GAAG;AACtD,SAAO,cAAc,KAAK,UAAU,IAAI,aAAa,IAAI,UAAU;AACrE;AACO,SAAS,cAAc,MAA4D,UAA4C;AACpI,MAAI,kBAAkB,IAAI,KAAK,IAAI,EAAG,QAAO,MAAM,KAAK,IAAI;AAC5D,QAAM,WAAW,SAAS,IAAI;AAC9B,SAAO,WAAW,OAAO,SAAS,MAAM,IAAI,SAAS,IAAI,KAAK,cAAc,KAAK,IAAI;AACvF;AAEO,SAAS,qBAAqB,MAAc,cAAyC,CAAC,GAAG,UAAyD;AACvJ,QAAM,OAAO,oBAAI,IAAY;AAC7B,MAAI,kBAAkB,IAAI,IAAI,EAAG,MAAK,IAAI,MAAM,IAAI,EAAE;AACtD,aAAW,QAAQ,aAAa;AAC9B,QAAI,KAAK,aAAa,YAAY,KAAK,aAAa,gBAAgB,KAAK,SAAS,WAAY;AAC9F,QAAI,CAAC,SAAU,QAAO;AACtB,QAAI,qBAAqB,KAAK,IAAI,MAAM,KAAM,MAAK,IAAI,cAAc,MAAM,QAAQ,CAAC;AAAA,EACtF;AACA,SAAO,KAAK,SAAS,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI;AAC1C;",
6
+ "names": []
7
+ }
@@ -5,7 +5,7 @@ import {
5
5
  import {
6
6
  checkObserve,
7
7
  jevObserveSchema
8
- } from "./chunk-WLLXKS6I.js";
8
+ } from "./chunk-DU6ZA44F.js";
9
9
  import {
10
10
  checkSchema,
11
11
  checkValue,
@@ -512,4 +512,4 @@ export {
512
512
  JEV_ACTION_DESCRIPTORS,
513
513
  JevProvider
514
514
  };
515
- //# sourceMappingURL=chunk-VPRJOD4Y.js.map
515
+ //# sourceMappingURL=chunk-LEDY5G2V.js.map
@@ -1,6 +1,6 @@
1
1
  import {
2
2
  writeJsonAtomic
3
- } from "./chunk-VON4TSO3.js";
3
+ } from "./chunk-CZPQTISQ.js";
4
4
  import {
5
5
  stableJsonHash
6
6
  } from "./chunk-3YZUQESG.js";
@@ -131,4 +131,4 @@ export {
131
131
  FabricComponentConfiguration,
132
132
  watchComponentConfiguration
133
133
  };
134
- //# sourceMappingURL=chunk-OVBKQCYL.js.map
134
+ //# sourceMappingURL=chunk-N2VKKA7O.js.map
@@ -178,7 +178,8 @@ var typeCheckFabricCode = (code, declarations, includeTypeCorrectness = false) =
178
178
 
179
179
  export {
180
180
  normalizeTypeScriptPath,
181
+ wrapFabricGuestCode,
181
182
  transpileFabricCodeWithSourceMap,
182
183
  typeCheckFabricCode
183
184
  };
184
- //# sourceMappingURL=chunk-N5GUXC6F.js.map
185
+ //# sourceMappingURL=chunk-P4KH4S4S.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/runtime/type-checker.ts"],
4
+ "sourcesContent": ["import path from \"node:path\";\nimport ts from \"typescript\";\n\nexport interface FabricTypeError {\n line: number;\n column: number;\n message: string;\n}\n\nexport interface FabricTypeCheckResult {\n errors: FabricTypeError[];\n javascript?: string;\n sourceMap?: string;\n}\n\nconst compilerOptions: ts.CompilerOptions = {\n target: ts.ScriptTarget.ES2022,\n module: ts.ModuleKind.ESNext,\n moduleResolution: ts.ModuleResolutionKind.NodeNext,\n strict: false,\n noImplicitAny: false,\n strictNullChecks: false,\n strictFunctionTypes: false,\n strictBindCallApply: false,\n alwaysStrict: false,\n strictPropertyInitialization: false,\n noImplicitThis: false,\n useUnknownInCatchVariables: false,\n noEmit: false,\n sourceMap: true,\n skipLibCheck: true,\n lib: [\"lib.es2022.d.ts\"],\n};\n\nconst TYPE_CORRECTNESS_CODES = new Set<number>([\n 2339, 2551,\n 2322, 2345, 2367,\n 2531, 2532, 18047, 18048,\n 7006, 7008, 7019, 7031, 7032, 7033, 7034,\n]);\n\nlet nextCheckerId = 0;\n\nexport const normalizeTypeScriptPath = (fileName: string): string =>\n fileName.replaceAll(\"\\\\\", \"/\");\n\n/** Guest programs execute inside this wrapper; user code starts on wrapped line 2. */\nexport const wrapFabricGuestCode = (code: string): string =>\n `async function __piFabricMain() {\\n${code}\\n}\\n`;\n\nclass FabricTypeChecker {\n readonly #guestFile: string;\n readonly #declarationFile: string;\n readonly #baseHost = ts.createCompilerHost(compilerOptions, true);\n readonly #stableFiles = new Map<string, ts.SourceFile>();\n readonly #declarationSource: ts.SourceFile;\n readonly #host: ts.CompilerHost;\n #sourceText = \"\";\n #sourceFile: ts.SourceFile;\n #program: ts.Program | undefined;\n\n constructor(readonly declarations: string) {\n const id = ++nextCheckerId;\n this.#guestFile = normalizeTypeScriptPath(path.resolve(`/__pi_fabric_guest_${id}.ts`));\n this.#declarationFile = normalizeTypeScriptPath(\n path.resolve(`/__pi_fabric_globals_${id}.d.ts`),\n );\n this.#sourceFile = ts.createSourceFile(\n this.#guestFile,\n \"\",\n ts.ScriptTarget.ES2022,\n true,\n );\n this.#declarationSource = ts.createSourceFile(\n this.#declarationFile,\n declarations,\n ts.ScriptTarget.ES2022,\n true,\n );\n const isGuestFile = (fileName: string): boolean =>\n this.#baseHost.getCanonicalFileName(normalizeTypeScriptPath(fileName)) ===\n this.#baseHost.getCanonicalFileName(this.#guestFile);\n const isDeclarationFile = (fileName: string): boolean =>\n this.#baseHost.getCanonicalFileName(normalizeTypeScriptPath(fileName)) ===\n this.#baseHost.getCanonicalFileName(this.#declarationFile);\n this.#host = {\n ...this.#baseHost,\n fileExists: (fileName) =>\n isGuestFile(fileName) ||\n isDeclarationFile(fileName) ||\n this.#baseHost.fileExists(fileName),\n readFile: (fileName) => {\n if (isGuestFile(fileName)) return this.#sourceText;\n if (isDeclarationFile(fileName)) return this.declarations;\n return this.#baseHost.readFile(fileName);\n },\n getSourceFile: (fileName, languageVersion, onError, shouldCreateNewSourceFile) => {\n if (isGuestFile(fileName)) return this.#sourceFile;\n if (isDeclarationFile(fileName)) return this.#declarationSource;\n const cached = this.#stableFiles.get(fileName);\n if (cached) return cached;\n const source = this.#baseHost.getSourceFile(\n fileName,\n languageVersion,\n onError,\n shouldCreateNewSourceFile,\n );\n if (source) this.#stableFiles.set(fileName, source);\n return source;\n },\n };\n }\n\n check(code: string, includeTypeCorrectness = false): FabricTypeCheckResult {\n this.#sourceText = wrapFabricGuestCode(code);\n this.#sourceFile = ts.createSourceFile(\n this.#guestFile,\n this.#sourceText,\n ts.ScriptTarget.ES2022,\n true,\n );\n const program = ts.createProgram({\n rootNames: [this.#declarationFile, this.#guestFile],\n options: compilerOptions,\n host: this.#host,\n ...(this.#program ? { oldProgram: this.#program } : {}),\n });\n this.#program = program;\n const diagnostics = [\n ...program.getSyntacticDiagnostics(this.#sourceFile),\n ...program\n .getSemanticDiagnostics(this.#sourceFile)\n .filter((diagnostic) => includeTypeCorrectness || !TYPE_CORRECTNESS_CODES.has(diagnostic.code)),\n ];\n const errors = diagnostics.map((diagnostic) => {\n const message = ts.flattenDiagnosticMessageText(diagnostic.messageText, \"\\n\");\n if (!diagnostic.file || diagnostic.start === undefined) {\n return { line: 0, column: 0, message };\n }\n const position = diagnostic.file.getLineAndCharacterOfPosition(diagnostic.start);\n return {\n line: Math.max(1, position.line),\n column: position.character + 1,\n message,\n };\n });\n if (errors.length > 0) return { errors };\n\n let javascript: string | undefined;\n let sourceMap: string | undefined;\n program.emit(this.#sourceFile, (fileName, content) => {\n if (fileName.endsWith(\".js.map\")) sourceMap = content;\n else if (fileName.endsWith(\".js\")) javascript = content;\n });\n return {\n errors,\n ...(javascript ? { javascript } : {}),\n ...(sourceMap ? { sourceMap } : {}),\n };\n }\n}\n\nconst checkerCache = new Map<string, FabricTypeChecker>();\nconst MAX_CHECKERS = 4;\n\nconst checkerFor = (declarations: string): FabricTypeChecker => {\n const cached = checkerCache.get(declarations);\n if (cached) {\n checkerCache.delete(declarations);\n checkerCache.set(declarations, cached);\n return cached;\n }\n const checker = new FabricTypeChecker(declarations);\n checkerCache.set(declarations, checker);\n while (checkerCache.size > MAX_CHECKERS) {\n const oldest = checkerCache.keys().next().value as string | undefined;\n if (oldest === undefined) break;\n checkerCache.delete(oldest);\n }\n return checker;\n};\n\nexport interface FabricTranspileResult {\n code: string;\n sourceMap?: string;\n}\n\nexport const transpileFabricCodeWithSourceMap = (code: string): FabricTranspileResult => {\n const result = ts.transpileModule(wrapFabricGuestCode(code), {\n compilerOptions: {\n target: ts.ScriptTarget.ES2022,\n module: ts.ModuleKind.ESNext,\n sourceMap: true,\n },\n });\n return {\n code: result.outputText,\n ...(result.sourceMapText ? { sourceMap: result.sourceMapText } : {}),\n };\n};\n\nexport const typeCheckFabricCode = (\n code: string,\n declarations: string,\n includeTypeCorrectness = false,\n): FabricTypeCheckResult => checkerFor(declarations).check(code, includeTypeCorrectness);\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }
@@ -1,3 +1,50 @@
1
+ // src/runtime/native-codemode-types.ts
2
+ var NATIVE_CODEMODE_TYPES = `
3
+ type NativeModelType = "chat" | "image" | "classifier";
4
+ interface NativeModelInfo { type?: NativeModelType; provider: string; id: string; name: string; api: string; input: ("text" | "image")[]; contextWindow?: number; [key: string]: unknown }
5
+ type NativeModelSelector = { provider: string; id: string };
6
+ type NativeClassifierQuestion =
7
+ | { type: "choice"; instructions: string; criteria: Record<string, string> }
8
+ | { type: "score"; instructions: string; criteria: string[] }
9
+ | { type: "bool"; instructions: string; criteria: { true: string; false: string } };
10
+ type NativeClassifierAnswer =
11
+ | { type: "choice"; choice: string; probabilities: Record<string, number>; confidence: number }
12
+ | { type: "score"; score: number; confidence: number }
13
+ | { type: "bool"; probability: number };
14
+ interface NativeClassifierContext { state: Record<string, unknown>; questions: Record<string, NativeClassifierQuestion> }
15
+ interface NativeModelUsage { input: number; output: number; totalTokens: number; cost: { total: number } }
16
+ interface NativeClassifierResult { provider: string; model: string; answers: Record<string, NativeClassifierAnswer>; usage?: NativeModelUsage; stopReason: "stop" | "error" | "aborted"; errorMessage?: string }
17
+ type NativeImageBlock = { type: "image"; data: string; mimeType: string };
18
+ type NativeTextBlock = { type: "text"; text: string };
19
+ interface NativeImagesContext { input: (NativeImageBlock | NativeTextBlock)[] }
20
+ interface NativeImagesResult { provider: string; model: string; output: (NativeImageBlock | NativeTextBlock)[]; usage?: NativeModelUsage; stopReason: "stop" | "error" | "aborted"; errorMessage?: string }
21
+ interface FabricNativeModels {
22
+ (): Promise<FabricModelInfo[]>;
23
+ getModelsOfType(type: NativeModelType, provider?: string): Promise<NativeModelInfo[]>;
24
+ getAvailableOfType(type: NativeModelType, provider?: string): Promise<NativeModelInfo[]>;
25
+ getModelOfType(type: NativeModelType, provider: string, id: string): Promise<NativeModelInfo | undefined>;
26
+ classify(model: NativeModelSelector, context: NativeClassifierContext): Promise<NativeClassifierResult>;
27
+ generateImages(model: NativeModelSelector, context: NativeImagesContext): Promise<NativeImagesResult>;
28
+ }
29
+ interface NativeToolInfo { name: string; description: string }
30
+ declare const ALL_TOOLS: readonly NativeToolInfo[];
31
+ declare function searchTools(query: string, options?: { limit?: number; namespace?: string }): Promise<NativeToolInfo[]>;
32
+ declare function describeTool(name: string): Promise<(NativeToolInfo & { declaration: string }) | undefined>;
33
+ declare function describeNamespace(name: string): Promise<{ name: string; description?: string; instructions?: string; tools: NativeToolInfo[] } | undefined>;
34
+ declare const nativeDiscovery: {
35
+ readonly ALL_TOOLS: readonly NativeToolInfo[];
36
+ searchTools(query: string, options?: {limit?: number; namespace?: string}): Promise<NativeToolInfo[]>;
37
+ describeTool(name: string): Promise<string | undefined>;
38
+ describeNamespace(name: string): Promise<{name: string; description?: string; instructions?: string; tools: string[]} | undefined>;
39
+ };
40
+ declare const models: FabricNativeModels;
41
+ declare function store(key: string, value: unknown): void;
42
+ declare function load<T = unknown>(key: string): T | undefined;
43
+ declare function text(value: unknown): void;
44
+ declare function image(value: NativeImageBlock | string | { image_url: string | { url: string } }): void;
45
+ declare function exit(): never;
46
+ `;
47
+
1
48
  // src/jev/guest-types.ts
2
49
  var JEV_GUEST_DECLARATIONS = `
3
50
  type FabricJevJson = null | boolean | number | string | FabricJevJson[] | { [key: string]: FabricJevJson };
@@ -84,10 +131,11 @@ var PI_CORE_NUMERIC_FIELDS = {
84
131
  ls: ["limit"]
85
132
  };
86
133
  var GUEST_TYPE_DECLARATIONS = `
134
+ ${NATIVE_CODEMODE_TYPES}
87
135
  type JsonPrimitive = string | number | boolean | null;
88
136
  type JsonValue = JsonPrimitive | JsonValue[] | { [key: string]: JsonValue };
89
137
  type FabricTransport = "auto" | "process" | "tmux" | "screen" | "localterm" | "herdr";
90
- type FabricAgentRunner = "pi" | "claude" | "veda" | (string & {});
138
+ type FabricAgentRunner = "pi-durable" | "pi" | "claude" | "veda" | (string & {});
91
139
  type FabricKernel = "typescript" | "python";
92
140
  type FabricThinking = "off" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
93
141
  interface FabricActionEffect {
@@ -463,6 +511,7 @@ interface FabricActionSearchEnvelope {
463
511
  backend: FabricActionSearchBackend;
464
512
  }
465
513
  interface FabricToolsApi {
514
+ [name: string]: any;
466
515
  providers(): Promise<Array<{ name: string; description: string }>>;
467
516
  catalog(args?: { provider?: string; limit?: number }): Promise<FabricCapabilityCatalog>;
468
517
  /**
@@ -475,7 +524,7 @@ interface FabricToolsApi {
475
524
  describe(args: { ref: string }): Promise<FabricAction>;
476
525
  call(args: { ref: string; args?: Record<string, unknown> }): Promise<unknown>;
477
526
  progress(args: { message: string }): Promise<void>;
478
- models(): Promise<FabricModelInfo[]>;
527
+ models: FabricNativeModels;
479
528
  }
480
529
  interface FabricCapturedToolResult {
481
530
  content: Array<{ type: string; text?: string; [key: string]: unknown }>;
@@ -1620,6 +1669,8 @@ interface FabricWorkflowApi {
1620
1669
  budget: { total: number; spent(): number; remaining(): number };
1621
1670
  }
1622
1671
  declare const tools: FabricToolsApi;
1672
+ declare const nativeTools: Record<string, (args?: Record<string, unknown>) => Promise<any>>;
1673
+ declare const fabric: { readonly tools: FabricToolsApi };
1623
1674
  declare const pi: PiToolsApi;
1624
1675
  declare const extensions: FabricExtensionsApi;
1625
1676
  declare const agents: FabricAgentsApi;
@@ -1646,7 +1697,7 @@ declare function phase(name: string, options?: FabricWorkflowPhaseOptions): Prom
1646
1697
  declare function phase(input: FabricWorkflowPhaseInput): Promise<{ name: string; index: number; id?: string }>;
1647
1698
  declare function log(...values: unknown[]): void;
1648
1699
  declare const budget: FabricWorkflowApi["budget"];
1649
- type FabricRlmRequest = Omit<FabricAgentRequest, "runner" | "recursive"> & { runner?: "pi" };
1700
+ type FabricRlmRequest = Omit<FabricAgentRequest, "runner" | "recursive"> & { runner?: "pi" | "pi-durable" };
1650
1701
  declare const rlm: { query(args: FabricRlmRequest): Promise<FabricAgentResult> };
1651
1702
  interface FabricConsole {
1652
1703
  log(...args: unknown[]): void;
@@ -1714,4 +1765,4 @@ export {
1714
1765
  GUEST_TYPE_DECLARATIONS,
1715
1766
  guestTypeDeclarations
1716
1767
  };
1717
- //# sourceMappingURL=chunk-TFFZVLR2.js.map
1768
+ //# sourceMappingURL=chunk-PF27MQY5.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/runtime/native-codemode-types.ts", "../../src/jev/guest-types.ts", "../../src/runtime/guest-types.ts"],
4
+ "sourcesContent": ["export const NATIVE_CODEMODE_TYPES = `\ntype NativeModelType = \"chat\" | \"image\" | \"classifier\";\ninterface NativeModelInfo { type?: NativeModelType; provider: string; id: string; name: string; api: string; input: (\"text\" | \"image\")[]; contextWindow?: number; [key: string]: unknown }\ntype NativeModelSelector = { provider: string; id: string };\ntype NativeClassifierQuestion =\n | { type: \"choice\"; instructions: string; criteria: Record<string, string> }\n | { type: \"score\"; instructions: string; criteria: string[] }\n | { type: \"bool\"; instructions: string; criteria: { true: string; false: string } };\ntype NativeClassifierAnswer =\n | { type: \"choice\"; choice: string; probabilities: Record<string, number>; confidence: number }\n | { type: \"score\"; score: number; confidence: number }\n | { type: \"bool\"; probability: number };\ninterface NativeClassifierContext { state: Record<string, unknown>; questions: Record<string, NativeClassifierQuestion> }\ninterface NativeModelUsage { input: number; output: number; totalTokens: number; cost: { total: number } }\ninterface NativeClassifierResult { provider: string; model: string; answers: Record<string, NativeClassifierAnswer>; usage?: NativeModelUsage; stopReason: \"stop\" | \"error\" | \"aborted\"; errorMessage?: string }\ntype NativeImageBlock = { type: \"image\"; data: string; mimeType: string };\ntype NativeTextBlock = { type: \"text\"; text: string };\ninterface NativeImagesContext { input: (NativeImageBlock | NativeTextBlock)[] }\ninterface NativeImagesResult { provider: string; model: string; output: (NativeImageBlock | NativeTextBlock)[]; usage?: NativeModelUsage; stopReason: \"stop\" | \"error\" | \"aborted\"; errorMessage?: string }\ninterface FabricNativeModels {\n (): Promise<FabricModelInfo[]>;\n getModelsOfType(type: NativeModelType, provider?: string): Promise<NativeModelInfo[]>;\n getAvailableOfType(type: NativeModelType, provider?: string): Promise<NativeModelInfo[]>;\n getModelOfType(type: NativeModelType, provider: string, id: string): Promise<NativeModelInfo | undefined>;\n classify(model: NativeModelSelector, context: NativeClassifierContext): Promise<NativeClassifierResult>;\n generateImages(model: NativeModelSelector, context: NativeImagesContext): Promise<NativeImagesResult>;\n}\ninterface NativeToolInfo { name: string; description: string }\ndeclare const ALL_TOOLS: readonly NativeToolInfo[];\ndeclare function searchTools(query: string, options?: { limit?: number; namespace?: string }): Promise<NativeToolInfo[]>;\ndeclare function describeTool(name: string): Promise<(NativeToolInfo & { declaration: string }) | undefined>;\ndeclare function describeNamespace(name: string): Promise<{ name: string; description?: string; instructions?: string; tools: NativeToolInfo[] } | undefined>;\ndeclare const nativeDiscovery: {\n readonly ALL_TOOLS: readonly NativeToolInfo[];\n searchTools(query: string, options?: {limit?: number; namespace?: string}): Promise<NativeToolInfo[]>;\n describeTool(name: string): Promise<string | undefined>;\n describeNamespace(name: string): Promise<{name: string; description?: string; instructions?: string; tools: string[]} | undefined>;\n};\ndeclare const models: FabricNativeModels;\ndeclare function store(key: string, value: unknown): void;\ndeclare function load<T = unknown>(key: string): T | undefined;\ndeclare function text(value: unknown): void;\ndeclare function image(value: NativeImageBlock | string | { image_url: string | { url: string } }): void;\ndeclare function exit(): never;\n`;\n", "export const JEV_GUEST_DECLARATIONS = `\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`;\n", "import type { FabricDynamicGuestDeclarations } from \"../protocol.js\";\nimport { NATIVE_CODEMODE_TYPES } from \"./native-codemode-types.js\";\nimport { JEV_GUEST_DECLARATIONS } from \"../jev/guest-types.js\";\n\n// These names and compatibility fields are the single source of truth for\n// generated core-override overloads. Keep them beside PiToolsApi below so an\n// override extends the same guest contract rather than copying its signatures.\n// Numeric fields widen to `number | string` in generated overloads too,\n// mirroring built-in runtime normalization; a strict override schema still\n// rejects the string form at validation time, and the registry error wins.\nexport const PI_CORE_COMPATIBILITY_ARGUMENT_TYPE_NAMES = {\n read: \"PiReadCompatibilityArgument\",\n bash: \"PiBashCompatibilityArgument\",\n powershell: \"PiPowerShellCompatibilityArgument\",\n edit: \"PiEditCompatibilityArgument\",\n write: \"PiWriteCompatibilityArgument\",\n grep: \"PiGrepCompatibilityArgument\",\n find: \"PiFindCompatibilityArgument\",\n ls: \"PiLsCompatibilityArgument\",\n} as const;\n\nexport const PI_CORE_NUMERIC_FIELDS = {\n read: [\"offset\", \"limit\"],\n bash: [\"timeout\"],\n powershell: [\"timeout\"],\n edit: [],\n write: [],\n grep: [\"context\", \"limit\"],\n find: [\"limit\"],\n ls: [\"limit\"],\n} as const;\n\nexport const GUEST_TYPE_DECLARATIONS = `\n${NATIVE_CODEMODE_TYPES}\ntype JsonPrimitive = string | number | boolean | null;\ntype JsonValue = JsonPrimitive | JsonValue[] | { [key: string]: JsonValue };\ntype FabricTransport = \"auto\" | \"process\" | \"tmux\" | \"screen\" | \"localterm\" | \"herdr\";\ntype FabricAgentRunner = \"pi-durable\" | \"pi\" | \"claude\" | \"veda\" | (string & {});\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 /** Child thinking bounds; must lie inside this session's bounds. Levels outside are clamped. */\n thinkingBounds?: FabricThinkingBounds;\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 /** Shell command run in the new worktree before launch. */\n worktreeSetup?: string;\n /** Pi only. branch: fork this conversation (last completed turn); snippet: prefix recent messages. */\n seed?: \"task\" | \"branch\" | \"snippet\";\n seedMessages?: number;\n /** Pi only write confinement; bash needs shell: \"unconfined\". */\n readOnly?: boolean;\n writableRoots?: string[];\n shell?: \"deny\" | \"unconfined\";\n /** Narrow the host-issued scope; omitted inherits it. Refused when this session is unscoped. */\n scope?: { grants: { resource: string; actions: (\"read\" | \"write\" | \"execute\")[] }[] };\n schema?: Record<string, unknown>;\n prompt?: string;\n instructions?: string;\n timeout_ms?: number;\n residency?: FabricParticipantResidency;\n /** Opt in to session persistence for hook-based observability and external trace ingestion. */\n persistSession?: boolean;\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 | \"provider\";\n rootId: string;\n ownerHostId: string;\n ownerIdentityId: string;\n ownerIncarnation?: string;\n parentId?: string;\n name: string;\n status: string;\n runner?: FabricAgentRunner;\n provider?: string;\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 /** Present only when the requested level was clamped into thinking bounds. */\n requestedThinking?: 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 /** worktree: true runs; worktree stays the path. */\n worktreeResult?: {\n path: string; branch?: string; baseRef?: string; changedFiles: string[];\n diffstat: { files: number; insertions: number; deletions: number }; kept: boolean; diffError?: string;\n };\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 [name: string]: any;\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: FabricNativeModels;\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 description?: string;\n /** Opt-in line events; implies background. ui never wakes the model; wake may start an owning-agent turn. */\n monitor?: { delivery: \"ui\" | \"wake\"; timeoutMs?: number; intervalMs?: number; match?: string };\n cwd?: string; workdir?: string; directory?: string; workingDirectory?: string;\n};\ntype PiBashOptions = PiShellOptions & {\n /** Owned by an external jev-fabric store (macOS/Linux): keeps running if Pi exits and reattaches on resume. Implies background. */\n durable?: boolean;\n /** Durable only: on exit publish {kind ?? \"task.completed\", data:{taskId, exitCode, description?}}. */\n notify?: { topic: string; kind?: string };\n};\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 /** lineage mirrors PI_FABRIC_LINEAGE in child workers. */\n self(): Promise<FabricParticipantInfo & { lineage?: {\n version: 1; rootSessionId: string; parentSessionId?: string; parentRunId?: string;\n runId: string; depth: number; childIndex: number; worker: true;\n } }>;\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 /** External grant post: untrusted data. */\n origin?: \"external\"; untrusted?: true; grantId?: string;\n scheduled?: { dueAt: number; key?: string };\n /** Host-stamped publisher authority: unscoped \"host\" or a scope principal. */\n sender?: { authority: \"host\" } | { authority: \"scope\"; principalId: string; digest: string };\n}\ntype FabricMeshSchedule = Omit<FabricMeshEvent, \"sequence\" | \"origin\" | \"untrusted\" | \"grantId\" | \"scheduled\"> & { key?: string; dueAt: number };\ninterface FabricMeshGrant { grantId: string; topic: string; kind?: string; createdAt: number; expiresAt: number; uses: number; maxUses: number; createdBy: FabricMeshIdentity }\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 /** Schedules instead: notBefore (epoch ms/ISO) or afterMs, \u2264366 days; key replaces. */\n publish(args: { topic: string; kind?: string; to?: string; text?: string; data?: unknown; notBefore?: number | string; afterMs?: number; key?: string }): Promise<FabricMeshSchedule & { scheduled: true }>;\n scheduled(args?: { topic?: string; limit?: number }): Promise<FabricMeshSchedule[]>;\n unschedule(args: { key: string }): Promise<{ removed: boolean }>;\n /** External post token, shown once. ttlMs 1 min..30 days; uses 1..10000, default 1. */\n grant(args: { topic: string; ttlMs: number; uses?: number; kind?: string }): Promise<FabricMeshGrant & { token: string; command: string }>;\n revoke(args: { grantId: string }): Promise<{ revoked: boolean }>;\n grants(): Promise<FabricMeshGrant[]>;\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 binding?: Record<string, string>;\n observed?: { commit?: string; dirty?: boolean };\n requestedBy?: \"program\" | \"host\";\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; binding?: Record<string, 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}\ntype FabricCompactionOwner = \"fabric\" | \"pi\" | \"external\" | \"none\";\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 FabricCacheHoldOptions {\n target?: \"self\" | \"main\";\n durationMs: number;\n /** Currently unsupported: requesting this bound rejects acquisition. */\n maxRefreshes?: number;\n /** Currently unsupported: requesting this bound rejects acquisition. */\n maxCostUsd?: number;\n}\ninterface FabricCacheLease {\n id: string; scope: \"session\" | \"component\"; sessionId: string; model: string; expiresAt: number;\n}\ntype FabricCacheHoldResult = ({ status: \"held\" } & FabricCacheLease)\n | { status: \"unsupported\" | \"unavailable\"; reason: string };\ninterface FabricCacheSample {\n entryId: string; observedAt: number; input: number; cacheRead: number; cacheWrite: number;\n output: number; totalInput: number; cacheReadShare: number; reportedCostUsd: number | null;\n}\ninterface FabricCacheObservation {\n lastRequest: FabricCacheSample | null; lastRefresh: FabricCacheSample | null;\n maintenance: { requests: number; tokens: number; reportedCostUsd: number; unknownCostRequests: number; unknownTokenRequests: number };\n window: { entries: number; limit: number; truncated: boolean; stoppedAt: string | null };\n}\ninterface FabricCacheStatus {\n target: \"self\"; sessionId: string; model: string | null; supported: boolean; reason: string | null;\n limits: { durationMs: true; maxRefreshes: false; maxCostUsd: false };\n leases: FabricCacheLease[]; scheduled: null; cleanupError: string | null; observation: FabricCacheObservation;\n}\ninterface FabricCacheApi {\n status(args?: { target?: \"self\" | \"main\" }): Promise<FabricCacheStatus>;\n hold(args: FabricCacheHoldOptions): Promise<FabricCacheHoldResult>;\n release(args: { id: string }): Promise<{ released: boolean; cleanupError: string | null }>;\n}\n\ninterface FabricThinkingBounds { min?: FabricThinking; max?: FabricThinking }\ninterface FabricThinkingOverride {\n level: FabricThinking;\n scope: \"turn\" | \"turns\" | \"session\";\n remainingTurns?: number;\n reason?: string;\n setAt: number;\n}\ninterface FabricThinkingStatus {\n level: FabricThinking;\n available: FabricThinking[];\n bounds: { min: FabricThinking; max: FabricThinking };\n baseline: FabricThinking;\n override?: FabricThinkingOverride;\n}\ninterface FabricThinkingApi {\n status(): Promise<FabricThinkingStatus>;\n set(args: { level: FabricThinking; scope?: \"turn\" | \"turns\" | \"session\"; turns?: number; reason?: string }): Promise<FabricThinkingStatus & { clamped?: true; requested?: FabricThinking }>;\n reset(): Promise<FabricThinkingStatus>;\n}\n\ninterface FabricDecision {\n id: string; kind: \"approval\" | \"question\" | \"escalation\"; title: string; body?: string;\n options?: Array<{ id: string; label: string }>; input: \"text\" | \"confirm\" | \"select\" | \"editor\";\n raisedBy: { participantId: string; runId?: string; sessionId?: string };\n holder: string; createdAt: number; deadline?: number; onExpire: \"cancel\" | \"default\" | \"escalate\"; defaultOptionId?: string;\n escalation?: { chain: string[]; hop: number; hopTimeoutMs: number; onFinal: \"cancel\" | \"default\" };\n history?: Array<{ holder: string; until: number; reason: \"expired\" | \"escalated\"; text?: string; by?: string }>;\n status: \"open\" | \"answered\" | \"expired\" | \"cancelled\";\n answer?: { optionId?: string; text?: string; answeredBy: string; via: string; at: number };\n}\ninterface FabricDecisionsApi {\n raise(args: { title: string; kind?: FabricDecision[\"kind\"]; body?: string; options?: Array<{ id: string; label: string }>; input?: FabricDecision[\"input\"]; holder?: string; deadline?: number; timeoutMs?: number; onExpire?: \"cancel\" | \"default\" | \"escalate\"; defaultOptionId?: string; escalation?: { chain?: string[]; hopTimeoutMs?: number; onFinal?: \"cancel\" | \"default\" } }): Promise<{ id: string }>;\n wait(args: { id: string; timeoutMs?: number }): Promise<FabricDecision>;\n list(args?: { status?: FabricDecision[\"status\"]; holder?: string; limit?: number }): Promise<FabricDecision[]>;\n answer(args: { id: string; optionId?: string; text?: string }): Promise<FabricDecision>;\n escalate(args: { id: string; reason?: string }): Promise<FabricDecision>;\n cancel(args: { id: string }): Promise<FabricDecision>;\n}\n\ntype FabricProgramStatus = \"candidate\" | \"promoted\" | \"retired\";\ninterface FabricProgramSummary {\n /** name@digest12 */\n ref: string; name: string; digest: string; kind: \"fabric\" | \"jev\"; kernel?: \"typescript\" | \"python\";\n description?: string; createdAt: number; status: FabricProgramStatus;\n}\ninterface FabricProgramRecord extends FabricProgramSummary {\n version: 1; code?: string; jevProgram?: Record<string, unknown>; inputSchema?: Record<string, unknown>; trial?: unknown;\n}\ninterface FabricProgramsApi {\n /** Always saved as a candidate; identical content returns the same ref. */\n save(args: { name: string; kind?: \"fabric\" | \"jev\"; kernel?: \"typescript\" | \"python\"; code?: string; jevProgram?: Record<string, unknown>; description?: string; inputSchema?: Record<string, unknown> }): Promise<{ ref: string; digest: string }>;\n list(args?: { name?: string; status?: FabricProgramStatus }): Promise<FabricProgramSummary[]>;\n /** ref: name (latest promoted, else latest candidate), name@<digest prefix >= 12>, or a full digest. */\n get(args: { ref: string }): Promise<FabricProgramRecord>;\n /** Runs nested with this program's capabilities; args.input becomes the saved program's input global. */\n run<T = unknown>(args: { ref: string; input?: unknown; requirePromoted?: boolean }): Promise<T>;\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<{\n pending?: FabricCompactPendingIntent;\n last?: FabricCompactLastCommit;\n lastAuto?: { at: number; trigger: \"headroom\" | \"tokens\" | \"ratio\"; committed: boolean };\n owner: FabricCompactionOwner;\n outputReserveTokens: number;\n }>;\n /** Read-only context pressure; never compacts. */\n pressure(): Promise<{\n tokens: number | null;\n contextWindow: number | null;\n fraction: number | null;\n headroomTokens: number | null;\n band: \"ok\" | \"warn\" | \"urgent\" | \"unknown\";\n outputReserveTokens: number;\n thresholdFraction?: number;\n thresholdTokens?: number;\n owner: FabricCompactionOwner;\n }>;\n /** Persistent carry-forward focus rendered in every Fabric summary until cleared; no args reads. */\n carry(args?: { items?: string[]; add?: string[]; remove?: string[]; clear?: boolean }): Promise<{ items: string[] }>;\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 /** Only when Fabric's armed advisory or checkpoint requests an executor handoff plan.\n * Not a task planner, checklist, or acceptance-ledger store; unavailable otherwise. */\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 /** Stable id, 1-128 chars of [A-Za-z0-9._:/-]; omitted ids become item-<n> per invocation. */\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 /** Plain JSON object (<= 2 KiB) carried only on the host pi-fabric:workflow-item:v1 event. */\n meta?: Record<string, 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 nativeTools: Record<string, (args?: Record<string, unknown>) => Promise<any>>;\ndeclare const fabric: { readonly 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 cache: FabricCacheApi;\ndeclare const thinking: FabricThinkingApi;\ndeclare const decisions: FabricDecisionsApi;\ndeclare const programs: FabricProgramsApi;\ndeclare const prewalk: FabricPrewalkApi;\n${JEV_GUEST_DECLARATIONS}\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\" | \"pi-durable\" };\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`;\n\nconst FULL_CODE_GLOBAL_DECLARATIONS = [\n \"declare const pi: PiToolsApi;\\n\",\n \"declare const extensions: FabricExtensionsApi;\\n\",\n];\n\nconst PI_LOOSE_DECLARATION = \"declare const pi: PiToolsApi;\\n\";\nconst MCP_LOOSE_DECLARATION = \"declare const mcp: FabricMcpApi;\\n\";\nconst EXTENSIONS_LOOSE_DECLARATION = \"declare const extensions: FabricExtensionsApi;\\n\";\n\nexport interface FabricGuestDeclarationOptions {\n /** Global names to omit (for example providers disabled by configuration). */\n excludeGlobals?: readonly string[];\n /**\n * Pre-rendered replacement blocks from buildDynamicGuestDeclarations().\n * Applied only when the loose anchor line is still present \u2014 excluded\n * globals (or orchestration-only mode, for extensions) keep nothing to\n * replace, and missing/undefined sections keep the loose surface.\n */\n dynamic?: FabricDynamicGuestDeclarations;\n /**\n * Additive overloads for the current captured exact-name core overrides.\n * The block is applied only to the full-code `pi` declaration.\n */\n coreOverrides?: string;\n}\n\nconst globalDeclarationLine = (name: string): RegExp =>\n new RegExp(`^declare const ${name}: [^\\\\n]*;\\\\n`, \"m\");\n\nconst terminatedDeclaration = (block: string): string =>\n block.endsWith(\"\\n\") ? block : `${block}\\n`;\n\nexport const guestTypeDeclarations = (\n fullCodeMode: boolean,\n options: FabricGuestDeclarationOptions = {},\n): string => {\n const base = fullCodeMode\n ? GUEST_TYPE_DECLARATIONS\n : FULL_CODE_GLOBAL_DECLARATIONS.reduce(\n (declarations, declaration) => declarations.replace(declaration, \"\"),\n GUEST_TYPE_DECLARATIONS,\n );\n let result = (options.excludeGlobals ?? []).reduce(\n (declarations, name) => declarations.replace(globalDeclarationLine(name), \"\"),\n base,\n );\n if (fullCodeMode && options.coreOverrides && result.includes(PI_LOOSE_DECLARATION)) {\n result = result.replace(\n PI_LOOSE_DECLARATION,\n terminatedDeclaration(options.coreOverrides),\n );\n }\n if (options.dynamic?.mcp && result.includes(MCP_LOOSE_DECLARATION)) {\n result = result.replace(\n MCP_LOOSE_DECLARATION,\n terminatedDeclaration(options.dynamic.mcp),\n );\n }\n if (options.dynamic?.extensions && result.includes(EXTENSIONS_LOOSE_DECLARATION)) {\n result = result.replace(\n EXTENSIONS_LOOSE_DECLARATION,\n terminatedDeclaration(options.dynamic.extensions),\n );\n }\n return result;\n};\n"],
5
+ "mappings": ";AAAO,IAAM,wBAAwB;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;;;ACA9B,IAAM,yBAAyB;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;;;ACU/B,IAAM,4CAA4C;AAAA,EACvD,MAAM;AAAA,EACN,MAAM;AAAA,EACN,YAAY;AAAA,EACZ,MAAM;AAAA,EACN,OAAO;AAAA,EACP,MAAM;AAAA,EACN,MAAM;AAAA,EACN,IAAI;AACN;AAEO,IAAM,yBAAyB;AAAA,EACpC,MAAM,CAAC,UAAU,OAAO;AAAA,EACxB,MAAM,CAAC,SAAS;AAAA,EAChB,YAAY,CAAC,SAAS;AAAA,EACtB,MAAM,CAAC;AAAA,EACP,OAAO,CAAC;AAAA,EACR,MAAM,CAAC,WAAW,OAAO;AAAA,EACzB,MAAM,CAAC,OAAO;AAAA,EACd,IAAI,CAAC,OAAO;AACd;AAEO,IAAM,0BAA0B;AAAA,EACrC,qBAAqB;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;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;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;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;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;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,EAmhDrB,sBAAsB;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;AAkCxB,IAAM,gCAAgC;AAAA,EACpC;AAAA,EACA;AACF;AAEA,IAAM,uBAAuB;AAC7B,IAAM,wBAAwB;AAC9B,IAAM,+BAA+B;AAmBrC,IAAM,wBAAwB,CAAC,SAC7B,IAAI,OAAO,kBAAkB,IAAI,iBAAiB,GAAG;AAEvD,IAAM,wBAAwB,CAAC,UAC7B,MAAM,SAAS,IAAI,IAAI,QAAQ,GAAG,KAAK;AAAA;AAElC,IAAM,wBAAwB,CACnC,cACA,UAAyC,CAAC,MAC/B;AACX,QAAM,OAAO,eACT,0BACA,8BAA8B;AAAA,IAC5B,CAAC,cAAc,gBAAgB,aAAa,QAAQ,aAAa,EAAE;AAAA,IACnE;AAAA,EACF;AACJ,MAAI,UAAU,QAAQ,kBAAkB,CAAC,GAAG;AAAA,IAC1C,CAAC,cAAc,SAAS,aAAa,QAAQ,sBAAsB,IAAI,GAAG,EAAE;AAAA,IAC5E;AAAA,EACF;AACA,MAAI,gBAAgB,QAAQ,iBAAiB,OAAO,SAAS,oBAAoB,GAAG;AAClF,aAAS,OAAO;AAAA,MACd;AAAA,MACA,sBAAsB,QAAQ,aAAa;AAAA,IAC7C;AAAA,EACF;AACA,MAAI,QAAQ,SAAS,OAAO,OAAO,SAAS,qBAAqB,GAAG;AAClE,aAAS,OAAO;AAAA,MACd;AAAA,MACA,sBAAsB,QAAQ,QAAQ,GAAG;AAAA,IAC3C;AAAA,EACF;AACA,MAAI,QAAQ,SAAS,cAAc,OAAO,SAAS,4BAA4B,GAAG;AAChF,aAAS,OAAO;AAAA,MACd;AAAA,MACA,sBAAsB,QAAQ,QAAQ,UAAU;AAAA,IAClD;AAAA,EACF;AACA,SAAO;AACT;",
6
+ "names": []
7
+ }
@@ -26,6 +26,15 @@ var sanitizeFabricMediaValue = (value) => {
26
26
  const indexes = /* @__PURE__ */ new Map();
27
27
  const seen = /* @__PURE__ */ new WeakSet();
28
28
  const walk = (node) => {
29
+ let local = node;
30
+ if (node && typeof node === "object" && "image_url" in node) {
31
+ const url = node.image_url;
32
+ local = typeof url === "string" ? url : url && typeof url === "object" && "url" in url ? url.url : void 0;
33
+ }
34
+ if (typeof local === "string") {
35
+ const match = /^data:(image\/(?:png|jpeg|gif|webp));base64,([A-Za-z0-9+/=\s]+)$/.exec(local);
36
+ if (match) node = { type: "image", mimeType: match[1], data: match[2].replace(/\s/g, "") };
37
+ }
29
38
  if (typeof node === "string") {
30
39
  if (looksLikeBase64(node)) return omittedMarker(node.length);
31
40
  return sanitizeFabricMediaText(node);
@@ -140,4 +149,4 @@ export {
140
149
  sanitizeFabricMediaValue,
141
150
  prepareFabricActorHostPayload
142
151
  };
143
- //# sourceMappingURL=chunk-CGL7QP4A.js.map
152
+ //# sourceMappingURL=chunk-PK4NIJEV.js.map
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/actors/host-event-payload.ts", "../../src/core/media-sanitize.ts"],
4
- "sourcesContent": ["import { createHash } from \"node:crypto\";\n// Base64 and image-block heuristics are shared with the fabric_exec media\n// sanitizer so both channels agree on what counts as a payload.\nimport { isImageContent, looksLikeBase64 } from \"../core/media-sanitize.js\";\nimport type { ImageContent } from \"@earendil-works/pi-ai\";\n\ninterface FabricActorHostMediaDescriptor {\n type: \"image\";\n mediaIndex: number;\n mimeType: string;\n}\n\nexport interface PreparedFabricActorHostPayload {\n payload: unknown;\n images: ImageContent[];\n media: FabricActorHostMediaDescriptor[];\n}\n\nconst normalizedKey = (key: string): string =>\n key.toLowerCase().replaceAll(/[^a-z0-9]/g, \"\");\n\nconst isSensitiveKey = (key: string): boolean => {\n const normalized = normalizedKey(key);\n return [\n \"password\",\n \"passwd\",\n \"secret\",\n \"token\",\n \"accesstoken\",\n \"refreshtoken\",\n \"authorization\",\n \"cookie\",\n \"credential\",\n \"credentials\",\n \"apikey\",\n \"privatekey\",\n \"clientsecret\",\n ].some((sensitive) => normalized === sensitive || normalized.endsWith(sensitive));\n};\n\nconst redactInlineSecrets = (value: string): string =>\n value\n .replace(/\\bBearer\\s+[A-Za-z0-9._~+\\/-]+=*/gi, \"Bearer [redacted]\")\n .replace(/\\bBasic\\s+[A-Za-z0-9+/=]{8,}/gi, \"Basic [redacted]\")\n .replace(/\\b(?:sk|pk|ghp|github_pat|xox[baprs])[-_][A-Za-z0-9_-]{12,}\\b/g, \"[redacted]\")\n .replace(\n /\\b(Authorization|Proxy-Authorization|Cookie|Set-Cookie|X-Api-Key)\\s*:\\s*[^\\r\\n;]+/gi,\n \"$1: [redacted]\",\n )\n .replace(/(https?:\\/\\/)[^\\s/:@]+:[^\\s/@]+@/gi, \"$1[redacted]@\");\n\n\nexport const prepareFabricActorHostPayload = (\n value: unknown,\n maxChars: number,\n): PreparedFabricActorHostPayload => {\n const images: ImageContent[] = [];\n const media: FabricActorHostMediaDescriptor[] = [];\n const imageIndexes = new Map<string, number>();\n const seen = new WeakSet<object>();\n let json: string;\n\n try {\n const serialized = JSON.stringify(value, (key, nested) => {\n if (key && isSensitiveKey(key)) return \"[redacted]\";\n if (isImageContent(nested)) {\n const sha256 = createHash(\"sha256\")\n .update(nested.mimeType)\n .update(\"\\0\")\n .update(nested.data)\n .digest(\"hex\");\n let mediaIndex = imageIndexes.get(sha256);\n if (mediaIndex === undefined) {\n mediaIndex = images.length;\n imageIndexes.set(sha256, mediaIndex);\n images.push({ type: \"image\", data: nested.data, mimeType: nested.mimeType });\n media.push({ type: \"image\", mediaIndex, mimeType: nested.mimeType });\n }\n return {\n type: \"image\",\n mediaIndex,\n mimeType: nested.mimeType,\n redacted: true,\n };\n }\n if (\n typeof nested === \"object\" &&\n nested !== null &&\n !Array.isArray(nested) &&\n (nested as { type?: unknown }).type === \"image\"\n ) {\n return {\n type: \"image\",\n ...(typeof (nested as { mimeType?: unknown }).mimeType === \"string\"\n ? { mimeType: (nested as { mimeType: string }).mimeType }\n : {}),\n redacted: true,\n };\n }\n if (typeof nested === \"string\") {\n if (looksLikeBase64(nested)) return \"[omitted base64]\";\n return redactInlineSecrets(nested);\n }\n if (typeof nested === \"bigint\") return String(nested);\n if (typeof nested === \"function\" || typeof nested === \"symbol\") return undefined;\n if (typeof nested === \"object\" && nested !== null) {\n if (seen.has(nested)) return \"[circular or repeated reference]\";\n seen.add(nested);\n }\n return nested;\n });\n json = serialized ?? \"null\";\n } catch {\n json = JSON.stringify(String(value));\n }\n\n if (json.length > maxChars) json = json.slice(json.length - maxChars);\n let payload: unknown;\n try {\n payload = JSON.parse(json) as unknown;\n } catch {\n payload = json;\n }\n return { payload, images, media };\n};\n", "import { createHash } from \"node:crypto\";\nimport type { ImageContent } from \"@earendil-works/pi-ai\";\n\n/**\n * Media sanitization for every channel that serializes guest or provider data\n * into text: fabric_exec logs, results, and error text, and actor host-event\n * payloads. Worker event lines are not sanitized: one past the line cap fails the\n * run with a bounded raw prefix as evidence.\n *\n * Raw image bytes stay available out of band (see the images side channel), so a\n * multimodal model can still receive them while text channels receive a\n * descriptor. The rule used to be implemented only for actor host events, so a\n * guest that printed or returned a nested pi.read image could push hundreds of\n * KB of base64 into one serialized line and break the run.\n */\n\n/** Descriptor that replaces an image payload in a text channel. */\nexport interface FabricSanitizedMediaDescriptor {\n type: \"image\";\n mediaIndex: number;\n mimeType: string;\n redacted: true;\n}\n\nexport interface SanitizedFabricMedia {\n value: unknown;\n /** Raw payloads, indexed by mediaIndex in the descriptors. */\n images: ImageContent[];\n media: FabricSanitizedMediaDescriptor[];\n}\n\n/** A run of base64-alphabet characters long enough to be a binary payload. */\nconst BASE64_RUN = /[A-Za-z0-9+/=_-]{1024,}/g;\n\nconst BASE64_ALPHABET = /^[A-Za-z0-9+/=_\\r\\n-]+$/;\n\nconst omittedMarker = (length: number): string =>\n \"[omitted base64: \" + String(length) + \" chars]\";\n\nconst isPlainObject = (value: object): boolean => {\n const prototype = Object.getPrototypeOf(value) as object | null;\n return prototype === Object.prototype || prototype === null;\n};\n\n/** True when an entire string is a base64 payload (or a base64 data URL). */\nexport const looksLikeBase64 = (value: string): boolean => {\n if (value.startsWith(\"data:\") && value.includes(\";base64,\")) return true;\n if (value.length < 1_024 || value.length % 4 !== 0) return false;\n return BASE64_ALPHABET.test(value);\n};\n\n/** True for the Pi multimodal block shape {type: \"image\", data, mimeType}. */\nexport const isImageContent = (value: unknown): value is ImageContent =>\n typeof value === \"object\" &&\n value !== null &&\n !Array.isArray(value) &&\n (value as { type?: unknown }).type === \"image\" &&\n typeof (value as { data?: unknown }).data === \"string\" &&\n typeof (value as { mimeType?: unknown }).mimeType === \"string\";\n\n/**\n * Replace base64 runs inside free text with a bounded marker. Short strings are\n * returned untouched, so the hot event-line path pays only a length check.\n */\nexport const sanitizeFabricMediaText = (text: string): string => {\n if (text.length < 1_024) return text;\n return text.replace(BASE64_RUN, (run) => omittedMarker(run.length));\n};\n\n/**\n * Recursively replace image payloads and long base64 strings in a value.\n *\n * Images are deduplicated by content hash and hoisted into the images side\n * channel, and their text representation becomes a descriptor. Non-plain objects\n * and repeated references are returned unchanged: rebuilding them would drop\n * class identity, which matters because fabric_exec inspects result values for\n * control fields such as terminate.\n */\nexport const sanitizeFabricMediaValue = (value: unknown): SanitizedFabricMedia => {\n const images: ImageContent[] = [];\n const media: FabricSanitizedMediaDescriptor[] = [];\n const indexes = new Map<string, number>();\n const seen = new WeakSet<object>();\n\n const walk = (node: unknown): unknown => {\n if (typeof node === \"string\") {\n if (looksLikeBase64(node)) return omittedMarker(node.length);\n return sanitizeFabricMediaText(node);\n }\n if (node === null || typeof node !== \"object\") return node;\n if (isImageContent(node)) {\n const sha256 = createHash(\"sha256\")\n .update(node.mimeType)\n .update(\"\\0\")\n .update(node.data)\n .digest(\"hex\");\n let mediaIndex = indexes.get(sha256);\n if (mediaIndex === undefined) {\n mediaIndex = images.length;\n indexes.set(sha256, mediaIndex);\n images.push({ type: \"image\", data: node.data, mimeType: node.mimeType });\n media.push({ type: \"image\", mediaIndex, mimeType: node.mimeType, redacted: true });\n }\n return { type: \"image\", mediaIndex, mimeType: node.mimeType, redacted: true };\n }\n if (seen.has(node)) return node;\n seen.add(node);\n if (Array.isArray(node)) return node.map(walk);\n if (!isPlainObject(node)) return node;\n const rebuilt: Record<string, unknown> = {};\n for (const [key, nested] of Object.entries(node)) rebuilt[key] = walk(nested);\n return rebuilt;\n };\n\n return { value: walk(value), images, media };\n};\n"],
5
- "mappings": "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",
4
+ "sourcesContent": ["import { createHash } from \"node:crypto\";\n// Base64 and image-block heuristics are shared with the fabric_exec media\n// sanitizer so both channels agree on what counts as a payload.\nimport { isImageContent, looksLikeBase64 } from \"../core/media-sanitize.js\";\nimport type { ImageContent } from \"@earendil-works/pi-ai\";\n\ninterface FabricActorHostMediaDescriptor {\n type: \"image\";\n mediaIndex: number;\n mimeType: string;\n}\n\nexport interface PreparedFabricActorHostPayload {\n payload: unknown;\n images: ImageContent[];\n media: FabricActorHostMediaDescriptor[];\n}\n\nconst normalizedKey = (key: string): string =>\n key.toLowerCase().replaceAll(/[^a-z0-9]/g, \"\");\n\nconst isSensitiveKey = (key: string): boolean => {\n const normalized = normalizedKey(key);\n return [\n \"password\",\n \"passwd\",\n \"secret\",\n \"token\",\n \"accesstoken\",\n \"refreshtoken\",\n \"authorization\",\n \"cookie\",\n \"credential\",\n \"credentials\",\n \"apikey\",\n \"privatekey\",\n \"clientsecret\",\n ].some((sensitive) => normalized === sensitive || normalized.endsWith(sensitive));\n};\n\nconst redactInlineSecrets = (value: string): string =>\n value\n .replace(/\\bBearer\\s+[A-Za-z0-9._~+\\/-]+=*/gi, \"Bearer [redacted]\")\n .replace(/\\bBasic\\s+[A-Za-z0-9+/=]{8,}/gi, \"Basic [redacted]\")\n .replace(/\\b(?:sk|pk|ghp|github_pat|xox[baprs])[-_][A-Za-z0-9_-]{12,}\\b/g, \"[redacted]\")\n .replace(\n /\\b(Authorization|Proxy-Authorization|Cookie|Set-Cookie|X-Api-Key)\\s*:\\s*[^\\r\\n;]+/gi,\n \"$1: [redacted]\",\n )\n .replace(/(https?:\\/\\/)[^\\s/:@]+:[^\\s/@]+@/gi, \"$1[redacted]@\");\n\n\nexport const prepareFabricActorHostPayload = (\n value: unknown,\n maxChars: number,\n): PreparedFabricActorHostPayload => {\n const images: ImageContent[] = [];\n const media: FabricActorHostMediaDescriptor[] = [];\n const imageIndexes = new Map<string, number>();\n const seen = new WeakSet<object>();\n let json: string;\n\n try {\n const serialized = JSON.stringify(value, (key, nested) => {\n if (key && isSensitiveKey(key)) return \"[redacted]\";\n if (isImageContent(nested)) {\n const sha256 = createHash(\"sha256\")\n .update(nested.mimeType)\n .update(\"\\0\")\n .update(nested.data)\n .digest(\"hex\");\n let mediaIndex = imageIndexes.get(sha256);\n if (mediaIndex === undefined) {\n mediaIndex = images.length;\n imageIndexes.set(sha256, mediaIndex);\n images.push({ type: \"image\", data: nested.data, mimeType: nested.mimeType });\n media.push({ type: \"image\", mediaIndex, mimeType: nested.mimeType });\n }\n return {\n type: \"image\",\n mediaIndex,\n mimeType: nested.mimeType,\n redacted: true,\n };\n }\n if (\n typeof nested === \"object\" &&\n nested !== null &&\n !Array.isArray(nested) &&\n (nested as { type?: unknown }).type === \"image\"\n ) {\n return {\n type: \"image\",\n ...(typeof (nested as { mimeType?: unknown }).mimeType === \"string\"\n ? { mimeType: (nested as { mimeType: string }).mimeType }\n : {}),\n redacted: true,\n };\n }\n if (typeof nested === \"string\") {\n if (looksLikeBase64(nested)) return \"[omitted base64]\";\n return redactInlineSecrets(nested);\n }\n if (typeof nested === \"bigint\") return String(nested);\n if (typeof nested === \"function\" || typeof nested === \"symbol\") return undefined;\n if (typeof nested === \"object\" && nested !== null) {\n if (seen.has(nested)) return \"[circular or repeated reference]\";\n seen.add(nested);\n }\n return nested;\n });\n json = serialized ?? \"null\";\n } catch {\n json = JSON.stringify(String(value));\n }\n\n if (json.length > maxChars) json = json.slice(json.length - maxChars);\n let payload: unknown;\n try {\n payload = JSON.parse(json) as unknown;\n } catch {\n payload = json;\n }\n return { payload, images, media };\n};\n", "import { createHash } from \"node:crypto\";\nimport type { ImageContent } from \"@earendil-works/pi-ai\";\n\n/**\n * Media sanitization for every channel that serializes guest or provider data\n * into text: fabric_exec logs, results, and error text, and actor host-event\n * payloads. Worker event lines are not sanitized: one past the line cap fails the\n * run with a bounded raw prefix as evidence.\n *\n * Raw image bytes stay available out of band (see the images side channel), so a\n * multimodal model can still receive them while text channels receive a\n * descriptor. The rule used to be implemented only for actor host events, so a\n * guest that printed or returned a nested pi.read image could push hundreds of\n * KB of base64 into one serialized line and break the run.\n */\n\n/** Descriptor that replaces an image payload in a text channel. */\nexport interface FabricSanitizedMediaDescriptor {\n type: \"image\";\n mediaIndex: number;\n mimeType: string;\n redacted: true;\n}\n\nexport interface SanitizedFabricMedia {\n value: unknown;\n /** Raw payloads, indexed by mediaIndex in the descriptors. */\n images: ImageContent[];\n media: FabricSanitizedMediaDescriptor[];\n}\n\n/** A run of base64-alphabet characters long enough to be a binary payload. */\nconst BASE64_RUN = /[A-Za-z0-9+/=_-]{1024,}/g;\n\nconst BASE64_ALPHABET = /^[A-Za-z0-9+/=_\\r\\n-]+$/;\n\nconst omittedMarker = (length: number): string =>\n \"[omitted base64: \" + String(length) + \" chars]\";\n\nconst isPlainObject = (value: object): boolean => {\n const prototype = Object.getPrototypeOf(value) as object | null;\n return prototype === Object.prototype || prototype === null;\n};\n\n/** True when an entire string is a base64 payload (or a base64 data URL). */\nexport const looksLikeBase64 = (value: string): boolean => {\n if (value.startsWith(\"data:\") && value.includes(\";base64,\")) return true;\n if (value.length < 1_024 || value.length % 4 !== 0) return false;\n return BASE64_ALPHABET.test(value);\n};\n\n/** True for the Pi multimodal block shape {type: \"image\", data, mimeType}. */\nexport const isImageContent = (value: unknown): value is ImageContent =>\n typeof value === \"object\" &&\n value !== null &&\n !Array.isArray(value) &&\n (value as { type?: unknown }).type === \"image\" &&\n typeof (value as { data?: unknown }).data === \"string\" &&\n typeof (value as { mimeType?: unknown }).mimeType === \"string\";\n\n/**\n * Replace base64 runs inside free text with a bounded marker. Short strings are\n * returned untouched, so the hot event-line path pays only a length check.\n */\nexport const sanitizeFabricMediaText = (text: string): string => {\n if (text.length < 1_024) return text;\n return text.replace(BASE64_RUN, (run) => omittedMarker(run.length));\n};\n\n/**\n * Recursively replace image payloads and long base64 strings in a value.\n *\n * Images are deduplicated by content hash and hoisted into the images side\n * channel, and their text representation becomes a descriptor. Non-plain objects\n * and repeated references are returned unchanged: rebuilding them would drop\n * class identity, which matters because fabric_exec inspects result values for\n * control fields such as terminate.\n */\nexport const sanitizeFabricMediaValue = (value: unknown): SanitizedFabricMedia => {\n const images: ImageContent[] = [];\n const media: FabricSanitizedMediaDescriptor[] = [];\n const indexes = new Map<string, number>();\n const seen = new WeakSet<object>();\n\n const walk = (node: unknown): unknown => {\n // Local-only native image forms. Never fetch or interpret remote URLs.\n let local: unknown = node;\n if (node && typeof node === \"object\" && \"image_url\" in node) {\n const url = (node as { image_url: unknown }).image_url;\n local = typeof url === \"string\" ? url : url && typeof url === \"object\" && \"url\" in url ? url.url : undefined;\n }\n if (typeof local === \"string\") {\n const match = /^data:(image\\/(?:png|jpeg|gif|webp));base64,([A-Za-z0-9+/=\\s]+)$/.exec(local);\n if (match) node = { type: \"image\", mimeType: match[1], data: match[2]!.replace(/\\s/g, \"\") };\n }\n if (typeof node === \"string\") {\n if (looksLikeBase64(node)) return omittedMarker(node.length);\n return sanitizeFabricMediaText(node);\n }\n if (node === null || typeof node !== \"object\") return node;\n if (isImageContent(node)) {\n const sha256 = createHash(\"sha256\")\n .update(node.mimeType)\n .update(\"\\0\")\n .update(node.data)\n .digest(\"hex\");\n let mediaIndex = indexes.get(sha256);\n if (mediaIndex === undefined) {\n mediaIndex = images.length;\n indexes.set(sha256, mediaIndex);\n images.push({ type: \"image\", data: node.data, mimeType: node.mimeType });\n media.push({ type: \"image\", mediaIndex, mimeType: node.mimeType, redacted: true });\n }\n return { type: \"image\", mediaIndex, mimeType: node.mimeType, redacted: true };\n }\n if (seen.has(node)) return node;\n seen.add(node);\n if (Array.isArray(node)) return node.map(walk);\n if (!isPlainObject(node)) return node;\n const rebuilt: Record<string, unknown> = {};\n for (const [key, nested] of Object.entries(node)) rebuilt[key] = walk(nested);\n return rebuilt;\n };\n\n return { value: walk(value), images, media };\n};\n"],
5
+ "mappings": "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",
6
6
  "names": ["createHash", "createHash"]
7
7
  }
@@ -94,4 +94,4 @@ export {
94
94
  FABRIC_TOOL_RESULT_PROXY_KIND,
95
95
  readFabricToolResultProxyDetailsV1
96
96
  };
97
- //# sourceMappingURL=chunk-YRDCJZZW.js.map
97
+ //# sourceMappingURL=chunk-RUO6L7RM.js.map