typeclaw 0.48.13 → 0.50.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/types/agent/attention-escalation.d.ts +18 -0
- package/dist/types/agent/auth.d.ts +7 -0
- package/dist/types/agent/compaction.d.ts +8 -0
- package/dist/types/agent/git-nudge.d.ts +6 -0
- package/dist/types/agent/guard-types.d.ts +25 -0
- package/dist/types/agent/guards.d.ts +7 -0
- package/dist/types/agent/idle-compaction.d.ts +7 -0
- package/dist/types/agent/index.d.ts +163 -0
- package/dist/types/agent/live-subagents.d.ts +113 -0
- package/dist/types/agent/llm-replay-sanitizer.d.ts +11 -0
- package/dist/types/agent/loop-guard.d.ts +67 -0
- package/dist/types/agent/model-fallback.d.ts +29 -0
- package/dist/types/agent/model-overrides.d.ts +8 -0
- package/dist/types/agent/multimodal/index.d.ts +2 -0
- package/dist/types/agent/multimodal/look-at.d.ts +60 -0
- package/dist/types/agent/multimodal/looker.d.ts +61 -0
- package/dist/types/agent/multimodal/read-redirect.d.ts +6 -0
- package/dist/types/agent/network/response-body.d.ts +1 -0
- package/dist/types/agent/network/safe-http.d.ts +46 -0
- package/dist/types/agent/plugin-tools.d.ts +129 -0
- package/dist/types/agent/proactive-next-step-nudge.d.ts +2 -0
- package/dist/types/agent/prompt-cache-key.d.ts +3 -0
- package/dist/types/agent/provider-error.d.ts +23 -0
- package/dist/types/agent/reload-tool.d.ts +10 -0
- package/dist/types/agent/restart/index.d.ts +31 -0
- package/dist/types/agent/restart-handoff/index.d.ts +32 -0
- package/dist/types/agent/restart-handoff/paths.d.ts +1 -0
- package/dist/types/agent/retry-same-ref.d.ts +41 -0
- package/dist/types/agent/reviewer-activity.d.ts +3 -0
- package/dist/types/agent/reviewer-bash-policy.d.ts +8 -0
- package/dist/types/agent/self.d.ts +1 -0
- package/dist/types/agent/session-meta.d.ts +28 -0
- package/dist/types/agent/session-origin.d.ts +65 -0
- package/dist/types/agent/subagent-cache-keepalive.d.ts +38 -0
- package/dist/types/agent/subagent-completion-reminder.d.ts +29 -0
- package/dist/types/agent/subagent-drain.d.ts +25 -0
- package/dist/types/agent/subagent-session.d.ts +3 -0
- package/dist/types/agent/subagents.d.ts +153 -0
- package/dist/types/agent/system-prompt.d.ts +7 -0
- package/dist/types/agent/throttle-circuit.d.ts +25 -0
- package/dist/types/agent/todo/continuation-policy.d.ts +54 -0
- package/dist/types/agent/todo/continuation-state.d.ts +11 -0
- package/dist/types/agent/todo/continuation-wiring.d.ts +32 -0
- package/dist/types/agent/todo/continuation.d.ts +21 -0
- package/dist/types/agent/todo/scope.d.ts +6 -0
- package/dist/types/agent/todo/store.d.ts +16 -0
- package/dist/types/agent/tool-error-remediation.d.ts +1 -0
- package/dist/types/agent/tool-file-safety.d.ts +78 -0
- package/dist/types/agent/tool-not-found-nudge.d.ts +9 -0
- package/dist/types/agent/tool-result-budget.d.ts +15 -0
- package/dist/types/agent/tools/channel-disengage.d.ts +18 -0
- package/dist/types/agent/tools/channel-edit.d.ts +19 -0
- package/dist/types/agent/tools/channel-fetch-attachment.d.ts +36 -0
- package/dist/types/agent/tools/channel-handoff.d.ts +13 -0
- package/dist/types/agent/tools/channel-history-render.d.ts +3 -0
- package/dist/types/agent/tools/channel-history.d.ts +25 -0
- package/dist/types/agent/tools/channel-log.d.ts +5 -0
- package/dist/types/agent/tools/channel-react.d.ts +23 -0
- package/dist/types/agent/tools/channel-read.d.ts +27 -0
- package/dist/types/agent/tools/channel-reply.d.ts +47 -0
- package/dist/types/agent/tools/channel-send.d.ts +42 -0
- package/dist/types/agent/tools/channel-session-search.d.ts +10 -0
- package/dist/types/agent/tools/curl-impersonate.d.ts +37 -0
- package/dist/types/agent/tools/ddg.d.ts +18 -0
- package/dist/types/agent/tools/grant-role.d.ts +25 -0
- package/dist/types/agent/tools/keyed-semaphore.d.ts +10 -0
- package/dist/types/agent/tools/post-github-review.d.ts +38 -0
- package/dist/types/agent/tools/restart.d.ts +25 -0
- package/dist/types/agent/tools/runtime-notice.d.ts +3 -0
- package/dist/types/agent/tools/search-retry.d.ts +16 -0
- package/dist/types/agent/tools/skip-response.d.ts +17 -0
- package/dist/types/agent/tools/spawn-subagent.d.ts +77 -0
- package/dist/types/agent/tools/stream-snapshot.d.ts +23 -0
- package/dist/types/agent/tools/subagent-access.d.ts +20 -0
- package/dist/types/agent/tools/subagent-cancel.d.ts +23 -0
- package/dist/types/agent/tools/subagent-output.d.ts +50 -0
- package/dist/types/agent/tools/todo/index.d.ts +14 -0
- package/dist/types/agent/tools/webfetch/adaptive-html.d.ts +29 -0
- package/dist/types/agent/tools/webfetch/fetch.d.ts +26 -0
- package/dist/types/agent/tools/webfetch/html-lexical.d.ts +27 -0
- package/dist/types/agent/tools/webfetch/index.d.ts +1 -0
- package/dist/types/agent/tools/webfetch/inline-style-visibility.d.ts +3 -0
- package/dist/types/agent/tools/webfetch/strategies/grep.d.ts +11 -0
- package/dist/types/agent/tools/webfetch/strategies/jq.d.ts +4 -0
- package/dist/types/agent/tools/webfetch/strategies/raw.d.ts +1 -0
- package/dist/types/agent/tools/webfetch/strategies/readability.d.ts +16 -0
- package/dist/types/agent/tools/webfetch/strategies/selector.d.ts +4 -0
- package/dist/types/agent/tools/webfetch/strategies/snapshot.d.ts +1 -0
- package/dist/types/agent/tools/webfetch/tool.d.ts +15 -0
- package/dist/types/agent/tools/webfetch/types.d.ts +32 -0
- package/dist/types/agent/tools/websearch.d.ts +17 -0
- package/dist/types/agent/tools/wikipedia.d.ts +7 -0
- package/dist/types/agent/tools-without-local-file-operands.d.ts +1 -0
- package/dist/types/agent/turn-runner.d.ts +36 -0
- package/dist/types/agent-messenger/config-dir.d.ts +19 -0
- package/dist/types/browser/dockerfile.d.ts +2 -0
- package/dist/types/browser/registry.d.ts +49 -0
- package/dist/types/bundled-plugins/bun-hygiene/policy.d.ts +18 -0
- package/dist/types/bundled-plugins/github-cli-auth/git-askpass.d.ts +5 -0
- package/dist/types/bundled-plugins/guard/keys.d.ts +6 -0
- package/dist/types/bundled-plugins/guard/policies/managed-config.d.ts +7 -0
- package/dist/types/bundled-plugins/guard/policies/memory-topics-delete.d.ts +11 -0
- package/dist/types/bundled-plugins/guard/policies/memory-topics-write.d.ts +7 -0
- package/dist/types/bundled-plugins/guard/policies/non-workspace-write.d.ts +9 -0
- package/dist/types/bundled-plugins/guard/policies/skill-authoring.d.ts +20 -0
- package/dist/types/bundled-plugins/guard/policies/uncommitted-changes.d.ts +12 -0
- package/dist/types/bundled-plugins/guard/policy.d.ts +11 -0
- package/dist/types/bundled-plugins/memory/secret-detector.d.ts +11 -0
- package/dist/types/bundled-plugins/memory/slug.d.ts +4 -0
- package/dist/types/bundled-plugins/security/permissions.d.ts +20 -0
- package/dist/types/bundled-plugins/security/policies/private-surface-read.d.ts +34 -0
- package/dist/types/bundled-plugins/security/policies/ssrf.d.ts +18 -0
- package/dist/types/bundled-plugins/security/policy.d.ts +4 -0
- package/dist/types/channels/adapter-namespace.d.ts +2 -0
- package/dist/types/channels/adapters/mention-hints.d.ts +12 -0
- package/dist/types/channels/adapters/webex-id-ref.d.ts +5 -0
- package/dist/types/channels/background-handoff.d.ts +56 -0
- package/dist/types/channels/background-obligations.d.ts +135 -0
- package/dist/types/channels/catch-up.d.ts +26 -0
- package/dist/types/channels/commands.d.ts +2 -0
- package/dist/types/channels/completion-claim.d.ts +20 -0
- package/dist/types/channels/continuation-willingness.d.ts +1 -0
- package/dist/types/channels/continuity-types.d.ts +75 -0
- package/dist/types/channels/describe-error.d.ts +1 -0
- package/dist/types/channels/engagement.d.ts +34 -0
- package/dist/types/channels/github-false-receipt.d.ts +20 -0
- package/dist/types/channels/github-repo.d.ts +2 -0
- package/dist/types/channels/github-rereview-guard.d.ts +24 -0
- package/dist/types/channels/github-review-check.d.ts +135 -0
- package/dist/types/channels/github-review-claim.d.ts +3 -0
- package/dist/types/channels/github-review-turn-ledger.d.ts +71 -0
- package/dist/types/channels/github-review-verdict-coordinator.d.ts +117 -0
- package/dist/types/channels/github-token-bridge.d.ts +20 -0
- package/dist/types/channels/github-verdict-activity.d.ts +12 -0
- package/dist/types/channels/inbound-journal.d.ts +272 -0
- package/dist/types/channels/last-alive.d.ts +3 -0
- package/dist/types/channels/membership-cache.d.ts +27 -0
- package/dist/types/channels/membership.d.ts +21 -0
- package/dist/types/channels/outbound-flood-filter.d.ts +7 -0
- package/dist/types/channels/participants.d.ts +4 -0
- package/dist/types/channels/persistence.d.ts +32 -0
- package/dist/types/channels/recovery-notice.d.ts +26 -0
- package/dist/types/channels/recovery-outbox.d.ts +58 -0
- package/dist/types/channels/router.d.ts +798 -0
- package/dist/types/channels/schema.d.ts +501 -0
- package/dist/types/channels/session-handoff.d.ts +58 -0
- package/dist/types/channels/session-search.d.ts +29 -0
- package/dist/types/channels/types.d.ts +414 -0
- package/dist/types/channels/waiting-reactions.d.ts +25 -0
- package/dist/types/cli/builtins.d.ts +2 -0
- package/dist/types/cli/command-meta.d.ts +9 -0
- package/dist/types/coding-agent/broker-body.d.ts +7 -0
- package/dist/types/coding-agent/broker.d.ts +22 -0
- package/dist/types/coding-agent/claude.d.ts +22 -0
- package/dist/types/coding-agent/codex.d.ts +19 -0
- package/dist/types/coding-agent/index.d.ts +71 -0
- package/dist/types/coding-agent/omo-state.d.ts +2 -0
- package/dist/types/coding-agent/omo-stream.d.ts +22 -0
- package/dist/types/coding-agent/omo.d.ts +133 -0
- package/dist/types/coding-agent/runner.d.ts +35 -0
- package/dist/types/coding-agent/tool.d.ts +27 -0
- package/dist/types/coding-agent/worktree.d.ts +22 -0
- package/dist/types/commands/index.d.ts +45 -0
- package/dist/types/config/config.d.ts +814 -0
- package/dist/types/config/index.d.ts +3 -0
- package/dist/types/config/model-overrides.d.ts +3 -0
- package/dist/types/config/providers.d.ts +1456 -0
- package/dist/types/config/reloadable.d.ts +9 -0
- package/dist/types/container/agent-operation-lock.d.ts +31 -0
- package/dist/types/container/build-cache.d.ts +39 -0
- package/dist/types/container/compose-project.d.ts +1 -0
- package/dist/types/container/controller.d.ts +25 -0
- package/dist/types/container/docker-app.d.ts +23 -0
- package/dist/types/container/exit-reason.d.ts +10 -0
- package/dist/types/container/index.d.ts +14 -0
- package/dist/types/container/log-archive.d.ts +68 -0
- package/dist/types/container/log-colors.d.ts +3 -0
- package/dist/types/container/log-timestamps.d.ts +9 -0
- package/dist/types/container/logs.d.ts +37 -0
- package/dist/types/container/memory-limit.d.ts +13 -0
- package/dist/types/container/memory-oversubscription.d.ts +20 -0
- package/dist/types/container/oom-events.d.ts +18 -0
- package/dist/types/container/port.d.ts +18 -0
- package/dist/types/container/require-running.d.ts +16 -0
- package/dist/types/container/restart.d.ts +32 -0
- package/dist/types/container/shared.d.ts +93 -0
- package/dist/types/container/shell.d.ts +35 -0
- package/dist/types/container/start.d.ts +144 -0
- package/dist/types/container/stats.d.ts +31 -0
- package/dist/types/container/status.d.ts +25 -0
- package/dist/types/container/stop.d.ts +24 -0
- package/dist/types/container/tool-oom-priority.d.ts +4 -0
- package/dist/types/container/verify-running.d.ts +49 -0
- package/dist/types/cron/consumer.d.ts +42 -0
- package/dist/types/cron/count-state.d.ts +24 -0
- package/dist/types/cron/index.d.ts +21 -0
- package/dist/types/cron/list.d.ts +33 -0
- package/dist/types/cron/reloadable.d.ts +11 -0
- package/dist/types/cron/scheduler.d.ts +51 -0
- package/dist/types/cron/schema.d.ts +108 -0
- package/dist/types/dependencies/bin-resolver.d.ts +28 -0
- package/dist/types/dependencies/bins.d.ts +22 -0
- package/dist/types/dependencies/index.d.ts +2 -0
- package/dist/types/git/bound-gc-config.d.ts +4 -0
- package/dist/types/git/hookless.d.ts +1 -0
- package/dist/types/git/reconcile-ignored.d.ts +13 -0
- package/dist/types/git/resolve-agent-git.d.ts +8 -0
- package/dist/types/git/resolve-identity.d.ts +10 -0
- package/dist/types/git/run.d.ts +24 -0
- package/dist/types/git/system-commit.d.ts +2 -0
- package/dist/types/hostd/client.d.ts +13 -0
- package/dist/types/hostd/models.d.ts +1 -0
- package/dist/types/hostd/paths.d.ts +17 -0
- package/dist/types/hostd/protocol.d.ts +93 -0
- package/dist/types/hostd/spawn.d.ts +17 -0
- package/dist/types/hostd/version.d.ts +18 -0
- package/dist/types/init/auto-upgrade.d.ts +41 -0
- package/dist/types/init/cli-version.d.ts +7 -0
- package/dist/types/init/dockerfile.d.ts +34 -0
- package/dist/types/init/ensure-deps.d.ts +17 -0
- package/dist/types/init/env-file.d.ts +3 -0
- package/dist/types/init/gitignore.d.ts +5 -0
- package/dist/types/init/local-source-stamp.d.ts +3 -0
- package/dist/types/init/packagejson.d.ts +7 -0
- package/dist/types/init/paths.d.ts +3 -0
- package/dist/types/init/reconcile-plugin-deps.d.ts +13 -0
- package/dist/types/init/run-bun-install.d.ts +16 -0
- package/dist/types/init/windows-dev-link.d.ts +8 -0
- package/dist/types/mcp/catalog.d.ts +7 -0
- package/dist/types/mcp/client.d.ts +58 -0
- package/dist/types/mcp/manager.d.ts +56 -0
- package/dist/types/mcp/tools.d.ts +23 -0
- package/dist/types/models/embedding-model.d.ts +20 -0
- package/dist/types/models/transformers-version.d.ts +1 -0
- package/dist/types/network/internal-destinations.d.ts +29 -0
- package/dist/types/operations/classify-tool-outcome.d.ts +35 -0
- package/dist/types/operations/incidents.d.ts +47 -0
- package/dist/types/operations/index.d.ts +3 -0
- package/dist/types/operations/remediations.d.ts +25 -0
- package/dist/types/path-safety/real-intended-path.d.ts +9 -0
- package/dist/types/permissions/builtins.d.ts +25 -0
- package/dist/types/permissions/grant.d.ts +19 -0
- package/dist/types/permissions/index.d.ts +6 -0
- package/dist/types/permissions/match-rule.d.ts +28 -0
- package/dist/types/permissions/permissions.d.ts +42 -0
- package/dist/types/permissions/resolve.d.ts +25 -0
- package/dist/types/permissions/schema.d.ts +14 -0
- package/dist/types/plugin/context.d.ts +20 -0
- package/dist/types/plugin/core-tool-names.d.ts +4 -0
- package/dist/types/plugin/define.d.ts +46 -0
- package/dist/types/plugin/hooks.d.ts +52 -0
- package/dist/types/plugin/index.d.ts +11 -0
- package/dist/types/plugin/load-skill.d.ts +14 -0
- package/dist/types/plugin/loader.d.ts +25 -0
- package/dist/types/plugin/manager.d.ts +42 -0
- package/dist/types/plugin/registry.d.ts +73 -0
- package/dist/types/plugin/skills.d.ts +11 -0
- package/dist/types/plugin/types.d.ts +336 -0
- package/dist/types/plugin/zod-introspect.d.ts +11 -0
- package/dist/types/reload/client.d.ts +11 -0
- package/dist/types/reload/docker-exec-client.d.ts +11 -0
- package/dist/types/reload/format.d.ts +2 -0
- package/dist/types/reload/index.d.ts +6 -0
- package/dist/types/reload/recover.d.ts +22 -0
- package/dist/types/reload/registry.d.ts +10 -0
- package/dist/types/reload/types.d.ts +25 -0
- package/dist/types/role-claim/client.d.ts +20 -0
- package/dist/types/role-claim/code.d.ts +4 -0
- package/dist/types/role-claim/controller.d.ts +59 -0
- package/dist/types/role-claim/index.d.ts +6 -0
- package/dist/types/role-claim/match-rule.d.ts +9 -0
- package/dist/types/role-claim/pending.d.ts +35 -0
- package/dist/types/role-claim/reload-after-claim.d.ts +16 -0
- package/dist/types/run/llm-fetch-observer.d.ts +50 -0
- package/dist/types/sandbox/availability.d.ts +21 -0
- package/dist/types/sandbox/build.d.ts +7 -0
- package/dist/types/sandbox/canonical-secrets.d.ts +8 -0
- package/dist/types/sandbox/coding-agent.d.ts +20 -0
- package/dist/types/sandbox/dependency-bins.d.ts +19 -0
- package/dist/types/sandbox/dev-source.d.ts +4 -0
- package/dist/types/sandbox/env-exposure.d.ts +1 -0
- package/dist/types/sandbox/errors.d.ts +20 -0
- package/dist/types/sandbox/hidden-paths.d.ts +11 -0
- package/dist/types/sandbox/index.d.ts +14 -0
- package/dist/types/sandbox/package-install.d.ts +1 -0
- package/dist/types/sandbox/policy.d.ts +71 -0
- package/dist/types/sandbox/privileged-runtime.d.ts +13 -0
- package/dist/types/sandbox/quote.d.ts +2 -0
- package/dist/types/sandbox/runtime-private.d.ts +1 -0
- package/dist/types/sandbox/session-tmp.d.ts +6 -0
- package/dist/types/sandbox/symlinks.d.ts +6 -0
- package/dist/types/sandbox/writable-zones.d.ts +15 -0
- package/dist/types/secrets/coding-agent-auth.d.ts +25 -0
- package/dist/types/secrets/defaults.d.ts +21 -0
- package/dist/types/secrets/export-github-cli-store.d.ts +22 -0
- package/dist/types/secrets/hydrate.d.ts +7 -0
- package/dist/types/secrets/index.d.ts +7 -0
- package/dist/types/secrets/provision-github-cli-store.d.ts +45 -0
- package/dist/types/secrets/refresh-provider-oauth.d.ts +22 -0
- package/dist/types/secrets/resolve.d.ts +14 -0
- package/dist/types/secrets/schema.d.ts +840 -0
- package/dist/types/secrets/storage.d.ts +56 -0
- package/dist/types/shared/host-locale.d.ts +1 -0
- package/dist/types/shared/index.d.ts +5 -0
- package/dist/types/shared/local-time.d.ts +4 -0
- package/dist/types/shared/platform.d.ts +2 -0
- package/dist/types/shared/protocol.d.ts +424 -0
- package/dist/types/shared/style-text.d.ts +3 -0
- package/dist/types/shared/wsl.d.ts +17 -0
- package/dist/types/stream/broker.d.ts +2 -0
- package/dist/types/stream/index.d.ts +2 -0
- package/dist/types/stream/types.d.ts +71 -0
- package/package.json +13 -6
- package/scripts/build-plugin-types.ts +105 -0
- package/scripts/check-plugin-sdk.ts +111 -0
- package/scripts/dump-system-prompt.ts +52 -110
- package/scripts/require-parallel.ts +5 -32
- package/src/agent/guard-types.ts +3 -0
- package/src/agent/guards.ts +4 -0
- package/src/agent/idle-compaction.ts +174 -0
- package/src/agent/index.ts +210 -80
- package/src/agent/live-sessions.ts +2 -2
- package/src/agent/live-subagents.ts +20 -0
- package/src/agent/multimodal/look-at.ts +22 -9
- package/src/agent/plugin-tools.ts +66 -12
- package/src/agent/prompt-cache-key.ts +42 -0
- package/src/agent/provider-error.ts +179 -10
- package/src/agent/restart-handoff/index.ts +7 -14
- package/src/agent/reviewer-activity.ts +68 -0
- package/src/agent/reviewer-bash-policy.ts +41 -1
- package/src/agent/session-origin.ts +58 -9
- package/src/agent/subagent-cache-keepalive.ts +198 -0
- package/src/agent/subagent-session.ts +6 -0
- package/src/agent/subagents.ts +59 -9
- package/src/agent/system-prompt.ts +68 -202
- package/src/agent/todo/continuation-policy.ts +12 -4
- package/src/agent/tool-file-safety.ts +119 -15
- package/src/agent/tool-not-found-nudge.ts +1 -1
- package/src/agent/tools/channel-edit.ts +20 -10
- package/src/agent/tools/channel-fetch-attachment.ts +12 -5
- package/src/agent/tools/channel-handoff.ts +72 -0
- package/src/agent/tools/channel-history-render.ts +2 -1
- package/src/agent/tools/channel-read.ts +57 -10
- package/src/agent/tools/channel-reply.ts +55 -30
- package/src/agent/tools/channel-send.ts +69 -19
- package/src/agent/tools/channel-session-search.ts +35 -0
- package/src/agent/tools/curl-impersonate.ts +22 -6
- package/src/agent/tools/ddg.ts +13 -5
- package/src/agent/tools/post-github-review.ts +77 -15
- package/src/agent/tools/skip-response.ts +2 -2
- package/src/agent/tools/spawn-subagent.ts +190 -23
- package/src/agent/tools/stream-snapshot.ts +15 -2
- package/src/agent/tools/subagent-access.ts +11 -4
- package/src/agent/tools/subagent-output.ts +8 -0
- package/src/browser/bsk-shim.mjs +74 -0
- package/src/browser/dockerfile.ts +84 -0
- package/src/browser/egress.ts +104 -0
- package/src/browser/managed-browser.ts +205 -0
- package/src/browser/registry.ts +110 -0
- package/src/browser/relay.ts +231 -0
- package/src/browser/sandbox-entry.ts +167 -0
- package/src/bundled-plugins/agent-browser/index.ts +2 -0
- package/src/bundled-plugins/backup/README.md +10 -9
- package/src/bundled-plugins/backup/runner.ts +140 -58
- package/src/bundled-plugins/backup/subagents.ts +58 -26
- package/src/bundled-plugins/browser-agent/browser-agent.ts +89 -0
- package/src/bundled-plugins/browser-agent/index.ts +12 -0
- package/src/bundled-plugins/doc-render/index.ts +0 -10
- package/src/bundled-plugins/doc-render/render.ts +83 -111
- package/src/bundled-plugins/doc-render/skills/typeclaw-render-pdf/SKILL.md +152 -257
- package/src/bundled-plugins/github-cli-auth/gh-command.ts +38 -2
- package/src/bundled-plugins/github-cli-auth/git-auth-diagnostic.ts +95 -0
- package/src/bundled-plugins/github-cli-auth/granted-push.ts +135 -0
- package/src/bundled-plugins/github-cli-auth/index.ts +158 -70
- package/src/bundled-plugins/github-cli-auth/review-account.ts +23 -0
- package/src/bundled-plugins/github-cli-auth/review-checkout.ts +9 -2
- package/src/bundled-plugins/github-cli-auth/review-recorder.ts +45 -7
- package/src/bundled-plugins/managed-browser/index.ts +74 -0
- package/src/bundled-plugins/managed-browser/skills/browser-use/browser-use/SKILL.md +27 -0
- package/src/bundled-plugins/managed-browser/skills/browserskill/browserskill/SKILL.md +28 -0
- package/src/bundled-plugins/managed-browser/skills/omowright/omowright/SKILL.md +40 -0
- package/src/bundled-plugins/operator/operator.ts +15 -4
- package/src/bundled-plugins/qa/index.ts +11 -0
- package/src/bundled-plugins/qa/qa.ts +160 -0
- package/src/bundled-plugins/qa/skills/qa-cli.ts +50 -0
- package/src/bundled-plugins/qa/skills/qa-general.ts +30 -0
- package/src/bundled-plugins/qa/skills/qa-http.ts +39 -0
- package/src/bundled-plugins/qa/skills/qa-pr.ts +51 -0
- package/src/bundled-plugins/qa/skills/qa-web.ts +49 -0
- package/src/bundled-plugins/reviewer/skills/code-review.ts +1 -1
- package/src/bundled-plugins/security/index.ts +103 -36
- package/src/bundled-plugins/security/policies/git-exfil.ts +24 -12
- package/src/bundled-plugins/security/policies/outbound-secret-scan.ts +1 -0
- package/src/channels/adapter-namespace.ts +13 -0
- package/src/channels/adapters/discord-bot-reactions.ts +18 -0
- package/src/channels/adapters/discord-bot.ts +219 -72
- package/src/channels/adapters/discord-reactions.ts +18 -0
- package/src/channels/adapters/discord.ts +114 -8
- package/src/channels/adapters/github/inbound.ts +103 -8
- package/src/channels/adapters/github/index.ts +267 -19
- package/src/channels/adapters/github/last-alive.ts +15 -0
- package/src/channels/adapters/github/outbound.ts +54 -18
- package/src/channels/adapters/github/pending-review-store.ts +141 -0
- package/src/channels/adapters/github/permission-guidance.ts +1 -0
- package/src/channels/adapters/github/reactions.ts +100 -0
- package/src/channels/adapters/github/reconcile-cooldown-store.ts +197 -67
- package/src/channels/adapters/github/reconcile-open-prs.ts +418 -33
- package/src/channels/adapters/github/recovery.ts +106 -0
- package/src/channels/adapters/github/review-check.ts +510 -0
- package/src/channels/adapters/github/review-submitter.ts +34 -2
- package/src/channels/adapters/instagram.ts +32 -14
- package/src/channels/adapters/kakaotalk.ts +22 -7
- package/src/channels/adapters/line.ts +18 -3
- package/src/channels/adapters/outbound-account.ts +20 -0
- package/src/channels/adapters/own-reactions.ts +66 -0
- package/src/channels/adapters/recovery-correlation.ts +214 -0
- package/src/channels/adapters/slack-attachment-download.ts +14 -3
- package/src/channels/adapters/slack-bot-author-resolver.ts +4 -3
- package/src/channels/adapters/slack-bot-channel-resolver.ts +9 -6
- package/src/channels/adapters/slack-bot-classify.ts +19 -11
- package/src/channels/adapters/slack-bot-dedupe.ts +111 -28
- package/src/channels/adapters/slack-bot-reactions.ts +18 -0
- package/src/channels/adapters/slack-bot-slash-commands.ts +3 -1
- package/src/channels/adapters/slack-bot.ts +424 -124
- package/src/channels/adapters/slack-classify.ts +26 -4
- package/src/channels/adapters/slack-inbound-revision.ts +96 -0
- package/src/channels/adapters/slack-reactions.ts +18 -0
- package/src/channels/adapters/slack-thread-ts.ts +6 -0
- package/src/channels/adapters/slack.ts +48 -3
- package/src/channels/adapters/teams.ts +14 -4
- package/src/channels/adapters/telegram-bot.ts +56 -10
- package/src/channels/adapters/webex-bot.ts +12 -2
- package/src/channels/adapters/webex.ts +12 -2
- package/src/channels/background-handoff.ts +434 -0
- package/src/channels/background-obligations.ts +893 -0
- package/src/channels/catch-up.ts +137 -0
- package/src/channels/continuation-willingness.ts +2 -2
- package/src/channels/continuity-types.ts +272 -0
- package/src/channels/engagement.ts +17 -1
- package/src/channels/github-false-receipt.ts +3 -3
- package/src/channels/github-rereview-guard.ts +9 -5
- package/src/channels/github-review-check.ts +598 -0
- package/src/channels/github-review-turn-ledger.ts +102 -28
- package/src/channels/github-review-verdict-coordinator.ts +72 -12
- package/src/channels/github-token-bridge.ts +35 -5
- package/src/channels/inbound-journal.ts +1738 -0
- package/src/channels/index.ts +6 -1
- package/src/channels/last-alive.ts +34 -0
- package/src/channels/manager.ts +25 -8
- package/src/channels/recovery-dispatcher.ts +264 -0
- package/src/channels/recovery-notice.ts +94 -0
- package/src/channels/recovery-outbox.ts +459 -0
- package/src/channels/router.ts +2951 -736
- package/src/channels/schema.ts +8 -1
- package/src/channels/session-handoff.fixture.ts +144 -0
- package/src/channels/session-handoff.ts +175 -0
- package/src/channels/session-search.ts +71 -0
- package/src/channels/subagent-completion-bridge.ts +17 -14
- package/src/channels/types.ts +133 -18
- package/src/channels/waiting-reactions.ts +664 -0
- package/src/cli/channel.ts +2 -3
- package/src/cli/compose.ts +7 -4
- package/src/cli/hostd.ts +49 -3
- package/src/cli/init.ts +2 -3
- package/src/cli/inspect.ts +11 -14
- package/src/cli/model.ts +132 -3
- package/src/coding-agent/broker-body.ts +38 -0
- package/src/coding-agent/broker.ts +290 -0
- package/src/coding-agent/claude.ts +95 -0
- package/src/coding-agent/codex.ts +104 -0
- package/src/coding-agent/index.ts +512 -0
- package/src/coding-agent/omo-state.ts +69 -0
- package/src/coding-agent/omo-stream.ts +138 -0
- package/src/coding-agent/omo.ts +192 -0
- package/src/coding-agent/runner.ts +285 -0
- package/src/coding-agent/tool.ts +62 -0
- package/src/coding-agent/worktree.ts +355 -0
- package/src/compose/restart.ts +10 -3
- package/src/compose/start.ts +20 -3
- package/src/config/config.ts +121 -25
- package/src/config/model-overrides.ts +59 -0
- package/src/config/models-mutation.ts +185 -2
- package/src/config/providers-mutation.ts +12 -4
- package/src/config/providers.ts +71 -9
- package/src/container/exit-reason.ts +44 -0
- package/src/container/index.ts +5 -0
- package/src/container/log-archive.ts +51 -13
- package/src/container/memory-limit.ts +1 -1
- package/src/container/memory-oversubscription.ts +36 -6
- package/src/container/oom-events.ts +86 -0
- package/src/container/restart.ts +2 -0
- package/src/container/shared.ts +8 -1
- package/src/container/start.ts +120 -17
- package/src/container/stop.ts +6 -2
- package/src/container/tool-oom-priority.ts +32 -0
- package/src/cron/consumer.ts +10 -4
- package/src/cron/reloadable.ts +23 -2
- package/src/doctor/checks.ts +22 -8
- package/src/hostd/daemon.ts +33 -11
- package/src/hostd/spawn.ts +106 -5
- package/src/hostd/version.ts +20 -0
- package/src/hostd/watchdog.ts +241 -0
- package/src/init/auto-upgrade.ts +7 -1
- package/src/init/dockerfile.ts +112 -602
- package/src/init/index.ts +6 -6
- package/src/init/local-source-stamp.ts +68 -0
- package/src/init/models-dev.ts +4 -0
- package/src/init/validate-api-key.ts +3 -0
- package/src/mcp/client.ts +3 -1
- package/src/operations/classify-tool-outcome.ts +45 -1
- package/src/operations/incidents.ts +10 -5
- package/src/permissions/builtins.ts +7 -0
- package/src/permissions/permissions.ts +18 -9
- package/src/permissions/resolve.ts +7 -1
- package/src/plugin/context.ts +2 -0
- package/src/plugin/core-tool-names.ts +1 -1
- package/src/plugin/define.ts +1 -0
- package/src/plugin/hooks.ts +137 -0
- package/src/plugin/index.ts +7 -0
- package/src/plugin/manager.ts +4 -0
- package/src/plugin/types.ts +66 -1
- package/src/run/background-handoff-boot.ts +86 -0
- package/src/run/bundled-plugins.ts +6 -0
- package/src/run/index.ts +107 -97
- package/src/run/llm-fetch-observer.ts +12 -15
- package/src/run/resource-sample.ts +19 -0
- package/src/sandbox/build.ts +4 -0
- package/src/sandbox/canonical-secrets.ts +4 -0
- package/src/sandbox/coding-agent.ts +214 -0
- package/src/sandbox/dev-source.ts +26 -0
- package/src/sandbox/hidden-paths.ts +16 -2
- package/src/sandbox/policy.ts +1 -0
- package/src/sandbox/runtime-private.ts +4 -1
- package/src/secrets/coding-agent-auth.ts +97 -0
- package/src/secrets/index.ts +0 -16
- package/src/secrets/storage.ts +13 -0
- package/src/server/command-runner.ts +6 -2
- package/src/server/index.ts +101 -40
- package/src/skills/typeclaw-channel-github/SKILL.md +15 -13
- package/src/skills/typeclaw-claude-code/SKILL.md +25 -260
- package/src/skills/typeclaw-claude-code/references/auth-flow.md +7 -23
- package/src/skills/typeclaw-claude-code/references/headless-sessions.md +11 -0
- package/src/skills/typeclaw-claude-code/references/results-and-worktrees.md +13 -0
- package/src/skills/typeclaw-codex-cli/SKILL.md +35 -270
- package/src/skills/typeclaw-codex-cli/references/auth-flow.md +13 -20
- package/src/skills/typeclaw-codex-cli/references/headless-sessions.md +26 -0
- package/src/skills/typeclaw-codex-cli/references/results-and-worktrees.md +28 -0
- package/src/skills/typeclaw-config/SKILL.md +60 -26
- package/src/skills/typeclaw-config/references/dockerfile.md +14 -13
- package/src/skills/typeclaw-cron/SKILL.md +1 -1
- package/src/skills/typeclaw-github-contributing/SKILL.md +3 -3
- package/src/skills/typeclaw-memory/SKILL.md +3 -3
- package/src/skills/typeclaw-monorepo/SKILL.md +1 -1
- package/src/skills/typeclaw-omo-cli/SKILL.md +52 -0
- package/src/skills/typeclaw-omo-cli/references/auth-flow.md +11 -0
- package/src/skills/typeclaw-omo-cli/references/headless-sessions.md +11 -0
- package/src/skills/typeclaw-omo-cli/references/results-and-worktrees.md +23 -0
- package/src/skills/typeclaw-permissions/SKILL.md +7 -7
- package/src/skills/typeclaw-plugins/SKILL.md +15 -15
- package/src/skills/typeclaw-skills/SKILL.md +19 -2
- package/src/skills/typeclaw-troubleshooting/SKILL.md +26 -2
- package/typeclaw.schema.json +448 -6
- package/src/bundled-plugins/doc-render/templates/lib.typ +0 -339
- package/src/bundled-plugins/github-cli-auth/gh-store.ts +0 -733
- package/src/secrets/claude-credentials-json.ts +0 -129
- package/src/secrets/codex-auth-json.ts +0 -102
- package/src/secrets/export-claude-credentials-file.ts +0 -270
- package/src/secrets/export-codex-auth-file.ts +0 -250
- package/src/skills/typeclaw-claude-code/references/stop-hook.md +0 -101
- package/src/skills/typeclaw-claude-code/references/tmux-driving.md +0 -243
- package/src/skills/typeclaw-codex-cli/references/stop-hook.md +0 -92
- package/src/skills/typeclaw-codex-cli/references/tmux-driving.md +0 -239
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
#!/usr/bin/env bun
|
|
2
|
+
|
|
3
|
+
import { rm } from 'node:fs/promises'
|
|
4
|
+
import { dirname, join, relative } from 'node:path'
|
|
5
|
+
import { fileURLToPath } from 'node:url'
|
|
6
|
+
|
|
7
|
+
import * as ts from '@typescript/typescript6'
|
|
8
|
+
|
|
9
|
+
const root = join(dirname(fileURLToPath(import.meta.url)), '..')
|
|
10
|
+
const sourceRoot = join(root, 'src')
|
|
11
|
+
const outputRoot = join(root, 'dist', 'types')
|
|
12
|
+
const configPath = join(root, 'tsconfig.json')
|
|
13
|
+
const config = ts.readConfigFile(configPath, ts.sys.readFile)
|
|
14
|
+
if (config.error) throw new Error(ts.flattenDiagnosticMessageText(config.error.messageText, '\n'))
|
|
15
|
+
const parsed = ts.parseJsonConfigFileContent(config.config, ts.sys, root)
|
|
16
|
+
const options: ts.CompilerOptions = {
|
|
17
|
+
...parsed.options,
|
|
18
|
+
noEmit: false,
|
|
19
|
+
noEmitOnError: true,
|
|
20
|
+
declaration: true,
|
|
21
|
+
declarationMap: false,
|
|
22
|
+
emitDeclarationOnly: true,
|
|
23
|
+
rootDir: sourceRoot,
|
|
24
|
+
outDir: outputRoot,
|
|
25
|
+
}
|
|
26
|
+
const program = ts.createProgram([join(sourceRoot, 'plugin', 'index.ts')], options)
|
|
27
|
+
const resolutionCache = ts.createModuleResolutionCache(root, (path) => path, options)
|
|
28
|
+
|
|
29
|
+
// Keep the emitted graph self-contained: consumers must not inherit our @/*
|
|
30
|
+
// aliases. Explicit .js specifiers also work with NodeNext declaration lookup.
|
|
31
|
+
const rewriteImports: ts.TransformerFactory<ts.SourceFile | ts.Bundle> = (context) => {
|
|
32
|
+
return (source) => {
|
|
33
|
+
if (ts.isBundle(source)) return source
|
|
34
|
+
const rewrite = (specifier: ts.StringLiteral): ts.StringLiteral => {
|
|
35
|
+
if (!specifier.text.startsWith('@/') && !specifier.text.startsWith('.')) return specifier
|
|
36
|
+
const resolved = ts.resolveModuleName(
|
|
37
|
+
specifier.text,
|
|
38
|
+
source.fileName,
|
|
39
|
+
options,
|
|
40
|
+
ts.sys,
|
|
41
|
+
resolutionCache,
|
|
42
|
+
).resolvedModule
|
|
43
|
+
if (!resolved) throw new Error(`Cannot resolve SDK declaration import ${specifier.text} in ${source.fileName}`)
|
|
44
|
+
let path = relative(dirname(source.fileName), resolved.resolvedFileName).replaceAll('\\', '/')
|
|
45
|
+
path = path
|
|
46
|
+
.replace(/\.tsx?$/, '.js')
|
|
47
|
+
.replace(/\.mts$/, '.mjs')
|
|
48
|
+
.replace(/\.cts$/, '.cjs')
|
|
49
|
+
return context.factory.createStringLiteral(path.startsWith('.') ? path : `./${path}`)
|
|
50
|
+
}
|
|
51
|
+
const visit: ts.Visitor = (node) => {
|
|
52
|
+
if (ts.isImportDeclaration(node) && ts.isStringLiteral(node.moduleSpecifier))
|
|
53
|
+
return context.factory.updateImportDeclaration(
|
|
54
|
+
node,
|
|
55
|
+
node.modifiers,
|
|
56
|
+
node.importClause,
|
|
57
|
+
rewrite(node.moduleSpecifier),
|
|
58
|
+
node.attributes,
|
|
59
|
+
)
|
|
60
|
+
if (ts.isExportDeclaration(node) && node.moduleSpecifier && ts.isStringLiteral(node.moduleSpecifier))
|
|
61
|
+
return context.factory.updateExportDeclaration(
|
|
62
|
+
node,
|
|
63
|
+
node.modifiers,
|
|
64
|
+
node.isTypeOnly,
|
|
65
|
+
node.exportClause,
|
|
66
|
+
rewrite(node.moduleSpecifier),
|
|
67
|
+
node.attributes,
|
|
68
|
+
)
|
|
69
|
+
if (ts.isImportTypeNode(node) && ts.isLiteralTypeNode(node.argument) && ts.isStringLiteral(node.argument.literal))
|
|
70
|
+
return context.factory.updateImportTypeNode(
|
|
71
|
+
node,
|
|
72
|
+
context.factory.createLiteralTypeNode(rewrite(node.argument.literal)),
|
|
73
|
+
node.attributes,
|
|
74
|
+
node.qualifier,
|
|
75
|
+
node.typeArguments,
|
|
76
|
+
node.isTypeOf,
|
|
77
|
+
)
|
|
78
|
+
return ts.visitEachChild(node, visit, context)
|
|
79
|
+
}
|
|
80
|
+
return ts.visitNode(source, visit) as ts.SourceFile
|
|
81
|
+
}
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
const diagnostics = [...parsed.errors, ...ts.getPreEmitDiagnostics(program)]
|
|
85
|
+
if (diagnostics.some((diagnostic) => diagnostic.category === ts.DiagnosticCategory.Error)) {
|
|
86
|
+
console.error(
|
|
87
|
+
ts.formatDiagnostics(diagnostics, {
|
|
88
|
+
getCanonicalFileName: (path) => path,
|
|
89
|
+
getCurrentDirectory: () => root,
|
|
90
|
+
getNewLine: () => '\n',
|
|
91
|
+
}),
|
|
92
|
+
)
|
|
93
|
+
process.exit(1)
|
|
94
|
+
}
|
|
95
|
+
await rm(outputRoot, { recursive: true, force: true })
|
|
96
|
+
const result = program.emit(undefined, undefined, undefined, true, { afterDeclarations: [rewriteImports] })
|
|
97
|
+
if (result.emitSkipped || result.diagnostics.some((diagnostic) => diagnostic.category === ts.DiagnosticCategory.Error))
|
|
98
|
+
throw new Error(
|
|
99
|
+
ts.formatDiagnostics(result.diagnostics, {
|
|
100
|
+
getCanonicalFileName: (path) => path,
|
|
101
|
+
getCurrentDirectory: () => root,
|
|
102
|
+
getNewLine: () => '\n',
|
|
103
|
+
}),
|
|
104
|
+
)
|
|
105
|
+
console.log('Built public plugin declarations under dist/types')
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
#!/usr/bin/env bun
|
|
2
|
+
|
|
3
|
+
import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises'
|
|
4
|
+
import { tmpdir } from 'node:os'
|
|
5
|
+
import { dirname, join } from 'node:path'
|
|
6
|
+
import { fileURLToPath } from 'node:url'
|
|
7
|
+
|
|
8
|
+
const root = join(dirname(fileURLToPath(import.meta.url)), '..')
|
|
9
|
+
const scratch = await mkdtemp(join(tmpdir(), 'typeclaw-plugin-sdk-'))
|
|
10
|
+
const manifest = await Bun.file(join(root, 'package.json')).json()
|
|
11
|
+
const bunTypes = await Bun.file(join(root, 'node_modules', '@types', 'bun', 'package.json')).json()
|
|
12
|
+
|
|
13
|
+
async function run(argv: string[], cwd: string): Promise<string> {
|
|
14
|
+
const child = Bun.spawn(argv, { cwd, stdin: 'ignore', stdout: 'pipe', stderr: 'pipe' })
|
|
15
|
+
const [stdout, stderr, code] = await Promise.all([
|
|
16
|
+
new Response(child.stdout).text(),
|
|
17
|
+
new Response(child.stderr).text(),
|
|
18
|
+
child.exited,
|
|
19
|
+
])
|
|
20
|
+
if (code !== 0) throw new Error(`${argv.join(' ')} failed (${code})\n${stdout}\n${stderr}`)
|
|
21
|
+
return stdout
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
try {
|
|
25
|
+
// Exercise the real prepack lifecycle. Installing with scripts disabled then
|
|
26
|
+
// proves declaration consumers do not need our dev compiler or install hook.
|
|
27
|
+
await run(['npm', 'pack', '--pack-destination', scratch], root)
|
|
28
|
+
const archiveName = `typeclaw-${manifest.version}.tgz`
|
|
29
|
+
const consumer = join(scratch, 'consumer')
|
|
30
|
+
await mkdir(consumer)
|
|
31
|
+
await writeFile(
|
|
32
|
+
join(consumer, 'package.json'),
|
|
33
|
+
JSON.stringify({
|
|
34
|
+
name: 'example-plugin-consumer',
|
|
35
|
+
private: true,
|
|
36
|
+
type: 'module',
|
|
37
|
+
dependencies: { typeclaw: `file:../${archiveName}`, zod: manifest.dependencies.zod },
|
|
38
|
+
devDependencies: { '@types/bun': bunTypes.version },
|
|
39
|
+
}),
|
|
40
|
+
)
|
|
41
|
+
await run([process.execPath, 'install', '--ignore-scripts'], consumer)
|
|
42
|
+
await writeFile(
|
|
43
|
+
join(consumer, 'tsconfig.json'),
|
|
44
|
+
JSON.stringify({
|
|
45
|
+
compilerOptions: {
|
|
46
|
+
target: 'ESNext',
|
|
47
|
+
module: 'Preserve',
|
|
48
|
+
moduleResolution: 'bundler',
|
|
49
|
+
strict: true,
|
|
50
|
+
skipLibCheck: true,
|
|
51
|
+
noEmit: true,
|
|
52
|
+
types: ['bun'],
|
|
53
|
+
},
|
|
54
|
+
include: ['plugin.ts'],
|
|
55
|
+
}),
|
|
56
|
+
)
|
|
57
|
+
await writeFile(
|
|
58
|
+
join(consumer, 'plugin.ts'),
|
|
59
|
+
`
|
|
60
|
+
import { definePlugin, type Hooks } from 'typeclaw/plugin'
|
|
61
|
+
import { z } from 'zod'
|
|
62
|
+
const hooks = {
|
|
63
|
+
'tool.before': (event) => {
|
|
64
|
+
const tool: string = event.tool
|
|
65
|
+
// @ts-expect-error tool identifiers must remain strings, not any
|
|
66
|
+
const invalid: number = event.tool
|
|
67
|
+
return tool ? undefined : { block: true as const, reason: 'empty tool' }
|
|
68
|
+
},
|
|
69
|
+
} satisfies Hooks
|
|
70
|
+
// @ts-expect-error unsupported hook names must not become valid or any
|
|
71
|
+
const unsupported: keyof Hooks = 'session.strat'
|
|
72
|
+
export default definePlugin({
|
|
73
|
+
configSchema: z.object({ enabled: z.boolean() }),
|
|
74
|
+
plugin: async (ctx) => {
|
|
75
|
+
const enabled: boolean = ctx.config.enabled
|
|
76
|
+
// @ts-expect-error schema-inferred config must not become any
|
|
77
|
+
const invalid: string = ctx.config.enabled
|
|
78
|
+
return enabled ? { hooks } : {}
|
|
79
|
+
},
|
|
80
|
+
})
|
|
81
|
+
`,
|
|
82
|
+
)
|
|
83
|
+
for (const [module, resolution] of [
|
|
84
|
+
['Preserve', 'bundler'],
|
|
85
|
+
['NodeNext', 'NodeNext'],
|
|
86
|
+
]) {
|
|
87
|
+
const output = await run(
|
|
88
|
+
[
|
|
89
|
+
process.execPath,
|
|
90
|
+
'run',
|
|
91
|
+
'typecheck',
|
|
92
|
+
'--project',
|
|
93
|
+
join(consumer, 'tsconfig.json'),
|
|
94
|
+
'--module',
|
|
95
|
+
module!,
|
|
96
|
+
'--moduleResolution',
|
|
97
|
+
resolution!,
|
|
98
|
+
'--listFiles',
|
|
99
|
+
],
|
|
100
|
+
root,
|
|
101
|
+
)
|
|
102
|
+
const files = output.split(/\r?\n/).map((file) => file.replaceAll('\\', '/'))
|
|
103
|
+
if (files.some((file) => file.includes('/node_modules/typeclaw/src/')))
|
|
104
|
+
throw new Error('The public SDK pulled TypeClaw implementation sources into the consumer.')
|
|
105
|
+
if (!files.some((file) => file.endsWith('/node_modules/typeclaw/dist/types/plugin/index.d.ts')))
|
|
106
|
+
throw new Error('The packed public SDK declaration entry was not resolved.')
|
|
107
|
+
console.log(`Packed plugin consumer passed ${resolution} resolution without source imports or @/* aliases`)
|
|
108
|
+
}
|
|
109
|
+
} finally {
|
|
110
|
+
await rm(scratch, { recursive: true, force: true })
|
|
111
|
+
}
|
|
@@ -1,9 +1,20 @@
|
|
|
1
1
|
#!/usr/bin/env bun
|
|
2
2
|
|
|
3
|
+
// Debug dump of the TypeClaw-composed system-prompt preamble for each standard
|
|
4
|
+
// session origin, with placeholder inputs. Every origin — including the
|
|
5
|
+
// default subagent — goes through the real `composeSystemPrompt`, so the
|
|
6
|
+
// sections and their order are exactly what `createResourceLoader` produces.
|
|
7
|
+
//
|
|
8
|
+
// This is the preamble only. pi appends project context (AGENTS.md), the skill
|
|
9
|
+
// catalog, and the cwd when it assembles the final system message; capture a
|
|
10
|
+
// real session's `session.systemPrompt` for that. Sessions created with an
|
|
11
|
+
// explicit `systemPromptOverride` do not use this composer and are not dumped.
|
|
12
|
+
|
|
3
13
|
import { parseArgs } from 'node:util'
|
|
4
14
|
|
|
5
|
-
import { composeSystemPrompt, deriveSystemPromptMode, renderTurnTimeAnchor
|
|
6
|
-
import type
|
|
15
|
+
import { composeSystemPrompt, deriveSystemPromptMode, renderTurnTimeAnchor } from '@/agent'
|
|
16
|
+
import { renderInteractiveSessionContext, type SessionOrigin, type SessionRoleContext } from '@/agent/session-origin'
|
|
17
|
+
import { buildSystemPolicy, DEFAULT_SUBAGENT_ROSTER, renderRuntimeBlock } from '@/agent/system-prompt'
|
|
7
18
|
import { renderRetrievedMemorySection, type RetrievedMemoryItem } from '@/bundled-plugins/memory/load-memory'
|
|
8
19
|
import { composeTurnPrompt } from '@/channels/router'
|
|
9
20
|
|
|
@@ -178,10 +189,10 @@ export type DumpResult = {
|
|
|
178
189
|
totalTokens: number
|
|
179
190
|
}
|
|
180
191
|
|
|
181
|
-
//
|
|
182
|
-
//
|
|
183
|
-
//
|
|
184
|
-
|
|
192
|
+
// Rough size estimate: ~4 chars per token. A model-agnostic rule of thumb for
|
|
193
|
+
// English prose/markdown, NOT a tokenizer count — use a real tokenizer for any
|
|
194
|
+
// measurement you report.
|
|
195
|
+
const TOKENS_PER_CHAR = 0.25
|
|
185
196
|
|
|
186
197
|
export function estimateTokens(text: string): number {
|
|
187
198
|
return Math.round(text.length * TOKENS_PER_CHAR)
|
|
@@ -198,12 +209,6 @@ export function byteLength(text: string): number {
|
|
|
198
209
|
return encoder.encode(text).length
|
|
199
210
|
}
|
|
200
211
|
|
|
201
|
-
const PLACEHOLDER_SUBAGENT_OVERRIDE = [
|
|
202
|
-
'You are typeclaw <PLACEHOLDER: subagent name>, a narrow worker subagent.',
|
|
203
|
-
'',
|
|
204
|
-
'<PLACEHOLDER: contents of the subagent-specific system prompt — owned by the plugin/bundled subagent that declared this worker. Real examples: memory-logger (~1000 tok), dreaming (~2200 tok). The prompt is opaque to the runtime; it teaches the subagent its job, its tools, and its termination contract.>',
|
|
205
|
-
].join('\n')
|
|
206
|
-
|
|
207
212
|
const mkSection = (name: string, body: string): SectionBreakdown => ({
|
|
208
213
|
name,
|
|
209
214
|
bytes: byteLength(body),
|
|
@@ -211,87 +216,32 @@ const mkSection = (name: string, body: string): SectionBreakdown => ({
|
|
|
211
216
|
tokens: estimateTokens(body),
|
|
212
217
|
})
|
|
213
218
|
|
|
219
|
+
// Each section row runs from its marker to the next one, so it includes the
|
|
220
|
+
// `\n\n` separator that follows it and the rows sum exactly to the totals.
|
|
214
221
|
export function dumpSystemPromptWithBreakdown(
|
|
215
222
|
kind: OriginKind,
|
|
216
223
|
options: { gitNudge: boolean } = { gitNudge: true },
|
|
217
224
|
): DumpResult {
|
|
218
|
-
if (kind === 'subagent') return dumpSubagentOverridePrompt()
|
|
219
|
-
return dumpDefaultLoaderPrompt(kind, options)
|
|
220
|
-
}
|
|
221
|
-
|
|
222
|
-
// Subagent sessions in production go through `defaultCreateSessionForSubagent`
|
|
223
|
-
// (and the plugin-subagent path in run/index.ts), both of which set
|
|
224
|
-
// `systemPromptOverride: subagent.systemPrompt`. That routes through
|
|
225
|
-
// `createOverrideResourceLoader`, which emits only:
|
|
226
|
-
// <override string> + runtime block + origin (with role)
|
|
227
|
-
// No DEFAULT/SLIM base, no IDENTITY/SOUL, no git-nudge.
|
|
228
|
-
//
|
|
229
|
-
// Without this branch, the dumper would report a misleadingly large slim
|
|
230
|
-
// breakdown for the subagent case and contradict AGENTS.md's "the section
|
|
231
|
-
// order it prints is the section order an agent actually sees" contract.
|
|
232
|
-
function dumpSubagentOverridePrompt(): DumpResult {
|
|
233
|
-
const fixture = buildFixture('subagent')
|
|
234
|
-
const runtimeBlock = `## Runtime\n\nTypeClaw runtime version: ${PLACEHOLDER_RUNTIME_VERSION}.`
|
|
235
|
-
const originBlock = `## Session origin\n\nYou are a \`${(fixture.origin as { subagent: string }).subagent}\` subagent spawned by parent session\n\`${(fixture.origin as { parentSessionId: string }).parentSessionId}\`. Stay narrowly within the task you were given.\nReturn cleanly when done; do not sprawl into unrelated work.\n\n## Your role in this session\n\nRole: \`${fixture.roleContext.role}\`. Permissions: ${fixture.roleContext.permissions.map((p) => `\`${p}\``).join(', ')}.\n\nThis is the role the runtime resolved at session creation. Tool calls\nand channel admission are gated by these permissions; a \`blocked:\` or\n"denied by permissions" message means the current actor lacks the\npermission the guard was looking for. See the \`typeclaw-permissions\`\nskill for what each role can do and how to grant access.`
|
|
236
|
-
|
|
237
|
-
const prompt = `${PLACEHOLDER_SUBAGENT_OVERRIDE}\n\n${runtimeBlock}\n\n${originBlock}`
|
|
238
|
-
const sections: SectionBreakdown[] = [
|
|
239
|
-
mkSection('Subagent override prompt', PLACEHOLDER_SUBAGENT_OVERRIDE),
|
|
240
|
-
mkSection('Runtime block', runtimeBlock),
|
|
241
|
-
mkSection('Session origin + role', originBlock),
|
|
242
|
-
]
|
|
243
|
-
return {
|
|
244
|
-
prompt,
|
|
245
|
-
sections,
|
|
246
|
-
totalBytes: byteLength(prompt),
|
|
247
|
-
totalChars: prompt.length,
|
|
248
|
-
totalTokens: estimateTokens(prompt),
|
|
249
|
-
}
|
|
250
|
-
}
|
|
251
|
-
|
|
252
|
-
function dumpDefaultLoaderPrompt(kind: Exclude<OriginKind, 'subagent'>, options: { gitNudge: boolean }): DumpResult {
|
|
253
225
|
const fixture = buildFixture(kind)
|
|
254
|
-
const mode
|
|
255
|
-
const
|
|
256
|
-
const
|
|
226
|
+
const mode = deriveSystemPromptMode(fixture.origin)
|
|
227
|
+
const gitNudge = options.gitNudge && mode === 'full' ? PLACEHOLDER_GIT_NUDGE : ''
|
|
228
|
+
const prompt = composeSystemPrompt({
|
|
257
229
|
mode,
|
|
258
230
|
self: PLACEHOLDER_SELF,
|
|
259
231
|
runtimeVersion: PLACEHOLDER_RUNTIME_VERSION,
|
|
260
232
|
origin: fixture.origin,
|
|
261
233
|
roleContext: fixture.roleContext,
|
|
262
|
-
gitNudge
|
|
263
|
-
}
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
const base = baseEnd > 0 ? prompt.slice(0, baseEnd) : ''
|
|
269
|
-
const baseLabel = mode === 'slim' ? 'SLIM_SYSTEM_PROMPT (base)' : 'DEFAULT_SYSTEM_PROMPT (base)'
|
|
270
|
-
const sections: SectionBreakdown[] = [
|
|
271
|
-
mkSection(baseLabel, base),
|
|
272
|
-
mkSection('Identity (IDENTITY.md + SOUL.md)', parts.self),
|
|
273
|
-
mkSection('Runtime block', `## Runtime\n\nTypeClaw runtime version: ${parts.runtimeVersion}.`),
|
|
274
|
-
mkSection('Session origin', extractSection(prompt, '## Session origin', '## Your role in this session')),
|
|
275
|
-
mkSection(
|
|
276
|
-
'Role context',
|
|
277
|
-
extractSection(
|
|
278
|
-
prompt,
|
|
279
|
-
'## Your role in this session',
|
|
280
|
-
parts.gitNudge !== '' ? '## Uncommitted changes at session start' : undefined,
|
|
281
|
-
),
|
|
282
|
-
),
|
|
234
|
+
gitNudge,
|
|
235
|
+
})
|
|
236
|
+
const markers: Array<readonly [string, string]> = [
|
|
237
|
+
['Shared policy', buildSystemPolicy()],
|
|
238
|
+
['Identity (IDENTITY.md + SOUL.md)', PLACEHOLDER_SELF],
|
|
239
|
+
['Runtime block', renderRuntimeBlock(PLACEHOLDER_RUNTIME_VERSION)],
|
|
283
240
|
]
|
|
284
|
-
if (
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
return {
|
|
289
|
-
prompt,
|
|
290
|
-
sections,
|
|
291
|
-
totalBytes: byteLength(prompt),
|
|
292
|
-
totalChars: prompt.length,
|
|
293
|
-
totalTokens: estimateTokens(prompt),
|
|
294
|
-
}
|
|
241
|
+
if (mode === 'full') markers.push(['Interactive context', renderInteractiveSessionContext(DEFAULT_SUBAGENT_ROSTER)])
|
|
242
|
+
markers.push(['Session origin', '## Session origin\n'], ['Role context', '## Your role in this session\n'])
|
|
243
|
+
if (gitNudge !== '') markers.push(['Git nudge', gitNudge])
|
|
244
|
+
return buildDumpResultFromMarkers(prompt, markers)
|
|
295
245
|
}
|
|
296
246
|
|
|
297
247
|
export function dumpSystemPrompt(kind: OriginKind, options: { gitNudge: boolean } = { gitNudge: true }): string {
|
|
@@ -334,6 +284,7 @@ export function dumpTurnPromptWithBreakdown(kind: OriginKind): DumpResult {
|
|
|
334
284
|
]
|
|
335
285
|
const batch = [
|
|
336
286
|
{
|
|
287
|
+
inputId: 'system-prompt-preview',
|
|
337
288
|
text: PLACEHOLDER_TURN_TEXT.channel,
|
|
338
289
|
authorId: 'U<PLACEHOLDER-AUTHOR>',
|
|
339
290
|
authorName: '<PLACEHOLDER: current speaker name>',
|
|
@@ -372,7 +323,7 @@ export function dumpTurnPrompt(kind: OriginKind): string {
|
|
|
372
323
|
|
|
373
324
|
function buildDumpResult(prompt: string, parts: ReadonlyArray<readonly [string, string]>): DumpResult {
|
|
374
325
|
if (parts.map(([, body]) => body).join('') !== prompt) {
|
|
375
|
-
throw new Error('
|
|
326
|
+
throw new Error('prompt breakdown does not cover the rendered prompt exactly')
|
|
376
327
|
}
|
|
377
328
|
return {
|
|
378
329
|
prompt,
|
|
@@ -383,37 +334,26 @@ function buildDumpResult(prompt: string, parts: ReadonlyArray<readonly [string,
|
|
|
383
334
|
}
|
|
384
335
|
}
|
|
385
336
|
|
|
337
|
+
// Locates each marker after the previous one, so a marker string that also
|
|
338
|
+
// occurs earlier (inside policy prose, say) cannot be mistaken for its section.
|
|
386
339
|
function buildDumpResultFromMarkers(prompt: string, markers: ReadonlyArray<readonly [string, string]>): DumpResult {
|
|
387
|
-
const starts
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
throw new Error('turn-prompt section markers are not in rendered order')
|
|
340
|
+
const starts: Array<{ name: string; start: number }> = []
|
|
341
|
+
for (const [name, marker] of markers) {
|
|
342
|
+
const previous = starts.at(-1)
|
|
343
|
+
const start = prompt.indexOf(marker, previous === undefined ? 0 : previous.start + 1)
|
|
344
|
+
if (start < 0) throw new Error(`prompt section marker not found in rendered order: ${name}`)
|
|
345
|
+
starts.push({ name, start })
|
|
394
346
|
}
|
|
347
|
+
if (starts[0]?.start !== 0) throw new Error('the first prompt section marker does not start the prompt')
|
|
395
348
|
return buildDumpResult(
|
|
396
349
|
prompt,
|
|
397
350
|
starts.map((part, index) => [part.name, prompt.slice(part.start, starts[index + 1]?.start)] as const),
|
|
398
351
|
)
|
|
399
352
|
}
|
|
400
353
|
|
|
401
|
-
// Slice between two unique headers in the rendered prompt. Both anchors are
|
|
402
|
-
// guaranteed unique by `composeSystemPrompt`'s contract (each section's
|
|
403
|
-
// header appears exactly once). Used by the breakdown so we attribute each
|
|
404
|
-
// section's chars precisely instead of guessing from input fixtures.
|
|
405
|
-
function extractSection(prompt: string, startHeader: string, endHeader: string | undefined): string {
|
|
406
|
-
const start = prompt.lastIndexOf(`\n\n${startHeader}`)
|
|
407
|
-
if (start < 0) return ''
|
|
408
|
-
const afterStart = start + 2
|
|
409
|
-
if (endHeader === undefined) return prompt.slice(afterStart)
|
|
410
|
-
const end = prompt.indexOf(`\n\n${endHeader}`, afterStart)
|
|
411
|
-
return end < 0 ? prompt.slice(afterStart) : prompt.slice(afterStart, end)
|
|
412
|
-
}
|
|
413
|
-
|
|
414
354
|
function header(kind: OriginKind, result: DumpResult, label: 'SYSTEM PROMPT' | 'USER TURN'): string {
|
|
415
355
|
const bar = '═'.repeat(78)
|
|
416
|
-
const summary =
|
|
356
|
+
const summary = `${result.totalChars} chars / ${result.totalBytes} bytes / ~${result.totalTokens} tok (chars/4 estimate, not a tokenizer count)`
|
|
417
357
|
return `\n${bar}\n ${label} — origin: ${kind} — ${summary}\n${bar}\n`
|
|
418
358
|
}
|
|
419
359
|
|
|
@@ -429,7 +369,7 @@ function renderBreakdownTable(result: DumpResult): string {
|
|
|
429
369
|
const sep = ` ${'─'.repeat(nameW)} ${'─'.repeat(tokW)} ${'─'.repeat(charW)} ${'─'.repeat(byteW)}`
|
|
430
370
|
|
|
431
371
|
const lines = [
|
|
432
|
-
row('Section', '
|
|
372
|
+
row('Section', '~Tok', 'Chars', 'Bytes'),
|
|
433
373
|
sep,
|
|
434
374
|
...result.sections.map((s) => row(s.name, `~${s.tokens}`, String(s.chars), String(s.bytes))),
|
|
435
375
|
sep,
|
|
@@ -455,11 +395,13 @@ function main(): void {
|
|
|
455
395
|
[
|
|
456
396
|
'Usage: bun run debug:prompt [--turn] [--origin <kind>] [--no-git-nudge]',
|
|
457
397
|
'',
|
|
458
|
-
'Dump the
|
|
459
|
-
'for one or all session-origin kinds,',
|
|
460
|
-
'
|
|
461
|
-
'
|
|
462
|
-
'
|
|
398
|
+
'Dump the TypeClaw-composed system-prompt preamble, or the per-turn user',
|
|
399
|
+
'message with --turn, for one or all session-origin kinds, using',
|
|
400
|
+
'placeholder values for every dynamic field. pi appends project context,',
|
|
401
|
+
'the skill catalog, and the cwd to the preamble at session creation.',
|
|
402
|
+
'Each dump is prefixed with a per-section breakdown of character count,',
|
|
403
|
+
'UTF-8 byte length, and a rough chars/4 token estimate (not a tokenizer',
|
|
404
|
+
'count); rows include their trailing separator and sum to the totals.',
|
|
463
405
|
'',
|
|
464
406
|
'Options:',
|
|
465
407
|
' -o, --origin <kind> tui | cron | channel | subagent | all (default: all)',
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
// Preloaded by bunfig.toml `[test] preload
|
|
2
|
-
//
|
|
3
|
-
//
|
|
1
|
+
// Preloaded by bunfig.toml `[test] preload` to deny `bun test` without
|
|
2
|
+
// --parallel. The default timeout belongs in bunfig.toml, not this preload,
|
|
3
|
+
// so an explicit CLI --timeout keeps its normal precedence.
|
|
4
4
|
//
|
|
5
5
|
// Why deny serial runs: Serial runs are ~3.4x slower (44s → 13s, see commit
|
|
6
6
|
// 1c66d5e), and Bun has no bunfig knob for the flag yet (verified against
|
|
@@ -18,39 +18,12 @@
|
|
|
18
18
|
//
|
|
19
19
|
// Bypass with TYPECLAW_ALLOW_SERIAL_TESTS=1 when debugging a flaky test
|
|
20
20
|
// where worker contention obscures the failure.
|
|
21
|
-
//
|
|
22
|
-
// Why raise the default timeout: A growing number of tests in this repo
|
|
23
|
-
// either spawn child processes (`bun run typeclaw …` via Bun.spawn from
|
|
24
|
-
// src/cli/index.test.ts, src/cli/role.test.ts, src/cli/status.test.ts,
|
|
25
|
-
// src/init/dockerfile.test.ts agent-browser wrapper, etc.) or boot the
|
|
26
|
-
// in-process agent (`startAgent({ port: 0, … })` from src/run/plugin.test.ts).
|
|
27
|
-
// Both shapes have a happy-path cost well under 1s but a worst-case cost
|
|
28
|
-
// that races Bun's 5000ms ceiling under `--parallel` contention. The
|
|
29
|
-
// repeating failure mode is "this test timed out after 5000ms" appearing
|
|
30
|
-
// on different tests across runs at a rough ~3-15% rate per full-suite
|
|
31
|
-
// invocation — not a real bug, just resource starvation. Raising the
|
|
32
|
-
// default to 30s eliminates the false positives without masking real
|
|
33
|
-
// hangs (a wedged test still fails, just 6x slower than before). The
|
|
34
|
-
// happy path is unaffected because tests complete in their actual
|
|
35
|
-
// runtime, not the timeout budget.
|
|
36
|
-
//
|
|
37
|
-
// 30s was chosen as ~75x the observed happy-path cold-start (~400ms) for
|
|
38
|
-
// the heaviest subprocess tests, matching the in-house convention used in
|
|
39
|
-
// pi-coding-agent's subprocess fixtures and Bun's own integration-test
|
|
40
|
-
// suites (see oven-sh/bun test/cli/install/*.test.ts which set 5-minute
|
|
41
|
-
// timeouts for full installs). Individual tests that genuinely need more
|
|
42
|
-
// can still pass an explicit 3rd arg to `test()` to override locally.
|
|
43
|
-
|
|
44
|
-
import { setDefaultTimeout } from 'bun:test'
|
|
45
21
|
|
|
46
22
|
const isParallelWorker = typeof process.env.BUN_TEST_WORKER_ID === 'string'
|
|
47
23
|
|
|
48
|
-
if (isParallelWorker) {
|
|
49
|
-
setDefaultTimeout(30_000)
|
|
50
|
-
} else if (process.env.TYPECLAW_ALLOW_SERIAL_TESTS === '1') {
|
|
24
|
+
if (!isParallelWorker && process.env.TYPECLAW_ALLOW_SERIAL_TESTS === '1') {
|
|
51
25
|
console.warn('[require-parallel] Running serially — TYPECLAW_ALLOW_SERIAL_TESTS=1 set.')
|
|
52
|
-
|
|
53
|
-
} else {
|
|
26
|
+
} else if (!isParallelWorker) {
|
|
54
27
|
console.error('')
|
|
55
28
|
console.error(' ✗ `bun test` without --parallel is denied in this repo.')
|
|
56
29
|
console.error('')
|
package/src/agent/guard-types.ts
CHANGED
|
@@ -21,5 +21,8 @@ export type InternalGuard = {
|
|
|
21
21
|
readonly owner: string
|
|
22
22
|
readonly key: string
|
|
23
23
|
readonly tools: ReadonlySet<string>
|
|
24
|
+
// Hygiene guards that protect no boundary set this so a bug in their check
|
|
25
|
+
// is logged and skipped instead of denying every call to their tools.
|
|
26
|
+
readonly skipOnCheckError?: true
|
|
24
27
|
readonly check: (event: InternalGuardEvent) => InternalGuardResult | Promise<InternalGuardResult>
|
|
25
28
|
}
|
package/src/agent/guards.ts
CHANGED
|
@@ -35,6 +35,7 @@ export function buildInternalGuards(agentDir: string): readonly InternalGuard[]
|
|
|
35
35
|
owner: 'guard',
|
|
36
36
|
key: GUARD_IMAGE_READ_REDIRECT,
|
|
37
37
|
tools: ['read'],
|
|
38
|
+
skipOnCheckError: true,
|
|
38
39
|
check: checkImageReadRedirect,
|
|
39
40
|
},
|
|
40
41
|
{
|
|
@@ -54,18 +55,21 @@ export function buildInternalGuards(agentDir: string): readonly InternalGuard[]
|
|
|
54
55
|
owner: 'bun-hygiene',
|
|
55
56
|
key: GUARD_GLOBAL_INSTALL,
|
|
56
57
|
tools: ['bash'],
|
|
58
|
+
skipOnCheckError: true,
|
|
57
59
|
check: checkGlobalInstallGuard,
|
|
58
60
|
},
|
|
59
61
|
{
|
|
60
62
|
owner: 'bun-hygiene',
|
|
61
63
|
key: GUARD_NON_BUN_PACKAGE_MANAGER,
|
|
62
64
|
tools: ['bash'],
|
|
65
|
+
skipOnCheckError: true,
|
|
63
66
|
check: checkNonBunPackageManagerGuard,
|
|
64
67
|
},
|
|
65
68
|
{
|
|
66
69
|
owner: 'bun-hygiene',
|
|
67
70
|
key: GUARD_NON_BUN_PACKAGE_RUNNER,
|
|
68
71
|
tools: ['bash'],
|
|
72
|
+
skipOnCheckError: true,
|
|
69
73
|
check: checkNonBunPackageRunnerGuard,
|
|
70
74
|
},
|
|
71
75
|
]
|