typeclaw 0.49.0 → 0.51.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/bash-sandbox-env.d.ts +15 -0
- package/dist/types/agent/bash-sandbox-proc.d.ts +8 -0
- package/dist/types/agent/bash-sandbox.d.ts +94 -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 +8 -0
- package/dist/types/agent/index.d.ts +151 -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/output-allowance.d.ts +4 -0
- package/dist/types/agent/plugin-tools.d.ts +58 -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-composition.d.ts +17 -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 +27 -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 +760 -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 +827 -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 +1458 -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 +145 -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/eval/cell.d.ts +26 -0
- package/dist/types/eval/config.d.ts +19 -0
- package/dist/types/eval/dispatch.d.ts +7 -0
- package/dist/types/eval/kernel.d.ts +28 -0
- package/dist/types/eval/process.d.ts +23 -0
- package/dist/types/eval/protocol.d.ts +34 -0
- package/dist/types/eval/sandbox.d.ts +10 -0
- package/dist/types/eval/tool.d.ts +17 -0
- package/dist/types/eval/wire.d.ts +33 -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 +3 -0
- package/dist/types/sandbox/errors.d.ts +20 -0
- package/dist/types/sandbox/hidden-paths.d.ts +11 -0
- package/dist/types/sandbox/index.d.ts +14 -0
- package/dist/types/sandbox/package-install.d.ts +1 -0
- package/dist/types/sandbox/policy.d.ts +71 -0
- package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
- package/dist/types/sandbox/quote.d.ts +2 -0
- package/dist/types/sandbox/runtime-private.d.ts +1 -0
- package/dist/types/sandbox/session-tmp.d.ts +6 -0
- package/dist/types/sandbox/symlinks.d.ts +6 -0
- package/dist/types/sandbox/writable-zones.d.ts +15 -0
- package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
- package/dist/types/secrets/defaults.d.ts +21 -0
- package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
- package/dist/types/secrets/hydrate.d.ts +7 -0
- package/dist/types/secrets/index.d.ts +7 -0
- package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
- package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
- package/dist/types/secrets/resolve.d.ts +14 -0
- package/dist/types/secrets/schema.d.ts +840 -0
- package/dist/types/secrets/storage.d.ts +56 -0
- package/dist/types/shared/host-locale.d.ts +1 -0
- package/dist/types/shared/index.d.ts +5 -0
- package/dist/types/shared/local-time.d.ts +4 -0
- package/dist/types/shared/platform.d.ts +2 -0
- package/dist/types/shared/protocol.d.ts +424 -0
- package/dist/types/shared/style-text.d.ts +3 -0
- package/dist/types/shared/wsl.d.ts +17 -0
- package/dist/types/stream/broker.d.ts +2 -0
- package/dist/types/stream/index.d.ts +2 -0
- package/dist/types/stream/types.d.ts +71 -0
- package/package.json +13 -6
- package/scripts/build-plugin-types.ts +105 -0
- package/scripts/check-plugin-sdk.ts +111 -0
- package/scripts/require-parallel.ts +5 -32
- package/src/agent/bash-sandbox-env.ts +104 -0
- package/src/agent/bash-sandbox-proc.ts +70 -0
- package/src/agent/bash-sandbox.ts +225 -0
- package/src/agent/compaction.ts +22 -10
- package/src/agent/guard-types.ts +3 -0
- package/src/agent/guards.ts +4 -0
- package/src/agent/idle-compaction.ts +178 -0
- package/src/agent/index.ts +139 -172
- package/src/agent/live-subagents.ts +19 -0
- package/src/agent/multimodal/look-at.ts +22 -9
- package/src/agent/output-allowance.ts +7 -0
- package/src/agent/plugin-tools.ts +39 -377
- package/src/agent/reviewer-bash-policy.ts +41 -1
- package/src/agent/session-origin.ts +28 -11
- package/src/agent/subagent-cache-keepalive.ts +198 -0
- package/src/agent/subagent-completion-reminder.ts +2 -2
- package/src/agent/subagent-session.ts +6 -0
- package/src/agent/subagents.ts +46 -8
- package/src/agent/system-prompt-composition.ts +141 -0
- package/src/agent/system-prompt.ts +5 -5
- package/src/agent/todo/scope.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 +84 -16
- 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/agent/tools-without-local-file-operands.ts +4 -0
- package/src/browser/bsk-shim.mjs +74 -0
- package/src/browser/dockerfile.ts +84 -0
- package/src/browser/egress.ts +104 -0
- package/src/browser/fill-secret.ts +307 -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/explorer/explorer.ts +1 -1
- package/src/bundled-plugins/github-cli-auth/gh-command.ts +4 -0
- package/src/bundled-plugins/github-cli-auth/gh-review-detect.ts +40 -16
- package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
- package/src/bundled-plugins/github-cli-auth/graphql-auth-nudge.ts +12 -7
- package/src/bundled-plugins/github-cli-auth/index.ts +85 -60
- package/src/bundled-plugins/managed-browser/index.ts +179 -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/memory/dreaming.ts +4 -1
- package/src/bundled-plugins/memory/load-memory.ts +2 -4
- package/src/bundled-plugins/memory/memory-logger.ts +74 -2
- package/src/bundled-plugins/memory/transcript-preload.ts +103 -0
- package/src/bundled-plugins/memory/vector/hybrid.ts +25 -14
- 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/bundled-plugins/security/policies/private-surface-read.ts +166 -201
- package/src/channels/adapter-namespace.ts +13 -0
- package/src/channels/adapters/discord-bot-reference.ts +5 -4
- package/src/channels/adapters/discord-bot.ts +98 -5
- package/src/channels/adapters/discord-classify.ts +8 -3
- package/src/channels/adapters/discord.ts +29 -0
- 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-review-check.ts +5 -1
- package/src/channels/github-review-verdict-coordinator.ts +68 -2
- 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 +515 -243
- package/src/channels/session-handoff.fixture.ts +144 -0
- package/src/channels/session-handoff.ts +175 -0
- package/src/channels/session-search.ts +71 -0
- package/src/channels/subagent-completion-bridge.ts +3 -2
- package/src/channels/types.ts +12 -2
- package/src/cli/channel.ts +2 -3
- package/src/cli/hostd.ts +3 -0
- 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 +126 -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 +69 -4
- package/src/container/start.ts +132 -5
- package/src/doctor/checks.ts +33 -22
- package/src/doctor/index.ts +48 -12
- package/src/doctor/operational-incidents.ts +16 -1
- package/src/doctor/plugin-bridge.ts +14 -1
- package/src/doctor/stage.ts +14 -0
- package/src/doctor/types.ts +6 -0
- package/src/eval/cell.ts +93 -0
- package/src/eval/config.ts +32 -0
- package/src/eval/dispatch.ts +67 -0
- package/src/eval/entry.ts +261 -0
- package/src/eval/kernel.ts +154 -0
- package/src/eval/process.ts +113 -0
- package/src/eval/protocol.ts +26 -0
- package/src/eval/redeclare.ts +174 -0
- package/src/eval/sandbox.ts +114 -0
- package/src/eval/tool.ts +98 -0
- package/src/eval/wire.ts +93 -0
- 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/operations/classify-tool-outcome.ts +1 -1
- package/src/permissions/builtins.ts +7 -0
- package/src/permissions/permissions.ts +18 -9
- package/src/permissions/resolve.ts +7 -1
- package/src/plugin/context.ts +2 -0
- package/src/plugin/core-tool-names.ts +6 -1
- 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/env-exposure.ts +20 -0
- package/src/sandbox/hidden-paths.ts +16 -2
- package/src/secrets/storage.ts +13 -0
- package/src/server/index.ts +46 -11
- package/src/skills/typeclaw-channel-github/SKILL.md +8 -8
- package/src/skills/typeclaw-config/SKILL.md +57 -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 +488 -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,61 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { createPublicSocketLookup, type PublicHttpAddress, type PublicHttpDependencies, type PublicHttpRequestOptions, type PublicHttpResponse } from "../network/safe-http.js";
|
|
3
|
+
import type { InternalDestinationPolicy } from "../../network/internal-destinations.js";
|
|
4
|
+
export declare const URL_FETCH_TIMEOUT_MS = 30000;
|
|
5
|
+
export declare const URL_FETCH_MAX_BYTES: number;
|
|
6
|
+
export declare const LOOK_AT_MAX_IMAGES = 16;
|
|
7
|
+
export declare const LOOK_AT_MAX_BYTES: number;
|
|
8
|
+
export declare const LOOK_AT_MAX_CONCURRENCY = 4;
|
|
9
|
+
export declare const LOOK_AT_MAX_REDIRECTS = 5;
|
|
10
|
+
export type ImageInput = {
|
|
11
|
+
kind: 'url';
|
|
12
|
+
url: string;
|
|
13
|
+
} | {
|
|
14
|
+
kind: 'file';
|
|
15
|
+
path: string;
|
|
16
|
+
} | {
|
|
17
|
+
kind: 'base64';
|
|
18
|
+
data: string;
|
|
19
|
+
mimeType: string;
|
|
20
|
+
};
|
|
21
|
+
export declare const imageInputSchema: z.ZodUnion<readonly [z.ZodObject<{
|
|
22
|
+
kind: z.ZodLiteral<"url">;
|
|
23
|
+
url: z.ZodString;
|
|
24
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
25
|
+
kind: z.ZodLiteral<"file">;
|
|
26
|
+
path: z.ZodString;
|
|
27
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
28
|
+
kind: z.ZodLiteral<"base64">;
|
|
29
|
+
data: z.ZodString;
|
|
30
|
+
mimeType: z.ZodString;
|
|
31
|
+
}, z.core.$strip>]>;
|
|
32
|
+
export declare const multimodalLookerPayloadSchema: z.ZodObject<{
|
|
33
|
+
images: z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
|
|
34
|
+
kind: z.ZodLiteral<"url">;
|
|
35
|
+
url: z.ZodString;
|
|
36
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
37
|
+
kind: z.ZodLiteral<"file">;
|
|
38
|
+
path: z.ZodString;
|
|
39
|
+
}, z.core.$strip>, z.ZodObject<{
|
|
40
|
+
kind: z.ZodLiteral<"base64">;
|
|
41
|
+
data: z.ZodString;
|
|
42
|
+
mimeType: z.ZodString;
|
|
43
|
+
}, z.core.$strip>]>>;
|
|
44
|
+
prompt: z.ZodOptional<z.ZodString>;
|
|
45
|
+
}, z.core.$strip>;
|
|
46
|
+
export type MultimodalLookerPayload = z.infer<typeof multimodalLookerPayloadSchema>;
|
|
47
|
+
export declare function buildMultimodalLookerSystemPrompt(prompt: string | undefined): string;
|
|
48
|
+
export type ResolvedImage = {
|
|
49
|
+
data: string;
|
|
50
|
+
mimeType: string;
|
|
51
|
+
};
|
|
52
|
+
export type LookAtAddress = PublicHttpAddress;
|
|
53
|
+
export type LookAtRequestOptions = PublicHttpRequestOptions;
|
|
54
|
+
export type LookAtHttpResponse = PublicHttpResponse;
|
|
55
|
+
export type LookAtNetworkDependencies = PublicHttpDependencies;
|
|
56
|
+
type ImageByteBudget = {
|
|
57
|
+
consume(bytes: number): void;
|
|
58
|
+
};
|
|
59
|
+
export declare function resolveImagesBounded(inputs: ImageInput[], signal?: AbortSignal, network?: LookAtNetworkDependencies, internalDestinationPolicy?: InternalDestinationPolicy): Promise<ResolvedImage[]>;
|
|
60
|
+
export declare function resolveImage(input: ImageInput, signal?: AbortSignal, aggregateBudget?: ImageByteBudget, network?: LookAtNetworkDependencies, internalDestinationPolicy?: InternalDestinationPolicy): Promise<ResolvedImage>;
|
|
61
|
+
export { createPublicSocketLookup };
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import type { InternalGuardResult } from "../guard-types.js";
|
|
2
|
+
export { GUARD_IMAGE_READ_REDIRECT } from "../../bundled-plugins/guard/keys.js";
|
|
3
|
+
export declare function checkImageReadRedirect(options: {
|
|
4
|
+
tool: string;
|
|
5
|
+
args: Readonly<Record<string, unknown>>;
|
|
6
|
+
}): InternalGuardResult;
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export declare function readResponseBodyBounded(response: Response, maxBytes: number): Promise<Buffer>;
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
import { type IncomingHttpHeaders } from 'node:http';
|
|
2
|
+
import { type LookupFunction } from 'node:net';
|
|
3
|
+
import { type InternalDestinationPolicy } from "../../network/internal-destinations.js";
|
|
4
|
+
export type PublicHttpAddress = {
|
|
5
|
+
address: string;
|
|
6
|
+
family: 4 | 6;
|
|
7
|
+
};
|
|
8
|
+
export type PublicHttpRequestOptions = {
|
|
9
|
+
protocol: 'http:' | 'https:';
|
|
10
|
+
hostname: string;
|
|
11
|
+
port?: number;
|
|
12
|
+
path: string;
|
|
13
|
+
method: 'GET';
|
|
14
|
+
headers: Record<string, string>;
|
|
15
|
+
servername?: string;
|
|
16
|
+
signal: AbortSignal;
|
|
17
|
+
lookup: LookupFunction;
|
|
18
|
+
autoSelectFamily: false;
|
|
19
|
+
};
|
|
20
|
+
export type PublicHttpResponse = {
|
|
21
|
+
statusCode: number;
|
|
22
|
+
headers: IncomingHttpHeaders;
|
|
23
|
+
body: AsyncIterable<Uint8Array>;
|
|
24
|
+
cancel(): void;
|
|
25
|
+
};
|
|
26
|
+
export type PublicHttpDependencies = {
|
|
27
|
+
resolveAddresses(hostname: string): Promise<readonly PublicHttpAddress[]>;
|
|
28
|
+
request(options: PublicHttpRequestOptions): Promise<PublicHttpResponse>;
|
|
29
|
+
};
|
|
30
|
+
export type PublicHttpResult = {
|
|
31
|
+
response: PublicHttpResponse;
|
|
32
|
+
finalUrl: string;
|
|
33
|
+
};
|
|
34
|
+
export declare const DEFAULT_PUBLIC_HTTP_MAX_REDIRECTS = 5;
|
|
35
|
+
export declare function requestPublicHttpUrl(rawUrl: string, options: {
|
|
36
|
+
signal: AbortSignal;
|
|
37
|
+
headers?: Record<string, string>;
|
|
38
|
+
headersForUrl?: (url: string) => Record<string, string>;
|
|
39
|
+
onResponse?: (response: PublicHttpResponse, url: string) => void;
|
|
40
|
+
maxRedirects?: number;
|
|
41
|
+
dependencies?: PublicHttpDependencies;
|
|
42
|
+
internalDestinationPolicy?: InternalDestinationPolicy;
|
|
43
|
+
}): Promise<PublicHttpResult>;
|
|
44
|
+
export declare function createPublicSocketLookup(resolveAddresses: PublicHttpDependencies['resolveAddresses'], internalDestinationPolicy?: InternalDestinationPolicy): LookupFunction;
|
|
45
|
+
export declare function headerValue(headers: IncomingHttpHeaders, name: string): string | null;
|
|
46
|
+
export declare const defaultPublicHttpDependencies: PublicHttpDependencies;
|
|
@@ -0,0 +1,58 @@
|
|
|
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 { commandNeedsRealProc } from "../sandbox/index.js";
|
|
9
|
+
import { type BashSandboxBoundary } from "./bash-sandbox.js";
|
|
10
|
+
export { buildBashFilesystemPolicy, type BashSandboxBoundary, type DeferredBashPreparation, type DeferredBashPreparationResult, } from "./bash-sandbox.js";
|
|
11
|
+
export { buildSandboxEnvPolicy } from "./bash-sandbox-env.js";
|
|
12
|
+
import type { InternalGuard } from "./guard-types.js";
|
|
13
|
+
import { type SubagentBashPolicy } from "./reviewer-bash-policy.js";
|
|
14
|
+
import type { SessionOrigin } from "./session-origin.js";
|
|
15
|
+
export declare const TYPECLAW_INTERNAL_BASH_ENV = "__typeclawBashEnv";
|
|
16
|
+
export declare const TYPECLAW_INTERNAL_BASH_WITHHOLD_ENV = "__typeclawBashWithholdEnv";
|
|
17
|
+
export declare const TYPECLAW_INTERNAL_BASH_PREPARE = "__typeclawBashPrepare";
|
|
18
|
+
type BashEnvOverlay = Record<string, string>;
|
|
19
|
+
export declare function sanitizeBashSpawnEnvironment(inherited: NodeJS.ProcessEnv | undefined, overlay: BashEnvOverlay | undefined, withhold?: readonly string[]): NodeJS.ProcessEnv;
|
|
20
|
+
export declare function isPiCodingBuiltinName(name: string): boolean;
|
|
21
|
+
export declare function resolveBuiltinToolRefs(refs: BuiltinToolRef[], cwd: string, contextTools?: ReadonlyMap<string, ToolDefinition<any, any, any>>): ToolDefinition<any, any, any>[];
|
|
22
|
+
export type WrapToolOptions = {
|
|
23
|
+
pluginName: string;
|
|
24
|
+
toolName: string;
|
|
25
|
+
agentDir: string;
|
|
26
|
+
sessionId: string;
|
|
27
|
+
logger: PluginLogger;
|
|
28
|
+
hooks: HookBus;
|
|
29
|
+
guards?: readonly InternalGuard[];
|
|
30
|
+
getOrigin?: () => SessionOrigin | undefined;
|
|
31
|
+
permissions?: PermissionService;
|
|
32
|
+
getAbort?: () => ((reason?: string) => void) | undefined;
|
|
33
|
+
getLoopGuardTurn?: () => number | undefined;
|
|
34
|
+
};
|
|
35
|
+
export type WrapSystemToolOptions = {
|
|
36
|
+
agentDir: string;
|
|
37
|
+
sessionId: string;
|
|
38
|
+
hooks: HookBus;
|
|
39
|
+
guards?: readonly InternalGuard[];
|
|
40
|
+
getOrigin?: () => SessionOrigin | undefined;
|
|
41
|
+
getAbort?: () => ((reason?: string) => void) | undefined;
|
|
42
|
+
getLoopGuardTurn?: () => number | undefined;
|
|
43
|
+
permissions?: PermissionService;
|
|
44
|
+
bashPolicy?: SubagentBashPolicy;
|
|
45
|
+
bashSandboxBoundary?: BashSandboxBoundary;
|
|
46
|
+
realProcDependencyCheck?: typeof commandNeedsRealProc;
|
|
47
|
+
remediations?: RemediationRegistry;
|
|
48
|
+
resolvePreflightFileOperands?: (tool: string, args: Record<string, unknown>) => ToolFileOperands | undefined;
|
|
49
|
+
incidentLedger?: IncidentLedger;
|
|
50
|
+
};
|
|
51
|
+
export declare function zodToToolParameters(schema: z.ZodType<unknown>): TSchema;
|
|
52
|
+
export declare function wrapPluginTool(tool: Tool<any>, opts: WrapToolOptions): ToolDefinition;
|
|
53
|
+
export declare function wrapSystemTool<TParams extends TSchema, TDetails = unknown, TState = unknown>(tool: ToolDefinition<TParams, TDetails, TState>, opts: WrapSystemToolOptions): ToolDefinition<TParams, TDetails, TState>;
|
|
54
|
+
export declare function wrapBuiltinToolDefinition<TParams extends TSchema, TDetails = unknown, TState = any>(tool: ToolDefinition<TParams, TDetails, TState>, opts: WrapSystemToolOptions): ToolDefinition<TParams, TDetails, TState>;
|
|
55
|
+
export declare function defaultBuiltinPiToolDefinitions(cwd: string): ToolDefinition<any, any, any>[];
|
|
56
|
+
export declare function buildBuiltinPiToolOverrides(opts: WrapSystemToolOptions): ToolDefinition<any, any>[];
|
|
57
|
+
export declare function forgetSharedLoopGuardTool(sessionId: string, tool: string): void;
|
|
58
|
+
export declare function __resetSharedLoopGuardForTests(): void;
|
|
@@ -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;
|