@xzzpig/pi-subagents 0.22.0 → 0.24.1
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/CHANGELOG.md +355 -0
- package/README.md +2 -2
- package/agents/evidence-auditor.md +1 -0
- package/agents/oracle.md +1 -0
- package/agents/reviewer.md +1 -0
- package/bundle/agent-management.js +16 -0
- package/bundle/agents.js +41 -0
- package/bundle/background-work.js +16 -0
- package/bundle/capability-ceiling.js +22 -0
- package/bundle/child-tool-plan.js +11 -0
- package/bundle/chunk-355ECEP2.js +1321 -0
- package/bundle/chunk-35GII5EF.js +637 -0
- package/bundle/chunk-3U633XDZ.js +749 -0
- package/bundle/chunk-4QFZZV3O.js +57 -0
- package/bundle/chunk-62OCY2S4.js +14 -0
- package/bundle/chunk-6BJUEES3.js +276 -0
- package/bundle/chunk-7J4ZXMY7.js +18 -0
- package/bundle/chunk-BGIYHF2W.js +138 -0
- package/bundle/chunk-CTPAE36Y.js +94 -0
- package/bundle/chunk-D4EHT5SJ.js +14 -0
- package/bundle/chunk-ED55MIC2.js +1681 -0
- package/bundle/chunk-EUPJB4S7.js +5503 -0
- package/bundle/chunk-FG6SQJAR.js +940 -0
- package/bundle/chunk-FJWI64H7.js +490 -0
- package/bundle/chunk-H36HBZB2.js +753 -0
- package/bundle/chunk-ICNYIALB.js +7347 -0
- package/bundle/chunk-JEA2ZKUA.js +1372 -0
- package/bundle/chunk-LCDJWBVM.js +57 -0
- package/bundle/chunk-LMGQAJ3O.js +9872 -0
- package/bundle/chunk-LVWU2HOO.js +1234 -0
- package/bundle/chunk-NIXWDZZV.js +9 -0
- package/bundle/chunk-QXASAHIA.js +173 -0
- package/bundle/chunk-RB4GELQA.js +458 -0
- package/bundle/chunk-RU522D5W.js +1768 -0
- package/bundle/chunk-SLNMBXLL.js +7336 -0
- package/bundle/chunk-SW2VMNIU.js +526 -0
- package/bundle/chunk-TGLFTQWJ.js +143 -0
- package/bundle/chunk-TMHVDPYW.js +4132 -0
- package/bundle/chunk-U4ODUYAG.js +235 -0
- package/bundle/chunk-UKG4V45O.js +228 -0
- package/bundle/chunk-UQDHXMUG.js +264 -0
- package/bundle/chunk-V2KFIGFH.js +8774 -0
- package/bundle/chunk-VO3G7HI3.js +85 -0
- package/bundle/chunk-WPW4V6HM.js +227 -0
- package/bundle/chunk-WW76JRIX.js +175 -0
- package/bundle/chunk-X6LOM3Z4.js +4175 -0
- package/bundle/chunk-XA3DY6UG.js +161 -0
- package/bundle/chunk-Y6H2G6KX.js +1310 -0
- package/bundle/chunk-YFCK7H2S.js +129 -0
- package/bundle/chunk-YYREO77V.js +137 -0
- package/bundle/chunk-Z6TFJ6BR.js +400 -0
- package/bundle/chunk-ZWXU5SPQ.js +16932 -0
- package/bundle/control-channel.js +11 -0
- package/bundle/delegation.js +14 -0
- package/bundle/external-job-provider.js +20 -0
- package/bundle/external-runs.js +21 -0
- package/bundle/index.js +30 -0
- package/bundle/inspectors.js +8 -0
- package/bundle/intercom-bridge.js +11 -0
- package/bundle/preflight.js +468 -0
- package/bundle/project-panes.js +28 -0
- package/bundle/required-child-extensions.js +6 -0
- package/bundle/shared-types.js +8 -0
- package/bundle/supervisor-routing.js +12 -0
- package/bundle/workflow-resources.js +7 -0
- package/docs/agents.md +42 -10
- package/docs/configuration.md +59 -14
- package/docs/extension-api.md +61 -9
- package/docs/goal-auto-continuation-gate.md +26 -0
- package/docs/missions.md +2 -0
- package/docs/observability.md +20 -5
- package/docs/standalone-background.md +8 -6
- package/docs/tool-reference.md +18 -5
- package/docs/workflows.md +25 -7
- package/index.d.ts +3 -0
- package/index.js +14 -0
- package/node_modules/@xzzpig/pi-components/package.json +1 -2
- package/package.json +107 -87
- package/skills/council-mode/SKILL.md +1 -4
- package/skills/pi-subagents/SKILL.md +130 -106
- package/skills/pi-subagents/references/orchestration.md +124 -0
- package/skills/pi-subagents/references/prompting-and-roles.md +96 -291
- package/src/agents/advertised-agent-prompt.d.ts +13 -0
- package/src/agents/advertised-agent-prompt.js +68 -0
- package/src/agents/agent-eject.d.ts +39 -0
- package/src/agents/agent-eject.js +263 -0
- package/src/agents/agent-management.d.ts +33 -0
- package/src/agents/agent-management.js +1541 -0
- package/src/agents/agent-memory.d.ts +48 -0
- package/src/agents/agent-memory.js +350 -0
- package/src/agents/agent-refinements.d.ts +99 -0
- package/src/agents/agent-refinements.js +568 -0
- package/src/agents/agent-scope.d.ts +3 -0
- package/src/agents/agent-scope.js +8 -0
- package/src/agents/agent-selection.d.ts +2 -0
- package/src/agents/agent-selection.js +22 -0
- package/src/agents/agent-serializer.d.ts +7 -0
- package/src/agents/agent-serializer.js +213 -0
- package/src/agents/agents.d.ts +352 -0
- package/src/agents/agents.js +2817 -0
- package/src/agents/builtin-names.d.ts +1 -0
- package/src/agents/builtin-names.js +16 -0
- package/src/agents/chain-serializer.d.ts +6 -0
- package/src/agents/chain-serializer.js +318 -0
- package/src/agents/frontmatter.d.ts +19 -0
- package/src/agents/frontmatter.js +166 -0
- package/src/agents/global-npm-root.d.ts +6 -0
- package/src/agents/global-npm-root.js +57 -0
- package/src/agents/identity.d.ts +7 -0
- package/src/agents/identity.js +29 -0
- package/src/agents/proactive-skills.d.ts +35 -0
- package/src/agents/proactive-skills.js +155 -0
- package/src/agents/runtime-agent-events.d.ts +26 -0
- package/src/agents/runtime-agent-events.js +52 -0
- package/src/agents/runtime-agent-registry.d.ts +66 -0
- package/src/agents/runtime-agent-registry.js +415 -0
- package/src/agents/runtime-discovery.d.ts +13 -0
- package/src/agents/runtime-discovery.js +27 -0
- package/src/agents/skills.d.ts +34 -0
- package/src/agents/skills.js +718 -0
- package/src/api/agent-management.d.ts +2 -0
- package/src/api/agent-management.js +2 -0
- package/src/api/agents.d.ts +6 -0
- package/src/api/agents.js +3 -0
- package/src/api/background-work.d.ts +41 -0
- package/src/api/background-work.js +171 -0
- package/src/api/capability-ceiling.d.ts +1 -0
- package/src/api/capability-ceiling.js +1 -0
- package/src/api/child-tool-plan.d.ts +1 -0
- package/src/api/child-tool-plan.js +1 -0
- package/src/api/control-channel.d.ts +1 -0
- package/src/api/control-channel.js +1 -0
- package/src/api/delegation.d.ts +132 -0
- package/src/api/delegation.js +8 -0
- package/src/api/external-job-provider.d.ts +57 -0
- package/src/api/external-job-provider.js +139 -0
- package/src/api/external-runs.d.ts +47 -0
- package/src/api/external-runs.js +245 -0
- package/src/api/inspectors.d.ts +20 -0
- package/src/api/inspectors.js +11 -0
- package/src/api/intercom-bridge.d.ts +1 -0
- package/src/api/intercom-bridge.js +1 -0
- package/src/api/preflight.d.ts +183 -0
- package/src/api/preflight.js +455 -0
- package/src/api/project-panes.d.ts +7 -0
- package/src/api/project-panes.js +7 -0
- package/src/api/required-child-extensions.d.ts +1 -0
- package/src/api/required-child-extensions.js +1 -0
- package/src/api/shared-types.d.ts +1 -0
- package/src/api/shared-types.js +1 -0
- package/src/api/supervisor-routing.d.ts +110 -0
- package/src/api/supervisor-routing.js +95 -0
- package/src/api/workflow-resources.d.ts +2 -0
- package/src/api/workflow-resources.js +1 -0
- package/src/extension/active-runs-prompt.d.ts +7 -0
- package/src/extension/active-runs-prompt.js +29 -0
- package/src/extension/config.d.ts +7 -0
- package/src/extension/config.js +290 -0
- package/src/extension/context-injection.d.ts +52 -0
- package/src/extension/context-injection.js +102 -0
- package/src/extension/control-notices.d.ts +18 -0
- package/src/extension/control-notices.js +29 -0
- package/src/extension/declaration-pinning.d.ts +18 -0
- package/src/extension/declaration-pinning.js +167 -0
- package/src/extension/doctor.d.ts +34 -0
- package/src/extension/doctor.js +236 -0
- package/src/extension/fanout-child.d.ts +6 -0
- package/src/extension/fanout-child.js +278 -0
- package/src/extension/herdr-pi-bridge.d.ts +16 -0
- package/src/extension/herdr-pi-bridge.js +261 -0
- package/src/extension/index.d.ts +18 -0
- package/src/extension/index.js +1300 -0
- package/src/extension/public-execution.d.ts +71 -0
- package/src/extension/public-execution.js +214 -0
- package/src/extension/reply-workflow-script.d.ts +11 -0
- package/src/extension/reply-workflow-script.js +71 -0
- package/src/extension/rpc.d.ts +84 -0
- package/src/extension/rpc.js +729 -0
- package/src/extension/schemas.d.ts +276 -0
- package/src/extension/schemas.js +311 -0
- package/src/extension/steering-notices.d.ts +14 -0
- package/src/extension/steering-notices.js +22 -0
- package/src/extension/subagent-guide.d.ts +4 -0
- package/src/extension/subagent-guide.js +114 -0
- package/src/extension/subagent-options.d.ts +7 -0
- package/src/extension/subagent-options.js +64 -0
- package/src/extension/tool-activation.d.ts +7 -0
- package/src/extension/tool-activation.js +185 -0
- package/src/extension/tool-description.d.ts +19 -0
- package/src/extension/tool-description.js +169 -0
- package/src/extension/tool-result.d.ts +9 -0
- package/src/extension/tool-result.js +16 -0
- package/src/extension/upgrade-notice.d.ts +6 -0
- package/src/extension/upgrade-notice.js +42 -0
- package/src/goal-auto-continue-gate.d.ts +17 -0
- package/src/goal-auto-continue-gate.js +61 -0
- package/src/goal-auto-continue-state.d.ts +22 -0
- package/src/goal-auto-continue-state.js +20 -0
- package/src/inspectors/actions.d.ts +24 -0
- package/src/inspectors/actions.js +182 -0
- package/src/inspectors/ghostty/actions.d.ts +11 -0
- package/src/inspectors/ghostty/actions.js +62 -0
- package/src/inspectors/ghostty/plugin.d.ts +7 -0
- package/src/inspectors/ghostty/plugin.js +23 -0
- package/src/inspectors/herdr/actions.d.ts +25 -0
- package/src/inspectors/herdr/actions.js +133 -0
- package/src/inspectors/herdr/client.d.ts +41 -0
- package/src/inspectors/herdr/client.js +129 -0
- package/src/inspectors/herdr/focus.d.ts +24 -0
- package/src/inspectors/herdr/focus.js +49 -0
- package/src/inspectors/herdr/plugin.d.ts +6 -0
- package/src/inspectors/herdr/plugin.js +14 -0
- package/src/inspectors/herdr/project-panes.d.ts +136 -0
- package/src/inspectors/herdr/project-panes.js +610 -0
- package/src/inspectors/inspector-runner.d.ts +23 -0
- package/src/inspectors/inspector-runner.js +161 -0
- package/src/inspectors/plugins.d.ts +8 -0
- package/src/inspectors/plugins.js +82 -0
- package/src/inspectors/session-roots-codec.d.ts +15 -0
- package/src/inspectors/session-roots-codec.js +32 -0
- package/src/inspectors/shell-command.d.ts +1 -0
- package/src/inspectors/shell-command.js +16 -0
- package/src/inspectors/tmux/actions.d.ts +25 -0
- package/src/inspectors/tmux/actions.js +181 -0
- package/src/inspectors/tmux/client.d.ts +27 -0
- package/src/inspectors/tmux/client.js +64 -0
- package/src/inspectors/tmux/plugin.d.ts +7 -0
- package/src/inspectors/tmux/plugin.js +14 -0
- package/src/inspectors/types.d.ts +48 -0
- package/src/inspectors/types.js +1 -0
- package/src/integrations/herdr-status.d.ts +47 -0
- package/src/integrations/herdr-status.js +350 -0
- package/src/integrations/pi-web-session-liveness.d.ts +19 -0
- package/src/integrations/pi-web-session-liveness.js +53 -0
- package/src/integrations/program-status.d.ts +30 -0
- package/src/integrations/program-status.js +188 -0
- package/src/intercom/fork-supervisor-routing.d.ts +90 -0
- package/src/intercom/fork-supervisor-routing.js +392 -0
- package/src/intercom/intercom-bridge.d.ts +58 -0
- package/src/intercom/intercom-bridge.js +193 -0
- package/src/intercom/native-supervisor-channel.d.ts +97 -0
- package/src/intercom/native-supervisor-channel.js +1184 -0
- package/src/intercom/result-intercom.d.ts +35 -0
- package/src/intercom/result-intercom.js +376 -0
- package/src/intercom/supervisor-ui.d.ts +29 -0
- package/src/intercom/supervisor-ui.js +49 -0
- package/src/missions/actions.d.ts +54 -0
- package/src/missions/actions.js +400 -0
- package/src/missions/goal-driver.d.ts +16 -0
- package/src/missions/goal-driver.js +171 -0
- package/src/missions/lifecycle.d.ts +50 -0
- package/src/missions/lifecycle.js +388 -0
- package/src/missions/store.d.ts +21 -0
- package/src/missions/store.js +605 -0
- package/src/missions/types.d.ts +169 -0
- package/src/missions/types.js +9 -0
- package/src/missions/workflow-state.d.ts +14 -0
- package/src/missions/workflow-state.js +273 -0
- package/src/policy/authority.d.ts +9 -0
- package/src/policy/authority.js +41 -0
- package/src/profiles/profiles.d.ts +134 -0
- package/src/profiles/profiles.js +526 -0
- package/src/runs/background/active-async-capacity.d.ts +115 -0
- package/src/runs/background/active-async-capacity.js +517 -0
- package/src/runs/background/active-run-index.d.ts +12 -0
- package/src/runs/background/active-run-index.js +157 -0
- package/src/runs/background/async-execution.d.ts +306 -0
- package/src/runs/background/async-execution.js +2210 -0
- package/src/runs/background/async-job-tracker.d.ts +37 -0
- package/src/runs/background/async-job-tracker.js +926 -0
- package/src/runs/background/async-resume.d.ts +60 -0
- package/src/runs/background/async-resume.js +707 -0
- package/src/runs/background/async-retention.d.ts +45 -0
- package/src/runs/background/async-retention.js +932 -0
- package/src/runs/background/async-status-snapshot.d.ts +9 -0
- package/src/runs/background/async-status-snapshot.js +26 -0
- package/src/runs/background/async-status.d.ts +179 -0
- package/src/runs/background/async-status.js +712 -0
- package/src/runs/background/auto-drain.d.ts +16 -0
- package/src/runs/background/auto-drain.js +71 -0
- package/src/runs/background/await-async-run.d.ts +26 -0
- package/src/runs/background/await-async-run.js +83 -0
- package/src/runs/background/binary-bootstrap.d.ts +8 -0
- package/src/runs/background/binary-bootstrap.js +69 -0
- package/src/runs/background/boot-id.d.ts +12 -0
- package/src/runs/background/boot-id.js +47 -0
- package/src/runs/background/calendar-schedule.d.ts +26 -0
- package/src/runs/background/calendar-schedule.js +93 -0
- package/src/runs/background/chain-append.d.ts +34 -0
- package/src/runs/background/chain-append.js +299 -0
- package/src/runs/background/chain-root-attachment.d.ts +51 -0
- package/src/runs/background/chain-root-attachment.js +186 -0
- package/src/runs/background/completion-batcher.d.ts +51 -0
- package/src/runs/background/completion-batcher.js +119 -0
- package/src/runs/background/completion-dedupe.d.ts +13 -0
- package/src/runs/background/completion-dedupe.js +48 -0
- package/src/runs/background/completion-replay.d.ts +47 -0
- package/src/runs/background/completion-replay.js +266 -0
- package/src/runs/background/control-channel.d.ts +170 -0
- package/src/runs/background/control-channel.js +610 -0
- package/src/runs/background/fleet-view.d.ts +63 -0
- package/src/runs/background/fleet-view.js +666 -0
- package/src/runs/background/index-segment.d.ts +16 -0
- package/src/runs/background/index-segment.js +58 -0
- package/src/runs/background/inspect-rpc.d.ts +64 -0
- package/src/runs/background/inspect-rpc.js +422 -0
- package/src/runs/background/interrupted-elsewhere.d.ts +22 -0
- package/src/runs/background/interrupted-elsewhere.js +68 -0
- package/src/runs/background/notify.d.ts +216 -0
- package/src/runs/background/notify.js +1006 -0
- package/src/runs/background/owned-process-tree.d.ts +10 -0
- package/src/runs/background/owned-process-tree.js +116 -0
- package/src/runs/background/parallel-groups.d.ts +3 -0
- package/src/runs/background/parallel-groups.js +46 -0
- package/src/runs/background/pid-namespace.d.ts +2 -0
- package/src/runs/background/pid-namespace.js +19 -0
- package/src/runs/background/process-terminal-candidate.d.ts +17 -0
- package/src/runs/background/process-terminal-candidate.js +96 -0
- package/src/runs/background/process-terminal.d.ts +21 -0
- package/src/runs/background/process-terminal.js +227 -0
- package/src/runs/background/result-delivery-ownership.d.ts +14 -0
- package/src/runs/background/result-delivery-ownership.js +38 -0
- package/src/runs/background/result-files.d.ts +63 -0
- package/src/runs/background/result-files.js +629 -0
- package/src/runs/background/result-watcher.d.ts +92 -0
- package/src/runs/background/result-watcher.js +819 -0
- package/src/runs/background/resume-guidance.d.ts +4 -0
- package/src/runs/background/resume-guidance.js +57 -0
- package/src/runs/background/retained-children.d.ts +24 -0
- package/src/runs/background/retained-children.js +128 -0
- package/src/runs/background/retained-nested-route-tracker.d.ts +12 -0
- package/src/runs/background/retained-nested-route-tracker.js +90 -0
- package/src/runs/background/run-child-session.d.ts +123 -0
- package/src/runs/background/run-child-session.js +670 -0
- package/src/runs/background/run-id-query.d.ts +3 -0
- package/src/runs/background/run-id-query.js +6 -0
- package/src/runs/background/run-id-resolver.d.ts +22 -0
- package/src/runs/background/run-id-resolver.js +172 -0
- package/src/runs/background/run-status.d.ts +25 -0
- package/src/runs/background/run-status.js +850 -0
- package/src/runs/background/runner-aliases.d.ts +17 -0
- package/src/runs/background/runner-aliases.js +191 -0
- package/src/runs/background/runner-child-launch.d.ts +24 -0
- package/src/runs/background/runner-child-launch.js +72 -0
- package/src/runs/background/runner-child-sessions.d.ts +6 -0
- package/src/runs/background/runner-child-sessions.js +34 -0
- package/src/runs/background/runner-http-dispatcher.d.ts +45 -0
- package/src/runs/background/runner-http-dispatcher.js +115 -0
- package/src/runs/background/runner-startup-failure.d.ts +13 -0
- package/src/runs/background/runner-startup-failure.js +46 -0
- package/src/runs/background/scheduled-runs.d.ts +127 -0
- package/src/runs/background/scheduled-runs.js +1265 -0
- package/src/runs/background/stale-run-reconciler.d.ts +62 -0
- package/src/runs/background/stale-run-reconciler.js +509 -0
- package/src/runs/background/steering.d.ts +51 -0
- package/src/runs/background/steering.js +246 -0
- package/src/runs/background/subagent-runner-bootstrap.d.ts +13 -0
- package/src/runs/background/subagent-runner-bootstrap.js +283 -0
- package/src/runs/background/subagent-runner.d.ts +210 -0
- package/src/runs/background/subagent-runner.js +4963 -0
- package/src/runs/background/subagent-wait.d.ts +124 -0
- package/src/runs/background/subagent-wait.js +756 -0
- package/src/runs/background/terminal-run-index.d.ts +10 -0
- package/src/runs/background/terminal-run-index.js +209 -0
- package/src/runs/background/top-level-async.d.ts +7 -0
- package/src/runs/background/top-level-async.js +5 -0
- package/src/runs/background/wait-completions.d.ts +28 -0
- package/src/runs/background/wait-completions.js +264 -0
- package/src/runs/background/wait-config.d.ts +8 -0
- package/src/runs/background/wait-config.js +46 -0
- package/src/runs/background/wait-subscriptions.d.ts +26 -0
- package/src/runs/background/wait-subscriptions.js +339 -0
- package/src/runs/background/wait-tool.d.ts +6 -0
- package/src/runs/background/wait-tool.js +48 -0
- package/src/runs/background/workflow-terminal-proof.d.ts +47 -0
- package/src/runs/background/workflow-terminal-proof.js +116 -0
- package/src/runs/foreground/async-dismiss-action.d.ts +6 -0
- package/src/runs/foreground/async-dismiss-action.js +82 -0
- package/src/runs/foreground/async-steering-action.d.ts +31 -0
- package/src/runs/foreground/async-steering-action.js +294 -0
- package/src/runs/foreground/async-stop-action.d.ts +13 -0
- package/src/runs/foreground/async-stop-action.js +213 -0
- package/src/runs/foreground/command-action.d.ts +12 -0
- package/src/runs/foreground/command-action.js +38 -0
- package/src/runs/foreground/execution.d.ts +10 -0
- package/src/runs/foreground/execution.js +2322 -0
- package/src/runs/foreground/foreground-control.d.ts +24 -0
- package/src/runs/foreground/foreground-control.js +138 -0
- package/src/runs/foreground/foreground-history.d.ts +25 -0
- package/src/runs/foreground/foreground-history.js +267 -0
- package/src/runs/foreground/prompt-audit.d.ts +32 -0
- package/src/runs/foreground/prompt-audit.js +138 -0
- package/src/runs/foreground/subagent-executor.d.ts +316 -0
- package/src/runs/foreground/subagent-executor.js +7990 -0
- package/src/runs/foreground/workflow-detach-reconcile.d.ts +15 -0
- package/src/runs/foreground/workflow-detach-reconcile.js +283 -0
- package/src/runs/foreground/workflow-foreground-steering.d.ts +43 -0
- package/src/runs/foreground/workflow-foreground-steering.js +148 -0
- package/src/runs/shared/abort-recovery.d.ts +26 -0
- package/src/runs/shared/abort-recovery.js +108 -0
- package/src/runs/shared/acceptance.d.ts +144 -0
- package/src/runs/shared/acceptance.js +1616 -0
- package/src/runs/shared/agent-contract.d.ts +5 -0
- package/src/runs/shared/agent-contract.js +35 -0
- package/src/runs/shared/async-status-projection.d.ts +100 -0
- package/src/runs/shared/async-status-projection.js +566 -0
- package/src/runs/shared/background-process-options.d.ts +4 -0
- package/src/runs/shared/background-process-options.js +6 -0
- package/src/runs/shared/capability-ceiling.d.ts +58 -0
- package/src/runs/shared/capability-ceiling.js +179 -0
- package/src/runs/shared/chain-outputs.d.ts +18 -0
- package/src/runs/shared/chain-outputs.js +104 -0
- package/src/runs/shared/child-commands.d.ts +29 -0
- package/src/runs/shared/child-commands.js +254 -0
- package/src/runs/shared/child-hooks.d.ts +31 -0
- package/src/runs/shared/child-hooks.js +173 -0
- package/src/runs/shared/child-identity.d.ts +23 -0
- package/src/runs/shared/child-identity.js +40 -0
- package/src/runs/shared/child-launch-plan.d.ts +70 -0
- package/src/runs/shared/child-launch-plan.js +88 -0
- package/src/runs/shared/child-launch.d.ts +128 -0
- package/src/runs/shared/child-launch.js +262 -0
- package/src/runs/shared/child-lifecycle.d.ts +13 -0
- package/src/runs/shared/child-lifecycle.js +22 -0
- package/src/runs/shared/child-runtime-config.d.ts +111 -0
- package/src/runs/shared/child-runtime-config.js +44 -0
- package/src/runs/shared/child-session.d.ts +178 -0
- package/src/runs/shared/child-session.js +726 -0
- package/src/runs/shared/child-tool-plan.d.ts +101 -0
- package/src/runs/shared/child-tool-plan.js +430 -0
- package/src/runs/shared/claude-code-adapter.d.ts +80 -0
- package/src/runs/shared/claude-code-adapter.js +255 -0
- package/src/runs/shared/codex-exec-adapter.d.ts +25 -0
- package/src/runs/shared/codex-exec-adapter.js +127 -0
- package/src/runs/shared/context-mode.d.ts +12 -0
- package/src/runs/shared/context-mode.js +38 -0
- package/src/runs/shared/cursor-agent-adapter.d.ts +26 -0
- package/src/runs/shared/cursor-agent-adapter.js +99 -0
- package/src/runs/shared/dynamic-fanout.d.ts +49 -0
- package/src/runs/shared/dynamic-fanout.js +273 -0
- package/src/runs/shared/effective-system-prompt.d.ts +17 -0
- package/src/runs/shared/effective-system-prompt.js +23 -0
- package/src/runs/shared/extension-bindings.d.ts +25 -0
- package/src/runs/shared/extension-bindings.js +96 -0
- package/src/runs/shared/external-cli-contract.d.ts +29 -0
- package/src/runs/shared/external-cli-contract.js +145 -0
- package/src/runs/shared/external-cli-preflight.d.ts +41 -0
- package/src/runs/shared/external-cli-preflight.js +159 -0
- package/src/runs/shared/external-cli-runner.d.ts +65 -0
- package/src/runs/shared/external-cli-runner.js +425 -0
- package/src/runs/shared/external-job-bridge.d.ts +24 -0
- package/src/runs/shared/external-job-bridge.js +486 -0
- package/src/runs/shared/external-job-runner.d.ts +44 -0
- package/src/runs/shared/external-job-runner.js +352 -0
- package/src/runs/shared/fast-mode-extension.d.ts +3 -0
- package/src/runs/shared/fast-mode-extension.js +8 -0
- package/src/runs/shared/fork-placed-env.d.ts +4 -0
- package/src/runs/shared/fork-placed-env.js +13 -0
- package/src/runs/shared/git-environment.d.ts +2 -0
- package/src/runs/shared/git-environment.js +27 -0
- package/src/runs/shared/herdr-connection.d.ts +79 -0
- package/src/runs/shared/herdr-connection.js +269 -0
- package/src/runs/shared/herdr-external-adapters.d.ts +148 -0
- package/src/runs/shared/herdr-external-adapters.js +404 -0
- package/src/runs/shared/herdr-machine.d.ts +59 -0
- package/src/runs/shared/herdr-machine.js +294 -0
- package/src/runs/shared/herdr-pane-host.d.ts +88 -0
- package/src/runs/shared/herdr-pane-host.js +155 -0
- package/src/runs/shared/herdr-pi-protocol.d.ts +21 -0
- package/src/runs/shared/herdr-pi-protocol.js +57 -0
- package/src/runs/shared/herdr-placed-run.d.ts +144 -0
- package/src/runs/shared/herdr-placed-run.js +380 -0
- package/src/runs/shared/host-step-status.d.ts +33 -0
- package/src/runs/shared/host-step-status.js +244 -0
- package/src/runs/shared/lane-metadata.d.ts +23 -0
- package/src/runs/shared/lane-metadata.js +126 -0
- package/src/runs/shared/launch-cwd.d.ts +1 -0
- package/src/runs/shared/launch-cwd.js +16 -0
- package/src/runs/shared/local-machine-access.d.ts +5 -0
- package/src/runs/shared/local-machine-access.js +28 -0
- package/src/runs/shared/long-running-guard.d.ts +34 -0
- package/src/runs/shared/long-running-guard.js +256 -0
- package/src/runs/shared/mcp-config-sources.d.ts +33 -0
- package/src/runs/shared/mcp-config-sources.js +418 -0
- package/src/runs/shared/mcp-direct-tool-allowlist.d.ts +86 -0
- package/src/runs/shared/mcp-direct-tool-allowlist.js +477 -0
- package/src/runs/shared/mcp-direct-tool-grant.d.ts +42 -0
- package/src/runs/shared/mcp-direct-tool-grant.js +159 -0
- package/src/runs/shared/model-resolution-diagnostic.d.ts +44 -0
- package/src/runs/shared/model-resolution-diagnostic.js +116 -0
- package/src/runs/shared/model-resolution.d.ts +109 -0
- package/src/runs/shared/model-resolution.js +411 -0
- package/src/runs/shared/model-scope.d.ts +68 -0
- package/src/runs/shared/model-scope.js +171 -0
- package/src/runs/shared/mutation-evidence.d.ts +18 -0
- package/src/runs/shared/mutation-evidence.js +198 -0
- package/src/runs/shared/nested-events.d.ts +135 -0
- package/src/runs/shared/nested-events.js +1090 -0
- package/src/runs/shared/nested-path.d.ts +8 -0
- package/src/runs/shared/nested-path.js +34 -0
- package/src/runs/shared/nested-render.d.ts +20 -0
- package/src/runs/shared/nested-render.js +115 -0
- package/src/runs/shared/orca-progress-tabs.d.ts +31 -0
- package/src/runs/shared/orca-progress-tabs.js +503 -0
- package/src/runs/shared/parallel-handoff.d.ts +78 -0
- package/src/runs/shared/parallel-handoff.js +783 -0
- package/src/runs/shared/parallel-utils.d.ts +177 -0
- package/src/runs/shared/parallel-utils.js +125 -0
- package/src/runs/shared/partial-output.d.ts +24 -0
- package/src/runs/shared/partial-output.js +35 -0
- package/src/runs/shared/permissions.d.ts +12 -0
- package/src/runs/shared/permissions.js +92 -0
- package/src/runs/shared/pi-spawn.d.ts +31 -0
- package/src/runs/shared/pi-spawn.js +211 -0
- package/src/runs/shared/placed-run-owner.d.ts +49 -0
- package/src/runs/shared/placed-run-owner.js +93 -0
- package/src/runs/shared/placement-host.d.ts +99 -0
- package/src/runs/shared/placement-host.js +157 -0
- package/src/runs/shared/process-signal.d.ts +15 -0
- package/src/runs/shared/process-signal.js +21 -0
- package/src/runs/shared/profile-extensions.d.ts +21 -0
- package/src/runs/shared/profile-extensions.js +122 -0
- package/src/runs/shared/profile-launch-env.d.ts +26 -0
- package/src/runs/shared/profile-launch-env.js +90 -0
- package/src/runs/shared/readonly-drain-observation.d.ts +25 -0
- package/src/runs/shared/readonly-drain-observation.js +50 -0
- package/src/runs/shared/rex-machine.d.ts +25 -0
- package/src/runs/shared/rex-machine.js +83 -0
- package/src/runs/shared/rex-pane-host.d.ts +62 -0
- package/src/runs/shared/rex-pane-host.js +327 -0
- package/src/runs/shared/run-fanout-budget.d.ts +14 -0
- package/src/runs/shared/run-fanout-budget.js +258 -0
- package/src/runs/shared/run-ownership.d.ts +3 -0
- package/src/runs/shared/run-ownership.js +8 -0
- package/src/runs/shared/runner-launcher.d.ts +11 -0
- package/src/runs/shared/runner-launcher.js +24 -0
- package/src/runs/shared/runtime-acknowledged-extensions.d.ts +7 -0
- package/src/runs/shared/runtime-acknowledged-extensions.js +44 -0
- package/src/runs/shared/sandbox-profile-guard.d.ts +23 -0
- package/src/runs/shared/sandbox-profile-guard.js +106 -0
- package/src/runs/shared/sandbox-startup-diagnostics.d.ts +21 -0
- package/src/runs/shared/sandbox-startup-diagnostics.js +51 -0
- package/src/runs/shared/session-lease.d.ts +69 -0
- package/src/runs/shared/session-lease.js +250 -0
- package/src/runs/shared/single-output.d.ts +90 -0
- package/src/runs/shared/single-output.js +349 -0
- package/src/runs/shared/spawn-budget.d.ts +20 -0
- package/src/runs/shared/spawn-budget.js +93 -0
- package/src/runs/shared/structured-output.d.ts +66 -0
- package/src/runs/shared/structured-output.js +483 -0
- package/src/runs/shared/subagent-control.d.ts +50 -0
- package/src/runs/shared/subagent-control.js +247 -0
- package/src/runs/shared/subagent-prompt-runtime.d.ts +90 -0
- package/src/runs/shared/subagent-prompt-runtime.js +776 -0
- package/src/runs/shared/tool-availability.d.ts +16 -0
- package/src/runs/shared/tool-availability.js +29 -0
- package/src/runs/shared/tool-budget.d.ts +21 -0
- package/src/runs/shared/tool-budget.js +78 -0
- package/src/runs/shared/tool-timeout.d.ts +31 -0
- package/src/runs/shared/tool-timeout.js +73 -0
- package/src/runs/shared/usage-budget.d.ts +7 -0
- package/src/runs/shared/usage-budget.js +74 -0
- package/src/runs/shared/usage-reconciliation.d.ts +8 -0
- package/src/runs/shared/usage-reconciliation.js +71 -0
- package/src/runs/shared/workflow-async-child-guidance.d.ts +3 -0
- package/src/runs/shared/workflow-async-child-guidance.js +17 -0
- package/src/runs/shared/workflow-graph.d.ts +31 -0
- package/src/runs/shared/workflow-graph.js +221 -0
- package/src/runs/shared/worktree-cleanup-apply.d.ts +36 -0
- package/src/runs/shared/worktree-cleanup-apply.js +178 -0
- package/src/runs/shared/worktree-cleanup-plan.d.ts +84 -0
- package/src/runs/shared/worktree-cleanup-plan.js +803 -0
- package/src/runs/shared/worktree-lock.d.ts +5 -0
- package/src/runs/shared/worktree-lock.js +40 -0
- package/src/runs/shared/worktree-setup-command.d.ts +38 -0
- package/src/runs/shared/worktree-setup-command.js +200 -0
- package/src/runs/shared/worktree.d.ts +181 -0
- package/src/runs/shared/worktree.js +1346 -0
- package/src/shared/accessible-dir.d.ts +11 -0
- package/src/shared/accessible-dir.js +39 -0
- package/src/shared/agent-stream-options.d.ts +5 -0
- package/src/shared/agent-stream-options.js +3 -0
- package/src/shared/artifacts.d.ts +22 -0
- package/src/shared/artifacts.js +272 -0
- package/src/shared/atomic-json.d.ts +19 -0
- package/src/shared/atomic-json.js +61 -0
- package/src/shared/capacity-resilient-json.d.ts +26 -0
- package/src/shared/capacity-resilient-json.js +86 -0
- package/src/shared/child-cache-retention.d.ts +29 -0
- package/src/shared/child-cache-retention.js +40 -0
- package/src/shared/child-session-name.d.ts +8 -0
- package/src/shared/child-session-name.js +40 -0
- package/src/shared/child-transcript.d.ts +37 -0
- package/src/shared/child-transcript.js +225 -0
- package/src/shared/completion-owner.d.ts +7 -0
- package/src/shared/completion-owner.js +13 -0
- package/src/shared/disabled-features.d.ts +93 -0
- package/src/shared/disabled-features.js +120 -0
- package/src/shared/display-text.d.ts +5 -0
- package/src/shared/display-text.js +154 -0
- package/src/shared/edit-distance.d.ts +4 -0
- package/src/shared/edit-distance.js +32 -0
- package/src/shared/extension-context.d.ts +21 -0
- package/src/shared/extension-context.js +39 -0
- package/src/shared/file-coalescer.d.ts +11 -0
- package/src/shared/file-coalescer.js +34 -0
- package/src/shared/file-lease.d.ts +10 -0
- package/src/shared/file-lease.js +106 -0
- package/src/shared/file-system-retry.d.ts +31 -0
- package/src/shared/file-system-retry.js +84 -0
- package/src/shared/fork-context.d.ts +64 -0
- package/src/shared/fork-context.js +185 -0
- package/src/shared/fork-session-cwd.d.ts +2 -0
- package/src/shared/fork-session-cwd.js +23 -0
- package/src/shared/formatters.d.ts +35 -0
- package/src/shared/formatters.js +137 -0
- package/src/shared/jsonl-writer.d.ts +20 -0
- package/src/shared/jsonl-writer.js +67 -0
- package/src/shared/launch-contract.d.ts +65 -0
- package/src/shared/launch-contract.js +145 -0
- package/src/shared/model-info.d.ts +55 -0
- package/src/shared/model-info.js +103 -0
- package/src/shared/model-response-aliases.d.ts +1 -0
- package/src/shared/model-response-aliases.js +15 -0
- package/src/shared/node-executable.d.ts +1 -0
- package/src/shared/node-executable.js +20 -0
- package/src/shared/opencode-session-headers.d.ts +12 -0
- package/src/shared/opencode-session-headers.js +26 -0
- package/src/shared/package-version.d.ts +2 -0
- package/src/shared/package-version.js +14 -0
- package/src/shared/parent-wake.d.ts +26 -0
- package/src/shared/parent-wake.js +68 -0
- package/src/shared/permission-profile.d.ts +26 -0
- package/src/shared/permission-profile.js +49 -0
- package/src/shared/prompt-resources.d.ts +5 -0
- package/src/shared/prompt-resources.js +10 -0
- package/src/shared/provider-diagnostics.d.ts +9 -0
- package/src/shared/provider-diagnostics.js +75 -0
- package/src/shared/pruned-fork.d.ts +34 -0
- package/src/shared/pruned-fork.js +434 -0
- package/src/shared/required-child-extensions.d.ts +34 -0
- package/src/shared/required-child-extensions.js +105 -0
- package/src/shared/runtime-module-path.d.ts +10 -0
- package/src/shared/runtime-module-path.js +16 -0
- package/src/shared/sandbox-profile.d.ts +12 -0
- package/src/shared/sandbox-profile.js +35 -0
- package/src/shared/session-file-trust.d.ts +1 -0
- package/src/shared/session-file-trust.js +20 -0
- package/src/shared/session-identity.d.ts +8 -0
- package/src/shared/session-identity.js +32 -0
- package/src/shared/session-succession.d.ts +4 -0
- package/src/shared/session-succession.js +24 -0
- package/src/shared/session-tokens.d.ts +2 -0
- package/src/shared/session-tokens.js +58 -0
- package/src/shared/settings-file-lease.d.ts +4 -0
- package/src/shared/settings-file-lease.js +38 -0
- package/src/shared/settings.d.ts +146 -0
- package/src/shared/settings.js +247 -0
- package/src/shared/shortcuts.d.ts +1 -0
- package/src/shared/shortcuts.js +17 -0
- package/src/shared/status-format.d.ts +9 -0
- package/src/shared/status-format.js +60 -0
- package/src/shared/thinking-ceiling.d.ts +13 -0
- package/src/shared/thinking-ceiling.js +37 -0
- package/src/shared/types.d.ts +2842 -0
- package/src/shared/types.js +276 -0
- package/src/shared/utf8.d.ts +5 -0
- package/src/shared/utf8.js +12 -0
- package/src/shared/utils.d.ts +83 -0
- package/src/shared/utils.js +612 -0
- package/src/shared/watch-strategy.d.ts +2 -0
- package/src/shared/watch-strategy.js +5 -0
- package/src/shared/workflow-child-permit.d.ts +58 -0
- package/src/shared/workflow-child-permit.js +159 -0
- package/src/slash/delegation-adapters.d.ts +154 -0
- package/src/slash/delegation-adapters.js +316 -0
- package/src/slash/delegation-json.d.ts +10 -0
- package/src/slash/delegation-json.js +117 -0
- package/src/slash/delegation-request.d.ts +12 -0
- package/src/slash/delegation-request.js +174 -0
- package/src/slash/prompt-template-bridge.d.ts +29 -0
- package/src/slash/prompt-template-bridge.js +399 -0
- package/src/slash/prompt-workflows.d.ts +21 -0
- package/src/slash/prompt-workflows.js +274 -0
- package/src/slash/selector.d.ts +47 -0
- package/src/slash/selector.js +117 -0
- package/src/slash/slash-bridge.d.ts +30 -0
- package/src/slash/slash-bridge.js +132 -0
- package/src/slash/slash-commands.d.ts +10 -0
- package/src/slash/slash-commands.js +1059 -0
- package/src/slash/slash-live-state.d.ts +21 -0
- package/src/slash/slash-live-state.js +263 -0
- package/src/slash/subagent-cost.d.ts +29 -0
- package/src/slash/subagent-cost.js +310 -0
- package/src/slash/subagents-admin.d.ts +3 -0
- package/src/slash/subagents-admin.js +481 -0
- package/src/tui/fleet-layout.d.ts +20 -0
- package/src/tui/fleet-layout.js +17 -0
- package/src/tui/fleet-native-transcript.d.ts +53 -0
- package/src/tui/fleet-native-transcript.js +339 -0
- package/src/tui/fleet-status.d.ts +92 -0
- package/src/tui/fleet-status.js +1132 -0
- package/src/tui/fleet-transcript.d.ts +64 -0
- package/src/tui/fleet-transcript.js +544 -0
- package/src/tui/fleet-viewport.d.ts +12 -0
- package/src/tui/fleet-viewport.js +35 -0
- package/src/tui/fleet.d.ts +196 -0
- package/src/tui/fleet.js +1588 -0
- package/src/tui/mouse-events.d.ts +21 -0
- package/src/tui/mouse-events.js +26 -0
- package/src/tui/render-helpers.d.ts +23 -0
- package/src/tui/render-helpers.js +100 -0
- package/src/tui/render.d.ts +66 -0
- package/src/tui/render.js +3707 -0
- package/src/tui/running-tone.d.ts +10 -0
- package/src/tui/running-tone.js +22 -0
- package/src/tui/subagent-messages.d.ts +22 -0
- package/src/tui/subagent-messages.js +270 -0
- package/src/ui-silent-marker.d.ts +20 -0
- package/src/ui-silent-marker.js +25 -0
- package/src/watchdog/change-signature.d.ts +7 -0
- package/src/watchdog/change-signature.js +243 -0
- package/src/watchdog/child-status.d.ts +53 -0
- package/src/watchdog/child-status.js +187 -0
- package/src/watchdog/diff-tool.d.ts +25 -0
- package/src/watchdog/diff-tool.js +104 -0
- package/src/watchdog/emission-guard.d.ts +36 -0
- package/src/watchdog/emission-guard.js +97 -0
- package/src/watchdog/guidance.d.ts +3 -0
- package/src/watchdog/guidance.js +19 -0
- package/src/watchdog/lsp-diagnostics.d.ts +17 -0
- package/src/watchdog/lsp-diagnostics.js +489 -0
- package/src/watchdog/model-selection.d.ts +24 -0
- package/src/watchdog/model-selection.js +167 -0
- package/src/watchdog/permission-arbiter.d.ts +20 -0
- package/src/watchdog/permission-arbiter.js +135 -0
- package/src/watchdog/register-child.d.ts +13 -0
- package/src/watchdog/register-child.js +128 -0
- package/src/watchdog/register-main.d.ts +11 -0
- package/src/watchdog/register-main.js +400 -0
- package/src/watchdog/render.d.ts +3 -0
- package/src/watchdog/render.js +33 -0
- package/src/watchdog/review.d.ts +36 -0
- package/src/watchdog/review.js +319 -0
- package/src/watchdog/rules.d.ts +21 -0
- package/src/watchdog/rules.js +58 -0
- package/src/watchdog/runtime.d.ts +195 -0
- package/src/watchdog/runtime.js +864 -0
- package/src/watchdog/scope.d.ts +14 -0
- package/src/watchdog/scope.js +44 -0
- package/src/watchdog/settings.d.ts +29 -0
- package/src/watchdog/settings.js +480 -0
- package/src/watchdog/tool-actions.d.ts +17 -0
- package/src/watchdog/tool-actions.js +150 -0
- package/src/watchdog/turn-delta.d.ts +15 -0
- package/src/watchdog/turn-delta.js +188 -0
- package/src/watchdog/types.d.ts +141 -0
- package/src/watchdog/types.js +27 -0
- package/src/watchdog/warning-format.d.ts +7 -0
- package/src/watchdog/warning-format.js +59 -0
- package/src/workflows/chat-progress.d.ts +37 -0
- package/src/workflows/chat-progress.js +129 -0
- package/src/workflows/host-command.d.ts +30 -0
- package/src/workflows/host-command.js +227 -0
- package/src/workflows/scripted-workflow.d.ts +204 -0
- package/src/workflows/scripted-workflow.js +1673 -0
- package/src/workflows/structured-workflow-scripts.d.ts +10 -0
- package/src/workflows/structured-workflow-scripts.js +179 -0
- package/src/workflows/workflow-auto-resume.d.ts +32 -0
- package/src/workflows/workflow-auto-resume.js +102 -0
- package/src/workflows/workflow-checklist.d.ts +127 -0
- package/src/workflows/workflow-checklist.js +314 -0
- package/src/workflows/workflow-child-summary.d.ts +24 -0
- package/src/workflows/workflow-child-summary.js +195 -0
- package/src/workflows/workflow-launch-record.d.ts +27 -0
- package/src/workflows/workflow-launch-record.js +48 -0
- package/src/workflows/workflow-preflight.d.ts +58 -0
- package/src/workflows/workflow-preflight.js +288 -0
- package/src/workflows/workflow-receipt.d.ts +34 -0
- package/src/workflows/workflow-receipt.js +454 -0
- package/src/workflows/workflow-resources.d.ts +55 -0
- package/src/workflows/workflow-resources.js +271 -0
- package/src/workflows/workflow-resume-claim.d.ts +82 -0
- package/src/workflows/workflow-resume-claim.js +210 -0
- package/src/workflows/workflow-resume.d.ts +56 -0
- package/src/workflows/workflow-resume.js +106 -0
- package/src/workflows/workflow-reuse.d.ts +61 -0
- package/src/workflows/workflow-reuse.js +186 -0
- package/src/workflows/workflow-revival.d.ts +33 -0
- package/src/workflows/workflow-revival.js +111 -0
- package/src/workflows/workflow-settlement.d.ts +84 -0
- package/src/workflows/workflow-settlement.js +203 -0
- package/src/workflows/workflow-stop-cause.d.ts +6 -0
- package/src/workflows/workflow-stop-cause.js +8 -0
- package/workflow-script-worker.cjs +1342 -0
- package/index.ts +0 -18
- package/node_modules/@xzzpig/pi-components/src/transcript.ts +0 -1878
- package/skills/pi-subagents/references/constraints-and-recipes.md +0 -74
- package/skills/pi-subagents/references/execution-controls.md +0 -561
- package/skills/pi-subagents/references/management-authoring-rpc.md +0 -165
- package/skills/pi-subagents/references/multi-lane-orchestration.md +0 -61
- package/skills/pi-subagents/references/review-and-validation.md +0 -73
- package/src/agents/advertised-agent-prompt.ts +0 -82
- package/src/agents/agent-eject.ts +0 -339
- package/src/agents/agent-management.ts +0 -1442
- package/src/agents/agent-memory.ts +0 -341
- package/src/agents/agent-refinements.ts +0 -624
- package/src/agents/agent-scope.ts +0 -10
- package/src/agents/agent-selection.ts +0 -25
- package/src/agents/agent-serializer.ts +0 -195
- package/src/agents/agents.ts +0 -3169
- package/src/agents/builtin-names.ts +0 -16
- package/src/agents/chain-serializer.ts +0 -285
- package/src/agents/frontmatter.ts +0 -153
- package/src/agents/global-npm-root.ts +0 -58
- package/src/agents/identity.ts +0 -30
- package/src/agents/proactive-skills.ts +0 -197
- package/src/agents/runtime-agent-events.ts +0 -70
- package/src/agents/runtime-agent-registry.ts +0 -457
- package/src/agents/runtime-discovery.ts +0 -39
- package/src/agents/skills.ts +0 -787
- package/src/api/agent-management.ts +0 -9
- package/src/api/agents.ts +0 -19
- package/src/api/background-work.ts +0 -206
- package/src/api/capability-ceiling.ts +0 -16
- package/src/api/child-tool-plan.ts +0 -5
- package/src/api/control-channel.ts +0 -4
- package/src/api/delegation.ts +0 -131
- package/src/api/external-job-provider.ts +0 -195
- package/src/api/external-runs.ts +0 -282
- package/src/api/inspectors.ts +0 -27
- package/src/api/intercom-bridge.ts +0 -3
- package/src/api/preflight.ts +0 -641
- package/src/api/project-panes.ts +0 -32
- package/src/api/required-child-extensions.ts +0 -6
- package/src/api/shared-types.ts +0 -29
- package/src/api/supervisor-routing.ts +0 -196
- package/src/api/workflow-resources.ts +0 -6
- package/src/extension/config.ts +0 -262
- package/src/extension/context-injection.ts +0 -123
- package/src/extension/control-notices.ts +0 -53
- package/src/extension/declaration-pinning.ts +0 -164
- package/src/extension/doctor.ts +0 -284
- package/src/extension/fanout-child.ts +0 -282
- package/src/extension/herdr-pi-bridge.ts +0 -166
- package/src/extension/index.ts +0 -1212
- package/src/extension/public-execution.ts +0 -262
- package/src/extension/reply-workflow-script.ts +0 -67
- package/src/extension/rpc.ts +0 -881
- package/src/extension/schemas.ts +0 -337
- package/src/extension/steering-notices.ts +0 -35
- package/src/extension/subagent-guide.ts +0 -127
- package/src/extension/subagent-options.ts +0 -47
- package/src/extension/tool-activation.ts +0 -147
- package/src/extension/tool-description.ts +0 -193
- package/src/extension/tool-result.ts +0 -19
- package/src/extension/upgrade-notice.ts +0 -40
- package/src/inspectors/actions.ts +0 -174
- package/src/inspectors/ghostty/actions.ts +0 -74
- package/src/inspectors/ghostty/plugin.ts +0 -29
- package/src/inspectors/herdr/actions.ts +0 -155
- package/src/inspectors/herdr/client.ts +0 -130
- package/src/inspectors/herdr/focus.ts +0 -55
- package/src/inspectors/herdr/plugin.ts +0 -20
- package/src/inspectors/herdr/project-panes.ts +0 -733
- package/src/inspectors/inspector-runner.ts +0 -153
- package/src/inspectors/plugins.ts +0 -76
- package/src/inspectors/session-roots-codec.ts +0 -31
- package/src/inspectors/shell-command.ts +0 -16
- package/src/inspectors/tmux/actions.ts +0 -204
- package/src/inspectors/tmux/client.ts +0 -85
- package/src/inspectors/tmux/plugin.ts +0 -21
- package/src/inspectors/types.ts +0 -51
- package/src/integrations/herdr-status.ts +0 -385
- package/src/integrations/pi-web-session-liveness.ts +0 -73
- package/src/integrations/program-status.ts +0 -215
- package/src/intercom/fork-supervisor-routing.ts +0 -533
- package/src/intercom/intercom-bridge.ts +0 -235
- package/src/intercom/native-supervisor-channel.ts +0 -1066
- package/src/intercom/result-intercom.ts +0 -433
- package/src/intercom/supervisor-ui.ts +0 -72
- package/src/missions/actions.ts +0 -433
- package/src/missions/goal-driver.ts +0 -177
- package/src/missions/lifecycle.ts +0 -367
- package/src/missions/store.ts +0 -613
- package/src/missions/types.ts +0 -190
- package/src/missions/workflow-state.ts +0 -281
- package/src/policy/authority.ts +0 -50
- package/src/profiles/profiles.ts +0 -674
- package/src/runs/background/active-async-capacity.ts +0 -548
- package/src/runs/background/active-run-index.ts +0 -155
- package/src/runs/background/async-execution.ts +0 -2479
- package/src/runs/background/async-job-tracker.ts +0 -869
- package/src/runs/background/async-resume.ts +0 -686
- package/src/runs/background/async-retention.ts +0 -953
- package/src/runs/background/async-status-snapshot.ts +0 -46
- package/src/runs/background/async-status.ts +0 -787
- package/src/runs/background/auto-drain.ts +0 -92
- package/src/runs/background/await-async-run.ts +0 -83
- package/src/runs/background/binary-bootstrap.ts +0 -67
- package/src/runs/background/calendar-schedule.ts +0 -90
- package/src/runs/background/chain-append.ts +0 -321
- package/src/runs/background/chain-root-attachment.ts +0 -263
- package/src/runs/background/completion-batcher.ts +0 -168
- package/src/runs/background/completion-dedupe.ts +0 -58
- package/src/runs/background/completion-replay.ts +0 -287
- package/src/runs/background/control-channel.ts +0 -659
- package/src/runs/background/fleet-view.ts +0 -692
- package/src/runs/background/index-segment.ts +0 -59
- package/src/runs/background/inspect-rpc.ts +0 -443
- package/src/runs/background/notify.ts +0 -1083
- package/src/runs/background/owned-process-tree.ts +0 -131
- package/src/runs/background/parallel-groups.ts +0 -45
- package/src/runs/background/pid-namespace.ts +0 -18
- package/src/runs/background/process-terminal-candidate.ts +0 -98
- package/src/runs/background/process-terminal.ts +0 -231
- package/src/runs/background/result-delivery-ownership.ts +0 -45
- package/src/runs/background/result-files.ts +0 -634
- package/src/runs/background/result-watcher.ts +0 -842
- package/src/runs/background/resume-guidance.ts +0 -56
- package/src/runs/background/retained-children.ts +0 -136
- package/src/runs/background/retained-nested-route-tracker.ts +0 -96
- package/src/runs/background/run-child-session.ts +0 -725
- package/src/runs/background/run-id-query.ts +0 -7
- package/src/runs/background/run-id-resolver.ts +0 -183
- package/src/runs/background/run-status.ts +0 -803
- package/src/runs/background/runner-aliases.ts +0 -183
- package/src/runs/background/runner-child-launch.ts +0 -96
- package/src/runs/background/runner-child-sessions.ts +0 -32
- package/src/runs/background/runner-http-dispatcher.ts +0 -122
- package/src/runs/background/runner-startup-failure.ts +0 -56
- package/src/runs/background/scheduled-runs.ts +0 -1222
- package/src/runs/background/stale-run-reconciler.ts +0 -463
- package/src/runs/background/steering.ts +0 -260
- package/src/runs/background/subagent-runner-bootstrap.ts +0 -279
- package/src/runs/background/subagent-runner.ts +0 -5251
- package/src/runs/background/subagent-wait.ts +0 -895
- package/src/runs/background/terminal-run-index.ts +0 -183
- package/src/runs/background/top-level-async.ts +0 -14
- package/src/runs/background/wait-completions.ts +0 -262
- package/src/runs/background/wait-config.ts +0 -50
- package/src/runs/background/wait-subscriptions.ts +0 -354
- package/src/runs/background/wait-tool.ts +0 -57
- package/src/runs/background/workflow-terminal-proof.ts +0 -85
- package/src/runs/foreground/async-dismiss-action.ts +0 -86
- package/src/runs/foreground/async-steering-action.ts +0 -276
- package/src/runs/foreground/async-stop-action.ts +0 -216
- package/src/runs/foreground/command-action.ts +0 -41
- package/src/runs/foreground/execution.ts +0 -2315
- package/src/runs/foreground/foreground-control.ts +0 -157
- package/src/runs/foreground/foreground-history.ts +0 -164
- package/src/runs/foreground/prompt-audit.ts +0 -172
- package/src/runs/foreground/subagent-executor.ts +0 -8252
- package/src/runs/foreground/workflow-detach-reconcile.ts +0 -304
- package/src/runs/foreground/workflow-foreground-steering.ts +0 -169
- package/src/runs/shared/abort-recovery.ts +0 -119
- package/src/runs/shared/acceptance.ts +0 -1664
- package/src/runs/shared/agent-contract.ts +0 -38
- package/src/runs/shared/async-status-projection.ts +0 -664
- package/src/runs/shared/background-process-options.ts +0 -9
- package/src/runs/shared/capability-ceiling.ts +0 -214
- package/src/runs/shared/chain-outputs.ts +0 -116
- package/src/runs/shared/child-commands.ts +0 -229
- package/src/runs/shared/child-hooks.ts +0 -175
- package/src/runs/shared/child-identity.ts +0 -62
- package/src/runs/shared/child-launch-plan.ts +0 -163
- package/src/runs/shared/child-launch.ts +0 -389
- package/src/runs/shared/child-lifecycle.ts +0 -28
- package/src/runs/shared/child-runtime-config.ts +0 -136
- package/src/runs/shared/child-session.ts +0 -699
- package/src/runs/shared/child-tool-plan.ts +0 -599
- package/src/runs/shared/claude-code-adapter.ts +0 -288
- package/src/runs/shared/codex-exec-adapter.ts +0 -129
- package/src/runs/shared/context-mode.ts +0 -44
- package/src/runs/shared/cursor-agent-adapter.ts +0 -114
- package/src/runs/shared/dynamic-fanout.ts +0 -297
- package/src/runs/shared/effective-system-prompt.ts +0 -33
- package/src/runs/shared/extension-bindings.ts +0 -103
- package/src/runs/shared/external-cli-contract.ts +0 -177
- package/src/runs/shared/external-cli-preflight.ts +0 -190
- package/src/runs/shared/external-cli-runner.ts +0 -437
- package/src/runs/shared/external-job-bridge.ts +0 -514
- package/src/runs/shared/external-job-runner.ts +0 -389
- package/src/runs/shared/fast-mode-extension.ts +0 -10
- package/src/runs/shared/fork-command-result.ts +0 -10
- package/src/runs/shared/git-environment.ts +0 -29
- package/src/runs/shared/herdr-connection.ts +0 -134
- package/src/runs/shared/herdr-external-adapters.ts +0 -169
- package/src/runs/shared/herdr-machine.ts +0 -279
- package/src/runs/shared/herdr-pi-protocol.ts +0 -59
- package/src/runs/shared/herdr-placed-run.ts +0 -264
- package/src/runs/shared/host-step-status.ts +0 -231
- package/src/runs/shared/lane-metadata.ts +0 -126
- package/src/runs/shared/launch-cwd.ts +0 -16
- package/src/runs/shared/long-running-guard.ts +0 -221
- package/src/runs/shared/mcp-config-sources.ts +0 -426
- package/src/runs/shared/mcp-direct-tool-allowlist.ts +0 -579
- package/src/runs/shared/mcp-direct-tool-grant.ts +0 -210
- package/src/runs/shared/model-resolution-diagnostic.ts +0 -101
- package/src/runs/shared/model-resolution.ts +0 -503
- package/src/runs/shared/model-scope.ts +0 -224
- package/src/runs/shared/mutation-evidence.ts +0 -199
- package/src/runs/shared/nested-events.ts +0 -1125
- package/src/runs/shared/nested-path.ts +0 -38
- package/src/runs/shared/nested-render.ts +0 -127
- package/src/runs/shared/orca-progress-tabs.ts +0 -511
- package/src/runs/shared/parallel-handoff.ts +0 -789
- package/src/runs/shared/parallel-utils.ts +0 -292
- package/src/runs/shared/partial-output.ts +0 -48
- package/src/runs/shared/permissions.ts +0 -86
- package/src/runs/shared/pi-spawn.ts +0 -205
- package/src/runs/shared/process-signal.ts +0 -35
- package/src/runs/shared/profile-extensions.ts +0 -134
- package/src/runs/shared/profile-launch-env.ts +0 -121
- package/src/runs/shared/readonly-drain-observation.ts +0 -42
- package/src/runs/shared/run-fanout-budget.ts +0 -267
- package/src/runs/shared/run-history.ts +0 -288
- package/src/runs/shared/runner-launcher.ts +0 -25
- package/src/runs/shared/runtime-acknowledged-extensions.ts +0 -44
- package/src/runs/shared/sandbox-profile-guard.ts +0 -119
- package/src/runs/shared/sandbox-startup-diagnostics.ts +0 -54
- package/src/runs/shared/session-lease.ts +0 -293
- package/src/runs/shared/single-output.ts +0 -366
- package/src/runs/shared/spawn-budget.ts +0 -128
- package/src/runs/shared/structured-output.ts +0 -463
- package/src/runs/shared/subagent-control.ts +0 -295
- package/src/runs/shared/subagent-prompt-runtime.ts +0 -598
- package/src/runs/shared/tool-availability.ts +0 -37
- package/src/runs/shared/tool-budget.ts +0 -87
- package/src/runs/shared/tool-timeout.ts +0 -93
- package/src/runs/shared/usage-budget.ts +0 -65
- package/src/runs/shared/usage-reconciliation.ts +0 -73
- package/src/runs/shared/workflow-async-child-guidance.ts +0 -18
- package/src/runs/shared/workflow-graph.ts +0 -225
- package/src/runs/shared/worktree-cleanup-apply.ts +0 -160
- package/src/runs/shared/worktree-cleanup-plan.ts +0 -891
- package/src/runs/shared/worktree-lock.ts +0 -29
- package/src/runs/shared/worktree-setup-command.ts +0 -213
- package/src/runs/shared/worktree.ts +0 -1554
- package/src/shared/accessible-dir.ts +0 -47
- package/src/shared/agent-stream-options.ts +0 -5
- package/src/shared/artifacts.ts +0 -281
- package/src/shared/atomic-json.ts +0 -85
- package/src/shared/capacity-resilient-json.ts +0 -102
- package/src/shared/child-cache-retention.ts +0 -43
- package/src/shared/child-session-name.ts +0 -48
- package/src/shared/child-transcript.ts +0 -264
- package/src/shared/completion-owner.ts +0 -14
- package/src/shared/disabled-features.ts +0 -123
- package/src/shared/display-text.ts +0 -150
- package/src/shared/edit-distance.ts +0 -33
- package/src/shared/extension-context.ts +0 -37
- package/src/shared/file-coalescer.ts +0 -49
- package/src/shared/file-lease.ts +0 -74
- package/src/shared/file-system-retry.ts +0 -95
- package/src/shared/fork-context.ts +0 -243
- package/src/shared/fork-session-cwd.ts +0 -27
- package/src/shared/formatters.ts +0 -142
- package/src/shared/jsonl-writer.ts +0 -92
- package/src/shared/launch-contract.ts +0 -206
- package/src/shared/model-info.ts +0 -132
- package/src/shared/model-response-aliases.ts +0 -13
- package/src/shared/node-executable.ts +0 -21
- package/src/shared/opencode-session-headers.ts +0 -30
- package/src/shared/package-version.ts +0 -17
- package/src/shared/parent-wake.ts +0 -79
- package/src/shared/permission-profile.ts +0 -56
- package/src/shared/prompt-resources.ts +0 -11
- package/src/shared/pruned-fork.ts +0 -469
- package/src/shared/required-child-extensions.ts +0 -115
- package/src/shared/runtime-module-path.ts +0 -19
- package/src/shared/sandbox-profile.ts +0 -37
- package/src/shared/session-file-trust.ts +0 -19
- package/src/shared/session-identity.ts +0 -10
- package/src/shared/session-tokens.ts +0 -55
- package/src/shared/settings-file-lease.ts +0 -36
- package/src/shared/settings.ts +0 -412
- package/src/shared/shortcuts.ts +0 -13
- package/src/shared/status-format.ts +0 -55
- package/src/shared/thinking-ceiling.ts +0 -46
- package/src/shared/types.ts +0 -3105
- package/src/shared/utf8.ts +0 -11
- package/src/shared/utils.ts +0 -610
- package/src/shared/watch-strategy.ts +0 -12
- package/src/shared/workflow-child-permit.ts +0 -212
- package/src/slash/delegation-adapters.ts +0 -452
- package/src/slash/delegation-json.ts +0 -108
- package/src/slash/delegation-request.ts +0 -176
- package/src/slash/prompt-template-bridge.ts +0 -435
- package/src/slash/prompt-workflows.ts +0 -298
- package/src/slash/selector.ts +0 -147
- package/src/slash/slash-bridge.ts +0 -192
- package/src/slash/slash-commands.ts +0 -1096
- package/src/slash/slash-live-state.ts +0 -310
- package/src/slash/subagent-cost.ts +0 -317
- package/src/slash/subagents-admin.ts +0 -489
- package/src/tui/fleet-native-transcript.ts +0 -424
- package/src/tui/fleet-status.ts +0 -1139
- package/src/tui/fleet-transcript.ts +0 -591
- package/src/tui/fleet.ts +0 -1618
- package/src/tui/mouse-events.ts +0 -42
- package/src/tui/render-helpers.ts +0 -111
- package/src/tui/render.ts +0 -3824
- package/src/tui/running-tone.ts +0 -28
- package/src/tui/subagent-messages.ts +0 -305
- package/src/ui-silent-marker.ts +0 -32
- package/src/watchdog/change-signature.ts +0 -260
- package/src/watchdog/child-status.ts +0 -225
- package/src/watchdog/diff-tool.ts +0 -112
- package/src/watchdog/emission-guard.ts +0 -125
- package/src/watchdog/guidance.ts +0 -20
- package/src/watchdog/lsp-diagnostics.ts +0 -538
- package/src/watchdog/model-selection.ts +0 -187
- package/src/watchdog/permission-arbiter.ts +0 -154
- package/src/watchdog/register-child.ts +0 -136
- package/src/watchdog/register-main.ts +0 -425
- package/src/watchdog/render.ts +0 -31
- package/src/watchdog/review.ts +0 -362
- package/src/watchdog/rules.ts +0 -70
- package/src/watchdog/runtime.ts +0 -927
- package/src/watchdog/scope.ts +0 -51
- package/src/watchdog/settings.ts +0 -520
- package/src/watchdog/tool-actions.ts +0 -156
- package/src/watchdog/turn-delta.ts +0 -190
- package/src/watchdog/types.ts +0 -186
- package/src/watchdog/warning-format.ts +0 -72
- package/src/workflows/chat-progress.ts +0 -152
- package/src/workflows/host-command.ts +0 -235
- package/src/workflows/scripted-workflow.ts +0 -2733
- package/src/workflows/structured-workflow-scripts.ts +0 -177
- package/src/workflows/workflow-checklist.ts +0 -442
- package/src/workflows/workflow-child-summary.ts +0 -172
- package/src/workflows/workflow-preflight.ts +0 -297
- package/src/workflows/workflow-receipt.ts +0 -390
- package/src/workflows/workflow-resources.ts +0 -275
- package/src/workflows/workflow-reuse.ts +0 -120
- package/src/workflows/workflow-revival.ts +0 -123
- package/src/workflows/workflow-settlement.ts +0 -252
|
@@ -1,1878 +0,0 @@
|
|
|
1
|
-
import {
|
|
2
|
-
AssistantMessageComponent,
|
|
3
|
-
getMarkdownTheme,
|
|
4
|
-
initTheme,
|
|
5
|
-
ToolExecutionComponent,
|
|
6
|
-
UserMessageComponent,
|
|
7
|
-
} from "@earendil-works/pi-coding-agent";
|
|
8
|
-
import type { ToolDefinition } from "@earendil-works/pi-coding-agent";
|
|
9
|
-
import {
|
|
10
|
-
matchesKey,
|
|
11
|
-
truncateToWidth,
|
|
12
|
-
visibleWidth,
|
|
13
|
-
wrapTextWithAnsi,
|
|
14
|
-
} from "@earendil-works/pi-tui";
|
|
15
|
-
|
|
16
|
-
/**
|
|
17
|
-
* Structural subset of Pi's theme used by transcript rendering.
|
|
18
|
-
* Pi theme-key unions vary across supported SDK versions, while the public
|
|
19
|
-
* transcript API only passes named string keys.
|
|
20
|
-
*/
|
|
21
|
-
export interface TranscriptTheme {
|
|
22
|
-
fg(color: string, text: string): string;
|
|
23
|
-
bg(color: string, text: string): string;
|
|
24
|
-
bold(text: string): string;
|
|
25
|
-
}
|
|
26
|
-
|
|
27
|
-
/** Structural subset of Pi's TUI used by the scroll viewport. */
|
|
28
|
-
export interface TranscriptTui {
|
|
29
|
-
requestRender(): void;
|
|
30
|
-
}
|
|
31
|
-
|
|
32
|
-
/**
|
|
33
|
-
* Structured tool result payload as delivered by agent session events. It is
|
|
34
|
-
* stored verbatim so Pi's native tool renderers receive the same shape the
|
|
35
|
-
* main transcript would.
|
|
36
|
-
*/
|
|
37
|
-
export interface TranscriptToolResultPayload {
|
|
38
|
-
content?: Array<{
|
|
39
|
-
type?: string;
|
|
40
|
-
text?: string;
|
|
41
|
-
data?: string;
|
|
42
|
-
mimeType?: string;
|
|
43
|
-
}>;
|
|
44
|
-
details?: unknown;
|
|
45
|
-
}
|
|
46
|
-
|
|
47
|
-
/**
|
|
48
|
-
* Host context used to construct Pi's native `ToolExecutionComponent`
|
|
49
|
-
* instances. Every field is optional: missing values fall back to a detached
|
|
50
|
-
* stub TUI and `process.cwd()`.
|
|
51
|
-
*/
|
|
52
|
-
export interface NativeToolRenderOptions {
|
|
53
|
-
/** Structural TUI subset; only `requestRender` is required. */
|
|
54
|
-
tui?: TranscriptTui;
|
|
55
|
-
/** Working directory used to resolve built-in tool definitions. */
|
|
56
|
-
cwd?: string;
|
|
57
|
-
/** Resolver for extension-registered custom tool definitions. */
|
|
58
|
-
resolveToolDefinition?: (toolName: string) => ToolDefinition | undefined;
|
|
59
|
-
/** Pass-through for Pi's image rendering settings. */
|
|
60
|
-
showImages?: boolean;
|
|
61
|
-
imageWidthCells?: number;
|
|
62
|
-
/** Initial expanded state for tool output. */
|
|
63
|
-
expanded?: boolean;
|
|
64
|
-
}
|
|
65
|
-
|
|
66
|
-
/** Structural lookup accepted by render functions; maps satisfy this. */
|
|
67
|
-
export interface ToolComponentLookup {
|
|
68
|
-
get(toolCallId: string): ToolExecutionComponent | undefined;
|
|
69
|
-
}
|
|
70
|
-
|
|
71
|
-
/** Full TUI type expected by Pi's component constructor. */
|
|
72
|
-
type NativeToolTui = NonNullable<
|
|
73
|
-
ConstructorParameters<typeof ToolExecutionComponent>[5]
|
|
74
|
-
>;
|
|
75
|
-
|
|
76
|
-
type Theme = TranscriptTheme;
|
|
77
|
-
type ThemeColor = string;
|
|
78
|
-
type ThemeBackground = string;
|
|
79
|
-
|
|
80
|
-
export type TranscriptNoticeTone = "info" | "warning" | "error";
|
|
81
|
-
|
|
82
|
-
/**
|
|
83
|
-
* How a turn ended. A host that distinguishes a completed exchange from one the
|
|
84
|
-
* user aborted or that failed records it on the turn's end boundary; rendering
|
|
85
|
-
* treats every finished turn the same, so this stays metadata for hosts/tests.
|
|
86
|
-
*/
|
|
87
|
-
export type TranscriptTurnOutcome = "completed" | "aborted" | "failed";
|
|
88
|
-
|
|
89
|
-
export type TranscriptEntry =
|
|
90
|
-
| {
|
|
91
|
-
id: number;
|
|
92
|
-
turnId: number;
|
|
93
|
-
type: "turn-boundary";
|
|
94
|
-
phase: "start" | "end";
|
|
95
|
-
/** Present on `end` boundaries when the host reported how the turn ended. */
|
|
96
|
-
outcome?: TranscriptTurnOutcome;
|
|
97
|
-
}
|
|
98
|
-
| { id: number; turnId: number; type: "user-message"; text: string }
|
|
99
|
-
| {
|
|
100
|
-
id: number;
|
|
101
|
-
turnId: number;
|
|
102
|
-
type: "thinking";
|
|
103
|
-
text: string;
|
|
104
|
-
streaming: boolean;
|
|
105
|
-
}
|
|
106
|
-
| {
|
|
107
|
-
id: number;
|
|
108
|
-
turnId: number;
|
|
109
|
-
type: "assistant-text";
|
|
110
|
-
text: string;
|
|
111
|
-
streaming: boolean;
|
|
112
|
-
}
|
|
113
|
-
| {
|
|
114
|
-
id: number;
|
|
115
|
-
turnId: number;
|
|
116
|
-
type: "tool-call";
|
|
117
|
-
toolCallId: string;
|
|
118
|
-
toolName: string;
|
|
119
|
-
/** Raw provider arguments object, preserved for native renderers. */
|
|
120
|
-
args: unknown;
|
|
121
|
-
}
|
|
122
|
-
| {
|
|
123
|
-
id: number;
|
|
124
|
-
turnId: number;
|
|
125
|
-
type: "tool-result";
|
|
126
|
-
toolCallId: string;
|
|
127
|
-
toolName: string;
|
|
128
|
-
/** Raw structured result; `null` until the first result arrives. */
|
|
129
|
-
result: TranscriptToolResultPayload | null;
|
|
130
|
-
isError: boolean;
|
|
131
|
-
streaming: boolean;
|
|
132
|
-
}
|
|
133
|
-
| {
|
|
134
|
-
id: number;
|
|
135
|
-
turnId: number;
|
|
136
|
-
type: "notice";
|
|
137
|
-
text: string;
|
|
138
|
-
tone: TranscriptNoticeTone;
|
|
139
|
-
};
|
|
140
|
-
|
|
141
|
-
interface ActiveAssistantSegment {
|
|
142
|
-
turnId: number;
|
|
143
|
-
thinkingEntryId?: number;
|
|
144
|
-
textEntryId?: number;
|
|
145
|
-
}
|
|
146
|
-
|
|
147
|
-
export interface TranscriptState {
|
|
148
|
-
entries: TranscriptEntry[];
|
|
149
|
-
nextEntryId: number;
|
|
150
|
-
nextTurnId: number;
|
|
151
|
-
currentTurnId: number | null;
|
|
152
|
-
lastTurnId: number | null;
|
|
153
|
-
activeAssistant: ActiveAssistantSegment | null;
|
|
154
|
-
toolCalls: Map<
|
|
155
|
-
string,
|
|
156
|
-
{ turnId: number; callEntryId: number; resultEntryId?: number }
|
|
157
|
-
>;
|
|
158
|
-
/** Persistent native tool components keyed by tool call id. */
|
|
159
|
-
toolComponents: TranscriptToolComponents;
|
|
160
|
-
/** Argument char cap applied to every recorded tool call. */
|
|
161
|
-
toolArgsCharLimit: number;
|
|
162
|
-
}
|
|
163
|
-
|
|
164
|
-
export interface SessionTranscriptOptions extends NativeToolRenderOptions {
|
|
165
|
-
/** Maximum retained entries. Oldest entries are discarded first. */
|
|
166
|
-
maxEntries?: number;
|
|
167
|
-
/** Maximum retained text across all entries. */
|
|
168
|
-
maxChars?: number;
|
|
169
|
-
/**
|
|
170
|
-
* Per-tool-call argument size cap in JSON characters. Oversized arguments
|
|
171
|
-
* are replaced by a truncated marker object so pathological payloads cannot
|
|
172
|
-
* break rendering or memory bounds. Defaults to 64 KiB.
|
|
173
|
-
*/
|
|
174
|
-
maxToolArgsChars?: number;
|
|
175
|
-
}
|
|
176
|
-
|
|
177
|
-
const DEFAULT_MAX_ENTRIES = 500;
|
|
178
|
-
const DEFAULT_MAX_CHARS = 512 * 1024;
|
|
179
|
-
const DEFAULT_MAX_TOOL_ARGS_CHARS = 64 * 1024;
|
|
180
|
-
|
|
181
|
-
let themeEnsured = false;
|
|
182
|
-
|
|
183
|
-
/**
|
|
184
|
-
* The SDK shares its global theme across module instances (tsx/jiti/host) via
|
|
185
|
-
* these globalThis symbols — the same keys its exported `theme` proxy checks
|
|
186
|
-
* before throwing "Theme not initialized" (see theme.js in pi-coding-agent).
|
|
187
|
-
* Both historical and current spellings are probed for older host support.
|
|
188
|
-
*/
|
|
189
|
-
const THEME_GLOBAL_KEY = Symbol.for("@earendil-works/pi-coding-agent:theme");
|
|
190
|
-
const THEME_GLOBAL_KEY_OLD = Symbol.for("@mariozechner/pi-coding-agent:theme");
|
|
191
|
-
|
|
192
|
-
function isTranscriptThemeInitialized(): boolean {
|
|
193
|
-
// SAFETY: the SDK stores its theme on globalThis under a symbol key; the
|
|
194
|
-
// proxy does `if (!t) throw` on the same lookup, so a defined value means
|
|
195
|
-
// a fully constructed Theme instance the proxy will hand back directly.
|
|
196
|
-
const globals = globalThis as unknown as Record<PropertyKey, unknown>;
|
|
197
|
-
return (
|
|
198
|
-
globals[THEME_GLOBAL_KEY] !== undefined ||
|
|
199
|
-
globals[THEME_GLOBAL_KEY_OLD] !== undefined
|
|
200
|
-
);
|
|
201
|
-
}
|
|
202
|
-
|
|
203
|
-
/**
|
|
204
|
-
* Ensures Pi's global theme is initialized so native message/tool components
|
|
205
|
-
* can render outside a live interactive session (headless embeds, unit tests).
|
|
206
|
-
*
|
|
207
|
-
* IMPORTANT: when the host has already initialized the theme (interactive Pi
|
|
208
|
-
* installs the user's chosen theme before any transcript renders), this is a
|
|
209
|
-
* strict no-op. Re-calling `initTheme()` would re-resolve the default theme
|
|
210
|
-
* from environment detection and can silently replace the user's selection
|
|
211
|
-
* with the dark fallback — changing tool-call colors in the main session too.
|
|
212
|
-
*/
|
|
213
|
-
export function ensureTranscriptTheme(): void {
|
|
214
|
-
if (themeEnsured) return;
|
|
215
|
-
themeEnsured = true;
|
|
216
|
-
if (isTranscriptThemeInitialized()) return;
|
|
217
|
-
initTheme();
|
|
218
|
-
}
|
|
219
|
-
|
|
220
|
-
const DETACHED_TUI: TranscriptTui = { requestRender() {} };
|
|
221
|
-
|
|
222
|
-
/**
|
|
223
|
-
* Owns the persistent `ToolExecutionComponent` instance for every live tool
|
|
224
|
-
* call, mirroring how Pi's interactive mode keeps pending components keyed by
|
|
225
|
-
* `toolCallId`. Instances are updated incrementally as events arrive and are
|
|
226
|
-
* pruned by the host once their transcript entries disappear.
|
|
227
|
-
*/
|
|
228
|
-
export class TranscriptToolComponents implements ToolComponentLookup {
|
|
229
|
-
private readonly components = new Map<string, ToolExecutionComponent>();
|
|
230
|
-
private readonly options: NativeToolRenderOptions;
|
|
231
|
-
private attachedTui: TranscriptTui | null;
|
|
232
|
-
/**
|
|
233
|
-
* Components capture their TUI at construction. This forwarder lets a host
|
|
234
|
-
* attach (or replace) the real TUI at any time — including after tool
|
|
235
|
-
* events already created instances — without rebuilding them.
|
|
236
|
-
*/
|
|
237
|
-
private readonly forwardedTui: TranscriptTui;
|
|
238
|
-
|
|
239
|
-
constructor(options: NativeToolRenderOptions = {}) {
|
|
240
|
-
this.options = options;
|
|
241
|
-
this.attachedTui = options.tui ?? null;
|
|
242
|
-
this.forwardedTui = {
|
|
243
|
-
requestRender: () => this.attachedTui?.requestRender(),
|
|
244
|
-
};
|
|
245
|
-
}
|
|
246
|
-
|
|
247
|
-
/** Wires (or replaces) the host TUI that receives repaint requests. */
|
|
248
|
-
attachTui(tui: TranscriptTui): void {
|
|
249
|
-
this.attachedTui = tui;
|
|
250
|
-
}
|
|
251
|
-
|
|
252
|
-
get size(): number {
|
|
253
|
-
return this.components.size;
|
|
254
|
-
}
|
|
255
|
-
|
|
256
|
-
has(toolCallId: string): boolean {
|
|
257
|
-
return this.components.has(toolCallId);
|
|
258
|
-
}
|
|
259
|
-
|
|
260
|
-
get(toolCallId: string): ToolExecutionComponent | undefined {
|
|
261
|
-
return this.components.get(toolCallId);
|
|
262
|
-
}
|
|
263
|
-
|
|
264
|
-
handleStart(toolCallId: string, toolName: string, args: unknown): void {
|
|
265
|
-
const component = this.ensure(toolCallId, toolName);
|
|
266
|
-
if (this.createdWithoutArgs.delete(toolCallId)) {
|
|
267
|
-
component.updateArgs(args ?? {});
|
|
268
|
-
}
|
|
269
|
-
component.setArgsComplete();
|
|
270
|
-
component.markExecutionStarted();
|
|
271
|
-
this.requestRender();
|
|
272
|
-
}
|
|
273
|
-
|
|
274
|
-
handleUpdate(
|
|
275
|
-
toolCallId: string,
|
|
276
|
-
toolName: string,
|
|
277
|
-
partialResult: unknown,
|
|
278
|
-
): void {
|
|
279
|
-
const component = this.ensure(toolCallId, toolName);
|
|
280
|
-
component.updateResult(toComponentResult(partialResult, false), true);
|
|
281
|
-
this.requestRender();
|
|
282
|
-
}
|
|
283
|
-
|
|
284
|
-
handleEnd(
|
|
285
|
-
toolCallId: string,
|
|
286
|
-
toolName: string,
|
|
287
|
-
result: unknown,
|
|
288
|
-
isError: boolean,
|
|
289
|
-
): void {
|
|
290
|
-
const component = this.ensure(toolCallId, toolName);
|
|
291
|
-
component.updateResult(toComponentResult(result, isError), false);
|
|
292
|
-
this.requestRender();
|
|
293
|
-
}
|
|
294
|
-
|
|
295
|
-
/** Drops instances whose transcript entries no longer exist. */
|
|
296
|
-
retainOnly(aliveToolCallIds: ReadonlySet<string>): void {
|
|
297
|
-
for (const toolCallId of this.components.keys()) {
|
|
298
|
-
if (!aliveToolCallIds.has(toolCallId)) this.components.delete(toolCallId);
|
|
299
|
-
}
|
|
300
|
-
}
|
|
301
|
-
|
|
302
|
-
clear(): void {
|
|
303
|
-
this.components.clear();
|
|
304
|
-
}
|
|
305
|
-
|
|
306
|
-
private ensure(toolCallId: string, toolName: string): ToolExecutionComponent {
|
|
307
|
-
const existing = this.components.get(toolCallId);
|
|
308
|
-
if (existing) return existing;
|
|
309
|
-
// Results may arrive before their start event; remember the placeholder so
|
|
310
|
-
// handleStart can backfill the real arguments later.
|
|
311
|
-
this.createdWithoutArgs.add(toolCallId);
|
|
312
|
-
const component = new ToolExecutionComponent(
|
|
313
|
-
toolName,
|
|
314
|
-
toolCallId,
|
|
315
|
-
{},
|
|
316
|
-
{
|
|
317
|
-
showImages: this.options.showImages,
|
|
318
|
-
imageWidthCells: this.options.imageWidthCells,
|
|
319
|
-
},
|
|
320
|
-
this.options.resolveToolDefinition?.(toolName),
|
|
321
|
-
// Forwards to the attached host TUI; only requestRender is invoked.
|
|
322
|
-
this.forwardedTui as NativeToolTui,
|
|
323
|
-
this.options.cwd ?? process.cwd(),
|
|
324
|
-
);
|
|
325
|
-
if (this.options.expanded) component.setExpanded(true);
|
|
326
|
-
this.components.set(toolCallId, component);
|
|
327
|
-
return component;
|
|
328
|
-
}
|
|
329
|
-
|
|
330
|
-
private requestRender(): void {
|
|
331
|
-
// Matches Pi's interactive mode, which repaints after every tool event.
|
|
332
|
-
this.attachedTui?.requestRender();
|
|
333
|
-
}
|
|
334
|
-
|
|
335
|
-
private readonly createdWithoutArgs = new Set<string>();
|
|
336
|
-
}
|
|
337
|
-
|
|
338
|
-
function toComponentResult(
|
|
339
|
-
value: unknown,
|
|
340
|
-
isError: boolean,
|
|
341
|
-
): {
|
|
342
|
-
content: Array<{
|
|
343
|
-
type: string;
|
|
344
|
-
text?: string;
|
|
345
|
-
data?: string;
|
|
346
|
-
mimeType?: string;
|
|
347
|
-
}>;
|
|
348
|
-
details?: unknown;
|
|
349
|
-
isError: boolean;
|
|
350
|
-
} {
|
|
351
|
-
const payload =
|
|
352
|
-
value && typeof value === "object"
|
|
353
|
-
? (value as TranscriptToolResultPayload)
|
|
354
|
-
: {};
|
|
355
|
-
const content = Array.isArray(payload.content)
|
|
356
|
-
? payload.content.map((part) => ({
|
|
357
|
-
type: part?.type ?? "text",
|
|
358
|
-
text: part?.text,
|
|
359
|
-
data: part?.data,
|
|
360
|
-
mimeType: part?.mimeType,
|
|
361
|
-
}))
|
|
362
|
-
: [];
|
|
363
|
-
return { content, details: payload.details, isError };
|
|
364
|
-
}
|
|
365
|
-
|
|
366
|
-
export function createTranscriptState(
|
|
367
|
-
nativeTools: NativeToolRenderOptions & SessionTranscriptOptions = {},
|
|
368
|
-
): TranscriptState {
|
|
369
|
-
return {
|
|
370
|
-
entries: [],
|
|
371
|
-
nextEntryId: 1,
|
|
372
|
-
nextTurnId: 1,
|
|
373
|
-
currentTurnId: null,
|
|
374
|
-
lastTurnId: null,
|
|
375
|
-
activeAssistant: null,
|
|
376
|
-
toolCalls: new Map(),
|
|
377
|
-
toolComponents: new TranscriptToolComponents(nativeTools),
|
|
378
|
-
toolArgsCharLimit: Math.max(
|
|
379
|
-
16,
|
|
380
|
-
nativeTools.maxToolArgsChars ?? DEFAULT_MAX_TOOL_ARGS_CHARS,
|
|
381
|
-
),
|
|
382
|
-
};
|
|
383
|
-
}
|
|
384
|
-
|
|
385
|
-
function codePointWidth(codePoint: number): 1 | 2 {
|
|
386
|
-
return codePoint > 0xffff ? 2 : 1;
|
|
387
|
-
}
|
|
388
|
-
|
|
389
|
-
function isUnsafeTerminalCodePoint(codePoint: number): boolean {
|
|
390
|
-
return (
|
|
391
|
-
(codePoint <= 0x1f && codePoint !== 0x09 && codePoint !== 0x0a) ||
|
|
392
|
-
(codePoint >= 0x7f && codePoint <= 0x9f) ||
|
|
393
|
-
codePoint === 0x061c ||
|
|
394
|
-
codePoint === 0x200e ||
|
|
395
|
-
codePoint === 0x200f ||
|
|
396
|
-
(codePoint >= 0x202a && codePoint <= 0x202e) ||
|
|
397
|
-
(codePoint >= 0x2066 && codePoint <= 0x2069) ||
|
|
398
|
-
(codePoint >= 0xe000 && codePoint <= 0xf8ff) ||
|
|
399
|
-
(codePoint >= 0xf0000 && codePoint <= 0xffffd) ||
|
|
400
|
-
(codePoint >= 0x100000 && codePoint <= 0x10fffd) ||
|
|
401
|
-
(codePoint >= 0xd800 && codePoint <= 0xdfff) ||
|
|
402
|
-
(codePoint >= 0xfdd0 && codePoint <= 0xfdef) ||
|
|
403
|
-
(codePoint & 0xffff) === 0xfffe ||
|
|
404
|
-
(codePoint & 0xffff) === 0xffff
|
|
405
|
-
);
|
|
406
|
-
}
|
|
407
|
-
|
|
408
|
-
function consumeControlString(
|
|
409
|
-
value: string,
|
|
410
|
-
start: number,
|
|
411
|
-
osc: boolean,
|
|
412
|
-
): number {
|
|
413
|
-
let index = start;
|
|
414
|
-
while (index < value.length) {
|
|
415
|
-
const codePoint = value.codePointAt(index);
|
|
416
|
-
if (codePoint === undefined) break;
|
|
417
|
-
const width = codePointWidth(codePoint);
|
|
418
|
-
if (osc && codePoint === 0x07) return index + width;
|
|
419
|
-
if (codePoint === 0x9c) return index + width;
|
|
420
|
-
if (codePoint === 0x1b && value.charCodeAt(index + 1) === 0x5c)
|
|
421
|
-
return index + 2;
|
|
422
|
-
index += width;
|
|
423
|
-
}
|
|
424
|
-
return value.length;
|
|
425
|
-
}
|
|
426
|
-
|
|
427
|
-
function consumeCsi(value: string, start: number): number {
|
|
428
|
-
let index = start;
|
|
429
|
-
while (index < value.length) {
|
|
430
|
-
const codePoint = value.codePointAt(index);
|
|
431
|
-
if (codePoint === undefined) break;
|
|
432
|
-
const width = codePointWidth(codePoint);
|
|
433
|
-
if (codePoint >= 0x40 && codePoint <= 0x7e) return index + width;
|
|
434
|
-
index += width;
|
|
435
|
-
}
|
|
436
|
-
return value.length;
|
|
437
|
-
}
|
|
438
|
-
|
|
439
|
-
function looksLikeBinaryContent(text: string): boolean {
|
|
440
|
-
if (text.includes("\0")) return true;
|
|
441
|
-
let suspiciousControls = 0;
|
|
442
|
-
let replacementCharacters = 0;
|
|
443
|
-
let codePoints = 0;
|
|
444
|
-
for (const character of text) {
|
|
445
|
-
codePoints++;
|
|
446
|
-
const codePoint = character.codePointAt(0) ?? 0;
|
|
447
|
-
if (codePoint <= 0x08 || (codePoint >= 0x0e && codePoint <= 0x1f))
|
|
448
|
-
suspiciousControls++;
|
|
449
|
-
if (codePoint === 0xfffd) replacementCharacters++;
|
|
450
|
-
}
|
|
451
|
-
return (
|
|
452
|
-
codePoints > 0 &&
|
|
453
|
-
((suspiciousControls >= 4 && suspiciousControls / codePoints >= 0.1) ||
|
|
454
|
-
(replacementCharacters >= 3 && replacementCharacters / codePoints >= 0.1))
|
|
455
|
-
);
|
|
456
|
-
}
|
|
457
|
-
|
|
458
|
-
/** Escapes terminal control sequences in model and tool output before rendering. */
|
|
459
|
-
export function safeTerminalText(value: string): string {
|
|
460
|
-
const normalized = value.replace(/\r\n/g, "\n");
|
|
461
|
-
if (looksLikeBinaryContent(normalized))
|
|
462
|
-
return "[binary content omitted for safe display]";
|
|
463
|
-
|
|
464
|
-
let safe = "";
|
|
465
|
-
for (let index = 0; index < normalized.length; ) {
|
|
466
|
-
const codePoint = normalized.codePointAt(index);
|
|
467
|
-
if (codePoint === undefined) break;
|
|
468
|
-
const width = codePointWidth(codePoint);
|
|
469
|
-
if (codePoint === 0x1b) {
|
|
470
|
-
const next = normalized.charCodeAt(index + 1);
|
|
471
|
-
if (next === 0x5b) {
|
|
472
|
-
index = consumeCsi(normalized, index + 2);
|
|
473
|
-
continue;
|
|
474
|
-
}
|
|
475
|
-
if (
|
|
476
|
-
next === 0x5d ||
|
|
477
|
-
next === 0x50 ||
|
|
478
|
-
next === 0x58 ||
|
|
479
|
-
next === 0x5e ||
|
|
480
|
-
next === 0x5f
|
|
481
|
-
) {
|
|
482
|
-
index = consumeControlString(normalized, index + 2, next === 0x5d);
|
|
483
|
-
continue;
|
|
484
|
-
}
|
|
485
|
-
index += next ? 2 : 1;
|
|
486
|
-
continue;
|
|
487
|
-
}
|
|
488
|
-
if (codePoint === 0x9b) {
|
|
489
|
-
index = consumeCsi(normalized, index + width);
|
|
490
|
-
continue;
|
|
491
|
-
}
|
|
492
|
-
if (
|
|
493
|
-
codePoint === 0x90 ||
|
|
494
|
-
codePoint === 0x98 ||
|
|
495
|
-
codePoint === 0x9d ||
|
|
496
|
-
codePoint === 0x9e ||
|
|
497
|
-
codePoint === 0x9f
|
|
498
|
-
) {
|
|
499
|
-
index = consumeControlString(
|
|
500
|
-
normalized,
|
|
501
|
-
index + width,
|
|
502
|
-
codePoint === 0x9d,
|
|
503
|
-
);
|
|
504
|
-
continue;
|
|
505
|
-
}
|
|
506
|
-
safe += isUnsafeTerminalCodePoint(codePoint)
|
|
507
|
-
? `[U+${codePoint.toString(16).toUpperCase().padStart(4, "0")}]`
|
|
508
|
-
: String.fromCodePoint(codePoint);
|
|
509
|
-
index += width;
|
|
510
|
-
}
|
|
511
|
-
return safe;
|
|
512
|
-
}
|
|
513
|
-
|
|
514
|
-
/**
|
|
515
|
-
* Appends a fully-formed entry, assigning the next sequential id.
|
|
516
|
-
*
|
|
517
|
-
* Public building block for hosts that construct transcripts from historical
|
|
518
|
-
* records instead of live agent events. The entry must be structurally valid
|
|
519
|
-
* for its `type`; ids and array placement are owned by this function.
|
|
520
|
-
*/
|
|
521
|
-
export function appendEntry(
|
|
522
|
-
state: TranscriptState,
|
|
523
|
-
entry: Omit<TranscriptEntry, "id"> & Record<string, unknown>,
|
|
524
|
-
): TranscriptEntry {
|
|
525
|
-
const nextEntry = { ...entry, id: state.nextEntryId++ } as TranscriptEntry;
|
|
526
|
-
state.entries.push(nextEntry);
|
|
527
|
-
return nextEntry;
|
|
528
|
-
}
|
|
529
|
-
|
|
530
|
-
/**
|
|
531
|
-
* Returns the active turn id, opening a new turn (with a start boundary)
|
|
532
|
-
* when none is open. Public building block for historical-record ingestion.
|
|
533
|
-
*/
|
|
534
|
-
export function ensureTurn(state: TranscriptState): number {
|
|
535
|
-
if (state.currentTurnId !== null) return state.currentTurnId;
|
|
536
|
-
const turnId = state.nextTurnId++;
|
|
537
|
-
state.currentTurnId = turnId;
|
|
538
|
-
state.lastTurnId = turnId;
|
|
539
|
-
appendEntry(state, { type: "turn-boundary", turnId, phase: "start" });
|
|
540
|
-
return turnId;
|
|
541
|
-
}
|
|
542
|
-
|
|
543
|
-
/**
|
|
544
|
-
* Finds the most recent entry of `type` inside `turnId`, scanning backwards.
|
|
545
|
-
* Public building block used by upsert-style helpers and hosts that merge
|
|
546
|
-
* repeated records (e.g. streamed message updates persisted as several lines).
|
|
547
|
-
*/
|
|
548
|
-
export function findLatestEntry<TType extends TranscriptEntry["type"]>(
|
|
549
|
-
state: TranscriptState,
|
|
550
|
-
turnId: number,
|
|
551
|
-
type: TType,
|
|
552
|
-
): Extract<TranscriptEntry, { type: TType }> | undefined {
|
|
553
|
-
for (let index = state.entries.length - 1; index >= 0; index--) {
|
|
554
|
-
const entry = state.entries[index];
|
|
555
|
-
if (!entry) continue;
|
|
556
|
-
if (entry.turnId === turnId && entry.type === type) {
|
|
557
|
-
return entry as Extract<TranscriptEntry, { type: TType }>;
|
|
558
|
-
}
|
|
559
|
-
}
|
|
560
|
-
return undefined;
|
|
561
|
-
}
|
|
562
|
-
|
|
563
|
-
/**
|
|
564
|
-
* Closes `turnId` (defaulting to the current turn): appends the end boundary
|
|
565
|
-
* unless one already exists, clears streaming flags on the turn's entries,
|
|
566
|
-
* and updates bookkeeping. Idempotent — finishing an already-finished turn is
|
|
567
|
-
* a no-op for boundary creation. An optional `outcome` is recorded on the end
|
|
568
|
-
* boundary, letting hosts distinguish completed, aborted, and failed turns.
|
|
569
|
-
* Public building block for hosts that know when a replayed exchange is
|
|
570
|
-
* complete.
|
|
571
|
-
*/
|
|
572
|
-
export function finishTurn(
|
|
573
|
-
state: TranscriptState,
|
|
574
|
-
turnId: number | null = state.currentTurnId,
|
|
575
|
-
outcome?: TranscriptTurnOutcome,
|
|
576
|
-
): void {
|
|
577
|
-
if (turnId === null) return;
|
|
578
|
-
const endBoundary = state.entries.find(
|
|
579
|
-
(entry): entry is Extract<TranscriptEntry, { type: "turn-boundary" }> =>
|
|
580
|
-
entry.turnId === turnId &&
|
|
581
|
-
entry.type === "turn-boundary" &&
|
|
582
|
-
entry.phase === "end",
|
|
583
|
-
);
|
|
584
|
-
if (endBoundary) {
|
|
585
|
-
if (outcome !== undefined) endBoundary.outcome = outcome;
|
|
586
|
-
} else {
|
|
587
|
-
appendEntry(state, {
|
|
588
|
-
type: "turn-boundary",
|
|
589
|
-
turnId,
|
|
590
|
-
phase: "end",
|
|
591
|
-
...(outcome === undefined ? {} : { outcome }),
|
|
592
|
-
});
|
|
593
|
-
}
|
|
594
|
-
for (const entry of state.entries) {
|
|
595
|
-
if (entry.turnId !== turnId) continue;
|
|
596
|
-
if (
|
|
597
|
-
entry.type === "thinking" ||
|
|
598
|
-
entry.type === "assistant-text" ||
|
|
599
|
-
entry.type === "tool-result"
|
|
600
|
-
) {
|
|
601
|
-
entry.streaming = false;
|
|
602
|
-
}
|
|
603
|
-
}
|
|
604
|
-
state.lastTurnId = turnId;
|
|
605
|
-
if (state.currentTurnId === turnId) state.currentTurnId = null;
|
|
606
|
-
if (state.activeAssistant?.turnId === turnId) state.activeAssistant = null;
|
|
607
|
-
}
|
|
608
|
-
|
|
609
|
-
export function removeTranscriptTurn(
|
|
610
|
-
state: TranscriptState,
|
|
611
|
-
turnId: number | null,
|
|
612
|
-
): void {
|
|
613
|
-
if (turnId === null) return;
|
|
614
|
-
state.entries = state.entries.filter((entry) => entry.turnId !== turnId);
|
|
615
|
-
for (const [toolCallId, toolCall] of state.toolCalls.entries()) {
|
|
616
|
-
if (toolCall.turnId === turnId) state.toolCalls.delete(toolCallId);
|
|
617
|
-
}
|
|
618
|
-
if (state.currentTurnId === turnId) state.currentTurnId = null;
|
|
619
|
-
if (state.lastTurnId === turnId) state.lastTurnId = null;
|
|
620
|
-
if (state.activeAssistant?.turnId === turnId) state.activeAssistant = null;
|
|
621
|
-
state.toolComponents.retainOnly(new Set(state.toolCalls.keys()));
|
|
622
|
-
}
|
|
623
|
-
|
|
624
|
-
function extractMessageText(message: { content?: unknown }): string {
|
|
625
|
-
if (typeof message.content === "string")
|
|
626
|
-
return safeTerminalText(message.content);
|
|
627
|
-
if (!Array.isArray(message.content)) return "";
|
|
628
|
-
|
|
629
|
-
const textParts: string[] = [];
|
|
630
|
-
for (const part of message.content) {
|
|
631
|
-
if (!part || typeof part !== "object") continue;
|
|
632
|
-
const typedPart = part as { type?: unknown; text?: unknown };
|
|
633
|
-
if (typedPart.type === "text" && typeof typedPart.text === "string") {
|
|
634
|
-
textParts.push(safeTerminalText(typedPart.text));
|
|
635
|
-
}
|
|
636
|
-
}
|
|
637
|
-
return textParts.join("\n").trim();
|
|
638
|
-
}
|
|
639
|
-
|
|
640
|
-
function extractThinking(message: { content?: unknown }): string {
|
|
641
|
-
if (!Array.isArray(message.content)) return "";
|
|
642
|
-
|
|
643
|
-
const thinkingParts: string[] = [];
|
|
644
|
-
for (const part of message.content) {
|
|
645
|
-
if (!part || typeof part !== "object") continue;
|
|
646
|
-
const typedPart = part as { type?: unknown; thinking?: unknown };
|
|
647
|
-
if (
|
|
648
|
-
typedPart.type === "thinking" &&
|
|
649
|
-
typeof typedPart.thinking === "string"
|
|
650
|
-
) {
|
|
651
|
-
thinkingParts.push(safeTerminalText(typedPart.thinking));
|
|
652
|
-
}
|
|
653
|
-
}
|
|
654
|
-
return thinkingParts.join("\n").trim();
|
|
655
|
-
}
|
|
656
|
-
|
|
657
|
-
function jsonSize(value: unknown): number {
|
|
658
|
-
if (value === undefined || value === null) return 0;
|
|
659
|
-
try {
|
|
660
|
-
return JSON.stringify(value)?.length ?? 0;
|
|
661
|
-
} catch {
|
|
662
|
-
return String(value).length;
|
|
663
|
-
}
|
|
664
|
-
}
|
|
665
|
-
|
|
666
|
-
function estimateToolResultSize(
|
|
667
|
-
result: TranscriptToolResultPayload | null,
|
|
668
|
-
): number {
|
|
669
|
-
if (!result) return 0;
|
|
670
|
-
let size = 0;
|
|
671
|
-
if (Array.isArray(result.content)) {
|
|
672
|
-
for (const part of result.content) {
|
|
673
|
-
if (!part || typeof part !== "object") continue;
|
|
674
|
-
if (typeof part.text === "string") size += part.text.length;
|
|
675
|
-
if (typeof part.data === "string") size += part.data.length;
|
|
676
|
-
}
|
|
677
|
-
}
|
|
678
|
-
return size + jsonSize(result.details);
|
|
679
|
-
}
|
|
680
|
-
|
|
681
|
-
/** Deep-copies structured tool data for snapshots; falls back to the reference. */
|
|
682
|
-
function cloneStructured<T>(value: T): T {
|
|
683
|
-
if (value === null || typeof value !== "object") return value;
|
|
684
|
-
try {
|
|
685
|
-
return structuredClone(value);
|
|
686
|
-
} catch {
|
|
687
|
-
return value;
|
|
688
|
-
}
|
|
689
|
-
}
|
|
690
|
-
|
|
691
|
-
/**
|
|
692
|
-
* Degraded stand-in stored on a tool-call entry when the original arguments
|
|
693
|
-
* exceed the state's char limit or cannot be serialized. Consumers can narrow
|
|
694
|
-
* with the `truncated` flag; rendering falls back to the preview text.
|
|
695
|
-
*/
|
|
696
|
-
export interface TruncatedToolArgs {
|
|
697
|
-
truncated: true;
|
|
698
|
-
/** Present only when JSON serialization of the original payload failed. */
|
|
699
|
-
reason?: "unserializable";
|
|
700
|
-
/** Serialized length of the original payload, when it was serializable. */
|
|
701
|
-
originalChars?: number;
|
|
702
|
-
preview: string;
|
|
703
|
-
}
|
|
704
|
-
|
|
705
|
-
function buildTruncatedToolArgs(
|
|
706
|
-
serialized: string | undefined,
|
|
707
|
-
raw: unknown,
|
|
708
|
-
limit: number,
|
|
709
|
-
): TruncatedToolArgs {
|
|
710
|
-
if (serialized === undefined) {
|
|
711
|
-
return {
|
|
712
|
-
truncated: true,
|
|
713
|
-
reason: "unserializable",
|
|
714
|
-
preview: String(raw).slice(0, limit),
|
|
715
|
-
};
|
|
716
|
-
}
|
|
717
|
-
return {
|
|
718
|
-
truncated: true,
|
|
719
|
-
originalChars: serialized.length,
|
|
720
|
-
preview: serialized.slice(0, limit),
|
|
721
|
-
};
|
|
722
|
-
}
|
|
723
|
-
|
|
724
|
-
/**
|
|
725
|
-
* Returns a truncation marker when pathological tool arguments exceed
|
|
726
|
-
* `limit` (or cannot be serialized), and `null` when the payload may be
|
|
727
|
-
* stored verbatim. Ingestion therefore never throws and rendering stays
|
|
728
|
-
* bounded regardless of provider payload size.
|
|
729
|
-
*/
|
|
730
|
-
function oversizedToolArgs(
|
|
731
|
-
args: unknown,
|
|
732
|
-
limit: number,
|
|
733
|
-
): TruncatedToolArgs | null {
|
|
734
|
-
if (args === undefined || args === null) return null;
|
|
735
|
-
let serialized: string | undefined;
|
|
736
|
-
try {
|
|
737
|
-
serialized = JSON.stringify(args);
|
|
738
|
-
} catch {
|
|
739
|
-
serialized = undefined;
|
|
740
|
-
}
|
|
741
|
-
if (serialized === undefined) {
|
|
742
|
-
return buildTruncatedToolArgs(undefined, args, limit);
|
|
743
|
-
}
|
|
744
|
-
return serialized.length <= limit
|
|
745
|
-
? null
|
|
746
|
-
: buildTruncatedToolArgs(serialized, args, limit);
|
|
747
|
-
}
|
|
748
|
-
|
|
749
|
-
/**
|
|
750
|
-
* Finds or creates the tool-call record for `toolCallId`, appending a
|
|
751
|
-
* tool-call entry when none exists yet.
|
|
752
|
-
*
|
|
753
|
-
* Public building block for hosts that ingest historical records where calls
|
|
754
|
-
* and results may arrive in either order: when the result was recorded first,
|
|
755
|
-
* the placeholder entry's arguments are backfilled here from the later call
|
|
756
|
-
* record. Arguments exceeding the state's char limit are stored as a
|
|
757
|
-
* truncated marker object instead of failing.
|
|
758
|
-
*/
|
|
759
|
-
export function ensureToolCall(
|
|
760
|
-
state: TranscriptState,
|
|
761
|
-
turnId: number,
|
|
762
|
-
toolCallId: string,
|
|
763
|
-
toolName: string,
|
|
764
|
-
args: unknown,
|
|
765
|
-
): { turnId: number; callEntryId: number; resultEntryId?: number } {
|
|
766
|
-
const existing = state.toolCalls.get(toolCallId);
|
|
767
|
-
if (existing) {
|
|
768
|
-
// Result-before-call replay: backfill arguments onto the placeholder.
|
|
769
|
-
if (args !== undefined && args !== null) {
|
|
770
|
-
const callEntry = state.entries.find(
|
|
771
|
-
(entry) =>
|
|
772
|
-
entry.id === existing.callEntryId && entry.type === "tool-call",
|
|
773
|
-
);
|
|
774
|
-
if (
|
|
775
|
-
callEntry &&
|
|
776
|
-
callEntry.type === "tool-call" &&
|
|
777
|
-
(callEntry.args === undefined || callEntry.args === null)
|
|
778
|
-
) {
|
|
779
|
-
callEntry.args =
|
|
780
|
-
oversizedToolArgs(args, state.toolArgsCharLimit) ?? args;
|
|
781
|
-
}
|
|
782
|
-
}
|
|
783
|
-
return existing;
|
|
784
|
-
}
|
|
785
|
-
const callEntry = appendEntry(state, {
|
|
786
|
-
type: "tool-call",
|
|
787
|
-
turnId,
|
|
788
|
-
toolCallId,
|
|
789
|
-
toolName,
|
|
790
|
-
args: oversizedToolArgs(args, state.toolArgsCharLimit) ?? args,
|
|
791
|
-
});
|
|
792
|
-
const record = { turnId, callEntryId: callEntry.id };
|
|
793
|
-
state.toolCalls.set(toolCallId, record);
|
|
794
|
-
return record;
|
|
795
|
-
}
|
|
796
|
-
|
|
797
|
-
function findActiveAssistantEntry(
|
|
798
|
-
state: TranscriptState,
|
|
799
|
-
entryId: number | undefined,
|
|
800
|
-
type: "thinking" | "assistant-text",
|
|
801
|
-
):
|
|
802
|
-
| Extract<TranscriptEntry, { type: "thinking" | "assistant-text" }>
|
|
803
|
-
| undefined {
|
|
804
|
-
if (entryId === undefined) return undefined;
|
|
805
|
-
const entry = state.entries.find((candidate) => candidate.id === entryId);
|
|
806
|
-
return entry?.type === type ? entry : undefined;
|
|
807
|
-
}
|
|
808
|
-
|
|
809
|
-
function updateActiveAssistantText(
|
|
810
|
-
state: TranscriptState,
|
|
811
|
-
segment: ActiveAssistantSegment,
|
|
812
|
-
type: "thinking" | "assistant-text",
|
|
813
|
-
text: string,
|
|
814
|
-
streaming: boolean,
|
|
815
|
-
): void {
|
|
816
|
-
if (!text) return;
|
|
817
|
-
const entryId =
|
|
818
|
-
type === "thinking" ? segment.thinkingEntryId : segment.textEntryId;
|
|
819
|
-
const existing = findActiveAssistantEntry(state, entryId, type);
|
|
820
|
-
if (existing) {
|
|
821
|
-
existing.text = text;
|
|
822
|
-
existing.streaming = streaming;
|
|
823
|
-
return;
|
|
824
|
-
}
|
|
825
|
-
|
|
826
|
-
const entry = appendEntry(state, {
|
|
827
|
-
type,
|
|
828
|
-
turnId: segment.turnId,
|
|
829
|
-
text,
|
|
830
|
-
streaming,
|
|
831
|
-
});
|
|
832
|
-
if (type === "thinking") segment.thinkingEntryId = entry.id;
|
|
833
|
-
else segment.textEntryId = entry.id;
|
|
834
|
-
}
|
|
835
|
-
|
|
836
|
-
function ensureActiveAssistantSegment(
|
|
837
|
-
state: TranscriptState,
|
|
838
|
-
turnId: number,
|
|
839
|
-
startNew: boolean,
|
|
840
|
-
): ActiveAssistantSegment {
|
|
841
|
-
if (startNew || state.activeAssistant?.turnId !== turnId) {
|
|
842
|
-
state.activeAssistant = { turnId };
|
|
843
|
-
}
|
|
844
|
-
return state.activeAssistant;
|
|
845
|
-
}
|
|
846
|
-
|
|
847
|
-
function finishActiveAssistantSegment(state: TranscriptState): void {
|
|
848
|
-
const segment = state.activeAssistant;
|
|
849
|
-
if (!segment) return;
|
|
850
|
-
const thinking = findActiveAssistantEntry(
|
|
851
|
-
state,
|
|
852
|
-
segment.thinkingEntryId,
|
|
853
|
-
"thinking",
|
|
854
|
-
);
|
|
855
|
-
if (thinking) thinking.streaming = false;
|
|
856
|
-
const text = findActiveAssistantEntry(
|
|
857
|
-
state,
|
|
858
|
-
segment.textEntryId,
|
|
859
|
-
"assistant-text",
|
|
860
|
-
);
|
|
861
|
-
if (text) text.streaming = false;
|
|
862
|
-
state.activeAssistant = null;
|
|
863
|
-
}
|
|
864
|
-
|
|
865
|
-
/**
|
|
866
|
-
* Inserts or updates the thinking/assistant-text entry for `turnId`.
|
|
867
|
-
* Repeated records for the same turn merge into one entry (latest text wins).
|
|
868
|
-
* Public building block for hosts that replay the *same* completed message
|
|
869
|
-
* several times (live message updates persisted line by line).
|
|
870
|
-
*
|
|
871
|
-
* Hosts replaying *distinct* assistant messages inside one turn must use
|
|
872
|
-
* `appendText` / `appendAssistantMessage` instead: a turn that contains
|
|
873
|
-
* several persisted assistant messages would otherwise keep only the last one.
|
|
874
|
-
*/
|
|
875
|
-
export function upsertText(
|
|
876
|
-
state: TranscriptState,
|
|
877
|
-
turnId: number,
|
|
878
|
-
type: "thinking" | "assistant-text",
|
|
879
|
-
text: string,
|
|
880
|
-
streaming: boolean,
|
|
881
|
-
): void {
|
|
882
|
-
if (!text) return;
|
|
883
|
-
const existing = findLatestEntry(state, turnId, type);
|
|
884
|
-
if (existing) {
|
|
885
|
-
existing.text = text;
|
|
886
|
-
existing.streaming = streaming;
|
|
887
|
-
return;
|
|
888
|
-
}
|
|
889
|
-
appendEntry(state, { type, turnId, text, streaming });
|
|
890
|
-
}
|
|
891
|
-
|
|
892
|
-
/**
|
|
893
|
-
* Appends a thinking/assistant-text entry for `turnId` without merging into
|
|
894
|
-
* any previous entry of the same type. Public building block for hosts that
|
|
895
|
-
* replay finished transcripts, where every persisted assistant message is a
|
|
896
|
-
* distinct entry even when several of them share one turn.
|
|
897
|
-
*/
|
|
898
|
-
export function appendText(
|
|
899
|
-
state: TranscriptState,
|
|
900
|
-
turnId: number,
|
|
901
|
-
type: "thinking" | "assistant-text",
|
|
902
|
-
text: string,
|
|
903
|
-
streaming = false,
|
|
904
|
-
): TranscriptEntry | undefined {
|
|
905
|
-
if (!text) return undefined;
|
|
906
|
-
return appendEntry(state, { type, turnId, text, streaming });
|
|
907
|
-
}
|
|
908
|
-
|
|
909
|
-
/**
|
|
910
|
-
* Appends one completed assistant message as its own thinking and/or
|
|
911
|
-
* assistant-text entries, in the order Pi renders them inside a message.
|
|
912
|
-
* Unlike `upsertText` it never overwrites an earlier message of the same
|
|
913
|
-
* turn, so history replay keeps every assistant message and thinking block.
|
|
914
|
-
*/
|
|
915
|
-
export function appendAssistantMessage(
|
|
916
|
-
state: TranscriptState,
|
|
917
|
-
turnId: number,
|
|
918
|
-
message: { thinking?: string; text?: string },
|
|
919
|
-
streaming = false,
|
|
920
|
-
): { thinkingEntryId?: number; textEntryId?: number } {
|
|
921
|
-
const result: { thinkingEntryId?: number; textEntryId?: number } = {};
|
|
922
|
-
const thinking = appendText(
|
|
923
|
-
state,
|
|
924
|
-
turnId,
|
|
925
|
-
"thinking",
|
|
926
|
-
message.thinking ?? "",
|
|
927
|
-
streaming,
|
|
928
|
-
);
|
|
929
|
-
if (thinking) result.thinkingEntryId = thinking.id;
|
|
930
|
-
const text = appendText(
|
|
931
|
-
state,
|
|
932
|
-
turnId,
|
|
933
|
-
"assistant-text",
|
|
934
|
-
message.text ?? "",
|
|
935
|
-
streaming,
|
|
936
|
-
);
|
|
937
|
-
if (text) result.textEntryId = text.id;
|
|
938
|
-
return result;
|
|
939
|
-
}
|
|
940
|
-
|
|
941
|
-
/**
|
|
942
|
-
* Inserts or updates the structured result of a tool call, creating the call
|
|
943
|
-
* placeholder first when the result arrives before its start event. Safe to
|
|
944
|
-
* call repeatedly — the latest result wins and streaming flags update in place.
|
|
945
|
-
* Public building block for hosts that ingest persisted tool results.
|
|
946
|
-
*/
|
|
947
|
-
export function upsertToolResult(
|
|
948
|
-
state: TranscriptState,
|
|
949
|
-
turnId: number,
|
|
950
|
-
toolCallId: string,
|
|
951
|
-
toolName: string,
|
|
952
|
-
result: TranscriptToolResultPayload | null,
|
|
953
|
-
isError: boolean,
|
|
954
|
-
streaming: boolean,
|
|
955
|
-
): void {
|
|
956
|
-
const toolCall = ensureToolCall(
|
|
957
|
-
state,
|
|
958
|
-
turnId,
|
|
959
|
-
toolCallId,
|
|
960
|
-
toolName,
|
|
961
|
-
undefined,
|
|
962
|
-
);
|
|
963
|
-
const existing =
|
|
964
|
-
toolCall.resultEntryId === undefined
|
|
965
|
-
? undefined
|
|
966
|
-
: state.entries.find(
|
|
967
|
-
(entry) =>
|
|
968
|
-
entry.id === toolCall.resultEntryId && entry.type === "tool-result",
|
|
969
|
-
);
|
|
970
|
-
if (existing && existing.type === "tool-result") {
|
|
971
|
-
existing.result = result;
|
|
972
|
-
existing.isError = isError;
|
|
973
|
-
existing.streaming = streaming;
|
|
974
|
-
return;
|
|
975
|
-
}
|
|
976
|
-
const resultEntry = appendEntry(state, {
|
|
977
|
-
type: "tool-result",
|
|
978
|
-
turnId,
|
|
979
|
-
toolCallId,
|
|
980
|
-
toolName,
|
|
981
|
-
result,
|
|
982
|
-
isError,
|
|
983
|
-
streaming,
|
|
984
|
-
});
|
|
985
|
-
toolCall.resultEntryId = resultEntry.id;
|
|
986
|
-
}
|
|
987
|
-
|
|
988
|
-
/**
|
|
989
|
-
* Appends a notice attached to the current turn (or the most recent one).
|
|
990
|
-
* Text is sanitized before storage. Public building block for hosts that
|
|
991
|
-
* surface stderr output, retry banners, or other non-conversation events.
|
|
992
|
-
*/
|
|
993
|
-
export function appendNotice(
|
|
994
|
-
state: TranscriptState,
|
|
995
|
-
text: string,
|
|
996
|
-
tone: TranscriptNoticeTone,
|
|
997
|
-
): void {
|
|
998
|
-
const turnId = state.currentTurnId ?? state.lastTurnId ?? ensureTurn(state);
|
|
999
|
-
appendEntry(state, {
|
|
1000
|
-
type: "notice",
|
|
1001
|
-
turnId,
|
|
1002
|
-
text: safeTerminalText(text),
|
|
1003
|
-
tone,
|
|
1004
|
-
});
|
|
1005
|
-
}
|
|
1006
|
-
|
|
1007
|
-
function entryLength(entry: TranscriptEntry): number {
|
|
1008
|
-
switch (entry.type) {
|
|
1009
|
-
case "user-message":
|
|
1010
|
-
case "thinking":
|
|
1011
|
-
case "assistant-text":
|
|
1012
|
-
case "notice":
|
|
1013
|
-
return entry.text.length;
|
|
1014
|
-
case "tool-call":
|
|
1015
|
-
return entry.toolName.length + jsonSize(entry.args);
|
|
1016
|
-
case "tool-result":
|
|
1017
|
-
return entry.toolName.length + estimateToolResultSize(entry.result);
|
|
1018
|
-
default:
|
|
1019
|
-
return 0;
|
|
1020
|
-
}
|
|
1021
|
-
}
|
|
1022
|
-
|
|
1023
|
-
function pruneToolCallIndex(state: TranscriptState): void {
|
|
1024
|
-
const entryIds = new Set(state.entries.map((entry) => entry.id));
|
|
1025
|
-
const aliveToolCallIds = new Set<string>();
|
|
1026
|
-
for (const [toolCallId, record] of state.toolCalls.entries()) {
|
|
1027
|
-
if (!entryIds.has(record.callEntryId)) {
|
|
1028
|
-
state.toolCalls.delete(toolCallId);
|
|
1029
|
-
continue;
|
|
1030
|
-
}
|
|
1031
|
-
aliveToolCallIds.add(toolCallId);
|
|
1032
|
-
if (
|
|
1033
|
-
record.resultEntryId !== undefined &&
|
|
1034
|
-
!entryIds.has(record.resultEntryId)
|
|
1035
|
-
) {
|
|
1036
|
-
record.resultEntryId = undefined;
|
|
1037
|
-
}
|
|
1038
|
-
}
|
|
1039
|
-
// Result entries whose call entry was trimmed away have no renderable
|
|
1040
|
-
// position: their visual is owned by the component attached to the call.
|
|
1041
|
-
let hasOrphanResults = false;
|
|
1042
|
-
for (const entry of state.entries) {
|
|
1043
|
-
if (
|
|
1044
|
-
entry.type === "tool-result" &&
|
|
1045
|
-
!aliveToolCallIds.has(entry.toolCallId)
|
|
1046
|
-
) {
|
|
1047
|
-
hasOrphanResults = true;
|
|
1048
|
-
break;
|
|
1049
|
-
}
|
|
1050
|
-
}
|
|
1051
|
-
if (hasOrphanResults) {
|
|
1052
|
-
state.entries = state.entries.filter(
|
|
1053
|
-
(entry) =>
|
|
1054
|
-
!(
|
|
1055
|
-
entry.type === "tool-result" &&
|
|
1056
|
-
!aliveToolCallIds.has(entry.toolCallId)
|
|
1057
|
-
),
|
|
1058
|
-
);
|
|
1059
|
-
}
|
|
1060
|
-
state.toolComponents.retainOnly(aliveToolCallIds);
|
|
1061
|
-
}
|
|
1062
|
-
|
|
1063
|
-
export function trimTranscriptState(
|
|
1064
|
-
state: TranscriptState,
|
|
1065
|
-
options: SessionTranscriptOptions = {},
|
|
1066
|
-
): void {
|
|
1067
|
-
const maxEntries = Math.max(16, options.maxEntries ?? DEFAULT_MAX_ENTRIES);
|
|
1068
|
-
const maxChars = Math.max(1024, options.maxChars ?? DEFAULT_MAX_CHARS);
|
|
1069
|
-
while (state.entries.length > maxEntries) state.entries.shift();
|
|
1070
|
-
let chars = state.entries.reduce(
|
|
1071
|
-
(total, entry) => total + entryLength(entry),
|
|
1072
|
-
0,
|
|
1073
|
-
);
|
|
1074
|
-
while (chars > maxChars && state.entries.length > 1) {
|
|
1075
|
-
const removed = state.entries.shift();
|
|
1076
|
-
if (removed) chars -= entryLength(removed);
|
|
1077
|
-
}
|
|
1078
|
-
pruneToolCallIndex(state);
|
|
1079
|
-
}
|
|
1080
|
-
|
|
1081
|
-
type SessionEventLike = {
|
|
1082
|
-
type?: unknown;
|
|
1083
|
-
message?: { role?: unknown; content?: unknown };
|
|
1084
|
-
toolCallId?: unknown;
|
|
1085
|
-
toolName?: unknown;
|
|
1086
|
-
args?: unknown;
|
|
1087
|
-
partialResult?: unknown;
|
|
1088
|
-
result?: unknown;
|
|
1089
|
-
isError?: unknown;
|
|
1090
|
-
attempt?: unknown;
|
|
1091
|
-
maxAttempts?: unknown;
|
|
1092
|
-
delayMs?: unknown;
|
|
1093
|
-
errorMessage?: unknown;
|
|
1094
|
-
success?: unknown;
|
|
1095
|
-
finalError?: unknown;
|
|
1096
|
-
};
|
|
1097
|
-
|
|
1098
|
-
function eventString(value: unknown, fallback = ""): string {
|
|
1099
|
-
return typeof value === "string" && value.trim()
|
|
1100
|
-
? safeTerminalText(value)
|
|
1101
|
-
: fallback;
|
|
1102
|
-
}
|
|
1103
|
-
|
|
1104
|
-
function eventNumber(value: unknown, fallback = 0): number {
|
|
1105
|
-
return typeof value === "number" && Number.isFinite(value) ? value : fallback;
|
|
1106
|
-
}
|
|
1107
|
-
|
|
1108
|
-
type TranscriptMessageEventPhase = "start" | "update" | "end";
|
|
1109
|
-
|
|
1110
|
-
function applyTranscriptMessageEvent(
|
|
1111
|
-
state: TranscriptState,
|
|
1112
|
-
event: SessionEventLike,
|
|
1113
|
-
phase: TranscriptMessageEventPhase,
|
|
1114
|
-
): void {
|
|
1115
|
-
const message = event.message ?? {};
|
|
1116
|
-
if (message.role === "user") {
|
|
1117
|
-
const turnId = ensureTurn(state);
|
|
1118
|
-
const text = extractMessageText(message);
|
|
1119
|
-
if (!text) return;
|
|
1120
|
-
const existing = findLatestEntry(state, turnId, "user-message");
|
|
1121
|
-
if (existing) existing.text = text;
|
|
1122
|
-
else appendEntry(state, { type: "user-message", turnId, text });
|
|
1123
|
-
return;
|
|
1124
|
-
}
|
|
1125
|
-
if (message.role !== "assistant") return;
|
|
1126
|
-
|
|
1127
|
-
const turnId = ensureTurn(state);
|
|
1128
|
-
const segment = ensureActiveAssistantSegment(
|
|
1129
|
-
state,
|
|
1130
|
-
turnId,
|
|
1131
|
-
phase === "start",
|
|
1132
|
-
);
|
|
1133
|
-
const streaming = phase !== "end";
|
|
1134
|
-
updateActiveAssistantText(
|
|
1135
|
-
state,
|
|
1136
|
-
segment,
|
|
1137
|
-
"thinking",
|
|
1138
|
-
extractThinking(message),
|
|
1139
|
-
streaming,
|
|
1140
|
-
);
|
|
1141
|
-
updateActiveAssistantText(
|
|
1142
|
-
state,
|
|
1143
|
-
segment,
|
|
1144
|
-
"assistant-text",
|
|
1145
|
-
extractMessageText(message),
|
|
1146
|
-
streaming,
|
|
1147
|
-
);
|
|
1148
|
-
if (phase === "end") finishActiveAssistantSegment(state);
|
|
1149
|
-
}
|
|
1150
|
-
|
|
1151
|
-
function eventToolCallId(
|
|
1152
|
-
state: TranscriptState,
|
|
1153
|
-
event: SessionEventLike,
|
|
1154
|
-
): string {
|
|
1155
|
-
return eventString(event.toolCallId, `unknown-tool-${state.nextEntryId}`);
|
|
1156
|
-
}
|
|
1157
|
-
|
|
1158
|
-
function normalizeToolResultPayload(
|
|
1159
|
-
value: unknown,
|
|
1160
|
-
): TranscriptToolResultPayload | null {
|
|
1161
|
-
if (value === undefined || value === null) return null;
|
|
1162
|
-
if (typeof value === "object") return value as TranscriptToolResultPayload;
|
|
1163
|
-
if (typeof value === "string")
|
|
1164
|
-
return { content: [{ type: "text", text: value }] };
|
|
1165
|
-
return { content: [{ type: "text", text: String(value) }] };
|
|
1166
|
-
}
|
|
1167
|
-
|
|
1168
|
-
function applyTranscriptToolResult(
|
|
1169
|
-
state: TranscriptState,
|
|
1170
|
-
event: SessionEventLike,
|
|
1171
|
-
value: unknown,
|
|
1172
|
-
isError: boolean,
|
|
1173
|
-
streaming: boolean,
|
|
1174
|
-
): void {
|
|
1175
|
-
const toolCallId = eventToolCallId(state, event);
|
|
1176
|
-
const toolName = eventString(event.toolName, "tool");
|
|
1177
|
-
const turnId = state.toolCalls.get(toolCallId)?.turnId ?? ensureTurn(state);
|
|
1178
|
-
const payload = normalizeToolResultPayload(value);
|
|
1179
|
-
upsertToolResult(
|
|
1180
|
-
state,
|
|
1181
|
-
turnId,
|
|
1182
|
-
toolCallId,
|
|
1183
|
-
toolName,
|
|
1184
|
-
payload,
|
|
1185
|
-
isError,
|
|
1186
|
-
streaming,
|
|
1187
|
-
);
|
|
1188
|
-
if (streaming) {
|
|
1189
|
-
state.toolComponents.handleUpdate(toolCallId, toolName, payload);
|
|
1190
|
-
} else {
|
|
1191
|
-
state.toolComponents.handleEnd(toolCallId, toolName, payload, isError);
|
|
1192
|
-
}
|
|
1193
|
-
}
|
|
1194
|
-
|
|
1195
|
-
function appendRetryStartNotice(
|
|
1196
|
-
state: TranscriptState,
|
|
1197
|
-
event: SessionEventLike,
|
|
1198
|
-
): void {
|
|
1199
|
-
const attempt = eventNumber(event.attempt);
|
|
1200
|
-
const maxAttempts = eventNumber(event.maxAttempts);
|
|
1201
|
-
const delaySeconds = Math.max(
|
|
1202
|
-
0,
|
|
1203
|
-
Math.ceil(eventNumber(event.delayMs) / 1000),
|
|
1204
|
-
);
|
|
1205
|
-
const error = eventString(event.errorMessage, "temporary error");
|
|
1206
|
-
appendNotice(
|
|
1207
|
-
state,
|
|
1208
|
-
`Retry ${attempt}/${maxAttempts} in ${delaySeconds}s: ${error}`,
|
|
1209
|
-
"warning",
|
|
1210
|
-
);
|
|
1211
|
-
}
|
|
1212
|
-
|
|
1213
|
-
function appendRetryEndNotice(
|
|
1214
|
-
state: TranscriptState,
|
|
1215
|
-
event: SessionEventLike,
|
|
1216
|
-
): void {
|
|
1217
|
-
const attempt = eventNumber(event.attempt);
|
|
1218
|
-
if (event.success === true) {
|
|
1219
|
-
appendNotice(state, `Retry ${attempt} succeeded.`, "info");
|
|
1220
|
-
return;
|
|
1221
|
-
}
|
|
1222
|
-
const finalError = eventString(event.finalError);
|
|
1223
|
-
const message = finalError
|
|
1224
|
-
? `Retry ${attempt} failed: ${finalError}`
|
|
1225
|
-
: `Retry ${attempt} failed.`;
|
|
1226
|
-
appendNotice(state, message, "error");
|
|
1227
|
-
}
|
|
1228
|
-
|
|
1229
|
-
export function applyAgentSessionEvent(
|
|
1230
|
-
state: TranscriptState,
|
|
1231
|
-
input: unknown,
|
|
1232
|
-
options: SessionTranscriptOptions = {},
|
|
1233
|
-
): void {
|
|
1234
|
-
if (!input || typeof input !== "object") return;
|
|
1235
|
-
const event = input as SessionEventLike;
|
|
1236
|
-
if (typeof event.type !== "string") return;
|
|
1237
|
-
switch (event.type) {
|
|
1238
|
-
case "turn_start":
|
|
1239
|
-
ensureTurn(state);
|
|
1240
|
-
break;
|
|
1241
|
-
case "message_start":
|
|
1242
|
-
applyTranscriptMessageEvent(state, event, "start");
|
|
1243
|
-
break;
|
|
1244
|
-
case "message_update":
|
|
1245
|
-
applyTranscriptMessageEvent(state, event, "update");
|
|
1246
|
-
break;
|
|
1247
|
-
case "message_end":
|
|
1248
|
-
applyTranscriptMessageEvent(state, event, "end");
|
|
1249
|
-
break;
|
|
1250
|
-
case "tool_execution_start": {
|
|
1251
|
-
const turnId = ensureTurn(state);
|
|
1252
|
-
const toolCallId = eventToolCallId(state, event);
|
|
1253
|
-
const toolName = eventString(event.toolName, "tool");
|
|
1254
|
-
ensureToolCall(state, turnId, toolCallId, toolName, event.args);
|
|
1255
|
-
state.toolComponents.handleStart(toolCallId, toolName, event.args);
|
|
1256
|
-
break;
|
|
1257
|
-
}
|
|
1258
|
-
case "tool_execution_update":
|
|
1259
|
-
applyTranscriptToolResult(state, event, event.partialResult, false, true);
|
|
1260
|
-
break;
|
|
1261
|
-
case "tool_execution_end":
|
|
1262
|
-
applyTranscriptToolResult(
|
|
1263
|
-
state,
|
|
1264
|
-
event,
|
|
1265
|
-
event.result,
|
|
1266
|
-
event.isError === true,
|
|
1267
|
-
false,
|
|
1268
|
-
);
|
|
1269
|
-
break;
|
|
1270
|
-
case "turn_end":
|
|
1271
|
-
finishTurn(state);
|
|
1272
|
-
break;
|
|
1273
|
-
case "auto_retry_start":
|
|
1274
|
-
appendRetryStartNotice(state, event);
|
|
1275
|
-
break;
|
|
1276
|
-
case "auto_retry_end":
|
|
1277
|
-
appendRetryEndNotice(state, event);
|
|
1278
|
-
break;
|
|
1279
|
-
default:
|
|
1280
|
-
break;
|
|
1281
|
-
}
|
|
1282
|
-
trimTranscriptState(state, options);
|
|
1283
|
-
}
|
|
1284
|
-
|
|
1285
|
-
export class SessionTranscript {
|
|
1286
|
-
private readonly state: TranscriptState;
|
|
1287
|
-
private readonly options: SessionTranscriptOptions;
|
|
1288
|
-
|
|
1289
|
-
constructor(options: SessionTranscriptOptions = {}) {
|
|
1290
|
-
this.options = options;
|
|
1291
|
-
this.state = createTranscriptState(options);
|
|
1292
|
-
}
|
|
1293
|
-
|
|
1294
|
-
get entries(): readonly TranscriptEntry[] {
|
|
1295
|
-
return this.state.entries;
|
|
1296
|
-
}
|
|
1297
|
-
|
|
1298
|
-
/** Live native tool components keyed by tool call id. */
|
|
1299
|
-
get toolComponents(): ToolComponentLookup {
|
|
1300
|
-
return this.state.toolComponents;
|
|
1301
|
-
}
|
|
1302
|
-
|
|
1303
|
-
snapshot(): TranscriptEntry[] {
|
|
1304
|
-
return this.state.entries.map((entry) => {
|
|
1305
|
-
const copy = { ...entry } as TranscriptEntry;
|
|
1306
|
-
if (copy.type === "tool-call") copy.args = cloneStructured(copy.args);
|
|
1307
|
-
else if (copy.type === "tool-result") {
|
|
1308
|
-
copy.result = cloneStructured(copy.result);
|
|
1309
|
-
}
|
|
1310
|
-
return copy;
|
|
1311
|
-
});
|
|
1312
|
-
}
|
|
1313
|
-
|
|
1314
|
-
get currentTurnId(): number | null {
|
|
1315
|
-
return this.state.currentTurnId;
|
|
1316
|
-
}
|
|
1317
|
-
|
|
1318
|
-
apply(event: unknown): void {
|
|
1319
|
-
applyAgentSessionEvent(this.state, event, this.options);
|
|
1320
|
-
}
|
|
1321
|
-
|
|
1322
|
-
appendCompletedTurn(details: {
|
|
1323
|
-
user?: string;
|
|
1324
|
-
thinking?: string;
|
|
1325
|
-
assistant: string;
|
|
1326
|
-
}): void {
|
|
1327
|
-
const turnId = ensureTurn(this.state);
|
|
1328
|
-
if (details.user)
|
|
1329
|
-
appendEntry(this.state, {
|
|
1330
|
-
type: "user-message",
|
|
1331
|
-
turnId,
|
|
1332
|
-
text: safeTerminalText(details.user),
|
|
1333
|
-
});
|
|
1334
|
-
if (details.thinking)
|
|
1335
|
-
upsertText(
|
|
1336
|
-
this.state,
|
|
1337
|
-
turnId,
|
|
1338
|
-
"thinking",
|
|
1339
|
-
safeTerminalText(details.thinking),
|
|
1340
|
-
false,
|
|
1341
|
-
);
|
|
1342
|
-
upsertText(
|
|
1343
|
-
this.state,
|
|
1344
|
-
turnId,
|
|
1345
|
-
"assistant-text",
|
|
1346
|
-
safeTerminalText(details.assistant),
|
|
1347
|
-
false,
|
|
1348
|
-
);
|
|
1349
|
-
finishTurn(this.state, turnId);
|
|
1350
|
-
trimTranscriptState(this.state, this.options);
|
|
1351
|
-
}
|
|
1352
|
-
|
|
1353
|
-
appendFailure(message: string): void {
|
|
1354
|
-
const turnId =
|
|
1355
|
-
this.state.currentTurnId ??
|
|
1356
|
-
this.state.lastTurnId ??
|
|
1357
|
-
ensureTurn(this.state);
|
|
1358
|
-
upsertText(
|
|
1359
|
-
this.state,
|
|
1360
|
-
turnId,
|
|
1361
|
-
"assistant-text",
|
|
1362
|
-
`Error: ${safeTerminalText(message)}`,
|
|
1363
|
-
false,
|
|
1364
|
-
);
|
|
1365
|
-
finishTurn(this.state, turnId);
|
|
1366
|
-
trimTranscriptState(this.state, this.options);
|
|
1367
|
-
}
|
|
1368
|
-
|
|
1369
|
-
appendNotice(message: string, tone: TranscriptNoticeTone = "info"): void {
|
|
1370
|
-
appendNotice(this.state, message, tone);
|
|
1371
|
-
trimTranscriptState(this.state, this.options);
|
|
1372
|
-
}
|
|
1373
|
-
|
|
1374
|
-
removeCurrentTurn(): void {
|
|
1375
|
-
removeTranscriptTurn(
|
|
1376
|
-
this.state,
|
|
1377
|
-
this.state.currentTurnId ?? this.state.lastTurnId,
|
|
1378
|
-
);
|
|
1379
|
-
}
|
|
1380
|
-
|
|
1381
|
-
clear(): void {
|
|
1382
|
-
this.state.entries = [];
|
|
1383
|
-
this.state.currentTurnId = null;
|
|
1384
|
-
this.state.lastTurnId = null;
|
|
1385
|
-
this.state.toolCalls.clear();
|
|
1386
|
-
this.state.toolComponents.clear();
|
|
1387
|
-
}
|
|
1388
|
-
}
|
|
1389
|
-
|
|
1390
|
-
export function hasStreamingTranscriptEntry(
|
|
1391
|
-
entries: readonly TranscriptEntry[],
|
|
1392
|
-
): boolean {
|
|
1393
|
-
return entries.some(
|
|
1394
|
-
(entry) =>
|
|
1395
|
-
(entry.type === "thinking" ||
|
|
1396
|
-
entry.type === "assistant-text" ||
|
|
1397
|
-
entry.type === "tool-result") &&
|
|
1398
|
-
entry.streaming,
|
|
1399
|
-
);
|
|
1400
|
-
}
|
|
1401
|
-
|
|
1402
|
-
export function getCompletedTranscriptExchangeCount(
|
|
1403
|
-
entries: readonly TranscriptEntry[],
|
|
1404
|
-
): number {
|
|
1405
|
-
return entries.filter(
|
|
1406
|
-
(entry) => entry.type === "assistant-text" && !entry.streaming,
|
|
1407
|
-
).length;
|
|
1408
|
-
}
|
|
1409
|
-
|
|
1410
|
-
type TranscriptRenderBlock =
|
|
1411
|
-
| { kind: "separator" }
|
|
1412
|
-
| { kind: "user"; text: string }
|
|
1413
|
-
| { kind: "assistant"; thinking: string; text: string }
|
|
1414
|
-
| {
|
|
1415
|
-
kind: "tool-native";
|
|
1416
|
-
toolCallId: string;
|
|
1417
|
-
toolName: string;
|
|
1418
|
-
args: unknown;
|
|
1419
|
-
result: TranscriptToolResultPayload | null;
|
|
1420
|
-
isError: boolean;
|
|
1421
|
-
streaming: boolean;
|
|
1422
|
-
}
|
|
1423
|
-
| { kind: "notice"; text: string; tone: TranscriptNoticeTone };
|
|
1424
|
-
|
|
1425
|
-
function buildRenderBlocks(
|
|
1426
|
-
entries: readonly TranscriptEntry[],
|
|
1427
|
-
): TranscriptRenderBlock[] {
|
|
1428
|
-
const blocks: TranscriptRenderBlock[] = [];
|
|
1429
|
-
let pendingAssistant:
|
|
1430
|
-
| { kind: "assistant"; thinking: string; text: string }
|
|
1431
|
-
| undefined;
|
|
1432
|
-
|
|
1433
|
-
// Tool results are upserted in place, so the last entry per call id wins.
|
|
1434
|
-
// Their visual output is owned by the native component rendered at the call
|
|
1435
|
-
// position, so result entries never emit blocks of their own.
|
|
1436
|
-
const latestResults = new Map<
|
|
1437
|
-
string,
|
|
1438
|
-
Extract<TranscriptEntry, { type: "tool-result" }>
|
|
1439
|
-
>();
|
|
1440
|
-
for (const entry of entries) {
|
|
1441
|
-
if (entry.type === "tool-result")
|
|
1442
|
-
latestResults.set(entry.toolCallId, entry);
|
|
1443
|
-
}
|
|
1444
|
-
|
|
1445
|
-
const flushAssistant = (): void => {
|
|
1446
|
-
if (!pendingAssistant) return;
|
|
1447
|
-
blocks.push(pendingAssistant);
|
|
1448
|
-
pendingAssistant = undefined;
|
|
1449
|
-
};
|
|
1450
|
-
const appendAssistantText = (
|
|
1451
|
-
type: "thinking" | "assistant-text",
|
|
1452
|
-
text: string,
|
|
1453
|
-
): void => {
|
|
1454
|
-
const safeText = safeTerminalText(text);
|
|
1455
|
-
if (!safeText) return;
|
|
1456
|
-
|
|
1457
|
-
const field = type === "thinking" ? "thinking" : "text";
|
|
1458
|
-
if (pendingAssistant?.[field]) flushAssistant();
|
|
1459
|
-
if (!pendingAssistant)
|
|
1460
|
-
pendingAssistant = { kind: "assistant", thinking: "", text: "" };
|
|
1461
|
-
pendingAssistant[field] = safeText;
|
|
1462
|
-
};
|
|
1463
|
-
|
|
1464
|
-
for (const entry of entries) {
|
|
1465
|
-
switch (entry.type) {
|
|
1466
|
-
case "turn-boundary":
|
|
1467
|
-
flushAssistant();
|
|
1468
|
-
if (entry.phase === "start" && blocks.length > 0)
|
|
1469
|
-
blocks.push({ kind: "separator" });
|
|
1470
|
-
break;
|
|
1471
|
-
case "user-message":
|
|
1472
|
-
flushAssistant();
|
|
1473
|
-
blocks.push({ kind: "user", text: entry.text });
|
|
1474
|
-
break;
|
|
1475
|
-
case "thinking":
|
|
1476
|
-
appendAssistantText("thinking", entry.text);
|
|
1477
|
-
break;
|
|
1478
|
-
case "assistant-text":
|
|
1479
|
-
appendAssistantText("assistant-text", entry.text);
|
|
1480
|
-
break;
|
|
1481
|
-
case "tool-call": {
|
|
1482
|
-
flushAssistant();
|
|
1483
|
-
const result = latestResults.get(entry.toolCallId);
|
|
1484
|
-
blocks.push({
|
|
1485
|
-
kind: "tool-native",
|
|
1486
|
-
toolCallId: entry.toolCallId,
|
|
1487
|
-
toolName: entry.toolName,
|
|
1488
|
-
args: entry.args,
|
|
1489
|
-
result: result?.result ?? null,
|
|
1490
|
-
isError: result?.isError ?? false,
|
|
1491
|
-
streaming: result?.streaming ?? false,
|
|
1492
|
-
});
|
|
1493
|
-
break;
|
|
1494
|
-
}
|
|
1495
|
-
case "tool-result":
|
|
1496
|
-
break;
|
|
1497
|
-
case "notice":
|
|
1498
|
-
flushAssistant();
|
|
1499
|
-
blocks.push({ kind: "notice", text: entry.text, tone: entry.tone });
|
|
1500
|
-
break;
|
|
1501
|
-
default:
|
|
1502
|
-
break;
|
|
1503
|
-
}
|
|
1504
|
-
}
|
|
1505
|
-
flushAssistant();
|
|
1506
|
-
return blocks;
|
|
1507
|
-
}
|
|
1508
|
-
|
|
1509
|
-
const ESC_SEQUENCE = String.fromCharCode(27);
|
|
1510
|
-
const BEL_SEQUENCE = String.fromCharCode(7);
|
|
1511
|
-
|
|
1512
|
-
const OSC_133_SEQUENCE = new RegExp(
|
|
1513
|
-
`${ESC_SEQUENCE}]133;[ABC]${BEL_SEQUENCE}`,
|
|
1514
|
-
"g",
|
|
1515
|
-
);
|
|
1516
|
-
|
|
1517
|
-
type PresentationAssistantMessage = NonNullable<
|
|
1518
|
-
ConstructorParameters<typeof AssistantMessageComponent>[0]
|
|
1519
|
-
>;
|
|
1520
|
-
|
|
1521
|
-
function stripOsc133(lines: readonly string[]): string[] {
|
|
1522
|
-
return lines.map((line) => line.replace(OSC_133_SEQUENCE, ""));
|
|
1523
|
-
}
|
|
1524
|
-
|
|
1525
|
-
function createPresentationAssistantMessage(
|
|
1526
|
-
thinking: string,
|
|
1527
|
-
text: string,
|
|
1528
|
-
): PresentationAssistantMessage {
|
|
1529
|
-
const content = [
|
|
1530
|
-
...(thinking
|
|
1531
|
-
? [{ type: "thinking" as const, thinking: safeTerminalText(thinking) }]
|
|
1532
|
-
: []),
|
|
1533
|
-
...(text ? [{ type: "text" as const, text: safeTerminalText(text) }] : []),
|
|
1534
|
-
];
|
|
1535
|
-
|
|
1536
|
-
// Pi's renderer reads only role/content. A transcript can merge events that
|
|
1537
|
-
// have no single provider response, so it intentionally has no transport metadata.
|
|
1538
|
-
return { role: "assistant", content } as PresentationAssistantMessage;
|
|
1539
|
-
}
|
|
1540
|
-
|
|
1541
|
-
function renderNativeUserMessage(text: string, width: number): string[] {
|
|
1542
|
-
return stripOsc133(
|
|
1543
|
-
new UserMessageComponent(
|
|
1544
|
-
safeTerminalText(text),
|
|
1545
|
-
getMarkdownTheme(),
|
|
1546
|
-
1,
|
|
1547
|
-
).render(width),
|
|
1548
|
-
);
|
|
1549
|
-
}
|
|
1550
|
-
|
|
1551
|
-
function renderNativeAssistantMessage(
|
|
1552
|
-
thinking: string,
|
|
1553
|
-
text: string,
|
|
1554
|
-
width: number,
|
|
1555
|
-
thinkingLabel: string,
|
|
1556
|
-
hideThinkingBlock: boolean,
|
|
1557
|
-
): string[] {
|
|
1558
|
-
return stripOsc133(
|
|
1559
|
-
new AssistantMessageComponent(
|
|
1560
|
-
createPresentationAssistantMessage(thinking, text),
|
|
1561
|
-
hideThinkingBlock,
|
|
1562
|
-
getMarkdownTheme(),
|
|
1563
|
-
thinkingLabel,
|
|
1564
|
-
1,
|
|
1565
|
-
).render(width),
|
|
1566
|
-
);
|
|
1567
|
-
}
|
|
1568
|
-
|
|
1569
|
-
function wrapRenderedLines(
|
|
1570
|
-
lines: readonly string[],
|
|
1571
|
-
width: number,
|
|
1572
|
-
verbatimLines?: ReadonlySet<number>,
|
|
1573
|
-
): string[] {
|
|
1574
|
-
const wrapped: string[] = [];
|
|
1575
|
-
for (const [index, line] of lines.entries()) {
|
|
1576
|
-
// Native tool components own their geometry (diffs, borders, tables);
|
|
1577
|
-
// re-wrapping their output would corrupt it, same as Pi's main transcript.
|
|
1578
|
-
if (verbatimLines?.has(index)) {
|
|
1579
|
-
wrapped.push(line);
|
|
1580
|
-
continue;
|
|
1581
|
-
}
|
|
1582
|
-
if (line) wrapped.push(...wrapTextWithAnsi(line, Math.max(1, width)));
|
|
1583
|
-
else wrapped.push("");
|
|
1584
|
-
}
|
|
1585
|
-
return wrapped;
|
|
1586
|
-
}
|
|
1587
|
-
|
|
1588
|
-
function noticeToneColor(tone: TranscriptNoticeTone): ThemeColor {
|
|
1589
|
-
switch (tone) {
|
|
1590
|
-
case "error":
|
|
1591
|
-
return "error";
|
|
1592
|
-
case "warning":
|
|
1593
|
-
return "warning";
|
|
1594
|
-
default:
|
|
1595
|
-
return "dim";
|
|
1596
|
-
}
|
|
1597
|
-
}
|
|
1598
|
-
|
|
1599
|
-
export interface TranscriptRenderOptions {
|
|
1600
|
-
width: number;
|
|
1601
|
-
theme: Theme;
|
|
1602
|
-
emptyText?: string;
|
|
1603
|
-
assistantLabel?: string;
|
|
1604
|
-
/** Collapsed-label text used when `hideThinkingBlock` is enabled. */
|
|
1605
|
-
thinkingLabel?: string;
|
|
1606
|
-
/**
|
|
1607
|
-
* Render assistant thinking blocks collapsed to `thinkingLabel`. Defaults to
|
|
1608
|
-
* `false` (expanded), so existing hosts keep Pi's default transcript
|
|
1609
|
-
* behavior; hosts that own their own expansion gesture opt in.
|
|
1610
|
-
*/
|
|
1611
|
-
hideThinkingBlock?: boolean;
|
|
1612
|
-
assistantBadgeBackground?: ThemeBackground;
|
|
1613
|
-
assistantBadgeForeground?: ThemeColor;
|
|
1614
|
-
/**
|
|
1615
|
-
* Live native tool components keyed by tool call id. When omitted, tool
|
|
1616
|
-
* blocks are rendered through stateless ad-hoc components rebuilt from the
|
|
1617
|
-
* entry data on every frame.
|
|
1618
|
-
*/
|
|
1619
|
-
toolComponents?: ToolComponentLookup;
|
|
1620
|
-
}
|
|
1621
|
-
|
|
1622
|
-
/**
|
|
1623
|
-
* Builds a stateless component for tool blocks rendered without a live
|
|
1624
|
-
* registry (direct API use). Rebuilt per frame; correct output, no incremental
|
|
1625
|
-
* renderer state.
|
|
1626
|
-
*/
|
|
1627
|
-
function createAdHocToolComponent(
|
|
1628
|
-
block: Extract<TranscriptRenderBlock, { kind: "tool-native" }>,
|
|
1629
|
-
): ToolExecutionComponent {
|
|
1630
|
-
const component = new ToolExecutionComponent(
|
|
1631
|
-
block.toolName,
|
|
1632
|
-
block.toolCallId,
|
|
1633
|
-
block.args ?? {},
|
|
1634
|
-
{},
|
|
1635
|
-
undefined,
|
|
1636
|
-
// Only requestRender is ever invoked on the host TUI.
|
|
1637
|
-
DETACHED_TUI as NativeToolTui,
|
|
1638
|
-
process.cwd(),
|
|
1639
|
-
);
|
|
1640
|
-
component.setArgsComplete();
|
|
1641
|
-
component.markExecutionStarted();
|
|
1642
|
-
if (block.result) {
|
|
1643
|
-
component.updateResult(
|
|
1644
|
-
toComponentResult(block.result, block.isError),
|
|
1645
|
-
block.streaming,
|
|
1646
|
-
);
|
|
1647
|
-
}
|
|
1648
|
-
return component;
|
|
1649
|
-
}
|
|
1650
|
-
|
|
1651
|
-
/**
|
|
1652
|
-
* Render normalized transcript entries as terminal lines. User and assistant
|
|
1653
|
-
* messages deliberately use Pi's native components so markdown, code,
|
|
1654
|
-
* thinking, and message theming stay consistent with the main transcript.
|
|
1655
|
-
* Tool calls are rendered by Pi's native `ToolExecutionComponent`, giving
|
|
1656
|
-
* built-in tools their familiar rich output (diffs, file previews, images).
|
|
1657
|
-
*/
|
|
1658
|
-
export function renderTranscriptLines(
|
|
1659
|
-
entries: readonly TranscriptEntry[],
|
|
1660
|
-
options: TranscriptRenderOptions,
|
|
1661
|
-
): string[] {
|
|
1662
|
-
const width = Math.max(1, options.width);
|
|
1663
|
-
const { theme } = options;
|
|
1664
|
-
if (entries.length === 0)
|
|
1665
|
-
return [theme.fg("dim", options.emptyText ?? "No transcript yet.")];
|
|
1666
|
-
|
|
1667
|
-
const lines: string[] = [];
|
|
1668
|
-
const verbatimLines = new Set<number>();
|
|
1669
|
-
const pushVerbatim = (rendered: readonly string[]): void => {
|
|
1670
|
-
for (const line of rendered) {
|
|
1671
|
-
verbatimLines.add(lines.length);
|
|
1672
|
-
lines.push(line);
|
|
1673
|
-
}
|
|
1674
|
-
};
|
|
1675
|
-
const assistantBadge = theme.bg(
|
|
1676
|
-
options.assistantBadgeBackground ?? "customMessageBg",
|
|
1677
|
-
theme.fg(
|
|
1678
|
-
options.assistantBadgeForeground ?? "success",
|
|
1679
|
-
theme.bold(` ${options.assistantLabel ?? "Assistant"} `),
|
|
1680
|
-
),
|
|
1681
|
-
);
|
|
1682
|
-
const separator = theme.fg(
|
|
1683
|
-
"borderMuted",
|
|
1684
|
-
"────────────────────────────────────────",
|
|
1685
|
-
);
|
|
1686
|
-
|
|
1687
|
-
const blankBefore = (): void => {
|
|
1688
|
-
if (lines.length > 0 && lines.at(-1) !== "") lines.push("");
|
|
1689
|
-
};
|
|
1690
|
-
|
|
1691
|
-
for (const block of buildRenderBlocks(entries)) {
|
|
1692
|
-
switch (block.kind) {
|
|
1693
|
-
case "separator":
|
|
1694
|
-
blankBefore();
|
|
1695
|
-
lines.push(separator);
|
|
1696
|
-
break;
|
|
1697
|
-
case "user":
|
|
1698
|
-
lines.push(...renderNativeUserMessage(block.text, width));
|
|
1699
|
-
break;
|
|
1700
|
-
case "assistant":
|
|
1701
|
-
blankBefore();
|
|
1702
|
-
lines.push(assistantBadge);
|
|
1703
|
-
lines.push(
|
|
1704
|
-
...renderNativeAssistantMessage(
|
|
1705
|
-
block.thinking,
|
|
1706
|
-
block.text,
|
|
1707
|
-
width,
|
|
1708
|
-
options.thinkingLabel ?? "Thinking",
|
|
1709
|
-
options.hideThinkingBlock === true,
|
|
1710
|
-
),
|
|
1711
|
-
);
|
|
1712
|
-
break;
|
|
1713
|
-
case "tool-native": {
|
|
1714
|
-
blankBefore();
|
|
1715
|
-
const component =
|
|
1716
|
-
options.toolComponents?.get(block.toolCallId) ??
|
|
1717
|
-
createAdHocToolComponent(block);
|
|
1718
|
-
pushVerbatim(component.render(width));
|
|
1719
|
-
break;
|
|
1720
|
-
}
|
|
1721
|
-
case "notice": {
|
|
1722
|
-
blankBefore();
|
|
1723
|
-
const color = noticeToneColor(block.tone);
|
|
1724
|
-
for (const noticeLine of safeTerminalText(block.text).split("\n"))
|
|
1725
|
-
lines.push(theme.fg(color, noticeLine));
|
|
1726
|
-
break;
|
|
1727
|
-
}
|
|
1728
|
-
default:
|
|
1729
|
-
break;
|
|
1730
|
-
}
|
|
1731
|
-
}
|
|
1732
|
-
|
|
1733
|
-
// wrapRenderedLines preserves length for verbatim lines, so indices stay
|
|
1734
|
-
// aligned for the width-truncation pass below.
|
|
1735
|
-
const wrapped = wrapRenderedLines(lines, width, verbatimLines);
|
|
1736
|
-
return wrapped.map((line, index) =>
|
|
1737
|
-
verbatimLines.has(index) || visibleWidth(line) <= width
|
|
1738
|
-
? line
|
|
1739
|
-
: truncateToWidth(line, width, ""),
|
|
1740
|
-
);
|
|
1741
|
-
}
|
|
1742
|
-
|
|
1743
|
-
export interface TranscriptViewportOptions
|
|
1744
|
-
extends Omit<TranscriptRenderOptions, "width"> {
|
|
1745
|
-
tui: TranscriptTui;
|
|
1746
|
-
readEntries: () => readonly TranscriptEntry[];
|
|
1747
|
-
}
|
|
1748
|
-
|
|
1749
|
-
export interface TranscriptViewportRender {
|
|
1750
|
-
lines: string[];
|
|
1751
|
-
hiddenAbove: number;
|
|
1752
|
-
hiddenBelow: number;
|
|
1753
|
-
totalLines: number;
|
|
1754
|
-
following: boolean;
|
|
1755
|
-
}
|
|
1756
|
-
|
|
1757
|
-
/**
|
|
1758
|
-
* Decodes an SGR mouse-wheel event into a transcript line delta.
|
|
1759
|
-
* Hosts remain responsible for enabling terminal mouse reporting when their
|
|
1760
|
-
* TUI mode does not already provide it.
|
|
1761
|
-
*/
|
|
1762
|
-
export function getTranscriptMouseScrollDelta(data: string): number | null {
|
|
1763
|
-
const match = data.match(
|
|
1764
|
-
new RegExp(`^${ESC_SEQUENCE}\\[<(\\d+);\\d+;\\d+[Mm]$`),
|
|
1765
|
-
);
|
|
1766
|
-
if (!match) return null;
|
|
1767
|
-
|
|
1768
|
-
const button = Number(match[1]);
|
|
1769
|
-
if ((button & 64) !== 64) return null;
|
|
1770
|
-
return (button & 1) === 0 ? -3 : 3;
|
|
1771
|
-
}
|
|
1772
|
-
|
|
1773
|
-
/**
|
|
1774
|
-
* Stateful scrolling viewport for a transcript. It owns no dialog chrome, so
|
|
1775
|
-
* extensions can compose it into their own overlay layout and controls.
|
|
1776
|
-
*/
|
|
1777
|
-
export class TranscriptViewport {
|
|
1778
|
-
private readonly tui: TranscriptTui;
|
|
1779
|
-
private readonly readEntries: () => readonly TranscriptEntry[];
|
|
1780
|
-
private readonly renderOptions: Omit<TranscriptRenderOptions, "width">;
|
|
1781
|
-
private scrollOffset = 0;
|
|
1782
|
-
private viewportHeight = 8;
|
|
1783
|
-
private totalLines = 0;
|
|
1784
|
-
private follow = true;
|
|
1785
|
-
|
|
1786
|
-
constructor(options: TranscriptViewportOptions) {
|
|
1787
|
-
this.tui = options.tui;
|
|
1788
|
-
this.readEntries = options.readEntries;
|
|
1789
|
-
const { tui: _tui, readEntries: _readEntries, ...renderOptions } = options;
|
|
1790
|
-
this.renderOptions = renderOptions;
|
|
1791
|
-
}
|
|
1792
|
-
|
|
1793
|
-
get following(): boolean {
|
|
1794
|
-
return this.follow;
|
|
1795
|
-
}
|
|
1796
|
-
|
|
1797
|
-
refresh(): void {
|
|
1798
|
-
this.tui.requestRender();
|
|
1799
|
-
}
|
|
1800
|
-
|
|
1801
|
-
scroll(delta: number): void {
|
|
1802
|
-
if (delta < 0) this.follow = false;
|
|
1803
|
-
const maxScroll = Math.max(0, this.totalLines - this.viewportHeight);
|
|
1804
|
-
this.scrollOffset = Math.max(
|
|
1805
|
-
0,
|
|
1806
|
-
Math.min(maxScroll, this.scrollOffset + delta),
|
|
1807
|
-
);
|
|
1808
|
-
if (this.scrollOffset >= maxScroll) this.follow = true;
|
|
1809
|
-
this.tui.requestRender();
|
|
1810
|
-
}
|
|
1811
|
-
|
|
1812
|
-
followLatest(): void {
|
|
1813
|
-
this.follow = true;
|
|
1814
|
-
this.scrollOffset = Math.max(0, this.totalLines - this.viewportHeight);
|
|
1815
|
-
this.tui.requestRender();
|
|
1816
|
-
}
|
|
1817
|
-
|
|
1818
|
-
handleInput(data: string): boolean {
|
|
1819
|
-
const mouseScrollDelta = getTranscriptMouseScrollDelta(data);
|
|
1820
|
-
if (mouseScrollDelta !== null) {
|
|
1821
|
-
this.scroll(mouseScrollDelta);
|
|
1822
|
-
return true;
|
|
1823
|
-
}
|
|
1824
|
-
if (matchesKey(data, "up") || matchesKey(data, "k")) {
|
|
1825
|
-
this.scroll(-1);
|
|
1826
|
-
return true;
|
|
1827
|
-
}
|
|
1828
|
-
if (matchesKey(data, "down") || matchesKey(data, "j")) {
|
|
1829
|
-
this.scroll(1);
|
|
1830
|
-
return true;
|
|
1831
|
-
}
|
|
1832
|
-
if (matchesKey(data, "pageUp")) {
|
|
1833
|
-
this.scroll(-Math.max(1, this.viewportHeight - 1));
|
|
1834
|
-
return true;
|
|
1835
|
-
}
|
|
1836
|
-
if (matchesKey(data, "pageDown")) {
|
|
1837
|
-
this.scroll(Math.max(1, this.viewportHeight - 1));
|
|
1838
|
-
return true;
|
|
1839
|
-
}
|
|
1840
|
-
if (matchesKey(data, "home")) {
|
|
1841
|
-
this.follow = false;
|
|
1842
|
-
this.scrollOffset = 0;
|
|
1843
|
-
this.tui.requestRender();
|
|
1844
|
-
return true;
|
|
1845
|
-
}
|
|
1846
|
-
if (matchesKey(data, "end")) {
|
|
1847
|
-
this.followLatest();
|
|
1848
|
-
return true;
|
|
1849
|
-
}
|
|
1850
|
-
return false;
|
|
1851
|
-
}
|
|
1852
|
-
|
|
1853
|
-
render(width: number, height: number): TranscriptViewportRender {
|
|
1854
|
-
const lines = renderTranscriptLines(this.readEntries(), {
|
|
1855
|
-
...this.renderOptions,
|
|
1856
|
-
width,
|
|
1857
|
-
});
|
|
1858
|
-
this.viewportHeight = Math.max(1, height);
|
|
1859
|
-
this.totalLines = lines.length;
|
|
1860
|
-
const maxScroll = Math.max(0, lines.length - this.viewportHeight);
|
|
1861
|
-
if (this.follow) this.scrollOffset = maxScroll;
|
|
1862
|
-
else {
|
|
1863
|
-
this.scrollOffset = Math.max(0, Math.min(this.scrollOffset, maxScroll));
|
|
1864
|
-
if (this.scrollOffset >= maxScroll) this.follow = true;
|
|
1865
|
-
}
|
|
1866
|
-
const visible = lines.slice(
|
|
1867
|
-
this.scrollOffset,
|
|
1868
|
-
this.scrollOffset + this.viewportHeight,
|
|
1869
|
-
);
|
|
1870
|
-
return {
|
|
1871
|
-
lines: visible,
|
|
1872
|
-
hiddenAbove: this.scrollOffset,
|
|
1873
|
-
hiddenBelow: Math.max(0, maxScroll - this.scrollOffset),
|
|
1874
|
-
totalLines: lines.length,
|
|
1875
|
-
following: this.follow,
|
|
1876
|
-
};
|
|
1877
|
-
}
|
|
1878
|
-
}
|