@f5-sales-demo/xcsh 19.51.2
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 +7073 -0
- package/README.md +14 -0
- package/examples/README.md +21 -0
- package/examples/custom-tools/README.md +109 -0
- package/examples/custom-tools/hello/index.ts +20 -0
- package/examples/custom-tools/todo/index.ts +206 -0
- package/examples/extensions/README.md +143 -0
- package/examples/extensions/api-demo.ts +89 -0
- package/examples/extensions/chalk-logger.ts +25 -0
- package/examples/extensions/hello.ts +32 -0
- package/examples/extensions/pirate.ts +43 -0
- package/examples/extensions/plan-mode.ts +551 -0
- package/examples/extensions/reload-runtime.ts +37 -0
- package/examples/extensions/todo.ts +296 -0
- package/examples/extensions/tools.ts +145 -0
- package/examples/extensions/with-deps/index.ts +36 -0
- package/examples/extensions/with-deps/package-lock.json +31 -0
- package/examples/extensions/with-deps/package.json +16 -0
- package/examples/hooks/README.md +56 -0
- package/examples/hooks/auto-commit-on-exit.ts +48 -0
- package/examples/hooks/confirm-destructive.ts +58 -0
- package/examples/hooks/custom-compaction.ts +115 -0
- package/examples/hooks/dirty-repo-guard.ts +51 -0
- package/examples/hooks/file-trigger.ts +40 -0
- package/examples/hooks/git-checkpoint.ts +52 -0
- package/examples/hooks/handoff.ts +149 -0
- package/examples/hooks/permission-gate.ts +33 -0
- package/examples/hooks/protected-paths.ts +29 -0
- package/examples/hooks/qna.ts +118 -0
- package/examples/hooks/status-line.ts +39 -0
- package/examples/sdk/01-minimal.ts +21 -0
- package/examples/sdk/02-custom-model.ts +49 -0
- package/examples/sdk/03-custom-prompt.ts +43 -0
- package/examples/sdk/04-skills.ts +43 -0
- package/examples/sdk/06-extensions.ts +80 -0
- package/examples/sdk/06-hooks.ts +61 -0
- package/examples/sdk/07-context-files.ts +35 -0
- package/examples/sdk/08-prompt-templates.ts +41 -0
- package/examples/sdk/08-slash-commands.ts +46 -0
- package/examples/sdk/09-api-keys-and-oauth.ts +54 -0
- package/examples/sdk/11-sessions.ts +47 -0
- package/examples/sdk/README.md +172 -0
- package/package.json +539 -0
- package/scripts/build-info/resolvers.ts +51 -0
- package/scripts/capture-ax-fixture.ts +84 -0
- package/scripts/capture-login-fixture.ts +30 -0
- package/scripts/check-workflow-field-coverage.ts +101 -0
- package/scripts/extension-uat-harness.ts +340 -0
- package/scripts/format-prompts.ts +68 -0
- package/scripts/generate-api-spec-index.ts +580 -0
- package/scripts/generate-branding-index.ts +81 -0
- package/scripts/generate-build-info.ts +106 -0
- package/scripts/generate-console-catalog.ts +88 -0
- package/scripts/generate-console-field-metadata.ts +74 -0
- package/scripts/generate-docs-index.ts +40 -0
- package/scripts/generate-template.ts +32 -0
- package/scripts/generate-terraform-index.ts +81 -0
- package/scripts/mermaid-gallery.ts +132 -0
- package/scripts/uat-matrix-modalities.ts +451 -0
- package/scripts/uat-matrix-report.ts +175 -0
- package/scripts/uat-matrix.ts +353 -0
- package/src/async/index.ts +2 -0
- package/src/async/job-manager.ts +416 -0
- package/src/async/support.ts +5 -0
- package/src/autoresearch/apply-contract-to-state.ts +1 -0
- package/src/autoresearch/command-resume.md +17 -0
- package/src/autoresearch/contract.ts +205 -0
- package/src/autoresearch/dashboard.ts +374 -0
- package/src/autoresearch/git.ts +191 -0
- package/src/autoresearch/helpers.ts +328 -0
- package/src/autoresearch/index.ts +402 -0
- package/src/autoresearch/prompt.md +236 -0
- package/src/autoresearch/resume-message.md +16 -0
- package/src/autoresearch/state.ts +303 -0
- package/src/autoresearch/tools/init-experiment.ts +400 -0
- package/src/autoresearch/tools/log-experiment.ts +793 -0
- package/src/autoresearch/tools/run-experiment.ts +679 -0
- package/src/autoresearch/types.ts +114 -0
- package/src/browser/acquire.ts +249 -0
- package/src/browser/actions.ts +126 -0
- package/src/browser/auth.ts +176 -0
- package/src/browser/ax.ts +134 -0
- package/src/browser/cdp-core.ts +45 -0
- package/src/browser/cdp-page-actions.ts +51 -0
- package/src/browser/chrome-locate.ts +66 -0
- package/src/browser/dom-context.ts +89 -0
- package/src/browser/dt-context.ts +100 -0
- package/src/browser/extension-bridge.ts +182 -0
- package/src/browser/extension-page-actions.ts +397 -0
- package/src/browser/extension-provider.ts +373 -0
- package/src/browser/index.ts +17 -0
- package/src/browser/input-commit.ts +74 -0
- package/src/browser/native-messaging.ts +20 -0
- package/src/browser/page-actions.ts +18 -0
- package/src/browser/provider.ts +155 -0
- package/src/browser/resolver.ts +126 -0
- package/src/browser/selector.ts +40 -0
- package/src/bun-imports.d.ts +22 -0
- package/src/capability/context-file.ts +43 -0
- package/src/capability/extension-module.ts +34 -0
- package/src/capability/extension.ts +47 -0
- package/src/capability/fs.ts +107 -0
- package/src/capability/hook.ts +40 -0
- package/src/capability/index.ts +438 -0
- package/src/capability/instruction.ts +37 -0
- package/src/capability/mcp.ts +74 -0
- package/src/capability/prompt.ts +35 -0
- package/src/capability/rule.ts +224 -0
- package/src/capability/settings.ts +34 -0
- package/src/capability/skill.ts +50 -0
- package/src/capability/slash-command.ts +40 -0
- package/src/capability/ssh.ts +41 -0
- package/src/capability/system-prompt.ts +34 -0
- package/src/capability/tool.ts +38 -0
- package/src/capability/types.ts +168 -0
- package/src/cli/agents-cli.ts +138 -0
- package/src/cli/args.ts +286 -0
- package/src/cli/chrome-cli.ts +88 -0
- package/src/cli/classify-install-target.ts +50 -0
- package/src/cli/commands/init-xdg.ts +27 -0
- package/src/cli/config-cli.ts +418 -0
- package/src/cli/file-processor.ts +121 -0
- package/src/cli/grep-cli.ts +160 -0
- package/src/cli/grievances-cli.ts +78 -0
- package/src/cli/initial-message.ts +58 -0
- package/src/cli/jupyter-cli.ts +106 -0
- package/src/cli/list-models.ts +128 -0
- package/src/cli/plugin-cli.ts +964 -0
- package/src/cli/read-cli.ts +68 -0
- package/src/cli/session-picker.ts +52 -0
- package/src/cli/setup-cli.ts +479 -0
- package/src/cli/shell-cli.ts +174 -0
- package/src/cli/ssh-cli.ts +179 -0
- package/src/cli/stats-cli.ts +182 -0
- package/src/cli/update-cli.ts +446 -0
- package/src/cli/web-search-cli.ts +203 -0
- package/src/cli.ts +123 -0
- package/src/commands/agents.ts +57 -0
- package/src/commands/chrome-host.ts +71 -0
- package/src/commands/chrome.ts +28 -0
- package/src/commands/commit.ts +36 -0
- package/src/commands/config.ts +51 -0
- package/src/commands/grep.ts +48 -0
- package/src/commands/grievances.ts +20 -0
- package/src/commands/jupyter.ts +32 -0
- package/src/commands/launch.ts +144 -0
- package/src/commands/plugin.ts +78 -0
- package/src/commands/read.ts +33 -0
- package/src/commands/setup.ts +42 -0
- package/src/commands/shell.ts +29 -0
- package/src/commands/ssh.ts +60 -0
- package/src/commands/stats.ts +29 -0
- package/src/commands/update.ts +21 -0
- package/src/commands/web-search.ts +46 -0
- package/src/commit/agentic/agent.ts +314 -0
- package/src/commit/agentic/fallback.ts +96 -0
- package/src/commit/agentic/index.ts +354 -0
- package/src/commit/agentic/prompts/analyze-file.md +22 -0
- package/src/commit/agentic/prompts/session-user.md +25 -0
- package/src/commit/agentic/prompts/split-confirm.md +1 -0
- package/src/commit/agentic/prompts/system.md +38 -0
- package/src/commit/agentic/state.ts +60 -0
- package/src/commit/agentic/tools/analyze-file.ts +127 -0
- package/src/commit/agentic/tools/git-file-diff.ts +191 -0
- package/src/commit/agentic/tools/git-hunk.ts +50 -0
- package/src/commit/agentic/tools/git-overview.ts +81 -0
- package/src/commit/agentic/tools/index.ts +54 -0
- package/src/commit/agentic/tools/propose-changelog.ts +139 -0
- package/src/commit/agentic/tools/propose-commit.ts +122 -0
- package/src/commit/agentic/tools/recent-commits.ts +81 -0
- package/src/commit/agentic/tools/schemas.ts +31 -0
- package/src/commit/agentic/tools/split-commit.ts +251 -0
- package/src/commit/agentic/topo-sort.ts +44 -0
- package/src/commit/agentic/trivial.ts +51 -0
- package/src/commit/agentic/validation.ts +183 -0
- package/src/commit/analysis/conventional.ts +122 -0
- package/src/commit/analysis/index.ts +4 -0
- package/src/commit/analysis/scope.ts +242 -0
- package/src/commit/analysis/summary.ts +105 -0
- package/src/commit/analysis/validation.ts +66 -0
- package/src/commit/changelog/detect.ts +40 -0
- package/src/commit/changelog/generate.ts +101 -0
- package/src/commit/changelog/index.ts +234 -0
- package/src/commit/changelog/parse.ts +44 -0
- package/src/commit/cli.ts +85 -0
- package/src/commit/git/diff.ts +148 -0
- package/src/commit/index.ts +5 -0
- package/src/commit/map-reduce/index.ts +69 -0
- package/src/commit/map-reduce/map-phase.ts +193 -0
- package/src/commit/map-reduce/reduce-phase.ts +108 -0
- package/src/commit/map-reduce/utils.ts +9 -0
- package/src/commit/message.ts +11 -0
- package/src/commit/model-selection.ts +66 -0
- package/src/commit/pipeline.ts +242 -0
- package/src/commit/prompts/analysis-system.md +148 -0
- package/src/commit/prompts/analysis-user.md +38 -0
- package/src/commit/prompts/changelog-system.md +50 -0
- package/src/commit/prompts/changelog-user.md +18 -0
- package/src/commit/prompts/file-observer-system.md +24 -0
- package/src/commit/prompts/file-observer-user.md +8 -0
- package/src/commit/prompts/reduce-system.md +50 -0
- package/src/commit/prompts/reduce-user.md +17 -0
- package/src/commit/prompts/summary-retry.md +3 -0
- package/src/commit/prompts/summary-system.md +38 -0
- package/src/commit/prompts/summary-user.md +13 -0
- package/src/commit/prompts/types-description.md +2 -0
- package/src/commit/types.ts +118 -0
- package/src/commit/utils/exclusions.ts +42 -0
- package/src/commit/utils.ts +44 -0
- package/src/config/auto-config.ts +698 -0
- package/src/config/context-schema.json +115 -0
- package/src/config/file-lock.ts +121 -0
- package/src/config/keybindings.ts +493 -0
- package/src/config/mcp-schema.json +230 -0
- package/src/config/model-equivalence.ts +675 -0
- package/src/config/model-registry.ts +2265 -0
- package/src/config/model-resolver.ts +1289 -0
- package/src/config/prompt-templates.ts +271 -0
- package/src/config/resolve-config-value.ts +110 -0
- package/src/config/settings-schema.ts +2155 -0
- package/src/config/settings.ts +730 -0
- package/src/config.ts +418 -0
- package/src/cursor.ts +323 -0
- package/src/dap/client.ts +674 -0
- package/src/dap/config.ts +150 -0
- package/src/dap/defaults.json +211 -0
- package/src/dap/index.ts +4 -0
- package/src/dap/session.ts +1255 -0
- package/src/dap/types.ts +600 -0
- package/src/debug/index.ts +440 -0
- package/src/debug/log-formatting.ts +58 -0
- package/src/debug/log-viewer.ts +908 -0
- package/src/debug/profiler.ts +158 -0
- package/src/debug/report-bundle.ts +365 -0
- package/src/debug/system-info.ts +107 -0
- package/src/discovery/agents-md.ts +67 -0
- package/src/discovery/agents.ts +219 -0
- package/src/discovery/builtin.ts +851 -0
- package/src/discovery/claude-plugins.ts +297 -0
- package/src/discovery/claude.ts +543 -0
- package/src/discovery/cline.ts +83 -0
- package/src/discovery/codex.ts +535 -0
- package/src/discovery/cursor.ts +220 -0
- package/src/discovery/gemini.ts +396 -0
- package/src/discovery/github.ts +118 -0
- package/src/discovery/helpers.ts +934 -0
- package/src/discovery/index.ts +79 -0
- package/src/discovery/language.ts +46 -0
- package/src/discovery/mcp-json.ts +171 -0
- package/src/discovery/opencode.ts +393 -0
- package/src/discovery/plugin-dir-roots.ts +28 -0
- package/src/discovery/ssh.ts +153 -0
- package/src/discovery/substitute-plugin-root.ts +29 -0
- package/src/discovery/vscode.ts +105 -0
- package/src/discovery/windsurf.ts +147 -0
- package/src/edit/diff.ts +818 -0
- package/src/edit/index.ts +481 -0
- package/src/edit/line-hash.ts +67 -0
- package/src/edit/modes/chunk.ts +762 -0
- package/src/edit/modes/hashline.ts +1366 -0
- package/src/edit/modes/patch.ts +1791 -0
- package/src/edit/modes/replace.ts +1115 -0
- package/src/edit/normalize.ts +375 -0
- package/src/edit/renderer.ts +627 -0
- package/src/exa/factory.ts +61 -0
- package/src/exa/index.ts +27 -0
- package/src/exa/mcp-client.ts +293 -0
- package/src/exa/render.ts +232 -0
- package/src/exa/researcher.ts +47 -0
- package/src/exa/search.ts +86 -0
- package/src/exa/types.ts +166 -0
- package/src/exa/websets.ts +247 -0
- package/src/exec/bash-executor.ts +332 -0
- package/src/exec/exec.ts +53 -0
- package/src/exec/idle-timeout-watchdog.ts +126 -0
- package/src/exec/non-interactive-env.ts +48 -0
- package/src/export/custom-share.ts +65 -0
- package/src/export/html/index.ts +161 -0
- package/src/export/html/template.css +1001 -0
- package/src/export/html/template.generated.ts +2 -0
- package/src/export/html/template.html +46 -0
- package/src/export/html/template.js +1950 -0
- package/src/export/html/template.macro.ts +24 -0
- package/src/export/html/vendor/highlight.min.js +1213 -0
- package/src/export/html/vendor/marked.min.js +6 -0
- package/src/export/ttsr.ts +434 -0
- package/src/extensibility/custom-commands/bundled/ci-green/index.ts +25 -0
- package/src/extensibility/custom-commands/bundled/review/index.ts +456 -0
- package/src/extensibility/custom-commands/index.ts +2 -0
- package/src/extensibility/custom-commands/loader.ts +236 -0
- package/src/extensibility/custom-commands/types.ts +111 -0
- package/src/extensibility/custom-tools/index.ts +7 -0
- package/src/extensibility/custom-tools/loader.ts +238 -0
- package/src/extensibility/custom-tools/types.ts +251 -0
- package/src/extensibility/custom-tools/wrapper.ts +47 -0
- package/src/extensibility/extensions/index.ts +15 -0
- package/src/extensibility/extensions/loader.ts +572 -0
- package/src/extensibility/extensions/runner.ts +848 -0
- package/src/extensibility/extensions/types.ts +1394 -0
- package/src/extensibility/extensions/wrapper.ts +191 -0
- package/src/extensibility/hooks/index.ts +5 -0
- package/src/extensibility/hooks/loader.ts +255 -0
- package/src/extensibility/hooks/runner.ts +425 -0
- package/src/extensibility/hooks/tool-wrapper.ts +108 -0
- package/src/extensibility/hooks/types.ts +826 -0
- package/src/extensibility/plugins/doctor.ts +66 -0
- package/src/extensibility/plugins/git-url.ts +281 -0
- package/src/extensibility/plugins/index.ts +9 -0
- package/src/extensibility/plugins/installer.ts +192 -0
- package/src/extensibility/plugins/loader.ts +267 -0
- package/src/extensibility/plugins/manager.ts +731 -0
- package/src/extensibility/plugins/marketplace/cache.ts +136 -0
- package/src/extensibility/plugins/marketplace/fetcher.ts +318 -0
- package/src/extensibility/plugins/marketplace/index.ts +6 -0
- package/src/extensibility/plugins/marketplace/manager.ts +781 -0
- package/src/extensibility/plugins/marketplace/prerequisites.ts +255 -0
- package/src/extensibility/plugins/marketplace/registry.ts +196 -0
- package/src/extensibility/plugins/marketplace/source-resolver.ts +147 -0
- package/src/extensibility/plugins/marketplace/types.ts +201 -0
- package/src/extensibility/plugins/parser.ts +105 -0
- package/src/extensibility/plugins/types.ts +194 -0
- package/src/extensibility/skills.ts +269 -0
- package/src/extensibility/slash-commands.ts +246 -0
- package/src/extensibility/tool-proxy.ts +25 -0
- package/src/extensibility/utils.ts +38 -0
- package/src/index.ts +61 -0
- package/src/internal-urls/agent-protocol.ts +136 -0
- package/src/internal-urls/api-catalog-resolve.ts +495 -0
- package/src/internal-urls/api-catalog-types.ts +94 -0
- package/src/internal-urls/api-spec-resolve.ts +1036 -0
- package/src/internal-urls/api-spec-types.ts +239 -0
- package/src/internal-urls/artifact-protocol.ts +97 -0
- package/src/internal-urls/branding-index.generated.ts +88 -0
- package/src/internal-urls/build-info-runtime.ts +302 -0
- package/src/internal-urls/build-info.generated.ts +33 -0
- package/src/internal-urls/computer-profile.ts +692 -0
- package/src/internal-urls/console-catalog-types.ts +21 -0
- package/src/internal-urls/console-catalog.generated.ts +532 -0
- package/src/internal-urls/console-field-metadata-types.ts +59 -0
- package/src/internal-urls/console-field-metadata.generated.ts +4841 -0
- package/src/internal-urls/console-resolve.ts +178 -0
- package/src/internal-urls/docs-index.generated.ts +698 -0
- package/src/internal-urls/extension-api.md +147 -0
- package/src/internal-urls/index.ts +46 -0
- package/src/internal-urls/jobs-protocol.ts +119 -0
- package/src/internal-urls/json-query.ts +126 -0
- package/src/internal-urls/local-protocol.ts +206 -0
- package/src/internal-urls/mcp-protocol.ts +156 -0
- package/src/internal-urls/memory-protocol.ts +133 -0
- package/src/internal-urls/parse.ts +72 -0
- package/src/internal-urls/profile-collectors.ts +106 -0
- package/src/internal-urls/router.ts +55 -0
- package/src/internal-urls/rule-protocol.ts +55 -0
- package/src/internal-urls/skill-protocol.ts +111 -0
- package/src/internal-urls/terraform-index.generated.ts +1852 -0
- package/src/internal-urls/terraform-resolve.ts +184 -0
- package/src/internal-urls/terraform-types.ts +45 -0
- package/src/internal-urls/types.ts +52 -0
- package/src/internal-urls/user-profile.ts +363 -0
- package/src/internal-urls/xcsh-protocol.ts +644 -0
- package/src/ipy/cancellation.ts +28 -0
- package/src/ipy/executor.ts +1155 -0
- package/src/ipy/gateway-coordinator.ts +424 -0
- package/src/ipy/kernel.ts +1091 -0
- package/src/ipy/modules.ts +144 -0
- package/src/ipy/prelude.py +849 -0
- package/src/ipy/prelude.ts +3 -0
- package/src/ipy/runtime.ts +221 -0
- package/src/locales/ar.json +512 -0
- package/src/locales/de.json +512 -0
- package/src/locales/en.json +549 -0
- package/src/locales/es.json +512 -0
- package/src/locales/fr.json +512 -0
- package/src/locales/hi.json +512 -0
- package/src/locales/index.ts +29 -0
- package/src/locales/it.json +512 -0
- package/src/locales/ja.json +512 -0
- package/src/locales/ko.json +512 -0
- package/src/locales/pt-br.json +512 -0
- package/src/locales/th.json +512 -0
- package/src/locales/zh-cn.json +512 -0
- package/src/locales/zh-tw.json +512 -0
- package/src/lsp/client.ts +941 -0
- package/src/lsp/clients/biome-client.ts +202 -0
- package/src/lsp/clients/index.ts +50 -0
- package/src/lsp/clients/lsp-linter-client.ts +93 -0
- package/src/lsp/clients/swiftlint-client.ts +120 -0
- package/src/lsp/config.ts +418 -0
- package/src/lsp/defaults.json +999 -0
- package/src/lsp/edits.ts +109 -0
- package/src/lsp/index.ts +1746 -0
- package/src/lsp/lspmux.ts +233 -0
- package/src/lsp/render.ts +692 -0
- package/src/lsp/startup-events.ts +13 -0
- package/src/lsp/types.ts +444 -0
- package/src/lsp/utils.ts +691 -0
- package/src/main.ts +944 -0
- package/src/mcp/client.ts +482 -0
- package/src/mcp/config-writer.ts +225 -0
- package/src/mcp/config.ts +365 -0
- package/src/mcp/discoverable-tool-metadata.ts +202 -0
- package/src/mcp/index.ts +29 -0
- package/src/mcp/json-rpc.ts +84 -0
- package/src/mcp/loader.ts +124 -0
- package/src/mcp/manager.ts +1152 -0
- package/src/mcp/oauth-discovery.ts +349 -0
- package/src/mcp/oauth-flow.ts +387 -0
- package/src/mcp/render.ts +157 -0
- package/src/mcp/smithery-auth.ts +104 -0
- package/src/mcp/smithery-connect.ts +145 -0
- package/src/mcp/smithery-registry.ts +477 -0
- package/src/mcp/tool-bridge.ts +417 -0
- package/src/mcp/tool-cache.ts +117 -0
- package/src/mcp/transports/http.ts +475 -0
- package/src/mcp/transports/index.ts +6 -0
- package/src/mcp/transports/stdio.ts +325 -0
- package/src/mcp/types.ts +423 -0
- package/src/memories/index.ts +1115 -0
- package/src/memories/storage.ts +577 -0
- package/src/modes/acp/acp-agent.ts +1361 -0
- package/src/modes/acp/acp-event-mapper.ts +538 -0
- package/src/modes/acp/acp-mode.ts +15 -0
- package/src/modes/acp/index.ts +2 -0
- package/src/modes/components/agent-dashboard.ts +1124 -0
- package/src/modes/components/assistant-message.ts +213 -0
- package/src/modes/components/bash-execution.ts +345 -0
- package/src/modes/components/bordered-loader.ts +41 -0
- package/src/modes/components/branch-summary-message.ts +45 -0
- package/src/modes/components/btw-panel.ts +103 -0
- package/src/modes/components/compaction-summary-message.ts +51 -0
- package/src/modes/components/context-add-wizard.ts +534 -0
- package/src/modes/components/countdown-timer.ts +75 -0
- package/src/modes/components/custom-editor.ts +238 -0
- package/src/modes/components/custom-message.ts +91 -0
- package/src/modes/components/diff.ts +210 -0
- package/src/modes/components/dynamic-border.ts +25 -0
- package/src/modes/components/extensions/extension-dashboard.ts +326 -0
- package/src/modes/components/extensions/extension-list.ts +492 -0
- package/src/modes/components/extensions/index.ts +9 -0
- package/src/modes/components/extensions/inspector-panel.ts +317 -0
- package/src/modes/components/extensions/state-manager.ts +587 -0
- package/src/modes/components/extensions/types.ts +191 -0
- package/src/modes/components/footer.ts +262 -0
- package/src/modes/components/gutter-block.ts +315 -0
- package/src/modes/components/history-search.ts +158 -0
- package/src/modes/components/hook-editor.ts +151 -0
- package/src/modes/components/hook-input.ts +81 -0
- package/src/modes/components/hook-message.ts +100 -0
- package/src/modes/components/hook-selector.ts +192 -0
- package/src/modes/components/index.ts +36 -0
- package/src/modes/components/keybinding-hints.ts +65 -0
- package/src/modes/components/login-dialog.ts +164 -0
- package/src/modes/components/mcp-add-wizard.ts +1314 -0
- package/src/modes/components/model-selector.ts +946 -0
- package/src/modes/components/oauth-selector.ts +211 -0
- package/src/modes/components/plugin-selector.ts +95 -0
- package/src/modes/components/plugin-settings.ts +477 -0
- package/src/modes/components/plugins/index.ts +5 -0
- package/src/modes/components/plugins/plugin-dashboard.ts +523 -0
- package/src/modes/components/plugins/plugin-inspector-pane.ts +84 -0
- package/src/modes/components/plugins/plugin-list-pane.ts +109 -0
- package/src/modes/components/plugins/state-manager.ts +229 -0
- package/src/modes/components/plugins/types.ts +51 -0
- package/src/modes/components/plugins/utils.ts +6 -0
- package/src/modes/components/python-execution.ts +244 -0
- package/src/modes/components/queue-mode-selector.ts +56 -0
- package/src/modes/components/read-tool-group.ts +137 -0
- package/src/modes/components/session-observer-overlay.ts +483 -0
- package/src/modes/components/session-selector.ts +343 -0
- package/src/modes/components/settings-defs.ts +568 -0
- package/src/modes/components/settings-selector.ts +641 -0
- package/src/modes/components/show-images-selector.ts +45 -0
- package/src/modes/components/skill-message.ts +90 -0
- package/src/modes/components/status-line/context-gradient.ts +64 -0
- package/src/modes/components/status-line/git-utils.ts +42 -0
- package/src/modes/components/status-line/hex-ansi.ts +29 -0
- package/src/modes/components/status-line/index.ts +4 -0
- package/src/modes/components/status-line/presets.ts +174 -0
- package/src/modes/components/status-line/segments.ts +494 -0
- package/src/modes/components/status-line/separators.ts +55 -0
- package/src/modes/components/status-line/token-rate.ts +66 -0
- package/src/modes/components/status-line/types.ts +96 -0
- package/src/modes/components/status-line-segment-editor.ts +361 -0
- package/src/modes/components/status-line.ts +729 -0
- package/src/modes/components/theme-selector.ts +63 -0
- package/src/modes/components/thinking-selector.ts +52 -0
- package/src/modes/components/todo-reminder.ts +54 -0
- package/src/modes/components/tool-execution.ts +781 -0
- package/src/modes/components/tree-selector.ts +908 -0
- package/src/modes/components/ttsr-notification.ts +80 -0
- package/src/modes/components/user-message-selector.ts +141 -0
- package/src/modes/components/user-message.ts +100 -0
- package/src/modes/components/visual-truncate.ts +63 -0
- package/src/modes/components/welcome-checks.ts +313 -0
- package/src/modes/components/welcome.ts +270 -0
- package/src/modes/controllers/btw-controller.ts +193 -0
- package/src/modes/controllers/chord-routing.ts +37 -0
- package/src/modes/controllers/command-controller.ts +1293 -0
- package/src/modes/controllers/context-command-controller.ts +61 -0
- package/src/modes/controllers/event-controller.ts +743 -0
- package/src/modes/controllers/extension-ui-controller.ts +983 -0
- package/src/modes/controllers/input-controller.ts +877 -0
- package/src/modes/controllers/mcp-command-controller.ts +1940 -0
- package/src/modes/controllers/selector-controller.ts +1292 -0
- package/src/modes/controllers/ssh-command-controller.ts +421 -0
- package/src/modes/index.ts +34 -0
- package/src/modes/interactive-mode.ts +1781 -0
- package/src/modes/oauth-manual-input.ts +42 -0
- package/src/modes/print-mode.ts +196 -0
- package/src/modes/prompt-action-autocomplete.ts +231 -0
- package/src/modes/rpc/host-tools.ts +186 -0
- package/src/modes/rpc/rpc-client.ts +762 -0
- package/src/modes/rpc/rpc-mode.ts +877 -0
- package/src/modes/rpc/rpc-types.ts +322 -0
- package/src/modes/session-observer-registry.ts +146 -0
- package/src/modes/shared.ts +30 -0
- package/src/modes/theme/defaults/index.ts +7 -0
- package/src/modes/theme/defaults/xcsh-dark.json +113 -0
- package/src/modes/theme/defaults/xcsh-light.json +115 -0
- package/src/modes/theme/mermaid-cache.ts +151 -0
- package/src/modes/theme/mermaid-palette.ts +39 -0
- package/src/modes/theme/theme-schema.json +553 -0
- package/src/modes/theme/theme.ts +2563 -0
- package/src/modes/types.ts +273 -0
- package/src/modes/utils/hotkeys-markdown.ts +60 -0
- package/src/modes/utils/keybinding-matchers.ts +30 -0
- package/src/modes/utils/read-group-outcome-aggregator.ts +55 -0
- package/src/modes/utils/sanitize-error-message.ts +60 -0
- package/src/modes/utils/tools-markdown.ts +28 -0
- package/src/modes/utils/ui-helpers.ts +734 -0
- package/src/plan-mode/approved-plan.ts +55 -0
- package/src/plan-mode/state.ts +6 -0
- package/src/priority.json +37 -0
- package/src/prompts/agents/designer.md +67 -0
- package/src/prompts/agents/explore.md +61 -0
- package/src/prompts/agents/frontmatter.md +10 -0
- package/src/prompts/agents/init.md +36 -0
- package/src/prompts/agents/librarian.md +121 -0
- package/src/prompts/agents/plan.md +49 -0
- package/src/prompts/agents/reviewer.md +127 -0
- package/src/prompts/agents/task.md +16 -0
- package/src/prompts/ci-green-request.md +35 -0
- package/src/prompts/compaction/branch-summary-context.md +5 -0
- package/src/prompts/compaction/branch-summary-preamble.md +2 -0
- package/src/prompts/compaction/branch-summary.md +30 -0
- package/src/prompts/compaction/compaction-short-summary.md +9 -0
- package/src/prompts/compaction/compaction-summary-context.md +5 -0
- package/src/prompts/compaction/compaction-summary.md +38 -0
- package/src/prompts/compaction/compaction-turn-prefix.md +17 -0
- package/src/prompts/compaction/compaction-update-summary.md +45 -0
- package/src/prompts/memories/consolidation.md +30 -0
- package/src/prompts/memories/read-path.md +11 -0
- package/src/prompts/memories/stage_one_input.md +6 -0
- package/src/prompts/memories/stage_one_system.md +21 -0
- package/src/prompts/review-request.md +70 -0
- package/src/prompts/system/agent-creation-architect.md +65 -0
- package/src/prompts/system/agent-creation-user.md +6 -0
- package/src/prompts/system/auto-handoff-threshold-focus.md +1 -0
- package/src/prompts/system/btw-user.md +8 -0
- package/src/prompts/system/commit-message-system.md +2 -0
- package/src/prompts/system/custom-system-prompt.md +82 -0
- package/src/prompts/system/eager-todo.md +13 -0
- package/src/prompts/system/file-operations.md +10 -0
- package/src/prompts/system/handoff-document.md +48 -0
- package/src/prompts/system/plan-mode-active.md +114 -0
- package/src/prompts/system/plan-mode-approved.md +23 -0
- package/src/prompts/system/plan-mode-reference.md +14 -0
- package/src/prompts/system/plan-mode-subagent.md +34 -0
- package/src/prompts/system/plan-mode-tool-decision-reminder.md +9 -0
- package/src/prompts/system/subagent-submit-reminder.md +7 -0
- package/src/prompts/system/subagent-system-prompt.md +36 -0
- package/src/prompts/system/subagent-user-prompt.md +12 -0
- package/src/prompts/system/summarization-system.md +3 -0
- package/src/prompts/system/system-prompt.md +698 -0
- package/src/prompts/system/title-system.md +2 -0
- package/src/prompts/system/ttsr-interrupt.md +7 -0
- package/src/prompts/system/web-search.md +28 -0
- package/src/prompts/tools/ask.md +28 -0
- package/src/prompts/tools/ast-edit.md +48 -0
- package/src/prompts/tools/ast-grep.md +54 -0
- package/src/prompts/tools/async-result.md +5 -0
- package/src/prompts/tools/bash.md +67 -0
- package/src/prompts/tools/browser.md +26 -0
- package/src/prompts/tools/calculator.md +10 -0
- package/src/prompts/tools/cancel-job.md +5 -0
- package/src/prompts/tools/catalog-workflow-runner.md +13 -0
- package/src/prompts/tools/checkpoint.md +16 -0
- package/src/prompts/tools/chunk-edit.md +279 -0
- package/src/prompts/tools/debug.md +43 -0
- package/src/prompts/tools/display-image.md +23 -0
- package/src/prompts/tools/exit-plan-mode.md +41 -0
- package/src/prompts/tools/find.md +26 -0
- package/src/prompts/tools/gemini-image.md +7 -0
- package/src/prompts/tools/grep.md +29 -0
- package/src/prompts/tools/hashline.md +131 -0
- package/src/prompts/tools/inspect-image-system.md +20 -0
- package/src/prompts/tools/inspect-image.md +32 -0
- package/src/prompts/tools/lsp.md +33 -0
- package/src/prompts/tools/patch.md +77 -0
- package/src/prompts/tools/poll.md +5 -0
- package/src/prompts/tools/python.md +60 -0
- package/src/prompts/tools/read-chunk.md +35 -0
- package/src/prompts/tools/read.md +63 -0
- package/src/prompts/tools/render-mermaid.md +9 -0
- package/src/prompts/tools/replace.md +36 -0
- package/src/prompts/tools/resolve.md +8 -0
- package/src/prompts/tools/rewind.md +13 -0
- package/src/prompts/tools/search-tool-bm25.md +34 -0
- package/src/prompts/tools/ssh.md +44 -0
- package/src/prompts/tools/task-summary.md +28 -0
- package/src/prompts/tools/task.md +131 -0
- package/src/prompts/tools/todo-write.md +89 -0
- package/src/prompts/tools/vim.md +98 -0
- package/src/prompts/tools/web-search.md +10 -0
- package/src/prompts/tools/write.md +14 -0
- package/src/prompts/tools/xcsh-api.md +283 -0
- package/src/resource-management/index.ts +42 -0
- package/src/sdk.ts +2123 -0
- package/src/secrets/index.ts +146 -0
- package/src/secrets/obfuscator.ts +290 -0
- package/src/secrets/regex.ts +21 -0
- package/src/services/context-env.ts +102 -0
- package/src/services/xcsh-api-client.ts +230 -0
- package/src/services/xcsh-context-command.ts +803 -0
- package/src/services/xcsh-context-display.ts +49 -0
- package/src/services/xcsh-context-indicators.ts +17 -0
- package/src/services/xcsh-context-segment.ts +39 -0
- package/src/services/xcsh-context.ts +1410 -0
- package/src/services/xcsh-env.ts +107 -0
- package/src/services/xcsh-knowledge.ts +177 -0
- package/src/services/xcsh-table.ts +164 -0
- package/src/session/agent-session.ts +6690 -0
- package/src/session/agent-storage.ts +451 -0
- package/src/session/artifacts.ts +132 -0
- package/src/session/auth-storage.ts +17 -0
- package/src/session/blob-store.ts +135 -0
- package/src/session/compaction/branch-summarization.ts +322 -0
- package/src/session/compaction/compaction.ts +1388 -0
- package/src/session/compaction/index.ts +7 -0
- package/src/session/compaction/pruning.ts +91 -0
- package/src/session/compaction/utils.ts +184 -0
- package/src/session/history-storage.ts +253 -0
- package/src/session/messages.ts +597 -0
- package/src/session/session-dump-format.ts +203 -0
- package/src/session/session-manager.ts +2816 -0
- package/src/session/session-storage.ts +370 -0
- package/src/session/streaming-output.ts +770 -0
- package/src/session/tool-choice-queue.ts +213 -0
- package/src/slash-commands/builtin-registry.ts +1614 -0
- package/src/slash-commands/export-command.ts +178 -0
- package/src/slash-commands/marketplace-install-parser.ts +99 -0
- package/src/slash-commands/resource-commands.ts +250 -0
- package/src/ssh/config-writer.ts +183 -0
- package/src/ssh/connection-manager.ts +445 -0
- package/src/ssh/ssh-executor.ts +131 -0
- package/src/ssh/sshfs-mount.ts +137 -0
- package/src/ssh/utils.ts +8 -0
- package/src/stt/downloader.ts +71 -0
- package/src/stt/index.ts +3 -0
- package/src/stt/recorder.ts +351 -0
- package/src/stt/setup.ts +52 -0
- package/src/stt/stt-controller.ts +160 -0
- package/src/stt/transcribe.py +70 -0
- package/src/stt/transcriber.ts +91 -0
- package/src/system-prompt.ts +688 -0
- package/src/task/agents.ts +166 -0
- package/src/task/commands.ts +131 -0
- package/src/task/discovery.ts +126 -0
- package/src/task/executor.ts +1324 -0
- package/src/task/index.ts +1197 -0
- package/src/task/isolation-backend.ts +72 -0
- package/src/task/name-generator.ts +1577 -0
- package/src/task/output-manager.ts +107 -0
- package/src/task/parallel.ts +116 -0
- package/src/task/render.ts +1035 -0
- package/src/task/subprocess-tool-registry.ts +88 -0
- package/src/task/template.ts +33 -0
- package/src/task/types.ts +230 -0
- package/src/task/worktree.ts +580 -0
- package/src/task/xcsh-command.ts +26 -0
- package/src/thinking.ts +87 -0
- package/src/tools/action-renderer.ts +198 -0
- package/src/tools/archive-reader.ts +315 -0
- package/src/tools/ask.ts +791 -0
- package/src/tools/ast-edit.ts +492 -0
- package/src/tools/ast-grep.ts +453 -0
- package/src/tools/auto-generated-guard.ts +305 -0
- package/src/tools/bash-interactive.ts +383 -0
- package/src/tools/bash-interceptor.ts +67 -0
- package/src/tools/bash-normalize.ts +107 -0
- package/src/tools/bash-skill-urls.ts +246 -0
- package/src/tools/bash.ts +878 -0
- package/src/tools/browser-renderer.ts +129 -0
- package/src/tools/browser.ts +1366 -0
- package/src/tools/calculator.ts +543 -0
- package/src/tools/cancel-job.ts +100 -0
- package/src/tools/catalog-workflow-runner.ts +718 -0
- package/src/tools/checkpoint.ts +133 -0
- package/src/tools/context.ts +39 -0
- package/src/tools/debug.ts +1004 -0
- package/src/tools/display-image-renderer.ts +96 -0
- package/src/tools/display-image.ts +109 -0
- package/src/tools/exit-plan-mode.ts +101 -0
- package/src/tools/fetch.ts +1462 -0
- package/src/tools/find.ts +437 -0
- package/src/tools/fs-cache-invalidation.ts +33 -0
- package/src/tools/gemini-image.ts +1004 -0
- package/src/tools/grep.ts +705 -0
- package/src/tools/index.ts +442 -0
- package/src/tools/inspect-image-renderer.ts +101 -0
- package/src/tools/inspect-image.ts +176 -0
- package/src/tools/json-tree.ts +266 -0
- package/src/tools/jtd-to-json-schema.ts +199 -0
- package/src/tools/jtd-to-typescript.ts +136 -0
- package/src/tools/jtd-utils.ts +102 -0
- package/src/tools/list-limit.ts +40 -0
- package/src/tools/mermaid-renderer.ts +127 -0
- package/src/tools/notebook.ts +288 -0
- package/src/tools/output-meta.ts +588 -0
- package/src/tools/path-utils.ts +560 -0
- package/src/tools/plan-mode-guard.ts +41 -0
- package/src/tools/poll-tool.ts +177 -0
- package/src/tools/puppeteer/00_stealth_tampering.txt +63 -0
- package/src/tools/puppeteer/01_stealth_activity.txt +20 -0
- package/src/tools/puppeteer/02_stealth_hairline.txt +11 -0
- package/src/tools/puppeteer/03_stealth_botd.txt +384 -0
- package/src/tools/puppeteer/04_stealth_iframe.txt +81 -0
- package/src/tools/puppeteer/05_stealth_webgl.txt +75 -0
- package/src/tools/puppeteer/06_stealth_screen.txt +72 -0
- package/src/tools/puppeteer/07_stealth_fonts.txt +97 -0
- package/src/tools/puppeteer/08_stealth_audio.txt +51 -0
- package/src/tools/puppeteer/09_stealth_locale.txt +46 -0
- package/src/tools/puppeteer/10_stealth_plugins.txt +206 -0
- package/src/tools/puppeteer/11_stealth_hardware.txt +8 -0
- package/src/tools/puppeteer/12_stealth_codecs.txt +40 -0
- package/src/tools/puppeteer/13_stealth_worker.txt +74 -0
- package/src/tools/python.ts +1184 -0
- package/src/tools/read.ts +1591 -0
- package/src/tools/render-mermaid.ts +93 -0
- package/src/tools/render-utils.ts +677 -0
- package/src/tools/renderers.ts +82 -0
- package/src/tools/report-tool-issue.ts +80 -0
- package/src/tools/resolve.ts +196 -0
- package/src/tools/review.ts +238 -0
- package/src/tools/search-tool-bm25.ts +288 -0
- package/src/tools/sqlite-reader.ts +623 -0
- package/src/tools/ssh.ts +322 -0
- package/src/tools/submit-result.ts +229 -0
- package/src/tools/todo-render.ts +33 -0
- package/src/tools/todo-write.ts +440 -0
- package/src/tools/tool-errors.ts +62 -0
- package/src/tools/tool-result.ts +93 -0
- package/src/tools/tool-timeouts.ts +30 -0
- package/src/tools/vim.ts +981 -0
- package/src/tools/write.ts +671 -0
- package/src/tools/xcsh-api-renderer.ts +402 -0
- package/src/tools/xcsh-api.ts +887 -0
- package/src/tui/code-cell.ts +101 -0
- package/src/tui/file-list.ts +47 -0
- package/src/tui/index.ts +11 -0
- package/src/tui/output-block.ts +175 -0
- package/src/tui/status-line.ts +39 -0
- package/src/tui/tree-list.ts +84 -0
- package/src/tui/types.ts +15 -0
- package/src/tui/utils.ts +103 -0
- package/src/utils/changelog.ts +98 -0
- package/src/utils/clipboard.ts +80 -0
- package/src/utils/command-args.ts +76 -0
- package/src/utils/commit-message-generator.ts +137 -0
- package/src/utils/edit-mode.ts +50 -0
- package/src/utils/event-bus.ts +33 -0
- package/src/utils/external-editor.ts +65 -0
- package/src/utils/file-display-mode.ts +37 -0
- package/src/utils/file-mentions.ts +376 -0
- package/src/utils/fuzzy.ts +108 -0
- package/src/utils/git.ts +1495 -0
- package/src/utils/gitstatus.ts +140 -0
- package/src/utils/image-convert.ts +27 -0
- package/src/utils/image-loading.ts +98 -0
- package/src/utils/image-passthrough.ts +118 -0
- package/src/utils/image-resize.ts +272 -0
- package/src/utils/image-viewer.ts +17 -0
- package/src/utils/lang-from-path.ts +239 -0
- package/src/utils/markit.ts +81 -0
- package/src/utils/open.ts +20 -0
- package/src/utils/session-color.ts +55 -0
- package/src/utils/shell-snapshot.ts +188 -0
- package/src/utils/title-generator.ts +193 -0
- package/src/utils/tool-choice.ts +28 -0
- package/src/utils/tools-manager.ts +356 -0
- package/src/vim/buffer.ts +309 -0
- package/src/vim/commands.ts +382 -0
- package/src/vim/engine.ts +2426 -0
- package/src/vim/parser.ts +151 -0
- package/src/vim/render.ts +252 -0
- package/src/vim/types.ts +197 -0
- package/src/web/kagi.ts +174 -0
- package/src/web/parallel.ts +346 -0
- package/src/web/scrapers/artifacthub.ts +207 -0
- package/src/web/scrapers/arxiv.ts +83 -0
- package/src/web/scrapers/aur.ts +162 -0
- package/src/web/scrapers/biorxiv.ts +133 -0
- package/src/web/scrapers/bluesky.ts +262 -0
- package/src/web/scrapers/brew.ts +172 -0
- package/src/web/scrapers/cheatsh.ts +68 -0
- package/src/web/scrapers/chocolatey.ts +196 -0
- package/src/web/scrapers/choosealicense.ts +95 -0
- package/src/web/scrapers/cisa-kev.ts +87 -0
- package/src/web/scrapers/clojars.ts +154 -0
- package/src/web/scrapers/coingecko.ts +177 -0
- package/src/web/scrapers/crates-io.ts +110 -0
- package/src/web/scrapers/crossref.ts +136 -0
- package/src/web/scrapers/devto.ts +147 -0
- package/src/web/scrapers/discogs.ts +306 -0
- package/src/web/scrapers/discourse.ts +197 -0
- package/src/web/scrapers/dockerhub.ts +138 -0
- package/src/web/scrapers/docs-rs.ts +653 -0
- package/src/web/scrapers/fdroid.ts +134 -0
- package/src/web/scrapers/firefox-addons.ts +191 -0
- package/src/web/scrapers/flathub.ts +223 -0
- package/src/web/scrapers/github-gist.ts +58 -0
- package/src/web/scrapers/github.ts +452 -0
- package/src/web/scrapers/gitlab.ts +401 -0
- package/src/web/scrapers/go-pkg.ts +266 -0
- package/src/web/scrapers/hackage.ts +140 -0
- package/src/web/scrapers/hackernews.ts +189 -0
- package/src/web/scrapers/hex.ts +105 -0
- package/src/web/scrapers/huggingface.ts +321 -0
- package/src/web/scrapers/iacr.ts +89 -0
- package/src/web/scrapers/index.ts +252 -0
- package/src/web/scrapers/jetbrains-marketplace.ts +159 -0
- package/src/web/scrapers/lemmy.ts +203 -0
- package/src/web/scrapers/lobsters.ts +175 -0
- package/src/web/scrapers/mastodon.ts +292 -0
- package/src/web/scrapers/maven.ts +138 -0
- package/src/web/scrapers/mdn.ts +169 -0
- package/src/web/scrapers/metacpan.ts +222 -0
- package/src/web/scrapers/musicbrainz.ts +250 -0
- package/src/web/scrapers/npm.ts +98 -0
- package/src/web/scrapers/nuget.ts +183 -0
- package/src/web/scrapers/nvd.ts +222 -0
- package/src/web/scrapers/ollama.ts +239 -0
- package/src/web/scrapers/open-vsx.ts +106 -0
- package/src/web/scrapers/opencorporates.ts +292 -0
- package/src/web/scrapers/openlibrary.ts +336 -0
- package/src/web/scrapers/orcid.ts +286 -0
- package/src/web/scrapers/osv.ts +176 -0
- package/src/web/scrapers/packagist.ts +160 -0
- package/src/web/scrapers/pub-dev.ts +143 -0
- package/src/web/scrapers/pubmed.ts +211 -0
- package/src/web/scrapers/pypi.ts +112 -0
- package/src/web/scrapers/rawg.ts +110 -0
- package/src/web/scrapers/readthedocs.ts +120 -0
- package/src/web/scrapers/reddit.ts +95 -0
- package/src/web/scrapers/repology.ts +251 -0
- package/src/web/scrapers/rfc.ts +201 -0
- package/src/web/scrapers/rubygems.ts +103 -0
- package/src/web/scrapers/searchcode.ts +190 -0
- package/src/web/scrapers/sec-edgar.ts +261 -0
- package/src/web/scrapers/semantic-scholar.ts +171 -0
- package/src/web/scrapers/snapcraft.ts +187 -0
- package/src/web/scrapers/sourcegraph.ts +336 -0
- package/src/web/scrapers/spdx.ts +108 -0
- package/src/web/scrapers/spotify.ts +198 -0
- package/src/web/scrapers/stackoverflow.ts +120 -0
- package/src/web/scrapers/terraform.ts +277 -0
- package/src/web/scrapers/tldr.ts +47 -0
- package/src/web/scrapers/twitter.ts +93 -0
- package/src/web/scrapers/types.ts +267 -0
- package/src/web/scrapers/utils.ts +109 -0
- package/src/web/scrapers/vimeo.ts +133 -0
- package/src/web/scrapers/vscode-marketplace.ts +187 -0
- package/src/web/scrapers/w3c.ts +156 -0
- package/src/web/scrapers/wikidata.ts +344 -0
- package/src/web/scrapers/wikipedia.ts +84 -0
- package/src/web/scrapers/youtube.ts +313 -0
- package/src/web/search/errors.ts +120 -0
- package/src/web/search/index.ts +346 -0
- package/src/web/search/params.ts +129 -0
- package/src/web/search/provider.ts +97 -0
- package/src/web/search/providers/anthropic.ts +339 -0
- package/src/web/search/providers/base.ts +35 -0
- package/src/web/search/providers/brave.ts +150 -0
- package/src/web/search/providers/codex.ts +402 -0
- package/src/web/search/providers/exa.ts +264 -0
- package/src/web/search/providers/firecrawl.ts +115 -0
- package/src/web/search/providers/gemini.ts +566 -0
- package/src/web/search/providers/jina.ts +99 -0
- package/src/web/search/providers/kagi.ts +70 -0
- package/src/web/search/providers/kimi.ts +157 -0
- package/src/web/search/providers/parallel.ts +63 -0
- package/src/web/search/providers/perplexity.ts +546 -0
- package/src/web/search/providers/synthetic.ts +113 -0
- package/src/web/search/providers/tavily.ts +162 -0
- package/src/web/search/providers/utils.ts +36 -0
- package/src/web/search/providers/zai.ts +311 -0
- package/src/web/search/render.ts +348 -0
- package/src/web/search/types.ts +438 -0
- package/src/web/search/utils.ts +17 -0
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Agents CLI command handlers.
|
|
3
|
+
*
|
|
4
|
+
* Handles `xcsh agents unpack` for writing bundled agent definitions to disk.
|
|
5
|
+
*/
|
|
6
|
+
import * as fs from "node:fs/promises";
|
|
7
|
+
import * as path from "node:path";
|
|
8
|
+
import { getAgentDir, getProjectDir, isEnoent } from "@f5xc-salesdemos/pi-utils";
|
|
9
|
+
import { YAML } from "bun";
|
|
10
|
+
import chalk from "chalk";
|
|
11
|
+
import { theme } from "../modes/theme/theme";
|
|
12
|
+
import { loadBundledAgents } from "../task/agents";
|
|
13
|
+
import type { AgentDefinition } from "../task/types";
|
|
14
|
+
|
|
15
|
+
export type AgentsAction = "unpack";
|
|
16
|
+
|
|
17
|
+
export interface AgentsCommandArgs {
|
|
18
|
+
action: AgentsAction;
|
|
19
|
+
flags: {
|
|
20
|
+
force?: boolean;
|
|
21
|
+
json?: boolean;
|
|
22
|
+
dir?: string;
|
|
23
|
+
user?: boolean;
|
|
24
|
+
project?: boolean;
|
|
25
|
+
};
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
interface UnpackResult {
|
|
29
|
+
targetDir: string;
|
|
30
|
+
total: number;
|
|
31
|
+
written: string[];
|
|
32
|
+
skipped: string[];
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
function writeStdout(line: string): void {
|
|
36
|
+
process.stdout.write(`${line}\n`);
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
function resolveTargetDir(flags: AgentsCommandArgs["flags"]): string {
|
|
40
|
+
if (flags.dir && flags.dir.trim().length > 0) {
|
|
41
|
+
return path.resolve(getProjectDir(), flags.dir.trim());
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
if (flags.user && flags.project) {
|
|
45
|
+
throw new Error("Choose either --user or --project, not both.");
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
if (flags.project) {
|
|
49
|
+
return path.resolve(getProjectDir(), ".xcsh", "agents");
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
return path.join(getAgentDir(), "agents");
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
function toFrontmatter(agent: AgentDefinition): Record<string, unknown> {
|
|
56
|
+
const frontmatter: Record<string, unknown> = {
|
|
57
|
+
name: agent.name,
|
|
58
|
+
description: agent.description,
|
|
59
|
+
};
|
|
60
|
+
|
|
61
|
+
if (agent.tools && agent.tools.length > 0) frontmatter.tools = agent.tools;
|
|
62
|
+
if (agent.spawns !== undefined) frontmatter.spawns = agent.spawns;
|
|
63
|
+
if (agent.model && agent.model.length > 0) frontmatter.model = agent.model;
|
|
64
|
+
if (agent.thinkingLevel) frontmatter.thinkingLevel = agent.thinkingLevel;
|
|
65
|
+
if (agent.output !== undefined) frontmatter.output = agent.output;
|
|
66
|
+
if (agent.blocking) frontmatter.blocking = true;
|
|
67
|
+
|
|
68
|
+
return frontmatter;
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
function serializeAgent(agent: AgentDefinition): string {
|
|
72
|
+
const frontmatter = YAML.stringify(toFrontmatter(agent), null, 2).trimEnd();
|
|
73
|
+
const body = agent.systemPrompt.trim();
|
|
74
|
+
return `---\n${frontmatter}\n---\n\n${body}\n`;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
async function unpackBundledAgents(flags: AgentsCommandArgs["flags"]): Promise<UnpackResult> {
|
|
78
|
+
const targetDir = resolveTargetDir(flags);
|
|
79
|
+
await fs.mkdir(targetDir, { recursive: true });
|
|
80
|
+
|
|
81
|
+
const bundledAgents = [...loadBundledAgents()].sort((a, b) => a.name.localeCompare(b.name));
|
|
82
|
+
const written: string[] = [];
|
|
83
|
+
const skipped: string[] = [];
|
|
84
|
+
|
|
85
|
+
for (const agent of bundledAgents) {
|
|
86
|
+
const filePath = path.join(targetDir, `${agent.name}.md`);
|
|
87
|
+
if (!flags.force) {
|
|
88
|
+
try {
|
|
89
|
+
await fs.stat(filePath);
|
|
90
|
+
skipped.push(filePath);
|
|
91
|
+
continue;
|
|
92
|
+
} catch (error) {
|
|
93
|
+
if (!isEnoent(error)) throw error;
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
await Bun.write(filePath, serializeAgent(agent));
|
|
98
|
+
written.push(filePath);
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
return {
|
|
102
|
+
targetDir,
|
|
103
|
+
total: bundledAgents.length,
|
|
104
|
+
written,
|
|
105
|
+
skipped,
|
|
106
|
+
};
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
export async function runAgentsCommand(cmd: AgentsCommandArgs): Promise<void> {
|
|
110
|
+
switch (cmd.action) {
|
|
111
|
+
case "unpack": {
|
|
112
|
+
const result = await unpackBundledAgents(cmd.flags);
|
|
113
|
+
if (cmd.flags.json) {
|
|
114
|
+
writeStdout(JSON.stringify(result, null, 2));
|
|
115
|
+
return;
|
|
116
|
+
}
|
|
117
|
+
|
|
118
|
+
writeStdout(chalk.bold(`Bundled agents: ${result.total}`));
|
|
119
|
+
writeStdout(chalk.dim(`Target directory: ${result.targetDir}`));
|
|
120
|
+
writeStdout(chalk.green(`${theme.status.success} Written: ${result.written.length}`));
|
|
121
|
+
if (result.skipped.length > 0) {
|
|
122
|
+
writeStdout(
|
|
123
|
+
chalk.yellow(
|
|
124
|
+
`${theme.status.warning} Skipped existing: ${result.skipped.length} (use --force to overwrite)`,
|
|
125
|
+
),
|
|
126
|
+
);
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
for (const filePath of result.written) {
|
|
130
|
+
writeStdout(chalk.dim(` + ${filePath}`));
|
|
131
|
+
}
|
|
132
|
+
for (const filePath of result.skipped) {
|
|
133
|
+
writeStdout(chalk.dim(` = ${filePath}`));
|
|
134
|
+
}
|
|
135
|
+
return;
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
}
|
package/src/cli/args.ts
ADDED
|
@@ -0,0 +1,286 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* CLI argument parsing and help display
|
|
3
|
+
*/
|
|
4
|
+
import { type Effort, THINKING_EFFORTS } from "@f5xc-salesdemos/pi-ai";
|
|
5
|
+
import { APP_NAME, CONFIG_DIR_NAME, logger } from "@f5xc-salesdemos/pi-utils";
|
|
6
|
+
import chalk from "chalk";
|
|
7
|
+
import { parseEffort } from "../thinking";
|
|
8
|
+
import { BUILTIN_TOOLS } from "../tools";
|
|
9
|
+
|
|
10
|
+
export type Mode = "text" | "json" | "rpc" | "acp";
|
|
11
|
+
|
|
12
|
+
export interface Args {
|
|
13
|
+
cwd?: string;
|
|
14
|
+
allowHome?: boolean;
|
|
15
|
+
provider?: string;
|
|
16
|
+
model?: string;
|
|
17
|
+
smol?: string;
|
|
18
|
+
slow?: string;
|
|
19
|
+
plan?: string;
|
|
20
|
+
apiKey?: string;
|
|
21
|
+
systemPrompt?: string;
|
|
22
|
+
appendSystemPrompt?: string;
|
|
23
|
+
thinking?: Effort;
|
|
24
|
+
continue?: boolean;
|
|
25
|
+
resume?: string | true;
|
|
26
|
+
help?: boolean;
|
|
27
|
+
version?: boolean;
|
|
28
|
+
mode?: Mode;
|
|
29
|
+
noSession?: boolean;
|
|
30
|
+
sessionDir?: string;
|
|
31
|
+
providerSessionId?: string;
|
|
32
|
+
fork?: string;
|
|
33
|
+
models?: string[];
|
|
34
|
+
tools?: string[];
|
|
35
|
+
noTools?: boolean;
|
|
36
|
+
noMcp?: boolean;
|
|
37
|
+
noLsp?: boolean;
|
|
38
|
+
noPty?: boolean;
|
|
39
|
+
hooks?: string[];
|
|
40
|
+
extensions?: string[];
|
|
41
|
+
noExtensions?: boolean;
|
|
42
|
+
pluginDirs?: string[];
|
|
43
|
+
print?: boolean;
|
|
44
|
+
export?: string;
|
|
45
|
+
noSkills?: boolean;
|
|
46
|
+
skills?: string[];
|
|
47
|
+
noRules?: boolean;
|
|
48
|
+
listModels?: string | true;
|
|
49
|
+
noTitle?: boolean;
|
|
50
|
+
messages: string[];
|
|
51
|
+
fileArgs: string[];
|
|
52
|
+
/** Unknown flags (potentially extension flags) - map of flag name to value */
|
|
53
|
+
unknownFlags: Map<string, boolean | string>;
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
export function parseArgs(args: string[], extensionFlags?: Map<string, { type: "boolean" | "string" }>): Args {
|
|
57
|
+
const result: Args = {
|
|
58
|
+
messages: [],
|
|
59
|
+
fileArgs: [],
|
|
60
|
+
unknownFlags: new Map(),
|
|
61
|
+
};
|
|
62
|
+
|
|
63
|
+
for (let i = 0; i < args.length; i++) {
|
|
64
|
+
const arg = args[i];
|
|
65
|
+
|
|
66
|
+
if (arg === "--help" || arg === "-h") {
|
|
67
|
+
result.help = true;
|
|
68
|
+
} else if (arg === "--version" || arg === "-v") {
|
|
69
|
+
result.version = true;
|
|
70
|
+
} else if (arg === "--allow-home") {
|
|
71
|
+
result.allowHome = true;
|
|
72
|
+
} else if (arg === "--mode" && i + 1 < args.length) {
|
|
73
|
+
const mode = args[++i];
|
|
74
|
+
if (mode === "text" || mode === "json" || mode === "rpc" || mode === "acp") {
|
|
75
|
+
result.mode = mode;
|
|
76
|
+
}
|
|
77
|
+
} else if (arg === "--continue" || arg === "-c") {
|
|
78
|
+
result.continue = true;
|
|
79
|
+
} else if (arg === "--resume" || arg === "-r" || arg === "--session") {
|
|
80
|
+
const next = args[i + 1];
|
|
81
|
+
if (next && !next.startsWith("-")) {
|
|
82
|
+
result.resume = args[++i];
|
|
83
|
+
} else {
|
|
84
|
+
result.resume = true;
|
|
85
|
+
}
|
|
86
|
+
} else if (arg === "--fork" && i + 1 < args.length) {
|
|
87
|
+
result.fork = args[++i];
|
|
88
|
+
} else if (arg === "--provider" && i + 1 < args.length) {
|
|
89
|
+
result.provider = args[++i];
|
|
90
|
+
} else if (arg === "--model" && i + 1 < args.length) {
|
|
91
|
+
result.model = args[++i];
|
|
92
|
+
} else if (arg === "--smol" && i + 1 < args.length) {
|
|
93
|
+
result.smol = args[++i];
|
|
94
|
+
} else if (arg === "--slow" && i + 1 < args.length) {
|
|
95
|
+
result.slow = args[++i];
|
|
96
|
+
} else if (arg === "--plan" && i + 1 < args.length) {
|
|
97
|
+
result.plan = args[++i];
|
|
98
|
+
} else if (arg === "--api-key" && i + 1 < args.length) {
|
|
99
|
+
result.apiKey = args[++i];
|
|
100
|
+
} else if (arg === "--system-prompt" && i + 1 < args.length) {
|
|
101
|
+
result.systemPrompt = args[++i];
|
|
102
|
+
} else if (arg === "--append-system-prompt" && i + 1 < args.length) {
|
|
103
|
+
result.appendSystemPrompt = args[++i];
|
|
104
|
+
} else if (arg === "--provider-session-id" && i + 1 < args.length) {
|
|
105
|
+
result.providerSessionId = args[++i];
|
|
106
|
+
} else if (arg === "--no-session") {
|
|
107
|
+
result.noSession = true;
|
|
108
|
+
} else if (arg === "--session-dir" && i + 1 < args.length) {
|
|
109
|
+
result.sessionDir = args[++i];
|
|
110
|
+
} else if (arg === "--models" && i + 1 < args.length) {
|
|
111
|
+
result.models = args[++i].split(",").map(s => s.trim());
|
|
112
|
+
} else if (arg === "--no-tools") {
|
|
113
|
+
result.noTools = true;
|
|
114
|
+
} else if (arg === "--no-lsp") {
|
|
115
|
+
result.noLsp = true;
|
|
116
|
+
} else if (arg === "--no-pty") {
|
|
117
|
+
result.noPty = true;
|
|
118
|
+
} else if (arg === "--no-mcp") {
|
|
119
|
+
result.noMcp = true;
|
|
120
|
+
} else if (arg === "--tools" && i + 1 < args.length) {
|
|
121
|
+
const toolNames = args[++i]
|
|
122
|
+
.split(",")
|
|
123
|
+
.map(s => s.trim().toLowerCase())
|
|
124
|
+
.filter(Boolean);
|
|
125
|
+
const validTools: string[] = [];
|
|
126
|
+
for (const name of toolNames) {
|
|
127
|
+
if (name in BUILTIN_TOOLS) {
|
|
128
|
+
validTools.push(name);
|
|
129
|
+
} else {
|
|
130
|
+
logger.warn("Unknown tool passed to --tools", {
|
|
131
|
+
tool: name,
|
|
132
|
+
validTools: Object.keys(BUILTIN_TOOLS),
|
|
133
|
+
});
|
|
134
|
+
}
|
|
135
|
+
}
|
|
136
|
+
result.tools = validTools;
|
|
137
|
+
} else if (arg === "--thinking" && i + 1 < args.length) {
|
|
138
|
+
const rawThinking = args[++i];
|
|
139
|
+
const thinking = parseEffort(rawThinking);
|
|
140
|
+
if (thinking !== undefined) {
|
|
141
|
+
result.thinking = thinking;
|
|
142
|
+
} else {
|
|
143
|
+
logger.warn("Invalid thinking level passed to --thinking", {
|
|
144
|
+
level: rawThinking,
|
|
145
|
+
validThinkingLevels: THINKING_EFFORTS,
|
|
146
|
+
});
|
|
147
|
+
}
|
|
148
|
+
} else if (arg === "--print" || arg === "-p") {
|
|
149
|
+
result.print = true;
|
|
150
|
+
} else if (arg === "--export" && i + 1 < args.length) {
|
|
151
|
+
result.export = args[++i];
|
|
152
|
+
} else if (arg === "--hook" && i + 1 < args.length) {
|
|
153
|
+
result.hooks = result.hooks ?? [];
|
|
154
|
+
result.hooks.push(args[++i]);
|
|
155
|
+
} else if ((arg === "--extension" || arg === "-e") && i + 1 < args.length) {
|
|
156
|
+
result.extensions = result.extensions ?? [];
|
|
157
|
+
result.extensions.push(args[++i]);
|
|
158
|
+
} else if (arg === "--plugin-dir" && i + 1 < args.length) {
|
|
159
|
+
result.pluginDirs = result.pluginDirs ?? [];
|
|
160
|
+
result.pluginDirs.push(args[++i]);
|
|
161
|
+
} else if (arg === "--no-extensions") {
|
|
162
|
+
result.noExtensions = true;
|
|
163
|
+
} else if (arg === "--no-skills") {
|
|
164
|
+
result.noSkills = true;
|
|
165
|
+
} else if (arg === "--no-rules") {
|
|
166
|
+
result.noRules = true;
|
|
167
|
+
} else if (arg === "--no-title") {
|
|
168
|
+
result.noTitle = true;
|
|
169
|
+
} else if (arg === "--skills" && i + 1 < args.length) {
|
|
170
|
+
// Comma-separated glob patterns for skill filtering
|
|
171
|
+
result.skills = args[++i].split(",").map(s => s.trim());
|
|
172
|
+
} else if (arg === "--list-models") {
|
|
173
|
+
// Check if next arg is a search pattern (not a flag or file arg)
|
|
174
|
+
if (i + 1 < args.length && !args[i + 1].startsWith("-") && !args[i + 1].startsWith("@")) {
|
|
175
|
+
result.listModels = args[++i];
|
|
176
|
+
} else {
|
|
177
|
+
result.listModels = true;
|
|
178
|
+
}
|
|
179
|
+
} else if (arg.startsWith("@")) {
|
|
180
|
+
result.fileArgs.push(arg.slice(1)); // Remove @ prefix
|
|
181
|
+
} else if (arg.startsWith("--") && extensionFlags) {
|
|
182
|
+
// Check if it's an extension-registered flag
|
|
183
|
+
const flagName = arg.slice(2);
|
|
184
|
+
const extFlag = extensionFlags.get(flagName);
|
|
185
|
+
if (extFlag) {
|
|
186
|
+
if (extFlag.type === "boolean") {
|
|
187
|
+
result.unknownFlags.set(flagName, true);
|
|
188
|
+
} else if (extFlag.type === "string" && i + 1 < args.length) {
|
|
189
|
+
result.unknownFlags.set(flagName, args[++i]);
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
// Unknown flags without extensionFlags are silently ignored (first pass)
|
|
193
|
+
} else if (!arg.startsWith("-")) {
|
|
194
|
+
result.messages.push(arg);
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
|
|
198
|
+
return result;
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
export function getExtraHelpText(): string {
|
|
202
|
+
return `${chalk.bold("Environment Variables:")}
|
|
203
|
+
${chalk.dim("# Core Providers")}
|
|
204
|
+
ANTHROPIC_API_KEY - Anthropic Claude models
|
|
205
|
+
ANTHROPIC_OAUTH_TOKEN - Anthropic OAuth (takes precedence over API key)
|
|
206
|
+
CLAUDE_CODE_USE_FOUNDRY - Enable Anthropic Foundry mode (uses Foundry endpoint + mTLS)
|
|
207
|
+
FOUNDRY_BASE_URL - Anthropic Foundry base URL (e.g., https://<foundry-host>)
|
|
208
|
+
ANTHROPIC_FOUNDRY_API_KEY - Anthropic token used as Authorization: Bearer <token> in Foundry mode
|
|
209
|
+
ANTHROPIC_CUSTOM_HEADERS - Extra Foundry headers (e.g., "user-id: USERNAME")
|
|
210
|
+
CLAUDE_CODE_CLIENT_CERT - Client certificate (PEM path or inline PEM) for mTLS
|
|
211
|
+
CLAUDE_CODE_CLIENT_KEY - Client private key (PEM path or inline PEM) for mTLS
|
|
212
|
+
NODE_EXTRA_CA_CERTS - CA bundle path (or inline PEM) for server certificate validation
|
|
213
|
+
OPENAI_API_KEY - OpenAI GPT models
|
|
214
|
+
GEMINI_API_KEY - Google Gemini models
|
|
215
|
+
GITHUB_TOKEN - GitHub Copilot (or GH_TOKEN, COPILOT_GITHUB_TOKEN)
|
|
216
|
+
|
|
217
|
+
${chalk.dim("# Additional LLM Providers")}
|
|
218
|
+
AZURE_OPENAI_API_KEY - Azure OpenAI models
|
|
219
|
+
GROQ_API_KEY - Groq models
|
|
220
|
+
CEREBRAS_API_KEY - Cerebras models
|
|
221
|
+
XAI_API_KEY - xAI Grok models
|
|
222
|
+
OPENROUTER_API_KEY - OpenRouter aggregated models
|
|
223
|
+
KILO_API_KEY - Kilo Gateway models
|
|
224
|
+
MISTRAL_API_KEY - Mistral models
|
|
225
|
+
ZAI_API_KEY - z.ai models (ZhipuAI/GLM)
|
|
226
|
+
MINIMAX_API_KEY - MiniMax models
|
|
227
|
+
OPENCODE_API_KEY - OpenCode Zen/OpenCode Go models
|
|
228
|
+
CURSOR_ACCESS_TOKEN - Cursor AI models
|
|
229
|
+
AI_GATEWAY_API_KEY - Vercel AI Gateway
|
|
230
|
+
|
|
231
|
+
${chalk.dim("# Cloud Providers")}
|
|
232
|
+
AWS_PROFILE - AWS Bedrock (or AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY)
|
|
233
|
+
GOOGLE_CLOUD_PROJECT - Google Vertex AI (requires GOOGLE_CLOUD_LOCATION)
|
|
234
|
+
GOOGLE_APPLICATION_CREDENTIALS - Service account for Vertex AI
|
|
235
|
+
|
|
236
|
+
${chalk.dim("# Search & Tools")}
|
|
237
|
+
EXA_API_KEY - Exa web search
|
|
238
|
+
BRAVE_API_KEY - Brave web search
|
|
239
|
+
PERPLEXITY_API_KEY - Perplexity web search (API)
|
|
240
|
+
PERPLEXITY_COOKIES - Perplexity web search (session cookie)
|
|
241
|
+
TAVILY_API_KEY - Tavily web search
|
|
242
|
+
ANTHROPIC_SEARCH_API_KEY - Anthropic search provider
|
|
243
|
+
|
|
244
|
+
${chalk.dim("# Configuration")}
|
|
245
|
+
PI_CODING_AGENT_DIR - Session storage directory (default: ~/${CONFIG_DIR_NAME}/agent)
|
|
246
|
+
PI_PACKAGE_DIR - Override package directory (for Nix/Guix store paths)
|
|
247
|
+
PI_SMOL_MODEL - Override smol/fast model (see --smol)
|
|
248
|
+
PI_SLOW_MODEL - Override slow/reasoning model (see --slow)
|
|
249
|
+
PI_PLAN_MODEL - Override planning model (see --plan)
|
|
250
|
+
PI_NO_PTY - Disable PTY-based interactive bash execution
|
|
251
|
+
|
|
252
|
+
For complete environment variable reference, see:
|
|
253
|
+
${chalk.dim("docs/environment-variables.md")}
|
|
254
|
+
${chalk.bold("Available Tools (default-enabled unless noted):")}
|
|
255
|
+
read - Read file contents
|
|
256
|
+
bash - Execute bash commands
|
|
257
|
+
edit - Edit files with find/replace
|
|
258
|
+
write - Write files (creates/overwrites)
|
|
259
|
+
grep - Search file contents
|
|
260
|
+
find - Find files by glob pattern
|
|
261
|
+
lsp - Language server protocol (code intelligence)
|
|
262
|
+
python - Execute Python code (requires: ${APP_NAME} setup python)
|
|
263
|
+
notebook - Edit Jupyter notebooks
|
|
264
|
+
inspect_image - Analyze images with a vision model
|
|
265
|
+
browser - Browser automation (Puppeteer)
|
|
266
|
+
task - Launch sub-agents for parallel tasks
|
|
267
|
+
todo_write - Manage todo/task lists
|
|
268
|
+
web_search - Search the web
|
|
269
|
+
ask - Ask user questions (interactive mode only)
|
|
270
|
+
|
|
271
|
+
${chalk.bold("Plugin Options:")}
|
|
272
|
+
--plugin-dir <path> Load plugin from directory (repeatable)
|
|
273
|
+
|
|
274
|
+
${chalk.bold("Useful Commands:")}
|
|
275
|
+
xcsh agents unpack - Export bundled subagents to ~/.xcsh/agent/agents (default)
|
|
276
|
+
xcsh agents unpack --project - Export bundled subagents to ./.xcsh/agents`;
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
export function printHelp(): void {
|
|
280
|
+
process.stdout.write(
|
|
281
|
+
`${chalk.bold(APP_NAME)} - AI coding assistant\n\n` +
|
|
282
|
+
`Run ${APP_NAME} --help for full command and option details.\n` +
|
|
283
|
+
`Run ${APP_NAME} <command> --help for command-specific help.\n\n` +
|
|
284
|
+
`${getExtraHelpText()}\n`,
|
|
285
|
+
);
|
|
286
|
+
}
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Chrome CLI command handlers.
|
|
3
|
+
*
|
|
4
|
+
* Backs both `xcsh chrome [status|relaunch]` and the `/chrome` REPL slash
|
|
5
|
+
* command. `renderStatus` is a pure formatter so it can be unit-tested without
|
|
6
|
+
* touching Chrome, settings, or the network.
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
import * as fs from "node:fs";
|
|
10
|
+
import * as os from "node:os";
|
|
11
|
+
import * as path from "node:path";
|
|
12
|
+
import { acquirePage, type BrowserProviderStatus, CdpBrowserProvider } from "../browser";
|
|
13
|
+
|
|
14
|
+
type Settings = { get(key: string): unknown };
|
|
15
|
+
|
|
16
|
+
export type ChromeAction = "status" | "relaunch" | "setup";
|
|
17
|
+
|
|
18
|
+
export const EXTENSION_ID = "klajkjdoehjidngligegnpknogmjjhkc";
|
|
19
|
+
export const EXTENSION_IDS = [EXTENSION_ID];
|
|
20
|
+
|
|
21
|
+
const NATIVE_HOST_NAME = "com.xcsh.xcsh.chrome_host";
|
|
22
|
+
|
|
23
|
+
function nativeHostDir(platform: NodeJS.Platform, home: string): string {
|
|
24
|
+
if (platform === "darwin")
|
|
25
|
+
return path.join(home, "Library", "Application Support", "Google", "Chrome", "NativeMessagingHosts");
|
|
26
|
+
return path.join(home, ".config", "google-chrome", "NativeMessagingHosts"); // linux (win32 handled separately — out of slice scope; throw)
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
export function writeNativeHostManifest(opts: {
|
|
30
|
+
platform?: NodeJS.Platform;
|
|
31
|
+
home?: string;
|
|
32
|
+
xcshBinPath: string;
|
|
33
|
+
extensionIds: string[];
|
|
34
|
+
write?: (p: string, c: string) => void;
|
|
35
|
+
}): { manifestPath: string } {
|
|
36
|
+
const platform = opts.platform ?? process.platform;
|
|
37
|
+
const home = opts.home ?? os.homedir();
|
|
38
|
+
if (platform === "win32") throw new Error("xcsh chrome setup on Windows is not in the vertical slice");
|
|
39
|
+
const dir = nativeHostDir(platform, home);
|
|
40
|
+
const manifestPath = path.join(dir, `${NATIVE_HOST_NAME}.json`);
|
|
41
|
+
const manifest = {
|
|
42
|
+
name: NATIVE_HOST_NAME,
|
|
43
|
+
description: "xcsh Chrome native-messaging host",
|
|
44
|
+
path: opts.xcshBinPath,
|
|
45
|
+
args: ["chrome-host"],
|
|
46
|
+
type: "stdio",
|
|
47
|
+
allowed_origins: opts.extensionIds.map(id => `chrome-extension://${id}/`),
|
|
48
|
+
};
|
|
49
|
+
const write =
|
|
50
|
+
opts.write ??
|
|
51
|
+
((p, c) => {
|
|
52
|
+
fs.mkdirSync(path.dirname(p), { recursive: true });
|
|
53
|
+
fs.writeFileSync(p, c);
|
|
54
|
+
});
|
|
55
|
+
write(manifestPath, JSON.stringify(manifest, null, 2));
|
|
56
|
+
return { manifestPath };
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
export function renderStatus(s: BrowserProviderStatus): string {
|
|
60
|
+
const yn = (b: boolean) => (b ? "yes" : "no");
|
|
61
|
+
return [
|
|
62
|
+
"xcsh Chrome status",
|
|
63
|
+
` Chrome installed: ${yn(s.chromeInstalled)}`,
|
|
64
|
+
` Chrome running: ${yn(s.chromeRunning)}`,
|
|
65
|
+
` debuggable now: ${yn(s.debuggableNow)}`,
|
|
66
|
+
` planned action: ${s.plannedAction}`,
|
|
67
|
+
` ${s.detail}`,
|
|
68
|
+
"",
|
|
69
|
+
" Note: an open Chrome debug port lets any local process drive and read that",
|
|
70
|
+
" browser (cookies, sessions, saved passwords). xcsh only opens it on loopback,",
|
|
71
|
+
" for the duration of a task, on a Chrome you attached/launched/relaunched.",
|
|
72
|
+
].join("\n");
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
export async function runChromeCommand(action: ChromeAction, settings: Settings): Promise<string> {
|
|
76
|
+
const provider = new CdpBrowserProvider(settings);
|
|
77
|
+
if (action === "status") return renderStatus(await provider.status());
|
|
78
|
+
if (action === "setup") {
|
|
79
|
+
const { manifestPath } = writeNativeHostManifest({
|
|
80
|
+
xcshBinPath: process.execPath,
|
|
81
|
+
extensionIds: EXTENSION_IDS,
|
|
82
|
+
});
|
|
83
|
+
return `Installed native-messaging host manifest at ${manifestPath} (extensions ${EXTENSION_IDS.join(", ")}). Load the xcsh Chrome extension, then it can drive your real Chrome.`;
|
|
84
|
+
}
|
|
85
|
+
// relaunch: self-consented rung 3 — force allowRelaunch regardless of the setting.
|
|
86
|
+
const { mode } = await acquirePage({ settings, allowRelaunch: true });
|
|
87
|
+
return `Chrome ready (${mode}). Your real, logged-in session is now debuggable for xcsh.`;
|
|
88
|
+
}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Classify an install spec as a marketplace plugin reference or a plain npm package.
|
|
3
|
+
*
|
|
4
|
+
* Rules (applied in order):
|
|
5
|
+
* 1. Starts with `@` (scoped npm) -> always npm.
|
|
6
|
+
* 2. Contains `@` after the first character -> split on the LAST `@`.
|
|
7
|
+
* If the right-hand side is a known marketplace name, it's a marketplace ref.
|
|
8
|
+
* Otherwise it's an npm spec (e.g. `pkg@1.2.3`).
|
|
9
|
+
* 3. No `@` -> npm.
|
|
10
|
+
*/
|
|
11
|
+
// Common npm dist-tags that should never be interpreted as marketplace names
|
|
12
|
+
const NPM_DIST_TAGS = new Set([
|
|
13
|
+
"latest",
|
|
14
|
+
"next",
|
|
15
|
+
"beta",
|
|
16
|
+
"alpha",
|
|
17
|
+
"canary",
|
|
18
|
+
"rc",
|
|
19
|
+
"dev",
|
|
20
|
+
"stable",
|
|
21
|
+
"nightly",
|
|
22
|
+
"experimental",
|
|
23
|
+
]);
|
|
24
|
+
|
|
25
|
+
// Semver-like: starts with digit, or contains version range prefixes
|
|
26
|
+
const LOOKS_LIKE_VERSION = /^[\d~^>=<]/;
|
|
27
|
+
|
|
28
|
+
export function classifyInstallTarget(
|
|
29
|
+
spec: string,
|
|
30
|
+
knownMarketplaces: Set<string>,
|
|
31
|
+
): { type: "marketplace"; name: string; marketplace: string } | { type: "npm"; spec: string } {
|
|
32
|
+
// Rule 1: scoped npm package — @ at position 0 is never a marketplace separator.
|
|
33
|
+
if (spec.startsWith("@")) return { type: "npm", spec };
|
|
34
|
+
// Rule 2: @ somewhere after the first character.
|
|
35
|
+
const atIdx = spec.lastIndexOf("@");
|
|
36
|
+
if (atIdx > 0) {
|
|
37
|
+
const rhs = spec.slice(atIdx + 1);
|
|
38
|
+
// Dist-tags and version specifiers are never marketplace names.
|
|
39
|
+
if (NPM_DIST_TAGS.has(rhs) || LOOKS_LIKE_VERSION.test(rhs)) {
|
|
40
|
+
return { type: "npm", spec };
|
|
41
|
+
}
|
|
42
|
+
if (knownMarketplaces.has(rhs)) {
|
|
43
|
+
return { type: "marketplace", name: spec.slice(0, atIdx), marketplace: rhs };
|
|
44
|
+
}
|
|
45
|
+
// Not a known marketplace — treat as npm version specifier.
|
|
46
|
+
return { type: "npm", spec };
|
|
47
|
+
}
|
|
48
|
+
// Rule 3: no @ at all.
|
|
49
|
+
return { type: "npm", spec };
|
|
50
|
+
}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import * as fs from "node:fs/promises";
|
|
2
|
+
import * as os from "node:os";
|
|
3
|
+
import * as path from "node:path";
|
|
4
|
+
|
|
5
|
+
const APP_NAME = "xcsh";
|
|
6
|
+
|
|
7
|
+
export async function initXdg(): Promise<void> {
|
|
8
|
+
if (process.platform !== "linux" && process.platform !== "darwin") {
|
|
9
|
+
console.error("XDG directory setup is only supported on Linux and macOS.");
|
|
10
|
+
process.exit(1);
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
const dataHome = process.env.XDG_DATA_HOME || path.join(os.homedir(), ".local/share");
|
|
14
|
+
const stateHome = process.env.XDG_STATE_HOME || path.join(os.homedir(), ".local/state");
|
|
15
|
+
const cacheHome = process.env.XDG_CACHE_HOME || path.join(os.homedir(), ".cache");
|
|
16
|
+
|
|
17
|
+
const dirs = [path.join(dataHome, APP_NAME), path.join(stateHome, APP_NAME), path.join(cacheHome, APP_NAME)];
|
|
18
|
+
|
|
19
|
+
for (const dir of dirs) {
|
|
20
|
+
await fs.mkdir(dir, { recursive: true });
|
|
21
|
+
console.log(`Created ${dir.replace(os.homedir(), "~")}`);
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
console.log("\nXDG directories initialized.");
|
|
25
|
+
console.log("Ensure XDG_DATA_HOME, XDG_STATE_HOME, and XDG_CACHE_HOME");
|
|
26
|
+
console.log("are set in your shell profile for xcsh to use them.");
|
|
27
|
+
}
|