@sayknow-cli/coding-agent 0.7.10 → 0.7.12
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 +18 -0
- package/dist/types/async/result-formatting.d.ts +2 -0
- package/dist/types/capability/fs.d.ts +22 -3
- package/dist/types/capability/mcp.d.ts +2 -0
- package/dist/types/cli/append-system-prompt.d.ts +6 -0
- package/dist/types/cli/update-cli.d.ts +3 -0
- package/dist/types/commands/contribution-prep.d.ts +0 -3
- package/dist/types/commands/migrate.d.ts +1 -1
- package/dist/types/commands/sdk.d.ts +9 -0
- package/dist/types/commit/changelog/index.d.ts +1 -0
- package/dist/types/config/settings-schema.d.ts +14 -0
- package/dist/types/config/settings.d.ts +7 -1
- package/dist/types/coordinator-mcp/session-reaper.d.ts +5 -0
- package/dist/types/cursor-delete-path.d.ts +1 -0
- package/dist/types/cursor-mcp-name.d.ts +8 -0
- package/dist/types/dap/config.d.ts +8 -4
- package/dist/types/dap/session.d.ts +11 -2
- package/dist/types/debug/report-bundle-parent.d.ts +2 -0
- package/dist/types/debug/system-info.d.ts +6 -1
- package/dist/types/discovery/helpers.d.ts +11 -3
- package/dist/types/discovery/mcp-json.d.ts +1 -0
- package/dist/types/edit/file-read-cache.d.ts +4 -0
- package/dist/types/edit/modes/patch.d.ts +14 -0
- package/dist/types/edit/modes/replace.d.ts +8 -0
- package/dist/types/eval/py/runtime.d.ts +9 -0
- package/dist/types/exa/mcp-client.d.ts +11 -6
- package/dist/types/exec/bash-executor.d.ts +18 -1
- package/dist/types/export/html/css-color.d.ts +2 -0
- package/dist/types/export/html/html-export-destination.d.ts +2 -0
- package/dist/types/export/html/template.generated.d.ts +1 -1
- package/dist/types/extensibility/custom-tools/loader.d.ts +3 -2
- package/dist/types/extensibility/custom-tools/types.d.ts +3 -1
- package/dist/types/extensibility/plugins/marketplace/cache.d.ts +2 -0
- package/dist/types/extensibility/plugins/plugin-link-path.d.ts +2 -0
- package/dist/types/goals/runtime.d.ts +6 -0
- package/dist/types/harness-control-plane/receipt-spool.d.ts +4 -0
- package/dist/types/hindsight/content.d.ts +5 -6
- package/dist/types/internal-urls/skill-path.d.ts +1 -0
- package/dist/types/internal-urls/types.d.ts +2 -0
- package/dist/types/lsp/clients/swiftlint-client.d.ts +0 -4
- package/dist/types/lsp/config.d.ts +8 -5
- package/dist/types/lsp/workspace-path.d.ts +1 -0
- package/dist/types/migrate/adapters/codex.d.ts +2 -1
- package/dist/types/migrate/adapters/index.d.ts +10 -1
- package/dist/types/migrate/executor.d.ts +3 -1
- package/dist/types/migrate/types.d.ts +15 -3
- package/dist/types/modes/components/custom-editor.d.ts +6 -0
- package/dist/types/modes/components/extensions/state-manager.d.ts +4 -3
- package/dist/types/modes/components/model-selector.d.ts +46 -0
- package/dist/types/modes/controllers/input-controller.d.ts +9 -0
- package/dist/types/modes/interactive-mode.d.ts +1 -0
- package/dist/types/modes/utils/macos-option-forwarding.d.ts +17 -0
- package/dist/types/runtime-mcp/content-limits.d.ts +4 -0
- package/dist/types/runtime-mcp/manager.d.ts +9 -1
- package/dist/types/runtime-mcp/mcp-redirect.d.ts +9 -0
- package/dist/types/runtime-mcp/oauth-public-url.d.ts +1 -0
- package/dist/types/runtime-mcp/plugin-mcp-name-filter.d.ts +22 -0
- package/dist/types/runtime-mcp/plugin-network-boundary.d.ts +1 -0
- package/dist/types/runtime-mcp/project-host-values.d.ts +33 -0
- package/dist/types/runtime-mcp/smithery-registry.d.ts +24 -0
- package/dist/types/runtime-mcp/tool-bridge.d.ts +4 -0
- package/dist/types/runtime-mcp/types.d.ts +6 -0
- package/dist/types/sdk/broker/ensure.d.ts +2 -0
- package/dist/types/sdk/broker/lifecycle-ledger.d.ts +5 -1
- package/dist/types/sdk/broker/runtime.d.ts +1 -1
- package/dist/types/sdk/bus/chat-daemon-control.d.ts +3 -1
- package/dist/types/sdk/bus/telegram-daemon-contract.d.ts +3 -1
- package/dist/types/sdk/bus/telegram-daemon.d.ts +1 -0
- package/dist/types/sdk/host/events.d.ts +4 -0
- package/dist/types/session/agent-session.d.ts +20 -1
- package/dist/types/session/messages.d.ts +5 -1
- package/dist/types/session/session-manager.d.ts +13 -0
- package/dist/types/session/session-storage.d.ts +8 -0
- package/dist/types/session/streaming-output.d.ts +11 -0
- package/dist/types/session-import/redact.d.ts +1 -1
- package/dist/types/skc-runtime/managed-owner-admission.d.ts +3 -0
- package/dist/types/skc-runtime/psmux-detect.d.ts +5 -4
- package/dist/types/skc-runtime/ralplan-runtime.d.ts +5 -0
- package/dist/types/skc-runtime/sidecar-bootstrap-env.d.ts +6 -0
- package/dist/types/skc-runtime/state-writer.d.ts +4 -1
- package/dist/types/skc-runtime/tmux-sessions.d.ts +24 -0
- package/dist/types/skc-runtime/ultragoal-runtime.d.ts +4 -0
- package/dist/types/skill-state/workflow-mutation-guard.d.ts +20 -1
- package/dist/types/slash-commands/helpers/mcp.d.ts +5 -0
- package/dist/types/ssh/ssh-executor.d.ts +3 -1
- package/dist/types/system-prompt.d.ts +5 -2
- package/dist/types/task/executor.d.ts +17 -3
- package/dist/types/task/isolation-dir.d.ts +26 -0
- package/dist/types/task/role-body.d.ts +11 -0
- package/dist/types/task/token-log-mode.test.d.ts +1 -0
- package/dist/types/tools/ask.d.ts +77 -254
- package/dist/types/tools/ast-edit-write-path.d.ts +23 -0
- package/dist/types/tools/atomic-file-write.d.ts +74 -0
- package/dist/types/tools/auto-generated-guard.d.ts +5 -2
- package/dist/types/tools/bash-allowed-prefixes.d.ts +16 -0
- package/dist/types/tools/bash-interactive.d.ts +2 -0
- package/dist/types/tools/bash-skill-urls.d.ts +5 -1
- package/dist/types/tools/bash.d.ts +1 -0
- package/dist/types/tools/browser/cdp-url.d.ts +2 -0
- package/dist/types/tools/browser/tab-worker.d.ts +2 -0
- package/dist/types/tools/debug.d.ts +2 -2
- package/dist/types/tools/explicit-artifact.d.ts +8 -0
- package/dist/types/tools/fetch.d.ts +7 -4
- package/dist/types/tools/github-side-effect.d.ts +22 -0
- package/dist/types/tools/index.d.ts +3 -0
- package/dist/types/tools/monitor-mutation.d.ts +9 -0
- package/dist/types/tools/recipe/index.d.ts +2 -0
- package/dist/types/tools/recipe/recipe-guard.d.ts +7 -0
- package/dist/types/tools/restricted-cwd.d.ts +1 -0
- package/dist/types/tools/reverse-engineer.d.ts +81 -0
- package/dist/types/tools/search-tool-bm25.d.ts +2 -0
- package/dist/types/tools/tmux-self-injection-guard.d.ts +17 -0
- package/dist/types/tools/untrusted-content.d.ts +12 -0
- package/dist/types/utils/file-mentions.d.ts +5 -0
- package/dist/types/utils/open.d.ts +0 -1
- package/dist/types/utils/shell-snapshot.d.ts +2 -0
- package/dist/types/utils/title-generator.d.ts +12 -2
- package/dist/types/utils/tools-checksum.d.ts +7 -0
- package/dist/types/utils/xml-escape.d.ts +2 -0
- package/dist/types/web/scrapers/types.d.ts +8 -1
- package/dist/types/web/search/providers/codex.d.ts +6 -7
- package/dist/types/web/search/providers/insane.d.ts +7 -1
- package/dist/types/web/search/providers/kimi.d.ts +2 -0
- package/dist/types/web/search/providers/searxng.d.ts +7 -0
- package/dist/types/web/search/providers/xai.d.ts +2 -0
- package/package.json +7 -7
- package/scripts/generate-sdk-operation-inventory.ts +4 -0
- package/src/async/job-manager.ts +23 -9
- package/src/async/result-formatting.ts +40 -0
- package/src/capability/fs.ts +78 -11
- package/src/capability/mcp.ts +2 -0
- package/src/cli/append-system-prompt.ts +12 -0
- package/src/cli/auth-broker-cli.ts +22 -12
- package/src/cli/config-cli.ts +8 -18
- package/src/cli/migrate-cli.ts +7 -5
- package/src/cli/ssh-cli.ts +6 -3
- package/src/cli/stats-cli.ts +9 -4
- package/src/cli/update-cli.ts +42 -0
- package/src/cli/web-search-cli.ts +9 -3
- package/src/cli.ts +5 -9
- package/src/commands/commit.ts +2 -2
- package/src/commands/contribution-prep.ts +1 -3
- package/src/commands/harness.ts +25 -15
- package/src/commands/launch.ts +1 -1
- package/src/commands/migrate.ts +3 -3
- package/src/commands/sdk.ts +115 -14
- package/src/commands/ultragoal.ts +14 -8
- package/src/commit/agentic/agent.ts +6 -6
- package/src/commit/analysis/conventional.ts +14 -5
- package/src/commit/changelog/index.ts +39 -1
- package/src/commit/message.ts +10 -3
- package/src/config/config-file.ts +106 -3
- package/src/config/keybindings.ts +154 -7
- package/src/config/mcp-schema.json +4 -0
- package/src/config/model-registry.ts +10 -2
- package/src/config/settings-schema.ts +18 -0
- package/src/config/settings.ts +32 -4
- package/src/coordinator-mcp/policy.ts +14 -4
- package/src/coordinator-mcp/server.ts +44 -4
- package/src/coordinator-mcp/session-reaper.ts +9 -1
- package/src/cursor-delete-path.ts +10 -0
- package/src/cursor-mcp-name.ts +15 -0
- package/src/cursor.ts +13 -2
- package/src/dap/client.ts +9 -2
- package/src/dap/config.ts +33 -13
- package/src/dap/defaults.json +1 -1
- package/src/dap/session.ts +161 -36
- package/src/debug/crash-diagnostics.ts +89 -6
- package/src/debug/report-bundle-parent.ts +22 -0
- package/src/debug/report-bundle.ts +100 -3
- package/src/debug/system-info.ts +21 -4
- package/src/defaults/skc/extensions/grok-cli-vendor/src/shared/base-url.ts +21 -7
- package/src/defaults/skc/skills/deep-interview/SKILL.md +1 -1
- package/src/discovery/agents-md.ts +3 -2
- package/src/discovery/agents.ts +3 -2
- package/src/discovery/builtin.ts +21 -11
- package/src/discovery/claude.ts +5 -4
- package/src/discovery/cline.ts +2 -2
- package/src/discovery/codex.ts +6 -5
- package/src/discovery/cursor.ts +11 -2
- package/src/discovery/gemini.ts +4 -3
- package/src/discovery/github.ts +2 -2
- package/src/discovery/helpers.ts +51 -11
- package/src/discovery/mcp-json.ts +28 -12
- package/src/discovery/opencode.ts +2 -1
- package/src/discovery/ssh.ts +11 -6
- package/src/discovery/substitute-plugin-root.ts +3 -1
- package/src/discovery/vscode.ts +3 -3
- package/src/edit/apply-patch/index.ts +12 -1
- package/src/edit/file-read-cache.ts +24 -6
- package/src/edit/index.ts +90 -20
- package/src/edit/modes/patch.ts +215 -9
- package/src/edit/modes/replace.ts +141 -0
- package/src/eval/js/context-manager.ts +29 -3
- package/src/eval/js/worker-entry.ts +51 -18
- package/src/eval/py/runner.py +144 -5
- package/src/eval/py/runtime.ts +44 -4
- package/src/eval/py/tool-bridge.ts +4 -0
- package/src/exa/mcp-client.ts +53 -11
- package/src/exec/bash-executor.ts +87 -4
- package/src/exec/non-interactive-env.ts +0 -1
- package/src/export/html/css-color.ts +9 -0
- package/src/export/html/html-export-destination.ts +16 -0
- package/src/export/html/index.ts +102 -8
- package/src/export/html/template.generated.ts +1 -1
- package/src/extensibility/custom-tools/loader.ts +13 -3
- package/src/extensibility/custom-tools/types.ts +3 -1
- package/src/extensibility/custom-tools/wrapper.ts +3 -1
- package/src/extensibility/plugins/manager.ts +3 -2
- package/src/extensibility/plugins/marketplace/cache.ts +15 -0
- package/src/extensibility/plugins/marketplace/fetcher.ts +2 -2
- package/src/extensibility/plugins/marketplace/manager.ts +5 -3
- package/src/extensibility/plugins/plugin-link-path.ts +12 -0
- package/src/extensibility/skc-plugins/mcp-policy.ts +2 -1
- package/src/goals/runtime.ts +30 -8
- package/src/harness-control-plane/finalize.ts +10 -0
- package/src/harness-control-plane/operate.ts +12 -4
- package/src/harness-control-plane/owner.ts +8 -1
- package/src/harness-control-plane/receipt-spool.ts +105 -28
- package/src/harness-control-plane/storage.ts +124 -6
- package/src/hashline/execute.ts +3 -3
- package/src/hashline/recovery.ts +85 -2
- package/src/hindsight/config.ts +9 -3
- package/src/hindsight/content.ts +116 -16
- package/src/hindsight/mental-models.ts +22 -10
- package/src/hindsight/state.ts +7 -4
- package/src/hooks/native-skill-hook.ts +17 -12
- package/src/i18n/messages/de.settings.ts +3 -0
- package/src/i18n/messages/es.settings.ts +3 -0
- package/src/i18n/messages/fr.settings.ts +3 -0
- package/src/i18n/messages/ja.settings.ts +3 -0
- package/src/i18n/messages/ko.settings.ts +3 -0
- package/src/i18n/messages/zh.settings.ts +3 -0
- package/src/internal-urls/artifact-protocol.ts +3 -1
- package/src/internal-urls/docs-index.generated.ts +10 -10
- package/src/internal-urls/local-protocol.ts +167 -8
- package/src/internal-urls/skill-path.ts +18 -0
- package/src/internal-urls/skill-protocol.ts +2 -0
- package/src/internal-urls/types.ts +2 -0
- package/src/lsp/client.ts +2 -1
- package/src/lsp/clients/biome-client.ts +2 -0
- package/src/lsp/clients/swiftlint-client.ts +2 -0
- package/src/lsp/config.ts +18 -62
- package/src/lsp/edits.ts +6 -0
- package/src/lsp/index.ts +29 -0
- package/src/lsp/workspace-path.ts +75 -0
- package/src/main.ts +33 -11
- package/src/memories/index.ts +141 -9
- package/src/migrate/action-planner.ts +57 -0
- package/src/migrate/adapters/claude-code.ts +23 -4
- package/src/migrate/adapters/codex.ts +22 -4
- package/src/migrate/adapters/index.ts +22 -4
- package/src/migrate/adapters/opencode.ts +6 -1
- package/src/migrate/executor.ts +84 -7
- package/src/migrate/report.ts +19 -2
- package/src/migrate/types.ts +14 -4
- package/src/modes/DESIGN.md +5 -0
- package/src/modes/acp/acp-agent.ts +35 -2
- package/src/modes/acp/permission-mode.ts +18 -1
- package/src/modes/components/custom-editor.ts +14 -0
- package/src/modes/components/extensions/extension-dashboard.ts +2 -2
- package/src/modes/components/extensions/inspector-panel.ts +9 -5
- package/src/modes/components/extensions/state-manager.ts +15 -5
- package/src/modes/components/model-selector.ts +144 -94
- package/src/modes/components/welcome.ts +3 -2
- package/src/modes/controllers/command-controller.ts +300 -9
- package/src/modes/controllers/event-controller.ts +1 -1
- package/src/modes/controllers/extension-ui-controller.ts +32 -19
- package/src/modes/controllers/input-controller.ts +62 -26
- package/src/modes/controllers/plan-mode-controller.ts +17 -7
- package/src/modes/controllers/runtime-mcp-command-controller.ts +25 -20
- package/src/modes/controllers/ssh-command-controller.ts +3 -1
- package/src/modes/interactive-mode.ts +10 -0
- package/src/modes/utils/macos-option-forwarding.ts +80 -0
- package/src/prompts/system/irc-incoming.md +3 -1
- package/src/prompts/system/project-prompt.md +19 -0
- package/src/prompts/system/system-prompt.md +3 -0
- package/src/prompts/tools/ask.md +2 -0
- package/src/prompts/tools/debug.md +1 -1
- package/src/prompts/tools/monitor.md +7 -5
- package/src/prompts/tools/reverse-engineer.md +29 -0
- package/src/runtime-credential-selector.ts +2 -2
- package/src/runtime-mcp/config-writer.ts +10 -6
- package/src/runtime-mcp/config.ts +1 -0
- package/src/runtime-mcp/content-limits.ts +7 -0
- package/src/runtime-mcp/json-rpc.ts +2 -1
- package/src/runtime-mcp/manager.ts +57 -9
- package/src/runtime-mcp/mcp-redirect.ts +73 -0
- package/src/runtime-mcp/oauth-flow.ts +43 -5
- package/src/runtime-mcp/oauth-public-url.ts +8 -0
- package/src/runtime-mcp/plugin-mcp-name-filter.ts +62 -0
- package/src/runtime-mcp/plugin-network-boundary.ts +4 -0
- package/src/runtime-mcp/project-host-values.ts +50 -0
- package/src/runtime-mcp/render.ts +16 -1
- package/src/runtime-mcp/smithery-registry.ts +22 -3
- package/src/runtime-mcp/tool-bridge.ts +194 -21
- package/src/runtime-mcp/transports/http.ts +4 -3
- package/src/runtime-mcp/transports/stdio.ts +2 -1
- package/src/runtime-mcp/types.ts +6 -0
- package/src/sdk/broker/broker.ts +11 -2
- package/src/sdk/broker/ensure.ts +131 -10
- package/src/sdk/broker/lifecycle-ledger.ts +18 -3
- package/src/sdk/broker/lifecycle.ts +21 -19
- package/src/sdk/broker/runtime.ts +1 -1
- package/src/sdk/bus/chat-daemon-cli.ts +38 -1
- package/src/sdk/bus/chat-daemon-control.ts +5 -3
- package/src/sdk/bus/index.ts +5 -3
- package/src/sdk/bus/lifecycle-control-runtime.ts +9 -2
- package/src/sdk/bus/session-control.ts +2 -0
- package/src/sdk/bus/slack-daemon.ts +8 -1
- package/src/sdk/bus/slack-live-provider.ts +3 -1
- package/src/sdk/bus/telegram-daemon-contract.ts +3 -1
- package/src/sdk/bus/telegram-daemon-control.ts +17 -12
- package/src/sdk/bus/telegram-daemon.ts +41 -1
- package/src/sdk/host/events.ts +67 -4
- package/src/sdk/mcp/server.ts +16 -3
- package/src/sdk/protocol/operation-inventory.generated.json +22 -0
- package/src/sdk/session.ts +18 -25
- package/src/secrets/obfuscator.ts +92 -12
- package/src/session/agent-session.ts +395 -79
- package/src/session/artifacts.ts +3 -1
- package/src/session/history-storage.ts +172 -8
- package/src/session/internal/managed-session-scope.ts +130 -52
- package/src/session/messages.ts +47 -6
- package/src/session/session-manager.ts +170 -10
- package/src/session/session-storage.ts +31 -1
- package/src/session/streaming-output.ts +263 -4
- package/src/session-import/redact.ts +76 -3
- package/src/setup/hermes-setup.ts +4 -1
- package/src/skc-runtime/gc-runtime.ts +26 -4
- package/src/skc-runtime/launch-tmux.ts +21 -11
- package/src/skc-runtime/launch-worktree.ts +42 -3
- package/src/skc-runtime/managed-owner-admission.ts +46 -2
- package/src/skc-runtime/psmux-detect.ts +29 -5
- package/src/skc-runtime/ralplan-runtime.ts +14 -1
- package/src/skc-runtime/session-resolution.ts +38 -6
- package/src/skc-runtime/sidecar-bootstrap-env.ts +19 -0
- package/src/skc-runtime/state-writer.ts +134 -16
- package/src/skc-runtime/tmux-sessions.ts +85 -4
- package/src/skc-runtime/ultragoal-change-set.ts +18 -2
- package/src/skc-runtime/ultragoal-guard.ts +9 -1
- package/src/skc-runtime/ultragoal-runtime.ts +26 -9
- package/src/skill-state/active-state.ts +13 -0
- package/src/skill-state/workflow-mutation-guard.ts +3297 -180
- package/src/slash-commands/builtin-registry.ts +14 -8
- package/src/slash-commands/helpers/mcp.ts +20 -7
- package/src/ssh/ssh-executor.ts +3 -1
- package/src/stt/recorder.ts +26 -9
- package/src/system-prompt.ts +65 -16
- package/src/task/commands.ts +3 -1
- package/src/task/executor.ts +52 -7
- package/src/task/index.ts +28 -0
- package/src/task/isolation-dir.ts +143 -0
- package/src/task/role-body.ts +84 -0
- package/src/task/token-log-mode.test.ts +162 -0
- package/src/task/token-log.ts +91 -2
- package/src/task/worktree.ts +16 -7
- package/src/tools/archive-reader.ts +653 -31
- package/src/tools/ask.ts +86 -14
- package/src/tools/ast-edit-write-path.ts +133 -0
- package/src/tools/ast-edit.ts +27 -1
- package/src/tools/ast-grep.ts +7 -2
- package/src/tools/atomic-file-write.ts +625 -0
- package/src/tools/auto-generated-guard.ts +28 -8
- package/src/tools/bash-allowed-prefixes.ts +225 -6
- package/src/tools/bash-interactive.ts +12 -0
- package/src/tools/bash-skill-urls.ts +113 -7
- package/src/tools/bash.ts +152 -20
- package/src/tools/browser/cdp-url.ts +18 -0
- package/src/tools/browser/tab-worker.ts +49 -14
- package/src/tools/browser.ts +25 -8
- package/src/tools/cron.ts +10 -1
- package/src/tools/debug.ts +16 -8
- package/src/tools/eval.ts +71 -34
- package/src/tools/explicit-artifact.ts +89 -0
- package/src/tools/fetch.ts +26 -17
- package/src/tools/gh.ts +40 -12
- package/src/tools/github-side-effect.ts +112 -0
- package/src/tools/image-gen.ts +24 -10
- package/src/tools/index.ts +6 -0
- package/src/tools/monitor-mutation.ts +27 -0
- package/src/tools/monitor.ts +28 -1
- package/src/tools/output-meta.ts +74 -5
- package/src/tools/read.ts +24 -36
- package/src/tools/recipe/index.ts +12 -0
- package/src/tools/recipe/recipe-guard.ts +19 -0
- package/src/tools/recipe/runner.ts +23 -12
- package/src/tools/render-utils.ts +2 -2
- package/src/tools/restricted-cwd.ts +10 -0
- package/src/tools/reverse-engineer.ts +497 -0
- package/src/tools/search-tool-bm25.ts +14 -3
- package/src/tools/search.ts +3 -2
- package/src/tools/ssh.ts +235 -8
- package/src/tools/subagent-render.ts +43 -7
- package/src/tools/subagent.ts +7 -3
- package/src/tools/tmux-self-injection-guard.ts +3538 -0
- package/src/tools/todo-write.ts +41 -3
- package/src/tools/untrusted-content.ts +23 -0
- package/src/tools/vim.ts +2 -2
- package/src/tools/write.ts +37 -4
- package/src/tui/tree-list.ts +15 -1
- package/src/utils/commit-message-generator.ts +9 -2
- package/src/utils/external-editor.ts +21 -7
- package/src/utils/file-mentions.ts +75 -7
- package/src/utils/git.ts +38 -7
- package/src/utils/open.ts +73 -4
- package/src/utils/shell-snapshot.ts +9 -1
- package/src/utils/title-generator.ts +61 -16
- package/src/utils/tools-checksum.ts +34 -0
- package/src/utils/tools-manager.ts +24 -6
- package/src/utils/xml-escape.ts +14 -0
- package/src/web/insane/url-guard.ts +2 -1
- package/src/web/scrapers/types.ts +8 -0
- package/src/web/scrapers/youtube.ts +3 -2
- package/src/web/search/index.ts +4 -3
- package/src/web/search/providers/anthropic.ts +4 -4
- package/src/web/search/providers/codex.ts +31 -34
- package/src/web/search/providers/insane.ts +145 -28
- package/src/web/search/providers/kimi.ts +15 -5
- package/src/web/search/providers/searxng.ts +47 -4
- package/src/web/search/providers/xai.ts +7 -2
- package/dist/types/cli/shell-cli.d.ts +0 -8
- package/dist/types/commands/shell.d.ts +0 -21
- package/src/cli/shell-cli.ts +0 -176
- package/src/commands/shell.ts +0 -29
package/src/sdk/host/events.ts
CHANGED
|
@@ -25,10 +25,37 @@ export interface EventReplay {
|
|
|
25
25
|
gap?: EventReplayGap;
|
|
26
26
|
}
|
|
27
27
|
|
|
28
|
+
/** Kinds emit sites suppress once notification redaction is on. */
|
|
29
|
+
const REDACTED_REPLAY_KINDS: ReadonlySet<string> = new Set([
|
|
30
|
+
"turn_stream",
|
|
31
|
+
"context_update",
|
|
32
|
+
"image_attachment",
|
|
33
|
+
"file_attachment",
|
|
34
|
+
"reasoning_summary",
|
|
35
|
+
"tool_activity",
|
|
36
|
+
]);
|
|
37
|
+
|
|
38
|
+
const outboundRedactBySession = new Map<string, boolean>();
|
|
39
|
+
|
|
40
|
+
/** Notification policy refresh records the live redaction bit for one session ring. */
|
|
41
|
+
export function setSessionOutboundRedact(sessionId: string, enabled: boolean): void {
|
|
42
|
+
outboundRedactBySession.set(sessionId, enabled);
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
function frameSessionId(frame: SdkFrame): string | undefined {
|
|
46
|
+
if (typeof frame.sessionId === "string") return frame.sessionId;
|
|
47
|
+
const payload = frame.payload;
|
|
48
|
+
if (!payload || typeof payload !== "object") return undefined;
|
|
49
|
+
const sessionId = (payload as { sessionId?: unknown }).sessionId;
|
|
50
|
+
return typeof sessionId === "string" ? sessionId : undefined;
|
|
51
|
+
}
|
|
52
|
+
|
|
28
53
|
export class SessionEventStream {
|
|
29
54
|
#generation = 0;
|
|
30
55
|
#seq = 0;
|
|
31
56
|
#frames: EventFrame[] = [];
|
|
57
|
+
#outboundRedact = false;
|
|
58
|
+
#sessionId: string | undefined;
|
|
32
59
|
readonly #ringSize: number;
|
|
33
60
|
readonly #resyncQueries: string[];
|
|
34
61
|
|
|
@@ -45,6 +72,12 @@ export class SessionEventStream {
|
|
|
45
72
|
return this.#seq;
|
|
46
73
|
}
|
|
47
74
|
|
|
75
|
+
/** Follow the session redaction bit. Replay then drops kinds emit sites already suppress. */
|
|
76
|
+
setOutboundRedact(enabled: boolean): void {
|
|
77
|
+
this.#outboundRedact = enabled;
|
|
78
|
+
if (this.#sessionId !== undefined) outboundRedactBySession.set(this.#sessionId, enabled);
|
|
79
|
+
}
|
|
80
|
+
|
|
48
81
|
restart(): number {
|
|
49
82
|
this.#generation += 1;
|
|
50
83
|
this.#seq = 0;
|
|
@@ -53,6 +86,8 @@ export class SessionEventStream {
|
|
|
53
86
|
}
|
|
54
87
|
|
|
55
88
|
emit(frame: SdkFrame): EventFrame {
|
|
89
|
+
this.#noteSession(frame);
|
|
90
|
+
this.#noteConfigRedact(frame);
|
|
56
91
|
const event: EventFrame = { ...frame, type: "event", generation: this.#generation, seq: ++this.#seq };
|
|
57
92
|
this.#frames.push(event);
|
|
58
93
|
if (this.#frames.length > this.#ringSize) this.#frames.shift();
|
|
@@ -61,10 +96,9 @@ export class SessionEventStream {
|
|
|
61
96
|
|
|
62
97
|
/** Replays retained current-generation events and reports any required resynchronization. */
|
|
63
98
|
replay(lastSeq: number, generation = this.#generation): EventReplay {
|
|
64
|
-
const events = this.#frames.filter(frame => frame.seq > lastSeq);
|
|
65
99
|
if (generation !== this.#generation) {
|
|
66
100
|
return {
|
|
67
|
-
events:
|
|
101
|
+
events: this.#visible(this.#frames),
|
|
68
102
|
gap: {
|
|
69
103
|
kind: "generation_reset",
|
|
70
104
|
fromGeneration: generation,
|
|
@@ -77,7 +111,7 @@ export class SessionEventStream {
|
|
|
77
111
|
const replayFrom = lastSeq + 1;
|
|
78
112
|
if (replayFrom < oldest) {
|
|
79
113
|
return {
|
|
80
|
-
events: this.#frames.filter(frame => frame.seq >= oldest),
|
|
114
|
+
events: this.#visible(this.#frames.filter(frame => frame.seq >= oldest)),
|
|
81
115
|
gap: {
|
|
82
116
|
kind: "sequence_gap",
|
|
83
117
|
fromSeq: replayFrom,
|
|
@@ -86,6 +120,35 @@ export class SessionEventStream {
|
|
|
86
120
|
},
|
|
87
121
|
};
|
|
88
122
|
}
|
|
89
|
-
return { events };
|
|
123
|
+
return { events: this.#visible(this.#frames.filter(frame => frame.seq > lastSeq)) };
|
|
124
|
+
}
|
|
125
|
+
|
|
126
|
+
#noteSession(frame: SdkFrame): void {
|
|
127
|
+
if (this.#sessionId !== undefined) return;
|
|
128
|
+
this.#sessionId = frameSessionId(frame);
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
#noteConfigRedact(frame: SdkFrame): void {
|
|
132
|
+
if (frame.kind !== "config_update") return;
|
|
133
|
+
const payload = frame.payload;
|
|
134
|
+
if (!payload || typeof payload !== "object") return;
|
|
135
|
+
const redact = (payload as { redact?: unknown }).redact;
|
|
136
|
+
if (typeof redact !== "boolean") return;
|
|
137
|
+
this.setOutboundRedact(redact);
|
|
138
|
+
}
|
|
139
|
+
|
|
140
|
+
#replayRedact(): boolean {
|
|
141
|
+
if (this.#sessionId !== undefined) {
|
|
142
|
+
const noted = outboundRedactBySession.get(this.#sessionId);
|
|
143
|
+
if (noted !== undefined) return noted;
|
|
144
|
+
}
|
|
145
|
+
return this.#outboundRedact;
|
|
146
|
+
}
|
|
147
|
+
|
|
148
|
+
#visible(frames: readonly EventFrame[]): EventFrame[] {
|
|
149
|
+
const retained = this.#replayRedact()
|
|
150
|
+
? frames.filter(frame => !REDACTED_REPLAY_KINDS.has(String(frame.kind)))
|
|
151
|
+
: frames;
|
|
152
|
+
return [...retained];
|
|
90
153
|
}
|
|
91
154
|
}
|
package/src/sdk/mcp/server.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import path from "node:path";
|
|
2
|
-
import { getAgentDir } from "@sayknow-cli/utils";
|
|
2
|
+
import { getAgentDir, VERSION } from "@sayknow-cli/utils";
|
|
3
3
|
import { ensureBroker } from "../broker/ensure";
|
|
4
4
|
import { SdkClient, SdkClientError } from "../client/client";
|
|
5
5
|
import {
|
|
@@ -12,6 +12,8 @@ import { validateAdapterControl, validateAdapterSecretFields } from "../protocol
|
|
|
12
12
|
import { adapterDispositionError, findOperation } from "../protocol/operation-registry";
|
|
13
13
|
|
|
14
14
|
const PROTOCOL_VERSION = "2024-11-05";
|
|
15
|
+
const SUPPORTED_PROTOCOL_VERSIONS = [PROTOCOL_VERSION, "2025-03-26", "2025-06-18"] as const;
|
|
16
|
+
const NEWEST_PROTOCOL_VERSION = SUPPORTED_PROTOCOL_VERSIONS[SUPPORTED_PROTOCOL_VERSIONS.length - 1];
|
|
15
17
|
const SERVER_NAME = "skc-sdk-mcp";
|
|
16
18
|
const ENDPOINT_CREDENTIAL_OPERATION = "session.get_endpoint";
|
|
17
19
|
|
|
@@ -101,6 +103,17 @@ function isObject(value: unknown): value is Arguments {
|
|
|
101
103
|
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
102
104
|
}
|
|
103
105
|
|
|
106
|
+
/** Echo a supported client protocol version; otherwise offer the newest one this server speaks. */
|
|
107
|
+
function negotiatedProtocolVersion(params: unknown): string {
|
|
108
|
+
const requestedProtocolVersion = isObject(params) ? params.protocolVersion : undefined;
|
|
109
|
+
if (
|
|
110
|
+
typeof requestedProtocolVersion === "string" &&
|
|
111
|
+
(SUPPORTED_PROTOCOL_VERSIONS as readonly string[]).includes(requestedProtocolVersion)
|
|
112
|
+
)
|
|
113
|
+
return requestedProtocolVersion;
|
|
114
|
+
return NEWEST_PROTOCOL_VERSION;
|
|
115
|
+
}
|
|
116
|
+
|
|
104
117
|
function asString(args: Arguments, name: string): string | null {
|
|
105
118
|
return typeof args[name] === "string" && args[name] ? (args[name] as string) : null;
|
|
106
119
|
}
|
|
@@ -271,9 +284,9 @@ export function createSdkMcpServer(options: SdkMcpServerOptions = {}) {
|
|
|
271
284
|
jsonrpc: "2.0",
|
|
272
285
|
id,
|
|
273
286
|
result: {
|
|
274
|
-
protocolVersion:
|
|
287
|
+
protocolVersion: negotiatedProtocolVersion(request.params),
|
|
275
288
|
capabilities: { tools: {} },
|
|
276
|
-
serverInfo: { name: SERVER_NAME },
|
|
289
|
+
serverInfo: { name: SERVER_NAME, version: VERSION },
|
|
277
290
|
},
|
|
278
291
|
};
|
|
279
292
|
if (request.method === "tools/list")
|
|
@@ -3388,6 +3388,28 @@
|
|
|
3388
3388
|
"testIds": "not_applicable"
|
|
3389
3389
|
}
|
|
3390
3390
|
},
|
|
3391
|
+
{
|
|
3392
|
+
"sourceId": "agent_session:resolvePromptSkillInvocation",
|
|
3393
|
+
"sourceFile": "packages/coding-agent/src/session/agent-session.ts",
|
|
3394
|
+
"sourceKind": "agent_session",
|
|
3395
|
+
"decision": "exclude",
|
|
3396
|
+
"rationale": "internal prompt-dispatch classifier shared with interactive title seeding, not a user-facing control seam",
|
|
3397
|
+
"exclusionMetadata": {
|
|
3398
|
+
"adapterMappings": "not_applicable",
|
|
3399
|
+
"testIds": "not_applicable"
|
|
3400
|
+
}
|
|
3401
|
+
},
|
|
3402
|
+
{
|
|
3403
|
+
"sourceId": "agent_session:isLocallyHandledSlashCommand",
|
|
3404
|
+
"sourceFile": "packages/coding-agent/src/session/agent-session.ts",
|
|
3405
|
+
"sourceKind": "agent_session",
|
|
3406
|
+
"decision": "exclude",
|
|
3407
|
+
"rationale": "internal slash-command classifier that keeps command text out of title seeding, not a user-facing control seam",
|
|
3408
|
+
"exclusionMetadata": {
|
|
3409
|
+
"adapterMappings": "not_applicable",
|
|
3410
|
+
"testIds": "not_applicable"
|
|
3411
|
+
}
|
|
3412
|
+
},
|
|
3391
3413
|
{
|
|
3392
3414
|
"sourceId": "agent_session:prompt",
|
|
3393
3415
|
"sourceFile": "packages/coding-agent/src/session/agent-session.ts",
|
package/src/sdk/session.ts
CHANGED
|
@@ -34,6 +34,7 @@ import {
|
|
|
34
34
|
resolveAppendOnlyMode,
|
|
35
35
|
} from "../append-only-mode";
|
|
36
36
|
import { type AsyncJob, AsyncJobManager, isBackgroundJobSupportEnabled, jobElapsedMs } from "../async";
|
|
37
|
+
import { formatAsyncResultForFollowUp } from "../async/result-formatting";
|
|
37
38
|
import { loadCapability } from "../capability";
|
|
38
39
|
import { type Rule, ruleCapability, setActiveRules } from "../capability/rule";
|
|
39
40
|
import { kNoAuth, ModelRegistry } from "../config/model-registry";
|
|
@@ -90,6 +91,7 @@ import btwUserPrompt from "../prompts/system/btw-user.md" with { type: "text" };
|
|
|
90
91
|
import asyncResultTemplate from "../prompts/tools/async-result.md" with { type: "text" };
|
|
91
92
|
import { AgentRegistry, MAIN_AGENT_ID } from "../registry/agent-registry";
|
|
92
93
|
import { MCPManager } from "../runtime-mcp";
|
|
94
|
+
import { omitPluginMcpNameShadows, retainPluginMcpMandatoryNames } from "../runtime-mcp/plugin-mcp-name-filter";
|
|
93
95
|
import { createNotificationsExtension } from "../sdk/bus";
|
|
94
96
|
import {
|
|
95
97
|
getNotificationConfig,
|
|
@@ -156,6 +158,7 @@ import {
|
|
|
156
158
|
WriteTool,
|
|
157
159
|
} from "../tools";
|
|
158
160
|
import { ToolContextStore } from "../tools/context";
|
|
161
|
+
import { wrapUntrustedContent } from "../tools/fetch";
|
|
159
162
|
import { getImageGenTools } from "../tools/image-gen";
|
|
160
163
|
import { wrapToolWithMetaNotice } from "../tools/output-meta";
|
|
161
164
|
import { guardToolForUltragoalAsk } from "../tools/ultragoal-ask-guard";
|
|
@@ -862,7 +865,10 @@ function buildMCPPromptCommands(manager: MCPManager): LoadedCustomCommand[] {
|
|
|
862
865
|
}
|
|
863
866
|
}
|
|
864
867
|
}
|
|
865
|
-
|
|
868
|
+
const body = parts.join("\n\n");
|
|
869
|
+
// A blank body must stay blank so the prompt entry still rejects it.
|
|
870
|
+
if (body.trim().length === 0) return body;
|
|
871
|
+
return wrapUntrustedContent(body);
|
|
866
872
|
},
|
|
867
873
|
},
|
|
868
874
|
});
|
|
@@ -1387,28 +1393,6 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
|
|
|
1387
1393
|
|
|
1388
1394
|
const backgroundJobsEnabled = isBackgroundJobSupportEnabled(settings);
|
|
1389
1395
|
const asyncMaxJobs = Math.min(100, Math.max(1, settings.get("async.maxJobs") ?? 100));
|
|
1390
|
-
const ASYNC_INLINE_RESULT_MAX_CHARS = 12_000;
|
|
1391
|
-
const ASYNC_PREVIEW_MAX_CHARS = 4_000;
|
|
1392
|
-
const formatAsyncResultForFollowUp = async (result: string): Promise<string> => {
|
|
1393
|
-
if (result.length <= ASYNC_INLINE_RESULT_MAX_CHARS) {
|
|
1394
|
-
return result;
|
|
1395
|
-
}
|
|
1396
|
-
|
|
1397
|
-
const preview = `${result.slice(0, ASYNC_PREVIEW_MAX_CHARS)}\n\n[Output truncated. Showing first ${ASYNC_PREVIEW_MAX_CHARS.toLocaleString()} characters.]`;
|
|
1398
|
-
try {
|
|
1399
|
-
const { path: artifactPath, id: artifactId } = await sessionManager.allocateArtifactPath("async");
|
|
1400
|
-
if (artifactPath && artifactId) {
|
|
1401
|
-
await Bun.write(artifactPath, result);
|
|
1402
|
-
return `${preview}\nFull output: artifact://${artifactId}`;
|
|
1403
|
-
}
|
|
1404
|
-
} catch (error) {
|
|
1405
|
-
logger.warn("Failed to persist async follow-up artifact", {
|
|
1406
|
-
error: error instanceof Error ? error.message : String(error),
|
|
1407
|
-
});
|
|
1408
|
-
}
|
|
1409
|
-
|
|
1410
|
-
return preview;
|
|
1411
|
-
};
|
|
1412
1396
|
// Only top-level sessions own an AsyncJobManager. Subagents reach the
|
|
1413
1397
|
// parent's manager via `AsyncJobManager.instance()` (set below), so creating
|
|
1414
1398
|
// a second instance here just to leave it orphaned wastes a constructor and
|
|
@@ -1419,7 +1403,7 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
|
|
|
1419
1403
|
maxRunningJobs: asyncMaxJobs,
|
|
1420
1404
|
onJobComplete: async (jobId, result, job) => {
|
|
1421
1405
|
if (!session || asyncJobManager!.isDeliverySuppressed(jobId)) return;
|
|
1422
|
-
const formattedResult = await formatAsyncResultForFollowUp(result);
|
|
1406
|
+
const formattedResult = await formatAsyncResultForFollowUp(sessionManager, result);
|
|
1423
1407
|
if (asyncJobManager!.isDeliverySuppressed(jobId)) return;
|
|
1424
1408
|
|
|
1425
1409
|
const durationMs = job ? jobElapsedMs(job) : undefined;
|
|
@@ -1500,6 +1484,7 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
|
|
|
1500
1484
|
getWorkflowGateEmitter: () => session?.getWorkflowGateEmitter(),
|
|
1501
1485
|
getAskAnswerSource: () => session?.getAskAnswerSource(),
|
|
1502
1486
|
getGoalRuntime: () => session?.goalRuntime,
|
|
1487
|
+
getSdkPermissionMode: () => session?.sdkPermissionMode ?? "allow",
|
|
1503
1488
|
getClientBridge: () => session?.clientBridge,
|
|
1504
1489
|
getCompactContext: () => session.formatCompactContext(),
|
|
1505
1490
|
getTodoPhases: () => session.getTodoPhases(),
|
|
@@ -1761,7 +1746,7 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
|
|
|
1761
1746
|
// register in-process tools/providers without enabling filesystem discovery.
|
|
1762
1747
|
const inlineExtensions: ExtensionFactory[] = [...(options.extensions ?? [])];
|
|
1763
1748
|
if (customTools.length > 0) {
|
|
1764
|
-
inlineExtensions.push(createCustomToolsExtension(customTools));
|
|
1749
|
+
inlineExtensions.push(createCustomToolsExtension(omitPluginMcpNameShadows(customTools)));
|
|
1765
1750
|
}
|
|
1766
1751
|
|
|
1767
1752
|
// Always-on constrained plugin hooks (validated registry surfaces). Additive
|
|
@@ -2192,6 +2177,7 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
|
|
|
2192
2177
|
repeatToolDescriptions,
|
|
2193
2178
|
intentField,
|
|
2194
2179
|
toolDiscoveryActive: effectiveDiscoveryMode === "all" || mcpDiscoveryEnabled,
|
|
2180
|
+
reverseEngineerAvailable: toolRegistry.has("reverse_engineer"),
|
|
2195
2181
|
eagerTasks,
|
|
2196
2182
|
secretsEnabled,
|
|
2197
2183
|
reasoningLanguage,
|
|
@@ -2271,6 +2257,13 @@ export async function createAgentSession(options: CreateAgentSessionOptions = {}
|
|
|
2271
2257
|
}
|
|
2272
2258
|
}
|
|
2273
2259
|
}
|
|
2260
|
+
// Mandatory names follow the plugin tools that survived registration.
|
|
2261
|
+
// A colliding user tool keeps the normalized name and must stay selectable.
|
|
2262
|
+
pluginMcpToolNames.splice(
|
|
2263
|
+
0,
|
|
2264
|
+
pluginMcpToolNames.length,
|
|
2265
|
+
...retainPluginMcpMandatoryNames(customTools, pluginMcpToolNames),
|
|
2266
|
+
);
|
|
2274
2267
|
const mandatoryMCPToolNameSet = new Set(pluginMcpToolNames);
|
|
2275
2268
|
const selectableExplicitMCPToolNames = explicitlyRequestedMCPToolNames.filter(
|
|
2276
2269
|
name => !mandatoryMCPToolNameSet.has(name),
|
|
@@ -21,17 +21,95 @@ export interface SecretEntry {
|
|
|
21
21
|
|
|
22
22
|
const REPLACEMENT_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
|
|
23
23
|
|
|
24
|
-
/**
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
24
|
+
/**
|
|
25
|
+
* Domain separator for replace-mode replacement derivation. Distinct from
|
|
26
|
+
* `PLACEHOLDER_DOMAIN` so a value minted under one construction can never be
|
|
27
|
+
* confused with a value minted under the other, even with the same key.
|
|
28
|
+
*/
|
|
29
|
+
const REPLACEMENT_DOMAIN = "skc.secret-obfuscation.replacement.v1\0";
|
|
30
|
+
|
|
31
|
+
/** One HMAC-SHA256 digest block length in bytes. */
|
|
32
|
+
const REPLACEMENT_DIGEST_BYTES = 32;
|
|
33
|
+
|
|
34
|
+
/** Largest accepted byte for uniform rejection sampling (256 - (256 % 62)). */
|
|
35
|
+
const REPLACEMENT_REJECT_THRESHOLD = 248;
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* Generate a deterministic, keyed, same-length replacement string from a
|
|
39
|
+
* secret value.
|
|
40
|
+
*
|
|
41
|
+
* COMPATIBILITY CONTRACT (required behavior, must never regress):
|
|
42
|
+
* - Deterministic within a process: the same secret under the same key always
|
|
43
|
+
* yields the same replacement, independent of entry order or call order.
|
|
44
|
+
* - Same length: `result.length === secret.length` (UTF-16 code units, i.e.
|
|
45
|
+
* `String.prototype.length` semantics — unchanged from the pre-fix
|
|
46
|
+
* implementation). Astral-plane characters count as two units, exactly as
|
|
47
|
+
* they did before.
|
|
48
|
+
* - Allowed characters: output is restricted to `[A-Za-z0-9]` (62 chars).
|
|
49
|
+
* - Explicit `replacement` values in secrets.yml are authoritative and are
|
|
50
|
+
* never derived; this path runs only when `replacement` is undefined.
|
|
51
|
+
* - Replace mode stays one-way: the derived value is never reversed by
|
|
52
|
+
* `deobfuscate()`.
|
|
53
|
+
*
|
|
54
|
+
* THREAT MODEL (issue #4166):
|
|
55
|
+
* - Attacker model: an observer sees one or more replacements (model context,
|
|
56
|
+
* provider-side logs, saved/shared transcripts) and has full knowledge of
|
|
57
|
+
* the public algorithm. Without the 32-byte obfuscation key they cannot
|
|
58
|
+
* confirm a candidate secret offline and cannot predict or precompute the
|
|
59
|
+
* replacement for any secret. The construction is a keyed PRF
|
|
60
|
+
* (HMAC-SHA256), so output is unpredictable without the key, and keyed
|
|
61
|
+
* domain separation keeps this construction distinct from the placeholder
|
|
62
|
+
* construction.
|
|
63
|
+
* - Accepted residual disclosure: the replacement is same-length by design
|
|
64
|
+
* (required behavior above), so the secret's exact length is still
|
|
65
|
+
* observable. This is inherent to size-preserving substitution and is
|
|
66
|
+
* explicitly out of scope; the fix removes the *keyless confirmation*
|
|
67
|
+
* oracle, not the length signal.
|
|
68
|
+
* - Cross-process stability / key rotation: the process key is generated per
|
|
69
|
+
* process (`PROCESS_SECRET_OBFUSCATION_KEY`), so derived replacements are
|
|
70
|
+
* stable within a process and differ across processes or after a key
|
|
71
|
+
* rotation. This is a deliberate decision, identical in scope to the
|
|
72
|
+
* obfuscate-mode placeholder behavior. Users who need stable values across
|
|
73
|
+
* processes or restarts must set an explicit `replacement` in secrets.yml.
|
|
74
|
+
* - Collision/bias: output is a keyed pseudorandom mapping. Two distinct
|
|
75
|
+
* secrets can in principle collide (birthday bound over the 62^len output
|
|
76
|
+
* space); for realistic secret lengths this is negligible. Character
|
|
77
|
+
* distribution is uniform by construction: digest bytes are rejection-
|
|
78
|
+
* sampled (bytes 248-255 rejected, 256 - (256 % 62) = 248 = 62 * 4), so
|
|
79
|
+
* every character is exactly equally likely, with no modulo bias.
|
|
80
|
+
* - Empty secrets: a zero-length secret yields an empty replacement and the
|
|
81
|
+
* obfuscator treats it as a no-op (load-time validation rejects empty
|
|
82
|
+
* content anyway). Unicode secrets are hashed as UTF-8 bytes, so encoding
|
|
83
|
+
* is canonical. Very long secrets expand via a counter-based HMAC stream
|
|
84
|
+
* in O(length) blocks; generation cost is linear in the secret length.
|
|
85
|
+
* - Overlapping secrets and streaming: derivation is per-secret and does not
|
|
86
|
+
* depend on matching semantics (longest-first overlap handling is
|
|
87
|
+
* unchanged), and `obfuscate()` runs per complete text payload, so chunked
|
|
88
|
+
* output (e.g. streamed LLM messages) sees the same deterministic
|
|
89
|
+
* replacement for the same secret within a process.
|
|
90
|
+
*/
|
|
91
|
+
function generateDeterministicReplacement(secret: string, key: Uint8Array): string {
|
|
92
|
+
const length = secret.length;
|
|
93
|
+
if (length === 0) return "";
|
|
28
94
|
const chars: string[] = [];
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
95
|
+
// CTR-style expansion: HMAC(key, DOMAIN || counter || secret) per 32-byte
|
|
96
|
+
// block. The counter is big-endian and fixed-width, so the stream is
|
|
97
|
+
// unambiguous and never repeats.
|
|
98
|
+
const counter = new Uint8Array(8);
|
|
99
|
+
const counterView = new DataView(counter.buffer);
|
|
100
|
+
let block: Uint8Array | undefined;
|
|
101
|
+
let blockOffset = REPLACEMENT_DIGEST_BYTES;
|
|
102
|
+
let blockIndex = 0;
|
|
103
|
+
while (chars.length < length) {
|
|
104
|
+
if (block === undefined || blockOffset >= REPLACEMENT_DIGEST_BYTES) {
|
|
105
|
+
counterView.setUint32(4, blockIndex, false);
|
|
106
|
+
block = createHmac("sha256", key).update(REPLACEMENT_DOMAIN).update(counter).update(secret, "utf8").digest();
|
|
107
|
+
blockOffset = 0;
|
|
108
|
+
blockIndex++;
|
|
109
|
+
}
|
|
110
|
+
const byte = block[blockOffset++]!;
|
|
111
|
+
if (byte >= REPLACEMENT_REJECT_THRESHOLD) continue;
|
|
112
|
+
chars.push(REPLACEMENT_CHARS[byte % REPLACEMENT_CHARS.length]!);
|
|
35
113
|
}
|
|
36
114
|
return chars.join("");
|
|
37
115
|
}
|
|
@@ -115,7 +193,8 @@ export class SecretObfuscator {
|
|
|
115
193
|
index++;
|
|
116
194
|
} else {
|
|
117
195
|
// replace mode
|
|
118
|
-
const replacement =
|
|
196
|
+
const replacement =
|
|
197
|
+
entry.replacement ?? generateDeterministicReplacement(entry.content, this.#placeholderKey);
|
|
119
198
|
this.#replaceMappings.set(entry.content, replacement);
|
|
120
199
|
}
|
|
121
200
|
} else {
|
|
@@ -168,7 +247,8 @@ export class SecretObfuscator {
|
|
|
168
247
|
|
|
169
248
|
for (const matchValue of matches) {
|
|
170
249
|
if (entry.mode === "replace") {
|
|
171
|
-
const replacement =
|
|
250
|
+
const replacement =
|
|
251
|
+
entry.replacement ?? generateDeterministicReplacement(matchValue, this.#placeholderKey);
|
|
172
252
|
result = replaceAll(result, matchValue, replacement);
|
|
173
253
|
} else {
|
|
174
254
|
// obfuscate mode — get or create stable index
|