@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,128 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 开发态热更的宿主半侧:轮询产物指纹 → 换代 → 产出「哪几个插件变了」的帧。
|
|
3
|
+
*
|
|
4
|
+
* 为什么是**轮询**而不是 fs.watch / chokidar(与参考实现同一个结论):
|
|
5
|
+
*
|
|
6
|
+
* 1. 文件监听在网络盘/挂载盘上没有 inotify;而构建「写临时文件再 rename」的语义各平台
|
|
7
|
+
* 不同(Windows 上 fs.watch 尤不可靠)。
|
|
8
|
+
* 2. dsc 的开发循环是 `pnpm -C ui-shell build:plugins`(或手改 `lib/ui/plugins/<id>/client.js`),
|
|
9
|
+
* 两者都只会让 stat 变;监听需要构建脚本与宿主多一条 IPC,省下的只是一次 500ms 轮询。
|
|
10
|
+
*
|
|
11
|
+
* 三类信号各管一段:
|
|
12
|
+
*
|
|
13
|
+
* - **成员文件 stat**(每个图行的磁盘路径):构建/手改的最常见形态;
|
|
14
|
+
* - **清单 stat**(`manifest.json` / 第三方 `plugin.json`):新增/删掉一个插件的信号;
|
|
15
|
+
* - **内容摘要 rev**(换代时算):gate 掉「文件被重写但字节没变」的假变更——
|
|
16
|
+
* 这正是内置 rev 改内容摘要之后白拿的一段,改前每轮构建都会把 16 个插件全推一遍。
|
|
17
|
+
*
|
|
18
|
+
* 读不到某个文件(构建 swap 的中间态、或插件目录刚被删)时**不放弃整轮**:记一次
|
|
19
|
+
* 「下轮强制比对」继续读完其余文件。这既保证这期间发生的写入不会丢,也让「已被删掉的
|
|
20
|
+
* 插件」能靠下一轮换代从图里退场(它的 watch 还在删之前那份行表里)。
|
|
21
|
+
*
|
|
22
|
+
* 这个模块不依赖 cordis、不碰 HTTP:可被 node 探针单独驱动(`scripts/ui-hmr-test.mjs`)。
|
|
23
|
+
*
|
|
24
|
+
* @module dsc/core/ui-hmr
|
|
25
|
+
*/
|
|
26
|
+
import { statSync } from 'node:fs';
|
|
27
|
+
function sameStat(a, b) {
|
|
28
|
+
return b !== undefined && a.mtimeMs === b.mtimeMs && a.ctimeMs === b.ctimeMs && a.size === b.size;
|
|
29
|
+
}
|
|
30
|
+
/** 造一个开发态轮询器。 */
|
|
31
|
+
export function createUiHmr(options) {
|
|
32
|
+
const intervalMs = options.pollIntervalMs ?? 500;
|
|
33
|
+
const log = options.log ?? ((line) => { process.stderr.write(`${line}\n`); });
|
|
34
|
+
let baseline = null;
|
|
35
|
+
/**
|
|
36
|
+
* 上一代图(轮询器自己的基线)。
|
|
37
|
+
*
|
|
38
|
+
* 为什么不去问 options.graph() 当「变更前」:`graph()` 本身会做一次非强制收集,
|
|
39
|
+
* 清单类变化(新增/删插件会改 manifest.json)在它那一问里就被收进来了——再 diff 就只剩
|
|
40
|
+
* 「无变化」。基线必须是**上一次推给页面的那一份**,与宿主快照当前的取值无关。
|
|
41
|
+
*/
|
|
42
|
+
let lastGraph = options.graph();
|
|
43
|
+
/** 上一次轮询里有文件读不到(swap 中间态):下一轮无论指纹如何都强制比对一次。 */
|
|
44
|
+
let retryNext = false;
|
|
45
|
+
let stopped = false;
|
|
46
|
+
let timer = null;
|
|
47
|
+
/**
|
|
48
|
+
* 读一遍所有 watch 的指纹。
|
|
49
|
+
*
|
|
50
|
+
* 单个文件读不到(构建 swap 中间态、或插件目录刚被删)**不中断整轮**:
|
|
51
|
+
* 记 `missing` 并继续读别的——整轮中止会让「已被删掉的插件」永远进不了下一轮
|
|
52
|
+
* (它的 watch 也在删之前的那份行表里,越抛越走不到换代)。
|
|
53
|
+
*/
|
|
54
|
+
const syncBaseline = () => {
|
|
55
|
+
const stats = new Map();
|
|
56
|
+
let missing = false;
|
|
57
|
+
for (const watch of options.watches()) {
|
|
58
|
+
try {
|
|
59
|
+
const stat = statSync(watch.path);
|
|
60
|
+
stats.set(watch.id, { mtimeMs: stat.mtimeMs, ctimeMs: stat.ctimeMs, size: stat.size });
|
|
61
|
+
}
|
|
62
|
+
catch {
|
|
63
|
+
missing = true;
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
return { stats, missing };
|
|
67
|
+
};
|
|
68
|
+
const poll = () => {
|
|
69
|
+
if (stopped)
|
|
70
|
+
return;
|
|
71
|
+
const synced = syncBaseline();
|
|
72
|
+
const current = synced.stats;
|
|
73
|
+
if (baseline === null) {
|
|
74
|
+
baseline = current;
|
|
75
|
+
return;
|
|
76
|
+
}
|
|
77
|
+
const known = baseline;
|
|
78
|
+
const touched = retryNext
|
|
79
|
+
|| synced.missing
|
|
80
|
+
|| current.size !== known.size
|
|
81
|
+
|| [...current].some(([id, stat]) => !sameStat(stat, known.get(id)));
|
|
82
|
+
if (!touched)
|
|
83
|
+
return;
|
|
84
|
+
retryNext = false;
|
|
85
|
+
// 元数据变了不代表内容变了(重写相同字节 / touch):换代后按 rev diff,没变就什么都不推。
|
|
86
|
+
options.refresh();
|
|
87
|
+
const after = options.graph();
|
|
88
|
+
const beforeRev = new Map(lastGraph.entries.map((entry) => [entry.id, entry.rev]));
|
|
89
|
+
const afterRev = new Map(after.entries.map((entry) => [entry.id, entry.rev]));
|
|
90
|
+
const changed = after.entries.filter((entry) => beforeRev.get(entry.id) !== entry.rev).map((entry) => entry.id);
|
|
91
|
+
const removed = lastGraph.entries.filter((entry) => !afterRev.has(entry.id)).map((entry) => entry.id);
|
|
92
|
+
const grew = after.rev !== lastGraph.rev;
|
|
93
|
+
lastGraph = after;
|
|
94
|
+
const resync = syncBaseline();
|
|
95
|
+
baseline = resync.stats;
|
|
96
|
+
if (resync.missing)
|
|
97
|
+
retryNext = true;
|
|
98
|
+
if (changed.length === 0 && removed.length === 0 && !grew)
|
|
99
|
+
return;
|
|
100
|
+
options.onFrame({ rev: after.rev, changed, removed, graph: after });
|
|
101
|
+
};
|
|
102
|
+
timer = setInterval(() => {
|
|
103
|
+
try {
|
|
104
|
+
poll();
|
|
105
|
+
}
|
|
106
|
+
catch (error) {
|
|
107
|
+
// 轮询里任何没接住的异常都不该打死定时器:记一行,下一轮继续。
|
|
108
|
+
log(`[ui-hmr] 轮询出错:${error instanceof Error ? error.message : String(error)}`);
|
|
109
|
+
}
|
|
110
|
+
}, intervalMs);
|
|
111
|
+
timer.unref?.();
|
|
112
|
+
return {
|
|
113
|
+
pollNow: () => {
|
|
114
|
+
try {
|
|
115
|
+
poll();
|
|
116
|
+
}
|
|
117
|
+
catch (error) {
|
|
118
|
+
log(`[ui-hmr] 轮询出错:${error instanceof Error ? error.message : String(error)}`);
|
|
119
|
+
}
|
|
120
|
+
},
|
|
121
|
+
stop: () => {
|
|
122
|
+
stopped = true;
|
|
123
|
+
if (timer !== null)
|
|
124
|
+
clearInterval(timer);
|
|
125
|
+
timer = null;
|
|
126
|
+
},
|
|
127
|
+
};
|
|
128
|
+
}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
/** 界面通道放行的方法。 */
|
|
2
|
+
export declare const UI_METHODS: readonly ["submit", "interrupt", "editQueued", "removeQueued", "steerQueued", "compact", "openSession", "newSessionIn", "refreshSessions", "archiveSessions", "restoreSessions", "renameSession", "setSessionPinned", "listUserMessages", "forkSession", "listArchivedSessions", "usageStats", "peekTranscript", "setModel", "listModels", "setEffort", "setMode", "getModelConfig", "discoverModels", "testConnection", "setDefaultModel", "answerApproval", "answerQuestion", "answerPlan", "getUiPrefs", "setUiPrefs", "listPlugins", "setPluginEnabled", "listUiTrust", "listTools", "listSkills", "readSkill", "setSkillEnabled", "browseMarket", "listPresets", "readPreset", "usePreset", "savePreset", "removePreset", "setDefaultPreset", "listPermissionPresets", "getSettingsSections", "getSectionValues", "setSettingValue", "runSettingAction", "listTeammates", "stopTeammate", "messageTeammate", "removeTeammate", "stopBackground", "readBackground", "clearTodos", "goalAction", "listUiCommands", "runUiCommand", "dock"];
|
|
3
|
+
/** 界面通道认得的方法名。 */
|
|
4
|
+
export type UiMethod = (typeof UI_METHODS)[number];
|
|
5
|
+
/** 明确排除、且逐条写了理由的方法(见文件头注释)。 */
|
|
6
|
+
export declare const UI_EXCLUDED: readonly ["runCommand", "setPolicy", "setReviewer", "usePermissionPreset", "setDefaultPermissionPreset", "purgeSessions", "saveProvider", "setConfigFile", "removeProvider", "setProviderKey", "installMarketSkill", "setMarketSources", "setUiTrust"];
|
|
7
|
+
/** 查表用的集合。 */
|
|
8
|
+
export declare const UI_METHOD_SET: ReadonlySet<string>;
|
|
9
|
+
/** 把线上来的方法名收窄成"界面通道允许调用的方法"。 */
|
|
10
|
+
export declare function isUiMethod(method: string): method is UiMethod;
|
|
11
|
+
/** 一个实参的形状。 */
|
|
12
|
+
type ArgShape = {
|
|
13
|
+
kind: 'string';
|
|
14
|
+
max: number;
|
|
15
|
+
} | {
|
|
16
|
+
kind: 'number';
|
|
17
|
+
} | {
|
|
18
|
+
kind: 'boolean';
|
|
19
|
+
} | {
|
|
20
|
+
kind: 'enum';
|
|
21
|
+
values: readonly string[];
|
|
22
|
+
} | {
|
|
23
|
+
kind: 'strings';
|
|
24
|
+
maxItems: number;
|
|
25
|
+
max: number;
|
|
26
|
+
} | {
|
|
27
|
+
kind: 'json';
|
|
28
|
+
maxBytes: number;
|
|
29
|
+
};
|
|
30
|
+
/** 一个实参的规格。 */
|
|
31
|
+
interface ArgSpec {
|
|
32
|
+
shape: ArgShape;
|
|
33
|
+
/** 可不传:省略(或页面显式传 null / undefined)表示"没这个实参"。 */
|
|
34
|
+
optional?: boolean;
|
|
35
|
+
}
|
|
36
|
+
/**
|
|
37
|
+
* 一个方法的实参规格:数组长度就是参数个数上限,下标就是参数位置。
|
|
38
|
+
*
|
|
39
|
+
* 为什么写死上界而不是照抄 TS 签名:TS 的可选参数在线上就是"少传一个",
|
|
40
|
+
* 而网络那头可以多传、可以传错类型、可以传 100 万个字符。这份规格管的是**入口**。
|
|
41
|
+
*/
|
|
42
|
+
type MethodSpec = readonly ArgSpec[];
|
|
43
|
+
/**
|
|
44
|
+
* 每个放行方法的实参规格。
|
|
45
|
+
*
|
|
46
|
+
* 类型写成 `Readonly<Record<UiMethod, MethodSpec>>`:少写一个方法、多写一个不存在的方法
|
|
47
|
+
* 都编不过,所以"放行"与"有校验"这两件事在这里被绑死。
|
|
48
|
+
*/
|
|
49
|
+
export declare const UI_ARG_SPECS: Readonly<Record<UiMethod, MethodSpec>>;
|
|
50
|
+
/** 校验结果:过了一条新实参数组(尾部空值已去掉),没过给一句能读的错。 */
|
|
51
|
+
export type UiArgCheck = {
|
|
52
|
+
ok: true;
|
|
53
|
+
args: unknown[];
|
|
54
|
+
} | {
|
|
55
|
+
ok: false;
|
|
56
|
+
error: string;
|
|
57
|
+
};
|
|
58
|
+
/**
|
|
59
|
+
* 校验并规整一次调用的实参。
|
|
60
|
+
*
|
|
61
|
+
* 规整的那一件事:页面用 `null` 表示"这个可选参数不传"(JSON 里没有 undefined),
|
|
62
|
+
* 所以尾部的 null / undefined 一律当"省略"去掉——省略只能从尾部开始,中间空一个
|
|
63
|
+
* 会让后面的参数错位(那正是要拒的形状)。
|
|
64
|
+
*
|
|
65
|
+
* @param method - 已收窄的界面通道方法名
|
|
66
|
+
* @param args - 页面给的实参(来自网络,任何形状都可能)
|
|
67
|
+
*/
|
|
68
|
+
export declare function validateUiArgs(method: UiMethod, args: readonly unknown[]): UiArgCheck;
|
|
69
|
+
export {};
|
|
@@ -0,0 +1,341 @@
|
|
|
1
|
+
import { DOCK_UI_OPS } from './dock-ops.js';
|
|
2
|
+
/** 界面通道放行的方法。 */
|
|
3
|
+
export const UI_METHODS = [
|
|
4
|
+
// 对话与回合
|
|
5
|
+
'submit',
|
|
6
|
+
'interrupt',
|
|
7
|
+
'editQueued',
|
|
8
|
+
'removeQueued',
|
|
9
|
+
'steerQueued',
|
|
10
|
+
'compact',
|
|
11
|
+
// 会话库
|
|
12
|
+
'openSession',
|
|
13
|
+
'newSessionIn',
|
|
14
|
+
'refreshSessions',
|
|
15
|
+
'archiveSessions',
|
|
16
|
+
'restoreSessions',
|
|
17
|
+
'renameSession',
|
|
18
|
+
'setSessionPinned',
|
|
19
|
+
'listUserMessages',
|
|
20
|
+
'forkSession',
|
|
21
|
+
'listArchivedSessions',
|
|
22
|
+
'usageStats',
|
|
23
|
+
'peekTranscript',
|
|
24
|
+
// 模型与档位
|
|
25
|
+
'setModel',
|
|
26
|
+
'listModels',
|
|
27
|
+
'setEffort',
|
|
28
|
+
'setMode',
|
|
29
|
+
'getModelConfig',
|
|
30
|
+
'discoverModels',
|
|
31
|
+
'testConnection',
|
|
32
|
+
'setDefaultModel',
|
|
33
|
+
// 审批与提问
|
|
34
|
+
'answerApproval',
|
|
35
|
+
'answerQuestion',
|
|
36
|
+
'answerPlan',
|
|
37
|
+
// 界面偏好
|
|
38
|
+
'getUiPrefs',
|
|
39
|
+
'setUiPrefs',
|
|
40
|
+
// 插件
|
|
41
|
+
'listPlugins',
|
|
42
|
+
'setPluginEnabled',
|
|
43
|
+
// 第三方界面插件的信任:列状态是读,放行(「还没信过」的那些要能在卡片里看见);
|
|
44
|
+
// 落信任记录是写,走桌面窗口的原生桥(见 `UI_EXCLUDED` 与 native-bridge 的文件头)。
|
|
45
|
+
'listUiTrust',
|
|
46
|
+
// 工具与技能
|
|
47
|
+
'listTools',
|
|
48
|
+
'listSkills',
|
|
49
|
+
'readSkill',
|
|
50
|
+
'setSkillEnabled',
|
|
51
|
+
'browseMarket',
|
|
52
|
+
// 模式(预设)
|
|
53
|
+
'listPresets',
|
|
54
|
+
'readPreset',
|
|
55
|
+
'usePreset',
|
|
56
|
+
'savePreset',
|
|
57
|
+
'removePreset',
|
|
58
|
+
'setDefaultPreset',
|
|
59
|
+
// 打包权限预设:读口(壳要画那颗旋钮);写口(usePermissionPreset /
|
|
60
|
+
// setDefaultPermissionPreset)与 setPolicy 同一条理由排除,见 UI_EXCLUDED。
|
|
61
|
+
'listPermissionPresets',
|
|
62
|
+
// 设置页
|
|
63
|
+
'getSettingsSections',
|
|
64
|
+
'getSectionValues',
|
|
65
|
+
'setSettingValue',
|
|
66
|
+
'runSettingAction',
|
|
67
|
+
// 队友
|
|
68
|
+
'listTeammates',
|
|
69
|
+
'stopTeammate',
|
|
70
|
+
'messageTeammate',
|
|
71
|
+
'removeTeammate',
|
|
72
|
+
// 后台作业与终端会话:只放行「收掉自己起的那个」与「只读看它的输出」两条
|
|
73
|
+
// (起进程的入口仍只有工具与原生桥);两条都带同口径的归属校验。
|
|
74
|
+
'stopBackground',
|
|
75
|
+
'readBackground',
|
|
76
|
+
// 任务与目标
|
|
77
|
+
'clearTodos',
|
|
78
|
+
'goalAction',
|
|
79
|
+
// 壳的 `/` 命令菜单:元数据是只读的;派发那条的名字面钉在宿主那份
|
|
80
|
+
// `shell: true` 清单上(挑不出来的命令在宿主那侧直接报错,见 core/commands-completion.ts)。
|
|
81
|
+
'listUiCommands',
|
|
82
|
+
'runUiCommand',
|
|
83
|
+
// 工作区文件与 git(dock 通道的读 + 写两档;终端那档留在原生桥,见 core/dock-ops.ts)
|
|
84
|
+
'dock',
|
|
85
|
+
];
|
|
86
|
+
/** 明确排除、且逐条写了理由的方法(见文件头注释)。 */
|
|
87
|
+
export const UI_EXCLUDED = [
|
|
88
|
+
'runCommand',
|
|
89
|
+
'setPolicy',
|
|
90
|
+
// 审阅者与打包权限预设改的同样是安全闸门本身(审阅者 = 谁来裁;预设 = 一次写
|
|
91
|
+
// 沙箱 + 权限模式 + 审阅者三个旋钮)。写口照旧开在原生桥
|
|
92
|
+
// (NATIVE_OPS.setReviewer / usePermissionPreset / setDefaultPermissionPreset)。
|
|
93
|
+
'setReviewer',
|
|
94
|
+
'usePermissionPreset',
|
|
95
|
+
'setDefaultPermissionPreset',
|
|
96
|
+
'purgeSessions',
|
|
97
|
+
'saveProvider',
|
|
98
|
+
// 换配置文件:改的是「以后读哪一份配置」——等于换掉整份端点与密钥引用,比改单个端点更大,
|
|
99
|
+
// 所以与它同一先例:只对主窗口那份文档开放(NATIVE_OPS.setConfigFile)。
|
|
100
|
+
'setConfigFile',
|
|
101
|
+
'removeProvider',
|
|
102
|
+
'setProviderKey',
|
|
103
|
+
'installMarketSkill',
|
|
104
|
+
'setMarketSources',
|
|
105
|
+
'setUiTrust',
|
|
106
|
+
];
|
|
107
|
+
const UI_COVERAGE = true;
|
|
108
|
+
void UI_COVERAGE;
|
|
109
|
+
const EXCLUSION_COVERAGE = true;
|
|
110
|
+
void EXCLUSION_COVERAGE;
|
|
111
|
+
/** 查表用的集合。 */
|
|
112
|
+
export const UI_METHOD_SET = new Set(UI_METHODS);
|
|
113
|
+
/** 把线上来的方法名收窄成"界面通道允许调用的方法"。 */
|
|
114
|
+
export function isUiMethod(method) {
|
|
115
|
+
return UI_METHOD_SET.has(method);
|
|
116
|
+
}
|
|
117
|
+
/** 长度上限:会话 jsonl 路径、模型名、技能名都不该超过它。 */
|
|
118
|
+
const MAX_PATH = 4096;
|
|
119
|
+
const MAX_NAME = 200;
|
|
120
|
+
/** 用户消息 / 提问回答的上限(请求体本身另有 64KB 上限,见 core/web-http.ts)。 */
|
|
121
|
+
const MAX_TEXT = 32000;
|
|
122
|
+
/** 图片以 data URL 形式随消息发,单条 32KB(请求体上限之下)。 */
|
|
123
|
+
const MAX_IMAGE = 32000;
|
|
124
|
+
const MAX_IMAGES = 8;
|
|
125
|
+
/** 一批会话路径的条数上限(归档 / 恢复)。 */
|
|
126
|
+
const MAX_PATHS = 500;
|
|
127
|
+
/** 偏好 / 设置值 / 预设草稿这类 JSON 实参的上限(按序列化后的文本长度算)。 */
|
|
128
|
+
const MAX_PREF_JSON = 32000;
|
|
129
|
+
/** 枚举取值直接绑到契约的类型上:契约改了而这里没跟上,编译期就报错。 */
|
|
130
|
+
const EFFORT_LEVELS = ['default', 'off', 'low', 'high', 'max'];
|
|
131
|
+
const MODES = ['build', 'plan', 'explore', 'quiet'];
|
|
132
|
+
const PLAN_DECISIONS = ['pending', 'approved', 'rejected'];
|
|
133
|
+
const APPROVAL_ANSWERS = ['allow-once', 'allow-session', 'allow-always', 'reject'];
|
|
134
|
+
const ANSWER_SOURCES = ['app', 'web'];
|
|
135
|
+
const GOAL_ACTIONS = ['pause', 'resume', 'clear', 'extend'];
|
|
136
|
+
/**
|
|
137
|
+
* 每个放行方法的实参规格。
|
|
138
|
+
*
|
|
139
|
+
* 类型写成 `Readonly<Record<UiMethod, MethodSpec>>`:少写一个方法、多写一个不存在的方法
|
|
140
|
+
* 都编不过,所以"放行"与"有校验"这两件事在这里被绑死。
|
|
141
|
+
*/
|
|
142
|
+
export const UI_ARG_SPECS = {
|
|
143
|
+
// ── 对话与回合 ─────────────────────────────────────────────────────────────
|
|
144
|
+
submit: [{ shape: { kind: 'string', max: MAX_TEXT } }, { shape: { kind: 'strings', maxItems: MAX_IMAGES, max: MAX_IMAGE }, optional: true }],
|
|
145
|
+
interrupt: [{ shape: { kind: 'string', max: MAX_PATH }, optional: true }],
|
|
146
|
+
editQueued: [{ shape: { kind: 'number' } }, { shape: { kind: 'string', max: MAX_TEXT } }],
|
|
147
|
+
removeQueued: [{ shape: { kind: 'number' } }],
|
|
148
|
+
steerQueued: [{ shape: { kind: 'number' }, optional: true }],
|
|
149
|
+
compact: [],
|
|
150
|
+
// ── 会话库 ────────────────────────────────────────────────────────────────
|
|
151
|
+
openSession: [{ shape: { kind: 'string', max: MAX_PATH }, optional: true }],
|
|
152
|
+
// 在指定目录里新建会话:实参只是一个**目录名**(能否用由宿主校验:绝对 + 存在 +
|
|
153
|
+
// 是目录),不写配置、不改策略、不执行命令——与 `openSession(path)` / `discoverModels`
|
|
154
|
+
// 同一把尺。目录是会话自己的数据(jsonl 的 meta 行),所以换目录新建**不需要重启
|
|
155
|
+
// 宿主**,也就不会再顺带把整个窗口重载一遍(工作区行那颗 ⊕ 走的就是这条路)。
|
|
156
|
+
newSessionIn: [{ shape: { kind: 'string', max: MAX_PATH } }],
|
|
157
|
+
refreshSessions: [],
|
|
158
|
+
archiveSessions: [{ shape: { kind: 'strings', maxItems: MAX_PATHS, max: MAX_PATH } }],
|
|
159
|
+
restoreSessions: [{ shape: { kind: 'strings', maxItems: MAX_PATHS, max: MAX_PATH } }],
|
|
160
|
+
renameSession: [{ shape: { kind: 'string', max: MAX_PATH } }, { shape: { kind: 'string', max: MAX_NAME } }],
|
|
161
|
+
setSessionPinned: [{ shape: { kind: 'string', max: MAX_PATH } }, { shape: { kind: 'boolean' } }],
|
|
162
|
+
listUserMessages: [{ shape: { kind: 'string', max: MAX_PATH } }],
|
|
163
|
+
forkSession: [{ shape: { kind: 'string', max: MAX_PATH } }, { shape: { kind: 'number' } }],
|
|
164
|
+
listArchivedSessions: [],
|
|
165
|
+
usageStats: [],
|
|
166
|
+
peekTranscript: [{ shape: { kind: 'string', max: MAX_PATH } }],
|
|
167
|
+
// ── 模型与档位 ────────────────────────────────────────────────────────────
|
|
168
|
+
setModel: [{ shape: { kind: 'string', max: MAX_NAME } }],
|
|
169
|
+
listModels: [],
|
|
170
|
+
setEffort: [{ shape: { kind: 'enum', values: EFFORT_LEVELS } }],
|
|
171
|
+
setMode: [{ shape: { kind: 'enum', values: MODES } }],
|
|
172
|
+
getModelConfig: [],
|
|
173
|
+
discoverModels: [{ shape: { kind: 'string', max: MAX_NAME } }],
|
|
174
|
+
testConnection: [
|
|
175
|
+
{ shape: { kind: 'string', max: MAX_NAME } },
|
|
176
|
+
{ shape: { kind: 'string', max: MAX_NAME }, optional: true },
|
|
177
|
+
],
|
|
178
|
+
setDefaultModel: [{ shape: { kind: 'string', max: MAX_NAME } }, { shape: { kind: 'string', max: MAX_NAME } }],
|
|
179
|
+
// ── 审批与提问 ────────────────────────────────────────────────────────────
|
|
180
|
+
answerApproval: [
|
|
181
|
+
{ shape: { kind: 'enum', values: APPROVAL_ANSWERS } },
|
|
182
|
+
{ shape: { kind: 'enum', values: ANSWER_SOURCES }, optional: true },
|
|
183
|
+
],
|
|
184
|
+
answerQuestion: [{ shape: { kind: 'string', max: MAX_TEXT } }],
|
|
185
|
+
answerPlan: [
|
|
186
|
+
{ shape: { kind: 'enum', values: PLAN_DECISIONS } },
|
|
187
|
+
{ shape: { kind: 'string', max: MAX_TEXT }, optional: true },
|
|
188
|
+
],
|
|
189
|
+
// ── 界面偏好 ──────────────────────────────────────────────────────────────
|
|
190
|
+
getUiPrefs: [],
|
|
191
|
+
setUiPrefs: [{ shape: { kind: 'json', maxBytes: MAX_PREF_JSON } }],
|
|
192
|
+
// ── 插件 ──────────────────────────────────────────────────────────────────
|
|
193
|
+
listPlugins: [],
|
|
194
|
+
setPluginEnabled: [{ shape: { kind: 'string', max: MAX_PATH } }, { shape: { kind: 'boolean' } }],
|
|
195
|
+
listUiTrust: [],
|
|
196
|
+
// ── 工具与技能 ────────────────────────────────────────────────────────────
|
|
197
|
+
listTools: [],
|
|
198
|
+
listSkills: [],
|
|
199
|
+
readSkill: [{ shape: { kind: 'string', max: MAX_NAME } }],
|
|
200
|
+
setSkillEnabled: [{ shape: { kind: 'string', max: MAX_NAME } }, { shape: { kind: 'boolean' } }],
|
|
201
|
+
browseMarket: [{ shape: { kind: 'string', max: MAX_NAME }, optional: true }],
|
|
202
|
+
// ── 模式(预设) ──────────────────────────────────────────────────────────
|
|
203
|
+
listPresets: [],
|
|
204
|
+
readPreset: [{ shape: { kind: 'string', max: MAX_NAME } }],
|
|
205
|
+
usePreset: [{ shape: { kind: 'string', max: MAX_NAME } }],
|
|
206
|
+
savePreset: [{ shape: { kind: 'json', maxBytes: MAX_PREF_JSON } }],
|
|
207
|
+
removePreset: [{ shape: { kind: 'string', max: MAX_NAME } }],
|
|
208
|
+
setDefaultPreset: [{ shape: { kind: 'string', max: MAX_NAME } }],
|
|
209
|
+
// ── 打包权限预设(只读口;三个写口在原生桥,见 UI_EXCLUDED)────────────────
|
|
210
|
+
listPermissionPresets: [],
|
|
211
|
+
// ── 设置页 ────────────────────────────────────────────────────────────────
|
|
212
|
+
getSettingsSections: [],
|
|
213
|
+
getSectionValues: [{ shape: { kind: 'string', max: MAX_NAME } }],
|
|
214
|
+
setSettingValue: [
|
|
215
|
+
{ shape: { kind: 'string', max: MAX_NAME } },
|
|
216
|
+
{ shape: { kind: 'string', max: MAX_NAME } },
|
|
217
|
+
{ shape: { kind: 'json', maxBytes: MAX_PREF_JSON } },
|
|
218
|
+
],
|
|
219
|
+
runSettingAction: [{ shape: { kind: 'string', max: MAX_NAME } }, { shape: { kind: 'string', max: MAX_NAME } }],
|
|
220
|
+
// ── 队友 ──────────────────────────────────────────────────────────────────
|
|
221
|
+
listTeammates: [],
|
|
222
|
+
stopTeammate: [{ shape: { kind: 'string', max: MAX_NAME } }],
|
|
223
|
+
messageTeammate: [{ shape: { kind: 'string', max: MAX_NAME } }, { shape: { kind: 'string', max: MAX_TEXT } }],
|
|
224
|
+
removeTeammate: [{ shape: { kind: 'string', max: MAX_NAME } }],
|
|
225
|
+
// 后台作业 / 终端会话的 id(job-N / term-N):短标识,给 MAX_NAME 绰绰有余。
|
|
226
|
+
stopBackground: [{ shape: { kind: 'string', max: MAX_NAME } }],
|
|
227
|
+
readBackground: [{ shape: { kind: 'string', max: MAX_NAME } }],
|
|
228
|
+
// ── 任务与目标 ────────────────────────────────────────────────────────────
|
|
229
|
+
clearTodos: [],
|
|
230
|
+
goalAction: [{ shape: { kind: 'enum', values: GOAL_ACTIONS } }],
|
|
231
|
+
// ── 壳的 `/` 命令菜单 ─────────────────────────────────────────────────────
|
|
232
|
+
listUiCommands: [],
|
|
233
|
+
// 一条命令行(`/review 关注点` 这样的原文,长度按输入框上限收):具体名字准不准
|
|
234
|
+
// 由宿主那侧按 `shell: true` 清单判,这一层只管形状。
|
|
235
|
+
runUiCommand: [{ shape: { kind: 'string', max: MAX_TEXT } }],
|
|
236
|
+
// ── 工作区文件与 git ──────────────────────────────────────────────────────
|
|
237
|
+
// 第一个实参是 op,钉死在 `DOCK_UI_OPS`(读 + 写);**终端那档不在枚举里**,
|
|
238
|
+
// 于是走 HTTP 的 term-spawn 会被这一层的枚举校验当场拒,而不是进到宿主才算。
|
|
239
|
+
dock: [
|
|
240
|
+
{ shape: { kind: 'enum', values: DOCK_UI_OPS } },
|
|
241
|
+
{ shape: { kind: 'json', maxBytes: MAX_PREF_JSON }, optional: true },
|
|
242
|
+
],
|
|
243
|
+
};
|
|
244
|
+
/**
|
|
245
|
+
* 校验并规整一次调用的实参。
|
|
246
|
+
*
|
|
247
|
+
* 规整的那一件事:页面用 `null` 表示"这个可选参数不传"(JSON 里没有 undefined),
|
|
248
|
+
* 所以尾部的 null / undefined 一律当"省略"去掉——省略只能从尾部开始,中间空一个
|
|
249
|
+
* 会让后面的参数错位(那正是要拒的形状)。
|
|
250
|
+
*
|
|
251
|
+
* @param method - 已收窄的界面通道方法名
|
|
252
|
+
* @param args - 页面给的实参(来自网络,任何形状都可能)
|
|
253
|
+
*/
|
|
254
|
+
export function validateUiArgs(method, args) {
|
|
255
|
+
const spec = UI_ARG_SPECS[method];
|
|
256
|
+
if (args.length > spec.length) {
|
|
257
|
+
return { ok: false, error: `界面通道:${method} 最多收 ${String(spec.length)} 个实参,收到 ${String(args.length)} 个` };
|
|
258
|
+
}
|
|
259
|
+
const checked = [];
|
|
260
|
+
for (let index = 0; index < args.length; index += 1) {
|
|
261
|
+
const value = args[index];
|
|
262
|
+
const arg = spec[index];
|
|
263
|
+
if (value === null || value === undefined) {
|
|
264
|
+
if (arg.optional !== true) {
|
|
265
|
+
return { ok: false, error: `界面通道:${method} 的第 ${String(index + 1)} 个实参不能为空` };
|
|
266
|
+
}
|
|
267
|
+
for (let later = index + 1; later < args.length; later += 1) {
|
|
268
|
+
const rest = args[later];
|
|
269
|
+
if (rest !== null && rest !== undefined) {
|
|
270
|
+
return {
|
|
271
|
+
ok: false,
|
|
272
|
+
error: `界面通道:${method} 的第 ${String(index + 1)} 个实参省略了,但第 ${String(later + 1)} 个还在(省略只能从尾部开始)`,
|
|
273
|
+
};
|
|
274
|
+
}
|
|
275
|
+
}
|
|
276
|
+
break;
|
|
277
|
+
}
|
|
278
|
+
const problem = checkShape(arg.shape, value);
|
|
279
|
+
if (problem !== null) {
|
|
280
|
+
return { ok: false, error: `界面通道:${method} 的第 ${String(index + 1)} 个实参${problem}` };
|
|
281
|
+
}
|
|
282
|
+
checked.push(value);
|
|
283
|
+
}
|
|
284
|
+
// 必传的实参一个都不能少:少了就当场拒,不能把 undefined 铺给宿主方法
|
|
285
|
+
// (`submit()` 收到 text=undefined 会被 Reflect.apply 原样传进去)。
|
|
286
|
+
for (let index = checked.length; index < spec.length; index += 1) {
|
|
287
|
+
if (spec[index].optional !== true) {
|
|
288
|
+
return { ok: false, error: `界面通道:${method} 的第 ${String(index + 1)} 个实参是必传的` };
|
|
289
|
+
}
|
|
290
|
+
}
|
|
291
|
+
return { ok: true, args: checked };
|
|
292
|
+
}
|
|
293
|
+
/** 校验一个值是不是这个形状;不是就回一句人话。 */
|
|
294
|
+
function checkShape(shape, value) {
|
|
295
|
+
switch (shape.kind) {
|
|
296
|
+
case 'string':
|
|
297
|
+
if (typeof value !== 'string')
|
|
298
|
+
return '必须是字符串';
|
|
299
|
+
if (value.length > shape.max)
|
|
300
|
+
return `是字符串但太长(${String(value.length)} > ${String(shape.max)} 字符)`;
|
|
301
|
+
return null;
|
|
302
|
+
case 'number':
|
|
303
|
+
return typeof value === 'number' && Number.isFinite(value) ? null : '必须是有限数字';
|
|
304
|
+
case 'boolean':
|
|
305
|
+
return typeof value === 'boolean' ? null : '必须是布尔值';
|
|
306
|
+
case 'enum':
|
|
307
|
+
return typeof value === 'string' && shape.values.includes(value)
|
|
308
|
+
? null
|
|
309
|
+
: `必须是这几个值之一:${shape.values.join(' / ')}`;
|
|
310
|
+
case 'strings': {
|
|
311
|
+
if (!Array.isArray(value))
|
|
312
|
+
return '必须是字符串数组';
|
|
313
|
+
if (value.length > shape.maxItems)
|
|
314
|
+
return `数组太长(${String(value.length)} > ${String(shape.maxItems)} 项)`;
|
|
315
|
+
for (const item of value) {
|
|
316
|
+
if (typeof item !== 'string')
|
|
317
|
+
return '数组里必须全是字符串';
|
|
318
|
+
if (item.length > shape.max)
|
|
319
|
+
return `数组里有字符串太长(${String(item.length)} > ${String(shape.max)} 字符)`;
|
|
320
|
+
}
|
|
321
|
+
return null;
|
|
322
|
+
}
|
|
323
|
+
case 'json': {
|
|
324
|
+
const text = jsonText(value);
|
|
325
|
+
if (text === null)
|
|
326
|
+
return '不是可序列化的 JSON 值';
|
|
327
|
+
if (text.length > shape.maxBytes)
|
|
328
|
+
return `是 JSON 但太长(${String(text.length)} > ${String(shape.maxBytes)} 字符)`;
|
|
329
|
+
return null;
|
|
330
|
+
}
|
|
331
|
+
}
|
|
332
|
+
}
|
|
333
|
+
/** 一段 JSON 文本;序列化不了(循环引用、BigInt、函数)给 null。 */
|
|
334
|
+
function jsonText(value) {
|
|
335
|
+
try {
|
|
336
|
+
return JSON.stringify(value) ?? null;
|
|
337
|
+
}
|
|
338
|
+
catch {
|
|
339
|
+
return null;
|
|
340
|
+
}
|
|
341
|
+
}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 插件 bundle 的 HTTP 解析:把 `/plugins/<id>/<file>?rev=` 解析成「回什么字节」。
|
|
3
|
+
*
|
|
4
|
+
* 为什么单独一份:本机界面服务(`core/ui-server.ts`)与远程控制(`plugins/remote/routes.ts`)
|
|
5
|
+
* 都要下发同一批插件 bundle——C-真 的要点正是**桌面与远程看同一份界面**,
|
|
6
|
+
* 所以解析口径只能有一处,否则两边对「版本对不上该不该给」这类判断会慢慢分叉。
|
|
7
|
+
*
|
|
8
|
+
* 四条规矩:
|
|
9
|
+
*
|
|
10
|
+
* - **id 可以是多段**(`@scope/name`):解析口径是"最后一个 `/` 之前全是 id",
|
|
11
|
+
* 最后一个 `/` 之后是文件名;文件名不许再带分隔符,id 的形状由
|
|
12
|
+
* `core/ui-bundles.ts` 的 `PLUGIN_ID` 与 `inside()` 围栏共同把关。
|
|
13
|
+
* - **缺 rev 一律 404**:地址里没有内容指纹就不是内容寻址的地址,绝不能混进
|
|
14
|
+
* "一年不可变"那一档——否则一旦被(代理)缓存,升级后一年不回源,用户看到的是旧界面。
|
|
15
|
+
* - **rev 对得上给当下这一代,对上前一代给旧字节**:插件刚重建时,已经打开、还没刷新的
|
|
16
|
+
* 页面手上还是旧地址,它必须还能拿到旧字节,否则那个插件当场加载失败、只能手动刷新。
|
|
17
|
+
* 两代都没有才 404(旧地址不该拿到新代码,新地址也不该拿到旧代码)。
|
|
18
|
+
* - **方法是 GET / HEAD**:HEAD 复用 GET 的头但不给体;其余方法 405(带 Allow)。
|
|
19
|
+
*
|
|
20
|
+
* combo(A3)走**精确表**:请求形如 `/plugins/??<id>/client.js,…&rev=<批 rev>`,判据是
|
|
21
|
+
* pathname 恰为 `/plugins/` 且 search 以 `??` 开头(`new URL()` 会把第一个 `?` 当查询起点,
|
|
22
|
+
* 所以这里直接拿原始 search 串,绝不 re-parse 资源列表)。表由宿主组图时登记
|
|
23
|
+
* (`core/ui-boot-source.ts`),未登记的组合一律 404——既与参考实现同口径,也让请求里的
|
|
24
|
+
* id 列表永远决定不了要读哪些文件。
|
|
25
|
+
*
|
|
26
|
+
* @module dsc/core/ui-route
|
|
27
|
+
*/
|
|
28
|
+
import type { UiComboTable } from './ui-combo.js';
|
|
29
|
+
/** 插件资源的路由前缀。 */
|
|
30
|
+
export declare const UI_BUNDLE_ROUTE = "/plugins/";
|
|
31
|
+
/** 解析结果:状态码 + 该回的头 + 该回的字节(非 200 时只有理由)。 */
|
|
32
|
+
export interface UiBundleResponse {
|
|
33
|
+
status: number;
|
|
34
|
+
headers?: Record<string, string>;
|
|
35
|
+
body?: Buffer;
|
|
36
|
+
/** 不是 200 时的一句话理由(日志与诊断用)。 */
|
|
37
|
+
reason?: string;
|
|
38
|
+
}
|
|
39
|
+
/** 这个路径是不是插件资源请求。 */
|
|
40
|
+
export declare function isUiBundleRequest(pathname: string): boolean;
|
|
41
|
+
/**
|
|
42
|
+
* 解析一个插件资源请求。
|
|
43
|
+
*
|
|
44
|
+
* @param pathname - 请求路径(`/plugins/@scope/name/client.js`)
|
|
45
|
+
* @param rev - 查询参数里的版本;缺省(null / 空串)一律 404——地址不带指纹就不是内容寻址
|
|
46
|
+
* @param dir - 插件目录,缺省 `lib/ui/plugins`
|
|
47
|
+
* @param method - 请求方法,缺省 GET;非 GET / HEAD 回 405
|
|
48
|
+
*/
|
|
49
|
+
export declare function resolveUiBundleRequest(pathname: string, rev: string | null, dir?: string, method?: string): UiBundleResponse;
|
|
50
|
+
/** 这个请求是不是 combo(判据:pathname 恰为前缀,search 以 `??` 开头——不是 pathname 里有 `??`)。 */
|
|
51
|
+
export declare function isUiComboRequest(pathname: string, search: string): boolean;
|
|
52
|
+
/**
|
|
53
|
+
* 一个 /plugins 请求的**唯一**解析口子:combo 走精确表,单资源走内容寻址。
|
|
54
|
+
* 本机界面服务与远程控制都调这一份(两处口径分叉是 `ui-route.ts` 头注释里说的老病)。
|
|
55
|
+
*
|
|
56
|
+
* @param pathname - 请求路径
|
|
57
|
+
* @param search - 原始查询串(含前导 `?`;combo 的 `??` 就是它的一部分)
|
|
58
|
+
* @param dir - 内置插件目录,缺省 `lib/ui/plugins`
|
|
59
|
+
* @param method - 请求方法,缺省 GET
|
|
60
|
+
* @param combo - 当前代的 combo 精确表;不给则 combo 一律 404(纯静态探测场景)
|
|
61
|
+
*/
|
|
62
|
+
export declare function resolveUiResourceRequest(pathname: string, search: string, dir?: string, method?: string, combo?: UiComboTable): UiBundleResponse;
|
|
63
|
+
/**
|
|
64
|
+
* 解析一个 combo 请求:`/plugins/??<id>/client.js,…&rev=<批 rev>`。
|
|
65
|
+
*
|
|
66
|
+
* 只查表不解析:未登记的组合(含「批已换代、页面还拿旧地址」过了保留窗口的)一律 404,
|
|
67
|
+
* 客户端据此按「批 → 单资源」回退(`@dsc/ui-core` 的 arrival 协议)。
|
|
68
|
+
*/
|
|
69
|
+
export declare function resolveUiComboRequest(pathname: string, search: string, combo: UiComboTable | undefined, method?: string): UiBundleResponse;
|