@waq666/pneuma 0.0.0-stage → 0.7.1
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 +206 -3
- 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 +15 -0
- package/lib/app/App.js +1650 -0
- package/lib/app/App.js.nv-backup +1650 -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 +63 -0
- package/lib/app/ChatView.js +310 -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 +201 -0
- package/lib/app/TaskStrips.d.ts +13 -0
- package/lib/app/TaskStrips.js +40 -0
- package/lib/app/TimelineRail.d.ts +22 -0
- package/lib/app/TimelineRail.js +160 -0
- package/lib/app/TimelineRail.js.negbak +98 -0
- package/lib/app/TimelineRail.js.nv-backup +160 -0
- package/lib/app/ToolCard.d.ts +11 -0
- package/lib/app/ToolCard.js +64 -0
- package/lib/app/ToolCard.js.nv-backup +64 -0
- package/lib/app/TranscriptOverlay.d.ts +27 -0
- package/lib/app/TranscriptOverlay.js +36 -0
- package/lib/app/TranscriptViewport.d.ts +78 -0
- package/lib/app/TranscriptViewport.js +218 -0
- package/lib/app/Welcome.d.ts +6 -0
- package/lib/app/Welcome.js +71 -0
- package/lib/app/attach.d.ts +16 -0
- package/lib/app/attach.js +58 -0
- package/lib/app/click.d.ts +40 -0
- package/lib/app/click.js +103 -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/keymap.d.ts +56 -0
- package/lib/app/keymap.js +56 -0
- package/lib/app/markdown.d.ts +54 -0
- package/lib/app/markdown.js +189 -0
- package/lib/app/mouse.d.ts +33 -0
- package/lib/app/mouse.js +35 -0
- package/lib/app/pointer.d.ts +16 -0
- package/lib/app/pointer.js +60 -0
- package/lib/app/scroll-model.d.ts +240 -0
- package/lib/app/scroll-model.js +347 -0
- package/lib/app/settings-model.d.ts +69 -0
- package/lib/app/settings-model.js +114 -0
- package/lib/app/snapshot-subscribe.d.ts +34 -0
- package/lib/app/snapshot-subscribe.js +110 -0
- package/lib/app/theme.d.ts +194 -0
- package/lib/app/theme.js +186 -0
- package/lib/app/ticker.d.ts +7 -0
- package/lib/app/ticker.js +53 -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 +283 -0
- package/lib/core/llm.js +565 -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 +896 -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 +434 -0
- package/lib/plugins/tool-search.js.nv-backup +434 -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,563 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 原生桥的规格:桌面外壳能替界面做的事,逐条白名单 + 实参校验。
|
|
3
|
+
*
|
|
4
|
+
* ## 为什么需要这一层
|
|
5
|
+
*
|
|
6
|
+
* 旧渲染层的 26 个 IPC 能力里,有一类**宿主做不了**——它们要 Electron 主进程:
|
|
7
|
+
* 原生窗口控件区的颜色、原生弹层的深浅、系统文件选择框、用系统程序打开路径/链接、
|
|
8
|
+
* 托盘通知、退出与重启宿主。插件壳跑在宿主伺服的 web 文档里,它要摸这些能力,
|
|
9
|
+
* 只能走一条主进程给的窄通道——就是这份规格描述的那条。
|
|
10
|
+
*
|
|
11
|
+
* ## 为什么规格单独放这里(而不再写一份在桌面那侧)
|
|
12
|
+
*
|
|
13
|
+
* 这一份**零依赖**(不 import 任何 node 内置模块、不 import electron),所以两侧共用:
|
|
14
|
+
* 桌面主进程用它校验并分派,界面壳用它拿操作名与实参类型。宿主与壳读同一份源码,
|
|
15
|
+
* 漂移在编译期就暴露——与 `src/ui/index.ts`(`@dsc/ui-core`)和
|
|
16
|
+
* `ui-shell/src/platform-modules.json` 是同一个套路。
|
|
17
|
+
*
|
|
18
|
+
* ## 边界(比"能少给就少给"更具体的三条)
|
|
19
|
+
*
|
|
20
|
+
* 1. **不出现"执行任意命令 / 读写任意文件"的操作**。这里全是"既定动作 + 实参枚举":
|
|
21
|
+
* 打开一个目录、报一次窗口控件色、弹一条通知。没有 op 能把一段字符串变成一次执行。
|
|
22
|
+
* 2. **每条操作的实参都过一遍形状校验**(长度上限、枚举取值、#rrggbb、通知的字段白名单),
|
|
23
|
+
* 规格写成 `Record<NativeOp, …>`,所以**加一个操作就必须写规格**,漏了编不过。
|
|
24
|
+
* 3. **主进程那一侧按 `NativeOp` 建分派表**(`Record<NativeOp, 处理函数>`),
|
|
25
|
+
* 漏实现一个操作同样编不过——"白名单"与"真有实现"被绑在一起。
|
|
26
|
+
*
|
|
27
|
+
* 装东西的四个操作(`installSkill` / `installPlugin` / `installMarketSkill` /
|
|
28
|
+
* `setMarketSources`)**走桥,不在界面通道**:它们是供应链写入口,界面通道
|
|
29
|
+
* (浏览器与远程页都够得着)持续排除;桥只对主窗口那份文档开放,与旧渲染层的
|
|
30
|
+
* 直接 IPC 是同一扇门。前两个弹系统文件选择器(人选了文件才算数),后两个转给
|
|
31
|
+
* 宿主(按市场源下载安装到 `~/.dsc/skills`、把源清单写回 settings.json)。
|
|
32
|
+
* 同一理由的还有 `setUiTrust`(落第三方界面插件的信任记录——放它进启动图这声
|
|
33
|
+
* 「我信任」必须是人在桌面窗口里答的),模型端点三件套
|
|
34
|
+
* (`saveProvider` / `removeProvider` / `setProviderKey`——写 config.yaml 与凭据库,
|
|
35
|
+
* 是设置 → 模型页可编辑形态的写入口;旧渲染层这三件事走的就是直接 IPC),
|
|
36
|
+
* 以及 `setPolicy`(审批策略是安全闸门本身,界面通道同样持续排除;旧渲染层的输入框
|
|
37
|
+
* 里本来就有这根能切的旋钮,桥替它把写口留住)。
|
|
38
|
+
*
|
|
39
|
+
* 内嵌浏览器那一套(`dockBrowser` / `browserNav` / `browserClose` + `browser-state`、
|
|
40
|
+
* `browser-open-requested` 两个事件)2026-10 搬进壳:它们操作的是原生 `WebContentsView`
|
|
41
|
+
* 覆盖层(旧渲染层直连 IPC 的那个),桥只转发「显示/隐藏 + 摆到哪 + 导航到哪 +
|
|
42
|
+
* 关掉哪一台」,页面管不到那个视图的内容。终端(`terminal`)同款——能力留在主进程,
|
|
43
|
+
* 界面只说意图。
|
|
44
|
+
*
|
|
45
|
+
* 2026-10 起浏览器页签可以多开:**一台视图一个 id**(壳拿页签自己的 id 当这个 id),
|
|
46
|
+
* 上面三个操作都带它。id 缺省回落 `'main'`,旧渲染层那条直连 IPC 因此一字不用改。
|
|
47
|
+
* 视图的创建/销毁、会话策略、导航闸门全在主进程(`desktop/electron/main/dock.ts`),
|
|
48
|
+
* 页面报上来的只有「哪一台、摆哪里」。
|
|
49
|
+
*
|
|
50
|
+
* 除了 `call` 之外,桥还有**一个订阅口**:`on(event, listener)`,事件名由 {@link NATIVE_EVENTS}
|
|
51
|
+
* 白名单(现在只有终端输出流)。事件不做实参校验——它是主进程往外推的,不是页面往里送的。
|
|
52
|
+
*
|
|
53
|
+
* @module dsc/core/native-bridge
|
|
54
|
+
*/
|
|
55
|
+
import { DOCK_TAB_CLOSE_EVENT, DOCK_TAB_OPEN_EVENT } from './dock-browser.js';
|
|
56
|
+
import { DOCK_TERM_OPS } from './dock-ops.js';
|
|
57
|
+
/**
|
|
58
|
+
* 桥的协议版本:**加操作不涨**,改某个操作的实参或语义才涨。
|
|
59
|
+
* 桌面主进程与壳握手时对一下,不一致就在诊断区说明白(不静默降级)。
|
|
60
|
+
*
|
|
61
|
+
* 2 → 3(2026-10):浏览器页签改可多开,`dockBrowser` / `browserNav` 各多一个
|
|
62
|
+
* 视图 id 实参,`browser-state` 的载荷从一个 `url` 扩成带 id / 标题 / 前后退 /
|
|
63
|
+
* 加载中的整份状态。**这一次必须两头同批重建**:旧外壳收到多出来的实参会按
|
|
64
|
+
* 「最多收 N 个实参」拒掉(不会静默忽略),壳与外壳各自出一份产物时对不上,
|
|
65
|
+
* 诊断区那条版本告警就是给这个场景写的。
|
|
66
|
+
*/
|
|
67
|
+
export const NATIVE_BRIDGE_VERSION = 3;
|
|
68
|
+
/** 桥放行的操作,一字不差就是分派表的键。 */
|
|
69
|
+
export const NATIVE_OPS = [
|
|
70
|
+
'setWindowChrome',
|
|
71
|
+
'setThemeSource',
|
|
72
|
+
'chooseDirectory',
|
|
73
|
+
'pickDirectory',
|
|
74
|
+
'rememberCwd',
|
|
75
|
+
'switchCwd',
|
|
76
|
+
'recentCwds',
|
|
77
|
+
'removeRecentCwd',
|
|
78
|
+
'openPath',
|
|
79
|
+
'openExternal',
|
|
80
|
+
'openWorkspace',
|
|
81
|
+
'installSkill',
|
|
82
|
+
'installPlugin',
|
|
83
|
+
'installMarketSkill',
|
|
84
|
+
'setMarketSources',
|
|
85
|
+
'setUiTrust',
|
|
86
|
+
/**
|
|
87
|
+
* 模型端点三件套(设置 → 模型的可编辑形态,2026-10):`saveProvider` /
|
|
88
|
+
* `removeProvider` / `setProviderKey` 都写 config.yaml 或凭据库,与上面那几个
|
|
89
|
+
* 供应链写入口同一性质,界面通道持续排除(`UI_EXCLUDED` 里有逐条理由),
|
|
90
|
+
* 桥只对主窗口那份文档开放。宿主那侧还是老方法(`protocol.invoke` 原样转发),
|
|
91
|
+
* 校验(名字形状、模型 id 去重、正整数)仍在 settings 插件里。
|
|
92
|
+
*/
|
|
93
|
+
'saveProvider',
|
|
94
|
+
'removeProvider',
|
|
95
|
+
'setProviderKey',
|
|
96
|
+
/**
|
|
97
|
+
* 换一份配置文件用(写 settings.json 的 configFile 字段)。与上面三件同一先例:
|
|
98
|
+
* 换掉的是「以后读哪一份配置」,等于整份端点与密钥引用都换掉,所以只对主窗口那份文档开放。
|
|
99
|
+
* 空串 = 回出厂那份(设置页的「恢复默认」)。文件本身不动,也不覆盖。
|
|
100
|
+
*/
|
|
101
|
+
'setConfigFile',
|
|
102
|
+
/**
|
|
103
|
+
* 弹系统文件选择框挑一份配置文件,**只返回路径、不碰配置**(取消给空串)。
|
|
104
|
+
*
|
|
105
|
+
* 与 setConfigFile 的分工照 pickDirectory / chooseDirectory 那一对:取路径与改状态
|
|
106
|
+
* 分成两件事,用户取消时什么都不会发生。过滤后缀(yaml/yml/json)由主进程定死,
|
|
107
|
+
* 页面递不进来任何过滤条件。
|
|
108
|
+
*/
|
|
109
|
+
'pickConfigFile',
|
|
110
|
+
/**
|
|
111
|
+
* 权限模式(只读 / 自动编辑 / 完全访问)。
|
|
112
|
+
*
|
|
113
|
+
* 为什么在这里而不在界面通道:`UI_EXCLUDED` 里写明了理由——审批策略是安全闸门本身,
|
|
114
|
+
* 「能让页面改它,前面所有闸门就都成了摆设」。但旧桌面版的输入框里本来就有这根能切的
|
|
115
|
+
* 旋钮(`desktop/src/renderer/Composer.tsx` 的 `policyOpen` → `proxy.setPolicy`),
|
|
116
|
+
* 壳不能比旧版少一样东西,所以按同一先例挪到桥上:**只有装了 preload 的桌面窗口
|
|
117
|
+
* 那份文档**够得着,浏览器页签 / 远程页面够不着。实参是三档枚举(下面 POLICIES),
|
|
118
|
+
* 到了宿主那侧仍走 `approval.setPolicy`(它自己会发一条 system 条目并记审计)。
|
|
119
|
+
*/
|
|
120
|
+
'setPolicy',
|
|
121
|
+
/**
|
|
122
|
+
* 审批审阅者(本人 / AI 复核)。与 setPolicy 同一条理由住在桥上:切换审阅者 =
|
|
123
|
+
* 决定「谁来裁」,同样是安全闸门本身。宿主那侧走 `approval.setReviewer`。
|
|
124
|
+
*/
|
|
125
|
+
'setReviewer',
|
|
126
|
+
/**
|
|
127
|
+
* 打包权限预设(沙箱 + 权限模式 + 审阅者三合一)。一次写三个旋钮,改的是闸门组合,
|
|
128
|
+
* 理由同上;宿主的写入口是 `permissionPermits.use()`(它自己记审计与系统条目)。
|
|
129
|
+
*/
|
|
130
|
+
'usePermissionPreset',
|
|
131
|
+
/** 设新会话默认的打包预设(只影响之后新建的会话)。 */
|
|
132
|
+
'setDefaultPermissionPreset',
|
|
133
|
+
'sessionUsage',
|
|
134
|
+
'notify',
|
|
135
|
+
'restartHost',
|
|
136
|
+
'quit',
|
|
137
|
+
/**
|
|
138
|
+
* 终端(dock 通道的第三档)。**这是终端唯一的入口**:界面 HTTP 面里没有 term-*
|
|
139
|
+
* (放行面的 op 枚举是 `DOCK_UI_OPS`,只有读 + 写),所以"起一个 shell 进程"
|
|
140
|
+
* 这件事只在装了 preload 的桌面窗口里做得到。实参是 `[op, payload]`,
|
|
141
|
+
* payload 由宿主插件自己净化(路径限 cwd、shell 白名单)。
|
|
142
|
+
*/
|
|
143
|
+
'terminal',
|
|
144
|
+
/**
|
|
145
|
+
* 内嵌浏览器(dock 的浏览器页签,可多开):`[id, visible, rect?]`——显示/隐藏那一台
|
|
146
|
+
* `WebContentsView` 覆盖层,并把它摆到页面报上来的矩形处(页面坐标 = 窗口内容坐标)。
|
|
147
|
+
*
|
|
148
|
+
* 为什么 id 排在最前:实参省略**只能从尾部开始**(见 {@link validateNativeCall}),
|
|
149
|
+
* 而「隐藏某一台」时后面那个 rect 要空着——id 放尾部就没法既给 id、又空着 rect
|
|
150
|
+
* (中间空一个会被当成错位的脏形状拒掉)。
|
|
151
|
+
*/
|
|
152
|
+
'dockBrowser',
|
|
153
|
+
/**
|
|
154
|
+
* 内嵌浏览器导航:`[url, action, id?]`(load / back / forward / reload;协议在主进程
|
|
155
|
+
* 再校验一次)。url 只在 load 时用;id 缺省 `'main'`(旧渲染层的单例视图走这条)。
|
|
156
|
+
* 这条三个实参从不省略,所以 id 放尾部——与上一条顺序不同,理由见上。
|
|
157
|
+
*/
|
|
158
|
+
'browserNav',
|
|
159
|
+
/**
|
|
160
|
+
* 关掉一台内嵌浏览器视图(页签关掉 / 切会话时调):`[id]`。
|
|
161
|
+
*
|
|
162
|
+
* 为什么要这一条而不是靠 `dockBrowser(false)`:隐藏只是从窗口上摘下来,视图与它
|
|
163
|
+
* 的渲染进程都还活着。页签没了就得真的销毁,否则开开关关一路攒下去。
|
|
164
|
+
*/
|
|
165
|
+
'browserClose',
|
|
166
|
+
/**
|
|
167
|
+
* 检查更新:问一次更新源,返回当前状态(形状见 {@link NATIVE_EVENTS} 里的 `update-status`)。
|
|
168
|
+
*
|
|
169
|
+
* 为什么整套更新住在桥而不是界面通道:**检查**宿主做得来(`core/update-check`),
|
|
170
|
+
* **装**做不了——下载要落文件、装要起安装程序、装完要退出应用,三件都是 Electron
|
|
171
|
+
* 主进程的事。把「检查」放一边、「安装」放另一边,两边各存一份状态迟早对不上;
|
|
172
|
+
* 索性整套交给主进程:它自己排期(现读 `~/.dsc/settings.json` 的 `updateCheck`)、
|
|
173
|
+
* 自己下载、自己起安装程序。宿主那侧只有设置页那颗按钮与 `/update` 命令在问版本号。
|
|
174
|
+
*/
|
|
175
|
+
'checkUpdate',
|
|
176
|
+
/**
|
|
177
|
+
* 就地更新:下载安装器(进度经 `update-progress` 推)→ 启动安装程序 → 退出本应用。
|
|
178
|
+
*
|
|
179
|
+
* 下载地址由主进程从**它自己拉到的发布资产**里挑,页面只说「装」、递不进任何 URL——
|
|
180
|
+
* 与 `installPlugin` 那几条同一取向:能执行外部代码的入口只认既定动作,不收任意地址。
|
|
181
|
+
*/
|
|
182
|
+
'installUpdate',
|
|
183
|
+
];
|
|
184
|
+
/** 桥能推给页面的事件(订阅入口按它白名单,别的名字直接拒)。 */
|
|
185
|
+
export const NATIVE_EVENTS = [
|
|
186
|
+
/** dock 终端输出流:`{ id, data }`(id 是 term-spawn 给的会话 id)。 */
|
|
187
|
+
'dock-data',
|
|
188
|
+
/**
|
|
189
|
+
* 内嵌浏览器那一台的状态:`{ id, url, title, canGoBack, canGoForward, loading }`
|
|
190
|
+
* (id 是页签给的视图 id;前进/后退/页面内跳转/标题变化/加载起止都推)。
|
|
191
|
+
*/
|
|
192
|
+
'browser-state',
|
|
193
|
+
/**
|
|
194
|
+
* 页面自己要开新窗口(`window.open` / `target="_blank"`):`{ id, url }`。
|
|
195
|
+
*
|
|
196
|
+
* 主进程一律 deny 掉原生弹窗,把请求转成这条事件,由壳开一张新浏览器页签——
|
|
197
|
+
* 旧做法是就地 `loadURL` 到同一台视图,那等于把用户正在看的页面顶掉。
|
|
198
|
+
*/
|
|
199
|
+
'browser-open-requested',
|
|
200
|
+
/**
|
|
201
|
+
* 更新状态:`{ status, version?, pageUrl?, assetName?, size?, error? }`。
|
|
202
|
+
*
|
|
203
|
+
* `status` 五档:`idle`(这一档不自动查)/ `checking` / `latest` / `available` / `error`。
|
|
204
|
+
* 排期检查与手动 `checkUpdate` 的结果都从这里推;壳挂载时先 `checkUpdate` 取一次当前值
|
|
205
|
+
* (事件是「之后的变化」,错过开机那一次就再也没有了),再订阅这条。
|
|
206
|
+
*/
|
|
207
|
+
'update-status',
|
|
208
|
+
/**
|
|
209
|
+
* 下载进度:`{ received, total, percent }`(`total` 未知时 `percent` 为 null)。
|
|
210
|
+
*
|
|
211
|
+
* 为什么不复用 `update-status`:进度是高频小包,状态是低频事实,混在一条事件里会让
|
|
212
|
+
* 订阅方每次进度回调都要重判一遍状态。
|
|
213
|
+
*/
|
|
214
|
+
'update-progress',
|
|
215
|
+
/**
|
|
216
|
+
* 宿主请壳开一张浏览器页签并聚焦:`{ id, url }`。
|
|
217
|
+
*
|
|
218
|
+
* 方向与别的条目相反:这条是**桌面主进程发起**的(agent 那侧要一台露出来的视图,
|
|
219
|
+
* 而页签与原生视图的矩形只有壳量得出来)。壳收到就按「用户点了新建浏览器页签」建一张,
|
|
220
|
+
* 并**照用这个 id**——id 由桌面侧发号(`agent-N`),壳自己再起一个名字,宿主下一次
|
|
221
|
+
* `browser-call` 就对不上号了。
|
|
222
|
+
*/
|
|
223
|
+
DOCK_TAB_OPEN_EVENT,
|
|
224
|
+
/**
|
|
225
|
+
* 宿主请壳关掉某张浏览器页签:`{ id }`。
|
|
226
|
+
*
|
|
227
|
+
* 为什么关页签要绕壳:只销毁原生视图的话,侧栏会留下一个点不开的空页签。
|
|
228
|
+
* 壳那边把页签一并收掉,这一台才算真的下线了(视图本身的销毁仍在主进程,见
|
|
229
|
+
* `browserClose`)。
|
|
230
|
+
*/
|
|
231
|
+
DOCK_TAB_CLOSE_EVENT,
|
|
232
|
+
];
|
|
233
|
+
/** 事件名查表。 */
|
|
234
|
+
export const NATIVE_EVENT_SET = new Set(NATIVE_EVENTS);
|
|
235
|
+
/** 查表用的集合。 */
|
|
236
|
+
export const NATIVE_OP_SET = new Set(NATIVE_OPS);
|
|
237
|
+
/** 路径 / 链接的长度上限。 */
|
|
238
|
+
const MAX_PATH = 4096;
|
|
239
|
+
/** 会话 id 的长度上限。 */
|
|
240
|
+
const MAX_ID = 200;
|
|
241
|
+
/** 通知标题 / 正文的长度上限(正文比标题长一档)。 */
|
|
242
|
+
const MAX_NOTIFY_TITLE = 200;
|
|
243
|
+
const MAX_NOTIFY_BODY = 1000;
|
|
244
|
+
/** 终端 payload 的上限:里面是一行命令或一段按键,8KB 富余得多。 */
|
|
245
|
+
const MAX_TERM_PAYLOAD = 8192;
|
|
246
|
+
/** 市场源清单的上限:源数、每项名字与地址的长度(几何级地够用,手填撑不破)。 */
|
|
247
|
+
const MAX_MARKET_SOURCES = 50;
|
|
248
|
+
const MAX_SOURCE_NAME = 100;
|
|
249
|
+
const MAX_SOURCE_URL = 2048;
|
|
250
|
+
/** 端点草稿的上限:名字、地址、模型清单加起来;几百个模型也撑不破 64KB。 */
|
|
251
|
+
const MAX_PROVIDER_NAME = 200;
|
|
252
|
+
const MAX_PROVIDER_URL = 4096;
|
|
253
|
+
const MAX_PROVIDER_DRAFT = 65536;
|
|
254
|
+
/** API key 的长度上限(真实 key 几十字符,4KB 富余得多)。 */
|
|
255
|
+
const MAX_PROVIDER_KEY = 4096;
|
|
256
|
+
const THEME_SOURCES = ['dark', 'light', 'system'];
|
|
257
|
+
const WORKSPACE_KINDS = ['terminal', 'explorer', 'vscode'];
|
|
258
|
+
/**
|
|
259
|
+
* 权限模式的三档(与 `contract.ts` 的 `ApprovalPolicy` 一字不差)。
|
|
260
|
+
*
|
|
261
|
+
* 写成字面量数组而不是 import 那个类型:桥的校验住不了类型那侧(实参从网络来),
|
|
262
|
+
* 枚举必须落成运行时的值。宿主那侧`satisfies ApprovalPolicy[]` 会让漏一档编不过。
|
|
263
|
+
*/
|
|
264
|
+
const POLICIES = ['readonly', 'auto-edit', 'full-access'];
|
|
265
|
+
/** 审阅者两档(同样与 `contract.ts` 的 `ApprovalReviewer` 一字不差)。 */
|
|
266
|
+
const REVIEWERS = ['user', 'auto-review'];
|
|
267
|
+
/** 内嵌浏览器的导航动作(与主进程 `navigateDockBrowser` 认的那几个一字不差)。 */
|
|
268
|
+
const NAV_ACTIONS = ['load', 'back', 'forward', 'reload'];
|
|
269
|
+
/** 页面报上来的矩形上限(窗口再大也到不了;只是挡住存坏的脏值)。 */
|
|
270
|
+
const RECT_MAX = 100_000;
|
|
271
|
+
/**
|
|
272
|
+
* 每个操作的实参规格:数组长度就是参数个数上限,下标就是参数位置。
|
|
273
|
+
*
|
|
274
|
+
* 类型写成 `Readonly<Record<NativeOp, …>>`:少写一个、多写一个不存在的操作都编不过。
|
|
275
|
+
*/
|
|
276
|
+
export const NATIVE_ARG_SPECS = {
|
|
277
|
+
/** 原生窗口控件区的底色与图标色,两个都必须压平过的 `#rrggbb`(系统那侧不收 alpha)。 */
|
|
278
|
+
setWindowChrome: [{ shape: { kind: 'hex' } }, { shape: { kind: 'hex' } }],
|
|
279
|
+
/** 原生弹层(下拉、右键菜单)的深浅;跟随系统时原样透传,让 OS 自己翻面。 */
|
|
280
|
+
setThemeSource: [{ shape: { kind: 'enum', values: THEME_SOURCES } }],
|
|
281
|
+
/** 弹系统目录选择框,选中就切工作目录并重启宿主;取消给 null。 */
|
|
282
|
+
chooseDirectory: [],
|
|
283
|
+
/**
|
|
284
|
+
* 弹系统目录选择框,**只返回路径、不碰宿主**(取消给空串)。
|
|
285
|
+
*
|
|
286
|
+
* 与 chooseDirectory 的分工:那个的语义是「切工作目录」(含重启宿主与整页重载),
|
|
287
|
+
* 旧渲染层还在用它;壳的「添加工作区」要的是「挑一个目录、在那儿开一条会话」——
|
|
288
|
+
* 目录是会话自己的数据,不必重启宿主,所以需要这个没有副作用的取路径口。
|
|
289
|
+
*/
|
|
290
|
+
pickDirectory: [],
|
|
291
|
+
/**
|
|
292
|
+
* 记一笔「最近用过的工作区」(写 desktop.json 的 recentCwds / lastCwd)。
|
|
293
|
+
*
|
|
294
|
+
* 谁调它:界面在某个目录里开了会话时(含「添加工作区」选的目录)。宿主管会话、
|
|
295
|
+
* 桌面主进程管这份记忆——所以这一笔记账得由界面显式报一声,别让两边各存一份。
|
|
296
|
+
*/
|
|
297
|
+
rememberCwd: [{ shape: { kind: 'string', max: MAX_PATH } }],
|
|
298
|
+
/** 切到指定工作目录(不弹框);失败给一句原因。 */
|
|
299
|
+
switchCwd: [{ shape: { kind: 'string', max: MAX_PATH } }],
|
|
300
|
+
/** 最近用过的工作目录,最新的排最前。 */
|
|
301
|
+
recentCwds: [],
|
|
302
|
+
/** 把一条从最近工作目录里撤下(删工作区时把空组从侧栏撤下)。 */
|
|
303
|
+
removeRecentCwd: [{ shape: { kind: 'string', max: MAX_PATH } }],
|
|
304
|
+
/** 用系统文件管理器打开一个**绝对**路径;返回空串表示成功。 */
|
|
305
|
+
openPath: [{ shape: { kind: 'string', max: MAX_PATH } }],
|
|
306
|
+
/** 用系统浏览器打开一个 http/https 链接(协议在主机侧再判一次)。 */
|
|
307
|
+
openExternal: [{ shape: { kind: 'string', max: MAX_PATH } }],
|
|
308
|
+
/**
|
|
309
|
+
* 用终端 / 资源管理器 / VS Code 打开一个工作区。
|
|
310
|
+
*
|
|
311
|
+
* 第二个实参是**要打开哪个目录**:壳传的是它自己显示的那个当前工作区(当前会话的 cwd)。
|
|
312
|
+
* 可省略——省略就回到宿主进程的启动目录(旧桌面版走的就是这条,行为不变)。壳必须传:
|
|
313
|
+
* 常驻多会话模型下会话各有各的 cwd,进程启动目录不是用户眼里的「当前工作区」。
|
|
314
|
+
*/
|
|
315
|
+
openWorkspace: [
|
|
316
|
+
{ shape: { kind: 'enum', values: WORKSPACE_KINDS } },
|
|
317
|
+
{ shape: { kind: 'string', max: MAX_PATH }, optional: true },
|
|
318
|
+
],
|
|
319
|
+
/** 弹系统文件选择器,把选中的技能(含 SKILL.md 的目录或 .md 文件)复制进 ~/.dsc/skills/;返回装好的名字(取消给空表)。 */
|
|
320
|
+
installSkill: [],
|
|
321
|
+
/** 弹系统文件选择器,把选中的 .js 插件复制进 ~/.dsc/plugins/;返回装好的文件名(取消给空表)。 */
|
|
322
|
+
installPlugin: [],
|
|
323
|
+
/** 从市场源安装一个技能到 ~/.dsc/skills/(转给宿主,与旧界面同一个方法)。 */
|
|
324
|
+
installMarketSkill: [{ shape: { kind: 'string', max: MAX_ID } }, { shape: { kind: 'string', max: MAX_ID } }],
|
|
325
|
+
/** 覆盖市场源清单(写 ~/.dsc/settings.json;形状是 [{name, url}],逐项校验)。 */
|
|
326
|
+
setMarketSources: [{ shape: { kind: 'marketSources' } }],
|
|
327
|
+
/** 落一条第三方界面插件的信任记录(插件中心信任卡「确认信任」的终点)。 */
|
|
328
|
+
setUiTrust: [{ shape: { kind: 'string', max: MAX_ID } }],
|
|
329
|
+
/** 切权限模式:三档枚举之一(宿主那侧仍是 `approval.setPolicy`,它自己记审计与系统条目)。 */
|
|
330
|
+
setPolicy: [{ shape: { kind: 'enum', values: POLICIES } }],
|
|
331
|
+
/** 切审阅者:两档枚举之一(宿主那侧是 `approval.setReviewer`)。 */
|
|
332
|
+
setReviewer: [{ shape: { kind: 'enum', values: REVIEWERS } }],
|
|
333
|
+
/** 切打包权限预设:预设名(宿主那侧查表,认不出的名字当场报错,不做静默回落)。 */
|
|
334
|
+
usePermissionPreset: [{ shape: { kind: 'string', max: 64 } }],
|
|
335
|
+
/** 设新会话默认的打包预设(空串 = 清掉,回到按两个旋钮各自的默认)。 */
|
|
336
|
+
setDefaultPermissionPreset: [{ shape: { kind: 'string', max: 64 } }],
|
|
337
|
+
/**
|
|
338
|
+
* 新增或编辑一个端点(写 config.yaml):一整份 `ProviderDraft`。
|
|
339
|
+
* 形状只查「是可序列化的 JSON 且不超过 64KB」——字段级校验(名字形状、模型 id 去重、
|
|
340
|
+
* 正整数)在宿主 settings 插件里,那里才是这些规矩的真源。
|
|
341
|
+
*/
|
|
342
|
+
saveProvider: [{ shape: { kind: 'json', maxBytes: MAX_PROVIDER_DRAFT } }],
|
|
343
|
+
/** 删一个端点(写 config.yaml;默认端点被删时宿主自动改指)。 */
|
|
344
|
+
removeProvider: [{ shape: { kind: 'string', max: MAX_PROVIDER_NAME } }],
|
|
345
|
+
/**
|
|
346
|
+
* 写入或清除端点的 API key(写 ~/.dsc/credentials.yaml):第二个实参 `null` 是
|
|
347
|
+
* **清除**而不是省略——所以它的形状是 stringOrNull 而不是可选的 string。
|
|
348
|
+
*/
|
|
349
|
+
setProviderKey: [
|
|
350
|
+
{ shape: { kind: 'string', max: MAX_PROVIDER_NAME } },
|
|
351
|
+
{ shape: { kind: 'stringOrNull', max: MAX_PROVIDER_KEY } },
|
|
352
|
+
],
|
|
353
|
+
/** 换一份配置文件用:一条绝对路径,空串 = 回出厂那份。 */
|
|
354
|
+
setConfigFile: [{ shape: { kind: 'string', max: MAX_PATH } }],
|
|
355
|
+
/** 弹系统文件选择框挑配置文件:不收任何实参(过滤条件由主进程定死)。 */
|
|
356
|
+
pickConfigFile: [],
|
|
357
|
+
/** 当前会话在宿主用量日志里的累计(只读;没有记录时 null)。 */
|
|
358
|
+
sessionUsage: [{ shape: { kind: 'string', max: MAX_ID } }],
|
|
359
|
+
/** 弹一条系统通知;字段只有标题与正文两项。 */
|
|
360
|
+
notify: [{ shape: { kind: 'notify' } }],
|
|
361
|
+
/** 以当前工作目录重启宿主。 */
|
|
362
|
+
restartHost: [],
|
|
363
|
+
/** 退出应用(关主窗口 → 优雅停宿主 → quit)。 */
|
|
364
|
+
quit: [],
|
|
365
|
+
/**
|
|
366
|
+
* 终端:`[op, payload]`。op 钉死在 `DOCK_TERM_OPS` 那三个上(spawn / input / kill),
|
|
367
|
+
* payload 是给宿主插件的小对象——它自己再净化一遍(路径限 cwd、shell 走白名单)。
|
|
368
|
+
*/
|
|
369
|
+
terminal: [
|
|
370
|
+
{ shape: { kind: 'enum', values: DOCK_TERM_OPS } },
|
|
371
|
+
{ shape: { kind: 'json', maxBytes: MAX_TERM_PAYLOAD }, optional: true },
|
|
372
|
+
],
|
|
373
|
+
/**
|
|
374
|
+
* 内嵌浏览器:`[id, visible, rect?]`。visible 为真时 rect 必给(摆哪儿);
|
|
375
|
+
* 为假时 rect 省略(这一台先不显示,视图留着,切回来页面还在)。id 是壳给那一台
|
|
376
|
+
* 起的名字(现在就是页签 id)——旧渲染层走的是直连 IPC,不经过这里。
|
|
377
|
+
*/
|
|
378
|
+
dockBrowser: [
|
|
379
|
+
{ shape: { kind: 'string', max: MAX_ID } },
|
|
380
|
+
{ shape: { kind: 'bool' } },
|
|
381
|
+
{ shape: { kind: 'rect' }, optional: true },
|
|
382
|
+
],
|
|
383
|
+
/** 内嵌浏览器导航:`[url, action, id?]`(url 只在 load 时用,协议在主进程校验)。 */
|
|
384
|
+
browserNav: [
|
|
385
|
+
{ shape: { kind: 'string', max: MAX_PATH } },
|
|
386
|
+
{ shape: { kind: 'enum', values: NAV_ACTIONS } },
|
|
387
|
+
{ shape: { kind: 'string', max: MAX_ID }, optional: true },
|
|
388
|
+
],
|
|
389
|
+
/** 关掉一台内嵌浏览器视图:`[id]`(页签关了 / 切会话了就真的销毁,别只藏起来)。 */
|
|
390
|
+
browserClose: [{ shape: { kind: 'string', max: MAX_ID } }],
|
|
391
|
+
/** 检查更新:无实参。更新源与本地版本都由主进程定,页面无从指定。 */
|
|
392
|
+
checkUpdate: [],
|
|
393
|
+
/** 就地更新:无实参(地址由主进程从自己拉到的发布资产里挑)。 */
|
|
394
|
+
installUpdate: [],
|
|
395
|
+
};
|
|
396
|
+
/**
|
|
397
|
+
* 校验一次桥调用。
|
|
398
|
+
*
|
|
399
|
+
* 与界面通道的 `validateUiArgs` 同口径:参数个数上限、逐个的 JSON 类型、长度上限、
|
|
400
|
+
* 枚举取值、`#rrggbb`;尾部省略只能从尾部开始,中间空一个会让后面的参数错位(正是要拒的形状)。
|
|
401
|
+
*
|
|
402
|
+
* @param op 调用方给的操作名(来自页面,任何形状都可能)
|
|
403
|
+
* @param args 调用方给的实参(同上)
|
|
404
|
+
*/
|
|
405
|
+
export function validateNativeCall(op, args) {
|
|
406
|
+
if (typeof op !== 'string' || !NATIVE_OP_SET.has(op)) {
|
|
407
|
+
return { ok: false, error: `原生桥不认识这个操作:${describeOp(op)}` };
|
|
408
|
+
}
|
|
409
|
+
const name = op;
|
|
410
|
+
const list = args === undefined || args === null ? [] : args;
|
|
411
|
+
if (!Array.isArray(list))
|
|
412
|
+
return { ok: false, error: `原生桥:${name} 的实参必须是数组` };
|
|
413
|
+
const spec = NATIVE_ARG_SPECS[name];
|
|
414
|
+
if (list.length > spec.length) {
|
|
415
|
+
return { ok: false, error: `原生桥:${name} 最多收 ${String(spec.length)} 个实参,收到 ${String(list.length)} 个` };
|
|
416
|
+
}
|
|
417
|
+
const checked = [];
|
|
418
|
+
for (let index = 0; index < list.length; index += 1) {
|
|
419
|
+
const value = list[index];
|
|
420
|
+
const arg = spec[index];
|
|
421
|
+
// stringOrNull:null 是**取值**不是省略(setProviderKey 的「清除」走这条)。
|
|
422
|
+
if (value === null && arg.shape.kind === 'stringOrNull') {
|
|
423
|
+
checked.push(null);
|
|
424
|
+
continue;
|
|
425
|
+
}
|
|
426
|
+
if (value === null || value === undefined) {
|
|
427
|
+
if (arg.optional !== true) {
|
|
428
|
+
return { ok: false, error: `原生桥:${name} 的第 ${String(index + 1)} 个实参不能为空` };
|
|
429
|
+
}
|
|
430
|
+
for (let later = index + 1; later < list.length; later += 1) {
|
|
431
|
+
const rest = list[later];
|
|
432
|
+
if (rest !== null && rest !== undefined) {
|
|
433
|
+
return { ok: false, error: `原生桥:${name} 的第 ${String(index + 1)} 个实参省略了,但第 ${String(later + 1)} 个还在(省略只能从尾部开始)` };
|
|
434
|
+
}
|
|
435
|
+
}
|
|
436
|
+
break;
|
|
437
|
+
}
|
|
438
|
+
const problem = checkShape(arg.shape, value);
|
|
439
|
+
if (problem !== null) {
|
|
440
|
+
return { ok: false, error: `原生桥:${name} 的第 ${String(index + 1)} 个实参${problem}` };
|
|
441
|
+
}
|
|
442
|
+
checked.push(value);
|
|
443
|
+
}
|
|
444
|
+
for (let index = checked.length; index < spec.length; index += 1) {
|
|
445
|
+
if (spec[index].optional !== true) {
|
|
446
|
+
return { ok: false, error: `原生桥:${name} 的第 ${String(index + 1)} 个实参是必传的` };
|
|
447
|
+
}
|
|
448
|
+
}
|
|
449
|
+
return { ok: true, op: name, args: checked };
|
|
450
|
+
}
|
|
451
|
+
/**
|
|
452
|
+
* 把一个不认识的操作名说成人能读的样子。
|
|
453
|
+
*
|
|
454
|
+
* 为什么不直接 `String(op)`:`String({})` 是 `[object Object]`、`String(Symbol())` 会抛。
|
|
455
|
+
* 这里只给"看得出是什么"的那一档,其余按类型说。
|
|
456
|
+
*/
|
|
457
|
+
function describeOp(op) {
|
|
458
|
+
if (typeof op === 'string')
|
|
459
|
+
return op;
|
|
460
|
+
if (op === null)
|
|
461
|
+
return 'null';
|
|
462
|
+
if (typeof op === 'number' || typeof op === 'boolean')
|
|
463
|
+
return String(op);
|
|
464
|
+
if (typeof op === 'undefined')
|
|
465
|
+
return 'undefined';
|
|
466
|
+
return Array.isArray(op) ? '数组' : typeof op;
|
|
467
|
+
}
|
|
468
|
+
/** 校验一个值是不是这个形状;不是就回一句人话。 */
|
|
469
|
+
function checkShape(shape, value) {
|
|
470
|
+
switch (shape.kind) {
|
|
471
|
+
case 'string':
|
|
472
|
+
if (typeof value !== 'string')
|
|
473
|
+
return '必须是字符串';
|
|
474
|
+
if (value.length > shape.max)
|
|
475
|
+
return `是字符串但太长(${String(value.length)} > ${String(shape.max)} 字符)`;
|
|
476
|
+
return null;
|
|
477
|
+
case 'stringOrNull':
|
|
478
|
+
if (value === null)
|
|
479
|
+
return null;
|
|
480
|
+
if (typeof value !== 'string')
|
|
481
|
+
return '必须是字符串或 null';
|
|
482
|
+
if (value.length > shape.max)
|
|
483
|
+
return `是字符串但太长(${String(value.length)} > ${String(shape.max)} 字符)`;
|
|
484
|
+
return null;
|
|
485
|
+
case 'bool':
|
|
486
|
+
return typeof value === 'boolean' ? null : '必须是布尔值';
|
|
487
|
+
case 'hex':
|
|
488
|
+
// 只收压平过的 #rrggbb:半透明颜色到了系统那侧会被丢掉,宁可当场拒。
|
|
489
|
+
return typeof value === 'string' && /^#[0-9a-fA-F]{6}$/.test(value) ? null : '必须是 #rrggbb 形状的颜色';
|
|
490
|
+
case 'enum':
|
|
491
|
+
return typeof value === 'string' && shape.values.includes(value)
|
|
492
|
+
? null
|
|
493
|
+
: `必须是这几个值之一:${shape.values.join(' / ')}`;
|
|
494
|
+
case 'notify': {
|
|
495
|
+
if (typeof value !== 'object' || value === null || Array.isArray(value))
|
|
496
|
+
return '必须是 { title, body? } 对象';
|
|
497
|
+
const record = value;
|
|
498
|
+
if (typeof record['title'] !== 'string')
|
|
499
|
+
return '的 title 必须是字符串';
|
|
500
|
+
if (record['title'].trim() === '')
|
|
501
|
+
return '的 title 不能是空串';
|
|
502
|
+
if (record['title'].length > MAX_NOTIFY_TITLE)
|
|
503
|
+
return `的 title 太长(> ${String(MAX_NOTIFY_TITLE)} 字符)`;
|
|
504
|
+
const body = record['body'];
|
|
505
|
+
if (body !== undefined && typeof body !== 'string')
|
|
506
|
+
return '的 body 必须是字符串';
|
|
507
|
+
if (typeof body === 'string' && body.length > MAX_NOTIFY_BODY)
|
|
508
|
+
return `的 body 太长(> ${String(MAX_NOTIFY_BODY)} 字符)`;
|
|
509
|
+
return null;
|
|
510
|
+
}
|
|
511
|
+
case 'marketSources': {
|
|
512
|
+
if (!Array.isArray(value))
|
|
513
|
+
return '必须是市场源数组([{name, url}])';
|
|
514
|
+
if (value.length === 0)
|
|
515
|
+
return '至少要有一个市场源';
|
|
516
|
+
if (value.length > MAX_MARKET_SOURCES)
|
|
517
|
+
return `里最多 ${String(MAX_MARKET_SOURCES)} 个市场源(收到 ${String(value.length)} 个)`;
|
|
518
|
+
for (const entry of value) {
|
|
519
|
+
if (typeof entry !== 'object' || entry === null || Array.isArray(entry))
|
|
520
|
+
return '的每一项必须是 {name, url} 对象';
|
|
521
|
+
const record = entry;
|
|
522
|
+
const name = record['name'];
|
|
523
|
+
const url = record['url'];
|
|
524
|
+
if (typeof name !== 'string' || name.trim() === '' || name.length > MAX_SOURCE_NAME) {
|
|
525
|
+
return `的每一项要带非空的 name(≤${String(MAX_SOURCE_NAME)} 字符)`;
|
|
526
|
+
}
|
|
527
|
+
if (typeof url !== 'string' || url.trim() === '' || url.length > MAX_SOURCE_URL) {
|
|
528
|
+
return `的每一项要带非空的 url(≤${String(MAX_SOURCE_URL)} 字符)`;
|
|
529
|
+
}
|
|
530
|
+
}
|
|
531
|
+
return null;
|
|
532
|
+
}
|
|
533
|
+
case 'rect': {
|
|
534
|
+
if (typeof value !== 'object' || value === null || Array.isArray(value))
|
|
535
|
+
return '必须是 { x, y, width, height } 对象';
|
|
536
|
+
const record = value;
|
|
537
|
+
for (const key of ['x', 'y', 'width', 'height']) {
|
|
538
|
+
const number = record[key];
|
|
539
|
+
if (typeof number !== 'number' || !Number.isFinite(number) || Math.abs(number) > RECT_MAX) {
|
|
540
|
+
return `的 ${key} 必须是有界的有限数`;
|
|
541
|
+
}
|
|
542
|
+
}
|
|
543
|
+
return null;
|
|
544
|
+
}
|
|
545
|
+
case 'json': {
|
|
546
|
+
const text = jsonText(value);
|
|
547
|
+
if (text === null)
|
|
548
|
+
return '不是可序列化的 JSON 值';
|
|
549
|
+
if (text.length > shape.maxBytes)
|
|
550
|
+
return `是 JSON 但太长(${String(text.length)} > ${String(shape.maxBytes)} 字符)`;
|
|
551
|
+
return null;
|
|
552
|
+
}
|
|
553
|
+
}
|
|
554
|
+
}
|
|
555
|
+
/** 一段 JSON 文本;序列化不了(循环引用、BigInt、函数)给 null。 */
|
|
556
|
+
function jsonText(value) {
|
|
557
|
+
try {
|
|
558
|
+
return JSON.stringify(value) ?? null;
|
|
559
|
+
}
|
|
560
|
+
catch {
|
|
561
|
+
return null;
|
|
562
|
+
}
|
|
563
|
+
}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
/** dsc 自己的配置目录(config.yaml / credentials.yaml 住这里)。 */
|
|
2
|
+
export declare const DSC_HOME: string;
|
|
3
|
+
/** dsc 自有存储下的绝对路径(config、会话、用量、插件……隔离测试与迁移的单一坐标)。 */
|
|
4
|
+
export declare function dscPath(...parts: string[]): string;
|
|
5
|
+
/** 判定结果:null = 允许;字符串 = 拒绝原因(会原样进工具结果,模型看得见)。 */
|
|
6
|
+
export type PathVerdict = string | null;
|
|
7
|
+
/** 目标是不是在工作目录内(跟着 symlink 判,堵住「建个软链指到工作区外」这条路)。 */
|
|
8
|
+
export declare function isInsideCwd(cwd: string, target: string): boolean;
|
|
9
|
+
/** 读这个路径要不要拒。 */
|
|
10
|
+
export declare function readBlockReason(target: string): PathVerdict;
|
|
11
|
+
/** 写这个路径要不要硬拒(硬拒 = 任何模式都不放行,包括审批)。 */
|
|
12
|
+
export declare function writeHardBlockReason(target: string): PathVerdict;
|
|
13
|
+
/** 这个写操作是不是「说明书」类改动(永远要弹一次卡,不受权限模式影响)。 */
|
|
14
|
+
export declare function isProtectedInstruction(target: string, cwd: string): PathVerdict;
|
|
15
|
+
/** 记录一次读取(read 工具执行后调用),带上当时的修改时间。按会话记账(0.6.48)。 */
|
|
16
|
+
export declare function noteRead(target: string, sessionId: string): void;
|
|
17
|
+
/** 记录一次写入(write/edit 成功后调用),免得刚写完的文件被自己拦成「已变」。 */
|
|
18
|
+
export declare function noteWrite(target: string, sessionId: string): void;
|
|
19
|
+
/**
|
|
20
|
+
* 整写覆盖前的检查:没读过 / 读之后文件又变了,都不许整写。
|
|
21
|
+
* 只针对已存在的文件;新建文件直接放行。
|
|
22
|
+
*/
|
|
23
|
+
export declare function staleOverwriteReason(target: string, sessionId: string): PathVerdict;
|
|
24
|
+
/**
|
|
25
|
+
* edit 定点替换前的检查(T35):只拦「模型读过、之后又被第三方改过」这一半——
|
|
26
|
+
* edit 自己会现读盘上现值,没读过的文件也允许直接改(这是它与整写覆盖的语义差别)。
|
|
27
|
+
*/
|
|
28
|
+
export declare function staleEditReason(target: string, sessionId: string): PathVerdict;
|
|
29
|
+
/** 清掉某个会话的读取台账(agent 收摊时调用,防长会话窗口里台账无界增长)。 */
|
|
30
|
+
export declare function clearReadLedger(sessionId: string): void;
|
|
31
|
+
/** 主目录(测试与提示词用)。 */
|
|
32
|
+
export declare function userHome(): string;
|