@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
|
@@ -0,0 +1,286 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The `codemode` tool: the model writes JavaScript that calls other tools. Scripts use `tools`,
|
|
3
|
+
* `ALL_TOOLS`, `text()`, `image()`, `exit()`, `store()`/`load()`, `console.*`, and `return <value>`,
|
|
4
|
+
* may start with a `// @options:` line, and reach the model catalog, classifiers, and image models
|
|
5
|
+
* through `models.*`. Results start with a "Script completed" or "Script failed" header.
|
|
6
|
+
*
|
|
7
|
+
* Scripts can call the agent loop's nested tools: active `direct` tools and every `codemode` or
|
|
8
|
+
* `deferred` tool. Nested calls run through the agent loop's tool pipeline (`ctx.executeTool`), so
|
|
9
|
+
* validation, `tool_call`/`tool_result` hooks, and permission checks apply exactly as for direct
|
|
10
|
+
* calls. Only the script's output reaches the model; nested results do not.
|
|
11
|
+
*
|
|
12
|
+
* Nested results are handed to the script as follows:
|
|
13
|
+
* - A tool that declares `outputSchema` resolves to its `structuredContent`, also for error
|
|
14
|
+
* results that carry one.
|
|
15
|
+
* - Any other tool resolves to its text content as one string.
|
|
16
|
+
* - A failed, blocked, or invalid call rejects with an Error carrying the tool's error text.
|
|
17
|
+
*
|
|
18
|
+
* A script that fails returns a normal error result that keeps its partial output, followed by
|
|
19
|
+
* "Script error:" and the error. `store(key, value)` and `load(key)` keep JSON values across
|
|
20
|
+
* calls; successful scripts append their writes to the session as `codemode-store` custom entries,
|
|
21
|
+
* so each branch sees the values written on its own path.
|
|
22
|
+
*/
|
|
23
|
+
import { join } from "node:path";
|
|
24
|
+
import { renderToolOutputType, renderToolSample, toCodemodeIdentifier } from "@punch-bot/codemode/declarations";
|
|
25
|
+
import { CODEMODE_SOURCE_GRAMMAR } from "@punch-bot/codemode/source";
|
|
26
|
+
import { Type } from "typebox";
|
|
27
|
+
import { getDocsPath } from "../../config.js";
|
|
28
|
+
import { SETTINGS_DEFAULTS } from "../../core/settings-defaults.js";
|
|
29
|
+
import { wrapToolDefinition } from "../../core/tools/tool-definition-wrapper.js";
|
|
30
|
+
import { loadCodemodeExecutor } from "./execute.lazy.js";
|
|
31
|
+
export const CODEMODE_TOOL_NAME = "codemode";
|
|
32
|
+
/** Custom entry type holding one script's `store()` writes: {@link CodemodeStoreEntryData}. */
|
|
33
|
+
export const CODEMODE_STORE_ENTRY_TYPE = "codemode-store";
|
|
34
|
+
const TEXT_OUTPUT_SCHEMA = { type: "string" };
|
|
35
|
+
export const codemodeSchema = Type.Object({
|
|
36
|
+
code: Type.String({
|
|
37
|
+
description: "Raw JavaScript source.",
|
|
38
|
+
}),
|
|
39
|
+
});
|
|
40
|
+
export const codemodeToolSystemPromptContribution = {
|
|
41
|
+
snippet: "Run JavaScript that calls other tools",
|
|
42
|
+
guidelines: [
|
|
43
|
+
"Use codemode to batch independent tool calls (Promise.allSettled), chain them, or filter large output, instead of many separate calls.",
|
|
44
|
+
],
|
|
45
|
+
};
|
|
46
|
+
/** The reference for scripts: globals, tool results, `store()`, the `models` API, and limits. */
|
|
47
|
+
export const CODEMODE_DOCS_PATH = join(getDocsPath(), "codemode.md");
|
|
48
|
+
const DESCRIPTION_INTRO = `Run JavaScript that calls other tools. The input is raw JavaScript (not JSON, no code fence), run as an async function body in a QuickJS sandbox: top-level \`await\` and \`return\` work. No Node, file system, network, or timers.
|
|
49
|
+
- \`await tools.<name>({ ...args })\` resolves to a string, or an object if the tool's declaration says so, and rejects with an Error on failure. A tool whose declaration returns an object resolves on failure too when it returned that object; check its fields. Calls still running when the script ends are cancelled.
|
|
50
|
+
- Optional first line: \`// @options: {"max_output_tokens": 10000, "timeout_ms": 60000}\``;
|
|
51
|
+
/** One line per global. The details live in {@link CODEMODE_DOCS_PATH}. */
|
|
52
|
+
function describeGlobals(models) {
|
|
53
|
+
const lines = [
|
|
54
|
+
"Globals:",
|
|
55
|
+
"- `text(value)`, `image(dataUrlOrImageBlock)`, `console.log(...)`, and top-level `return` add output; `exit()` ends the script. With several text items, each starts with a `==> text N/M <==` line, and `console` lines follow the other output in one `<console_output>` block. `image()` also saves the image to a temp file and the result names its path.",
|
|
56
|
+
"- `store(key, value)` and `load(key)` keep JSON values across codemode calls.",
|
|
57
|
+
"- `ALL_TOOLS`, `await searchTools(query, { limit?, namespace? })`, `await describeTool(name)`, `await describeNamespace(name)`: find unlisted tools, such as MCP tools.",
|
|
58
|
+
];
|
|
59
|
+
if (models) {
|
|
60
|
+
lines.push(`- \`models\`: classifiers and image generation. Read ${CODEMODE_DOCS_PATH} first.`);
|
|
61
|
+
}
|
|
62
|
+
return lines.join("\n");
|
|
63
|
+
}
|
|
64
|
+
/** Default for {@link CodemodeDescriptionOptions.inlineBudget}, in estimated tokens. */
|
|
65
|
+
export const DEFAULT_CODEMODE_INLINE_BUDGET = SETTINGS_DEFAULTS.codemode.inlineBudget;
|
|
66
|
+
/** Characters per token when estimating the cost of a tool section. */
|
|
67
|
+
const CHARS_PER_TOKEN = 4;
|
|
68
|
+
/**
|
|
69
|
+
* What a script sees of a tool: its description followed by its prompt guidelines, which the system
|
|
70
|
+
* prompt only has for declared tools. Tools without an output schema resolve to their text output.
|
|
71
|
+
*/
|
|
72
|
+
export function toCodemodeDeclaration(tool, guidelines = []) {
|
|
73
|
+
const bullets = guidelines.flatMap((guideline) => (guideline.trim() ? [`- ${guideline.trim()}`] : []));
|
|
74
|
+
return {
|
|
75
|
+
name: tool.name,
|
|
76
|
+
description: bullets.length > 0 ? `${tool.description.trim()}\n\n${bullets.join("\n")}` : tool.description,
|
|
77
|
+
inputSchema: tool.parameters,
|
|
78
|
+
outputSchema: tool.outputSchema ?? TEXT_OUTPUT_SCHEMA,
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
/** Tools a script may call: every given tool except the codemode tool itself. */
|
|
82
|
+
export function getCodemodeCallableTools(tools) {
|
|
83
|
+
return tools.filter((tool) => tool.name !== CODEMODE_TOOL_NAME);
|
|
84
|
+
}
|
|
85
|
+
/** `### \`id\` (\`raw name\`)` followed by the tool's description and declaration. */
|
|
86
|
+
function renderToolSection(declaration) {
|
|
87
|
+
const id = toCodemodeIdentifier(declaration.name);
|
|
88
|
+
const heading = id === declaration.name ? `### \`${id}\`` : `### \`${id}\` (\`${declaration.name}\`)`;
|
|
89
|
+
return `${heading}\n${renderToolSample(declaration).trim()}`;
|
|
90
|
+
}
|
|
91
|
+
/**
|
|
92
|
+
* Pick the tool sections that fit the budget, like OpenCode's catalog: in each round every group
|
|
93
|
+
* (tools without a namespace first, then namespaces by name) places its cheapest remaining tool; a
|
|
94
|
+
* group whose next tool does not fit drops out while the others continue. Every namespace is
|
|
95
|
+
* represented before any namespace is complete.
|
|
96
|
+
*/
|
|
97
|
+
function selectCatalog(groups, budget) {
|
|
98
|
+
if (budget === undefined)
|
|
99
|
+
return new Set(groups.flatMap((group) => group.entries.map((entry) => entry.name)));
|
|
100
|
+
const queues = groups.map((group) => [...group.entries].sort((a, b) => a.cost - b.cost));
|
|
101
|
+
const shown = new Set();
|
|
102
|
+
let remaining = budget;
|
|
103
|
+
let active = queues.filter((queue) => queue.length > 0);
|
|
104
|
+
while (active.length > 0) {
|
|
105
|
+
active = active.filter((queue) => {
|
|
106
|
+
const next = queue[0];
|
|
107
|
+
if (next.cost > remaining)
|
|
108
|
+
return false;
|
|
109
|
+
remaining -= next.cost;
|
|
110
|
+
shown.add(next.name);
|
|
111
|
+
queue.shift();
|
|
112
|
+
return queue.length > 0;
|
|
113
|
+
});
|
|
114
|
+
}
|
|
115
|
+
return shown;
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* Model-facing description: the helper list, guidance for finding tools that are not listed, the
|
|
119
|
+
* `models` API, and one section per listed tool, grouped by namespace. Deferred tools are never
|
|
120
|
+
* listed and do not affect the description at all, so it stays the same while tools are registered
|
|
121
|
+
* late (for example by MCP servers that connect). Tool sections are limited to `inlineBudget`.
|
|
122
|
+
*/
|
|
123
|
+
export function createCodemodeDescription(tools, options = {}) {
|
|
124
|
+
const declarations = getCodemodeCallableTools(tools)
|
|
125
|
+
.filter((tool) => !options.deferred?.has(tool.name))
|
|
126
|
+
.map((tool) => toCodemodeDeclaration(tool, options.guidelines?.get(tool.name)));
|
|
127
|
+
const groups = new Map([["", { namespace: undefined, entries: [] }]]);
|
|
128
|
+
for (const declaration of declarations) {
|
|
129
|
+
const namespace = options.namespaces?.get(declaration.name);
|
|
130
|
+
const key = namespace ? `ns:${namespace.name}` : "";
|
|
131
|
+
const group = groups.get(key) ?? { namespace, entries: [] };
|
|
132
|
+
groups.set(key, group);
|
|
133
|
+
const section = renderToolSection(declaration);
|
|
134
|
+
group.entries.push({ name: declaration.name, section, cost: Math.ceil(section.length / CHARS_PER_TOKEN) });
|
|
135
|
+
}
|
|
136
|
+
const ordered = [...groups.values()].sort((a, b) => a.namespace === undefined ? -1 : b.namespace === undefined ? 1 : a.namespace.name.localeCompare(b.namespace.name));
|
|
137
|
+
const shown = selectCatalog(ordered, options.inlineBudget);
|
|
138
|
+
const sections = [DESCRIPTION_INTRO, describeGlobals(options.models === true)];
|
|
139
|
+
if (declarations.length === 0)
|
|
140
|
+
return sections.join("\n\n");
|
|
141
|
+
const toolSections = ["Nested tools:"];
|
|
142
|
+
for (const { namespace, entries } of ordered) {
|
|
143
|
+
const visible = entries.filter((entry) => shown.has(entry.name));
|
|
144
|
+
if (namespace) {
|
|
145
|
+
// Only tools that did not fit the budget are counted as not listed here.
|
|
146
|
+
const listing = visible.length === entries.length
|
|
147
|
+
? ""
|
|
148
|
+
: visible.length === 0
|
|
149
|
+
? " (tools not listed)"
|
|
150
|
+
: " (some tools not listed)";
|
|
151
|
+
const description = namespace.description?.trim();
|
|
152
|
+
toolSections.push(`## ${namespace.name}${listing}${description ? `\n${description}` : ""}`);
|
|
153
|
+
}
|
|
154
|
+
for (const entry of visible)
|
|
155
|
+
toolSections.push(entry.section);
|
|
156
|
+
}
|
|
157
|
+
sections.push(toolSections.join("\n\n"));
|
|
158
|
+
return sections.join("\n\n");
|
|
159
|
+
}
|
|
160
|
+
/**
|
|
161
|
+
* The field names of an object schema, `{ output, exit_code, full_output_path? }`, with the fields of
|
|
162
|
+
* object-typed fields `depth` levels deep: `{ content, structuredContent?: { results } }`. Undefined
|
|
163
|
+
* for other schemas.
|
|
164
|
+
*/
|
|
165
|
+
function describeFields(schema, depth) {
|
|
166
|
+
if (typeof schema !== "object" || schema === null)
|
|
167
|
+
return undefined;
|
|
168
|
+
const { type, properties, required } = schema;
|
|
169
|
+
if (type !== "object" || typeof properties !== "object" || properties === null)
|
|
170
|
+
return undefined;
|
|
171
|
+
const requiredNames = new Set(Array.isArray(required) ? required : []);
|
|
172
|
+
const fields = Object.entries(properties).map(([name, field]) => {
|
|
173
|
+
const nested = depth > 0 ? describeFields(field, depth - 1) : undefined;
|
|
174
|
+
return `${name}${requiredNames.has(name) ? "" : "?"}${nested ? `: ${nested}` : ""}`;
|
|
175
|
+
});
|
|
176
|
+
return `{ ${fields.join(", ")} }`;
|
|
177
|
+
}
|
|
178
|
+
/**
|
|
179
|
+
* What a script call resolves to, in one line: `a string`, the field names of an object (see
|
|
180
|
+
* {@link describeFields}), or the rendered type for anything else.
|
|
181
|
+
*/
|
|
182
|
+
function describeOutput(schema) {
|
|
183
|
+
const type = renderToolOutputType(schema);
|
|
184
|
+
if (type === "string")
|
|
185
|
+
return "a string";
|
|
186
|
+
const fields = describeFields(schema, 1);
|
|
187
|
+
return `\`${fields ?? type.replace(/\s+/g, " ")}\``;
|
|
188
|
+
}
|
|
189
|
+
/**
|
|
190
|
+
* A declared tool's description followed by how scripts call it and what the call resolves to. The
|
|
191
|
+
* arguments are the tool's declared parameters, so they are not repeated.
|
|
192
|
+
*/
|
|
193
|
+
function describeScriptCall(tool) {
|
|
194
|
+
return `${tool.description.trim()}\n\nCodemode: \`tools.${toCodemodeIdentifier(tool.name)}(args)\` resolves to ${describeOutput(toCodemodeDeclaration(tool).outputSchema)}.`;
|
|
195
|
+
}
|
|
196
|
+
/**
|
|
197
|
+
* How the codemode tool presents tools that are both declared and callable from scripts:
|
|
198
|
+
* - `on`: their descriptions say how scripts call them, and the codemode description
|
|
199
|
+
* lists only the callable tools without `direct` exposure.
|
|
200
|
+
* - `only`: the codemode description lists every callable tool, and requests leave out the
|
|
201
|
+
* declarations of active `direct` tools.
|
|
202
|
+
*
|
|
203
|
+
* Listed tools carry their prompt guidelines, which the system prompt only has for declared tools.
|
|
204
|
+
*
|
|
205
|
+
* Listing by exposure, not by the active set, keeps the codemode description unchanged when
|
|
206
|
+
* `tool_search` loads a tool, so loads do not redeclare codemode.
|
|
207
|
+
*/
|
|
208
|
+
function prepareCodemodeLoadout(loadout, options) {
|
|
209
|
+
const mode = options.getMode?.() ?? SETTINGS_DEFAULTS.codemode.mode;
|
|
210
|
+
const isDirect = (tool) => loadout.getExposure(tool.name) === "direct";
|
|
211
|
+
const callable = getCodemodeCallableTools(loadout.callable);
|
|
212
|
+
const callableNames = new Set(callable.map((tool) => tool.name));
|
|
213
|
+
const descriptions = {};
|
|
214
|
+
if (mode === "on") {
|
|
215
|
+
for (const tool of loadout.declared) {
|
|
216
|
+
if (callableNames.has(tool.name))
|
|
217
|
+
descriptions[tool.name] = describeScriptCall(tool);
|
|
218
|
+
}
|
|
219
|
+
}
|
|
220
|
+
const listed = mode === "only" ? callable : callable.filter((tool) => !isDirect(tool));
|
|
221
|
+
const namespaces = new Map(listed.flatMap((tool) => {
|
|
222
|
+
const namespace = loadout.getNamespace(tool.name);
|
|
223
|
+
return namespace ? [[tool.name, namespace]] : [];
|
|
224
|
+
}));
|
|
225
|
+
const guidelines = new Map(listed.map((tool) => [tool.name, loadout.getPromptGuidelines(tool.name)]));
|
|
226
|
+
descriptions[CODEMODE_TOOL_NAME] = createCodemodeDescription(listed, {
|
|
227
|
+
models: options.models === true,
|
|
228
|
+
namespaces,
|
|
229
|
+
guidelines,
|
|
230
|
+
deferred: new Set(listed.filter((tool) => loadout.getExposure(tool.name) === "deferred").map((tool) => tool.name)),
|
|
231
|
+
inlineBudget: options.getInlineBudget?.() ?? DEFAULT_CODEMODE_INLINE_BUDGET,
|
|
232
|
+
});
|
|
233
|
+
const declaredNames = new Set(loadout.declared.map((tool) => tool.name));
|
|
234
|
+
return {
|
|
235
|
+
descriptions,
|
|
236
|
+
hiddenDeclarations: mode === "only"
|
|
237
|
+
? callable.filter((tool) => isDirect(tool) && declaredNames.has(tool.name)).map((tool) => tool.name)
|
|
238
|
+
: [],
|
|
239
|
+
};
|
|
240
|
+
}
|
|
241
|
+
/** Script globals that list or look up tools and namespaces, which the script may then call by any name. */
|
|
242
|
+
const DISCOVERY_GLOBALS = /\b(searchTools|describeNamespace|describeTool|ALL_TOOLS)\b/;
|
|
243
|
+
/**
|
|
244
|
+
* The tools a script may call (`ToolDefinition.reachesTools`): every tool when it uses a discovery
|
|
245
|
+
* global, else the words of its source, so `tools.mcp__docs__search` and
|
|
246
|
+
* `tools["mcp__docs__" + name]` both name the `mcp__docs` namespace.
|
|
247
|
+
*/
|
|
248
|
+
function getScriptReach(code) {
|
|
249
|
+
if (typeof code !== "string")
|
|
250
|
+
return [];
|
|
251
|
+
return DISCOVERY_GLOBALS.test(code) ? "all" : (code.match(/\w+/g) ?? []);
|
|
252
|
+
}
|
|
253
|
+
export function createCodemodeToolDefinition(options = {}) {
|
|
254
|
+
return {
|
|
255
|
+
name: CODEMODE_TOOL_NAME,
|
|
256
|
+
label: CODEMODE_TOOL_NAME,
|
|
257
|
+
// Replaced with the declarations of the callable tools when the tool is activated.
|
|
258
|
+
description: createCodemodeDescription([], { models: options.models === true }),
|
|
259
|
+
promptSnippet: codemodeToolSystemPromptContribution.snippet,
|
|
260
|
+
promptGuidelines: [...codemodeToolSystemPromptContribution.guidelines],
|
|
261
|
+
parameters: codemodeSchema,
|
|
262
|
+
// Scripts must not start other scripts.
|
|
263
|
+
exposure: "model-only",
|
|
264
|
+
prepareLoadout: (loadout) => prepareCodemodeLoadout(loadout, options),
|
|
265
|
+
reachesTools: (input) => getScriptReach(input.code),
|
|
266
|
+
// Capable models write the script as raw text instead of a JSON-escaped string.
|
|
267
|
+
constrainedSampling: { type: "grammar", variants: { openai_lark: CODEMODE_SOURCE_GRAMMAR } },
|
|
268
|
+
// The sandbox (worker, QuickJS wasm) loads on the first call, not at startup.
|
|
269
|
+
execute: async (toolCallId, params, signal, onUpdate, ctx) => (await loadCodemodeExecutor()).executeCodemode(toolCallId, params, signal, onUpdate, ctx, options),
|
|
270
|
+
};
|
|
271
|
+
}
|
|
272
|
+
/**
|
|
273
|
+
* Create the codemode tool as an AgentTool. The description lists the given tools; the script can
|
|
274
|
+
* call whatever tools the agent loop provides at execution time.
|
|
275
|
+
*/
|
|
276
|
+
export function createCodemodeTool(tools = [], options = {}) {
|
|
277
|
+
const definition = createCodemodeToolDefinition(options);
|
|
278
|
+
const tool = wrapToolDefinition(definition);
|
|
279
|
+
Object.assign(tool, {
|
|
280
|
+
description: createCodemodeDescription(tools, { models: options.models === true }),
|
|
281
|
+
promptSnippet: definition.promptSnippet,
|
|
282
|
+
promptGuidelines: definition.promptGuidelines,
|
|
283
|
+
});
|
|
284
|
+
return tool;
|
|
285
|
+
}
|
|
286
|
+
//# sourceMappingURL=tool.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tool.js","sourceRoot":"","sources":["../../../src/extensions/codemode/tool.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * The `codemode` tool: the model writes JavaScript that calls other tools. Scripts use `tools`,\n * `ALL_TOOLS`, `text()`, `image()`, `exit()`, `store()`/`load()`, `console.*`, and `return <value>`,\n * may start with a `// @options:` line, and reach the model catalog, classifiers, and image models\n * through `models.*`. Results start with a \"Script completed\" or \"Script failed\" header.\n *\n * Scripts can call the agent loop's nested tools: active `direct` tools and every `codemode` or\n * `deferred` tool. Nested calls run through the agent loop's tool pipeline (`ctx.executeTool`), so\n * validation, `tool_call`/`tool_result` hooks, and permission checks apply exactly as for direct\n * calls. Only the script's output reaches the model; nested results do not.\n *\n * Nested results are handed to the script as follows:\n * - A tool that declares `outputSchema` resolves to its `structuredContent`, also for error\n * results that carry one.\n * - Any other tool resolves to its text content as one string.\n * - A failed, blocked, or invalid call rejects with an Error carrying the tool's error text.\n *\n * A script that fails returns a normal error result that keeps its partial output, followed by\n * \"Script error:\" and the error. `store(key, value)` and `load(key)` keep JSON values across\n * calls; successful scripts append their writes to the session as `codemode-store` custom entries,\n * so each branch sees the values written on its own path.\n */\n\nimport { join } from \"node:path\";\nimport type { AgentTool } from \"@punch-bot/agent\";\nimport type { CodemodeJsonSchema, CodemodeTool } from \"@punch-bot/codemode\";\nimport { renderToolOutputType, renderToolSample, toCodemodeIdentifier } from \"@punch-bot/codemode/declarations\";\nimport { CODEMODE_SOURCE_GRAMMAR } from \"@punch-bot/codemode/source\";\nimport { type Static, Type } from \"typebox\";\nimport { getDocsPath } from \"../../config.ts\";\nimport type { ToolDefinition, ToolLoadout, ToolLoadoutChanges, ToolNamespace } from \"../../core/extensions/types.ts\";\nimport type { ModelRegistry } from \"../../core/model-registry.ts\";\nimport { SETTINGS_DEFAULTS } from \"../../core/settings-defaults.ts\";\nimport type { CodemodeMode } from \"../../core/settings-manager.ts\";\nimport { wrapToolDefinition } from \"../../core/tools/tool-definition-wrapper.ts\";\nimport { loadCodemodeExecutor } from \"./execute.lazy.ts\";\n\nexport const CODEMODE_TOOL_NAME = \"codemode\";\n\n/** Custom entry type holding one script's `store()` writes: {@link CodemodeStoreEntryData}. */\nexport const CODEMODE_STORE_ENTRY_TYPE = \"codemode-store\";\n\nexport interface CodemodeStoreEntryData {\n\tset: Record<string, unknown>;\n\tdelete: string[];\n}\n\n/** The part of the model registry that scripts reach through `models`. */\nexport type CodemodeModelRuntime = Pick<\n\tModelRegistry,\n\t\"getModelsOfType\" | \"getAvailableOfType\" | \"getModelOfType\" | \"classify\" | \"generateImages\"\n>;\n\nexport interface CodemodeToolOptions {\n\t/** Namespace of a tool, for `searchTools()` ranking and its `namespace` filter. */\n\tgetToolNamespace?: (toolName: string) => ToolNamespace | undefined;\n\t/** Prompt guidelines of every tool, by tool name, shown with declarations by `describeTool()` and `ALL_TOOLS`. */\n\tgetToolGuidelines?: () => ReadonlyMap<string, readonly string[]>;\n\t/**\n\t * Expose the `models` namespace to scripts, backed by the session's model registry\n\t * (`ctx.modelRegistry`). Without it, `models` is not declared.\n\t */\n\tmodels?: boolean;\n\t/**\n\t * Persists `store()` writes as a session custom entry. Without it, writes last only for the\n\t * current script; `load()` still reads entries already on the branch.\n\t */\n\tappendEntry?: (customType: string, data: CodemodeStoreEntryData) => void;\n\t/** How the tool presents the loadout while active (the `codemode.mode` setting). Default: `on`. */\n\tgetMode?: () => CodemodeMode;\n\t/** Token budget for tool declarations in the description. Default: {@link DEFAULT_CODEMODE_INLINE_BUDGET}. */\n\tgetInlineBudget?: () => number | undefined;\n}\n\nconst TEXT_OUTPUT_SCHEMA: CodemodeJsonSchema = { type: \"string\" };\n\nexport const codemodeSchema = Type.Object({\n\tcode: Type.String({\n\t\tdescription: \"Raw JavaScript source.\",\n\t}),\n});\n\nexport type CodemodeToolInput = Static<typeof codemodeSchema>;\n\nexport type CodemodeNestedCallStatus = \"running\" | \"ok\" | \"error\" | \"cancelled\";\n\nexport interface CodemodeNestedCall {\n\t/** Tool call id of the nested call, `<codemode call id>/<n>`. */\n\tid: string;\n\tname: string;\n\t/** Compact JSON of the arguments, truncated for display. */\n\targs: string;\n\tstatus: CodemodeNestedCallStatus;\n\tdurationMs?: number;\n\t/** Error text, truncated for display. */\n\terror?: string;\n\t/** Cost in USD of a `models.*` call that reported usage. */\n\tcost?: number;\n}\n\nexport interface CodemodeToolDetails {\n\tcalls: CodemodeNestedCall[];\n\t/** Temp file with the full text output, when the output was truncated. */\n\tfullOutputPath?: string;\n}\n\nexport const codemodeToolSystemPromptContribution = {\n\tsnippet: \"Run JavaScript that calls other tools\",\n\tguidelines: [\n\t\t\"Use codemode to batch independent tool calls (Promise.allSettled), chain them, or filter large output, instead of many separate calls.\",\n\t],\n} as const;\n\n/** The reference for scripts: globals, tool results, `store()`, the `models` API, and limits. */\nexport const CODEMODE_DOCS_PATH = join(getDocsPath(), \"codemode.md\");\n\nconst DESCRIPTION_INTRO = `Run JavaScript that calls other tools. The input is raw JavaScript (not JSON, no code fence), run as an async function body in a QuickJS sandbox: top-level \\`await\\` and \\`return\\` work. No Node, file system, network, or timers.\n- \\`await tools.<name>({ ...args })\\` resolves to a string, or an object if the tool's declaration says so, and rejects with an Error on failure. A tool whose declaration returns an object resolves on failure too when it returned that object; check its fields. Calls still running when the script ends are cancelled.\n- Optional first line: \\`// @options: {\"max_output_tokens\": 10000, \"timeout_ms\": 60000}\\``;\n\n/** One line per global. The details live in {@link CODEMODE_DOCS_PATH}. */\nfunction describeGlobals(models: boolean): string {\n\tconst lines = [\n\t\t\"Globals:\",\n\t\t\"- `text(value)`, `image(dataUrlOrImageBlock)`, `console.log(...)`, and top-level `return` add output; `exit()` ends the script. With several text items, each starts with a `==> text N/M <==` line, and `console` lines follow the other output in one `<console_output>` block. `image()` also saves the image to a temp file and the result names its path.\",\n\t\t\"- `store(key, value)` and `load(key)` keep JSON values across codemode calls.\",\n\t\t\"- `ALL_TOOLS`, `await searchTools(query, { limit?, namespace? })`, `await describeTool(name)`, `await describeNamespace(name)`: find unlisted tools, such as MCP tools.\",\n\t];\n\tif (models) {\n\t\tlines.push(`- \\`models\\`: classifiers and image generation. Read ${CODEMODE_DOCS_PATH} first.`);\n\t}\n\treturn lines.join(\"\\n\");\n}\n\n/** Default for {@link CodemodeDescriptionOptions.inlineBudget}, in estimated tokens. */\nexport const DEFAULT_CODEMODE_INLINE_BUDGET = SETTINGS_DEFAULTS.codemode.inlineBudget;\n/** Characters per token when estimating the cost of a tool section. */\nconst CHARS_PER_TOKEN = 4;\n\n/**\n * What a script sees of a tool: its description followed by its prompt guidelines, which the system\n * prompt only has for declared tools. Tools without an output schema resolve to their text output.\n */\nexport function toCodemodeDeclaration(\n\ttool: AgentTool<any>,\n\tguidelines: readonly string[] = [],\n): Omit<CodemodeTool, \"execute\"> {\n\tconst bullets = guidelines.flatMap((guideline) => (guideline.trim() ? [`- ${guideline.trim()}`] : []));\n\treturn {\n\t\tname: tool.name,\n\t\tdescription: bullets.length > 0 ? `${tool.description.trim()}\\n\\n${bullets.join(\"\\n\")}` : tool.description,\n\t\tinputSchema: tool.parameters as CodemodeJsonSchema,\n\t\toutputSchema: (tool.outputSchema as CodemodeJsonSchema | undefined) ?? TEXT_OUTPUT_SCHEMA,\n\t};\n}\n\n/** Tools a script may call: every given tool except the codemode tool itself. */\nexport function getCodemodeCallableTools(tools: readonly AgentTool<any>[]): AgentTool<any>[] {\n\treturn tools.filter((tool) => tool.name !== CODEMODE_TOOL_NAME);\n}\n\nexport interface CodemodeDescriptionOptions {\n\t/** Declare the `models` namespace; only for tools created with model access. */\n\tmodels?: boolean;\n\t/** Namespace of each tool, by tool name. Tools of one namespace are listed under one heading. */\n\tnamespaces?: ReadonlyMap<string, ToolNamespace>;\n\t/** Tools that are callable but never listed with their declaration (`deferred` exposure). */\n\tdeferred?: ReadonlySet<string>;\n\t/** Prompt guidelines of each tool, by tool name, listed after its description. */\n\tguidelines?: ReadonlyMap<string, readonly string[]>;\n\t/**\n\t * Estimated tokens (characters / 4) the tool sections may use. Tools that do not fit are left\n\t * out, like deferred tools. Unset lists every tool that is not deferred.\n\t */\n\tinlineBudget?: number;\n}\n\n/** `### \\`id\\` (\\`raw name\\`)` followed by the tool's description and declaration. */\nfunction renderToolSection(declaration: Omit<CodemodeTool, \"execute\">): string {\n\tconst id = toCodemodeIdentifier(declaration.name);\n\tconst heading = id === declaration.name ? `### \\`${id}\\`` : `### \\`${id}\\` (\\`${declaration.name}\\`)`;\n\treturn `${heading}\\n${renderToolSample(declaration).trim()}`;\n}\n\ninterface CatalogEntry {\n\tname: string;\n\tsection: string;\n\tcost: number;\n}\n\ninterface CatalogGroup {\n\tnamespace: ToolNamespace | undefined;\n\tentries: CatalogEntry[];\n}\n\n/**\n * Pick the tool sections that fit the budget, like OpenCode's catalog: in each round every group\n * (tools without a namespace first, then namespaces by name) places its cheapest remaining tool; a\n * group whose next tool does not fit drops out while the others continue. Every namespace is\n * represented before any namespace is complete.\n */\nfunction selectCatalog(groups: readonly CatalogGroup[], budget: number | undefined): Set<string> {\n\tif (budget === undefined) return new Set(groups.flatMap((group) => group.entries.map((entry) => entry.name)));\n\tconst queues = groups.map((group) => [...group.entries].sort((a, b) => a.cost - b.cost));\n\tconst shown = new Set<string>();\n\tlet remaining = budget;\n\tlet active = queues.filter((queue) => queue.length > 0);\n\twhile (active.length > 0) {\n\t\tactive = active.filter((queue) => {\n\t\t\tconst next = queue[0];\n\t\t\tif (next.cost > remaining) return false;\n\t\t\tremaining -= next.cost;\n\t\t\tshown.add(next.name);\n\t\t\tqueue.shift();\n\t\t\treturn queue.length > 0;\n\t\t});\n\t}\n\treturn shown;\n}\n\n/**\n * Model-facing description: the helper list, guidance for finding tools that are not listed, the\n * `models` API, and one section per listed tool, grouped by namespace. Deferred tools are never\n * listed and do not affect the description at all, so it stays the same while tools are registered\n * late (for example by MCP servers that connect). Tool sections are limited to `inlineBudget`.\n */\nexport function createCodemodeDescription(\n\ttools: readonly AgentTool<any>[],\n\toptions: CodemodeDescriptionOptions = {},\n): string {\n\tconst declarations = getCodemodeCallableTools(tools)\n\t\t.filter((tool) => !options.deferred?.has(tool.name))\n\t\t.map((tool) => toCodemodeDeclaration(tool, options.guidelines?.get(tool.name)));\n\tconst groups = new Map<string, CatalogGroup>([[\"\", { namespace: undefined, entries: [] }]]);\n\tfor (const declaration of declarations) {\n\t\tconst namespace = options.namespaces?.get(declaration.name);\n\t\tconst key = namespace ? `ns:${namespace.name}` : \"\";\n\t\tconst group = groups.get(key) ?? { namespace, entries: [] };\n\t\tgroups.set(key, group);\n\t\tconst section = renderToolSection(declaration);\n\t\tgroup.entries.push({ name: declaration.name, section, cost: Math.ceil(section.length / CHARS_PER_TOKEN) });\n\t}\n\tconst ordered = [...groups.values()].sort((a, b) =>\n\t\ta.namespace === undefined ? -1 : b.namespace === undefined ? 1 : a.namespace.name.localeCompare(b.namespace.name),\n\t);\n\tconst shown = selectCatalog(ordered, options.inlineBudget);\n\n\tconst sections = [DESCRIPTION_INTRO, describeGlobals(options.models === true)];\n\tif (declarations.length === 0) return sections.join(\"\\n\\n\");\n\n\tconst toolSections = [\"Nested tools:\"];\n\tfor (const { namespace, entries } of ordered) {\n\t\tconst visible = entries.filter((entry) => shown.has(entry.name));\n\t\tif (namespace) {\n\t\t\t// Only tools that did not fit the budget are counted as not listed here.\n\t\t\tconst listing =\n\t\t\t\tvisible.length === entries.length\n\t\t\t\t\t? \"\"\n\t\t\t\t\t: visible.length === 0\n\t\t\t\t\t\t? \" (tools not listed)\"\n\t\t\t\t\t\t: \" (some tools not listed)\";\n\t\t\tconst description = namespace.description?.trim();\n\t\t\ttoolSections.push(`## ${namespace.name}${listing}${description ? `\\n${description}` : \"\"}`);\n\t\t}\n\t\tfor (const entry of visible) toolSections.push(entry.section);\n\t}\n\tsections.push(toolSections.join(\"\\n\\n\"));\n\treturn sections.join(\"\\n\\n\");\n}\n\n/**\n * The field names of an object schema, `{ output, exit_code, full_output_path? }`, with the fields of\n * object-typed fields `depth` levels deep: `{ content, structuredContent?: { results } }`. Undefined\n * for other schemas.\n */\nfunction describeFields(schema: unknown, depth: number): string | undefined {\n\tif (typeof schema !== \"object\" || schema === null) return undefined;\n\tconst { type, properties, required } = schema as Record<string, unknown>;\n\tif (type !== \"object\" || typeof properties !== \"object\" || properties === null) return undefined;\n\tconst requiredNames = new Set(Array.isArray(required) ? required : []);\n\tconst fields = Object.entries(properties).map(([name, field]) => {\n\t\tconst nested = depth > 0 ? describeFields(field, depth - 1) : undefined;\n\t\treturn `${name}${requiredNames.has(name) ? \"\" : \"?\"}${nested ? `: ${nested}` : \"\"}`;\n\t});\n\treturn `{ ${fields.join(\", \")} }`;\n}\n\n/**\n * What a script call resolves to, in one line: `a string`, the field names of an object (see\n * {@link describeFields}), or the rendered type for anything else.\n */\nfunction describeOutput(schema: CodemodeJsonSchema | undefined): string {\n\tconst type = renderToolOutputType(schema);\n\tif (type === \"string\") return \"a string\";\n\tconst fields = describeFields(schema, 1);\n\treturn `\\`${fields ?? type.replace(/\\s+/g, \" \")}\\``;\n}\n\n/**\n * A declared tool's description followed by how scripts call it and what the call resolves to. The\n * arguments are the tool's declared parameters, so they are not repeated.\n */\nfunction describeScriptCall(tool: AgentTool<any>): string {\n\treturn `${tool.description.trim()}\\n\\nCodemode: \\`tools.${toCodemodeIdentifier(tool.name)}(args)\\` resolves to ${describeOutput(toCodemodeDeclaration(tool).outputSchema)}.`;\n}\n\n/**\n * How the codemode tool presents tools that are both declared and callable from scripts:\n * - `on`: their descriptions say how scripts call them, and the codemode description\n * lists only the callable tools without `direct` exposure.\n * - `only`: the codemode description lists every callable tool, and requests leave out the\n * declarations of active `direct` tools.\n *\n * Listed tools carry their prompt guidelines, which the system prompt only has for declared tools.\n *\n * Listing by exposure, not by the active set, keeps the codemode description unchanged when\n * `tool_search` loads a tool, so loads do not redeclare codemode.\n */\nfunction prepareCodemodeLoadout(loadout: ToolLoadout, options: CodemodeToolOptions): ToolLoadoutChanges {\n\tconst mode = options.getMode?.() ?? SETTINGS_DEFAULTS.codemode.mode;\n\tconst isDirect = (tool: AgentTool) => loadout.getExposure(tool.name) === \"direct\";\n\tconst callable = getCodemodeCallableTools(loadout.callable);\n\tconst callableNames = new Set(callable.map((tool) => tool.name));\n\tconst descriptions: Record<string, string> = {};\n\tif (mode === \"on\") {\n\t\tfor (const tool of loadout.declared) {\n\t\t\tif (callableNames.has(tool.name)) descriptions[tool.name] = describeScriptCall(tool);\n\t\t}\n\t}\n\tconst listed = mode === \"only\" ? callable : callable.filter((tool) => !isDirect(tool));\n\tconst namespaces = new Map(\n\t\tlisted.flatMap((tool) => {\n\t\t\tconst namespace = loadout.getNamespace(tool.name);\n\t\t\treturn namespace ? [[tool.name, namespace] as const] : [];\n\t\t}),\n\t);\n\tconst guidelines = new Map(listed.map((tool) => [tool.name, loadout.getPromptGuidelines(tool.name)] as const));\n\tdescriptions[CODEMODE_TOOL_NAME] = createCodemodeDescription(listed, {\n\t\tmodels: options.models === true,\n\t\tnamespaces,\n\t\tguidelines,\n\t\tdeferred: new Set(\n\t\t\tlisted.filter((tool) => loadout.getExposure(tool.name) === \"deferred\").map((tool) => tool.name),\n\t\t),\n\t\tinlineBudget: options.getInlineBudget?.() ?? DEFAULT_CODEMODE_INLINE_BUDGET,\n\t});\n\tconst declaredNames = new Set(loadout.declared.map((tool) => tool.name));\n\treturn {\n\t\tdescriptions,\n\t\thiddenDeclarations:\n\t\t\tmode === \"only\"\n\t\t\t\t? callable.filter((tool) => isDirect(tool) && declaredNames.has(tool.name)).map((tool) => tool.name)\n\t\t\t\t: [],\n\t};\n}\n\n/** Script globals that list or look up tools and namespaces, which the script may then call by any name. */\nconst DISCOVERY_GLOBALS = /\\b(searchTools|describeNamespace|describeTool|ALL_TOOLS)\\b/;\n\n/**\n * The tools a script may call (`ToolDefinition.reachesTools`): every tool when it uses a discovery\n * global, else the words of its source, so `tools.mcp__docs__search` and\n * `tools[\"mcp__docs__\" + name]` both name the `mcp__docs` namespace.\n */\nfunction getScriptReach(code: unknown): \"all\" | readonly string[] {\n\tif (typeof code !== \"string\") return [];\n\treturn DISCOVERY_GLOBALS.test(code) ? \"all\" : (code.match(/\\w+/g) ?? []);\n}\n\nexport function createCodemodeToolDefinition(\n\toptions: CodemodeToolOptions = {},\n): ToolDefinition<typeof codemodeSchema, CodemodeToolDetails | undefined> {\n\treturn {\n\t\tname: CODEMODE_TOOL_NAME,\n\t\tlabel: CODEMODE_TOOL_NAME,\n\t\t// Replaced with the declarations of the callable tools when the tool is activated.\n\t\tdescription: createCodemodeDescription([], { models: options.models === true }),\n\t\tpromptSnippet: codemodeToolSystemPromptContribution.snippet,\n\t\tpromptGuidelines: [...codemodeToolSystemPromptContribution.guidelines],\n\t\tparameters: codemodeSchema,\n\t\t// Scripts must not start other scripts.\n\t\texposure: \"model-only\",\n\t\tprepareLoadout: (loadout) => prepareCodemodeLoadout(loadout, options),\n\t\treachesTools: (input) => getScriptReach(input.code),\n\t\t// Capable models write the script as raw text instead of a JSON-escaped string.\n\t\tconstrainedSampling: { type: \"grammar\", variants: { openai_lark: CODEMODE_SOURCE_GRAMMAR } },\n\t\t// The sandbox (worker, QuickJS wasm) loads on the first call, not at startup.\n\t\texecute: async (toolCallId, params, signal, onUpdate, ctx) =>\n\t\t\t(await loadCodemodeExecutor()).executeCodemode(toolCallId, params, signal, onUpdate, ctx, options),\n\t};\n}\n\n/**\n * Create the codemode tool as an AgentTool. The description lists the given tools; the script can\n * call whatever tools the agent loop provides at execution time.\n */\nexport function createCodemodeTool(\n\ttools: readonly AgentTool<any>[] = [],\n\toptions: CodemodeToolOptions = {},\n): AgentTool<typeof codemodeSchema> {\n\tconst definition = createCodemodeToolDefinition(options);\n\tconst tool = wrapToolDefinition(definition);\n\tObject.assign(tool, {\n\t\tdescription: createCodemodeDescription(tools, { models: options.models === true }),\n\t\tpromptSnippet: definition.promptSnippet,\n\t\tpromptGuidelines: definition.promptGuidelines,\n\t});\n\treturn tool;\n}\n"]}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Worker entry for the codemode sandbox in bundled builds. The Node bundle and the Bun binary
|
|
3
|
+
* build this file as a separate entrypoint because pi-codemode's own worker file is not on disk
|
|
4
|
+
* there; `getCodemodeWorkerSpecifier()` in config.ts resolves it.
|
|
5
|
+
*/
|
|
6
|
+
import "@punch-bot/codemode/worker";
|
|
7
|
+
//# sourceMappingURL=worker.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../src/extensions/codemode/worker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,4BAA4B,CAAC"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Worker entry for the codemode sandbox in bundled builds. The Node bundle and the Bun binary
|
|
3
|
+
* build this file as a separate entrypoint because pi-codemode's own worker file is not on disk
|
|
4
|
+
* there; `getCodemodeWorkerSpecifier()` in config.ts resolves it.
|
|
5
|
+
*/
|
|
6
|
+
import "@punch-bot/codemode/worker";
|
|
7
|
+
//# sourceMappingURL=worker.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../src/extensions/codemode/worker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,4BAA4B,CAAC","sourcesContent":["/**\n * Worker entry for the codemode sandbox in bundled builds. The Node bundle and the Bun binary\n * build this file as a separate entrypoint because pi-codemode's own worker file is not on disk\n * there; `getCodemodeWorkerSpecifier()` in config.ts resolves it.\n */\nimport \"@punch-bot/codemode/worker\";\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"compress_context.d.ts","sourceRoot":"","sources":["../../../src/extensions/context-pruning/compress_context.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,gCAAgC,CAAC;AAmFrF,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA4MtE","sourcesContent":["import { readFile, writeFile } from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport type { AgentMessage } from \"@punch-bot/agent\";\nimport { Type } from \"typebox\";\nimport type { ExtensionAPI, ExtensionContext } from \"../../core/extensions/types.ts\";\nimport type { PruningRecord, PruningState } from \"./context-pruning-state.ts\";\nimport {\n\tactiveBlocks,\n\tactiveMessageIds,\n\tblockPreview,\n\tcreateBlock,\n\tdeactivateBlock,\n\temptyState,\n\tmessageRecords,\n\tnormalizeState,\n\trecompressBlock,\n\tSTATE_TYPE,\n\tsearchBlocks,\n} from \"./context-pruning-state.ts\";\n\nconst MAX_MEMORY_CHARS = 12_000;\n\nfunction memoryFilePath(ctx: ExtensionContext): string {\n\treturn process.env.PI_MEMORY_FILE || path.join(ctx.cwd, \".punch-memory.md\");\n}\n\nconst textResult = (text: string) => ({ content: [{ type: \"text\" as const, text }], details: {} });\n\nfunction loadState(ctx: ExtensionContext): PruningState {\n\tconst entries = ctx.sessionManager.getBranch();\n\tfor (let index = entries.length - 1; index >= 0; index -= 1) {\n\t\tconst entry = entries[index] as { type?: string; customType?: string; data?: unknown } | undefined;\n\t\tif (entry?.type === \"custom\" && entry.customType === STATE_TYPE) return normalizeState(entry.data);\n\t}\n\treturn emptyState();\n}\n\nfunction saveState(pi: ExtensionAPI, _ctx: ExtensionContext, state: PruningState) {\n\tpi.appendEntry(STATE_TYPE, state);\n}\n\nfunction records(ctx: ExtensionContext): PruningRecord[] {\n\treturn messageRecords(ctx.sessionManager.buildContextEntries());\n}\n\nfunction messageSignature(message: { role?: string; content?: unknown; toolCallId?: string; toolName?: string }) {\n\treturn JSON.stringify({\n\t\trole: message?.role,\n\t\tcontent: message?.content,\n\t\ttoolCallId: message?.toolCallId,\n\t\ttoolName: message?.toolName,\n\t});\n}\n\nfunction matchEntryIds(ctx: ExtensionContext, messages: Array<{ role?: string; content?: unknown }>) {\n\tconst idsBySignature = new Map<string, string[]>();\n\tfor (const record of records(ctx)) {\n\t\tconst signature = messageSignature(record.message);\n\t\tconst ids = idsBySignature.get(signature) ?? [];\n\t\tids.push(record.id);\n\t\tidsBySignature.set(signature, ids);\n\t}\n\treturn messages.map((message) => idsBySignature.get(messageSignature(message))?.shift());\n}\n\nfunction addMessageId(message: AgentMessage, id: string): AgentMessage {\n\tif (message.role !== \"user\") return message;\n\tconst marker = `\\n\\n<punch-message-id>${id}</punch-message-id>`;\n\tif (!(\"content\" in message)) return message;\n\tif (typeof message.content === \"string\") return { ...message, content: `${message.content}${marker}` };\n\tif (Array.isArray(message.content)) {\n\t\treturn { ...message, content: [...message.content, { type: \"text\", text: marker }] };\n\t}\n\treturn message;\n}\n\nfunction compressedSummary(block: PruningState[\"blocks\"][number]): AgentMessage {\n\tconst topic = block.topic ? `: ${block.topic}` : \"\";\n\treturn {\n\t\trole: \"custom\",\n\t\tcustomType: STATE_TYPE,\n\t\tcontent: `<compressed-context id=\"${block.id}\">${topic}\\n${block.summary}\\n</compressed-context>`,\n\t\tdisplay: false,\n\t\ttimestamp: Date.now(),\n\t};\n}\n\nexport default function contextPruningExtension(pi: ExtensionAPI): void {\n\tpi.on(\"before_agent_start\", (event, ctx) => {\n\t\tconst threshold = Number(process.env.PI_CONTEXT_PRUNING_THRESHOLD || 0);\n\t\tconst usage = ctx.getContextUsage();\n\t\tconst nudge =\n\t\t\tthreshold > 0 && usage?.percent != null && usage.percent >= threshold\n\t\t\t\t? `\\n\\n## Context pruning now\\nUsage ${Math.round(usage.percent)}% — compress stale complete ranges with compress_context before continuing. Keep current work and recent turns raw.`\n\t\t\t\t: \"\";\n\t\tif (!nudge) return;\n\t\treturn {\n\t\t\tsystemPrompt: `${event.systemPrompt}${nudge}`,\n\t\t};\n\t});\n\n\tpi.on(\"context\", (event, ctx) => {\n\t\tconst state = loadState(ctx);\n\t\tconst blocks = activeBlocks(state);\n\t\tconst ids = matchEntryIds(ctx, event.messages);\n\t\tconst hidden = activeMessageIds(state);\n\t\tif ([...hidden].some((id) => !ids.includes(id))) {\n\t\t\treturn {\n\t\t\t\tmessages: event.messages.map((message, index) =>\n\t\t\t\t\tids[index] ? addMessageId(message, ids[index]!) : message,\n\t\t\t\t),\n\t\t\t};\n\t\t}\n\n\t\tconst byAnchor = new Map(blocks.map((block) => [block.anchorId, block]));\n\t\tconst messages: typeof event.messages = [];\n\t\tfor (let index = 0; index < event.messages.length; index += 1) {\n\t\t\tconst id = ids[index];\n\t\t\tconst block = id ? byAnchor.get(id) : undefined;\n\t\t\tif (block) messages.push(compressedSummary(block));\n\t\t\tif (id && hidden.has(id)) continue;\n\t\t\tmessages.push(id ? addMessageId(event.messages[index], id) : event.messages[index]);\n\t\t}\n\t\treturn { messages };\n\t});\n\n\tpi.registerTool({\n\t\tname: \"compress_context\",\n\t\tlabel: \"Compress context range\",\n\t\tpromptSnippet:\n\t\t\t\"Compress stale complete conversation ranges when context is crowded; use visible punch-message-id values.\",\n\t\tpromptGuidelines: [\n\t\t\t\"Before compression, save durable project facts to the project memory file.\",\n\t\t\t\"Only compress complete stale user-turn ranges. Keep active task discussion and recent turns visible.\",\n\t\t\t\"Supply a self-contained summary. The original session remains retrievable with decompress_context.\",\n\t\t\t\"Do not compress ranges that contain compression or task tools (compress_context, decompress_context, recompress_context, context_status, search_context, task). Those turns are protected.\",\n\t\t],\n\t\tdescription:\n\t\t\t\"Replace a stale range of complete conversation turns with your summary for future model calls. Boundaries must be visible user-message IDs. Original session entries remain intact and can be restored with decompress_context.\",\n\t\texecutionMode: \"sequential\",\n\t\tparameters: Type.Object({\n\t\t\tstartId: Type.String({ description: \"Earlier visible user punch-message-id\" }),\n\t\t\tendId: Type.String({ description: \"Later visible user punch-message-id\" }),\n\t\t\tsummary: Type.String({ description: \"Self-contained summary replacing the range\" }),\n\t\t\ttopic: Type.Optional(Type.String({ description: \"Short range label\" })),\n\t\t}),\n\t\tasync execute(_toolCallId, args, _signal, _onUpdate, ctx) {\n\t\t\tconst state = createBlock(loadState(ctx), records(ctx), args);\n\t\t\tsaveState(pi, ctx, state);\n\t\t\tconst block = state.blocks.at(-1)!;\n\t\t\treturn textResult(\n\t\t\t\t`Compressed ${block.id}: ${block.messageIds.length} messages, ${block.sourceCharacters} source characters. Use decompress_context with ${block.id} to restore it.`,\n\t\t\t);\n\t\t},\n\t});\n\n\tpi.registerTool({\n\t\tname: \"recompress_context\",\n\t\tlabel: \"Recompress into denser summary\",\n\t\tpromptSnippet:\n\t\t\t\"Condense multiple deactivated blocks into a single denser tier-2 block when context is tight. Parent blocks must be deactivated first.\",\n\t\tpromptGuidelines: [\n\t\t\t\"Deactivate the source blocks with decompress_context before recompressing them.\",\n\t\t\t\"The new summary should be more concise than the individual block summaries combined.\",\n\t\t],\n\t\tdescription:\n\t\t\t\"Combine 2+ deactivated (restored) blocks into a single tier-2 compressed block with a condensed summary. Frees the anchor slot and reduces context overhead.\",\n\t\texecutionMode: \"sequential\",\n\t\tparameters: Type.Object({\n\t\t\tblockIds: Type.Array(Type.String(), {\n\t\t\t\tdescription: 'IDs of deactivated blocks to condense, e.g. [\"b1\", \"b2\"]',\n\t\t\t}),\n\t\t\tsummary: Type.String({ description: \"Condensed summary replacing all parent summaries\" }),\n\t\t\ttopic: Type.Optional(Type.String({ description: \"Short label\" })),\n\t\t}),\n\t\tasync execute(_toolCallId, args, _signal, _onUpdate, ctx) {\n\t\t\tconst state = recompressBlock(loadState(ctx), args.blockIds, args);\n\t\t\tsaveState(pi, ctx, state);\n\t\t\tconst block = state.blocks.at(-1)!;\n\t\t\treturn textResult(\n\t\t\t\t`Recompressed ${args.blockIds.join(\", \")} into ${block.id} [T2]: ${block.messageIds.length} messages, ${block.sourceCharacters} source characters.`,\n\t\t\t);\n\t\t},\n\t});\n\n\tpi.registerTool({\n\t\tname: \"decompress_context\",\n\t\tlabel: \"Restore context range\",\n\t\tdescription:\n\t\t\t\"Restore a previously compressed block for future model calls. Returns a bounded preview immediately; original session entries are never deleted.\",\n\t\texecutionMode: \"sequential\",\n\t\tparameters: Type.Object({ blockId: Type.String({ description: \"Active block ID, such as b1\" }) }),\n\t\tasync execute(_toolCallId, args, _signal, _onUpdate, ctx) {\n\t\t\tconst state = loadState(ctx);\n\t\t\tconst block = activeBlocks(state).find((candidate) => candidate.id === args.blockId);\n\t\t\tif (!block) throw new Error(`active block ${args.blockId} not found`);\n\t\t\tconst next = deactivateBlock(state, args.blockId);\n\t\t\tsaveState(pi, ctx, next);\n\t\t\treturn textResult(`Restored ${args.blockId}. Preview:\\n${blockPreview(records(ctx), block)}`);\n\t\t},\n\t});\n\n\tpi.registerTool({\n\t\tname: \"context_status\",\n\t\tlabel: \"Context pruning status\",\n\t\tdescription: \"Show active compressed ranges and context usage.\",\n\t\tparameters: Type.Object({}),\n\t\tasync execute(_toolCallId, _args, _signal, _onUpdate, ctx) {\n\t\t\tconst state = loadState(ctx);\n\t\t\tconst blocks = activeBlocks(state);\n\t\t\tconst usage = ctx.getContextUsage();\n\t\t\tconst lines = blocks.map(\n\t\t\t\t(block) =>\n\t\t\t\t\t`${block.id} [T${block.tier || 1}]: ${block.messageIds.length} messages, ${block.sourceCharacters} source chars${block.topic ? `, ${block.topic}` : \"\"}${block.parentBlockIds ? `, from ${block.parentBlockIds.join(\", \")}` : \"\"}`,\n\t\t\t);\n\t\t\treturn textResult(\n\t\t\t\t[\n\t\t\t\t\t`Active compressed blocks: ${blocks.length}.`,\n\t\t\t\t\tusage?.percent == null ? \"Context usage unavailable.\" : `Context usage: ${Math.round(usage.percent)}%.`,\n\t\t\t\t\tlines.join(\"\\n\") || \"No ranges compressed.\",\n\t\t\t\t].join(\"\\n\"),\n\t\t\t);\n\t\t},\n\t});\n\n\tpi.registerTool({\n\t\tname: \"search_context\",\n\t\tlabel: \"Search compressed context\",\n\t\tdescription: \"Search active compressed summaries before restoring a block.\",\n\t\tparameters: Type.Object({ query: Type.String({ description: \"Words to search\" }) }),\n\t\tasync execute(_toolCallId, args, _signal, _onUpdate, ctx) {\n\t\t\tconst results = searchBlocks(loadState(ctx), args.query);\n\t\t\tif (!results.length) return textResult(\"No matching compressed blocks.\");\n\t\t\treturn textResult(\n\t\t\t\tresults\n\t\t\t\t\t.map(\n\t\t\t\t\t\t({ block }) =>\n\t\t\t\t\t\t\t`${block.id}${block.topic ? ` (${block.topic})` : \"\"}: ${block.summary.slice(0, 1_000)}`,\n\t\t\t\t\t)\n\t\t\t\t\t.join(\"\\n\\n\"),\n\t\t\t);\n\t\t},\n\t});\n\n\tpi.registerTool({\n\t\tname: \"update_memory\",\n\t\tlabel: \"Update project memory\",\n\t\tdescription:\n\t\t\t\"Add or update a section in the project memory file. Sections are delimited by ## headers. Replaces existing content for the same section name.\",\n\t\tpromptSnippet:\n\t\t\t\"Save durable project context to the project memory file before compression or when you learn something worth keeping across sessions.\",\n\t\tpromptGuidelines: [\n\t\t\t\"Keep entries concise and scoped to what matters long-term.\",\n\t\t\t\"Use existing section names to update them or new names to create sections.\",\n\t\t\t\"The file survives session resets and compactions — write decisions, conventions, gotchas, and preferences.\",\n\t\t],\n\t\texecutionMode: \"sequential\",\n\t\tparameters: Type.Object({\n\t\t\tsection: Type.String({ description: \"Section name without ## prefix, e.g. Guidelines or Open work\" }),\n\t\t\tcontent: Type.String({ description: \"Section body as markdown\" }),\n\t\t}),\n\t\tasync execute(_toolCallId, args, _signal, _onUpdate, ctx) {\n\t\t\tconst filePath = memoryFilePath(ctx);\n\t\t\tlet existing = \"\";\n\t\t\ttry {\n\t\t\t\texisting = await readFile(filePath, \"utf8\");\n\t\t\t} catch {\n\t\t\t\t// memory file may not exist yet\n\t\t\t}\n\t\t\tconst content = args.content.trim().replace(/^(## )/gm, \"\\\\$1\");\n\t\t\tconst header = `## ${args.section}`;\n\t\t\tconst sectionPattern = new RegExp(\n\t\t\t\t`(?:^|\\n)${header.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\")}\\n.*?(?=\\n## |\\n*$)`,\n\t\t\t\t\"ds\",\n\t\t\t);\n\t\t\tconst newSection = `\\n${header}\\n${content}`;\n\t\t\tlet updated: string;\n\t\t\tif (sectionPattern.test(existing)) {\n\t\t\t\tupdated = existing.replace(sectionPattern, newSection);\n\t\t\t} else {\n\t\t\t\tupdated = existing.trimEnd() + newSection;\n\t\t\t}\n\t\t\tif (updated.length > MAX_MEMORY_CHARS) {\n\t\t\t\treturn textResult(\n\t\t\t\t\t`Update skipped: memory would be ${updated.length} characters (max ${MAX_MEMORY_CHARS}). Shorten the content or remove old sections.`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tawait writeFile(filePath, updated, \"utf8\");\n\t\t\treturn textResult(`Memory section \"${args.section}\" updated.`);\n\t\t},\n\t});\n}\n"]}
|
|
1
|
+
{"version":3,"file":"compress_context.d.ts","sourceRoot":"","sources":["../../../src/extensions/context-pruning/compress_context.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,gCAAgC,CAAC;AAmFrF,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CA0MtE"}
|
|
@@ -72,9 +72,7 @@ export default function contextPruningExtension(pi) {
|
|
|
72
72
|
: "";
|
|
73
73
|
if (!nudge)
|
|
74
74
|
return;
|
|
75
|
-
|
|
76
|
-
systemPrompt: `${event.systemPrompt}${nudge}`,
|
|
77
|
-
};
|
|
75
|
+
event.systemPromptOptions.sections.context_pruning = nudge.trim();
|
|
78
76
|
});
|
|
79
77
|
pi.on("context", (event, ctx) => {
|
|
80
78
|
const state = loadState(ctx);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"compress_context.js","sourceRoot":"","sources":["../../../src/extensions/context-pruning/compress_context.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile, writeFile } from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport type { AgentMessage } from \"@punch-bot/agent\";\nimport { Type } from \"typebox\";\nimport type { ExtensionAPI, ExtensionContext } from \"../../core/extensions/types.ts\";\nimport type { PruningRecord, PruningState } from \"./context-pruning-state.ts\";\nimport {\n\tactiveBlocks,\n\tactiveMessageIds,\n\tblockPreview,\n\tcreateBlock,\n\tdeactivateBlock,\n\temptyState,\n\tmessageRecords,\n\tnormalizeState,\n\trecompressBlock,\n\tSTATE_TYPE,\n\tsearchBlocks,\n} from \"./context-pruning-state.ts\";\n\nconst MAX_MEMORY_CHARS = 12_000;\n\nfunction memoryFilePath(ctx: ExtensionContext): string {\n\treturn process.env.PI_MEMORY_FILE || path.join(ctx.cwd, \".punch-memory.md\");\n}\n\nconst textResult = (text: string) => ({ content: [{ type: \"text\" as const, text }], details: {} });\n\nfunction loadState(ctx: ExtensionContext): PruningState {\n\tconst entries = ctx.sessionManager.getBranch();\n\tfor (let index = entries.length - 1; index >= 0; index -= 1) {\n\t\tconst entry = entries[index] as { type?: string; customType?: string; data?: unknown } | undefined;\n\t\tif (entry?.type === \"custom\" && entry.customType === STATE_TYPE) return normalizeState(entry.data);\n\t}\n\treturn emptyState();\n}\n\nfunction saveState(pi: ExtensionAPI, _ctx: ExtensionContext, state: PruningState) {\n\tpi.appendEntry(STATE_TYPE, state);\n}\n\nfunction records(ctx: ExtensionContext): PruningRecord[] {\n\treturn messageRecords(ctx.sessionManager.buildContextEntries());\n}\n\nfunction messageSignature(message: { role?: string; content?: unknown; toolCallId?: string; toolName?: string }) {\n\treturn JSON.stringify({\n\t\trole: message?.role,\n\t\tcontent: message?.content,\n\t\ttoolCallId: message?.toolCallId,\n\t\ttoolName: message?.toolName,\n\t});\n}\n\nfunction matchEntryIds(ctx: ExtensionContext, messages: Array<{ role?: string; content?: unknown }>) {\n\tconst idsBySignature = new Map<string, string[]>();\n\tfor (const record of records(ctx)) {\n\t\tconst signature = messageSignature(record.message);\n\t\tconst ids = idsBySignature.get(signature) ?? [];\n\t\tids.push(record.id);\n\t\tidsBySignature.set(signature, ids);\n\t}\n\treturn messages.map((message) => idsBySignature.get(messageSignature(message))?.shift());\n}\n\nfunction addMessageId(message: AgentMessage, id: string): AgentMessage {\n\tif (message.role !== \"user\") return message;\n\tconst marker = `\\n\\n<punch-message-id>${id}</punch-message-id>`;\n\tif (!(\"content\" in message)) return message;\n\tif (typeof message.content === \"string\") return { ...message, content: `${message.content}${marker}` };\n\tif (Array.isArray(message.content)) {\n\t\treturn { ...message, content: [...message.content, { type: \"text\", text: marker }] };\n\t}\n\treturn message;\n}\n\nfunction compressedSummary(block: PruningState[\"blocks\"][number]): AgentMessage {\n\tconst topic = block.topic ? `: ${block.topic}` : \"\";\n\treturn {\n\t\trole: \"custom\",\n\t\tcustomType: STATE_TYPE,\n\t\tcontent: `<compressed-context id=\"${block.id}\">${topic}\\n${block.summary}\\n</compressed-context>`,\n\t\tdisplay: false,\n\t\ttimestamp: Date.now(),\n\t};\n}\n\nexport default function contextPruningExtension(pi: ExtensionAPI): void {\n\tpi.on(\"before_agent_start\", (event, ctx) => {\n\t\tconst threshold = Number(process.env.PI_CONTEXT_PRUNING_THRESHOLD || 0);\n\t\tconst usage = ctx.getContextUsage();\n\t\tconst nudge =\n\t\t\tthreshold > 0 && usage?.percent != null && usage.percent >= threshold\n\t\t\t\t? `\\n\\n## Context pruning now\\nUsage ${Math.round(usage.percent)}% — compress stale complete ranges with compress_context before continuing. Keep current work and recent turns raw.`\n\t\t\t\t: \"\";\n\t\tif (!nudge) return;\n\t\treturn {\n\t\t\tsystemPrompt: `${event.systemPrompt}${nudge}`,\n\t\t};\n\t});\n\n\tpi.on(\"context\", (event, ctx) => {\n\t\tconst state = loadState(ctx);\n\t\tconst blocks = activeBlocks(state);\n\t\tconst ids = matchEntryIds(ctx, event.messages);\n\t\tconst hidden = activeMessageIds(state);\n\t\tif ([...hidden].some((id) => !ids.includes(id))) {\n\t\t\treturn {\n\t\t\t\tmessages: event.messages.map((message, index) =>\n\t\t\t\t\tids[index] ? addMessageId(message, ids[index]!) : message,\n\t\t\t\t),\n\t\t\t};\n\t\t}\n\n\t\tconst byAnchor = new Map(blocks.map((block) => [block.anchorId, block]));\n\t\tconst messages: typeof event.messages = [];\n\t\tfor (let index = 0; index < event.messages.length; index += 1) {\n\t\t\tconst id = ids[index];\n\t\t\tconst block = id ? byAnchor.get(id) : undefined;\n\t\t\tif (block) messages.push(compressedSummary(block));\n\t\t\tif (id && hidden.has(id)) continue;\n\t\t\tmessages.push(id ? addMessageId(event.messages[index], id) : event.messages[index]);\n\t\t}\n\t\treturn { messages };\n\t});\n\n\tpi.registerTool({\n\t\tname: \"compress_context\",\n\t\tlabel: \"Compress context range\",\n\t\tpromptSnippet:\n\t\t\t\"Compress stale complete conversation ranges when context is crowded; use visible punch-message-id values.\",\n\t\tpromptGuidelines: [\n\t\t\t\"Before compression, save durable project facts to the project memory file.\",\n\t\t\t\"Only compress complete stale user-turn ranges. Keep active task discussion and recent turns visible.\",\n\t\t\t\"Supply a self-contained summary. The original session remains retrievable with decompress_context.\",\n\t\t\t\"Do not compress ranges that contain compression or task tools (compress_context, decompress_context, recompress_context, context_status, search_context, task). Those turns are protected.\",\n\t\t],\n\t\tdescription:\n\t\t\t\"Replace a stale range of complete conversation turns with your summary for future model calls. Boundaries must be visible user-message IDs. Original session entries remain intact and can be restored with decompress_context.\",\n\t\texecutionMode: \"sequential\",\n\t\tparameters: Type.Object({\n\t\t\tstartId: Type.String({ description: \"Earlier visible user punch-message-id\" }),\n\t\t\tendId: Type.String({ description: \"Later visible user punch-message-id\" }),\n\t\t\tsummary: Type.String({ description: \"Self-contained summary replacing the range\" }),\n\t\t\ttopic: Type.Optional(Type.String({ description: \"Short range label\" })),\n\t\t}),\n\t\tasync execute(_toolCallId, args, _signal, _onUpdate, ctx) {\n\t\t\tconst state = createBlock(loadState(ctx), records(ctx), args);\n\t\t\tsaveState(pi, ctx, state);\n\t\t\tconst block = state.blocks.at(-1)!;\n\t\t\treturn textResult(\n\t\t\t\t`Compressed ${block.id}: ${block.messageIds.length} messages, ${block.sourceCharacters} source characters. Use decompress_context with ${block.id} to restore it.`,\n\t\t\t);\n\t\t},\n\t});\n\n\tpi.registerTool({\n\t\tname: \"recompress_context\",\n\t\tlabel: \"Recompress into denser summary\",\n\t\tpromptSnippet:\n\t\t\t\"Condense multiple deactivated blocks into a single denser tier-2 block when context is tight. Parent blocks must be deactivated first.\",\n\t\tpromptGuidelines: [\n\t\t\t\"Deactivate the source blocks with decompress_context before recompressing them.\",\n\t\t\t\"The new summary should be more concise than the individual block summaries combined.\",\n\t\t],\n\t\tdescription:\n\t\t\t\"Combine 2+ deactivated (restored) blocks into a single tier-2 compressed block with a condensed summary. Frees the anchor slot and reduces context overhead.\",\n\t\texecutionMode: \"sequential\",\n\t\tparameters: Type.Object({\n\t\t\tblockIds: Type.Array(Type.String(), {\n\t\t\t\tdescription: 'IDs of deactivated blocks to condense, e.g. [\"b1\", \"b2\"]',\n\t\t\t}),\n\t\t\tsummary: Type.String({ description: \"Condensed summary replacing all parent summaries\" }),\n\t\t\ttopic: Type.Optional(Type.String({ description: \"Short label\" })),\n\t\t}),\n\t\tasync execute(_toolCallId, args, _signal, _onUpdate, ctx) {\n\t\t\tconst state = recompressBlock(loadState(ctx), args.blockIds, args);\n\t\t\tsaveState(pi, ctx, state);\n\t\t\tconst block = state.blocks.at(-1)!;\n\t\t\treturn textResult(\n\t\t\t\t`Recompressed ${args.blockIds.join(\", \")} into ${block.id} [T2]: ${block.messageIds.length} messages, ${block.sourceCharacters} source characters.`,\n\t\t\t);\n\t\t},\n\t});\n\n\tpi.registerTool({\n\t\tname: \"decompress_context\",\n\t\tlabel: \"Restore context range\",\n\t\tdescription:\n\t\t\t\"Restore a previously compressed block for future model calls. Returns a bounded preview immediately; original session entries are never deleted.\",\n\t\texecutionMode: \"sequential\",\n\t\tparameters: Type.Object({ blockId: Type.String({ description: \"Active block ID, such as b1\" }) }),\n\t\tasync execute(_toolCallId, args, _signal, _onUpdate, ctx) {\n\t\t\tconst state = loadState(ctx);\n\t\t\tconst block = activeBlocks(state).find((candidate) => candidate.id === args.blockId);\n\t\t\tif (!block) throw new Error(`active block ${args.blockId} not found`);\n\t\t\tconst next = deactivateBlock(state, args.blockId);\n\t\t\tsaveState(pi, ctx, next);\n\t\t\treturn textResult(`Restored ${args.blockId}. Preview:\\n${blockPreview(records(ctx), block)}`);\n\t\t},\n\t});\n\n\tpi.registerTool({\n\t\tname: \"context_status\",\n\t\tlabel: \"Context pruning status\",\n\t\tdescription: \"Show active compressed ranges and context usage.\",\n\t\tparameters: Type.Object({}),\n\t\tasync execute(_toolCallId, _args, _signal, _onUpdate, ctx) {\n\t\t\tconst state = loadState(ctx);\n\t\t\tconst blocks = activeBlocks(state);\n\t\t\tconst usage = ctx.getContextUsage();\n\t\t\tconst lines = blocks.map(\n\t\t\t\t(block) =>\n\t\t\t\t\t`${block.id} [T${block.tier || 1}]: ${block.messageIds.length} messages, ${block.sourceCharacters} source chars${block.topic ? `, ${block.topic}` : \"\"}${block.parentBlockIds ? `, from ${block.parentBlockIds.join(\", \")}` : \"\"}`,\n\t\t\t);\n\t\t\treturn textResult(\n\t\t\t\t[\n\t\t\t\t\t`Active compressed blocks: ${blocks.length}.`,\n\t\t\t\t\tusage?.percent == null ? \"Context usage unavailable.\" : `Context usage: ${Math.round(usage.percent)}%.`,\n\t\t\t\t\tlines.join(\"\\n\") || \"No ranges compressed.\",\n\t\t\t\t].join(\"\\n\"),\n\t\t\t);\n\t\t},\n\t});\n\n\tpi.registerTool({\n\t\tname: \"search_context\",\n\t\tlabel: \"Search compressed context\",\n\t\tdescription: \"Search active compressed summaries before restoring a block.\",\n\t\tparameters: Type.Object({ query: Type.String({ description: \"Words to search\" }) }),\n\t\tasync execute(_toolCallId, args, _signal, _onUpdate, ctx) {\n\t\t\tconst results = searchBlocks(loadState(ctx), args.query);\n\t\t\tif (!results.length) return textResult(\"No matching compressed blocks.\");\n\t\t\treturn textResult(\n\t\t\t\tresults\n\t\t\t\t\t.map(\n\t\t\t\t\t\t({ block }) =>\n\t\t\t\t\t\t\t`${block.id}${block.topic ? ` (${block.topic})` : \"\"}: ${block.summary.slice(0, 1_000)}`,\n\t\t\t\t\t)\n\t\t\t\t\t.join(\"\\n\\n\"),\n\t\t\t);\n\t\t},\n\t});\n\n\tpi.registerTool({\n\t\tname: \"update_memory\",\n\t\tlabel: \"Update project memory\",\n\t\tdescription:\n\t\t\t\"Add or update a section in the project memory file. Sections are delimited by ## headers. Replaces existing content for the same section name.\",\n\t\tpromptSnippet:\n\t\t\t\"Save durable project context to the project memory file before compression or when you learn something worth keeping across sessions.\",\n\t\tpromptGuidelines: [\n\t\t\t\"Keep entries concise and scoped to what matters long-term.\",\n\t\t\t\"Use existing section names to update them or new names to create sections.\",\n\t\t\t\"The file survives session resets and compactions — write decisions, conventions, gotchas, and preferences.\",\n\t\t],\n\t\texecutionMode: \"sequential\",\n\t\tparameters: Type.Object({\n\t\t\tsection: Type.String({ description: \"Section name without ## prefix, e.g. Guidelines or Open work\" }),\n\t\t\tcontent: Type.String({ description: \"Section body as markdown\" }),\n\t\t}),\n\t\tasync execute(_toolCallId, args, _signal, _onUpdate, ctx) {\n\t\t\tconst filePath = memoryFilePath(ctx);\n\t\t\tlet existing = \"\";\n\t\t\ttry {\n\t\t\t\texisting = await readFile(filePath, \"utf8\");\n\t\t\t} catch {\n\t\t\t\t// memory file may not exist yet\n\t\t\t}\n\t\t\tconst content = args.content.trim().replace(/^(## )/gm, \"\\\\$1\");\n\t\t\tconst header = `## ${args.section}`;\n\t\t\tconst sectionPattern = new RegExp(\n\t\t\t\t`(?:^|\\n)${header.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\")}\\n.*?(?=\\n## |\\n*$)`,\n\t\t\t\t\"ds\",\n\t\t\t);\n\t\t\tconst newSection = `\\n${header}\\n${content}`;\n\t\t\tlet updated: string;\n\t\t\tif (sectionPattern.test(existing)) {\n\t\t\t\tupdated = existing.replace(sectionPattern, newSection);\n\t\t\t} else {\n\t\t\t\tupdated = existing.trimEnd() + newSection;\n\t\t\t}\n\t\t\tif (updated.length > MAX_MEMORY_CHARS) {\n\t\t\t\treturn textResult(\n\t\t\t\t\t`Update skipped: memory would be ${updated.length} characters (max ${MAX_MEMORY_CHARS}). Shorten the content or remove old sections.`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tawait writeFile(filePath, updated, \"utf8\");\n\t\t\treturn textResult(`Memory section \"${args.section}\" updated.`);\n\t\t},\n\t});\n}\n"]}
|
|
1
|
+
{"version":3,"file":"compress_context.js","sourceRoot":"","sources":["../../../src/extensions/context-pruning/compress_context.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile, writeFile } from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport type { AgentMessage } from \"@punch-bot/agent\";\nimport { Type } from \"typebox\";\nimport type { ExtensionAPI, ExtensionContext } from \"../../core/extensions/types.ts\";\nimport type { PruningRecord, PruningState } from \"./context-pruning-state.ts\";\nimport {\n\tactiveBlocks,\n\tactiveMessageIds,\n\tblockPreview,\n\tcreateBlock,\n\tdeactivateBlock,\n\temptyState,\n\tmessageRecords,\n\tnormalizeState,\n\trecompressBlock,\n\tSTATE_TYPE,\n\tsearchBlocks,\n} from \"./context-pruning-state.ts\";\n\nconst MAX_MEMORY_CHARS = 12_000;\n\nfunction memoryFilePath(ctx: ExtensionContext): string {\n\treturn process.env.PI_MEMORY_FILE || path.join(ctx.cwd, \".punch-memory.md\");\n}\n\nconst textResult = (text: string) => ({ content: [{ type: \"text\" as const, text }], details: {} });\n\nfunction loadState(ctx: ExtensionContext): PruningState {\n\tconst entries = ctx.sessionManager.getBranch();\n\tfor (let index = entries.length - 1; index >= 0; index -= 1) {\n\t\tconst entry = entries[index] as { type?: string; customType?: string; data?: unknown } | undefined;\n\t\tif (entry?.type === \"custom\" && entry.customType === STATE_TYPE) return normalizeState(entry.data);\n\t}\n\treturn emptyState();\n}\n\nfunction saveState(pi: ExtensionAPI, _ctx: ExtensionContext, state: PruningState) {\n\tpi.appendEntry(STATE_TYPE, state);\n}\n\nfunction records(ctx: ExtensionContext): PruningRecord[] {\n\treturn messageRecords(ctx.sessionManager.buildContextEntries());\n}\n\nfunction messageSignature(message: { role?: string; content?: unknown; toolCallId?: string; toolName?: string }) {\n\treturn JSON.stringify({\n\t\trole: message?.role,\n\t\tcontent: message?.content,\n\t\ttoolCallId: message?.toolCallId,\n\t\ttoolName: message?.toolName,\n\t});\n}\n\nfunction matchEntryIds(ctx: ExtensionContext, messages: Array<{ role?: string; content?: unknown }>) {\n\tconst idsBySignature = new Map<string, string[]>();\n\tfor (const record of records(ctx)) {\n\t\tconst signature = messageSignature(record.message);\n\t\tconst ids = idsBySignature.get(signature) ?? [];\n\t\tids.push(record.id);\n\t\tidsBySignature.set(signature, ids);\n\t}\n\treturn messages.map((message) => idsBySignature.get(messageSignature(message))?.shift());\n}\n\nfunction addMessageId(message: AgentMessage, id: string): AgentMessage {\n\tif (message.role !== \"user\") return message;\n\tconst marker = `\\n\\n<punch-message-id>${id}</punch-message-id>`;\n\tif (!(\"content\" in message)) return message;\n\tif (typeof message.content === \"string\") return { ...message, content: `${message.content}${marker}` };\n\tif (Array.isArray(message.content)) {\n\t\treturn { ...message, content: [...message.content, { type: \"text\", text: marker }] };\n\t}\n\treturn message;\n}\n\nfunction compressedSummary(block: PruningState[\"blocks\"][number]): AgentMessage {\n\tconst topic = block.topic ? `: ${block.topic}` : \"\";\n\treturn {\n\t\trole: \"custom\",\n\t\tcustomType: STATE_TYPE,\n\t\tcontent: `<compressed-context id=\"${block.id}\">${topic}\\n${block.summary}\\n</compressed-context>`,\n\t\tdisplay: false,\n\t\ttimestamp: Date.now(),\n\t};\n}\n\nexport default function contextPruningExtension(pi: ExtensionAPI): void {\n\tpi.on(\"before_agent_start\", (event, ctx) => {\n\t\tconst threshold = Number(process.env.PI_CONTEXT_PRUNING_THRESHOLD || 0);\n\t\tconst usage = ctx.getContextUsage();\n\t\tconst nudge =\n\t\t\tthreshold > 0 && usage?.percent != null && usage.percent >= threshold\n\t\t\t\t? `\\n\\n## Context pruning now\\nUsage ${Math.round(usage.percent)}% — compress stale complete ranges with compress_context before continuing. Keep current work and recent turns raw.`\n\t\t\t\t: \"\";\n\t\tif (!nudge) return;\n\t\tevent.systemPromptOptions.sections.context_pruning = nudge.trim();\n\t});\n\n\tpi.on(\"context\", (event, ctx) => {\n\t\tconst state = loadState(ctx);\n\t\tconst blocks = activeBlocks(state);\n\t\tconst ids = matchEntryIds(ctx, event.messages);\n\t\tconst hidden = activeMessageIds(state);\n\t\tif ([...hidden].some((id) => !ids.includes(id))) {\n\t\t\treturn {\n\t\t\t\tmessages: event.messages.map((message, index) =>\n\t\t\t\t\tids[index] ? addMessageId(message, ids[index]!) : message,\n\t\t\t\t),\n\t\t\t};\n\t\t}\n\n\t\tconst byAnchor = new Map(blocks.map((block) => [block.anchorId, block]));\n\t\tconst messages: typeof event.messages = [];\n\t\tfor (let index = 0; index < event.messages.length; index += 1) {\n\t\t\tconst id = ids[index];\n\t\t\tconst block = id ? byAnchor.get(id) : undefined;\n\t\t\tif (block) messages.push(compressedSummary(block));\n\t\t\tif (id && hidden.has(id)) continue;\n\t\t\tmessages.push(id ? addMessageId(event.messages[index], id) : event.messages[index]);\n\t\t}\n\t\treturn { messages };\n\t});\n\n\tpi.registerTool({\n\t\tname: \"compress_context\",\n\t\tlabel: \"Compress context range\",\n\t\tpromptSnippet:\n\t\t\t\"Compress stale complete conversation ranges when context is crowded; use visible punch-message-id values.\",\n\t\tpromptGuidelines: [\n\t\t\t\"Before compression, save durable project facts to the project memory file.\",\n\t\t\t\"Only compress complete stale user-turn ranges. Keep active task discussion and recent turns visible.\",\n\t\t\t\"Supply a self-contained summary. The original session remains retrievable with decompress_context.\",\n\t\t\t\"Do not compress ranges that contain compression or task tools (compress_context, decompress_context, recompress_context, context_status, search_context, task). Those turns are protected.\",\n\t\t],\n\t\tdescription:\n\t\t\t\"Replace a stale range of complete conversation turns with your summary for future model calls. Boundaries must be visible user-message IDs. Original session entries remain intact and can be restored with decompress_context.\",\n\t\texecutionMode: \"sequential\",\n\t\tparameters: Type.Object({\n\t\t\tstartId: Type.String({ description: \"Earlier visible user punch-message-id\" }),\n\t\t\tendId: Type.String({ description: \"Later visible user punch-message-id\" }),\n\t\t\tsummary: Type.String({ description: \"Self-contained summary replacing the range\" }),\n\t\t\ttopic: Type.Optional(Type.String({ description: \"Short range label\" })),\n\t\t}),\n\t\tasync execute(_toolCallId, args, _signal, _onUpdate, ctx) {\n\t\t\tconst state = createBlock(loadState(ctx), records(ctx), args);\n\t\t\tsaveState(pi, ctx, state);\n\t\t\tconst block = state.blocks.at(-1)!;\n\t\t\treturn textResult(\n\t\t\t\t`Compressed ${block.id}: ${block.messageIds.length} messages, ${block.sourceCharacters} source characters. Use decompress_context with ${block.id} to restore it.`,\n\t\t\t);\n\t\t},\n\t});\n\n\tpi.registerTool({\n\t\tname: \"recompress_context\",\n\t\tlabel: \"Recompress into denser summary\",\n\t\tpromptSnippet:\n\t\t\t\"Condense multiple deactivated blocks into a single denser tier-2 block when context is tight. Parent blocks must be deactivated first.\",\n\t\tpromptGuidelines: [\n\t\t\t\"Deactivate the source blocks with decompress_context before recompressing them.\",\n\t\t\t\"The new summary should be more concise than the individual block summaries combined.\",\n\t\t],\n\t\tdescription:\n\t\t\t\"Combine 2+ deactivated (restored) blocks into a single tier-2 compressed block with a condensed summary. Frees the anchor slot and reduces context overhead.\",\n\t\texecutionMode: \"sequential\",\n\t\tparameters: Type.Object({\n\t\t\tblockIds: Type.Array(Type.String(), {\n\t\t\t\tdescription: 'IDs of deactivated blocks to condense, e.g. [\"b1\", \"b2\"]',\n\t\t\t}),\n\t\t\tsummary: Type.String({ description: \"Condensed summary replacing all parent summaries\" }),\n\t\t\ttopic: Type.Optional(Type.String({ description: \"Short label\" })),\n\t\t}),\n\t\tasync execute(_toolCallId, args, _signal, _onUpdate, ctx) {\n\t\t\tconst state = recompressBlock(loadState(ctx), args.blockIds, args);\n\t\t\tsaveState(pi, ctx, state);\n\t\t\tconst block = state.blocks.at(-1)!;\n\t\t\treturn textResult(\n\t\t\t\t`Recompressed ${args.blockIds.join(\", \")} into ${block.id} [T2]: ${block.messageIds.length} messages, ${block.sourceCharacters} source characters.`,\n\t\t\t);\n\t\t},\n\t});\n\n\tpi.registerTool({\n\t\tname: \"decompress_context\",\n\t\tlabel: \"Restore context range\",\n\t\tdescription:\n\t\t\t\"Restore a previously compressed block for future model calls. Returns a bounded preview immediately; original session entries are never deleted.\",\n\t\texecutionMode: \"sequential\",\n\t\tparameters: Type.Object({ blockId: Type.String({ description: \"Active block ID, such as b1\" }) }),\n\t\tasync execute(_toolCallId, args, _signal, _onUpdate, ctx) {\n\t\t\tconst state = loadState(ctx);\n\t\t\tconst block = activeBlocks(state).find((candidate) => candidate.id === args.blockId);\n\t\t\tif (!block) throw new Error(`active block ${args.blockId} not found`);\n\t\t\tconst next = deactivateBlock(state, args.blockId);\n\t\t\tsaveState(pi, ctx, next);\n\t\t\treturn textResult(`Restored ${args.blockId}. Preview:\\n${blockPreview(records(ctx), block)}`);\n\t\t},\n\t});\n\n\tpi.registerTool({\n\t\tname: \"context_status\",\n\t\tlabel: \"Context pruning status\",\n\t\tdescription: \"Show active compressed ranges and context usage.\",\n\t\tparameters: Type.Object({}),\n\t\tasync execute(_toolCallId, _args, _signal, _onUpdate, ctx) {\n\t\t\tconst state = loadState(ctx);\n\t\t\tconst blocks = activeBlocks(state);\n\t\t\tconst usage = ctx.getContextUsage();\n\t\t\tconst lines = blocks.map(\n\t\t\t\t(block) =>\n\t\t\t\t\t`${block.id} [T${block.tier || 1}]: ${block.messageIds.length} messages, ${block.sourceCharacters} source chars${block.topic ? `, ${block.topic}` : \"\"}${block.parentBlockIds ? `, from ${block.parentBlockIds.join(\", \")}` : \"\"}`,\n\t\t\t);\n\t\t\treturn textResult(\n\t\t\t\t[\n\t\t\t\t\t`Active compressed blocks: ${blocks.length}.`,\n\t\t\t\t\tusage?.percent == null ? \"Context usage unavailable.\" : `Context usage: ${Math.round(usage.percent)}%.`,\n\t\t\t\t\tlines.join(\"\\n\") || \"No ranges compressed.\",\n\t\t\t\t].join(\"\\n\"),\n\t\t\t);\n\t\t},\n\t});\n\n\tpi.registerTool({\n\t\tname: \"search_context\",\n\t\tlabel: \"Search compressed context\",\n\t\tdescription: \"Search active compressed summaries before restoring a block.\",\n\t\tparameters: Type.Object({ query: Type.String({ description: \"Words to search\" }) }),\n\t\tasync execute(_toolCallId, args, _signal, _onUpdate, ctx) {\n\t\t\tconst results = searchBlocks(loadState(ctx), args.query);\n\t\t\tif (!results.length) return textResult(\"No matching compressed blocks.\");\n\t\t\treturn textResult(\n\t\t\t\tresults\n\t\t\t\t\t.map(\n\t\t\t\t\t\t({ block }) =>\n\t\t\t\t\t\t\t`${block.id}${block.topic ? ` (${block.topic})` : \"\"}: ${block.summary.slice(0, 1_000)}`,\n\t\t\t\t\t)\n\t\t\t\t\t.join(\"\\n\\n\"),\n\t\t\t);\n\t\t},\n\t});\n\n\tpi.registerTool({\n\t\tname: \"update_memory\",\n\t\tlabel: \"Update project memory\",\n\t\tdescription:\n\t\t\t\"Add or update a section in the project memory file. Sections are delimited by ## headers. Replaces existing content for the same section name.\",\n\t\tpromptSnippet:\n\t\t\t\"Save durable project context to the project memory file before compression or when you learn something worth keeping across sessions.\",\n\t\tpromptGuidelines: [\n\t\t\t\"Keep entries concise and scoped to what matters long-term.\",\n\t\t\t\"Use existing section names to update them or new names to create sections.\",\n\t\t\t\"The file survives session resets and compactions — write decisions, conventions, gotchas, and preferences.\",\n\t\t],\n\t\texecutionMode: \"sequential\",\n\t\tparameters: Type.Object({\n\t\t\tsection: Type.String({ description: \"Section name without ## prefix, e.g. Guidelines or Open work\" }),\n\t\t\tcontent: Type.String({ description: \"Section body as markdown\" }),\n\t\t}),\n\t\tasync execute(_toolCallId, args, _signal, _onUpdate, ctx) {\n\t\t\tconst filePath = memoryFilePath(ctx);\n\t\t\tlet existing = \"\";\n\t\t\ttry {\n\t\t\t\texisting = await readFile(filePath, \"utf8\");\n\t\t\t} catch {\n\t\t\t\t// memory file may not exist yet\n\t\t\t}\n\t\t\tconst content = args.content.trim().replace(/^(## )/gm, \"\\\\$1\");\n\t\t\tconst header = `## ${args.section}`;\n\t\t\tconst sectionPattern = new RegExp(\n\t\t\t\t`(?:^|\\n)${header.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\")}\\n.*?(?=\\n## |\\n*$)`,\n\t\t\t\t\"ds\",\n\t\t\t);\n\t\t\tconst newSection = `\\n${header}\\n${content}`;\n\t\t\tlet updated: string;\n\t\t\tif (sectionPattern.test(existing)) {\n\t\t\t\tupdated = existing.replace(sectionPattern, newSection);\n\t\t\t} else {\n\t\t\t\tupdated = existing.trimEnd() + newSection;\n\t\t\t}\n\t\t\tif (updated.length > MAX_MEMORY_CHARS) {\n\t\t\t\treturn textResult(\n\t\t\t\t\t`Update skipped: memory would be ${updated.length} characters (max ${MAX_MEMORY_CHARS}). Shorten the content or remove old sections.`,\n\t\t\t\t);\n\t\t\t}\n\t\t\tawait writeFile(filePath, updated, \"utf8\");\n\t\t\treturn textResult(`Memory section \"${args.section}\" updated.`);\n\t\t},\n\t});\n}\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"context-pruning-state.d.ts","sourceRoot":"","sources":["../../../src/extensions/context-pruning/context-pruning-state.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,UAAU,0BAA0B,CAAC;AAClD,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAaxC,eAAO,MAAM,uBAAuB,UAQnC,CAAC;AAEF,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtF;AAED,wBAAgB,UAAU,IAAI,YAAY,CAEzC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAiB3D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAOxD;AAED,wBAAgB,cAAc,CAC7B,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;CAAE,CAAC,GAChF,aAAa,EAAE,CAOjB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,EAAE,CAEhE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAMjE;AAYD,wBAAgB,WAAW,CAC1B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,aAAa,EAAE,EACxB,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrG,YAAY,CAoDd;AAED,wBAAgB,eAAe,CAC9B,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAAE,EAClB,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,YAAY,CAsDd;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,YAAY,CAU7E;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,aAAa,SAAQ,GAAG,MAAM,CAczG;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI;;;IAczE","sourcesContent":["export const STATE_VERSION = 1;\nexport const STATE_TYPE = \"punch-context-pruning\";\nexport const MAX_SUMMARY_CHARS = 16_000;\n\nconst MIN_SUMMARY_ABSOLUTE = 20;\nconst MIN_SUMMARY_RATIO = 0.03;\nconst SMALL_RANGE_CHARS = 500;\nconst PLACEHOLDER_PATTERNS = [\n\t/^\\.\\.\\.$/s,\n\t/^see above$/i,\n\t/^same as above$/i,\n\t/^n\\/a\\.?$/i,\n\t/^\\[(?:placeholder|insert|omitted|truncated)[\\s\\S]*\\]$/i,\n];\n\nexport const PROTECTED_TOOL_PATTERNS = [\n\t/^compress_context$/,\n\t/^decompress_context$/,\n\t/^recompress_context$/,\n\t/^context_status$/,\n\t/^search_context$/,\n\t/^task$/,\n\t/^summarize/,\n];\n\nexport interface PruningBlock {\n\tid: string;\n\ttier: number;\n\tactive: boolean;\n\tanchorId: string;\n\tstartId?: string;\n\tendId?: string;\n\tmessageIds: string[];\n\tparentBlockIds?: string[];\n\ttopic?: string;\n\tsummary: string;\n\tsourceCharacters?: number;\n\tcreatedAt: number;\n\trestoredAt?: number;\n}\n\nexport interface PruningState {\n\tversion: number;\n\tnextBlockId: number;\n\tblocks: PruningBlock[];\n}\n\nexport interface PruningRecord {\n\tid: string;\n\tmessage: { role?: string; content?: unknown; toolCallId?: string; toolName?: string };\n}\n\nexport function emptyState(): PruningState {\n\treturn { version: STATE_VERSION, nextBlockId: 1, blocks: [] };\n}\n\nexport function normalizeState(value: unknown): PruningState {\n\tif (\n\t\t!value ||\n\t\ttypeof value !== \"object\" ||\n\t\t(value as PruningState).version !== STATE_VERSION ||\n\t\t!Array.isArray((value as PruningState).blocks)\n\t) {\n\t\treturn emptyState();\n\t}\n\tconst candidate = value as PruningState;\n\tconst blocks = candidate.blocks.filter(\n\t\t(block) =>\n\t\t\tblock && typeof block.id === \"string\" && Array.isArray(block.messageIds) && typeof block.summary === \"string\",\n\t);\n\tconst nextBlockId =\n\t\tNumber.isInteger(candidate.nextBlockId) && candidate.nextBlockId > 0 ? candidate.nextBlockId : blocks.length + 1;\n\treturn { version: STATE_VERSION, nextBlockId, blocks };\n}\n\nexport function textFromContent(content: unknown): string {\n\tif (typeof content === \"string\") return content;\n\tif (!Array.isArray(content)) return \"\";\n\treturn content\n\t\t.filter((part): part is { type: \"text\"; text: string } => part?.type === \"text\" && typeof part.text === \"string\")\n\t\t.map((part) => part.text)\n\t\t.join(\"\\n\");\n}\n\nexport function messageRecords(\n\tentries: Array<{ type?: string; id?: string; message?: PruningRecord[\"message\"] }>,\n): PruningRecord[] {\n\tconst records: PruningRecord[] = [];\n\tfor (const entry of entries) {\n\t\tif (entry?.type !== \"message\" || !entry.id || !entry.message) continue;\n\t\trecords.push({ id: entry.id, message: entry.message });\n\t}\n\treturn records;\n}\n\nexport function activeBlocks(state: PruningState): PruningBlock[] {\n\treturn normalizeState(state).blocks.filter((block) => block.active !== false);\n}\n\nexport function activeMessageIds(state: PruningState): Set<string> {\n\tconst ids = new Set<string>();\n\tfor (const block of activeBlocks(state)) {\n\t\tfor (const id of block.messageIds) ids.add(id);\n\t}\n\treturn ids;\n}\n\nfunction isValidSummary(summary: string, sourceCharacters: number): boolean {\n\tif (typeof summary !== \"string\" || !summary.trim()) return false;\n\tif (PLACEHOLDER_PATTERNS.some((pattern) => pattern.test(summary.trim()))) return false;\n\tif (summary.trim().length > sourceCharacters) return false;\n\tif (sourceCharacters < SMALL_RANGE_CHARS) return true;\n\tif (summary.trim().length < MIN_SUMMARY_ABSOLUTE) return false;\n\tif (summary.trim().length < sourceCharacters * MIN_SUMMARY_RATIO) return false;\n\treturn true;\n}\n\nexport function createBlock(\n\tstate: PruningState,\n\trecords: PruningRecord[],\n\t{ startId, endId, topic, summary }: { startId: string; endId: string; topic?: string; summary: string },\n): PruningState {\n\tconst next = normalizeState(state);\n\tif (typeof summary !== \"string\" || !summary.trim()) throw new Error(\"summary is required\");\n\tif (summary.length > MAX_SUMMARY_CHARS) throw new Error(`summary exceeds ${MAX_SUMMARY_CHARS} characters`);\n\tconst start = records.findIndex((record) => record.id === startId);\n\tconst end = records.findIndex((record) => record.id === endId);\n\tif (start < 0 || end < 0) throw new Error(\"boundaries must reference current conversation messages\");\n\tif (start > end) throw new Error(\"startId must precede endId\");\n\tif (records[start]?.message?.role !== \"user\" || records[end]?.message?.role !== \"user\") {\n\t\tthrow new Error(\"boundaries must reference user messages\");\n\t}\n\tconst firstUser = records.find((record) => record.message?.role === \"user\");\n\tif (startId === firstUser?.id) throw new Error(\"first user message is protected\");\n\tlet rangeEndExclusive = end + 1;\n\twhile (rangeEndExclusive < records.length && records[rangeEndExclusive]?.message?.role !== \"user\") {\n\t\trangeEndExclusive += 1;\n\t}\n\tconst rangeRecords = records.slice(start, rangeEndExclusive);\n\tconst messageIds = rangeRecords.map((record) => record.id);\n\tif (\n\t\trangeRecords.some((record) => {\n\t\t\tconst toolName = record.message?.toolName;\n\t\t\treturn toolName && PROTECTED_TOOL_PATTERNS.some((pattern) => pattern.test(toolName));\n\t\t})\n\t) {\n\t\tthrow new Error(\"range contains protected tool output — decompress or skip that turn\");\n\t}\n\tconst compressed = activeMessageIds(next);\n\tif (messageIds.some((id) => compressed.has(id))) throw new Error(\"range overlaps an active compressed block\");\n\tconst sourceCharacters = rangeRecords.reduce(\n\t\t(total, record) => total + textFromContent(record.message?.content).length,\n\t\t0,\n\t);\n\tif (!isValidSummary(summary, sourceCharacters)) {\n\t\tthrow new Error(\n\t\t\t`summary is too short, too vague, or longer than source for a ${sourceCharacters}-character range`,\n\t\t);\n\t}\n\tconst block: PruningBlock = {\n\t\tid: `b${next.nextBlockId}`,\n\t\ttier: 1,\n\t\tactive: true,\n\t\tanchorId: startId,\n\t\tstartId,\n\t\tendId,\n\t\tmessageIds,\n\t\ttopic: typeof topic === \"string\" ? topic.slice(0, 120) : \"\",\n\t\tsummary: summary.trim(),\n\t\tsourceCharacters,\n\t\tcreatedAt: Date.now(),\n\t};\n\treturn { ...next, nextBlockId: next.nextBlockId + 1, blocks: [...next.blocks, block] };\n}\n\nexport function recompressBlock(\n\tstate: PruningState,\n\tblockIds: string[],\n\t{ summary, topic }: { summary: string; topic?: string },\n): PruningState {\n\tconst next = normalizeState(state);\n\tif (typeof summary !== \"string\" || !summary.trim()) throw new Error(\"summary is required\");\n\tif (summary.length > MAX_SUMMARY_CHARS) throw new Error(`summary exceeds ${MAX_SUMMARY_CHARS} characters`);\n\tif (!Array.isArray(blockIds) || blockIds.length < 2)\n\t\tthrow new Error(\"need at least 2 deactivated blocks to recompress\");\n\tif (new Set(blockIds).size !== blockIds.length)\n\t\tthrow new Error(\"blockIds must be unique; duplicates are not allowed\");\n\tconst parents: PruningBlock[] = [];\n\tfor (const id of blockIds) {\n\t\tconst block = next.blocks.find((candidate) => candidate.id === id);\n\t\tif (!block) throw new Error(`block ${id} not found`);\n\t\tif (block.active !== false) throw new Error(`block ${id} must be deactivated first`);\n\t\tparents.push(block);\n\t}\n\tconst stateOrder = new Map(next.blocks.map((block, index) => [block.id, index]));\n\tparents.sort(\n\t\t(a, b) => (a.createdAt || 0) - (b.createdAt || 0) || (stateOrder.get(a.id) ?? 0) - (stateOrder.get(b.id) ?? 0),\n\t);\n\tconst allMessageIds: string[] = [];\n\tconst seenIds = new Set<string>();\n\tlet sourceCharacters = 0;\n\tfor (const block of parents) {\n\t\tfor (const id of block.messageIds) {\n\t\t\tif (seenIds.has(id)) {\n\t\t\t\tthrow new Error(`parent blocks overlap on message ${id}; deactivated blocks must not share message ids`);\n\t\t\t}\n\t\t\tseenIds.add(id);\n\t\t\tallMessageIds.push(id);\n\t\t}\n\t\tsourceCharacters += block.sourceCharacters || 0;\n\t}\n\tif (!isValidSummary(summary, sourceCharacters)) {\n\t\tthrow new Error(\n\t\t\t`recompressed summary is too short, too vague, or longer than source for ${sourceCharacters} source characters`,\n\t\t);\n\t}\n\tconst firstAnchor = parents[0].anchorId || parents[0].messageIds[0];\n\tif (!firstAnchor) throw new Error(\"parent blocks have no anchor\");\n\tconst active = activeMessageIds(next);\n\tif (allMessageIds.some((id) => active.has(id))) throw new Error(\"some parent message ids are in active blocks\");\n\tconst block: PruningBlock = {\n\t\tid: `b${next.nextBlockId}`,\n\t\ttier: 2,\n\t\tactive: true,\n\t\tanchorId: firstAnchor,\n\t\tparentBlockIds: parents.map((parent) => parent.id),\n\t\tmessageIds: allMessageIds,\n\t\ttopic: typeof topic === \"string\" ? topic.slice(0, 120) : \"\",\n\t\tsummary: summary.trim(),\n\t\tsourceCharacters,\n\t\tcreatedAt: Date.now(),\n\t};\n\treturn { ...next, nextBlockId: next.nextBlockId + 1, blocks: [...next.blocks, block] };\n}\n\nexport function deactivateBlock(state: PruningState, id: string): PruningState {\n\tconst next = normalizeState(state);\n\tlet changed = false;\n\tconst blocks = next.blocks.map((block) => {\n\t\tif (block.id !== id || block.active === false) return block;\n\t\tchanged = true;\n\t\treturn { ...block, active: false, restoredAt: Date.now() };\n\t});\n\tif (!changed) throw new Error(`active block ${id} not found`);\n\treturn { ...next, blocks };\n}\n\nexport function blockPreview(records: PruningRecord[], block: PruningBlock, maxCharacters = 4_000): string {\n\tconst selected = new Set(block.messageIds);\n\tlet text = \"\";\n\tfor (const record of records) {\n\t\tif (!selected.has(record.id)) continue;\n\t\tconst body = textFromContent(record.message?.content).trim();\n\t\tif (!body) continue;\n\t\tconst section = `[${record.message.role}]\\n${body}\\n\\n`;\n\t\tif (text.length + section.length > maxCharacters) {\n\t\t\treturn `${text.slice(0, maxCharacters)}\\n[preview truncated]`;\n\t\t}\n\t\ttext += section;\n\t}\n\treturn text || \"[No text content in this range]\";\n}\n\nexport function searchBlocks(state: PruningState, query: string, limit = 5) {\n\tconst terms = String(query || \"\")\n\t\t.toLowerCase()\n\t\t.split(/\\s+/)\n\t\t.filter(Boolean);\n\tif (!terms.length) return [];\n\treturn activeBlocks(state)\n\t\t.map((block) => {\n\t\t\tconst haystack = `${block.topic}\\n${block.summary}`.toLowerCase();\n\t\t\treturn { block, score: terms.reduce((score, term) => score + (haystack.includes(term) ? 1 : 0), 0) };\n\t\t})\n\t\t.filter((result) => result.score > 0)\n\t\t.sort((a, b) => b.score - a.score || (b.block.createdAt || 0) - (a.block.createdAt || 0))\n\t\t.slice(0, limit);\n}\n"]}
|
|
1
|
+
{"version":3,"file":"context-pruning-state.d.ts","sourceRoot":"","sources":["../../../src/extensions/context-pruning/context-pruning-state.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,UAAU,0BAA0B,CAAC;AAClD,eAAO,MAAM,iBAAiB,QAAS,CAAC;AAaxC,eAAO,MAAM,uBAAuB,UAQnC,CAAC;AAEF,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtF;AAED,wBAAgB,UAAU,IAAI,YAAY,CAEzC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAiB3D;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAOxD;AAED,wBAAgB,cAAc,CAC7B,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;CAAE,CAAC,GAChF,aAAa,EAAE,CAOjB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,EAAE,CAEhE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,CAAC,CAMjE;AAYD,wBAAgB,WAAW,CAC1B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,aAAa,EAAE,EACxB,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrG,YAAY,CAoDd;AAED,wBAAgB,eAAe,CAC9B,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,MAAM,EAAE,EAClB,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,YAAY,CAsDd;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,GAAG,YAAY,CAU7E;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,aAAa,SAAQ,GAAG,MAAM,CAczG;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAI;;;IAczE"}
|