@waq666/pneuma 0.0.0-stage → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +144 -2
- package/bin/dsc.js +91 -0
- package/bin/headless.cjs +40 -0
- package/lib/adapter/core-runtime.d.ts +11 -0
- package/lib/adapter/core-runtime.js +259 -0
- package/lib/adapter/host.d.ts +18 -0
- package/lib/adapter/host.js +14 -0
- package/lib/adapter/runtime.d.ts +15 -0
- package/lib/adapter/runtime.js +290 -0
- package/lib/adapter/transcript.d.ts +184 -0
- package/lib/adapter/transcript.js +605 -0
- package/lib/app/AgentsOverlay.d.ts +18 -0
- package/lib/app/AgentsOverlay.js +63 -0
- package/lib/app/App.d.ts +13 -0
- package/lib/app/App.js +1498 -0
- package/lib/app/ApprovalCard.d.ts +12 -0
- package/lib/app/ApprovalCard.js +76 -0
- package/lib/app/AskCard.d.ts +20 -0
- package/lib/app/AskCard.js +45 -0
- package/lib/app/ChatView.d.ts +32 -0
- package/lib/app/ChatView.js +198 -0
- package/lib/app/Composer.d.ts +50 -0
- package/lib/app/Composer.js +282 -0
- package/lib/app/DiffBlock.d.ts +6 -0
- package/lib/app/DiffBlock.js +37 -0
- package/lib/app/MarkdownView.d.ts +6 -0
- package/lib/app/MarkdownView.js +99 -0
- package/lib/app/ModelPicker.d.ts +7 -0
- package/lib/app/ModelPicker.js +18 -0
- package/lib/app/PlanReviewCard.d.ts +13 -0
- package/lib/app/PlanReviewCard.js +54 -0
- package/lib/app/PresetPicker.d.ts +11 -0
- package/lib/app/PresetPicker.js +19 -0
- package/lib/app/PreviewOverlay.d.ts +14 -0
- package/lib/app/PreviewOverlay.js +22 -0
- package/lib/app/SessionPicker.d.ts +43 -0
- package/lib/app/SessionPicker.js +56 -0
- package/lib/app/SettingsOverlay.d.ts +32 -0
- package/lib/app/SettingsOverlay.js +157 -0
- package/lib/app/SkillsPicker.d.ts +7 -0
- package/lib/app/SkillsPicker.js +19 -0
- package/lib/app/StatusBar.d.ts +22 -0
- package/lib/app/StatusBar.js +272 -0
- package/lib/app/TaskStrips.d.ts +13 -0
- package/lib/app/TaskStrips.js +40 -0
- package/lib/app/ToolCard.d.ts +5 -0
- package/lib/app/ToolCard.js +40 -0
- package/lib/app/TranscriptOverlay.d.ts +12 -0
- package/lib/app/TranscriptOverlay.js +17 -0
- package/lib/app/Welcome.d.ts +6 -0
- package/lib/app/Welcome.js +66 -0
- package/lib/app/attach.d.ts +16 -0
- package/lib/app/attach.js +58 -0
- package/lib/app/click.d.ts +27 -0
- package/lib/app/click.js +89 -0
- package/lib/app/clipboard-image.d.ts +11 -0
- package/lib/app/clipboard-image.js +66 -0
- package/lib/app/cursor.d.ts +4 -0
- package/lib/app/cursor.js +24 -0
- package/lib/app/hello.d.ts +11 -0
- package/lib/app/hello.js +8 -0
- package/lib/app/history-store.d.ts +4 -0
- package/lib/app/history-store.js +41 -0
- package/lib/app/image-blocks.d.ts +12 -0
- package/lib/app/image-blocks.js +125 -0
- package/lib/app/markdown.d.ts +54 -0
- package/lib/app/markdown.js +189 -0
- package/lib/app/settings-model.d.ts +69 -0
- package/lib/app/settings-model.js +114 -0
- package/lib/app/theme.d.ts +166 -0
- package/lib/app/theme.js +141 -0
- package/lib/boot.d.ts +1 -0
- package/lib/boot.js +34 -0
- package/lib/commands.d.ts +49 -0
- package/lib/commands.js +115 -0
- package/lib/contract.d.ts +1973 -0
- package/lib/contract.js +36 -0
- package/lib/core/agent-roles.d.ts +52 -0
- package/lib/core/agent-roles.js +274 -0
- package/lib/core/approval-floor.d.ts +183 -0
- package/lib/core/approval-floor.js +679 -0
- package/lib/core/approval.d.ts +42 -0
- package/lib/core/approval.js +8 -0
- package/lib/core/audit.d.ts +61 -0
- package/lib/core/audit.js +59 -0
- package/lib/core/boot-notices.d.ts +6 -0
- package/lib/core/boot-notices.js +61 -0
- package/lib/core/cdp/actions.d.ts +182 -0
- package/lib/core/cdp/actions.js +649 -0
- package/lib/core/cdp/launch.d.ts +192 -0
- package/lib/core/cdp/launch.js +491 -0
- package/lib/core/cdp/snapshot.d.ts +139 -0
- package/lib/core/cdp/snapshot.js +316 -0
- package/lib/core/cdp/transport.d.ts +160 -0
- package/lib/core/cdp/transport.js +359 -0
- package/lib/core/command-policy.d.ts +108 -0
- package/lib/core/command-policy.js +580 -0
- package/lib/core/commands-completion.d.ts +78 -0
- package/lib/core/commands-completion.js +167 -0
- package/lib/core/compact-anchors.d.ts +76 -0
- package/lib/core/compact-anchors.js +284 -0
- package/lib/core/compact.d.ts +110 -0
- package/lib/core/compact.js +210 -0
- package/lib/core/config-store.d.ts +38 -0
- package/lib/core/config-store.js +307 -0
- package/lib/core/config.d.ts +36 -0
- package/lib/core/config.js +124 -0
- package/lib/core/connection-test.d.ts +60 -0
- package/lib/core/connection-test.js +84 -0
- package/lib/core/desktop-control.d.ts +298 -0
- package/lib/core/desktop-control.js +1311 -0
- package/lib/core/diff-text.d.ts +74 -0
- package/lib/core/diff-text.js +257 -0
- package/lib/core/dock-browser.d.ts +137 -0
- package/lib/core/dock-browser.js +146 -0
- package/lib/core/dock-ops.d.ts +59 -0
- package/lib/core/dock-ops.js +104 -0
- package/lib/core/dock-session.d.ts +39 -0
- package/lib/core/dock-session.js +28 -0
- package/lib/core/dsh-compat/hook.d.ts +18 -0
- package/lib/core/dsh-compat/hook.js +52 -0
- package/lib/core/dsh-compat/resolve-hook.d.ts +5 -0
- package/lib/core/dsh-compat/resolve-hook.js +59 -0
- package/lib/core/dsh-compat/tools-facade.d.ts +47 -0
- package/lib/core/dsh-compat/tools-facade.js +108 -0
- package/lib/core/err-text.d.ts +13 -0
- package/lib/core/err-text.js +15 -0
- package/lib/core/events.d.ts +149 -0
- package/lib/core/events.js +1 -0
- package/lib/core/git-exec.d.ts +23 -0
- package/lib/core/git-exec.js +72 -0
- package/lib/core/git-info.d.ts +47 -0
- package/lib/core/git-info.js +157 -0
- package/lib/core/goal.d.ts +89 -0
- package/lib/core/goal.js +189 -0
- package/lib/core/hooks.d.ts +272 -0
- package/lib/core/hooks.js +818 -0
- package/lib/core/host-browser-link.d.ts +59 -0
- package/lib/core/host-browser-link.js +9 -0
- package/lib/core/host-methods.d.ts +25 -0
- package/lib/core/host-methods.js +103 -0
- package/lib/core/image-diet.d.ts +77 -0
- package/lib/core/image-diet.js +127 -0
- package/lib/core/learnings/ledger.d.ts +73 -0
- package/lib/core/learnings/ledger.js +273 -0
- package/lib/core/learnings/skill-write.d.ts +250 -0
- package/lib/core/learnings/skill-write.js +854 -0
- package/lib/core/learnings/store.d.ts +102 -0
- package/lib/core/learnings/store.js +266 -0
- package/lib/core/lifecycle-hooks.d.ts +189 -0
- package/lib/core/lifecycle-hooks.js +576 -0
- package/lib/core/llm.d.ts +272 -0
- package/lib/core/llm.js +548 -0
- package/lib/core/lockfile.d.ts +17 -0
- package/lib/core/lockfile.js +110 -0
- package/lib/core/loop.d.ts +185 -0
- package/lib/core/loop.js +587 -0
- package/lib/core/lsp/client.d.ts +189 -0
- package/lib/core/lsp/client.js +690 -0
- package/lib/core/lsp/framing.d.ts +84 -0
- package/lib/core/lsp/framing.js +181 -0
- package/lib/core/lsp/line-shift.d.ts +28 -0
- package/lib/core/lsp/line-shift.js +127 -0
- package/lib/core/lsp/manager.d.ts +93 -0
- package/lib/core/lsp/manager.js +418 -0
- package/lib/core/lsp/normalize.d.ts +32 -0
- package/lib/core/lsp/normalize.js +139 -0
- package/lib/core/lsp/servers.d.ts +106 -0
- package/lib/core/lsp/servers.js +352 -0
- package/lib/core/lsp/uri.d.ts +76 -0
- package/lib/core/lsp/uri.js +179 -0
- package/lib/core/market.d.ts +51 -0
- package/lib/core/market.js +358 -0
- package/lib/core/mcp.d.ts +201 -0
- package/lib/core/mcp.js +836 -0
- package/lib/core/memory-eval.d.ts +158 -0
- package/lib/core/memory-eval.js +215 -0
- package/lib/core/memory.d.ts +266 -0
- package/lib/core/memory.js +703 -0
- package/lib/core/mention.d.ts +57 -0
- package/lib/core/mention.js +129 -0
- package/lib/core/microcompact.d.ts +48 -0
- package/lib/core/microcompact.js +79 -0
- package/lib/core/migrate.d.ts +56 -0
- package/lib/core/migrate.js +134 -0
- package/lib/core/model-caps.d.ts +83 -0
- package/lib/core/model-caps.js +150 -0
- package/lib/core/model-discovery.d.ts +19 -0
- package/lib/core/model-discovery.js +69 -0
- package/lib/core/modes.d.ts +72 -0
- package/lib/core/modes.js +152 -0
- package/lib/core/native-bridge.d.ts +135 -0
- package/lib/core/native-bridge.js +563 -0
- package/lib/core/path-policy.d.ts +32 -0
- package/lib/core/path-policy.js +248 -0
- package/lib/core/permission-presets.d.ts +67 -0
- package/lib/core/permission-presets.js +75 -0
- package/lib/core/plugin-loader.d.ts +36 -0
- package/lib/core/plugin-loader.js +294 -0
- package/lib/core/plugin-registry.d.ts +113 -0
- package/lib/core/plugin-registry.js +256 -0
- package/lib/core/prefs.d.ts +82 -0
- package/lib/core/prefs.js +372 -0
- package/lib/core/presets.d.ts +80 -0
- package/lib/core/presets.js +373 -0
- package/lib/core/pricing.d.ts +90 -0
- package/lib/core/pricing.js +126 -0
- package/lib/core/prompt.d.ts +92 -0
- package/lib/core/prompt.js +339 -0
- package/lib/core/ptc.d.ts +66 -0
- package/lib/core/ptc.js +70 -0
- package/lib/core/remote/frames.d.ts +91 -0
- package/lib/core/remote/frames.js +174 -0
- package/lib/core/remote/notify.d.ts +54 -0
- package/lib/core/remote/notify.js +77 -0
- package/lib/core/remote/owner.d.ts +32 -0
- package/lib/core/remote/owner.js +75 -0
- package/lib/core/remote/pairing.d.ts +104 -0
- package/lib/core/remote/pairing.js +261 -0
- package/lib/core/remote/push.d.ts +80 -0
- package/lib/core/remote/push.js +222 -0
- package/lib/core/remote/store.d.ts +18 -0
- package/lib/core/remote/store.js +59 -0
- package/lib/core/remote/tickets.d.ts +20 -0
- package/lib/core/remote/tickets.js +49 -0
- package/lib/core/remote/uploads.d.ts +63 -0
- package/lib/core/remote/uploads.js +161 -0
- package/lib/core/request-attribution.d.ts +26 -0
- package/lib/core/request-attribution.js +86 -0
- package/lib/core/request-invariant.d.ts +61 -0
- package/lib/core/request-invariant.js +199 -0
- package/lib/core/sandbox/backends.d.ts +64 -0
- package/lib/core/sandbox/backends.js +194 -0
- package/lib/core/sandbox/execpolicy.d.ts +93 -0
- package/lib/core/sandbox/execpolicy.js +452 -0
- package/lib/core/sandbox/net-proxy.d.ts +31 -0
- package/lib/core/sandbox/net-proxy.js +162 -0
- package/lib/core/sandbox/policy.d.ts +211 -0
- package/lib/core/sandbox/policy.js +559 -0
- package/lib/core/sandbox/win/abi.d.ts +161 -0
- package/lib/core/sandbox/win/abi.js +169 -0
- package/lib/core/sandbox/win/account.d.ts +71 -0
- package/lib/core/sandbox/win/account.js +206 -0
- package/lib/core/sandbox/win/acl.d.ts +54 -0
- package/lib/core/sandbox/win/acl.js +339 -0
- package/lib/core/sandbox/win/backend.d.ts +61 -0
- package/lib/core/sandbox/win/backend.js +249 -0
- package/lib/core/sandbox/win/doctor.d.ts +24 -0
- package/lib/core/sandbox/win/doctor.js +272 -0
- package/lib/core/sandbox/win/ffi.d.ts +107 -0
- package/lib/core/sandbox/win/ffi.js +166 -0
- package/lib/core/sandbox/win/net-abi.d.ts +154 -0
- package/lib/core/sandbox/win/net-abi.js +316 -0
- package/lib/core/sandbox/win/runner-entry.d.ts +35 -0
- package/lib/core/sandbox/win/runner-entry.js +391 -0
- package/lib/core/sandbox/win/setup.d.ts +60 -0
- package/lib/core/sandbox/win/setup.js +986 -0
- package/lib/core/sandbox/win/token.d.ts +35 -0
- package/lib/core/sandbox/win/token.js +238 -0
- package/lib/core/sandbox/win/wfp.d.ts +41 -0
- package/lib/core/sandbox/win/wfp.js +200 -0
- package/lib/core/sandbox/win/workspace-sid.d.ts +9 -0
- package/lib/core/sandbox/win/workspace-sid.js +45 -0
- package/lib/core/schedule/rule.d.ts +184 -0
- package/lib/core/schedule/rule.js +745 -0
- package/lib/core/schedule/runner.d.ts +185 -0
- package/lib/core/schedule/runner.js +678 -0
- package/lib/core/schedule/store.d.ts +182 -0
- package/lib/core/schedule/store.js +455 -0
- package/lib/core/secrets.d.ts +41 -0
- package/lib/core/secrets.js +150 -0
- package/lib/core/session-export.d.ts +18 -0
- package/lib/core/session-export.js +73 -0
- package/lib/core/session-index.d.ts +159 -0
- package/lib/core/session-index.js +683 -0
- package/lib/core/session-meta.d.ts +41 -0
- package/lib/core/session-meta.js +97 -0
- package/lib/core/session.d.ts +356 -0
- package/lib/core/session.js +998 -0
- package/lib/core/skills.d.ts +60 -0
- package/lib/core/skills.js +171 -0
- package/lib/core/spill.d.ts +159 -0
- package/lib/core/spill.js +329 -0
- package/lib/core/surface-registry.d.ts +45 -0
- package/lib/core/surface-registry.js +67 -0
- package/lib/core/team-board.d.ts +95 -0
- package/lib/core/team-board.js +316 -0
- package/lib/core/throughput.d.ts +46 -0
- package/lib/core/throughput.js +40 -0
- package/lib/core/todo-reminder.d.ts +44 -0
- package/lib/core/todo-reminder.js +55 -0
- package/lib/core/todo.d.ts +81 -0
- package/lib/core/todo.js +222 -0
- package/lib/core/token-estimate.d.ts +55 -0
- package/lib/core/token-estimate.js +82 -0
- package/lib/core/tool-guards.d.ts +103 -0
- package/lib/core/tool-guards.js +77 -0
- package/lib/core/tool-search.d.ts +152 -0
- package/lib/core/tool-search.js +311 -0
- package/lib/core/tools/bash.d.ts +281 -0
- package/lib/core/tools/bash.js +871 -0
- package/lib/core/tools/command-runner.d.ts +84 -0
- package/lib/core/tools/command-runner.js +68 -0
- package/lib/core/tools/fs-tools.d.ts +23 -0
- package/lib/core/tools/fs-tools.js +247 -0
- package/lib/core/tools/index.d.ts +8 -0
- package/lib/core/tools/index.js +4 -0
- package/lib/core/tools/sandbox-args.d.ts +51 -0
- package/lib/core/tools/sandbox-args.js +90 -0
- package/lib/core/tools/search-tools.d.ts +3 -0
- package/lib/core/tools/search-tools.js +153 -0
- package/lib/core/tools.d.ts +96 -0
- package/lib/core/tools.js +53 -0
- package/lib/core/ui-boot-source.d.ts +71 -0
- package/lib/core/ui-boot-source.js +121 -0
- package/lib/core/ui-bundles.d.ts +249 -0
- package/lib/core/ui-bundles.js +830 -0
- package/lib/core/ui-combo.d.ts +49 -0
- package/lib/core/ui-combo.js +55 -0
- package/lib/core/ui-events.d.ts +81 -0
- package/lib/core/ui-events.js +364 -0
- package/lib/core/ui-hmr.d.ts +36 -0
- package/lib/core/ui-hmr.js +128 -0
- package/lib/core/ui-methods.d.ts +69 -0
- package/lib/core/ui-methods.js +341 -0
- package/lib/core/ui-route.d.ts +69 -0
- package/lib/core/ui-route.js +122 -0
- package/lib/core/ui-server.d.ts +75 -0
- package/lib/core/ui-server.js +369 -0
- package/lib/core/ui-trust.d.ts +47 -0
- package/lib/core/ui-trust.js +164 -0
- package/lib/core/untrusted.d.ts +30 -0
- package/lib/core/untrusted.js +48 -0
- package/lib/core/update-check.d.ts +81 -0
- package/lib/core/update-check.js +177 -0
- package/lib/core/usage-log.d.ts +82 -0
- package/lib/core/usage-log.js +306 -0
- package/lib/core/version.d.ts +1 -0
- package/lib/core/version.js +37 -0
- package/lib/core/web-http.d.ts +57 -0
- package/lib/core/web-http.js +137 -0
- package/lib/core/web-static.d.ts +31 -0
- package/lib/core/web-static.js +75 -0
- package/lib/headless.d.ts +1 -0
- package/lib/headless.js +31 -0
- package/lib/host/kernel.d.ts +33 -0
- package/lib/host/kernel.js +451 -0
- package/lib/index.d.ts +41 -0
- package/lib/index.js +35 -0
- package/lib/plugins/agent.d.ts +2 -0
- package/lib/plugins/agent.js +274 -0
- package/lib/plugins/approval-floor.d.ts +2 -0
- package/lib/plugins/approval-floor.js +223 -0
- package/lib/plugins/approval.d.ts +16 -0
- package/lib/plugins/approval.js +674 -0
- package/lib/plugins/ask.d.ts +2 -0
- package/lib/plugins/ask.js +245 -0
- package/lib/plugins/browser.d.ts +68 -0
- package/lib/plugins/browser.js +1341 -0
- package/lib/plugins/commands.d.ts +23 -0
- package/lib/plugins/commands.js +498 -0
- package/lib/plugins/compact.d.ts +21 -0
- package/lib/plugins/compact.js +274 -0
- package/lib/plugins/computer-use.d.ts +47 -0
- package/lib/plugins/computer-use.js +539 -0
- package/lib/plugins/desktop-dock.d.ts +2 -0
- package/lib/plugins/desktop-dock.js +626 -0
- package/lib/plugins/dock-browser.d.ts +34 -0
- package/lib/plugins/dock-browser.js +765 -0
- package/lib/plugins/dsh-compat.d.ts +25 -0
- package/lib/plugins/dsh-compat.js +37 -0
- package/lib/plugins/file-review.d.ts +108 -0
- package/lib/plugins/file-review.js +393 -0
- package/lib/plugins/git.d.ts +26 -0
- package/lib/plugins/git.js +132 -0
- package/lib/plugins/goal.d.ts +20 -0
- package/lib/plugins/goal.js +245 -0
- package/lib/plugins/guards.d.ts +14 -0
- package/lib/plugins/guards.js +18 -0
- package/lib/plugins/hooks.d.ts +19 -0
- package/lib/plugins/hooks.js +583 -0
- package/lib/plugins/host-stdio.d.ts +88 -0
- package/lib/plugins/host-stdio.js +317 -0
- package/lib/plugins/image-diet.d.ts +17 -0
- package/lib/plugins/image-diet.js +85 -0
- package/lib/plugins/lifecycle-hooks.d.ts +26 -0
- package/lib/plugins/lifecycle-hooks.js +338 -0
- package/lib/plugins/llm.d.ts +13 -0
- package/lib/plugins/llm.js +215 -0
- package/lib/plugins/lsp.d.ts +54 -0
- package/lib/plugins/lsp.js +608 -0
- package/lib/plugins/mcp.d.ts +16 -0
- package/lib/plugins/mcp.js +673 -0
- package/lib/plugins/memory.d.ts +17 -0
- package/lib/plugins/memory.js +858 -0
- package/lib/plugins/microcompact.d.ts +18 -0
- package/lib/plugins/microcompact.js +119 -0
- package/lib/plugins/mode.d.ts +18 -0
- package/lib/plugins/mode.js +115 -0
- package/lib/plugins/permission-presets.d.ts +18 -0
- package/lib/plugins/permission-presets.js +135 -0
- package/lib/plugins/plan.d.ts +2 -0
- package/lib/plugins/plan.js +192 -0
- package/lib/plugins/plugin-manager.d.ts +2 -0
- package/lib/plugins/plugin-manager.js +165 -0
- package/lib/plugins/presets.d.ts +2 -0
- package/lib/plugins/presets.js +182 -0
- package/lib/plugins/prompt.d.ts +2 -0
- package/lib/plugins/prompt.js +264 -0
- package/lib/plugins/ptc.d.ts +2 -0
- package/lib/plugins/ptc.js +272 -0
- package/lib/plugins/remote/http.d.ts +11 -0
- package/lib/plugins/remote/http.js +11 -0
- package/lib/plugins/remote/routes.d.ts +24 -0
- package/lib/plugins/remote/routes.js +384 -0
- package/lib/plugins/remote/types.d.ts +135 -0
- package/lib/plugins/remote/types.js +87 -0
- package/lib/plugins/remote.d.ts +17 -0
- package/lib/plugins/remote.js +1028 -0
- package/lib/plugins/runtime-api.d.ts +16 -0
- package/lib/plugins/runtime-api.js +99 -0
- package/lib/plugins/runtime.d.ts +10 -0
- package/lib/plugins/runtime.js +451 -0
- package/lib/plugins/sandbox.d.ts +2 -0
- package/lib/plugins/sandbox.js +761 -0
- package/lib/plugins/schedule.d.ts +26 -0
- package/lib/plugins/schedule.js +538 -0
- package/lib/plugins/self-improve.d.ts +61 -0
- package/lib/plugins/self-improve.js +953 -0
- package/lib/plugins/session-search.d.ts +16 -0
- package/lib/plugins/session-search.js +308 -0
- package/lib/plugins/session-title.d.ts +19 -0
- package/lib/plugins/session-title.js +109 -0
- package/lib/plugins/session.d.ts +7 -0
- package/lib/plugins/session.js +296 -0
- package/lib/plugins/settings.d.ts +3 -0
- package/lib/plugins/settings.js +705 -0
- package/lib/plugins/skills.d.ts +2 -0
- package/lib/plugins/skills.js +360 -0
- package/lib/plugins/spill.d.ts +16 -0
- package/lib/plugins/spill.js +200 -0
- package/lib/plugins/subagent.d.ts +2 -0
- package/lib/plugins/subagent.js +862 -0
- package/lib/plugins/surfaces.d.ts +11 -0
- package/lib/plugins/surfaces.js +20 -0
- package/lib/plugins/team.d.ts +16 -0
- package/lib/plugins/team.js +149 -0
- package/lib/plugins/todo.d.ts +19 -0
- package/lib/plugins/todo.js +188 -0
- package/lib/plugins/tool-search.d.ts +2 -0
- package/lib/plugins/tool-search.js +425 -0
- package/lib/plugins/tools-default.d.ts +12 -0
- package/lib/plugins/tools-default.js +275 -0
- package/lib/plugins/tools.d.ts +16 -0
- package/lib/plugins/tools.js +62 -0
- package/lib/plugins/transcript.d.ts +15 -0
- package/lib/plugins/transcript.js +311 -0
- package/lib/plugins/tui.d.ts +2 -0
- package/lib/plugins/tui.js +98 -0
- package/lib/plugins/waiting.d.ts +12 -0
- package/lib/plugins/waiting.js +34 -0
- package/lib/plugins/web-search.d.ts +14 -0
- package/lib/plugins/web-search.js +263 -0
- package/lib/plugins/webserver.d.ts +48 -0
- package/lib/plugins/webserver.js +228 -0
- package/lib/remote/assets/app-DAcUCOEn.js +14 -0
- package/lib/remote/assets/icon-192.png +0 -0
- package/lib/remote/assets/icon-512.png +0 -0
- package/lib/remote/assets/index.html +34 -0
- package/lib/remote/assets/manifest.json +27 -0
- package/lib/remote/assets/style-DIB6729x.css +1 -0
- package/lib/remote/assets/sw.js +66 -0
- package/lib/services/types.d.ts +1228 -0
- package/lib/services/types.js +1 -0
- package/lib/tools/config-cli.d.ts +1 -0
- package/lib/tools/config-cli.js +89 -0
- package/lib/ui/arrival.d.ts +72 -0
- package/lib/ui/arrival.js +105 -0
- package/lib/ui/assets/app-B70nVIKd.js +69 -0
- package/lib/ui/assets/chunk-2UxHyX5q.js +1 -0
- package/lib/ui/assets/chunk-B1dDrJ26.js +1 -0
- package/lib/ui/assets/chunk-B6aJPvgy.js +1 -0
- package/lib/ui/assets/chunk-BEwlwnbL.js +1 -0
- package/lib/ui/assets/chunk-BGcgwlCI.js +12 -0
- package/lib/ui/assets/chunk-BIGW1oBm.js +1 -0
- package/lib/ui/assets/chunk-BPQ3VLAy.js +1 -0
- package/lib/ui/assets/chunk-BRH0KZbk.js +141 -0
- package/lib/ui/assets/chunk-BX6H_ySx.js +1 -0
- package/lib/ui/assets/chunk-B_P3UbPa.js +1 -0
- package/lib/ui/assets/chunk-B_TYUkTI.js +1 -0
- package/lib/ui/assets/chunk-B_vNuMnf.js +1 -0
- package/lib/ui/assets/chunk-BajyYBss.js +10 -0
- package/lib/ui/assets/chunk-BdnUsdx6.js +1 -0
- package/lib/ui/assets/chunk-Buea-lGh.js +1 -0
- package/lib/ui/assets/chunk-C0PvZCCE.js +1 -0
- package/lib/ui/assets/chunk-C0m74zRD.js +1 -0
- package/lib/ui/assets/chunk-C27-OAKa.js +1 -0
- package/lib/ui/assets/chunk-C2oV4EkX.js +1 -0
- package/lib/ui/assets/chunk-C7zT0LnQ.js +1 -0
- package/lib/ui/assets/chunk-C9GSunVT.js +1 -0
- package/lib/ui/assets/chunk-C9tS-k6U.js +1 -0
- package/lib/ui/assets/chunk-CHLpvVh8.js +1 -0
- package/lib/ui/assets/chunk-CLxacb5B.js +1 -0
- package/lib/ui/assets/chunk-COt5Ahok.js +1 -0
- package/lib/ui/assets/chunk-CPTIWCL2.js +1 -0
- package/lib/ui/assets/chunk-CQLl-L-p.js +1 -0
- package/lib/ui/assets/chunk-CUWRgxuq.js +55 -0
- package/lib/ui/assets/chunk-CWanVSXC.js +1 -0
- package/lib/ui/assets/chunk-Cf5RLm7j.js +1 -0
- package/lib/ui/assets/chunk-CickPsom.js +1 -0
- package/lib/ui/assets/chunk-Cj5Yp3dK.js +1 -0
- package/lib/ui/assets/chunk-Cmh6b_Ma.js +1 -0
- package/lib/ui/assets/chunk-Cp-IABpG.js +1 -0
- package/lib/ui/assets/chunk-CqE71os6.js +1 -0
- package/lib/ui/assets/chunk-CtKP3W-j.js +1 -0
- package/lib/ui/assets/chunk-Cvjx9yec.js +1 -0
- package/lib/ui/assets/chunk-CxGP3dtY.js +1 -0
- package/lib/ui/assets/chunk-CylS5w8V.js +1 -0
- package/lib/ui/assets/chunk-D38fbIBN.js +1 -0
- package/lib/ui/assets/chunk-D97Zzqfu.js +1 -0
- package/lib/ui/assets/chunk-DAi9KRSo.js +1 -0
- package/lib/ui/assets/chunk-DHK4yRfg.js +1 -0
- package/lib/ui/assets/chunk-DJeabLx-.js +1 -0
- package/lib/ui/assets/chunk-DNRxmY5a.js +1 -0
- package/lib/ui/assets/chunk-DNSN1z5r.js +1 -0
- package/lib/ui/assets/chunk-DNasK_ZG.js +1 -0
- package/lib/ui/assets/chunk-DPvrY3IQ.js +1 -0
- package/lib/ui/assets/chunk-DXmwc3jG.js +1 -0
- package/lib/ui/assets/chunk-Dd0kTxKP.js +1 -0
- package/lib/ui/assets/chunk-De0Btta0.js +1 -0
- package/lib/ui/assets/chunk-Des-eS-w.js +1 -0
- package/lib/ui/assets/chunk-Df6bDoY_.js +1 -0
- package/lib/ui/assets/chunk-DijEV5ha.js +1 -0
- package/lib/ui/assets/chunk-DkvoVjww.js +1 -0
- package/lib/ui/assets/chunk-DlC-OlHO.js +1 -0
- package/lib/ui/assets/chunk-DnzrXTVv.js +1 -0
- package/lib/ui/assets/chunk-Dualf0xi.js +1 -0
- package/lib/ui/assets/chunk-EXT84bkm.js +1 -0
- package/lib/ui/assets/chunk-GwR3hkPK.js +1 -0
- package/lib/ui/assets/chunk-P80f7IUj.js +1 -0
- package/lib/ui/assets/chunk-VOosw3JB.js +1 -0
- package/lib/ui/assets/chunk-YQ4lDkt_.js +140 -0
- package/lib/ui/assets/chunk-Yzrsuije.js +1 -0
- package/lib/ui/assets/chunk-Z72CF80r.js +1 -0
- package/lib/ui/assets/chunk-g9-lgVsj.js +1 -0
- package/lib/ui/assets/chunk-vGWfd6FD.js +1 -0
- package/lib/ui/assets/chunk-wDzz0qaB.js +1 -0
- package/lib/ui/assets/chunk-ySF7HWmS.js +1 -0
- package/lib/ui/assets/icon.png +0 -0
- package/lib/ui/assets/index.html +14 -0
- package/lib/ui/assets/pdf.worker.min-CjEcRF4W.mjs +28 -0
- package/lib/ui/assets/style-Bq01xH_b.css +1 -0
- package/lib/ui/frames.d.ts +67 -0
- package/lib/ui/frames.js +146 -0
- package/lib/ui/index.d.ts +59 -0
- package/lib/ui/index.js +50 -0
- package/lib/ui/manifest.d.ts +172 -0
- package/lib/ui/manifest.js +158 -0
- package/lib/ui/plugin.d.ts +161 -0
- package/lib/ui/plugin.js +7 -0
- package/lib/ui/plugins/browser/client.js +290 -0
- package/lib/ui/plugins/browser/icon.png +0 -0
- package/lib/ui/plugins/composer/client.js +1843 -0
- package/lib/ui/plugins/composer/icon.png +0 -0
- package/lib/ui/plugins/files/client.js +646 -0
- package/lib/ui/plugins/files/icon.png +0 -0
- package/lib/ui/plugins/manifest.json +107 -0
- package/lib/ui/plugins/plugins/client.js +682 -0
- package/lib/ui/plugins/plugins/icon.png +0 -0
- package/lib/ui/plugins/preview/client.js +197 -0
- package/lib/ui/plugins/preview/icon.png +0 -0
- package/lib/ui/plugins/prompt/client.js +653 -0
- package/lib/ui/plugins/prompt/icon.png +0 -0
- package/lib/ui/plugins/sessions/client.js +1577 -0
- package/lib/ui/plugins/sessions/icon.png +0 -0
- package/lib/ui/plugins/settings/client.js +5470 -0
- package/lib/ui/plugins/settings/icon.png +0 -0
- package/lib/ui/plugins/skills/client.js +485 -0
- package/lib/ui/plugins/skills/icon.png +0 -0
- package/lib/ui/plugins/status/client.js +1420 -0
- package/lib/ui/plugins/status/icon.png +0 -0
- package/lib/ui/plugins/statusbar/client.js +504 -0
- package/lib/ui/plugins/statusbar/icon.png +0 -0
- package/lib/ui/plugins/tasks/client.js +52 -0
- package/lib/ui/plugins/tasks/icon.png +0 -0
- package/lib/ui/plugins/team/client.js +527 -0
- package/lib/ui/plugins/team/icon.png +0 -0
- package/lib/ui/plugins/terminal/client.js +232 -0
- package/lib/ui/plugins/terminal/icon.png +0 -0
- package/lib/ui/plugins/trace/client.js +1376 -0
- package/lib/ui/plugins/trace/icon.png +0 -0
- package/lib/ui/plugins/transcript/client.js +2661 -0
- package/lib/ui/plugins/transcript/icon.png +0 -0
- package/lib/ui/scoped-slots.d.ts +20 -0
- package/lib/ui/scoped-slots.js +21 -0
- package/lib/ui/sdk/@dsc/ui/index.d.ts +242 -0
- package/lib/ui/sdk/@dsc/ui/package.json +16 -0
- package/lib/ui/sdk/@dsc/ui-core/contract.d.ts +1973 -0
- package/lib/ui/sdk/@dsc/ui-core/core/diff-text.d.ts +74 -0
- package/lib/ui/sdk/@dsc/ui-core/core/dock-browser.d.ts +137 -0
- package/lib/ui/sdk/@dsc/ui-core/core/dock-ops.d.ts +59 -0
- package/lib/ui/sdk/@dsc/ui-core/core/model-caps.d.ts +83 -0
- package/lib/ui/sdk/@dsc/ui-core/core/native-bridge.d.ts +135 -0
- package/lib/ui/sdk/@dsc/ui-core/core/token-estimate.d.ts +55 -0
- package/lib/ui/sdk/@dsc/ui-core/package.json +16 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/arrival.d.ts +72 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/frames.d.ts +67 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/index.d.ts +59 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/manifest.d.ts +172 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/plugin.d.ts +161 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/scoped-slots.d.ts +20 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/services-react.d.ts +27 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/services.d.ts +63 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/slots-react.d.ts +28 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/slots.d.ts +481 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/store.d.ts +89 -0
- package/lib/ui/sdk/@dsc/ui-dockkit/dock-model.d.ts +238 -0
- package/lib/ui/sdk/@dsc/ui-dockkit/dock-state.d.ts +163 -0
- package/lib/ui/sdk/@dsc/ui-dockkit/dock.d.ts +24 -0
- package/lib/ui/sdk/@dsc/ui-dockkit/index.d.ts +15 -0
- package/lib/ui/sdk/@dsc/ui-dockkit/package.json +16 -0
- package/lib/ui/sdk/@dsc/ui-layout/app.d.ts +74 -0
- package/lib/ui/sdk/@dsc/ui-layout/appearance.d.ts +70 -0
- package/lib/ui/sdk/@dsc/ui-layout/host-channel.d.ts +112 -0
- package/lib/ui/sdk/@dsc/ui-layout/index.d.ts +34 -0
- package/lib/ui/sdk/@dsc/ui-layout/package.json +16 -0
- package/lib/ui/sdk/@dsc/ui-layout/page-state.d.ts +14 -0
- package/lib/ui/sdk/@dsc/ui-layout/review-pane.d.ts +21 -0
- package/lib/ui/sdk/@dsc/ui-layout/runtime-context.d.ts +44 -0
- package/lib/ui/sdk/@dsc/ui-layout/thread-view.d.ts +28 -0
- package/lib/ui/sdk/@dsc/ui-layout/update-button.d.ts +21 -0
- package/lib/ui/sdk/@dsc/ui-primitives/code-file-icon-artwork.d.ts +53 -0
- package/lib/ui/sdk/@dsc/ui-primitives/code-view.d.ts +15 -0
- package/lib/ui/sdk/@dsc/ui-primitives/compat.d.ts +27 -0
- package/lib/ui/sdk/@dsc/ui-primitives/completion-sound.d.ts +24 -0
- package/lib/ui/sdk/@dsc/ui-primitives/confirm.d.ts +33 -0
- package/lib/ui/sdk/@dsc/ui-primitives/css.d.ts +47 -0
- package/lib/ui/sdk/@dsc/ui-primitives/diff-rows.d.ts +20 -0
- package/lib/ui/sdk/@dsc/ui-primitives/file-icons.d.ts +38 -0
- package/lib/ui/sdk/@dsc/ui-primitives/file-type-classify.d.ts +66 -0
- package/lib/ui/sdk/@dsc/ui-primitives/file-type-icon.d.ts +57 -0
- package/lib/ui/sdk/@dsc/ui-primitives/highlight.d.ts +24 -0
- package/lib/ui/sdk/@dsc/ui-primitives/hover-delay.d.ts +17 -0
- package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +109 -0
- package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +55 -0
- package/lib/ui/sdk/@dsc/ui-primitives/lang-table.d.ts +10 -0
- package/lib/ui/sdk/@dsc/ui-primitives/markdown.d.ts +20 -0
- package/lib/ui/sdk/@dsc/ui-primitives/native.d.ts +41 -0
- package/lib/ui/sdk/@dsc/ui-primitives/package.json +16 -0
- package/lib/ui/sdk/@dsc/ui-primitives/panels.d.ts +86 -0
- package/lib/ui/sdk/@dsc/ui-primitives/paths.d.ts +11 -0
- package/lib/ui/sdk/@dsc/ui-primitives/pdf-view.d.ts +13 -0
- package/lib/ui/sdk/@dsc/ui-primitives/plugin-text.d.ts +15 -0
- package/lib/ui/sdk/@dsc/ui-primitives/select.d.ts +35 -0
- package/lib/ui/sdk/@dsc/ui-primitives/table-view.d.ts +23 -0
- package/lib/ui/sdk/@dsc/ui-primitives/thread-resizer.d.ts +22 -0
- package/lib/ui/sdk/@dsc/ui-primitives/time.d.ts +33 -0
- package/lib/ui/sdk/@dsc/ui-primitives/toast.d.ts +16 -0
- package/lib/ui/sdk/@dsc/ui-primitives/tokens.d.ts +14 -0
- package/lib/ui/sdk/@dsc/ui-primitives/tool-args.d.ts +49 -0
- package/lib/ui/sdk/@dsc/ui-primitives/tool-summary.d.ts +64 -0
- package/lib/ui/sdk/@dsc/ui-renderer/boot.d.ts +121 -0
- package/lib/ui/sdk/@dsc/ui-renderer/hmr.d.ts +43 -0
- package/lib/ui/sdk/@dsc/ui-renderer/index.d.ts +20 -0
- package/lib/ui/sdk/@dsc/ui-renderer/package.json +16 -0
- package/lib/ui/sdk/@dsc/ui-slots/index.d.ts +19 -0
- package/lib/ui/sdk/@dsc/ui-slots/package.json +16 -0
- package/lib/ui/sdk/@dsc/ui-slots/slots-react.d.ts +48 -0
- package/lib/ui/sdk/@dsc/ui-slots/slots.d.ts +102 -0
- package/lib/ui/services-react.d.ts +27 -0
- package/lib/ui/services-react.js +32 -0
- package/lib/ui/services.d.ts +63 -0
- package/lib/ui/services.js +121 -0
- package/lib/ui/slots-ink.d.ts +26 -0
- package/lib/ui/slots-ink.js +78 -0
- package/lib/ui/slots-react.d.ts +28 -0
- package/lib/ui/slots-react.js +88 -0
- package/lib/ui/slots.d.ts +481 -0
- package/lib/ui/slots.js +550 -0
- package/lib/ui/store.d.ts +89 -0
- package/lib/ui/store.js +62 -0
- package/lib/ui/tui-plugin-api.d.ts +23 -0
- package/lib/ui/tui-plugin-api.js +23 -0
- package/lib/ui/tui-plugins.d.ts +47 -0
- package/lib/ui/tui-plugins.js +220 -0
- package/package.json +58 -6
|
@@ -0,0 +1,1228 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 服务契约:内置插件 provide 的全部服务接口 + cordis Context/Events 声明合并。
|
|
3
|
+
*
|
|
4
|
+
* 「万物皆插件」的类型边界:插件只 import 本文件、core/ 实现库与 contract.ts,
|
|
5
|
+
* 服务之间通过 ctx.<name> 访问、通过 dsc/* 事件解耦(禁止直接 import 其他插件)。
|
|
6
|
+
*
|
|
7
|
+
* 事件约定:
|
|
8
|
+
* - `dsc/changed` —— 任何影响快照的状态变化后发出(transcript 据此失效缓存);
|
|
9
|
+
* - `dsc/notice` —— 请求写一条 system 条目(transcript 监听);
|
|
10
|
+
* - `dsc/session-open` —— 会话已切换(transcript 清空条目、agent 换会话);
|
|
11
|
+
* - `dsc/exit` —— 请求收尾(session close、approval 放行挂起、UI unmount),
|
|
12
|
+
* 监听器同步执行,随后宿主自行决定是否退进程。
|
|
13
|
+
*
|
|
14
|
+
* @module dsc/services
|
|
15
|
+
*/
|
|
16
|
+
import type { ApprovalDecision, ApprovalHandler, ApprovalRequest } from '../core/approval.js';
|
|
17
|
+
import type { AuditRecord } from '../core/audit.js';
|
|
18
|
+
import type { HookJudgement, HooksDoc, HookTrust } from '../core/hooks.js';
|
|
19
|
+
import type { HostBrowserLink } from '../core/host-browser-link.js';
|
|
20
|
+
import type { MemoryCell, MemoryConfig, MemoryOperation, MemoryTarget, MemoryWriteResult, WriteOptions } from '../core/memory.js';
|
|
21
|
+
import type { ProviderConfig } from '../core/config.js';
|
|
22
|
+
import type { Session, InboxOrigin } from '../core/session.js';
|
|
23
|
+
import type { ChatMessage, LlmAdapter, LlmRoute, StreamHandlers, StreamRequest, StreamResult } from '../core/llm.js';
|
|
24
|
+
import type { FileChangeSummary, ToolEntry } from '../core/tools.js';
|
|
25
|
+
import type { CoreEvent } from '../core/events.js';
|
|
26
|
+
import type { SkillDefinition, SkillSummary } from '../core/skills.js';
|
|
27
|
+
import type { DscPrefs } from '../core/prefs.js';
|
|
28
|
+
import type { ToolGuard, ToolGuardChain, ToolObserver } from '../core/tool-guards.js';
|
|
29
|
+
import type { GoalStore } from '../core/goal.js';
|
|
30
|
+
import type { PromptContribution } from '../core/prompt.js';
|
|
31
|
+
import type { TodoWriteResult } from '../core/todo.js';
|
|
32
|
+
import type { ApprovalAnswer, ApprovalPolicy, ApprovalRequestView, ApprovalReviewer, ArchivedPage, AskQuestionItem, AskUserView, AskUserViewInput, BackgroundOutputView, CollaborationMode, ConnectionTestView, DscRuntime, EffortLevel, GitSurface, GoalView, MarketBrowseResult, MarketSkillView, ModelChoiceView, ModelConfigView, Modality, ModeSurface, PlanDecision, PlanView, PermissionPresetSurface, PolicySurface, PresetDraft, PresetSurface, ProviderDraft, RuntimeSnapshot, RuntimeSurfaces, TeammateView, TodoView, TranscriptEntry, SessionForkResult, SessionSummary, SettingsField, SettingsGroupView, SettingsMutation, SettingsMutationOk, SettingsSectionView, SettingsValue, SettingsValues, SkillInfoView, SkillLoadResult } from '../contract.js';
|
|
33
|
+
/** 服务方法允许同步或异步返回(插件提供方常要联网)。 */
|
|
34
|
+
export type MaybePromise<T> = T | Promise<T>;
|
|
35
|
+
/** 会话切换事件负载。 */
|
|
36
|
+
export interface SessionOpenPayload {
|
|
37
|
+
/** 新会话实例。 */
|
|
38
|
+
session: Session;
|
|
39
|
+
/** undefined = 新建;否则为恢复的 jsonl 路径。 */
|
|
40
|
+
filePath: string | undefined;
|
|
41
|
+
}
|
|
42
|
+
/** 回合事件的会话归属(0.6.48):turn-start / turn-end 的第二参数。 */
|
|
43
|
+
export interface TurnSignal {
|
|
44
|
+
/** 发起回合的会话(meta.id)。 */
|
|
45
|
+
sessionId: string;
|
|
46
|
+
/** 同一会话的 jsonl 路径(快照 sessionStates 的键口径)。 */
|
|
47
|
+
sessionPath: string;
|
|
48
|
+
}
|
|
49
|
+
/** 跨会话运行状态的变化(0.6.48,dsc/agent-status 的负载)。 */
|
|
50
|
+
export interface AgentStatusPayload {
|
|
51
|
+
sessionId: string;
|
|
52
|
+
/** 会话 jsonl 路径(侧栏行的 id)。 */
|
|
53
|
+
path: string;
|
|
54
|
+
state: 'working' | 'awaiting-approval' | 'idle';
|
|
55
|
+
}
|
|
56
|
+
/** 每次请求的模型路由(定义在 core/llm,这里转出口供插件引用;文件头已同时引入本地绑定)。 */
|
|
57
|
+
export type { LlmRoute } from '../core/llm.js';
|
|
58
|
+
/** 模型端点路由服务(provider/model 热切换的唯一状态持有者)。 */
|
|
59
|
+
export interface LlmService {
|
|
60
|
+
/** 当前端点名。 */
|
|
61
|
+
get provider(): string;
|
|
62
|
+
/** 当前模型名。 */
|
|
63
|
+
get model(): string;
|
|
64
|
+
/** 当前思考强度档位;'default' = 不声明 thinking 字段(跟随端点默认)。 */
|
|
65
|
+
get effort(): EffortLevel;
|
|
66
|
+
/** 当前模型上下文窗口(未知模型按 128k)。 */
|
|
67
|
+
get contextWindow(): number;
|
|
68
|
+
/** 当前模型声明的输入模态(没勾照片时,图像在发请求前换成一句说明)。 */
|
|
69
|
+
get inputModalities(): Modality[];
|
|
70
|
+
/** 组装当前路由;端点缺失时抛错(调用方负责转 system 条目)。 */
|
|
71
|
+
route(): LlmRoute;
|
|
72
|
+
/**
|
|
73
|
+
* 按指定端点/模型/思考强度组路由,不改动当前选择。
|
|
74
|
+
* 子智能体用它跑角色自己指定的模型;端点或模型不存在时抛错。
|
|
75
|
+
*/
|
|
76
|
+
routeTo(provider: string, model: string, effort: EffortLevel): LlmRoute;
|
|
77
|
+
/**
|
|
78
|
+
* 注册一个模型协议适配器;端点在 config.yaml 里用 `api: <id>` 选择它。
|
|
79
|
+
* 重复 id 抛错(装配错误不许静默顶替);返回卸载函数,插件卸载时一并撤销。
|
|
80
|
+
*/
|
|
81
|
+
registerAdapter(adapter: LlmAdapter): () => void;
|
|
82
|
+
/**
|
|
83
|
+
* 经适配器发一次流式请求。`api` 没有对应的已注册适配器时抛错
|
|
84
|
+
* (消息可直接展示:多半是端点的 api 字段写错或提供它的插件没开)。
|
|
85
|
+
*/
|
|
86
|
+
stream(api: string, request: StreamRequest, handlers: StreamHandlers): Promise<StreamResult>;
|
|
87
|
+
/** 校验并切换端点/模型;失败抛错(消息可直接展示)。 */
|
|
88
|
+
setModel(provider: string, model: string): void;
|
|
89
|
+
/**
|
|
90
|
+
* 解析「[端点/]模型」引用:端点名做**最长前缀匹配**——模型 id 自己可能带斜杠
|
|
91
|
+
* (如 command 端点的 `deepseek/deepseek-v4.1-flash`),按首个斜杠切会把模型名切碎。
|
|
92
|
+
* 没带已知端点前缀时整串当当前端点的模型名(/model 直接打模型名的用法)。
|
|
93
|
+
*/
|
|
94
|
+
parseModelRef(ref: string): {
|
|
95
|
+
provider: string;
|
|
96
|
+
model: string;
|
|
97
|
+
};
|
|
98
|
+
/**
|
|
99
|
+
* 设置思考强度档位(off=关闭思考,low/high/max=开启思考)。
|
|
100
|
+
* 当前模型没声明这一档时抛错(消息可直接展示),越界的旧档位会随模型切换退回「默认」。
|
|
101
|
+
*/
|
|
102
|
+
setEffort(effort: EffortLevel): void;
|
|
103
|
+
/** 可切换模型列表(/model 补全与校验数据源)。 */
|
|
104
|
+
listModels(): ModelChoiceView[];
|
|
105
|
+
}
|
|
106
|
+
/** 会话服务:当前会话持有者 + 列表缓存(快照的 sessions 字段来源)。 */
|
|
107
|
+
export interface SessionService {
|
|
108
|
+
current(): Session;
|
|
109
|
+
/**
|
|
110
|
+
* 新建(undefined)或恢复指定 jsonl;成功后发出 dsc/session-open。
|
|
111
|
+
*
|
|
112
|
+
* @param filePath - 要恢复的会话 jsonl;省略 = 新建(此时才看 `cwd`)。
|
|
113
|
+
* @param cwd - 新会话的工作目录(绝对路径,必须存在且是目录)。省略时按
|
|
114
|
+
* 「当前会话的目录 → 宿主启动目录」兜底。目录是**会话自己的数据**
|
|
115
|
+
* (写进 jsonl 的 meta 行),不是进程状态——所以在这里指定目录
|
|
116
|
+
* 不需要重启宿主。给了 `filePath` 时这一项无意义(会话的目录
|
|
117
|
+
* 是它出生时写下的),忽略。
|
|
118
|
+
* @throws 目录不可用(不是绝对路径 / 不存在 / 不是目录)时抛错,界面据此提示。
|
|
119
|
+
*/
|
|
120
|
+
open(filePath?: string, cwd?: string): Promise<void>;
|
|
121
|
+
/** refresh() 填充的会话列表缓存。 */
|
|
122
|
+
readonly sessions: SessionSummary[];
|
|
123
|
+
readonly loading: boolean;
|
|
124
|
+
/** 启动时是否成功恢复了历史会话(宿主据此重放历史到 transcript)。 */
|
|
125
|
+
readonly resumedStartup: boolean;
|
|
126
|
+
/** 异步刷新会话列表缓存。 */
|
|
127
|
+
refresh(): Promise<void>;
|
|
128
|
+
/** 启动期一次性提示(如恢复失败回退),由宿主在就绪后转 system 条目。 */
|
|
129
|
+
readonly startupNote: string | null;
|
|
130
|
+
/** 归档一批会话(移进归档区);当前打开的会话拒绝归档;常驻 agent 先收摊再挪文件。 */
|
|
131
|
+
archive(paths: string[]): Promise<SettingsMutation>;
|
|
132
|
+
/** 归档页数据(设置 → 归档的数据源)。 */
|
|
133
|
+
archived(): ArchivedPage;
|
|
134
|
+
/** 从归档区恢复一批会话。 */
|
|
135
|
+
restore(paths: string[]): SettingsMutation;
|
|
136
|
+
/** 永久删除一批会话(移进回收站,30 天后清)。 */
|
|
137
|
+
purge(paths: string[]): SettingsMutation;
|
|
138
|
+
/** 改会话显示名(写 meta.json,不动 jsonl)。 */
|
|
139
|
+
rename(path: string, title: string): SettingsMutation;
|
|
140
|
+
/** 置顶或取消置顶一个会话。 */
|
|
141
|
+
setPinned(path: string, pinned: boolean): SettingsMutation;
|
|
142
|
+
/** 一个会话里的用户消息清单(数组下标即分叉位置)。 */
|
|
143
|
+
userMessages(path: string): string[];
|
|
144
|
+
/** 分叉会话:复制到第 index 条用户消息之前,成功时给新会话路径。 */
|
|
145
|
+
fork(path: string, index: number): SessionForkResult;
|
|
146
|
+
}
|
|
147
|
+
/** 审批服务:权限模式状态机(沙箱强制层)+ 工具执行的挂起 Promise ↔ UI 审批卡。 */
|
|
148
|
+
export interface ApprovalService extends ApprovalHandler {
|
|
149
|
+
/** 当前权限模式(决定自动放行集)。 */
|
|
150
|
+
readonly policy: ApprovalPolicy;
|
|
151
|
+
/** 当前审阅者(决定「要问的事」先给谁看)。 */
|
|
152
|
+
readonly reviewer: ApprovalReviewer;
|
|
153
|
+
/** 权限投影(当前档 + 可切清单 + 当前审阅者 + 可切清单),界面画按钮的数据源。 */
|
|
154
|
+
surface(): PolicySurface;
|
|
155
|
+
/** 切换权限模式(写 system 条目告知模型与用户)。 */
|
|
156
|
+
setPolicy(policy: ApprovalPolicy): void;
|
|
157
|
+
/** 切换审阅者(同上;`auto-review` = 先给模型判官,判不出来仍会问人)。 */
|
|
158
|
+
setReviewer(reviewer: ApprovalReviewer): void;
|
|
159
|
+
/** 当前查看会话挂起的审批视图(0.6.50 起只给本会话的卡,后台会话的卡不跨界);null = 无。 */
|
|
160
|
+
pendingView(): ApprovalRequestView | null;
|
|
161
|
+
/** 这个会话现在有没有挂着审批卡(agent 切走时重发侧栏状态点用)。 */
|
|
162
|
+
pendingFor(filePath: string): boolean;
|
|
163
|
+
/**
|
|
164
|
+
* 应答当前挂起审批(无挂起时静默忽略)。
|
|
165
|
+
* @param source - 这个答案从哪儿来:省略 = 宿主界面(桌面端 / 终端),
|
|
166
|
+
* `'web'` = 手机浏览器(远程控制)。它只进审计记录。
|
|
167
|
+
*/
|
|
168
|
+
answer(answer: ApprovalAnswer, source?: 'app' | 'web'): void;
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* 安全钩子服务:规则与脚本的清单、脚本批准状态、命中历史。
|
|
172
|
+
* 拦与问的动作发生在守卫链里(这个服务不负责裁决),它负责让界面与 `/hooks` 看得见现状。
|
|
173
|
+
*/
|
|
174
|
+
export interface HookService {
|
|
175
|
+
/** 当前配置(含读配置时发现的毛病)。 */
|
|
176
|
+
doc(): HooksDoc;
|
|
177
|
+
/** 一条脚本的批准状态与「现在到底能不能跑」;找不到这条脚本返回 null。 */
|
|
178
|
+
trustOf(id: string): HookTrust | null;
|
|
179
|
+
/** 只看规则会命中什么(不跑脚本),给 `/hooks` 与自检用。 */
|
|
180
|
+
previewRules(input: {
|
|
181
|
+
toolName: string;
|
|
182
|
+
command?: string;
|
|
183
|
+
target?: string;
|
|
184
|
+
args?: Record<string, unknown>;
|
|
185
|
+
}): HookJudgement[];
|
|
186
|
+
/** 最近若干条钩子命中记录(新的在前,从 `~/.dsc/audit.jsonl` 里挑)。 */
|
|
187
|
+
recent(limit?: number): AuditRecord[];
|
|
188
|
+
}
|
|
189
|
+
/**
|
|
190
|
+
* 长期记忆服务:三格清单的现状、写入入口、注入系统提示的那一栏。
|
|
191
|
+
* 存储本体在 `~/.dsc/memory/`,这个服务负责让界面与 `/memory` 看得见现状。
|
|
192
|
+
*/
|
|
193
|
+
export interface MemoryService {
|
|
194
|
+
/** 三格现状(含额度用量与「被外面改过」的提示)。不传 cwd 就用当前会话的工作目录。 */
|
|
195
|
+
cells(cwd?: string): MemoryCell[];
|
|
196
|
+
/** 当前生效的可调值。 */
|
|
197
|
+
config(): MemoryConfig;
|
|
198
|
+
/** 写一批操作(设置页的按钮也走这条路,安检与额度一道不少)。 */
|
|
199
|
+
write(operations: readonly MemoryOperation[], cwd?: string, options?: WriteOptions): MemoryWriteResult;
|
|
200
|
+
/** 现在注入系统提示的那一栏(可能为空串)。 */
|
|
201
|
+
snapshot(): string;
|
|
202
|
+
/** 重算一份快照:新会话与压缩会自动做,这里留一个人工入口。 */
|
|
203
|
+
refresh(): string;
|
|
204
|
+
/**
|
|
205
|
+
* 保守整理:把「从没被引用过、且已经陈旧」的条目移进同目录的 `.archive.md`(只移不删)。
|
|
206
|
+
* 不传 target 就整理全部启用的格子。返回给用户看的一句话(没有可整理的也要说清)。
|
|
207
|
+
*/
|
|
208
|
+
prune(target?: MemoryTarget): string;
|
|
209
|
+
}
|
|
210
|
+
/**
|
|
211
|
+
* 协作模式服务:模式状态 + 注册进守卫链的那一道闸门。
|
|
212
|
+
* 模式只管「这一轮允许把手伸多远」,权限模式管「问出来之后怎么裁」,两者互不越界。
|
|
213
|
+
*/
|
|
214
|
+
export interface ModeService {
|
|
215
|
+
/** 当前模式(执行 / 计划 / 探索 / 免打扰)。 */
|
|
216
|
+
readonly mode: CollaborationMode;
|
|
217
|
+
/** 协作模式投影(当前档 + 可切清单),界面画档位按钮的数据源。 */
|
|
218
|
+
surface(): ModeSurface;
|
|
219
|
+
/** 切换模式:写会话记录(恢复会话时能还原)并广播快照失效。 */
|
|
220
|
+
setMode(mode: CollaborationMode): void;
|
|
221
|
+
}
|
|
222
|
+
/**
|
|
223
|
+
* 模式服务(presets 插件):一个模式就是 `~/.dsc/presets/<名字>.md` 一个文件,
|
|
224
|
+
* 管「模型是谁、手上有什么、被叮嘱了什么」。
|
|
225
|
+
*
|
|
226
|
+
* 与协作模式是两根独立旋钮:协作模式决定这一轮允许把手伸多远(工具闸门),
|
|
227
|
+
* 模式决定模型看见什么(提示词 + 工具目录 + 骨架取舍)。模式只做减法,
|
|
228
|
+
* 任何模式都放宽不了安全——审批硬地板与守卫链不看模式。
|
|
229
|
+
*/
|
|
230
|
+
export interface PresetService {
|
|
231
|
+
/** 当前会话用的模式名。 */
|
|
232
|
+
readonly name: string;
|
|
233
|
+
/** 新会话默认用的模式名(读偏好,认不出就回落标准档)。 */
|
|
234
|
+
readonly defaultName: string;
|
|
235
|
+
/** 模式投影(当前 + 默认 + 全部可选),界面画卡片与旋钮的数据源。 */
|
|
236
|
+
surface(): PresetSurface;
|
|
237
|
+
/** 切换当前会话的模式:写会话记录(恢复会话时能还原)并广播快照失效。
|
|
238
|
+
* 返回给用户看的一句话;名字不存在就抛错。 */
|
|
239
|
+
use(name: string): string;
|
|
240
|
+
/** 读一个模式的原文(「查看配置」只读用);不存在就抛错。 */
|
|
241
|
+
read(name: string): string;
|
|
242
|
+
/** 新建或覆盖一个模式,返回给用户看的一句话。 */
|
|
243
|
+
save(draft: PresetDraft): string;
|
|
244
|
+
/** 删掉一个自定义模式(内置四个删不掉),返回给用户看的一句话。 */
|
|
245
|
+
remove(name: string): string;
|
|
246
|
+
/** 设为新会话默认模式,返回给用户看的一句话。 */
|
|
247
|
+
setDefault(name: string): string;
|
|
248
|
+
}
|
|
249
|
+
/**
|
|
250
|
+
* 打包权限预设(把沙箱档位、权限模式、审阅者捆成一颗按钮)。
|
|
251
|
+
*
|
|
252
|
+
* 只做组合:写口只调 `sandbox.setMode` 与 `approval.setPolicy/setReviewer`,
|
|
253
|
+
* 自己不认识任何执行策略——所以「预设放宽不了安全」是结构上成立的。
|
|
254
|
+
*/
|
|
255
|
+
export interface PermissionPresetService {
|
|
256
|
+
/** 现在生效的预设名;三项拼不出预设时是 `custom`(推导状态,选不了)。 */
|
|
257
|
+
readonly name: string;
|
|
258
|
+
/** 新会话默认的预设名。 */
|
|
259
|
+
readonly defaultName: string;
|
|
260
|
+
/** 预设投影(当前 + 默认 + 全部可选),界面画那颗旋钮的数据源。 */
|
|
261
|
+
surface(): PermissionPresetSurface;
|
|
262
|
+
/** 切到某个预设:只写实际不同的旋钮,返回给用户看的一句话;名字不存在就抛错。 */
|
|
263
|
+
use(name: string): string;
|
|
264
|
+
/** 设为新会话默认预设(空串 = 清掉),返回给用户看的一句话。 */
|
|
265
|
+
setDefault(name: string): string;
|
|
266
|
+
}
|
|
267
|
+
/**
|
|
268
|
+
* 任务面服务(todo_write 那一块):模型自己维护、界面实时显示的清单。
|
|
269
|
+
* 计划、目标、提问各自是另一个功能点,各自的插件提供各自的服务。
|
|
270
|
+
*/
|
|
271
|
+
export interface TodoService {
|
|
272
|
+
/** 任务清单投影(输入框上方那条清单条的数据源)。 */
|
|
273
|
+
todoView(): TodoView;
|
|
274
|
+
/** 写入任务清单(整表替换或按 id 合并),同时落会话记录。 */
|
|
275
|
+
writeTodos(todos: readonly unknown[], merge: boolean): TodoWriteResult;
|
|
276
|
+
/** 清空任务清单(用户手动清)。 */
|
|
277
|
+
clearTodos(): void;
|
|
278
|
+
/** 任务清单的提示词投影(压缩后重新注入用;空清单返回空串)。 */
|
|
279
|
+
todoPrompt(): string;
|
|
280
|
+
}
|
|
281
|
+
/** 计划交付服务(exit_plan_mode 那一块):写计划文件 + 弹评审卡等用户批。 */
|
|
282
|
+
export interface PlanService {
|
|
283
|
+
/** 挂着等批的计划;null = 无。 */
|
|
284
|
+
pendingPlan(): PlanView | null;
|
|
285
|
+
/** 交一份计划等用户批(挂起直到批准/拒绝/中断)。 */
|
|
286
|
+
proposePlan(plan: {
|
|
287
|
+
file: string;
|
|
288
|
+
title: string;
|
|
289
|
+
text: string;
|
|
290
|
+
}, signal: AbortSignal): Promise<PlanDecision>;
|
|
291
|
+
/** 回答挂起的计划评审卡;拒绝时可附反馈原话(经 exit_plan_mode 的结果捎给模型)。 */
|
|
292
|
+
answerPlan(decision: PlanDecision, feedback?: string): void;
|
|
293
|
+
}
|
|
294
|
+
/** 模型提问服务(ask_user 那一块):一次提问最多几个问题、每项几个选项由插件配置决定。 */
|
|
295
|
+
export interface AskService {
|
|
296
|
+
/** 挂着等答的提问;null = 无。多题提问整批挂在这里,视图自己带 `questions` 数组。 */
|
|
297
|
+
pendingQuestion(): AskUserView | null;
|
|
298
|
+
/** 模型向用户提一个问题(挂起直到有答案或中断)。 */
|
|
299
|
+
ask(question: AskUserViewInput, signal: AbortSignal, sessionPath?: string): Promise<string>;
|
|
300
|
+
/**
|
|
301
|
+
* 模型一次问一批(挂起直到全部答完/跳过,或中断);返回的答案按题序与入参一一对应。
|
|
302
|
+
*
|
|
303
|
+
* 界面在这一批上逐题作答、统一提交,每次 `answerQuestion` 收下当前这一题的答案,
|
|
304
|
+
* 收齐整批才让这个 Promise 落地——所以模型看到的是「一次调用拿回全部答案」。
|
|
305
|
+
* @param sessionPath - 提问会话的 jsonl 路径(0.6.49):卡跟自己的会话走,缺省按当前会话。
|
|
306
|
+
*/
|
|
307
|
+
askMany(questions: readonly AskQuestionItem[], signal: AbortSignal, sessionPath?: string): Promise<string[]>;
|
|
308
|
+
/** 回答挂起的提问:第 1 次调用解决第 1 题,第 2 次解决第 2 题…… */
|
|
309
|
+
answerQuestion(answer: string): void;
|
|
310
|
+
}
|
|
311
|
+
/** 会话目标服务(goal 那一块):跨轮自动续跑与它的刹车。 */
|
|
312
|
+
export interface GoalService {
|
|
313
|
+
/** 会话目标投影;null = 没设目标。 */
|
|
314
|
+
goalView(): GoalView | null;
|
|
315
|
+
/** 目标存储(goal 工具与自动续跑驱动器共用)。 */
|
|
316
|
+
readonly goals: GoalStore;
|
|
317
|
+
/** 用户侧目标动作(暂停 / 继续 / 清空 / 放宽轮次上限)。 */
|
|
318
|
+
goalAction(action: 'pause' | 'resume' | 'clear' | 'extend'): SettingsMutation;
|
|
319
|
+
/**
|
|
320
|
+
* 自动续跑驱动器向目标要一轮:目标 active 且已上膛时把轮次 +1 并返回要补发给模型的话。
|
|
321
|
+
* 只要还有卡片在等用户做决定,或轮次跑到上限,就返回 null(不隔着一张卡硬推)。
|
|
322
|
+
*/
|
|
323
|
+
takeGoalRound(): string | null;
|
|
324
|
+
}
|
|
325
|
+
/**
|
|
326
|
+
* 工具守卫链服务(内核 API v4):一次工具调用动手之前该问谁。
|
|
327
|
+
* 模式注册 order 10 的那一位,审批注册 order 30 的那一位;循环只问结果。
|
|
328
|
+
*/
|
|
329
|
+
export interface GuardService extends ToolGuardChain {
|
|
330
|
+
/** 注册一位守卫;返回退订函数。同 id 后注册者顶掉先注册者。 */
|
|
331
|
+
register(guard: ToolGuard): () => void;
|
|
332
|
+
/** 注册一位工具结果加工者(遮红是内置唯一一位);返回退订函数。 */
|
|
333
|
+
registerObserver(observer: ToolObserver): () => void;
|
|
334
|
+
/** 当前链上的守卫(按询问顺序,自检与诊断用)。 */
|
|
335
|
+
readonly chain: ToolGuard[];
|
|
336
|
+
}
|
|
337
|
+
/**
|
|
338
|
+
* 快照片段注册表服务(内核 API v4):界面快照里每一块状态投影由功能点自己登记。
|
|
339
|
+
* 装配快照的那一层因此不认识任何具体功能。
|
|
340
|
+
*/
|
|
341
|
+
export interface SurfaceService {
|
|
342
|
+
/**
|
|
343
|
+
* 登记一片投影。
|
|
344
|
+
* @param id - 界面读取时用的键(同时是 RuntimeSurfaces 的那个键)。
|
|
345
|
+
* @param read - 每次装配快照时调用,所以功能点改内容不用通知谁。
|
|
346
|
+
* @returns 退订函数。
|
|
347
|
+
*/
|
|
348
|
+
register<K extends keyof RuntimeSurfaces>(id: K, read: () => RuntimeSurfaces[K]): () => void;
|
|
349
|
+
/** 装配当前全部投影(界面快照的 surfaces 字段就是它的返回值)。 */
|
|
350
|
+
build(): RuntimeSurfaces;
|
|
351
|
+
/** 已登记的片段键(按登记顺序,自检与诊断用)。 */
|
|
352
|
+
readonly ids: string[];
|
|
353
|
+
}
|
|
354
|
+
/**
|
|
355
|
+
* 「正在等人」登记表(内核 API v4):审批卡、计划卡、提问卡各登记一位。
|
|
356
|
+
* 谁想自动往下推(例如目标续跑),先问这里有没有人挂着,不必认识每张卡。
|
|
357
|
+
*/
|
|
358
|
+
export interface WaitingService {
|
|
359
|
+
/** 登记一位正在等用户做决定的卡片;返回退订函数。 */
|
|
360
|
+
register(id: string, pending: () => boolean): () => void;
|
|
361
|
+
/** 当前有哪些卡片在等人(按登记顺序)。 */
|
|
362
|
+
readonly ids: string[];
|
|
363
|
+
/** 是否有任何卡片在等人。 */
|
|
364
|
+
readonly any: boolean;
|
|
365
|
+
}
|
|
366
|
+
/** 工具注册表服务:外部插件注入新工具的唯一入口。 */
|
|
367
|
+
export interface ToolService {
|
|
368
|
+
/** 注册一个工具;返回退订函数。 */
|
|
369
|
+
register(entry: ToolEntry): () => void;
|
|
370
|
+
/** 全量目录(队友按工牌从它里面挑;界面、工具检索、守卫链也读它)。 */
|
|
371
|
+
list(): ToolEntry[];
|
|
372
|
+
/**
|
|
373
|
+
* 注册一个「主会话目录投影」(内核 API v5):入参是当前目录,返回要递给模型的那份。
|
|
374
|
+
*
|
|
375
|
+
* 只做减法——返回的必须是入参的子集,别用它凭空造工具:模型能调用的名字必须真的
|
|
376
|
+
* 在注册表里,否则守卫链按名字找不到它,审计也就无从谈起。
|
|
377
|
+
* @param id - 投影名(宿主日志与诊断用)。
|
|
378
|
+
* @returns 退订函数。
|
|
379
|
+
*/
|
|
380
|
+
project(id: string, fn: (tools: readonly ToolEntry[]) => readonly ToolEntry[]): () => void;
|
|
381
|
+
/**
|
|
382
|
+
* 主会话要发给模型的那份目录(过一遍全部投影,按注册顺序)。
|
|
383
|
+
* 只有 agent 循环读它;队友、界面、工具检索一律走 {@link list}。
|
|
384
|
+
*/
|
|
385
|
+
visible(): ToolEntry[];
|
|
386
|
+
}
|
|
387
|
+
/** 斜杠命令元数据。 */
|
|
388
|
+
export interface CommandSpec {
|
|
389
|
+
name: string;
|
|
390
|
+
/** 参数占位提示(空 = 无参数)。 */
|
|
391
|
+
args: string;
|
|
392
|
+
description: string;
|
|
393
|
+
/**
|
|
394
|
+
* T44:回合跑着的时候还能不能用(codex slash_command 的 available_during_task 矩阵)。
|
|
395
|
+
* 缺省 'allow'(外部命令不知道自己安不安全,按可用处理);内置表逐条声明。
|
|
396
|
+
* 派发时统一查这一位——桌面 / TUI / 远端从同一个闸过,不再各防各的。
|
|
397
|
+
*/
|
|
398
|
+
duringTask?: 'allow' | 'deny';
|
|
399
|
+
/**
|
|
400
|
+
* 壳(桌面 / 手机那份插件化界面)的 `/` 菜单里列不列、能不能执行。
|
|
401
|
+
*
|
|
402
|
+
* 缺省 false 是**失败关闭**:外部插件注册的命令默认不进界面菜单,内置表里逐条标过才
|
|
403
|
+
* 放行(清单与理由在 `core/commands-completion.ts`)。界面通道(`core/ui-methods.ts`)
|
|
404
|
+
* 要的正是这一位:`runUiCommand` 只派发标了它的命令。
|
|
405
|
+
*/
|
|
406
|
+
shell?: boolean;
|
|
407
|
+
}
|
|
408
|
+
/** 补全面板的一项(命令候选与模型候选共用)。 */
|
|
409
|
+
export interface CompletionItem {
|
|
410
|
+
/** Tab 补全时填入输入框的完整文本。 */
|
|
411
|
+
insert: string;
|
|
412
|
+
label: string;
|
|
413
|
+
description: string;
|
|
414
|
+
}
|
|
415
|
+
/** 命令执行期 UI 回调。 */
|
|
416
|
+
export interface CommandContext {
|
|
417
|
+
openPicker(): void;
|
|
418
|
+
/** 打开模型选择面板(/model 无参数时;桌面端可映射到自己的模型面板,无可忽略)。 */
|
|
419
|
+
openModels(): void;
|
|
420
|
+
/**
|
|
421
|
+
* 打开子代理总览(/agents)。可选:桌面端可以映射到自己的面板,暂未接的端
|
|
422
|
+
* 忽略该回调(命令本身仍注册,/help 里可见)。
|
|
423
|
+
*/
|
|
424
|
+
openAgents?(): void;
|
|
425
|
+
/**
|
|
426
|
+
* 打开设置页(/settings)。可选:桌面端映射到自己的设置窗口,暂未接的端
|
|
427
|
+
* 忽略该回调(命令本身仍注册,/help 里可见)。
|
|
428
|
+
*/
|
|
429
|
+
openSettings?(): void;
|
|
430
|
+
/**
|
|
431
|
+
* 打开模式选择浮层(/preset 无参数时)。可选:暂未接的端忽略——裸命令保持
|
|
432
|
+
* 「notice 当前模式 + 可选清单」的旧行为(桌面端有自己的设置 → 模式页)。
|
|
433
|
+
*/
|
|
434
|
+
openPresets?(): void;
|
|
435
|
+
/**
|
|
436
|
+
* 打开技能选择浮层(/skills 无参数时)。可选:暂未接的端忽略——裸命令保持
|
|
437
|
+
* notice 清单的旧行为(桌面端有自己的技能中心页)。
|
|
438
|
+
*/
|
|
439
|
+
openSkills?(): void;
|
|
440
|
+
/**
|
|
441
|
+
* 切换思考块的展开显示(/thinking;缺省参数 = 翻转,传值为显式设置)。
|
|
442
|
+
* 可选:会话内没有思考块可折的端忽略(此时命令报「当前界面不支持」)。
|
|
443
|
+
*/
|
|
444
|
+
toggleThinking?(visible?: boolean): void;
|
|
445
|
+
notice(text: string): void;
|
|
446
|
+
}
|
|
447
|
+
/** 命令处理器入参。 */
|
|
448
|
+
export interface CommandInvocation {
|
|
449
|
+
args: string[];
|
|
450
|
+
runtime: DscRuntime;
|
|
451
|
+
ui: CommandContext;
|
|
452
|
+
}
|
|
453
|
+
export type CommandHandler = (invocation: CommandInvocation) => void;
|
|
454
|
+
/** 命令注册表服务:内置与外部命令的单一真源。 */
|
|
455
|
+
export interface CommandService {
|
|
456
|
+
/** 注册一条命令;返回退订函数。同名注册覆盖旧项。 */
|
|
457
|
+
register(spec: CommandSpec, handler: CommandHandler): () => void;
|
|
458
|
+
/** 全部已注册命令(/help 与补全数据源)。 */
|
|
459
|
+
specs(): CommandSpec[];
|
|
460
|
+
/**
|
|
461
|
+
* 执行一条 `/...` 输入;参数错误经 notice 反馈。
|
|
462
|
+
* @returns 输入是否为命令(false = 普通消息)。
|
|
463
|
+
*/
|
|
464
|
+
run(input: string, runtime: DscRuntime, ui: CommandContext): boolean;
|
|
465
|
+
}
|
|
466
|
+
/** 会话流服务:core 事件折叠器 + RuntimeSnapshot 快照源(UI 状态中心)。 */
|
|
467
|
+
export interface TranscriptService {
|
|
468
|
+
/** 折叠一条 core 事件(可见变化时自动失效快照)。 */
|
|
469
|
+
emit(event: CoreEvent): void;
|
|
470
|
+
/** 追加一条 system 条目。 */
|
|
471
|
+
system(text: string): void;
|
|
472
|
+
/** 追加一条计划卡条目(提交评审与批完各更新一次)。 */
|
|
473
|
+
plan(view: PlanView): void;
|
|
474
|
+
/**
|
|
475
|
+
* 恢复会话时把历史消息重放为条目(启动恢复/session-open 场景)。
|
|
476
|
+
* @param toolErrors 会话日志记的工具异常标记(`Session.toolErrors`),
|
|
477
|
+
* 决定了重放出来的工具卡是「已拒绝」「失败」还是「完成」。
|
|
478
|
+
* @param fileChanges 成功 write / edit 的实际改动(`Session.fileChanges`),
|
|
479
|
+
* 决定轮尾「文件已更改」卡要不要出现。
|
|
480
|
+
*/
|
|
481
|
+
replayHistory(messages: readonly ChatMessage[], toolErrors?: ReadonlyMap<string, string>, fileChanges?: ReadonlyMap<string, FileChangeSummary>): boolean;
|
|
482
|
+
subscribe(listener: () => void): () => void;
|
|
483
|
+
getSnapshot(): RuntimeSnapshot;
|
|
484
|
+
/** 手动失效快照缓存并通知订阅者。 */
|
|
485
|
+
touch(): void;
|
|
486
|
+
}
|
|
487
|
+
/** 上下文压缩服务。 */
|
|
488
|
+
export interface CompactService {
|
|
489
|
+
/**
|
|
490
|
+
* 每轮请求前的自动压缩检查(超阈值时折叠历史)。
|
|
491
|
+
* T41:signal 是调用方那一轮的取消信号——用户打断时压到一半的模型调用跟着停。
|
|
492
|
+
* 0.6.48:target 是发起请求的 agent 自己的会话(常驻多 agent 下不能再看「当前
|
|
493
|
+
* 查看的会话」);缺省按当前会话算。
|
|
494
|
+
*/
|
|
495
|
+
check(signal?: AbortSignal, target?: Session): Promise<void>;
|
|
496
|
+
/** 手动压缩(/compact),结果经 dsc/notice 反馈。回合运行中会被守卫挡下(防落库交错)。 */
|
|
497
|
+
run(): Promise<void>;
|
|
498
|
+
/**
|
|
499
|
+
* 请求报「上下文装不下」时的强制压缩:忽略触发线与「历史太短」检查直接折叠一次。
|
|
500
|
+
* @returns true = 确实压缩了(调用方可以重试请求);false = 没压出空间(原样报错)。
|
|
501
|
+
* T41:signal 是调用方那一轮的取消信号。target 同 check()。
|
|
502
|
+
*/
|
|
503
|
+
forceCompact(signal?: AbortSignal, target?: Session): Promise<boolean>;
|
|
504
|
+
/**
|
|
505
|
+
* 当前压缩口径(/status 展示用):自动压缩触发线百分比与摘要后保留条数。
|
|
506
|
+
* 值现读插件配置,设置页保存后立刻是新值——与 check() 的判定同源。
|
|
507
|
+
*/
|
|
508
|
+
describe(): {
|
|
509
|
+
autoCompactPercent: number;
|
|
510
|
+
keepRecent: number;
|
|
511
|
+
};
|
|
512
|
+
/**
|
|
513
|
+
* 登记一段「摘要之外必须原样带过去」的文本。
|
|
514
|
+
* 任务清单、会话目标这类内容经摘要模型一转就会被改写走样,所以由功能点自己登记原文;
|
|
515
|
+
* 压缩插件因此不认识任何具体功能。
|
|
516
|
+
* @param contribute - 每次压缩时调用,返回要附在摘要后面的文本(空串 = 这次没有)。
|
|
517
|
+
* @returns 退订函数。
|
|
518
|
+
*/
|
|
519
|
+
registerCarry(contribute: () => string): () => void;
|
|
520
|
+
}
|
|
521
|
+
/** Agent 服务:ReAct 循环的对外操作面(0.6.48 起按会话常驻多 agent)。 */
|
|
522
|
+
export interface AgentService {
|
|
523
|
+
/**
|
|
524
|
+
* 提交一条消息(排队执行)。
|
|
525
|
+
* @param images - 随消息发送的图片(data URL 清单)。
|
|
526
|
+
* @param sessionId - 目标会话(meta.id)。缺省投给当前查看的会话;指定时投给那个
|
|
527
|
+
* 会话的常驻 agent(跑动中进收件箱、闲置的唤醒一轮后台回合),没有常驻 agent
|
|
528
|
+
* 就写进会话文件等用户回去再说(不打断也不抢跑)。
|
|
529
|
+
* @param origin - 这条是用户来源还是机器来源(缺省 `'user'`)。只影响回合跑动中入箱
|
|
530
|
+
* 时界面把它画在输入框上方(机器通知)还是下方(用户排队)——见 `InboxOrigin`。
|
|
531
|
+
*/
|
|
532
|
+
followup(text: string, images?: string[], sessionId?: string, origin?: InboxOrigin): void;
|
|
533
|
+
/**
|
|
534
|
+
* 取消在跑的回合。缺省停当前查看的会话;指定 jsonl 路径时停那个**后台**会话
|
|
535
|
+
* (路径语义与 sessionFor/isRunning/stop 一致,侧栏的行标识就是路径)——
|
|
536
|
+
* 挂着的审批卡随信号兜底成 reject,回合以 aborted 收尾。
|
|
537
|
+
*/
|
|
538
|
+
interrupt(filePath?: string): void;
|
|
539
|
+
/**
|
|
540
|
+
* 改一条排队中的输入(当前查看会话的收件箱,界面上的队列条)。0.6.67 起
|
|
541
|
+
* 「入箱」不再当对话条目画,队列条是它的唯一界面,所以这三个动作与
|
|
542
|
+
* {@link followup} 是一套:提交 → 排队 → 编辑 / 删除 / 插话。
|
|
543
|
+
* @returns 是否真的改了;那条已经出账(越界)时返回 false。
|
|
544
|
+
*/
|
|
545
|
+
editQueued(index: number, text: string): boolean;
|
|
546
|
+
/** 撤掉一条排队中的输入。 */
|
|
547
|
+
removeQueued(index: number): boolean;
|
|
548
|
+
/**
|
|
549
|
+
* 插话:把第 index 条提到队首并打断当前回合(收尾出账后它先发)。
|
|
550
|
+
* @param index - 省略则保持原顺序把整队送进去。
|
|
551
|
+
*/
|
|
552
|
+
steerQueued(index?: number): boolean;
|
|
553
|
+
/** 那个会话有没有常驻 agent(生产者决定「投递」还是「写文件等用户回来」)。 */
|
|
554
|
+
hasAgent(sessionId: string): boolean;
|
|
555
|
+
/** 按 jsonl 路径找常驻会话实例(session.open 复用常驻会话、避免重复拿写租约)。 */
|
|
556
|
+
sessionFor(filePath: string): Session | undefined;
|
|
557
|
+
/** 那个会话的常驻 agent 正在跑回合吗(切回运行中会话时转录层补「回合中」状态)。 */
|
|
558
|
+
isRunning(filePath: string): boolean;
|
|
559
|
+
/**
|
|
560
|
+
* 停下并收摊那个会话的常驻 agent(归档/删除工作区的前置动作,对齐 dsh 的
|
|
561
|
+
* stopActivity):排队输入按归档语义丢弃,在跑的回合取消,等完全收摊
|
|
562
|
+
* (注册表移出、写租约释放)才 resolve。没有常驻 agent 就是空操作。
|
|
563
|
+
*/
|
|
564
|
+
stop(filePath: string): Promise<void>;
|
|
565
|
+
}
|
|
566
|
+
/**
|
|
567
|
+
* 请求组装扩展点(内核 API v3):插件往系统提示里加一段话,或者改写要发给
|
|
568
|
+
* 模型的那份消息。两者的注册都返回 disposer,插件卸载即撤销。
|
|
569
|
+
*/
|
|
570
|
+
export interface PromptService {
|
|
571
|
+
/**
|
|
572
|
+
* 注册一段附加系统提示。
|
|
573
|
+
* @param id - 归属键(例如插件名),同名后注册者顶掉先注册的。
|
|
574
|
+
* @param text - 每次组装请求时调用,所以插件改内容不用重启。
|
|
575
|
+
* @param options.order - 段落位置:小的排前面。内置刻度是身份 0、做事方式 10、
|
|
576
|
+
* 工具规范 20、模式条款 30、插件贡献 60(缺省)、指令文件 200、技能目录 210、模型信息 890。
|
|
577
|
+
* 易变的内容请往大数值放,前面的稳定段才能一直命中服务端提示缓存。
|
|
578
|
+
* @param options.block - 归并目标:传 `'agents-md'` 时不单独成段,而是并进
|
|
579
|
+
* `# agentsMd` 块(与 AGENTS.md / CLAUDE.md 同一个块)。长期记忆索引走这条路;
|
|
580
|
+
* 缺省 = 按 order 单独成段。
|
|
581
|
+
*/
|
|
582
|
+
register(id: string, text: () => string, options?: {
|
|
583
|
+
order?: number;
|
|
584
|
+
block?: 'agents-md';
|
|
585
|
+
}): () => void;
|
|
586
|
+
/**
|
|
587
|
+
* 注册一个「骨架取舍」(内核 API v5):拼系统提示时按登记顺序应用,拿到全部候选段的
|
|
588
|
+
* id,返回要留下的那些。模式(presets 插件)用它把「做事方式」这类叮嘱段整段摘掉,
|
|
589
|
+
* 极简档因此只剩一段固定提示词。
|
|
590
|
+
*
|
|
591
|
+
* 一个都不注册时,提示词的段清单与顺序与没有这个扩展点时逐字节一致(默认档的承诺)。
|
|
592
|
+
* 它只影响提示词文本:审批硬地板、命令策略这些代码里的守卫不受它影响。
|
|
593
|
+
*
|
|
594
|
+
* @param id - 过滤器名(诊断与文档用)。
|
|
595
|
+
* @returns 退订函数。
|
|
596
|
+
*/
|
|
597
|
+
registerSkeletonFilter(id: string, fn: (ids: readonly string[]) => readonly string[]): () => void;
|
|
598
|
+
/**
|
|
599
|
+
* 注册一个「模型可见投影」:对发给模型的消息做一次**纯函数**改写——同一输入永远
|
|
600
|
+
* 同一输出、不读不改注册表之外的任何状态。
|
|
601
|
+
*
|
|
602
|
+
* 这是 dsh「Model-visible ⟺ logged」不变量的个人版达成方式:会话日志只存原文,
|
|
603
|
+
* 模型看见什么 = 日志原文按注册序应用全部投影的结果,投影是命名且可复算的定义,
|
|
604
|
+
* 任何人拿日志都能重建请求。往请求里**加**日志上没有的内容(LSP 诊断、钩子话术)
|
|
605
|
+
* 的投影,必须同时用 `session.appendNote` 把加的东西落进日志。
|
|
606
|
+
*
|
|
607
|
+
* @param id - 投影名(诊断与文档用)。`fold-system`、`drop-images` 是内核保留名。
|
|
608
|
+
* @param options.order - 应用次序,小的先做。内置刻度:插件投影 60(缺省)、
|
|
609
|
+
* fold-system 500(多条 system 并进头部一条)、env-facts 600(环境事实快照附在请求末尾)、
|
|
610
|
+
* image-diet 550(历史里太久/太多的图换成占位)、env-facts 600、drop-images 900(模型没勾照片时兜底)。
|
|
611
|
+
*/
|
|
612
|
+
registerProjection(id: string, fn: (messages: ChatMessage[]) => ChatMessage[], options?: {
|
|
613
|
+
order?: number;
|
|
614
|
+
}): () => void;
|
|
615
|
+
/** 已注册段(带顺序),拼提示词时与内核自己的段合并;外部插件一般不必直接调。 */
|
|
616
|
+
sections(): PromptContribution[];
|
|
617
|
+
/**
|
|
618
|
+
* 拼出这一轮要用的完整系统提示词(内置骨架 + 各注册段 + 指令文件 + 技能目录)。
|
|
619
|
+
* 环境事实不在这份提示词里(2026-10-03 起):内核的 env-facts 投影把它作为
|
|
620
|
+
* 请求末尾的 user 快照附上——它每天都会变,放提示词里会把服务端前缀缓存整段打掉。
|
|
621
|
+
* @param cwd - 会话工作目录(决定读哪份 AGENTS.md)。
|
|
622
|
+
*/
|
|
623
|
+
systemPrompt(cwd: string): string;
|
|
624
|
+
/**
|
|
625
|
+
* 按注册序应用全部投影(含内置 fold-system / drop-images),得到真正发给模型的那份消息。
|
|
626
|
+
* 这条链是纯函数管道:日志原文 + 这份定义 = 模型看见的内容。
|
|
627
|
+
* @param messages - 已经拼好系统提示的那份。
|
|
628
|
+
*/
|
|
629
|
+
/**
|
|
630
|
+
* 应用投影链。第二参数是发起请求的会话(0.6.48 常驻多 agent):env-facts 这类
|
|
631
|
+
* 按会话取 cwd 的内置投影靠它取对归属;缺省按当前会话算。
|
|
632
|
+
*/
|
|
633
|
+
rewrite(messages: ChatMessage[], session?: Session): ChatMessage[];
|
|
634
|
+
}
|
|
635
|
+
/**
|
|
636
|
+
* 智能体团队服务:由 subagent 插件提供,插件关着时这个服务不存在(可选属性)。
|
|
637
|
+
* 侧栏的「队友」列表、只读查看与管理动作都走它,UI 因此不必知道队友文件放在哪。
|
|
638
|
+
*/
|
|
639
|
+
export interface TeamService {
|
|
640
|
+
/** 队友清单,含已经收工的(来自 `~/.dsc/team/roster.json`)。 */
|
|
641
|
+
list(): TeammateView[];
|
|
642
|
+
/** 只读重放一个队友的运行记录,返回可渲染的对话条目。 */
|
|
643
|
+
peek(file: string): Promise<TranscriptEntry[]>;
|
|
644
|
+
/**
|
|
645
|
+
* 收掉一个队友(打断当前这一轮并从在场名单里摘掉)。
|
|
646
|
+
* 与 `subagent` 工具的 `stop` 是同一条路:来自用户界面,署名是用户。
|
|
647
|
+
* @returns 给用户看的一句话;名字不存在时这句话就是明确的错误说明(不抛错)。
|
|
648
|
+
*/
|
|
649
|
+
stop(name: string): Promise<string>;
|
|
650
|
+
/**
|
|
651
|
+
* 给队友投一句话(写进它的信箱并叫醒)。与 `subagent` 工具的 `message` 同一条路。
|
|
652
|
+
* @returns 给用户看的一句话;名字不存在或话是空的,这句话就是明确的错误说明(不抛错)。
|
|
653
|
+
*/
|
|
654
|
+
message(name: string, text: string): Promise<string>;
|
|
655
|
+
/**
|
|
656
|
+
* 把一个收工的队友从名册移除,运行记录文件一并删除(它只在名册里可达),
|
|
657
|
+
* 名字随之释放、之后派出的队友可以复用。还在干活的队友不接受移除——先停止。
|
|
658
|
+
* @returns 给用户看的一句话;名字不存在或还在干活,这句话就是明确的错误说明(不抛错)。
|
|
659
|
+
*/
|
|
660
|
+
remove(name: string): Promise<string>;
|
|
661
|
+
}
|
|
662
|
+
/**
|
|
663
|
+
* 只读代码审查通道(T18):由 subagent 插件提供,/review 命令的升级路径。
|
|
664
|
+
* 派出去的队友工牌被强制压到只读交集(工具 = read/glob/grep,审批 = forbid),
|
|
665
|
+
* 与角色文件怎么改无关——审查通道天然安全,不靠配置自觉。
|
|
666
|
+
*/
|
|
667
|
+
export interface ReviewService {
|
|
668
|
+
/**
|
|
669
|
+
* 派一个只读审查队友(后台),审查完成后 findings 以
|
|
670
|
+
* `<review-findings>` 包裹写进发起会话(渲染层解析成卡片;不打断当前会话的模型轮)。
|
|
671
|
+
* @returns ok=false 时 reason 是给用户看的一句话(额度满/角色不可用等),调用方回落。
|
|
672
|
+
*/
|
|
673
|
+
spawn(request: ReviewSpawnRequest): ReviewSpawnResult;
|
|
674
|
+
}
|
|
675
|
+
/** /review 交给审查通道的输入(collectWorkingTree 的产出 + 关注点)。 */
|
|
676
|
+
export interface ReviewSpawnRequest {
|
|
677
|
+
/** `git diff HEAD --no-textconv --no-ext-diff` 的输出(collectWorkingTree 已按预算截断)。 */
|
|
678
|
+
diff: string;
|
|
679
|
+
/** 未跟踪文件名单(diff 里没有,队友自己 read)。 */
|
|
680
|
+
untracked: string[];
|
|
681
|
+
/** 用户写在 /review 后面的关注点;空 = 不限。 */
|
|
682
|
+
focus: string;
|
|
683
|
+
}
|
|
684
|
+
/** 派审查队友的结果:ok=false 时 reason 说明原因并回落主会话轮。 */
|
|
685
|
+
export type ReviewSpawnResult = {
|
|
686
|
+
ok: true;
|
|
687
|
+
name: string;
|
|
688
|
+
} | {
|
|
689
|
+
ok: false;
|
|
690
|
+
reason: string;
|
|
691
|
+
};
|
|
692
|
+
/**
|
|
693
|
+
* 技能提供方:本地目录之外,外部插件也能挂一个技能来源(例如公司内部库)。
|
|
694
|
+
* 返回的条目里 `local: false`,技能中心只展示不提供启停与导入。
|
|
695
|
+
*/
|
|
696
|
+
export interface SkillProvider {
|
|
697
|
+
/** 提供方名字(进 SkillSummary.source,也用于日志)。 */
|
|
698
|
+
readonly name: string;
|
|
699
|
+
/** 重名裁决用的小者赢;内置目录占用 100/200/300/400,插件请用 500+。 */
|
|
700
|
+
readonly rank: number;
|
|
701
|
+
/** 列出可用技能(cwd = 当前会话工作目录,供项目级源使用)。 */
|
|
702
|
+
list(cwd: string): MaybePromise<SkillSummary[]>;
|
|
703
|
+
/** 按名字取正文;不存在返回 undefined。 */
|
|
704
|
+
get(name: string): MaybePromise<SkillDefinition | undefined>;
|
|
705
|
+
}
|
|
706
|
+
/** 技能市场提供方(外部插件可挂自己的源;内置实现见 core/market.ts)。 */
|
|
707
|
+
export interface SkillMarketProvider {
|
|
708
|
+
readonly name: string;
|
|
709
|
+
/** 浏览可安装条目(抛错 = 源不可用,错误原因会显示在技能中心)。 */
|
|
710
|
+
browse(refresh?: boolean): MaybePromise<MarketSkillView[]>;
|
|
711
|
+
/** 安装到 ~/.dsc/skills/,返回一句给用户看的落点说明。 */
|
|
712
|
+
install(name: string): MaybePromise<string>;
|
|
713
|
+
}
|
|
714
|
+
/** 技能服务:发现、启停、正文读取与模型可见目录。 */
|
|
715
|
+
export interface SkillService {
|
|
716
|
+
/** 全部来源合并 + 重名按 rank 裁决 + 启停过滤后的清单(技能中心数据源)。 */
|
|
717
|
+
list(): SkillInfoView[];
|
|
718
|
+
/** 读正文(含被停用的技能,便于技能中心预览)。 */
|
|
719
|
+
read(name: string): Promise<SkillLoadResult>;
|
|
720
|
+
/** 启停一个本地技能(虚拟条目返回错误原因)。 */
|
|
721
|
+
setEnabled(name: string, enabled: boolean): SettingsMutation;
|
|
722
|
+
/** 注册外部技能提供方;返回退订函数。 */
|
|
723
|
+
registerProvider(provider: SkillProvider): () => void;
|
|
724
|
+
/** 注册外部市场源;返回退订函数。 */
|
|
725
|
+
registerMarket(market: SkillMarketProvider): () => void;
|
|
726
|
+
/** 市场浏览(内置源 + 插件注册源)。 */
|
|
727
|
+
browseMarket(source: string, refresh?: boolean): Promise<MarketBrowseResult>;
|
|
728
|
+
/** 市场安装。 */
|
|
729
|
+
installMarketSkill(source: string, name: string): Promise<SettingsMutation>;
|
|
730
|
+
/** 用户级技能目录(技能中心的导入目标)。 */
|
|
731
|
+
readonly userDir: string;
|
|
732
|
+
/**
|
|
733
|
+
* 模型可见目录文本(`<available_skills>` 段)。
|
|
734
|
+
* 无可用技能时返回空串,调用方据此决定是否拼接。
|
|
735
|
+
*/
|
|
736
|
+
catalogText(): string;
|
|
737
|
+
}
|
|
738
|
+
/**
|
|
739
|
+
* 设置分区声明:内置分区与外部插件贡献的分区走同一套注册接口。
|
|
740
|
+
* 字段清单必须可 JSON 序列化——桌面端只渲染声明,插件不提供组件。
|
|
741
|
+
*/
|
|
742
|
+
export interface SettingsSectionSpec {
|
|
743
|
+
/** 分区 id,同时是 UI 的导航键;建议 `<插件名>-<分区名>`。 */
|
|
744
|
+
id: string;
|
|
745
|
+
title: string;
|
|
746
|
+
subtitle?: string;
|
|
747
|
+
/**
|
|
748
|
+
* 分区内的子页分组(dsh 同款):字段声明 `group: <组id>` 归进组里,TUI 根页
|
|
749
|
+
* 只画一行「组标题 … ›」、Enter 进子页才见组内字段,桌面端渲染成组头。
|
|
750
|
+
* 字段 key 与 values/save 链路不因分组改变——组只是展示层的收拢。
|
|
751
|
+
*/
|
|
752
|
+
groups?: SettingsGroupView[];
|
|
753
|
+
/** 导航顺序,小者在前;内置:通用 0、模型 10、技能 20、关于 900。 */
|
|
754
|
+
order?: number;
|
|
755
|
+
/**
|
|
756
|
+
* true = 这块界面由桌面端自己画(结构化数据,通用表单渲染器表达不了),
|
|
757
|
+
* 此时 fields 返回空数组,数据走 SettingsService / SkillService 的专门方法。
|
|
758
|
+
*/
|
|
759
|
+
custom?: boolean;
|
|
760
|
+
/**
|
|
761
|
+
* true = 这个插件代管的分区要进桌面端的设置页(在插件注册时声明,见
|
|
762
|
+
* {@link SettingsService.registerSection} 的第二参)。给的是「内核级功能」:
|
|
763
|
+
* 桌面端设置页只列 `builtin: true` 的分区,而这些功能不属于内核自己注册的那几档。
|
|
764
|
+
* 不声明时插件分区照旧只出现在插件中心那张卡上。
|
|
765
|
+
*/
|
|
766
|
+
inSettings?: boolean;
|
|
767
|
+
/** 分区内的控件清单(值从 values() 取)。 */
|
|
768
|
+
fields(): SettingsField[];
|
|
769
|
+
/** 当前控件值(打开分区时调用)。 */
|
|
770
|
+
values(): MaybePromise<SettingsValues>;
|
|
771
|
+
/**
|
|
772
|
+
* 控件写入;返回字符串 = 失败原因(老契约,校验不过的短报错),
|
|
773
|
+
* 返回 {@link SettingsMutationOk} = 成功(`notice` 是给用户看的回执文案),
|
|
774
|
+
* 返回 void = 成功且无回执,抛错 = 失败原因。
|
|
775
|
+
*/
|
|
776
|
+
save?(key: string, value: SettingsValue): MaybePromise<string | void | SettingsMutationOk>;
|
|
777
|
+
/**
|
|
778
|
+
* 按钮动作;返回字符串 = 完成后的提示文案(变成长在控件下面的一行字),
|
|
779
|
+
* 返回 {@link SettingsMutationOk} = 文案之外再带一份结构化数据给界面(如「连接手机」的
|
|
780
|
+
* 配对码与二维码地址,界面据此弹窗而不是闪一条通知)。
|
|
781
|
+
*/
|
|
782
|
+
action?(name: string): MaybePromise<string | void | SettingsMutationOk>;
|
|
783
|
+
}
|
|
784
|
+
/** 设置服务:分区注册表 + 模型配置读写 + 偏好持久化。 */
|
|
785
|
+
export interface SettingsService {
|
|
786
|
+
/**
|
|
787
|
+
* 注册一个设置分区;返回退订函数。
|
|
788
|
+
* @param options.inSettings - true = 这个插件代管的分区也进桌面端设置页
|
|
789
|
+
* (投影出来的 `builtin` 为 true)。内核级功能(例如远程控制)用它;
|
|
790
|
+
* 普通插件分区不传,仍旧只出现在插件中心那张卡上。
|
|
791
|
+
*/
|
|
792
|
+
registerSection(section: SettingsSectionSpec, options?: {
|
|
793
|
+
inSettings?: boolean;
|
|
794
|
+
}): () => void;
|
|
795
|
+
/** 分区清单(按 order 排序;`builtin` = 内核内置分区,或声明了 inSettings 的插件代管分区)。 */
|
|
796
|
+
sections(): SettingsSectionView[];
|
|
797
|
+
values(id: string): Promise<SettingsValues>;
|
|
798
|
+
/** 写入一个控件;分区不存在或校验失败返回错误原因。 */
|
|
799
|
+
save(id: string, key: string, value: SettingsValue): Promise<SettingsMutation>;
|
|
800
|
+
/** 执行分区按钮。 */
|
|
801
|
+
action(id: string, name: string): Promise<SettingsMutation>;
|
|
802
|
+
/** 模型配置全貌(读 config.yaml,缺 key 的端点也在列表里)。 */
|
|
803
|
+
modelConfig(): ModelConfigView;
|
|
804
|
+
saveProvider(draft: ProviderDraft): SettingsMutation;
|
|
805
|
+
/**
|
|
806
|
+
* 拉一个端点线上可用的模型清单(T23):GET {baseUrl}/models,OpenAI / ollama 形状都认。
|
|
807
|
+
* 端点不存在、连不上或应答认不得时抛错(消息可直接展示)。
|
|
808
|
+
*/
|
|
809
|
+
discoverModels(provider: string): Promise<string[]>;
|
|
810
|
+
/**
|
|
811
|
+
* 测一次端点连接:拿这个端点真发一次最小对话请求(走与正常对话同一条链路)。
|
|
812
|
+
* 端点不存在 / 这个端点还没有模型时抛错;请求本身失败折成 `{ ok: false, error }` 返回。
|
|
813
|
+
*/
|
|
814
|
+
testConnection(provider: string, model?: string): Promise<ConnectionTestView>;
|
|
815
|
+
removeProvider(name: string): SettingsMutation;
|
|
816
|
+
setProviderKey(name: string, apiKey: string | null): SettingsMutation;
|
|
817
|
+
/** 写默认端点/模型,并对当前会话立即生效。 */
|
|
818
|
+
setDefaultModel(provider: string, model: string): SettingsMutation;
|
|
819
|
+
/**
|
|
820
|
+
* 换一份配置文件用(写 settings.json 的 configFile;空串 = 回出厂那份)。
|
|
821
|
+
* 校验不过(不是绝对路径 / 读不了 / 不是能解析的 YAML / 没有 providers)就抛错,不落偏好。
|
|
822
|
+
*/
|
|
823
|
+
setConfigFile(path: string): SettingsMutation;
|
|
824
|
+
/** 界面层偏好。 */
|
|
825
|
+
prefs(): DscPrefs;
|
|
826
|
+
/** 合并写偏好并应用(权限模式/思考强度立即生效,市场源即时生效)。 */
|
|
827
|
+
setPrefs(patch: Partial<DscPrefs>): DscPrefs;
|
|
828
|
+
/**
|
|
829
|
+
* 监听偏好写盘:每次写成功的此刻同步回调,返回退订函数。
|
|
830
|
+
* 用途是远程控制这类「开关一改就要实时起停服务」的功能点,不必去轮询 settings.json。
|
|
831
|
+
*/
|
|
832
|
+
watchPrefs(listener: (prefs: DscPrefs) => void): () => void;
|
|
833
|
+
/** 宿主内核 API 版本(关于分区展示,外部插件兼容性判定的基准)。 */
|
|
834
|
+
readonly kernelApiVersion: number;
|
|
835
|
+
/** dsc 版本号与配置路径(关于分区)。 */
|
|
836
|
+
about(): {
|
|
837
|
+
version: string;
|
|
838
|
+
apiVersion: number;
|
|
839
|
+
home: string;
|
|
840
|
+
skillsDir: string;
|
|
841
|
+
pluginsDir: string;
|
|
842
|
+
};
|
|
843
|
+
}
|
|
844
|
+
/**
|
|
845
|
+
* git 观测服务(git 插件提供):当前工作区的分支与改动读数。
|
|
846
|
+
*
|
|
847
|
+
* 读面是给快照用的那一片(`surfaces.git`);{@link refresh} 是给写类 op 的催拍口——
|
|
848
|
+
* 切了分支 / 建了分支之后,桌面 dock 的写类 handler 调它一次,界面那颗钮当场跟上,
|
|
849
|
+
* 不必等下一个 12 秒。
|
|
850
|
+
*/
|
|
851
|
+
export interface GitService {
|
|
852
|
+
/** 最近一次的读数(同步:快照片段在装配时读,不能等 I/O)。 */
|
|
853
|
+
snapshot(): GitSurface;
|
|
854
|
+
/** 催一拍:立刻重取一次(写类 git op 落盘后调)。 */
|
|
855
|
+
refresh(): void;
|
|
856
|
+
}
|
|
857
|
+
/** dock 服务:桌面端面板的工作区文件系统 + git 能力(op/payload 透传协议)。 */
|
|
858
|
+
export interface DockService {
|
|
859
|
+
/**
|
|
860
|
+
* 处理一次 dock 请求(fs-list / fs-read / git-status / git-branches / git-stage /
|
|
861
|
+
* git-unstage / git-commit / git-checkout / git-branch-create / git-log / git-diff)。
|
|
862
|
+
*/
|
|
863
|
+
handle(op: string, payload: Record<string, unknown>): Promise<unknown>;
|
|
864
|
+
}
|
|
865
|
+
/**
|
|
866
|
+
* 后台作业与终端会话的收口(tools-default 插件提供):状态面板「终端」区的停止动作
|
|
867
|
+
* 与只读输出面走它。开工的两条路(bash 的 run_in_background / terminal 工具)仍在工具面,
|
|
868
|
+
* 这里只有「收」与「读」。
|
|
869
|
+
*/
|
|
870
|
+
export interface BackgroundWorksService {
|
|
871
|
+
/**
|
|
872
|
+
* 收掉一个正在跑的后台作业(`job-N`,走 job_kill 那套整树收尾)或持久终端会话
|
|
873
|
+
* (`term-N`,等价 terminal close)。
|
|
874
|
+
* @param id - 作业 / 会话 id;两种前缀各自路由,陌生 id 抛错(错误原文就是给用户的说明)。
|
|
875
|
+
* @returns 给用户看的一句话。
|
|
876
|
+
*/
|
|
877
|
+
stop(id: string): string;
|
|
878
|
+
/**
|
|
879
|
+
* 只读读一次输出快照(状态面板「终端」区点开的那一页轮询它)。
|
|
880
|
+
*
|
|
881
|
+
* 与 {@link stop} 同口径的归属校验:只读**当前查看会话**起的那条;id 不认识、或属于
|
|
882
|
+
* 别的会话时抛错。返回形状带 `text / status / totalChars / from / droppedChars / atEnd`
|
|
883
|
+
* ——`droppedChars > 0` 就是「头部丢字」,界面据此报出来(对照参考实现的 truncated/gap)。
|
|
884
|
+
*
|
|
885
|
+
* 读的是**尾部窗口**、且**不动模型的增量读游标**(走表上的 peek 而非 read/output),
|
|
886
|
+
* 所以界面按秒轮询不会把模型下一次 `job_output` / `terminal read` 该读到的输出吃掉。
|
|
887
|
+
*/
|
|
888
|
+
read(id: string): BackgroundOutputView;
|
|
889
|
+
}
|
|
890
|
+
/** 一个 MCP server 的连接状态(给设置页与自检看,不进模型上下文)。 */
|
|
891
|
+
export interface McpServerInfo {
|
|
892
|
+
name: string;
|
|
893
|
+
transport: 'stdio' | 'http';
|
|
894
|
+
/** 这个 server 暴露了几个工具。 */
|
|
895
|
+
tools: number;
|
|
896
|
+
state: 'ready' | 'connecting' | 'failed';
|
|
897
|
+
/** state 为 failed 时的原因原文。 */
|
|
898
|
+
problem?: string;
|
|
899
|
+
/** T24:server 声明了 resources 能力时,列出来的资源条数(没声明/没连上不填)。 */
|
|
900
|
+
resources?: number;
|
|
901
|
+
/** T24:server 声明了 prompts 能力时,列出来的模板条数(没声明/没连上不填)。 */
|
|
902
|
+
prompts?: number;
|
|
903
|
+
}
|
|
904
|
+
/** 一个 MCP 工具在目录里的样子(渐进披露的检索对象)。 */
|
|
905
|
+
export interface McpToolInfo {
|
|
906
|
+
/** 完整工具名,形如 `mcp__<server>__<tool>`;模型与守卫链看到的都是它。 */
|
|
907
|
+
name: string;
|
|
908
|
+
server: string;
|
|
909
|
+
tool: string;
|
|
910
|
+
description: string;
|
|
911
|
+
/** JSON Schema(OpenAI function 参数格式)。 */
|
|
912
|
+
parameters: Record<string, unknown>;
|
|
913
|
+
risk: 'read' | 'write' | 'exec';
|
|
914
|
+
}
|
|
915
|
+
/**
|
|
916
|
+
* MCP 客户端(mcp 插件提供;插件没开时不存在)。
|
|
917
|
+
*
|
|
918
|
+
* 命令式四个方法构成的能力面:查连接状态、列工具目录、按真名调用、把 schema 从
|
|
919
|
+
* 每轮请求里撤下。最后一个是给 Tool Search 用的——由工具目录的持有者自己决定
|
|
920
|
+
* 哪些工具留在台面上,免得两处各存一份「谁可见」的判断。
|
|
921
|
+
*/
|
|
922
|
+
export interface McpService {
|
|
923
|
+
/** 已配置的 server 及其连接状态。 */
|
|
924
|
+
servers(): McpServerInfo[];
|
|
925
|
+
/** 当前可用的 MCP 工具目录(与是否已注册进 ctx.tools 无关)。 */
|
|
926
|
+
tools(): McpToolInfo[];
|
|
927
|
+
/** 按完整工具名调用;结果已过防注入围栏。 */
|
|
928
|
+
call(name: string, args: Record<string, unknown>, signal: AbortSignal): Promise<string>;
|
|
929
|
+
/**
|
|
930
|
+
* 把已注册进 `ctx.tools` 的动手类(write / exec)MCP 工具撤下,只留在本服务里供渐进披露;
|
|
931
|
+
* 只读工具留在台面上——它们靠 `risk: 'read'` 免审批,撤下去就只剩走 `tool_call` 的审批卡。
|
|
932
|
+
* 幂等。
|
|
933
|
+
*/
|
|
934
|
+
deferSchemas(): void;
|
|
935
|
+
}
|
|
936
|
+
/** 一条跨会话检索命中。 */
|
|
937
|
+
export interface SessionSearchHit {
|
|
938
|
+
sessionId: string;
|
|
939
|
+
/** 会话 jsonl 的绝对路径,可直接交给 openSession 打开。 */
|
|
940
|
+
file: string;
|
|
941
|
+
cwd: string;
|
|
942
|
+
/** 命中那一行属于谁:user / assistant / tool / summary。 */
|
|
943
|
+
role: string;
|
|
944
|
+
/** 命中行的记录时间戳(毫秒);老日志没有就是 0。 */
|
|
945
|
+
ts: number;
|
|
946
|
+
/** 命中处前后各截一段的正文片段。 */
|
|
947
|
+
snippet: string;
|
|
948
|
+
/** 命中所在行号(从 1 数),供精确定位。 */
|
|
949
|
+
line: number;
|
|
950
|
+
}
|
|
951
|
+
/** {@link SessionSearchService.search} 的可选条件。 */
|
|
952
|
+
export interface SessionSearchOptions {
|
|
953
|
+
/** 最多返回几条,缺省由插件配置决定。 */
|
|
954
|
+
limit?: number;
|
|
955
|
+
/** 是否把归档区(`sessions/.archived/`)也算进来。 */
|
|
956
|
+
includeArchived?: boolean;
|
|
957
|
+
/** 只搜这个工作目录下的会话。 */
|
|
958
|
+
cwd?: string;
|
|
959
|
+
}
|
|
960
|
+
/**
|
|
961
|
+
* 跨会话全文检索(session-search 插件提供;插件没开时不存在)。
|
|
962
|
+
*
|
|
963
|
+
* 检索走旁路索引,不改会话 jsonl 的主格式:索引坏了重建即可,会话历史不受影响。
|
|
964
|
+
*/
|
|
965
|
+
export interface SessionSearchService {
|
|
966
|
+
/** 按关键词检索历史会话正文;中文按 bigram 切词,所以 1-2 字词也命中。 */
|
|
967
|
+
search(query: string, options?: SessionSearchOptions): Promise<SessionSearchHit[]>;
|
|
968
|
+
/** 丢掉索引整表重建(回填用)。 */
|
|
969
|
+
rebuild(): Promise<void>;
|
|
970
|
+
/** 索引现状:建了几个文件、多少词项、最后更新时间。 */
|
|
971
|
+
stats(): {
|
|
972
|
+
files: number;
|
|
973
|
+
terms: number;
|
|
974
|
+
updatedAt: number;
|
|
975
|
+
};
|
|
976
|
+
}
|
|
977
|
+
/**
|
|
978
|
+
* 审批灾难地板的只读视图(approval-floor 插件提供;插件没开时不存在)。
|
|
979
|
+
*
|
|
980
|
+
* 地板排在守卫链最前面,它判过的东西后面的守卫看不到,所以「这条命令命中白名单」这件事
|
|
981
|
+
* 必须显式交出来,由审批层去免卡放行——地板不能自己 `pass`,那会把后面的安全钩子一起跳掉。
|
|
982
|
+
*/
|
|
983
|
+
export interface ApprovalFloorService {
|
|
984
|
+
/** 这条命令命中白名单前缀就返回那串词元;没命中返回 null。 */
|
|
985
|
+
whitelist(command: string): readonly string[] | null;
|
|
986
|
+
/** 白名单当前条数(诊断与设置页用)。 */
|
|
987
|
+
count(): number;
|
|
988
|
+
}
|
|
989
|
+
/**
|
|
990
|
+
* 沙箱档位(形制照 codex 的 `sandbox_mode`):
|
|
991
|
+
* read-only 只读:任何写盘与越界命令都拒;
|
|
992
|
+
* workspace-write 工作区可写:工作区 + 沙箱私有临时目录可写,越界拒(默认档);
|
|
993
|
+
* danger-full-access 不设围栏(等同关掉沙箱)。
|
|
994
|
+
*
|
|
995
|
+
* 真源在 `contract.ts`(界面与宿主共用一份词汇),这里只转出去给宿主侧引用。
|
|
996
|
+
*/
|
|
997
|
+
import type { SandboxMode } from '../contract.js';
|
|
998
|
+
export type { SandboxMode };
|
|
999
|
+
/**
|
|
1000
|
+
* 沙箱的强制执行等级——「说拦得住」和「真拦得住」是两件事,这个字段说的就是后者:
|
|
1001
|
+
* full 执行体真被换掉了(容器后端:网络与文件系统由内核隔离);
|
|
1002
|
+
* partial 进程内策略围栏:拦得住 dsc 自己发起的工具调用,拦不住命令内部的任意写;
|
|
1003
|
+
* none 沙箱插件关着,或当前档位不设围栏。
|
|
1004
|
+
*/
|
|
1005
|
+
export type SandboxEnforcement = 'full' | 'partial' | 'none';
|
|
1006
|
+
/** 一次路径判定的结果。 */
|
|
1007
|
+
export interface SandboxCheck {
|
|
1008
|
+
allowed: boolean;
|
|
1009
|
+
/** 被拒时说明命中哪条规则。 */
|
|
1010
|
+
reason?: string;
|
|
1011
|
+
/** 放行时,是被哪个可写根覆盖的。 */
|
|
1012
|
+
root?: string;
|
|
1013
|
+
}
|
|
1014
|
+
/**
|
|
1015
|
+
* 沙箱(sandbox 插件提供;插件关着时这个服务不存在,读它要用 `ctx.get('sandbox')`)。
|
|
1016
|
+
*
|
|
1017
|
+
* 对外只给「查」和「判」两类能力:别的功能(将来的 PTC、无人值守的定时任务)
|
|
1018
|
+
* 要问「我现在能不能写这个路径」,不必自己重算一遍白名单——白名单只有持有者该认识。
|
|
1019
|
+
*/
|
|
1020
|
+
export interface SandboxService {
|
|
1021
|
+
/** 当前档位。 */
|
|
1022
|
+
readonly mode: SandboxMode;
|
|
1023
|
+
/** 强制执行等级(见 {@link SandboxEnforcement})。 */
|
|
1024
|
+
readonly enforcement: SandboxEnforcement;
|
|
1025
|
+
/** 本次会话的可写根(绝对路径,已规范化)。 */
|
|
1026
|
+
readonly writableRoots: readonly string[];
|
|
1027
|
+
/** 网络是否放行(声明式开关;策略后端只能靠环境变量与容器后端落实)。 */
|
|
1028
|
+
readonly networkAccess: boolean;
|
|
1029
|
+
/** 沙箱私有临时目录(本次会话;`TMP/TEMP/HOME` 被重定向到这里)。 */
|
|
1030
|
+
readonly tmpDir: string;
|
|
1031
|
+
/**
|
|
1032
|
+
* 判一个路径能不能写;解析失败保守拒绝。
|
|
1033
|
+
* @param path - 目标路径(相对路径按 cwd 展开)。
|
|
1034
|
+
* @param cwd - 会话工作目录(可写根的基准);省略时用最近一次工具调用看到的工作目录。
|
|
1035
|
+
* 为什么要有这个参数:可写根随会话走,同一进程里不同会话的 cwd 不同;
|
|
1036
|
+
* 拿挂载时的 `process.cwd()` 当基准,会把别的会话的合法写入误判成越界。
|
|
1037
|
+
*/
|
|
1038
|
+
canWrite(path: string, cwd?: string): SandboxCheck;
|
|
1039
|
+
/** 当前策略的一句话摘要(系统提示与诊断用)。 */
|
|
1040
|
+
describe(): string;
|
|
1041
|
+
/**
|
|
1042
|
+
* 切沙箱档位(写 `~/.dsc/plugins.json` 里沙箱那一项的 `mode`)。
|
|
1043
|
+
* 打包权限预设与设置页的档位格走同一条写盘路径;非法档位当场抛错。
|
|
1044
|
+
*/
|
|
1045
|
+
setMode(mode: SandboxMode): void;
|
|
1046
|
+
/**
|
|
1047
|
+
* 记一条**本会话**的放宽:把几个绝对路径并进这个会话的可写根
|
|
1048
|
+
* (审批卡上「本会话允许」那一按调它)。键是会话 jsonl 路径——一个会话放宽了不影响别的会话。
|
|
1049
|
+
*/
|
|
1050
|
+
grantSession(sessionPath: string, roots: readonly string[]): void;
|
|
1051
|
+
/** 读一个会话已经放宽出来的可写根(诊断与 `/sandbox` 用)。 */
|
|
1052
|
+
sessionGrants(sessionPath: string): readonly string[];
|
|
1053
|
+
}
|
|
1054
|
+
/**
|
|
1055
|
+
* 界面可达性:tui / host-stdio 这类「有人在看」的入口登记一份,没有登记就是没人能回答审批卡。
|
|
1056
|
+
* 审批插件据此决定是弹卡还是立刻按拒处理,不再白等一次审批超时。
|
|
1057
|
+
*/
|
|
1058
|
+
export interface InteractiveService {
|
|
1059
|
+
/** tui = 终端界面;host = 桌面端 stdio 宿主。 */
|
|
1060
|
+
kind: 'tui' | 'host';
|
|
1061
|
+
/** 现在还有人能回答审批卡吗(宿主客户端断开后为 false)。 */
|
|
1062
|
+
reachable(): boolean;
|
|
1063
|
+
}
|
|
1064
|
+
/**
|
|
1065
|
+
* 本机界面服务:宿主把一个回环 HTTP 服务开起来,把插件版界面伺服给浏览器(桌面窗口看的
|
|
1066
|
+
* 就是它伺服的那份文档,与远程设备共用同一份)。
|
|
1067
|
+
*
|
|
1068
|
+
* 默认**不起**(挂载只是登记服务):终端里跑 `numa` 的人不该平白多出一个监听端口。
|
|
1069
|
+
* 谁来要:桌面主进程经宿主协议拿地址,或者 `DSC_UI_SERVER=1` / 插件配置 `enabled: true`。
|
|
1070
|
+
*/
|
|
1071
|
+
export interface WebServerService {
|
|
1072
|
+
/**
|
|
1073
|
+
* 要服务(幂等):已经起来就直接给地址,没起来就现在起。
|
|
1074
|
+
* @returns 入口地址(带一次性令牌)、本机根地址与端口
|
|
1075
|
+
*/
|
|
1076
|
+
ensure(): Promise<{
|
|
1077
|
+
url: string;
|
|
1078
|
+
origin: string;
|
|
1079
|
+
port: number;
|
|
1080
|
+
}>;
|
|
1081
|
+
/** 已经起来的那个句柄;没起来给 null。 */
|
|
1082
|
+
readonly running: unknown;
|
|
1083
|
+
}
|
|
1084
|
+
declare module '@deepseek-ai/cordis' {
|
|
1085
|
+
interface Context {
|
|
1086
|
+
llm: LlmService;
|
|
1087
|
+
session: SessionService;
|
|
1088
|
+
approval: ApprovalService;
|
|
1089
|
+
/** 协作模式(执行 / 计划 / 探索 / 免打扰)与它注册的那道守卫。 */
|
|
1090
|
+
mode: ModeService;
|
|
1091
|
+
/** 模式(预设):人格、工具目录与提示词的那根旋钮。 */
|
|
1092
|
+
presets: PresetService;
|
|
1093
|
+
/** 打包权限预设:沙箱 + 权限模式 + 审阅者三合一那颗旋钮。 */
|
|
1094
|
+
permissionPresets: PermissionPresetService;
|
|
1095
|
+
/** 任务清单(todo_write)。 */
|
|
1096
|
+
todo: TodoService;
|
|
1097
|
+
/** 计划交付与评审卡(exit_plan_mode)。 */
|
|
1098
|
+
plan: PlanService;
|
|
1099
|
+
/** 模型提问(ask_user)。 */
|
|
1100
|
+
ask: AskService;
|
|
1101
|
+
/** 会话目标与自动续跑。 */
|
|
1102
|
+
goal: GoalService;
|
|
1103
|
+
tools: ToolService;
|
|
1104
|
+
transcript: TranscriptService;
|
|
1105
|
+
commands: CommandService;
|
|
1106
|
+
compact: CompactService;
|
|
1107
|
+
agent: AgentService;
|
|
1108
|
+
/** 请求组装扩展点(附加系统提示 + 请求体改写)。 */
|
|
1109
|
+
prompt: PromptService;
|
|
1110
|
+
/** 工具守卫链(内核扩展点:谁想在工具动手前说话就注册一位)。 */
|
|
1111
|
+
guards: GuardService;
|
|
1112
|
+
/** 快照片段注册表(内核扩展点:谁想在界面快照里有一块就登记一片)。 */
|
|
1113
|
+
surfaces: SurfaceService;
|
|
1114
|
+
/** 「正在等人」登记表(内核扩展点:卡片挂没挂着一问就知道)。 */
|
|
1115
|
+
waiting: WaitingService;
|
|
1116
|
+
/** 智能体团队(subagent 插件提供;插件没开时不存在)。 */
|
|
1117
|
+
team?: TeamService;
|
|
1118
|
+
/** 只读代码审查通道(subagent 插件提供;插件没开时 /review 回落主会话轮)。 */
|
|
1119
|
+
review?: ReviewService;
|
|
1120
|
+
/** 技能服务(发现/启停/市场/模型可见目录)。 */
|
|
1121
|
+
skills: SkillService;
|
|
1122
|
+
/** 设置服务(分区注册表 + 模型配置 + 偏好)。 */
|
|
1123
|
+
settings: SettingsService;
|
|
1124
|
+
/** 安全钩子(用户在工具动手前自己加的规则与脚本)。 */
|
|
1125
|
+
hooks: HookService;
|
|
1126
|
+
/** 长期记忆(跨会话留下的事实,写在 `~/.dsc/memory/`)。 */
|
|
1127
|
+
memory: MemoryService;
|
|
1128
|
+
/** MCP 客户端(mcp 插件提供;插件没开时不存在,读它要用 `ctx.get('mcp')`)。 */
|
|
1129
|
+
mcp?: McpService;
|
|
1130
|
+
/** 跨会话全文检索(session-search 插件提供;插件没开时不存在,读它要用 `ctx.get('sessionSearch')`)。 */
|
|
1131
|
+
sessionSearch?: SessionSearchService;
|
|
1132
|
+
/** 审批灾难地板的只读视图(approval-floor 插件提供;插件没开时不存在,读它要用 `ctx.get('approvalFloor')`)。 */
|
|
1133
|
+
approvalFloor?: ApprovalFloorService;
|
|
1134
|
+
/** 界面可达性(tui / host-stdio 入口登记;脚本环境里不存在,读它要用 `ctx.get('interactive')`)。 */
|
|
1135
|
+
interactive?: InteractiveService;
|
|
1136
|
+
/**
|
|
1137
|
+
* 桌面壳那条浏览器控制链路(host-stdio 插件登记)。
|
|
1138
|
+
*
|
|
1139
|
+
* 管道宿主(`node lib/headless.js`)与远程壳里**服务在、但 `available()` 为假**——
|
|
1140
|
+
* 「宿主里没有桌面壳」与「桌面壳没响应」是两回事,取到之后必须看这一位再决定怎么说。
|
|
1141
|
+
* 读它要用 `ctx.get('hostBrowser')`。
|
|
1142
|
+
*/
|
|
1143
|
+
hostBrowser?: HostBrowserLink;
|
|
1144
|
+
/**
|
|
1145
|
+
* 本机界面服务(webserver 插件提供;挂载即存在,真正监听要调 `ensure()`)。
|
|
1146
|
+
* 桌面主进程拿它取窗口地址,`DSC_UI_SERVER=1` 时插件自己起来。
|
|
1147
|
+
*/
|
|
1148
|
+
webServer?: WebServerService;
|
|
1149
|
+
/** 沙箱(sandbox 插件提供;插件没开时不存在,读它要用 `ctx.get('sandbox')`)。 */
|
|
1150
|
+
sandbox?: SandboxService;
|
|
1151
|
+
/** desktop-dock 服务(桌面端面板的工作区文件系统 + git)。 */
|
|
1152
|
+
dock: DockService;
|
|
1153
|
+
/** git 观测(当前工作区分支与改动读数;写类 op 落盘后调它催一拍)。 */
|
|
1154
|
+
git: GitService;
|
|
1155
|
+
/**
|
|
1156
|
+
* 后台作业与终端会话的收口(tools-default 提供;它停用时不存在,读它要用 `ctx.get`)。
|
|
1157
|
+
*/
|
|
1158
|
+
backgroundWorks?: BackgroundWorksService;
|
|
1159
|
+
/**
|
|
1160
|
+
* DscRuntime 适配器(供 UI 插件消费)。
|
|
1161
|
+
* 注意:不能叫 `runtime`——那是 cordis 内置的 fiber.mixin 保留属性名。
|
|
1162
|
+
*/
|
|
1163
|
+
ui: DscRuntime;
|
|
1164
|
+
}
|
|
1165
|
+
interface Events {
|
|
1166
|
+
'dsc/changed'(): void;
|
|
1167
|
+
/**
|
|
1168
|
+
* 请求写一条 system 条目(transcript 监听)。
|
|
1169
|
+
* @param kind - 通知的类别;`'compaction'` = 这条通知是「历史刚被压缩」的落点,
|
|
1170
|
+
* transcript 会给这条条目打上压缩标记(轨迹页据此切区段),
|
|
1171
|
+
* 省略 = 普通通知(错误、状态说明这类)。
|
|
1172
|
+
*/
|
|
1173
|
+
'dsc/notice'(text: string, kind?: 'compaction', sessionPath?: string): void;
|
|
1174
|
+
/** 计划卡内容或评审结果有变(plan 插件发出,transcript 折叠成会话流里的计划条目)。 */
|
|
1175
|
+
'dsc/plan'(plan: PlanView, sessionPath?: string): void;
|
|
1176
|
+
'dsc/session-open'(payload: SessionOpenPayload): void;
|
|
1177
|
+
'dsc/exit'(): void;
|
|
1178
|
+
/** 命令 handler 请求打开会话选择面板(/resume;UI 桥转发给宿主壳)。 */
|
|
1179
|
+
'dsc/open-picker'(): void;
|
|
1180
|
+
/** 命令 handler 请求打开模型选择面板(/model 无参数;桌面端可自行映射或忽略)。 */
|
|
1181
|
+
'dsc/open-models'(): void;
|
|
1182
|
+
/** dock 终端输出流(desktop-dock 服务 → 桌面端面板)。 */
|
|
1183
|
+
'dsc/dock-data'(id: string, data: string): void;
|
|
1184
|
+
/** 技能清单或启停状态变化(agent 据此重算模型可见目录)。 */
|
|
1185
|
+
'dsc/skills-changed'(): void;
|
|
1186
|
+
/**
|
|
1187
|
+
* 协作模式换了档位(mode 插件发出)。
|
|
1188
|
+
* 审批插件听这个把档位留在审批卡与审计记录里——它因此不必反过来依赖模式服务
|
|
1189
|
+
* (mode 已经依赖 approval,反向再依赖一次就是环)。
|
|
1190
|
+
*/
|
|
1191
|
+
'dsc/mode-changed'(mode: CollaborationMode): void;
|
|
1192
|
+
/**
|
|
1193
|
+
* 模式(预设)换了一个(presets 插件发出)。
|
|
1194
|
+
* 想知道「模型的工具目录刚变了」的功能点听这个,不必反过来依赖模式服务。
|
|
1195
|
+
*/
|
|
1196
|
+
'dsc/preset-changed'(name: string): void;
|
|
1197
|
+
/**
|
|
1198
|
+
* 一轮对话开始(agent 发出,T41):压缩插件数着它做 /compact 的运行中守卫;
|
|
1199
|
+
* 别的「想知道回合开始了」的功能点也听这个,不必各自盯快照。
|
|
1200
|
+
* 0.6.48 起带会话归属:后台常驻 agent 的回合也发这个事件,消费方按
|
|
1201
|
+
* sessionId 判断是不是自己关心的那个会话。
|
|
1202
|
+
*/
|
|
1203
|
+
'dsc/turn-start'(payload: TurnSignal): void;
|
|
1204
|
+
/**
|
|
1205
|
+
* 一轮对话结束(agent 发出,reason 与 CoreEvent 的 turn/end 一致)。
|
|
1206
|
+
* 目标续跑听这个;循环因此不认识「目标」这个功能。
|
|
1207
|
+
* 0.6.48 起带会话归属(TurnSignal):只想管当前查看会话的消费方自己比对。
|
|
1208
|
+
*/
|
|
1209
|
+
'dsc/turn-end'(reason: 'completed' | 'aborted' | 'error', payload: TurnSignal): void;
|
|
1210
|
+
/**
|
|
1211
|
+
* 某个会话的运行状态变了(agent/审批插件发出,0.6.48):侧栏跨会话状态点与
|
|
1212
|
+
* 「已完成未读」徽标的数据源。state: working = 回合在跑;awaiting-approval =
|
|
1213
|
+
* 挂着等审批卡;idle = 完全闲下来(转录层据此把刚收工且没在看的会话标成 just-finished)。
|
|
1214
|
+
*/
|
|
1215
|
+
'dsc/agent-status'(payload: AgentStatusPayload): void;
|
|
1216
|
+
/**
|
|
1217
|
+
* 历史刚被压缩掉(compact 插件发出)。
|
|
1218
|
+
* 加载时冻结的东西要重算:记忆栏就是靠这个换新的一份,不然压缩后模型还在读旧事实。
|
|
1219
|
+
*/
|
|
1220
|
+
'dsc/compacted'(): void;
|
|
1221
|
+
}
|
|
1222
|
+
}
|
|
1223
|
+
/** 便利别名:contract/core 的公共类型统一从 services 透出(插件的唯一类型入口)。 */
|
|
1224
|
+
export type { ProviderConfig };
|
|
1225
|
+
export type { ApprovalDecision, ApprovalRequest };
|
|
1226
|
+
export type { SkillDefinition, SkillSummary };
|
|
1227
|
+
export type { DscPrefs };
|
|
1228
|
+
export type { ApprovalAnswer, ApprovalPolicy, ApprovalRequestView, ApprovalReviewer, ArchivedPage, ArchivedSessionView, DscRuntime, EffortLevel, MarketBrowseResult, MarketSkillView, MarketSource, ModelChoiceView, ModelConfigView, Modality, PairShareData, PresetDraft, PresetFileView, PresetSurface, PresetView, ProviderDraft, ProviderModelView, ProviderView, RuntimeSnapshot, SessionForkResult, SessionSummary, SettingsField, SettingsMutation, SettingsMutationOk, SettingsOption, SettingsSectionView, SettingsValue, SettingsValues, SkillDetail, SkillInfoView, SkillLoadResult, StatusView, TokenUsageView, ToolCallView, ToolEntryView, ToolStatus, TranscriptEntry, } from '../contract.js';
|