@punch-bot/cli 1.5.1 → 1.5.3
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 +162 -1
- package/README.md +6 -8
- package/dist/bundle/chunks/anthropic-messages-WIBS5YKY.js +6 -0
- package/dist/bundle/chunks/azure-openai-responses-GP5GDEGO.js +2 -0
- package/dist/bundle/chunks/bedrock-converse-stream.js +7 -4
- package/dist/bundle/chunks/chunk-35EHANXE.js +2 -0
- package/dist/bundle/chunks/chunk-3IMHRFLG.js +6 -0
- package/dist/bundle/chunks/chunk-77CRE5SV.js +9 -0
- package/dist/bundle/chunks/chunk-CE33JMCE.js +861 -0
- package/dist/bundle/chunks/{chunk-MYNHUMKE.js → chunk-CXY7BILM.js} +2 -44
- package/dist/bundle/chunks/chunk-EISXNXOQ.js +41 -0
- package/dist/bundle/chunks/chunk-ENMVUQHE.js +26 -0
- package/dist/bundle/chunks/chunk-FFMDRXC4.js +10 -0
- package/dist/bundle/chunks/chunk-GFUN2N5K.js +2 -0
- package/dist/bundle/chunks/chunk-HQH636GU.js +361 -0
- package/dist/bundle/chunks/chunk-IEBK4HQA.js +2 -0
- package/dist/bundle/chunks/chunk-JAJLG57O.js +4 -0
- package/dist/bundle/chunks/{chunk-RROECCMX.js → chunk-LOHGXPCL.js} +2 -2
- package/dist/bundle/chunks/{chunk-CRILLKNU.js → chunk-OV2VGRRS.js} +1 -1
- package/dist/bundle/chunks/chunk-P7FPUEYA.js +2 -0
- package/dist/bundle/chunks/chunk-PDENR63J.js +16 -0
- package/dist/bundle/chunks/chunk-RHOWRSGK.js +2 -0
- package/dist/bundle/chunks/{chunk-HMPP4ECW.js → chunk-UZ3LUZDC.js} +1 -1
- package/dist/bundle/chunks/chunk-WN2D4UD4.js +2 -0
- package/dist/bundle/chunks/chunk-X4T5TGM4.js +82 -0
- package/dist/bundle/chunks/chunk-ZG74NES2.js +2 -0
- package/dist/bundle/chunks/cli-OQNR6ESL.js +53 -0
- package/dist/bundle/chunks/{cloudflare-workers-ai-system-one-JWAAZATQ.js → cloudflare-workers-ai-system-one-36EDUVVN.js} +1 -1
- package/dist/bundle/chunks/codemode-worker.js +2 -0
- package/dist/bundle/chunks/{execute-HXULRBCI.js → execute-EHT55MW7.js} +5 -3
- package/dist/bundle/chunks/github-copilot.js +1 -1
- package/dist/bundle/chunks/{google-generative-ai-EHUU7JII.js → google-generative-ai-KA6FZCHM.js} +1 -1
- package/dist/bundle/chunks/{google-vertex-AFMVUS5C.js → google-vertex-DXKQ4IYR.js} +1 -1
- package/dist/bundle/chunks/image-resize-worker.js +1 -1
- package/dist/bundle/chunks/kimi-coding.js +1 -1
- package/dist/bundle/chunks/{llama-cpp-classify-YVA2UOJG.js → llama-cpp-classify-676UCBOD.js} +1 -1
- package/dist/bundle/chunks/meta.js +1 -1
- package/dist/bundle/chunks/mistral-conversations-PJ56UMXO.js +5 -0
- package/dist/bundle/chunks/openai-codex-responses-DWVG7MAQ.js +10 -0
- package/dist/bundle/chunks/openai-completions-OKI6KBNP.js +7 -0
- package/dist/bundle/chunks/{openai-decisions-GNOLFL74.js → openai-decisions-SO57QA6O.js} +1 -1
- package/dist/bundle/chunks/openai-responses-3HV234HB.js +4 -0
- package/dist/bundle/chunks/{openrouter-images-ZTNVFSL2.js → openrouter-images-5X6D7HFS.js} +1 -1
- package/dist/bundle/chunks/pi-messages-BS5Z34RE.js +8 -0
- package/dist/bundle/chunks/radius.js +1 -1
- package/dist/bundle/chunks/{runtime-R5GXO4CV.js → runtime-74PFKASL.js} +1 -1
- package/dist/bundle/chunks/{typesafe-system-one-I5AHLF6T.js → typesafe-system-one-IPNULX2M.js} +1 -1
- package/dist/bundle/chunks/virtual-modules-2Y422I6U.js +2 -0
- package/dist/bundle/cli-runtime.js +1 -1
- package/dist/bundle/index.js +1 -1
- package/dist/bundle/rpc-entry.js +1 -1
- package/dist/cli/args.d.ts +0 -1
- package/dist/cli/args.d.ts.map +1 -1
- package/dist/cli/args.js +8 -12
- package/dist/cli/args.js.map +1 -1
- package/dist/cli/auth-command.d.ts.map +1 -1
- package/dist/cli/auth-command.js +26 -2
- package/dist/cli/auth-command.js.map +1 -1
- package/dist/cli/auth-login.d.ts +15 -0
- package/dist/cli/auth-login.d.ts.map +1 -0
- package/dist/cli/auth-login.js +232 -0
- package/dist/cli/auth-login.js.map +1 -0
- package/dist/cli/auth-logout.d.ts +14 -0
- package/dist/cli/auth-logout.d.ts.map +1 -0
- package/dist/cli/auth-logout.js +63 -0
- package/dist/cli/auth-logout.js.map +1 -0
- package/dist/cli/auth-terminal.d.ts +17 -0
- package/dist/cli/auth-terminal.d.ts.map +1 -0
- package/dist/cli/auth-terminal.js +63 -0
- package/dist/cli/auth-terminal.js.map +1 -0
- package/dist/cli/project-trust.js +1 -1
- package/dist/cli/project-trust.js.map +1 -1
- package/dist/config.d.ts +10 -2
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +24 -11
- package/dist/config.js.map +1 -1
- package/dist/core/agent-session-runtime.d.ts +5 -0
- package/dist/core/agent-session-runtime.d.ts.map +1 -1
- package/dist/core/agent-session-runtime.js +20 -5
- package/dist/core/agent-session-runtime.js.map +1 -1
- package/dist/core/agent-session.d.ts +31 -15
- package/dist/core/agent-session.d.ts.map +1 -1
- package/dist/core/agent-session.js +158 -71
- package/dist/core/agent-session.js.map +1 -1
- package/dist/core/auth-storage.d.ts.map +1 -1
- package/dist/core/auth-storage.js +3 -2
- 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 +3 -1
- package/dist/core/bash-executor.js.map +1 -1
- package/dist/core/cache-warmer.d.ts +4 -37
- package/dist/core/cache-warmer.d.ts.map +1 -1
- package/dist/core/cache-warmer.js +11 -89
- package/dist/core/cache-warmer.js.map +1 -1
- package/dist/core/compaction/branch-summarization.d.ts +4 -2
- package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
- package/dist/core/compaction/branch-summarization.js +16 -4
- package/dist/core/compaction/branch-summarization.js.map +1 -1
- package/dist/core/compaction/utils.d.ts.map +1 -1
- package/dist/core/compaction/utils.js +2 -1
- package/dist/core/compaction/utils.js.map +1 -1
- package/dist/core/exec.d.ts +9 -1
- package/dist/core/exec.d.ts.map +1 -1
- package/dist/core/exec.js +104 -60
- package/dist/core/exec.js.map +1 -1
- package/dist/core/export-html/template.css +9 -0
- package/dist/core/export-html/template.js +165 -45
- 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/loader.d.ts.map +1 -1
- package/dist/core/extensions/loader.js +10 -13
- package/dist/core/extensions/loader.js.map +1 -1
- package/dist/core/extensions/pi-ai-extension-view.d.ts +19 -0
- package/dist/core/extensions/pi-ai-extension-view.d.ts.map +1 -0
- package/dist/core/extensions/pi-ai-extension-view.js +22 -0
- package/dist/core/extensions/pi-ai-extension-view.js.map +1 -0
- package/dist/core/extensions/runner.d.ts +1 -4
- package/dist/core/extensions/runner.d.ts.map +1 -1
- package/dist/core/extensions/runner.js +0 -14
- package/dist/core/extensions/runner.js.map +1 -1
- package/dist/core/extensions/types.d.ts +5 -18
- package/dist/core/extensions/types.d.ts.map +1 -1
- package/dist/core/extensions/types.js +1 -1
- package/dist/core/extensions/types.js.map +1 -1
- package/dist/core/extensions/virtual-modules.d.ts.map +1 -1
- package/dist/core/extensions/virtual-modules.js +8 -7
- package/dist/core/extensions/virtual-modules.js.map +1 -1
- package/dist/core/index.d.ts +1 -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 +23 -41
- package/dist/core/mcp-servers.d.ts.map +1 -1
- package/dist/core/mcp-servers.js +51 -120
- package/dist/core/mcp-servers.js.map +1 -1
- package/dist/core/model-config.d.ts +1730 -2029
- package/dist/core/model-config.d.ts.map +1 -1
- package/dist/core/model-config.js +2 -3
- package/dist/core/model-config.js.map +1 -1
- package/dist/core/model-resolver.d.ts.map +1 -1
- package/dist/core/model-resolver.js +36 -29
- package/dist/core/model-resolver.js.map +1 -1
- package/dist/core/model-runtime.d.ts +5 -0
- package/dist/core/model-runtime.d.ts.map +1 -1
- package/dist/core/model-runtime.js +11 -4
- package/dist/core/model-runtime.js.map +1 -1
- package/dist/core/package-manager.d.ts +24 -1
- package/dist/core/package-manager.d.ts.map +1 -1
- package/dist/core/package-manager.js +210 -51
- package/dist/core/package-manager.js.map +1 -1
- package/dist/core/pi-ai-schemas.d.ts +167 -0
- package/dist/core/pi-ai-schemas.d.ts.map +1 -0
- package/dist/core/pi-ai-schemas.js +21 -0
- package/dist/core/pi-ai-schemas.js.map +1 -0
- package/dist/core/pi-manifest.d.ts +1 -0
- package/dist/core/pi-manifest.d.ts.map +1 -1
- package/dist/core/pi-manifest.js +4 -0
- package/dist/core/pi-manifest.js.map +1 -1
- package/dist/core/preferred-providers.d.ts +17 -0
- package/dist/core/preferred-providers.d.ts.map +1 -0
- package/dist/core/preferred-providers.js +24 -0
- package/dist/core/preferred-providers.js.map +1 -0
- package/dist/core/project-trust.d.ts +1 -1
- package/dist/core/project-trust.d.ts.map +1 -1
- package/dist/core/project-trust.js +1 -1
- package/dist/core/project-trust.js.map +1 -1
- package/dist/core/prompt-templates.d.ts.map +1 -1
- package/dist/core/prompt-templates.js +18 -2
- package/dist/core/prompt-templates.js.map +1 -1
- package/dist/core/provider-composer.d.ts.map +1 -1
- package/dist/core/provider-composer.js +3 -1
- package/dist/core/provider-composer.js.map +1 -1
- package/dist/core/provider-matching.d.ts +11 -0
- package/dist/core/provider-matching.d.ts.map +1 -0
- package/dist/core/provider-matching.js +14 -0
- package/dist/core/provider-matching.js.map +1 -0
- package/dist/core/radius-mcp.d.ts +13 -0
- package/dist/core/radius-mcp.d.ts.map +1 -0
- package/dist/core/radius-mcp.js +29 -0
- package/dist/core/radius-mcp.js.map +1 -0
- package/dist/core/radius.d.ts +0 -3
- package/dist/core/radius.d.ts.map +1 -1
- package/dist/core/radius.js +0 -5
- package/dist/core/radius.js.map +1 -1
- package/dist/core/remote-catalog-provider.d.ts.map +1 -1
- package/dist/core/remote-catalog-provider.js +2 -0
- package/dist/core/remote-catalog-provider.js.map +1 -1
- package/dist/core/resource-loader.d.ts +4 -1
- package/dist/core/resource-loader.d.ts.map +1 -1
- package/dist/core/resource-loader.js +40 -25
- package/dist/core/resource-loader.js.map +1 -1
- package/dist/core/runtime-credentials.d.ts +8 -0
- package/dist/core/runtime-credentials.d.ts.map +1 -1
- package/dist/core/runtime-credentials.js +15 -1
- package/dist/core/runtime-credentials.js.map +1 -1
- package/dist/core/sdk.d.ts.map +1 -1
- package/dist/core/sdk.js +3 -1
- package/dist/core/sdk.js.map +1 -1
- package/dist/core/session-cwd.d.ts +0 -1
- package/dist/core/session-cwd.d.ts.map +1 -1
- package/dist/core/session-cwd.js +0 -3
- package/dist/core/session-cwd.js.map +1 -1
- package/dist/core/session-manager.d.ts +7 -0
- package/dist/core/session-manager.d.ts.map +1 -1
- package/dist/core/session-manager.js +32 -13
- package/dist/core/session-manager.js.map +1 -1
- package/dist/core/settings-defaults.d.ts +1 -31
- package/dist/core/settings-defaults.d.ts.map +1 -1
- package/dist/core/settings-defaults.js +1 -31
- package/dist/core/settings-defaults.js.map +1 -1
- package/dist/core/settings-manager.d.ts +4 -56
- package/dist/core/settings-manager.d.ts.map +1 -1
- package/dist/core/settings-manager.js +11 -247
- package/dist/core/settings-manager.js.map +1 -1
- package/dist/core/settings-schema.d.ts +4 -54
- package/dist/core/settings-schema.d.ts.map +1 -1
- package/dist/core/settings-schema.js +7 -101
- package/dist/core/settings-schema.js.map +1 -1
- package/dist/core/skills.d.ts.map +1 -1
- package/dist/core/skills.js +6 -14
- package/dist/core/skills.js.map +1 -1
- package/dist/core/slash-commands.d.ts +0 -6
- package/dist/core/slash-commands.d.ts.map +1 -1
- package/dist/core/slash-commands.js +1 -27
- package/dist/core/slash-commands.js.map +1 -1
- package/dist/core/source-info.d.ts +9 -0
- package/dist/core/source-info.d.ts.map +1 -1
- package/dist/core/source-info.js +13 -0
- package/dist/core/source-info.js.map +1 -1
- package/dist/core/system-prompt.d.ts.map +1 -1
- package/dist/core/system-prompt.js +5 -6
- package/dist/core/system-prompt.js.map +1 -1
- package/dist/core/telemetry.js +1 -1
- package/dist/core/telemetry.js.map +1 -1
- package/dist/core/theme/theme.d.ts.map +1 -1
- package/dist/core/theme/theme.js +5 -1
- package/dist/core/theme/theme.js.map +1 -1
- package/dist/core/tools/bash.d.ts +2 -2
- package/dist/core/tools/bash.d.ts.map +1 -1
- package/dist/core/tools/bash.js +35 -5
- package/dist/core/tools/bash.js.map +1 -1
- package/dist/core/tools/edit-diff.d.ts +23 -14
- package/dist/core/tools/edit-diff.d.ts.map +1 -1
- package/dist/core/tools/edit-diff.js +182 -41
- package/dist/core/tools/edit-diff.js.map +1 -1
- package/dist/core/tools/edit.d.ts +3 -3
- package/dist/core/tools/edit.d.ts.map +1 -1
- package/dist/core/tools/edit.js +10 -11
- package/dist/core/tools/edit.js.map +1 -1
- package/dist/core/tools/find.d.ts +2 -2
- package/dist/core/tools/find.d.ts.map +1 -1
- package/dist/core/tools/find.js +82 -36
- package/dist/core/tools/find.js.map +1 -1
- package/dist/core/tools/grep.d.ts +7 -5
- package/dist/core/tools/grep.d.ts.map +1 -1
- package/dist/core/tools/grep.js +87 -75
- package/dist/core/tools/grep.js.map +1 -1
- package/dist/core/tools/ls.d.ts +2 -2
- package/dist/core/tools/ls.d.ts.map +1 -1
- package/dist/core/tools/ls.js +2 -1
- package/dist/core/tools/ls.js.map +1 -1
- package/dist/core/tools/powershell.d.ts.map +1 -1
- package/dist/core/tools/powershell.js +15 -2
- package/dist/core/tools/powershell.js.map +1 -1
- package/dist/core/tools/read.d.ts +10 -2
- package/dist/core/tools/read.d.ts.map +1 -1
- package/dist/core/tools/read.js +141 -25
- package/dist/core/tools/read.js.map +1 -1
- package/dist/core/tools/tool-definition-wrapper.d.ts +11 -1
- package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
- package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
- package/dist/core/tools/truncate.d.ts +4 -14
- package/dist/core/tools/truncate.d.ts.map +1 -1
- package/dist/core/tools/truncate.js +23 -29
- package/dist/core/tools/truncate.js.map +1 -1
- package/dist/core/tools/write.d.ts +2 -2
- package/dist/core/tools/write.d.ts.map +1 -1
- 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 +14 -8
- package/dist/core/trust-manager.js.map +1 -1
- package/dist/core/usage-totals.d.ts.map +1 -1
- package/dist/core/usage-totals.js +2 -0
- package/dist/core/usage-totals.js.map +1 -1
- package/dist/extensions/codemode/execute.js +4 -4
- package/dist/extensions/codemode/execute.js.map +1 -1
- package/dist/extensions/codemode/tool.d.ts +2 -1
- package/dist/extensions/codemode/tool.d.ts.map +1 -1
- package/dist/extensions/codemode/tool.js +59 -12
- package/dist/extensions/codemode/tool.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 +23 -2
- package/dist/extensions/llama/client.js.map +1 -1
- package/dist/extensions/llama/index.d.ts.map +1 -1
- package/dist/extensions/llama/index.js +1 -1
- package/dist/extensions/llama/index.js.map +1 -1
- package/dist/extensions/mcp/cli.d.ts +2 -0
- package/dist/extensions/mcp/cli.d.ts.map +1 -1
- package/dist/extensions/mcp/cli.js +83 -22
- package/dist/extensions/mcp/cli.js.map +1 -1
- package/dist/extensions/mcp/config.d.ts.map +1 -1
- package/dist/extensions/mcp/config.js +4 -7
- package/dist/extensions/mcp/config.js.map +1 -1
- package/dist/extensions/mcp/index.d.ts.map +1 -1
- package/dist/extensions/mcp/index.js +5 -4
- package/dist/extensions/mcp/index.js.map +1 -1
- package/dist/extensions/mcp/oauth.d.ts +11 -49
- package/dist/extensions/mcp/oauth.d.ts.map +1 -1
- package/dist/extensions/mcp/oauth.js +56 -296
- package/dist/extensions/mcp/oauth.js.map +1 -1
- package/dist/extensions/mcp/resources.d.ts +1 -1
- package/dist/extensions/mcp/resources.d.ts.map +1 -1
- package/dist/extensions/mcp/resources.js +4 -3
- package/dist/extensions/mcp/resources.js.map +1 -1
- package/dist/extensions/mcp/runtime.d.ts +4 -3
- package/dist/extensions/mcp/runtime.d.ts.map +1 -1
- package/dist/extensions/mcp/runtime.js +7 -5
- package/dist/extensions/mcp/runtime.js.map +1 -1
- package/dist/extensions/mcp/tools.d.ts +2 -23
- package/dist/extensions/mcp/tools.d.ts.map +1 -1
- package/dist/extensions/mcp/tools.js +6 -58
- package/dist/extensions/mcp/tools.js.map +1 -1
- package/dist/extensions/punch/index.d.ts.map +1 -1
- package/dist/extensions/punch/index.js +1 -1
- package/dist/extensions/punch/index.js.map +1 -1
- package/dist/extensions/punch/todos.js +1 -1
- package/dist/extensions/punch/todos.js.map +1 -1
- package/dist/extensions/subagent/index.d.ts.map +1 -1
- package/dist/extensions/subagent/index.js +278 -129
- package/dist/extensions/subagent/index.js.map +1 -1
- package/dist/extensions/tool-search/tool.d.ts +21 -6
- package/dist/extensions/tool-search/tool.d.ts.map +1 -1
- package/dist/extensions/tool-search/tool.js +122 -42
- package/dist/extensions/tool-search/tool.js.map +1 -1
- package/dist/index.d.ts +4 -4
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/index.js.map +1 -1
- package/dist/main.d.ts.map +1 -1
- package/dist/main.js +106 -14
- package/dist/main.js.map +1 -1
- package/dist/modes/print-mode.d.ts.map +1 -1
- package/dist/modes/print-mode.js +19 -10
- package/dist/modes/print-mode.js.map +1 -1
- package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
- package/dist/modes/rpc/rpc-mode.js +53 -23
- package/dist/modes/rpc/rpc-mode.js.map +1 -1
- package/dist/package-manager-cli.d.ts.map +1 -1
- package/dist/package-manager-cli.js +94 -12
- package/dist/package-manager-cli.js.map +1 -1
- package/dist/utils/ansi.d.ts.map +1 -1
- package/dist/utils/ansi.js +5 -2
- package/dist/utils/ansi.js.map +1 -1
- package/dist/utils/changelog.d.ts +2 -2
- package/dist/utils/changelog.d.ts.map +1 -1
- package/dist/utils/changelog.js +12 -9
- package/dist/utils/changelog.js.map +1 -1
- package/dist/utils/clipboard-command.d.ts.map +1 -1
- package/dist/utils/clipboard-command.js +4 -0
- package/dist/utils/clipboard-command.js.map +1 -1
- package/dist/utils/fuzzy.d.ts.map +1 -1
- package/dist/utils/fuzzy.js +59 -44
- package/dist/utils/fuzzy.js.map +1 -1
- package/dist/utils/git.d.ts +11 -1
- package/dist/utils/git.d.ts.map +1 -1
- package/dist/utils/git.js +44 -0
- package/dist/utils/git.js.map +1 -1
- package/dist/utils/image-resize-core.d.ts.map +1 -1
- package/dist/utils/image-resize-core.js +5 -3
- package/dist/utils/image-resize-core.js.map +1 -1
- package/dist/utils/image-resize.d.ts.map +1 -1
- package/dist/utils/image-resize.js +3 -1
- package/dist/utils/image-resize.js.map +1 -1
- package/dist/utils/open-browser.d.ts.map +1 -1
- package/dist/utils/open-browser.js +4 -1
- package/dist/utils/open-browser.js.map +1 -1
- package/dist/utils/paths.d.ts +17 -0
- package/dist/utils/paths.d.ts.map +1 -1
- package/dist/utils/paths.js +42 -1
- package/dist/utils/paths.js.map +1 -1
- package/dist/utils/shell.d.ts.map +1 -1
- package/dist/utils/shell.js +14 -0
- package/dist/utils/shell.js.map +1 -1
- package/dist/utils/terminal-question.d.ts +8 -0
- package/dist/utils/terminal-question.d.ts.map +1 -0
- package/dist/utils/terminal-question.js +24 -0
- package/dist/utils/terminal-question.js.map +1 -0
- package/dist/utils/text.d.ts +2 -0
- package/dist/utils/text.d.ts.map +1 -1
- package/dist/utils/text.js +5 -0
- package/dist/utils/text.js.map +1 -1
- package/dist/utils/tools-manager.d.ts.map +1 -1
- package/dist/utils/tools-manager.js +30 -35
- package/dist/utils/tools-manager.js.map +1 -1
- package/dist/utils/web-url.d.ts +12 -0
- package/dist/utils/web-url.d.ts.map +1 -0
- package/dist/utils/web-url.js +20 -0
- package/dist/utils/web-url.js.map +1 -0
- package/docs/cli-integration.md +3 -5
- package/docs/cli.md +45 -26
- package/docs/compaction.md +9 -9
- package/docs/configuration.md +1 -2
- package/docs/containerization.md +16 -14
- package/docs/custom-provider.md +5 -3
- package/docs/docs.json +9 -9
- package/docs/environment-variables.md +5 -12
- package/docs/extensions.md +683 -757
- package/docs/how-pi-works.md +5 -5
- package/docs/index.md +5 -5
- package/docs/llama-cpp.md +41 -39
- package/docs/mcp.md +12 -10
- package/docs/message-types.md +1 -1
- package/docs/models-configuration.md +6 -1
- package/docs/models.md +18 -19
- package/docs/nvidia-rtx-llama-cpp.md +1 -1
- package/docs/packages.md +21 -1
- package/docs/prompt-templates.md +11 -9
- package/docs/providers.md +8 -8
- package/docs/quickstart.md +28 -52
- package/docs/rpc-commands.md +2 -2
- package/docs/rpc-extension-ui.md +5 -7
- package/docs/rpc.md +4 -2
- package/docs/sdk.md +1 -1
- package/docs/security.md +9 -5
- package/docs/session-format.md +7 -9
- package/docs/sessions.md +26 -26
- package/docs/settings.md +36 -67
- package/docs/shell-aliases.md +7 -7
- package/docs/skills.md +4 -4
- package/docs/slash-commands.md +50 -58
- package/docs/termux.md +8 -9
- package/docs/themes.md +21 -41
- package/docs/usage.md +59 -177
- package/docs/virtual-models.md +4 -4
- package/docs/windows.md +8 -10
- package/examples/extensions/README.md +3 -2
- package/examples/extensions/custom-provider-anthropic/index.ts +27 -31
- package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
- package/examples/extensions/custom-provider-anthropic/package.json +1 -1
- package/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
- package/examples/extensions/gondolin/package-lock.json +16 -26
- package/examples/extensions/gondolin/package.json +2 -2
- package/examples/extensions/reload-runtime.ts +17 -5
- package/examples/extensions/rpc-demo.ts +2 -2
- package/examples/extensions/subagent/README.md +14 -11
- package/examples/extensions/with-deps/package-lock.json +2 -2
- package/examples/extensions/with-deps/package.json +1 -1
- package/examples/tsconfig.json +208 -0
- package/npm-shrinkwrap.json +32 -34
- package/package.json +12 -14
- package/schemas/models.schema.json +65 -36
- package/schemas/settings.schema.json +17 -243
- package/dist/bundle/chunks/anthropic-messages-WAYXCPZL.js +0 -6
- package/dist/bundle/chunks/azure-openai-responses-LUIPKPFC.js +0 -2
- package/dist/bundle/chunks/chunk-275CIYA5.js +0 -16
- package/dist/bundle/chunks/chunk-2W2ATKZM.js +0 -2
- package/dist/bundle/chunks/chunk-3V45WARH.js +0 -7
- package/dist/bundle/chunks/chunk-4LBJE4YM.js +0 -14
- package/dist/bundle/chunks/chunk-4NE64BTO.js +0 -82
- package/dist/bundle/chunks/chunk-7SFLP7ZK.js +0 -1197
- package/dist/bundle/chunks/chunk-BQU3RKDL.js +0 -2
- package/dist/bundle/chunks/chunk-NJK3U3WK.js +0 -8
- package/dist/bundle/chunks/chunk-NQWQE4BR.js +0 -11
- package/dist/bundle/chunks/chunk-TEPMHNKQ.js +0 -2
- package/dist/bundle/chunks/chunk-TRN3ET6M.js +0 -2
- package/dist/bundle/chunks/chunk-UE7JCDFW.js +0 -2
- package/dist/bundle/chunks/chunk-UKVNB6C4.js +0 -2
- package/dist/bundle/chunks/chunk-USJZMAIR.js +0 -2
- package/dist/bundle/chunks/cli-W5KJM7YB.js +0 -51
- package/dist/bundle/chunks/mistral-conversations-FEBYNTL2.js +0 -5
- package/dist/bundle/chunks/openai-codex-responses-MI7TTP3C.js +0 -10
- package/dist/bundle/chunks/openai-completions-BVORSTAM.js +0 -7
- package/dist/bundle/chunks/openai-responses-TLIV5OQA.js +0 -4
- package/dist/bundle/chunks/pi-messages-4MVQCGGY.js +0 -8
- package/dist/bundle/chunks/virtual-modules-QK7S56IZ.js +0 -2
- package/dist/core/bug-report-upload.d.ts +0 -12
- package/dist/core/bug-report-upload.d.ts.map +0 -1
- package/dist/core/bug-report-upload.js +0 -22
- package/dist/core/bug-report-upload.js.map +0 -1
- package/dist/core/bug-report.d.ts +0 -184
- package/dist/core/bug-report.d.ts.map +0 -1
- package/dist/core/bug-report.js +0 -292
- package/dist/core/bug-report.js.map +0 -1
- package/dist/core/crash-log.d.ts +0 -27
- package/dist/core/crash-log.d.ts.map +0 -1
- package/dist/core/crash-log.js +0 -140
- package/dist/core/crash-log.js.map +0 -1
- package/dist/core/footer-data-provider.d.ts +0 -64
- package/dist/core/footer-data-provider.d.ts.map +0 -1
- package/dist/core/footer-data-provider.js +0 -338
- package/dist/core/footer-data-provider.js.map +0 -1
- package/dist/utils/zip.d.ts +0 -7
- package/dist/utils/zip.d.ts.map +0 -1
- package/dist/utils/zip.js +0 -60
- package/dist/utils/zip.js.map +0 -1
- package/docs/images/interactive-mode.png +0 -0
- package/docs/images/tree-view.png +0 -0
- package/docs/keybindings.md +0 -194
- package/docs/terminal-setup.md +0 -17
- package/docs/tmux.md +0 -55
- package/docs/tui.md +0 -125
- package/examples/extensions/sandbox/index.ts +0 -321
- package/examples/extensions/sandbox/package-lock.json +0 -66
- package/examples/extensions/sandbox/package.json +0 -22
package/docs/settings.md
CHANGED
|
@@ -16,11 +16,9 @@ Add `"$schema": "https://raw.githubusercontent.com/punch-bot/core/main/packages/
|
|
|
16
16
|
| `modelThinkingLevels` | object | None | Per-model startup thinking levels keyed by exact `provider/modelId`. |
|
|
17
17
|
| `thinkingBudgets` | object | Built-in budgets | Token budgets for `minimal`, `low`, `medium`, and `high` thinking levels. |
|
|
18
18
|
| `enabledModels` | `string[]` | All available models | Model patterns or globs used for startup selection and model cycling. Uses the same format as `--models`; stale entries are skipped with a warning. |
|
|
19
|
-
| `
|
|
20
|
-
| `showCacheMissNotices` | boolean | `false` | Show notices for significant cache misses, successful cache warming, compaction usage, and provider recovery. |
|
|
21
|
-
| `cacheWarming` | `"off" \| "streaming" \| "idle"` | `"streaming"` | Keep eligible provider prompt caches warm during active runs or, with `"idle"`, between runs. Global setting only. |
|
|
19
|
+
| `cacheWarming` | `"off" \| "streaming" \| "idle"` | `"idle"` | Keep eligible provider prompt caches warm during active runs and, with `"idle"`, for up to 30 minutes between runs. `"streaming"` warms only during active runs. Global setting only. |
|
|
22
20
|
|
|
23
|
-
Cache warming runs only when the model declares a cache lifetime and Pi estimates at least $0.05 in avoided cache-miss cost. Refresh usage counts toward session totals but does not enter model context.
|
|
21
|
+
Cache warming runs only when the model declares a cache lifetime and Pi estimates at least $0.05 in avoided cache-miss cost. Refresh usage counts toward session totals but does not enter model context. Extensions can override the decision with `cache_warming_decision`. See [Prompt Cache Lifetimes](models.md#prompt-cache-lifetimes).
|
|
24
22
|
|
|
25
23
|
See [Choose a Model](models.md) for model selection and thinking controls.
|
|
26
24
|
|
|
@@ -30,9 +28,6 @@ See [Choose a Model](models.md) for model selection and thinking controls.
|
|
|
30
28
|
|---|---|---|---|
|
|
31
29
|
| `steeringMode` | `"all" \| "one-at-a-time"` | `"one-at-a-time"` | How queued steering messages are delivered. |
|
|
32
30
|
| `followUpMode` | `"all" \| "one-at-a-time"` | `"one-at-a-time"` | How queued follow-up messages are delivered. |
|
|
33
|
-
| `externalEditor` | string | `$VISUAL`, `$EDITOR`, then platform default | Command opened by the external-editor keybinding. |
|
|
34
|
-
| `doubleEscapeAction` | `"tree" \| "fork" \| "none"` | `"tree"` | Action for double Escape with an empty editor. |
|
|
35
|
-
| `treeFilterMode` | `"default" \| "no-tools" \| "user-only" \| "labeled-only" \| "all"` | `"default"` | Initial filter used by `/tree`. |
|
|
36
31
|
| `defaultProjectTrust` | `"ask" \| "always" \| "never"` | `"ask"` | Fallback project-trust behavior. **Can only be set in agent-directory settings.** |
|
|
37
32
|
|
|
38
33
|
## Tools
|
|
@@ -55,9 +50,9 @@ A list of only `+name` and `-name` entries changes the inherited selection inste
|
|
|
55
50
|
|
|
56
51
|
This replaces `bash` with `powershell` and enables `grep`: `["-bash", "+powershell", "+grep"]`. Project settings apply on top of user settings: a project list with only `+name` and `-name` entries changes the user's selection, and a project list with a plain name replaces it. In one list, plain names form the selection, and `+name` and `-name` then apply in order.
|
|
57
52
|
|
|
58
|
-
|
|
53
|
+
Reloading a running session with an extension command's `ctx.reload()` enables tools newly added to `defaultTools`. It does not disable tools removed from it or re-enable unchanged tools you turned off. `--tools` with plain names, `--no-tools`, and `--no-builtin-tools` override `defaultTools`, also on reload.
|
|
59
54
|
|
|
60
|
-
CLI tool options override this setting for one invocation. `--tools` with only `+name` and `-name` entries changes the resolved `defaultTools` selection instead, for example `pi --tools +codemode`. On
|
|
55
|
+
CLI tool options override this setting for one invocation. `--tools` with only `+name` and `-name` entries changes the resolved `defaultTools` selection instead, for example `pi --tools +codemode`. On reload, these entries apply to the reloaded setting too, so a tool removed with `-name` stays removed. See [Command Line](cli.md#tools).
|
|
61
56
|
|
|
62
57
|
## Sessions and context
|
|
63
58
|
|
|
@@ -83,72 +78,50 @@ See [Compaction Reference](compaction.md) for trigger, summarization, and valida
|
|
|
83
78
|
### Branch summaries
|
|
84
79
|
|
|
85
80
|
| Setting | Type | Default | Description |
|
|
86
|
-
|
|
87
|
-
| `
|
|
88
|
-
| `terminal.imageWidthCells` | number | `60` | Preferred inline image width in terminal cells |
|
|
89
|
-
| `terminal.clearOnShrink` | boolean | `false` | Clear empty rows when content shrinks (can cause flicker) |
|
|
90
|
-
| `terminal.trueColor` | boolean or `"auto"` | `"auto"` | Override truecolor support (advanced, JSON-only) |
|
|
91
|
-
| `images.autoResize` | boolean | `true` | Resize images to 2000x2000 max. Applies to `@file` attachments, `read`, and images returned by tools |
|
|
92
|
-
| `images.blockImages` | boolean | `false` | Block all images from being sent to LLM |
|
|
93
|
-
|
|
94
|
-
### Shell
|
|
95
|
-
|
|
96
|
-
| Setting | Type | Default | Description |
|
|
97
|
-
|---------|------|---------|-------------|
|
|
98
|
-
| `shellPath` | string | - | Custom shell path (e.g., for Cygwin on Windows); supports a leading `~` for the home directory |
|
|
99
|
-
| `shellCommandPrefix` | string | - | Prefix for every bash command (e.g., `"shopt -s expand_aliases"`) |
|
|
100
|
-
| `npmCommand` | string[] | - | Command argv used for npm package lookup/install operations (e.g., `["mise", "exec", "node@20", "--", "npm"]`) |
|
|
81
|
+
|---|---|---|---|
|
|
82
|
+
| `branchSummary.reserveTokens` | number | `16384` | Tokens reserved when summarizing branch history. |
|
|
101
83
|
|
|
102
|
-
|
|
84
|
+
<a id="terminal-and-display"></a>
|
|
103
85
|
|
|
104
|
-
##
|
|
86
|
+
## Themes and images
|
|
105
87
|
|
|
106
88
|
| Setting | Type | Default | Description |
|
|
107
89
|
|---|---|---|---|
|
|
108
|
-
| `theme` | string | `"system"` | Built-in or custom theme name
|
|
109
|
-
| `
|
|
110
|
-
| `
|
|
111
|
-
| `fullscreenExitOutput` | `"transcript" \| "resume-hint"` | `"transcript"` | Output printed when fullscreen mode exits. |
|
|
112
|
-
| `fullscreenScrollbar` | `"auto" \| "always" \| "hidden"` | `"auto"` | Fullscreen transcript scrollbar behavior. |
|
|
113
|
-
| `fullscreenCopyOnSelect` | boolean | `true` | Copy selected text automatically in fullscreen mode. |
|
|
114
|
-
| `fullscreenWheelScrollLines` | `"auto"` \| number | `"auto"` | Lines per mouse-wheel event in fullscreen mode, from 1 to 100. `"auto"` moves one line per event in local macOS terminals, which already accelerate wheel and trackpad input; elsewhere, and over SSH, it speeds up fast wheel spins to at most 6 lines per event. Alt+wheel moves five times as far. |
|
|
115
|
-
| `editorPaddingX` | number | `0` | Horizontal editor padding from 0 to 3 cells. |
|
|
116
|
-
| `outputPad` | `0 \| 1` | `1` | Horizontal transcript padding. |
|
|
117
|
-
| `autocompleteMaxVisible` | number | `5` | Visible autocomplete entries, from 3 to 20. |
|
|
118
|
-
| `showHardwareCursor` | boolean | `false` | Use the terminal cursor instead of Pi's drawn cursor. Pi still positions it for input methods. |
|
|
119
|
-
| `terminal.showImages` | boolean | `true` | Display inline images when supported. |
|
|
120
|
-
| `terminal.imageWidthCells` | number | `60` | Preferred inline image width in terminal cells. |
|
|
121
|
-
| `terminal.clearOnShrink` | boolean | `false` | Clear empty rows when rendered content shrinks. |
|
|
122
|
-
| `terminal.showTerminalProgress` | boolean | `false` | Show OSC 9;4 progress in the terminal tab. |
|
|
123
|
-
| `terminal.hyperlinks` | `boolean \| "auto"` | `"auto"` | Override OSC 8 hyperlink detection. |
|
|
124
|
-
| `terminal.images` | `"kitty" \| "iterm2" \| "auto" \| false` | `"auto"` | Override inline-image protocol detection. |
|
|
125
|
-
| `terminal.trueColor` | `boolean \| "auto"` | `"auto"` | Override true-color detection. |
|
|
126
|
-
| `images.autoResize` | boolean | `true` | Resize images to at most 2000 by 2000 pixels before sending them to a model. |
|
|
90
|
+
| `theme` | string | `"system"` | Built-in or custom theme name for HTML exports and extension colors. |
|
|
91
|
+
| `terminal.trueColor` | `boolean \| "auto"` | `"auto"` | Override truecolor detection. JSON-only. |
|
|
92
|
+
| `images.autoResize` | boolean | `true` | Resize images to at most 2000 by 2000 pixels before sending them to a model. Applies to `@file` attachments, `read`, and images returned by tools. |
|
|
127
93
|
| `images.blockImages` | boolean | `false` | Prevent images from being sent to models. |
|
|
128
|
-
| `markdown.codeBlockIndent` | string | `" "` | Prefix used to indent rendered code blocks. |
|
|
129
|
-
| `markdown.mermaid` | `"off" \| "final" \| "streaming"` | `"streaming"` | Mermaid rendering mode. |
|
|
130
94
|
|
|
131
|
-
See [Themes](themes.md)
|
|
95
|
+
See [Themes](themes.md) for theme files and truecolor detection.
|
|
132
96
|
|
|
133
97
|
## Network and retries
|
|
134
98
|
|
|
135
99
|
| Setting | Type | Default | Description |
|
|
136
|
-
|
|
137
|
-
| `
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
100
|
+
|---|---|---|---|
|
|
101
|
+
| `transport` | `"auto" \| "sse" \| "websocket" \| "websocket-cached"` | `"auto"` | Preferred transport for AI providers that support multiple transports. |
|
|
102
|
+
| `httpProxy` | string | None | Proxy URL applied as `HTTP_PROXY` and `HTTPS_PROXY` for Pi-managed HTTP clients. **Can only be set in agent-directory settings.** |
|
|
103
|
+
| `httpIdleTimeoutMs` | number \| `"disabled"` | `300000` | HTTP header and body idle timeout in milliseconds. Set to `0` or `"disabled"` to disable. |
|
|
104
|
+
| `websocketConnectTimeoutMs` | number \| `"disabled"` | `15000` | WebSocket connection timeout in milliseconds. Set to `0` or `"disabled"` to disable. |
|
|
105
|
+
| `retry.enabled` | boolean | `true` | Enable automatic agent-level retry for transient failures. |
|
|
106
|
+
| `retry.maxRetries` | number | `3` | Maximum agent-level retry attempts. |
|
|
107
|
+
| `retry.baseDelayMs` | number | `2000` | Initial exponential-backoff delay in milliseconds. |
|
|
108
|
+
| `retry.maxAgentDelayMs` | number | `60000` | Maximum agent-level retry delay in milliseconds. |
|
|
109
|
+
| `retry.provider.timeoutMs` | number | `httpIdleTimeoutMs` | Provider request timeout in milliseconds. |
|
|
110
|
+
| `retry.provider.maxRetries` | number | `0` | Provider-level retry attempts. |
|
|
111
|
+
| `retry.provider.maxRetryDelayMs` | number | `60000` | Maximum server-requested delay in milliseconds. Set to `0` to disable the limit. |
|
|
112
|
+
|
|
113
|
+
Keep `retry.provider.maxRetries` at `0` unless provider-level retries are required. Provider retries can delay Pi from handling quota and usage-limit errors itself.
|
|
114
|
+
|
|
115
|
+
## Shell
|
|
146
116
|
|
|
147
117
|
| Setting | Type | Default | Description |
|
|
148
|
-
|
|
149
|
-
| `
|
|
118
|
+
|---|---|---|---|
|
|
119
|
+
| `shellPath` | string | Platform default | Custom shell executable path, for example for Cygwin on Windows. Supports a leading `~`. |
|
|
120
|
+
| `shellCommandPrefix` | string | None | Prefix prepended to every shell command, for example `"shopt -s expand_aliases"`. |
|
|
121
|
+
| `npmCommand` | `string[]` | `npm` | Command and arguments used for npm package lookup and installation, for example `["mise", "exec", "node@20", "--", "npm"]`. |
|
|
122
|
+
| `selfUpdateCommand` | `string[]` | None | Command and arguments `pi update` runs to update Pi itself, with `{packageName}`, `{version}`, and `{installSpec}` placeholders. `PI_SELF_UPDATE_COMMAND` takes precedence. **Can only be set in agent-directory settings.** See [Custom update command](cli.md#custom-update-command). |
|
|
150
123
|
|
|
151
|
-
See [Shell aliases](shell-aliases.md) for shell setup and [Pi Packages](packages.md) for package-manager behavior.
|
|
124
|
+
Windows paths in JSON must use forward slashes or escaped backslashes. See [Shell aliases](shell-aliases.md) for shell setup and [Pi Packages](packages.md) for package-manager behavior.
|
|
152
125
|
|
|
153
126
|
## Resources
|
|
154
127
|
|
|
@@ -161,17 +134,13 @@ Resource paths in user settings resolve from the agent directory. Paths in proje
|
|
|
161
134
|
| `skills` | `string[]` | `[]` | Skill files or directories. |
|
|
162
135
|
| `prompts` | `string[]` | `[]` | Prompt-template files or directories. |
|
|
163
136
|
| `themes` | `string[]` | `[]` | Theme files or directories. |
|
|
164
|
-
| `enableSkillCommands` | boolean | `true` | Register skills as `/skill:name` commands. |
|
|
165
137
|
|
|
166
138
|
Resource arrays support glob exclusions with `!pattern`, exact inclusion with `+path`, and exact exclusion with `-path`. Pi loads resources listed in both user-level and project settings.
|
|
167
139
|
|
|
168
|
-
The built-in extensions are named `builtin:mcp`, `builtin:llama.cpp`, `builtin:codemode`, and `builtin:tool-search` in `extensions`. They load by default; `-builtin:mcp` disables one. A `+builtin:<name>` or `-builtin:<name>` entry in project settings overrides the user setting. `pi config`
|
|
140
|
+
The built-in extensions are named `builtin:mcp`, `builtin:llama.cpp`, `builtin:codemode`, and `builtin:tool-search` in `extensions`. They load by default; `-builtin:mcp` disables one. A `+builtin:<name>` or `-builtin:<name>` entry in project settings overrides the user setting. `pi config` prints them with the other resolved resources. `--no-extensions` disables them too, and `-e builtin:<name>` loads one explicitly.
|
|
169
141
|
|
|
170
|
-
##
|
|
142
|
+
## Telemetry
|
|
171
143
|
|
|
172
144
|
| Setting | Type | Default | Description |
|
|
173
145
|
|---|---|---|---|
|
|
174
|
-
| `collapseChangelog` | boolean | `false` | Show a condensed changelog after an update. |
|
|
175
146
|
| `enableInstallTelemetry` | boolean | `true` | Enable anonymous install/update reporting and selected provider attribution headers. Does not control update checks. |
|
|
176
|
-
| `enableAnalytics` | boolean | `false` | Opt in to analytics data sharing. Currently used only by the experimental first-run setup. |
|
|
177
|
-
| `warnings.anthropicExtraUsage` | boolean | `true` | Warn when Anthropic subscription authentication may use paid extra usage. |
|
package/docs/shell-aliases.md
CHANGED
|
@@ -9,7 +9,7 @@ Use `shellPath` to choose the Bash executable and `shellCommandPrefix` to run se
|
|
|
9
9
|
| Command source | Shell |
|
|
10
10
|
|---|---|
|
|
11
11
|
| Model calls the built-in `bash` tool | Pi's resolved Bash executable |
|
|
12
|
-
|
|
|
12
|
+
| An RPC client sends the [`bash`](rpc-commands.md#bash) command | The same resolved Bash executable |
|
|
13
13
|
| Model calls the optional `powershell` tool | PowerShell 7 (`pwsh.exe`) or Windows PowerShell |
|
|
14
14
|
| An extension provides or replaces a shell tool | The operations implemented by that extension |
|
|
15
15
|
|
|
@@ -33,11 +33,11 @@ On Windows, use forward slashes or escape backslashes:
|
|
|
33
33
|
}
|
|
34
34
|
```
|
|
35
35
|
|
|
36
|
-
|
|
36
|
+
Restart Pi after changing the setting. See [Run Pi on Windows](windows.md) for the native Windows defaults.
|
|
37
37
|
|
|
38
38
|
## Run setup before every Bash command
|
|
39
39
|
|
|
40
|
-
Set `shellCommandPrefix` to prepend shell setup to both the built-in `bash` tool and
|
|
40
|
+
Set `shellCommandPrefix` to prepend shell setup to both the built-in `bash` tool and the RPC `bash` command:
|
|
41
41
|
|
|
42
42
|
```json
|
|
43
43
|
{
|
|
@@ -66,10 +66,10 @@ Then configure Pi to enable alias expansion and load the file:
|
|
|
66
66
|
}
|
|
67
67
|
```
|
|
68
68
|
|
|
69
|
-
|
|
69
|
+
Then verify the alias through Pi:
|
|
70
70
|
|
|
71
|
-
```
|
|
72
|
-
|
|
71
|
+
```bash
|
|
72
|
+
pi --tools bash -p "Run the shell command ll and show its output."
|
|
73
73
|
```
|
|
74
74
|
|
|
75
75
|
The command should produce the same listing as `ls -la`.
|
|
@@ -78,7 +78,7 @@ Aliases must use Bash-compatible syntax. Do not source an arbitrary `.zshrc` int
|
|
|
78
78
|
|
|
79
79
|
## Troubleshooting
|
|
80
80
|
|
|
81
|
-
### The prefix works for
|
|
81
|
+
### The prefix works for the built-in tool but not for an extension tool
|
|
82
82
|
|
|
83
83
|
`shellCommandPrefix` configures Pi's built-in Bash execution. An extension that replaces the `bash` tool or provides its own shell operations controls its own setup. Check that extension's documentation.
|
|
84
84
|
|
package/docs/skills.md
CHANGED
|
@@ -46,11 +46,11 @@ When a task matches, the model reads `SKILL.md` and follows its instructions. Th
|
|
|
46
46
|
|
|
47
47
|
Arguments after `/skill:name` are appended to the loaded instructions as a user request:
|
|
48
48
|
|
|
49
|
-
```
|
|
50
|
-
/skill:pdf-tools extract report.pdf
|
|
49
|
+
```bash
|
|
50
|
+
pi -p "/skill:pdf-tools extract report.pdf"
|
|
51
51
|
```
|
|
52
52
|
|
|
53
|
-
Set `disable-model-invocation: true` in frontmatter when a skill should be available only through its explicit command.
|
|
53
|
+
Set `disable-model-invocation: true` in frontmatter when a skill should be available only through its explicit command.
|
|
54
54
|
|
|
55
55
|
<a id="choose-where-it-loads"></a>
|
|
56
56
|
|
|
@@ -86,7 +86,7 @@ Malformed `SKILL.md` files and declared skills without descriptions are not load
|
|
|
86
86
|
|
|
87
87
|
## Validate and share a skill
|
|
88
88
|
|
|
89
|
-
Run Pi from a location where the skill is discoverable, then inspect the startup diagnostics and `/skill:name`
|
|
89
|
+
Run Pi from a location where the skill is discoverable, then inspect the startup diagnostics and run `/skill:name`. RPC [`get_commands`](rpc-commands.md#get_commands) lists loaded skills. Restart Pi after editing a skill, or reload a running session from an extension command with `ctx.reload()`.
|
|
90
90
|
|
|
91
91
|
Use a [Pi package](packages.md) to distribute one or more skills through npm or git. Keep environment setup inside the skill and declare any required runtime dependencies in the package.
|
|
92
92
|
|
package/docs/slash-commands.md
CHANGED
|
@@ -1,60 +1,52 @@
|
|
|
1
1
|
# Slash commands
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
|
25
|
-
|
|
26
|
-
| `/
|
|
27
|
-
| `/
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
|
36
|
-
|
|
37
|
-
| `/
|
|
38
|
-
| `/
|
|
39
|
-
| `/
|
|
40
|
-
| `/
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
|
47
|
-
|
|
48
|
-
| `/
|
|
49
|
-
| `/
|
|
50
|
-
| `/
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
## Commands added by resources
|
|
55
|
-
|
|
56
|
-
- Extensions can register commands with their own arguments and completion behavior.
|
|
57
|
-
- Each prompt template is available under its template name.
|
|
58
|
-
- Skills are available as `/skill:name` when skill commands are enabled.
|
|
59
|
-
|
|
60
|
-
Use `/reload` after adding or changing a discovered command resource. See [Extensions](extensions.md), [Prompt Templates](prompt-templates.md), and [Skills](skills.md) for their loading and naming rules.
|
|
3
|
+
Pi has no built-in slash commands. A prompt that starts with `/` runs a command only when its name matches a command added by a loaded resource:
|
|
4
|
+
|
|
5
|
+
| Resource | Command | Reference |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| Extension | `/name`, registered with `pi.registerCommand()` | [Extensions](extensions.md) |
|
|
8
|
+
| Prompt template | `/name`, from the template's filename | [Prompt Templates](prompt-templates.md) |
|
|
9
|
+
| Skill | `/skill:name` | [Skills](skills.md) |
|
|
10
|
+
|
|
11
|
+
Pi checks extension commands first, then skills, then prompt templates. A prompt such as `/model` that matches none of them is sent to the model as plain text.
|
|
12
|
+
|
|
13
|
+
Send commands as prompts in any mode:
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
pi -p "/review concurrency"
|
|
17
|
+
pi -p "/skill:pdf-tools extract report.pdf"
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
In RPC mode, send them through the [`prompt`](rpc-commands.md#prompt) command. [`get_commands`](rpc-commands.md#get_commands) lists the commands loaded in the current session.
|
|
21
|
+
|
|
22
|
+
## Commands from built-in extensions
|
|
23
|
+
|
|
24
|
+
| Command | Extension | Description |
|
|
25
|
+
|---|---|---|
|
|
26
|
+
| `/mcp` | `builtin:mcp` | Show MCP server status. `/mcp login <server>`, `/mcp logout <server>`, and `/mcp reconnect <server>` perform those actions. See [MCP Servers](mcp.md). |
|
|
27
|
+
| `/llama` | `builtin:llama.cpp` | Load, unload, and download models on the configured llama.cpp router through extension dialogs. Use it over RPC, whose client shows the dialogs. See [Run Local Models](llama-cpp.md). |
|
|
28
|
+
|
|
29
|
+
## Replacements for upstream pi commands
|
|
30
|
+
|
|
31
|
+
Upstream pi's terminal UI provides built-in commands such as `/model` and `/tree`. In Pi, use these options, RPC commands, or extension APIs instead:
|
|
32
|
+
|
|
33
|
+
| Upstream command | CLI | RPC command | Extension API |
|
|
34
|
+
|---|---|---|---|
|
|
35
|
+
| `/model` | `--model` | `set_model`, `cycle_model` | `pi.setModel()` |
|
|
36
|
+
| `/thinking` | `--thinking` | `set_thinking_level`, `cycle_thinking_level` | `pi.setThinkingLevel()` |
|
|
37
|
+
| `/scoped-models` | `--models`, `enabledModels` setting | | `ctx.scopedModels` |
|
|
38
|
+
| `/login`, `/logout` | `pi auth login`, `pi auth logout` | | |
|
|
39
|
+
| `/settings` | Edit [`settings.json`](settings.md) | | |
|
|
40
|
+
| `/new` | | `new_session` | `ctx.newSession()` |
|
|
41
|
+
| `/resume` | `--continue`, `--session` | `switch_session` | `ctx.switchSession()` |
|
|
42
|
+
| `/name` | `--name` | `set_session_name` | `pi.setSessionName()` |
|
|
43
|
+
| `/session` | | `get_state`, `get_session_stats` | |
|
|
44
|
+
| `/tree` | | `get_tree` | `ctx.navigateTree()` |
|
|
45
|
+
| `/fork` | `--fork` | `fork` | `ctx.fork()` |
|
|
46
|
+
| `/clone` | | `clone` | `ctx.fork(entryId, { position: "at" })` |
|
|
47
|
+
| `/compact` | | `compact` | `ctx.compact()` |
|
|
48
|
+
| `/copy` | | `get_last_assistant_text` | |
|
|
49
|
+
| `/export` | `--export` | `export_html` | |
|
|
50
|
+
| `/reload` | Restart Pi | | `ctx.reload()` |
|
|
51
|
+
|
|
52
|
+
See [RPC Commands](rpc-commands.md) for each command's fields.
|
package/docs/termux.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
# Run Pi on Android with Termux
|
|
2
2
|
|
|
3
|
-
Pi runs on Android through [Termux](https://termux.dev/), a terminal emulator and Linux environment.
|
|
3
|
+
Pi runs on Android through [Termux](https://termux.dev/), a terminal emulator and Linux environment. Print, JSON, and RPC modes, file tools, and shell commands are supported. Extensions can copy text to the Android clipboard through Termux:API.
|
|
4
4
|
|
|
5
5
|
## Before you begin
|
|
6
6
|
|
|
7
7
|
Install Termux from [GitHub or F-Droid](https://github.com/termux/termux-app#installation). Do not use the deprecated Google Play build.
|
|
8
8
|
|
|
9
|
-
[Termux:API](https://github.com/termux/termux-api#installation) is optional. Install it only when
|
|
9
|
+
[Termux:API](https://github.com/termux/termux-api#installation) is optional. Install it only when an extension should copy text to the Android clipboard, or when shell commands need Android device APIs.
|
|
10
10
|
|
|
11
11
|
## Install Pi
|
|
12
12
|
|
|
@@ -34,14 +34,13 @@ Install Termux from [GitHub or F-Droid](https://github.com/termux/termux-app#ins
|
|
|
34
34
|
pi --version
|
|
35
35
|
```
|
|
36
36
|
|
|
37
|
-
5. Open the folder you want to work in
|
|
37
|
+
5. Open the folder you want to work in:
|
|
38
38
|
|
|
39
39
|
```bash
|
|
40
40
|
cd /path/to/working-folder
|
|
41
|
-
pi
|
|
42
41
|
```
|
|
43
42
|
|
|
44
|
-
Continue with the main [Quickstart](quickstart.md#
|
|
43
|
+
Continue with the main [Quickstart](quickstart.md#2-choose-a-model) to connect a model and run your first task.
|
|
45
44
|
|
|
46
45
|
## Access Android shared storage
|
|
47
46
|
|
|
@@ -57,7 +56,7 @@ Only grant this permission when Pi should be able to access those files. Command
|
|
|
57
56
|
|
|
58
57
|
## Use clipboard commands
|
|
59
58
|
|
|
60
|
-
|
|
59
|
+
The SDK's `copyToClipboard()`, which extensions can call, uses `termux-clipboard-set` in Termux. Shell commands can use `termux-clipboard-set` and `termux-clipboard-get` directly. Install the Termux:API app and its command-line package:
|
|
61
60
|
|
|
62
61
|
```bash
|
|
63
62
|
pkg install termux-api
|
|
@@ -72,7 +71,7 @@ termux-clipboard-get
|
|
|
72
71
|
|
|
73
72
|
The second command should print `Pi clipboard test`.
|
|
74
73
|
|
|
75
|
-
The Termux clipboard API supports text only.
|
|
74
|
+
The Termux clipboard API supports text only.
|
|
76
75
|
|
|
77
76
|
## Add Termux-specific instructions
|
|
78
77
|
|
|
@@ -88,7 +87,7 @@ Pi detects that it is running in Termux, but it cannot infer how you want it to
|
|
|
88
87
|
- Do not access shared storage unless the task requires it.
|
|
89
88
|
````
|
|
90
89
|
|
|
91
|
-
|
|
90
|
+
Pi reads the file at startup, so the change applies to the next Pi process.
|
|
92
91
|
|
|
93
92
|
## Troubleshooting
|
|
94
93
|
|
|
@@ -99,7 +98,7 @@ Confirm that you installed both components:
|
|
|
99
98
|
1. The Termux:API Android app from the same source as Termux
|
|
100
99
|
2. The `termux-api` command-line package
|
|
101
100
|
|
|
102
|
-
Then run the clipboard verification commands above outside Pi. If they fail there, fix the Termux:API installation before retrying
|
|
101
|
+
Then run the clipboard verification commands above outside Pi. If they fail there, fix the Termux:API installation before retrying the extension that copies text.
|
|
103
102
|
|
|
104
103
|
### Shared storage reports permission denied
|
|
105
104
|
|
package/docs/themes.md
CHANGED
|
@@ -1,33 +1,16 @@
|
|
|
1
1
|
# Customize Pi with themes
|
|
2
2
|
|
|
3
|
-
Themes control the colors
|
|
3
|
+
Themes control the colors of HTML session exports written by the RPC [`export_html`](rpc-commands.md#export_html) command or the SDK, and the `ctx.ui.theme` colors that extensions use. Pi includes the `system`, `dark`, and `light` themes, and you can create your own palette.
|
|
4
4
|
|
|
5
|
-
## Use
|
|
5
|
+
## Use the default theme
|
|
6
6
|
|
|
7
|
-
The `system` theme is the default.
|
|
8
|
-
|
|
9
|
-
- Pi queries the terminal's default foreground and background colors and its 16 ANSI colors.
|
|
10
|
-
- Each Pi color takes its hue from one ANSI color, for example errors from red and links from blue.
|
|
11
|
-
- Pi sets each color's lightness so that it stands out from the background by a minimum contrast. Body text keeps at least a 4.5:1 WCAG contrast ratio on the background and every panel.
|
|
12
|
-
- When the terminal switches between light and dark, Pi queries the colors again and rebuilds the theme.
|
|
13
|
-
|
|
14
|
-
The theme adapts to what the terminal reports:
|
|
15
|
-
|
|
16
|
-
| Terminal reports | Result |
|
|
17
|
-
|---|---|
|
|
18
|
-
| Background and ANSI colors | Colors from the terminal palette, placed for the actual background. |
|
|
19
|
-
| Background only | Pi's own hues, placed for the actual background. |
|
|
20
|
-
| Nothing | ANSI color indices and the terminal's default colors, which the terminal renders itself. Secondary text is faint, and panels have no background color. |
|
|
21
|
-
|
|
22
|
-
Pi asks the terminal for its colors when it starts. Terminals usually answer within a few milliseconds, and Pi waits at most 100 ms before showing the startup header. If the terminal does not answer in time, Pi uses the ANSI color fallback, and it still applies the colors if they arrive later, for example over a slow SSH connection. `system` is a reserved name: a custom theme with that name is ignored.
|
|
7
|
+
The `system` theme is the default. Upstream pi derives it from the colors a terminal reports. Pi's headless modes do not query the terminal, so `system` uses Pi's own hues and picks a dark or light appearance from the `COLORFGBG` environment variable, falling back to dark. `system` is a reserved name: a custom theme with that name is ignored.
|
|
23
8
|
|
|
24
9
|
<a id="selecting-a-theme"></a>
|
|
25
10
|
|
|
26
11
|
## Choose a theme
|
|
27
12
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
The selection is saved as the `theme` [setting](settings.md#terminal-and-display):
|
|
13
|
+
Set the `theme` [setting](settings.md#terminal-and-display):
|
|
31
14
|
|
|
32
15
|
```json
|
|
33
16
|
{
|
|
@@ -37,25 +20,22 @@ The selection is saved as the `theme` [setting](settings.md#terminal-and-display
|
|
|
37
20
|
|
|
38
21
|
Without a `theme` setting, Pi uses `system`.
|
|
39
22
|
|
|
40
|
-
|
|
23
|
+
Upstream pi also accepts a `light/dark` pair that follows the terminal's appearance. Pi cannot detect the appearance, so it uses `system` for a pair. Theme names cannot contain `/` because the pair format reserves it.
|
|
41
24
|
|
|
42
|
-
|
|
43
|
-
{
|
|
44
|
-
"theme": "light/dark"
|
|
45
|
-
}
|
|
46
|
-
```
|
|
47
|
-
|
|
48
|
-
Pi decides whether the terminal is light or dark from its reported background and foreground colors. If the terminal does not report its background, Pi uses the terminal's light/dark notification, then the `COLORFGBG` environment variable, then dark. The same decision picks the theme of a light/dark pair and the appearance of `system`. When automatic mode is active, Pi changes themes when the terminal reports an appearance change. Theme names cannot contain `/` because Pi reserves it for this setting format.
|
|
49
|
-
|
|
50
|
-
Use `--use-theme` to choose the initial theme for one invocation without changing the saved setting:
|
|
25
|
+
Use `--use-theme` to choose the theme for one invocation without changing the saved setting:
|
|
51
26
|
|
|
52
27
|
```bash
|
|
53
|
-
pi --use-theme light
|
|
54
|
-
pi --use-theme light/dark
|
|
28
|
+
pi --use-theme light --mode rpc
|
|
55
29
|
```
|
|
56
30
|
|
|
57
31
|
See [CLI resources](cli.md#resources) for the command-line option.
|
|
58
32
|
|
|
33
|
+
<a id="override-detected-capabilities"></a>
|
|
34
|
+
|
|
35
|
+
### Override truecolor detection
|
|
36
|
+
|
|
37
|
+
Pi detects truecolor support for the ANSI colors that `ctx.ui.theme` produces. If detection fails behind a terminal proxy or multiplexer, override it with `PI_TRUE_COLOR=1|0|auto` or the JSON-only `terminal.trueColor` setting (`true`, `false`, or `"auto"`). Without truecolor, Pi approximates colors with the 256-color palette.
|
|
38
|
+
|
|
59
39
|
## Create a custom theme
|
|
60
40
|
|
|
61
41
|
Copy one of the [built-in themes](https://github.com/punch-bot/core/tree/main/packages/coding-agent/src/core/theme) or create a new JSON file conforming to the [schema](https://raw.githubusercontent.com/punch-bot/core/main/packages/coding-agent/schemas/theme.schema.json). The built-in themes use OKHSL colors, with variables for colors that several roles share, so you can adjust a hue, saturation, or lightness directly.
|
|
@@ -63,19 +43,19 @@ Copy one of the [built-in themes](https://github.com/punch-bot/core/tree/main/pa
|
|
|
63
43
|
1. Save the file as `<agent-dir>/themes/my-theme.json`. The agent directory defaults to `~/.pi/agent`.
|
|
64
44
|
2. Set its `name` to `my-theme`.
|
|
65
45
|
3. Change values in `vars` and `colors`.
|
|
66
|
-
4.
|
|
46
|
+
4. Set `"theme": "my-theme"` in `settings.json`.
|
|
67
47
|
|
|
68
|
-
Use the theme name as the filename. Pi
|
|
48
|
+
Use the theme name as the filename. Pi loads themes at startup, so restart Pi after adding or changing one. An extension command can reload a running session with `ctx.reload()`.
|
|
69
49
|
|
|
70
50
|
## Understand the theme file
|
|
71
51
|
|
|
72
52
|
| Property | Required | Responsibility |
|
|
73
53
|
|---|---|---|
|
|
74
54
|
| `$schema` | No | Enables editor validation and completion against Pi's published schema. |
|
|
75
|
-
| `name` | Yes | Identifies the theme in
|
|
55
|
+
| `name` | Yes | Identifies the theme in settings and `--use-theme`. It must be unique, cannot contain `/`, and cannot be `system`. |
|
|
76
56
|
| `appearance` | No | `"dark"` or `"light"`: the background the theme is designed for. Pi detects it from the theme colors when omitted. |
|
|
77
57
|
| `vars` | No | Defines reusable color values. Variables can reference other variables. |
|
|
78
|
-
| `colors` | Yes | Assigns colors to
|
|
58
|
+
| `colors` | Yes | Assigns colors to interface roles. The schema identifies required and optional roles. |
|
|
79
59
|
| `export` | No | Overrides page and panel backgrounds in HTML exports. |
|
|
80
60
|
|
|
81
61
|
Theme objects are strict: only documented top-level fields and color tokens are accepted. Define reusable custom colors under `vars`; custom keys under `colors` or `export` and additional top-level metadata are rejected.
|
|
@@ -91,17 +71,17 @@ A color can be written in six forms:
|
|
|
91
71
|
| Variable reference | `"primary"` | The value of an entry in `vars`. |
|
|
92
72
|
| Terminal default | `""` | The terminal's default foreground or background color. |
|
|
93
73
|
|
|
94
|
-
Terminal default colors render as the terminal's own colors. Where Pi needs a concrete value, such as HTML export or extension color math, it uses
|
|
74
|
+
Terminal default colors render as the terminal's own colors in ANSI output. Where Pi needs a concrete value, such as HTML export or extension color math, it uses a black or white guess based on the theme's appearance.
|
|
95
75
|
|
|
96
|
-
Pi resolves chained variable references. A missing variable or circular reference makes the theme invalid. Pi
|
|
76
|
+
Pi resolves chained variable references. A missing variable or circular reference makes the theme invalid. Pi gamut-maps OKLCH to sRGB. HTML exports convert OKHSL values to hexadecimal because CSS does not support them. For ANSI output, see [Override truecolor detection](#override-detected-capabilities).
|
|
97
77
|
|
|
98
78
|
Use the [theme JSON schema](https://raw.githubusercontent.com/punch-bot/core/main/packages/coding-agent/schemas/theme.schema.json) for the exact properties, required colors, and accepted value types.
|
|
99
79
|
|
|
100
|
-
Pi reports invalid theme files during startup and
|
|
80
|
+
Pi reports invalid theme files during startup and reload.
|
|
101
81
|
|
|
102
82
|
## Find the color to change
|
|
103
83
|
|
|
104
|
-
Theme colors describe interface
|
|
84
|
+
Theme colors describe roles of upstream pi's terminal interface; HTML exports reuse them for messages, tool output, Markdown, diffs, and syntax highlighting. Use these groups to find the relevant part of the schema:
|
|
105
85
|
|
|
106
86
|
| Area | Color names |
|
|
107
87
|
|---|---|
|