@sema-agent/core 7.60.0 → 7.61.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 +605 -0
- package/README.md +2 -2
- package/dist/agents/agent-transcript-tool.d.ts +2 -2
- package/dist/agents/agent-transcript-tool.js +1 -1
- package/dist/agents/cascade.d.ts +61 -10
- package/dist/agents/cascade.js +60 -20
- package/dist/agents/composition-allowance.d.ts +53 -0
- package/dist/agents/composition-allowance.js +49 -0
- package/dist/agents/composition-placement.d.ts +29 -0
- package/dist/agents/composition-placement.js +24 -0
- package/dist/agents/cumulative-stats.d.ts +4 -0
- package/dist/agents/cumulative-stats.js +3 -0
- package/dist/agents/inherited-tool-pool.d.ts +5 -3
- package/dist/agents/inherited-tool-pool.js +2 -2
- package/dist/agents/list-agents-tool.d.ts +1 -1
- package/dist/agents/peer-notice-route.d.ts +1 -1
- package/dist/agents/peer-notice-route.js +4 -3
- package/dist/agents/peer-notices.d.ts +4 -4
- package/dist/agents/peer-notices.js +8 -4
- package/dist/agents/peer-session-drain.d.ts +8 -1
- package/dist/agents/peer-session-drain.js +36 -7
- package/dist/agents/repair-loop.js +16 -6
- package/dist/agents/retain-ledger.js +3 -1
- package/dist/agents/roster-store.d.ts +1 -1
- package/dist/agents/roster-store.js +7 -4
- package/dist/agents/send-message-tool.d.ts +8 -10
- package/dist/agents/send-message-tool.js +43 -23
- package/dist/agents/subagent-completion-gate.d.ts +35 -0
- package/dist/agents/subagent-completion-gate.js +62 -0
- package/dist/agents/subagent-steps.d.ts +7 -6
- package/dist/agents/subagent.d.ts +30 -40
- package/dist/agents/subagent.js +187 -196
- package/dist/agents/suspend-guard.d.ts +9 -0
- package/dist/agents/suspend-guard.js +4 -0
- package/dist/agents/verify.d.ts +41 -14
- package/dist/agents/verify.js +37 -27
- package/dist/brain/anthropic.js +1 -0
- package/dist/brain/errors.d.ts +7 -1
- package/dist/brain/errors.js +6 -0
- package/dist/brain/failover.js +2 -1
- package/dist/brain/open-responses.js +1 -0
- package/dist/brain/openai.js +1 -0
- package/dist/brain/provider-dialect.d.ts +10 -0
- package/dist/brain/provider-dialect.js +13 -2
- package/dist/brain/stream-engine.d.ts +3 -0
- package/dist/brain/stream-engine.js +4 -0
- package/dist/core/agent-state.d.ts +1 -1
- package/dist/core/allow-entry.d.ts +59 -23
- package/dist/core/allow-entry.js +131 -38
- package/dist/core/ask-origin.d.ts +79 -0
- package/dist/core/ask-origin.js +76 -0
- package/dist/core/ask-question.d.ts +19 -13
- package/dist/core/ask-question.js +8 -2
- package/dist/core/auto-compaction.d.ts +2 -0
- package/dist/core/auto-compaction.js +2 -1
- package/dist/core/auto-mode.js +3 -5
- package/dist/core/background-agent-store.d.ts +7 -5
- package/dist/core/background-agent-store.js +12 -11
- package/dist/core/checkpoint-requirements.d.ts +24 -3
- package/dist/core/checkpoint-requirements.js +9 -1
- package/dist/core/checkpoint-store.d.ts +78 -19
- package/dist/core/checkpoint-store.js +8 -4
- package/dist/core/child-clamp-seats.d.ts +3 -2
- package/dist/core/child-clamp-seats.js +4 -3
- package/dist/core/closest-name.d.ts +13 -0
- package/dist/core/closest-name.js +35 -0
- package/dist/core/context-settings.js +3 -5
- package/dist/core/cross-boundary-taint.d.ts +1 -1
- package/dist/core/decision-receipt.d.ts +14 -1
- package/dist/core/decision-receipt.js +6 -3
- package/dist/core/delegation-frames.d.ts +13 -9
- package/dist/core/effective-path-target.js +2 -3
- package/dist/core/engine-attestation.d.ts +11 -1
- package/dist/core/engine-attestation.js +2 -0
- package/dist/core/engine-notice.d.ts +49 -18
- package/dist/core/file-history-retention.d.ts +8 -0
- package/dist/core/file-history-retention.js +14 -11
- package/dist/core/file-history-store.d.ts +31 -1
- package/dist/core/file-history-store.js +31 -2
- package/dist/core/frame-settlement.d.ts +10 -0
- package/dist/core/frame-settlement.js +6 -1
- package/dist/core/fs-write-gate-policy.d.ts +3 -3
- package/dist/core/fs-write-gate-policy.js +8 -7
- package/dist/core/gate-fold.js +2 -1
- package/dist/core/gate-lanes.js +7 -4
- package/dist/core/gate-outcome.d.ts +40 -1
- package/dist/core/gate-outcome.js +10 -0
- package/dist/core/git-worktree-env.d.ts +7 -3
- package/dist/core/git-worktree-env.js +16 -13
- package/dist/core/governance-codes.d.ts +12 -4
- package/dist/core/governance-codes.js +16 -4
- package/dist/core/hooks.d.ts +12 -4
- package/dist/core/hooks.js +11 -4
- package/dist/core/host-floor.js +3 -5
- package/dist/core/image-admission.d.ts +48 -8
- package/dist/core/image-admission.js +35 -4
- package/dist/core/input-author.d.ts +36 -0
- package/dist/core/input-author.js +39 -0
- package/dist/core/leg-identity.d.ts +62 -0
- package/dist/core/leg-identity.js +18 -0
- package/dist/core/locked-config.d.ts +2 -1
- package/dist/core/locked-config.js +5 -3
- package/dist/core/lsp.d.ts +5 -3
- package/dist/core/lsp.js +3 -2
- package/dist/core/mailbox-store.d.ts +85 -10
- package/dist/core/mailbox-store.js +31 -10
- package/dist/core/mcp-connection-pool.d.ts +6 -20
- package/dist/core/mcp-connection-pool.js +10 -28
- package/dist/core/mcp-failure.d.ts +76 -15
- package/dist/core/mcp-failure.js +60 -33
- package/dist/core/mcp-host-seat.d.ts +92 -53
- package/dist/core/mcp-host-seat.js +220 -46
- package/dist/core/mcp-probe.js +2 -2
- package/dist/core/mcp-server-link.d.ts +18 -6
- package/dist/core/mcp-server-link.js +19 -4
- package/dist/core/mcp-server-spec.d.ts +2 -1
- package/dist/core/mcp-session-end.d.ts +1 -2
- package/dist/core/mcp-session-end.js +1 -1
- package/dist/core/mcp.d.ts +6 -49
- package/dist/core/mcp.js +115 -111
- package/dist/core/media-byte-cap.d.ts +21 -46
- package/dist/core/media-byte-cap.js +55 -55
- package/dist/core/member-group.d.ts +7 -0
- package/dist/core/member-group.js +35 -0
- package/dist/core/memory-engine/consolidation.d.ts +1 -1
- package/dist/core/memory-engine/consolidation.js +7 -1
- package/dist/core/memory-engine/dual-root.d.ts +31 -0
- package/dist/core/memory-engine/dual-root.js +59 -11
- package/dist/core/memory-engine/engine.js +27 -24
- package/dist/core/memory-engine/file-backend.d.ts +13 -0
- package/dist/core/memory-engine/file-backend.js +35 -15
- package/dist/core/memory-engine/layout.d.ts +3 -0
- package/dist/core/memory-engine/layout.js +13 -3
- package/dist/core/memory-engine/memory-deployment.d.ts +110 -0
- package/dist/core/memory-engine/memory-deployment.js +182 -0
- package/dist/core/memory-engine/sync-client.d.ts +39 -18
- package/dist/core/memory-engine/sync-client.js +72 -14
- package/dist/core/memory-engine/sync-report.d.ts +7 -4
- package/dist/core/memory-engine/sync.d.ts +9 -1
- package/dist/core/mode-policy.d.ts +8 -8
- package/dist/core/mode-policy.js +7 -5
- package/dist/core/mods/agent-stations.d.ts +39 -4
- package/dist/core/mods/agent-stations.js +59 -10
- package/dist/core/mods/dollar.d.ts +62 -0
- package/dist/core/mods/extension-call.d.ts +15 -1
- package/dist/core/mods/extension-call.js +7 -2
- package/dist/core/mods/kernel/dispatch.d.ts +4 -3
- package/dist/core/mods/kernel/dispatch.js +4 -4
- package/dist/core/mods/kernel/events.d.ts +4 -1
- package/dist/core/mods/kernel/events.js +6 -6
- package/dist/core/mods/kernel/registration.d.ts +3 -0
- package/dist/core/mods/kernel/registration.js +5 -0
- package/dist/core/mods/kernel/site-rules.d.ts +6 -3
- package/dist/core/mods/kernel/site-rules.js +10 -2
- package/dist/core/mods/session-append.d.ts +115 -0
- package/dist/core/mods/session-append.js +311 -0
- package/dist/core/mods/session-compact.d.ts +48 -0
- package/dist/core/mods/session-compact.js +194 -0
- package/dist/core/mods/session-receive.d.ts +93 -0
- package/dist/core/mods/session-receive.js +141 -0
- package/dist/core/mods/session-send.d.ts +72 -0
- package/dist/core/mods/session-send.js +88 -0
- package/dist/core/mods/stations.d.ts +38 -16
- package/dist/core/mods/stations.js +25 -11
- package/dist/core/mods/tool-call.d.ts +2 -0
- package/dist/core/mods/tool-call.js +4 -4
- package/dist/core/output-style.js +3 -4
- package/dist/core/own-property-receipt.d.ts +61 -2
- package/dist/core/own-property-receipt.js +42 -2
- package/dist/core/park-selfcheck.js +4 -2
- package/dist/core/path-identity.d.ts +11 -0
- package/dist/core/path-identity.js +4 -0
- package/dist/core/path-rule-binding.d.ts +3 -1
- package/dist/core/path-rule-binding.js +3 -1
- package/dist/core/peer-seat.d.ts +3 -3
- package/dist/core/peer-seat.js +20 -8
- package/dist/core/permission-rule-consent.d.ts +21 -5
- package/dist/core/permission-rule-consent.js +21 -1
- package/dist/core/permission-rule-model.d.ts +34 -11
- package/dist/core/permission-rule-model.js +47 -10
- package/dist/core/permission-rule-org.d.ts +1 -1
- package/dist/core/permission-rule-provider.js +4 -1
- package/dist/core/permission-rules.d.ts +4 -0
- package/dist/core/permission-rules.js +11 -16
- package/dist/core/remote-env.d.ts +74 -26
- package/dist/core/remote-env.js +20 -0
- package/dist/core/retention-policy.d.ts +24 -23
- package/dist/core/retention-policy.js +36 -2
- package/dist/core/retention.d.ts +4 -1
- package/dist/core/retired-keys.d.ts +4 -4
- package/dist/core/row-admission.d.ts +10 -0
- package/dist/core/row-admission.js +5 -0
- package/dist/core/runner/advisor-instructions.d.ts +2 -1
- package/dist/core/runner/advisor-instructions.js +2 -1
- package/dist/core/runner/announce-once-ledger.d.ts +4 -4
- package/dist/core/runner/assemble-result.d.ts +13 -3
- package/dist/core/runner/assemble-result.js +12 -7
- package/dist/core/runner/caller-roster.d.ts +12 -9
- package/dist/core/runner/caller-roster.js +5 -2
- package/dist/core/runner/checkpoint-scope.d.ts +16 -1
- package/dist/core/runner/checkpoint-scope.js +21 -0
- package/dist/core/runner/compact-session.js +14 -2
- package/dist/core/runner/compaction-call-options.d.ts +1 -1
- package/dist/core/runner/compaction-restate.d.ts +2 -2
- package/dist/core/runner/compaction-restate.js +4 -3
- package/dist/core/runner/construction-doors.d.ts +2 -2
- package/dist/core/runner/construction-doors.js +2 -2
- package/dist/core/runner/contracts.d.ts +98 -26
- package/dist/core/runner/cross-boundary-lane.d.ts +1 -1
- package/dist/core/runner/decide-continuation.d.ts +4 -2
- package/dist/core/runner/decide-continuation.js +7 -4
- package/dist/core/runner/denial-limit-arms.d.ts +15 -21
- package/dist/core/runner/denial-limit-arms.js +17 -10
- package/dist/core/runner/expire-settle.d.ts +44 -0
- package/dist/core/runner/expire-settle.js +55 -0
- package/dist/core/runner/git-status-frame.d.ts +3 -3
- package/dist/core/runner/git-status-frame.js +2 -1
- package/dist/core/runner/halt-attribution.d.ts +2 -1
- package/dist/core/runner/halt-attribution.js +2 -1
- package/dist/core/runner/local-claims.d.ts +17 -0
- package/dist/core/runner/local-claims.js +18 -0
- package/dist/core/runner/media-removed-seat.d.ts +46 -0
- package/dist/core/runner/media-removed-seat.js +88 -0
- package/dist/core/runner/park-commit.d.ts +2 -2
- package/dist/core/runner/permission-rule-lanes.d.ts +5 -1
- package/dist/core/runner/permission-rule-lanes.js +28 -9
- package/dist/core/runner/person-path-rows.js +1 -1
- package/dist/core/runner/placement-fence.d.ts +26 -0
- package/dist/core/runner/placement-fence.js +38 -0
- package/dist/core/runner/prepare-ask-lane.d.ts +6 -12
- package/dist/core/runner/prepare-ask-lane.js +4 -4
- package/dist/core/runner/prepare-boundary-parks.d.ts +4 -1
- package/dist/core/runner/prepare-boundary-parks.js +2 -2
- package/dist/core/runner/prepare-caps-and-workflow.d.ts +2 -0
- package/dist/core/runner/prepare-caps-and-workflow.js +1 -0
- package/dist/core/runner/prepare-config-doors.js +16 -17
- package/dist/core/runner/prepare-context-lane.d.ts +6 -2
- package/dist/core/runner/prepare-context-lane.js +13 -13
- package/dist/core/runner/prepare-delegation-surface.d.ts +9 -9
- package/dist/core/runner/prepare-delegation-surface.js +4 -5
- package/dist/core/runner/prepare-execution-env.d.ts +5 -2
- package/dist/core/runner/prepare-execution-env.js +7 -4
- package/dist/core/runner/prepare-gate-stations.d.ts +19 -14
- package/dist/core/runner/prepare-gate-stations.js +6 -4
- package/dist/core/runner/prepare-hands-readface.d.ts +5 -5
- package/dist/core/runner/prepare-hands-readface.js +4 -4
- package/dist/core/runner/prepare-inherited-gate.d.ts +6 -0
- package/dist/core/runner/prepare-inherited-gate.js +3 -0
- package/dist/core/runner/prepare-lsp.d.ts +3 -0
- package/dist/core/runner/prepare-lsp.js +2 -2
- package/dist/core/runner/prepare-park-ask.d.ts +5 -2
- package/dist/core/runner/prepare-park-ask.js +4 -5
- package/dist/core/runner/prepare-policy-chain.d.ts +10 -21
- package/dist/core/runner/prepare-policy-chain.js +16 -25
- package/dist/core/runner/prepare-project-context.d.ts +2 -2
- package/dist/core/runner/prepare-prompt-inputs.d.ts +5 -4
- package/dist/core/runner/prepare-prompt-inputs.js +3 -2
- package/dist/core/runner/prepare-question-face.d.ts +6 -4
- package/dist/core/runner/prepare-question-face.js +2 -2
- package/dist/core/runner/prepare-run-refs.d.ts +3 -0
- package/dist/core/runner/prepare-run-refs.js +2 -2
- package/dist/core/runner/prepare-suspend-saga.d.ts +11 -7
- package/dist/core/runner/prepare-suspend-saga.js +17 -7
- package/dist/core/runner/prepare-task.d.ts +1 -1
- package/dist/core/runner/prepare-task.js +56 -28
- package/dist/core/runner/prepare-tool-disclosure-mount.d.ts +6 -0
- package/dist/core/runner/prepare-tool-disclosure-mount.js +3 -1
- package/dist/core/runner/prepare-wiring-manifest.d.ts +3 -0
- package/dist/core/runner/prepare-wiring-manifest.js +2 -1
- package/dist/core/runner/prepare-workspace-restore.d.ts +5 -0
- package/dist/core/runner/prepare-workspace-restore.js +10 -6
- package/dist/core/runner/read-root-grant.d.ts +1 -1
- package/dist/core/runner/read-root-grant.js +2 -1
- package/dist/core/runner/resume-admission.d.ts +5 -3
- package/dist/core/runner/resume-admission.js +17 -3
- package/dist/core/runner/resume-apply.js +3 -1
- package/dist/core/runner/resume-claim.d.ts +8 -3
- package/dist/core/runner/resume-claim.js +28 -12
- package/dist/core/runner/resume-internals-and-config.d.ts +2 -2
- package/dist/core/runner/resume-internals-and-config.js +10 -1
- package/dist/core/runner/resume-preflight.d.ts +3 -2
- package/dist/core/runner/resume-preflight.js +13 -26
- package/dist/core/runner/retired-runner-deps.js +2 -0
- package/dist/core/runner/run-git-lane.js +2 -1
- package/dist/core/runner/run-harness-handlers.js +2 -2
- package/dist/core/runner/run-identity-wiring.d.ts +2 -2
- package/dist/core/runner/run-identity-wiring.js +14 -5
- package/dist/core/runner/run-leg.d.ts +3 -3
- package/dist/core/runner/run-leg.js +40 -29
- package/dist/core/runner/run-notification-lane.js +20 -2
- package/dist/core/runner/run-recovery-lanes.js +3 -2
- package/dist/core/runner/run-settle-and-teardown.js +9 -7
- package/dist/core/runner/run-telemetry-and-budget-seats.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.d.ts +1 -1
- package/dist/core/runner/run-terminal-adoption.js +26 -17
- package/dist/core/runner/run-turn-boundary.js +27 -14
- package/dist/core/runner/runtask.d.ts +18 -3
- package/dist/core/runner/runtask.js +27 -11
- package/dist/core/runner/session-rule-policy.d.ts +1 -1
- package/dist/core/runner/session-rule-policy.js +6 -1
- package/dist/core/runner/shell-env-withheld.d.ts +1 -1
- package/dist/core/runner/stream-halt-verbs.d.ts +1 -14
- package/dist/core/runner/stream-halt-verbs.js +4 -3
- package/dist/core/runner/stream-reap.d.ts +7 -6
- package/dist/core/runner/stream-reap.js +13 -16
- package/dist/core/runner/stream-settle-backstop.d.ts +3 -2
- package/dist/core/runner/stream-settle-backstop.js +5 -3
- package/dist/core/runner/stream-steer-verb.d.ts +5 -2
- package/dist/core/runner/stream-steer-verb.js +8 -7
- package/dist/core/runner/terminal-account.d.ts +11 -1
- package/dist/core/runner/terminal-account.js +20 -0
- package/dist/core/runner/terminal-projection.d.ts +8 -2
- package/dist/core/runner/terminal-projection.js +2 -2
- package/dist/core/runner/tool-disclosure.d.ts +3 -0
- package/dist/core/runner/tool-disclosure.js +5 -2
- package/dist/core/runner/tool-end-body.d.ts +3 -3
- package/dist/core/runner/tool-end-body.js +1 -1
- package/dist/core/runner/tool-output-projection.d.ts +3 -3
- package/dist/core/runner/tool-output-projection.js +7 -6
- package/dist/core/runner/tool-table-view.d.ts +56 -0
- package/dist/core/runner/tool-table-view.js +51 -0
- package/dist/core/runner/turn-attachments.d.ts +3 -2
- package/dist/core/runner/turn-attachments.js +1 -1
- package/dist/core/runner/void-verifier-pause.d.ts +33 -0
- package/dist/core/runner/void-verifier-pause.js +41 -0
- package/dist/core/runner-deps.d.ts +24 -25
- package/dist/core/secret-env.d.ts +11 -11
- package/dist/core/secret-env.js +8 -9
- package/dist/core/session-log-transfer.js +9 -10
- package/dist/core/session-policy-store.d.ts +1 -1
- package/dist/core/session-policy-store.js +5 -2
- package/dist/core/session-reconcile.d.ts +3 -2
- package/dist/core/session-reconcile.js +7 -4
- package/dist/core/session-store.d.ts +2 -0
- package/dist/core/session-store.js +5 -7
- package/dist/core/session.d.ts +2 -1
- package/dist/core/shell-confinement.d.ts +37 -0
- package/dist/core/shell-confinement.js +56 -0
- package/dist/core/skill-grant.js +1 -1
- package/dist/core/store-contracts/checkpoint-store-contract.d.ts +2 -2
- package/dist/core/store-contracts/checkpoint-store-contract.js +15 -2
- package/dist/core/store-contracts/file-history-store-contract.d.ts +5 -2
- package/dist/core/store-contracts/file-history-store-contract.js +25 -1
- package/dist/core/store-contracts/mailbox-store-contract.d.ts +12 -5
- package/dist/core/store-contracts/mailbox-store-contract.js +156 -9
- package/dist/core/store-contracts/tool-result-store-contract.d.ts +1 -1
- package/dist/core/store-contracts/tool-result-store-contract.js +30 -0
- package/dist/core/task-event.d.ts +17 -8
- package/dist/core/task-limits.d.ts +5 -0
- package/dist/core/task-notification.d.ts +89 -12
- package/dist/core/task-notification.js +87 -13
- package/dist/core/task-registry-agent.d.ts +5 -43
- package/dist/core/task-registry-agent.js +24 -51
- package/dist/core/task-registry-monitor.d.ts +1 -1
- package/dist/core/task-registry-monitor.js +15 -60
- package/dist/core/task-registry-shared.d.ts +15 -112
- package/dist/core/task-registry-shared.js +3 -41
- package/dist/core/task-registry-workflow.js +4 -21
- package/dist/core/task-registry.d.ts +19 -60
- package/dist/core/task-registry.js +19 -106
- package/dist/core/task-result.d.ts +24 -7
- package/dist/core/task-spec-members.d.ts +39 -0
- package/dist/core/task-spec-members.js +92 -0
- package/dist/core/task-spec.d.ts +10 -10
- package/dist/core/task-tool-shape.d.ts +7 -57
- package/dist/core/task-tool-shape.js +7 -66
- package/dist/core/terminal-cause.d.ts +30 -0
- package/dist/core/terminal-cause.js +1 -0
- package/dist/core/tool-catalog-entries.js +2 -5
- package/dist/core/tool-check-reading.js +16 -10
- package/dist/core/tool-conformance.js +1 -2
- package/dist/core/tool-errors.d.ts +6 -3
- package/dist/core/tool-errors.js +2 -0
- package/dist/core/tool-face-reader.js +3 -2
- package/dist/core/tool-face.d.ts +2 -3
- package/dist/core/tool-name-aliases.d.ts +5 -29
- package/dist/core/tool-name-aliases.js +9 -5
- package/dist/core/tool-name-readings.d.ts +14 -3
- package/dist/core/tool-name-readings.js +2 -0
- package/dist/core/tool-policy.d.ts +108 -18
- package/dist/core/tool-policy.js +84 -14
- package/dist/core/tool-result-store.d.ts +23 -0
- package/dist/core/tool-result-store.js +3 -2
- package/dist/core/tool-spec.d.ts +19 -6
- package/dist/core/trace.d.ts +18 -1
- package/dist/core/user-attachment.js +26 -21
- package/dist/core/workflow-journal-store.d.ts +1 -1
- package/dist/core/workflow-run-store.d.ts +2 -0
- package/dist/core/workflow-run-store.js +6 -5
- package/dist/core/workflow-settled-run.d.ts +5 -0
- package/dist/core/workflow-settled-run.js +7 -0
- package/dist/engine/execution-env/node-execution-env.d.ts +34 -9
- package/dist/engine/execution-env/node-execution-env.js +213 -21
- package/dist/engine/harness/agent-harness.d.ts +65 -18
- package/dist/engine/harness/agent-harness.js +90 -23
- package/dist/engine/harness/messages.d.ts +4 -3
- package/dist/engine/harness/messages.js +2 -2
- package/dist/engine/harness/types.d.ts +41 -7
- package/dist/engine/llm/media-removed.d.ts +14 -0
- package/dist/engine/llm/media-removed.js +9 -0
- package/dist/engine/llm/rejected-images.d.ts +35 -25
- package/dist/engine/llm/rejected-images.js +59 -10
- package/dist/engine/llm/types.d.ts +24 -3
- package/dist/engine/llm/types.js +7 -3
- package/dist/engine/loop/agent-loop.d.ts +6 -1
- package/dist/engine/loop/agent-loop.js +20 -11
- package/dist/engine/loop/types.d.ts +12 -3
- package/dist/engine/session/import-validate.js +7 -0
- package/dist/fixtures/index.d.ts +7 -5
- package/dist/fixtures/index.js +5 -3
- package/dist/index.d.ts +21 -11
- package/dist/index.js +15 -7
- package/dist/internal/harness-types.d.ts +2 -0
- package/dist/internal/llm.d.ts +2 -1
- package/dist/internal/llm.js +1 -0
- package/dist/orchestration/goal.d.ts +6 -2
- package/dist/orchestration/goal.js +6 -3
- package/dist/orchestration/run-workflow-tool.d.ts +11 -17
- package/dist/orchestration/run-workflow-tool.js +19 -42
- package/dist/orchestration/workflow-governance.d.ts +1 -1
- package/dist/orchestration/workflow-types.d.ts +2 -2
- package/dist/orchestration/workflow.d.ts +4 -0
- package/dist/orchestration/workflow.js +8 -5
- package/dist/stores/file/background-agent-store.js +18 -15
- package/dist/stores/file/checkpoint-store.js +7 -4
- package/dist/stores/file/file-history-store.js +3 -2
- package/dist/stores/file/index.d.ts +5 -3
- package/dist/stores/file/index.js +23 -8
- package/dist/stores/file/ledger-tuning.d.ts +23 -0
- package/dist/stores/file/ledger-tuning.js +21 -0
- package/dist/stores/file/mailbox-store.js +42 -22
- package/dist/stores/file/memory-store.js +3 -2
- package/dist/stores/file/permission-rule-adopt.js +24 -21
- package/dist/stores/file/permission-rule-store.js +6 -3
- package/dist/stores/file/session-policy-store.js +3 -2
- package/dist/stores/file/session-store.d.ts +16 -3
- package/dist/stores/file/session-store.js +21 -20
- package/dist/stores/file/tool-result-store.d.ts +11 -0
- package/dist/stores/file/tool-result-store.js +57 -3
- package/dist/stores/file/usage-window-store.js +3 -2
- package/dist/stores/file/workflow-journal-store.d.ts +0 -2
- package/dist/stores/file/workflow-journal-store.js +3 -18
- package/dist/stores/file/workflow-run-store.d.ts +1 -1
- package/dist/stores/file/workflow-run-store.js +15 -10
- package/dist/tools/fs/dead-cwd.d.ts +5 -5
- package/dist/tools/fs/dead-cwd.js +4 -11
- package/dist/tools/fs/fs-bash-background-text.d.ts +6 -0
- package/dist/tools/fs/fs-bash-background-text.js +6 -0
- package/dist/tools/fs/fs-bash.d.ts +3 -18
- package/dist/tools/fs/fs-bash.js +37 -124
- package/dist/tools/fs/fs-pdf.js +8 -6
- package/dist/tools/fs/fs-read.js +2 -2
- package/dist/tools/fs/fs-shared.d.ts +28 -3
- package/dist/tools/fs/fs-shared.js +15 -0
- package/dist/tools/fs/index.d.ts +1 -1
- package/dist/tools/fs/index.js +4 -14
- package/dist/tools/fs/pdf.d.ts +4 -4
- package/dist/tools/fs/pdf.js +6 -6
- package/dist/tools/fs/read-deny-home.js +8 -1
- package/dist/tools/fs/read-deny.d.ts +26 -2
- package/dist/tools/fs/read-deny.js +9 -2
- package/dist/tools/fs/read-floor.d.ts +13 -5
- package/dist/tools/fs/read-floor.js +206 -2
- package/dist/tools/fs/search.d.ts +3 -2
- package/dist/tools/fs/search.js +6 -6
- package/dist/tools/fs/shell-read-establish.js +3 -1
- package/dist/tools/fs/shell-read-identity.d.ts +3 -1
- package/dist/tools/fs/shell-read-identity.js +4 -2
- package/dist/tools/fs/shell-read-judge.d.ts +7 -1
- package/dist/tools/fs/shell-read-judge.js +1 -1
- package/dist/tools/monitor.d.ts +8 -7
- package/dist/tools/monitor.js +12 -10
- package/dist/tools/worktree.d.ts +5 -1
- package/dist/tools/worktree.js +20 -17
- package/package.json +6 -3
- package/test/export-surface.snapshot.json +92 -10
- package/wire-changes/core-stores-sql@7.61.0.json +480 -0
- package/wire-changes/core@7.61.0.json +4405 -0
- package/wire-changes/mods-kernel@7.61.0.json +65 -0
- package/wire-changes/primitives@7.61.0.json +30 -0
- package/dist/core/runner/image-removed-seat.d.ts +0 -12
- package/dist/core/runner/image-removed-seat.js +0 -19
|
@@ -1,16 +1,28 @@
|
|
|
1
1
|
import { type ModBottomContext, type ModBus } from "./kernel/index.js";
|
|
2
2
|
import type { ExtensionRequester } from "../task-event.js";
|
|
3
|
+
/** Which `$` call made the record: the door the extension came through. */
|
|
4
|
+
export type ExtensionDoor = "tool.call" | "agent.spawn";
|
|
3
5
|
/** One extension's call while it runs. */
|
|
4
6
|
export interface ExtensionCall {
|
|
5
7
|
/** The leg bus the call was made on (the one {@link legBusOf} returned). */
|
|
6
8
|
readonly bus: ModBus;
|
|
7
9
|
readonly toolCallId: string;
|
|
10
|
+
/** The door: an extension's spawn is a record made by `$.agent.spawn` — a tool an extension calls through `$.tool.call` that
|
|
11
|
+
* runs the delegation inside its own body hands the delegation a tool call's record, and the delegation runs as it would
|
|
12
|
+
* for the model. */
|
|
13
|
+
readonly door: ExtensionDoor;
|
|
8
14
|
/** The `$` call's context: the frames its pipeline's events are raised under, and its origin. */
|
|
9
15
|
readonly caller: ModBottomContext;
|
|
10
16
|
/** Cleared when the call's pipeline settles — the one reading of "this call is still running". */
|
|
11
17
|
readonly live: boolean;
|
|
12
18
|
/** The call's end projection refused it (its latest gate record is a refusal) — written once, by the leg's tool_end station. */
|
|
13
19
|
readonly denied: boolean;
|
|
20
|
+
/** The subagent the call started (`$.agent.spawn`): its id and the model it was let start on — written once, by the delegation
|
|
21
|
+
* tool where it lets the subagent run; absent ⇒ none started (the call's result is never read for it). */
|
|
22
|
+
readonly launched?: {
|
|
23
|
+
readonly agentId: string;
|
|
24
|
+
readonly model: string;
|
|
25
|
+
};
|
|
14
26
|
}
|
|
15
27
|
/** The running extension call this chain carries for `bus`, when it is the call `toolCallId` names (or any, unnamed). */
|
|
16
28
|
export declare function extensionCallOf(bus: object, toolCallId?: string): ExtensionCall | undefined;
|
|
@@ -21,8 +33,10 @@ export declare function requesterOf(bus: object, toolCallId: string): {
|
|
|
21
33
|
};
|
|
22
34
|
/** The leg's tool_end station says the call it is closing was refused (a no-op for any call that is not the running extension call). */
|
|
23
35
|
export declare function noteExtensionCallDenied(bus: object, toolCallId: string): void;
|
|
36
|
+
/** The delegation tool says the extension's spawn it is running started its subagent (a no-op for any other call). */
|
|
37
|
+
export declare function noteExtensionCallLaunched(bus: object, toolCallId: string, launched: NonNullable<ExtensionCall["launched"]>): void;
|
|
24
38
|
/** Run an extension's call: `pipeline` runs with the call's record in scope; the record stops being live when it settles. */
|
|
25
|
-
export declare function runExtensionCall<T>(bus: ModBus, toolCallId: string, caller: ModBottomContext, pipeline: (call: ExtensionCall) => Promise<T>): Promise<T>;
|
|
39
|
+
export declare function runExtensionCall<T>(bus: ModBus, toolCallId: string, door: ExtensionDoor, caller: ModBottomContext, pipeline: (call: ExtensionCall) => Promise<T>): Promise<T>;
|
|
26
40
|
/**
|
|
27
41
|
* The leg bus every station raises on: a dispatch inside a running extension call made on it is raised under that call's
|
|
28
42
|
* frames and origin (a raiser that names its own frames keeps them — they extend the call's); one raised under a call
|
|
@@ -14,8 +14,13 @@ export function noteExtensionCallDenied(bus, toolCallId) {
|
|
|
14
14
|
if (c !== undefined && c.live && c.bus === bus && c.toolCallId === toolCallId)
|
|
15
15
|
c.denied = true;
|
|
16
16
|
}
|
|
17
|
-
export
|
|
18
|
-
const
|
|
17
|
+
export function noteExtensionCallLaunched(bus, toolCallId, launched) {
|
|
18
|
+
const c = store.getStore();
|
|
19
|
+
if (c !== undefined && c.live && c.bus === bus && c.toolCallId === toolCallId && c.launched === undefined)
|
|
20
|
+
c.launched = Object.freeze({ agentId: launched.agentId, model: launched.model });
|
|
21
|
+
}
|
|
22
|
+
export async function runExtensionCall(bus, toolCallId, door, caller, pipeline) {
|
|
23
|
+
const call = { bus, toolCallId, door, caller, live: true, denied: false };
|
|
19
24
|
try {
|
|
20
25
|
return await store.run(call, () => pipeline(call));
|
|
21
26
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import { type ModBusSide, type ModEventName, type ModSeat } from "./events.js";
|
|
2
2
|
import { type ModAdmissionRecord, type ModDollarBase, type ModOrigin, type ModSeats } from "./registration.js";
|
|
3
|
-
import { type ModAnswerCheck, type ModAnswerRanks, type ModEventPayload, type ModFailureCause, type ModMatcher, type ModSkip, type ProxyProbe } from "./site-rules.js";
|
|
3
|
+
import { type ModAnswerCheck, type ModAnswerer, type ModAnswerRanks, type ModEventPayload, type ModFailureCause, type ModMatcher, type ModSkip, type ProxyProbe } from "./site-rules.js";
|
|
4
4
|
/** A frame on the dispatch stack: a registration's own `$` call, or one of its handlers running. */
|
|
5
5
|
export type ModFrame = {
|
|
6
6
|
readonly kind: "dollar";
|
|
@@ -73,8 +73,9 @@ export interface ModDispatchOptions {
|
|
|
73
73
|
/** The raiser's reading of an answer; an answer it refuses is a violation of the site. */
|
|
74
74
|
readonly checkAnswer?: ModAnswerCheck;
|
|
75
75
|
/** The raiser's reading of what a handler hands on (a payload other than the dispatch's own `e`, received, its pinned keys
|
|
76
|
-
* judged); a payload it refuses is a violation of the site — the other direction of
|
|
77
|
-
|
|
76
|
+
* judged), with the handler that hands it on; a payload it refuses is a violation of the site — the other direction of
|
|
77
|
+
* {@link checkAnswer}. */
|
|
78
|
+
readonly checkHandOn?: (payload: ModEventPayload, by: ModAnswerer) => string | undefined;
|
|
78
79
|
/** The station's ranking of its answers — named by every dispatch of an event whose failure column refuses (one that
|
|
79
80
|
* names none is not run), and read by the seat-trust law. */
|
|
80
81
|
readonly ranks?: ModAnswerRanks;
|
|
@@ -371,13 +371,13 @@ function createBus(side, mounted, bottoms, entries, report, records, describe, i
|
|
|
371
371
|
let found;
|
|
372
372
|
return () => (found ??= sealedObjects([e0]));
|
|
373
373
|
})();
|
|
374
|
-
const handOn = (passed) => {
|
|
374
|
+
const handOn = (passed, h) => {
|
|
375
375
|
if (passed === e0)
|
|
376
376
|
return { snap: e0 };
|
|
377
377
|
const handed = handedOn(st.pinned, e0, passed, engines(), isProxy);
|
|
378
378
|
if ("violation" in handed)
|
|
379
379
|
return handed;
|
|
380
|
-
const why = handOnViolation(handed.payload, options.checkHandOn);
|
|
380
|
+
const why = handOnViolation(handed.payload, options.checkHandOn, answererOf(h));
|
|
381
381
|
return why !== undefined ? { violation: why } : { snap: handed.payload };
|
|
382
382
|
};
|
|
383
383
|
const trustFloors = new Map();
|
|
@@ -516,7 +516,7 @@ function createBus(side, mounted, bottoms, entries, report, records, describe, i
|
|
|
516
516
|
state.violated ??= "next() already called (a handler calls next once; its first run's answer stands)";
|
|
517
517
|
return Promise.reject(new Error(`${name}: next() already called`));
|
|
518
518
|
}
|
|
519
|
-
const handed = handOn(passed);
|
|
519
|
+
const handed = handOn(passed, h);
|
|
520
520
|
if ("violation" in handed) {
|
|
521
521
|
state.violated ??= handed.violation;
|
|
522
522
|
return Promise.reject(new Error(`${name}: ${state.violated}`));
|
|
@@ -634,7 +634,7 @@ function createBus(side, mounted, bottoms, entries, report, records, describe, i
|
|
|
634
634
|
running.then(resume, resume);
|
|
635
635
|
return running;
|
|
636
636
|
}
|
|
637
|
-
const handed = handOn(passed);
|
|
637
|
+
const handed = handOn(passed, h);
|
|
638
638
|
if ("violation" in handed) {
|
|
639
639
|
violated ??= handed.violation;
|
|
640
640
|
return Promise.reject(new Error(`${h.reg.name}: ${violated}`));
|
|
@@ -30,8 +30,11 @@
|
|
|
30
30
|
* go, before its subagent starts — every argument pinned, a refusal its only answer), `turn.complete` (a model turn ended)
|
|
31
31
|
* and `session.end` (a leg ended) have stations; `tool.call`'s failure column is `refuse` — a failure once the body has
|
|
32
32
|
* started withholds the result (under `refuse_until_run`, its column until 5, the result stood).
|
|
33
|
+
* 7: `session.receive` (a frame arriving for the model), `session.append` (a row entering the conversation), `session.send` (a
|
|
34
|
+
* message the leg sends) and `session.compact` (a compaction about to run) have stations; `agent.spawn` has a `call` column,
|
|
35
|
+
* and so do `session.append`, `session.send` and `session.compact` — a `$` call of each reaches the host's entry.
|
|
33
36
|
*/
|
|
34
|
-
export declare const KERNEL_CONTRACT_VERSION =
|
|
37
|
+
export declare const KERNEL_CONTRACT_VERSION = 7;
|
|
35
38
|
/** The five tiers in run order (CC names). `builtin` and `core` are the engine's own. */
|
|
36
39
|
export declare const MOD_TIERS: readonly ["prepend", "user", "append", "builtin", "core"];
|
|
37
40
|
export type ModTier = (typeof MOD_TIERS)[number];
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
export const KERNEL_CONTRACT_VERSION =
|
|
1
|
+
export const KERNEL_CONTRACT_VERSION = 7;
|
|
2
2
|
export const MOD_TIERS = Object.freeze(["prepend", "user", "append", "builtin", "core"]);
|
|
3
3
|
export const MOD_SEATS = Object.freeze(["deployment", "task"]);
|
|
4
4
|
export const MOD_EVENT_SIDES = Object.freeze(["engine", "surface", "both"]);
|
|
@@ -93,7 +93,7 @@ export const MOD_EVENT_TABLE = Object.freeze({
|
|
|
93
93
|
"ui.scroll": surface(station("skip", "grace", ["component", "requestId", "by", "bodyRows", "contentRows", "origin", "pointer"], { call: true })),
|
|
94
94
|
"ui.focus": surface(station("skip", "grace", ["component", "requestId", "plugin", "origin", "element"], { call: true })),
|
|
95
95
|
"agent.offer": engine(station("skip", "grace", ["agent", "provider"])),
|
|
96
|
-
"agent.spawn": engine(station("refuse_until_run", "immediate", AGENT_SPAWN_PINNED)),
|
|
96
|
+
"agent.spawn": engine(station("refuse_until_run", "immediate", AGENT_SPAWN_PINNED, { call: true })),
|
|
97
97
|
"prompt.submit": engine(),
|
|
98
98
|
"prompt.fill": surface(station("skip", "grace", ["origin", "mode"], { call: true })),
|
|
99
99
|
"prompt.suggest": surface(station("skip", "grace", ["origin"], { call: true })),
|
|
@@ -114,10 +114,10 @@ export const MOD_EVENT_TABLE = Object.freeze({
|
|
|
114
114
|
"skill.prompt": engine(),
|
|
115
115
|
"attribution.text": engine(),
|
|
116
116
|
"session.start": engine(),
|
|
117
|
-
"session.receive": engine(),
|
|
118
|
-
"session.append": engine(),
|
|
119
|
-
"session.send": engine(),
|
|
120
|
-
"session.compact": engine(),
|
|
117
|
+
"session.receive": engine(station("refuse", "immediate", ["origin", "event", "agentId"])),
|
|
118
|
+
"session.append": engine(station("skip", "grace", ["door", "origin", "agentId"], { call: true })),
|
|
119
|
+
"session.send": engine(station("refuse_until_run", "immediate", ["origin", "agentId", "to", "text"], { call: true })),
|
|
120
|
+
"session.compact": engine(station("refuse_until_run", "immediate", ["trigger", "agentId", "instructions"], { call: true })),
|
|
121
121
|
"session.attach": engine(),
|
|
122
122
|
"session.detach": engine(),
|
|
123
123
|
"session.measure": engine(),
|
|
@@ -23,6 +23,9 @@ export interface ModOrigin {
|
|
|
23
23
|
}
|
|
24
24
|
/** The engine's own origin; its `plugin` word is reserved (no registration may take it). */
|
|
25
25
|
export declare const ENGINE_ORIGIN: ModOrigin;
|
|
26
|
+
/** The form of a registration name: 1–64 of letters, digits, `.`, `_`, `:` and `-` (`:` is the separator of the `skill:<name>` spelling a skill's registrations use). The one rule — a name reaches sentences a person or
|
|
27
|
+
* a model reads (`extension "<name>"`), so a name that could quote, bracket or fold a sentence is refused where it enters. */
|
|
28
|
+
export declare const MOD_REGISTRATION_NAME: RegExp;
|
|
26
29
|
/** The extension a refusal names: the registration's own name — never the engine's origin word (a raise the engine could not run
|
|
27
30
|
* names no extension), never an absent one. The one reading of "who refused" for every station that refuses a call at the hook
|
|
28
31
|
* layer (`GateDisposition.extension`). Module-level: not part of the kernel's entry. */
|
|
@@ -3,6 +3,7 @@ import { resolveModBudgetMs } from "./budget.js";
|
|
|
3
3
|
export const MODS_INVALID_CODE = "config.mods_invalid";
|
|
4
4
|
export const MODS_REGISTRATION_REFUSED_CODE = "mods.registration_refused";
|
|
5
5
|
export const ENGINE_ORIGIN = Object.freeze({ plugin: "engine", tier: "core" });
|
|
6
|
+
export const MOD_REGISTRATION_NAME = /^[A-Za-z0-9._:-]{1,64}$/;
|
|
6
7
|
export function namedRegistration(registration) {
|
|
7
8
|
return registration === undefined || registration === ENGINE_ORIGIN.plugin ? undefined : registration;
|
|
8
9
|
}
|
|
@@ -37,8 +38,12 @@ function screenOne(item, seat, side, report) {
|
|
|
37
38
|
if (!isRegistration(item))
|
|
38
39
|
throw modsInvalid(`a ${seat} mods entry is ${describe(item)}; a registration has a name and a register function`);
|
|
39
40
|
const name = item.name;
|
|
41
|
+
if (typeof name !== "string")
|
|
42
|
+
throw modsInvalid(`a ${seat} registration's name is ${describe(name)}; a registration name is a string`);
|
|
40
43
|
if (name === "")
|
|
41
44
|
throw modsInvalid(`a ${seat} registration has an empty name`);
|
|
45
|
+
if (!MOD_REGISTRATION_NAME.test(name))
|
|
46
|
+
throw modsInvalid(`a ${seat} registration's name (${name.length} characters) is outside the form of a registration name — 1 to 64 of letters, digits, ".", "_", ":" and "-"`);
|
|
42
47
|
if (name === ENGINE_ORIGIN.plugin)
|
|
43
48
|
throw modsInvalid(`a ${seat} registration is named "${name}", the engine's own origin word — choose another name`);
|
|
44
49
|
const tier = tierOf(item.tier, seat, name);
|
|
@@ -74,6 +74,9 @@ export interface PinnedKeyBreak {
|
|
|
74
74
|
* ({@link sameModValue}): the engine's own fact handed on as is, or a copy of it, is not a change.
|
|
75
75
|
*/
|
|
76
76
|
export declare function pinnedKeyChanged(pinned: readonly string[], received: ModEventPayload, passed: ModEventPayload): PinnedKeyBreak | undefined;
|
|
77
|
+
/** Whether `b` is the same data as `a`, by the one comparison a pinned key is judged by ({@link sameModValue}): a copy is the
|
|
78
|
+
* value it copies. A pair the walk cannot finish (past the depth bound, or a read that throws) is not proven the same. */
|
|
79
|
+
export declare function sameModData(a: unknown, b: unknown): boolean;
|
|
77
80
|
/** {@link engineObjects} of a dispatch's own event, found the first time it is asked and the same set every time after:
|
|
78
81
|
* the event is frozen, so one finding serves every receipt of the dispatch. */
|
|
79
82
|
export declare function engineObjectsOnce(held: ModEventPayload): () => ReadonlySet<object>;
|
|
@@ -109,9 +112,9 @@ export declare function pinnedHandOn(pinned: readonly string[], held: ModEventPa
|
|
|
109
112
|
};
|
|
110
113
|
/** Why a handler's answer breaks the site, or undefined. No answer at all is never an answer. */
|
|
111
114
|
export declare function answerViolation(answer: unknown, check: ModAnswerCheck | undefined, e: ModEventPayload, by: ModAnswerer, below: readonly unknown[], run: ModDispatchRun): string | undefined;
|
|
112
|
-
/** A station's reading of what a handler hands on: its sentence, or undefined (no check, or the
|
|
113
|
-
* throws is a sentence too — the station could not read the payload, so it is not handed on. */
|
|
114
|
-
export declare function handOnViolation(payload: ModEventPayload, check: ((payload: ModEventPayload) => string | undefined) | undefined): string | undefined;
|
|
115
|
+
/** A station's reading of what a handler hands on (and of who hands it on): its sentence, or undefined (no check, or the
|
|
116
|
+
* payload passes). A check that throws is a sentence too — the station could not read the payload, so it is not handed on. */
|
|
117
|
+
export declare function handOnViolation(payload: ModEventPayload, check: ((payload: ModEventPayload, by: ModAnswerer) => string | undefined) | undefined, by: ModAnswerer): string | undefined;
|
|
115
118
|
/**
|
|
116
119
|
* A `$` method's answer form: `{ value }` (the call's result) or `{ deny }` (the call throws). A `{ deny }` given after
|
|
117
120
|
* the handler's `next` was answered with something that is not a deny — or while that `next` is still running — breaks
|
|
@@ -81,6 +81,14 @@ export function pinnedKeyChanged(pinned, received, passed) {
|
|
|
81
81
|
const compared = comparePinned(pinned, received, passed);
|
|
82
82
|
return "broke" in compared ? compared.broke : undefined;
|
|
83
83
|
}
|
|
84
|
+
export function sameModData(a, b) {
|
|
85
|
+
try {
|
|
86
|
+
return sameModValue(a, b, new Map(), 1, new Map()) !== false;
|
|
87
|
+
}
|
|
88
|
+
catch {
|
|
89
|
+
return false;
|
|
90
|
+
}
|
|
91
|
+
}
|
|
84
92
|
function comparePinned(pinned, received, passed) {
|
|
85
93
|
const paired = new Map();
|
|
86
94
|
const homes = new Map();
|
|
@@ -203,11 +211,11 @@ export function answerViolation(answer, check, e, by, below, run) {
|
|
|
203
211
|
return "returned an answer the station cannot read";
|
|
204
212
|
}
|
|
205
213
|
}
|
|
206
|
-
export function handOnViolation(payload, check) {
|
|
214
|
+
export function handOnViolation(payload, check, by) {
|
|
207
215
|
if (check === undefined)
|
|
208
216
|
return undefined;
|
|
209
217
|
try {
|
|
210
|
-
return check(payload);
|
|
218
|
+
return check(payload, by);
|
|
211
219
|
}
|
|
212
220
|
catch {
|
|
213
221
|
return "handed on an event the station cannot read";
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The `session.append` station, and the one seat every conversation row passes on its way in ({@link RowSeat}).
|
|
3
|
+
*
|
|
4
|
+
* THE RULE. A row enters the conversation at one point: its first commit point, before the live context reads it again and
|
|
5
|
+
* before the store keeps it. Every writer calls the seat there, once — the harness for the rows it commits (a row the loop
|
|
6
|
+
* ends, the record of an API failure, a row handed to its port), every direct writer of the leg through
|
|
7
|
+
* `appendAdmittedRow` (`row-admission.ts`). With a handler on `session.append` the seat raises the event once per row; with none, or before
|
|
8
|
+
* the leg's bus is bound, the row passes as made and nothing is raised.
|
|
9
|
+
*
|
|
10
|
+
* `e = { door, origin, agentId?, message }` plus the identity envelope; `door`, `origin` and `agentId` are pinned. `door` and
|
|
11
|
+
* `origin` are read off the row's own typed facts ({@link doorOf}, {@link originOf}) — no writer names them; an extension's
|
|
12
|
+
* own note (raised through `$.session.append`) is door `note`, origin `{ kind: "plugin", name }`. `message` is a frozen data
|
|
13
|
+
* view of the row: its role, the members that name it, and its content.
|
|
14
|
+
*
|
|
15
|
+
* A handler answers:
|
|
16
|
+
* - `next(e)` — the row is kept as made; what comes up is `{ message }`, the row as kept;
|
|
17
|
+
* - `next({ ...e, message })` — the row is kept with its content rewritten: only text changes (a text block's text, or a
|
|
18
|
+
* string content); every other block stays, the same blocks in the same order, and every member beside `content` is
|
|
19
|
+
* pinned. The rewrite is made on the row itself, in place — the same object, so every account kept by identity (the
|
|
20
|
+
* live context, a frame's settlement, the prompt's receipt) settles on it — and the row records who rewrote it
|
|
21
|
+
* (`rewrittenBy`). A rewrite that changes a pinned part, or of a row whose content another reader holds by its exact text
|
|
22
|
+
* (a row the engine composed its frames into, an attachment's row), is not kept: the row is kept as made, and the leg's
|
|
23
|
+
* report sink says so (the reference's form: `appendCoreOf` (cli309.js:296238));
|
|
24
|
+
* - `{ deny: <reason> }` — only before `next`, only of an extension's own note: the note is not kept.
|
|
25
|
+
* The answer is the row as kept: what `next` answered, or a copy of it. Anything else is a violation (the reference's
|
|
26
|
+
* sentences: `Nu` (cli309.js:255554)). A handler may not change `message.role`, nor the members that name the row.
|
|
27
|
+
*
|
|
28
|
+
* A failure skips the handler (the table's column): before `next`, what is below it runs in its place, so the row is kept as
|
|
29
|
+
* made; after it, the row as kept stands. No row is dropped and none is kept twice: an engine row cannot be refused, an
|
|
30
|
+
* extension's own note only by a deny before `next` (a note whose handler failed is kept — the reference refuses it:
|
|
31
|
+
* `ee` (cli309.js:256939)). An engine fault of the dispatch keeps the row as made and is said on the report sink.
|
|
32
|
+
*
|
|
33
|
+
* `$.session.append({ message: { role: "user", content }, agentId? })` is the event called ({@link createSessionAppendEntry}):
|
|
34
|
+
* the leg's harness takes the note through its own port, the seat raises it here under the caller's frames and origin, and
|
|
35
|
+
* the call answers `{ message }` (the note as admitted) or `{ deny: <reason> }` (returned, not thrown): the note is in the
|
|
36
|
+
* conversation the leg goes on with — stored by the port (`AgentHarness.appendMessage`), or carried by a durable park's row
|
|
37
|
+
* (`heldRows`); once the park is taken, or may have been, the call throws `$.session.append: refused: …`.
|
|
38
|
+
*/
|
|
39
|
+
import type { AgentMessage, RowAdmission, RowRaising } from "../../internal/harness-types.js";
|
|
40
|
+
import type { AgentHarness } from "../../internal/harness.js";
|
|
41
|
+
import { type FrameSettlement } from "../frame-settlement.js";
|
|
42
|
+
import type { HookInvocationIdentity } from "../hooks.js";
|
|
43
|
+
import type { ModBottomContext, ModCallEntry } from "./kernel/index.js";
|
|
44
|
+
import { type LegModBus } from "./stations.js";
|
|
45
|
+
/** Where a row comes in: read off the row ({@link doorOf}); an extension's own note is `note`. The doors the leg's commit
|
|
46
|
+
* points produce — a compaction's summary is kept as its own entry, not a conversation row, and the engine writes no
|
|
47
|
+
* command row. */
|
|
48
|
+
export declare const SESSION_APPEND_DOORS: readonly ["prompt", "note", "delivery", "attachment", "response", "tool-result"];
|
|
49
|
+
export type SessionAppendDoor = (typeof SESSION_APPEND_DOORS)[number];
|
|
50
|
+
/** Who made a row: read off the row ({@link originOf}); an extension's own note is `plugin`. */
|
|
51
|
+
export declare const SESSION_APPEND_ORIGIN_KINDS: readonly ["host", "engine", "model", "tool", "plugin"];
|
|
52
|
+
export type SessionAppendOrigin = {
|
|
53
|
+
readonly kind: "host";
|
|
54
|
+
} | {
|
|
55
|
+
readonly kind: "engine";
|
|
56
|
+
} | {
|
|
57
|
+
readonly kind: "model";
|
|
58
|
+
readonly model: string;
|
|
59
|
+
} | {
|
|
60
|
+
readonly kind: "tool";
|
|
61
|
+
readonly tool: string;
|
|
62
|
+
} | {
|
|
63
|
+
readonly kind: "plugin";
|
|
64
|
+
readonly name: string;
|
|
65
|
+
};
|
|
66
|
+
/** A row's door, from its typed facts: a person's (or the host's) input is a `prompt`; what the engine adds for the model to
|
|
67
|
+
* read is a `note` (a user-lane note, or a row of its own kind), a `delivery` (a frame with its delivery key) or an
|
|
68
|
+
* `attachment`; the model's turn is a `response`, a tool's answer a `tool-result`. */
|
|
69
|
+
export declare function doorOf(row: AgentMessage): SessionAppendDoor;
|
|
70
|
+
/** A row's maker, from its typed facts: the model, the tool that answered, the host (a prompt, an attachment the host
|
|
71
|
+
* declared), else the engine. */
|
|
72
|
+
export declare function originOf(row: AgentMessage): SessionAppendOrigin;
|
|
73
|
+
/** What the leg binds the seat to once its bus is admitted. */
|
|
74
|
+
export interface RowSeatBinding {
|
|
75
|
+
readonly bus: LegModBus;
|
|
76
|
+
readonly identity: HookInvocationIdentity | undefined;
|
|
77
|
+
/** The leg's report sink (handler failures and the seat's own disclosures). */
|
|
78
|
+
readonly report: (err: Error) => void;
|
|
79
|
+
/** The leg's settlement seam: a tool result an extension rewrote is a host-side decision of what the model reads
|
|
80
|
+
* (`noteHostRewrite`), so a frame the rewrite took out is withheld by the host side, never owed again. */
|
|
81
|
+
readonly frameSettlement?: FrameSettlement;
|
|
82
|
+
}
|
|
83
|
+
/** What became of an extension's own note: kept (the answer its call returns), refused by a deny, or cancelled with its call. */
|
|
84
|
+
export type RaisedRowOutcome = {
|
|
85
|
+
readonly kind: "kept";
|
|
86
|
+
readonly answer: object;
|
|
87
|
+
} | {
|
|
88
|
+
readonly kind: "denied";
|
|
89
|
+
readonly reason: string;
|
|
90
|
+
} | {
|
|
91
|
+
readonly kind: "cancelled";
|
|
92
|
+
};
|
|
93
|
+
/** The leg's one admission seat. */
|
|
94
|
+
export interface RowSeat {
|
|
95
|
+
/** What every writer calls at a row's first commit point (`AgentHarnessOptions.admitRows`). */
|
|
96
|
+
readonly admitRows: RowAdmission;
|
|
97
|
+
/** Bind the leg's bus. Until then every row passes as made. */
|
|
98
|
+
bind(binding: RowSeatBinding): void;
|
|
99
|
+
/** The token an extension's own note is handed to the harness with: its dispatch runs under `ctx` (the `$` call's frames,
|
|
100
|
+
* origin and signal). Known by identity; a token this seat did not mint is no raising. */
|
|
101
|
+
raise(ctx: ModBottomContext): RowRaising;
|
|
102
|
+
/** What became of the note a token was handed with — once the seat has admitted it. */
|
|
103
|
+
outcomeOf(raising: RowRaising): RaisedRowOutcome | undefined;
|
|
104
|
+
}
|
|
105
|
+
/** A leg's admission seat (see the module header). */
|
|
106
|
+
export declare function createRowSeat(): RowSeat;
|
|
107
|
+
/** What the host entry reaches: the leg's seat, its harness's port, the leg's `agentId` (a delegated leg's), its clock. */
|
|
108
|
+
export interface SessionAppendEntryInput {
|
|
109
|
+
readonly seat: RowSeat;
|
|
110
|
+
readonly harness: Pick<AgentHarness, "appendMessage">;
|
|
111
|
+
readonly agentId: string | undefined;
|
|
112
|
+
readonly now: () => number;
|
|
113
|
+
}
|
|
114
|
+
/** `$.session.append`'s host entry: an extension's own note, through the harness's port and this station (the module header). */
|
|
115
|
+
export declare function createSessionAppendEntry(input: SessionAppendEntryInput): ModCallEntry;
|