typeclaw 0.48.13 → 0.50.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/dist/types/agent/attention-escalation.d.ts +18 -0
- package/dist/types/agent/auth.d.ts +7 -0
- package/dist/types/agent/compaction.d.ts +8 -0
- package/dist/types/agent/git-nudge.d.ts +6 -0
- package/dist/types/agent/guard-types.d.ts +25 -0
- package/dist/types/agent/guards.d.ts +7 -0
- package/dist/types/agent/idle-compaction.d.ts +7 -0
- package/dist/types/agent/index.d.ts +163 -0
- package/dist/types/agent/live-subagents.d.ts +113 -0
- package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
- package/dist/types/agent/loop-guard.d.ts +67 -0
- package/dist/types/agent/model-fallback.d.ts +29 -0
- package/dist/types/agent/model-overrides.d.ts +8 -0
- package/dist/types/agent/multimodal/index.d.ts +2 -0
- package/dist/types/agent/multimodal/look-at.d.ts +60 -0
- package/dist/types/agent/multimodal/looker.d.ts +61 -0
- package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
- package/dist/types/agent/network/response-body.d.ts +1 -0
- package/dist/types/agent/network/safe-http.d.ts +46 -0
- package/dist/types/agent/plugin-tools.d.ts +129 -0
- package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
- package/dist/types/agent/prompt-cache-key.d.ts +3 -0
- package/dist/types/agent/provider-error.d.ts +23 -0
- package/dist/types/agent/reload-tool.d.ts +10 -0
- package/dist/types/agent/restart/index.d.ts +31 -0
- package/dist/types/agent/restart-handoff/index.d.ts +32 -0
- package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
- package/dist/types/agent/retry-same-ref.d.ts +41 -0
- package/dist/types/agent/reviewer-activity.d.ts +3 -0
- package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
- package/dist/types/agent/self.d.ts +1 -0
- package/dist/types/agent/session-meta.d.ts +28 -0
- package/dist/types/agent/session-origin.d.ts +65 -0
- package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
- package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
- package/dist/types/agent/subagent-drain.d.ts +25 -0
- package/dist/types/agent/subagent-session.d.ts +3 -0
- package/dist/types/agent/subagents.d.ts +153 -0
- package/dist/types/agent/system-prompt.d.ts +7 -0
- package/dist/types/agent/throttle-circuit.d.ts +25 -0
- package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
- package/dist/types/agent/todo/continuation-state.d.ts +11 -0
- package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
- package/dist/types/agent/todo/continuation.d.ts +21 -0
- package/dist/types/agent/todo/scope.d.ts +6 -0
- package/dist/types/agent/todo/store.d.ts +16 -0
- package/dist/types/agent/tool-error-remediation.d.ts +1 -0
- package/dist/types/agent/tool-file-safety.d.ts +78 -0
- package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
- package/dist/types/agent/tool-result-budget.d.ts +15 -0
- package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
- package/dist/types/agent/tools/channel-edit.d.ts +19 -0
- package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
- package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
- package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
- package/dist/types/agent/tools/channel-history.d.ts +25 -0
- package/dist/types/agent/tools/channel-log.d.ts +5 -0
- package/dist/types/agent/tools/channel-react.d.ts +23 -0
- package/dist/types/agent/tools/channel-read.d.ts +27 -0
- package/dist/types/agent/tools/channel-reply.d.ts +47 -0
- package/dist/types/agent/tools/channel-send.d.ts +42 -0
- package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
- package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
- package/dist/types/agent/tools/ddg.d.ts +18 -0
- package/dist/types/agent/tools/grant-role.d.ts +25 -0
- package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
- package/dist/types/agent/tools/post-github-review.d.ts +38 -0
- package/dist/types/agent/tools/restart.d.ts +25 -0
- package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
- package/dist/types/agent/tools/search-retry.d.ts +16 -0
- package/dist/types/agent/tools/skip-response.d.ts +17 -0
- package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
- package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
- package/dist/types/agent/tools/subagent-access.d.ts +20 -0
- package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
- package/dist/types/agent/tools/subagent-output.d.ts +50 -0
- package/dist/types/agent/tools/todo/index.d.ts +14 -0
- package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
- package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
- package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
- package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
- package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
- package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
- package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
- package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
- package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
- package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
- package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
- package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
- package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
- package/dist/types/agent/tools/websearch.d.ts +17 -0
- package/dist/types/agent/tools/wikipedia.d.ts +7 -0
- package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
- package/dist/types/agent/turn-runner.d.ts +36 -0
- package/dist/types/agent-messenger/config-dir.d.ts +19 -0
- package/dist/types/browser/dockerfile.d.ts +2 -0
- package/dist/types/browser/registry.d.ts +49 -0
- package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
- package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
- package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
- package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
- package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
- package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
- package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
- package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
- package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
- package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
- package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
- package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
- package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
- package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
- package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
- package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
- package/dist/types/channels/adapter-namespace.d.ts +2 -0
- package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
- package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
- package/dist/types/channels/background-handoff.d.ts +56 -0
- package/dist/types/channels/background-obligations.d.ts +135 -0
- package/dist/types/channels/catch-up.d.ts +26 -0
- package/dist/types/channels/commands.d.ts +2 -0
- package/dist/types/channels/completion-claim.d.ts +20 -0
- package/dist/types/channels/continuation-willingness.d.ts +1 -0
- package/dist/types/channels/continuity-types.d.ts +75 -0
- package/dist/types/channels/describe-error.d.ts +1 -0
- package/dist/types/channels/engagement.d.ts +34 -0
- package/dist/types/channels/github-false-receipt.d.ts +20 -0
- package/dist/types/channels/github-repo.d.ts +2 -0
- package/dist/types/channels/github-rereview-guard.d.ts +24 -0
- package/dist/types/channels/github-review-check.d.ts +135 -0
- package/dist/types/channels/github-review-claim.d.ts +3 -0
- package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
- package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
- package/dist/types/channels/github-token-bridge.d.ts +20 -0
- package/dist/types/channels/github-verdict-activity.d.ts +12 -0
- package/dist/types/channels/inbound-journal.d.ts +272 -0
- package/dist/types/channels/last-alive.d.ts +3 -0
- package/dist/types/channels/membership-cache.d.ts +27 -0
- package/dist/types/channels/membership.d.ts +21 -0
- package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
- package/dist/types/channels/participants.d.ts +4 -0
- package/dist/types/channels/persistence.d.ts +32 -0
- package/dist/types/channels/recovery-notice.d.ts +26 -0
- package/dist/types/channels/recovery-outbox.d.ts +58 -0
- package/dist/types/channels/router.d.ts +798 -0
- package/dist/types/channels/schema.d.ts +501 -0
- package/dist/types/channels/session-handoff.d.ts +58 -0
- package/dist/types/channels/session-search.d.ts +29 -0
- package/dist/types/channels/types.d.ts +414 -0
- package/dist/types/channels/waiting-reactions.d.ts +25 -0
- package/dist/types/cli/builtins.d.ts +2 -0
- package/dist/types/cli/command-meta.d.ts +9 -0
- package/dist/types/coding-agent/broker-body.d.ts +7 -0
- package/dist/types/coding-agent/broker.d.ts +22 -0
- package/dist/types/coding-agent/claude.d.ts +22 -0
- package/dist/types/coding-agent/codex.d.ts +19 -0
- package/dist/types/coding-agent/index.d.ts +71 -0
- package/dist/types/coding-agent/omo-state.d.ts +2 -0
- package/dist/types/coding-agent/omo-stream.d.ts +22 -0
- package/dist/types/coding-agent/omo.d.ts +133 -0
- package/dist/types/coding-agent/runner.d.ts +35 -0
- package/dist/types/coding-agent/tool.d.ts +27 -0
- package/dist/types/coding-agent/worktree.d.ts +22 -0
- package/dist/types/commands/index.d.ts +45 -0
- package/dist/types/config/config.d.ts +814 -0
- package/dist/types/config/index.d.ts +3 -0
- package/dist/types/config/model-overrides.d.ts +3 -0
- package/dist/types/config/providers.d.ts +1456 -0
- package/dist/types/config/reloadable.d.ts +9 -0
- package/dist/types/container/agent-operation-lock.d.ts +31 -0
- package/dist/types/container/build-cache.d.ts +39 -0
- package/dist/types/container/compose-project.d.ts +1 -0
- package/dist/types/container/controller.d.ts +25 -0
- package/dist/types/container/docker-app.d.ts +23 -0
- package/dist/types/container/exit-reason.d.ts +10 -0
- package/dist/types/container/index.d.ts +14 -0
- package/dist/types/container/log-archive.d.ts +68 -0
- package/dist/types/container/log-colors.d.ts +3 -0
- package/dist/types/container/log-timestamps.d.ts +9 -0
- package/dist/types/container/logs.d.ts +37 -0
- package/dist/types/container/memory-limit.d.ts +13 -0
- package/dist/types/container/memory-oversubscription.d.ts +20 -0
- package/dist/types/container/oom-events.d.ts +18 -0
- package/dist/types/container/port.d.ts +18 -0
- package/dist/types/container/require-running.d.ts +16 -0
- package/dist/types/container/restart.d.ts +32 -0
- package/dist/types/container/shared.d.ts +93 -0
- package/dist/types/container/shell.d.ts +35 -0
- package/dist/types/container/start.d.ts +144 -0
- package/dist/types/container/stats.d.ts +31 -0
- package/dist/types/container/status.d.ts +25 -0
- package/dist/types/container/stop.d.ts +24 -0
- package/dist/types/container/tool-oom-priority.d.ts +4 -0
- package/dist/types/container/verify-running.d.ts +49 -0
- package/dist/types/cron/consumer.d.ts +42 -0
- package/dist/types/cron/count-state.d.ts +24 -0
- package/dist/types/cron/index.d.ts +21 -0
- package/dist/types/cron/list.d.ts +33 -0
- package/dist/types/cron/reloadable.d.ts +11 -0
- package/dist/types/cron/scheduler.d.ts +51 -0
- package/dist/types/cron/schema.d.ts +108 -0
- package/dist/types/dependencies/bin-resolver.d.ts +28 -0
- package/dist/types/dependencies/bins.d.ts +22 -0
- package/dist/types/dependencies/index.d.ts +2 -0
- package/dist/types/git/bound-gc-config.d.ts +4 -0
- package/dist/types/git/hookless.d.ts +1 -0
- package/dist/types/git/reconcile-ignored.d.ts +13 -0
- package/dist/types/git/resolve-agent-git.d.ts +8 -0
- package/dist/types/git/resolve-identity.d.ts +10 -0
- package/dist/types/git/run.d.ts +24 -0
- package/dist/types/git/system-commit.d.ts +2 -0
- package/dist/types/hostd/client.d.ts +13 -0
- package/dist/types/hostd/models.d.ts +1 -0
- package/dist/types/hostd/paths.d.ts +17 -0
- package/dist/types/hostd/protocol.d.ts +93 -0
- package/dist/types/hostd/spawn.d.ts +17 -0
- package/dist/types/hostd/version.d.ts +18 -0
- package/dist/types/init/auto-upgrade.d.ts +41 -0
- package/dist/types/init/cli-version.d.ts +7 -0
- package/dist/types/init/dockerfile.d.ts +34 -0
- package/dist/types/init/ensure-deps.d.ts +17 -0
- package/dist/types/init/env-file.d.ts +3 -0
- package/dist/types/init/gitignore.d.ts +5 -0
- package/dist/types/init/local-source-stamp.d.ts +3 -0
- package/dist/types/init/packagejson.d.ts +7 -0
- package/dist/types/init/paths.d.ts +3 -0
- package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
- package/dist/types/init/run-bun-install.d.ts +16 -0
- package/dist/types/init/windows-dev-link.d.ts +8 -0
- package/dist/types/mcp/catalog.d.ts +7 -0
- package/dist/types/mcp/client.d.ts +58 -0
- package/dist/types/mcp/manager.d.ts +56 -0
- package/dist/types/mcp/tools.d.ts +23 -0
- package/dist/types/models/embedding-model.d.ts +20 -0
- package/dist/types/models/transformers-version.d.ts +1 -0
- package/dist/types/network/internal-destinations.d.ts +29 -0
- package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
- package/dist/types/operations/incidents.d.ts +47 -0
- package/dist/types/operations/index.d.ts +3 -0
- package/dist/types/operations/remediations.d.ts +25 -0
- package/dist/types/path-safety/real-intended-path.d.ts +9 -0
- package/dist/types/permissions/builtins.d.ts +25 -0
- package/dist/types/permissions/grant.d.ts +19 -0
- package/dist/types/permissions/index.d.ts +6 -0
- package/dist/types/permissions/match-rule.d.ts +28 -0
- package/dist/types/permissions/permissions.d.ts +42 -0
- package/dist/types/permissions/resolve.d.ts +25 -0
- package/dist/types/permissions/schema.d.ts +14 -0
- package/dist/types/plugin/context.d.ts +20 -0
- package/dist/types/plugin/core-tool-names.d.ts +4 -0
- package/dist/types/plugin/define.d.ts +46 -0
- package/dist/types/plugin/hooks.d.ts +52 -0
- package/dist/types/plugin/index.d.ts +11 -0
- package/dist/types/plugin/load-skill.d.ts +14 -0
- package/dist/types/plugin/loader.d.ts +25 -0
- package/dist/types/plugin/manager.d.ts +42 -0
- package/dist/types/plugin/registry.d.ts +73 -0
- package/dist/types/plugin/skills.d.ts +11 -0
- package/dist/types/plugin/types.d.ts +336 -0
- package/dist/types/plugin/zod-introspect.d.ts +11 -0
- package/dist/types/reload/client.d.ts +11 -0
- package/dist/types/reload/docker-exec-client.d.ts +11 -0
- package/dist/types/reload/format.d.ts +2 -0
- package/dist/types/reload/index.d.ts +6 -0
- package/dist/types/reload/recover.d.ts +22 -0
- package/dist/types/reload/registry.d.ts +10 -0
- package/dist/types/reload/types.d.ts +25 -0
- package/dist/types/role-claim/client.d.ts +20 -0
- package/dist/types/role-claim/code.d.ts +4 -0
- package/dist/types/role-claim/controller.d.ts +59 -0
- package/dist/types/role-claim/index.d.ts +6 -0
- package/dist/types/role-claim/match-rule.d.ts +9 -0
- package/dist/types/role-claim/pending.d.ts +35 -0
- package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
- package/dist/types/run/llm-fetch-observer.d.ts +50 -0
- package/dist/types/sandbox/availability.d.ts +21 -0
- package/dist/types/sandbox/build.d.ts +7 -0
- package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
- package/dist/types/sandbox/coding-agent.d.ts +20 -0
- package/dist/types/sandbox/dependency-bins.d.ts +19 -0
- package/dist/types/sandbox/dev-source.d.ts +4 -0
- package/dist/types/sandbox/env-exposure.d.ts +1 -0
- package/dist/types/sandbox/errors.d.ts +20 -0
- package/dist/types/sandbox/hidden-paths.d.ts +11 -0
- package/dist/types/sandbox/index.d.ts +14 -0
- package/dist/types/sandbox/package-install.d.ts +1 -0
- package/dist/types/sandbox/policy.d.ts +71 -0
- package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
- package/dist/types/sandbox/quote.d.ts +2 -0
- package/dist/types/sandbox/runtime-private.d.ts +1 -0
- package/dist/types/sandbox/session-tmp.d.ts +6 -0
- package/dist/types/sandbox/symlinks.d.ts +6 -0
- package/dist/types/sandbox/writable-zones.d.ts +15 -0
- package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
- package/dist/types/secrets/defaults.d.ts +21 -0
- package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
- package/dist/types/secrets/hydrate.d.ts +7 -0
- package/dist/types/secrets/index.d.ts +7 -0
- package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
- package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
- package/dist/types/secrets/resolve.d.ts +14 -0
- package/dist/types/secrets/schema.d.ts +840 -0
- package/dist/types/secrets/storage.d.ts +56 -0
- package/dist/types/shared/host-locale.d.ts +1 -0
- package/dist/types/shared/index.d.ts +5 -0
- package/dist/types/shared/local-time.d.ts +4 -0
- package/dist/types/shared/platform.d.ts +2 -0
- package/dist/types/shared/protocol.d.ts +424 -0
- package/dist/types/shared/style-text.d.ts +3 -0
- package/dist/types/shared/wsl.d.ts +17 -0
- package/dist/types/stream/broker.d.ts +2 -0
- package/dist/types/stream/index.d.ts +2 -0
- package/dist/types/stream/types.d.ts +71 -0
- package/package.json +13 -6
- package/scripts/build-plugin-types.ts +105 -0
- package/scripts/check-plugin-sdk.ts +111 -0
- package/scripts/dump-system-prompt.ts +52 -110
- package/scripts/require-parallel.ts +5 -32
- package/src/agent/guard-types.ts +3 -0
- package/src/agent/guards.ts +4 -0
- package/src/agent/idle-compaction.ts +174 -0
- package/src/agent/index.ts +210 -80
- package/src/agent/live-sessions.ts +2 -2
- package/src/agent/live-subagents.ts +20 -0
- package/src/agent/multimodal/look-at.ts +22 -9
- package/src/agent/plugin-tools.ts +66 -12
- package/src/agent/prompt-cache-key.ts +42 -0
- package/src/agent/provider-error.ts +179 -10
- package/src/agent/restart-handoff/index.ts +7 -14
- package/src/agent/reviewer-activity.ts +68 -0
- package/src/agent/reviewer-bash-policy.ts +41 -1
- package/src/agent/session-origin.ts +58 -9
- package/src/agent/subagent-cache-keepalive.ts +198 -0
- package/src/agent/subagent-session.ts +6 -0
- package/src/agent/subagents.ts +59 -9
- package/src/agent/system-prompt.ts +68 -202
- package/src/agent/todo/continuation-policy.ts +12 -4
- package/src/agent/tool-file-safety.ts +119 -15
- package/src/agent/tool-not-found-nudge.ts +1 -1
- package/src/agent/tools/channel-edit.ts +20 -10
- package/src/agent/tools/channel-fetch-attachment.ts +12 -5
- package/src/agent/tools/channel-handoff.ts +72 -0
- package/src/agent/tools/channel-history-render.ts +2 -1
- package/src/agent/tools/channel-read.ts +57 -10
- package/src/agent/tools/channel-reply.ts +55 -30
- package/src/agent/tools/channel-send.ts +69 -19
- package/src/agent/tools/channel-session-search.ts +35 -0
- package/src/agent/tools/curl-impersonate.ts +22 -6
- package/src/agent/tools/ddg.ts +13 -5
- package/src/agent/tools/post-github-review.ts +77 -15
- package/src/agent/tools/skip-response.ts +2 -2
- package/src/agent/tools/spawn-subagent.ts +190 -23
- package/src/agent/tools/stream-snapshot.ts +15 -2
- package/src/agent/tools/subagent-access.ts +11 -4
- package/src/agent/tools/subagent-output.ts +8 -0
- package/src/browser/bsk-shim.mjs +74 -0
- package/src/browser/dockerfile.ts +84 -0
- package/src/browser/egress.ts +104 -0
- package/src/browser/managed-browser.ts +205 -0
- package/src/browser/registry.ts +110 -0
- package/src/browser/relay.ts +231 -0
- package/src/browser/sandbox-entry.ts +167 -0
- package/src/bundled-plugins/agent-browser/index.ts +2 -0
- package/src/bundled-plugins/backup/README.md +10 -9
- package/src/bundled-plugins/backup/runner.ts +140 -58
- package/src/bundled-plugins/backup/subagents.ts +58 -26
- package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
- package/src/bundled-plugins/browser-agent/index.ts +12 -0
- package/src/bundled-plugins/doc-render/index.ts +0 -10
- package/src/bundled-plugins/doc-render/render.ts +83 -111
- package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
- package/src/bundled-plugins/github-cli-auth/gh-command.ts +38 -2
- package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
- package/src/bundled-plugins/github-cli-auth/granted-push.ts +135 -0
- package/src/bundled-plugins/github-cli-auth/index.ts +158 -70
- package/src/bundled-plugins/github-cli-auth/review-account.ts +23 -0
- package/src/bundled-plugins/github-cli-auth/review-checkout.ts +9 -2
- package/src/bundled-plugins/github-cli-auth/review-recorder.ts +45 -7
- package/src/bundled-plugins/managed-browser/index.ts +74 -0
- package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
- package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
- package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
- package/src/bundled-plugins/operator/operator.ts +15 -4
- package/src/bundled-plugins/qa/index.ts +11 -0
- package/src/bundled-plugins/qa/qa.ts +160 -0
- package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
- package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
- package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
- package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
- package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
- package/src/bundled-plugins/reviewer/skills/code-review.ts +1 -1
- package/src/bundled-plugins/security/index.ts +103 -36
- package/src/bundled-plugins/security/policies/git-exfil.ts +24 -12
- package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
- package/src/channels/adapter-namespace.ts +13 -0
- package/src/channels/adapters/discord-bot-reactions.ts +18 -0
- package/src/channels/adapters/discord-bot.ts +219 -72
- package/src/channels/adapters/discord-reactions.ts +18 -0
- package/src/channels/adapters/discord.ts +114 -8
- package/src/channels/adapters/github/inbound.ts +103 -8
- package/src/channels/adapters/github/index.ts +267 -19
- package/src/channels/adapters/github/last-alive.ts +15 -0
- package/src/channels/adapters/github/outbound.ts +54 -18
- package/src/channels/adapters/github/pending-review-store.ts +141 -0
- package/src/channels/adapters/github/permission-guidance.ts +1 -0
- package/src/channels/adapters/github/reactions.ts +100 -0
- package/src/channels/adapters/github/reconcile-cooldown-store.ts +197 -67
- package/src/channels/adapters/github/reconcile-open-prs.ts +418 -33
- package/src/channels/adapters/github/recovery.ts +106 -0
- package/src/channels/adapters/github/review-check.ts +510 -0
- package/src/channels/adapters/github/review-submitter.ts +34 -2
- package/src/channels/adapters/instagram.ts +32 -14
- package/src/channels/adapters/kakaotalk.ts +22 -7
- package/src/channels/adapters/line.ts +18 -3
- package/src/channels/adapters/outbound-account.ts +20 -0
- package/src/channels/adapters/own-reactions.ts +66 -0
- package/src/channels/adapters/recovery-correlation.ts +214 -0
- package/src/channels/adapters/slack-attachment-download.ts +14 -3
- package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
- package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
- package/src/channels/adapters/slack-bot-classify.ts +19 -11
- package/src/channels/adapters/slack-bot-dedupe.ts +111 -28
- package/src/channels/adapters/slack-bot-reactions.ts +18 -0
- package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
- package/src/channels/adapters/slack-bot.ts +424 -124
- package/src/channels/adapters/slack-classify.ts +26 -4
- package/src/channels/adapters/slack-inbound-revision.ts +96 -0
- package/src/channels/adapters/slack-reactions.ts +18 -0
- package/src/channels/adapters/slack-thread-ts.ts +6 -0
- package/src/channels/adapters/slack.ts +48 -3
- package/src/channels/adapters/teams.ts +14 -4
- package/src/channels/adapters/telegram-bot.ts +56 -10
- package/src/channels/adapters/webex-bot.ts +12 -2
- package/src/channels/adapters/webex.ts +12 -2
- package/src/channels/background-handoff.ts +434 -0
- package/src/channels/background-obligations.ts +893 -0
- package/src/channels/catch-up.ts +137 -0
- package/src/channels/continuation-willingness.ts +2 -2
- package/src/channels/continuity-types.ts +272 -0
- package/src/channels/engagement.ts +17 -1
- package/src/channels/github-false-receipt.ts +3 -3
- package/src/channels/github-rereview-guard.ts +9 -5
- package/src/channels/github-review-check.ts +598 -0
- package/src/channels/github-review-turn-ledger.ts +102 -28
- package/src/channels/github-review-verdict-coordinator.ts +72 -12
- package/src/channels/github-token-bridge.ts +35 -5
- package/src/channels/inbound-journal.ts +1738 -0
- package/src/channels/index.ts +6 -1
- package/src/channels/last-alive.ts +34 -0
- package/src/channels/manager.ts +25 -8
- package/src/channels/recovery-dispatcher.ts +264 -0
- package/src/channels/recovery-notice.ts +94 -0
- package/src/channels/recovery-outbox.ts +459 -0
- package/src/channels/router.ts +2951 -736
- package/src/channels/schema.ts +8 -1
- package/src/channels/session-handoff.fixture.ts +144 -0
- package/src/channels/session-handoff.ts +175 -0
- package/src/channels/session-search.ts +71 -0
- package/src/channels/subagent-completion-bridge.ts +17 -14
- package/src/channels/types.ts +133 -18
- package/src/channels/waiting-reactions.ts +664 -0
- package/src/cli/channel.ts +2 -3
- package/src/cli/compose.ts +7 -4
- package/src/cli/hostd.ts +49 -3
- package/src/cli/init.ts +2 -3
- package/src/cli/inspect.ts +11 -14
- package/src/cli/model.ts +132 -3
- package/src/coding-agent/broker-body.ts +38 -0
- package/src/coding-agent/broker.ts +290 -0
- package/src/coding-agent/claude.ts +95 -0
- package/src/coding-agent/codex.ts +104 -0
- package/src/coding-agent/index.ts +512 -0
- package/src/coding-agent/omo-state.ts +69 -0
- package/src/coding-agent/omo-stream.ts +138 -0
- package/src/coding-agent/omo.ts +192 -0
- package/src/coding-agent/runner.ts +285 -0
- package/src/coding-agent/tool.ts +62 -0
- package/src/coding-agent/worktree.ts +355 -0
- package/src/compose/restart.ts +10 -3
- package/src/compose/start.ts +20 -3
- package/src/config/config.ts +121 -25
- package/src/config/model-overrides.ts +59 -0
- package/src/config/models-mutation.ts +185 -2
- package/src/config/providers-mutation.ts +12 -4
- package/src/config/providers.ts +71 -9
- package/src/container/exit-reason.ts +44 -0
- package/src/container/index.ts +5 -0
- package/src/container/log-archive.ts +51 -13
- package/src/container/memory-limit.ts +1 -1
- package/src/container/memory-oversubscription.ts +36 -6
- package/src/container/oom-events.ts +86 -0
- package/src/container/restart.ts +2 -0
- package/src/container/shared.ts +8 -1
- package/src/container/start.ts +120 -17
- package/src/container/stop.ts +6 -2
- package/src/container/tool-oom-priority.ts +32 -0
- package/src/cron/consumer.ts +10 -4
- package/src/cron/reloadable.ts +23 -2
- package/src/doctor/checks.ts +22 -8
- package/src/hostd/daemon.ts +33 -11
- package/src/hostd/spawn.ts +106 -5
- package/src/hostd/version.ts +20 -0
- package/src/hostd/watchdog.ts +241 -0
- package/src/init/auto-upgrade.ts +7 -1
- package/src/init/dockerfile.ts +112 -602
- package/src/init/index.ts +6 -6
- package/src/init/local-source-stamp.ts +68 -0
- package/src/init/models-dev.ts +4 -0
- package/src/init/validate-api-key.ts +3 -0
- package/src/mcp/client.ts +3 -1
- package/src/operations/classify-tool-outcome.ts +45 -1
- package/src/operations/incidents.ts +10 -5
- package/src/permissions/builtins.ts +7 -0
- package/src/permissions/permissions.ts +18 -9
- package/src/permissions/resolve.ts +7 -1
- package/src/plugin/context.ts +2 -0
- package/src/plugin/core-tool-names.ts +1 -1
- package/src/plugin/define.ts +1 -0
- package/src/plugin/hooks.ts +137 -0
- package/src/plugin/index.ts +7 -0
- package/src/plugin/manager.ts +4 -0
- package/src/plugin/types.ts +66 -1
- package/src/run/background-handoff-boot.ts +86 -0
- package/src/run/bundled-plugins.ts +6 -0
- package/src/run/index.ts +107 -97
- package/src/run/llm-fetch-observer.ts +12 -15
- package/src/run/resource-sample.ts +19 -0
- package/src/sandbox/build.ts +4 -0
- package/src/sandbox/canonical-secrets.ts +4 -0
- package/src/sandbox/coding-agent.ts +214 -0
- package/src/sandbox/dev-source.ts +26 -0
- package/src/sandbox/hidden-paths.ts +16 -2
- package/src/sandbox/policy.ts +1 -0
- package/src/sandbox/runtime-private.ts +4 -1
- package/src/secrets/coding-agent-auth.ts +97 -0
- package/src/secrets/index.ts +0 -16
- package/src/secrets/storage.ts +13 -0
- package/src/server/command-runner.ts +6 -2
- package/src/server/index.ts +101 -40
- package/src/skills/typeclaw-channel-github/SKILL.md +15 -13
- package/src/skills/typeclaw-claude-code/SKILL.md +25 -260
- package/src/skills/typeclaw-claude-code/references/auth-flow.md +7 -23
- package/src/skills/typeclaw-claude-code/references/headless-sessions.md +11 -0
- package/src/skills/typeclaw-claude-code/references/results-and-worktrees.md +13 -0
- package/src/skills/typeclaw-codex-cli/SKILL.md +35 -270
- package/src/skills/typeclaw-codex-cli/references/auth-flow.md +13 -20
- package/src/skills/typeclaw-codex-cli/references/headless-sessions.md +26 -0
- package/src/skills/typeclaw-codex-cli/references/results-and-worktrees.md +28 -0
- package/src/skills/typeclaw-config/SKILL.md +60 -26
- package/src/skills/typeclaw-config/references/dockerfile.md +14 -13
- package/src/skills/typeclaw-cron/SKILL.md +1 -1
- package/src/skills/typeclaw-github-contributing/SKILL.md +3 -3
- package/src/skills/typeclaw-memory/SKILL.md +3 -3
- package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
- package/src/skills/typeclaw-omo-cli/SKILL.md +52 -0
- package/src/skills/typeclaw-omo-cli/references/auth-flow.md +11 -0
- package/src/skills/typeclaw-omo-cli/references/headless-sessions.md +11 -0
- package/src/skills/typeclaw-omo-cli/references/results-and-worktrees.md +23 -0
- package/src/skills/typeclaw-permissions/SKILL.md +7 -7
- package/src/skills/typeclaw-plugins/SKILL.md +15 -15
- package/src/skills/typeclaw-skills/SKILL.md +19 -2
- package/src/skills/typeclaw-troubleshooting/SKILL.md +26 -2
- package/typeclaw.schema.json +448 -6
- package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
- package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
- package/src/secrets/claude-credentials-json.ts +0 -129
- package/src/secrets/codex-auth-json.ts +0 -102
- package/src/secrets/export-claude-credentials-file.ts +0 -270
- package/src/secrets/export-codex-auth-file.ts +0 -250
- package/src/skills/typeclaw-claude-code/references/stop-hook.md +0 -101
- package/src/skills/typeclaw-claude-code/references/tmux-driving.md +0 -243
- package/src/skills/typeclaw-codex-cli/references/stop-hook.md +0 -92
- package/src/skills/typeclaw-codex-cli/references/tmux-driving.md +0 -239
package/src/agent/index.ts
CHANGED
|
@@ -10,8 +10,10 @@ import {
|
|
|
10
10
|
} from '@earendil-works/pi-coding-agent'
|
|
11
11
|
import type { AgentSession, ToolDefinition } from '@earendil-works/pi-coding-agent'
|
|
12
12
|
|
|
13
|
+
import { adapterNamespace } from '@/channels/adapter-namespace'
|
|
13
14
|
import type { ChannelRouter } from '@/channels/router'
|
|
14
15
|
import type { ReactionRef } from '@/channels/types'
|
|
16
|
+
import { createCodingAgentTool } from '@/coding-agent/tool'
|
|
15
17
|
import {
|
|
16
18
|
getConfig,
|
|
17
19
|
resolveModel,
|
|
@@ -20,6 +22,7 @@ import {
|
|
|
20
22
|
type ResolvedProfile,
|
|
21
23
|
type ThinkingLevel,
|
|
22
24
|
} from '@/config'
|
|
25
|
+
import { effectiveModels } from '@/config/model-overrides'
|
|
23
26
|
import { defaultThinkingLevelForRef, isOpenAiFamilyRef, providerForModelRef, type ModelRef } from '@/config/providers'
|
|
24
27
|
import { renderMcpCatalog } from '@/mcp/catalog'
|
|
25
28
|
import type { McpManager } from '@/mcp/manager'
|
|
@@ -27,6 +30,7 @@ import { createMcpDispatcherTools, MCP_DISPATCHER_TOOL_NAMES, resolveMcpCallPref
|
|
|
27
30
|
import { noopPermissionService, type PermissionService, type RolesConfig } from '@/permissions'
|
|
28
31
|
import type {
|
|
29
32
|
BuiltinToolRef,
|
|
33
|
+
ChannelOutboundOrigin,
|
|
30
34
|
HookBus,
|
|
31
35
|
MaterializedSkills,
|
|
32
36
|
PluginRegistry,
|
|
@@ -44,6 +48,7 @@ import { createCompactionSettingsManager } from './compaction'
|
|
|
44
48
|
import { renderGitNudge } from './git-nudge'
|
|
45
49
|
import type { InternalGuard } from './guard-types'
|
|
46
50
|
import { buildInternalGuards } from './guards'
|
|
51
|
+
import { attachIdleCompaction } from './idle-compaction'
|
|
47
52
|
import type { LiveSubagentRegistry } from './live-subagents'
|
|
48
53
|
import { sanitizeMessagesForLlmReplay } from './llm-replay-sanitizer'
|
|
49
54
|
import { applyModelRuntimeOverrides } from './model-overrides'
|
|
@@ -57,16 +62,23 @@ import {
|
|
|
57
62
|
zodToToolParameters,
|
|
58
63
|
} from './plugin-tools'
|
|
59
64
|
import { PROACTIVE_NEXT_STEP_NUDGE } from './proactive-next-step-nudge'
|
|
65
|
+
import { promptCacheKeyForOrigin, withPromptCacheKey } from './prompt-cache-key'
|
|
66
|
+
import { wrapTransformContextWithLocalFailureMarker } from './provider-error'
|
|
60
67
|
import { createReloadTool } from './reload-tool'
|
|
61
68
|
import type { RestartHandoffOrigin } from './restart-handoff'
|
|
62
69
|
import type { SubagentBashPolicy } from './reviewer-bash-policy'
|
|
63
70
|
import { loadSelf } from './self'
|
|
64
71
|
import { SESSION_META_CUSTOM_TYPE, sessionMetaPayload } from './session-meta'
|
|
65
|
-
import {
|
|
72
|
+
import {
|
|
73
|
+
renderInteractiveSessionContext,
|
|
74
|
+
renderSessionOrigin,
|
|
75
|
+
type SessionOrigin,
|
|
76
|
+
type SessionRoleContext,
|
|
77
|
+
} from './session-origin'
|
|
78
|
+
import { SubagentCacheKeepalive } from './subagent-cache-keepalive'
|
|
66
79
|
import type { CreateSessionForSubagent, SubagentCoalescer, SubagentRegistry } from './subagents'
|
|
67
80
|
import {
|
|
68
|
-
|
|
69
|
-
buildSlimSystemPrompt,
|
|
81
|
+
buildSystemPolicy,
|
|
70
82
|
DEFAULT_SUBAGENT_ROSTER,
|
|
71
83
|
renderRuntimeBlock,
|
|
72
84
|
renderRuntimeNondisclosureRule,
|
|
@@ -77,11 +89,13 @@ import { createBudgetState, type ToolResultBudget, wrapToolDefinitionWithBudget
|
|
|
77
89
|
import { createChannelDisengageTool } from './tools/channel-disengage'
|
|
78
90
|
import { createChannelEditTool } from './tools/channel-edit'
|
|
79
91
|
import { createChannelFetchAttachmentTool, resolveInboxBaseDir } from './tools/channel-fetch-attachment'
|
|
92
|
+
import { createChannelHandoffTool } from './tools/channel-handoff'
|
|
80
93
|
import { createChannelHistoryTool } from './tools/channel-history'
|
|
81
94
|
import { createChannelReactTool } from './tools/channel-react'
|
|
82
95
|
import { createChannelReadTool } from './tools/channel-read'
|
|
83
96
|
import { createChannelReplyTool } from './tools/channel-reply'
|
|
84
97
|
import { createChannelSendTool } from './tools/channel-send'
|
|
98
|
+
import { createChannelSessionSearchTool } from './tools/channel-session-search'
|
|
85
99
|
import { createGrantRoleTool } from './tools/grant-role'
|
|
86
100
|
import { createPostGithubReviewTool } from './tools/post-github-review'
|
|
87
101
|
import { createRestartTool } from './tools/restart'
|
|
@@ -138,8 +152,12 @@ export type CreateSessionOptions = {
|
|
|
138
152
|
stream?: Stream
|
|
139
153
|
channelRouter?: ChannelRouter
|
|
140
154
|
mcpManager?: McpManager
|
|
141
|
-
//
|
|
142
|
-
//
|
|
155
|
+
// Replace TypeClaw's standard composition with this string: the shared
|
|
156
|
+
// policy, IDENTITY.md/SOUL.md, the interactive context, and the skill paths
|
|
157
|
+
// TypeClaw adds (bundled, plugin, `.agents/skills/`, `memory/skills/`) are
|
|
158
|
+
// not injected. Runtime metadata and the origin block are still appended,
|
|
159
|
+
// and pi's own default discovery still runs, so project context files such
|
|
160
|
+
// as AGENTS.md still reach the final system message.
|
|
143
161
|
systemPromptOverride?: string
|
|
144
162
|
// Identifies the kind of session and (for channels) its addressing fields.
|
|
145
163
|
// Rendered into the system prompt so the agent knows who's listening, where
|
|
@@ -201,6 +219,9 @@ export type CreateSessionOptions = {
|
|
|
201
219
|
// overrides) so different sessions on the same agent can run different
|
|
202
220
|
// models without per-session config edits.
|
|
203
221
|
profile?: string
|
|
222
|
+
// Thinking level overriding the resolved profile's own. Ignored when `profile`
|
|
223
|
+
// fell back to `default`, so the fallback session keeps `default`'s level.
|
|
224
|
+
thinkingLevel?: ThinkingLevel
|
|
204
225
|
// Override the resolved ref directly, bypassing `profile` resolution. Used
|
|
205
226
|
// by the model-fallback helper (`promptWithFallback`) to recreate a session
|
|
206
227
|
// pinned to the next ref in the chain after the previous one failed. When
|
|
@@ -251,11 +272,16 @@ export type CreateSessionResult = {
|
|
|
251
272
|
// in config.ts), so they arrive here as `resolved.thinkingLevel` — the first term.
|
|
252
273
|
// That is why `deep`'s `high` still beats a lowered global default, and why there
|
|
253
274
|
// is no profile special-casing in this function.
|
|
275
|
+
//
|
|
276
|
+
// `override` (a subagent's declared `thinkingLevel`) wins only when the requested
|
|
277
|
+
// profile actually resolved; a fallback to `default` ignores it.
|
|
254
278
|
export function resolveSessionThinkingLevel(
|
|
255
279
|
models: Models,
|
|
256
|
-
resolved: Pick<ResolvedProfile, 'thinkingLevel' | 'profile'
|
|
280
|
+
resolved: Pick<ResolvedProfile, 'thinkingLevel' | 'profile'> & { fellBackToDefault?: boolean },
|
|
257
281
|
activeRef: ModelRef,
|
|
282
|
+
override?: ThinkingLevel,
|
|
258
283
|
): ThinkingLevel | undefined {
|
|
284
|
+
if (override !== undefined && resolved.fellBackToDefault !== true) return override
|
|
259
285
|
return resolved.thinkingLevel ?? models.default.thinkingLevel ?? defaultThinkingLevelForRef(activeRef)
|
|
260
286
|
}
|
|
261
287
|
|
|
@@ -274,7 +300,10 @@ export function attachLoopGuardTurnTracking(
|
|
|
274
300
|
}
|
|
275
301
|
|
|
276
302
|
export async function createSessionWithDispose(options: CreateSessionOptions = {}): Promise<CreateSessionResult> {
|
|
277
|
-
|
|
303
|
+
// Profiles resolve against the session's effective models: the global block
|
|
304
|
+
// with any `modelOverrides` matching this session's channel layered on top.
|
|
305
|
+
const models = effectiveModels(getConfig(), options.origin)
|
|
306
|
+
const resolved = resolveProfile(models, options.profile)
|
|
278
307
|
// Unknown profiles silently fall back to `default`. The fallback is by design
|
|
279
308
|
// (see `resolveProfile`) and surfacing a warning here just creates noise on
|
|
280
309
|
// every memory-logger / dreaming subagent spawn for advanced users who know
|
|
@@ -329,13 +358,28 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
|
|
|
329
358
|
let loopGuardTurnId = 0
|
|
330
359
|
const getLoopGuardTurn = () => loopGuardTurnId
|
|
331
360
|
const guards = buildInternalGuards(options.plugins?.agentDir ?? process.cwd())
|
|
361
|
+
const codingTool = createCodingAgentTool({
|
|
362
|
+
agentDir: options.plugins?.agentDir ?? process.cwd(),
|
|
363
|
+
sessionId: options.plugins?.sessionId ?? sessionManager.getSessionId(),
|
|
364
|
+
getOrigin,
|
|
365
|
+
permissions: options.permissions ?? noopPermissionService,
|
|
366
|
+
})
|
|
332
367
|
|
|
333
368
|
// Subagent built-in tool refs resolve to `ToolDefinition`s (see
|
|
334
369
|
// plugin-tools.ts). Their NAMES narrow the session via `tools:`; their wrapped
|
|
335
370
|
// implementations arrive through `customTools` (either `builtinPiToolOverrides`
|
|
336
371
|
// for pi coding builtins, or `customSystemTools` for typeclaw web tools).
|
|
337
|
-
const
|
|
338
|
-
|
|
372
|
+
const declaredRefs = options.pluginSubagent?.toolRefs
|
|
373
|
+
const writeCapable =
|
|
374
|
+
declaredRefs?.some((ref) => ref.__builtinTool === 'bash') &&
|
|
375
|
+
declaredRefs.some((ref) => ref.__builtinTool === 'write' || ref.__builtinTool === 'edit') &&
|
|
376
|
+
options.bashPolicy === undefined
|
|
377
|
+
const resolvedSubagentBuiltins = declaredRefs
|
|
378
|
+
? resolveBuiltinToolRefs(
|
|
379
|
+
declaredRefs.filter((ref) => ref.__builtinTool !== 'coding_agent' || writeCapable),
|
|
380
|
+
options.plugins?.agentDir ?? process.cwd(),
|
|
381
|
+
new Map([['coding_agent', codingTool]]),
|
|
382
|
+
)
|
|
339
383
|
: []
|
|
340
384
|
const subagentBuiltinNames = resolvedSubagentBuiltins.map((t) => t.name)
|
|
341
385
|
const subagentTypeclawToolDefinitions = resolvedSubagentBuiltins.filter((t) => !isPiCodingBuiltinName(t.name))
|
|
@@ -413,6 +457,7 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
|
|
|
413
457
|
agentDir: options.plugins?.agentDir,
|
|
414
458
|
parentSessionId: sessionManager.getSessionId(),
|
|
415
459
|
getOrigin,
|
|
460
|
+
getSessionFile: () => sessionManager.getSessionFile(),
|
|
416
461
|
permissions: options.permissions,
|
|
417
462
|
stream: options.stream,
|
|
418
463
|
allowBackgroundFromSubagent: options.allowBackgroundFromSubagent,
|
|
@@ -421,7 +466,10 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
|
|
|
421
466
|
}),
|
|
422
467
|
]
|
|
423
468
|
: [
|
|
424
|
-
...buildCoreSystemTools(options.permissions)
|
|
469
|
+
...buildCoreSystemTools(options.permissions, codingTool).filter(
|
|
470
|
+
(tool) =>
|
|
471
|
+
tool.name !== 'coding_agent' || options.tools === undefined || options.tools.includes('coding_agent'),
|
|
472
|
+
),
|
|
425
473
|
...(options.mcpManager
|
|
426
474
|
? buildMcpDispatcherToolDefinitions(options.mcpManager, {
|
|
427
475
|
permissions: options.permissions,
|
|
@@ -457,6 +505,7 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
|
|
|
457
505
|
agentDir: options.plugins?.agentDir,
|
|
458
506
|
parentSessionId: sessionManager.getSessionId(),
|
|
459
507
|
getOrigin,
|
|
508
|
+
getSessionFile: () => sessionManager.getSessionFile(),
|
|
460
509
|
permissions: options.permissions,
|
|
461
510
|
stream: options.stream,
|
|
462
511
|
coalescer: options.subagentCoalescer,
|
|
@@ -521,7 +570,7 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
|
|
|
521
570
|
const model = applyModelRuntimeOverrides(resolveModel(activeRef), activeRef)
|
|
522
571
|
// Read live so a reloaded `models` lands on the next session without a
|
|
523
572
|
// container restart.
|
|
524
|
-
const thinkingLevel = resolveSessionThinkingLevel(
|
|
573
|
+
const thinkingLevel = resolveSessionThinkingLevel(models, resolved, activeRef, options.thinkingLevel)
|
|
525
574
|
const { session } = await createAgentSession({
|
|
526
575
|
model,
|
|
527
576
|
modelRuntime,
|
|
@@ -533,6 +582,26 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
|
|
|
533
582
|
customTools,
|
|
534
583
|
...(thinkingLevel ? { thinkingLevel } : {}),
|
|
535
584
|
})
|
|
585
|
+
// Pi's general warmer also runs without background children. TypeClaw owns
|
|
586
|
+
// the narrower idle-parent policy and never persists synthetic ping results.
|
|
587
|
+
session.setCacheWarmingMode('off')
|
|
588
|
+
const cacheKeepalive = options.liveSubagentRegistry
|
|
589
|
+
? new SubagentCacheKeepalive(
|
|
590
|
+
options.plugins?.sessionId ?? sessionManager.getSessionId(),
|
|
591
|
+
options.liveSubagentRegistry,
|
|
592
|
+
(requestModel, context, streamOptions) => modelRuntime.streamSimple(requestModel, context, streamOptions),
|
|
593
|
+
)
|
|
594
|
+
: undefined
|
|
595
|
+
const unsubCacheKeepalive = session.subscribe((event) => {
|
|
596
|
+
if (event.type === 'agent_start') cacheKeepalive?.startTurn()
|
|
597
|
+
if (event.type === 'agent_settled') cacheKeepalive?.settle()
|
|
598
|
+
})
|
|
599
|
+
const innerDispose = session.dispose.bind(session)
|
|
600
|
+
session.dispose = () => {
|
|
601
|
+
cacheKeepalive?.close()
|
|
602
|
+
unsubCacheKeepalive()
|
|
603
|
+
innerDispose()
|
|
604
|
+
}
|
|
536
605
|
|
|
537
606
|
// Wrapping also means `agent.streamFunction !== streamSimple`, which puts pi's
|
|
538
607
|
// summarization auth on its lenient branch (agent-session.js:214-232): a
|
|
@@ -544,7 +613,20 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
|
|
|
544
613
|
const maxTokens =
|
|
545
614
|
streamOptions?.maxTokens ??
|
|
546
615
|
(requestModel.maxTokens > 0 ? Math.min(requestModel.maxTokens, DEFAULT_MAX_OUTPUT_TOKENS) : undefined)
|
|
547
|
-
|
|
616
|
+
const promptCacheKey = promptCacheKeyForOrigin(getOrigin())
|
|
617
|
+
const onPayload = async (payload: unknown, payloadModel: typeof requestModel) => {
|
|
618
|
+
const next = (await streamOptions?.onPayload?.(payload, payloadModel)) ?? payload
|
|
619
|
+
const final = promptCacheKey === undefined ? next : withPromptCacheKey(next, promptCacheKey)
|
|
620
|
+
if (streamOptions?.sessionId === session.sessionId) {
|
|
621
|
+
cacheKeepalive?.capture(payloadModel, context, { ...streamOptions, maxTokens }, final)
|
|
622
|
+
}
|
|
623
|
+
return final
|
|
624
|
+
}
|
|
625
|
+
return await innerStreamFunction(requestModel, context, {
|
|
626
|
+
...streamOptions,
|
|
627
|
+
maxTokens,
|
|
628
|
+
onPayload,
|
|
629
|
+
})
|
|
548
630
|
}
|
|
549
631
|
|
|
550
632
|
// typeclaw owns retry/fallback in its turn drivers, so the SDK's own
|
|
@@ -553,7 +635,8 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
|
|
|
553
635
|
// while typeclaw has already latched the failure, reporting a recovered turn as
|
|
554
636
|
// failed (and burning an unnecessary failover). Disabling it makes a soft error
|
|
555
637
|
// a deterministic, typeclaw-owned signal. Compaction/context-overflow recovery
|
|
556
|
-
// is independent (gated on compaction settings), so this does not disable those
|
|
638
|
+
// is independent (gated on compaction settings), so this does not disable those;
|
|
639
|
+
// marked local failures are kept out of overflow recovery at the marker below.
|
|
557
640
|
session.setAutoRetryEnabled(false)
|
|
558
641
|
const getAbortReason = () => abortHolder.reason
|
|
559
642
|
const sessionWithAbortReason = Object.assign(session, { getAbortReason })
|
|
@@ -576,6 +659,20 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
|
|
|
576
659
|
}
|
|
577
660
|
}
|
|
578
661
|
|
|
662
|
+
// pi turns a throw from context preparation into the same `stopReason:'error'`
|
|
663
|
+
// message a provider failure produces, with only the error text kept, so the
|
|
664
|
+
// origin has to be stamped where it is thrown. Installed last so it is the
|
|
665
|
+
// outermost layer over pi's extension `context` pass (which clones the
|
|
666
|
+
// messages) and its forced-prompt projection. getApiKey and streamFunction
|
|
667
|
+
// stay unwrapped: their failures can be genuine provider/auth failures.
|
|
668
|
+
// Overflow recovery stays enabled; a local failure whose text would read as a
|
|
669
|
+
// provider overflow is stamped with fixed text and its raw text is logged here.
|
|
670
|
+
session.agent.transformContext = wrapTransformContextWithLocalFailureMarker(session.agent.transformContext, {
|
|
671
|
+
getProvider: () => session.agent.state.model?.provider,
|
|
672
|
+
logWithheld: (line) =>
|
|
673
|
+
console.error(`[agent] ${options.plugins?.sessionId ?? sessionManager.getSessionId()}: ${line}`),
|
|
674
|
+
})
|
|
675
|
+
|
|
579
676
|
abortHolder.abort = (reason?: string) => {
|
|
580
677
|
if (reason !== undefined) abortHolder.reason = reason
|
|
581
678
|
if (session.agent.signal?.aborted !== true) session.agent.abort()
|
|
@@ -584,6 +681,9 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
|
|
|
584
681
|
const unsubRestart = subscribeRestartNotice(options.stream, sessionManager)
|
|
585
682
|
|
|
586
683
|
const unsubToolNudge = attachToolNotFoundNudge(session, intendedActiveToolNames)
|
|
684
|
+
// An applied idle summary replaces the prefix the keepalive captured;
|
|
685
|
+
// replaying the old one would only refresh a cache no turn will read.
|
|
686
|
+
const stopIdleCompaction = attachIdleCompaction(session, { onApplied: () => cacheKeepalive?.invalidate() })
|
|
587
687
|
|
|
588
688
|
// Registered only once creation can no longer fail, so a rejected creation
|
|
589
689
|
// leaves no scope entry behind; tools resolve the scope lazily at call time.
|
|
@@ -595,6 +695,9 @@ export async function createSessionWithDispose(options: CreateSessionOptions = {
|
|
|
595
695
|
)
|
|
596
696
|
: undefined
|
|
597
697
|
const dispose = async () => {
|
|
698
|
+
stopIdleCompaction()
|
|
699
|
+
cacheKeepalive?.close()
|
|
700
|
+
unsubCacheKeepalive()
|
|
598
701
|
releaseSubagentTmp?.()
|
|
599
702
|
unsubLoopGuardTurn()
|
|
600
703
|
unsubRestart?.()
|
|
@@ -637,7 +740,12 @@ export function buildRestartHandoffWiring(
|
|
|
637
740
|
// session. Returns undefined for non-channel/no-author origins.
|
|
638
741
|
export function currentChannelAuthor(getOrigin: () => SessionOrigin | undefined): string | undefined {
|
|
639
742
|
const origin = getOrigin()
|
|
640
|
-
|
|
743
|
+
if (origin?.kind !== 'channel') return undefined
|
|
744
|
+
// The legacy restart record carries only a target-local author ID. Foreign
|
|
745
|
+
// requesters must remain authorless there, matching their target role rules.
|
|
746
|
+
if (adapterNamespace(origin.lastInboundAuthorAdapter ?? origin.adapter) !== adapterNamespace(origin.adapter))
|
|
747
|
+
return undefined
|
|
748
|
+
return origin.lastInboundAuthorId
|
|
641
749
|
}
|
|
642
750
|
|
|
643
751
|
function restartHandoffOriginFor(origin: SessionOrigin): RestartHandoffOrigin | null {
|
|
@@ -763,6 +871,10 @@ export function buildChannelTools(
|
|
|
763
871
|
): ToolDefinition[] {
|
|
764
872
|
if (!channelRouter) return []
|
|
765
873
|
const tools: ToolDefinition[] = []
|
|
874
|
+
const getOutboundOrigin = (): ChannelOutboundOrigin | undefined => {
|
|
875
|
+
const current = getOrigin ? getOrigin() : origin
|
|
876
|
+
return current ? { kind: current.kind, ...(current.kind === 'cron' ? { jobId: current.jobId } : {}) } : undefined
|
|
877
|
+
}
|
|
766
878
|
if (origin?.kind === 'channel') {
|
|
767
879
|
// adapter/workspace/chat/thread are session-key fields and never vary across
|
|
768
880
|
// a session's turns, so they stay snapshotted. The review round does: it is
|
|
@@ -783,21 +895,23 @@ export function buildChannelTools(
|
|
|
783
895
|
createChannelReplyTool({
|
|
784
896
|
router: channelRouter,
|
|
785
897
|
origin: channelOrigin,
|
|
898
|
+
getOutboundOrigin,
|
|
786
899
|
...(sessionId !== undefined ? { sessionId } : {}),
|
|
787
900
|
}),
|
|
788
901
|
)
|
|
789
902
|
if (origin.adapter === 'github' && sessionId !== undefined)
|
|
790
903
|
tools.push(createPostGithubReviewTool({ router: channelRouter, origin: channelOrigin, sessionId }))
|
|
791
904
|
tools.push(createChannelHistoryTool({ router: channelRouter, origin: channelOrigin }))
|
|
792
|
-
tools.push(createChannelReadTool({ router: channelRouter }))
|
|
905
|
+
tools.push(createChannelReadTool({ router: channelRouter, ...(sessionId !== undefined ? { sessionId } : {}) }))
|
|
793
906
|
tools.push(
|
|
794
907
|
createChannelSendTool({
|
|
795
908
|
router: channelRouter,
|
|
796
909
|
origin: channelOrigin,
|
|
910
|
+
getOutboundOrigin,
|
|
797
911
|
...(sessionId !== undefined ? { sessionId } : {}),
|
|
798
912
|
}),
|
|
799
913
|
)
|
|
800
|
-
tools.push(createChannelEditTool({ router: channelRouter }))
|
|
914
|
+
tools.push(createChannelEditTool({ router: channelRouter, getOutboundOrigin }))
|
|
801
915
|
// Read the live turn origin, falling back to the static snapshot when no
|
|
802
916
|
// getter is wired (composition tests). `reactionRef` is per-turn, so the
|
|
803
917
|
// getter is what makes reactions work outside tests.
|
|
@@ -826,11 +940,13 @@ export function buildChannelTools(
|
|
|
826
940
|
tools.push(createChannelDisengageTool({ router: channelRouter, origin: channelOrigin }))
|
|
827
941
|
if (sessionId !== undefined) {
|
|
828
942
|
tools.push(createSkipResponseTool({ router: channelRouter, sessionId }))
|
|
943
|
+
tools.push(createChannelHandoffTool({ router: channelRouter, sessionId }))
|
|
944
|
+
tools.push(createChannelSessionSearchTool({ router: channelRouter, sessionId }))
|
|
829
945
|
}
|
|
830
946
|
} else {
|
|
831
|
-
tools.push(createChannelSendTool({ router: channelRouter }))
|
|
947
|
+
tools.push(createChannelSendTool({ router: channelRouter, getOutboundOrigin }))
|
|
832
948
|
tools.push(createChannelReadTool({ router: channelRouter }))
|
|
833
|
-
tools.push(createChannelEditTool({ router: channelRouter }))
|
|
949
|
+
tools.push(createChannelEditTool({ router: channelRouter, getOutboundOrigin }))
|
|
834
950
|
}
|
|
835
951
|
return tools
|
|
836
952
|
}
|
|
@@ -886,6 +1002,7 @@ export function buildSubagentOrchestrationTools(opts: {
|
|
|
886
1002
|
agentDir: string | undefined
|
|
887
1003
|
parentSessionId: string
|
|
888
1004
|
getOrigin: () => SessionOrigin | undefined
|
|
1005
|
+
getSessionFile?: () => string | undefined
|
|
889
1006
|
permissions: PermissionService | undefined
|
|
890
1007
|
stream: Stream | undefined
|
|
891
1008
|
allowBackgroundFromSubagent?: boolean
|
|
@@ -908,6 +1025,10 @@ export function buildSubagentOrchestrationTools(opts: {
|
|
|
908
1025
|
agentDir: opts.agentDir,
|
|
909
1026
|
parentSessionId: opts.parentSessionId,
|
|
910
1027
|
getOrigin: opts.getOrigin,
|
|
1028
|
+
...(opts.getSessionFile !== undefined ? { getSessionFile: opts.getSessionFile } : {}),
|
|
1029
|
+
...(opts.channelRouter === undefined
|
|
1030
|
+
? {}
|
|
1031
|
+
: { getAccountIdentity: opts.channelRouter.getRecoveryAccountIdentity, router: opts.channelRouter }),
|
|
911
1032
|
...(opts.permissions ? { permissions: opts.permissions } : {}),
|
|
912
1033
|
...(opts.stream ? { stream: opts.stream } : {}),
|
|
913
1034
|
...(opts.allowBackgroundFromSubagent !== undefined
|
|
@@ -919,6 +1040,7 @@ export function buildSubagentOrchestrationTools(opts: {
|
|
|
919
1040
|
liveRegistry: opts.liveRegistry,
|
|
920
1041
|
getOrigin: opts.getOrigin,
|
|
921
1042
|
callerSessionId: opts.parentSessionId,
|
|
1043
|
+
...(opts.channelRouter ? { router: opts.channelRouter } : {}),
|
|
922
1044
|
...(opts.permissions ? { permissions: opts.permissions } : {}),
|
|
923
1045
|
}),
|
|
924
1046
|
createSubagentCancelTool({
|
|
@@ -963,8 +1085,11 @@ export function buildTodoTools(
|
|
|
963
1085
|
return createTodoTools({ agentDir, getOrigin })
|
|
964
1086
|
}
|
|
965
1087
|
|
|
966
|
-
function buildCoreSystemTools(
|
|
967
|
-
|
|
1088
|
+
function buildCoreSystemTools(
|
|
1089
|
+
permissions: PermissionService | undefined,
|
|
1090
|
+
codingTool: ToolDefinition,
|
|
1091
|
+
): ToolDefinition[] {
|
|
1092
|
+
const definitions = [webSearchTool, webFetchTool, createLookAtTool(permissions), codingTool]
|
|
968
1093
|
const byName = new Map(definitions.map((tool) => [tool.name, tool]))
|
|
969
1094
|
if (byName.size !== definitions.length || byName.size !== CORE_SYSTEM_TOOL_NAMES.length) {
|
|
970
1095
|
throw new Error('core system tool catalog does not match its registered definitions')
|
|
@@ -1101,31 +1226,31 @@ export type CreateResourceLoaderOptions = {
|
|
|
1101
1226
|
mcpManager?: McpManager
|
|
1102
1227
|
permissions?: PermissionService
|
|
1103
1228
|
runtimeVersion?: string
|
|
1104
|
-
// Public subagents whose names + `rosterDescription`s render the
|
|
1105
|
-
//
|
|
1106
|
-
// debug dumper), the
|
|
1107
|
-
// from `createSessionWithDispose`, where the merged registry is
|
|
1108
|
-
// scope.
|
|
1229
|
+
// Public subagents whose names + `rosterDescription`s render the roster in
|
|
1230
|
+
// the full-mode interactive context. When omitted (registry-free callers,
|
|
1231
|
+
// the debug dumper), the context falls back to `DEFAULT_SUBAGENT_ROSTER`.
|
|
1232
|
+
// Threaded from `createSessionWithDispose`, where the merged registry is
|
|
1233
|
+
// already in scope.
|
|
1109
1234
|
subagentRegistry?: SubagentRegistry
|
|
1110
|
-
// Explicit override for the
|
|
1111
|
-
// from `origin.kind
|
|
1112
|
-
// 'full' to
|
|
1235
|
+
// Explicit override for the session-context mode. When omitted, the mode is
|
|
1236
|
+
// derived from `origin.kind`. It never changes the shared policy; pass
|
|
1237
|
+
// 'full' to add the interactive context to an unattended origin (rarely
|
|
1113
1238
|
// useful; mostly an escape hatch for ad-hoc debugging).
|
|
1114
1239
|
mode?: SystemPromptMode
|
|
1115
1240
|
proactiveNextStepNudge?: boolean
|
|
1116
1241
|
}
|
|
1117
1242
|
|
|
1118
|
-
// Origins
|
|
1119
|
-
//
|
|
1120
|
-
//
|
|
1121
|
-
//
|
|
1122
|
-
//
|
|
1123
|
-
//
|
|
1243
|
+
// Origins with a conversation partner waiting on the reply get the full-mode
|
|
1244
|
+
// session context: the interactive orchestration context with the live public
|
|
1245
|
+
// roster, the MCP catalog, and the git nudge. Unattended origins (cron fires,
|
|
1246
|
+
// default subagents, system processes) skip that context and the roster/git/MCP
|
|
1247
|
+
// work it needs — their origin block already says what is expected. Every
|
|
1248
|
+
// origin gets the same shared policy either way.
|
|
1124
1249
|
//
|
|
1125
1250
|
// Exhaustive switch (not a boolean expression) so a future origin kind forces
|
|
1126
1251
|
// the author to make an explicit full-or-slim decision at compile time. The
|
|
1127
1252
|
// previous form silently defaulted new origins to slim, which would have
|
|
1128
|
-
// stripped the
|
|
1253
|
+
// stripped the interactive context from a new interactive surface by
|
|
1129
1254
|
// accident.
|
|
1130
1255
|
export function deriveSystemPromptMode(origin: SessionOrigin | undefined): SystemPromptMode {
|
|
1131
1256
|
if (origin === undefined) return 'full'
|
|
@@ -1152,28 +1277,27 @@ export function deriveSystemPromptMode(origin: SessionOrigin | undefined): Syste
|
|
|
1152
1277
|
// pipeline `createResourceLoader` uses, with no risk of drift if the
|
|
1153
1278
|
// section order changes.
|
|
1154
1279
|
//
|
|
1155
|
-
// `mode` selects the
|
|
1156
|
-
//
|
|
1157
|
-
//
|
|
1158
|
-
//
|
|
1159
|
-
//
|
|
1160
|
-
//
|
|
1161
|
-
//
|
|
1162
|
-
// guidance is irrelevant and the origin block already covers per-kind
|
|
1163
|
-
// specifics (no human, side effects via tools, narrow scope).
|
|
1280
|
+
// `mode` selects only the optional session context, never the policy: every
|
|
1281
|
+
// standard session starts with `buildSystemPolicy(branding)`.
|
|
1282
|
+
// - 'full' (default) — TUI, channel, and origin-less sessions: appends the
|
|
1283
|
+
// interactive context (`renderInteractiveSessionContext`) with the roster.
|
|
1284
|
+
// - 'slim' — cron, default subagents, system processes: no interactive
|
|
1285
|
+
// context; the origin block covers per-kind specifics (no human, side
|
|
1286
|
+
// effects via tools, narrow scope).
|
|
1164
1287
|
export type SystemPromptMode = 'full' | 'slim'
|
|
1165
1288
|
|
|
1166
1289
|
export type SystemPromptComposition = {
|
|
1167
1290
|
mode?: SystemPromptMode
|
|
1168
1291
|
// Whether the prompt discloses that the agent runs on TypeClaw. When false,
|
|
1169
|
-
// the
|
|
1170
|
-
//
|
|
1292
|
+
// the policy's opening is phrased generically, the `## Runtime` version
|
|
1293
|
+
// block is dropped, and the runtime-disclosure rule is appended. Defaults to
|
|
1294
|
+
// true. Mirrors `config.branding`.
|
|
1171
1295
|
branding?: boolean
|
|
1172
1296
|
self: string
|
|
1173
|
-
// Pre-rendered
|
|
1297
|
+
// Pre-rendered interactive-context roster (from `renderPublicSubagentRoster`).
|
|
1174
1298
|
// Kept as a ready string so this composer stays pure and registry-free; the
|
|
1175
|
-
// registry-aware caller renders it. Ignored in slim mode (no
|
|
1176
|
-
// Falls back to `DEFAULT_SUBAGENT_ROSTER` when omitted.
|
|
1299
|
+
// registry-aware caller renders it. Ignored in slim mode (no interactive
|
|
1300
|
+
// context). Falls back to `DEFAULT_SUBAGENT_ROSTER` when omitted.
|
|
1177
1301
|
subagentRoster?: string
|
|
1178
1302
|
runtimeVersion?: string
|
|
1179
1303
|
origin?: SessionOrigin
|
|
@@ -1191,12 +1315,19 @@ export type SystemPromptComposition = {
|
|
|
1191
1315
|
// section changes (the provider's prompt cache hits up to the first byte
|
|
1192
1316
|
// that differs).
|
|
1193
1317
|
//
|
|
1194
|
-
// 0.
|
|
1195
|
-
// 1.
|
|
1196
|
-
// 2.
|
|
1318
|
+
// 0. shared policy — identical for every standard session of an agent.
|
|
1319
|
+
// 1. self — IDENTITY.md + SOUL.md (plus any plugin `session.prompt` append).
|
|
1320
|
+
// 2. runtime block (or the runtime-disclosure rule when branding is off) —
|
|
1321
|
+
// only changes on typeclaw releases.
|
|
1322
|
+
// 3. interactive context (full mode) — stable per agent registry, so it
|
|
1323
|
+
// precedes the per-session origin block.
|
|
1324
|
+
// 4. origin block + role — stable across sessions of the same kind; channel
|
|
1325
|
+
// origins carry per-conversation details.
|
|
1326
|
+
// 5. MCP catalog — changes when servers connect or disconnect.
|
|
1327
|
+
// 6. gitNudge — rare changes; agent folders force-commit sessions/ and
|
|
1197
1328
|
// memory/ after every turn, so the dirty-files list is empty most of
|
|
1198
1329
|
// the time.
|
|
1199
|
-
//
|
|
1330
|
+
// 7. proactive next-step nudge — deterministic per model family.
|
|
1200
1331
|
//
|
|
1201
1332
|
// The wall-clock anchor that used to live here as `## Now` moved out
|
|
1202
1333
|
// entirely. It is now injected into the user turn at each `session.prompt`
|
|
@@ -1204,20 +1335,23 @@ export type SystemPromptComposition = {
|
|
|
1204
1335
|
// stamp reflects the moment of THIS turn, not session creation. Per-turn
|
|
1205
1336
|
// injection costs zero cached bytes — the user turn is the non-cacheable
|
|
1206
1337
|
// suffix anyway — and removes the staleness failure mode where a session
|
|
1207
|
-
// opened Friday answered "today is Friday" on Thursday.
|
|
1338
|
+
// opened Friday answered "today is Friday" on Thursday. Retrieved memory and
|
|
1339
|
+
// the live channel role ride in the user turn for the same reason.
|
|
1340
|
+
//
|
|
1341
|
+
// pi appends project context (AGENTS.md), the skill catalog, and the cwd
|
|
1342
|
+
// after this preamble when it builds the final system message.
|
|
1208
1343
|
export function composeSystemPrompt(parts: SystemPromptComposition): string {
|
|
1209
1344
|
const branding = parts.branding ?? true
|
|
1210
|
-
|
|
1211
|
-
parts.mode === 'slim'
|
|
1212
|
-
? buildSlimSystemPrompt(branding)
|
|
1213
|
-
: buildDefaultSystemPrompt(parts.subagentRoster ?? DEFAULT_SUBAGENT_ROSTER, branding)
|
|
1214
|
-
let prompt = `${base}\n\n${parts.self}`
|
|
1345
|
+
let prompt = `${buildSystemPolicy(branding)}\n\n${parts.self}`
|
|
1215
1346
|
if (branding && parts.runtimeVersion !== undefined) {
|
|
1216
1347
|
prompt = `${prompt}\n\n${renderRuntimeBlock(parts.runtimeVersion)}`
|
|
1217
1348
|
}
|
|
1218
1349
|
if (!branding) {
|
|
1219
1350
|
prompt = `${prompt}\n\n${renderRuntimeNondisclosureRule()}`
|
|
1220
1351
|
}
|
|
1352
|
+
if (parts.mode !== 'slim') {
|
|
1353
|
+
prompt = `${prompt}\n\n${renderInteractiveSessionContext(parts.subagentRoster ?? DEFAULT_SUBAGENT_ROSTER)}`
|
|
1354
|
+
}
|
|
1221
1355
|
if (parts.origin !== undefined) {
|
|
1222
1356
|
prompt = `${prompt}\n\n${renderSessionOrigin(parts.origin, Date.now(), parts.roleContext)}`
|
|
1223
1357
|
}
|
|
@@ -1236,10 +1370,10 @@ export function composeSystemPrompt(parts: SystemPromptComposition): string {
|
|
|
1236
1370
|
export async function createResourceLoader(options: CreateResourceLoaderOptions = {}): Promise<DefaultResourceLoader> {
|
|
1237
1371
|
const agentDir = options.agentDir ?? process.cwd()
|
|
1238
1372
|
const mode: SystemPromptMode = options.mode ?? deriveSystemPromptMode(options.origin)
|
|
1239
|
-
// Slim mode (cron/subagent) has no
|
|
1240
|
-
// the roster. Skip rendering it there — `renderPublicSubagentRoster`
|
|
1241
|
-
// a public subagent with a missing/blank `rosterDescription`, and
|
|
1242
|
-
// session must not fail on a roster it will never show.
|
|
1373
|
+
// Slim mode (cron/subagent/system) has no interactive context, so it never
|
|
1374
|
+
// reads the roster. Skip rendering it there — `renderPublicSubagentRoster`
|
|
1375
|
+
// throws on a public subagent with a missing/blank `rosterDescription`, and
|
|
1376
|
+
// a slim session must not fail on a roster it will never show.
|
|
1243
1377
|
const subagentRoster =
|
|
1244
1378
|
mode === 'slim'
|
|
1245
1379
|
? undefined
|
|
@@ -1247,10 +1381,7 @@ export async function createResourceLoader(options: CreateResourceLoaderOptions
|
|
|
1247
1381
|
? renderPublicSubagentRoster(options.subagentRegistry)
|
|
1248
1382
|
: DEFAULT_SUBAGENT_ROSTER
|
|
1249
1383
|
const branding = getConfig().branding
|
|
1250
|
-
const
|
|
1251
|
-
mode === 'slim'
|
|
1252
|
-
? buildSlimSystemPrompt(branding)
|
|
1253
|
-
: buildDefaultSystemPrompt(subagentRoster ?? DEFAULT_SUBAGENT_ROSTER, branding)
|
|
1384
|
+
const policy = buildSystemPolicy(branding)
|
|
1254
1385
|
|
|
1255
1386
|
// Kick off the independent I/O paths concurrently. Sequential awaits
|
|
1256
1387
|
// here used to be the dominant cold-start cost amplifier: loadSelf is 2
|
|
@@ -1285,25 +1416,24 @@ export async function createResourceLoader(options: CreateResourceLoaderOptions
|
|
|
1285
1416
|
let self = await selfPromise
|
|
1286
1417
|
|
|
1287
1418
|
if (options.plugins) {
|
|
1288
|
-
// The plugin hook receives the partially-assembled prompt (
|
|
1289
|
-
// so plugins can rewrite either section before the
|
|
1290
|
-
//
|
|
1291
|
-
//
|
|
1292
|
-
|
|
1293
|
-
const preHook = `${basePrompt}\n\n${self}`
|
|
1419
|
+
// The plugin hook receives the partially-assembled prompt (shared policy +
|
|
1420
|
+
// identity) so plugins can rewrite either section before the session
|
|
1421
|
+
// context and cache-suffix blocks are appended. Every standard origin
|
|
1422
|
+
// hands the hook the same policy text.
|
|
1423
|
+
const preHook = `${policy}\n\n${self}`
|
|
1294
1424
|
const event = { prompt: preHook, sessionId: options.plugins.sessionId, agentDir, origin: options.origin }
|
|
1295
1425
|
await options.plugins.hooks.runSessionPrompt(event)
|
|
1296
|
-
// Recover `self` by stripping the leading
|
|
1297
|
-
// composition stays section-shaped. If a plugin rewrote the
|
|
1426
|
+
// Recover `self` by stripping the leading policy so the rest of the
|
|
1427
|
+
// composition stays section-shaped. If a plugin rewrote the policy as
|
|
1298
1428
|
// well, the recovered `self` carries the full mutated remainder.
|
|
1299
|
-
self = event.prompt.startsWith(`${
|
|
1429
|
+
self = event.prompt.startsWith(`${policy}\n\n`) ? event.prompt.slice(policy.length + 2) : event.prompt
|
|
1300
1430
|
}
|
|
1301
1431
|
|
|
1302
1432
|
const roleContext = options.origin !== undefined ? resolveRoleContext(options.origin, options.permissions) : undefined
|
|
1303
|
-
// Slim mode skips git-nudge entirely: cron
|
|
1304
|
-
// right actor to drive
|
|
1305
|
-
//
|
|
1306
|
-
//
|
|
1433
|
+
// Slim mode skips git-nudge entirely: cron, subagent, and system sessions
|
|
1434
|
+
// are not the right actor to drive commit decisions about dirty files they
|
|
1435
|
+
// did not touch. The shared policy's commit rules still cover their own
|
|
1436
|
+
// changes.
|
|
1307
1437
|
const gitNudgeResult = await gitNudgeSettled
|
|
1308
1438
|
const gitNudge = unwrapSettled(gitNudgeResult)
|
|
1309
1439
|
|
|
@@ -5,8 +5,8 @@ export type LiveAgentSession = {
|
|
|
5
5
|
sessionId: string
|
|
6
6
|
session: Pick<AgentSession, 'subscribe'>
|
|
7
7
|
// Surfaced by the inspect picker for sessions not yet on disk: pi-coding-agent
|
|
8
|
-
// defers the first .jsonl write until the first
|
|
9
|
-
// these a
|
|
8
|
+
// defers the first .jsonl write until the first user message, so without
|
|
9
|
+
// these a session that has not been prompted yet is invisible. Optional so subscribe-only test
|
|
10
10
|
// harnesses can still register `{ sessionId, session }`; live-listing skips
|
|
11
11
|
// entries lacking an origin.
|
|
12
12
|
origin?: MinimalSessionOrigin
|