@fitchmultz/pi-subagents 0.44.7 → 0.46.0
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 +264 -7
- package/LICENSE +1 -0
- package/README.md +58 -1483
- package/agents/context-builder.md +19 -1
- package/agents/debugger.md +10 -3
- package/agents/delegate.md +1 -0
- package/agents/fixer.md +4 -1
- package/agents/oracle.md +13 -2
- package/agents/planner.md +14 -3
- package/agents/researcher.md +11 -2
- package/agents/reviewer-claude.md +11 -2
- package/agents/reviewer-gpt.md +12 -2
- package/agents/reviewer-ponytail.md +11 -1
- package/agents/reviewer-security.md +13 -2
- package/agents/reviewer.md +12 -3
- package/agents/scout.md +12 -1
- package/agents/ui-designer.md +10 -3
- package/agents/watcher.md +1 -0
- package/agents/worker.md +8 -2
- package/agents/writer.md +6 -3
- package/dist/agents/agent-defaults.js +9 -0
- package/dist/agents/agent-definition.js +196 -0
- package/dist/agents/agent-management.js +64 -905
- package/dist/agents/agent-scope.js +4 -2
- package/dist/agents/agent-selection.js +10 -5
- package/dist/agents/agent-serializer.js +55 -67
- package/dist/agents/agents.js +75 -716
- package/dist/agents/builtin-overrides.js +218 -0
- package/dist/agents/chain-serializer.js +3 -367
- package/dist/agents/config-values.js +52 -0
- package/dist/agents/discovery-paths.js +91 -0
- package/dist/agents/frontmatter.js +15 -5
- package/dist/agents/identity.js +25 -8
- package/dist/agents/json-chain.js +254 -0
- package/dist/agents/management-config.js +332 -0
- package/dist/agents/management-format.js +231 -0
- package/dist/agents/management-persistence.js +287 -0
- package/dist/agents/management-targets.js +136 -0
- package/dist/agents/management-warnings.js +81 -0
- package/dist/agents/markdown-chain.js +210 -0
- package/dist/agents/package-agents.js +154 -0
- package/dist/agents/skill-files.js +157 -0
- package/dist/agents/skill-search-paths.js +246 -0
- package/dist/agents/skill-types.js +1 -0
- package/dist/agents/skills.js +54 -499
- package/dist/extension/acceptance-schema.js +55 -0
- package/dist/extension/build-info.js +1 -1
- package/dist/extension/chain-schema.js +196 -0
- package/dist/extension/child-runtime.js +237 -0
- package/dist/extension/compact-tools.js +122 -51
- package/dist/extension/config-schema.js +29 -0
- package/dist/extension/config.js +27 -11
- package/dist/extension/control-notice-schema.js +37 -0
- package/dist/extension/control-notices.js +13 -6
- package/dist/extension/delegation-bridges.js +43 -0
- package/dist/extension/doctor.js +48 -25
- package/dist/extension/everyday-schemas.js +207 -0
- package/dist/extension/fanout-child.js +18 -319
- package/dist/extension/index.js +8 -563
- package/dist/extension/message-renderers.js +225 -0
- package/dist/extension/nested-control-inbox.js +154 -0
- package/dist/extension/parent-runtime.js +339 -0
- package/dist/extension/primary-tool.js +69 -0
- package/dist/extension/result-snapshot.js +22 -0
- package/dist/extension/runtime-reload.js +62 -0
- package/dist/extension/runtime-storage.js +43 -0
- package/dist/extension/schema-overrides.js +75 -0
- package/dist/extension/schemas.js +265 -336
- package/dist/extension/tool-input.js +27 -12
- package/dist/extension/tool-result.js +19 -4
- package/dist/history/answer-texts.js +57 -0
- package/dist/history/canonical-result.js +76 -43
- package/dist/history/canonical-selection.js +40 -0
- package/dist/history/database-generation.js +82 -0
- package/dist/history/database.js +57 -33
- package/dist/history/entry-ingestion.js +61 -0
- package/dist/history/index.js +242 -97
- package/dist/history/ingest.js +168 -331
- package/dist/history/output-digests.js +40 -0
- package/dist/history/preview.js +210 -0
- package/dist/history/prune.js +33 -0
- package/dist/history/queries.js +60 -349
- package/dist/history/query-scope.js +190 -0
- package/dist/history/rows.js +77 -0
- package/dist/history/run-projection.js +137 -0
- package/dist/history/run-queries.js +153 -0
- package/dist/history/schema.js +31 -0
- package/dist/history/search-queries.js +163 -0
- package/dist/history/selected-record.js +108 -0
- package/dist/history/source-file.js +45 -0
- package/dist/history/source-watches.js +141 -0
- package/dist/history/store.js +164 -153
- package/dist/history/text-chunks.js +169 -0
- package/dist/history/text.js +35 -0
- package/dist/history/transcript-queries.js +177 -0
- package/dist/history/types.js +5 -1
- package/dist/history/values.js +36 -0
- package/dist/history/wire-inputs.js +122 -0
- package/dist/history/wire-models.js +38 -0
- package/dist/history/worker-runtime.js +441 -0
- package/dist/history/worker.js +66 -462
- package/dist/intercom/intercom-bridge.js +48 -20
- package/dist/intercom/live-intercom.js +80 -23
- package/dist/intercom/nested-result-tree.js +163 -0
- package/dist/intercom/result-delivery.js +40 -0
- package/dist/intercom/result-intercom.js +178 -261
- package/dist/pi-intercom/agent-dir.js +7 -3
- package/dist/pi-intercom/async.js +27 -0
- package/dist/pi-intercom/bridge-ask.js +57 -0
- package/dist/pi-intercom/bridge-config.js +89 -0
- package/dist/pi-intercom/bridge-http.js +86 -0
- package/dist/pi-intercom/bridge-launch-policy.js +88 -0
- package/dist/pi-intercom/bridge-launch.js +217 -0
- package/dist/pi-intercom/bridge-protocol.js +106 -0
- package/dist/pi-intercom/bridge-routes.js +72 -0
- package/dist/pi-intercom/bridge-rpc-process.js +264 -0
- package/dist/pi-intercom/bridge-session.js +420 -0
- package/dist/pi-intercom/bridge.js +221 -606
- package/dist/pi-intercom/broker/broker.js +236 -244
- package/dist/pi-intercom/broker/client.js +189 -304
- package/dist/pi-intercom/broker/connection.js +165 -0
- package/dist/pi-intercom/broker/framing.js +5 -3
- package/dist/pi-intercom/broker/paths.js +4 -1
- package/dist/pi-intercom/broker/pid.js +53 -25
- package/dist/pi-intercom/broker/snapshot-reader.js +78 -0
- package/dist/pi-intercom/broker/snapshots.js +188 -0
- package/dist/pi-intercom/broker/spawn.js +36 -25
- package/dist/pi-intercom/config.js +85 -71
- package/dist/pi-intercom/connection.js +297 -0
- package/dist/pi-intercom/identity.js +58 -0
- package/dist/pi-intercom/inbound-delivery.js +356 -0
- package/dist/pi-intercom/inbound-journal.js +303 -0
- package/dist/pi-intercom/inbound-record.js +113 -0
- package/dist/pi-intercom/inbound.js +179 -0
- package/dist/pi-intercom/index.js +79 -2933
- package/dist/pi-intercom/inspection.js +62 -0
- package/dist/pi-intercom/interview.js +236 -0
- package/dist/pi-intercom/lifecycle.js +168 -0
- package/dist/pi-intercom/message-format.js +69 -0
- package/dist/pi-intercom/outbound.js +304 -0
- package/dist/pi-intercom/peer-awareness.js +66 -0
- package/dist/pi-intercom/reply-tracker.js +62 -43
- package/dist/pi-intercom/reply-wait.js +201 -0
- package/dist/pi-intercom/runtime-types.js +3 -0
- package/dist/pi-intercom/session-events.js +180 -0
- package/dist/pi-intercom/session-targets.js +42 -34
- package/dist/pi-intercom/subagent-events.js +238 -0
- package/dist/pi-intercom/subagent-live-events.js +129 -86
- package/dist/pi-intercom/supervisor.js +282 -0
- package/dist/pi-intercom/tool-arguments.js +74 -0
- package/dist/pi-intercom/tool-registration.js +95 -0
- package/dist/pi-intercom/tool-results.js +38 -0
- package/dist/pi-intercom/tool-schemas.js +82 -0
- package/dist/pi-intercom/tools.js +51 -0
- package/dist/pi-intercom/topic-actions.js +177 -0
- package/dist/pi-intercom/topics.js +177 -92
- package/dist/pi-intercom/transport.js +1 -0
- package/dist/pi-intercom/types.js +151 -114
- package/dist/pi-intercom/ui/compose-paste.js +93 -0
- package/dist/pi-intercom/ui/compose.js +121 -143
- package/dist/pi-intercom/ui/inline-message.js +59 -59
- package/dist/pi-intercom/ui/message-renderers.js +147 -0
- package/dist/pi-intercom/ui/overlay.js +181 -0
- package/dist/pi-intercom/ui/session-format.js +124 -0
- package/dist/pi-intercom/ui/session-list.js +76 -43
- package/dist/pi-intercom/ui/tool-renderers.js +110 -0
- package/dist/pi-intercom/ui/topic-view.js +88 -0
- package/dist/pi-intercom/validation.js +59 -0
- package/dist/runs/background/async-chain-plan.js +265 -0
- package/dist/runs/background/async-control.js +134 -58
- package/dist/runs/background/async-execution.js +136 -633
- package/dist/runs/background/async-job-admission.js +40 -0
- package/dist/runs/background/async-job-projection.js +169 -0
- package/dist/runs/background/async-job-tracker.js +297 -327
- package/dist/runs/background/async-launch.js +216 -0
- package/dist/runs/background/async-plan.js +116 -0
- package/dist/runs/background/async-result-file.js +47 -23
- package/dist/runs/background/async-resume.js +195 -253
- package/dist/runs/background/async-run-discovery.js +213 -0
- package/dist/runs/background/async-run-location.js +135 -0
- package/dist/runs/background/async-run-record.js +1 -0
- package/dist/runs/background/async-run-repair.js +223 -0
- package/dist/runs/background/async-run-summary.js +1 -0
- package/dist/runs/background/async-single-plan.js +105 -0
- package/dist/runs/background/async-status-projection.js +155 -0
- package/dist/runs/background/async-status-render.js +117 -0
- package/dist/runs/background/async-status-validation.js +181 -0
- package/dist/runs/background/async-status.js +3 -442
- package/dist/runs/background/async-value.js +21 -0
- package/dist/runs/background/completion-dedupe.js +36 -12
- package/dist/runs/background/completion-delivery.js +211 -205
- package/dist/runs/background/completion-receipts.js +237 -0
- package/dist/runs/background/legacy-status-acceptance.js +34 -0
- package/dist/runs/background/notify.js +96 -48
- package/dist/runs/background/parallel-groups.js +36 -19
- package/dist/runs/background/result-payload.js +178 -0
- package/dist/runs/background/result-watcher.js +348 -339
- package/dist/runs/background/run-id-resolver.js +53 -33
- package/dist/runs/background/run-schemas.js +189 -0
- package/dist/runs/background/run-status-contracts.js +14 -0
- package/dist/runs/background/run-status-render.js +270 -0
- package/dist/runs/background/run-status.js +231 -339
- package/dist/runs/background/runner-attempt-output.js +155 -0
- package/dist/runs/background/runner-attempt.js +263 -0
- package/dist/runs/background/runner-child-executor.js +166 -0
- package/dist/runs/background/runner-child-observer.js +192 -0
- package/dist/runs/background/runner-completion-summary.js +71 -0
- package/dist/runs/background/runner-completion.js +211 -0
- package/dist/runs/background/runner-config.js +1 -0
- package/dist/runs/background/runner-contract.js +1 -0
- package/dist/runs/background/runner-dynamic.js +121 -0
- package/dist/runs/background/runner-finalization.js +149 -0
- package/dist/runs/background/runner-graph.js +68 -0
- package/dist/runs/background/runner-initial-status.js +60 -0
- package/dist/runs/background/runner-lifecycle.js +142 -0
- package/dist/runs/background/runner-monitor.js +309 -0
- package/dist/runs/background/runner-parallel.js +204 -0
- package/dist/runs/background/runner-prepare-step.js +86 -0
- package/dist/runs/background/runner-reporting.js +153 -0
- package/dist/runs/background/runner-status.js +148 -0
- package/dist/runs/background/runner-step-output.js +92 -0
- package/dist/runs/background/runner-step-record.js +45 -0
- package/dist/runs/background/runner-step.js +112 -0
- package/dist/runs/background/runner-streaming.js +173 -0
- package/dist/runs/background/runner-workflow.js +213 -0
- package/dist/runs/background/stale-run-reconciler.js +155 -292
- package/dist/runs/background/subagent-runner-launcher.js +33 -13
- package/dist/runs/background/subagent-runner.js +51 -1842
- package/dist/runs/background/top-level-async.js +2 -1
- package/dist/runs/foreground/chain-clarify.js +293 -1017
- package/dist/runs/foreground/clarification-draft.js +87 -0
- package/dist/runs/foreground/clarify-contracts.js +1 -0
- package/dist/runs/foreground/clarify-invocation.js +129 -38
- package/dist/runs/foreground/clarify-text-editor.js +210 -0
- package/dist/runs/foreground/clarify-view.js +167 -0
- package/dist/runs/foreground/execution-input.js +226 -353
- package/dist/runs/foreground/execution-routing.js +33 -0
- package/dist/runs/foreground/execution-timeout.js +81 -0
- package/dist/runs/foreground/foreground-control.js +222 -763
- package/dist/runs/foreground/foreground-memory.js +99 -0
- package/dist/runs/foreground/invocation-context.js +55 -0
- package/dist/runs/foreground/invocation-execution.js +331 -0
- package/dist/runs/foreground/invocation-expansion.js +48 -0
- package/dist/runs/foreground/management-actions.js +295 -0
- package/dist/runs/foreground/nested-control.js +179 -0
- package/dist/runs/foreground/question-continuation.js +78 -0
- package/dist/runs/foreground/question-control.js +155 -50
- package/dist/runs/foreground/resume-target.js +221 -0
- package/dist/runs/foreground/revival-launch-policy.js +58 -0
- package/dist/runs/foreground/run-async-path.js +190 -178
- package/dist/runs/foreground/run-interrupt.js +164 -0
- package/dist/runs/foreground/run-nudge.js +278 -0
- package/dist/runs/foreground/saved-revival.js +251 -0
- package/dist/runs/foreground/subagent-executor.js +135 -424
- package/dist/runs/foreground/subagent-params.js +67 -30
- package/dist/runs/foreground/wait-observation.js +104 -0
- package/dist/runs/foreground/wait-registration.js +17 -0
- package/dist/runs/foreground/wait-run.js +283 -123
- package/dist/runs/shared/acceptance-contract.js +193 -99
- package/dist/runs/shared/acceptance-defaults.js +1 -0
- package/dist/runs/shared/acceptance-evaluation.js +201 -181
- package/dist/runs/shared/acceptance-finalization.js +256 -180
- package/dist/runs/shared/acceptance-outcome.js +53 -0
- package/dist/runs/shared/acceptance-reports.js +137 -72
- package/dist/runs/shared/acceptance-submission.js +167 -0
- package/dist/runs/shared/acceptance-verification.js +100 -0
- package/dist/runs/shared/chain-outputs.js +80 -52
- package/dist/runs/shared/child-attempt-types.js +1 -0
- package/dist/runs/shared/child-attempt.js +314 -667
- package/dist/runs/shared/child-boundaries.js +173 -0
- package/dist/runs/shared/child-context-filter.js +44 -0
- package/dist/runs/shared/child-event-observer.js +390 -0
- package/dist/runs/shared/child-execution-cwd.js +73 -43
- package/dist/runs/shared/child-execution-outcome.js +72 -0
- package/dist/runs/shared/child-invocation.js +54 -0
- package/dist/runs/shared/child-message-validation.js +215 -0
- package/dist/runs/shared/child-native-accounting.js +106 -0
- package/dist/runs/shared/child-native-observation.js +69 -0
- package/dist/runs/shared/child-observation-spool.js +164 -0
- package/dist/runs/shared/child-observations.js +157 -76
- package/dist/runs/shared/child-presence.js +3 -0
- package/dist/runs/shared/child-route-env.js +119 -0
- package/dist/runs/shared/child-stream-observer.js +221 -0
- package/dist/runs/shared/child-stream-projection.js +137 -0
- package/dist/runs/shared/child-structured-tool.js +27 -0
- package/dist/runs/shared/claude-code.js +121 -158
- package/dist/runs/shared/claude-model.js +42 -0
- package/dist/runs/shared/claude-session.js +83 -0
- package/dist/runs/shared/claude-types.js +1 -0
- package/dist/runs/shared/completion-guard.js +18 -18
- package/dist/runs/shared/control-event-policy.js +8 -0
- package/dist/runs/shared/control-notification-owner.js +13 -0
- package/dist/runs/shared/dynamic-fanout.js +188 -173
- package/dist/runs/shared/dynamic-item.js +102 -0
- package/dist/runs/shared/history-index.js +62 -36
- package/dist/runs/shared/legacy-async-recovery.js +114 -0
- package/dist/runs/shared/legacy-output-recovery.js +148 -0
- package/dist/runs/shared/mcp-config-schema.js +36 -0
- package/dist/runs/shared/mcp-direct-tool-allowlist.js +147 -116
- package/dist/runs/shared/model-fallback.js +97 -38
- package/dist/runs/shared/mutating-tool-guard.js +128 -88
- package/dist/runs/shared/native-finalization-types.js +1 -0
- package/dist/runs/shared/native-finalization.js +155 -76
- package/dist/runs/shared/native-usage.js +238 -98
- package/dist/runs/shared/nested-control-records.js +128 -0
- package/dist/runs/shared/nested-events.js +8 -700
- package/dist/runs/shared/nested-path.js +32 -28
- package/dist/runs/shared/nested-projection.js +155 -0
- package/dist/runs/shared/nested-protocol.js +18 -0
- package/dist/runs/shared/nested-registry.js +191 -0
- package/dist/runs/shared/nested-render.js +106 -58
- package/dist/runs/shared/nested-route.js +220 -0
- package/dist/runs/shared/nested-validation.js +216 -0
- package/dist/runs/shared/owned-child-evidence.js +125 -0
- package/dist/runs/shared/owned-run-list.js +146 -0
- package/dist/runs/shared/owned-run-observation.js +267 -0
- package/dist/runs/shared/owned-run-progress.js +109 -0
- package/dist/runs/shared/owned-run-read-state.js +1 -0
- package/dist/runs/shared/owned-run-results.js +202 -0
- package/dist/runs/shared/owned-run-status.js +180 -0
- package/dist/runs/shared/owned-run-view.js +51 -0
- package/dist/runs/shared/owned-workflow-details.js +17 -0
- package/dist/runs/shared/owner-output.js +43 -0
- package/dist/runs/shared/parallel-utils.js +36 -28
- package/dist/runs/shared/parent-receipts.js +90 -32
- package/dist/runs/shared/parent-usage.js +169 -57
- package/dist/runs/shared/pi-args.js +108 -201
- package/dist/runs/shared/pi-launch-input.js +1 -0
- package/dist/runs/shared/pi-session-launch.js +86 -0
- package/dist/runs/shared/pi-spawn.js +35 -21
- package/dist/runs/shared/run-history-queries.js +126 -35
- package/dist/runs/shared/run-history.js +101 -35
- package/dist/runs/shared/run-metadata-paths.js +14 -0
- package/dist/runs/shared/run-metadata.js +158 -0
- package/dist/runs/shared/run-persistence.js +131 -0
- package/dist/runs/shared/run-records.js +9 -679
- package/dist/runs/shared/run-restoration.js +338 -0
- package/dist/runs/shared/run-state-owner.js +26 -0
- package/dist/runs/shared/session-cwd-preload.js +27 -18
- package/dist/runs/shared/single-output.js +148 -70
- package/dist/runs/shared/stable-value.js +15 -0
- package/dist/runs/shared/streaming-text.js +23 -12
- package/dist/runs/shared/structured-output.js +25 -13
- package/dist/runs/shared/subagent-control.js +167 -100
- package/dist/runs/shared/subagent-prompt-runtime.js +27 -130
- package/dist/runs/shared/subagent-tool-loop-guard.js +81 -52
- package/dist/runs/shared/supervisor-question-state.js +145 -0
- package/dist/runs/shared/supervisor-questions.js +185 -254
- package/dist/runs/shared/workflow-graph.js +259 -167
- package/dist/runs/shared/workflow-policy.js +120 -48
- package/dist/runs/shared/worktree-contract.js +1 -0
- package/dist/runs/shared/worktree-hook.js +138 -0
- package/dist/runs/shared/worktree-location.js +47 -0
- package/dist/runs/shared/worktree-preservation.js +8 -0
- package/dist/runs/shared/worktree-process.js +107 -0
- package/dist/runs/shared/worktree.js +183 -322
- package/dist/shared/agent-context-policy.js +34 -44
- package/dist/shared/agent-dir.js +14 -0
- package/dist/shared/artifacts.js +30 -12
- package/dist/shared/atomic-json.js +4 -1
- package/dist/shared/chain-files.js +72 -0
- package/dist/shared/concurrency.js +18 -0
- package/dist/shared/content-preview.js +115 -0
- package/dist/shared/cooperative.js +5 -2
- package/dist/shared/execution-cwd.js +13 -5
- package/dist/shared/file-coalescer.js +2 -1
- package/dist/shared/fork-context.js +10 -12
- package/dist/shared/formatters.js +45 -19
- package/dist/shared/journal-frames.js +164 -0
- package/dist/shared/journal-projections.js +121 -0
- package/dist/shared/journal-reader.js +6 -407
- package/dist/shared/json-projection.js +191 -0
- package/dist/shared/lazy-tools.js +19 -8
- package/dist/shared/message-output.js +116 -0
- package/dist/shared/model-info.js +31 -14
- package/dist/shared/native-import.js +20 -0
- package/dist/shared/native-journal.js +140 -0
- package/dist/shared/native-session-loader.js +17 -0
- package/dist/shared/native-session.js +2 -13
- package/dist/shared/native-tui.js +7 -2
- package/dist/shared/native-typebox.js +15 -3
- package/dist/shared/output-page.js +63 -0
- package/dist/shared/post-exit-stdio-guard.js +128 -88
- package/dist/shared/prompt-sections.js +2 -0
- package/dist/shared/session-entries.js +70 -35
- package/dist/shared/session-identity.js +5 -3
- package/dist/shared/settings.js +62 -192
- package/dist/shared/status-format.js +97 -37
- package/dist/shared/task-file-policy.js +24 -0
- package/dist/shared/temp-root.js +44 -15
- package/dist/shared/types/acceptance.js +1 -0
- package/dist/shared/types/async.js +1 -0
- package/dist/shared/types/config.js +1 -0
- package/dist/shared/types/details.js +1 -0
- package/dist/shared/types/history.js +1 -0
- package/dist/shared/types/inputs.js +1 -0
- package/dist/shared/types/intercom.js +1 -0
- package/dist/shared/types/launch.js +1 -0
- package/dist/shared/types/messages.js +1 -0
- package/dist/shared/types/nested.js +1 -0
- package/dist/shared/types/owned-runs.js +1 -0
- package/dist/shared/types/progress.js +1 -0
- package/dist/shared/types/questions.js +1 -0
- package/dist/shared/types/results.js +1 -0
- package/dist/shared/types/state.js +1 -0
- package/dist/shared/types/usage.js +1 -0
- package/dist/shared/types/workflow.js +1 -0
- package/dist/shared/types.js +75 -30
- package/dist/shared/unknown.js +52 -0
- package/dist/shared/utils.js +54 -260
- package/dist/slash/command-discovery.js +82 -0
- package/dist/slash/command-input.js +190 -0
- package/dist/slash/prompt-template-bridge.js +94 -270
- package/dist/slash/prompt-template-contract.js +77 -0
- package/dist/slash/prompt-template-results.js +125 -0
- package/dist/slash/request-protocol.js +68 -0
- package/dist/slash/result-delivery.js +237 -0
- package/dist/slash/saved-chain.js +78 -0
- package/dist/slash/slash-bridge.js +123 -89
- package/dist/slash/slash-commands.js +101 -572
- package/dist/slash/slash-live-state.js +68 -47
- package/dist/tui/action-hints.js +50 -22
- package/dist/tui/activity-lines.js +32 -0
- package/dist/tui/agent-browser.js +290 -0
- package/dist/tui/agent-controls.js +289 -0
- package/dist/tui/agent-conversation.js +444 -0
- package/dist/tui/agent-dock.js +171 -0
- package/dist/tui/agent-history.js +50 -183
- package/dist/tui/agent-model.js +62 -0
- package/dist/tui/agent-picker.js +262 -0
- package/dist/tui/agent-view.js +232 -1564
- package/dist/tui/compact-results.js +193 -0
- package/dist/tui/conversation-details.js +190 -0
- package/dist/tui/conversation-frame.js +135 -0
- package/dist/tui/conversation-history.js +201 -0
- package/dist/tui/conversation-menu.js +78 -0
- package/dist/tui/conversation-notices.js +79 -0
- package/dist/tui/conversation-selection.js +58 -0
- package/dist/tui/conversation-viewport.js +129 -0
- package/dist/tui/direction-message.js +27 -0
- package/dist/tui/display.js +282 -0
- package/dist/tui/editor-viewport.js +18 -0
- package/dist/tui/expanded-content.js +87 -0
- package/dist/tui/expanded-multi.js +170 -0
- package/dist/tui/expanded-single.js +65 -0
- package/dist/tui/history-cards.js +216 -0
- package/dist/tui/history-display.js +238 -0
- package/dist/tui/history-json.js +16 -0
- package/dist/tui/history-metadata.js +152 -0
- package/dist/tui/history-record.js +251 -0
- package/dist/tui/history-text.js +34 -0
- package/dist/tui/indexed-history.js +116 -0
- package/dist/tui/nested-widget.js +120 -0
- package/dist/tui/picker-page.js +59 -0
- package/dist/tui/render.js +58 -1501
- package/dist/tui/result-facts.js +64 -0
- package/dist/tui/task-observation.js +59 -0
- package/dist/tui/task-store.js +366 -0
- package/dist/tui/text-values.js +16 -0
- package/dist/tui/view-connections.js +47 -0
- package/dist/tui/view-model.js +94 -0
- package/dist/tui/view-persistence.js +51 -0
- package/dist/tui/view-ports.js +1 -0
- package/dist/tui/view-session.js +37 -0
- package/dist/tui/widget-details.js +144 -0
- package/dist/tui/widget-status.js +245 -0
- package/dist/tui/widget.js +145 -0
- package/dist/tui/workflow-labels.js +223 -0
- package/dist/tui/workflow-outcomes.js +124 -0
- package/docs/code-quality.md +38 -0
- package/docs/development.md +99 -0
- package/docs/intercom-bridge.md +77 -22
- package/docs/intercom.md +132 -106
- package/docs/performance.md +19 -17
- package/docs/reference.md +1472 -0
- package/generated/RunValidators.d.ts +28 -0
- package/generated/RunValidators.js +2 -0
- package/package.json +27 -6
- package/prompts/parallel-cleanup.md +3 -0
- package/prompts/parallel-context-build.md +3 -0
- package/prompts/parallel-handoff-plan.md +6 -0
- package/prompts/parallel-research.md +4 -0
- package/prompts/parallel-review.md +2 -0
- package/prompts/review-loop.md +2 -0
- package/scripts/build.mjs +129 -85
- package/scripts/check-compat.mjs +48 -11
- package/scripts/compat-host.mjs +35 -7
- package/scripts/generate-run-schemas.mjs +210 -0
- package/scripts/intercom-bridge-credentials.mjs +158 -29
- package/scripts/intercom-remote.mjs +213 -52
- package/scripts/local-install-smoke.mjs +47 -37
- package/scripts/native-package-smoke.mjs +135 -25
- package/scripts/package-smoke.mjs +360 -140
- package/scripts/prepare.mjs +54 -34
- package/scripts/real-pi-processes.mjs +261 -0
- package/scripts/real-pi-smoke.mjs +432 -351
- package/scripts/run-tests.mjs +29 -15
- package/skills/pi-intercom/SKILL.md +11 -11
- package/skills/pi-intercom/references/peer-sessions.md +7 -2
- package/skills/pi-subagents/SKILL.md +1 -1
- package/skills/pi-subagents/references/full-orchestration-guide.md +254 -112
- package/src/agents/agent-defaults.ts +13 -0
- package/src/agents/agent-definition.ts +253 -0
- package/src/agents/agent-management.ts +111 -808
- package/src/agents/agent-scope.ts +7 -3
- package/src/agents/agent-selection.ts +26 -16
- package/src/agents/agent-serializer.ts +84 -93
- package/src/agents/agents.ts +199 -906
- package/src/agents/builtin-overrides.ts +297 -0
- package/src/agents/chain-serializer.ts +3 -329
- package/src/agents/config-values.ts +57 -0
- package/src/agents/discovery-paths.ts +134 -0
- package/src/agents/frontmatter.ts +35 -17
- package/src/agents/identity.ts +49 -18
- package/src/agents/json-chain.ts +305 -0
- package/src/agents/management-config.ts +342 -0
- package/src/agents/management-format.ts +243 -0
- package/src/agents/management-persistence.ts +408 -0
- package/src/agents/management-targets.ts +260 -0
- package/src/agents/management-warnings.ts +115 -0
- package/src/agents/markdown-chain.ts +237 -0
- package/src/agents/package-agents.ts +231 -0
- package/src/agents/skill-files.ts +182 -0
- package/src/agents/skill-search-paths.ts +289 -0
- package/src/agents/skill-types.ts +31 -0
- package/src/agents/skills.ts +152 -610
- package/src/extension/acceptance-schema.ts +88 -0
- package/src/extension/chain-schema.ts +276 -0
- package/src/extension/child-runtime.ts +302 -0
- package/src/extension/compact-tools.ts +259 -102
- package/src/extension/config-schema.ts +59 -0
- package/src/extension/config.ts +39 -17
- package/src/extension/control-notice-schema.ts +55 -0
- package/src/extension/control-notices.ts +57 -33
- package/src/extension/delegation-bridges.ts +59 -0
- package/src/extension/doctor.ts +171 -135
- package/src/extension/everyday-schemas.ts +252 -0
- package/src/extension/fanout-child.ts +29 -308
- package/src/extension/index.ts +17 -642
- package/src/extension/message-renderers.ts +334 -0
- package/src/extension/nested-control-inbox.ts +196 -0
- package/src/extension/parent-runtime.ts +405 -0
- package/src/extension/primary-tool.ts +130 -0
- package/src/extension/result-snapshot.ts +35 -0
- package/src/extension/runtime-reload.ts +72 -0
- package/src/extension/runtime-storage.ts +49 -0
- package/src/extension/schema-overrides.ts +114 -0
- package/src/extension/schemas.ts +451 -418
- package/src/extension/tool-input.ts +40 -13
- package/src/extension/tool-result.ts +45 -14
- package/src/history/answer-texts.ts +74 -0
- package/src/history/canonical-result.ts +127 -51
- package/src/history/canonical-selection.ts +54 -0
- package/src/history/database-generation.ts +86 -0
- package/src/history/database.ts +86 -48
- package/src/history/entry-ingestion.ts +129 -0
- package/src/history/index.ts +426 -148
- package/src/history/ingest.ts +372 -342
- package/src/history/output-digests.ts +41 -0
- package/src/history/preview.ts +235 -0
- package/src/history/prune.ts +48 -0
- package/src/history/queries.ts +122 -256
- package/src/history/query-scope.ts +278 -0
- package/src/history/rows.ts +118 -0
- package/src/history/run-projection.ts +164 -0
- package/src/history/run-queries.ts +199 -0
- package/src/history/schema.ts +34 -0
- package/src/history/search-queries.ts +216 -0
- package/src/history/selected-record.ts +140 -0
- package/src/history/source-file.ts +51 -0
- package/src/history/source-watches.ts +156 -0
- package/src/history/store.ts +310 -197
- package/src/history/text-chunks.ts +181 -0
- package/src/history/text.ts +43 -0
- package/src/history/transcript-queries.ts +251 -0
- package/src/history/types.ts +27 -164
- package/src/history/values.ts +36 -0
- package/src/history/wire-inputs.ts +141 -0
- package/src/history/wire-models.ts +51 -0
- package/src/history/worker-runtime.ts +502 -0
- package/src/history/worker.ts +94 -336
- package/src/intercom/intercom-bridge.ts +136 -69
- package/src/intercom/live-intercom.ts +197 -92
- package/src/intercom/nested-result-tree.ts +213 -0
- package/src/intercom/result-delivery.ts +56 -0
- package/src/intercom/result-intercom.ts +364 -382
- package/src/pi-intercom/agent-dir.ts +9 -3
- package/src/pi-intercom/async.ts +33 -0
- package/src/pi-intercom/bridge-ask.ts +64 -0
- package/src/pi-intercom/bridge-config.ts +120 -0
- package/src/pi-intercom/bridge-http.ts +97 -0
- package/src/pi-intercom/bridge-launch-policy.ts +109 -0
- package/src/pi-intercom/bridge-launch.ts +317 -0
- package/src/pi-intercom/bridge-protocol.ts +123 -0
- package/src/pi-intercom/bridge-routes.ts +105 -0
- package/src/pi-intercom/bridge-rpc-process.ts +293 -0
- package/src/pi-intercom/bridge-session.ts +510 -0
- package/src/pi-intercom/bridge.ts +305 -549
- package/src/pi-intercom/broker/broker.ts +326 -263
- package/src/pi-intercom/broker/client.ts +273 -354
- package/src/pi-intercom/broker/connection.ts +192 -0
- package/src/pi-intercom/broker/framing.ts +11 -6
- package/src/pi-intercom/broker/paths.ts +28 -25
- package/src/pi-intercom/broker/pid.ts +68 -24
- package/src/pi-intercom/broker/snapshot-reader.ts +91 -0
- package/src/pi-intercom/broker/snapshots.ts +241 -0
- package/src/pi-intercom/broker/spawn.ts +58 -34
- package/src/pi-intercom/config.ts +113 -108
- package/src/pi-intercom/connection.ts +346 -0
- package/src/pi-intercom/identity.ts +71 -0
- package/src/pi-intercom/inbound-delivery.ts +450 -0
- package/src/pi-intercom/inbound-journal.ts +350 -0
- package/src/pi-intercom/inbound-record.ts +141 -0
- package/src/pi-intercom/inbound.ts +237 -0
- package/src/pi-intercom/index.ts +86 -2923
- package/src/pi-intercom/inspection.ts +82 -0
- package/src/pi-intercom/interview.ts +295 -0
- package/src/pi-intercom/lifecycle.ts +183 -0
- package/src/pi-intercom/message-format.ts +77 -0
- package/src/pi-intercom/outbound.ts +418 -0
- package/src/pi-intercom/peer-awareness.ts +84 -0
- package/src/pi-intercom/reply-tracker.ts +121 -59
- package/src/pi-intercom/reply-wait.ts +247 -0
- package/src/pi-intercom/runtime-types.ts +97 -0
- package/src/pi-intercom/session-events.ts +247 -0
- package/src/pi-intercom/session-targets.ts +124 -72
- package/src/pi-intercom/subagent-events.ts +299 -0
- package/src/pi-intercom/subagent-live-events.ts +212 -109
- package/src/pi-intercom/supervisor.ts +362 -0
- package/src/pi-intercom/tool-arguments.ts +120 -0
- package/src/pi-intercom/tool-registration.ts +121 -0
- package/src/pi-intercom/tool-results.ts +54 -0
- package/src/pi-intercom/tool-schemas.ts +134 -0
- package/src/pi-intercom/tools.ts +80 -0
- package/src/pi-intercom/topic-actions.ts +243 -0
- package/src/pi-intercom/topics.ts +267 -121
- package/src/pi-intercom/transport.ts +14 -0
- package/src/pi-intercom/types.ts +288 -190
- package/src/pi-intercom/ui/compose-paste.ts +109 -0
- package/src/pi-intercom/ui/compose.ts +173 -157
- package/src/pi-intercom/ui/inline-message.ts +80 -62
- package/src/pi-intercom/ui/message-renderers.ts +182 -0
- package/src/pi-intercom/ui/overlay.ts +238 -0
- package/src/pi-intercom/ui/session-format.ts +146 -0
- package/src/pi-intercom/ui/session-list.ts +145 -62
- package/src/pi-intercom/ui/tool-renderers.ts +148 -0
- package/src/pi-intercom/ui/topic-view.ts +107 -0
- package/src/pi-intercom/validation.ts +69 -0
- package/src/runs/background/async-chain-plan.ts +451 -0
- package/src/runs/background/async-control.ts +201 -71
- package/src/runs/background/async-execution.ts +206 -829
- package/src/runs/background/async-job-admission.ts +54 -0
- package/src/runs/background/async-job-projection.ts +225 -0
- package/src/runs/background/async-job-tracker.ts +416 -360
- package/src/runs/background/async-launch.ts +319 -0
- package/src/runs/background/async-plan.ts +285 -0
- package/src/runs/background/async-result-file.ts +79 -37
- package/src/runs/background/async-resume.ts +338 -285
- package/src/runs/background/async-run-discovery.ts +270 -0
- package/src/runs/background/async-run-location.ts +194 -0
- package/src/runs/background/async-run-record.ts +14 -0
- package/src/runs/background/async-run-repair.ts +307 -0
- package/src/runs/background/async-run-summary.ts +71 -0
- package/src/runs/background/async-single-plan.ts +168 -0
- package/src/runs/background/async-status-projection.ts +188 -0
- package/src/runs/background/async-status-render.ts +164 -0
- package/src/runs/background/async-status-validation.ts +238 -0
- package/src/runs/background/async-status.ts +9 -481
- package/src/runs/background/async-value.ts +29 -0
- package/src/runs/background/completion-dedupe.ts +103 -54
- package/src/runs/background/completion-delivery.ts +313 -187
- package/src/runs/background/completion-receipts.ts +309 -0
- package/src/runs/background/legacy-status-acceptance.ts +38 -0
- package/src/runs/background/notify.ts +167 -106
- package/src/runs/background/parallel-groups.ts +95 -46
- package/src/runs/background/result-payload.ts +268 -0
- package/src/runs/background/result-watcher.ts +484 -387
- package/src/runs/background/run-id-resolver.ts +126 -57
- package/src/runs/background/run-schemas.ts +240 -0
- package/src/runs/background/run-status-contracts.ts +46 -0
- package/src/runs/background/run-status-render.ts +364 -0
- package/src/runs/background/run-status.ts +338 -356
- package/src/runs/background/runner-attempt-output.ts +281 -0
- package/src/runs/background/runner-attempt.ts +354 -0
- package/src/runs/background/runner-child-executor.ts +232 -0
- package/src/runs/background/runner-child-observer.ts +270 -0
- package/src/runs/background/runner-completion-summary.ts +106 -0
- package/src/runs/background/runner-completion.ts +274 -0
- package/src/runs/background/runner-config.ts +52 -0
- package/src/runs/background/runner-contract.ts +51 -0
- package/src/runs/background/runner-dynamic.ts +185 -0
- package/src/runs/background/runner-finalization.ts +203 -0
- package/src/runs/background/runner-graph.ts +91 -0
- package/src/runs/background/runner-initial-status.ts +72 -0
- package/src/runs/background/runner-lifecycle.ts +159 -0
- package/src/runs/background/runner-monitor.ts +399 -0
- package/src/runs/background/runner-parallel.ts +280 -0
- package/src/runs/background/runner-prepare-step.ts +128 -0
- package/src/runs/background/runner-reporting.ts +192 -0
- package/src/runs/background/runner-status.ts +220 -0
- package/src/runs/background/runner-step-output.ts +158 -0
- package/src/runs/background/runner-step-record.ts +76 -0
- package/src/runs/background/runner-step.ts +150 -0
- package/src/runs/background/runner-streaming.ts +220 -0
- package/src/runs/background/runner-workflow.ts +284 -0
- package/src/runs/background/stale-run-reconciler.ts +279 -336
- package/src/runs/background/subagent-runner-launcher.ts +67 -35
- package/src/runs/background/subagent-runner.ts +80 -2048
- package/src/runs/background/top-level-async.ts +9 -7
- package/src/runs/foreground/chain-clarify.ts +499 -1334
- package/src/runs/foreground/clarification-draft.ts +92 -0
- package/src/runs/foreground/clarify-contracts.ts +33 -0
- package/src/runs/foreground/clarify-invocation.ts +192 -65
- package/src/runs/foreground/clarify-text-editor.ts +229 -0
- package/src/runs/foreground/clarify-view.ts +222 -0
- package/src/runs/foreground/execution-input.ts +358 -424
- package/src/runs/foreground/execution-routing.ts +41 -0
- package/src/runs/foreground/execution-timeout.ts +92 -0
- package/src/runs/foreground/foreground-control.ts +333 -812
- package/src/runs/foreground/foreground-memory.ts +132 -0
- package/src/runs/foreground/invocation-context.ts +88 -0
- package/src/runs/foreground/invocation-execution.ts +465 -0
- package/src/runs/foreground/invocation-expansion.ts +58 -0
- package/src/runs/foreground/management-actions.ts +360 -0
- package/src/runs/foreground/nested-control.ts +248 -0
- package/src/runs/foreground/question-continuation.ts +112 -0
- package/src/runs/foreground/question-control.ts +297 -70
- package/src/runs/foreground/resume-target.ts +330 -0
- package/src/runs/foreground/revival-launch-policy.ts +112 -0
- package/src/runs/foreground/run-async-path.ts +307 -223
- package/src/runs/foreground/run-interrupt.ts +202 -0
- package/src/runs/foreground/run-nudge.ts +355 -0
- package/src/runs/foreground/saved-revival.ts +356 -0
- package/src/runs/foreground/subagent-executor.ts +195 -493
- package/src/runs/foreground/subagent-params.ts +314 -242
- package/src/runs/foreground/wait-observation.ts +160 -0
- package/src/runs/foreground/wait-registration.ts +18 -0
- package/src/runs/foreground/wait-run.ts +361 -119
- package/src/runs/shared/acceptance-contract.ts +410 -209
- package/src/runs/shared/acceptance-defaults.ts +1 -0
- package/src/runs/shared/acceptance-evaluation.ts +314 -240
- package/src/runs/shared/acceptance-finalization.ts +447 -305
- package/src/runs/shared/acceptance-outcome.ts +69 -0
- package/src/runs/shared/acceptance-reports.ts +220 -126
- package/src/runs/shared/acceptance-submission.ts +251 -0
- package/src/runs/shared/acceptance-verification.ts +118 -0
- package/src/runs/shared/acceptance.ts +25 -25
- package/src/runs/shared/chain-outputs.ts +190 -98
- package/src/runs/shared/child-attempt-types.ts +118 -0
- package/src/runs/shared/child-attempt.ts +372 -608
- package/src/runs/shared/child-boundaries.ts +217 -0
- package/src/runs/shared/child-context-filter.ts +53 -0
- package/src/runs/shared/child-event-observer.ts +496 -0
- package/src/runs/shared/child-execution-cwd.ts +139 -68
- package/src/runs/shared/child-execution-outcome.ts +103 -0
- package/src/runs/shared/child-invocation.ts +74 -0
- package/src/runs/shared/child-message-validation.ts +233 -0
- package/src/runs/shared/child-native-accounting.ts +154 -0
- package/src/runs/shared/child-native-observation.ts +79 -0
- package/src/runs/shared/child-observation-spool.ts +188 -0
- package/src/runs/shared/child-observations.ts +219 -89
- package/src/runs/shared/child-presence.ts +6 -0
- package/src/runs/shared/child-route-env.ts +142 -0
- package/src/runs/shared/child-stream-observer.ts +302 -0
- package/src/runs/shared/child-stream-projection.ts +160 -0
- package/src/runs/shared/child-structured-tool.ts +38 -0
- package/src/runs/shared/claude-code.ts +201 -228
- package/src/runs/shared/claude-model.ts +67 -0
- package/src/runs/shared/claude-session.ts +124 -0
- package/src/runs/shared/claude-types.ts +31 -0
- package/src/runs/shared/completion-guard.ts +35 -26
- package/src/runs/shared/control-event-policy.ts +15 -0
- package/src/runs/shared/control-notification-owner.ts +20 -0
- package/src/runs/shared/dynamic-fanout.ts +402 -238
- package/src/runs/shared/dynamic-item.ts +114 -0
- package/src/runs/shared/history-index.ts +112 -51
- package/src/runs/shared/legacy-async-recovery.ts +153 -0
- package/src/runs/shared/legacy-output-recovery.ts +214 -0
- package/src/runs/shared/mcp-config-schema.ts +46 -0
- package/src/runs/shared/mcp-direct-tool-allowlist.ts +396 -307
- package/src/runs/shared/model-fallback.ts +302 -180
- package/src/runs/shared/mutating-tool-guard.ts +259 -158
- package/src/runs/shared/native-finalization-types.ts +29 -0
- package/src/runs/shared/native-finalization.ts +233 -109
- package/src/runs/shared/native-usage.ts +379 -96
- package/src/runs/shared/nested-control-records.ts +178 -0
- package/src/runs/shared/nested-events.ts +45 -752
- package/src/runs/shared/nested-path.ts +47 -34
- package/src/runs/shared/nested-projection.ts +230 -0
- package/src/runs/shared/nested-protocol.ts +67 -0
- package/src/runs/shared/nested-registry.ts +273 -0
- package/src/runs/shared/nested-render.ts +198 -100
- package/src/runs/shared/nested-route.ts +292 -0
- package/src/runs/shared/nested-validation.ts +291 -0
- package/src/runs/shared/owned-child-evidence.ts +184 -0
- package/src/runs/shared/owned-run-list.ts +187 -0
- package/src/runs/shared/owned-run-observation.ts +368 -0
- package/src/runs/shared/owned-run-progress.ts +172 -0
- package/src/runs/shared/owned-run-read-state.ts +7 -0
- package/src/runs/shared/owned-run-results.ts +289 -0
- package/src/runs/shared/owned-run-status.ts +239 -0
- package/src/runs/shared/owned-run-view.ts +65 -0
- package/src/runs/shared/owned-workflow-details.ts +24 -0
- package/src/runs/shared/owner-output.ts +73 -0
- package/src/runs/shared/parallel-utils.ts +93 -129
- package/src/runs/shared/parent-receipts.ts +177 -50
- package/src/runs/shared/parent-usage.ts +314 -91
- package/src/runs/shared/pi-args.ts +241 -311
- package/src/runs/shared/pi-launch-input.ts +48 -0
- package/src/runs/shared/pi-session-launch.ts +94 -0
- package/src/runs/shared/pi-spawn.ts +57 -33
- package/src/runs/shared/run-history-queries.ts +189 -38
- package/src/runs/shared/run-history.ts +197 -76
- package/src/runs/shared/run-id-ambiguity.ts +7 -3
- package/src/runs/shared/run-metadata-paths.ts +17 -0
- package/src/runs/shared/run-metadata.ts +240 -0
- package/src/runs/shared/run-persistence.ts +181 -0
- package/src/runs/shared/run-records.ts +19 -607
- package/src/runs/shared/run-restoration.ts +455 -0
- package/src/runs/shared/run-state-owner.ts +31 -0
- package/src/runs/shared/session-cwd-preload.ts +39 -19
- package/src/runs/shared/single-output.ts +358 -205
- package/src/runs/shared/stable-value.ts +15 -0
- package/src/runs/shared/streaming-text.ts +39 -12
- package/src/runs/shared/structured-output.ts +76 -46
- package/src/runs/shared/subagent-control.ts +330 -197
- package/src/runs/shared/subagent-prompt-runtime.ts +92 -174
- package/src/runs/shared/subagent-tool-loop-guard.ts +118 -68
- package/src/runs/shared/supervisor-question-state.ts +221 -0
- package/src/runs/shared/supervisor-questions.ts +396 -401
- package/src/runs/shared/workflow-graph.ts +400 -198
- package/src/runs/shared/workflow-policy.ts +245 -110
- package/src/runs/shared/worktree-contract.ts +29 -0
- package/src/runs/shared/worktree-hook.ts +181 -0
- package/src/runs/shared/worktree-location.ts +61 -0
- package/src/runs/shared/worktree-preservation.ts +10 -0
- package/src/runs/shared/worktree-process.ts +132 -0
- package/src/runs/shared/worktree.ts +459 -587
- package/src/shared/agent-context-policy.ts +176 -145
- package/src/shared/agent-dir.ts +15 -0
- package/src/shared/artifacts.ts +99 -68
- package/src/shared/atomic-json.ts +14 -11
- package/src/shared/chain-files.ts +72 -0
- package/src/shared/concurrency.ts +27 -0
- package/src/shared/content-preview.ts +117 -0
- package/src/shared/cooperative.ts +17 -13
- package/src/shared/execution-cwd.ts +34 -9
- package/src/shared/file-coalescer.ts +24 -22
- package/src/shared/fork-context.ts +52 -48
- package/src/shared/formatters.ts +88 -47
- package/src/shared/journal-frames.ts +197 -0
- package/src/shared/journal-projections.ts +133 -0
- package/src/shared/journal-reader.ts +18 -333
- package/src/shared/json-projection.ts +224 -0
- package/src/shared/lazy-tools.ts +76 -27
- package/src/shared/message-output.ts +146 -0
- package/src/shared/model-info.ts +94 -58
- package/src/shared/native-import.ts +25 -0
- package/src/shared/native-journal.ts +172 -0
- package/src/shared/native-session-loader.ts +13 -0
- package/src/shared/native-session.ts +3 -5
- package/src/shared/native-tui.ts +13 -3
- package/src/shared/native-typebox.ts +18 -3
- package/src/shared/output-page.ts +76 -0
- package/src/shared/post-exit-stdio-guard.ts +232 -172
- package/src/shared/prompt-sections.ts +13 -7
- package/src/shared/session-entries.ts +103 -44
- package/src/shared/session-identity.ts +17 -10
- package/src/shared/settings.ts +182 -367
- package/src/shared/status-format.ts +207 -98
- package/src/shared/stream-json.d.ts +10 -0
- package/src/shared/task-file-policy.ts +35 -0
- package/src/shared/temp-root.ts +122 -71
- package/src/shared/types/acceptance.ts +149 -0
- package/src/shared/types/async.ts +247 -0
- package/src/shared/types/config.ts +139 -0
- package/src/shared/types/details.ts +104 -0
- package/src/shared/types/history.ts +217 -0
- package/src/shared/types/inputs.ts +4 -0
- package/src/shared/types/intercom.ts +57 -0
- package/src/shared/types/launch.ts +39 -0
- package/src/shared/types/messages.ts +104 -0
- package/src/shared/types/nested.ts +153 -0
- package/src/shared/types/owned-runs.ts +148 -0
- package/src/shared/types/progress.ts +106 -0
- package/src/shared/types/questions.ts +103 -0
- package/src/shared/types/results.ts +119 -0
- package/src/shared/types/state.ts +56 -0
- package/src/shared/types/usage.ts +36 -0
- package/src/shared/types/workflow.ts +187 -0
- package/src/shared/types.ts +222 -1161
- package/src/shared/ui-mode.ts +1 -1
- package/src/shared/unknown.ts +59 -0
- package/src/shared/utils.ts +111 -305
- package/src/slash/command-discovery.ts +109 -0
- package/src/slash/command-input.ts +232 -0
- package/src/slash/prompt-template-bridge.ts +153 -400
- package/src/slash/prompt-template-contract.ts +152 -0
- package/src/slash/prompt-template-results.ts +189 -0
- package/src/slash/request-protocol.ts +87 -0
- package/src/slash/result-delivery.ts +312 -0
- package/src/slash/saved-chain.ts +115 -0
- package/src/slash/slash-bridge.ts +202 -156
- package/src/slash/slash-commands.ts +176 -598
- package/src/slash/slash-live-state.ts +287 -229
- package/src/tui/action-hints.ts +147 -61
- package/src/tui/activity-lines.ts +40 -0
- package/src/tui/agent-browser.ts +354 -0
- package/src/tui/agent-controls.ts +355 -0
- package/src/tui/agent-conversation.ts +514 -0
- package/src/tui/agent-dock.ts +250 -0
- package/src/tui/agent-history.ts +78 -203
- package/src/tui/agent-model.ts +78 -0
- package/src/tui/agent-picker.ts +325 -0
- package/src/tui/agent-view.ts +391 -1333
- package/src/tui/compact-results.ts +342 -0
- package/src/tui/conversation-details.ts +206 -0
- package/src/tui/conversation-frame.ts +184 -0
- package/src/tui/conversation-history.ts +246 -0
- package/src/tui/conversation-menu.ts +119 -0
- package/src/tui/conversation-notices.ts +116 -0
- package/src/tui/conversation-selection.ts +66 -0
- package/src/tui/conversation-viewport.ts +169 -0
- package/src/tui/direction-message.ts +35 -0
- package/src/tui/display.ts +409 -0
- package/src/tui/editor-viewport.ts +19 -0
- package/src/tui/expanded-content.ts +134 -0
- package/src/tui/expanded-multi.ts +264 -0
- package/src/tui/expanded-single.ts +92 -0
- package/src/tui/history-cards.ts +316 -0
- package/src/tui/history-display.ts +334 -0
- package/src/tui/history-json.ts +17 -0
- package/src/tui/history-metadata.ts +177 -0
- package/src/tui/history-record.ts +321 -0
- package/src/tui/history-text.ts +34 -0
- package/src/tui/indexed-history.ts +149 -0
- package/src/tui/nested-widget.ts +192 -0
- package/src/tui/picker-page.ts +80 -0
- package/src/tui/render.ts +100 -1546
- package/src/tui/result-facts.ts +99 -0
- package/src/tui/task-observation.ts +96 -0
- package/src/tui/task-store.ts +432 -0
- package/src/tui/text-values.ts +20 -0
- package/src/tui/view-connections.ts +64 -0
- package/src/tui/view-model.ts +181 -0
- package/src/tui/view-persistence.ts +57 -0
- package/src/tui/view-ports.ts +55 -0
- package/src/tui/view-session.ts +42 -0
- package/src/tui/widget-details.ts +220 -0
- package/src/tui/widget-status.ts +331 -0
- package/src/tui/widget.ts +208 -0
- package/src/tui/workflow-labels.ts +340 -0
- package/src/tui/workflow-outcomes.ts +150 -0
- package/tsconfig.build.json +11 -10
- package/tsconfig.json +30 -17
|
@@ -1,607 +1,19 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
import { formatRunIdAmbiguity } from "./run-id-ambiguity.ts";
|
|
21
|
-
import { resolveFinalizationOutput } from "./acceptance-finalization.ts";
|
|
22
|
-
import { parseAcceptanceReport, validateAcceptanceReportShape } from "./acceptance-reports.ts";
|
|
23
|
-
import { sumAttemptUsage } from "./model-fallback.ts";
|
|
24
|
-
import { workflowAgentNodes } from "./workflow-graph.ts";
|
|
25
|
-
import { collectInvocationAgentNames } from "../../shared/settings.ts";
|
|
26
|
-
import type { SubagentParamsLike } from "../foreground/subagent-params.ts";
|
|
27
|
-
import { compactOwnerResult, getRunMetadataDir, listOwnedRunQuestions, migrateSupervisorQuestionSteps, questionProcessAlive, readQuestionContract, readRunJson, saveAsyncRunResult, saveRunStatus, saveQuestionOwner, saveQuestionContract, type SupervisorRunContract } from "./supervisor-questions.ts";
|
|
28
|
-
import { ASYNC_DIR, DEFAULT_MAX_OUTPUT, RESULTS_DIR, SLASH_RESULT_TYPE, truncateOutput, type AgentProgress, type AsyncResultChild, type AsyncStatus, type Details, type ForegroundResumeRun, type ManagementRunState, type OwnedRun, type OwnedRunView, type SingleResult, type SubagentExecutionResult, type SubagentState, type WorkflowGraphSnapshot } from "../../shared/types.ts";
|
|
29
|
-
|
|
30
|
-
export const OWNED_RUN_ENTRY = "subagent-run";
|
|
31
|
-
const failedAccountingSources = new Map<string, string>();
|
|
32
|
-
|
|
33
|
-
/** Repair only recorded native billing evidence; never execute or verify work again. */
|
|
34
|
-
export function repairOwnedRunAccounting(run: OwnedRun): void {
|
|
35
|
-
const file = path.join(getRunMetadataDir(run.runId), "result.json");
|
|
36
|
-
if (!fs.existsSync(file)) return;
|
|
37
|
-
const saved = readAsyncResultFile(file);
|
|
38
|
-
let changed = false;
|
|
39
|
-
saved.results?.forEach((child, index) => {
|
|
40
|
-
if (child.accounting?.state !== "incomplete") return;
|
|
41
|
-
const contract = readQuestionContract(run.runId, index, undefined, { readConfiguration: false });
|
|
42
|
-
const terminalEntryId = child.terminalEntryId ?? contract?.terminalEntryId;
|
|
43
|
-
if (!contract?.attemptBaseline || !terminalEntryId) return;
|
|
44
|
-
const source = child.sessionFile ?? contract.sessionFile;
|
|
45
|
-
if (!source) return;
|
|
46
|
-
const stat = fs.statSync(source, { bigint: true, throwIfNoEntry: false });
|
|
47
|
-
const key = `${run.runId}:${index}`, stamp = `${stat ? journalStamp(stat) : "missing"}:${terminalEntryId}:${JSON.stringify(contract.attemptBaseline)}`;
|
|
48
|
-
if (failedAccountingSources.get(key) === stamp) return;
|
|
49
|
-
let usage;
|
|
50
|
-
try { usage = readNativeUsage(source, new Set(contract.attemptBaseline), [], { terminalEntryId })?.[0]; }
|
|
51
|
-
catch (error) { failedAccountingSources.set(key, stamp); throw error; }
|
|
52
|
-
if (!usage) return;
|
|
53
|
-
failedAccountingSources.delete(key);
|
|
54
|
-
child.usage = usage; child.accounting = { state: "complete" }; changed = true;
|
|
55
|
-
if (contract.result) saveQuestionContract(run.runId, index, { accounting: child.accounting, result: { ...contract.result, usage, accounting: child.accounting } });
|
|
56
|
-
});
|
|
57
|
-
if (changed) saveAsyncRunResult(run.runId, saved);
|
|
58
|
-
}
|
|
59
|
-
|
|
60
|
-
export function rememberOwnedRun(state: SubagentState, run: OwnedRun): void {
|
|
61
|
-
const previous = state.ownedRuns?.get(run.runId);
|
|
62
|
-
(state.ownedRuns ??= new Map()).set(run.runId, run);
|
|
63
|
-
if (JSON.stringify(previous) !== JSON.stringify(run)) {
|
|
64
|
-
state.persistOwnedRun?.(run);
|
|
65
|
-
updateRunHistory(state, run);
|
|
66
|
-
state.onRunsChanged?.();
|
|
67
|
-
}
|
|
68
|
-
}
|
|
69
|
-
|
|
70
|
-
export function resolveOwnedRun(state: SubagentState, requested: string): OwnedRun | undefined {
|
|
71
|
-
const id = requested.trim();
|
|
72
|
-
getRunMetadataDir(id); // Same ID boundary as the question and result files.
|
|
73
|
-
const exact = state.ownedRuns?.get(id);
|
|
74
|
-
if (exact && id !== "latest" && id !== "last") return exact;
|
|
75
|
-
const runs = [...(state.ownedRuns?.values() ?? [])];
|
|
76
|
-
if (id === "latest" || id === "last") return runs.sort((a, b) => b.startedAt - a.startedAt)[0];
|
|
77
|
-
const matches = runs.filter((run) => run.runId.startsWith(id));
|
|
78
|
-
if (matches.length > 1) throw new Error(formatRunIdAmbiguity("owned", id, matches.map((run) => run.runId)));
|
|
79
|
-
return matches[0];
|
|
80
|
-
}
|
|
81
|
-
|
|
82
|
-
export function saveForegroundRun(input: { runId: string; mode: ForegroundResumeRun["mode"]; cwd: string; results: SingleResult[]; error?: string; pausedReason?: string }): ForegroundResumeRun {
|
|
83
|
-
const run: ForegroundResumeRun = {
|
|
84
|
-
runId: input.runId, mode: input.mode, cwd: input.cwd, updatedAt: Date.now(),
|
|
85
|
-
...(input.error ? { error: input.error } : {}),
|
|
86
|
-
...(input.pausedReason ? { pausedReason: input.pausedReason } : {}),
|
|
87
|
-
children: input.results.map((result, index) => ({
|
|
88
|
-
agent: result.agent, index,
|
|
89
|
-
status: resolveSubagentResultStatus(result),
|
|
90
|
-
...(!result.detached ? { summary: (getSingleResultOutput(result) || result.error)?.slice(-8192) } : {}),
|
|
91
|
-
artifactPath: result.artifactPaths?.outputPath,
|
|
92
|
-
sessionFile: result.sessionFile,
|
|
93
|
-
effectiveAcceptance: result.acceptance?.effectiveAcceptance,
|
|
94
|
-
result: compactOwnerResult(input.runId, index, compactForegroundResult(result)),
|
|
95
|
-
})),
|
|
96
|
-
};
|
|
97
|
-
writeAtomicJson(path.join(getRunMetadataDir(input.runId), "foreground.json"), run);
|
|
98
|
-
return run;
|
|
99
|
-
}
|
|
100
|
-
|
|
101
|
-
function receiptDetails(entry: SessionEntry): Details | undefined {
|
|
102
|
-
if (entry.type === "message" && entry.message.role === "toolResult" && ["subagent", "delegate", "agent_runs"].includes(entry.message.toolName)) return entry.message.details as Details | undefined;
|
|
103
|
-
if (entry.type === "custom_message" && entry.customType === SLASH_RESULT_TYPE) {
|
|
104
|
-
const details = entry.details as { result?: SubagentExecutionResult } | undefined;
|
|
105
|
-
return details?.result?.details;
|
|
106
|
-
}
|
|
107
|
-
return undefined;
|
|
108
|
-
}
|
|
109
|
-
|
|
110
|
-
function sessionFiles(root: string): string[] {
|
|
111
|
-
if (!fs.existsSync(root)) return [];
|
|
112
|
-
return fs.readdirSync(root, { withFileTypes: true }).flatMap((entry) => entry.isDirectory()
|
|
113
|
-
? sessionFiles(path.join(root, entry.name))
|
|
114
|
-
: entry.name.endsWith(".jsonl") ? [path.join(root, entry.name)] : []);
|
|
115
|
-
}
|
|
116
|
-
|
|
117
|
-
function recoverOutput(sessionFile: string | undefined, outputFile: string | undefined, endedAt: number): string | undefined {
|
|
118
|
-
if (outputFile && fs.existsSync(outputFile)) return readOutputPage(outputFile).text;
|
|
119
|
-
if (!sessionFile || !fs.existsSync(sessionFile)) return undefined;
|
|
120
|
-
const journal = new NativeJournal(sessionFile);
|
|
121
|
-
for (const record of journal.branch(undefined, endedAt).reverse()) {
|
|
122
|
-
if (record.value.type !== "message" || record.value.message?.role !== "assistant") continue;
|
|
123
|
-
const output = getFinalOutput([journal.body(record).message]);
|
|
124
|
-
if (output) return output;
|
|
125
|
-
}
|
|
126
|
-
}
|
|
127
|
-
|
|
128
|
-
function recoverLegacyTerminalOutput(sessionFile: string | undefined, startedAt: number, endedAt: number | undefined, acceptance: SingleResult["acceptance"]): string | undefined {
|
|
129
|
-
const review = acceptance?.finalization;
|
|
130
|
-
const reviewedOutput = review?.status === "completed" ? review.turns.at(-1)?.rawOutput : undefined;
|
|
131
|
-
if (reviewedOutput?.trim()) return resolveFinalizationOutput(reviewedOutput, "") || undefined;
|
|
132
|
-
// Live and finalization logs are separate, mutable streams, not a final-answer receipt.
|
|
133
|
-
if (endedAt === undefined || !Number.isFinite(endedAt) || !sessionFile || !fs.existsSync(sessionFile)) return;
|
|
134
|
-
const journal = new NativeJournal(sessionFile);
|
|
135
|
-
const records = journal.branch(undefined, endedAt).filter(({ value }) => value.type === "message" && Date.parse(value.timestamp) >= startedAt);
|
|
136
|
-
const lastAssistant = records.findLastIndex(({ value }) => value.message?.role === "assistant");
|
|
137
|
-
const messages: Message[] = records.map((record, index) => index === lastAssistant ? journal.body(record).message : record.value.message);
|
|
138
|
-
const index = messages.findLastIndex((message) => message.role === "assistant");
|
|
139
|
-
const last = messages[index];
|
|
140
|
-
if (last?.role !== "assistant" || last.errorMessage || !["stop", "toolUse"].includes(last.stopReason) || !Array.isArray(last.content)) return;
|
|
141
|
-
const calls = last.content.filter((part) => part.type === "toolCall");
|
|
142
|
-
if (!calls.length) return index === messages.length - 1 && last.stopReason === "stop" ? resolveFinalizationOutput(getFinalOutput([last]), "") || undefined : undefined;
|
|
143
|
-
if (calls.length !== 1 || calls[0]!.name !== "structured_output") return;
|
|
144
|
-
const following = messages.slice(index + 1);
|
|
145
|
-
const result = following.at(-1);
|
|
146
|
-
if (following.some((message) => message.role !== "toolResult") || result?.role !== "toolResult" || result.toolCallId !== calls[0]!.id || result.toolName !== "structured_output" || result.isError !== false) return;
|
|
147
|
-
const value = calls[0]!.arguments.value;
|
|
148
|
-
if (!value || typeof value !== "object" || !("report" in value)) return;
|
|
149
|
-
if (typeof value.report === "string" && parseAcceptanceReport(value.report).report) return resolveFinalizationOutput(value.report, "") || undefined;
|
|
150
|
-
if ("answer" in value && typeof value.answer === "string" && value.answer.trim() && !validateAcceptanceReportShape(value.report)) return value.answer;
|
|
151
|
-
}
|
|
152
|
-
|
|
153
|
-
export function workflowChildren(children: OwnedRun["children"], graph: WorkflowGraphSnapshot | undefined): OwnedRun["children"] {
|
|
154
|
-
if (!graph || (graph.mode !== "chain" && !children.some((child) => child.workflowNodeId))) return children;
|
|
155
|
-
return workflowAgentNodes(graph).map((node, index) => {
|
|
156
|
-
const declared = children.find((child) => child.workflowNodeId === node.id);
|
|
157
|
-
return { ...declared, index, workflowNodeId: node.id, agent: node.agent ?? declared?.agent ?? "unknown",
|
|
158
|
-
...(node.itemKey !== undefined ? { label: node.label } : {}) };
|
|
159
|
-
});
|
|
160
|
-
}
|
|
161
|
-
|
|
162
|
-
function savedWorkflowNodes(status: AsyncStatus | null | undefined) {
|
|
163
|
-
if (!status?.workflowGraph || status.workflowGraph.runId !== status.runId) return;
|
|
164
|
-
const nodes = workflowAgentNodes(status.workflowGraph);
|
|
165
|
-
if (nodes.length !== status.steps?.length || new Set(nodes.map((node) => node.id)).size !== nodes.length) return;
|
|
166
|
-
if (nodes.some((node, index) => typeof node.id !== "string" || !node.id || (node.agent && node.agent !== status.steps![index]!.agent))) return;
|
|
167
|
-
return nodes;
|
|
168
|
-
}
|
|
169
|
-
|
|
170
|
-
export interface OwnedRunRestoration {
|
|
171
|
-
startedAt: number;
|
|
172
|
-
records: AsyncRunRecord[];
|
|
173
|
-
discover: () => AsyncRunRecord[];
|
|
174
|
-
}
|
|
175
|
-
|
|
176
|
-
export function restoreOwnedRuns(state: SubagentState, ctx: ExtensionContext): OwnedRunRestoration {
|
|
177
|
-
return runSynchronously(restoreOwnedRunSteps(state, ctx));
|
|
178
|
-
}
|
|
179
|
-
|
|
180
|
-
export async function restoreOwnedRunsAsync(state: SubagentState, ctx: ExtensionContext): Promise<OwnedRunRestoration> {
|
|
181
|
-
const onRunsChanged = state.onRunsChanged;
|
|
182
|
-
// Publish readiness once restoration is complete, before starting browse/UI work.
|
|
183
|
-
state.onRunsChanged = undefined;
|
|
184
|
-
try { return await runCooperatively(restoreOwnedRunSteps(state, ctx)); }
|
|
185
|
-
finally { state.onRunsChanged = onRunsChanged; }
|
|
186
|
-
}
|
|
187
|
-
|
|
188
|
-
function* restoreOwnedRunSteps(state: SubagentState, ctx: ExtensionContext): Generator<void, OwnedRunRestoration> {
|
|
189
|
-
const startedAt = Date.now();
|
|
190
|
-
const ownerSessionId = ctx.sessionManager.getSessionId();
|
|
191
|
-
const entries = ctx.sessionManager.getEntries();
|
|
192
|
-
state.ownedRuns = new Map();
|
|
193
|
-
yield* migrateSupervisorQuestionSteps(ownerSessionId);
|
|
194
|
-
for (const entry of entries) {
|
|
195
|
-
yield;
|
|
196
|
-
if (entry.type !== "custom" || entry.customType !== OWNED_RUN_ENTRY) continue;
|
|
197
|
-
const run = (ctx.sessionManager.getEntry(entry.id) as typeof entry | undefined)?.data as OwnedRun | undefined;
|
|
198
|
-
if (run?.ownerSessionId === ownerSessionId && run.runId && Array.isArray(run.children)) state.ownedRuns.set(run.runId, run);
|
|
199
|
-
}
|
|
200
|
-
// Forks copy old entries. Their old receipts are evidence, not ownership for the new parent.
|
|
201
|
-
const inheritedIds = new Set<string>();
|
|
202
|
-
const parentFile = ctx.sessionManager.getHeader()?.parentSession;
|
|
203
|
-
if (parentFile && fs.existsSync(parentFile)) {
|
|
204
|
-
for (const id of snapshotNativeUsage(parentFile)) inheritedIds.add(id);
|
|
205
|
-
}
|
|
206
|
-
const recoveredReceipts: SessionEntry[] = [];
|
|
207
|
-
for (const entry of entries) {
|
|
208
|
-
yield;
|
|
209
|
-
if (!(entry.type === "message" && entry.message.role === "toolResult" && ["subagent", "delegate", "agent_runs"].includes(entry.message.toolName)
|
|
210
|
-
|| entry.type === "custom_message" && entry.customType === SLASH_RESULT_TYPE)) continue;
|
|
211
|
-
const receipt = ctx.sessionManager.getEntry(entry.id);
|
|
212
|
-
if (receipt) recoveredReceipts.push(receipt);
|
|
213
|
-
}
|
|
214
|
-
const calls = new Map<string, SubagentParamsLike>();
|
|
215
|
-
const needsLegacyCalls = recoveredReceipts.some((entry) => { const details = receiptDetails(entry); return details && !state.ownedRuns!.has(details.runId ?? details.asyncId ?? ""); });
|
|
216
|
-
for (const metadata of needsLegacyCalls ? entries : []) {
|
|
217
|
-
yield;
|
|
218
|
-
if (metadata.type !== "message" || metadata.message.role !== "assistant") continue;
|
|
219
|
-
const entry = ctx.sessionManager.getEntry(metadata.id);
|
|
220
|
-
if (entry?.type !== "message" || entry.message.role !== "assistant" || !Array.isArray(entry.message.content)) continue;
|
|
221
|
-
for (const part of entry.message.content) if (part.type === "toolCall" && ["subagent", "delegate"].includes(part.name)) calls.set(part.id, part.arguments as SubagentParamsLike);
|
|
222
|
-
}
|
|
223
|
-
for (const entry of recoveredReceipts) {
|
|
224
|
-
yield;
|
|
225
|
-
if (inheritedIds.has(entry.id) || (parentFile && !fs.existsSync(parentFile))) continue;
|
|
226
|
-
const details = receiptDetails(entry);
|
|
227
|
-
const runId = details?.runId ?? details?.asyncId;
|
|
228
|
-
if (!runId || !details || !Array.isArray(details.results) || (details.mode !== "single" && details.mode !== "parallel" && details.mode !== "chain") || state.ownedRuns.has(runId)) continue;
|
|
229
|
-
const cwd = details.results.find((result) => result.sessionFile)?.sessionFile;
|
|
230
|
-
const request = entry.type === "message" && entry.message.role === "toolResult" ? calls.get(entry.message.toolCallId) : undefined;
|
|
231
|
-
const run: OwnedRun = {
|
|
232
|
-
runId, ownerSessionId, rootRunId: details.managementControl?.revivedFromRunId ?? runId,
|
|
233
|
-
predecessorRunId: details.managementControl?.revivedFromRunId,
|
|
234
|
-
source: details.asyncId ? "async" : "foreground", mode: details.mode,
|
|
235
|
-
cwd: request?.cwd ? path.resolve(ctx.cwd, request.cwd) : ctx.cwd, task: details.results[0]?.task ?? request?.task ?? "Recovered delegated run",
|
|
236
|
-
startedAt: Date.parse(entry.timestamp), asyncDir: details.asyncDir, legacy: true,
|
|
237
|
-
children: details.results.length ? details.results.map((result, index) => ({ agent: result.agent, index, task: result.task, sessionFile: result.sessionFile })) : collectInvocationAgentNames(request ?? {}).map((agent, index) => ({ agent, index })),
|
|
238
|
-
};
|
|
239
|
-
try {
|
|
240
|
-
if (cwd && fs.existsSync(cwd)) {
|
|
241
|
-
const header = new NativeJournal(cwd).records[0]?.value;
|
|
242
|
-
if (header?.type === "session" && header.cwd) run.cwd = header.cwd;
|
|
243
|
-
}
|
|
244
|
-
if (run.source === "foreground") saveForegroundRun({ ...run, results: details.results.map((result) => ({ ...result, finalOutput: result.finalOutput ?? recoverOutput(result.sessionFile, result.artifactPaths?.outputPath, Date.parse(entry.timestamp)) })) });
|
|
245
|
-
let owner: { sessionId?: unknown } | undefined;
|
|
246
|
-
try { owner = readRunJson(path.join(getRunMetadataDir(runId), "question-owner.json")); } catch { /* Unusable metadata can be repaired from the genuine receipt. */ }
|
|
247
|
-
if (typeof owner?.sessionId !== "string" || !owner.sessionId.trim()) saveQuestionOwner(runId, ownerSessionId);
|
|
248
|
-
rememberOwnedRun(state, run);
|
|
249
|
-
} catch (error) {
|
|
250
|
-
// The genuine receipt still establishes ownership. Keep completion
|
|
251
|
-
// unconfirmed when its supplemental output/context cannot be recovered.
|
|
252
|
-
rememberOwnedRun(state, { ...run, recoveryError: `Saved child recovery remains incomplete: ${String(error)}` });
|
|
253
|
-
console.error(`Could not recover legacy receipt ${runId}: ${String(error)}`);
|
|
254
|
-
}
|
|
255
|
-
}
|
|
256
|
-
// Pre-update background runs may have no parent tool receipt (for example slash launches).
|
|
257
|
-
const scan = createAsyncRunDiscovery(ASYNC_DIR, {
|
|
258
|
-
sessionId: ctx.sessionManager.getSessionFile() ?? resolveCurrentSessionId(ctx.sessionManager), ownerSessionId,
|
|
259
|
-
receiptRunIds: () => state.ownedRuns!.keys(), skipInvalid: true,
|
|
260
|
-
});
|
|
261
|
-
function* discoverSteps(): Generator<void, AsyncRunRecord[]> {
|
|
262
|
-
const records = yield* scan.steps();
|
|
263
|
-
for (const { location, status, durable } of records) {
|
|
264
|
-
yield;
|
|
265
|
-
try {
|
|
266
|
-
const asyncDir = location.asyncDir;
|
|
267
|
-
if (!asyncDir || !status) continue;
|
|
268
|
-
const terminal = !["running", "queued"].includes(status.state);
|
|
269
|
-
if (!durable && terminal) saveRunStatus(status.runId, status);
|
|
270
|
-
const old = state.ownedRuns!.get(status.runId);
|
|
271
|
-
const nodes = savedWorkflowNodes(status);
|
|
272
|
-
const declared = status.mode === "chain" && nodes && !old?.children.some((child) => child.workflowNodeId) ? [] : old?.children ?? [];
|
|
273
|
-
const children = workflowChildren(declared, nodes ? status.workflowGraph : undefined);
|
|
274
|
-
rememberOwnedRun(state, {
|
|
275
|
-
...old, runId: status.runId, ownerSessionId, rootRunId: old?.rootRunId ?? status.runId,
|
|
276
|
-
source: "async", mode: status.mode, cwd: status.cwd ?? old?.cwd ?? ctx.cwd,
|
|
277
|
-
task: old?.task ?? "Recovered background run", startedAt: status.startedAt,
|
|
278
|
-
asyncDir, pid: status.pid, legacy: old?.legacy ?? !durable,
|
|
279
|
-
children: (status.steps ?? []).map((step, index) => ({ ...children.find((child) => child.index === index), agent: step.agent, index, ...(status.mode === "chain" && nodes?.[index] ? { workflowNodeId: nodes[index]!.id } : {}), label: step.label ?? children[index]?.label, sessionFile: step.sessionFile ?? (status.steps?.length === 1 ? status.sessionFile : undefined) })),
|
|
280
|
-
});
|
|
281
|
-
const resultPath = path.join(RESULTS_DIR, `${status.runId}.json`);
|
|
282
|
-
if (!durable && terminal && !fs.existsSync(path.join(getRunMetadataDir(status.runId), "result.json"))) {
|
|
283
|
-
if (fs.existsSync(resultPath)) saveAsyncRunResult(status.runId, readAsyncResultFile(resultPath));
|
|
284
|
-
else if (status.steps?.length && status.steps.every((step) => !["running", "pending"].includes(step.status))) {
|
|
285
|
-
const endedAt = status.endedAt ?? status.lastUpdate ?? status.startedAt;
|
|
286
|
-
const results = status.steps.map((step) => {
|
|
287
|
-
const sessionFile = step.sessionFile ?? (status.steps!.length === 1 ? status.sessionFile : undefined);
|
|
288
|
-
return { agent: step.agent, sessionFile, model: step.model, acceptance: step.acceptance,
|
|
289
|
-
exitCode: step.exitCode, agentProcessExit: step.agentProcessExit, success: step.status === "complete" || step.status === "completed",
|
|
290
|
-
interrupted: step.status === "paused" || undefined, timedOut: step.status === "timed-out" || undefined, error: step.error,
|
|
291
|
-
output: recoverLegacyTerminalOutput(sessionFile, step.startedAt ?? status.startedAt, step.endedAt ?? status.endedAt, step.acceptance) ?? "" };
|
|
292
|
-
});
|
|
293
|
-
saveAsyncRunResult(status.runId, { id: status.runId, sessionId: status.sessionId, mode: status.mode, state: status.state,
|
|
294
|
-
success: status.state === "complete", error: status.error, timestamp: endedAt, cwd: status.cwd, asyncDir, sessionFile: status.sessionFile, results });
|
|
295
|
-
}
|
|
296
|
-
}
|
|
297
|
-
} catch (error) {
|
|
298
|
-
console.error(`Could not recover owned async metadata for '${location.resolvedId}':`, error);
|
|
299
|
-
}
|
|
300
|
-
}
|
|
301
|
-
return records;
|
|
302
|
-
}
|
|
303
|
-
const discover = () => runSynchronously(discoverSteps());
|
|
304
|
-
const records = yield* discoverSteps();
|
|
305
|
-
for (const run of state.ownedRuns.values()) {
|
|
306
|
-
yield;
|
|
307
|
-
try {
|
|
308
|
-
const stored = readRunJson<ForegroundResumeRun>(path.join(getRunMetadataDir(run.runId), "foreground.json"));
|
|
309
|
-
if (stored) (state.foregroundRuns ??= new Map()).set(run.runId, stored);
|
|
310
|
-
if (run.children.some((child) => child.sessionFile) || !run.legacy) continue;
|
|
311
|
-
const file = ctx.sessionManager.getSessionFile();
|
|
312
|
-
if (!file) continue;
|
|
313
|
-
const root = path.join(path.dirname(file), path.basename(file, ".jsonl"), run.runId);
|
|
314
|
-
const files = sessionFiles(root).sort();
|
|
315
|
-
if (files.length) rememberOwnedRun(state, { ...run, children: files.map((sessionFile, index) => ({ agent: run.children[index]?.agent ?? "unknown", index, sessionFile })) });
|
|
316
|
-
} catch (error) {
|
|
317
|
-
console.error(`Could not recover foreground owner ${run.runId}: ${String(error)}`);
|
|
318
|
-
}
|
|
319
|
-
}
|
|
320
|
-
return { startedAt, records, discover };
|
|
321
|
-
}
|
|
322
|
-
|
|
323
|
-
function normalizedState(value: string | undefined): ManagementRunState {
|
|
324
|
-
if (value === "running" || value === "queued") return "live";
|
|
325
|
-
if (value === "complete" || value === "completed") return "completed";
|
|
326
|
-
if (value === "failed" || value === "timed-out") return "failed";
|
|
327
|
-
if (value === "blocked") return "blocked";
|
|
328
|
-
if (value === "paused") return "paused";
|
|
329
|
-
return "unknown";
|
|
330
|
-
}
|
|
331
|
-
|
|
332
|
-
function processAlive(pid: number | undefined): boolean {
|
|
333
|
-
return Boolean(pid && Number.isSafeInteger(pid) && pid > 0 && questionProcessAlive({ pid }));
|
|
334
|
-
}
|
|
335
|
-
|
|
336
|
-
function asyncChildResult(child: AsyncResultChild, task: string) {
|
|
337
|
-
const { output, ...result } = child;
|
|
338
|
-
return {
|
|
339
|
-
...result, agent: child.agent ?? "unknown", task: child.task ?? task, exitCode: child.exitCode ?? (child.success ? 0 : 1),
|
|
340
|
-
finalOutput: child.finalOutput ?? output, usage: child.usage ?? sumAttemptUsage(child.modelAttempts ?? []),
|
|
341
|
-
};
|
|
342
|
-
}
|
|
343
|
-
|
|
344
|
-
function runAttention(run: OwnedRun, executionState: ManagementRunState, pendingInput: boolean): string[] {
|
|
345
|
-
return [
|
|
346
|
-
...(pendingInput ? ["awaiting_input"] : []),
|
|
347
|
-
...(run.review?.decision === "needs_changes" ? ["needs_changes"] : []),
|
|
348
|
-
...(run.review?.decision !== "accepted" && ["failed", "blocked", "paused", "unknown"].includes(executionState) ? [executionState] : []),
|
|
349
|
-
...(executionState === "completed" && !run.review ? ["unreviewed"] : []),
|
|
350
|
-
];
|
|
351
|
-
}
|
|
352
|
-
|
|
353
|
-
export function ownedRunView(run: OwnedRun, state: SubagentState, options: { pendingInput?: boolean; includeContinuations?: boolean; readConfiguration?: false; reconcile?: boolean } = {}): OwnedRunView {
|
|
354
|
-
run = state.ownedRuns?.get(run.runId) ?? run;
|
|
355
|
-
const root = getRunMetadataDir(run.runId);
|
|
356
|
-
const foreground = readRunJson<ForegroundResumeRun>(path.join(root, "foreground.json")) ?? state.foregroundRuns?.get(run.runId);
|
|
357
|
-
const resultPath = path.join(root, "result.json");
|
|
358
|
-
const result = fs.existsSync(resultPath) ? readAsyncResultFile(resultPath) : undefined;
|
|
359
|
-
const location = exactAsyncRunLocation(run.runId, ASYNC_DIR, RESULTS_DIR);
|
|
360
|
-
const asyncDir = location.asyncDir ?? run.asyncDir;
|
|
361
|
-
const liveStatus = asyncDir ? readStatus(asyncDir) : null;
|
|
362
|
-
const savedStatus = liveStatus ?? readRunJson<AsyncStatus>(path.join(root, "status.json"));
|
|
363
|
-
const durable = isDurableRun(savedStatus) || isDurableRun(readRunJson<object>(path.join(root, "launch.json")));
|
|
364
|
-
const reconciliation = durable && options.reconcile !== false ? reconcileAsyncRun(asyncDir ?? root) : undefined;
|
|
365
|
-
const status = reconciliation?.status ?? savedStatus;
|
|
366
|
-
const contracts = new Map<number, SupervisorRunContract>();
|
|
367
|
-
const contractDir = path.join(root, "contracts");
|
|
368
|
-
for (const name of fs.existsSync(contractDir) ? fs.readdirSync(contractDir) : []) {
|
|
369
|
-
if (!/^\d+\.json$/.test(name)) continue;
|
|
370
|
-
const index = Number(name.slice(0, -5));
|
|
371
|
-
const contract = readQuestionContract(run.runId, index, undefined, { endedAt: status?.steps?.[index]?.endedAt ?? result?.timestamp ?? foreground?.updatedAt, readConfiguration: options.readConfiguration });
|
|
372
|
-
if (contract) contracts.set(index, contract);
|
|
373
|
-
}
|
|
374
|
-
const nodes = savedWorkflowNodes(status);
|
|
375
|
-
const declarations = workflowChildren(run.children, nodes ? status?.workflowGraph : undefined);
|
|
376
|
-
// Terminal snapshots contain materialized children; declared slots can include an empty fanout or unstarted downstream steps.
|
|
377
|
-
const terminalIndices = result?.results?.map((_, index) => index) ?? foreground?.children.map((child) => child.index);
|
|
378
|
-
const indices = new Set(terminalIndices ?? [...declarations.map((child) => child.index), ...contracts.keys(), ...(status?.steps?.map((_, index) => index) ?? [])]);
|
|
379
|
-
const sessions = new Map([...indices].map((index) => [index, foreground?.children.find((child) => child.index === index)?.sessionFile ?? result?.results?.[index]?.sessionFile ?? status?.steps?.[index]?.sessionFile ?? contracts.get(index)?.sessionFile]));
|
|
380
|
-
const sessionUses = new Map<string, number>();
|
|
381
|
-
for (const file of sessions.values()) if (file) sessionUses.set(file, (sessionUses.get(file) ?? 0) + 1);
|
|
382
|
-
const uncertainIndices = run.mode === "chain" && (!run.children.some((child) => child.workflowNodeId) || (run.source === "async" && status && !nodes));
|
|
383
|
-
const children: OwnedRunView["children"] = [...indices].sort((a, b) => a - b).map((index) => {
|
|
384
|
-
const boundSession = sessions.get(index);
|
|
385
|
-
const declared = uncertainIndices && !nodes
|
|
386
|
-
? run.children.find((child) => boundSession && sessionUses.get(boundSession) === 1 && child.sessionFile === boundSession)
|
|
387
|
-
: declarations.find((child) => child.index === index);
|
|
388
|
-
const contract = contracts.get(index);
|
|
389
|
-
const fg = foreground?.children.find((child) => child.index === index);
|
|
390
|
-
const bg = result?.results?.[index];
|
|
391
|
-
const step = status?.steps?.[index];
|
|
392
|
-
const sessionFile = boundSession ?? declared?.sessionFile;
|
|
393
|
-
const live = processAlive(contract?.pid) || ((!step || step.status === "running" || step.status === "pending") && processAlive(status?.pid ?? run.pid));
|
|
394
|
-
const pending = !fg && !bg && !contract?.pid && !contract?.result && ((!step || step.status === "pending") && processAlive(status?.pid ?? run.pid));
|
|
395
|
-
const childState = bg ? normalizedState(resolveSubagentResultStatus({ success: bg.success, exitCode: bg.exitCode ?? undefined, interrupted: bg.interrupted, acceptance: bg.acceptance, state: typeof bg.success !== "boolean" && bg.exitCode == null ? result?.terminalState : undefined }))
|
|
396
|
-
: fg && fg.status !== "detached" ? normalizedState(fg.status)
|
|
397
|
-
: contract?.result ? normalizedState(resolveSubagentResultStatus(contract.result))
|
|
398
|
-
: live || pending ? "live"
|
|
399
|
-
: step && !["running", "pending"].includes(step.status) ? normalizedState(step.status) : "unknown";
|
|
400
|
-
const task = contract?.task ?? declared?.task ?? fg?.result?.task ?? (run.children.length === 1 ? run.task : undefined);
|
|
401
|
-
const selection = contract?.modelSelection ?? step ?? fg?.result?.progress;
|
|
402
|
-
return {
|
|
403
|
-
agent: fg?.agent ?? bg?.agent ?? step?.agent ?? contract?.launch?.agent.name ?? declared?.agent ?? "unknown", index, workflowNodeId: declared?.workflowNodeId, sessionFile,
|
|
404
|
-
task, label: contract?.label ?? step?.label ?? declared?.label,
|
|
405
|
-
...(run.mode === "chain" && !declared?.workflowNodeId && (!boundSession || sessionUses.get(boundSession) !== 1) ? { identityUnavailable: true } : {}),
|
|
406
|
-
modelSelection: selection ? { model: selection.model, thinking: selection.thinking, modelStartedAt: selection.modelStartedAt } : undefined,
|
|
407
|
-
activity: childState === "live" ? (pending ? { ...step, status: "pending" as const } : step) : undefined,
|
|
408
|
-
state: childState, result: fg?.status !== "detached" && fg?.result ? fg.result : bg ? asyncChildResult(bg, task ?? "Original child assignment unavailable") : contract?.result ?? fg?.result,
|
|
409
|
-
launch: contract?.launch, configuration: contract?.launch ? "saved" : "legacy-partial",
|
|
410
|
-
...(sessionFile && !fs.existsSync(sessionFile) ? { missingSession: true } : {}),
|
|
411
|
-
};
|
|
412
|
-
});
|
|
413
|
-
const live = children.some((child) => child.state === "live") || (!result && (!status || status.state === "running" || status.state === "queued") && processAlive(status?.pid ?? run.pid));
|
|
414
|
-
const error = result?.error ?? foreground?.error ?? run.error ?? (status && !["running", "queued"].includes(status.state) ? status.error : undefined);
|
|
415
|
-
const executionState: ManagementRunState = error ? "failed" : result ? normalizedState(result.terminalState)
|
|
416
|
-
: durable && !live ? "unknown"
|
|
417
|
-
: live ? "live"
|
|
418
|
-
: children.some((child) => child.state === "failed") ? "failed"
|
|
419
|
-
: children.some((child) => child.state === "blocked") ? "blocked"
|
|
420
|
-
: children.some((child) => child.state === "paused") ? "paused"
|
|
421
|
-
: children.length && children.every((child) => child.state === "completed") ? (foreground?.pausedReason ? "paused" : "completed")
|
|
422
|
-
: status && !["running", "queued"].includes(status.state) ? normalizedState(status.state) : "unknown";
|
|
423
|
-
const pendingInput = options.pendingInput ?? listOwnedRunQuestions(run.ownerSessionId, run.runId).some((question) => question.state === "awaiting_input" || question.state === "answer_pending");
|
|
424
|
-
return {
|
|
425
|
-
...run, state: executionState, children, attention: runAttention(run, executionState, pendingInput),
|
|
426
|
-
canInterrupt: pendingInput || (live && savedStatus?.state === "running" && savedStatus.runId === run.runId),
|
|
427
|
-
updatedAt: result?.timestamp ?? status?.lastUpdate ?? foreground?.updatedAt ?? run.startedAt,
|
|
428
|
-
continuations: options.includeContinuations === false ? [] : [...(state.ownedRuns?.values() ?? [])].filter((candidate) => candidate.rootRunId === run.rootRunId && candidate.predecessorRunId).sort((a, b) => a.startedAt - b.startedAt).map((candidate) => ({ runId: candidate.runId, predecessorRunId: candidate.predecessorRunId!, predecessorIndex: candidate.predecessorIndex })),
|
|
429
|
-
...(result ? { resultPath } : foreground ? { resultPath: path.join(root, "foreground.json") } : {}),
|
|
430
|
-
...(error ? { diagnosis: error } : executionState === "paused" && foreground?.pausedReason ? { diagnosis: foreground.pausedReason } : executionState === "unknown" ? { diagnosis: run.recoveryError ?? reconciliation?.message ?? "Completion is unconfirmed. Saved sessions are context, not proof of successful execution." } : {}),
|
|
431
|
-
};
|
|
432
|
-
}
|
|
433
|
-
|
|
434
|
-
function workflowDetails(graph: WorkflowGraphSnapshot | undefined): Pick<Details, "workflowGraph" | "chainAgents" | "totalSteps" | "currentStepIndex"> {
|
|
435
|
-
if (!graph) return {};
|
|
436
|
-
if (graph.mode !== "chain") return { workflowGraph: graph };
|
|
437
|
-
const current = graph.nodes.find((node) => node.id === graph.currentNodeId || node.children?.some((child) => child.id === graph.currentNodeId));
|
|
438
|
-
return { workflowGraph: graph, chainAgents: graph.nodes.map((node) => node.agent ?? node.label), totalSteps: graph.nodes.length,
|
|
439
|
-
...(current?.stepIndex !== undefined ? { currentStepIndex: current.stepIndex } : {}) };
|
|
440
|
-
}
|
|
441
|
-
|
|
442
|
-
export function ownedRunExecutionResult(run: OwnedRun, state: SubagentState, index?: number, includeProgress = false): SubagentExecutionResult {
|
|
443
|
-
try { repairOwnedRunAccounting(run); }
|
|
444
|
-
catch (error) { console.error(`Native accounting for ${run.runId} remains incomplete:`, error); }
|
|
445
|
-
const view = ownedRunView(run, state);
|
|
446
|
-
const location = exactAsyncRunLocation(run.runId, ASYNC_DIR, RESULTS_DIR);
|
|
447
|
-
const saved = location.resultPath ? readAsyncResultFile(location.resultPath) : undefined;
|
|
448
|
-
const limits = { ...DEFAULT_MAX_OUTPUT, ...(saved?.maxOutput ?? view.children[0]?.launch?.maxOutput) };
|
|
449
|
-
const children = view.children.filter((child) => index === undefined || child.index === index);
|
|
450
|
-
const projected = view.children.map((child) => {
|
|
451
|
-
if (!child.result) return { ...child, result: undefined };
|
|
452
|
-
const { artifactPaths, ...result } = child.result;
|
|
453
|
-
const finalOutput = getSingleResultOutput(result);
|
|
454
|
-
const truncation = result.outputMode === "file-only" && result.exitCode === 0 && result.outputReference
|
|
455
|
-
? { text: result.outputReference.message, truncated: false } : truncateOutput(finalOutput, limits, artifactPaths?.outputPath);
|
|
456
|
-
const compacted = compactForegroundResult({ ...result, finalOutput: truncation.text,
|
|
457
|
-
...(truncation.truncated ? { truncation } : {}),
|
|
458
|
-
...(result.initialOutput ? { initialOutput: truncateOutput(result.initialOutput, limits, artifactPaths?.outputPath).text } : {}),
|
|
459
|
-
});
|
|
460
|
-
return { ...child, result: { ...compacted, ...(artifactPaths ? { artifactPaths } : {}) } };
|
|
461
|
-
});
|
|
462
|
-
const results: SingleResult[] = projected.filter((child) => index === undefined || child.index === index).flatMap((child) => {
|
|
463
|
-
if (!child.result) return [];
|
|
464
|
-
const { artifactPaths, ...result } = child.result;
|
|
465
|
-
return [{ ...result, ...(artifactPaths?.inputPath && artifactPaths.outputPath && artifactPaths.metadataPath
|
|
466
|
-
? { artifactPaths: { inputPath: artifactPaths.inputPath, outputPath: artifactPaths.outputPath, metadataPath: artifactPaths.metadataPath } } : {}) }];
|
|
467
|
-
});
|
|
468
|
-
let text = (index === undefined ? saved?.summary : undefined) || [...children.map((child) => child.result ? getSingleResultOutput(child.result) || child.result.error : undefined), view.diagnosis].filter(Boolean).join("\n\n");
|
|
469
|
-
const failed = index === undefined ? ["failed", "unknown"].includes(view.state) : children.length === 0 || children.some((child) => ["failed", "unknown"].includes(child.state));
|
|
470
|
-
if (failed && saved?.error && !text.includes(saved.error)) text = `${saved.error}\n\n${text}`;
|
|
471
|
-
const logPath = path.join(location.asyncDir ?? run.asyncDir ?? getRunMetadataDir(run.runId), `subagent-log-${run.runId}.md`);
|
|
472
|
-
const artifactPath = run.mode === "single" ? results[0]?.artifactPaths?.outputPath : fs.existsSync(logPath) ? logPath : undefined;
|
|
473
|
-
const referenceOnly = view.state === "completed" && run.mode === "single" && results.length === 1 && results[0]?.outputMode === "file-only" && results[0].outputReference;
|
|
474
|
-
const truncation = referenceOnly ? { text: referenceOnly.message, truncated: false }
|
|
475
|
-
: view.state === "blocked" ? { text, truncated: false } : truncateOutput(text, limits, artifactPath);
|
|
476
|
-
const files = results.flatMap((result) => result.artifactPaths ? [result.artifactPaths] : []);
|
|
477
|
-
const progressSummary = { toolCount: results.reduce((total, result) => total + (result.progressSummary?.toolCount ?? 0), 0),
|
|
478
|
-
tokens: results.reduce((total, result) => total + (result.progressSummary?.tokens ?? 0), 0),
|
|
479
|
-
durationMs: saved?.durationMs ?? Math.max(0, ...results.map((result) => result.progressSummary?.durationMs ?? 0)) };
|
|
480
|
-
const share = saved?.shareUrl ? `Session: ${saved.shareUrl}` : saved?.shareError ? `Session share error: ${saved.shareError}` : undefined;
|
|
481
|
-
const identity = run.predecessorRunId ? `Run: ${run.runId}\nPredecessor: ${run.predecessorRunId} (child ${run.predecessorIndex ?? 0})` : undefined;
|
|
482
|
-
return { content: [{ type: "text", text: [identity, truncation.text || `Run ${run.runId}: ${view.state}.`, share].filter(Boolean).join("\n\n") }],
|
|
483
|
-
...(failed ? { isError: true } : {}),
|
|
484
|
-
details: { mode: run.mode, runId: run.runId, asyncId: run.runId, asyncDir: location.asyncDir ?? run.asyncDir, results,
|
|
485
|
-
run: { ...view, children: projected }, progressSummary,
|
|
486
|
-
...(includeProgress ? { progress: ownedRunProgressResult(run, state, index).details.progress } : {}),
|
|
487
|
-
...(saved?.shareUrl ? { shareUrl: saved.shareUrl } : {}),
|
|
488
|
-
...(saved?.gistUrl ? { gistUrl: saved.gistUrl } : {}),
|
|
489
|
-
...(saved?.shareError ? { shareError: saved.shareError } : {}),
|
|
490
|
-
...(files.length ? { artifacts: { dir: saved?.artifactsDir ?? path.dirname(files[0]!.outputPath), files } } : {}),
|
|
491
|
-
...(truncation.truncated ? { truncation } : {}),
|
|
492
|
-
...(saved?.outputs ? { outputs: saved.outputs } : {}), ...workflowDetails(saved?.workflowGraph) } };
|
|
493
|
-
}
|
|
494
|
-
|
|
495
|
-
/** Project the run owner's native activity for waiting callers without copying its journal. */
|
|
496
|
-
export function ownedRunProgressResult(run: OwnedRun, state: SubagentState, index?: number, view = ownedRunView(run, state, { readConfiguration: false, includeContinuations: false })): SubagentExecutionResult {
|
|
497
|
-
const status = readStatus(run.asyncDir ?? getRunMetadataDir(run.runId));
|
|
498
|
-
const children = view.children.filter((child) => index === undefined || child.index === index);
|
|
499
|
-
const progress: AgentProgress[] = children.map((child) => {
|
|
500
|
-
const step = status?.steps?.[child.index];
|
|
501
|
-
const live = child.state === "live";
|
|
502
|
-
return {
|
|
503
|
-
index: child.index, agent: child.agent, task: child.task ?? run.task,
|
|
504
|
-
status: step?.status ?? (child.state === "live" ? "pending" : child.state === "unknown" ? "failed" : child.state),
|
|
505
|
-
model: step?.model, thinking: step?.thinking, modelStartedAt: step?.modelStartedAt,
|
|
506
|
-
activityState: step?.activityState, lastActivityAt: step?.lastActivityAt, skills: step?.skills,
|
|
507
|
-
...(live ? { currentTool: step?.currentTool, currentToolArgs: step?.currentToolArgs, currentToolStartedAt: step?.currentToolStartedAt,
|
|
508
|
-
currentPath: step?.currentPath, streamingText: step?.streamingText } : {}),
|
|
509
|
-
recentTools: live ? step?.recentTools?.slice(-10) ?? [] : [], recentOutput: live ? step?.recentOutput?.slice(-10) ?? [] : [],
|
|
510
|
-
toolCount: step?.toolCount ?? 0, turnCount: step?.turnCount, tokens: step?.tokens?.total ?? 0,
|
|
511
|
-
durationMs: step?.durationMs ?? Math.max(0, Date.now() - (step?.startedAt ?? run.startedAt)), error: step?.error,
|
|
512
|
-
};
|
|
513
|
-
});
|
|
514
|
-
const results: SingleResult[] = progress.map((item, position) => ({
|
|
515
|
-
agent: item.agent, task: item.task, exitCode: children[position]?.result?.exitCode ?? 0,
|
|
516
|
-
usage: children[position]?.result?.usage ?? { input: status?.steps?.[item.index]?.tokens?.input ?? 0, output: status?.steps?.[item.index]?.tokens?.output ?? 0, cacheRead: 0, cacheWrite: 0, cost: 0, turns: item.turnCount ?? 0 },
|
|
517
|
-
progress: item, model: item.model, sessionFile: children[position]?.sessionFile,
|
|
518
|
-
finalOutput: getSingleResultOutput(children[position]?.result ?? {}) || item.streamingText || item.recentOutput.at(-1),
|
|
519
|
-
}));
|
|
520
|
-
return { content: [{ type: "text", text: progress.map((item) => `${item.agent}: ${item.status}${item.currentTool ? ` — ${item.currentTool}${item.currentToolArgs ? ` ${item.currentToolArgs}` : ""}` : ""}`).join("\n") }],
|
|
521
|
-
details: { mode: run.mode, runId: run.runId, asyncId: run.runId, asyncDir: run.asyncDir, results, progress, ...workflowDetails(status?.workflowGraph) } };
|
|
522
|
-
}
|
|
523
|
-
|
|
524
|
-
function compact(value: string, max = 180): string {
|
|
525
|
-
const text = value.replace(/\s+/g, " ").trim();
|
|
526
|
-
return text.length > max ? `${text.slice(0, max - 1)}…` : text;
|
|
527
|
-
}
|
|
528
|
-
|
|
529
|
-
function ownedRunControl(view: OwnedRunView) {
|
|
530
|
-
const active = view.children.find((child) => child.state === "live" && child.activity?.status !== "pending");
|
|
531
|
-
const resumable = active ?? view.children.find((child) => child.state !== "live" && child.sessionFile && !child.missingSession);
|
|
532
|
-
return buildManagementControl({ state: view.state, runId: view.runId, index: resumable?.index, canReview: view.state !== "live", canResume: Boolean(resumable), canNudge: Boolean(active), canInterrupt: view.canInterrupt, intercomTarget: active ? resolveSubagentIntercomTarget(view.runId, active.agent, active.index) : undefined });
|
|
533
|
-
}
|
|
534
|
-
|
|
535
|
-
export function ownedRunStatusResult(run: OwnedRun, state: SubagentState, runtime?: SubagentExecutionResult, options: { full?: boolean; childSafe?: boolean } = {}): SubagentExecutionResult {
|
|
536
|
-
const view = ownedRunView(run, state);
|
|
537
|
-
const liveControl = view.state === "live" && runtime?.details.managementControl?.state === "live" ? runtime.details.managementControl : undefined;
|
|
538
|
-
const control = liveControl ?? ownedRunControl(view);
|
|
539
|
-
const lines = [
|
|
540
|
-
`Run: ${run.runId}`, `State: ${view.state}`, `Mode: ${run.mode} (${run.source})`, `Task: ${options.full ? run.task : compact(run.task)}`, `Launch cwd: ${run.cwd}`,
|
|
541
|
-
`Root: ${run.rootRunId}`, ...(run.predecessorRunId ? [`Predecessor: ${run.predecessorRunId} (child ${run.predecessorIndex ?? 0})`] : []),
|
|
542
|
-
`Parent review (not sent to child): ${run.review?.decision ?? "unreviewed"}${run.review?.message ? ` — ${options.full ? run.review.message : compact(run.review.message)}` : ""}`,
|
|
543
|
-
`Notification: ${run.delivery ? `recorded ${new Date(run.delivery.notifiedAt).toISOString()}; intercom ${run.delivery.intercomDelivered ? "delivered" : "not confirmed"}` : "not recorded"}`,
|
|
544
|
-
...(view.attention.length ? [`Attention: ${view.attention.join(", ")}`] : []),
|
|
545
|
-
...(view.resultPath ? [`Result: ${view.resultPath}`] : []), ...(view.diagnosis ? [view.diagnosis] : []),
|
|
546
|
-
...(runtime && !runtime.isError && (run.source === "async" || liveControl) ? runtime.content.flatMap((part) => part.type === "text" ? [part.text] : []) : []),
|
|
547
|
-
];
|
|
548
|
-
for (const child of view.children) {
|
|
549
|
-
lines.push(`Child ${child.index}: ${child.agent} | ${child.state}${child.result?.acceptance ? ` | validation: ${child.result.acceptance.status}` : ""}`);
|
|
550
|
-
const humanAction = acceptanceHumanAction(child.result?.acceptance);
|
|
551
|
-
if (humanAction) lines.push(` Needs your action — acceptance incomplete:\n${humanAction}`);
|
|
552
|
-
if (child.state !== "live") lines.push(` ${formatAgentProcessExit(child.result?.agentProcessExit)}`);
|
|
553
|
-
if (child.sessionFile) lines.push(` Session: ${child.sessionFile}${child.missingSession ? " (missing; continuation unavailable)" : ""}`);
|
|
554
|
-
if (child.result?.auditPath) lines.push(` Child observations / uncommitted output: ${child.result.auditPath}`);
|
|
555
|
-
if (child.result?.fullOutputPath) lines.push(` Full output: ${child.result.fullOutputPath}`);
|
|
556
|
-
if (child.result?.accounting?.state === "incomplete") lines.push(` Accounting incomplete: ${child.result.accounting.error ?? "Native billing evidence is unavailable; no work was repeated."}`);
|
|
557
|
-
const artifact = child.result?.artifactPaths?.outputPath;
|
|
558
|
-
if (artifact) lines.push(` Artifact: ${artifact}${fs.existsSync(artifact) ? "" : " (missing)"}`);
|
|
559
|
-
const metadata = child.result?.artifactPaths?.metadataPath;
|
|
560
|
-
if (metadata) lines.push(` Result metadata (acceptance details when configured): ${metadata}${fs.existsSync(metadata) ? "" : " (missing)"}`);
|
|
561
|
-
if (child.launch) {
|
|
562
|
-
const launch = child.launch;
|
|
563
|
-
lines.push(` Effective model: ${launch.model ?? "native default"}; thinking: ${launch.thinking ?? "native default"}`,
|
|
564
|
-
` Output: ${launch.output || "disabled"} (${launch.outputMode}); configuration: saved launch snapshot`);
|
|
565
|
-
if (options.full) lines.push(` Saved launch configuration:\n${JSON.stringify(launch, null, 2)}`);
|
|
566
|
-
} else lines.push(" Configuration: legacy-partial; original profile snapshot was not recorded.");
|
|
567
|
-
const output = child.result && getSingleResultOutput(child.result);
|
|
568
|
-
if (output) lines.push(` Result: ${compact(output, 600)}`);
|
|
569
|
-
if (child.result?.error) lines.push(` Error: ${child.result.error}`);
|
|
570
|
-
}
|
|
571
|
-
if (control.capabilities.includes("review")) lines.push(`Review (parent-only, not sent to child): ${formatRunAction("review", run.runId, { decision: "accepted" }, options.childSafe)} or decision: "needs_changes".`);
|
|
572
|
-
if (view.continuations.length) lines.push("Continuation history:", ...view.continuations.map((next) => ` ${next.predecessorRunId}:${next.predecessorIndex ?? 0} -> ${next.runId}`));
|
|
573
|
-
if (control.capabilities.includes("resume")) lines.push(`Continue: ${formatRunAction("resume", run.runId, { ...(view.children.length > 1 ? { index: control.nextActions.find((action) => action.action === "resume")?.index ?? 0 } : {}), message: "..." }, options.childSafe)}`);
|
|
574
|
-
if (!options.full) lines.push(`Full task/configuration: ${formatRunAction("status", run.runId, { full: true }, options.childSafe)}`);
|
|
575
|
-
return {
|
|
576
|
-
content: [{ type: "text", text: lines.join("\n") }],
|
|
577
|
-
details: { ...runtime?.details, mode: "management", results: [], run: view, managementControl: control },
|
|
578
|
-
};
|
|
579
|
-
}
|
|
580
|
-
|
|
581
|
-
function unavailableRunView(run: OwnedRun, error: unknown): OwnedRunView {
|
|
582
|
-
return { ...run, state: "unknown", updatedAt: run.startedAt, attention: ["unknown"], canInterrupt: false, continuations: [],
|
|
583
|
-
children: run.children.map((child) => ({ ...child, state: "unknown", configuration: "legacy-partial" })),
|
|
584
|
-
diagnosis: `Saved owner records unavailable: ${String(error)}. Completion is unconfirmed.` };
|
|
585
|
-
}
|
|
586
|
-
|
|
587
|
-
export async function ownedRunList(state: SubagentState, params: Pick<SubagentParamsLike, "offset" | "limit" | "cursor" | "sort" | "agent" | "state" | "text"> & { signal?: AbortSignal }): Promise<SubagentExecutionResult> {
|
|
588
|
-
const limit = params.limit ?? 20, sort = params.sort;
|
|
589
|
-
if (sort === "relevance") throw new Error("Run list sort must be attention, newest, or oldest.");
|
|
590
|
-
const indexed = await (await runHistoryIndex(state, true)).listRuns({ ...params, sort });
|
|
591
|
-
// The index orders observations; only the bounded selected page gets authoritative controls.
|
|
592
|
-
const page = indexed.rows.map((row) => {
|
|
593
|
-
const run = state.ownedRuns?.get(row.runId);
|
|
594
|
-
if (!run || run.ownerSessionId !== row.ownerSessionId) throw new Error("Owning session changed while listing runs.");
|
|
595
|
-
try { return ownedRunView(run, state, { includeContinuations: false, readConfiguration: false }); }
|
|
596
|
-
catch (error) { return unavailableRunView(run, error); }
|
|
597
|
-
});
|
|
598
|
-
const owned = [...(state.ownedRuns?.values() ?? [])];
|
|
599
|
-
const runs = page.map(({ runId, source, mode, cwd, task, state: runState, updatedAt, attention, review, rootRunId, predecessorRunId, predecessorIndex, children }) => ({ runId, source, mode, cwd, task: compact(task, 2048), state: runState, updatedAt, attention, review, rootRunId, predecessorRunId, predecessorIndex, continuations: owned.filter((candidate) => candidate.predecessorRunId === runId).map((candidate) => candidate.runId), summary: compact(children.map((child) => child.result ? getSingleResultOutput(child.result) || child.result.error || "" : "").filter(Boolean).join(" | ")) }));
|
|
600
|
-
const controls = page.map(ownedRunControl);
|
|
601
|
-
const { offset, nextOffset, nextCursor, total, freshness, version } = indexed;
|
|
602
|
-
const next = nextCursor ? { action: "list", cursor: nextCursor, limit, ...(sort ? { sort } : {}), ...(params.agent ? { agent: params.agent } : {}), ...(params.state ? { state: params.state } : {}), ...(params.text ? { text: params.text } : {}) } : undefined;
|
|
603
|
-
return {
|
|
604
|
-
content: [{ type: "text", text: total ? [`Owned runs: ${total} (showing ${page.length ? `${offset + 1}–${offset + page.length}` : "none"}; ${params.sort ?? "attention"} order)`, ...(freshness.state !== "current" ? [`Browse index: ${freshness.state}; ordering/filter observations may be incomplete. Selected controls are checked against owner records.`] : []), ...runs.map((run) => `- ${run.runId} | ${run.state}${run.attention.length ? ` | ${run.attention.join(", ")}` : ""} | ${compact(run.task)}${run.summary ? ` | ${run.summary}` : ""} | Launch cwd: ${run.cwd}${run.predecessorRunId ? ` | from ${run.predecessorRunId}:${run.predecessorIndex ?? 0}` : ""}${run.continuations.length ? ` | continued as ${run.continuations.join(", ")} (separate results/reviews)` : ""}`), ...(next ? [`Next: agent_runs(${JSON.stringify(next)})`] : [])].join("\n") : "No delegated runs match in this owning session." }],
|
|
605
|
-
details: { mode: "management", results: [], runs, managementControls: controls, managementControl: controls.find((control) => control.state === "live"), runList: { total, offset, limit, version, freshness, ...(nextOffset !== undefined ? { nextOffset } : {}), ...(nextCursor ? { nextCursor } : {}) } },
|
|
606
|
-
};
|
|
607
|
-
}
|
|
1
|
+
// Public run-management surface. Persistence, recovery, projection and presentation
|
|
2
|
+
// have separate owners so browsing never becomes evidence of completion.
|
|
3
|
+
export {
|
|
4
|
+
OWNED_RUN_ENTRY,
|
|
5
|
+
repairOwnedRunAccounting,
|
|
6
|
+
rememberOwnedRun,
|
|
7
|
+
resolveOwnedRun,
|
|
8
|
+
saveForegroundRun,
|
|
9
|
+
} from "./run-persistence.ts";
|
|
10
|
+
export { workflowChildren } from "./workflow-graph.ts";
|
|
11
|
+
export {
|
|
12
|
+
restoreOwnedRuns,
|
|
13
|
+
restoreOwnedRunsAsync,
|
|
14
|
+
type OwnedRunRestoration,
|
|
15
|
+
} from "./run-restoration.ts";
|
|
16
|
+
export { ownedRunView } from "./owned-run-view.ts";
|
|
17
|
+
export { ownedRunExecutionResult, ownedRunProgressResult } from "./owned-run-results.ts";
|
|
18
|
+
export { ownedRunStatusResult } from "./owned-run-status.ts";
|
|
19
|
+
export { ownedRunList } from "./owned-run-list.ts";
|