@e4779/pi-fabric 0.117.2-fork.31 → 0.131.4-fork.33
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -6
- package/THIRD_PARTY_NOTICES.md +6 -14
- package/dist/activity/store.d.ts +2 -1
- package/dist/activity/store.d.ts.map +1 -1
- package/dist/actors/binding-store.d.ts +13 -0
- package/dist/actors/binding-store.d.ts.map +1 -1
- package/dist/actors/directory.d.ts.map +1 -1
- package/dist/actors/feedback.d.ts +5 -0
- package/dist/actors/feedback.d.ts.map +1 -0
- package/dist/actors/global-registry.d.ts +8 -0
- package/dist/actors/global-registry.d.ts.map +1 -1
- package/dist/actors/host-event-payload.d.ts +14 -0
- package/dist/actors/host-event-payload.d.ts.map +1 -1
- package/dist/actors/manager.d.ts +4 -3
- package/dist/actors/manager.d.ts.map +1 -1
- package/dist/actors/mesh-monitor.d.ts +2 -0
- package/dist/actors/mesh-monitor.d.ts.map +1 -1
- package/dist/actors/name-policy.d.ts +3 -0
- package/dist/actors/name-policy.d.ts.map +1 -0
- package/dist/actors/registry-store.d.ts +14 -5
- package/dist/actors/registry-store.d.ts.map +1 -1
- package/dist/actors/store-read.d.ts +16 -0
- package/dist/actors/store-read.d.ts.map +1 -0
- package/dist/agents/agent-files.d.ts +80 -0
- package/dist/agents/agent-files.d.ts.map +1 -0
- package/dist/agents/agent-files.js +327 -0
- package/dist/agents/agent-files.js.map +7 -0
- package/dist/agents/child-skills.d.ts +60 -0
- package/dist/agents/child-skills.d.ts.map +1 -0
- package/dist/agents/child-skills.js +94 -0
- package/dist/agents/child-skills.js.map +7 -0
- package/dist/agents/clone-first-worktree.d.ts +6 -0
- package/dist/agents/clone-first-worktree.d.ts.map +1 -1
- package/dist/agents/completion-inbox.d.ts.map +1 -1
- package/dist/agents/cow-clone.d.ts.map +1 -1
- package/dist/agents/handoff.d.ts +12 -2
- package/dist/agents/handoff.d.ts.map +1 -1
- package/dist/agents/herdr-status.d.ts +26 -0
- package/dist/agents/herdr-status.d.ts.map +1 -0
- package/dist/agents/herdr-status.js +161 -0
- package/dist/agents/herdr-status.js.map +7 -0
- package/dist/agents/hosted-run.d.ts +20 -4
- package/dist/agents/hosted-run.d.ts.map +1 -1
- package/dist/agents/manager.d.ts +18 -2
- package/dist/agents/manager.d.ts.map +1 -1
- package/dist/agents/model-pin-guard.d.ts +27 -0
- package/dist/agents/model-pin-guard.d.ts.map +1 -0
- package/dist/agents/model-pin-guard.js +86 -0
- package/dist/agents/model-pin-guard.js.map +7 -0
- package/dist/agents/model-pin.d.ts +25 -0
- package/dist/agents/model-pin.d.ts.map +1 -0
- package/dist/agents/provider-bridge.d.ts +7 -6
- package/dist/agents/provider-bridge.d.ts.map +1 -1
- package/dist/agents/provider-bridge.js +33 -5
- package/dist/agents/provider-bridge.js.map +3 -3
- package/dist/agents/request.d.ts.map +1 -1
- package/dist/agents/result.d.ts.map +1 -1
- package/dist/agents/result.js +1 -1
- package/dist/agents/runner-notice.d.ts.map +1 -1
- package/dist/agents/runner-protocol.d.ts +8 -0
- package/dist/agents/runner-protocol.d.ts.map +1 -1
- package/dist/agents/service-schema.d.ts.map +1 -1
- package/dist/agents/transports/herdr-core-socket.d.ts +13 -0
- package/dist/agents/transports/herdr-core-socket.d.ts.map +1 -0
- package/dist/agents/transports/herdr-core-transport.d.ts +10 -0
- package/dist/agents/transports/herdr-core-transport.d.ts.map +1 -0
- package/dist/agents/transports/herdr-socket.d.ts +12 -0
- package/dist/agents/transports/herdr-socket.d.ts.map +1 -0
- package/dist/agents/transports/herdr-transport.d.ts.map +1 -1
- package/dist/agents/types.d.ts +51 -0
- package/dist/agents/types.d.ts.map +1 -1
- package/dist/agents/worker-recovery.d.ts +75 -0
- package/dist/agents/worker-recovery.d.ts.map +1 -0
- package/dist/agents/worktree-manager.d.ts.map +1 -1
- package/dist/agents.js +12 -11
- package/dist/agents.js.map +2 -2
- package/dist/audit/details.d.ts +38 -1
- package/dist/audit/details.d.ts.map +1 -1
- package/dist/audit/projection.d.ts.map +1 -1
- package/dist/audit/trace-schema.d.ts +50 -0
- package/dist/audit/trace-schema.d.ts.map +1 -0
- package/dist/audit/trace.d.ts +2 -48
- package/dist/audit/trace.d.ts.map +1 -1
- package/dist/chunks/chunk-2RWNVCFD.js +483 -0
- package/dist/chunks/chunk-2RWNVCFD.js.map +7 -0
- package/dist/chunks/chunk-2SCMGO2Z.js +16 -0
- package/dist/chunks/chunk-2SCMGO2Z.js.map +7 -0
- package/dist/chunks/chunk-35EEGOH3.js +324 -0
- package/dist/chunks/chunk-35EEGOH3.js.map +7 -0
- package/dist/chunks/{chunk-UTOBAZ5T.js → chunk-37NIOSVU.js} +1 -1
- package/dist/chunks/chunk-37NIOSVU.js.map +7 -0
- package/dist/chunks/chunk-3IJEQBFS.js +25 -0
- package/dist/chunks/chunk-3IJEQBFS.js.map +7 -0
- package/dist/chunks/{chunk-EHQQ4KCX.js → chunk-3MOY6WIB.js} +84 -19
- package/dist/chunks/chunk-3MOY6WIB.js.map +7 -0
- package/dist/chunks/chunk-3VK6UGAN.js +64 -0
- package/dist/chunks/chunk-3VK6UGAN.js.map +7 -0
- package/dist/chunks/{chunk-ROTCDDOV.js → chunk-3XT5WHSG.js} +59 -119
- package/dist/chunks/chunk-3XT5WHSG.js.map +7 -0
- package/dist/chunks/{chunk-FIDUHKMM.js → chunk-4BYS4ZLY.js} +16 -16
- package/dist/chunks/chunk-4BYS4ZLY.js.map +7 -0
- package/dist/chunks/{chunk-UOM37PE4.js → chunk-4PBW54I2.js} +162 -92
- package/dist/chunks/chunk-4PBW54I2.js.map +7 -0
- package/dist/chunks/{chunk-ZEXCKK4K.js → chunk-4WKD3YM3.js} +3 -3
- package/dist/chunks/{chunk-PK4NIJEV.js → chunk-4XMXFHAR.js} +62 -3
- package/dist/chunks/chunk-4XMXFHAR.js.map +7 -0
- package/dist/chunks/{chunk-4EW7GVUR.js → chunk-56NMRVTV.js} +589 -377
- package/dist/chunks/chunk-56NMRVTV.js.map +7 -0
- package/dist/chunks/chunk-5QJFDKPN.js +179 -0
- package/dist/chunks/chunk-5QJFDKPN.js.map +7 -0
- package/dist/chunks/{chunk-P7CBPPHY.js → chunk-6GWDGTHC.js} +5 -5
- package/dist/chunks/{chunk-P7CBPPHY.js.map → chunk-6GWDGTHC.js.map} +1 -1
- package/dist/chunks/chunk-6HO2IUQ5.js +104 -0
- package/dist/chunks/chunk-6HO2IUQ5.js.map +7 -0
- package/dist/chunks/chunk-6OGYPHNQ.js +62 -0
- package/dist/chunks/chunk-6OGYPHNQ.js.map +7 -0
- package/dist/chunks/{chunk-G4TLWHRS.js → chunk-7N7IC3Z2.js} +4 -3
- package/dist/chunks/{chunk-G4TLWHRS.js.map → chunk-7N7IC3Z2.js.map} +2 -2
- package/dist/chunks/{chunk-5XBYFSI5.js → chunk-7YNE4NB2.js} +2 -2
- package/dist/chunks/chunk-ASOJYFKU.js +1316 -0
- package/dist/chunks/chunk-ASOJYFKU.js.map +7 -0
- package/dist/chunks/{chunk-NTC2MCB6.js → chunk-B5L3X3ID.js} +1 -1
- package/dist/chunks/{chunk-NTC2MCB6.js.map → chunk-B5L3X3ID.js.map} +1 -1
- package/dist/chunks/chunk-BIBRWZWQ.js +325 -0
- package/dist/chunks/chunk-BIBRWZWQ.js.map +7 -0
- package/dist/chunks/{chunk-K6QXUGS5.js → chunk-BMAEZNZ5.js} +2 -1
- package/dist/chunks/{chunk-FSB2VIRZ.js → chunk-CBIV747V.js} +14 -3
- package/dist/chunks/chunk-CBIV747V.js.map +7 -0
- package/dist/chunks/{chunk-CCHZXF6K.js → chunk-CXYJJ3HZ.js} +3 -3
- package/dist/chunks/{chunk-R2XQ6AHT.js → chunk-DGERP4VL.js} +22 -10
- package/dist/chunks/chunk-DGERP4VL.js.map +7 -0
- package/dist/chunks/{chunk-C7Z6F3SO.js → chunk-DGUXJSYA.js} +64 -33
- package/dist/chunks/chunk-DGUXJSYA.js.map +7 -0
- package/dist/chunks/chunk-F2LGSRIN.js +38 -0
- package/dist/chunks/chunk-F2LGSRIN.js.map +7 -0
- package/dist/chunks/chunk-F6A6MQ6G.js +609 -0
- package/dist/chunks/chunk-F6A6MQ6G.js.map +7 -0
- package/dist/chunks/{chunk-IR3PIHJM.js → chunk-FK73YJKV.js} +67 -2
- package/dist/chunks/chunk-FK73YJKV.js.map +7 -0
- package/dist/chunks/{chunk-XCEEQ5AB.js → chunk-G2DZJ5LK.js} +1607 -1567
- package/dist/chunks/chunk-G2DZJ5LK.js.map +7 -0
- package/dist/chunks/{chunk-VYQV5JRT.js → chunk-GJVKEHDL.js} +2 -2
- package/dist/chunks/chunk-GJVKEHDL.js.map +7 -0
- package/dist/chunks/{chunk-TIIIHPHF.js → chunk-GS67KDMV.js} +2 -2
- package/dist/chunks/{chunk-D5NYNIST.js → chunk-H57KPL3V.js} +5 -5
- package/dist/chunks/{chunk-KVYNGDGC.js → chunk-HFDJWLMS.js} +6 -6
- package/dist/chunks/{chunk-KVYNGDGC.js.map → chunk-HFDJWLMS.js.map} +1 -1
- package/dist/chunks/{chunk-INRXG4J5.js → chunk-HGD75NZY.js} +2 -2
- package/dist/chunks/{chunk-CRRUW26I.js → chunk-HRDMBGMY.js} +12 -12
- package/dist/chunks/{chunk-CRRUW26I.js.map → chunk-HRDMBGMY.js.map} +2 -2
- package/dist/chunks/{chunk-GO32KSEZ.js → chunk-HRVYXRWZ.js} +85 -10
- package/dist/chunks/chunk-HRVYXRWZ.js.map +7 -0
- package/dist/chunks/{chunk-MLLYR3Y6.js → chunk-HSEZPCL5.js} +19 -78
- package/dist/chunks/chunk-HSEZPCL5.js.map +7 -0
- package/dist/chunks/chunk-JMUUNW2H.js +65 -0
- package/dist/chunks/chunk-JMUUNW2H.js.map +7 -0
- package/dist/chunks/{chunk-UXIBKMUM.js → chunk-KIFOEBYJ.js} +4 -4
- package/dist/chunks/{chunk-3FJUP3GV.js → chunk-L6H46CPY.js} +2 -2
- package/dist/chunks/{chunk-SPCJXN4K.js → chunk-LKYLD5SN.js} +298 -65
- package/dist/chunks/chunk-LKYLD5SN.js.map +7 -0
- package/dist/chunks/{chunk-K7J2ABAZ.js → chunk-LRSZFYUC.js} +92 -32
- package/dist/chunks/chunk-LRSZFYUC.js.map +7 -0
- package/dist/chunks/{chunk-GIK2WNAK.js → chunk-LZ2ZXOCU.js} +112 -23
- package/dist/chunks/chunk-LZ2ZXOCU.js.map +7 -0
- package/dist/chunks/{chunk-FUY6XVRX.js → chunk-MPMEK3IQ.js} +2 -2
- package/dist/chunks/{chunk-HP5P7NBO.js → chunk-MSDL7U6Q.js} +4 -4
- package/dist/chunks/{chunk-ASSLHWZS.js → chunk-MX53BRAC.js} +2 -2
- package/dist/chunks/chunk-N7ZAK2PB.js +132 -0
- package/dist/chunks/chunk-N7ZAK2PB.js.map +7 -0
- package/dist/chunks/{chunk-VSDUSNIA.js → chunk-NBIYYMKS.js} +8 -2
- package/dist/chunks/chunk-NBIYYMKS.js.map +7 -0
- package/dist/chunks/chunk-NENQZCGW.js +45 -0
- package/dist/chunks/chunk-NENQZCGW.js.map +7 -0
- package/dist/chunks/chunk-NJHJKINP.js +47 -0
- package/dist/chunks/chunk-NJHJKINP.js.map +7 -0
- package/dist/chunks/{chunk-U366I5K2.js → chunk-NQ7IWEIF.js} +18 -6
- package/dist/chunks/chunk-NQ7IWEIF.js.map +7 -0
- package/dist/chunks/{chunk-ZQMBS5SH.js → chunk-OJ4HAALD.js} +15 -12
- package/dist/chunks/chunk-OJ4HAALD.js.map +7 -0
- package/dist/chunks/chunk-OZCJU3PZ.js +33 -0
- package/dist/chunks/chunk-OZCJU3PZ.js.map +7 -0
- package/dist/chunks/chunk-P3DCXKL3.js +40 -0
- package/dist/chunks/chunk-P3DCXKL3.js.map +7 -0
- package/dist/chunks/chunk-P7YSPKTM.js +294 -0
- package/dist/chunks/chunk-P7YSPKTM.js.map +7 -0
- package/dist/chunks/chunk-PQVUMJ5J.js +223 -0
- package/dist/chunks/chunk-PQVUMJ5J.js.map +7 -0
- package/dist/chunks/chunk-PUBHBEYO.js +84 -0
- package/dist/chunks/chunk-PUBHBEYO.js.map +7 -0
- package/dist/chunks/{chunk-P4KH4S4S.js → chunk-QGTD3LAZ.js} +5 -20
- package/dist/chunks/chunk-QGTD3LAZ.js.map +7 -0
- package/dist/chunks/{chunk-TIJ3YQXX.js → chunk-QOEOKW2X.js} +2 -2
- package/dist/chunks/{chunk-TIJ3YQXX.js.map → chunk-QOEOKW2X.js.map} +1 -1
- package/dist/chunks/{chunk-QT4W5YVB.js → chunk-RAA3FAYZ.js} +2 -2
- package/dist/chunks/{chunk-3UGN25XS.js → chunk-RKJPBTBB.js} +98 -1664
- package/dist/chunks/chunk-RKJPBTBB.js.map +7 -0
- package/dist/chunks/{chunk-WJJXODAB.js → chunk-RLKRZXSX.js} +8 -1
- package/dist/chunks/{chunk-WJJXODAB.js.map → chunk-RLKRZXSX.js.map} +2 -2
- package/dist/chunks/chunk-RWKQ5SRW.js +129 -0
- package/dist/chunks/chunk-RWKQ5SRW.js.map +7 -0
- package/dist/chunks/chunk-SW25R47N.js +71 -0
- package/dist/chunks/chunk-SW25R47N.js.map +7 -0
- package/dist/chunks/{chunk-EKODKR6Y.js → chunk-TEMKDJJY.js} +148 -72
- package/dist/chunks/chunk-TEMKDJJY.js.map +7 -0
- package/dist/chunks/{chunk-EFETPXU2.js → chunk-TJZYM2SP.js} +118 -237
- package/dist/chunks/chunk-TJZYM2SP.js.map +7 -0
- package/dist/chunks/{chunk-53N2I4QA.js → chunk-TXCNZCZP.js} +2 -2
- package/dist/chunks/{chunk-LNASO4VT.js → chunk-U6Y6TKJL.js} +45 -20
- package/dist/chunks/chunk-U6Y6TKJL.js.map +7 -0
- package/dist/chunks/chunk-UD7LFV43.js +28 -0
- package/dist/chunks/chunk-UD7LFV43.js.map +7 -0
- package/dist/chunks/{chunk-7QKKLBHJ.js → chunk-UPMWLOKL.js} +10 -1
- package/dist/chunks/{chunk-7QKKLBHJ.js.map → chunk-UPMWLOKL.js.map} +2 -2
- package/dist/chunks/chunk-V4OW2ULC.js +422 -0
- package/dist/chunks/chunk-V4OW2ULC.js.map +7 -0
- package/dist/chunks/{chunk-FE6NOAO7.js → chunk-VGRUWTMG.js} +1993 -659
- package/dist/chunks/chunk-VGRUWTMG.js.map +7 -0
- package/dist/chunks/{chunk-PYFJW3HC.js → chunk-W5FEHVZA.js} +2 -16
- package/dist/chunks/{chunk-PYFJW3HC.js.map → chunk-W5FEHVZA.js.map} +3 -3
- package/dist/chunks/chunk-WKFRGICG.js +101 -0
- package/dist/chunks/chunk-WKFRGICG.js.map +7 -0
- package/dist/chunks/{chunk-LEU5CDSL.js → chunk-XFOSUGLU.js} +5 -5
- package/dist/chunks/{chunk-MZUC6LLH.js → chunk-XMYG2TKR.js} +4 -4
- package/dist/chunks/{chunk-MZUC6LLH.js.map → chunk-XMYG2TKR.js.map} +1 -1
- package/dist/chunks/chunk-YC65P7ZO.js +57 -0
- package/dist/chunks/chunk-YC65P7ZO.js.map +7 -0
- package/dist/chunks/{chunk-5UBRGTVN.js → chunk-ZHROHNEE.js} +31 -15
- package/dist/chunks/chunk-ZHROHNEE.js.map +7 -0
- package/dist/cli/decisions.d.ts.map +1 -1
- package/dist/cli/decisions.js +15 -3
- package/dist/cli/decisions.js.map +2 -2
- package/dist/cli/mesh.js +4 -3
- package/dist/cli/mesh.js.map +1 -1
- package/dist/commands/fabric-handler.d.ts +7 -0
- package/dist/commands/fabric-handler.d.ts.map +1 -0
- package/dist/commands/fabric-handler.js +916 -0
- package/dist/commands/fabric-handler.js.map +7 -0
- package/dist/commands/fabric.d.ts +11 -1
- package/dist/commands/fabric.d.ts.map +1 -1
- package/dist/compaction/claim-events.d.ts +61 -0
- package/dist/compaction/claim-events.d.ts.map +1 -0
- package/dist/compaction/claim-events.js +210 -0
- package/dist/compaction/claim-events.js.map +7 -0
- package/dist/compaction/claim.d.ts +51 -0
- package/dist/compaction/claim.d.ts.map +1 -0
- package/dist/compaction/hook.d.ts +28 -2
- package/dist/compaction/hook.d.ts.map +1 -1
- package/dist/compaction/hook.js +12 -7
- package/dist/compaction/owner.js +9 -8
- package/dist/compaction/trace-events.d.ts +1 -1
- package/dist/compaction/trace-events.d.ts.map +1 -1
- package/dist/components/configuration.js +6 -6
- package/dist/components/effect-scope.d.ts.map +1 -1
- package/dist/config.d.ts +40 -3
- package/dist/config.d.ts.map +1 -1
- package/dist/core/action-arguments.d.ts.map +1 -1
- package/dist/core/action-policy-hooks.d.ts +69 -0
- package/dist/core/action-policy-hooks.d.ts.map +1 -0
- package/dist/core/action-registry.d.ts +31 -10
- package/dist/core/action-registry.d.ts.map +1 -1
- package/dist/core/action-registry.js +12 -9
- package/dist/core/approval-controller.d.ts +23 -3
- package/dist/core/approval-controller.d.ts.map +1 -1
- package/dist/core/atomic-write.d.ts +164 -0
- package/dist/core/atomic-write.d.ts.map +1 -1
- package/dist/core/call-presentation.d.ts +14 -0
- package/dist/core/call-presentation.d.ts.map +1 -0
- package/dist/core/child-tool-allowlist.d.ts +17 -1
- package/dist/core/child-tool-allowlist.d.ts.map +1 -1
- package/dist/core/compact-controller.d.ts +34 -0
- package/dist/core/compact-controller.d.ts.map +1 -1
- package/dist/core/core-override-guidance.d.ts +3 -1
- package/dist/core/core-override-guidance.d.ts.map +1 -1
- package/dist/core/file-lock.d.ts.map +1 -1
- package/dist/core/foreground-tools.d.ts +4 -1
- package/dist/core/foreground-tools.d.ts.map +1 -1
- package/dist/core/host-policy.d.ts +43 -0
- package/dist/core/host-policy.d.ts.map +1 -0
- package/dist/core/host-sdk-runtime.d.ts.map +1 -1
- package/dist/core/host-sdk.d.ts.map +1 -1
- package/dist/core/host-sdk.js +1 -1
- package/dist/core/managed-host-guidance.d.ts +5 -0
- package/dist/core/managed-host-guidance.d.ts.map +1 -0
- package/dist/core/model-aliases.d.ts +22 -0
- package/dist/core/model-aliases.d.ts.map +1 -0
- package/dist/core/model-resolution.d.ts +41 -20
- package/dist/core/model-resolution.d.ts.map +1 -1
- package/dist/core/native-tool-result.d.ts +1 -0
- package/dist/core/native-tool-result.d.ts.map +1 -1
- package/dist/core/program-tasks.d.ts +52 -0
- package/dist/core/program-tasks.d.ts.map +1 -0
- package/dist/core/prompt-guidance.d.ts +5 -0
- package/dist/core/prompt-guidance.d.ts.map +1 -0
- package/dist/core/prompt-guidance.js +159 -0
- package/dist/core/prompt-guidance.js.map +7 -0
- package/dist/core/provider-operations.d.ts.map +1 -1
- package/dist/core/provider-operations.js +60 -108
- package/dist/core/provider-operations.js.map +3 -3
- package/dist/core/shell-inbox.d.ts.map +1 -1
- package/dist/core/shell-jobs.d.ts +7 -5
- package/dist/core/shell-jobs.d.ts.map +1 -1
- package/dist/core/shell-timing.d.ts.map +1 -1
- package/dist/core/skill-prompt.d.ts +1 -1
- package/dist/core/skill-prompt.d.ts.map +1 -1
- package/dist/core/skill-references.d.ts +1 -1
- package/dist/core/skill-references.d.ts.map +1 -1
- package/dist/core/system-guidance.d.ts.map +1 -1
- package/dist/core/tool-result-proxy.d.ts.map +1 -1
- package/dist/decisions/command.d.ts +2 -1
- package/dist/decisions/command.d.ts.map +1 -1
- package/dist/decisions/command.js +40 -12
- package/dist/decisions/command.js.map +2 -2
- package/dist/decisions/events.d.ts +12 -0
- package/dist/decisions/events.d.ts.map +1 -0
- package/dist/decisions/events.js +130 -0
- package/dist/decisions/events.js.map +7 -0
- package/dist/decisions/host.d.ts +31 -3
- package/dist/decisions/host.d.ts.map +1 -1
- package/dist/decisions/render.d.ts +44 -0
- package/dist/decisions/render.d.ts.map +1 -0
- package/dist/decisions/store.d.ts +8 -0
- package/dist/decisions/store.d.ts.map +1 -1
- package/dist/durable/agent.d.ts +8 -0
- package/dist/durable/agent.d.ts.map +1 -1
- package/dist/durable/extension-load-error.d.ts +8 -0
- package/dist/durable/extension-load-error.d.ts.map +1 -0
- package/dist/durable/session.d.ts +1 -0
- package/dist/durable/session.d.ts.map +1 -1
- package/dist/durable/worker-host.d.ts +10 -1
- package/dist/durable/worker-host.d.ts.map +1 -1
- package/dist/durable/worker-host.js +10 -1181
- package/dist/durable/worker-host.js.map +4 -4
- package/dist/durable/worker-options.d.ts +3 -0
- package/dist/durable/worker-options.d.ts.map +1 -1
- package/dist/durable/worker-role-seed.d.ts +82 -0
- package/dist/durable/worker-role-seed.d.ts.map +1 -0
- package/dist/durable/worker.js +43 -4
- package/dist/durable/worker.js.map +2 -2
- package/dist/durable-controls.d.ts.map +1 -1
- package/dist/durable-extension-wasm.d.ts +8 -0
- package/dist/durable-extension-wasm.d.ts.map +1 -0
- package/dist/durable-extension-wasm.js +32 -0
- package/dist/durable-extension-wasm.js.map +7 -0
- package/dist/durable-extension.d.ts +94 -0
- package/dist/durable-extension.d.ts.map +1 -0
- package/dist/durable-extension.js +649 -0
- package/dist/durable-extension.js.map +7 -0
- package/dist/durable-host.d.ts +8 -0
- package/dist/durable-host.d.ts.map +1 -0
- package/dist/durable-host.js +20 -0
- package/dist/durable-host.js.map +7 -0
- package/dist/durable-journal.d.ts +94 -0
- package/dist/durable-journal.d.ts.map +1 -0
- package/dist/durable.d.ts.map +1 -1
- package/dist/durable.js +13 -10
- package/dist/durable.js.map +2 -2
- package/dist/entropy/index.js +12 -10
- package/dist/entropy/pool-store.d.ts.map +1 -1
- package/dist/execution-service.d.ts +14 -0
- package/dist/execution-service.d.ts.map +1 -1
- package/dist/extension-bootstrap.d.ts.map +1 -1
- package/dist/extension-bootstrap.js +28 -27
- package/dist/extension-bootstrap.js.map +2 -2
- package/dist/extension-copy.d.ts +21 -0
- package/dist/extension-copy.d.ts.map +1 -0
- package/dist/extension-copy.js +90 -0
- package/dist/extension-copy.js.map +7 -0
- package/dist/extension.d.ts +1 -1
- package/dist/extension.d.ts.map +1 -1
- package/dist/fabric-exec-arguments.d.ts.map +1 -1
- package/dist/fabric-exec-tool.d.ts +2 -1
- package/dist/fabric-exec-tool.d.ts.map +1 -1
- package/dist/fabric-runtime-state.d.ts +19 -0
- package/dist/fabric-runtime-state.d.ts.map +1 -1
- package/dist/fabric-runtime-state.js +2205 -839
- package/dist/fabric-runtime-state.js.map +4 -4
- package/dist/fabric-state.d.ts +44 -1
- package/dist/fabric-state.d.ts.map +1 -1
- package/dist/feedback.d.ts +5 -0
- package/dist/feedback.d.ts.map +1 -0
- package/dist/index.d.ts +5 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +88 -53
- package/dist/index.js.map +2 -2
- package/dist/jev/client.js +2 -2
- package/dist/jev/manager.d.ts +3 -0
- package/dist/jev/manager.d.ts.map +1 -1
- package/dist/jev/observation.d.ts +1 -1
- package/dist/jev/observation.js +6 -6
- package/dist/jev-fabric/bridge.d.ts.map +1 -1
- package/dist/jev.js +11 -12
- package/dist/main-agent.d.ts +2 -1
- package/dist/main-agent.d.ts.map +1 -1
- package/dist/managed-host.d.ts +13 -0
- package/dist/managed-host.d.ts.map +1 -1
- package/dist/memory/digest.js +2 -2
- package/dist/memory/discovery.js +6 -7
- package/dist/memory/file-worker.js +10 -11
- package/dist/memory/file-worker.js.map +1 -1
- package/dist/memory/normalize.js +5 -6
- package/dist/memory/search.js +7 -8
- package/dist/memory/worker-provider.js +11 -12
- package/dist/memory.js +11 -12
- package/dist/memory.js.map +1 -1
- package/dist/mesh/grants.d.ts +3 -3
- package/dist/mesh/grants.d.ts.map +1 -1
- package/dist/mesh/store.d.ts +8 -0
- package/dist/mesh/store.d.ts.map +1 -1
- package/dist/native-codemode.d.ts.map +1 -1
- package/dist/native-tool-catalog.d.ts.map +1 -1
- package/dist/native-tool-catalog.js +12 -3
- package/dist/native-tool-catalog.js.map +2 -2
- package/dist/programs/host.d.ts +18 -6
- package/dist/programs/host.d.ts.map +1 -1
- package/dist/programs/host.js +71 -47
- package/dist/programs/host.js.map +2 -2
- package/dist/programs/source.d.ts +11 -0
- package/dist/programs/source.d.ts.map +1 -1
- package/dist/programs/store.d.ts.map +1 -1
- package/dist/protocol.d.ts +504 -8
- package/dist/protocol.d.ts.map +1 -1
- package/dist/protocol.js +41 -11
- package/dist/provider-globals.d.ts +13 -0
- package/dist/provider-globals.d.ts.map +1 -0
- package/dist/providers/agents-actions.d.ts.map +1 -1
- package/dist/providers/agents-provider.d.ts +3 -0
- package/dist/providers/agents-provider.d.ts.map +1 -1
- package/dist/providers/captured-tools-provider.d.ts +5 -0
- package/dist/providers/captured-tools-provider.d.ts.map +1 -1
- package/dist/providers/compact-provider.d.ts +4 -1
- package/dist/providers/compact-provider.d.ts.map +1 -1
- package/dist/providers/components-provider.d.ts.map +1 -1
- package/dist/providers/decisions-provider.d.ts +9 -1
- package/dist/providers/decisions-provider.d.ts.map +1 -1
- package/dist/providers/jev-provider.d.ts +1 -1
- package/dist/providers/jev-provider.js +11 -12
- package/dist/providers/memory-provider.js +10 -11
- package/dist/providers/pi-tools-provider.d.ts +14 -0
- package/dist/providers/pi-tools-provider.d.ts.map +1 -1
- package/dist/providers/programs-provider.d.ts.map +1 -1
- package/dist/providers/sessions-provider.d.ts +7 -0
- package/dist/providers/sessions-provider.d.ts.map +1 -1
- package/dist/repeat-guard.d.ts +7 -6
- package/dist/repeat-guard.d.ts.map +1 -1
- package/dist/residency/actor-client.js +3 -3
- package/dist/residency/client.d.ts +15 -0
- package/dist/residency/client.d.ts.map +1 -1
- package/dist/residency/host.d.ts.map +1 -1
- package/dist/residency/host.js +34 -23
- package/dist/residency/launcher.js +1 -1
- package/dist/residency/pi-entry.js +34 -23
- package/dist/residency/pi-entry.js.map +1 -1
- package/dist/residency/protocol.d.ts +2 -0
- package/dist/residency/protocol.d.ts.map +1 -1
- package/dist/runners.js +11 -1
- package/dist/runners.js.map +2 -2
- package/dist/runtime/core-override-guest-types.js +2 -2
- package/dist/runtime/cpython-child-source.d.ts.map +1 -1
- package/dist/runtime/cpython-runtime.d.ts.map +1 -1
- package/dist/runtime/cpython-runtime.js +51 -21
- package/dist/runtime/cpython-runtime.js.map +2 -2
- package/dist/runtime/deadline-pause.d.ts +2 -0
- package/dist/runtime/deadline-pause.d.ts.map +1 -1
- package/dist/runtime/dynamic-guest-types.d.ts.map +1 -1
- package/dist/runtime/dynamic-guest-types.js +2 -1
- package/dist/runtime/exec-journal.d.ts +73 -0
- package/dist/runtime/exec-journal.d.ts.map +1 -0
- package/dist/runtime/exec-journal.js +335 -0
- package/dist/runtime/exec-journal.js.map +7 -0
- package/dist/runtime/guest-types.d.ts +3 -2
- package/dist/runtime/guest-types.d.ts.map +1 -1
- package/dist/runtime/guest-types.js +1 -1
- package/dist/runtime/journal-shim.d.ts +3 -0
- package/dist/runtime/journal-shim.d.ts.map +1 -0
- package/dist/runtime/kernel.d.ts +95 -1
- package/dist/runtime/kernel.d.ts.map +1 -1
- package/dist/runtime/monty-bridge.d.ts +6 -2
- package/dist/runtime/monty-bridge.d.ts.map +1 -1
- package/dist/runtime/monty-runtime.d.ts.map +1 -1
- package/dist/runtime/monty-runtime.js +27 -15
- package/dist/runtime/monty-runtime.js.map +2 -2
- package/dist/runtime/native-codemode-guest.d.ts.map +1 -1
- package/dist/runtime/node-process-runtime.d.ts.map +1 -1
- package/dist/runtime/node-process-runtime.js +7 -5
- package/dist/runtime/quickjs-runtime.d.ts +7 -1
- package/dist/runtime/quickjs-runtime.d.ts.map +1 -1
- package/dist/runtime/quickjs-runtime.js +5 -4
- package/dist/runtime/sha256.d.ts +4 -0
- package/dist/runtime/sha256.d.ts.map +1 -0
- package/dist/runtime/transpile.d.ts +8 -0
- package/dist/runtime/transpile.d.ts.map +1 -0
- package/dist/runtime/type-checker.d.ts +1 -7
- package/dist/runtime/type-checker.d.ts.map +1 -1
- package/dist/runtime/type-checker.js +4 -2
- package/dist/runtime/typescript-kernel.js +13 -10
- package/dist/runtime/typescript-kernel.js.map +1 -1
- package/dist/runtime-state-builtins.d.ts.map +1 -1
- package/dist/speculation/scanner.js +1 -1
- package/dist/speculation/store.d.ts +7 -16
- package/dist/speculation/store.d.ts.map +1 -1
- package/dist/speculation/types.d.ts +1 -0
- package/dist/speculation/types.d.ts.map +1 -1
- package/dist/storage/retention.d.ts.map +1 -1
- package/dist/topology/participant-directory.d.ts +26 -1
- package/dist/topology/participant-directory.d.ts.map +1 -1
- package/dist/topology/peer-presence.d.ts.map +1 -1
- package/dist/topology/peer-settle.js +11 -0
- package/dist/topology/peer-settle.js.map +7 -0
- package/dist/topology/session-label-settings.d.ts +13 -0
- package/dist/topology/session-label-settings.d.ts.map +1 -0
- package/dist/topology/session-label.d.ts +60 -0
- package/dist/topology/session-label.d.ts.map +1 -0
- package/dist/topology/types.d.ts +27 -0
- package/dist/topology/types.d.ts.map +1 -1
- package/dist/type-error-guidance.js +1 -1
- package/dist/ui/controller.d.ts +1 -0
- package/dist/ui/controller.d.ts.map +1 -1
- package/dist/ui/conversation-chrome.d.ts.map +1 -1
- package/dist/ui/conversation-chrome.js +3 -2
- package/dist/ui/conversation-commands.d.ts +1 -1
- package/dist/ui/conversation-commands.d.ts.map +1 -1
- package/dist/ui/conversation-native-reader.js +2 -2
- package/dist/ui/conversation-selection.d.ts +4 -1
- package/dist/ui/conversation-selection.d.ts.map +1 -1
- package/dist/ui/conversation-targets.d.ts.map +1 -1
- package/dist/ui/conversation-targets.js +2 -2
- package/dist/ui/conversation.d.ts +25 -24
- package/dist/ui/conversation.d.ts.map +1 -1
- package/dist/ui/conversation.js +170 -339
- package/dist/ui/conversation.js.map +2 -2
- package/dist/ui/core-tool-render.d.ts +1 -0
- package/dist/ui/core-tool-render.d.ts.map +1 -1
- package/dist/ui/dashboard-model.d.ts.map +1 -1
- package/dist/ui/dashboard.d.ts.map +1 -1
- package/dist/ui/dashboard.js +23 -16
- package/dist/ui/dashboard.js.map +2 -2
- package/dist/ui/fabric-render.d.ts +7 -0
- package/dist/ui/fabric-render.d.ts.map +1 -1
- package/dist/ui/footer-dock.d.ts +48 -0
- package/dist/ui/footer-dock.d.ts.map +1 -0
- package/dist/ui/format.d.ts +7 -0
- package/dist/ui/format.d.ts.map +1 -1
- package/dist/ui/settings-sections-lifecycle.d.ts.map +1 -1
- package/dist/ui/settings-sections-presentation.d.ts.map +1 -1
- package/dist/ui/settings-values.d.ts +2 -1
- package/dist/ui/settings-values.d.ts.map +1 -1
- package/dist/ui/settings.js +60 -19
- package/dist/ui/settings.js.map +2 -2
- package/dist/ui/shell-hang-keys.d.ts +8 -1
- package/dist/ui/shell-hang-keys.d.ts.map +1 -1
- package/dist/ui/shell-tasks.d.ts +2 -2
- package/dist/ui/shell-tasks.d.ts.map +1 -1
- package/dist/ui/shell-tasks.js +27 -94
- package/dist/ui/shell-tasks.js.map +2 -2
- package/dist/ui/snapshot.d.ts.map +1 -1
- package/dist/ui/terminal-title.d.ts +41 -0
- package/dist/ui/terminal-title.d.ts.map +1 -0
- package/dist/ui/types.d.ts +4 -0
- package/dist/ui/types.d.ts.map +1 -1
- package/dist/ui/widget-keys.d.ts +5 -0
- package/dist/ui/widget-keys.d.ts.map +1 -0
- package/dist/ui/widget.d.ts +40 -18
- package/dist/ui/widget.d.ts.map +1 -1
- package/dist/ui/word-diff/line-emphasis.js +1603 -0
- package/dist/ui/word-diff/line-emphasis.js.map +7 -0
- package/dist/util.d.ts +2 -0
- package/dist/util.d.ts.map +1 -1
- package/dist/verified/authority.d.ts +2 -2
- package/dist/verified/authority.d.ts.map +1 -1
- package/dist/verified/budget.d.ts +4 -0
- package/dist/verified/budget.d.ts.map +1 -0
- package/dist/verified/generated/actor-name.d.ts +4 -0
- package/dist/verified/generated/actor-name.js +17 -0
- package/dist/verified/generated/authority.d.ts +4 -0
- package/dist/verified/generated/authority.js +28 -0
- package/dist/verified/generated/budget.d.ts +4 -0
- package/dist/verified/generated/budget.js +17 -0
- package/dist/verified/generated/compaction.d.ts +4 -0
- package/dist/verified/generated/compaction.js +19 -0
- package/dist/verified/generated/grants.d.ts +4 -0
- package/dist/verified/generated/grants.js +17 -0
- package/dist/verified/generated/lifecycle.d.ts +4 -0
- package/dist/verified/generated/lifecycle.js +50 -0
- package/dist/verified/generated/manifest.json +137 -48
- package/dist/verified/generated/policy.d.ts +17 -0
- package/dist/verified/generated/policy.js +211 -0
- package/dist/verified/generated/provider.d.ts +4 -0
- package/dist/verified/generated/provider.js +18 -0
- package/dist/verified/generated/resources.d.ts +6 -0
- package/dist/verified/generated/resources.js +73 -0
- package/dist/verified/generated/speculation.d.ts +6 -0
- package/dist/verified/generated/speculation.js +48 -0
- package/dist/verified/generated/storage.d.ts +4 -0
- package/dist/verified/generated/storage.js +18 -0
- package/dist/verified/grants.d.ts +22 -0
- package/dist/verified/grants.d.ts.map +1 -0
- package/dist/verified/lifecycle.d.ts +31 -0
- package/dist/verified/lifecycle.d.ts.map +1 -0
- package/dist/verified/machine.d.ts +18 -0
- package/dist/verified/machine.d.ts.map +1 -0
- package/dist/verified/memory.d.ts +1 -1
- package/dist/verified/memory.d.ts.map +1 -1
- package/dist/verified/nat.d.ts +1 -1
- package/dist/verified/nat.d.ts.map +1 -1
- package/dist/verified/policy.d.ts +17 -5
- package/dist/verified/policy.d.ts.map +1 -1
- package/dist/verified/provider.d.ts +22 -0
- package/dist/verified/provider.d.ts.map +1 -0
- package/dist/verified/resources.d.ts +21 -7
- package/dist/verified/resources.d.ts.map +1 -1
- package/dist/verified/speculation.d.ts +36 -0
- package/dist/verified/speculation.d.ts.map +1 -0
- package/dist/verified/storage.d.ts.map +1 -1
- package/dist/worker/missing-install.d.ts +8 -0
- package/dist/worker/missing-install.d.ts.map +1 -0
- package/dist/worker/options.d.ts.map +1 -1
- package/dist/worker/options.js +25 -0
- package/dist/worker/options.js.map +2 -2
- package/dist/worker/prompt-lifecycle.d.ts +16 -0
- package/dist/worker/prompt-lifecycle.d.ts.map +1 -0
- package/dist/worker/prompt-lifecycle.js +90 -0
- package/dist/worker/prompt-lifecycle.js.map +7 -0
- package/dist/worker/questions.d.ts +15 -3
- package/dist/worker/questions.d.ts.map +1 -1
- package/dist/worker/questions.js +53 -8
- package/dist/worker/questions.js.map +2 -2
- package/dist/worker/recovery-watchdog.d.ts +22 -0
- package/dist/worker/recovery-watchdog.d.ts.map +1 -1
- package/dist/worker/recovery-watchdog.js +116 -1
- package/dist/worker/recovery-watchdog.js.map +2 -2
- package/dist/worker/result.js +1 -1
- package/dist/worker/result.js.map +2 -2
- package/dist/worker.js +131 -21
- package/dist/worker.js.map +2 -2
- package/docs/actor-name-policy-handoff.md +5 -0
- package/docs/agents.md +172 -22
- package/docs/architecture.md +5 -1
- package/docs/audit-trace.md +2 -1
- package/docs/background-tasks.md +126 -28
- package/docs/codemode-parity.md +2 -2
- package/docs/compaction.md +21 -5
- package/docs/components.md +1 -1
- package/docs/configuration.md +113 -66
- package/docs/decisions.md +92 -10
- package/docs/durable-extension.md +121 -0
- package/docs/durable-pi.md +306 -6
- package/docs/extractive-history.md +3 -1
- package/docs/interface.md +22 -17
- package/docs/jev.md +2 -2
- package/docs/kernels.md +1 -1
- package/{node_modules/pi-coralbricks-provider/LICENSE → docs/licenses/gdp-wired-mit.txt} +1 -1
- package/docs/managed-host-migration.md +50 -0
- package/docs/programmatic-compaction.md +216 -6
- package/docs/programs.md +23 -1
- package/docs/prompt-cache.md +4 -2
- package/docs/provider-capabilities.md +15 -14
- package/docs/providers.md +99 -3
- package/docs/shell-composition.md +15 -0
- package/docs/short-lock-protocol.md +90 -0
- package/docs/skills.md +5 -1
- package/docs/speculation.md +6 -0
- package/docs/verified-kernels.md +309 -220
- package/package.json +45 -24
- package/proofs/actor-name.ts +27 -0
- package/proofs/authority.ts +62 -0
- package/proofs/budget.ts +24 -0
- package/proofs/compaction.ts +51 -0
- package/proofs/grants.ts +39 -0
- package/proofs/index.ts +40 -0
- package/proofs/kernel.ts +44 -0
- package/proofs/lifecycle.ts +128 -0
- package/proofs/policy.ts +195 -0
- package/proofs/provider.ts +52 -0
- package/proofs/resources.ts +160 -0
- package/proofs/speculation.ts +69 -0
- package/proofs/storage.ts +66 -0
- package/scripts/verified-kernels.ts +141 -0
- package/skillsets/python/fabric-council/SKILL.md +94 -20
- package/skillsets/python/fabric-exec/SKILL.md +2 -2
- package/skillsets/python/fabric-exec/references/agents.md +10 -4
- package/skillsets/python/fabric-fusion/SKILL.md +1 -1
- package/skillsets/python/fabric-guide/SKILL.md +1 -1
- package/skillsets/typescript/fabric-council/SKILL.md +110 -22
- package/skillsets/typescript/fabric-exec/SKILL.md +7 -7
- package/skillsets/typescript/fabric-exec/references/agents.md +17 -8
- package/skillsets/typescript/fabric-fusion/SKILL.md +1 -1
- package/skillsets/typescript/fabric-guide/SKILL.md +1 -1
- package/LAWS.bend +0 -502
- package/PROOF.bend +0 -452
- package/dist/chunks/chunk-3UGN25XS.js.map +0 -7
- package/dist/chunks/chunk-4EW7GVUR.js.map +0 -7
- package/dist/chunks/chunk-5UBRGTVN.js.map +0 -7
- package/dist/chunks/chunk-BN7F52EG.js +0 -525
- package/dist/chunks/chunk-BN7F52EG.js.map +0 -7
- package/dist/chunks/chunk-C7Z6F3SO.js.map +0 -7
- package/dist/chunks/chunk-DK35W6U7.js +0 -259
- package/dist/chunks/chunk-DK35W6U7.js.map +0 -7
- package/dist/chunks/chunk-EFETPXU2.js.map +0 -7
- package/dist/chunks/chunk-EHQQ4KCX.js.map +0 -7
- package/dist/chunks/chunk-EKODKR6Y.js.map +0 -7
- package/dist/chunks/chunk-FE6NOAO7.js.map +0 -7
- package/dist/chunks/chunk-FIDUHKMM.js.map +0 -7
- package/dist/chunks/chunk-FSB2VIRZ.js.map +0 -7
- package/dist/chunks/chunk-GIK2WNAK.js.map +0 -7
- package/dist/chunks/chunk-GO32KSEZ.js.map +0 -7
- package/dist/chunks/chunk-IR3PIHJM.js.map +0 -7
- package/dist/chunks/chunk-ITVLKXCI.js +0 -266
- package/dist/chunks/chunk-ITVLKXCI.js.map +0 -7
- package/dist/chunks/chunk-K7J2ABAZ.js.map +0 -7
- package/dist/chunks/chunk-KJZAOENY.js +0 -212
- package/dist/chunks/chunk-KJZAOENY.js.map +0 -7
- package/dist/chunks/chunk-LNASO4VT.js.map +0 -7
- package/dist/chunks/chunk-MLLYR3Y6.js.map +0 -7
- package/dist/chunks/chunk-P4KH4S4S.js.map +0 -7
- package/dist/chunks/chunk-PK4NIJEV.js.map +0 -7
- package/dist/chunks/chunk-Q2JQ3RYZ.js +0 -99
- package/dist/chunks/chunk-Q2JQ3RYZ.js.map +0 -7
- package/dist/chunks/chunk-R2XQ6AHT.js.map +0 -7
- package/dist/chunks/chunk-ROTCDDOV.js.map +0 -7
- package/dist/chunks/chunk-SPCJXN4K.js.map +0 -7
- package/dist/chunks/chunk-U366I5K2.js.map +0 -7
- package/dist/chunks/chunk-UKMQK5VP.js +0 -231
- package/dist/chunks/chunk-UKMQK5VP.js.map +0 -7
- package/dist/chunks/chunk-UOM37PE4.js.map +0 -7
- package/dist/chunks/chunk-UTOBAZ5T.js.map +0 -7
- package/dist/chunks/chunk-VSDUSNIA.js.map +0 -7
- package/dist/chunks/chunk-VTK2FEH7.js +0 -229
- package/dist/chunks/chunk-VTK2FEH7.js.map +0 -7
- package/dist/chunks/chunk-VYQV5JRT.js.map +0 -7
- package/dist/chunks/chunk-XCEEQ5AB.js.map +0 -7
- package/dist/chunks/chunk-ZLNJDTCN.js +0 -226
- package/dist/chunks/chunk-ZLNJDTCN.js.map +0 -7
- package/dist/chunks/chunk-ZQMBS5SH.js.map +0 -7
- package/dist/ui/conversation-shortcut.d.ts +0 -3
- package/dist/ui/conversation-shortcut.d.ts.map +0 -1
- package/dist/ui/widget-activity.d.ts +0 -21
- package/dist/ui/widget-activity.d.ts.map +0 -1
- package/dist/verified/generated/authority-kernel.d.ts +0 -10
- package/dist/verified/generated/authority-kernel.js +0 -127
- package/dist/verified/generated/kernel.d.ts +0 -31
- package/dist/verified/generated/kernel.js +0 -389
- package/dist/verified/generated/lifecycle-kernel.d.ts +0 -7
- package/dist/verified/generated/lifecycle-kernel.js +0 -164
- package/dist/verified/generated/provider-kernel.d.ts +0 -9
- package/dist/verified/generated/provider-kernel.js +0 -87
- package/dist/verified/generated/storage-kernel.d.ts +0 -11
- package/dist/verified/generated/storage-kernel.js +0 -107
- package/docs/licenses/bend-apache-2.0.txt +0 -202
- package/node_modules/pi-coralbricks-provider/README.md +0 -306
- package/node_modules/pi-coralbricks-provider/auth.ts +0 -30
- package/node_modules/pi-coralbricks-provider/custom-models.json +0 -1
- package/node_modules/pi-coralbricks-provider/deprecated-models.json +0 -1
- package/node_modules/pi-coralbricks-provider/guard.ts +0 -155
- package/node_modules/pi-coralbricks-provider/index.ts +0 -662
- package/node_modules/pi-coralbricks-provider/models.json +0 -88
- package/node_modules/pi-coralbricks-provider/package.json +0 -74
- package/node_modules/pi-coralbricks-provider/park.ts +0 -122
- package/node_modules/pi-coralbricks-provider/patch.json +0 -34
- package/node_modules/pi-coralbricks-provider/scripts/update-models.js +0 -658
- package/node_modules/pi-coralbricks-provider/settings.ts +0 -143
- package/node_modules/pi-coralbricks-provider/sync-policy.ts +0 -309
- package/proofs/abi.json +0 -308
- package/proofs/authority-abi.json +0 -7
- package/proofs/authority-kernel.bend +0 -23
- package/proofs/authority-proof.bend +0 -74
- package/proofs/authority-spec.bend +0 -30
- package/proofs/authority-state.bend +0 -43
- package/proofs/authority-types.d.ts +0 -3
- package/proofs/kernel.bend +0 -139
- package/proofs/lifecycle-abi.json +0 -3
- package/proofs/lifecycle-kernel.bend +0 -11
- package/proofs/lifecycle-proof.bend +0 -249
- package/proofs/lifecycle-spec.bend +0 -261
- package/proofs/lifecycle-types.d.ts +0 -4
- package/proofs/lifecycle.bend +0 -119
- package/proofs/provider-abi.json +0 -4
- package/proofs/provider-kernel.bend +0 -14
- package/proofs/provider-plans.bend +0 -28
- package/proofs/provider-spec.bend +0 -14
- package/proofs/provider-types.d.ts +0 -5
- package/proofs/resource-proof.bend +0 -633
- package/proofs/resource-spec.bend +0 -133
- package/proofs/resources.bend +0 -160
- package/proofs/state-kernel.bend +0 -17
- package/proofs/state-plans.bend +0 -40
- package/proofs/state-proof.bend +0 -42
- package/proofs/state-spec.bend +0 -26
- package/proofs/storage-abi.json +0 -3
- package/proofs/storage-kernel.bend +0 -11
- package/proofs/storage-plans.bend +0 -100
- package/proofs/storage-proof.bend +0 -176
- package/proofs/storage-spec.bend +0 -70
- package/proofs/storage-types.d.ts +0 -8
- package/proofs/types.d.ts +0 -7
- package/scripts/test-verified-kernels.mjs +0 -107
- package/scripts/verified-kernels.mjs +0 -176
- /package/dist/chunks/{chunk-ZEXCKK4K.js.map → chunk-4WKD3YM3.js.map} +0 -0
- /package/dist/chunks/{chunk-5XBYFSI5.js.map → chunk-7YNE4NB2.js.map} +0 -0
- /package/dist/chunks/{chunk-K6QXUGS5.js.map → chunk-BMAEZNZ5.js.map} +0 -0
- /package/dist/chunks/{chunk-CCHZXF6K.js.map → chunk-CXYJJ3HZ.js.map} +0 -0
- /package/dist/chunks/{chunk-TIIIHPHF.js.map → chunk-GS67KDMV.js.map} +0 -0
- /package/dist/chunks/{chunk-D5NYNIST.js.map → chunk-H57KPL3V.js.map} +0 -0
- /package/dist/chunks/{chunk-INRXG4J5.js.map → chunk-HGD75NZY.js.map} +0 -0
- /package/dist/chunks/{chunk-UXIBKMUM.js.map → chunk-KIFOEBYJ.js.map} +0 -0
- /package/dist/chunks/{chunk-3FJUP3GV.js.map → chunk-L6H46CPY.js.map} +0 -0
- /package/dist/chunks/{chunk-FUY6XVRX.js.map → chunk-MPMEK3IQ.js.map} +0 -0
- /package/dist/chunks/{chunk-HP5P7NBO.js.map → chunk-MSDL7U6Q.js.map} +0 -0
- /package/dist/chunks/{chunk-ASSLHWZS.js.map → chunk-MX53BRAC.js.map} +0 -0
- /package/dist/chunks/{chunk-QT4W5YVB.js.map → chunk-RAA3FAYZ.js.map} +0 -0
- /package/dist/chunks/{chunk-53N2I4QA.js.map → chunk-TXCNZCZP.js.map} +0 -0
- /package/dist/chunks/{chunk-LEU5CDSL.js.map → chunk-XFOSUGLU.js.map} +0 -0
package/docs/interface.md
CHANGED
|
@@ -10,37 +10,46 @@ Nested `pi.read`, `pi.bash`, `pi.powershell`, `pi.grep`, `pi.find`, `pi.ls`, `pi
|
|
|
10
10
|
|
|
11
11
|
Fabric keeps its orchestration-specific behavior around those previews. Multi-call rows stay compact, and live write composition with phase/call progress stays visible during the run. Agent and actor audits can expose their current child tools directly in the parent card, with owner, runner, and run metadata. One execution-wide throttle coalesces parallel nested-call updates before they reach Pi, and continuous streams are not starved. Long ANSI rows are bounded without clearing the enclosing tool background. The widget lease plus result-to-source row transfer keep completion height stable. The highlighter initializes lazily and falls back to plain text until it is ready. When Pi switches between its light and dark variants, the highlighter swaps themes live. Collapsed previews use the configured expand keybinding, for example `Ctrl-O`.
|
|
12
12
|
|
|
13
|
+
Successful internal `native.load` calls are hidden from ordinary tool rows and call totals, including partial updates, resumed cards, and dashboard summaries. Errors remain visible, and the raw audits and execution trace still record the calls. This is a presentation filter only: branch-local `load`/`store` behavior and commit ordering are unchanged. Built-in provider actions use scoped labels and bounded, allowlisted target metadata (for example `tasks.wait task-id`); stdin, credentials, arbitrary program input, and model state are not used as fallback labels.
|
|
14
|
+
|
|
15
|
+
## Terminal title
|
|
16
|
+
|
|
17
|
+
In an interactive session, the terminal window/tab title carries the declared `fabric_exec` display name: `record release evidence`, `Apply migration`, and so on. Nested call detail such as `read src/config.ts · typescript` never reaches the window; it stays in the transcript and the activity surface, where there is room for it.
|
|
18
|
+
|
|
19
|
+
The title is sticky. It holds after the program stops, parallel calls leave the newest declared name in place, and a resumed session adopts it again, because Fabric records the name as a session entry. Fabric re-adopts it whenever Pi applies its own title: on session start, on a branch switch, after a session rename, and after a settled turn. Pi's `app - session - cwd` shape is only seen before the first declared name in a session, or after `ui.terminalTitle` is turned off under `/fabric settings` → **UI**. Titles are plain text: styling and control characters are stripped, and the text is clipped to 120 characters, so a long name cannot wrap or repaint the terminal chrome. Headless and RPC hosts never receive one.
|
|
20
|
+
|
|
13
21
|
## Background shell tasks
|
|
14
22
|
|
|
15
|
-
|
|
23
|
+
The footer list keeps detached commands visible with their ID, purpose/command and elapsed time. Focus it with **↓** from an empty editor or `/fabric tasks`, then press **Enter** on a task to open its detail without interrupting Main. `/fabric tasks <id-or-unique-prefix>` opens the same detail directly. Arrows scroll its bounded output tail, **x twice** stops it, and **Esc** closes the detail and returns to the footer list. The detail shows cwd, PID, exit status, output path, elapsed time separately from time since last output, and monitor delivery/deadline. Completion hints last 30 seconds; retained jobs remain inspectable.
|
|
16
24
|
|
|
17
25
|
See [Background tasks and monitors](background-tasks.md) for completion delivery, task controls, opt-in UI-only versus agent-waking monitors, limits, and cancellation.
|
|
18
26
|
|
|
19
|
-
##
|
|
27
|
+
## Agent list
|
|
20
28
|
|
|
21
|
-
The
|
|
29
|
+
The Fabric widget sits at the bottom of the screen, below Pi's footer and a blank row, as in Claude Code. Its header is the main session's row: `● FAB-3` shows the session's [peer label](agents.md#peer-labels-and-queue-gates), followed by the current run's declared name and totals. A new session takes its label at its first Fabric use, so a session that has done nothing yet shows none. Without a label it reads `● Fabric`. A session with a label also shows it on the right of the editor's top border, in a badge like the one a conversation window shows for its target, whether or not the list is showing. While the list has no row to select, with no agent, actor worker, or shell task (idle actors have none), it takes no rows. The badge yields to Pi's own border text, such as a scroll indicator, and needs the list to be placed after the footer; otherwise the header row stays. Below it, running agents and actors are listed as a tree, above any background shell tasks, each child under its parent and indented by depth. Each row shows a circle, the participant's name, what it is doing, its model, tool calls, tokens, and elapsed time. What it is doing is the latest display name the agent declared for a `fabric_exec` call, which holds until it declares another; before that, the row shows the current tool or `thinking`. A finished row shows its result or error. The circle's colour is the status: accent while running, green when done, red on failure. Shell tasks list one per row after agents and actors, within the same row budget. Shell rows are selectable like agents: **Enter** or a click on a shell opens that task's detail with its output, status, and stop action. There is no secondary task-list overlay. **Esc** closes a task opened this way in one step, and focus returns to the list. Lines disclose progressively: when a line is too wide, its statistics drop first, then its title or activity is shortened, and its key hints go last. Pi gives extensions no slot below its footer, so Fabric registers an empty below-editor widget and places the list after the footer itself, in both the fullscreen and the regular renderer. Pi's footer and footers from other extensions stay as they are. In fullscreen mode, the list uses only the rows left after Pi's editor, other widgets (including Better OpenAI's status line), and footer, keeping at least one transcript row. It shrinks or temporarily disappears when those need the space, and returns when space is available. If Pi's layout is not the one Fabric expects, the list falls back to below the editor and stays last among the widgets other extensions place there. Press **↓** in an empty editor to move into the list; **ctrl+shift+e**, **`/fabric focus`**, or a click on a row also focuses it. The filled circle `●` marks the selected row, and **↑↓** or **j/k** moves it. **↑** on the top row returns to the editor. **Enter** or a click opens the participant's full conversation, where you can read its whole transcript, see its model and thinking level, and steer it or send a follow-up. Closing that view returns focus to the list. As in Claude Code, there is no inline preview: the conversation is where a participant's activity is shown. In Pi's fullscreen renderer, hovering the pointer over a row fills its circle too. Pi turns on hover tracking only outside tmux, zellij, and screen, and there is no event for leaving the widget, so the hover clears when the pointer crosses the header or the next key is pressed. **Esc** returns focus to the editor; while the list has focus, Esc does not halt background workers. Any other key returns focus to the editor and reaches it, so typing, Ctrl+C, and shortcuts keep working; only a click on a participant row takes focus. The list never grows past `ui.maxRows` on focus and remains bounded by half the terminal height and the space left in the fullscreen dock. Arrow keys and the mouse wheel over the list scroll within that viewport, keeping every participant and task reachable without moving the footer. When content overflows, a bottom cue row stays reserved across the whole scroll range: `↓ N more` appears there while children remain below, and the row is blank at the end. `↑ N more` appears in the main header when children are above the viewport. Very short viewports prioritize the header and a reachable child over the cue. Short or idle lists do not reserve a large empty area.
|
|
22
30
|
|
|
23
31
|
## Focused conversations
|
|
24
32
|
|
|
25
|
-
Press **
|
|
33
|
+
Press **Enter** on a row of the agent list, or run **`/fabric chat`**, to open a full-screen conversation without going through the dashboard. `/fabric chat <id-or-name>` opens a specific agent or actor; Tab completes exact participant IDs, including nested agents. Ambiguous names or ID prefixes are rejected; use an exact participant ID to select the intended target. In the dashboard, **Shift+C** opens the selected participant.
|
|
34
|
+
|
|
35
|
+
The first implicit open prefers a currently active child over stale history; later opens remember a valid selection. The view keeps a lossless native Pi transcript and a multiline Pi editor together, independently of the dashboard’s bounded transcript projection. It uses Pi’s real user, assistant, thinking, tool, skill, custom-message, and summary components, including registered tool renderers such as `fabric_exec`, with complete tool details and native expansion behavior. User backgrounds and editor rules span the terminal width, with Pi's configured output padding, editor padding, and code-block indentation inside them. Markdown and tool previews use the configured Shiki theme. A one-row gap belongs to the transcript's end, not the fixed input dock, so it scrolls away and leaves history unobstructed. While the selected participant is active, the native-style `Working` indicator stays in the editor border; the transcript uses a fallback only when that border is out of view. The directory/name footer row includes a compact `read-only` badge when needed; status, model, and thinking metadata are not repeated in a separate header. The footer below the editor shows the selected participant's directory, known branch, model, thinking level, and its current or last run's token, cache, and cost totals, tool calls, and elapsed time, for example `↑43k ↓2.2k R147k $0.122 · 12 calls · 3m04s · ?/272k ctx`. A running participant shows `Working` on the border, so the line names the status only once the run settles, such as `completed · …` or `failed · …`. Unknown usage and context occupancy are marked explicitly; Main's statistics are never substituted. A target badge sits on the upper-right editor border, replacing the standalone transcript breadcrumb. Like the main editor's label badge, it is filled with the border's own colour, which Pi sets from the thinking level, so it changes when the reasoning level does; its text is black or white, whichever has the higher contrast against that colour, and a border drawn without colour gets a plain label. It shows the target's own name, shortened on narrow terminals, and marks read-only targets; lineage lives in the agent list below the window. Native working and draft-scroll labels share the border without adding a row. Main and other participants keep running: opening, navigating, and closing the view never calls Pi's session-replacement API or starts another worker. Selecting Main restores the original Pi conversation, including its editor. Child drafts and scroll positions survive switching targets and reopening the view for the lifetime of this Pi session.
|
|
26
36
|
|
|
27
|
-
The
|
|
37
|
+
The same agent list sits at the bottom of the conversation window, below its footer, with the same key hints, so `↓ to manage` and `⏎ open · ↑↓ select · esc back` tell whether the keys go to the editor or to the list. The participant on screen keeps the filled circle, and the header row is Main. **↓** in an empty editor moves into the list, **Enter** or a click switches to the selected participant, selecting Main returns to the native session, and a shell row opens the tasks view over the window. **Esc** or **↑** on the top row returns to the editor. This list replaces the former target picker and its cycling and parent/child keys.
|
|
28
38
|
|
|
29
39
|
The transcript also follows Pi 1.0's fullscreen scrollbar setting (`auto`, `always`, or `hidden`), theme colors, hover/drag behavior, and auto-hide timing. Only an always-visible scrollbar reserves a transcript column; the editor and footer keep their full width. The thumb describes the loaded history window; existing wheel, page, and top commands continue to fetch older history. While scrolled away from the tail, or when newer history is not loaded, the native-style **↓ Jump to latest message · End** indicator appears at the transcript bottom. Its shortcut label follows Pi's configured binding. Click it or use the shortcut to load the latest history and resume following, without losing the draft or editor focus. Selection drags do not activate it.
|
|
30
40
|
|
|
31
41
|
The composer also uses Pi's native **up/down prompt history**, including configured `tui.editor.historyPrevious` / `tui.editor.historyNext` bindings. Up browses previous prompts from an empty editor or the start of its first visual line; multiline/wrapped arrows still move the cursor normally. Down returns toward newer prompts and restores the draft and cursor you had before browsing. Each target keeps its own newest 100 trimmed prompts, with consecutive duplicates suppressed, across switches and reopening. History is lazily seeded once from that target's currently loaded user text (direct actor envelopes are unwrapped), then remembers ordinary steering/follow-up submissions, parked follow-ups, and submitted slash commands (including failed attempts) in chronological order. Slash entries are ephemeral: they remain only in this target's bounded editor memory for the current Pi session, never in the agent transcript or sent to the model. History does not fetch additional pages or include shell commands, rejected read-only prose, assistant/tool output, or Main's history. Send attempts are remembered as in Pi; failures still preserve the draft. Pasted prompts are sent and recalled as full text, not paste markers. Completion lists retain arrow priority, and queue-row editing uses a separate history-free editor. Resetting the parent session clears local history.
|
|
32
42
|
|
|
33
|
-
Drag across transcript text to select it in either screen mode. Selection uses display-cell coordinates and keeps
|
|
43
|
+
Drag across transcript or footer text to select it in either screen mode. Double-click selects a word (including hyphenated model IDs and paths); triple-click selects a line. Participant model labels use the same `(provider) model • thinking` format as Main. Selection uses display-cell coordinates and keeps the selected text stable while output streams; it never selects hidden Main content. Releasing the mouse copies automatically when Pi's `fullscreenCopyOnSelect` setting is enabled (the default). Otherwise use the configured copy shortcut (`ctrl+shift+c` by default), `ctrl+c` with an active selection, or `/copy selection`. Escape clears selection first; a second Escape closes. Scrolling after release, resizing, switching targets, changing tool/thinking expansion, and `/latest` clear the selection. Dragging with the wheel can select across already loaded history; load older pages before starting a selection.
|
|
34
44
|
|
|
35
45
|
The preview has a small, local command allowlist with slash/Tab completion:
|
|
36
46
|
|
|
37
47
|
| Command | Preview action |
|
|
38
48
|
| --- | --- |
|
|
39
49
|
| `/copy` | Copy the selected participant's last assistant response as plain source text/Markdown, including for completed read-only runs. Thinking and tool results are excluded. If newer history is unloaded, use `/latest` first. |
|
|
40
|
-
| `/copy selection` | Copy selected transcript text, without terminal styling/control sequences. |
|
|
50
|
+
| `/copy selection` | Copy selected transcript or footer text, without terminal styling/control sequences. |
|
|
41
51
|
| `/latest` | Clear selection and follow the latest output. |
|
|
42
52
|
| `/help` | List preview commands. |
|
|
43
|
-
| `/agents` | Open the target picker. |
|
|
44
53
|
| `/back` | Return to Main. |
|
|
45
54
|
| `/stop` | Confirm stopping the selected live participant. |
|
|
46
55
|
|
|
@@ -53,18 +62,14 @@ Slash-command results use Pi's native-style conversation notifications: dim stat
|
|
|
53
62
|
| Enter | Send a steering message to the selected live participant |
|
|
54
63
|
| Follow-up key (Alt+Enter by default; Ctrl+Q on Windows) | Queue a follow-up for the selected participant |
|
|
55
64
|
| Shift+Enter | Insert a newline |
|
|
56
|
-
|
|
|
57
|
-
| Alt+Left / Alt+Right at an empty editor | Navigate to parent / first child |
|
|
58
|
-
| Ctrl+Tab / Ctrl+Shift+Tab | Cycle conversations |
|
|
65
|
+
| ↓ at an empty editor, then Enter | Switch to a participant from the agent list |
|
|
59
66
|
| Mouse wheel / configured Pi scroll keys | Scroll locally and fetch older history; prompt, line, and page jumps work in both TUI modes |
|
|
60
67
|
| End | Follow the latest output |
|
|
61
68
|
| Pi's tool-expand key (Ctrl+O by default) | Toggle tool details |
|
|
62
69
|
| `/stop` | Explicitly stop the selected participant after confirmation |
|
|
63
70
|
| Esc or `/back` | Return to Main without interrupting any agent |
|
|
64
71
|
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
Direct actor messages appear as normal user text, with paired RPC start/end events shown once. Session branches and compaction remain authoritative over overlapping RPC history. Native message errors remain visible. Use `/fabric log <id>` to inspect worker startup diagnostics. The widget advertises `ctrl+shift+a chat` only while an agent or actor is active, and removes the hint when work settles. The command and shortcut remain available for idle and historical conversations.
|
|
72
|
+
Direct actor messages appear as normal user text, with paired RPC start/end events shown once. Session branches and compaction remain authoritative over overlapping RPC history. Native message errors remain visible. Use `/fabric log <id>` to inspect worker startup diagnostics. `/fabric chat` remains available for idle and historical conversations.
|
|
68
73
|
|
|
69
74
|
Pending messages use Pi’s native labels and spacing. When a compatible loaded `pi-queue-steer` provides `queue-steer:conversation-queue:request:v1`, the view uses its actual per-target queue, execution-outline widget, and inline editor. A stopped actor’s Alt+Enter input is parked for editing or explicit Enter release. Accepted sends remain visible until native delivery is observed; they cannot be retracted or edited locally. Queues stay isolated from Main and other targets, survive preview close/reopen within the session, and are cleared on session reset. Older queue-extension releases without the bridge use the native display.
|
|
70
75
|
|
|
@@ -152,7 +157,7 @@ Fabric ships a general-purpose, theme-aware activity surface that works with any
|
|
|
152
157
|
- The graph renders status-coloured node shapes, orthogonal connectors, animated traffic, an optional fixed-width selected-node inspector, and directional off-canvas summaries. Traffic follows the same structural branches through the source/target lowest common ancestor. It never draws direct lines through unrelated subtrees. A large or deeply recursive graph opens around the attention-priority node. When you move between nodes, a damped spring camera retargets smoothly and the viewport does not snap. Live and replay animation drives renders only while the dashboard is open. Narrow terminals keep the centred graph and drop the inspector.
|
|
153
158
|
- Retained-run selection works as a lens over the same topology. Pressing `[` or `]` changes the highlighted run and its phase context, and live actors and remote project participants stay visible. Route records remain selectable, and they aggregate repeated traffic by source, target, topic, and kind. The recent event feed is a bounded live window. It does not replace audit history.
|
|
154
159
|
- **Inspection and control** work the same way in both views. Agent detail includes Markdown-rendered tasks and results, highlighted YAML values, model, current tool, usage, worktree, and attach metadata. Tool-call details show highlighted command, file, and edit inputs, with Markdown or YAML outputs. Persisted bash calls keep their command text. Space peeks at an agent or actor transcript. `t` toggles between summary and transcript detail. The initial bounded tail is paged directly from Pi RPC, Pi session, and Claude stream-JSON logs. At the loaded top, `k` or Up fetches one older page, `g` loads and jumps to the true beginning, and `G` jumps to the growing tail and resumes follow mode. Assistant text uses native Markdown. Tool calls retain structured arguments and results, so they get the same read, bash, search, edit, and write previews as the parent card. Credential and token redaction applies before rendering. You can steer Main and active one-shot agents or queue them a follow-up, and one-shot agents can also be stopped safely. Persistent actors accept `s` mailbox messages. Where configured, they expose model (`m`), thinking (`e`), the complete session-bound Pi host-event catalog (`v`), instructions (`i`), mailbox clearing (`c`), and export (`x`). Remote participants expose only their advertised capabilities. Control resolves their owner and reports success after acknowledgement. From Activity, global templates stay available for import (`p`), instruction editing (`i`), and deletion (`d`).
|
|
155
|
-
- `/fabric settings` opens an inline settings view that mirrors Pi core's `/settings`, with top and bottom borders, fuzzy search, and section submenus, and it writes changes to `fabric.json`. Trusted projects default to `<project>/.pi/fabric.json`. Pressing **Ctrl+G** anywhere in the view switches both the displayed configuration layer and the save destination between project and global `~/.pi/agent/fabric.json`. The global view keeps global edits visible even when a project override remains effective, and its scope banner states that precedence explicitly. Untrusted sessions stay global-only. In RPC hosts, the same hierarchy is exposed through recursive select/input dialogs; a root save-scope action replaces the Ctrl+G shortcut, while Back returns one section at a time. Full code mode, capture, executor, approvals, and UI changes apply immediately when they change the effective configuration. Mesh, agent, retention, and MCP changes persist and take effect on the next `/fabric reload`. The UI section includes **Tool display** (`full` by default or `compact`), a default-on **Agent tool preview** toggle, and a global **Update debounce** (`0`/Off through `1000ms`, default `100ms`); all apply immediately. Compact display makes the declared Fabric display name/description the card header, hides outer TypeScript at every expansion level, and retains bounded nested tool details. The Agents section selects the default runner, keeps independent Pi and runtime-enumerated Claude model pickers, and exposes free-text Veda backend, persona, and model fields for the Veda runner. List editors for `agents.defaultTools` and `capture.keepVisible` toggle known tools on and off. The `keepVisible` candidates include `fabric_exec` plus every captured extension tool; this legacy preference cannot override full-code or Schema enforce mode's sole `fabric_exec` model declaration on Pi 0.99.
|
|
160
|
+
- `/fabric settings` opens an inline settings view that mirrors Pi core's `/settings`, with top and bottom borders, fuzzy search, and section submenus, and it writes changes to `fabric.json`. Trusted projects default to `<project>/.pi/fabric.json`. Pressing **Ctrl+G** anywhere in the view switches both the displayed configuration layer and the save destination between project and global `~/.pi/agent/fabric.json`. The global view keeps global edits visible even when a project override remains effective, and its scope banner states that precedence explicitly. Untrusted sessions stay global-only. In RPC hosts, the same hierarchy is exposed through recursive select/input dialogs; a root save-scope action replaces the Ctrl+G shortcut, while Back returns one section at a time. Full code mode, capture, executor, approvals, and UI changes apply immediately when they change the effective configuration. Mesh, agent, retention, and MCP changes persist and take effect on the next `/fabric reload`. The UI section includes **Tool display** (`full` by default or `compact`), a default-on **Agent tool preview** toggle, and a global **Update debounce** (`0`/Off through `1000ms`, default `100ms`); all apply immediately. Compact display makes the declared Fabric display name/description the card header, hides outer TypeScript at every expansion level, and retains bounded nested tool details. The Agents section selects the default runner, keeps independent Pi and runtime-enumerated Claude model pickers, and exposes free-text Veda backend, persona, and model fields for the Veda runner. List editors for `agents.defaultTools` and `capture.keepVisible` toggle known tools on and off. The `keepVisible` candidates include `fabric_exec` plus every captured extension tool; this legacy preference cannot override full-code or Schema enforce mode's sole `fabric_exec` model declaration on Pi 0.99, so in those modes the row reads `(no effect)` and points to `foreground.tools`.
|
|
156
161
|
|
|
157
162
|
### Keybindings
|
|
158
163
|
|
|
@@ -214,7 +219,7 @@ async invoke(actionName, args, context) {
|
|
|
214
219
|
/fabric run <ref> [json input]
|
|
215
220
|
```
|
|
216
221
|
|
|
217
|
-
`/fabric decisions` lists open [durable decisions](decisions.md) and answers the picked one through native dialogs.
|
|
222
|
+
`/fabric decisions` lists open [durable decisions](decisions.md) and answers or cancels the picked one through native dialogs.
|
|
218
223
|
|
|
219
224
|
`/fabric programs` lists [saved programs](programs.md) with their status; `promote` and `retire` are the only way to change one. `/fabric run` executes a saved program without the model, with the same approval policy as a model call, and shows the result in the transcript.
|
|
220
225
|
|
|
@@ -229,4 +234,4 @@ git diff | pi -p --no-session -t read,grep "Review this diff for concrete defect
|
|
|
229
234
|
pi -p --no-session --mode json -e <path-to-pi-fabric> "Map the persistence layer."
|
|
230
235
|
```
|
|
231
236
|
|
|
232
|
-
`--no-session` keeps the run ephemeral. `-t` restricts the tool allowlist. `--mode json` emits a structured event stream for scripting through `| jq`. `-e <pi-fabric>` loads Fabric so the agent can use `fabric_exec`. The process exits non-zero on failure. Run `pi --help` for the full flag list.
|
|
237
|
+
`--no-session` keeps the run ephemeral. `-t` restricts the tool allowlist. `--mode json` emits a structured event stream for scripting through `| jq`. `-e <pi-fabric>` loads Fabric so the agent can use `fabric_exec`. If your settings also install Fabric, the `-e` copy wins and the settings copy stays inactive. The process exits non-zero on failure. Run `pi --help` for the full flag list.
|
package/docs/jev.md
CHANGED
|
@@ -171,7 +171,7 @@ Use named Fabric payloads when large code strings are awkward to quote. In a Jev
|
|
|
171
171
|
- `program.emit(value)` records a bounded progress event.
|
|
172
172
|
- With `observe` on spawn, `program.nextEvent()` waits for Main lifecycle events without polling.
|
|
173
173
|
- `program.advise({eventId,message})` supplies the run ID to the policy-checked `jev.advise` action; declare that exact capability and opt into delivery.
|
|
174
|
-
- `tools.call({ ref, args })` and ordinary Fabric provider proxies call only exact `requires` refs. Discovery is not a way to acquire additional authority.
|
|
174
|
+
- `tools.call({ ref, args })` and ordinary Fabric provider proxies call only exact `requires` refs. Discovery is not a way to acquire additional authority. A provider another extension registers is a typed global, such as `app.control(args)`, only when `requires` names one of its actions; see [program globals](providers.md#program-globals-and-types).
|
|
175
175
|
- The same QuickJS context persists for the whole run: local variables and data structures survive every iteration. No host imports, `process`, or direct `fetch` are available.
|
|
176
176
|
|
|
177
177
|
A reactive controller can use `while (true)` with these primitives. Observe fresh state, construct questions/candidate IDs, evaluate, verify applicability, act, and observe again. Revalidate target IDs/revisions before applying a decision. Define a no-match or escalation path. There is no mandatory model-generated planning step in the loop and no built-in 10 Hz guarantee: end-to-end rate includes observation, inference, and action latency.
|
|
@@ -330,7 +330,7 @@ return {id:observer.id, state:observer.state};
|
|
|
330
330
|
|
|
331
331
|
### Delivery, freshness, and interruption
|
|
332
332
|
|
|
333
|
-
Delivery defaults to off. Opt into `"steer"` or `"followUp"
|
|
333
|
+
Delivery defaults to off. Opt into `"steer"` or legacy `"followUp"` (both deliver Main feedback as hidden steering); `triggerTurn` defaults to false and never wakes idle Main when false. UI hosts show a bounded notification naming the advisor instead of a chat bubble. The full advice remains in model context and session audit, with actual and requested delivery modes. `maxAdvice` bounds delivery attempts for the run (feedback/stale suppression does not consume a delivery attempt) (1–16, default 4). Advice must be sent before requesting the next event; it needs the last consumed event ID and must still match the latest completed-turn/task/context revision and age limit. A next turn may be in flight; a newer completed turn, real input, compaction, or cancellation invalidates old advice. The check is at enqueue time, not a guarantee that context cannot change before Main consumes a queued message.
|
|
334
334
|
|
|
335
335
|
There is at most **one delivery attempt across all Jev observers per external user input**. Automatic continuations and extension-injected input do not reset this feedback latch. Duplicate, stale, disabled, over-budget, feedback-gated, or failed deliveries return `{delivered:false,reason}`; failures are not replayed. This prevents an advisor from repeatedly waking/steering Main based on its own intervention. Additional turns may still be classified and recorded within budget. Broader separately granted tools retain their own authority; these safeguards specifically govern `jev.advise`.
|
|
336
336
|
|
package/docs/kernels.md
CHANGED
|
@@ -130,7 +130,7 @@ return {"output": r["output"], "chars": len(text)}
|
|
|
130
130
|
|
|
131
131
|
### Shared host bridge, not TypeScript syntax
|
|
132
132
|
|
|
133
|
-
Python uses the same host action namespaces: `tools`, `mcp`, `memory`, `state`, `schema`, `compact`, `agents`, `mesh
|
|
133
|
+
Python uses the same host action namespaces: `tools`, `mcp`, `memory`, `state`, `schema`, `compact`, `agents`, and `mesh`. A provider another extension registers is a global named after it, for example `await context.task_add(title="x")`; see [program globals](providers.md#program-globals-and-types). Full code mode also exposes `pi` and `extensions`; schema enforce uses the full-code bridge. Known actions use direct async calls, while computed refs use `tools.call`:
|
|
134
134
|
|
|
135
135
|
```python
|
|
136
136
|
hits = await tools.search({"query": "deployment status", "limit": 3})
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# Managed-host migration: 0.119.7 → 0.127.1
|
|
2
|
+
|
|
3
|
+
## 0.127.1 follow-up
|
|
4
|
+
|
|
5
|
+
The factory contract remains **v2** and provider registration remains v1. No option changes or downstream workarounds are needed.
|
|
6
|
+
|
|
7
|
+
- Native discovery previews retain field descriptions, including usage rules such as page numbering and identifier provenance.
|
|
8
|
+
- Preview limits apply to rendered declarations. Long description text is shortened first, then dropped before structural information is sacrificed. Oversized enums, unions and tuples are cut by rendered size; short 13–40-value contracts remain complete when they fit.
|
|
9
|
+
- Deeper structural cuts and whole-input fallback remain last resorts. Every lossy preview carries a visible marker and points to `fabric.tools.describe({ ref })` for the exact unmodified `inputSchema`.
|
|
10
|
+
- Public factory declarations explicitly use the embedding application's peer SDK, not Fabric's private worker SDK alias, so older supported hosts can type-check the integration.
|
|
11
|
+
- Managed execution guidance appears once through its guidance slot. Host `guidance` appears once in the system prompt. Tool and `code` descriptions are concise, and `promptGuidelines` contains only independent execution advice. Stable guidance remains byte-identical across turns.
|
|
12
|
+
|
|
13
|
+
The host should continue to use the v2 options documented below. Applications should not interpret a visibly truncated preview as the authoritative validation schema.
|
|
14
|
+
|
|
15
|
+
## 0.127.0 changelog
|
|
16
|
+
|
|
17
|
+
The managed-host factory contract is **v2** (`FABRIC_MANAGED_HOST_VERSION === 2`). Provider registration is still v1. Existing `{ providers }` calls work; consumers that assert the factory version must update their assertion. This release adds optional foreground, guidance, skill-reader, CPU and compaction controls without enabling ambient configuration.
|
|
18
|
+
|
|
19
|
+
### Replacement map for downstream patch hunks
|
|
20
|
+
|
|
21
|
+
| Hunk | Upstream replacement |
|
|
22
|
+
| --- | --- |
|
|
23
|
+
| A1 - stale script store after tool receipts | Automatic: later non-store custom entries are allowed on the same branch; aborts, session/generation changes, messages, compaction, navigation and either store writer still invalidate the transaction. |
|
|
24
|
+
| A2 - truncated enum/union/tuple declarations | Automatic: bounded, visibly marked previews. Fetch exact `inputSchema` with `fabric.tools.describe({ ref })`; native `describeTool` returns a bounded declaration, not the raw schema. |
|
|
25
|
+
| A3 - nested validation paths | Automatic: prefer TypeBox `instancePath`, falling back to `path`. |
|
|
26
|
+
| A4 - exact tool discovery | Automatic: trimmed exact name/raw name/ref/final `__` segment takes precedence within the requested namespace. |
|
|
27
|
+
| A5 - Jev in managed mode | Automatic: managed configuration disables Jev. |
|
|
28
|
+
| B1 - direct foreground tools | `managedHost.foreground: ["ask_user_questions", "ai_todo_write", "run_delegated_task"]`; register and activate those names. |
|
|
29
|
+
| B2 - provider-accurate tool and prompt text | Automatic managed metadata; put application policy in `managedHost.guidance` or the existing execution-guidance slot. |
|
|
30
|
+
| B3 - skill reader | `managedHost.skillReader: "mcp.files.read"` (use the host's real callable name), or omit and own skill loading entirely. |
|
|
31
|
+
| B4 - MCP-only native discovery | Automatic MCP fallback when Pi/extension discovery has no actions. |
|
|
32
|
+
| B5 - uninterrupted guest CPU | Managed default is 1000 ms; explicitly use `managedHost.executor: { maxCpuSliceMs: 1000 }`. Ordinary sessions can set `executor.maxCpuSliceMs` (`0` disables it). |
|
|
33
|
+
| B6 - host-owned compaction | `managedHost.compaction: "pi"`; omitted retains `"fabric"`. |
|
|
34
|
+
|
|
35
|
+
Deliberately not upstreamed: application-specific counting, scope-completion and receipt-reconciliation prose; it belongs in host guidance. The undeclared external schema renderer and 64 KiB per-tool expansion are also not carried forward: Fabric keeps compact previews and exact schema discovery, without a new dependency. Auto-promoting every `model-only` registration is not required: the explicit host foreground list avoids accidentally exposing unrelated tools.
|
|
36
|
+
|
|
37
|
+
## Compatibility since 0.119.7
|
|
38
|
+
|
|
39
|
+
The public minimum remains Pi 1.0.0. Development and standard public-contract tests use Pi 1.3.0. A separate offline CLI smoke check passed with `pi-coding-agent`, `pi-agent-core`, `pi-ai` and `pi-codemode` all pinned to **1.0.2**, using the compiled bundle: v2 registration, a model-only foreground tool, MCP-only native discovery, visibly truncated declarations, all 20 raw enum values, a valid value past the preview cut, receipt-safe store/load across two scripts, and clean `agent_settled` with host-owned compaction. This is a focused compatibility check, not a claim that the entire test suite runs against 1.0.2. Fabric does **not** import the standalone `pi-codemode` package; its presence in an embedding application is independent.
|
|
40
|
+
|
|
41
|
+
Relevant intervening changes:
|
|
42
|
+
|
|
43
|
+
- Host SDK loading now resolves from the running Pi CLI or embedding entry, including mapped/compiled hosts. Managed installs need not place a second host SDK beside Fabric.
|
|
44
|
+
- External provider registration now contributes direct guest globals and schema-derived types; host provider names still pass closed-world authorization.
|
|
45
|
+
- Program-run events accept caller-supplied code. They execute in the current host's root capability view and policy; they do not widen managed provider authority.
|
|
46
|
+
- Interrupted read-only durable execution can rerun once in supported durable environments. Managed mode still does not enable native workers or agents.
|
|
47
|
+
- Child roster filtering and exact child-question names changed for native agents. Those facilities remain disabled in managed mode unless supplied by a host provider.
|
|
48
|
+
- Terminal-title, agent-panel, shell warming and background optimization work do not enable those native facilities in managed mode.
|
|
49
|
+
|
|
50
|
+
New deliberate changes in this release: the managed default CPU slice is bounded; Jev is disabled as documented; managed prompts no longer advertise unloaded coding providers or automatically contribute Fabric's coding skill tree. Host code should register desired skill resources itself. Native catalog declarations remain advisory, visibly incomplete when bounded; dispatch validates against the full schema.
|
|
@@ -60,22 +60,27 @@ await compact.request({
|
|
|
60
60
|
instructions: "Keep the failing test name and the file map; drop the rest.",
|
|
61
61
|
preserve: ["Auth regression is still open", "tests/auth.test.ts"], // optional
|
|
62
62
|
requestedBy: "model", // optional, default "model"
|
|
63
|
+
seed: "Start phase 2: wire the API", // optional, queued after the commit as a labelled Fabric message
|
|
63
64
|
});
|
|
64
65
|
|
|
65
66
|
// Read the pending intent and the last committed/failed compaction info.
|
|
66
67
|
const status = await compact.status();
|
|
67
|
-
// { pending?: { reason?, instructions?, preserve?, requestedBy, requestedAt },
|
|
68
|
+
// { pending?: { reason?, instructions?, preserve?, seed?, requestedBy, requestedAt },
|
|
68
69
|
// last?: { at, requestedBy, status: "committed"|"cancelled"|"failed",
|
|
69
|
-
// summary?, tokensBefore?, estimatedTokensAfter?, error? },
|
|
70
|
+
// summary?, tokensBefore?, estimatedTokensAfter?, error?, seeded? },
|
|
70
71
|
// lastAuto?: { at, trigger: "headroom"|"tokens"|"ratio", committed },
|
|
71
72
|
// owner: "fabric"|"pi"|"external"|"none",
|
|
72
|
-
// outputReserveTokens
|
|
73
|
+
// outputReserveTokens,
|
|
74
|
+
// claim?: { name, version, branchSummary, actions }, // under a claim
|
|
75
|
+
// ownerStatus? } // owner's own report
|
|
73
76
|
|
|
74
77
|
// Read context pressure. Never compacts; the program decides what to do.
|
|
75
78
|
const pressure = await compact.pressure();
|
|
76
79
|
// { tokens, contextWindow, fraction, headroomTokens,
|
|
77
80
|
// band: "ok"|"warn"|"urgent"|"unknown", outputReserveTokens,
|
|
78
|
-
// thresholdFraction?, thresholdTokens?, owner
|
|
81
|
+
// thresholdFraction?, thresholdTokens?, owner,
|
|
82
|
+
// claim?: { name, version }, // under a claim
|
|
83
|
+
// ownerPressure?: { stage, thresholds? } } // owner's ladder
|
|
79
84
|
|
|
80
85
|
// Keep a bounded focus list in every Fabric summary until it is cleared.
|
|
81
86
|
await compact.carry({ add: ["Auth regression is still open"] });
|
|
@@ -121,8 +126,32 @@ restart, and tree navigation restore it without extra state, and a branch
|
|
|
121
126
|
keeps its own list. A malformed latest entry reads as an empty list. Custom
|
|
122
127
|
entries never enter the model context. The rendered block is bounded to
|
|
123
128
|
3 KiB like the request block; compaction details record
|
|
124
|
-
`carry: { count, renderedOmittedBytes }`. With `compaction.engine: "pi"
|
|
125
|
-
|
|
129
|
+
`carry: { count, renderedOmittedBytes }`. With `compaction.engine: "pi"`, or
|
|
130
|
+
when an extension wins compaction by load order without a claim, the list is
|
|
131
|
+
stored but not rendered. Under a [compaction owner claim](#compaction-owner-claim)
|
|
132
|
+
the list belongs to the owner and Fabric stores nothing.
|
|
133
|
+
|
|
134
|
+
##### Carry update contract
|
|
135
|
+
|
|
136
|
+
Fabric applies one `compact.carry` call to the current list in this order.
|
|
137
|
+
A claim owner that takes `carry` applies the same rules to its own list, so
|
|
138
|
+
the call means the same thing either way.
|
|
139
|
+
|
|
140
|
+
1. Fabric validates the call first. It accepts only `items`, `add`, and
|
|
141
|
+
`remove` (arrays of at most 16 strings of 1 to 2048 characters) and
|
|
142
|
+
`clear` (a boolean).
|
|
143
|
+
2. A call without `items`, `add`, `remove`, or `clear: true` reads the
|
|
144
|
+
list and changes nothing.
|
|
145
|
+
3. `clear: true` starts from an empty list; otherwise the update starts from
|
|
146
|
+
the current list.
|
|
147
|
+
4. `items` replaces the list.
|
|
148
|
+
5. `remove` drops every item exactly equal to one of its strings.
|
|
149
|
+
6. `add` appends, in order, each item that is not already present.
|
|
150
|
+
7. Duplicates are dropped; the first occurrence stays.
|
|
151
|
+
8. The result must hold at most 16 items, each not blank and at most 2048
|
|
152
|
+
characters and 2048 UTF-8 bytes. Otherwise the whole call is rejected
|
|
153
|
+
and the list is unchanged.
|
|
154
|
+
9. Fabric writes no entry when the result equals the current list.
|
|
126
155
|
|
|
127
156
|
With only `instructions` present, Fabric forwards it as ordinary Pi
|
|
128
157
|
`customInstructions`. Manual `/compact` text and programmatic requests then
|
|
@@ -190,7 +219,186 @@ not an automatically inferred conversational objective.
|
|
|
190
219
|
- On any other error, Fabric clears the intent and `last` records
|
|
191
220
|
`status: "failed"` with the message. A synchronous throw from `compact()`
|
|
192
221
|
itself follows the same failure path.
|
|
222
|
+
- A `seed` (at most 8192 characters, not blank) is sent only after
|
|
223
|
+
`onComplete`. Fabric sends it as a labelled custom message, never as a
|
|
224
|
+
user message, because the compaction removes the context that showed a
|
|
225
|
+
program wrote it:
|
|
226
|
+
|
|
227
|
+
```ts
|
|
228
|
+
pi.sendMessage({
|
|
229
|
+
customType: "fabric-compaction-seed",
|
|
230
|
+
content: "A Fabric program requested this continuation when it compacted the context. It is not a message from the user.\n"
|
|
231
|
+
+ `<fabric-compaction-seed>\n${escaped}\n</fabric-compaction-seed>`,
|
|
232
|
+
display: true,
|
|
233
|
+
details: { version: 1 },
|
|
234
|
+
}, { triggerTurn: true, deliverAs: "followUp" });
|
|
235
|
+
```
|
|
236
|
+
|
|
237
|
+
Pi gives the model a custom message as user-role text without its type or
|
|
238
|
+
details, so the first line carries the origin. Fabric escapes `&`, `<`,
|
|
239
|
+
and `>` in the seed, so it cannot close the wrapper, and no slash command
|
|
240
|
+
or template expands. The seed is queued after the compaction commits; a
|
|
241
|
+
prompt submitted during the compaction runs first. Pi defers a
|
|
242
|
+
turn-starting message sent during `agent_settled` until the settle
|
|
243
|
+
finishes, then runs deferred prompts and messages in submission order.
|
|
244
|
+
`last.seeded` is `true` once Fabric handed the seed to Pi. A cancelled
|
|
245
|
+
or failed commit never sends it. The seed applies to Fabric's own
|
|
246
|
+
controller whatever summarizer runs, including `compaction.engine: "pi"`.
|
|
247
|
+
Under a claim the owner receives the seed instead and sends it the same
|
|
248
|
+
way (see below).
|
|
249
|
+
|
|
250
|
+
### Compaction owner claim
|
|
251
|
+
|
|
252
|
+
Another extension can take compaction from Fabric without
|
|
253
|
+
`compaction.engine: "pi"`, which would also hand `/tree` summaries to Pi.
|
|
254
|
+
The owner emits `pi-fabric:compaction-owner:v1`
|
|
255
|
+
(`FABRIC_COMPACTION_OWNER_EVENT` in `pi-fabric/protocol`) from its
|
|
256
|
+
`session_start` handler or later:
|
|
193
257
|
|
|
258
|
+
```ts
|
|
259
|
+
import {
|
|
260
|
+
FABRIC_COMPACTION_OWNER_EVENT,
|
|
261
|
+
type FabricCompactionOwnerClaimV1,
|
|
262
|
+
type FabricCompactionOwnerHandleV1,
|
|
263
|
+
} from "pi-fabric/protocol";
|
|
264
|
+
|
|
265
|
+
let claim: FabricCompactionOwnerHandleV1 | undefined;
|
|
266
|
+
const lifetime = new AbortController();
|
|
267
|
+
pi.on("session_start", (_event, ctx) => {
|
|
268
|
+
// Fabric may answer after emit returns, so wait for the reply with a timeout.
|
|
269
|
+
const giveUp = setTimeout(() => lifetime.abort(), 5_000); // no reply: Fabric is not loaded
|
|
270
|
+
pi.events.emit(FABRIC_COMPACTION_OWNER_EVENT, {
|
|
271
|
+
version: 1,
|
|
272
|
+
type: "claim",
|
|
273
|
+
owner: { name: "example-owner", version: "1.4.0" },
|
|
274
|
+
actions: {
|
|
275
|
+
request: { fields: ["instructions", "preserve", "seed"], handler: (request, { signal }) => focus(request, signal) },
|
|
276
|
+
carry: { fields: ["items", "add", "remove", "clear"], handler: (update) => ({ items: carry(update) }) },
|
|
277
|
+
status: { handler: () => ({ stage: ladder.stage }) },
|
|
278
|
+
pressure: { handler: () => ({ stage: ladder.stage, thresholds: { fold: 0.7, compact: 0.9 } }) },
|
|
279
|
+
cancel: { handler: () => cancelPending() },
|
|
280
|
+
},
|
|
281
|
+
// branchSummary: true, // also take /tree summaries
|
|
282
|
+
signal: lifetime.signal,
|
|
283
|
+
reply: (result) => {
|
|
284
|
+
clearTimeout(giveUp);
|
|
285
|
+
if (!result.ok) {
|
|
286
|
+
ctx.ui.notify(result.error, "warning");
|
|
287
|
+
return;
|
|
288
|
+
}
|
|
289
|
+
if (lifetime.signal.aborted) {
|
|
290
|
+
result.handle.withdraw(); // granted after the claimant gave up
|
|
291
|
+
return;
|
|
292
|
+
}
|
|
293
|
+
claim = result.handle;
|
|
294
|
+
if (result.carry) adoptCarry(result.carry); // Fabric's list at cut-over
|
|
295
|
+
},
|
|
296
|
+
} satisfies FabricCompactionOwnerClaimV1);
|
|
297
|
+
});
|
|
298
|
+
```
|
|
299
|
+
|
|
300
|
+
The first message loads Fabric's claim code, so `reply` is called once, after
|
|
301
|
+
`emit` returns (a Fabric that answers during `emit` is also valid; accept
|
|
302
|
+
both). If it never comes, Fabric is not loaded: abort the claim's `signal` and
|
|
303
|
+
carry on without it. If `{ ok: true }` arrives after you gave up, call
|
|
304
|
+
`handle.withdraw()`. Fabric refuses a claim whose `signal` is already aborted
|
|
305
|
+
when it handles it. It handles messages in the order they were emitted and reads
|
|
306
|
+
each field when it handles the message, so do not change the message after
|
|
307
|
+
emitting it. A message still queued at Fabric's `session_shutdown` is refused:
|
|
308
|
+
a claim gets `{ ok: false, error }` saying Fabric is shutting down. If the
|
|
309
|
+
claim code fails to load, the reply is `{ ok: false, error }` naming the failure.
|
|
310
|
+
|
|
311
|
+
A successful reply is `{ ok: true, handle, carry? }`. `carry` is a frozen
|
|
312
|
+
copy of Fabric's carry-forward items when the claim was made: the list the
|
|
313
|
+
owner takes over, because `compact.carry` now goes to the owner. It is
|
|
314
|
+
absent when Fabric has not started the session yet, which happens when the
|
|
315
|
+
owner's `session_start` handler runs before Fabric's. The owner then reads
|
|
316
|
+
the latest `pi-fabric-compact-carry` custom entry on the branch itself
|
|
317
|
+
(`data: { version: 1, items }`).
|
|
318
|
+
|
|
319
|
+
While the claim is held:
|
|
320
|
+
|
|
321
|
+
- Fabric's `session_before_compact` handler returns nothing, before its
|
|
322
|
+
threshold deferral. Fabric produces no summary and never cancels the
|
|
323
|
+
owner's compaction. The owner's own `session_before_compact` handler
|
|
324
|
+
decides; when it returns nothing, Pi's summarizer runs.
|
|
325
|
+
- Fabric's settled-boundary threshold and headroom trigger stay off.
|
|
326
|
+
- `/tree` summaries stay with Fabric's configured engine unless the claim
|
|
327
|
+
sets `branchSummary: true`.
|
|
328
|
+
- `compact.request`, `compact.carry`, and `compact.cancel` go to the owner.
|
|
329
|
+
Fabric validates arguments as usual, then passes a fresh copy holding only
|
|
330
|
+
the fields the owner declared. An undeclared action or field fails with an
|
|
331
|
+
error naming the owner (`compaction owner example-owner@1.4.0: ...`),
|
|
332
|
+
and nothing is recorded, stored, or forwarded. `request` returns
|
|
333
|
+
`{ requested: true, intent, claim, result? }`. `intent` is a receipt that
|
|
334
|
+
describes what went to the owner; Fabric records none of it, so
|
|
335
|
+
`compact.status().pending` stays empty. `carry` handlers return
|
|
336
|
+
`{ items }` and should apply the [carry update contract](#carry-update-contract)
|
|
337
|
+
to the owner's own list.
|
|
338
|
+
- A request's `seed` reaches the owner only when it declares the `seed`
|
|
339
|
+
field, after the same checks as Fabric's own path. Fabric does not send
|
|
340
|
+
it. Send it after the owner's compaction commits, the way Fabric does: a
|
|
341
|
+
labelled custom message with `{ triggerTurn: true, deliverAs: "followUp" }`
|
|
342
|
+
whose text names its origin, not `sendUserMessage`.
|
|
343
|
+
- `compact.cancel` first clears any intent Fabric recorded before the
|
|
344
|
+
claim. That intent would otherwise commit through the owner at the next
|
|
345
|
+
settle, with Fabric-encoded instructions and Fabric's seed. It then calls
|
|
346
|
+
the owner's `cancel`. The result says which happened:
|
|
347
|
+
`{ cancelled: true, claim, fabricIntentCleared, ownerCancelled, result? }`.
|
|
348
|
+
Without an owner `cancel`, the call succeeds when Fabric had an intent to
|
|
349
|
+
clear and fails otherwise.
|
|
350
|
+
- `compact.status` adds `claim: { name, version, branchSummary, actions }`
|
|
351
|
+
and, when the owner supports `status`, `ownerStatus`. `compact.pressure`
|
|
352
|
+
adds `claim` and `ownerPressure: { stage, thresholds? }` beside Fabric's
|
|
353
|
+
band. Fabric omits its own `thresholdFraction` and `thresholdTokens`
|
|
354
|
+
there because they do not trigger under a claim.
|
|
355
|
+
- Every handler receives `{ context, signal }` (`FabricCompactionOwnerCallV1`):
|
|
356
|
+
`request` and `carry` as the second argument, the others as the only
|
|
357
|
+
one. `context` is the invoking session's extension context when Fabric
|
|
358
|
+
has one. Fabric bounds each handler call at 30 seconds. When the calling program
|
|
359
|
+
is cancelled or the bound passes, Fabric aborts `signal` and fails the
|
|
360
|
+
program call at once with `compaction owner <name>@<version>:
|
|
361
|
+
compact.<action> was cancelled by the calling program` or
|
|
362
|
+
`... did not finish within 30 s`. Stop the work when `signal` aborts.
|
|
363
|
+
- Owner handler results must be JSON of at most 16 KiB. A handler that throws
|
|
364
|
+
or returns an invalid shape fails the call with the owner's name. Pressure
|
|
365
|
+
threshold names `__proto__`, `constructor`, and `prototype` are refused.
|
|
366
|
+
- An expected owner result does not raise Fabric's ownership warning.
|
|
367
|
+
|
|
368
|
+
The handle's `fallback(event, ctx, { carry? })` returns Fabric's
|
|
369
|
+
deterministic summary for a `session_before_compact` event: the same
|
|
370
|
+
compiler, enrichers, and budget as Fabric's own hook, as
|
|
371
|
+
`{ ok: true, compaction }` or `{ ok: false, reason }`. Return
|
|
372
|
+
`{ compaction }` from the owner's handler when its model summary fails.
|
|
373
|
+
`carry` replaces Fabric's stored carry list and must fit the
|
|
374
|
+
`compact.carry` limits. The result carries Fabric's v2 details
|
|
375
|
+
(`compactor: "fabric"`) plus `claimOwner`, the owner's name, so a
|
|
376
|
+
provenance check can tell the owner's fallback from Fabric's own engine,
|
|
377
|
+
which never sets `claimOwner`. The fallback works only while the claim is
|
|
378
|
+
held.
|
|
379
|
+
|
|
380
|
+
One claim at a time. A second claim gets `{ ok: false, error, holder }`,
|
|
381
|
+
and Fabric shows a warning that names both owners. If the claimant's
|
|
382
|
+
`reply` throws, Fabric withdraws the claim it just granted and reports the
|
|
383
|
+
error as a warning (UI notice, else `console.warn`), because the owner never
|
|
384
|
+
received its token. A message with no usable `reply` is also reported as a
|
|
385
|
+
warning and dropped; nothing throws from `emit`. The claim ends when:
|
|
386
|
+
|
|
387
|
+
- the holder calls `handle.withdraw()` or emits
|
|
388
|
+
`{ version: 1, type: "withdraw", token: handle.token, reply? }`. Any other
|
|
389
|
+
token is refused with `{ ok: false, error }` and the claim stays;
|
|
390
|
+
- the claim's `signal` aborts; or
|
|
391
|
+
- Fabric receives `session_shutdown`. Pi sends it on reload, session
|
|
392
|
+
replacement (new, resume, fork), and quit, then loads every extension
|
|
393
|
+
again, so the owner claims again from its next `session_start`. Fabric
|
|
394
|
+
clears the claim first, before any other shutdown work.
|
|
395
|
+
|
|
396
|
+
Withdrawal restores Fabric's engine, thresholds, and `compact.*` behavior.
|
|
397
|
+
Fabric validates the claim and copies only named fields, reading each once:
|
|
398
|
+
`owner.name` and `owner.version` (printable text, at most 128 and 64
|
|
399
|
+
characters), the five known actions with their handlers and known fields,
|
|
400
|
+
`branchSummary`, and `signal`. Unknown keys, actions, or fields are
|
|
401
|
+
rejected with a reply naming the problem.
|
|
194
402
|
### Agent compaction: `agents.compact`
|
|
195
403
|
|
|
196
404
|
```ts
|
|
@@ -268,6 +476,8 @@ see [compaction](compaction.md#headroom-trigger).
|
|
|
268
476
|
| `src/compaction/pressure.ts` | Pure pressure projection from Pi's context usage, the active model, and config. |
|
|
269
477
|
| `src/compaction/carry.ts` | Carry-forward entry codec, update semantics, and summary lines. |
|
|
270
478
|
| `src/compaction/owner.ts` | Compaction owner classification and the once-per-session ownership warning. |
|
|
479
|
+
| `src/compaction/claim.ts` | Compaction owner claim registry: one holder, token withdrawal, abort-signal and shutdown release, and the deterministic fallback. |
|
|
480
|
+
| `src/protocol.ts` | `pi-fabric:compaction-owner:v1` message types and the validating, field-copying reader. |
|
|
271
481
|
| `src/fabric-state.ts` | Constructs the controller with mesh-publish hooks, registers the provider, and resets on re-init or shutdown. |
|
|
272
482
|
| `src/index.ts` | Invokes `state.compact.maybeCommit(context)` in the existing `agent_settled` handler. |
|
|
273
483
|
| `src/agents/types.ts` | Extends `AgentSteerEntry["type"]` with `"compact"` and adds the optional `instructions` field. |
|
package/docs/programs.md
CHANGED
|
@@ -114,7 +114,29 @@ pi.events.emit(FABRIC_PROGRAM_RUN_EVENT, {
|
|
|
114
114
|
});
|
|
115
115
|
```
|
|
116
116
|
|
|
117
|
-
The reply arrives exactly once. A payload without a `reply` function
|
|
117
|
+
The reply arrives exactly once. A payload without a `reply` function makes the listener throw synchronously; Pi's event bus catches and logs that throw, and other listeners still run. A `reply` property whose getter throws cannot be answered: Fabric neither replies nor throws. Other invalid fields, a missing session, an unknown ref, and a failed run all reply `{ ok: false, error }`. The event runs in the live session that Fabric saw at `session_start`.
|
|
118
|
+
|
|
119
|
+
Fabric reads `reply` and the named fields (`ref`, `input`, `requirePromoted`, `signal`) once, when the event arrives, and ignores every other field. A request without `ref` also has `code` read, once. Fabric keeps a JSON copy of `input`, not the caller's object, and makes it last, so a `toJSON` or getter inside `input` cannot change the other fields. A caller that deletes or changes the request or its `input` afterwards changes nothing, and the reply still arrives on the original `reply`. A named field whose getter throws never escapes the listener: Fabric replies `{ ok: false, error: "Invalid program run request: <field> could not be read" }` before any other check, and nothing runs.
|
|
120
|
+
|
|
121
|
+
### Running caller-supplied code
|
|
122
|
+
|
|
123
|
+
A host extension that builds program text itself, such as a program that ships in a package or a small runner it generates per run, can pass the TypeScript text as `code`, with no `ref`. Extensions already run with the user's full permissions, so this adds no new power. Fabric computes the SHA-256 of the code's UTF-8 bytes and records it, so the trace says which text ran.
|
|
124
|
+
|
|
125
|
+
```ts
|
|
126
|
+
import { FABRIC_PROGRAM_RUN_EVENT, type FabricProgramRunReplyV1 } from "pi-fabric/protocol";
|
|
127
|
+
|
|
128
|
+
pi.events.emit(FABRIC_PROGRAM_RUN_EVENT, {
|
|
129
|
+
code: "return { who: input.who };",
|
|
130
|
+
input: { who: "pi-stack" }, // optional, as for a ref run
|
|
131
|
+
reply: (result: FabricProgramRunReplyV1) => {},
|
|
132
|
+
});
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
- A request with `ref` is a saved-program run and ignores `code`. Without `ref`, the request needs `code`. `requirePromoted` applies only to `ref`.
|
|
136
|
+
- Fabric refuses with one `{ ok: false, error }` reply, before running anything, when `code` is empty or longer than 65 536 characters (the saved-program limit), or there is no active session. A session whose kernel is Python also refuses, because the code is TypeScript. So does a session without the `programs` provider, such as a managed embedded host, because the run goes through `programs.run`.
|
|
137
|
+
- The run takes the saved-program path: a one-call host program invokes `programs.run`, which resolves the code in place of a saved record. A policy that denies `programs.run`, through `approvals.execute` or `approvals.actions["programs.run"]`, refuses a `code` request as it refuses a `ref` request. Actions inside the code face their own approvals. The run has the root capability view, `invokedBy: "host"`, and a `pi-fabric-program-run` message labelled `caller-code:<first 12 hex of the hash>`.
|
|
138
|
+
- The trace records one `fabric.program.run` operation with `args: { program: "caller-code:<full sha256>", invokedBy: "host" }`. The reply's `program` and the message details' `program` carry the same value. The message details also carry `source: "caller-code"` and the full `sha256`, never the code. The `:` is outside the characters a program name may use, so no saved program can share this identity.
|
|
139
|
+
- The code is held for that run only and resolves only inside the host run that supplied it, never for a model's `programs.run`. Nothing is written to the program store. The binding lasts for the whole host execution: a saved program that the code runs can itself call `programs.run` with `caller-code:<sha256>` and reach the same code, under the 16-run nesting budget and the same approvals. It is gone when the run ends, whether it succeeded, threw or was aborted.
|
|
118
140
|
|
|
119
141
|
## Mesh-triggered runs
|
|
120
142
|
|
package/docs/prompt-cache.md
CHANGED
|
@@ -4,9 +4,9 @@
|
|
|
4
4
|
|
|
5
5
|
## Availability and cost
|
|
6
6
|
|
|
7
|
-
Observations work on ordinary Pi sessions now.
|
|
7
|
+
Observations work on ordinary Pi sessions now. **Scoped warming leases** require the optional native `ctx.acquireCacheWarming("idle")` capability, returning an idempotent release function. The inspected stock Pi 0.87.0/0.87.1 and 1.4.0 SDKs do **not** expose that capability, so lease acquisitions return `unsupported`. This does not disable Pi's own idle cache warmer or Fabric's [spilled-shell decision override](background-tasks.md#prompt-cache-warming-while-yielded). Fabric never simulates warming with prompts, changes global settings, or sends a replacement provider request.
|
|
8
8
|
|
|
9
|
-
No configuration switch is needed. Fabric acquires no warming interest until an explicit approved `cache.hold` or trusted component `cache.lease` acquisition. Native warming settings, including Pi's ordinary streaming policy, are unchanged. Acquisition has `agent` risk and may authorize paid native refreshes for the duration. Pi retains request snapshots, model eligibility, retention tiers, economic decisions, scheduling, and native safety windows. A lease cannot force a refresh or guarantee a cache hit.
|
|
9
|
+
No configuration switch is needed. Fabric acquires no warming interest until an explicit approved `cache.hold` or trusted component `cache.lease` acquisition. The one exception is a decision, not an interest: when Pi's own idle warming is already enabled and a spilled shell will wake this agent, Fabric re-prices Pi's idle refresh at certain continuation (see [background tasks](background-tasks.md#prompt-cache-warming-while-yielded)). Native warming settings, including Pi's ordinary streaming policy, are unchanged. Acquisition has `agent` risk and may authorize paid native refreshes for the duration. Pi retains request snapshots, model eligibility, retention tiers, economic decisions, scheduling, and native safety windows. A lease cannot force a refresh or guarantee a cache hit.
|
|
10
10
|
|
|
11
11
|
## Guest API
|
|
12
12
|
|
|
@@ -87,5 +87,7 @@ A future native bounded-admission protocol would be needed before enabling refre
|
|
|
87
87
|
| Managed host exclusion and Schema read-only boundary | `tests/managed-host-runtime.test.ts`, `tests/cache-provider.test.ts` |
|
|
88
88
|
| Node, Monty, and CPython proxy parity | Their targeted runtime suites |
|
|
89
89
|
| Registration/idle stays lazy; compiled artifacts include first-use path | Startup suites, `assert:lazy-graph`, fresh build |
|
|
90
|
+
| Spilled-shell idle override, savings threshold, interruption/error/branch/close exclusions | `tests/shell-inbox.test.ts` |
|
|
91
|
+
| Native 270-second refresh, replay and usage receipt, completion wakeup, default/off/UI-only exclusions, 30-minute horizon | `tests/shell-cache-warming-sdk.test.ts` |
|
|
90
92
|
|
|
91
93
|
No live cache-hit rate, native lease deployment, or strict spend cap is claimed by these checks.
|