@sayknow-cli/coding-agent 0.7.11 → 0.7.13
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 +16 -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 +22 -2
- package/dist/types/session/auto-resume.d.ts +5 -0
- 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 +466 -100
- package/src/session/artifacts.ts +3 -1
- package/src/session/auto-resume.ts +45 -8
- 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 +116 -8
- 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
|
@@ -293,11 +293,131 @@ export function sessionPaths(root: string, sessionId: string): SessionPaths {
|
|
|
293
293
|
};
|
|
294
294
|
}
|
|
295
295
|
|
|
296
|
+
const NO_FOLLOW = process.platform === "win32" ? 0 : (fsSync.constants.O_NOFOLLOW ?? 0);
|
|
297
|
+
|
|
298
|
+
function errnoCode(error: unknown): string | undefined {
|
|
299
|
+
return error instanceof Error && "code" in error ? (error as NodeJS.ErrnoException).code : undefined;
|
|
300
|
+
}
|
|
301
|
+
|
|
302
|
+
function sameInode(left: fsSync.BigIntStats, right: fsSync.BigIntStats): boolean {
|
|
303
|
+
return left.dev === right.dev && left.ino === right.ino && left.nlink === right.nlink;
|
|
304
|
+
}
|
|
305
|
+
|
|
306
|
+
/**
|
|
307
|
+
* Leaf directory mode 0700. `lstat` plus `chmod` does not need read permission, so a
|
|
308
|
+
* mode 0300 directory stays writable. A symlink leaf is refused before chmod.
|
|
309
|
+
* This does not pin the directory against a later rename in a writable parent.
|
|
310
|
+
*/
|
|
311
|
+
async function ensureOwnerDirectory(dir: string): Promise<void> {
|
|
312
|
+
await fs.mkdir(dir, { recursive: true, mode: 0o700 });
|
|
313
|
+
let current: fsSync.Stats;
|
|
314
|
+
try {
|
|
315
|
+
current = await fs.lstat(dir);
|
|
316
|
+
} catch (error) {
|
|
317
|
+
const code = errnoCode(error);
|
|
318
|
+
if (code === "ELOOP" || code === "ENOTDIR") throw new Error("harness state directory is not a directory");
|
|
319
|
+
throw error;
|
|
320
|
+
}
|
|
321
|
+
if (current.isSymbolicLink() || !current.isDirectory())
|
|
322
|
+
throw new Error("harness state directory is not a directory");
|
|
323
|
+
if (process.platform === "win32" || (current.mode & 0o077) === 0) return;
|
|
324
|
+
await fs.chmod(dir, 0o700);
|
|
325
|
+
const tightened = await fs.lstat(dir);
|
|
326
|
+
if (tightened.isSymbolicLink() || !tightened.isDirectory() || (tightened.mode & 0o777) !== 0o700) {
|
|
327
|
+
throw new Error("harness state directory could not be tightened to mode 0700");
|
|
328
|
+
}
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
async function assertRegularOrMissing(file: string): Promise<void> {
|
|
332
|
+
try {
|
|
333
|
+
const existing = await fs.lstat(file);
|
|
334
|
+
if (existing.isSymbolicLink() || !existing.isFile()) throw new Error("harness state path is not a regular file");
|
|
335
|
+
} catch (error) {
|
|
336
|
+
if (errnoCode(error) !== "ENOENT") throw error;
|
|
337
|
+
}
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
/**
|
|
341
|
+
* Append like the workflow owner-only writer: mode 0600, `O_NOFOLLOW` when the file
|
|
342
|
+
* exists, `O_EXCL` when it does not, and chmod to 0600 when group or other bits are set.
|
|
343
|
+
*/
|
|
344
|
+
async function appendOwnerOnly(filePath: string, text: string): Promise<void> {
|
|
345
|
+
await ensureOwnerDirectory(path.dirname(filePath));
|
|
346
|
+
let handle: fs.FileHandle | undefined;
|
|
347
|
+
let initial: fsSync.BigIntStats | undefined;
|
|
348
|
+
for (let attempt = 0; attempt < 2; attempt++) {
|
|
349
|
+
initial = undefined;
|
|
350
|
+
try {
|
|
351
|
+
initial = await fs.lstat(filePath, { bigint: true });
|
|
352
|
+
if (initial.isSymbolicLink() || !initial.isFile()) throw new Error("harness state path is not a regular file");
|
|
353
|
+
} catch (error) {
|
|
354
|
+
if (errnoCode(error) !== "ENOENT") throw error;
|
|
355
|
+
}
|
|
356
|
+
const flags = initial
|
|
357
|
+
? fsSync.constants.O_WRONLY | fsSync.constants.O_APPEND | NO_FOLLOW
|
|
358
|
+
: fsSync.constants.O_WRONLY | fsSync.constants.O_APPEND | fsSync.constants.O_CREAT | fsSync.constants.O_EXCL;
|
|
359
|
+
try {
|
|
360
|
+
handle = await fs.open(filePath, flags, 0o600);
|
|
361
|
+
break;
|
|
362
|
+
} catch (error) {
|
|
363
|
+
const code = errnoCode(error);
|
|
364
|
+
if (code === "ELOOP") throw new Error("harness state path is not a regular file");
|
|
365
|
+
if (initial === undefined && code === "EEXIST" && attempt === 0) continue;
|
|
366
|
+
throw error;
|
|
367
|
+
}
|
|
368
|
+
}
|
|
369
|
+
if (!handle) throw new Error("harness state path identity changed before append");
|
|
370
|
+
try {
|
|
371
|
+
const opened = await handle.stat({ bigint: true });
|
|
372
|
+
const named = await fs.lstat(filePath, { bigint: true });
|
|
373
|
+
if (
|
|
374
|
+
opened.isSymbolicLink() ||
|
|
375
|
+
!opened.isFile() ||
|
|
376
|
+
named.isSymbolicLink() ||
|
|
377
|
+
!named.isFile() ||
|
|
378
|
+
(initial !== undefined && !sameInode(initial, opened)) ||
|
|
379
|
+
!sameInode(opened, named)
|
|
380
|
+
) {
|
|
381
|
+
throw new Error("harness state path identity changed before append");
|
|
382
|
+
}
|
|
383
|
+
if (process.platform !== "win32" && (Number(opened.mode) & 0o077) !== 0) {
|
|
384
|
+
await handle.chmod(0o600);
|
|
385
|
+
const tightened = await handle.stat({ bigint: true });
|
|
386
|
+
if ((Number(tightened.mode) & 0o777) !== 0o600) {
|
|
387
|
+
throw new Error("harness state path could not be tightened to mode 0600");
|
|
388
|
+
}
|
|
389
|
+
}
|
|
390
|
+
await handle.writeFile(text, "utf8");
|
|
391
|
+
} finally {
|
|
392
|
+
await handle.close();
|
|
393
|
+
}
|
|
394
|
+
}
|
|
395
|
+
|
|
296
396
|
async function writeJsonAtomic(file: string, value: unknown): Promise<void> {
|
|
297
|
-
await
|
|
397
|
+
await ensureOwnerDirectory(path.dirname(file));
|
|
398
|
+
await assertRegularOrMissing(file);
|
|
298
399
|
const tmp = `${file}.tmp-${randomBytes(4).toString("hex")}`;
|
|
299
|
-
|
|
300
|
-
await fs.
|
|
400
|
+
const flags = fsSync.constants.O_WRONLY | fsSync.constants.O_CREAT | fsSync.constants.O_EXCL | NO_FOLLOW;
|
|
401
|
+
const handle = await fs.open(tmp, flags, 0o600);
|
|
402
|
+
try {
|
|
403
|
+
if (process.platform !== "win32") {
|
|
404
|
+
await handle.chmod(0o600);
|
|
405
|
+
const created = await handle.stat();
|
|
406
|
+
if (!created.isFile() || (created.mode & 0o777) !== 0o600) {
|
|
407
|
+
throw new Error("harness state path could not be tightened to mode 0600");
|
|
408
|
+
}
|
|
409
|
+
}
|
|
410
|
+
await handle.writeFile(`${JSON.stringify(value, null, 2)}\n`, "utf8");
|
|
411
|
+
} finally {
|
|
412
|
+
await handle.close();
|
|
413
|
+
}
|
|
414
|
+
try {
|
|
415
|
+
await assertRegularOrMissing(file);
|
|
416
|
+
await fs.rename(tmp, file);
|
|
417
|
+
} catch (error) {
|
|
418
|
+
await fs.rm(tmp, { force: true }).catch(() => undefined);
|
|
419
|
+
throw error;
|
|
420
|
+
}
|
|
301
421
|
}
|
|
302
422
|
|
|
303
423
|
async function readJson<T>(file: string): Promise<T | null> {
|
|
@@ -396,7 +516,6 @@ export async function resolveHarnessSessionRoot(
|
|
|
396
516
|
|
|
397
517
|
export async function writeSessionState(root: string, state: SessionState): Promise<void> {
|
|
398
518
|
const paths = sessionPaths(root, state.sessionId);
|
|
399
|
-
await fs.mkdir(paths.dir, { recursive: true });
|
|
400
519
|
await writeJsonAtomic(paths.state, state);
|
|
401
520
|
}
|
|
402
521
|
|
|
@@ -407,8 +526,7 @@ export async function sessionExists(root: string, sessionId: string): Promise<bo
|
|
|
407
526
|
/** Append a single severity envelope to events.jsonl. Single-writer discipline is the owner's job (M3). */
|
|
408
527
|
export async function appendEvent(root: string, sessionId: string, envelope: EventEnvelope): Promise<void> {
|
|
409
528
|
const paths = sessionPaths(root, sessionId);
|
|
410
|
-
await
|
|
411
|
-
await fs.appendFile(paths.events, `${JSON.stringify(envelope)}\n`, "utf8");
|
|
529
|
+
await appendOwnerOnly(paths.events, `${JSON.stringify(envelope)}\n`);
|
|
412
530
|
}
|
|
413
531
|
|
|
414
532
|
/** Read events from cursor (exclusive). Tail-only: never mutates the log. */
|
package/src/hashline/execute.ts
CHANGED
|
@@ -111,7 +111,7 @@ async function preflightHashlineSection(options: ExecuteHashlineSingleOptions &
|
|
|
111
111
|
|
|
112
112
|
const source = await readHashlineFile(absolutePath, sectionPath);
|
|
113
113
|
if (!source.exists && hasAnchorScopedEdit(edits)) throw new Error(`File not found: ${sectionPath}`);
|
|
114
|
-
if (source.exists) assertEditableFileContent(source.rawContent, sectionPath);
|
|
114
|
+
if (source.exists) assertEditableFileContent(source.rawContent, sectionPath, session.settings);
|
|
115
115
|
|
|
116
116
|
const { text } = stripBom(source.rawContent);
|
|
117
117
|
const normalized = normalizeToLF(text);
|
|
@@ -144,7 +144,7 @@ async function executeHashlineSection(
|
|
|
144
144
|
|
|
145
145
|
const source = await readHashlineFile(absolutePath, sourcePath);
|
|
146
146
|
if (!source.exists && hasAnchorScopedEdit(edits)) throw new Error(`File not found: ${sourcePath}`);
|
|
147
|
-
if (source.exists) assertEditableFileContent(source.rawContent, sourcePath);
|
|
147
|
+
if (source.exists) assertEditableFileContent(source.rawContent, sourcePath, session.settings);
|
|
148
148
|
|
|
149
149
|
const { bom, text } = stripBom(source.rawContent);
|
|
150
150
|
const originalEnding = detectLineEnding(text);
|
|
@@ -182,7 +182,7 @@ async function executeHashlineSection(
|
|
|
182
182
|
// of the file: the model just received it back as the diff/preview. Cache
|
|
183
183
|
// it so a follow-up edit anchored against this state can still recover
|
|
184
184
|
// if the file is touched out-of-band before the next edit lands.
|
|
185
|
-
getFileReadCache(session).
|
|
185
|
+
getFileReadCache(session).recordFull(absolutePath, result.lines.split("\n"));
|
|
186
186
|
|
|
187
187
|
const diffResult = generateDiffString(originalNormalized, result.lines);
|
|
188
188
|
const meta = outputMeta()
|
package/src/hashline/recovery.ts
CHANGED
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
import * as Diff from "diff";
|
|
2
2
|
import { generateDiffString } from "../edit/diff";
|
|
3
|
-
import type { FileReadCache } from "../edit/file-read-cache";
|
|
3
|
+
import type { FileReadCache, FileReadSnapshot } from "../edit/file-read-cache";
|
|
4
4
|
import { HashlineMismatchError } from "./anchors";
|
|
5
5
|
import { applyHashlineEdits, type HashlineApplyResult } from "./apply";
|
|
6
|
+
import { RANGE_INTERIOR_HASH } from "./constants";
|
|
6
7
|
import { computeLineHash } from "./hash";
|
|
7
8
|
import type { Anchor, HashlineApplyOptions, HashlineEdit } from "./types";
|
|
8
9
|
|
|
@@ -28,6 +29,69 @@ const HASHLINE_RECOVERY_FUZZ_FACTOR = 0;
|
|
|
28
29
|
const HASHLINE_RECOVERY_WARNING =
|
|
29
30
|
"Recovered from stale anchors using a previous read snapshot (file changed externally between read and edit).";
|
|
30
31
|
|
|
32
|
+
/**
|
|
33
|
+
* Line numbers outside a partial snapshot were filled from the live file when
|
|
34
|
+
* building the replay base, so they say nothing about the version the anchors
|
|
35
|
+
* were authored against. Drop such lines from a hunk's leading and trailing
|
|
36
|
+
* context; refuse the hunk if any remaining old-side line is not covered.
|
|
37
|
+
*/
|
|
38
|
+
function trimHunkToSnapshot(
|
|
39
|
+
hunk: Diff.StructuredPatchHunk,
|
|
40
|
+
snapshot: FileReadSnapshot,
|
|
41
|
+
): Diff.StructuredPatchHunk | null {
|
|
42
|
+
const oldLineNumbers: Array<number | undefined> = [];
|
|
43
|
+
let oldLine = hunk.oldStart;
|
|
44
|
+
for (const line of hunk.lines) {
|
|
45
|
+
if (line[0] === " " || line[0] === "-") oldLineNumbers.push(oldLine++);
|
|
46
|
+
else oldLineNumbers.push(undefined);
|
|
47
|
+
}
|
|
48
|
+
const covered = (index: number): boolean => {
|
|
49
|
+
const lineNum = oldLineNumbers[index];
|
|
50
|
+
return lineNum !== undefined && snapshot.lines.has(lineNum);
|
|
51
|
+
};
|
|
52
|
+
|
|
53
|
+
let start = 0;
|
|
54
|
+
while (start < hunk.lines.length && hunk.lines[start][0] === " " && !covered(start)) start++;
|
|
55
|
+
let end = hunk.lines.length;
|
|
56
|
+
while (end > start && hunk.lines[end - 1][0] === " " && !covered(end - 1)) end--;
|
|
57
|
+
const lines = hunk.lines.slice(start, end);
|
|
58
|
+
for (let index = start; index < end; index++) {
|
|
59
|
+
if (oldLineNumbers[index] !== undefined && !covered(index)) return null;
|
|
60
|
+
}
|
|
61
|
+
return {
|
|
62
|
+
oldStart: hunk.oldStart + start,
|
|
63
|
+
oldLines: lines.filter(line => line[0] === " " || line[0] === "-").length,
|
|
64
|
+
newStart: hunk.newStart + start,
|
|
65
|
+
newLines: lines.filter(line => line[0] === " " || line[0] === "+").length,
|
|
66
|
+
lines,
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* `Diff.applyPatch` searches the whole file for a spot where a hunk's context
|
|
72
|
+
* matches, so a hunk whose old side (context + deleted lines) occurs more than
|
|
73
|
+
* once could land on the wrong copy. Refuse such replays.
|
|
74
|
+
*/
|
|
75
|
+
function everyHunkLandsUniquely(hunks: Diff.StructuredPatchHunk[], lines: string[]): boolean {
|
|
76
|
+
for (const hunk of hunks) {
|
|
77
|
+
const oldSide = hunk.lines.filter(line => line[0] === " " || line[0] === "-").map(line => line.slice(1));
|
|
78
|
+
if (oldSide.length === 0) return false;
|
|
79
|
+
let occurrences = 0;
|
|
80
|
+
for (let start = 0; start + oldSide.length <= lines.length; start++) {
|
|
81
|
+
let matches = true;
|
|
82
|
+
for (let offset = 0; offset < oldSide.length; offset++) {
|
|
83
|
+
if (lines[start + offset] !== oldSide[offset]) {
|
|
84
|
+
matches = false;
|
|
85
|
+
break;
|
|
86
|
+
}
|
|
87
|
+
}
|
|
88
|
+
if (matches && ++occurrences > 1) return false;
|
|
89
|
+
}
|
|
90
|
+
if (occurrences !== 1) return false;
|
|
91
|
+
}
|
|
92
|
+
return true;
|
|
93
|
+
}
|
|
94
|
+
|
|
31
95
|
/** Collect every line anchor an edit batch depends on. */
|
|
32
96
|
function collectEditAnchors(edits: HashlineEdit[]): Anchor[] {
|
|
33
97
|
const anchors: Anchor[] = [];
|
|
@@ -64,11 +128,14 @@ export function tryRecoverHashlineWithCache(args: HashlineRecoveryArgs): Hashlin
|
|
|
64
128
|
// Precondition: the model's anchors must be vouched-for by the cache. If
|
|
65
129
|
// even one anchored line is missing from the snapshot, or its cached
|
|
66
130
|
// content hashes to a different value than the model supplied, refuse —
|
|
67
|
-
// any merge from here is a guess.
|
|
131
|
+
// any merge from here is a guess. Range interiors carry no model-supplied
|
|
132
|
+
// hash (the endpoints vouch for the range), so they only need to be present;
|
|
133
|
+
// the replayed hunk still has to match those snapshot lines exactly.
|
|
68
134
|
const anchors = collectEditAnchors(edits);
|
|
69
135
|
for (const anchor of anchors) {
|
|
70
136
|
const cachedLine = snapshot.lines.get(anchor.line);
|
|
71
137
|
if (cachedLine === undefined) return null;
|
|
138
|
+
if (anchor.hash === RANGE_INTERIOR_HASH) continue;
|
|
72
139
|
if (computeLineHash(anchor.line, cachedLine) !== anchor.hash) return null;
|
|
73
140
|
}
|
|
74
141
|
|
|
@@ -81,6 +148,9 @@ export function tryRecoverHashlineWithCache(args: HashlineRecoveryArgs): Hashlin
|
|
|
81
148
|
for (const [lineNum, content] of snapshot.lines) {
|
|
82
149
|
overlaid[lineNum - 1] = content;
|
|
83
150
|
}
|
|
151
|
+
// A full-file snapshot is authoritative about length too: live lines past
|
|
152
|
+
// its end did not exist in the version the anchors were authored against.
|
|
153
|
+
if (snapshot.lineCount !== undefined) overlaid.length = snapshot.lineCount;
|
|
84
154
|
const previousText = overlaid.join("\n");
|
|
85
155
|
if (previousText === currentText) return null;
|
|
86
156
|
|
|
@@ -94,6 +164,19 @@ export function tryRecoverHashlineWithCache(args: HashlineRecoveryArgs): Hashlin
|
|
|
94
164
|
if (applied.lines === previousText) return null;
|
|
95
165
|
|
|
96
166
|
const patch = Diff.structuredPatch("file", "file", previousText, applied.lines, "", "", { context: 3 });
|
|
167
|
+
const hunks: Diff.StructuredPatchHunk[] = [];
|
|
168
|
+
for (const hunk of patch.hunks) {
|
|
169
|
+
const trimmed = trimHunkToSnapshot(hunk, snapshot);
|
|
170
|
+
if (!trimmed) return null;
|
|
171
|
+
hunks.push(trimmed);
|
|
172
|
+
}
|
|
173
|
+
patch.hunks = hunks;
|
|
174
|
+
// Content is the only location evidence a replayed hunk carries, so it must
|
|
175
|
+
// identify one site in the authored version and in the live file. A single
|
|
176
|
+
// live match may otherwise be an unrelated identical copy left standing after
|
|
177
|
+
// the anchored copy changed out-of-band.
|
|
178
|
+
if (!everyHunkLandsUniquely(hunks, previousText.split("\n"))) return null;
|
|
179
|
+
if (!everyHunkLandsUniquely(hunks, currentText.split("\n"))) return null;
|
|
97
180
|
const merged = Diff.applyPatch(currentText, patch, { fuzzFactor: HASHLINE_RECOVERY_FUZZ_FACTOR });
|
|
98
181
|
if (typeof merged !== "string" || merged === currentText) return null;
|
|
99
182
|
|
package/src/hindsight/config.ts
CHANGED
|
@@ -62,11 +62,17 @@ function envBool(value: string | undefined): boolean | undefined {
|
|
|
62
62
|
return ["true", "1", "yes"].includes(value.toLowerCase());
|
|
63
63
|
}
|
|
64
64
|
|
|
65
|
-
/**
|
|
65
|
+
/**
|
|
66
|
+
* Coerce an env var value into a non-negative int, returning undefined (so the
|
|
67
|
+
* settings value applies) for anything that is not plain digits. `parseInt`
|
|
68
|
+
* alone would read "5turns" as 5, "1e3" as 1 and "-3" as -3.
|
|
69
|
+
*/
|
|
66
70
|
function envInt(value: string | undefined): number | undefined {
|
|
67
71
|
if (value === undefined) return undefined;
|
|
68
|
-
const
|
|
69
|
-
|
|
72
|
+
const trimmed = value.trim();
|
|
73
|
+
if (!/^\d+$/.test(trimmed)) return undefined;
|
|
74
|
+
const n = Number(trimmed);
|
|
75
|
+
return Number.isSafeInteger(n) ? n : undefined;
|
|
70
76
|
}
|
|
71
77
|
|
|
72
78
|
function envString(value: string | undefined): string | undefined {
|
package/src/hindsight/content.ts
CHANGED
|
@@ -20,27 +20,126 @@ export interface RecallResultLike {
|
|
|
20
20
|
mentioned_at?: string | null;
|
|
21
21
|
}
|
|
22
22
|
|
|
23
|
-
const
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
23
|
+
const MEMORY_TAG_NAMES = ["memories", "hindsight_memories", "relevant_memories", "mental_models"] as const;
|
|
24
|
+
|
|
25
|
+
function memoryTagExpression(name: string): RegExp {
|
|
26
|
+
return new RegExp(`<\\s*\\/?\\s*${name}\\s*>`, "gi");
|
|
27
|
+
}
|
|
28
|
+
|
|
29
|
+
interface MemoryTagSpan {
|
|
30
|
+
start: number;
|
|
31
|
+
end: number;
|
|
32
|
+
close: boolean;
|
|
33
|
+
paired: boolean;
|
|
34
|
+
absorbed: boolean;
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
function findMemoryTagSpans(content: string, name: string): MemoryTagSpan[] {
|
|
38
|
+
const spans: MemoryTagSpan[] = [];
|
|
39
|
+
for (const match of content.matchAll(memoryTagExpression(name))) {
|
|
40
|
+
const raw = match[0];
|
|
41
|
+
const start = match.index ?? 0;
|
|
42
|
+
spans.push({
|
|
43
|
+
start,
|
|
44
|
+
end: start + raw.length,
|
|
45
|
+
close: raw.includes("/"),
|
|
46
|
+
paired: false,
|
|
47
|
+
absorbed: false,
|
|
48
|
+
});
|
|
49
|
+
}
|
|
50
|
+
return spans;
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
function mergeSpans(ranges: Array<[number, number]>): Array<[number, number]> {
|
|
54
|
+
const sorted = ranges.filter(([start, end]) => end > start).sort((a, b) => a[0] - b[0] || b[1] - a[1]);
|
|
55
|
+
const merged: Array<[number, number]> = [];
|
|
56
|
+
for (const [start, end] of sorted) {
|
|
57
|
+
const last = merged[merged.length - 1];
|
|
58
|
+
if (!last || start > last[1]) merged.push([start, end]);
|
|
59
|
+
else last[1] = Math.max(last[1], end);
|
|
60
|
+
}
|
|
61
|
+
return merged;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/**
|
|
65
|
+
* Remove one memory-tag family.
|
|
66
|
+
*
|
|
67
|
+
* A matched block is removed whole. An extra closer after that block is the
|
|
68
|
+
* recall frame ending early: the escaped text through that closer is removed
|
|
69
|
+
* so it is not retained as instructions. A closer or opener with no block
|
|
70
|
+
* before it is removed as a token only, and the surrounding prose stays.
|
|
71
|
+
*/
|
|
72
|
+
function stripMemoryTagFamily(content: string, name: string): string {
|
|
73
|
+
const tags = findMemoryTagSpans(content, name);
|
|
74
|
+
if (tags.length === 0) return content;
|
|
75
|
+
|
|
76
|
+
const ranges: Array<[number, number]> = [];
|
|
77
|
+
const stack: MemoryTagSpan[] = [];
|
|
78
|
+
for (const tag of tags) {
|
|
79
|
+
if (!tag.close) {
|
|
80
|
+
stack.push(tag);
|
|
81
|
+
continue;
|
|
82
|
+
}
|
|
83
|
+
const open = stack.pop();
|
|
84
|
+
if (!open) continue;
|
|
85
|
+
open.paired = true;
|
|
86
|
+
tag.paired = true;
|
|
87
|
+
ranges.push([open.start, tag.end]);
|
|
88
|
+
}
|
|
89
|
+
|
|
90
|
+
for (const tag of tags) {
|
|
91
|
+
if (!tag.close || tag.paired) continue;
|
|
92
|
+
let previous: MemoryTagSpan | undefined;
|
|
93
|
+
for (const candidate of tags) {
|
|
94
|
+
if (candidate.end <= tag.start) previous = candidate;
|
|
95
|
+
else break;
|
|
96
|
+
}
|
|
97
|
+
const followsClosedBlock = Boolean(previous?.close && (previous.paired || previous.absorbed));
|
|
98
|
+
if (followsClosedBlock && previous) {
|
|
99
|
+
ranges.push([previous.end, tag.end]);
|
|
100
|
+
tag.absorbed = true;
|
|
101
|
+
} else {
|
|
102
|
+
ranges.push([tag.start, tag.end]);
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
for (const tag of tags) {
|
|
107
|
+
if (!tag.close && !tag.paired) ranges.push([tag.start, tag.end]);
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
let out = content;
|
|
111
|
+
for (const [start, end] of mergeSpans(ranges).reverse()) {
|
|
112
|
+
out = out.slice(0, start) + out.slice(end);
|
|
113
|
+
}
|
|
114
|
+
return out;
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
/** Escape recognized tag delimiters so recalled text cannot close the outer frame. */
|
|
118
|
+
function stripMemoryTagTokens(text: string): string {
|
|
119
|
+
let out = text;
|
|
120
|
+
for (const name of MEMORY_TAG_NAMES) {
|
|
121
|
+
out = out.replace(memoryTagExpression(name), tag => tag.replace("<", "<"));
|
|
122
|
+
}
|
|
123
|
+
return out;
|
|
124
|
+
}
|
|
27
125
|
|
|
28
126
|
/**
|
|
29
127
|
* Strip `<memories>`, `<mental_models>`, and legacy memory blocks.
|
|
30
128
|
*
|
|
31
|
-
*
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
* retaining.
|
|
129
|
+
* Matching is case-insensitive and allows whitespace inside the tag.
|
|
130
|
+
* Both per-turn recall and curated mental models are injected around the
|
|
131
|
+
* prompt. If a closer, a case variant, or an early-ended frame leaks into
|
|
132
|
+
* the retention transcript, the next retain stores the breakout as a new
|
|
133
|
+
* memory. Always strip before retaining.
|
|
37
134
|
*/
|
|
38
135
|
export function stripMemoryTags(content: string): string {
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
136
|
+
let out = content;
|
|
137
|
+
while (true) {
|
|
138
|
+
let stripped = out;
|
|
139
|
+
for (const name of MEMORY_TAG_NAMES) stripped = stripMemoryTagFamily(stripped, name);
|
|
140
|
+
if (stripped === out) return out;
|
|
141
|
+
out = stripped;
|
|
142
|
+
}
|
|
44
143
|
}
|
|
45
144
|
|
|
46
145
|
/** Format recall results into a bullet list for context injection. */
|
|
@@ -50,7 +149,8 @@ export function formatMemories(results: RecallResultLike[]): string {
|
|
|
50
149
|
.map(r => {
|
|
51
150
|
const typeStr = r.type ? ` [${r.type}]` : "";
|
|
52
151
|
const dateStr = r.mentioned_at ? ` (${r.mentioned_at})` : "";
|
|
53
|
-
|
|
152
|
+
const text = stripMemoryTagTokens(r.text);
|
|
153
|
+
return `- ${text}${typeStr}${dateStr}`;
|
|
54
154
|
})
|
|
55
155
|
.join("\n\n");
|
|
56
156
|
}
|
|
@@ -219,6 +219,17 @@ const TRUNCATION_MARKER = "\n\n…[mental-model snapshot truncated at render bud
|
|
|
219
219
|
*/
|
|
220
220
|
const MIN_CONTENT_ROOM_CHARS = 64;
|
|
221
221
|
|
|
222
|
+
const MEMORY_FRAME_NAMES = ["memories", "hindsight_memories", "relevant_memories", "mental_models"] as const;
|
|
223
|
+
|
|
224
|
+
/** Escape the same frame tokens as recalled memory text so a stored closer cannot end this block early. */
|
|
225
|
+
function escapeMemoryFrameTokens(text: string): string {
|
|
226
|
+
let out = text;
|
|
227
|
+
for (const name of MEMORY_FRAME_NAMES) {
|
|
228
|
+
out = out.replace(new RegExp(`<\\s*\\/?\\s*${name}\\s*>`, "gi"), tag => tag.replace("<", "<"));
|
|
229
|
+
}
|
|
230
|
+
return out;
|
|
231
|
+
}
|
|
232
|
+
|
|
222
233
|
/** Smallest budget that can yield a usable block (wrapper + preamble + marker + a few chars of content). */
|
|
223
234
|
function minRenderBudgetChars(): number {
|
|
224
235
|
const cleanOverhead = `<mental_models>\n${PREAMBLE}\n\n\n</mental_models>`.length;
|
|
@@ -235,7 +246,6 @@ export function renderMentalModelsBlock(models: MentalModelSummary[], budgetChar
|
|
|
235
246
|
if (budgetChars < minRenderBudgetChars()) return "";
|
|
236
247
|
|
|
237
248
|
const truncatedOverhead = `<mental_models>\n${PREAMBLE}\n\n${TRUNCATION_MARKER}\n</mental_models>`.length;
|
|
238
|
-
const cleanOverhead = `<mental_models>\n${PREAMBLE}\n\n\n</mental_models>`.length;
|
|
239
249
|
const innerBudget = Math.max(0, budgetChars - truncatedOverhead);
|
|
240
250
|
const perModelBudget = Math.max(120, Math.floor(innerBudget / Math.max(1, models.length)));
|
|
241
251
|
|
|
@@ -260,18 +270,20 @@ export function renderMentalModelsBlock(models: MentalModelSummary[], budgetChar
|
|
|
260
270
|
consumed += sectionCost;
|
|
261
271
|
}
|
|
262
272
|
|
|
273
|
+
// Escape after the heading/body join. A closer split across that newline
|
|
274
|
+
// (`</mental_models` + `>`) is not visible in either field alone.
|
|
275
|
+
// The wrapper is added after this step and is not escaped.
|
|
276
|
+
let inner = escapeMemoryFrameTokens(sections.join("\n\n"));
|
|
263
277
|
const tail = truncated ? TRUNCATION_MARKER : "";
|
|
264
|
-
let assembled = `<mental_models>\n${PREAMBLE}\n\n${
|
|
278
|
+
let assembled = `<mental_models>\n${PREAMBLE}\n\n${inner}${tail}\n</mental_models>`;
|
|
265
279
|
|
|
266
|
-
// Final hard-cap:
|
|
267
|
-
//
|
|
268
|
-
//
|
|
269
|
-
// still find the closing tag.
|
|
280
|
+
// Final hard-cap: slice the already escaped body so a cut cannot restore a raw closer.
|
|
281
|
+
// The marker is always appended on this path, so reserve its overhead.
|
|
282
|
+
// Escaped tags are longer than the raw text the per-model budget measured.
|
|
270
283
|
if (assembled.length > budgetChars) {
|
|
271
|
-
const
|
|
272
|
-
|
|
273
|
-
|
|
274
|
-
assembled = `<mental_models>\n${PREAMBLE}\n\n${body}${TRUNCATION_MARKER}\n</mental_models>`;
|
|
284
|
+
const room = Math.max(0, budgetChars - truncatedOverhead);
|
|
285
|
+
inner = inner.slice(0, room).trimEnd();
|
|
286
|
+
assembled = `<mental_models>\n${PREAMBLE}\n\n${inner}${TRUNCATION_MARKER}\n</mental_models>`;
|
|
275
287
|
}
|
|
276
288
|
return assembled;
|
|
277
289
|
}
|
package/src/hindsight/state.ts
CHANGED
|
@@ -1,6 +1,7 @@
|
|
|
1
1
|
import { createHash } from "node:crypto";
|
|
2
2
|
|
|
3
3
|
import { logger } from "@sayknow-cli/utils";
|
|
4
|
+
import { redactMemorySecretsForTesting as redactMemorySecrets } from "../memories";
|
|
4
5
|
import type { AgentSession } from "../session/agent-session";
|
|
5
6
|
import { type BankScope, ensureBankMission } from "./bank";
|
|
6
7
|
import type { HindsightApi, MemoryItemInput } from "./client";
|
|
@@ -149,8 +150,8 @@ export class HindsightRetainQueue {
|
|
|
149
150
|
try {
|
|
150
151
|
await ensureBankMission(state.client, state.bankId, state.config, state.missionsSet);
|
|
151
152
|
const batch: MemoryItemInput[] = items.map(item => ({
|
|
152
|
-
content: item.content,
|
|
153
|
-
context: item.context
|
|
153
|
+
content: redactMemorySecrets(item.content),
|
|
154
|
+
context: item.context === undefined ? state.config.retainContext : redactMemorySecrets(item.context),
|
|
154
155
|
metadata: { session_id: sessionId },
|
|
155
156
|
tags: state.retainTags,
|
|
156
157
|
}));
|
|
@@ -316,8 +317,10 @@ export class HindsightSessionState {
|
|
|
316
317
|
documentId = `${this.sessionId}-${Date.now()}`;
|
|
317
318
|
}
|
|
318
319
|
|
|
319
|
-
const
|
|
320
|
-
if (!transcript) return false;
|
|
320
|
+
const prepared = prepareRetentionTranscript(target, true);
|
|
321
|
+
if (!prepared.transcript) return false;
|
|
322
|
+
// Same scrub the local memory backend applies before it stores consolidation text.
|
|
323
|
+
const transcript = redactMemorySecrets(prepared.transcript);
|
|
321
324
|
|
|
322
325
|
await ensureBankMission(this.client, this.bankId, this.config, this.missionsSet);
|
|
323
326
|
await this.client.retain(this.bankId, transcript, {
|
|
@@ -2,11 +2,13 @@ import { appendFile, mkdir, stat } from "node:fs/promises";
|
|
|
2
2
|
import * as os from "node:os";
|
|
3
3
|
import * as path from "node:path";
|
|
4
4
|
import { getAgentDir, getConfigDirName } from "@sayknow-cli/utils";
|
|
5
|
+
import { projectEnvSnapshot } from "@sayknow-cli/utils/env-file";
|
|
5
6
|
import { YAML } from "bun";
|
|
6
7
|
import type { SkillDiscoverySettings } from "../config/skill-settings-defaults";
|
|
7
8
|
import { DEFAULT_DISABLED_EXTENSIONS, DEFAULT_SKILL_DISCOVERY_SETTINGS } from "../config/skill-settings-defaults";
|
|
8
9
|
import type { PromptTriager } from "../decisions/prompt-triage";
|
|
9
10
|
import { sessionLogsDir } from "../skc-runtime/session-layout";
|
|
11
|
+
import { trustedCoordinatorEnv } from "../skc-runtime/sidecar-bootstrap-env";
|
|
10
12
|
import { routeNativePrompt } from "./native-prompt-routing";
|
|
11
13
|
import {
|
|
12
14
|
buildActiveUltragoalPromptContext,
|
|
@@ -278,14 +280,14 @@ function readTurnId(payload: HookPayload): string | undefined {
|
|
|
278
280
|
return safeString(payload.turn_id ?? payload.turnId).trim() || undefined;
|
|
279
281
|
}
|
|
280
282
|
|
|
281
|
-
function readSessionFile(payload: HookPayload): string | undefined {
|
|
282
|
-
|
|
283
|
-
|
|
284
|
-
|
|
285
|
-
|
|
286
|
-
|
|
287
|
-
|
|
288
|
-
);
|
|
283
|
+
function readSessionFile(payload: HookPayload, cwd: string): string | undefined {
|
|
284
|
+
const explicit = safeString(
|
|
285
|
+
payload.session_file ?? payload.sessionFile ?? payload.transcript_path ?? payload.transcriptPath,
|
|
286
|
+
).trim();
|
|
287
|
+
if (explicit) return explicit;
|
|
288
|
+
// Bun has already copied the project dotenv into the environment. A value
|
|
289
|
+
// that matches that snapshot must not select another transcript.
|
|
290
|
+
return trustedCoordinatorEnv("SKC_SESSION_FILE", process.env, projectEnvSnapshot(cwd));
|
|
289
291
|
}
|
|
290
292
|
|
|
291
293
|
export async function dispatchSkcNativeSkillHook(
|
|
@@ -308,6 +310,7 @@ async function dispatchSkcNativeSkillHookInner(
|
|
|
308
310
|
): Promise<SkcNativeHookDispatchResult> {
|
|
309
311
|
const hookEventName = readHookEventName(payload);
|
|
310
312
|
const cwd = (options.cwd ?? safeString(payload.cwd).trim()) || process.cwd();
|
|
313
|
+
const sessionFile = readSessionFile(payload, cwd);
|
|
311
314
|
if (hookEventName === "UserPromptSubmit") {
|
|
312
315
|
const prompt = readPromptText(payload);
|
|
313
316
|
// Compute the bundled UI-skill directive first so a later state/recovery
|
|
@@ -332,7 +335,7 @@ async function dispatchSkcNativeSkillHookInner(
|
|
|
332
335
|
threadId: readThreadId(payload),
|
|
333
336
|
stateDir: options.stateDir,
|
|
334
337
|
prompt,
|
|
335
|
-
sessionFile
|
|
338
|
+
sessionFile,
|
|
336
339
|
});
|
|
337
340
|
recoveryContext = buildStateRecoveryDiagnosticsContext(recoveryDiagnostics);
|
|
338
341
|
} catch {
|
|
@@ -384,7 +387,7 @@ async function dispatchSkcNativeSkillHookInner(
|
|
|
384
387
|
threadId: readThreadId(payload),
|
|
385
388
|
stateDir: options.stateDir,
|
|
386
389
|
prompt,
|
|
387
|
-
sessionFile
|
|
390
|
+
sessionFile,
|
|
388
391
|
});
|
|
389
392
|
} catch {
|
|
390
393
|
activeUltragoalContext = null;
|
|
@@ -432,7 +435,7 @@ async function dispatchSkcNativeSkillHookInner(
|
|
|
432
435
|
sessionId: readSessionId(payload),
|
|
433
436
|
threadId: readThreadId(payload),
|
|
434
437
|
stateDir: options.stateDir,
|
|
435
|
-
sessionFile
|
|
438
|
+
sessionFile,
|
|
436
439
|
}),
|
|
437
440
|
};
|
|
438
441
|
}
|
|
@@ -466,7 +469,9 @@ async function readStdinJson(): Promise<{ payload: HookPayload; parseError: Erro
|
|
|
466
469
|
}
|
|
467
470
|
|
|
468
471
|
async function logHookError(cwd: string, type: string, error: unknown): Promise<void> {
|
|
469
|
-
|
|
472
|
+
// Bun has already copied the project dotenv into the environment. A value
|
|
473
|
+
// that matches that snapshot must not select another session's log directory.
|
|
474
|
+
const skcSessionId = trustedCoordinatorEnv("SKC_SESSION_ID", process.env, projectEnvSnapshot(cwd));
|
|
470
475
|
if (!skcSessionId) {
|
|
471
476
|
console.error(
|
|
472
477
|
JSON.stringify({
|
|
@@ -589,6 +589,9 @@ export const deSettings: Record<string, string> = {
|
|
|
589
589
|
"skill-Tool aktivieren, damit der Agent im nächsten Zug zu einer anderen verfügbaren Skill wechseln kann",
|
|
590
590
|
"set:fetch.enabled:l": "URLs lesen",
|
|
591
591
|
"set:fetch.enabled:d": "read-Tool das Abrufen und Verarbeiten von URLs erlauben",
|
|
592
|
+
"set:reverseEngineer.enabled:l": "Reverse Engineer (REA)",
|
|
593
|
+
"set:reverseEngineer.enabled:d":
|
|
594
|
+
"reverse_engineer-Werkzeug aktivieren (REA über npx/bunx), um etwas nach einem vom Benutzer angegebenen Link, einer App oder Binärdatei nachzubauen",
|
|
592
595
|
"set:gitlab.enabled:l": "GitLab CLI",
|
|
593
596
|
"set:gitlab.enabled:d":
|
|
594
597
|
"gitlab-Werkzeug aktivieren (op-basierte Ausführung für Merge-Request-Erstellung/-Ansicht/-Liste und Pipeline-Status über glab)",
|