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
|
@@ -115,17 +115,30 @@ export type StatusSnapshot = {
|
|
|
115
115
|
}
|
|
116
116
|
|
|
117
117
|
export class LiveSubagentRegistry {
|
|
118
|
+
private readonly listeners = new Set<(parentSessionId: string | undefined) => void>()
|
|
118
119
|
private readonly entries = new Map<string, LiveSubagent>()
|
|
119
120
|
private readonly events = new Map<string, SubagentProgressEvent[]>()
|
|
120
121
|
private readonly capturedFinalMessages = new Map<string, string>()
|
|
121
122
|
private readonly pendingWorkKeyRegistrations = new Map<string, Set<PendingWorkKeyRegistration>>()
|
|
122
123
|
|
|
124
|
+
subscribe(listener: (parentSessionId: string | undefined) => void): () => void {
|
|
125
|
+
this.listeners.add(listener)
|
|
126
|
+
return () => {
|
|
127
|
+
this.listeners.delete(listener)
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
private notify(parentSessionId: string | undefined): void {
|
|
132
|
+
for (const listener of this.listeners) listener(parentSessionId)
|
|
133
|
+
}
|
|
134
|
+
|
|
123
135
|
register(live: LiveSubagent): void {
|
|
124
136
|
if (this.entries.has(live.taskId)) {
|
|
125
137
|
throw new Error(`task ${live.taskId} already registered`)
|
|
126
138
|
}
|
|
127
139
|
this.entries.set(live.taskId, live)
|
|
128
140
|
this.events.set(live.taskId, [{ kind: 'started', ts: live.startedAt }])
|
|
141
|
+
this.notify(live.parentSessionId)
|
|
129
142
|
}
|
|
130
143
|
|
|
131
144
|
beginWorkKeyRegistration(workKey: string): PendingWorkKeyRegistration {
|
|
@@ -151,9 +164,11 @@ export class LiveSubagentRegistry {
|
|
|
151
164
|
}
|
|
152
165
|
|
|
153
166
|
unregister(taskId: string): void {
|
|
167
|
+
const entry = this.entries.get(taskId)
|
|
154
168
|
this.entries.delete(taskId)
|
|
155
169
|
this.events.delete(taskId)
|
|
156
170
|
this.capturedFinalMessages.delete(taskId)
|
|
171
|
+
if (entry) this.notify(entry.parentSessionId)
|
|
157
172
|
}
|
|
158
173
|
|
|
159
174
|
get(taskId: string): LiveSubagent | undefined {
|
|
@@ -198,6 +213,7 @@ export class LiveSubagentRegistry {
|
|
|
198
213
|
if (entry === undefined) return
|
|
199
214
|
entry.completion = completion
|
|
200
215
|
entry.status = completion.ok ? 'completed' : 'failed'
|
|
216
|
+
this.notify(entry.parentSessionId)
|
|
201
217
|
}
|
|
202
218
|
|
|
203
219
|
// First-writer-wins settlement, returning whether THIS caller won. A subagent
|
|
@@ -215,6 +231,7 @@ export class LiveSubagentRegistry {
|
|
|
215
231
|
if (entry === undefined || entry.status !== 'running') return false
|
|
216
232
|
entry.completion = completion
|
|
217
233
|
entry.status = completion.ok ? 'completed' : 'failed'
|
|
234
|
+
this.notify(entry.parentSessionId)
|
|
218
235
|
return true
|
|
219
236
|
}
|
|
220
237
|
|
|
@@ -287,10 +304,13 @@ export class LiveSubagentRegistry {
|
|
|
287
304
|
}
|
|
288
305
|
|
|
289
306
|
clear(): void {
|
|
307
|
+
// Shutdown must not erase evidence of children that have not terminated.
|
|
308
|
+
const parents = new Set(Array.from(this.entries.values(), (entry) => entry.parentSessionId))
|
|
290
309
|
this.entries.clear()
|
|
291
310
|
this.events.clear()
|
|
292
311
|
this.capturedFinalMessages.clear()
|
|
293
312
|
this.pendingWorkKeyRegistrations.clear()
|
|
313
|
+
for (const parent of parents) this.notify(parent)
|
|
294
314
|
}
|
|
295
315
|
|
|
296
316
|
private removePendingWorkKeyRegistration(registration: PendingWorkKeyRegistration): void {
|
|
@@ -116,19 +116,28 @@ export function createChannelLookAtTool(
|
|
|
116
116
|
description:
|
|
117
117
|
'View an image attached to a channel message. Inbound messages show ' +
|
|
118
118
|
'`[<Platform> attachment #N: <kind> <metadata>]`; pass `N` as `attachment_id`. Do not invent ids. ' +
|
|
119
|
-
'Images on the CURRENT inbound resolve directly; for
|
|
120
|
-
'
|
|
119
|
+
'Images on the CURRENT inbound resolve directly; for an EARLIER message call channel_history first. ' +
|
|
120
|
+
'On Slack pass file_id when the request names an exact file or several messages reuse #1.',
|
|
121
121
|
parameters: Type.Object({
|
|
122
122
|
attachment_id: Type.Integer({
|
|
123
123
|
description: 'The number N from the inbound `[<Platform> attachment #N: ...]` placeholder.',
|
|
124
124
|
minimum: 1,
|
|
125
125
|
}),
|
|
126
|
+
file_id: Type.Optional(
|
|
127
|
+
Type.String({ pattern: '^F[A-Z0-9]+$', description: 'Exact Slack file ID from the request or history.' }),
|
|
128
|
+
),
|
|
126
129
|
prompt: Type.Optional(
|
|
127
130
|
Type.String({ description: 'Optional question to ask about the image; omitted means describe it.' }),
|
|
128
131
|
),
|
|
129
132
|
}),
|
|
130
133
|
async execute(_toolCallId, params) {
|
|
131
|
-
|
|
134
|
+
if (params.file_id !== undefined && origin.adapter !== 'slack' && origin.adapter !== 'slack-bot')
|
|
135
|
+
return errorResult('file_id is only supported for Slack attachments', { count: 0, prompt: params.prompt })
|
|
136
|
+
const found = router.lookupInboundAttachment({
|
|
137
|
+
...origin,
|
|
138
|
+
id: params.attachment_id,
|
|
139
|
+
...(params.file_id !== undefined ? { ref: params.file_id } : {}),
|
|
140
|
+
})
|
|
132
141
|
if (found === null) {
|
|
133
142
|
const validIds = router.listInboundAttachmentIds(origin)
|
|
134
143
|
const validMsg =
|
|
@@ -151,12 +160,16 @@ export function createChannelLookAtTool(
|
|
|
151
160
|
maxBytes: LOOK_AT_MAX_BYTES,
|
|
152
161
|
...(found.filename !== undefined ? { filename: found.filename } : {}),
|
|
153
162
|
})
|
|
154
|
-
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
163
|
+
const viewed = result.ok
|
|
164
|
+
? await runLookAtImages(
|
|
165
|
+
[toImageContent(result.buffer.toString('base64'), result.mimetype ?? 'image/jpeg')],
|
|
166
|
+
params.prompt,
|
|
167
|
+
permissions,
|
|
168
|
+
)
|
|
169
|
+
: errorResult(result.error, { count: 0, prompt: params.prompt })
|
|
170
|
+
if (origin.adapter === 'slack' || origin.adapter === 'slack-bot')
|
|
171
|
+
viewed.content.unshift({ type: 'text', text: `Selected Slack file_id=${found.ref}` })
|
|
172
|
+
return viewed
|
|
160
173
|
},
|
|
161
174
|
})
|
|
162
175
|
}
|
|
@@ -4,6 +4,7 @@ import { join, relative, sep } from 'node:path'
|
|
|
4
4
|
|
|
5
5
|
import {
|
|
6
6
|
createBashToolDefinition as piCreateBashToolDefinition,
|
|
7
|
+
createLocalBashOperations,
|
|
7
8
|
createEditToolDefinition as piCreateEditToolDefinition,
|
|
8
9
|
createFindToolDefinition as piCreateFindToolDefinition,
|
|
9
10
|
createGrepToolDefinition as piCreateGrepToolDefinition,
|
|
@@ -19,6 +20,8 @@ import { z } from 'zod'
|
|
|
19
20
|
|
|
20
21
|
import { ACKNOWLEDGE_GUARDS } from '@/bundled-plugins/guard/keys'
|
|
21
22
|
import { config, getSandboxWritablePathSpecs } from '@/config/config'
|
|
23
|
+
import { readOomEvents, toolOomNote } from '@/container/oom-events'
|
|
24
|
+
import { withToolOomPriorityCommand } from '@/container/tool-oom-priority'
|
|
22
25
|
import { readEnvFile } from '@/init/env-file'
|
|
23
26
|
import {
|
|
24
27
|
classifyToolOutcome,
|
|
@@ -75,6 +78,7 @@ import {
|
|
|
75
78
|
verifyHiddenMaskTargets,
|
|
76
79
|
verifyPrivilegedSandboxRuntime,
|
|
77
80
|
} from '@/sandbox'
|
|
81
|
+
import { resolveDevSourceMount } from '@/sandbox/dev-source'
|
|
78
82
|
import { resolveExposableEnvNames } from '@/sandbox/env-exposure'
|
|
79
83
|
|
|
80
84
|
import type { InternalGuard } from './guard-types'
|
|
@@ -136,6 +140,7 @@ type BashSpawnEnvContext = {
|
|
|
136
140
|
// that appears in process.env between policy build and spawn stays out of the
|
|
137
141
|
// sandbox (closes the inherit TOCTOU).
|
|
138
142
|
sandboxSpawnEnv?: Record<string, string>
|
|
143
|
+
oomNote?: string
|
|
139
144
|
}
|
|
140
145
|
|
|
141
146
|
const bashEnvStore = new AsyncLocalStorage<BashSpawnEnvContext | undefined>()
|
|
@@ -164,8 +169,9 @@ function readBashPreparation(args: Record<string, unknown>): DeferredBashPrepara
|
|
|
164
169
|
|
|
165
170
|
function bashSpawnHookWithOverlay(context: BashSpawnContext): BashSpawnContext {
|
|
166
171
|
const store = bashEnvStore.getStore()
|
|
167
|
-
|
|
168
|
-
return { ...context, env:
|
|
172
|
+
const command = withToolOomPriorityCommand(context.command)
|
|
173
|
+
if (store?.sandboxSpawnEnv !== undefined) return { ...context, command, env: { ...store.sandboxSpawnEnv } }
|
|
174
|
+
return { ...context, command, env: sanitizeBashSpawnEnvironment(context.env, store?.overlay, store?.withhold) }
|
|
169
175
|
}
|
|
170
176
|
|
|
171
177
|
export function sanitizeBashSpawnEnvironment(
|
|
@@ -204,14 +210,33 @@ function createPiBuiltinToolDefinition(name: PiBuiltinToolName, cwd: string): To
|
|
|
204
210
|
switch (name) {
|
|
205
211
|
case 'read':
|
|
206
212
|
return piCreateReadToolDefinition(cwd)
|
|
207
|
-
case 'bash':
|
|
213
|
+
case 'bash': {
|
|
214
|
+
const operations = createLocalBashOperations()
|
|
208
215
|
return piCreateBashToolDefinition(cwd, {
|
|
209
|
-
//
|
|
210
|
-
//
|
|
211
|
-
//
|
|
216
|
+
// TypeClaw owns the bash environment boundary, so disable Pi session
|
|
217
|
+
// metadata rather than bypassing the spawn hook. Bracket the real
|
|
218
|
+
// process at the operation boundary: only there can memory.events be
|
|
219
|
+
// read before spawn and after exit (Pi 0.99 reports a signal-killed
|
|
220
|
+
// shell as 128+signal, so a SIGKILLed shell surfaces as 137 too).
|
|
212
221
|
exposeSessionEnvironment: false,
|
|
213
222
|
spawnHook: bashSpawnHookWithOverlay,
|
|
223
|
+
operations: {
|
|
224
|
+
async exec(command, dir, options) {
|
|
225
|
+
const before = readOomEvents()
|
|
226
|
+
const result = await operations.exec(command, dir, options)
|
|
227
|
+
const note =
|
|
228
|
+
result.exitCode === null
|
|
229
|
+
? null
|
|
230
|
+
: toolOomNote(before, result.exitCode, 'bash', { log: (line) => console.warn(line) })
|
|
231
|
+
if (note !== null) {
|
|
232
|
+
const context = bashEnvStore.getStore()
|
|
233
|
+
if (context !== undefined) context.oomNote = note
|
|
234
|
+
}
|
|
235
|
+
return result
|
|
236
|
+
},
|
|
237
|
+
},
|
|
214
238
|
})
|
|
239
|
+
}
|
|
215
240
|
case 'edit':
|
|
216
241
|
return piCreateEditToolDefinition(cwd)
|
|
217
242
|
case 'write':
|
|
@@ -249,11 +274,17 @@ function isTypeclawToolName(name: string): name is TypeclawToolName {
|
|
|
249
274
|
return name in TYPECLAW_TOOL_DEFINITION_MAP
|
|
250
275
|
}
|
|
251
276
|
|
|
252
|
-
export function resolveBuiltinToolRefs(
|
|
277
|
+
export function resolveBuiltinToolRefs(
|
|
278
|
+
refs: BuiltinToolRef[],
|
|
279
|
+
cwd: string,
|
|
280
|
+
contextTools: ReadonlyMap<string, ToolDefinition<any, any, any>> = new Map(),
|
|
281
|
+
): ToolDefinition<any, any, any>[] {
|
|
253
282
|
return refs.map((ref) => {
|
|
254
283
|
const name = ref.__builtinTool
|
|
255
284
|
if (isPiBuiltinToolName(name)) return createPiBuiltinToolDefinition(name, cwd)
|
|
256
285
|
if (isTypeclawToolName(name)) return TYPECLAW_TOOL_DEFINITION_MAP[name]
|
|
286
|
+
const contextual = contextTools.get(name)
|
|
287
|
+
if (contextual) return contextual
|
|
257
288
|
throw new Error(`unknown built-in tool ref: ${name}`)
|
|
258
289
|
})
|
|
259
290
|
}
|
|
@@ -639,6 +670,7 @@ export function wrapBuiltinToolDefinition<TParams extends TSchema, TDetails = un
|
|
|
639
670
|
cleanupError = undefined
|
|
640
671
|
sandboxedRealProcSucceeded = false
|
|
641
672
|
const attemptArgs = { ...originalArgs }
|
|
673
|
+
let spawnEnvContext: BashSpawnEnvContext | undefined
|
|
642
674
|
try {
|
|
643
675
|
if (tool.name === 'bash') {
|
|
644
676
|
if (opts.permissions === undefined) {
|
|
@@ -678,7 +710,7 @@ export function wrapBuiltinToolDefinition<TParams extends TSchema, TDetails = un
|
|
|
678
710
|
signal,
|
|
679
711
|
})
|
|
680
712
|
await preparedSandboxRuntime?.verify()
|
|
681
|
-
|
|
713
|
+
spawnEnvContext =
|
|
682
714
|
bashEnvOverlay !== undefined ||
|
|
683
715
|
bashEnvWithhold !== undefined ||
|
|
684
716
|
preparedSandboxRuntime?.spawnEnv !== undefined
|
|
@@ -689,17 +721,28 @@ export function wrapBuiltinToolDefinition<TParams extends TSchema, TDetails = un
|
|
|
689
721
|
? { sandboxSpawnEnv: preparedSandboxRuntime.spawnEnv }
|
|
690
722
|
: {}),
|
|
691
723
|
}
|
|
692
|
-
:
|
|
693
|
-
|
|
724
|
+
: tool.name === 'bash'
|
|
725
|
+
? {}
|
|
726
|
+
: undefined
|
|
727
|
+
const executed = await bashEnvStore.run(spawnEnvContext, () =>
|
|
694
728
|
tool.execute(toolCallId, attemptArgs as Static<TParams>, signal, onUpdate, ctx),
|
|
695
729
|
)
|
|
730
|
+
// Pi 0.99 bash returns a nonzero exit as an `isError` result whose text
|
|
731
|
+
// is the message 0.87 threw (tools/bash.js). This wrapper returns only
|
|
732
|
+
// content/details, so rethrow to keep the failure on the error path
|
|
733
|
+
// (remediation, incident repair, sandbox note, model-facing isError).
|
|
734
|
+
if (executed.isError === true) {
|
|
735
|
+
throw new Error(executed.content.map((part) => (part.type === 'text' ? part.text : '')).join('\n'))
|
|
736
|
+
}
|
|
737
|
+
rawResult = executed
|
|
696
738
|
const originalCommand = originalArgs.command
|
|
697
739
|
sandboxedRealProcSucceeded =
|
|
698
740
|
preparedSandboxRuntime !== undefined &&
|
|
699
741
|
typeof originalCommand === 'string' &&
|
|
700
742
|
(opts.realProcDependencyCheck ?? commandNeedsRealProc)(originalCommand)
|
|
701
743
|
} catch (error) {
|
|
702
|
-
executionError =
|
|
744
|
+
executionError =
|
|
745
|
+
spawnEnvContext?.oomNote === undefined ? error : appendErrorText(error, spawnEnvContext.oomNote)
|
|
703
746
|
} finally {
|
|
704
747
|
const cleanup = [pinnedFiles?.cleanup(), preparedSandboxRuntime?.cleanup()].filter(
|
|
705
748
|
(task): task is Promise<void> => task !== undefined,
|
|
@@ -778,7 +821,16 @@ export function wrapBuiltinToolDefinition<TParams extends TSchema, TDetails = un
|
|
|
778
821
|
renderSandboxPolicyNote(preparedSandboxRuntime.withheld, opts.agentDir),
|
|
779
822
|
)
|
|
780
823
|
}
|
|
781
|
-
|
|
824
|
+
const errorResult = toErrorResult(finalError)
|
|
825
|
+
await runToolAfterSafely(opts, tool.name, toolCallId, errorResult)
|
|
826
|
+
const annotatedMessage = errorResult.content
|
|
827
|
+
.filter((part) => part.type === 'text')
|
|
828
|
+
.map((part) => part.text)
|
|
829
|
+
.join('\n')
|
|
830
|
+
if (annotatedMessage !== (finalError instanceof Error ? finalError.message : String(finalError))) {
|
|
831
|
+
if (finalError instanceof Error) finalError.message = annotatedMessage
|
|
832
|
+
else finalError = new Error(annotatedMessage)
|
|
833
|
+
}
|
|
782
834
|
throw finalError
|
|
783
835
|
}
|
|
784
836
|
if (pinnedFiles === undefined) throw new Error('tool file boundary was not initialized')
|
|
@@ -954,6 +1006,7 @@ async function applyBashSandbox(
|
|
|
954
1006
|
env: sandboxEnvOverlay,
|
|
955
1007
|
})
|
|
956
1008
|
await verifyHiddenMaskTargets(maskTargets)
|
|
1009
|
+
const devSourceMount = await resolveDevSourceMount(agentDir)
|
|
957
1010
|
const { commandString, spawnEnv } = boundary.buildCommand(command, {
|
|
958
1011
|
mounts: [
|
|
959
1012
|
{ type: 'ro-bind', source: agentDir, dest: agentDir },
|
|
@@ -962,6 +1015,7 @@ async function applyBashSandbox(
|
|
|
962
1015
|
// the lifetime of this command. Last-op-wins makes this narrow re-bind
|
|
963
1016
|
// read-only without adding any broader filesystem exposure.
|
|
964
1017
|
{ type: 'ro-bind', source: dependencyBins.wrapperDir, dest: DEPENDENCY_BIN_SANDBOX_DIR },
|
|
1018
|
+
...(devSourceMount === undefined ? [] : [devSourceMount]),
|
|
965
1019
|
...(privilegedRuntime?.mounts ?? []),
|
|
966
1020
|
...(preparation === undefined ? [] : [preparation.mount]),
|
|
967
1021
|
],
|
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
import type { SessionOrigin } from './session-origin'
|
|
2
|
+
|
|
3
|
+
// Mirrors pi-ai's OPENAI_PROMPT_CACHE_KEY_MAX_LENGTH, which pi applies before
|
|
4
|
+
// `onPayload` runs, so a replaced key must be bounded here too. Truncation can
|
|
5
|
+
// only merge two long-named origins into one cache bucket, which is harmless.
|
|
6
|
+
const PROMPT_CACHE_KEY_MAX_LENGTH = 64
|
|
7
|
+
|
|
8
|
+
// pi defaults OpenAI's `prompt_cache_key` to the session id, and OpenAI routes
|
|
9
|
+
// requests to cache machines by that key. Every new subagent/cron/channel
|
|
10
|
+
// session therefore landed on a cold machine and re-paid its whole ~10K-token
|
|
11
|
+
// system+tools prefix even though sibling sessions of the same kind had just
|
|
12
|
+
// sent the identical prefix. Keying by origin kind (and subagent/component
|
|
13
|
+
// name, whose prompts differ) lets those sessions share the warm prefix. Only
|
|
14
|
+
// the body key changes: pi still uses the session id for the Codex websocket
|
|
15
|
+
// session cache and request headers.
|
|
16
|
+
export function promptCacheKeyForOrigin(origin: SessionOrigin | undefined): string | undefined {
|
|
17
|
+
const key = unboundedPromptCacheKey(origin)
|
|
18
|
+
return key === undefined ? undefined : Array.from(key).slice(0, PROMPT_CACHE_KEY_MAX_LENGTH).join('')
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
function unboundedPromptCacheKey(origin: SessionOrigin | undefined): string | undefined {
|
|
22
|
+
if (origin === undefined) return undefined
|
|
23
|
+
switch (origin.kind) {
|
|
24
|
+
case 'subagent':
|
|
25
|
+
return `typeclaw:subagent:${origin.subagent}`
|
|
26
|
+
case 'system':
|
|
27
|
+
return `typeclaw:system:${origin.component}`
|
|
28
|
+
case 'tui':
|
|
29
|
+
case 'cron':
|
|
30
|
+
case 'channel':
|
|
31
|
+
return `typeclaw:${origin.kind}`
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
// Rewrites only payloads that already carry a string `prompt_cache_key`, so
|
|
36
|
+
// providers without the field and `cacheRetention: 'none'` (which omits it)
|
|
37
|
+
// are left untouched.
|
|
38
|
+
export function withPromptCacheKey(payload: unknown, key: string): unknown {
|
|
39
|
+
if (typeof payload !== 'object' || payload === null) return payload
|
|
40
|
+
if (typeof (payload as { prompt_cache_key?: unknown }).prompt_cache_key !== 'string') return payload
|
|
41
|
+
return { ...payload, prompt_cache_key: key }
|
|
42
|
+
}
|
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import { isContextOverflow, type AssistantMessage } from '@earendil-works/pi-ai'
|
|
2
|
+
|
|
1
3
|
import type { AgentSession } from './index'
|
|
2
4
|
|
|
3
5
|
// pi-coding-agent encodes upstream LLM failures (billing, rate limit, network,
|
|
@@ -24,14 +26,138 @@ export type DetectedProviderError = {
|
|
|
24
26
|
safeMessage: string
|
|
25
27
|
}
|
|
26
28
|
|
|
27
|
-
|
|
29
|
+
// Origin-neutral on purpose: an unclassified failure may come from the
|
|
30
|
+
// provider, the network, or TypeClaw itself, and the raw text alone can't say
|
|
31
|
+
// which. Naming the provider here blamed it for local bugs.
|
|
32
|
+
const GENERIC_SAFE_NOTICE = 'The assistant turn failed. Operators can check `typeclaw logs` for details.'
|
|
33
|
+
|
|
34
|
+
// pi-agent-core turns ANY throw inside its loop into the same
|
|
35
|
+
// `stopReason: 'error'` assistant message a provider failure produces, keeping
|
|
36
|
+
// only `errorMessage` (agent.js handleRunFailure) — the error's name, cause and
|
|
37
|
+
// throw site are dropped. So origin must be stamped into the message at the
|
|
38
|
+
// throw site: `wrapTransformContextWithLocalFailureMarker` appends this marker
|
|
39
|
+
// when the context-preparation step that runs before the next provider request
|
|
40
|
+
// throws. It covers only that request; earlier requests in the same run may
|
|
41
|
+
// have reached the provider. Anchored at the end so provider text echoed
|
|
42
|
+
// mid-message can't impersonate it. System token — English by design, like
|
|
43
|
+
// OBSERVER_TIMEOUT.
|
|
44
|
+
const LOCAL_FAILURE_NAME = /^[A-Za-z][A-Za-z0-9_]{0,63}$/
|
|
45
|
+
const LOCAL_PRE_REQUEST_FAILURE = /\(typeclaw local failure before provider request: [A-Za-z][A-Za-z0-9_]{0,63}\)$/
|
|
46
|
+
|
|
47
|
+
type TransformContext = NonNullable<AgentSession['agent']['transformContext']>
|
|
48
|
+
|
|
49
|
+
function readOr<T>(read: () => T, fallback: T): T {
|
|
50
|
+
try {
|
|
51
|
+
return read()
|
|
52
|
+
} catch {
|
|
53
|
+
return fallback
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
export type LocalFailureMarkerOptions = {
|
|
58
|
+
// Provider of the model pi stamps on the failure message. Pi's overflow
|
|
59
|
+
// check has a provider-specific branch, so the same text can trip it for one
|
|
60
|
+
// provider and not another.
|
|
61
|
+
getProvider?: () => string | undefined
|
|
62
|
+
// Receives the raw text when it is withheld from the transcript (see
|
|
63
|
+
// markLocalPreRequestFailure). Defaults to console.error.
|
|
64
|
+
logWithheld?: (line: string) => void
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
const WITHHELD_LOCAL_TEXT =
|
|
68
|
+
'local error text withheld from the transcript; it resembled provider context-overflow wording and is in typeclaw logs'
|
|
69
|
+
|
|
70
|
+
const NO_USAGE: AssistantMessage['usage'] = {
|
|
71
|
+
input: 0,
|
|
72
|
+
output: 0,
|
|
73
|
+
cacheRead: 0,
|
|
74
|
+
cacheWrite: 0,
|
|
75
|
+
totalTokens: 0,
|
|
76
|
+
cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, total: 0 },
|
|
77
|
+
}
|
|
78
|
+
|
|
79
|
+
// Pi's auto-compaction takes any `stopReason:'error'` message its public
|
|
80
|
+
// `isContextOverflow` accepts as a provider context overflow, then compacts and
|
|
81
|
+
// retries the turn (AgentSession._checkCompaction `explicitOverflow`). Called
|
|
82
|
+
// without a context window, this is that exact check, so pattern updates in Pi
|
|
83
|
+
// apply here too.
|
|
84
|
+
function wouldTripPiOverflow(errorMessage: string, provider: string | undefined): boolean {
|
|
85
|
+
return isContextOverflow({
|
|
86
|
+
role: 'assistant',
|
|
87
|
+
content: [],
|
|
88
|
+
api: '',
|
|
89
|
+
provider: provider ?? '',
|
|
90
|
+
model: '',
|
|
91
|
+
usage: NO_USAGE,
|
|
92
|
+
stopReason: 'error',
|
|
93
|
+
errorMessage,
|
|
94
|
+
timestamp: 0,
|
|
95
|
+
})
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
// Only an identifier-shaped `Error.name` is embedded, so a hostile or odd name
|
|
99
|
+
// can't inject parentheses/newlines into the marker. The raw text normally
|
|
100
|
+
// stays on the message for logs and operator surfaces; channels only ever see
|
|
101
|
+
// the fixed LOCAL sentence, never this text. One exception: when the marked
|
|
102
|
+
// text (raw text or name) would trip Pi's overflow check, pi would compact the
|
|
103
|
+
// session and replay a turn that never reached the provider. Then the
|
|
104
|
+
// transcript gets a fixed placeholder and the raw text moves to one
|
|
105
|
+
// `logWithheld` line instead. Reading a throwing getter/`toString`, or a
|
|
106
|
+
// throwing log sink, must not replace the original failure with a new one.
|
|
107
|
+
function markLocalPreRequestFailure(err: unknown, options: LocalFailureMarkerOptions): Error {
|
|
108
|
+
const provider = readOr(() => options.getProvider?.(), undefined)
|
|
109
|
+
const isError = readOr(() => err instanceof Error, false)
|
|
110
|
+
const text = readOr(() => String(isError ? (err as Error).message : err), 'unprintable thrown value')
|
|
111
|
+
if (isError && LOCAL_PRE_REQUEST_FAILURE.test(text) && !wouldTripPiOverflow(text, provider)) return err as Error
|
|
112
|
+
const rawName = readOr(() => (isError ? (err as Error).name : undefined), undefined)
|
|
113
|
+
const name = typeof rawName === 'string' && LOCAL_FAILURE_NAME.test(rawName) ? rawName : 'Error'
|
|
114
|
+
const marked = `${text} (typeclaw local failure before provider request: ${name})`
|
|
115
|
+
if (!wouldTripPiOverflow(marked, provider)) return new Error(marked, { cause: err })
|
|
116
|
+
try {
|
|
117
|
+
;(options.logWithheld ?? console.error)(`local failure text withheld from the transcript (${name}): ${text}`)
|
|
118
|
+
} catch {
|
|
119
|
+
// The failure being reported matters more than its log line.
|
|
120
|
+
}
|
|
121
|
+
const withheld = `${WITHHELD_LOCAL_TEXT} (typeclaw local failure before provider request: ${name})`
|
|
122
|
+
if (!wouldTripPiOverflow(withheld, provider)) return new Error(withheld, { cause: err })
|
|
123
|
+
// The name itself trips the check (e.g. `request_too_large`).
|
|
124
|
+
return new Error(`${WITHHELD_LOCAL_TEXT} (typeclaw local failure before provider request: Error)`, { cause: err })
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
// Wraps an agent's `transformContext` (the step pi runs right before
|
|
128
|
+
// `convertToLlm`/`getApiKey`/`streamFunction` on every request) so a throw from
|
|
129
|
+
// it — sync or async — is re-thrown with the local-origin marker. An abort is
|
|
130
|
+
// re-thrown untouched: it's a cancellation, and pi reports it as `aborted`.
|
|
131
|
+
export function wrapTransformContextWithLocalFailureMarker(
|
|
132
|
+
inner: TransformContext | undefined,
|
|
133
|
+
options: LocalFailureMarkerOptions = {},
|
|
134
|
+
): TransformContext {
|
|
135
|
+
return async (messages, signal) => {
|
|
136
|
+
if (!inner) return messages
|
|
137
|
+
try {
|
|
138
|
+
return await inner(messages, signal)
|
|
139
|
+
} catch (err) {
|
|
140
|
+
if (signal?.aborted) throw err
|
|
141
|
+
throw markLocalPreRequestFailure(err, options)
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
}
|
|
28
145
|
|
|
29
146
|
// The fetch observer (`llm-fetch-observer`) aborts a stalled provider stream
|
|
30
147
|
// with a message ending in this marker (TTFB / idle / overall deadline). Such a
|
|
31
148
|
// stall is a hard throw, not a `stopReason: 'error'` soft error, so it never
|
|
32
149
|
// reaches `detectProviderError`; the marker lets the hard-throw path recognize
|
|
33
150
|
// and surface it. The literal is the system's own token — English by design.
|
|
34
|
-
|
|
151
|
+
//
|
|
152
|
+
// The OpenAI and Anthropic SDKs don't let the marker through for the TTFB case:
|
|
153
|
+
// any fetch rejection that mentions "timed out" is replaced by a bare
|
|
154
|
+
// `APIConnectionTimeoutError('Request timed out.')` with no cause. That error is
|
|
155
|
+
// only raised when fetch itself rejects, i.e. before response headers, so it is
|
|
156
|
+
// the same pre-headers stall and must classify like the marked one. Matched as
|
|
157
|
+
// the whole message so the sentence echoed inside other text can't claim it.
|
|
158
|
+
const MARKED_OBSERVER_TIMEOUT = /\(typeclaw observer timeout\)/i
|
|
159
|
+
const SDK_CONNECTION_TIMEOUT = /^Request timed out\.$/
|
|
160
|
+
const OBSERVER_TIMEOUT = new RegExp(`${MARKED_OBSERVER_TIMEOUT.source}|${SDK_CONNECTION_TIMEOUT.source}`, 'i')
|
|
35
161
|
const OBSERVER_TTFB_TIMEOUT = /timed out before response headers/i
|
|
36
162
|
|
|
37
163
|
// Transport-layer failure: the request died at the connection/session before a
|
|
@@ -91,8 +217,14 @@ const INVALID_REQUEST = /\binvalid_request_error\b/i
|
|
|
91
217
|
// text, so adding a new class is opt-in and never widens what we expose.
|
|
92
218
|
const SAFE_CLASSES: ReadonlyArray<{ match: RegExp; safe: string }> = [
|
|
93
219
|
{
|
|
94
|
-
//
|
|
95
|
-
//
|
|
220
|
+
// First, so provider-looking text inside a local error (a `401` or `429`
|
|
221
|
+
// echoed by a tool, a `quota` word) can't pull it into a provider class.
|
|
222
|
+
match: LOCAL_PRE_REQUEST_FAILURE,
|
|
223
|
+
safe: 'TypeClaw could not prepare the conversation for the LLM request. Operators can check `typeclaw logs` for details.',
|
|
224
|
+
},
|
|
225
|
+
{
|
|
226
|
+
// Matched before billing because a 401 body can also mention "account",
|
|
227
|
+
// which would otherwise fall into the billing class below.
|
|
96
228
|
match: AUTH_FAULT,
|
|
97
229
|
safe: 'The upstream LLM provider rejected the request as unauthorized. Operators should check the provider API key configuration and `typeclaw logs`.',
|
|
98
230
|
},
|
|
@@ -141,6 +273,12 @@ const SAFE_CLASSES: ReadonlyArray<{ match: RegExp; safe: string }> = [
|
|
|
141
273
|
},
|
|
142
274
|
]
|
|
143
275
|
|
|
276
|
+
// An unclassified failure names no cause the chat user can act on, so channels
|
|
277
|
+
// treat it as retry-and-see rather than posting the generic notice.
|
|
278
|
+
export function isUnclassifiedProviderNotice(safeMessage: string): boolean {
|
|
279
|
+
return safeMessage === GENERIC_SAFE_NOTICE
|
|
280
|
+
}
|
|
281
|
+
|
|
144
282
|
function toSafeMessage(raw: string): string {
|
|
145
283
|
for (const { match, safe } of SAFE_CLASSES) {
|
|
146
284
|
if (match.test(raw)) return safe
|
|
@@ -162,8 +300,11 @@ const THROTTLE_OR_OVERLOAD =
|
|
|
162
300
|
// status with a quota/billing/auth reason (e.g. `429 insufficient quota`) — the
|
|
163
301
|
// status code alone must not force a pointless failover. The auth arm reuses the
|
|
164
302
|
// shared `AUTH_FAULT` source so it stays in lockstep with the safe-message class.
|
|
303
|
+
// A local pre-request failure is in the same bucket: preparing the context is
|
|
304
|
+
// model-independent, so every ref (and a same-ref replay) would fail the same
|
|
305
|
+
// way — and it must never count as provider throttling.
|
|
165
306
|
const NON_FAILOVER_FAULT = new RegExp(
|
|
166
|
-
`${INVALID_MODEL.source}|${INVALID_REQUEST.source}|\\bcyber_policy\\b|insufficient.*(?:quota|credit|fund|balance)|\\bquota\\b|billing|payment|account is not active|${AUTH_FAULT.source}`,
|
|
307
|
+
`${LOCAL_PRE_REQUEST_FAILURE.source}|${INVALID_MODEL.source}|${INVALID_REQUEST.source}|\\bcyber_policy\\b|insufficient.*(?:quota|credit|fund|balance)|\\bquota\\b|billing|payment|account is not active|${AUTH_FAULT.source}`,
|
|
167
308
|
'i',
|
|
168
309
|
)
|
|
169
310
|
|
|
@@ -177,8 +318,12 @@ export function isThrottleOrOverload(raw: string): boolean {
|
|
|
177
318
|
return THROTTLE_OR_OVERLOAD.test(raw)
|
|
178
319
|
}
|
|
179
320
|
|
|
321
|
+
// A local pre-request failure can carry observer text it merely echoes; the
|
|
322
|
+
// request it was preparing was never sent, so it must not count toward the
|
|
323
|
+
// no-progress envelope or trip the codex provider circuit.
|
|
180
324
|
export function isObserverTtfbTimeout(raw: string): boolean {
|
|
181
|
-
|
|
325
|
+
if (LOCAL_PRE_REQUEST_FAILURE.test(raw)) return false
|
|
326
|
+
return (MARKED_OBSERVER_TIMEOUT.test(raw) && OBSERVER_TTFB_TIMEOUT.test(raw)) || SDK_CONNECTION_TIMEOUT.test(raw)
|
|
182
327
|
}
|
|
183
328
|
|
|
184
329
|
// Failover predicate for turn-drivers' `shouldFailover`: rotate to the next model
|
|
@@ -199,10 +344,16 @@ export function isFailoverWorthy(raw: string): boolean {
|
|
|
199
344
|
// means the model is out of capacity NOW, so the right move is to fail OVER to a
|
|
200
345
|
// different ref, not hammer the same one — whereas a socket hang-up or a 500 is a
|
|
201
346
|
// one-off blip a replay against the SAME ref often fixes. `\b` anchors the 5xx
|
|
202
|
-
// codes so they don't match digit runs in prose.
|
|
203
|
-
//
|
|
347
|
+
// codes so they don't match digit runs in prose. Streaming APIs often report a
|
|
348
|
+
// provider-side 500 inside the event stream with no status code at all, only
|
|
349
|
+
// the provider's own name for it: OpenAI/Codex `server_error` ("An error
|
|
350
|
+
// occurred while processing your request"), Anthropic `api_error`, Gemini
|
|
351
|
+
// `INTERNAL` ("An internal error has occurred"), and the generic "internal
|
|
352
|
+
// server error" / "bad gateway" / "gateway timeout" wording proxies use.
|
|
353
|
+
// Provider protocol tokens — English by design (the system-token exception to
|
|
354
|
+
// the multi-language rule).
|
|
204
355
|
const NETWORK_OR_5XX =
|
|
205
|
-
/econnreset|econnrefused|etimedout|enetunreach|socket hang up|network.?error|connection.?(?:error|refused|reset|lost)|fetch failed|other side closed|reset before headers|http2 request did not get a response|\b(?:500|502|504)\b/i
|
|
356
|
+
/econnreset|econnrefused|etimedout|enetunreach|socket hang up|network.?error|connection.?(?:error|refused|reset|lost)|fetch failed|other side closed|reset before headers|http2 request did not get a response|\b(?:server_error|api_error)\b|"INTERNAL"|an error occurred while processing your request|an internal error has occurred|internal server error|bad gateway|gateway time-?out|\b(?:500|502|504)\b/i
|
|
206
357
|
|
|
207
358
|
// Retry predicate for typeclaw-owned SAME-REF retry: replay the SAME model ref
|
|
208
359
|
// before advancing the chain. Deliberately NARROWER than `isFailoverWorthy` —
|
|
@@ -225,6 +376,22 @@ export function isRetryableSameRef(raw: string): boolean {
|
|
|
225
376
|
return TRANSPORT_FAILURE.test(raw) || OBSERVER_TIMEOUT.test(raw) || NETWORK_OR_5XX.test(raw)
|
|
226
377
|
}
|
|
227
378
|
|
|
379
|
+
// Failures a user can only answer with "try again": a dropped transport, an
|
|
380
|
+
// observer stall, a network/5xx blip, or a provider overload. Channels mark
|
|
381
|
+
// these with a reaction instead of posting a notice. Rate/usage limits are
|
|
382
|
+
// excluded even though they say "try again shortly": they can last hours, and
|
|
383
|
+
// a bare reaction on every message would hide why the agent stopped
|
|
384
|
+
// answering. Account-wide faults stay out via `isRetryableSameRef` and
|
|
385
|
+
// NON_FAILOVER_FAULT.
|
|
386
|
+
const OVERLOAD = /overloaded|service.?unavailable|\b503\b/i
|
|
387
|
+
const RATE_OR_USAGE_LIMIT = /usage.?limit|rate.?limit|too many requests|\b429\b/i
|
|
388
|
+
|
|
389
|
+
export function isTransientProviderFailure(raw: string): boolean {
|
|
390
|
+
if (RATE_OR_USAGE_LIMIT.test(raw)) return false
|
|
391
|
+
if (isRetryableSameRef(raw)) return true
|
|
392
|
+
return !NON_FAILOVER_FAULT.test(raw) && !CONTEXT_OVERFLOW.test(raw) && OVERLOAD.test(raw)
|
|
393
|
+
}
|
|
394
|
+
|
|
228
395
|
export function detectProviderError(message: unknown): DetectedProviderError | null {
|
|
229
396
|
if (typeof message !== 'object' || message === null) return null
|
|
230
397
|
const m = message as { role?: unknown; stopReason?: unknown; errorMessage?: unknown }
|
|
@@ -243,7 +410,9 @@ export function detectProviderError(message: unknown): DetectedProviderError | n
|
|
|
243
410
|
// NOT an operator-actionable provider failure (internal bugs, network blips),
|
|
244
411
|
// so the caller stays silent-with-log rather than spamming channels. The three
|
|
245
412
|
// recognized classes are: failover-worthy throttle/overload, account-wide faults
|
|
246
|
-
// (billing/quota/auth) that must surface, and observer stall timeouts.
|
|
413
|
+
// (billing/quota/auth) that must surface, and observer stall timeouts. A throw
|
|
414
|
+
// carrying the local pre-request marker surfaces too (via NON_FAILOVER_FAULT)
|
|
415
|
+
// with the LOCAL notice; an unmarked internal error still returns `null`.
|
|
247
416
|
export function detectHardProviderError(err: unknown): DetectedProviderError | null {
|
|
248
417
|
const message = err instanceof Error ? err.message : String(err)
|
|
249
418
|
const isProviderFailure =
|
|
@@ -10,15 +10,10 @@ export { restartHandoffPath } from './paths'
|
|
|
10
10
|
|
|
11
11
|
export const RESTART_HANDOFF_TTL_MS = 60_000
|
|
12
12
|
|
|
13
|
-
//
|
|
14
|
-
//
|
|
15
|
-
//
|
|
16
|
-
//
|
|
17
|
-
// without this the SIGTERM read-modify-write can interleave with `/restart`'s
|
|
18
|
-
// write and drop the originating session's origin/author or its interrupted
|
|
19
|
-
// children. This is NOT a cross-process lock — both producers live in this one
|
|
20
|
-
// container process; the event loop yields at every await, so a promise-chain
|
|
21
|
-
// mutex is all that's needed. Keyed by handoff path so distinct agent dirs
|
|
13
|
+
// Serialize ordinary restart-handoff reads and writes within one process.
|
|
14
|
+
// This is not a cross-process lock. Background launch inventory transfers
|
|
15
|
+
// non-TTL interrupted work to the runtime outbox; it neither augments this
|
|
16
|
+
// greeting nor relies on a SIGTERM sampler. Key by path so distinct agent dirs
|
|
22
17
|
// (tests) never contend.
|
|
23
18
|
const handoffLocks = new Map<string, Promise<void>>()
|
|
24
19
|
|
|
@@ -76,11 +71,9 @@ export type RestartHandoff = {
|
|
|
76
71
|
// whatever bare-channel rule matches on every "I'm back" turn. Optional and
|
|
77
72
|
// additive: pre-field v2 handoffs and tui handoffs omit it.
|
|
78
73
|
triggeringAuthorId?: string
|
|
79
|
-
//
|
|
80
|
-
//
|
|
81
|
-
//
|
|
82
|
-
// TTL, so a stop→idle-for-hours→start drops it instead of replaying a stale
|
|
83
|
-
// notice into a moved-on conversation.
|
|
74
|
+
// Lost-work names accepted from older handoffs. Channel boot excludes these
|
|
75
|
+
// from model greetings: covered launch recovery belongs to the outbox.
|
|
76
|
+
// Ordinary handoffs retain the greeting's 60s TTL.
|
|
84
77
|
interruptedSubagents?: string[]
|
|
85
78
|
}
|
|
86
79
|
|