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,129 @@
|
|
|
1
|
+
import type { ToolDefinition } from '@earendil-works/pi-coding-agent';
|
|
2
|
+
import type { TSchema } from 'typebox';
|
|
3
|
+
import { z } from 'zod';
|
|
4
|
+
import { IncidentLedger } from "../operations/index.js";
|
|
5
|
+
import type { RemediationRegistry } from "../operations/index.js";
|
|
6
|
+
import type { PermissionService } from "../permissions/permissions.js";
|
|
7
|
+
import type { BuiltinToolRef, HookBus, PluginLogger, Tool, ToolFileOperands } from "../plugin/index.js";
|
|
8
|
+
import { buildSandboxedCommand, cleanupPrivilegedSandboxRuntime, commandNeedsRealProc, resolvePrivilegedSandboxRuntime, type SandboxMount, verifyPrivilegedSandboxRuntime } from "../sandbox/index.js";
|
|
9
|
+
import type { InternalGuard } from "./guard-types.js";
|
|
10
|
+
import { type SubagentBashPolicy } from "./reviewer-bash-policy.js";
|
|
11
|
+
import type { SessionOrigin } from "./session-origin.js";
|
|
12
|
+
export declare const TYPECLAW_INTERNAL_BASH_ENV = "__typeclawBashEnv";
|
|
13
|
+
export declare const TYPECLAW_INTERNAL_BASH_WITHHOLD_ENV = "__typeclawBashWithholdEnv";
|
|
14
|
+
export declare const TYPECLAW_INTERNAL_BASH_PREPARE = "__typeclawBashPrepare";
|
|
15
|
+
type BashEnvOverlay = Record<string, string>;
|
|
16
|
+
export type DeferredBashPreparationResult = {
|
|
17
|
+
command: string;
|
|
18
|
+
env?: Record<string, string>;
|
|
19
|
+
mount: Extract<SandboxMount, {
|
|
20
|
+
type: 'ro-bind';
|
|
21
|
+
}>;
|
|
22
|
+
cleanup: () => Promise<void>;
|
|
23
|
+
};
|
|
24
|
+
export type DeferredBashPreparation = () => Promise<DeferredBashPreparationResult>;
|
|
25
|
+
export declare function sanitizeBashSpawnEnvironment(inherited: NodeJS.ProcessEnv | undefined, overlay: BashEnvOverlay | undefined, withhold?: readonly string[]): NodeJS.ProcessEnv;
|
|
26
|
+
export declare function isPiCodingBuiltinName(name: string): boolean;
|
|
27
|
+
export declare function resolveBuiltinToolRefs(refs: BuiltinToolRef[], cwd: string, contextTools?: ReadonlyMap<string, ToolDefinition<any, any, any>>): ToolDefinition<any, any, any>[];
|
|
28
|
+
export type WrapToolOptions = {
|
|
29
|
+
pluginName: string;
|
|
30
|
+
toolName: string;
|
|
31
|
+
agentDir: string;
|
|
32
|
+
sessionId: string;
|
|
33
|
+
logger: PluginLogger;
|
|
34
|
+
hooks: HookBus;
|
|
35
|
+
guards?: readonly InternalGuard[];
|
|
36
|
+
getOrigin?: () => SessionOrigin | undefined;
|
|
37
|
+
permissions?: PermissionService;
|
|
38
|
+
getAbort?: () => ((reason?: string) => void) | undefined;
|
|
39
|
+
getLoopGuardTurn?: () => number | undefined;
|
|
40
|
+
};
|
|
41
|
+
export type BashSandboxBoundary = {
|
|
42
|
+
ensureAvailable: () => Promise<void>;
|
|
43
|
+
buildCommand: typeof buildSandboxedCommand;
|
|
44
|
+
resolveProcStrategy?: () => Promise<ProcStrategyResolution>;
|
|
45
|
+
resolveRuntime?: typeof resolvePrivilegedSandboxRuntime;
|
|
46
|
+
verifyRuntime?: typeof verifyPrivilegedSandboxRuntime;
|
|
47
|
+
cleanupRuntime?: typeof cleanupPrivilegedSandboxRuntime;
|
|
48
|
+
};
|
|
49
|
+
export type WrapSystemToolOptions = {
|
|
50
|
+
agentDir: string;
|
|
51
|
+
sessionId: string;
|
|
52
|
+
hooks: HookBus;
|
|
53
|
+
guards?: readonly InternalGuard[];
|
|
54
|
+
getOrigin?: () => SessionOrigin | undefined;
|
|
55
|
+
getAbort?: () => ((reason?: string) => void) | undefined;
|
|
56
|
+
getLoopGuardTurn?: () => number | undefined;
|
|
57
|
+
permissions?: PermissionService;
|
|
58
|
+
bashPolicy?: SubagentBashPolicy;
|
|
59
|
+
bashSandboxBoundary?: BashSandboxBoundary;
|
|
60
|
+
realProcDependencyCheck?: typeof commandNeedsRealProc;
|
|
61
|
+
remediations?: RemediationRegistry;
|
|
62
|
+
resolvePreflightFileOperands?: (tool: string, args: Record<string, unknown>) => ToolFileOperands | undefined;
|
|
63
|
+
incidentLedger?: IncidentLedger;
|
|
64
|
+
};
|
|
65
|
+
export declare function zodToToolParameters(schema: z.ZodType<unknown>): TSchema;
|
|
66
|
+
export declare function wrapPluginTool(tool: Tool<any>, opts: WrapToolOptions): ToolDefinition;
|
|
67
|
+
export declare function wrapSystemTool<TParams extends TSchema, TDetails = unknown, TState = unknown>(tool: ToolDefinition<TParams, TDetails, TState>, opts: WrapSystemToolOptions): ToolDefinition<TParams, TDetails, TState>;
|
|
68
|
+
export declare function wrapBuiltinToolDefinition<TParams extends TSchema, TDetails = unknown, TState = any>(tool: ToolDefinition<TParams, TDetails, TState>, opts: WrapSystemToolOptions): ToolDefinition<TParams, TDetails, TState>;
|
|
69
|
+
export declare function defaultBuiltinPiToolDefinitions(cwd: string): ToolDefinition<any, any, any>[];
|
|
70
|
+
export declare function buildBuiltinPiToolOverrides(opts: WrapSystemToolOptions): ToolDefinition<any, any>[];
|
|
71
|
+
type BashFilesystemPolicyOptions = {
|
|
72
|
+
agentDir: string;
|
|
73
|
+
canWriteAgentRoot: boolean;
|
|
74
|
+
masks: {
|
|
75
|
+
dirs: string[];
|
|
76
|
+
files: string[];
|
|
77
|
+
};
|
|
78
|
+
writable: {
|
|
79
|
+
dirs: string[];
|
|
80
|
+
files: string[];
|
|
81
|
+
};
|
|
82
|
+
protected: {
|
|
83
|
+
dirs: string[];
|
|
84
|
+
files: string[];
|
|
85
|
+
};
|
|
86
|
+
};
|
|
87
|
+
export declare function buildBashFilesystemPolicy(options: BashFilesystemPolicyOptions): {
|
|
88
|
+
writableRoot: {
|
|
89
|
+
dir: string;
|
|
90
|
+
};
|
|
91
|
+
masks: {
|
|
92
|
+
dirs: string[];
|
|
93
|
+
files: string[];
|
|
94
|
+
};
|
|
95
|
+
protected: {
|
|
96
|
+
dirs: string[];
|
|
97
|
+
files: string[];
|
|
98
|
+
};
|
|
99
|
+
writable?: undefined;
|
|
100
|
+
} | {
|
|
101
|
+
masks: {
|
|
102
|
+
dirs: string[];
|
|
103
|
+
files: string[];
|
|
104
|
+
};
|
|
105
|
+
writable: {
|
|
106
|
+
dirs: string[];
|
|
107
|
+
files: string[];
|
|
108
|
+
};
|
|
109
|
+
protected: {
|
|
110
|
+
dirs: string[];
|
|
111
|
+
files: string[];
|
|
112
|
+
};
|
|
113
|
+
writableRoot?: undefined;
|
|
114
|
+
};
|
|
115
|
+
export declare function buildSandboxEnvPolicy(overlay: BashEnvOverlay | undefined, runtimeEnv: Record<string, string> | undefined, exposableEnvNames?: readonly string[], withhold?: readonly string[]): {
|
|
116
|
+
inherit?: string[];
|
|
117
|
+
set?: Record<string, string>;
|
|
118
|
+
withhold?: string[];
|
|
119
|
+
};
|
|
120
|
+
type ProcStrategyResolution = {
|
|
121
|
+
strategy: 'real-proc' | 'proc-bind';
|
|
122
|
+
degradeReason?: undefined;
|
|
123
|
+
} | {
|
|
124
|
+
strategy: 'tmpfs';
|
|
125
|
+
degradeReason: 'definitive' | 'unverified';
|
|
126
|
+
};
|
|
127
|
+
export declare function forgetSharedLoopGuardTool(sessionId: string, tool: string): void;
|
|
128
|
+
export declare function __resetSharedLoopGuardForTests(): void;
|
|
129
|
+
export {};
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import type { AgentSession } from "./index.js";
|
|
2
|
+
export type DetectedProviderError = {
|
|
3
|
+
message: string;
|
|
4
|
+
safeMessage: string;
|
|
5
|
+
};
|
|
6
|
+
type TransformContext = NonNullable<AgentSession['agent']['transformContext']>;
|
|
7
|
+
export type LocalFailureMarkerOptions = {
|
|
8
|
+
getProvider?: () => string | undefined;
|
|
9
|
+
logWithheld?: (line: string) => void;
|
|
10
|
+
};
|
|
11
|
+
export declare function wrapTransformContextWithLocalFailureMarker(inner: TransformContext | undefined, options?: LocalFailureMarkerOptions): TransformContext;
|
|
12
|
+
export declare function isUnclassifiedProviderNotice(safeMessage: string): boolean;
|
|
13
|
+
export declare function isThrottleOrOverload(raw: string): boolean;
|
|
14
|
+
export declare function isObserverTtfbTimeout(raw: string): boolean;
|
|
15
|
+
export declare function isFailoverWorthy(raw: string): boolean;
|
|
16
|
+
export declare function isRetryableSameRef(raw: string): boolean;
|
|
17
|
+
export declare function isTransientProviderFailure(raw: string): boolean;
|
|
18
|
+
export declare function detectProviderError(message: unknown): DetectedProviderError | null;
|
|
19
|
+
export declare function detectHardProviderError(err: unknown): DetectedProviderError | null;
|
|
20
|
+
export type ProviderErrorListener = (error: DetectedProviderError) => void;
|
|
21
|
+
export type Unsubscribe = () => void;
|
|
22
|
+
export declare function subscribeProviderErrors(session: AgentSession, onError: ProviderErrorListener): Unsubscribe;
|
|
23
|
+
export {};
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import { Type } from 'typebox';
|
|
2
|
+
import type { ReloadRegistry, ReloadResult } from "../reload/index.js";
|
|
3
|
+
export type CreateReloadToolOptions = {
|
|
4
|
+
registry: ReloadRegistry;
|
|
5
|
+
};
|
|
6
|
+
export declare function createReloadTool({ registry }: CreateReloadToolOptions): import("@earendil-works/pi-coding-agent").ToolDefinition<Type.TObject<{
|
|
7
|
+
scope: Type.TOptional<Type.TString>;
|
|
8
|
+
}>, {
|
|
9
|
+
results: ReloadResult[];
|
|
10
|
+
}, any> & import("@earendil-works/pi-coding-agent").ToolDefinition<any, any, any>;
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import { type RestartHandoffOrigin } from "../restart-handoff/index.js";
|
|
2
|
+
import type { Stream } from "../../stream/index.js";
|
|
3
|
+
export type ContainerRestartingBroadcast = {
|
|
4
|
+
kind: 'container-restarting';
|
|
5
|
+
restartedAt: string;
|
|
6
|
+
originatingSessionId: string;
|
|
7
|
+
};
|
|
8
|
+
export type RequestContainerRestartOptions = {
|
|
9
|
+
containerName: string;
|
|
10
|
+
build?: boolean;
|
|
11
|
+
hostdUrl?: string;
|
|
12
|
+
hostdToken?: string;
|
|
13
|
+
ackTimeoutMs?: number;
|
|
14
|
+
stream?: Stream;
|
|
15
|
+
agentDir?: string;
|
|
16
|
+
originatingSessionId?: string;
|
|
17
|
+
originatingSessionFile?: string;
|
|
18
|
+
handoffOrigin?: RestartHandoffOrigin;
|
|
19
|
+
triggeringAuthorId?: string;
|
|
20
|
+
restartedAt?: string;
|
|
21
|
+
};
|
|
22
|
+
export type RequestContainerRestartResult = {
|
|
23
|
+
ok: true;
|
|
24
|
+
containerName: string;
|
|
25
|
+
restartedAt: string;
|
|
26
|
+
} | {
|
|
27
|
+
ok: false;
|
|
28
|
+
containerName: string;
|
|
29
|
+
reason: string;
|
|
30
|
+
};
|
|
31
|
+
export declare function requestContainerRestart({ containerName, build, hostdUrl, hostdToken, ackTimeoutMs, stream, agentDir, originatingSessionId, originatingSessionFile, handoffOrigin, triggeringAuthorId, restartedAt, }: RequestContainerRestartOptions): Promise<RequestContainerRestartResult>;
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import type { AdapterId } from "../../channels/schema.js";
|
|
2
|
+
export { restartHandoffPath } from "./paths.js";
|
|
3
|
+
export declare const RESTART_HANDOFF_TTL_MS = 60000;
|
|
4
|
+
export declare function acquireRestartHandoffLock(agentDir: string): Promise<() => void>;
|
|
5
|
+
export type RestartHandoffChannelKey = {
|
|
6
|
+
adapter: AdapterId;
|
|
7
|
+
workspace: string;
|
|
8
|
+
chat: string;
|
|
9
|
+
thread: string | null;
|
|
10
|
+
};
|
|
11
|
+
export type RestartHandoffOrigin = {
|
|
12
|
+
kind: 'tui';
|
|
13
|
+
} | {
|
|
14
|
+
kind: 'channel';
|
|
15
|
+
key: RestartHandoffChannelKey;
|
|
16
|
+
};
|
|
17
|
+
export type RestartHandoff = {
|
|
18
|
+
schemaVersion: 2;
|
|
19
|
+
restartedAt: string;
|
|
20
|
+
originatingSessionId: string;
|
|
21
|
+
originatingSessionFile: string;
|
|
22
|
+
origin: RestartHandoffOrigin;
|
|
23
|
+
triggeringAuthorId?: string;
|
|
24
|
+
interruptedSubagents?: string[];
|
|
25
|
+
};
|
|
26
|
+
export declare function writeRestartHandoff(agentDir: string, handoff: RestartHandoff): Promise<boolean>;
|
|
27
|
+
export declare function peekRestartHandoff(agentDir: string): Promise<RestartHandoff | null>;
|
|
28
|
+
export declare function consumeRestartHandoff(agentDir: string, options?: {
|
|
29
|
+
now?: number;
|
|
30
|
+
ttlMs?: number;
|
|
31
|
+
accept?: (handoff: RestartHandoff) => boolean;
|
|
32
|
+
}): Promise<RestartHandoff | null>;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare function restartHandoffPath(agentDir: string): string;
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
import type { AgentSession } from "./index.js";
|
|
2
|
+
export declare const RETRIES_PER_REF = 1;
|
|
3
|
+
export type RetryPolicy = 'responsive' | 'patient';
|
|
4
|
+
export declare const PATIENT_OVERLOAD_RETRIES = 6;
|
|
5
|
+
export declare const PATIENT_OVERLOAD_WINDOW_MS = 180000;
|
|
6
|
+
export declare const RESPONSIVE_OVERLOAD_RETRIES = 2;
|
|
7
|
+
export declare const RESPONSIVE_OVERLOAD_WINDOW_MS = 25000;
|
|
8
|
+
export declare function patientOverloadBackoffMs(attempt: number, random?: () => number): number;
|
|
9
|
+
export declare function responsiveOverloadBackoffMs(attempt: number, random?: () => number): number;
|
|
10
|
+
export type OverloadRetryBudget = {
|
|
11
|
+
retries: number;
|
|
12
|
+
windowMs: number;
|
|
13
|
+
backoffMs: (attempt: number, random?: () => number) => number;
|
|
14
|
+
};
|
|
15
|
+
export declare function overloadRetryBudget(policy: RetryPolicy | undefined): OverloadRetryBudget;
|
|
16
|
+
export declare function retryBackoffMs(attempt: number, random?: () => number): number;
|
|
17
|
+
export declare function sleepBackoff(attempt: number, signal?: AbortSignal, random?: () => number): Promise<void>;
|
|
18
|
+
export declare function retryTurnOnPersistentSession(session: AgentSession, opts?: {
|
|
19
|
+
attempt: number;
|
|
20
|
+
signal?: AbortSignal;
|
|
21
|
+
random?: () => number;
|
|
22
|
+
delayMs?: number;
|
|
23
|
+
}): Promise<boolean>;
|
|
24
|
+
export declare function retryTurnAfterCompletedToolResult(session: AgentSession, opts: {
|
|
25
|
+
attempt: number;
|
|
26
|
+
signal?: AbortSignal;
|
|
27
|
+
random?: () => number;
|
|
28
|
+
authorize: () => boolean;
|
|
29
|
+
onBackoffStart?: () => void;
|
|
30
|
+
delayMs?: number;
|
|
31
|
+
}): Promise<boolean>;
|
|
32
|
+
export type SameRefPromptResult = {
|
|
33
|
+
success: boolean;
|
|
34
|
+
lastError?: Error;
|
|
35
|
+
};
|
|
36
|
+
export declare function promptWithSameRefRetryOnly(session: AgentSession, text: string, promptOpts?: Parameters<AgentSession['prompt']>[1], opts?: {
|
|
37
|
+
retryPolicy?: RetryPolicy;
|
|
38
|
+
random?: () => number;
|
|
39
|
+
now?: () => number;
|
|
40
|
+
overloadBackoffMs?: (attempt: number) => number;
|
|
41
|
+
}): Promise<SameRefPromptResult>;
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import type { ReviewerActivity } from "../channels/github-review-check.js";
|
|
2
|
+
import type { AgentSession } from "./index.js";
|
|
3
|
+
export declare function attachReviewerActivityCapture(session: Pick<AgentSession, 'subscribe'>, report: (activity: ReviewerActivity) => void, now?: () => number): () => void;
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
export type SubagentBashPolicy = {
|
|
2
|
+
kind: 'readonly-reviewer';
|
|
3
|
+
};
|
|
4
|
+
export declare class SubagentBashPolicyError extends Error {
|
|
5
|
+
constructor(message: string);
|
|
6
|
+
}
|
|
7
|
+
export declare function enforceReviewerReadonlyBashPolicy(command: string): void;
|
|
8
|
+
export declare function enforceSubagentBashPolicy(policy: SubagentBashPolicy, command: string): void;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare function loadSelf(agentDir: string): Promise<string>;
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import type { SessionOrigin } from "./session-origin.js";
|
|
2
|
+
export declare const SESSION_META_CUSTOM_TYPE = "typeclaw.session-meta";
|
|
3
|
+
export type SessionMetaPayload = {
|
|
4
|
+
origin: MinimalSessionOrigin;
|
|
5
|
+
};
|
|
6
|
+
export type MinimalSessionOrigin = {
|
|
7
|
+
kind: 'tui';
|
|
8
|
+
} | {
|
|
9
|
+
kind: 'cron';
|
|
10
|
+
jobId: string;
|
|
11
|
+
jobKind: 'prompt' | 'exec' | 'subagent' | 'handler';
|
|
12
|
+
} | {
|
|
13
|
+
kind: 'channel';
|
|
14
|
+
adapter: string;
|
|
15
|
+
workspace: string;
|
|
16
|
+
workspaceName?: string;
|
|
17
|
+
chat: string;
|
|
18
|
+
chatName?: string;
|
|
19
|
+
thread: string | null;
|
|
20
|
+
} | {
|
|
21
|
+
kind: 'subagent';
|
|
22
|
+
subagent: string;
|
|
23
|
+
parentSessionId: string;
|
|
24
|
+
} | {
|
|
25
|
+
kind: 'system';
|
|
26
|
+
component: string;
|
|
27
|
+
};
|
|
28
|
+
export declare function sessionMetaPayload(origin: SessionOrigin): SessionMetaPayload;
|
|
@@ -0,0 +1,65 @@
|
|
|
1
|
+
import { type MembershipCount } from "../channels/membership.js";
|
|
2
|
+
import type { AdapterId } from "../channels/schema.js";
|
|
3
|
+
import type { ChannelSelfIdentity, GithubReviewFollowupRound, ReactionRef } from "../channels/types.js";
|
|
4
|
+
export type ChannelParticipant = {
|
|
5
|
+
authorId: string;
|
|
6
|
+
authorName: string;
|
|
7
|
+
firstMessageAt: number;
|
|
8
|
+
lastMessageAt: number;
|
|
9
|
+
messageCount: number;
|
|
10
|
+
isBot?: boolean;
|
|
11
|
+
};
|
|
12
|
+
export type ChannelOriginContext = {
|
|
13
|
+
lastInboundAuthorId?: string;
|
|
14
|
+
participants?: readonly ChannelParticipant[];
|
|
15
|
+
};
|
|
16
|
+
export type SessionOrigin = {
|
|
17
|
+
kind: 'tui';
|
|
18
|
+
sessionId: string;
|
|
19
|
+
} | {
|
|
20
|
+
kind: 'cron';
|
|
21
|
+
jobId: string;
|
|
22
|
+
jobKind: 'prompt' | 'exec' | 'subagent' | 'handler';
|
|
23
|
+
scheduledByRole?: string;
|
|
24
|
+
scheduledByOrigin?: SessionOrigin | {
|
|
25
|
+
kind: 'config-file';
|
|
26
|
+
};
|
|
27
|
+
} | {
|
|
28
|
+
kind: 'channel';
|
|
29
|
+
adapter: AdapterId;
|
|
30
|
+
workspace: string;
|
|
31
|
+
workspaceName?: string;
|
|
32
|
+
chat: string;
|
|
33
|
+
chatName?: string;
|
|
34
|
+
thread: string | null;
|
|
35
|
+
githubReviewRound?: GithubReviewFollowupRound;
|
|
36
|
+
parentChat?: string;
|
|
37
|
+
parentChatName?: string;
|
|
38
|
+
lastInboundAuthorId?: string;
|
|
39
|
+
lastInboundAuthorAdapter?: AdapterId;
|
|
40
|
+
reactionRef?: ReactionRef;
|
|
41
|
+
participants?: readonly ChannelParticipant[];
|
|
42
|
+
membership?: MembershipCount;
|
|
43
|
+
self?: ChannelSelfIdentity;
|
|
44
|
+
} | {
|
|
45
|
+
kind: 'subagent';
|
|
46
|
+
subagent: string;
|
|
47
|
+
parentSessionId: string;
|
|
48
|
+
spawnedByRole?: string;
|
|
49
|
+
spawnedByOrigin?: SessionOrigin;
|
|
50
|
+
} | {
|
|
51
|
+
kind: 'system';
|
|
52
|
+
component: string;
|
|
53
|
+
reason?: string;
|
|
54
|
+
triggeredBy?: SessionOrigin;
|
|
55
|
+
};
|
|
56
|
+
export declare const MAX_SUBAGENT_DEPTH = 2;
|
|
57
|
+
export declare function subagentDepth(origin: SessionOrigin | undefined): number;
|
|
58
|
+
export declare const PARTICIPANTS_TOP_K = 10;
|
|
59
|
+
export declare const PARTICIPANTS_MAX_AGE_MS: number;
|
|
60
|
+
export type SessionRoleContext = {
|
|
61
|
+
role: string;
|
|
62
|
+
permissions: readonly string[];
|
|
63
|
+
};
|
|
64
|
+
export declare function renderSessionOrigin(origin: SessionOrigin, now?: number, roleContext?: SessionRoleContext): string;
|
|
65
|
+
export declare function renderInteractiveSessionContext(subagentRoster: string): string;
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import type { StreamFn } from '@earendil-works/pi-agent-core';
|
|
2
|
+
import type { LiveSubagentRegistry } from "./live-subagents.js";
|
|
3
|
+
export declare const MAX_SUBAGENT_CACHE_PINGS = 6;
|
|
4
|
+
type Request = {
|
|
5
|
+
readonly model: Parameters<StreamFn>[0];
|
|
6
|
+
readonly context: Parameters<StreamFn>[1];
|
|
7
|
+
readonly options: NonNullable<Parameters<StreamFn>[2]>;
|
|
8
|
+
readonly payload: Record<string, unknown>;
|
|
9
|
+
};
|
|
10
|
+
export declare class SubagentCacheKeepalive {
|
|
11
|
+
private readonly sessionId;
|
|
12
|
+
private readonly registry;
|
|
13
|
+
private readonly stream;
|
|
14
|
+
private readonly clock;
|
|
15
|
+
private readonly log;
|
|
16
|
+
private request;
|
|
17
|
+
private refreshedAt;
|
|
18
|
+
private idle;
|
|
19
|
+
private closed;
|
|
20
|
+
private pings;
|
|
21
|
+
private cancelTimer;
|
|
22
|
+
private controller;
|
|
23
|
+
private readonly unsubscribe;
|
|
24
|
+
constructor(sessionId: string, registry: LiveSubagentRegistry, stream: StreamFn, clock?: {
|
|
25
|
+
now: () => number;
|
|
26
|
+
schedule: (callback: () => void, delay: number) => (() => void);
|
|
27
|
+
}, log?: (line: string) => void);
|
|
28
|
+
capture(model: Request['model'], context: Request['context'], options: Request['options'], payload: unknown): void;
|
|
29
|
+
invalidate(): void;
|
|
30
|
+
startTurn(): void;
|
|
31
|
+
settle(): void;
|
|
32
|
+
close(): void;
|
|
33
|
+
private running;
|
|
34
|
+
private stop;
|
|
35
|
+
private reconcile;
|
|
36
|
+
private ping;
|
|
37
|
+
}
|
|
38
|
+
export {};
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
export type CompletionReminderArgs = {
|
|
2
|
+
subagent: string;
|
|
3
|
+
taskId: string;
|
|
4
|
+
ok: boolean;
|
|
5
|
+
durationMs: number;
|
|
6
|
+
error?: string;
|
|
7
|
+
hasRecoverableOutput?: boolean;
|
|
8
|
+
channel?: boolean;
|
|
9
|
+
adapter?: string;
|
|
10
|
+
};
|
|
11
|
+
export declare function renderSubagentCompletionReminder(args: CompletionReminderArgs): string;
|
|
12
|
+
export declare function formatReminderDuration(ms: number): string;
|
|
13
|
+
export type SubagentCompletedChannelKey = {
|
|
14
|
+
adapter: string;
|
|
15
|
+
workspace: string;
|
|
16
|
+
chat: string;
|
|
17
|
+
thread: string | null;
|
|
18
|
+
};
|
|
19
|
+
export type SubagentCompletedPayload = {
|
|
20
|
+
taskId: string;
|
|
21
|
+
subagent: string;
|
|
22
|
+
parentSessionId: string;
|
|
23
|
+
ok: boolean;
|
|
24
|
+
durationMs: number;
|
|
25
|
+
error?: string;
|
|
26
|
+
hasRecoverableOutput?: boolean;
|
|
27
|
+
channelKey?: SubagentCompletedChannelKey;
|
|
28
|
+
};
|
|
29
|
+
export declare function parseSubagentCompletedPayload(payload: unknown): SubagentCompletedPayload | null;
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import type { Stream } from "../stream/index.js";
|
|
2
|
+
import type { LiveSubagentRegistry } from "./live-subagents.js";
|
|
3
|
+
export type SubagentBackgroundDrain = {
|
|
4
|
+
stream: Stream;
|
|
5
|
+
sessionId: string;
|
|
6
|
+
liveRegistry: LiveSubagentRegistry;
|
|
7
|
+
};
|
|
8
|
+
export type DrainPrompt = (text: string) => Promise<void>;
|
|
9
|
+
export type RunSubagentDrainOptions = {
|
|
10
|
+
drain: SubagentBackgroundDrain;
|
|
11
|
+
prompt: DrainPrompt;
|
|
12
|
+
cancelled?: () => boolean;
|
|
13
|
+
maxChildWaitMs?: number;
|
|
14
|
+
now?: () => number;
|
|
15
|
+
};
|
|
16
|
+
export declare function runSubagentDrain(watch: SubagentDrainWatch, options: RunSubagentDrainOptions): Promise<void>;
|
|
17
|
+
export type SubagentDrainWatch = {
|
|
18
|
+
waitForWakeup: (timeoutMs?: number) => Promise<boolean>;
|
|
19
|
+
stop: () => void;
|
|
20
|
+
};
|
|
21
|
+
export type TimerScheduler = {
|
|
22
|
+
set: (fn: () => void, ms: number) => unknown;
|
|
23
|
+
clear: (handle: unknown) => void;
|
|
24
|
+
};
|
|
25
|
+
export declare function beginSubagentDrainWatch(drain: SubagentBackgroundDrain, scheduler?: TimerScheduler): SubagentDrainWatch;
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import { SessionManager } from '@earendil-works/pi-coding-agent';
|
|
2
|
+
/** Plugin-owned privacy choice; model payloads cannot enable or disable persistence. */
|
|
3
|
+
export declare function createSubagentSessionManager(cwd: string, sessionDir: string, ephemeral?: boolean): SessionManager;
|
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
import type { ToolDefinition } from '@earendil-works/pi-coding-agent';
|
|
2
|
+
import type { z } from 'zod';
|
|
3
|
+
import { type ThinkingLevel } from "../config/index.js";
|
|
4
|
+
import type { PermissionService } from "../permissions/index.js";
|
|
5
|
+
import type { HookBus } from "../plugin/index.js";
|
|
6
|
+
import type { Stream } from "../stream/index.js";
|
|
7
|
+
import { type AgentSession, createSession, type PluginSessionWiring } from "./index.js";
|
|
8
|
+
import type { SubagentBashPolicy } from "./reviewer-bash-policy.js";
|
|
9
|
+
import type { SessionOrigin } from "./session-origin.js";
|
|
10
|
+
import { type SubagentBackgroundDrain } from "./subagent-drain.js";
|
|
11
|
+
import type { ToolResultBudget } from "./tool-result-budget.js";
|
|
12
|
+
type AgentSessionTools = NonNullable<Parameters<typeof createSession>[0]>['tools'];
|
|
13
|
+
export type SubagentContext<P = unknown> = {
|
|
14
|
+
userPrompt: string;
|
|
15
|
+
agentDir: string;
|
|
16
|
+
payload: P;
|
|
17
|
+
};
|
|
18
|
+
export type RunSession = (override?: {
|
|
19
|
+
userPrompt?: string;
|
|
20
|
+
onFinalMessage?: (message: string | null) => void;
|
|
21
|
+
}) => Promise<void>;
|
|
22
|
+
export type SubagentShared<P = unknown> = {
|
|
23
|
+
systemPrompt: string;
|
|
24
|
+
profile?: string;
|
|
25
|
+
thinkingLevel?: ThinkingLevel;
|
|
26
|
+
payloadSchema?: z.ZodType<P>;
|
|
27
|
+
handler?: (ctx: SubagentContext<P>, runSession: RunSession) => Promise<void>;
|
|
28
|
+
toolResultBudget?: ToolResultBudget;
|
|
29
|
+
visibility?: 'public' | 'internal';
|
|
30
|
+
rosterDescription?: string;
|
|
31
|
+
requiresSpecificPermission?: boolean;
|
|
32
|
+
canSpawnSubagents?: boolean;
|
|
33
|
+
canBackgroundSpawnSubagents?: boolean;
|
|
34
|
+
timeoutMs?: number;
|
|
35
|
+
bashPolicy?: SubagentBashPolicy;
|
|
36
|
+
inFlightKey?: (payload: P) => string;
|
|
37
|
+
};
|
|
38
|
+
export type Subagent<P = unknown> = SubagentShared<P> & {
|
|
39
|
+
tools?: AgentSessionTools;
|
|
40
|
+
customTools?: ToolDefinition[];
|
|
41
|
+
};
|
|
42
|
+
export type SubagentRegistry = Readonly<Record<string, Subagent<any>>>;
|
|
43
|
+
export declare function validateSubagentPayload(name: string, subagent: Subagent<any>, payload: unknown): unknown;
|
|
44
|
+
export declare function resolveSubagentProfile(subagent: SubagentShared<any>, options: CreateSessionForSubagentOptions | undefined): string | undefined;
|
|
45
|
+
export type CreateSessionForSubagentResult = {
|
|
46
|
+
session: AgentSession;
|
|
47
|
+
dispose?: () => Promise<void>;
|
|
48
|
+
hooks?: HookBus;
|
|
49
|
+
sessionId?: string;
|
|
50
|
+
agentDir?: string;
|
|
51
|
+
origin?: SessionOrigin;
|
|
52
|
+
getTranscriptPath?: () => string | undefined;
|
|
53
|
+
backgroundDrain?: SubagentBackgroundDrain;
|
|
54
|
+
};
|
|
55
|
+
export type CreateSessionForSubagentOptions = {
|
|
56
|
+
name?: string;
|
|
57
|
+
parentSessionId?: string;
|
|
58
|
+
spawnedByRole?: string;
|
|
59
|
+
spawnedByOrigin?: SessionOrigin;
|
|
60
|
+
plugins?: PluginSessionWiring;
|
|
61
|
+
permissions?: PermissionService;
|
|
62
|
+
profileOverride?: string;
|
|
63
|
+
};
|
|
64
|
+
export type CreateSessionForSubagent = (subagent: Subagent<any>, options?: CreateSessionForSubagentOptions) => Promise<AgentSession | CreateSessionForSubagentResult>;
|
|
65
|
+
export declare const defaultCreateSessionForSubagent: CreateSessionForSubagent;
|
|
66
|
+
export type InvokeSubagentOptions = {
|
|
67
|
+
registry: SubagentRegistry;
|
|
68
|
+
createSessionForSubagent?: CreateSessionForSubagent;
|
|
69
|
+
agentDir: string;
|
|
70
|
+
userPrompt: string;
|
|
71
|
+
payload?: unknown;
|
|
72
|
+
parentSessionId?: string;
|
|
73
|
+
spawnedByRole?: string;
|
|
74
|
+
spawnedByOrigin?: SessionOrigin;
|
|
75
|
+
onProviderError?: (errorMessage: string) => void;
|
|
76
|
+
onSessionCreated?: (event: {
|
|
77
|
+
session: AgentSession;
|
|
78
|
+
sessionId: string | undefined;
|
|
79
|
+
abort: () => Promise<void>;
|
|
80
|
+
}) => void;
|
|
81
|
+
onFinalMessageCaptured?: (msg: string) => void;
|
|
82
|
+
};
|
|
83
|
+
export declare function invokeSubagent(name: string, options: InvokeSubagentOptions): Promise<void>;
|
|
84
|
+
export declare class SubagentTimeoutError extends Error {
|
|
85
|
+
readonly subagentName: string;
|
|
86
|
+
readonly coalesceKey: string;
|
|
87
|
+
readonly timeoutMs: number;
|
|
88
|
+
readonly name = "SubagentTimeoutError";
|
|
89
|
+
constructor(subagentName: string, coalesceKey: string, timeoutMs: number);
|
|
90
|
+
}
|
|
91
|
+
export declare function isSubagentTimeoutError(err: unknown): err is SubagentTimeoutError;
|
|
92
|
+
export declare function awaitWithSubagentTimeout(work: Promise<void>, subagentName: string, coalesceKey: string, timeoutMs: number | undefined): Promise<void>;
|
|
93
|
+
export type SubagentHandle = {
|
|
94
|
+
taskId: string;
|
|
95
|
+
sessionId: string | undefined;
|
|
96
|
+
abort: () => Promise<void>;
|
|
97
|
+
};
|
|
98
|
+
export type StartSubagentResult = {
|
|
99
|
+
handle: Promise<SubagentHandle>;
|
|
100
|
+
completion: Promise<{
|
|
101
|
+
ok: true;
|
|
102
|
+
finalMessage?: string;
|
|
103
|
+
} | {
|
|
104
|
+
ok: false;
|
|
105
|
+
error: string;
|
|
106
|
+
finalMessage?: string;
|
|
107
|
+
}>;
|
|
108
|
+
};
|
|
109
|
+
export type StartSubagentOptions = InvokeSubagentOptions & {
|
|
110
|
+
taskId: string;
|
|
111
|
+
onSession?: (event: {
|
|
112
|
+
session: AgentSession;
|
|
113
|
+
sessionId: string | undefined;
|
|
114
|
+
abort: () => Promise<void>;
|
|
115
|
+
}) => void;
|
|
116
|
+
};
|
|
117
|
+
export declare function startSubagent(name: string, options: StartSubagentOptions): StartSubagentResult;
|
|
118
|
+
export declare const INCOMPLETE_REVIEW_VERDICT = "incomplete-review-not-a-verdict";
|
|
119
|
+
export type SubagentConsumerLogger = {
|
|
120
|
+
info: (msg: string) => void;
|
|
121
|
+
warn: (msg: string) => void;
|
|
122
|
+
error: (msg: string) => void;
|
|
123
|
+
};
|
|
124
|
+
export type SubagentInFlightKey = (subagent: string, payload: unknown, parentSessionId?: string) => string;
|
|
125
|
+
export type CreateSubagentConsumerOptions = {
|
|
126
|
+
stream: Stream;
|
|
127
|
+
getRegistry: () => SubagentRegistry;
|
|
128
|
+
agentDir: string;
|
|
129
|
+
createSessionForSubagent?: CreateSessionForSubagent;
|
|
130
|
+
inFlightKey?: SubagentInFlightKey;
|
|
131
|
+
coalescer?: SubagentCoalescer;
|
|
132
|
+
logger?: SubagentConsumerLogger;
|
|
133
|
+
};
|
|
134
|
+
export type SubagentConsumer = {
|
|
135
|
+
start: () => void;
|
|
136
|
+
stop: () => void;
|
|
137
|
+
inFlightCount: () => number;
|
|
138
|
+
};
|
|
139
|
+
export declare class SubagentCoalescer {
|
|
140
|
+
private readonly inFlight;
|
|
141
|
+
tryAcquire(key: string): boolean;
|
|
142
|
+
release(key: string): void;
|
|
143
|
+
count(): number;
|
|
144
|
+
}
|
|
145
|
+
export declare function subagentCoalesceKey<P>(options: {
|
|
146
|
+
subagentName: string;
|
|
147
|
+
payload: P;
|
|
148
|
+
fallbackKey: string;
|
|
149
|
+
inFlightKey?: (payload: P) => string;
|
|
150
|
+
parentSessionId?: string;
|
|
151
|
+
}): string;
|
|
152
|
+
export declare function createSubagentConsumer({ stream, getRegistry, agentDir, createSessionForSubagent, inFlightKey, coalescer, logger, }: CreateSubagentConsumerOptions): SubagentConsumer;
|
|
153
|
+
export {};
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
export declare function buildSystemPolicy(branding?: boolean): string;
|
|
2
|
+
export declare const DEFAULT_SUBAGENT_ROSTER = "the registered public subagents (see the `spawn_subagent` tool description for the live list and each one\u2019s purpose)";
|
|
3
|
+
export declare function renderRuntimeBlock(version: string): string;
|
|
4
|
+
export declare function renderRuntimeNondisclosureRule(): string;
|
|
5
|
+
export declare function stripRuntimeIdentityProse(prompt: string): string;
|
|
6
|
+
export declare function renderTurnTimeAnchor(now?: Date): string;
|
|
7
|
+
export declare function renderTurnRoleAnchor(role: string): string | undefined;
|