typeclaw 0.49.0 → 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 +9 -2
- package/scripts/build-plugin-types.ts +105 -0
- package/scripts/check-plugin-sdk.ts +111 -0
- 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 +74 -16
- package/src/agent/live-subagents.ts +19 -0
- package/src/agent/multimodal/look-at.ts +22 -9
- package/src/agent/plugin-tools.ts +13 -1
- package/src/agent/reviewer-bash-policy.ts +41 -1
- package/src/agent/session-origin.ts +26 -10
- package/src/agent/subagent-cache-keepalive.ts +198 -0
- package/src/agent/subagent-session.ts +6 -0
- package/src/agent/subagents.ts +46 -8
- package/src/agent/system-prompt.ts +1 -1
- package/src/agent/tool-file-safety.ts +6 -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-read.ts +57 -10
- package/src/agent/tools/channel-reply.ts +33 -26
- package/src/agent/tools/channel-send.ts +21 -13
- package/src/agent/tools/channel-session-search.ts +35 -0
- package/src/agent/tools/curl-impersonate.ts +11 -4
- package/src/agent/tools/ddg.ts +13 -5
- package/src/agent/tools/spawn-subagent.ts +27 -11
- package/src/agent/tools/stream-snapshot.ts +15 -2
- package/src/agent/tools/subagent-access.ts +11 -4
- 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/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 +4 -0
- package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
- package/src/bundled-plugins/github-cli-auth/index.ts +75 -59
- 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 +1 -1
- 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/security/index.ts +53 -34
- 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.ts +97 -5
- package/src/channels/adapters/github/index.ts +16 -0
- package/src/channels/adapters/github/last-alive.ts +4 -16
- 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 +1 -0
- package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
- package/src/channels/adapters/slack-bot.ts +299 -67
- package/src/channels/adapters/slack-classify.ts +1 -0
- package/src/channels/catch-up.ts +137 -0
- package/src/channels/continuation-willingness.ts +2 -2
- package/src/channels/continuity-types.ts +1 -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-token-bridge.ts +24 -0
- package/src/channels/last-alive.ts +34 -0
- package/src/channels/manager.ts +8 -1
- package/src/channels/router.ts +427 -136
- 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/types.ts +12 -2
- package/src/cli/channel.ts +2 -3
- package/src/cli/init.ts +2 -3
- package/src/cli/model.ts +132 -3
- package/src/coding-agent/index.ts +7 -1
- package/src/coding-agent/omo-stream.ts +40 -0
- package/src/coding-agent/runner.ts +30 -8
- package/src/config/config.ts +111 -22
- 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 +59 -0
- package/src/container/start.ts +95 -4
- package/src/doctor/checks.ts +8 -6
- package/src/hostd/daemon.ts +13 -1
- package/src/init/auto-upgrade.ts +7 -1
- package/src/init/dockerfile.ts +57 -12
- package/src/init/index.ts +4 -3
- 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/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/hooks.ts +137 -0
- package/src/plugin/index.ts +6 -0
- package/src/plugin/manager.ts +4 -0
- package/src/plugin/types.ts +60 -0
- package/src/run/bundled-plugins.ts +6 -0
- package/src/run/index.ts +24 -14
- package/src/run/llm-fetch-observer.ts +12 -15
- package/src/sandbox/canonical-secrets.ts +4 -0
- package/src/sandbox/dev-source.ts +26 -0
- package/src/sandbox/hidden-paths.ts +16 -2
- package/src/secrets/storage.ts +13 -0
- package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
- package/src/skills/typeclaw-config/SKILL.md +39 -5
- package/src/skills/typeclaw-config/references/dockerfile.md +2 -2
- package/src/skills/typeclaw-github-contributing/SKILL.md +1 -1
- package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
- package/src/skills/typeclaw-permissions/SKILL.md +7 -7
- package/src/skills/typeclaw-troubleshooting/SKILL.md +12 -1
- package/typeclaw.schema.json +436 -5
- package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
- package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
#!/usr/bin/env bun
|
|
2
|
+
|
|
3
|
+
import { rm } from 'node:fs/promises'
|
|
4
|
+
import { dirname, join, relative } from 'node:path'
|
|
5
|
+
import { fileURLToPath } from 'node:url'
|
|
6
|
+
|
|
7
|
+
import * as ts from '@typescript/typescript6'
|
|
8
|
+
|
|
9
|
+
const root = join(dirname(fileURLToPath(import.meta.url)), '..')
|
|
10
|
+
const sourceRoot = join(root, 'src')
|
|
11
|
+
const outputRoot = join(root, 'dist', 'types')
|
|
12
|
+
const configPath = join(root, 'tsconfig.json')
|
|
13
|
+
const config = ts.readConfigFile(configPath, ts.sys.readFile)
|
|
14
|
+
if (config.error) throw new Error(ts.flattenDiagnosticMessageText(config.error.messageText, '\n'))
|
|
15
|
+
const parsed = ts.parseJsonConfigFileContent(config.config, ts.sys, root)
|
|
16
|
+
const options: ts.CompilerOptions = {
|
|
17
|
+
...parsed.options,
|
|
18
|
+
noEmit: false,
|
|
19
|
+
noEmitOnError: true,
|
|
20
|
+
declaration: true,
|
|
21
|
+
declarationMap: false,
|
|
22
|
+
emitDeclarationOnly: true,
|
|
23
|
+
rootDir: sourceRoot,
|
|
24
|
+
outDir: outputRoot,
|
|
25
|
+
}
|
|
26
|
+
const program = ts.createProgram([join(sourceRoot, 'plugin', 'index.ts')], options)
|
|
27
|
+
const resolutionCache = ts.createModuleResolutionCache(root, (path) => path, options)
|
|
28
|
+
|
|
29
|
+
// Keep the emitted graph self-contained: consumers must not inherit our @/*
|
|
30
|
+
// aliases. Explicit .js specifiers also work with NodeNext declaration lookup.
|
|
31
|
+
const rewriteImports: ts.TransformerFactory<ts.SourceFile | ts.Bundle> = (context) => {
|
|
32
|
+
return (source) => {
|
|
33
|
+
if (ts.isBundle(source)) return source
|
|
34
|
+
const rewrite = (specifier: ts.StringLiteral): ts.StringLiteral => {
|
|
35
|
+
if (!specifier.text.startsWith('@/') && !specifier.text.startsWith('.')) return specifier
|
|
36
|
+
const resolved = ts.resolveModuleName(
|
|
37
|
+
specifier.text,
|
|
38
|
+
source.fileName,
|
|
39
|
+
options,
|
|
40
|
+
ts.sys,
|
|
41
|
+
resolutionCache,
|
|
42
|
+
).resolvedModule
|
|
43
|
+
if (!resolved) throw new Error(`Cannot resolve SDK declaration import ${specifier.text} in ${source.fileName}`)
|
|
44
|
+
let path = relative(dirname(source.fileName), resolved.resolvedFileName).replaceAll('\\', '/')
|
|
45
|
+
path = path
|
|
46
|
+
.replace(/\.tsx?$/, '.js')
|
|
47
|
+
.replace(/\.mts$/, '.mjs')
|
|
48
|
+
.replace(/\.cts$/, '.cjs')
|
|
49
|
+
return context.factory.createStringLiteral(path.startsWith('.') ? path : `./${path}`)
|
|
50
|
+
}
|
|
51
|
+
const visit: ts.Visitor = (node) => {
|
|
52
|
+
if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier))
|
|
53
|
+
return context.factory.updateImportDeclaration(
|
|
54
|
+
node,
|
|
55
|
+
node.modifiers,
|
|
56
|
+
node.importClause,
|
|
57
|
+
rewrite(node.moduleSpecifier),
|
|
58
|
+
node.attributes,
|
|
59
|
+
)
|
|
60
|
+
if (ts.isExportDeclaration(node) && node.moduleSpecifier && ts.isStringLiteral(node.moduleSpecifier))
|
|
61
|
+
return context.factory.updateExportDeclaration(
|
|
62
|
+
node,
|
|
63
|
+
node.modifiers,
|
|
64
|
+
node.isTypeOnly,
|
|
65
|
+
node.exportClause,
|
|
66
|
+
rewrite(node.moduleSpecifier),
|
|
67
|
+
node.attributes,
|
|
68
|
+
)
|
|
69
|
+
if (ts.isImportTypeNode(node) && ts.isLiteralTypeNode(node.argument) && ts.isStringLiteral(node.argument.literal))
|
|
70
|
+
return context.factory.updateImportTypeNode(
|
|
71
|
+
node,
|
|
72
|
+
context.factory.createLiteralTypeNode(rewrite(node.argument.literal)),
|
|
73
|
+
node.attributes,
|
|
74
|
+
node.qualifier,
|
|
75
|
+
node.typeArguments,
|
|
76
|
+
node.isTypeOf,
|
|
77
|
+
)
|
|
78
|
+
return ts.visitEachChild(node, visit, context)
|
|
79
|
+
}
|
|
80
|
+
return ts.visitNode(source, visit) as ts.SourceFile
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
const diagnostics = [...parsed.errors, ...ts.getPreEmitDiagnostics(program)]
|
|
85
|
+
if (diagnostics.some((diagnostic) => diagnostic.category === ts.DiagnosticCategory.Error)) {
|
|
86
|
+
console.error(
|
|
87
|
+
ts.formatDiagnostics(diagnostics, {
|
|
88
|
+
getCanonicalFileName: (path) => path,
|
|
89
|
+
getCurrentDirectory: () => root,
|
|
90
|
+
getNewLine: () => '\n',
|
|
91
|
+
}),
|
|
92
|
+
)
|
|
93
|
+
process.exit(1)
|
|
94
|
+
}
|
|
95
|
+
await rm(outputRoot, { recursive: true, force: true })
|
|
96
|
+
const result = program.emit(undefined, undefined, undefined, true, { afterDeclarations: [rewriteImports] })
|
|
97
|
+
if (result.emitSkipped || result.diagnostics.some((diagnostic) => diagnostic.category === ts.DiagnosticCategory.Error))
|
|
98
|
+
throw new Error(
|
|
99
|
+
ts.formatDiagnostics(result.diagnostics, {
|
|
100
|
+
getCanonicalFileName: (path) => path,
|
|
101
|
+
getCurrentDirectory: () => root,
|
|
102
|
+
getNewLine: () => '\n',
|
|
103
|
+
}),
|
|
104
|
+
)
|
|
105
|
+
console.log('Built public plugin declarations under dist/types')
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
#!/usr/bin/env bun
|
|
2
|
+
|
|
3
|
+
import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises'
|
|
4
|
+
import { tmpdir } from 'node:os'
|
|
5
|
+
import { dirname, join } from 'node:path'
|
|
6
|
+
import { fileURLToPath } from 'node:url'
|
|
7
|
+
|
|
8
|
+
const root = join(dirname(fileURLToPath(import.meta.url)), '..')
|
|
9
|
+
const scratch = await mkdtemp(join(tmpdir(), 'typeclaw-plugin-sdk-'))
|
|
10
|
+
const manifest = await Bun.file(join(root, 'package.json')).json()
|
|
11
|
+
const bunTypes = await Bun.file(join(root, 'node_modules', '@types', 'bun', 'package.json')).json()
|
|
12
|
+
|
|
13
|
+
async function run(argv: string[], cwd: string): Promise<string> {
|
|
14
|
+
const child = Bun.spawn(argv, { cwd, stdin: 'ignore', stdout: 'pipe', stderr: 'pipe' })
|
|
15
|
+
const [stdout, stderr, code] = await Promise.all([
|
|
16
|
+
new Response(child.stdout).text(),
|
|
17
|
+
new Response(child.stderr).text(),
|
|
18
|
+
child.exited,
|
|
19
|
+
])
|
|
20
|
+
if (code !== 0) throw new Error(`${argv.join(' ')} failed (${code})\n${stdout}\n${stderr}`)
|
|
21
|
+
return stdout
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
try {
|
|
25
|
+
// Exercise the real prepack lifecycle. Installing with scripts disabled then
|
|
26
|
+
// proves declaration consumers do not need our dev compiler or install hook.
|
|
27
|
+
await run(['npm', 'pack', '--pack-destination', scratch], root)
|
|
28
|
+
const archiveName = `typeclaw-${manifest.version}.tgz`
|
|
29
|
+
const consumer = join(scratch, 'consumer')
|
|
30
|
+
await mkdir(consumer)
|
|
31
|
+
await writeFile(
|
|
32
|
+
join(consumer, 'package.json'),
|
|
33
|
+
JSON.stringify({
|
|
34
|
+
name: 'example-plugin-consumer',
|
|
35
|
+
private: true,
|
|
36
|
+
type: 'module',
|
|
37
|
+
dependencies: { typeclaw: `file:../${archiveName}`, zod: manifest.dependencies.zod },
|
|
38
|
+
devDependencies: { '@types/bun': bunTypes.version },
|
|
39
|
+
}),
|
|
40
|
+
)
|
|
41
|
+
await run([process.execPath, 'install', '--ignore-scripts'], consumer)
|
|
42
|
+
await writeFile(
|
|
43
|
+
join(consumer, 'tsconfig.json'),
|
|
44
|
+
JSON.stringify({
|
|
45
|
+
compilerOptions: {
|
|
46
|
+
target: 'ESNext',
|
|
47
|
+
module: 'Preserve',
|
|
48
|
+
moduleResolution: 'bundler',
|
|
49
|
+
strict: true,
|
|
50
|
+
skipLibCheck: true,
|
|
51
|
+
noEmit: true,
|
|
52
|
+
types: ['bun'],
|
|
53
|
+
},
|
|
54
|
+
include: ['plugin.ts'],
|
|
55
|
+
}),
|
|
56
|
+
)
|
|
57
|
+
await writeFile(
|
|
58
|
+
join(consumer, 'plugin.ts'),
|
|
59
|
+
`
|
|
60
|
+
import { definePlugin, type Hooks } from 'typeclaw/plugin'
|
|
61
|
+
import { z } from 'zod'
|
|
62
|
+
const hooks = {
|
|
63
|
+
'tool.before': (event) => {
|
|
64
|
+
const tool: string = event.tool
|
|
65
|
+
// @ts-expect-error tool identifiers must remain strings, not any
|
|
66
|
+
const invalid: number = event.tool
|
|
67
|
+
return tool ? undefined : { block: true as const, reason: 'empty tool' }
|
|
68
|
+
},
|
|
69
|
+
} satisfies Hooks
|
|
70
|
+
// @ts-expect-error unsupported hook names must not become valid or any
|
|
71
|
+
const unsupported: keyof Hooks = 'session.strat'
|
|
72
|
+
export default definePlugin({
|
|
73
|
+
configSchema: z.object({ enabled: z.boolean() }),
|
|
74
|
+
plugin: async (ctx) => {
|
|
75
|
+
const enabled: boolean = ctx.config.enabled
|
|
76
|
+
// @ts-expect-error schema-inferred config must not become any
|
|
77
|
+
const invalid: string = ctx.config.enabled
|
|
78
|
+
return enabled ? { hooks } : {}
|
|
79
|
+
},
|
|
80
|
+
})
|
|
81
|
+
`,
|
|
82
|
+
)
|
|
83
|
+
for (const [module, resolution] of [
|
|
84
|
+
['Preserve', 'bundler'],
|
|
85
|
+
['NodeNext', 'NodeNext'],
|
|
86
|
+
]) {
|
|
87
|
+
const output = await run(
|
|
88
|
+
[
|
|
89
|
+
process.execPath,
|
|
90
|
+
'run',
|
|
91
|
+
'typecheck',
|
|
92
|
+
'--project',
|
|
93
|
+
join(consumer, 'tsconfig.json'),
|
|
94
|
+
'--module',
|
|
95
|
+
module!,
|
|
96
|
+
'--moduleResolution',
|
|
97
|
+
resolution!,
|
|
98
|
+
'--listFiles',
|
|
99
|
+
],
|
|
100
|
+
root,
|
|
101
|
+
)
|
|
102
|
+
const files = output.split(/\r?\n/).map((file) => file.replaceAll('\\', '/'))
|
|
103
|
+
if (files.some((file) => file.includes('/node_modules/typeclaw/src/')))
|
|
104
|
+
throw new Error('The public SDK pulled TypeClaw implementation sources into the consumer.')
|
|
105
|
+
if (!files.some((file) => file.endsWith('/node_modules/typeclaw/dist/types/plugin/index.d.ts')))
|
|
106
|
+
throw new Error('The packed public SDK declaration entry was not resolved.')
|
|
107
|
+
console.log(`Packed plugin consumer passed ${resolution} resolution without source imports or @/* aliases`)
|
|
108
|
+
}
|
|
109
|
+
} finally {
|
|
110
|
+
await rm(scratch, { recursive: true, force: true })
|
|
111
|
+
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
// Preloaded by bunfig.toml `[test] preload
|
|
2
|
-
//
|
|
3
|
-
//
|
|
1
|
+
// Preloaded by bunfig.toml `[test] preload` to deny `bun test` without
|
|
2
|
+
// --parallel. The default timeout belongs in bunfig.toml, not this preload,
|
|
3
|
+
// so an explicit CLI --timeout keeps its normal precedence.
|
|
4
4
|
//
|
|
5
5
|
// Why deny serial runs: Serial runs are ~3.4x slower (44s → 13s, see commit
|
|
6
6
|
// 1c66d5e), and Bun has no bunfig knob for the flag yet (verified against
|
|
@@ -18,39 +18,12 @@
|
|
|
18
18
|
//
|
|
19
19
|
// Bypass with TYPECLAW_ALLOW_SERIAL_TESTS=1 when debugging a flaky test
|
|
20
20
|
// where worker contention obscures the failure.
|
|
21
|
-
//
|
|
22
|
-
// Why raise the default timeout: A growing number of tests in this repo
|
|
23
|
-
// either spawn child processes (`bun run typeclaw …` via Bun.spawn from
|
|
24
|
-
// src/cli/index.test.ts, src/cli/role.test.ts, src/cli/status.test.ts,
|
|
25
|
-
// src/init/dockerfile.test.ts agent-browser wrapper, etc.) or boot the
|
|
26
|
-
// in-process agent (`startAgent({ port: 0, … })` from src/run/plugin.test.ts).
|
|
27
|
-
// Both shapes have a happy-path cost well under 1s but a worst-case cost
|
|
28
|
-
// that races Bun's 5000ms ceiling under `--parallel` contention. The
|
|
29
|
-
// repeating failure mode is "this test timed out after 5000ms" appearing
|
|
30
|
-
// on different tests across runs at a rough ~3-15% rate per full-suite
|
|
31
|
-
// invocation — not a real bug, just resource starvation. Raising the
|
|
32
|
-
// default to 30s eliminates the false positives without masking real
|
|
33
|
-
// hangs (a wedged test still fails, just 6x slower than before). The
|
|
34
|
-
// happy path is unaffected because tests complete in their actual
|
|
35
|
-
// runtime, not the timeout budget.
|
|
36
|
-
//
|
|
37
|
-
// 30s was chosen as ~75x the observed happy-path cold-start (~400ms) for
|
|
38
|
-
// the heaviest subprocess tests, matching the in-house convention used in
|
|
39
|
-
// pi-coding-agent's subprocess fixtures and Bun's own integration-test
|
|
40
|
-
// suites (see oven-sh/bun test/cli/install/*.test.ts which set 5-minute
|
|
41
|
-
// timeouts for full installs). Individual tests that genuinely need more
|
|
42
|
-
// can still pass an explicit 3rd arg to `test()` to override locally.
|
|
43
|
-
|
|
44
|
-
import { setDefaultTimeout } from 'bun:test'
|
|
45
21
|
|
|
46
22
|
const isParallelWorker = typeof process.env.BUN_TEST_WORKER_ID === 'string'
|
|
47
23
|
|
|
48
|
-
if (isParallelWorker) {
|
|
49
|
-
setDefaultTimeout(30_000)
|
|
50
|
-
} else if (process.env.TYPECLAW_ALLOW_SERIAL_TESTS === '1') {
|
|
24
|
+
if (!isParallelWorker && process.env.TYPECLAW_ALLOW_SERIAL_TESTS === '1') {
|
|
51
25
|
console.warn('[require-parallel] Running serially — TYPECLAW_ALLOW_SERIAL_TESTS=1 set.')
|
|
52
|
-
|
|
53
|
-
} else {
|
|
26
|
+
} else if (!isParallelWorker) {
|
|
54
27
|
console.error('')
|
|
55
28
|
console.error(' ✗ `bun test` without --parallel is denied in this repo.')
|
|
56
29
|
console.error('')
|
package/src/agent/guard-types.ts
CHANGED
|
@@ -21,5 +21,8 @@ export type InternalGuard = {
|
|
|
21
21
|
readonly owner: string
|
|
22
22
|
readonly key: string
|
|
23
23
|
readonly tools: ReadonlySet<string>
|
|
24
|
+
// Hygiene guards that protect no boundary set this so a bug in their check
|
|
25
|
+
// is logged and skipped instead of denying every call to their tools.
|
|
26
|
+
readonly skipOnCheckError?: true
|
|
24
27
|
readonly check: (event: InternalGuardEvent) => InternalGuardResult | Promise<InternalGuardResult>
|
|
25
28
|
}
|
package/src/agent/guards.ts
CHANGED
|
@@ -35,6 +35,7 @@ export function buildInternalGuards(agentDir: string): readonly InternalGuard[]
|
|
|
35
35
|
owner: 'guard',
|
|
36
36
|
key: GUARD_IMAGE_READ_REDIRECT,
|
|
37
37
|
tools: ['read'],
|
|
38
|
+
skipOnCheckError: true,
|
|
38
39
|
check: checkImageReadRedirect,
|
|
39
40
|
},
|
|
40
41
|
{
|
|
@@ -54,18 +55,21 @@ export function buildInternalGuards(agentDir: string): readonly InternalGuard[]
|
|
|
54
55
|
owner: 'bun-hygiene',
|
|
55
56
|
key: GUARD_GLOBAL_INSTALL,
|
|
56
57
|
tools: ['bash'],
|
|
58
|
+
skipOnCheckError: true,
|
|
57
59
|
check: checkGlobalInstallGuard,
|
|
58
60
|
},
|
|
59
61
|
{
|
|
60
62
|
owner: 'bun-hygiene',
|
|
61
63
|
key: GUARD_NON_BUN_PACKAGE_MANAGER,
|
|
62
64
|
tools: ['bash'],
|
|
65
|
+
skipOnCheckError: true,
|
|
63
66
|
check: checkNonBunPackageManagerGuard,
|
|
64
67
|
},
|
|
65
68
|
{
|
|
66
69
|
owner: 'bun-hygiene',
|
|
67
70
|
key: GUARD_NON_BUN_PACKAGE_RUNNER,
|
|
68
71
|
tools: ['bash'],
|
|
72
|
+
skipOnCheckError: true,
|
|
69
73
|
check: checkNonBunPackageRunnerGuard,
|
|
70
74
|
},
|
|
71
75
|
]
|
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
import { Agent, type StreamFn } from '@earendil-works/pi-agent-core'
|
|
2
|
+
import { AgentSession, DefaultResourceLoader, SessionManager, SettingsManager } from '@earendil-works/pi-coding-agent'
|
|
3
|
+
|
|
4
|
+
import { compactionTriggerTokens } from './compaction'
|
|
5
|
+
|
|
6
|
+
type IdleSchedule = (run: () => Promise<void>) => () => void
|
|
7
|
+
|
|
8
|
+
// Leave ten percent of the normal budget for the next input and response.
|
|
9
|
+
const IDLE_COMPACTION_TRIGGER_RATIO = 0.9
|
|
10
|
+
|
|
11
|
+
export function attachIdleCompaction(
|
|
12
|
+
session: AgentSession,
|
|
13
|
+
options: { schedule?: IdleSchedule; onApplied?: () => void } = {},
|
|
14
|
+
): () => void {
|
|
15
|
+
const schedule = options.schedule ?? scheduleIdle
|
|
16
|
+
// Capture before turn drivers install output caps that apply only to replies.
|
|
17
|
+
const stream = session.agent.streamFunction
|
|
18
|
+
let cancelScheduled: (() => void) | undefined
|
|
19
|
+
let pending: { cancelled: boolean; session?: AgentSession } | undefined
|
|
20
|
+
let attemptedLeaf: string | null | undefined
|
|
21
|
+
let disposed = false
|
|
22
|
+
|
|
23
|
+
const cancel = () => {
|
|
24
|
+
cancelScheduled?.()
|
|
25
|
+
cancelScheduled = undefined
|
|
26
|
+
if (pending) {
|
|
27
|
+
pending.cancelled = true
|
|
28
|
+
pending.session?.abortCompaction()
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
const run = async () => {
|
|
33
|
+
cancelScheduled = undefined
|
|
34
|
+
const model = session.model
|
|
35
|
+
const leaf = session.sessionManager.getLeafId()
|
|
36
|
+
const tokens = session.getContextUsage()?.tokens
|
|
37
|
+
if (
|
|
38
|
+
disposed ||
|
|
39
|
+
pending ||
|
|
40
|
+
!session.isIdle ||
|
|
41
|
+
!session.autoCompactionEnabled ||
|
|
42
|
+
!model ||
|
|
43
|
+
leaf === attemptedLeaf ||
|
|
44
|
+
tokens == null ||
|
|
45
|
+
tokens < compactionTriggerTokens(model) * IDLE_COMPACTION_TRIGGER_RATIO
|
|
46
|
+
)
|
|
47
|
+
return
|
|
48
|
+
|
|
49
|
+
attemptedLeaf = leaf
|
|
50
|
+
const thinkingLevel = session.thinkingLevel
|
|
51
|
+
const generation: { cancelled: boolean; session?: AgentSession } = { cancelled: false }
|
|
52
|
+
pending = generation
|
|
53
|
+
try {
|
|
54
|
+
generation.session = snapshotSession(session, stream)
|
|
55
|
+
const result = await generation.session.compact()
|
|
56
|
+
// No await between validation and append/refresh: the live branch cannot
|
|
57
|
+
// change between the validity check and the append-only checkpoint.
|
|
58
|
+
if (
|
|
59
|
+
generation.cancelled ||
|
|
60
|
+
disposed ||
|
|
61
|
+
!session.isIdle ||
|
|
62
|
+
session.model !== model ||
|
|
63
|
+
session.thinkingLevel !== thinkingLevel ||
|
|
64
|
+
session.sessionManager.getLeafId() !== leaf
|
|
65
|
+
)
|
|
66
|
+
return
|
|
67
|
+
session.sessionManager.appendCompaction(
|
|
68
|
+
result.summary,
|
|
69
|
+
result.firstKeptEntryId,
|
|
70
|
+
result.tokensBefore,
|
|
71
|
+
result.details,
|
|
72
|
+
false,
|
|
73
|
+
result.usage,
|
|
74
|
+
)
|
|
75
|
+
session.refreshContext()
|
|
76
|
+
options.onApplied?.()
|
|
77
|
+
} catch (error) {
|
|
78
|
+
// This is an optional background operation. Pi owns bounded transient
|
|
79
|
+
// retries; a final failure leaves ordinary foreground compaction intact.
|
|
80
|
+
if (!generation.cancelled && !disposed) {
|
|
81
|
+
console.warn(
|
|
82
|
+
`[agent] ${session.sessionId}: idle compaction failed: ${error instanceof Error ? error.message : String(error)}`,
|
|
83
|
+
)
|
|
84
|
+
}
|
|
85
|
+
} finally {
|
|
86
|
+
generation.session?.dispose()
|
|
87
|
+
if (pending === generation) pending = undefined
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
|
|
91
|
+
const unsubscribe = session.subscribe((event) => {
|
|
92
|
+
if (event.type === 'agent_settled') {
|
|
93
|
+
cancelScheduled?.()
|
|
94
|
+
// Scheduling yields past settlement so short-lived cron/subagent sessions
|
|
95
|
+
// can be disposed without starting a summary they will never use.
|
|
96
|
+
const tokens = session.getContextUsage()?.tokens
|
|
97
|
+
const model = session.model
|
|
98
|
+
if (model && tokens != null && tokens >= compactionTriggerTokens(model) * IDLE_COMPACTION_TRIGGER_RATIO) {
|
|
99
|
+
cancelScheduled = schedule(run)
|
|
100
|
+
}
|
|
101
|
+
} else if (event.type === 'agent_start' || event.type === 'compaction_start' || event.type === 'entry_appended') {
|
|
102
|
+
cancel()
|
|
103
|
+
}
|
|
104
|
+
})
|
|
105
|
+
|
|
106
|
+
// Cancel before prompt preflight, not just agent_start: auth and input hooks
|
|
107
|
+
// may await while the provider finishes an idle summary.
|
|
108
|
+
const prompt = session.prompt.bind(session)
|
|
109
|
+
session.prompt = (...args) => {
|
|
110
|
+
cancel()
|
|
111
|
+
return prompt(...args)
|
|
112
|
+
}
|
|
113
|
+
const resume = session.agent.continue.bind(session.agent)
|
|
114
|
+
session.agent.continue = (...args) => {
|
|
115
|
+
cancel()
|
|
116
|
+
return resume(...args)
|
|
117
|
+
}
|
|
118
|
+
const compact = session.compact.bind(session)
|
|
119
|
+
session.compact = (...args) => {
|
|
120
|
+
cancel()
|
|
121
|
+
return compact(...args)
|
|
122
|
+
}
|
|
123
|
+
const dispose = session.dispose.bind(session)
|
|
124
|
+
const stop = () => {
|
|
125
|
+
if (disposed) return
|
|
126
|
+
disposed = true
|
|
127
|
+
cancel()
|
|
128
|
+
unsubscribe()
|
|
129
|
+
session.prompt = prompt
|
|
130
|
+
session.agent.continue = resume
|
|
131
|
+
session.compact = compact
|
|
132
|
+
session.dispose = dispose
|
|
133
|
+
}
|
|
134
|
+
session.dispose = () => {
|
|
135
|
+
stop()
|
|
136
|
+
dispose()
|
|
137
|
+
}
|
|
138
|
+
return stop
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
function scheduleIdle(run: () => Promise<void>): () => void {
|
|
142
|
+
const timer = setTimeout(() => void run(), 0)
|
|
143
|
+
timer.unref()
|
|
144
|
+
return () => clearTimeout(timer)
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
function snapshotSession(source: AgentSession, streamFn: StreamFn): AgentSession {
|
|
148
|
+
const cwd = source.sessionManager.getCwd()
|
|
149
|
+
// No header: pi assigns a separate session ID, preserving entry IDs for the
|
|
150
|
+
// checkpoint without sharing session-scoped provider resources on disposal.
|
|
151
|
+
const sessionManager = SessionManager.inMemory(cwd, undefined, structuredClone(source.sessionManager.getBranch()))
|
|
152
|
+
const settingsManager = SettingsManager.inMemory({
|
|
153
|
+
compaction: source.settingsManager.getCompactionSettings(source.model),
|
|
154
|
+
retry: { enabled: true, maxRetries: 2, baseDelayMs: 2_000 },
|
|
155
|
+
})
|
|
156
|
+
return new AgentSession({
|
|
157
|
+
agent: new Agent({
|
|
158
|
+
initialState: {
|
|
159
|
+
model: source.model,
|
|
160
|
+
thinkingLevel: source.thinkingLevel,
|
|
161
|
+
messages: sessionManager.buildSessionContext().messages,
|
|
162
|
+
},
|
|
163
|
+
streamFn,
|
|
164
|
+
}),
|
|
165
|
+
sessionManager,
|
|
166
|
+
settingsManager,
|
|
167
|
+
modelRuntime: source.modelRuntime,
|
|
168
|
+
// An unloaded loader supplies no tools or extension handlers. The shadow
|
|
169
|
+
// only runs pi's built-in compact(), never a turn or extension lifecycle.
|
|
170
|
+
resourceLoader: new DefaultResourceLoader({ cwd, agentDir: cwd, settingsManager }),
|
|
171
|
+
cwd,
|
|
172
|
+
initialActiveToolNames: [],
|
|
173
|
+
})
|
|
174
|
+
}
|