@punch-bot/cli 0.85.1 → 1.3.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/CHANGELOG.md +609 -3
- package/README.md +82 -174
- package/dist/bun/cli.d.ts.map +1 -1
- package/dist/bun/restore-sandbox-env.d.ts.map +1 -1
- package/dist/bun/restore-sandbox-env.js.map +1 -1
- package/dist/bun/runtime-setup.d.ts.map +1 -1
- package/dist/bun/runtime-setup.js +4 -1
- package/dist/bun/runtime-setup.js.map +1 -1
- package/dist/bun/sandbox-env-setup.d.ts.map +1 -1
- package/dist/bundle/chunks/anthropic-messages-BUUFZMRE.js +6 -0
- package/dist/bundle/chunks/anthropic.js +2 -2
- package/dist/bundle/chunks/azure-openai-responses-WZ4GZHD2.js +2 -0
- package/dist/bundle/chunks/bedrock-converse-stream.js +10 -2
- package/dist/bundle/chunks/chunk-22CYIUS4.js +2 -0
- package/dist/bundle/chunks/chunk-2M76JOVH.js +8 -0
- package/dist/bundle/chunks/chunk-6C5VKHGV.js +50 -0
- package/dist/bundle/chunks/chunk-6WNF4BLC.js +2 -0
- package/dist/bundle/chunks/chunk-6YKFJ7FQ.js +1188 -0
- package/dist/bundle/chunks/chunk-BYHXHV4K.js +11 -0
- package/dist/bundle/chunks/chunk-F5ZABL6Z.js +20 -0
- package/dist/bundle/chunks/chunk-HACVPRBJ.js +11 -0
- package/dist/bundle/chunks/chunk-ITZNWD4K.js +2 -0
- package/dist/bundle/chunks/chunk-J7I2NFJ7.js +82 -0
- package/dist/bundle/chunks/chunk-LPXNMA2W.js +2 -0
- package/dist/bundle/chunks/chunk-OO6DJ3CL.js +31 -0
- package/dist/bundle/chunks/chunk-OWCYH5W2.js +2 -0
- package/dist/bundle/chunks/chunk-PMRZO46Y.js +2 -0
- package/dist/bundle/chunks/{chunk-TRDNDS6A.js → chunk-PYGXRV27.js} +5 -2
- package/dist/bundle/chunks/chunk-RDZVAGPR.js +2 -0
- package/dist/bundle/chunks/{chunk-XDUWOHPL.js → chunk-S3GGRYIO.js} +2 -2
- package/dist/bundle/chunks/chunk-UTB4DTYQ.js +2 -0
- package/dist/bundle/chunks/chunk-WUIPA42N.js +14 -0
- package/dist/bundle/chunks/chunk-XIX7LUWI.js +2 -0
- package/dist/bundle/chunks/{chunk-3DNTDXPG.js → chunk-YGGF2ZM6.js} +3 -3
- package/dist/bundle/chunks/chunk-YWHGLBPB.js +2 -0
- package/dist/bundle/chunks/chunk-ZBURYEWF.js +2 -0
- package/dist/bundle/chunks/cli-QAQLORRY.js +51 -0
- package/dist/bundle/chunks/cloudflare-workers-ai-system-one-UTBL2KOF.js +2 -0
- package/dist/bundle/chunks/codemode-worker.js +478 -0
- package/dist/bundle/chunks/execute-2Z6BN5R3.js +499 -0
- package/dist/bundle/chunks/github-copilot.js +1 -1
- package/dist/bundle/chunks/google-generative-ai-S2KXX5PQ.js +2 -0
- package/dist/bundle/chunks/google-vertex-LQOUTFJN.js +2 -0
- package/dist/bundle/chunks/image-resize-worker.js +1 -1
- package/dist/bundle/chunks/jiti-loader-C3NU2SDH.js +21 -0
- package/dist/bundle/chunks/jiti-static-loader-E6ANQD5T.js +2 -0
- package/dist/bundle/chunks/{lib-HGQMNYVT.js → lib-TEDK3E5I.js} +2 -2
- package/dist/bundle/chunks/llama-cpp-classify-FYN623RH.js +22 -0
- package/dist/bundle/chunks/meta.js +2 -0
- package/dist/bundle/chunks/mistral-conversations-VNJYBSRF.js +5 -0
- package/dist/bundle/chunks/node-N5BSDOA5.js +16 -0
- package/dist/bundle/chunks/{node-4PXJTSWH.js → node-TWVVAGPO.js} +1 -1
- package/dist/bundle/chunks/openai-chatgpt.js +75 -0
- package/dist/bundle/chunks/openai-codex-responses-E6BLZPYJ.js +10 -0
- package/dist/bundle/chunks/openai-codex.js +2 -2
- package/dist/bundle/chunks/openai-completions-LUDIAWSG.js +7 -0
- package/dist/bundle/chunks/openai-decisions-WVPMQ4JD.js +5 -0
- package/dist/bundle/chunks/openai-responses-IOCBEIVC.js +3 -0
- package/dist/bundle/chunks/{openrouter-images-N4XVVFSD.js → openrouter-images-YU24TD7D.js} +1 -1
- package/dist/bundle/chunks/openrouter.js +2 -2
- package/dist/bundle/chunks/{pi-messages-ZRYGTSON.js → pi-messages-V27DSLVC.js} +2 -2
- package/dist/bundle/chunks/radius.js +2 -2
- package/dist/bundle/chunks/runtime-R6O72Q4R.js +2 -0
- package/dist/bundle/chunks/typesafe-system-one-ZSK3RN4B.js +2 -0
- package/dist/bundle/chunks/virtual-modules-GZVZPCK3.js +2 -0
- package/dist/bundle/cli-runtime.js +3 -0
- package/dist/bundle/cli.js +4 -2
- package/dist/bundle/index.js +1 -1
- package/dist/bundle/rpc-entry.js +1 -1
- package/dist/cli/args.d.ts +1 -2
- package/dist/cli/args.d.ts.map +1 -1
- package/dist/cli/args.js +73 -53
- package/dist/cli/args.js.map +1 -1
- package/dist/cli/auth-check.d.ts.map +1 -1
- package/dist/cli/auth-check.js.map +1 -1
- package/dist/cli/auth-command.d.ts.map +1 -1
- package/dist/cli/auth-command.js.map +1 -1
- package/dist/cli/credential-print.d.ts.map +1 -1
- package/dist/cli/credential-print.js +4 -4
- package/dist/cli/credential-print.js.map +1 -1
- package/dist/cli/experimental/transport-address.d.ts +21 -0
- package/dist/cli/experimental/transport-address.d.ts.map +1 -0
- package/dist/cli/experimental/transport-address.js +89 -0
- package/dist/cli/experimental/transport-address.js.map +1 -0
- package/dist/cli/file-processor.d.ts +1 -1
- package/dist/cli/file-processor.d.ts.map +1 -1
- package/dist/cli/file-processor.js.map +1 -1
- package/dist/cli/initial-message.d.ts +1 -1
- package/dist/cli/initial-message.d.ts.map +1 -1
- package/dist/cli/initial-message.js.map +1 -1
- package/dist/cli/list-models.d.ts.map +1 -1
- package/dist/cli/list-models.js +1 -1
- package/dist/cli/list-models.js.map +1 -1
- package/dist/cli/project-trust.d.ts.map +1 -1
- package/dist/cli/project-trust.js +5 -35
- package/dist/cli/project-trust.js.map +1 -1
- package/dist/cli/setup.d.ts.map +1 -1
- package/dist/cli/setup.js.map +1 -1
- package/dist/cli.d.ts.map +1 -1
- package/dist/config.d.ts +30 -11
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +72 -21
- package/dist/config.js.map +1 -1
- package/dist/core/agent-session-runtime.d.ts +4 -3
- package/dist/core/agent-session-runtime.d.ts.map +1 -1
- package/dist/core/agent-session-runtime.js +37 -27
- package/dist/core/agent-session-runtime.js.map +1 -1
- package/dist/core/agent-session-services.d.ts.map +1 -1
- package/dist/core/agent-session-services.js +13 -0
- package/dist/core/agent-session-services.js.map +1 -1
- package/dist/core/agent-session.d.ts +270 -22
- package/dist/core/agent-session.d.ts.map +1 -1
- package/dist/core/agent-session.js +1174 -410
- package/dist/core/agent-session.js.map +1 -1
- package/dist/core/auth-guidance.d.ts.map +1 -1
- package/dist/core/auth-guidance.js.map +1 -1
- package/dist/core/auth-storage.d.ts.map +1 -1
- package/dist/core/auth-storage.js +20 -13
- package/dist/core/auth-storage.js.map +1 -1
- package/dist/core/bash-executor.d.ts.map +1 -1
- package/dist/core/bash-executor.js +42 -52
- package/dist/core/bash-executor.js.map +1 -1
- package/dist/core/bug-report-upload.d.ts +12 -0
- package/dist/core/bug-report-upload.d.ts.map +1 -0
- package/dist/core/bug-report-upload.js +22 -0
- package/dist/core/bug-report-upload.js.map +1 -0
- package/dist/core/bug-report.d.ts +184 -0
- package/dist/core/bug-report.d.ts.map +1 -0
- package/dist/core/bug-report.js +292 -0
- package/dist/core/bug-report.js.map +1 -0
- package/dist/core/cache-stats.d.ts.map +1 -1
- package/dist/core/cache-stats.js +12 -1
- package/dist/core/cache-stats.js.map +1 -1
- package/dist/core/cache-warmer.d.ts +103 -0
- package/dist/core/cache-warmer.d.ts.map +1 -0
- package/dist/core/cache-warmer.js +356 -0
- package/dist/core/cache-warmer.js.map +1 -0
- package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
- package/dist/core/compaction/branch-summarization.js +2 -2
- package/dist/core/compaction/branch-summarization.js.map +1 -1
- package/dist/core/compaction/compaction.d.ts +5 -3
- package/dist/core/compaction/compaction.d.ts.map +1 -1
- package/dist/core/compaction/compaction.js +164 -88
- package/dist/core/compaction/compaction.js.map +1 -1
- package/dist/core/compaction/index.d.ts.map +1 -1
- package/dist/core/compaction/utils.d.ts +8 -1
- package/dist/core/compaction/utils.d.ts.map +1 -1
- package/dist/core/compaction/utils.js +32 -26
- package/dist/core/compaction/utils.js.map +1 -1
- package/dist/core/crash-log.d.ts +27 -0
- package/dist/core/crash-log.d.ts.map +1 -0
- package/dist/core/crash-log.js +140 -0
- package/dist/core/crash-log.js.map +1 -0
- package/dist/core/defaults.d.ts.map +1 -1
- package/dist/core/delivery.d.ts.map +1 -1
- package/dist/core/delivery.js.map +1 -1
- package/dist/core/diagnostics.d.ts.map +1 -1
- package/dist/core/event-bus.d.ts.map +1 -1
- package/dist/core/event-bus.js.map +1 -1
- package/dist/core/exec.d.ts.map +1 -1
- package/dist/core/exec.js.map +1 -1
- package/dist/core/experimental.d.ts.map +1 -1
- package/dist/core/experimental.js.map +1 -1
- package/dist/core/export-html/ansi-to-html.d.ts.map +1 -1
- package/dist/core/export-html/ansi-to-html.js.map +1 -1
- package/dist/core/export-html/index.d.ts.map +1 -1
- package/dist/core/export-html/index.js +1 -1
- package/dist/core/export-html/index.js.map +1 -1
- package/dist/core/export-html/template.css +10 -0
- package/dist/core/export-html/template.js +93 -34
- package/dist/core/export-html/tool-renderer.d.ts +5 -11
- package/dist/core/export-html/tool-renderer.d.ts.map +1 -1
- package/dist/core/export-html/tool-renderer.js +8 -99
- package/dist/core/export-html/tool-renderer.js.map +1 -1
- package/dist/core/extensions/index.d.ts +1 -1
- package/dist/core/extensions/index.d.ts.map +1 -1
- package/dist/core/extensions/index.js.map +1 -1
- package/dist/core/extensions/jiti-loader.d.ts +2 -0
- package/dist/core/extensions/jiti-loader.d.ts.map +1 -0
- package/dist/core/extensions/jiti-loader.js +4 -0
- package/dist/core/extensions/jiti-loader.js.map +1 -0
- package/dist/core/extensions/jiti-static-loader.d.ts +2 -0
- package/dist/core/extensions/jiti-static-loader.d.ts.map +1 -0
- package/dist/core/extensions/jiti-static-loader.js +4 -0
- package/dist/core/extensions/jiti-static-loader.js.map +1 -0
- package/dist/core/extensions/loader.d.ts.map +1 -1
- package/dist/core/extensions/loader.js +102 -74
- package/dist/core/extensions/loader.js.map +1 -1
- package/dist/core/extensions/runner.d.ts +44 -14
- package/dist/core/extensions/runner.d.ts.map +1 -1
- package/dist/core/extensions/runner.js +297 -169
- package/dist/core/extensions/runner.js.map +1 -1
- package/dist/core/extensions/types.d.ts +482 -238
- package/dist/core/extensions/types.d.ts.map +1 -1
- package/dist/core/extensions/types.js.map +1 -1
- package/dist/core/extensions/virtual-modules.d.ts +3 -0
- package/dist/core/extensions/virtual-modules.d.ts.map +1 -0
- package/dist/core/extensions/virtual-modules.js +35 -0
- package/dist/core/extensions/virtual-modules.js.map +1 -0
- package/dist/core/extensions/wrapper.d.ts +2 -2
- package/dist/core/extensions/wrapper.d.ts.map +1 -1
- package/dist/core/extensions/wrapper.js +3 -22
- package/dist/core/extensions/wrapper.js.map +1 -1
- package/dist/core/footer-data-provider.d.ts.map +1 -1
- package/dist/core/footer-data-provider.js.map +1 -1
- package/dist/core/http-dispatcher.d.ts +13 -0
- package/dist/core/http-dispatcher.d.ts.map +1 -1
- package/dist/core/http-dispatcher.js +13 -4
- package/dist/core/http-dispatcher.js.map +1 -1
- package/dist/core/index.d.ts +2 -1
- package/dist/core/index.d.ts.map +1 -1
- package/dist/core/index.js.map +1 -1
- package/dist/core/mcp-servers.d.ts +139 -0
- package/dist/core/mcp-servers.d.ts.map +1 -0
- package/dist/core/mcp-servers.js +232 -0
- package/dist/core/mcp-servers.js.map +1 -0
- package/dist/core/messages.d.ts.map +1 -1
- package/dist/core/messages.js +1 -0
- package/dist/core/messages.js.map +1 -1
- package/dist/{modes/interactive → core}/model-catalog-refresh.d.ts +2 -2
- package/dist/core/model-catalog-refresh.d.ts.map +1 -0
- package/dist/{modes/interactive → core}/model-catalog-refresh.js +2 -2
- package/dist/core/model-catalog-refresh.js.map +1 -0
- package/dist/core/model-config.d.ts +886 -80
- package/dist/core/model-config.d.ts.map +1 -1
- package/dist/core/model-config.js +33 -148
- package/dist/core/model-config.js.map +1 -1
- package/dist/core/model-registry.d.ts +15 -1
- package/dist/core/model-registry.d.ts.map +1 -1
- package/dist/core/model-registry.js +29 -0
- package/dist/core/model-registry.js.map +1 -1
- package/dist/core/model-resolver.d.ts +61 -46
- package/dist/core/model-resolver.d.ts.map +1 -1
- package/dist/core/model-resolver.js +338 -363
- package/dist/core/model-resolver.js.map +1 -1
- package/dist/core/model-runtime.d.ts +51 -3
- package/dist/core/model-runtime.d.ts.map +1 -1
- package/dist/core/model-runtime.js +211 -44
- package/dist/core/model-runtime.js.map +1 -1
- package/dist/core/model-suffix-variants.d.ts +14 -0
- package/dist/core/model-suffix-variants.d.ts.map +1 -0
- package/dist/core/model-suffix-variants.js +27 -0
- package/dist/core/model-suffix-variants.js.map +1 -0
- package/dist/core/models-store.d.ts.map +1 -1
- package/dist/core/models-store.js.map +1 -1
- package/dist/core/nested-tool-calls.d.ts +103 -0
- package/dist/core/nested-tool-calls.d.ts.map +1 -0
- package/dist/core/nested-tool-calls.js +179 -0
- package/dist/core/nested-tool-calls.js.map +1 -0
- package/dist/core/output-guard.d.ts.map +1 -1
- package/dist/core/output-guard.js.map +1 -1
- package/dist/core/package-manager.d.ts +4 -0
- package/dist/core/package-manager.d.ts.map +1 -1
- package/dist/core/package-manager.js +62 -15
- package/dist/core/package-manager.js.map +1 -1
- package/dist/core/pi-manifest.d.ts.map +1 -1
- package/dist/core/pi-manifest.js.map +1 -1
- package/dist/core/project-trust.d.ts.map +1 -1
- package/dist/core/project-trust.js +2 -1
- package/dist/core/project-trust.js.map +1 -1
- package/dist/core/prompt-templates.d.ts +6 -1
- package/dist/core/prompt-templates.d.ts.map +1 -1
- package/dist/core/prompt-templates.js +68 -37
- package/dist/core/prompt-templates.js.map +1 -1
- package/dist/core/provider-attribution.d.ts.map +1 -1
- package/dist/core/provider-attribution.js.map +1 -1
- package/dist/core/provider-composer.d.ts +42 -20
- package/dist/core/provider-composer.d.ts.map +1 -1
- package/dist/core/provider-composer.js +126 -40
- package/dist/core/provider-composer.js.map +1 -1
- package/dist/core/radius.d.ts +5 -0
- package/dist/core/radius.d.ts.map +1 -1
- package/dist/core/radius.js +8 -0
- package/dist/core/radius.js.map +1 -1
- package/dist/core/remote-catalog-provider.d.ts +19 -1
- package/dist/core/remote-catalog-provider.d.ts.map +1 -1
- package/dist/core/remote-catalog-provider.js +102 -34
- package/dist/core/remote-catalog-provider.js.map +1 -1
- package/dist/core/resolve-config-value.d.ts.map +1 -1
- package/dist/core/resolve-config-value.js.map +1 -1
- package/dist/core/resource-loader.d.ts +11 -2
- package/dist/core/resource-loader.d.ts.map +1 -1
- package/dist/core/resource-loader.js +170 -42
- package/dist/core/resource-loader.js.map +1 -1
- package/dist/core/runtime-credentials.d.ts.map +1 -1
- package/dist/core/runtime-credentials.js.map +1 -1
- package/dist/core/sdk.d.ts +14 -5
- package/dist/core/sdk.d.ts.map +1 -1
- package/dist/core/sdk.js +108 -52
- package/dist/core/sdk.js.map +1 -1
- package/dist/core/session-cwd.d.ts.map +1 -1
- package/dist/core/session-cwd.js.map +1 -1
- package/dist/core/session-export.d.ts +6 -2
- package/dist/core/session-export.d.ts.map +1 -1
- package/dist/core/session-export.js +14 -13
- package/dist/core/session-export.js.map +1 -1
- package/dist/core/session-manager.d.ts +72 -13
- package/dist/core/session-manager.d.ts.map +1 -1
- package/dist/core/session-manager.js +277 -124
- package/dist/core/session-manager.js.map +1 -1
- package/dist/core/settings-defaults.d.ts +65 -0
- package/dist/core/settings-defaults.d.ts.map +1 -0
- package/dist/core/settings-defaults.js +66 -0
- package/dist/core/settings-defaults.js.map +1 -0
- package/dist/core/settings-diagnostics.d.ts.map +1 -1
- package/dist/core/settings-diagnostics.js.map +1 -1
- package/dist/core/settings-manager.d.ts +41 -126
- package/dist/core/settings-manager.d.ts.map +1 -1
- package/dist/core/settings-manager.js +165 -52
- package/dist/core/settings-manager.js.map +1 -1
- package/dist/core/settings-schema.d.ts +224 -0
- package/dist/core/settings-schema.d.ts.map +1 -0
- package/dist/core/settings-schema.js +285 -0
- package/dist/core/settings-schema.js.map +1 -0
- package/dist/core/skills.d.ts +4 -1
- package/dist/core/skills.d.ts.map +1 -1
- package/dist/core/skills.js +6 -1
- package/dist/core/skills.js.map +1 -1
- package/dist/core/slash-commands.d.ts.map +1 -1
- package/dist/core/slash-commands.js +3 -2
- package/dist/core/slash-commands.js.map +1 -1
- package/dist/core/source-info.d.ts +8 -0
- package/dist/core/source-info.d.ts.map +1 -1
- package/dist/core/source-info.js +16 -0
- package/dist/core/source-info.js.map +1 -1
- package/dist/core/system-prompt.d.ts +55 -6
- package/dist/core/system-prompt.d.ts.map +1 -1
- package/dist/core/system-prompt.js +128 -93
- package/dist/core/system-prompt.js.map +1 -1
- package/dist/core/telemetry.d.ts +2 -0
- package/dist/core/telemetry.d.ts.map +1 -1
- package/dist/core/telemetry.js +45 -0
- package/dist/core/telemetry.js.map +1 -1
- package/dist/core/theme/dark.json +78 -0
- package/dist/core/theme/light.json +78 -0
- package/dist/core/theme/system-theme.d.ts +54 -0
- package/dist/core/theme/system-theme.d.ts.map +1 -0
- package/dist/core/theme/system-theme.js +547 -0
- package/dist/core/theme/system-theme.js.map +1 -0
- package/dist/core/theme/theme-schema.d.ts +28 -0
- package/dist/core/theme/theme-schema.d.ts.map +1 -0
- package/dist/core/theme/theme-schema.js +105 -0
- package/dist/core/theme/theme-schema.js.map +1 -0
- package/dist/core/theme/theme-tokens.d.ts +257 -0
- package/dist/core/theme/theme-tokens.d.ts.map +1 -0
- package/dist/core/theme/theme-tokens.js +94 -0
- package/dist/core/theme/theme-tokens.js.map +1 -0
- package/dist/core/theme/theme.d.ts +162 -0
- package/dist/core/theme/theme.d.ts.map +1 -0
- package/dist/{modes/interactive → core}/theme/theme.js +265 -402
- package/dist/core/theme/theme.js.map +1 -0
- package/dist/core/timings.d.ts.map +1 -1
- package/dist/core/timings.js.map +1 -1
- package/dist/core/tools/bash.d.ts +14 -1
- package/dist/core/tools/bash.d.ts.map +1 -1
- package/dist/core/tools/bash.js +43 -6
- package/dist/core/tools/bash.js.map +1 -1
- package/dist/core/tools/edit-diff.d.ts.map +1 -1
- package/dist/core/tools/edit-diff.js.map +1 -1
- package/dist/core/tools/edit.d.ts +1 -2
- package/dist/core/tools/edit.d.ts.map +1 -1
- package/dist/core/tools/edit.js +0 -3
- package/dist/core/tools/edit.js.map +1 -1
- package/dist/core/tools/file-mutation-queue.d.ts.map +1 -1
- package/dist/core/tools/file-mutation-queue.js.map +1 -1
- package/dist/core/tools/find.d.ts.map +1 -1
- package/dist/core/tools/find.js +0 -2
- package/dist/core/tools/find.js.map +1 -1
- package/dist/core/tools/grep.d.ts.map +1 -1
- package/dist/core/tools/grep.js +0 -2
- package/dist/core/tools/grep.js.map +1 -1
- package/dist/core/tools/index.d.ts.map +1 -1
- package/dist/core/tools/index.js.map +1 -1
- package/dist/core/tools/ls.d.ts.map +1 -1
- package/dist/core/tools/ls.js +0 -2
- package/dist/core/tools/ls.js.map +1 -1
- package/dist/core/tools/output-accumulator.d.ts +11 -0
- package/dist/core/tools/output-accumulator.d.ts.map +1 -1
- package/dist/core/tools/output-accumulator.js +40 -10
- package/dist/core/tools/output-accumulator.js.map +1 -1
- package/dist/core/tools/path-utils.d.ts.map +1 -1
- package/dist/core/tools/path-utils.js.map +1 -1
- package/dist/core/tools/powershell.d.ts.map +1 -1
- package/dist/core/tools/powershell.js.map +1 -1
- package/dist/core/tools/read.d.ts +17 -1
- package/dist/core/tools/read.d.ts.map +1 -1
- package/dist/core/tools/read.js +23 -4
- package/dist/core/tools/read.js.map +1 -1
- package/dist/core/tools/tool-definition-wrapper.d.ts +5 -3
- package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
- package/dist/core/tools/tool-definition-wrapper.js +3 -1
- package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
- package/dist/core/tools/truncate.d.ts +14 -0
- package/dist/core/tools/truncate.d.ts.map +1 -1
- package/dist/core/tools/truncate.js +29 -0
- package/dist/core/tools/truncate.js.map +1 -1
- package/dist/core/tools/write.d.ts.map +1 -1
- package/dist/core/tools/write.js +0 -2
- package/dist/core/tools/write.js.map +1 -1
- package/dist/core/trust-manager.d.ts.map +1 -1
- package/dist/core/trust-manager.js +1 -0
- package/dist/core/trust-manager.js.map +1 -1
- package/dist/core/usage-totals.d.ts +3 -1
- package/dist/core/usage-totals.d.ts.map +1 -1
- package/dist/core/usage-totals.js +28 -1
- package/dist/core/usage-totals.js.map +1 -1
- package/dist/core/virtual-models.d.ts +117 -0
- package/dist/core/virtual-models.d.ts.map +1 -0
- package/dist/core/virtual-models.js +124 -0
- package/dist/core/virtual-models.js.map +1 -0
- package/dist/extensions/browser/index.d.ts.map +1 -1
- package/dist/extensions/browser/index.js.map +1 -1
- package/dist/extensions/codemode/execute.d.ts +16 -0
- package/dist/extensions/codemode/execute.d.ts.map +1 -0
- package/dist/extensions/codemode/execute.js +665 -0
- package/dist/extensions/codemode/execute.js.map +1 -0
- package/dist/extensions/codemode/execute.lazy.d.ts +3 -0
- package/dist/extensions/codemode/execute.lazy.d.ts.map +1 -0
- package/dist/extensions/codemode/execute.lazy.js +3 -0
- package/dist/extensions/codemode/execute.lazy.js.map +1 -0
- package/dist/extensions/codemode/index.d.ts +21 -0
- package/dist/extensions/codemode/index.d.ts.map +1 -0
- package/dist/extensions/codemode/index.js +33 -0
- package/dist/extensions/codemode/index.js.map +1 -0
- package/dist/extensions/codemode/tool.d.ts +124 -0
- package/dist/extensions/codemode/tool.d.ts.map +1 -0
- package/dist/extensions/codemode/tool.js +286 -0
- package/dist/extensions/codemode/tool.js.map +1 -0
- package/dist/extensions/codemode/worker.d.ts +7 -0
- package/dist/extensions/codemode/worker.d.ts.map +1 -0
- package/dist/extensions/codemode/worker.js +7 -0
- package/dist/extensions/codemode/worker.js.map +1 -0
- package/dist/extensions/context-pruning/compress_context.d.ts.map +1 -1
- package/dist/extensions/context-pruning/compress_context.js +1 -3
- package/dist/extensions/context-pruning/compress_context.js.map +1 -1
- package/dist/extensions/context-pruning/context-pruning-state.d.ts.map +1 -1
- package/dist/extensions/context-pruning/context-pruning-state.js.map +1 -1
- package/dist/extensions/index.d.ts.map +1 -1
- package/dist/extensions/index.js +6 -2
- package/dist/extensions/index.js.map +1 -1
- package/dist/extensions/llama/client.d.ts +2 -0
- package/dist/extensions/llama/client.d.ts.map +1 -1
- package/dist/extensions/llama/client.js +7 -3
- package/dist/extensions/llama/client.js.map +1 -1
- package/dist/extensions/llama/huggingface.d.ts.map +1 -1
- package/dist/extensions/llama/huggingface.js.map +1 -1
- package/dist/extensions/llama/index.d.ts.map +1 -1
- package/dist/extensions/llama/index.js +0 -4
- package/dist/extensions/llama/index.js.map +1 -1
- package/dist/extensions/llama/provider.d.ts +1 -1
- package/dist/extensions/llama/provider.d.ts.map +1 -1
- package/dist/extensions/llama/provider.js +103 -13
- package/dist/extensions/llama/provider.js.map +1 -1
- package/dist/extensions/llama/ui.d.ts +3 -2
- package/dist/extensions/llama/ui.d.ts.map +1 -1
- package/dist/extensions/llama/ui.js +106 -364
- package/dist/extensions/llama/ui.js.map +1 -1
- package/dist/extensions/mcp/cli.d.ts +21 -0
- package/dist/extensions/mcp/cli.d.ts.map +1 -0
- package/dist/extensions/mcp/cli.js +494 -0
- package/dist/extensions/mcp/cli.js.map +1 -0
- package/dist/extensions/mcp/cli.lazy.d.ts +3 -0
- package/dist/extensions/mcp/cli.lazy.d.ts.map +1 -0
- package/dist/extensions/mcp/cli.lazy.js +3 -0
- package/dist/extensions/mcp/cli.lazy.js.map +1 -0
- package/dist/extensions/mcp/config.d.ts +84 -0
- package/dist/extensions/mcp/config.d.ts.map +1 -0
- package/dist/extensions/mcp/config.js +196 -0
- package/dist/extensions/mcp/config.js.map +1 -0
- package/dist/extensions/mcp/index.d.ts +71 -2
- package/dist/extensions/mcp/index.d.ts.map +1 -1
- package/dist/extensions/mcp/index.js +839 -131
- package/dist/extensions/mcp/index.js.map +1 -1
- package/dist/extensions/mcp/log.d.ts +16 -0
- package/dist/extensions/mcp/log.d.ts.map +1 -0
- package/dist/extensions/mcp/log.js +66 -0
- package/dist/extensions/mcp/log.js.map +1 -0
- package/dist/extensions/mcp/oauth.d.ts +102 -0
- package/dist/extensions/mcp/oauth.d.ts.map +1 -0
- package/dist/extensions/mcp/oauth.js +428 -0
- package/dist/extensions/mcp/oauth.js.map +1 -0
- package/dist/extensions/mcp/resources.d.ts +36 -0
- package/dist/extensions/mcp/resources.d.ts.map +1 -0
- package/dist/extensions/mcp/resources.js +261 -0
- package/dist/extensions/mcp/resources.js.map +1 -0
- package/dist/extensions/mcp/runtime.d.ts +98 -0
- package/dist/extensions/mcp/runtime.d.ts.map +1 -0
- package/dist/extensions/mcp/runtime.js +378 -0
- package/dist/extensions/mcp/runtime.js.map +1 -0
- package/dist/extensions/mcp/runtime.lazy.d.ts +3 -0
- package/dist/extensions/mcp/runtime.lazy.d.ts.map +1 -0
- package/dist/extensions/mcp/runtime.lazy.js +3 -0
- package/dist/extensions/mcp/runtime.lazy.js.map +1 -0
- package/dist/extensions/mcp/tools.d.ts +84 -0
- package/dist/extensions/mcp/tools.d.ts.map +1 -0
- package/dist/extensions/mcp/tools.js +263 -0
- package/dist/extensions/mcp/tools.js.map +1 -0
- package/dist/extensions/punch/a2a-listen.d.ts +9 -0
- package/dist/extensions/punch/a2a-listen.d.ts.map +1 -0
- package/dist/extensions/punch/a2a-listen.js +88 -0
- package/dist/extensions/punch/a2a-listen.js.map +1 -0
- package/dist/extensions/punch/a2a.d.ts +12 -0
- package/dist/extensions/punch/a2a.d.ts.map +1 -0
- package/dist/extensions/punch/a2a.js +106 -0
- package/dist/extensions/punch/a2a.js.map +1 -0
- package/dist/extensions/punch/auth.d.ts +2 -1
- package/dist/extensions/punch/auth.d.ts.map +1 -1
- package/dist/extensions/punch/auth.js +5 -1
- package/dist/extensions/punch/auth.js.map +1 -1
- package/dist/extensions/punch/collabs.d.ts.map +1 -1
- package/dist/extensions/punch/collabs.js.map +1 -1
- package/dist/extensions/punch/index.d.ts.map +1 -1
- package/dist/extensions/punch/index.js +11 -15
- package/dist/extensions/punch/index.js.map +1 -1
- package/dist/extensions/punch/routines.d.ts +1 -3
- package/dist/extensions/punch/routines.d.ts.map +1 -1
- package/dist/extensions/punch/routines.js +1 -121
- package/dist/extensions/punch/routines.js.map +1 -1
- package/dist/extensions/punch/server.d.ts +3 -0
- package/dist/extensions/punch/server.d.ts.map +1 -1
- package/dist/extensions/punch/server.js +41 -3
- package/dist/extensions/punch/server.js.map +1 -1
- package/dist/extensions/punch/timezone.d.ts.map +1 -1
- package/dist/extensions/punch/timezone.js.map +1 -1
- package/dist/extensions/punch/todo-store.d.ts +15 -0
- package/dist/extensions/punch/todo-store.d.ts.map +1 -0
- package/dist/extensions/punch/todo-store.js +208 -0
- package/dist/extensions/punch/todo-store.js.map +1 -0
- package/dist/extensions/punch/todos.d.ts +7 -3
- package/dist/extensions/punch/todos.d.ts.map +1 -1
- package/dist/extensions/punch/todos.js +40 -17
- package/dist/extensions/punch/todos.js.map +1 -1
- package/dist/extensions/report-progress/index.d.ts.map +1 -1
- package/dist/extensions/report-progress/index.js.map +1 -1
- package/dist/extensions/subagent/agents.d.ts.map +1 -1
- package/dist/extensions/subagent/agents.js.map +1 -1
- package/dist/extensions/subagent/index.d.ts.map +1 -1
- package/dist/extensions/subagent/index.js +0 -372
- package/dist/extensions/subagent/index.js.map +1 -1
- package/dist/extensions/tool-search/index.d.ts +12 -0
- package/dist/extensions/tool-search/index.d.ts.map +1 -0
- package/dist/extensions/tool-search/index.js +15 -0
- package/dist/extensions/tool-search/index.js.map +1 -0
- package/dist/extensions/tool-search/tool.d.ts +71 -0
- package/dist/extensions/tool-search/tool.d.ts.map +1 -0
- package/dist/extensions/tool-search/tool.js +187 -0
- package/dist/extensions/tool-search/tool.js.map +1 -0
- package/dist/extensions/webfetch/index.d.ts.map +1 -1
- package/dist/extensions/webfetch/index.js.map +1 -1
- package/dist/extensions/websearch/index.d.ts.map +1 -1
- package/dist/extensions/websearch/index.js.map +1 -1
- package/dist/index.d.ts +13 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -6
- package/dist/index.js.map +1 -1
- package/dist/main.d.ts +1 -1
- package/dist/main.d.ts.map +1 -1
- package/dist/main.js +140 -173
- package/dist/main.js.map +1 -1
- package/dist/migrations.d.ts.map +1 -1
- package/dist/migrations.js +0 -20
- package/dist/migrations.js.map +1 -1
- package/dist/modes/index.d.ts +0 -1
- package/dist/modes/index.d.ts.map +1 -1
- package/dist/modes/index.js +0 -1
- package/dist/modes/index.js.map +1 -1
- package/dist/modes/json-event.d.ts.map +1 -1
- package/dist/modes/json-event.js.map +1 -1
- package/dist/modes/print-mode.d.ts.map +1 -1
- package/dist/modes/print-mode.js +4 -0
- package/dist/modes/print-mode.js.map +1 -1
- package/dist/modes/rpc/jsonl.d.ts.map +1 -1
- package/dist/modes/rpc/jsonl.js.map +1 -1
- package/dist/modes/rpc/rpc-client.d.ts +10 -6
- package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-client.js +19 -8
- package/dist/modes/rpc/rpc-client.js.map +1 -1
- package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-mode.js +30 -48
- package/dist/modes/rpc/rpc-mode.js.map +1 -1
- package/dist/modes/rpc/rpc-types.d.ts +21 -1
- package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-types.js.map +1 -1
- package/dist/package-manager-cli.d.ts.map +1 -1
- package/dist/package-manager-cli.js +43 -43
- package/dist/package-manager-cli.js.map +1 -1
- package/dist/rpc-entry.d.ts.map +1 -1
- package/dist/rpc-entry.js.map +1 -1
- package/dist/server/a2a/harness-runner.d.ts.map +1 -1
- package/dist/server/a2a/harness-runner.js.map +1 -1
- package/dist/server/a2a/run-server.d.ts.map +1 -1
- package/dist/server/a2a/run-server.js.map +1 -1
- package/dist/utils/abort.d.ts.map +1 -1
- package/dist/utils/abort.js.map +1 -1
- package/dist/utils/ansi.d.ts +8 -0
- package/dist/utils/ansi.d.ts.map +1 -1
- package/dist/utils/ansi.js +30 -11
- package/dist/utils/ansi.js.map +1 -1
- package/dist/utils/changelog.d.ts.map +1 -1
- package/dist/utils/changelog.js +5 -2
- package/dist/utils/changelog.js.map +1 -1
- package/dist/utils/child-process.d.ts.map +1 -1
- package/dist/utils/child-process.js.map +1 -1
- package/dist/utils/clipboard-command.d.ts.map +1 -1
- package/dist/utils/clipboard-command.js.map +1 -1
- package/dist/utils/clipboard-image.d.ts.map +1 -1
- package/dist/utils/clipboard-image.js +15 -41
- package/dist/utils/clipboard-image.js.map +1 -1
- package/dist/utils/clipboard.d.ts.map +1 -1
- package/dist/utils/clipboard.js +96 -38
- package/dist/utils/clipboard.js.map +1 -1
- package/dist/utils/colors.d.ts +73 -0
- package/dist/utils/colors.d.ts.map +1 -0
- package/dist/utils/colors.js +273 -0
- package/dist/utils/colors.js.map +1 -0
- package/dist/utils/deprecation.d.ts.map +1 -1
- package/dist/utils/deprecation.js.map +1 -1
- package/dist/utils/exif-orientation.d.ts.map +1 -1
- package/dist/utils/exif-orientation.js.map +1 -1
- package/dist/utils/frontmatter.d.ts.map +1 -1
- package/dist/utils/frontmatter.js.map +1 -1
- package/dist/utils/fs-watch.d.ts.map +1 -1
- package/dist/utils/fs-watch.js.map +1 -1
- package/dist/utils/fuzzy.d.ts +16 -0
- package/dist/utils/fuzzy.d.ts.map +1 -0
- package/dist/utils/fuzzy.js +111 -0
- package/dist/utils/fuzzy.js.map +1 -0
- package/dist/utils/git.d.ts.map +1 -1
- package/dist/utils/git.js.map +1 -1
- package/dist/utils/html.d.ts.map +1 -1
- package/dist/utils/html.js.map +1 -1
- package/dist/utils/image-convert.d.ts.map +1 -1
- package/dist/utils/image-convert.js.map +1 -1
- package/dist/utils/image-process.d.ts.map +1 -1
- package/dist/utils/image-process.js.map +1 -1
- package/dist/utils/image-resize-core.d.ts +12 -0
- package/dist/utils/image-resize-core.d.ts.map +1 -1
- package/dist/utils/image-resize-core.js +5 -0
- package/dist/utils/image-resize-core.js.map +1 -1
- package/dist/utils/image-resize-worker.d.ts.map +1 -1
- package/dist/utils/image-resize-worker.js +3 -2
- package/dist/utils/image-resize-worker.js.map +1 -1
- package/dist/utils/image-resize.d.ts.map +1 -1
- package/dist/utils/image-resize.js +9 -10
- package/dist/utils/image-resize.js.map +1 -1
- package/dist/utils/json.d.ts.map +1 -1
- package/dist/utils/json.js.map +1 -1
- package/dist/utils/management-http.d.ts.map +1 -1
- package/dist/utils/management-http.js.map +1 -1
- package/dist/utils/mime.d.ts.map +1 -1
- package/dist/utils/mime.js +1 -1
- package/dist/utils/mime.js.map +1 -1
- package/dist/utils/oklab.d.ts +43 -0
- package/dist/utils/oklab.d.ts.map +1 -0
- package/dist/utils/oklab.js +210 -0
- package/dist/utils/oklab.js.map +1 -0
- package/dist/utils/open-browser.d.ts.map +1 -1
- package/dist/utils/open-browser.js.map +1 -1
- package/dist/utils/output-files.d.ts +15 -0
- package/dist/utils/output-files.d.ts.map +1 -0
- package/dist/utils/output-files.js +30 -0
- package/dist/utils/output-files.js.map +1 -0
- package/dist/utils/paths.d.ts +3 -3
- package/dist/utils/paths.d.ts.map +1 -1
- package/dist/utils/paths.js +5 -4
- package/dist/utils/paths.js.map +1 -1
- package/dist/utils/photon.d.ts.map +1 -1
- package/dist/utils/photon.js.map +1 -1
- package/dist/utils/pi-user-agent.d.ts.map +1 -1
- package/dist/utils/pi-user-agent.js.map +1 -1
- package/dist/utils/shell.d.ts +1 -3
- package/dist/utils/shell.d.ts.map +1 -1
- package/dist/utils/shell.js +3 -30
- package/dist/utils/shell.js.map +1 -1
- package/dist/utils/sleep.d.ts.map +1 -1
- package/dist/utils/sleep.js.map +1 -1
- package/dist/utils/syntax-highlight.d.ts.map +1 -1
- package/dist/utils/syntax-highlight.js +8 -1
- package/dist/utils/syntax-highlight.js.map +1 -1
- package/dist/utils/text.d.ts.map +1 -1
- package/dist/utils/text.js.map +1 -1
- package/dist/utils/tool-result-images.d.ts +3 -1
- package/dist/utils/tool-result-images.d.ts.map +1 -1
- package/dist/utils/tool-result-images.js +4 -1
- package/dist/utils/tool-result-images.js.map +1 -1
- package/dist/utils/tools-manager.d.ts.map +1 -1
- package/dist/utils/tools-manager.js.map +1 -1
- package/dist/utils/version-check.d.ts.map +1 -1
- package/dist/utils/version-check.js.map +1 -1
- package/dist/utils/windows-self-update.d.ts.map +1 -1
- package/dist/utils/windows-self-update.js.map +1 -1
- package/dist/utils/wsl.d.ts +3 -0
- package/dist/utils/wsl.d.ts.map +1 -0
- package/dist/utils/wsl.js +15 -0
- package/dist/utils/wsl.js.map +1 -0
- package/dist/utils/zip.d.ts +7 -0
- package/dist/utils/zip.d.ts.map +1 -0
- package/dist/utils/zip.js +60 -0
- package/dist/utils/zip.js.map +1 -0
- package/docs/cli-integration.md +106 -0
- package/docs/cli.md +333 -0
- package/docs/codemode.md +230 -0
- package/docs/compaction.md +47 -28
- package/docs/configuration.md +47 -0
- package/docs/containerization.md +109 -82
- package/docs/custom-provider.md +109 -713
- package/docs/docs.json +152 -96
- package/docs/environment-variables.md +18 -3
- package/docs/extensions.md +284 -604
- package/docs/how-pi-works.md +49 -0
- package/docs/images/interactive-mode.png +0 -0
- package/docs/index.md +24 -69
- package/docs/json.md +193 -65
- package/docs/keybindings.md +58 -103
- package/docs/llama-cpp.md +24 -4
- package/docs/mcp.md +272 -0
- package/docs/message-types.md +279 -0
- package/docs/models.md +124 -489
- package/docs/nvidia-rtx-llama-cpp.md +96 -0
- package/docs/packages.md +67 -166
- package/docs/prompt-templates.md +31 -68
- package/docs/providers.md +158 -228
- package/docs/punch-todos.md +24 -0
- package/docs/quickstart.md +61 -106
- package/docs/rpc-commands.md +888 -0
- package/docs/rpc-extension-ui.md +200 -0
- package/docs/rpc.md +131 -1554
- package/docs/sdk.md +79 -1158
- package/docs/security.md +72 -32
- package/docs/session-format.md +58 -215
- package/docs/sessions.md +35 -114
- package/docs/settings.md +98 -326
- package/docs/shell-aliases.md +85 -5
- package/docs/skills.md +51 -190
- package/docs/slash-commands.md +60 -0
- package/docs/subagents.md +2 -0
- package/docs/terminal-setup.md +7 -182
- package/docs/termux.md +74 -83
- package/docs/themes.md +89 -273
- package/docs/tmux.md +31 -39
- package/docs/tui.md +74 -910
- package/docs/usage.md +52 -129
- package/docs/virtual-models.md +114 -0
- package/docs/windows.md +45 -17
- package/examples/README.md +13 -5
- package/examples/extensions/README.md +4 -30
- package/examples/extensions/custom-provider-anthropic/index.ts +18 -12
- package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
- package/examples/extensions/custom-provider-anthropic/package.json +17 -17
- package/examples/extensions/custom-provider-gitlab-duo/index.ts +2 -2
- package/examples/extensions/custom-provider-gitlab-duo/package.json +14 -14
- package/examples/extensions/custom-provider-gitlab-duo/test.ts +5 -5
- package/examples/extensions/debug-provider.ts +69 -0
- package/examples/extensions/dynamic-resources/dynamic.json +1 -1
- package/examples/extensions/gondolin/package-lock.json +5 -5
- package/examples/extensions/gondolin/package.json +1 -1
- package/examples/extensions/jev-router.ts +113 -0
- package/examples/extensions/prompt-customizer.ts +19 -67
- package/examples/extensions/sandbox/package-lock.json +2 -2
- package/examples/extensions/sandbox/package.json +1 -1
- package/examples/extensions/with-deps/package-lock.json +2 -2
- package/examples/extensions/with-deps/package.json +20 -20
- package/examples/rpc-client.ts +35 -0
- package/examples/sdk/14-codemode-mcp.ts +61 -0
- package/examples/sdk/README.md +3 -2
- package/npm-shrinkwrap.json +2425 -0
- package/package.json +30 -29
- package/schemas/models.schema.json +1157 -0
- package/schemas/settings.schema.json +734 -0
- package/schemas/theme.schema.json +365 -0
- package/src/extensions/punch/sqlite-bun.mjs +1 -0
- package/src/extensions/punch/sqlite-driver.d.mts +15 -0
- package/src/extensions/punch/sqlite-node.mjs +1 -0
- package/dist/bundle/chunks/anthropic-messages-ASRU76PT.js +0 -6
- package/dist/bundle/chunks/azure-openai-responses-UGF6LMEX.js +0 -2
- package/dist/bundle/chunks/chunk-5PRUVL6W.js +0 -1770
- package/dist/bundle/chunks/chunk-6R7UI4IY.js +0 -2
- package/dist/bundle/chunks/chunk-A3JYRWB6.js +0 -2
- package/dist/bundle/chunks/chunk-CHB3CEFP.js +0 -2
- package/dist/bundle/chunks/chunk-ELBMWBDG.js +0 -11
- package/dist/bundle/chunks/chunk-GMWCTUPB.js +0 -2
- package/dist/bundle/chunks/chunk-GTBU4EAF.js +0 -2
- package/dist/bundle/chunks/chunk-NUHFSC37.js +0 -25
- package/dist/bundle/chunks/chunk-UIWY7TU5.js +0 -42
- package/dist/bundle/chunks/chunk-XNGRGP62.js +0 -2
- package/dist/bundle/chunks/google-generative-ai-VCD2PGIY.js +0 -2
- package/dist/bundle/chunks/google-vertex-L6U34ZRC.js +0 -2
- package/dist/bundle/chunks/mistral-conversations-IXWQ2YKN.js +0 -5
- package/dist/bundle/chunks/node-5YXRXMVN.js +0 -16
- package/dist/bundle/chunks/openai-codex-responses-P7HKQLIT.js +0 -10
- package/dist/bundle/chunks/openai-completions-O7BFLP3U.js +0 -7
- package/dist/bundle/chunks/openai-responses-QAKWAYVG.js +0 -2
- package/dist/cli/config-selector.d.ts +0 -16
- package/dist/cli/config-selector.d.ts.map +0 -1
- package/dist/cli/config-selector.js +0 -32
- package/dist/cli/config-selector.js.map +0 -1
- package/dist/cli/session-picker.d.ts +0 -10
- package/dist/cli/session-picker.d.ts.map +0 -1
- package/dist/cli/session-picker.js +0 -36
- package/dist/cli/session-picker.js.map +0 -1
- package/dist/cli/startup-ui.d.ts +0 -20
- package/dist/cli/startup-ui.d.ts.map +0 -1
- package/dist/cli/startup-ui.js +0 -185
- package/dist/cli/startup-ui.js.map +0 -1
- package/dist/core/keybindings.d.ts +0 -428
- package/dist/core/keybindings.d.ts.map +0 -1
- package/dist/core/keybindings.js +0 -321
- package/dist/core/keybindings.js.map +0 -1
- package/dist/core/tools/render-utils.d.ts +0 -24
- package/dist/core/tools/render-utils.d.ts.map +0 -1
- package/dist/core/tools/render-utils.js +0 -65
- package/dist/core/tools/render-utils.js.map +0 -1
- package/dist/core/tools/renderers/bash.d.ts +0 -12
- package/dist/core/tools/renderers/bash.d.ts.map +0 -1
- package/dist/core/tools/renderers/bash.js +0 -130
- package/dist/core/tools/renderers/bash.js.map +0 -1
- package/dist/core/tools/renderers/edit.d.ts +0 -23
- package/dist/core/tools/renderers/edit.d.ts.map +0 -1
- package/dist/core/tools/renderers/edit.js +0 -167
- package/dist/core/tools/renderers/edit.js.map +0 -1
- package/dist/core/tools/renderers/find.d.ts +0 -10
- package/dist/core/tools/renderers/find.d.ts.map +0 -1
- package/dist/core/tools/renderers/find.js +0 -64
- package/dist/core/tools/renderers/find.js.map +0 -1
- package/dist/core/tools/renderers/grep.d.ts +0 -10
- package/dist/core/tools/renderers/grep.d.ts.map +0 -1
- package/dist/core/tools/renderers/grep.js +0 -69
- package/dist/core/tools/renderers/grep.js.map +0 -1
- package/dist/core/tools/renderers/index.d.ts +0 -28
- package/dist/core/tools/renderers/index.d.ts.map +0 -1
- package/dist/core/tools/renderers/index.js +0 -47
- package/dist/core/tools/renderers/index.js.map +0 -1
- package/dist/core/tools/renderers/ls.d.ts +0 -10
- package/dist/core/tools/renderers/ls.d.ts.map +0 -1
- package/dist/core/tools/renderers/ls.js +0 -58
- package/dist/core/tools/renderers/ls.js.map +0 -1
- package/dist/core/tools/renderers/read.d.ts +0 -11
- package/dist/core/tools/renderers/read.d.ts.map +0 -1
- package/dist/core/tools/renderers/read.js +0 -129
- package/dist/core/tools/renderers/read.js.map +0 -1
- package/dist/core/tools/renderers/write.d.ts +0 -10
- package/dist/core/tools/renderers/write.d.ts.map +0 -1
- package/dist/core/tools/renderers/write.js +0 -153
- package/dist/core/tools/renderers/write.js.map +0 -1
- package/dist/extensions/mcp/mcp-client.d.ts +0 -31
- package/dist/extensions/mcp/mcp-client.d.ts.map +0 -1
- package/dist/extensions/mcp/mcp-client.js +0 -149
- package/dist/extensions/mcp/mcp-client.js.map +0 -1
- package/dist/extensions/mcp/mcp-config.d.ts +0 -47
- package/dist/extensions/mcp/mcp-config.d.ts.map +0 -1
- package/dist/extensions/mcp/mcp-config.js +0 -281
- package/dist/extensions/mcp/mcp-config.js.map +0 -1
- package/dist/extensions/mcp/mcp-transport.d.ts +0 -65
- package/dist/extensions/mcp/mcp-transport.d.ts.map +0 -1
- package/dist/extensions/mcp/mcp-transport.js +0 -278
- package/dist/extensions/mcp/mcp-transport.js.map +0 -1
- package/dist/modes/interactive/assets/clankolas.png +0 -0
- package/dist/modes/interactive/chat-viewport.d.ts +0 -20
- package/dist/modes/interactive/chat-viewport.d.ts.map +0 -1
- package/dist/modes/interactive/chat-viewport.js +0 -28
- package/dist/modes/interactive/chat-viewport.js.map +0 -1
- package/dist/modes/interactive/components/armin.d.ts +0 -34
- package/dist/modes/interactive/components/armin.d.ts.map +0 -1
- package/dist/modes/interactive/components/armin.js +0 -333
- package/dist/modes/interactive/components/armin.js.map +0 -1
- package/dist/modes/interactive/components/assistant-message.d.ts +0 -26
- package/dist/modes/interactive/components/assistant-message.d.ts.map +0 -1
- package/dist/modes/interactive/components/assistant-message.js +0 -158
- package/dist/modes/interactive/components/assistant-message.js.map +0 -1
- package/dist/modes/interactive/components/bash-execution.d.ts +0 -34
- package/dist/modes/interactive/components/bash-execution.d.ts.map +0 -1
- package/dist/modes/interactive/components/bash-execution.js +0 -175
- package/dist/modes/interactive/components/bash-execution.js.map +0 -1
- package/dist/modes/interactive/components/bordered-loader.d.ts +0 -16
- package/dist/modes/interactive/components/bordered-loader.d.ts.map +0 -1
- package/dist/modes/interactive/components/bordered-loader.js +0 -54
- package/dist/modes/interactive/components/bordered-loader.js.map +0 -1
- package/dist/modes/interactive/components/branch-summary-message.d.ts +0 -16
- package/dist/modes/interactive/components/branch-summary-message.d.ts.map +0 -1
- package/dist/modes/interactive/components/branch-summary-message.js +0 -44
- package/dist/modes/interactive/components/branch-summary-message.js.map +0 -1
- package/dist/modes/interactive/components/compaction-summary-message.d.ts +0 -16
- package/dist/modes/interactive/components/compaction-summary-message.d.ts.map +0 -1
- package/dist/modes/interactive/components/compaction-summary-message.js +0 -45
- package/dist/modes/interactive/components/compaction-summary-message.js.map +0 -1
- package/dist/modes/interactive/components/config-selector.d.ts +0 -102
- package/dist/modes/interactive/components/config-selector.d.ts.map +0 -1
- package/dist/modes/interactive/components/config-selector.js +0 -761
- package/dist/modes/interactive/components/config-selector.js.map +0 -1
- package/dist/modes/interactive/components/countdown-timer.d.ts +0 -14
- package/dist/modes/interactive/components/countdown-timer.d.ts.map +0 -1
- package/dist/modes/interactive/components/countdown-timer.js +0 -33
- package/dist/modes/interactive/components/countdown-timer.js.map +0 -1
- package/dist/modes/interactive/components/custom-editor.d.ts +0 -30
- package/dist/modes/interactive/components/custom-editor.d.ts.map +0 -1
- package/dist/modes/interactive/components/custom-editor.js +0 -115
- package/dist/modes/interactive/components/custom-editor.js.map +0 -1
- package/dist/modes/interactive/components/custom-entry.d.ts +0 -19
- package/dist/modes/interactive/components/custom-entry.d.ts.map +0 -1
- package/dist/modes/interactive/components/custom-entry.js +0 -52
- package/dist/modes/interactive/components/custom-entry.js.map +0 -1
- package/dist/modes/interactive/components/custom-message.d.ts +0 -22
- package/dist/modes/interactive/components/custom-message.d.ts.map +0 -1
- package/dist/modes/interactive/components/custom-message.js +0 -87
- package/dist/modes/interactive/components/custom-message.js.map +0 -1
- package/dist/modes/interactive/components/daxnuts.d.ts +0 -23
- package/dist/modes/interactive/components/daxnuts.d.ts.map +0 -1
- package/dist/modes/interactive/components/daxnuts.js +0 -140
- package/dist/modes/interactive/components/daxnuts.js.map +0 -1
- package/dist/modes/interactive/components/diff.d.ts +0 -12
- package/dist/modes/interactive/components/diff.d.ts.map +0 -1
- package/dist/modes/interactive/components/diff.js +0 -133
- package/dist/modes/interactive/components/diff.js.map +0 -1
- package/dist/modes/interactive/components/dynamic-border.d.ts +0 -15
- package/dist/modes/interactive/components/dynamic-border.d.ts.map +0 -1
- package/dist/modes/interactive/components/dynamic-border.js +0 -21
- package/dist/modes/interactive/components/dynamic-border.js.map +0 -1
- package/dist/modes/interactive/components/earendil-announcement.d.ts +0 -5
- package/dist/modes/interactive/components/earendil-announcement.d.ts.map +0 -1
- package/dist/modes/interactive/components/earendil-announcement.js +0 -40
- package/dist/modes/interactive/components/earendil-announcement.js.map +0 -1
- package/dist/modes/interactive/components/extension-editor.d.ts +0 -21
- package/dist/modes/interactive/components/extension-editor.d.ts.map +0 -1
- package/dist/modes/interactive/components/extension-editor.js +0 -98
- package/dist/modes/interactive/components/extension-editor.js.map +0 -1
- package/dist/modes/interactive/components/extension-input.d.ts +0 -23
- package/dist/modes/interactive/components/extension-input.d.ts.map +0 -1
- package/dist/modes/interactive/components/extension-input.js +0 -61
- package/dist/modes/interactive/components/extension-input.js.map +0 -1
- package/dist/modes/interactive/components/extension-selector.d.ts +0 -26
- package/dist/modes/interactive/components/extension-selector.d.ts.map +0 -1
- package/dist/modes/interactive/components/extension-selector.js +0 -83
- package/dist/modes/interactive/components/extension-selector.js.map +0 -1
- package/dist/modes/interactive/components/first-time-setup.d.ts +0 -25
- package/dist/modes/interactive/components/first-time-setup.d.ts.map +0 -1
- package/dist/modes/interactive/components/first-time-setup.js +0 -103
- package/dist/modes/interactive/components/first-time-setup.js.map +0 -1
- package/dist/modes/interactive/components/footer.d.ts +0 -32
- package/dist/modes/interactive/components/footer.d.ts.map +0 -1
- package/dist/modes/interactive/components/footer.js +0 -222
- package/dist/modes/interactive/components/footer.js.map +0 -1
- package/dist/modes/interactive/components/index.d.ts +0 -34
- package/dist/modes/interactive/components/index.d.ts.map +0 -1
- package/dist/modes/interactive/components/index.js +0 -35
- package/dist/modes/interactive/components/index.js.map +0 -1
- package/dist/modes/interactive/components/keybinding-hints.d.ts +0 -13
- package/dist/modes/interactive/components/keybinding-hints.d.ts.map +0 -1
- package/dist/modes/interactive/components/keybinding-hints.js +0 -36
- package/dist/modes/interactive/components/keybinding-hints.js.map +0 -1
- package/dist/modes/interactive/components/login-dialog.d.ts +0 -52
- package/dist/modes/interactive/components/login-dialog.d.ts.map +0 -1
- package/dist/modes/interactive/components/login-dialog.js +0 -188
- package/dist/modes/interactive/components/login-dialog.js.map +0 -1
- package/dist/modes/interactive/components/markdown-transform.d.ts +0 -3
- package/dist/modes/interactive/components/markdown-transform.d.ts.map +0 -1
- package/dist/modes/interactive/components/markdown-transform.js +0 -19
- package/dist/modes/interactive/components/markdown-transform.js.map +0 -1
- package/dist/modes/interactive/components/mermaid.d.ts +0 -11
- package/dist/modes/interactive/components/mermaid.d.ts.map +0 -1
- package/dist/modes/interactive/components/mermaid.js +0 -75
- package/dist/modes/interactive/components/mermaid.js.map +0 -1
- package/dist/modes/interactive/components/model-selector.d.ts +0 -60
- package/dist/modes/interactive/components/model-selector.d.ts.map +0 -1
- package/dist/modes/interactive/components/model-selector.js +0 -361
- package/dist/modes/interactive/components/model-selector.js.map +0 -1
- package/dist/modes/interactive/components/oauth-selector.d.ts +0 -33
- package/dist/modes/interactive/components/oauth-selector.d.ts.map +0 -1
- package/dist/modes/interactive/components/oauth-selector.js +0 -163
- package/dist/modes/interactive/components/oauth-selector.js.map +0 -1
- package/dist/modes/interactive/components/question-selector.d.ts +0 -24
- package/dist/modes/interactive/components/question-selector.d.ts.map +0 -1
- package/dist/modes/interactive/components/question-selector.js +0 -158
- package/dist/modes/interactive/components/question-selector.js.map +0 -1
- package/dist/modes/interactive/components/scoped-models-selector.d.ts +0 -46
- package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +0 -1
- package/dist/modes/interactive/components/scoped-models-selector.js +0 -326
- package/dist/modes/interactive/components/scoped-models-selector.js.map +0 -1
- package/dist/modes/interactive/components/session-selector-search.d.ts +0 -23
- package/dist/modes/interactive/components/session-selector-search.d.ts.map +0 -1
- package/dist/modes/interactive/components/session-selector-search.js +0 -155
- package/dist/modes/interactive/components/session-selector-search.js.map +0 -1
- package/dist/modes/interactive/components/session-selector.d.ts +0 -95
- package/dist/modes/interactive/components/session-selector.d.ts.map +0 -1
- package/dist/modes/interactive/components/session-selector.js +0 -867
- package/dist/modes/interactive/components/session-selector.js.map +0 -1
- package/dist/modes/interactive/components/settings-selector.d.ts +0 -92
- package/dist/modes/interactive/components/settings-selector.d.ts.map +0 -1
- package/dist/modes/interactive/components/settings-selector.js +0 -709
- package/dist/modes/interactive/components/settings-selector.js.map +0 -1
- package/dist/modes/interactive/components/settings-submenu.d.ts +0 -72
- package/dist/modes/interactive/components/settings-submenu.d.ts.map +0 -1
- package/dist/modes/interactive/components/settings-submenu.js +0 -165
- package/dist/modes/interactive/components/settings-submenu.js.map +0 -1
- package/dist/modes/interactive/components/show-images-selector.d.ts +0 -10
- package/dist/modes/interactive/components/show-images-selector.d.ts.map +0 -1
- package/dist/modes/interactive/components/show-images-selector.js +0 -39
- package/dist/modes/interactive/components/show-images-selector.js.map +0 -1
- package/dist/modes/interactive/components/skill-invocation-message.d.ts +0 -17
- package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +0 -1
- package/dist/modes/interactive/components/skill-invocation-message.js +0 -47
- package/dist/modes/interactive/components/skill-invocation-message.js.map +0 -1
- package/dist/modes/interactive/components/status-indicator.d.ts +0 -30
- package/dist/modes/interactive/components/status-indicator.d.ts.map +0 -1
- package/dist/modes/interactive/components/status-indicator.js +0 -67
- package/dist/modes/interactive/components/status-indicator.js.map +0 -1
- package/dist/modes/interactive/components/theme-selector.d.ts +0 -11
- package/dist/modes/interactive/components/theme-selector.d.ts.map +0 -1
- package/dist/modes/interactive/components/theme-selector.js +0 -50
- package/dist/modes/interactive/components/theme-selector.js.map +0 -1
- package/dist/modes/interactive/components/thinking-selector.d.ts +0 -23
- package/dist/modes/interactive/components/thinking-selector.d.ts.map +0 -1
- package/dist/modes/interactive/components/thinking-selector.js +0 -109
- package/dist/modes/interactive/components/thinking-selector.js.map +0 -1
- package/dist/modes/interactive/components/tool-execution.d.ts +0 -80
- package/dist/modes/interactive/components/tool-execution.d.ts.map +0 -1
- package/dist/modes/interactive/components/tool-execution.js +0 -328
- package/dist/modes/interactive/components/tool-execution.js.map +0 -1
- package/dist/modes/interactive/components/tree-selector.d.ts +0 -94
- package/dist/modes/interactive/components/tree-selector.d.ts.map +0 -1
- package/dist/modes/interactive/components/tree-selector.js +0 -1245
- package/dist/modes/interactive/components/tree-selector.js.map +0 -1
- package/dist/modes/interactive/components/trust-selector.d.ts +0 -23
- package/dist/modes/interactive/components/trust-selector.d.ts.map +0 -1
- package/dist/modes/interactive/components/trust-selector.js +0 -91
- package/dist/modes/interactive/components/trust-selector.js.map +0 -1
- package/dist/modes/interactive/components/user-message-selector.d.ts +0 -30
- package/dist/modes/interactive/components/user-message-selector.d.ts.map +0 -1
- package/dist/modes/interactive/components/user-message-selector.js +0 -114
- package/dist/modes/interactive/components/user-message-selector.js.map +0 -1
- package/dist/modes/interactive/components/user-message.d.ts +0 -16
- package/dist/modes/interactive/components/user-message.d.ts.map +0 -1
- package/dist/modes/interactive/components/user-message.js +0 -49
- package/dist/modes/interactive/components/user-message.js.map +0 -1
- package/dist/modes/interactive/components/visual-truncate.d.ts +0 -24
- package/dist/modes/interactive/components/visual-truncate.d.ts.map +0 -1
- package/dist/modes/interactive/components/visual-truncate.js +0 -33
- package/dist/modes/interactive/components/visual-truncate.js.map +0 -1
- package/dist/modes/interactive/external-editor.d.ts +0 -12
- package/dist/modes/interactive/external-editor.d.ts.map +0 -1
- package/dist/modes/interactive/external-editor.js +0 -38
- package/dist/modes/interactive/external-editor.js.map +0 -1
- package/dist/modes/interactive/interactive-mode.d.ts +0 -443
- package/dist/modes/interactive/interactive-mode.d.ts.map +0 -1
- package/dist/modes/interactive/interactive-mode.js +0 -5604
- package/dist/modes/interactive/interactive-mode.js.map +0 -1
- package/dist/modes/interactive/model-catalog-refresh.d.ts.map +0 -1
- package/dist/modes/interactive/model-catalog-refresh.js.map +0 -1
- package/dist/modes/interactive/model-search.d.ts +0 -12
- package/dist/modes/interactive/model-search.d.ts.map +0 -1
- package/dist/modes/interactive/model-search.js +0 -15
- package/dist/modes/interactive/model-search.js.map +0 -1
- package/dist/modes/interactive/session-share.d.ts +0 -16
- package/dist/modes/interactive/session-share.d.ts.map +0 -1
- package/dist/modes/interactive/session-share.js +0 -184
- package/dist/modes/interactive/session-share.js.map +0 -1
- package/dist/modes/interactive/theme/dark.json +0 -91
- package/dist/modes/interactive/theme/light.json +0 -90
- package/dist/modes/interactive/theme/theme-controller.d.ts +0 -41
- package/dist/modes/interactive/theme/theme-controller.d.ts.map +0 -1
- package/dist/modes/interactive/theme/theme-controller.js +0 -130
- package/dist/modes/interactive/theme/theme-controller.js.map +0 -1
- package/dist/modes/interactive/theme/theme-json.d.ts +0 -84
- package/dist/modes/interactive/theme/theme-json.d.ts.map +0 -1
- package/dist/modes/interactive/theme/theme-json.js +0 -130
- package/dist/modes/interactive/theme/theme-json.js.map +0 -1
- package/dist/modes/interactive/theme/theme-schema.json +0 -356
- package/dist/modes/interactive/theme/theme.d.ts +0 -131
- package/dist/modes/interactive/theme/theme.d.ts.map +0 -1
- package/dist/modes/interactive/theme/theme.js.map +0 -1
- package/dist/modes/interactive/tui-renderer.d.ts +0 -21
- package/dist/modes/interactive/tui-renderer.d.ts.map +0 -1
- package/dist/modes/interactive/tui-renderer.js +0 -66
- package/dist/modes/interactive/tui-renderer.js.map +0 -1
- package/docs/development.md +0 -90
- package/examples/extensions/border-status-editor.ts +0 -145
- package/examples/extensions/built-in-tool-renderer.ts +0 -249
- package/examples/extensions/custom-footer.ts +0 -64
- package/examples/extensions/custom-header.ts +0 -73
- package/examples/extensions/doom-overlay/README.md +0 -46
- package/examples/extensions/doom-overlay/doom/build/doom.js +0 -21
- package/examples/extensions/doom-overlay/doom/build/doom.wasm +0 -0
- package/examples/extensions/doom-overlay/doom/build.sh +0 -152
- package/examples/extensions/doom-overlay/doom/doomgeneric_pi.c +0 -72
- package/examples/extensions/doom-overlay/doom-component.ts +0 -132
- package/examples/extensions/doom-overlay/doom-engine.ts +0 -173
- package/examples/extensions/doom-overlay/doom-keys.ts +0 -104
- package/examples/extensions/doom-overlay/index.ts +0 -74
- package/examples/extensions/doom-overlay/wad-finder.ts +0 -55
- package/examples/extensions/entry-renderer.ts +0 -41
- package/examples/extensions/github-issue-autocomplete.ts +0 -185
- package/examples/extensions/handoff.ts +0 -190
- package/examples/extensions/interactive-shell.ts +0 -196
- package/examples/extensions/kimi-deferred-tools.ts +0 -61
- package/examples/extensions/message-renderer.ts +0 -59
- package/examples/extensions/minimal-mode.ts +0 -426
- package/examples/extensions/modal-editor.ts +0 -85
- package/examples/extensions/overlay-qa-tests.ts +0 -1450
- package/examples/extensions/overlay-test.ts +0 -153
- package/examples/extensions/plan-mode/README.md +0 -66
- package/examples/extensions/plan-mode/index.ts +0 -390
- package/examples/extensions/plan-mode/utils.ts +0 -168
- package/examples/extensions/preset.ts +0 -436
- package/examples/extensions/qna.ts +0 -118
- package/examples/extensions/question.ts +0 -278
- package/examples/extensions/questionnaire.ts +0 -440
- package/examples/extensions/rainbow-editor.ts +0 -88
- package/examples/extensions/snake.ts +0 -343
- package/examples/extensions/space-invaders.ts +0 -560
- package/examples/extensions/structured-output.ts +0 -65
- package/examples/extensions/summarize.ts +0 -199
- package/examples/extensions/tic-tac-toe.ts +0 -1008
- package/examples/extensions/todo.ts +0 -297
- package/examples/extensions/tools.ts +0 -146
- package/examples/extensions/truncated-tool.ts +0 -195
- package/examples/plugins/pi-example-plugin/README.md +0 -38
- package/examples/plugins/pi-example-plugin/package.json +0 -10
- package/examples/plugins/pi-example-plugin/src/contract.ts +0 -13
- package/examples/plugins/pi-example-plugin/src/session.ts +0 -23
- package/examples/plugins/pi-example-plugin/src/tui.ts +0 -31
- package/examples/rpc-extension-ui.ts +0 -641
- /package/dist/bundle/chunks/{chunk-PATAL4PO.js → chunk-7ZC4UXSL.js} +0 -0
|
@@ -7,31 +7,37 @@
|
|
|
7
7
|
* - Register commands, keyboard shortcuts, and CLI flags
|
|
8
8
|
* - Interact with the user via UI primitives
|
|
9
9
|
*/
|
|
10
|
-
import type { AgentMessage, AgentToolResult, AgentToolUpdateCallback, ThinkingLevel, ToolExecutionMode } from "@punch-bot/agent";
|
|
11
|
-
import type { Api, AssistantMessageEvent, AssistantMessageEventStream, ConstrainedSamplingConfig,
|
|
12
|
-
import type { AutocompleteItem, AutocompleteProvider, Component, EditorComponent, EditorTheme, KeyId, OverlayHandle, OverlayOptions, TUI } from "@punch-bot/tui";
|
|
10
|
+
import type { AgentMessage, AgentTool, AgentToolCallOutcome, AgentToolResult, AgentToolUpdateCallback, ThinkingLevel, ToolExecutionMode } from "@punch-bot/agent";
|
|
11
|
+
import type { AnyModel, Api, AssistantMessageEvent, AssistantMessageEventStream, ClassifierApi, ConstrainedSamplingConfig, ImageApi, ImageContent, JsonValue, Message, Model, OAuthCredentials, OAuthLoginCallbacks, Provider, ProviderClassifier, ProviderHeaders, ProviderId, ProviderImages, RefreshModelsContext, SimpleStreamOptions, TextContent, ToolResultMessage, TranscriptContext, Usage } from "@punch-bot/ai";
|
|
13
12
|
import type { Static, TSchema } from "typebox";
|
|
14
|
-
import type { Theme } from "../../modes/interactive/theme/theme.ts";
|
|
15
13
|
import type { BashResult } from "../bash-executor.ts";
|
|
14
|
+
import type { CacheWarmingDecisionEvent, CacheWarmingDecisionEventResult } from "../cache-warmer.ts";
|
|
16
15
|
import type { CompactionPreparation, CompactionResult } from "../compaction/index.ts";
|
|
17
16
|
import type { EventBus } from "../event-bus.ts";
|
|
18
17
|
import type { ExecOptions, ExecResult } from "../exec.ts";
|
|
19
|
-
import type {
|
|
20
|
-
import type { KeybindingsManager } from "../keybindings.ts";
|
|
18
|
+
import type { McpServerConfig, McpServerRegistry, RegisteredMcpServer } from "../mcp-servers.ts";
|
|
21
19
|
import type { CustomMessage } from "../messages.ts";
|
|
22
20
|
import type { ModelRegistry } from "../model-registry.ts";
|
|
23
21
|
import type { ScopedModel } from "../model-resolver.ts";
|
|
24
|
-
import type { BranchSummaryEntry, CompactionEntry,
|
|
22
|
+
import type { BranchSummaryEntry, CompactionEntry, ContextEditEntry, ProjectedSessionEntry, ReadonlySessionManager, SessionEntry, SessionManager } from "../session-manager.ts";
|
|
23
|
+
import type { Settings } from "../settings-manager.ts";
|
|
25
24
|
import type { SlashCommandInfo } from "../slash-commands.ts";
|
|
26
25
|
import type { SourceInfo } from "../source-info.ts";
|
|
27
|
-
import type { BuildSystemPromptOptions } from "../system-prompt.ts";
|
|
26
|
+
import type { BuildSystemPromptOptions, NormalizedBuildSystemPromptOptions } from "../system-prompt.ts";
|
|
27
|
+
import type { Theme } from "../theme/theme.ts";
|
|
28
28
|
import type { BashOperations } from "../tools/bash.ts";
|
|
29
29
|
import type { EditToolDetails } from "../tools/edit.ts";
|
|
30
30
|
import type { BashToolDetails, BashToolInput, EditToolInput, FindToolDetails, FindToolInput, GrepToolDetails, GrepToolInput, LsToolDetails, LsToolInput, PowerShellToolDetails, PowerShellToolInput, ReadToolDetails, ReadToolInput, WriteToolInput } from "../tools/index.ts";
|
|
31
|
+
import type { ModelRoute, ModelRouteRequest, VirtualModelDefinition } from "../virtual-models.ts";
|
|
31
32
|
export type { ExecOptions, ExecResult } from "../exec.ts";
|
|
32
|
-
export type { BuildSystemPromptOptions } from "../system-prompt.ts";
|
|
33
|
+
export type { BuildSystemPromptOptions, NormalizedBuildSystemPromptOptions } from "../system-prompt.ts";
|
|
33
34
|
export type { AgentToolResult, AgentToolUpdateCallback, ToolExecutionMode };
|
|
34
|
-
export type
|
|
35
|
+
export type KeyId = string;
|
|
36
|
+
export interface AutocompleteItem {
|
|
37
|
+
value: string;
|
|
38
|
+
label?: string;
|
|
39
|
+
description?: string;
|
|
40
|
+
}
|
|
35
41
|
/** Options for extension UI dialogs. */
|
|
36
42
|
export interface ExtensionUIDialogOptions {
|
|
37
43
|
/** AbortSignal to programmatically dismiss the dialog. */
|
|
@@ -46,24 +52,16 @@ export interface ExtensionWidgetOptions {
|
|
|
46
52
|
/** Where the widget is rendered. Defaults to "aboveEditor". */
|
|
47
53
|
placement?: WidgetPlacement;
|
|
48
54
|
}
|
|
49
|
-
/**
|
|
50
|
-
export type TerminalInputHandler = (data: string) => {
|
|
51
|
-
consume?: boolean;
|
|
52
|
-
data?: string;
|
|
53
|
-
} | undefined;
|
|
54
|
-
/** Working indicator configuration for the interactive streaming loader. */
|
|
55
|
+
/** Working indicator configuration for streaming hosts that display one. */
|
|
55
56
|
export interface WorkingIndicatorOptions {
|
|
56
57
|
/** Animation frames. Use an empty array to hide the indicator entirely. Custom frames are rendered verbatim. */
|
|
57
58
|
frames?: string[];
|
|
58
59
|
/** Frame interval in milliseconds for animated indicators. */
|
|
59
60
|
intervalMs?: number;
|
|
60
61
|
}
|
|
61
|
-
/** Wrap the current autocomplete provider with additional behavior. */
|
|
62
|
-
export type AutocompleteProviderFactory = (current: AutocompleteProvider) => AutocompleteProvider;
|
|
63
|
-
export type EditorFactory = (tui: TUI, theme: EditorTheme, keybindings: KeybindingsManager) => EditorComponent;
|
|
64
62
|
/**
|
|
65
|
-
* UI context for extensions to request
|
|
66
|
-
*
|
|
63
|
+
* UI context for extensions to request user interaction.
|
|
64
|
+
* RPC and print modes provide their own implementations.
|
|
67
65
|
*/
|
|
68
66
|
export interface ExtensionUIContext {
|
|
69
67
|
/** Show a selector and return the user's choice. */
|
|
@@ -74,103 +72,28 @@ export interface ExtensionUIContext {
|
|
|
74
72
|
input(title: string, placeholder?: string, opts?: ExtensionUIDialogOptions): Promise<string | undefined>;
|
|
75
73
|
/** Show a notification to the user. */
|
|
76
74
|
notify(message: string, type?: "info" | "warning" | "error"): void;
|
|
77
|
-
/**
|
|
78
|
-
onTerminalInput(handler: TerminalInputHandler): () => void;
|
|
79
|
-
/** Set status text in the footer/status bar. Pass undefined to clear. */
|
|
75
|
+
/** Set status text. Pass undefined to clear. */
|
|
80
76
|
setStatus(key: string, text: string | undefined): void;
|
|
81
77
|
/** Set the working/loading message shown during streaming. Call with no argument to restore default. */
|
|
82
78
|
setWorkingMessage(message?: string): void;
|
|
83
|
-
/** Show or hide the
|
|
79
|
+
/** Show or hide the working indicator during streaming. */
|
|
84
80
|
setWorkingVisible(visible: boolean): void;
|
|
85
|
-
/**
|
|
86
|
-
* Configure the interactive working indicator shown during streaming.
|
|
87
|
-
*
|
|
88
|
-
* - Omit the argument to restore the default animated spinner.
|
|
89
|
-
* - Use `frames: ["●"]` for a static indicator.
|
|
90
|
-
* - Use `frames: []` to hide the indicator entirely.
|
|
91
|
-
* - Custom frames are rendered as provided, so extensions must add their own colors.
|
|
92
|
-
*/
|
|
81
|
+
/** Configure the working indicator shown during streaming. */
|
|
93
82
|
setWorkingIndicator(options?: WorkingIndicatorOptions): void;
|
|
94
83
|
/** Set the label shown for hidden thinking blocks. Call with no argument to restore default. */
|
|
95
84
|
setHiddenThinkingLabel(label?: string): void;
|
|
96
|
-
/** Set a widget
|
|
85
|
+
/** Set a widget of text lines. */
|
|
97
86
|
setWidget(key: string, content: string[] | undefined, options?: ExtensionWidgetOptions): void;
|
|
98
|
-
|
|
99
|
-
dispose?(): void;
|
|
100
|
-
}) | undefined, options?: ExtensionWidgetOptions): void;
|
|
101
|
-
/** Set a custom footer component, or undefined to restore the built-in footer.
|
|
102
|
-
*
|
|
103
|
-
* The factory receives a FooterDataProvider for data not otherwise accessible:
|
|
104
|
-
* git branch and extension statuses from setStatus(). Context usage is on
|
|
105
|
-
* ctx.getContextUsage(), token stats on ctx.sessionManager.getEntries(), model info on ctx.model.
|
|
106
|
-
*/
|
|
107
|
-
setFooter(factory: ((tui: TUI, theme: Theme, footerData: ReadonlyFooterDataProvider) => Component & {
|
|
108
|
-
dispose?(): void;
|
|
109
|
-
}) | undefined): void;
|
|
110
|
-
/** Set a custom header component (shown at startup, above chat), or undefined to restore the built-in header. */
|
|
111
|
-
setHeader(factory: ((tui: TUI, theme: Theme) => Component & {
|
|
112
|
-
dispose?(): void;
|
|
113
|
-
}) | undefined): void;
|
|
114
|
-
/** Set the terminal window/tab title. */
|
|
87
|
+
/** Set the window/tab title. */
|
|
115
88
|
setTitle(title: string): void;
|
|
116
|
-
/**
|
|
117
|
-
custom<T>(factory: (tui: TUI, theme: Theme, keybindings: KeybindingsManager, done: (result: T) => void) => (Component & {
|
|
118
|
-
dispose?(): void;
|
|
119
|
-
}) | Promise<Component & {
|
|
120
|
-
dispose?(): void;
|
|
121
|
-
}>, options?: {
|
|
122
|
-
overlay?: boolean;
|
|
123
|
-
/** Overlay positioning/sizing options. Can be static or a function for dynamic updates. */
|
|
124
|
-
overlayOptions?: OverlayOptions | (() => OverlayOptions);
|
|
125
|
-
/** Called with the overlay handle after the overlay is shown. Use to control visibility. */
|
|
126
|
-
onHandle?: (handle: OverlayHandle) => void;
|
|
127
|
-
}): Promise<T>;
|
|
128
|
-
/** Paste text into the editor, triggering paste handling (collapse for large content). */
|
|
89
|
+
/** Paste text into the host editor. */
|
|
129
90
|
pasteToEditor(text: string): void;
|
|
130
|
-
/** Set the text in the
|
|
91
|
+
/** Set the text in the host editor. */
|
|
131
92
|
setEditorText(text: string): void;
|
|
132
|
-
/** Get the current text from the
|
|
93
|
+
/** Get the current text from the host editor. */
|
|
133
94
|
getEditorText(): string;
|
|
134
95
|
/** Show a multi-line editor for text editing. */
|
|
135
96
|
editor(title: string, prefill?: string): Promise<string | undefined>;
|
|
136
|
-
/** Stack additional autocomplete behavior on top of the built-in provider. */
|
|
137
|
-
addAutocompleteProvider(factory: AutocompleteProviderFactory): void;
|
|
138
|
-
/**
|
|
139
|
-
* Set a custom editor component via factory function.
|
|
140
|
-
* Pass undefined to restore the default editor.
|
|
141
|
-
*
|
|
142
|
-
* The factory receives:
|
|
143
|
-
* - `theme`: EditorTheme for styling borders and autocomplete
|
|
144
|
-
* - `keybindings`: KeybindingsManager for app-level keybindings
|
|
145
|
-
*
|
|
146
|
-
* For full app keybinding support (escape, ctrl+d, model switching, etc.),
|
|
147
|
-
* extend `CustomEditor` from `@punch-bot/cli` and call
|
|
148
|
-
* `super.handleInput(data)` for keys you don't handle.
|
|
149
|
-
*
|
|
150
|
-
* @example
|
|
151
|
-
* ```ts
|
|
152
|
-
* import { CustomEditor } from "@punch-bot/cli";
|
|
153
|
-
*
|
|
154
|
-
* class VimEditor extends CustomEditor {
|
|
155
|
-
* private mode: "normal" | "insert" = "insert";
|
|
156
|
-
*
|
|
157
|
-
* handleInput(data: string): void {
|
|
158
|
-
* if (this.mode === "normal") {
|
|
159
|
-
* // Handle vim normal mode keys...
|
|
160
|
-
* if (data === "i") { this.mode = "insert"; return; }
|
|
161
|
-
* }
|
|
162
|
-
* super.handleInput(data); // App keybindings + text editing
|
|
163
|
-
* }
|
|
164
|
-
* }
|
|
165
|
-
*
|
|
166
|
-
* ctx.ui.setEditorComponent((tui, theme, keybindings) =>
|
|
167
|
-
* new VimEditor(tui, theme, keybindings)
|
|
168
|
-
* );
|
|
169
|
-
* ```
|
|
170
|
-
*/
|
|
171
|
-
setEditorComponent(factory: EditorFactory | undefined): void;
|
|
172
|
-
/** Get the currently configured custom editor factory, or undefined when using the default editor. */
|
|
173
|
-
getEditorComponent(): EditorFactory | undefined;
|
|
174
97
|
/** Get the current theme for styling. */
|
|
175
98
|
readonly theme: Theme;
|
|
176
99
|
/** Get all available themes with their names and file paths. */
|
|
@@ -247,6 +170,34 @@ export interface ExtensionContext {
|
|
|
247
170
|
/** Get the current effective system prompt. */
|
|
248
171
|
getSystemPrompt(): string;
|
|
249
172
|
}
|
|
173
|
+
/** Options for {@link ExtensionToolContext.executeTool}. */
|
|
174
|
+
export interface ExecuteToolOptions {
|
|
175
|
+
/** Defaults to the calling tool's signal. */
|
|
176
|
+
signal?: AbortSignal;
|
|
177
|
+
/** Receives partial results of the nested tool, in addition to `tool_execution_update` events. */
|
|
178
|
+
onUpdate?: AgentToolUpdateCallback;
|
|
179
|
+
}
|
|
180
|
+
/**
|
|
181
|
+
* Context passed to tool `execute()` in a session: the extension context plus `executeTool()`
|
|
182
|
+
* for running other tools through the same validation, hooks, and permission checks as
|
|
183
|
+
* model-issued calls.
|
|
184
|
+
*
|
|
185
|
+
* A tool wrapped with `wrapToolDefinition()` without a context factory, such as a built-in tool
|
|
186
|
+
* created with `createBashTool()` and run in a plain `Agent` or called directly, gets no context.
|
|
187
|
+
*/
|
|
188
|
+
export interface ExtensionToolContext extends ExtensionContext {
|
|
189
|
+
/** Tools {@link executeTool} can call. */
|
|
190
|
+
readonly tools: readonly AgentTool[];
|
|
191
|
+
/**
|
|
192
|
+
* Run another tool. The call gets the id `<calling id>/<n>`, and the `tool_call`, `tool_result`,
|
|
193
|
+
* and `tool_execution_*` events carry `parentToolCallId`. It does not appear in the transcript;
|
|
194
|
+
* a bounded record of it is kept as `nestedCalls` on the calling tool's result message.
|
|
195
|
+
*
|
|
196
|
+
* Never rejects for tool failures: unknown tools, validation errors, blocked calls, and thrown
|
|
197
|
+
* errors come back as `isError: true`.
|
|
198
|
+
*/
|
|
199
|
+
executeTool(name: string, args: unknown, options?: ExecuteToolOptions): Promise<AgentToolCallOutcome>;
|
|
200
|
+
}
|
|
250
201
|
/**
|
|
251
202
|
* Extended context for command handlers.
|
|
252
203
|
* Includes session control methods only safe in user-initiated commands.
|
|
@@ -304,44 +255,80 @@ export interface ReplacedSessionContext extends ExtensionCommandContext {
|
|
|
304
255
|
expandPromptTemplates?: boolean;
|
|
305
256
|
}): Promise<void>;
|
|
306
257
|
}
|
|
307
|
-
/**
|
|
308
|
-
|
|
309
|
-
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
|
|
317
|
-
|
|
318
|
-
|
|
319
|
-
|
|
320
|
-
|
|
321
|
-
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
/**
|
|
329
|
-
|
|
330
|
-
/**
|
|
331
|
-
|
|
332
|
-
/**
|
|
333
|
-
|
|
334
|
-
/**
|
|
335
|
-
|
|
336
|
-
|
|
337
|
-
|
|
338
|
-
|
|
339
|
-
|
|
258
|
+
/**
|
|
259
|
+
* How the model reaches a tool. "Callable" means callable from other tools through
|
|
260
|
+
* `ctx.executeTool()`, as the `codemode` tool does.
|
|
261
|
+
*
|
|
262
|
+
* - `direct`: declared to the model while active, and callable while active.
|
|
263
|
+
* - `model-only`: declared to the model while active, never callable. Use it for orchestrating or
|
|
264
|
+
* interactive tools.
|
|
265
|
+
* - `codemode`: callable whenever registered. Not declared to the model unless explicitly
|
|
266
|
+
* activated. Codemode tools list it in their description.
|
|
267
|
+
* - `deferred`: like `codemode`, but codemode tools do not list it; tool search can find it.
|
|
268
|
+
* - `hidden`: registered but unreachable. Activating it has no effect.
|
|
269
|
+
*
|
|
270
|
+
* `direct` and `model-only` tools are activated when they are registered; the others are not.
|
|
271
|
+
* The active tool set (`getActiveTools`/`setActiveTools`) is the set declared to the model.
|
|
272
|
+
*/
|
|
273
|
+
export type ToolExposure = "direct" | "model-only" | "codemode" | "deferred" | "hidden";
|
|
274
|
+
/**
|
|
275
|
+
* Hints about what a tool does, with the meaning of MCP tool annotations. They come from the tool's
|
|
276
|
+
* author and are not verified; permission extensions can use them to decide which calls to confirm.
|
|
277
|
+
*/
|
|
278
|
+
export interface ToolAnnotations {
|
|
279
|
+
/** The tool does not modify its environment. */
|
|
280
|
+
readOnlyHint?: boolean;
|
|
281
|
+
/** The tool may delete or overwrite data, rather than only add to it. Meaningful when not read-only. */
|
|
282
|
+
destructiveHint?: boolean;
|
|
283
|
+
/** Repeating a call with the same arguments has no further effect. Meaningful when not read-only. */
|
|
284
|
+
idempotentHint?: boolean;
|
|
285
|
+
/** The tool reaches an open world of external entities, such as the web, rather than a closed domain. */
|
|
286
|
+
openWorldHint?: boolean;
|
|
287
|
+
}
|
|
288
|
+
/** A group of related tools, such as the tools of one MCP server. Codemode tools list them together. */
|
|
289
|
+
export interface ToolNamespace {
|
|
290
|
+
/** For example `mcp__docs`. */
|
|
291
|
+
name: string;
|
|
292
|
+
/**
|
|
293
|
+
* Other names that refer to the namespace where tools look it up by name (codemode's
|
|
294
|
+
* `describeNamespace()` and the `namespace` option of `searchTools()`), for example `docs`.
|
|
295
|
+
*/
|
|
296
|
+
aliases?: readonly string[];
|
|
297
|
+
/** Short summary shown once with the group in model-facing tool listings. */
|
|
298
|
+
description?: string;
|
|
299
|
+
/**
|
|
300
|
+
* Longer usage guidance, such as MCP server instructions. Not part of tool listings; tools that
|
|
301
|
+
* describe the namespace on request (codemode's `describeNamespace()`) return it.
|
|
302
|
+
*/
|
|
303
|
+
instructions?: string;
|
|
304
|
+
}
|
|
305
|
+
/** The tools of a session as {@link ToolDefinition.prepareLoadout} sees them. */
|
|
306
|
+
export interface ToolLoadout {
|
|
307
|
+
/** Tools declared to the model (the active tools), in order, with their original descriptions. */
|
|
308
|
+
readonly declared: readonly AgentTool[];
|
|
309
|
+
/** Tools callable through `ctx.executeTool()`. */
|
|
310
|
+
readonly callable: readonly AgentTool[];
|
|
311
|
+
/** Every registered tool. */
|
|
312
|
+
readonly registered: readonly AgentTool[];
|
|
313
|
+
getExposure(name: string): ToolExposure;
|
|
314
|
+
getNamespace(name: string): ToolNamespace | undefined;
|
|
315
|
+
/** A tool's `promptGuidelines`. Hidden declarations leave them out of the system prompt. */
|
|
316
|
+
getPromptGuidelines(name: string): readonly string[];
|
|
317
|
+
}
|
|
318
|
+
/** Changes {@link ToolDefinition.prepareLoadout} makes to what the model sees. */
|
|
319
|
+
export interface ToolLoadoutChanges {
|
|
320
|
+
/** Model-facing descriptions of declared tools, by tool name. */
|
|
321
|
+
descriptions?: Readonly<Record<string, string>>;
|
|
322
|
+
/**
|
|
323
|
+
* Declared tools whose declarations requests leave out. They stay active and callable, and the
|
|
324
|
+
* transcript still declares them, so the active set survives `/tree` and resume.
|
|
325
|
+
*/
|
|
326
|
+
hiddenDeclarations?: readonly string[];
|
|
340
327
|
}
|
|
341
328
|
/**
|
|
342
329
|
* Tool definition for registerTool().
|
|
343
330
|
*/
|
|
344
|
-
export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = unknown,
|
|
331
|
+
export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = unknown, _TState = any> {
|
|
345
332
|
/** Tool name (used in LLM tool calls) */
|
|
346
333
|
name: string;
|
|
347
334
|
/** Human-readable label for UI */
|
|
@@ -356,10 +343,41 @@ export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = un
|
|
|
356
343
|
parameters: TParams;
|
|
357
344
|
/** Optional provider-side constrained sampling request for this tool. Set false to explicitly disable it, equivalent to leaving it undefined. */
|
|
358
345
|
constrainedSampling?: false | ConstrainedSamplingConfig;
|
|
359
|
-
/** Controls whether ToolExecutionComponent renders the standard colored shell or the tool renders its own framing. */
|
|
360
|
-
renderShell?: "default" | "self";
|
|
361
346
|
/** Optional compatibility shim to prepare raw tool call arguments before schema validation. Must return an object conforming to TParams. */
|
|
362
347
|
prepareArguments?: (args: unknown) => Static<TParams>;
|
|
348
|
+
/**
|
|
349
|
+
* JSON Schema of `structuredContent` in successful results. Tools that declare it should always
|
|
350
|
+
* set `structuredContent`; codemode scripts then receive it instead of the text content.
|
|
351
|
+
*/
|
|
352
|
+
outputSchema?: TSchema;
|
|
353
|
+
/**
|
|
354
|
+
* How the model reaches the tool. Default: `"direct"`. See {@link ToolExposure}.
|
|
355
|
+
*/
|
|
356
|
+
exposure?: ToolExposure;
|
|
357
|
+
/** Group the tool belongs to, for example its MCP server. */
|
|
358
|
+
namespace?: ToolNamespace;
|
|
359
|
+
/**
|
|
360
|
+
* For tools that reach other tools (such as `codemode`, which calls them, and `tool_search`, which
|
|
361
|
+
* loads them): which tools a call with `input` may reach. `"all"`, or the words of the input that
|
|
362
|
+
* may name them, where a word refers to a tool or namespace whose name it contains, so words may
|
|
363
|
+
* over-match. Extensions that register tools late, such as MCP servers that are still connecting,
|
|
364
|
+
* use it from their `tool_call` handler to finish registering those tools before the call runs.
|
|
365
|
+
*/
|
|
366
|
+
reachesTools?: (input: Record<string, unknown>) => "all" | readonly string[];
|
|
367
|
+
/** Hints about what the tool does, for example from an MCP server. */
|
|
368
|
+
annotations?: ToolAnnotations;
|
|
369
|
+
/**
|
|
370
|
+
* Whether registering the tool activates it. Default: `true` for `direct` and `model-only` tools;
|
|
371
|
+
* other exposures are never activated on registration. A tool with `defaultActive: false` is
|
|
372
|
+
* activated by naming it in `--tools` or the `defaultTools` setting, or with `setActiveTools()`.
|
|
373
|
+
*/
|
|
374
|
+
defaultActive?: boolean;
|
|
375
|
+
/**
|
|
376
|
+
* Adjust how the loadout is presented to the model while this tool is active. Called whenever
|
|
377
|
+
* the active tools change. Tools that orchestrate other tools use it, for example to list the
|
|
378
|
+
* callable tools in their own description.
|
|
379
|
+
*/
|
|
380
|
+
prepareLoadout?: (loadout: ToolLoadout) => ToolLoadoutChanges | undefined;
|
|
363
381
|
/**
|
|
364
382
|
* Per-tool execution mode override.
|
|
365
383
|
* - "sequential": this tool must execute one at a time with other tool calls.
|
|
@@ -369,11 +387,7 @@ export interface ToolDefinition<TParams extends TSchema = TSchema, TDetails = un
|
|
|
369
387
|
*/
|
|
370
388
|
executionMode?: ToolExecutionMode;
|
|
371
389
|
/** Execute the tool. */
|
|
372
|
-
execute(toolCallId: string, params: Static<TParams>, signal: AbortSignal | undefined, onUpdate: AgentToolUpdateCallback<TDetails> | undefined, ctx:
|
|
373
|
-
/** Custom rendering for tool call display */
|
|
374
|
-
renderCall?: (args: Static<TParams>, theme: Theme, context: ToolRenderContext<TState, Static<TParams>>) => Component;
|
|
375
|
-
/** Custom rendering for tool result display */
|
|
376
|
-
renderResult?: (result: AgentToolResult<TDetails>, options: ToolRenderResultOptions, theme: Theme, context: ToolRenderContext<TState, Static<TParams>>) => Component;
|
|
390
|
+
execute(toolCallId: string, params: Static<TParams>, signal: AbortSignal | undefined, onUpdate: AgentToolUpdateCallback<TDetails> | undefined, ctx: ExtensionToolContext): Promise<AgentToolResult<TDetails>>;
|
|
377
391
|
}
|
|
378
392
|
type AnyToolDefinition = ToolDefinition<any, any, any>;
|
|
379
393
|
/**
|
|
@@ -412,6 +426,17 @@ export interface ResourcesDiscoverResult {
|
|
|
412
426
|
promptPaths?: string[];
|
|
413
427
|
themePaths?: string[];
|
|
414
428
|
}
|
|
429
|
+
/**
|
|
430
|
+
* Fired when an extension registers or unregisters an MCP server after the extensions are bound
|
|
431
|
+
* (see {@link ExtensionAPI.registerMcpServer}). Servers registered while extensions load are read
|
|
432
|
+
* with `pi.getMcpServers()` on `session_start`. Handling this event marks an extension as the one
|
|
433
|
+
* that connects registered servers.
|
|
434
|
+
*/
|
|
435
|
+
export interface McpServersChangeEvent {
|
|
436
|
+
type: "mcp_servers_change";
|
|
437
|
+
/** Every registered server after the change. */
|
|
438
|
+
servers: RegisteredMcpServer[];
|
|
439
|
+
}
|
|
415
440
|
/** Fired when a session is started, loaded, or reloaded */
|
|
416
441
|
export interface SessionStartEvent {
|
|
417
442
|
type: "session_start";
|
|
@@ -510,11 +535,26 @@ export interface SessionTreeEvent {
|
|
|
510
535
|
fromExtension?: boolean;
|
|
511
536
|
}
|
|
512
537
|
export type SessionEvent = SessionStartEvent | SessionInfoChangedEvent | SessionBeforeSwitchEvent | SessionBeforeForkEvent | SessionBeforeCompactEvent | SessionCompactEvent | SessionCompactFailedEvent | SessionShutdownEvent | SessionBeforeTreeEvent | SessionTreeEvent;
|
|
513
|
-
/**
|
|
538
|
+
/**
|
|
539
|
+
* Fired before each LLM call. Can modify messages.
|
|
540
|
+
*
|
|
541
|
+
* `messages` holds the conversation without system messages. The prompt and tool state
|
|
542
|
+
* belong to Pi: it restores them after the handler returns, so a handler cannot drop
|
|
543
|
+
* them and does not need to preserve them.
|
|
544
|
+
*/
|
|
514
545
|
export interface ContextEvent {
|
|
515
546
|
type: "context";
|
|
516
547
|
messages: AgentMessage[];
|
|
517
548
|
}
|
|
549
|
+
/**
|
|
550
|
+
* Fired before each LLM call, after every `context` handler has run and Pi has restored
|
|
551
|
+
* the prompt and tool state. `messages` is the full transcript including system messages,
|
|
552
|
+
* and the result is sent as returned: the handler owns the prompt and tool declarations.
|
|
553
|
+
*/
|
|
554
|
+
export interface ContextWithSystemEvent {
|
|
555
|
+
type: "context_with_system";
|
|
556
|
+
messages: AgentMessage[];
|
|
557
|
+
}
|
|
518
558
|
/** Fired before a provider request is sent. Can replace the payload. */
|
|
519
559
|
export interface BeforeProviderRequestEvent {
|
|
520
560
|
type: "before_provider_request";
|
|
@@ -535,18 +575,37 @@ export interface AfterProviderResponseEvent {
|
|
|
535
575
|
status: number;
|
|
536
576
|
headers: Record<string, string>;
|
|
537
577
|
}
|
|
538
|
-
/** Fired
|
|
539
|
-
export interface
|
|
578
|
+
/** Fired for a parsed provider stream event before Pi normalizes it. */
|
|
579
|
+
export interface ProviderStreamEvent {
|
|
580
|
+
type: "provider_stream_event";
|
|
581
|
+
provider: ProviderId;
|
|
582
|
+
api: Api;
|
|
583
|
+
model: string;
|
|
584
|
+
data: unknown;
|
|
585
|
+
}
|
|
586
|
+
interface BeforeAgentStartEventBase {
|
|
540
587
|
type: "before_agent_start";
|
|
588
|
+
/** The current system prompt, rendered from systemPromptOptions and earlier handler changes. */
|
|
589
|
+
readonly systemPrompt: string;
|
|
590
|
+
/** Mutable prompt sections. Later handlers observe mutations made by earlier handlers. */
|
|
591
|
+
systemPromptOptions: NormalizedBuildSystemPromptOptions;
|
|
592
|
+
}
|
|
593
|
+
/** A run started by a submitted prompt, RPC prompt, or `pi.sendUserMessage()`. */
|
|
594
|
+
export interface BeforeAgentStartUserEvent extends BeforeAgentStartEventBase {
|
|
595
|
+
messageType: "user";
|
|
541
596
|
/** The raw user prompt text (after expansion). */
|
|
542
597
|
prompt: string;
|
|
543
598
|
/** Images attached to the user prompt, if any. */
|
|
544
599
|
images?: ImageContent[];
|
|
545
|
-
/** The fully assembled system prompt string. */
|
|
546
|
-
systemPrompt: string;
|
|
547
|
-
/** Structured options used to build the system prompt. Extensions can inspect this to understand what Pi loaded without re-discovering resources. */
|
|
548
|
-
systemPromptOptions: BuildSystemPromptOptions;
|
|
549
600
|
}
|
|
601
|
+
/** A run started by `pi.sendMessage(..., { triggerTurn: true })` while idle. */
|
|
602
|
+
export interface BeforeAgentStartCustomEvent extends BeforeAgentStartEventBase {
|
|
603
|
+
messageType: "custom";
|
|
604
|
+
/** The custom message that starts the run. */
|
|
605
|
+
message: CustomMessage;
|
|
606
|
+
}
|
|
607
|
+
/** Fired before a run starts from a user message or an idle custom message with `triggerTurn`. */
|
|
608
|
+
export type BeforeAgentStartEvent = BeforeAgentStartUserEvent | BeforeAgentStartCustomEvent;
|
|
550
609
|
/** Fired when an agent loop starts */
|
|
551
610
|
export interface AgentStartEvent {
|
|
552
611
|
type: "agent_start";
|
|
@@ -556,9 +615,59 @@ export interface AgentEndEvent {
|
|
|
556
615
|
type: "agent_end";
|
|
557
616
|
messages: AgentMessage[];
|
|
558
617
|
}
|
|
618
|
+
export type AgentActivityOutcome = "completed" | "aborted" | "error";
|
|
619
|
+
export interface CustomEntryDraft {
|
|
620
|
+
type: "custom";
|
|
621
|
+
customType: string;
|
|
622
|
+
data?: unknown;
|
|
623
|
+
}
|
|
624
|
+
export interface CustomMessageEntryDraft {
|
|
625
|
+
type: "custom_message";
|
|
626
|
+
customType: string;
|
|
627
|
+
content: string | (TextContent | ImageContent)[];
|
|
628
|
+
display: boolean;
|
|
629
|
+
details?: unknown;
|
|
630
|
+
}
|
|
631
|
+
export interface ContextEditEntryDraft {
|
|
632
|
+
type: "context_edit";
|
|
633
|
+
targetId: string;
|
|
634
|
+
replacement: ContextEditEntry["replacement"];
|
|
635
|
+
}
|
|
636
|
+
export interface CompactionEntryDraft {
|
|
637
|
+
type: "compaction";
|
|
638
|
+
summary: string;
|
|
639
|
+
/** Null creates a self-retaining compaction that keeps no preceding entries. */
|
|
640
|
+
firstKeptEntryId: string | null;
|
|
641
|
+
details?: unknown;
|
|
642
|
+
usage?: Usage;
|
|
643
|
+
}
|
|
644
|
+
export type SessionBoundaryDraft = CustomEntryDraft | CustomMessageEntryDraft | ContextEditEntryDraft | CompactionEntryDraft;
|
|
645
|
+
export interface BoundaryContextPreview {
|
|
646
|
+
contextEntries: ProjectedSessionEntry[];
|
|
647
|
+
contextMessages: AgentMessage[];
|
|
648
|
+
llmMessages: Message[];
|
|
649
|
+
pendingMessages: AgentMessage[];
|
|
650
|
+
canContinue: boolean;
|
|
651
|
+
}
|
|
652
|
+
export interface BoundaryState {
|
|
653
|
+
entries: SessionBoundaryDraft[];
|
|
654
|
+
continue: boolean;
|
|
655
|
+
context: BoundaryContextPreview;
|
|
656
|
+
outcome: AgentActivityOutcome;
|
|
657
|
+
}
|
|
658
|
+
export interface BoundaryResult {
|
|
659
|
+
entries?: SessionBoundaryDraft[];
|
|
660
|
+
continue?: boolean;
|
|
661
|
+
}
|
|
662
|
+
/** Fired before final settlement. May append entries and ensure one next provider request. */
|
|
663
|
+
export interface AgentBeforeSettleEvent extends BoundaryState {
|
|
664
|
+
type: "agent_before_settle";
|
|
665
|
+
}
|
|
559
666
|
/** Fired after an agent run has fully settled and no automatic retry, compaction, or queued continuation will run. */
|
|
560
667
|
export interface AgentSettledEvent {
|
|
561
668
|
type: "agent_settled";
|
|
669
|
+
/** Whether the run ended because it was aborted, for example with Escape. */
|
|
670
|
+
aborted: boolean;
|
|
562
671
|
}
|
|
563
672
|
export type UIPromptKind = "select" | "confirm" | "input" | "editor" | "custom";
|
|
564
673
|
/** Fired when Pi starts waiting on a blocking user-facing extension UI prompt. */
|
|
@@ -582,11 +691,13 @@ export interface TurnStartEvent {
|
|
|
582
691
|
timestamp: number;
|
|
583
692
|
}
|
|
584
693
|
/** Fired at the end of each turn */
|
|
585
|
-
export interface TurnEndEvent {
|
|
694
|
+
export interface TurnEndEvent extends BoundaryState {
|
|
586
695
|
type: "turn_end";
|
|
587
696
|
turnIndex: number;
|
|
588
697
|
message: AgentMessage;
|
|
589
698
|
toolResults: ToolResultMessage[];
|
|
699
|
+
messageEntryId: string;
|
|
700
|
+
toolResultEntryIds: string[];
|
|
590
701
|
}
|
|
591
702
|
/** Fired when a message starts (user, assistant, or toolResult) */
|
|
592
703
|
export interface MessageStartEvent {
|
|
@@ -610,6 +721,8 @@ export interface ToolExecutionStartEvent {
|
|
|
610
721
|
toolCallId: string;
|
|
611
722
|
toolName: string;
|
|
612
723
|
args: any;
|
|
724
|
+
/** Set when another tool (for example a codemode script) made this call. */
|
|
725
|
+
parentToolCallId?: string;
|
|
613
726
|
}
|
|
614
727
|
/** Fired during tool execution with partial/streaming output */
|
|
615
728
|
export interface ToolExecutionUpdateEvent {
|
|
@@ -618,6 +731,8 @@ export interface ToolExecutionUpdateEvent {
|
|
|
618
731
|
toolName: string;
|
|
619
732
|
args: any;
|
|
620
733
|
partialResult: any;
|
|
734
|
+
/** Set when another tool (for example a codemode script) made this call. */
|
|
735
|
+
parentToolCallId?: string;
|
|
621
736
|
}
|
|
622
737
|
/** Fired when a tool finishes executing */
|
|
623
738
|
export interface ToolExecutionEndEvent {
|
|
@@ -626,6 +741,10 @@ export interface ToolExecutionEndEvent {
|
|
|
626
741
|
toolName: string;
|
|
627
742
|
result: any;
|
|
628
743
|
isError: boolean;
|
|
744
|
+
/** Milliseconds `execute()` took, measured with a monotonic clock; absent when the tool did not run. */
|
|
745
|
+
durationMs?: number;
|
|
746
|
+
/** Set when another tool (for example a codemode script) made this call. */
|
|
747
|
+
parentToolCallId?: string;
|
|
629
748
|
}
|
|
630
749
|
export type ModelSelectSource = "set" | "cycle" | "restore";
|
|
631
750
|
/** Fired when a new model is selected */
|
|
@@ -677,7 +796,14 @@ export type InputEventResult = {
|
|
|
677
796
|
};
|
|
678
797
|
interface ToolCallEventBase {
|
|
679
798
|
type: "tool_call";
|
|
799
|
+
/**
|
|
800
|
+
* The call's id. For calls another tool made (with `parentToolCallId` set), pi assigns
|
|
801
|
+
* `<parent id>/<n>`; such ids never appear as tool calls or tool results in the transcript, only
|
|
802
|
+
* in the parent result's `nestedCalls` record.
|
|
803
|
+
*/
|
|
680
804
|
toolCallId: string;
|
|
805
|
+
/** Set when another tool (for example a codemode script) issued this call. */
|
|
806
|
+
parentToolCallId?: string;
|
|
681
807
|
}
|
|
682
808
|
export interface BashToolCallEvent extends ToolCallEventBase {
|
|
683
809
|
toolName: "bash";
|
|
@@ -724,9 +850,17 @@ export interface CustomToolCallEvent extends ToolCallEventBase {
|
|
|
724
850
|
export type ToolCallEvent = BashToolCallEvent | PowerShellToolCallEvent | ReadToolCallEvent | EditToolCallEvent | WriteToolCallEvent | GrepToolCallEvent | FindToolCallEvent | LsToolCallEvent | CustomToolCallEvent;
|
|
725
851
|
interface ToolResultEventBase {
|
|
726
852
|
type: "tool_result";
|
|
853
|
+
/** The call's id; `<parent id>/<n>` for nested calls, see `ToolCallEvent`. */
|
|
727
854
|
toolCallId: string;
|
|
855
|
+
/** Set when another tool (for example a codemode script) issued this call. */
|
|
856
|
+
parentToolCallId?: string;
|
|
728
857
|
input: Record<string, unknown>;
|
|
729
858
|
content: (TextContent | ImageContent)[];
|
|
859
|
+
/**
|
|
860
|
+
* Machine-readable result for tools that declare an `outputSchema`. Handlers that redact
|
|
861
|
+
* `content` should also replace this; replacing `content` alone drops it.
|
|
862
|
+
*/
|
|
863
|
+
structuredContent?: JsonValue;
|
|
730
864
|
isError: boolean;
|
|
731
865
|
/** Usage from the tool execution itself, if available. */
|
|
732
866
|
usage?: Usage;
|
|
@@ -810,11 +944,14 @@ export declare function isToolCallEventType<TName extends string, TInput extends
|
|
|
810
944
|
input: TInput;
|
|
811
945
|
};
|
|
812
946
|
/** Union of all event types */
|
|
813
|
-
export type ExtensionEvent = ProjectTrustEvent | ResourcesDiscoverEvent | SessionEvent | ContextEvent | BeforeProviderRequestEvent | BeforeProviderHeadersEvent | AfterProviderResponseEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | AgentSettledEvent | UIPromptStartEvent | UIPromptEndEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | ModelSelectEvent | ThinkingLevelSelectEvent | UserBashEvent | InputEvent | ToolCallEvent | ToolResultEvent;
|
|
947
|
+
export type ExtensionEvent = ProjectTrustEvent | ResourcesDiscoverEvent | McpServersChangeEvent | SessionEvent | ContextEvent | ContextWithSystemEvent | CacheWarmingDecisionEvent | BeforeProviderRequestEvent | BeforeProviderHeadersEvent | AfterProviderResponseEvent | ProviderStreamEvent | BeforeAgentStartEvent | AgentStartEvent | AgentEndEvent | AgentBeforeSettleEvent | AgentSettledEvent | UIPromptStartEvent | UIPromptEndEvent | TurnStartEvent | TurnEndEvent | MessageStartEvent | MessageUpdateEvent | MessageEndEvent | ToolExecutionStartEvent | ToolExecutionUpdateEvent | ToolExecutionEndEvent | ModelSelectEvent | ThinkingLevelSelectEvent | UserBashEvent | InputEvent | ToolCallEvent | ToolResultEvent;
|
|
814
948
|
export interface ContextEventResult {
|
|
815
949
|
messages?: AgentMessage[];
|
|
816
950
|
}
|
|
951
|
+
export type TurnEndEventResult = BoundaryResult;
|
|
952
|
+
export type AgentBeforeSettleEventResult = BoundaryResult;
|
|
817
953
|
export type BeforeProviderRequestEventResult = unknown;
|
|
954
|
+
export type { CacheWarmingDecisionEvent, CacheWarmingDecisionEventResult } from "../cache-warmer.ts";
|
|
818
955
|
export interface ToolCallEventResult {
|
|
819
956
|
/** Block tool execution. To modify arguments, mutate `event.input` in place instead. */
|
|
820
957
|
block?: boolean;
|
|
@@ -826,15 +963,24 @@ export interface ToolCallEventResult {
|
|
|
826
963
|
terminate?: boolean;
|
|
827
964
|
}
|
|
828
965
|
/** Result from user_bash event handler */
|
|
829
|
-
export
|
|
966
|
+
export type UserBashEventResult = {
|
|
830
967
|
/** Custom operations to use for execution */
|
|
831
|
-
operations
|
|
968
|
+
operations: BashOperations;
|
|
969
|
+
result?: never;
|
|
970
|
+
} | {
|
|
971
|
+
operations?: never;
|
|
832
972
|
/** Full replacement: extension handled execution, use this result */
|
|
833
|
-
result
|
|
834
|
-
}
|
|
973
|
+
result: BashResult;
|
|
974
|
+
};
|
|
975
|
+
/**
|
|
976
|
+
* Changes a `tool_result` handler makes. Omitted fields stay as they are, except that replacing
|
|
977
|
+
* `content` without returning `structuredContent` drops the structured content, because it may no
|
|
978
|
+
* longer match. Return it along with `content` to keep it.
|
|
979
|
+
*/
|
|
835
980
|
export interface ToolResultEventResult {
|
|
836
981
|
content?: (TextContent | ImageContent)[];
|
|
837
982
|
details?: unknown;
|
|
983
|
+
structuredContent?: JsonValue;
|
|
838
984
|
isError?: boolean;
|
|
839
985
|
usage?: Usage;
|
|
840
986
|
}
|
|
@@ -844,7 +990,7 @@ export interface MessageEndEventResult {
|
|
|
844
990
|
}
|
|
845
991
|
export interface BeforeAgentStartEventResult {
|
|
846
992
|
message?: Pick<CustomMessage, "customType" | "content" | "display" | "details">;
|
|
847
|
-
/** Replace the system prompt for this turn.
|
|
993
|
+
/** Replace the complete system prompt for this turn. Later handlers observe this exact override. */
|
|
848
994
|
systemPrompt?: string;
|
|
849
995
|
}
|
|
850
996
|
export interface SessionBeforeSwitchResult {
|
|
@@ -872,22 +1018,6 @@ export interface SessionBeforeTreeResult {
|
|
|
872
1018
|
/** Override label to attach to the branch summary entry */
|
|
873
1019
|
label?: string;
|
|
874
1020
|
}
|
|
875
|
-
export interface MessageRenderOptions {
|
|
876
|
-
expanded: boolean;
|
|
877
|
-
/** Horizontal padding configured by the outputPad setting. */
|
|
878
|
-
outputPad: number;
|
|
879
|
-
}
|
|
880
|
-
export interface MarkdownTransformContext {
|
|
881
|
-
messageType: "user" | "assistant" | "assistant-thinking";
|
|
882
|
-
isStreaming: boolean;
|
|
883
|
-
availableWidth: number;
|
|
884
|
-
}
|
|
885
|
-
export type MarkdownTransformer = (markdown: string, context: MarkdownTransformContext) => string;
|
|
886
|
-
export interface EntryRenderOptions {
|
|
887
|
-
expanded: boolean;
|
|
888
|
-
}
|
|
889
|
-
export type MessageRenderer<T = unknown> = (message: CustomMessage<T>, options: MessageRenderOptions, theme: Theme) => Component | undefined;
|
|
890
|
-
export type EntryRenderer<T = unknown> = (entry: CustomEntry<T>, options: EntryRenderOptions, theme: Theme) => Component | undefined;
|
|
891
1021
|
export interface RegisteredCommand {
|
|
892
1022
|
name: string;
|
|
893
1023
|
sourceInfo: SourceInfo;
|
|
@@ -904,42 +1034,47 @@ export type ExtensionHandler<E, R = undefined> = (event: E, ctx: ExtensionContex
|
|
|
904
1034
|
* ExtensionAPI passed to extension factory functions.
|
|
905
1035
|
*/
|
|
906
1036
|
export interface ExtensionAPI {
|
|
907
|
-
on(event: "project_trust", handler: ProjectTrustHandler): void;
|
|
908
|
-
on(event: "resources_discover", handler: ExtensionHandler<ResourcesDiscoverEvent, ResourcesDiscoverResult>): void;
|
|
909
|
-
on(event: "session_start", handler: ExtensionHandler<SessionStartEvent>): void;
|
|
910
|
-
on(event: "session_info_changed", handler: ExtensionHandler<SessionInfoChangedEvent>): void;
|
|
911
|
-
on(event: "session_before_switch", handler: ExtensionHandler<SessionBeforeSwitchEvent, SessionBeforeSwitchResult>): void;
|
|
912
|
-
on(event: "session_before_fork", handler: ExtensionHandler<SessionBeforeForkEvent, SessionBeforeForkResult>): void;
|
|
913
|
-
on(event: "session_before_compact", handler: ExtensionHandler<SessionBeforeCompactEvent, SessionBeforeCompactResult>): void;
|
|
914
|
-
on(event: "session_compact", handler: ExtensionHandler<SessionCompactEvent>): void;
|
|
915
|
-
on(event: "session_compact_failed", handler: ExtensionHandler<SessionCompactFailedEvent>): void;
|
|
916
|
-
on(event: "session_shutdown", handler: ExtensionHandler<SessionShutdownEvent>): void;
|
|
917
|
-
on(event: "
|
|
918
|
-
on(event: "
|
|
919
|
-
on(event: "
|
|
920
|
-
on(event: "
|
|
921
|
-
on(event: "
|
|
922
|
-
on(event: "
|
|
923
|
-
on(event: "
|
|
924
|
-
on(event: "
|
|
925
|
-
on(event: "
|
|
926
|
-
on(event: "
|
|
927
|
-
on(event: "
|
|
928
|
-
on(event: "
|
|
929
|
-
on(event: "
|
|
930
|
-
on(event: "
|
|
931
|
-
on(event: "
|
|
932
|
-
on(event: "
|
|
933
|
-
on(event: "
|
|
934
|
-
on(event: "
|
|
935
|
-
on(event: "
|
|
936
|
-
on(event: "
|
|
937
|
-
on(event: "
|
|
938
|
-
on(event: "
|
|
939
|
-
on(event: "
|
|
940
|
-
on(event: "
|
|
941
|
-
on(event: "
|
|
942
|
-
on(event: "
|
|
1037
|
+
on(event: "project_trust", handler: ProjectTrustHandler): () => void;
|
|
1038
|
+
on(event: "resources_discover", handler: ExtensionHandler<ResourcesDiscoverEvent, ResourcesDiscoverResult>): () => void;
|
|
1039
|
+
on(event: "session_start", handler: ExtensionHandler<SessionStartEvent>): () => void;
|
|
1040
|
+
on(event: "session_info_changed", handler: ExtensionHandler<SessionInfoChangedEvent>): () => void;
|
|
1041
|
+
on(event: "session_before_switch", handler: ExtensionHandler<SessionBeforeSwitchEvent, SessionBeforeSwitchResult>): () => void;
|
|
1042
|
+
on(event: "session_before_fork", handler: ExtensionHandler<SessionBeforeForkEvent, SessionBeforeForkResult>): () => void;
|
|
1043
|
+
on(event: "session_before_compact", handler: ExtensionHandler<SessionBeforeCompactEvent, SessionBeforeCompactResult>): () => void;
|
|
1044
|
+
on(event: "session_compact", handler: ExtensionHandler<SessionCompactEvent>): () => void;
|
|
1045
|
+
on(event: "session_compact_failed", handler: ExtensionHandler<SessionCompactFailedEvent>): () => void;
|
|
1046
|
+
on(event: "session_shutdown", handler: ExtensionHandler<SessionShutdownEvent>): () => void;
|
|
1047
|
+
on(event: "mcp_servers_change", handler: ExtensionHandler<McpServersChangeEvent>): () => void;
|
|
1048
|
+
on(event: "session_before_tree", handler: ExtensionHandler<SessionBeforeTreeEvent, SessionBeforeTreeResult>): () => void;
|
|
1049
|
+
on(event: "session_tree", handler: ExtensionHandler<SessionTreeEvent>): () => void;
|
|
1050
|
+
on(event: "context", handler: ExtensionHandler<ContextEvent, ContextEventResult>): () => void;
|
|
1051
|
+
on(event: "context_with_system", handler: ExtensionHandler<ContextWithSystemEvent, ContextEventResult>): () => void;
|
|
1052
|
+
on(event: "cache_warming_decision", handler: ExtensionHandler<CacheWarmingDecisionEvent, CacheWarmingDecisionEventResult>): () => void;
|
|
1053
|
+
on(event: "before_provider_request", handler: ExtensionHandler<BeforeProviderRequestEvent, BeforeProviderRequestEventResult>): () => void;
|
|
1054
|
+
on(event: "before_provider_headers", handler: ExtensionHandler<BeforeProviderHeadersEvent>): () => void;
|
|
1055
|
+
on(event: "after_provider_response", handler: ExtensionHandler<AfterProviderResponseEvent>): () => void;
|
|
1056
|
+
on(event: "provider_stream_event", handler: ExtensionHandler<ProviderStreamEvent>): () => void;
|
|
1057
|
+
on(event: "before_agent_start", handler: ExtensionHandler<BeforeAgentStartEvent, BeforeAgentStartEventResult>): () => void;
|
|
1058
|
+
on(event: "agent_start", handler: ExtensionHandler<AgentStartEvent>): () => void;
|
|
1059
|
+
on(event: "agent_end", handler: ExtensionHandler<AgentEndEvent>): () => void;
|
|
1060
|
+
on(event: "agent_before_settle", handler: ExtensionHandler<AgentBeforeSettleEvent, AgentBeforeSettleEventResult>): () => void;
|
|
1061
|
+
on(event: "agent_settled", handler: ExtensionHandler<AgentSettledEvent>): () => void;
|
|
1062
|
+
on(event: "ui_prompt_start", handler: ExtensionHandler<UIPromptStartEvent>): () => void;
|
|
1063
|
+
on(event: "ui_prompt_end", handler: ExtensionHandler<UIPromptEndEvent>): () => void;
|
|
1064
|
+
on(event: "turn_start", handler: ExtensionHandler<TurnStartEvent>): () => void;
|
|
1065
|
+
on(event: "turn_end", handler: ExtensionHandler<TurnEndEvent, TurnEndEventResult>): () => void;
|
|
1066
|
+
on(event: "message_start", handler: ExtensionHandler<MessageStartEvent>): () => void;
|
|
1067
|
+
on(event: "message_update", handler: ExtensionHandler<MessageUpdateEvent>): () => void;
|
|
1068
|
+
on(event: "message_end", handler: ExtensionHandler<MessageEndEvent, MessageEndEventResult>): () => void;
|
|
1069
|
+
on(event: "tool_execution_start", handler: ExtensionHandler<ToolExecutionStartEvent>): () => void;
|
|
1070
|
+
on(event: "tool_execution_update", handler: ExtensionHandler<ToolExecutionUpdateEvent>): () => void;
|
|
1071
|
+
on(event: "tool_execution_end", handler: ExtensionHandler<ToolExecutionEndEvent>): () => void;
|
|
1072
|
+
on(event: "model_select", handler: ExtensionHandler<ModelSelectEvent>): () => void;
|
|
1073
|
+
on(event: "thinking_level_select", handler: ExtensionHandler<ThinkingLevelSelectEvent>): () => void;
|
|
1074
|
+
on(event: "tool_call", handler: ExtensionHandler<ToolCallEvent, ToolCallEventResult>): () => void;
|
|
1075
|
+
on(event: "tool_result", handler: ExtensionHandler<ToolResultEvent, ToolResultEventResult>): () => void;
|
|
1076
|
+
on(event: "user_bash", handler: ExtensionHandler<UserBashEvent, UserBashEventResult>): () => void;
|
|
1077
|
+
on(event: "input", handler: ExtensionHandler<InputEvent, InputEventResult>): () => void;
|
|
943
1078
|
/** Register a tool that the LLM can call. */
|
|
944
1079
|
registerTool<TParams extends TSchema = TSchema, TDetails = unknown, TState = any>(tool: ToolDefinition<TParams, TDetails, TState>): void;
|
|
945
1080
|
/** Register a custom command. */
|
|
@@ -961,12 +1096,6 @@ export interface ExtensionAPI {
|
|
|
961
1096
|
}): void;
|
|
962
1097
|
/** Get the value of a registered CLI flag. */
|
|
963
1098
|
getFlag(name: string): boolean | string | undefined;
|
|
964
|
-
/** Register a custom renderer for CustomMessageEntry. */
|
|
965
|
-
registerMessageRenderer<T = unknown>(customType: string, renderer: MessageRenderer<T>): void;
|
|
966
|
-
/** Register a transformer for user and assistant Markdown before Pi renders it in the interactive transcript. */
|
|
967
|
-
registerMarkdownTransformer(transformer: MarkdownTransformer): void;
|
|
968
|
-
/** Register a custom renderer for CustomEntry. Custom entries do not participate in LLM context. */
|
|
969
|
-
registerEntryRenderer<T = unknown>(customType: string, renderer: EntryRenderer<T>): void;
|
|
970
1099
|
/** Send a custom message to the session. */
|
|
971
1100
|
sendMessage<T = unknown>(message: Pick<CustomMessage<T>, "customType" | "content" | "display" | "details">, options?: {
|
|
972
1101
|
triggerTurn?: boolean;
|
|
@@ -991,11 +1120,16 @@ export interface ExtensionAPI {
|
|
|
991
1120
|
setLabel(entryId: string, label: string | undefined): void;
|
|
992
1121
|
/** Execute a shell command. */
|
|
993
1122
|
exec(command: string, args: string[], options?: ExecOptions): Promise<ExecResult>;
|
|
994
|
-
/** Get the
|
|
1123
|
+
/** Get the names of the active tools, which are the tools declared to the model. */
|
|
995
1124
|
getActiveTools(): string[];
|
|
996
|
-
/** Get all configured tools with parameter schema, prompt guidelines, and source metadata. */
|
|
1125
|
+
/** Get all configured tools with parameter schema, prompt guidelines, exposure, and source metadata. */
|
|
997
1126
|
getAllTools(): ToolInfo[];
|
|
998
|
-
/**
|
|
1127
|
+
/** Get a copy of the effective settings (global and project settings merged, with overrides). */
|
|
1128
|
+
getSettings(): Settings;
|
|
1129
|
+
/**
|
|
1130
|
+
* Set the active tools by name. Unknown and `hidden` tools are ignored. Tools with `codemode` or
|
|
1131
|
+
* `deferred` exposure stay callable from codemode scripts whether active or not.
|
|
1132
|
+
*/
|
|
999
1133
|
setActiveTools(toolNames: string[]): void;
|
|
1000
1134
|
/** Get available slash commands in the current session. */
|
|
1001
1135
|
getCommands(): SlashCommandInfo[];
|
|
@@ -1079,9 +1213,45 @@ export interface ExtensionAPI {
|
|
|
1079
1213
|
* pi.unregisterProvider("my-proxy");
|
|
1080
1214
|
*/
|
|
1081
1215
|
unregisterProvider(name: string): void;
|
|
1216
|
+
/**
|
|
1217
|
+
* Register an MCP server for this session, with the same config as an `mcpServers` entry in
|
|
1218
|
+
* `mcp.json`. The server connects next to the configured servers: on `session_start` when
|
|
1219
|
+
* registered during extension load, right away when registered later. Registering a name again
|
|
1220
|
+
* replaces the extension's earlier registration.
|
|
1221
|
+
*
|
|
1222
|
+
* The registration is not saved; register again on every load. A server of the same name in
|
|
1223
|
+
* `mcp.json` takes precedence. Throws for invalid configs and for names another extension
|
|
1224
|
+
* registered. When no loaded extension handles MCP servers (for example because another MCP
|
|
1225
|
+
* extension replaced the built-in one), the registration is reported as an extension error.
|
|
1226
|
+
*
|
|
1227
|
+
* @example
|
|
1228
|
+
* pi.registerMcpServer("jira", { url: "https://mcp.example.com/jira" });
|
|
1229
|
+
*/
|
|
1230
|
+
registerMcpServer(name: string, config: McpServerConfig): void;
|
|
1231
|
+
/** Remove an MCP server this extension registered and close its connection. */
|
|
1232
|
+
unregisterMcpServer(name: string): void;
|
|
1233
|
+
/** Every MCP server registered by extensions. For extensions that connect MCP servers. */
|
|
1234
|
+
getMcpServers(): RegisteredMcpServer[];
|
|
1235
|
+
/**
|
|
1236
|
+
* Register a virtual model: a selectable catalog entry that routes each request to a physical
|
|
1237
|
+
* model. The selection (`ctx.model`, `model_change` entries) names the virtual model; assistant
|
|
1238
|
+
* messages record the physical model and thinking level the router picked.
|
|
1239
|
+
*
|
|
1240
|
+
* `provider` may be any provider id, including one with physical models, and may list several
|
|
1241
|
+
* virtual models. Registering the same provider and id again replaces the virtual model. See
|
|
1242
|
+
* docs/virtual-models.md.
|
|
1243
|
+
*/
|
|
1244
|
+
registerVirtualModel<TState = unknown>(model: ExtensionVirtualModel<TState>): void;
|
|
1245
|
+
/** Remove a virtual model registered with `registerVirtualModel()`. */
|
|
1246
|
+
unregisterVirtualModel(provider: string, id: string): void;
|
|
1082
1247
|
/** Shared event bus for extension communication. */
|
|
1083
1248
|
events: EventBus;
|
|
1084
1249
|
}
|
|
1250
|
+
/** Virtual model registered via pi.registerVirtualModel(). */
|
|
1251
|
+
export interface ExtensionVirtualModel<TState = unknown> extends Omit<VirtualModelDefinition<TState>, "route"> {
|
|
1252
|
+
/** Like `VirtualModelDefinition.route`, with an extension context. */
|
|
1253
|
+
route(request: ModelRouteRequest<TState>, ctx: ExtensionContext): ModelRoute<TState> | Promise<ModelRoute<TState>>;
|
|
1254
|
+
}
|
|
1085
1255
|
/** Configuration for registering a provider via pi.registerProvider(). */
|
|
1086
1256
|
export interface ProviderConfig {
|
|
1087
1257
|
/** Display name for the provider in UI. */
|
|
@@ -1094,11 +1264,19 @@ export interface ProviderConfig {
|
|
|
1094
1264
|
api?: Api;
|
|
1095
1265
|
/**
|
|
1096
1266
|
* Optional streamSimple handler for custom APIs.
|
|
1267
|
+
* The context is a normalized transcript: read the prompt and tools from its system messages
|
|
1268
|
+
* (`getCurrentSystemPrompt(context.messages)`, `getCurrentTools(context.messages)`).
|
|
1097
1269
|
* Implementations must invoke `options.onPayload` before sending the provider request and use any
|
|
1098
1270
|
* returned replacement payload. They must invoke `options.onResponse` after receiving the response
|
|
1099
|
-
* and before consuming its body, matching built-in providers.
|
|
1271
|
+
* and before consuming its body, matching built-in providers. Implementations may invoke
|
|
1272
|
+
* `options.onProviderStreamEvent(data, model)` with parsed stream events before normalization.
|
|
1273
|
+
* Event data is adapter-owned and must be treated as read-only.
|
|
1100
1274
|
*/
|
|
1101
|
-
streamSimple?: (model: Model<Api>, context:
|
|
1275
|
+
streamSimple?: (model: Model<Api>, context: TranscriptContext, options?: SimpleStreamOptions) => AssistantMessageEventStream;
|
|
1276
|
+
/** Image-generation implementations keyed by image API. */
|
|
1277
|
+
images?: Partial<Record<ImageApi, ProviderImages>>;
|
|
1278
|
+
/** Classifier implementations keyed by classifier API. */
|
|
1279
|
+
classifiers?: Partial<Record<ClassifierApi, ProviderClassifier>>;
|
|
1102
1280
|
/** Custom headers to include in requests. */
|
|
1103
1281
|
headers?: Record<string, string>;
|
|
1104
1282
|
/** If true, adds Authorization: Bearer header with the resolved API key. */
|
|
@@ -1128,41 +1306,84 @@ export interface ProviderConfig {
|
|
|
1128
1306
|
modifyModels?(models: Model<Api>[], credentials: OAuthCredentials): Model<Api>[];
|
|
1129
1307
|
};
|
|
1130
1308
|
}
|
|
1131
|
-
|
|
1132
|
-
|
|
1133
|
-
/** Model ID (e.g., "claude-sonnet-4-20250514"). */
|
|
1309
|
+
interface ProviderModelConfigBase {
|
|
1310
|
+
/** Model ID. */
|
|
1134
1311
|
id: string;
|
|
1135
|
-
/** Display name
|
|
1312
|
+
/** Display name. */
|
|
1136
1313
|
name: string;
|
|
1137
1314
|
/** API type override for this model. */
|
|
1138
|
-
api?:
|
|
1315
|
+
api?: string;
|
|
1139
1316
|
/** API endpoint URL override for this model. */
|
|
1140
1317
|
baseUrl?: string;
|
|
1318
|
+
/** Supported input types. */
|
|
1319
|
+
input: ("text" | "image")[];
|
|
1320
|
+
/** Provider input limits and cache-safe image preprocessing metadata. */
|
|
1321
|
+
inputLimits?: AnyModel["inputLimits"];
|
|
1322
|
+
/** Per-million-token cost rates and optional request-wide input pricing tiers. */
|
|
1323
|
+
cost: AnyModel["cost"];
|
|
1324
|
+
/** Custom headers for this model. */
|
|
1325
|
+
headers?: Record<string, string>;
|
|
1326
|
+
}
|
|
1327
|
+
/** Chat model configuration. Omitted `type` is normalized to `"chat"`. */
|
|
1328
|
+
export interface ProviderChatModelConfig extends ProviderModelConfigBase {
|
|
1329
|
+
type?: "chat";
|
|
1330
|
+
api?: Api;
|
|
1141
1331
|
/** Whether the model supports extended thinking. */
|
|
1142
1332
|
reasoning: boolean;
|
|
1143
1333
|
/** Maps pi thinking levels to provider/model-specific values; null marks a level unsupported. */
|
|
1144
1334
|
thinkingLevelMap?: Model<Api>["thinkingLevelMap"];
|
|
1145
|
-
/**
|
|
1146
|
-
|
|
1147
|
-
/** Per-million-token cost rates and optional request-wide input pricing tiers. */
|
|
1148
|
-
cost: Model<Api>["cost"];
|
|
1335
|
+
/** Best-effort prompt cache lifetime in seconds per retention tier. Unset disables cache warming. */
|
|
1336
|
+
promptCache?: Model<Api>["promptCache"];
|
|
1149
1337
|
/** Maximum context window size in tokens. */
|
|
1150
1338
|
contextWindow: number;
|
|
1151
1339
|
/** Maximum output tokens. */
|
|
1152
1340
|
maxTokens: number;
|
|
1153
|
-
|
|
1154
|
-
headers?: Record<string, string>;
|
|
1341
|
+
samplingParams?: Record<string, unknown>;
|
|
1155
1342
|
/** OpenAI compatibility settings. */
|
|
1156
1343
|
compat?: Model<Api>["compat"];
|
|
1157
1344
|
}
|
|
1345
|
+
/** Image-generation model configuration. */
|
|
1346
|
+
export interface ProviderImageModelConfig extends ProviderModelConfigBase {
|
|
1347
|
+
type: "image";
|
|
1348
|
+
api?: ImageApi;
|
|
1349
|
+
output: ("text" | "image")[];
|
|
1350
|
+
}
|
|
1351
|
+
/** Structured classifier model configuration. */
|
|
1352
|
+
export interface ProviderClassifierModelConfig extends ProviderModelConfigBase {
|
|
1353
|
+
type: "classifier";
|
|
1354
|
+
api?: ClassifierApi;
|
|
1355
|
+
contextWindow: number;
|
|
1356
|
+
}
|
|
1357
|
+
/** Configuration for a model within a provider. */
|
|
1358
|
+
export type ProviderModelConfig = ProviderChatModelConfig | ProviderImageModelConfig | ProviderClassifierModelConfig;
|
|
1158
1359
|
/** Extension factory function type. Supports both sync and async initialization. */
|
|
1159
1360
|
export type ExtensionFactory = (pi: ExtensionAPI) => void | Promise<void>;
|
|
1160
1361
|
export type InlineExtension = ExtensionFactory | {
|
|
1161
|
-
/**
|
|
1362
|
+
/**
|
|
1363
|
+
* Display name shown as `<inline:name>` in the startup Extensions list and errors. With
|
|
1364
|
+
* `builtin`, the extension is named `builtin:name` in errors and diagnostics.
|
|
1365
|
+
*/
|
|
1162
1366
|
name: string;
|
|
1163
1367
|
factory: ExtensionFactory;
|
|
1164
1368
|
/** Omit this extension from the startup Extensions list. */
|
|
1165
1369
|
hidden?: boolean;
|
|
1370
|
+
/**
|
|
1371
|
+
* Leave this extension out when another extension registers a tool, command, or flag with a
|
|
1372
|
+
* name it registers during loading, instead of reporting a conflict. The CLI's built-in MCP,
|
|
1373
|
+
* codemode, and tool search extensions use it, so for example an MCP extension that registers
|
|
1374
|
+
* `/mcp` replaces the built-in MCP support. The factory still runs, so it should only register
|
|
1375
|
+
* tools, commands, flags, and event handlers.
|
|
1376
|
+
*/
|
|
1377
|
+
replaceable?: boolean;
|
|
1378
|
+
/**
|
|
1379
|
+
* Supply the code of the `builtin:<name>` extension instead of loading as an inline extension.
|
|
1380
|
+
* `builtin:<name>` is an extension resource like a file: it loads by default, `pi config` lists
|
|
1381
|
+
* it, `-builtin:<name>` in the `extensions` setting and `--no-extensions` disable it, and
|
|
1382
|
+
* `-e builtin:<name>` loads it explicitly. It is hidden from the startup Extensions list and
|
|
1383
|
+
* loads after project trust is resolved, so it cannot handle `project_trust`. The CLI's built-in
|
|
1384
|
+
* extensions use it.
|
|
1385
|
+
*/
|
|
1386
|
+
builtin?: boolean;
|
|
1166
1387
|
};
|
|
1167
1388
|
export interface RegisteredTool {
|
|
1168
1389
|
definition: ToolDefinition;
|
|
@@ -1195,10 +1416,14 @@ export type SetSessionNameHandler = (name: string) => void;
|
|
|
1195
1416
|
export type GetSessionNameHandler = () => string | undefined;
|
|
1196
1417
|
export type GetActiveToolsHandler = () => string[];
|
|
1197
1418
|
/** Tool info with name, description, parameter schema, prompt guidelines, and source metadata. */
|
|
1198
|
-
export type ToolInfo = Pick<ToolDefinition, "name" | "description" | "parameters" | "promptGuidelines"> & {
|
|
1419
|
+
export type ToolInfo = Pick<ToolDefinition, "name" | "description" | "parameters" | "promptGuidelines" | "reachesTools"> & {
|
|
1420
|
+
exposure: ToolExposure;
|
|
1421
|
+
namespace?: ToolNamespace;
|
|
1422
|
+
annotations?: ToolAnnotations;
|
|
1199
1423
|
sourceInfo: SourceInfo;
|
|
1200
1424
|
};
|
|
1201
1425
|
export type GetAllToolsHandler = () => ToolInfo[];
|
|
1426
|
+
export type GetSettingsHandler = () => Settings;
|
|
1202
1427
|
export type GetCommandsHandler = () => SlashCommandInfo[];
|
|
1203
1428
|
export type SetActiveToolsHandler = (toolNames: string[]) => void;
|
|
1204
1429
|
export type RefreshToolsHandler = () => void;
|
|
@@ -1223,6 +1448,13 @@ export interface ExtensionRuntimeState {
|
|
|
1223
1448
|
provider: Provider;
|
|
1224
1449
|
extensionPath: string;
|
|
1225
1450
|
}>;
|
|
1451
|
+
/** Virtual model registrations queued during extension loading, processed when runner binds. */
|
|
1452
|
+
pendingVirtualModelRegistrations: Array<{
|
|
1453
|
+
definition: VirtualModelDefinition;
|
|
1454
|
+
extensionPath: string;
|
|
1455
|
+
}>;
|
|
1456
|
+
/** Create an extension context. Throws before the runner binds. */
|
|
1457
|
+
createContext: () => ExtensionContext;
|
|
1226
1458
|
/** Throws when this extension instance is stale after runtime replacement. */
|
|
1227
1459
|
assertActive: () => void;
|
|
1228
1460
|
/** Marks this extension instance as stale after runtime replacement or reload. */
|
|
@@ -1238,6 +1470,10 @@ export interface ExtensionRuntimeState {
|
|
|
1238
1470
|
registerProvider: (name: string, config: ProviderConfig, extensionPath?: string) => void;
|
|
1239
1471
|
registerNativeProvider: (provider: Provider, extensionPath?: string) => void;
|
|
1240
1472
|
unregisterProvider: (name: string, extensionPath?: string) => void;
|
|
1473
|
+
/** Servers registered with `pi.registerMcpServer()`. */
|
|
1474
|
+
mcpServers: McpServerRegistry;
|
|
1475
|
+
registerVirtualModel: (definition: VirtualModelDefinition, extensionPath?: string) => void;
|
|
1476
|
+
unregisterVirtualModel: (provider: string, id: string) => void;
|
|
1241
1477
|
}
|
|
1242
1478
|
/**
|
|
1243
1479
|
* Action implementations for pi.* API methods.
|
|
@@ -1252,6 +1488,7 @@ export interface ExtensionActions {
|
|
|
1252
1488
|
setLabel: SetLabelHandler;
|
|
1253
1489
|
getActiveTools: GetActiveToolsHandler;
|
|
1254
1490
|
getAllTools: GetAllToolsHandler;
|
|
1491
|
+
getSettings: GetSettingsHandler;
|
|
1255
1492
|
setActiveTools: SetActiveToolsHandler;
|
|
1256
1493
|
refreshTools: RefreshToolsHandler;
|
|
1257
1494
|
getCommands: GetCommandsHandler;
|
|
@@ -1276,6 +1513,10 @@ export interface ExtensionContextActions {
|
|
|
1276
1513
|
compact: (options?: CompactOptions) => void;
|
|
1277
1514
|
getSystemPrompt: () => string;
|
|
1278
1515
|
getSystemPromptOptions?: () => BuildSystemPromptOptions;
|
|
1516
|
+
/** Backs `ExtensionToolContext.executeTool()`. Without it, nested calls fail. */
|
|
1517
|
+
executeTool?: (callerId: string, name: string, args: unknown, options: ExecuteToolOptions) => Promise<AgentToolCallOutcome>;
|
|
1518
|
+
/** Backs `ExtensionToolContext.tools`. */
|
|
1519
|
+
getCallableTools?: () => readonly AgentTool[];
|
|
1279
1520
|
}
|
|
1280
1521
|
/**
|
|
1281
1522
|
* Actions for ExtensionCommandContext (ctx.* in command handlers).
|
|
@@ -1322,12 +1563,11 @@ export interface Extension {
|
|
|
1322
1563
|
path: string;
|
|
1323
1564
|
resolvedPath: string;
|
|
1324
1565
|
hidden?: boolean;
|
|
1566
|
+
/** See {@link InlineExtension}. */
|
|
1567
|
+
replaceable?: boolean;
|
|
1325
1568
|
sourceInfo: SourceInfo;
|
|
1326
1569
|
handlers: Map<string, HandlerFn[]>;
|
|
1327
1570
|
tools: Map<string, RegisteredTool>;
|
|
1328
|
-
messageRenderers: Map<string, MessageRenderer>;
|
|
1329
|
-
markdownTransformer?: MarkdownTransformer;
|
|
1330
|
-
entryRenderers?: Map<string, EntryRenderer>;
|
|
1331
1571
|
commands: Map<string, RegisteredCommand>;
|
|
1332
1572
|
flags: Map<string, ExtensionFlag>;
|
|
1333
1573
|
shortcuts: Map<KeyId, ExtensionShortcut>;
|
|
@@ -1339,6 +1579,10 @@ export interface LoadExtensionsResult {
|
|
|
1339
1579
|
path: string;
|
|
1340
1580
|
error: string;
|
|
1341
1581
|
}>;
|
|
1582
|
+
warnings?: Array<{
|
|
1583
|
+
path: string;
|
|
1584
|
+
warning: string;
|
|
1585
|
+
}>;
|
|
1342
1586
|
/** Shared runtime - actions are throwing stubs until runner.initialize() */
|
|
1343
1587
|
runtime: ExtensionRuntime;
|
|
1344
1588
|
}
|