@waq666/pneuma 0.0.0-stage → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +144 -2
- package/bin/dsc.js +91 -0
- package/bin/headless.cjs +40 -0
- package/lib/adapter/core-runtime.d.ts +11 -0
- package/lib/adapter/core-runtime.js +259 -0
- package/lib/adapter/host.d.ts +18 -0
- package/lib/adapter/host.js +14 -0
- package/lib/adapter/runtime.d.ts +15 -0
- package/lib/adapter/runtime.js +290 -0
- package/lib/adapter/transcript.d.ts +184 -0
- package/lib/adapter/transcript.js +605 -0
- package/lib/app/AgentsOverlay.d.ts +18 -0
- package/lib/app/AgentsOverlay.js +63 -0
- package/lib/app/App.d.ts +13 -0
- package/lib/app/App.js +1498 -0
- package/lib/app/ApprovalCard.d.ts +12 -0
- package/lib/app/ApprovalCard.js +76 -0
- package/lib/app/AskCard.d.ts +20 -0
- package/lib/app/AskCard.js +45 -0
- package/lib/app/ChatView.d.ts +32 -0
- package/lib/app/ChatView.js +198 -0
- package/lib/app/Composer.d.ts +50 -0
- package/lib/app/Composer.js +282 -0
- package/lib/app/DiffBlock.d.ts +6 -0
- package/lib/app/DiffBlock.js +37 -0
- package/lib/app/MarkdownView.d.ts +6 -0
- package/lib/app/MarkdownView.js +99 -0
- package/lib/app/ModelPicker.d.ts +7 -0
- package/lib/app/ModelPicker.js +18 -0
- package/lib/app/PlanReviewCard.d.ts +13 -0
- package/lib/app/PlanReviewCard.js +54 -0
- package/lib/app/PresetPicker.d.ts +11 -0
- package/lib/app/PresetPicker.js +19 -0
- package/lib/app/PreviewOverlay.d.ts +14 -0
- package/lib/app/PreviewOverlay.js +22 -0
- package/lib/app/SessionPicker.d.ts +43 -0
- package/lib/app/SessionPicker.js +56 -0
- package/lib/app/SettingsOverlay.d.ts +32 -0
- package/lib/app/SettingsOverlay.js +157 -0
- package/lib/app/SkillsPicker.d.ts +7 -0
- package/lib/app/SkillsPicker.js +19 -0
- package/lib/app/StatusBar.d.ts +22 -0
- package/lib/app/StatusBar.js +272 -0
- package/lib/app/TaskStrips.d.ts +13 -0
- package/lib/app/TaskStrips.js +40 -0
- package/lib/app/ToolCard.d.ts +5 -0
- package/lib/app/ToolCard.js +40 -0
- package/lib/app/TranscriptOverlay.d.ts +12 -0
- package/lib/app/TranscriptOverlay.js +17 -0
- package/lib/app/Welcome.d.ts +6 -0
- package/lib/app/Welcome.js +66 -0
- package/lib/app/attach.d.ts +16 -0
- package/lib/app/attach.js +58 -0
- package/lib/app/click.d.ts +27 -0
- package/lib/app/click.js +89 -0
- package/lib/app/clipboard-image.d.ts +11 -0
- package/lib/app/clipboard-image.js +66 -0
- package/lib/app/cursor.d.ts +4 -0
- package/lib/app/cursor.js +24 -0
- package/lib/app/hello.d.ts +11 -0
- package/lib/app/hello.js +8 -0
- package/lib/app/history-store.d.ts +4 -0
- package/lib/app/history-store.js +41 -0
- package/lib/app/image-blocks.d.ts +12 -0
- package/lib/app/image-blocks.js +125 -0
- package/lib/app/markdown.d.ts +54 -0
- package/lib/app/markdown.js +189 -0
- package/lib/app/settings-model.d.ts +69 -0
- package/lib/app/settings-model.js +114 -0
- package/lib/app/theme.d.ts +166 -0
- package/lib/app/theme.js +141 -0
- package/lib/boot.d.ts +1 -0
- package/lib/boot.js +34 -0
- package/lib/commands.d.ts +49 -0
- package/lib/commands.js +115 -0
- package/lib/contract.d.ts +1973 -0
- package/lib/contract.js +36 -0
- package/lib/core/agent-roles.d.ts +52 -0
- package/lib/core/agent-roles.js +274 -0
- package/lib/core/approval-floor.d.ts +183 -0
- package/lib/core/approval-floor.js +679 -0
- package/lib/core/approval.d.ts +42 -0
- package/lib/core/approval.js +8 -0
- package/lib/core/audit.d.ts +61 -0
- package/lib/core/audit.js +59 -0
- package/lib/core/boot-notices.d.ts +6 -0
- package/lib/core/boot-notices.js +61 -0
- package/lib/core/cdp/actions.d.ts +182 -0
- package/lib/core/cdp/actions.js +649 -0
- package/lib/core/cdp/launch.d.ts +192 -0
- package/lib/core/cdp/launch.js +491 -0
- package/lib/core/cdp/snapshot.d.ts +139 -0
- package/lib/core/cdp/snapshot.js +316 -0
- package/lib/core/cdp/transport.d.ts +160 -0
- package/lib/core/cdp/transport.js +359 -0
- package/lib/core/command-policy.d.ts +108 -0
- package/lib/core/command-policy.js +580 -0
- package/lib/core/commands-completion.d.ts +78 -0
- package/lib/core/commands-completion.js +167 -0
- package/lib/core/compact-anchors.d.ts +76 -0
- package/lib/core/compact-anchors.js +284 -0
- package/lib/core/compact.d.ts +110 -0
- package/lib/core/compact.js +210 -0
- package/lib/core/config-store.d.ts +38 -0
- package/lib/core/config-store.js +307 -0
- package/lib/core/config.d.ts +36 -0
- package/lib/core/config.js +124 -0
- package/lib/core/connection-test.d.ts +60 -0
- package/lib/core/connection-test.js +84 -0
- package/lib/core/desktop-control.d.ts +298 -0
- package/lib/core/desktop-control.js +1311 -0
- package/lib/core/diff-text.d.ts +74 -0
- package/lib/core/diff-text.js +257 -0
- package/lib/core/dock-browser.d.ts +137 -0
- package/lib/core/dock-browser.js +146 -0
- package/lib/core/dock-ops.d.ts +59 -0
- package/lib/core/dock-ops.js +104 -0
- package/lib/core/dock-session.d.ts +39 -0
- package/lib/core/dock-session.js +28 -0
- package/lib/core/dsh-compat/hook.d.ts +18 -0
- package/lib/core/dsh-compat/hook.js +52 -0
- package/lib/core/dsh-compat/resolve-hook.d.ts +5 -0
- package/lib/core/dsh-compat/resolve-hook.js +59 -0
- package/lib/core/dsh-compat/tools-facade.d.ts +47 -0
- package/lib/core/dsh-compat/tools-facade.js +108 -0
- package/lib/core/err-text.d.ts +13 -0
- package/lib/core/err-text.js +15 -0
- package/lib/core/events.d.ts +149 -0
- package/lib/core/events.js +1 -0
- package/lib/core/git-exec.d.ts +23 -0
- package/lib/core/git-exec.js +72 -0
- package/lib/core/git-info.d.ts +47 -0
- package/lib/core/git-info.js +157 -0
- package/lib/core/goal.d.ts +89 -0
- package/lib/core/goal.js +189 -0
- package/lib/core/hooks.d.ts +272 -0
- package/lib/core/hooks.js +818 -0
- package/lib/core/host-browser-link.d.ts +59 -0
- package/lib/core/host-browser-link.js +9 -0
- package/lib/core/host-methods.d.ts +25 -0
- package/lib/core/host-methods.js +103 -0
- package/lib/core/image-diet.d.ts +77 -0
- package/lib/core/image-diet.js +127 -0
- package/lib/core/learnings/ledger.d.ts +73 -0
- package/lib/core/learnings/ledger.js +273 -0
- package/lib/core/learnings/skill-write.d.ts +250 -0
- package/lib/core/learnings/skill-write.js +854 -0
- package/lib/core/learnings/store.d.ts +102 -0
- package/lib/core/learnings/store.js +266 -0
- package/lib/core/lifecycle-hooks.d.ts +189 -0
- package/lib/core/lifecycle-hooks.js +576 -0
- package/lib/core/llm.d.ts +272 -0
- package/lib/core/llm.js +548 -0
- package/lib/core/lockfile.d.ts +17 -0
- package/lib/core/lockfile.js +110 -0
- package/lib/core/loop.d.ts +185 -0
- package/lib/core/loop.js +587 -0
- package/lib/core/lsp/client.d.ts +189 -0
- package/lib/core/lsp/client.js +690 -0
- package/lib/core/lsp/framing.d.ts +84 -0
- package/lib/core/lsp/framing.js +181 -0
- package/lib/core/lsp/line-shift.d.ts +28 -0
- package/lib/core/lsp/line-shift.js +127 -0
- package/lib/core/lsp/manager.d.ts +93 -0
- package/lib/core/lsp/manager.js +418 -0
- package/lib/core/lsp/normalize.d.ts +32 -0
- package/lib/core/lsp/normalize.js +139 -0
- package/lib/core/lsp/servers.d.ts +106 -0
- package/lib/core/lsp/servers.js +352 -0
- package/lib/core/lsp/uri.d.ts +76 -0
- package/lib/core/lsp/uri.js +179 -0
- package/lib/core/market.d.ts +51 -0
- package/lib/core/market.js +358 -0
- package/lib/core/mcp.d.ts +201 -0
- package/lib/core/mcp.js +836 -0
- package/lib/core/memory-eval.d.ts +158 -0
- package/lib/core/memory-eval.js +215 -0
- package/lib/core/memory.d.ts +266 -0
- package/lib/core/memory.js +703 -0
- package/lib/core/mention.d.ts +57 -0
- package/lib/core/mention.js +129 -0
- package/lib/core/microcompact.d.ts +48 -0
- package/lib/core/microcompact.js +79 -0
- package/lib/core/migrate.d.ts +56 -0
- package/lib/core/migrate.js +134 -0
- package/lib/core/model-caps.d.ts +83 -0
- package/lib/core/model-caps.js +150 -0
- package/lib/core/model-discovery.d.ts +19 -0
- package/lib/core/model-discovery.js +69 -0
- package/lib/core/modes.d.ts +72 -0
- package/lib/core/modes.js +152 -0
- package/lib/core/native-bridge.d.ts +135 -0
- package/lib/core/native-bridge.js +563 -0
- package/lib/core/path-policy.d.ts +32 -0
- package/lib/core/path-policy.js +248 -0
- package/lib/core/permission-presets.d.ts +67 -0
- package/lib/core/permission-presets.js +75 -0
- package/lib/core/plugin-loader.d.ts +36 -0
- package/lib/core/plugin-loader.js +294 -0
- package/lib/core/plugin-registry.d.ts +113 -0
- package/lib/core/plugin-registry.js +256 -0
- package/lib/core/prefs.d.ts +82 -0
- package/lib/core/prefs.js +372 -0
- package/lib/core/presets.d.ts +80 -0
- package/lib/core/presets.js +373 -0
- package/lib/core/pricing.d.ts +90 -0
- package/lib/core/pricing.js +126 -0
- package/lib/core/prompt.d.ts +92 -0
- package/lib/core/prompt.js +339 -0
- package/lib/core/ptc.d.ts +66 -0
- package/lib/core/ptc.js +70 -0
- package/lib/core/remote/frames.d.ts +91 -0
- package/lib/core/remote/frames.js +174 -0
- package/lib/core/remote/notify.d.ts +54 -0
- package/lib/core/remote/notify.js +77 -0
- package/lib/core/remote/owner.d.ts +32 -0
- package/lib/core/remote/owner.js +75 -0
- package/lib/core/remote/pairing.d.ts +104 -0
- package/lib/core/remote/pairing.js +261 -0
- package/lib/core/remote/push.d.ts +80 -0
- package/lib/core/remote/push.js +222 -0
- package/lib/core/remote/store.d.ts +18 -0
- package/lib/core/remote/store.js +59 -0
- package/lib/core/remote/tickets.d.ts +20 -0
- package/lib/core/remote/tickets.js +49 -0
- package/lib/core/remote/uploads.d.ts +63 -0
- package/lib/core/remote/uploads.js +161 -0
- package/lib/core/request-attribution.d.ts +26 -0
- package/lib/core/request-attribution.js +86 -0
- package/lib/core/request-invariant.d.ts +61 -0
- package/lib/core/request-invariant.js +199 -0
- package/lib/core/sandbox/backends.d.ts +64 -0
- package/lib/core/sandbox/backends.js +194 -0
- package/lib/core/sandbox/execpolicy.d.ts +93 -0
- package/lib/core/sandbox/execpolicy.js +452 -0
- package/lib/core/sandbox/net-proxy.d.ts +31 -0
- package/lib/core/sandbox/net-proxy.js +162 -0
- package/lib/core/sandbox/policy.d.ts +211 -0
- package/lib/core/sandbox/policy.js +559 -0
- package/lib/core/sandbox/win/abi.d.ts +161 -0
- package/lib/core/sandbox/win/abi.js +169 -0
- package/lib/core/sandbox/win/account.d.ts +71 -0
- package/lib/core/sandbox/win/account.js +206 -0
- package/lib/core/sandbox/win/acl.d.ts +54 -0
- package/lib/core/sandbox/win/acl.js +339 -0
- package/lib/core/sandbox/win/backend.d.ts +61 -0
- package/lib/core/sandbox/win/backend.js +249 -0
- package/lib/core/sandbox/win/doctor.d.ts +24 -0
- package/lib/core/sandbox/win/doctor.js +272 -0
- package/lib/core/sandbox/win/ffi.d.ts +107 -0
- package/lib/core/sandbox/win/ffi.js +166 -0
- package/lib/core/sandbox/win/net-abi.d.ts +154 -0
- package/lib/core/sandbox/win/net-abi.js +316 -0
- package/lib/core/sandbox/win/runner-entry.d.ts +35 -0
- package/lib/core/sandbox/win/runner-entry.js +391 -0
- package/lib/core/sandbox/win/setup.d.ts +60 -0
- package/lib/core/sandbox/win/setup.js +986 -0
- package/lib/core/sandbox/win/token.d.ts +35 -0
- package/lib/core/sandbox/win/token.js +238 -0
- package/lib/core/sandbox/win/wfp.d.ts +41 -0
- package/lib/core/sandbox/win/wfp.js +200 -0
- package/lib/core/sandbox/win/workspace-sid.d.ts +9 -0
- package/lib/core/sandbox/win/workspace-sid.js +45 -0
- package/lib/core/schedule/rule.d.ts +184 -0
- package/lib/core/schedule/rule.js +745 -0
- package/lib/core/schedule/runner.d.ts +185 -0
- package/lib/core/schedule/runner.js +678 -0
- package/lib/core/schedule/store.d.ts +182 -0
- package/lib/core/schedule/store.js +455 -0
- package/lib/core/secrets.d.ts +41 -0
- package/lib/core/secrets.js +150 -0
- package/lib/core/session-export.d.ts +18 -0
- package/lib/core/session-export.js +73 -0
- package/lib/core/session-index.d.ts +159 -0
- package/lib/core/session-index.js +683 -0
- package/lib/core/session-meta.d.ts +41 -0
- package/lib/core/session-meta.js +97 -0
- package/lib/core/session.d.ts +356 -0
- package/lib/core/session.js +998 -0
- package/lib/core/skills.d.ts +60 -0
- package/lib/core/skills.js +171 -0
- package/lib/core/spill.d.ts +159 -0
- package/lib/core/spill.js +329 -0
- package/lib/core/surface-registry.d.ts +45 -0
- package/lib/core/surface-registry.js +67 -0
- package/lib/core/team-board.d.ts +95 -0
- package/lib/core/team-board.js +316 -0
- package/lib/core/throughput.d.ts +46 -0
- package/lib/core/throughput.js +40 -0
- package/lib/core/todo-reminder.d.ts +44 -0
- package/lib/core/todo-reminder.js +55 -0
- package/lib/core/todo.d.ts +81 -0
- package/lib/core/todo.js +222 -0
- package/lib/core/token-estimate.d.ts +55 -0
- package/lib/core/token-estimate.js +82 -0
- package/lib/core/tool-guards.d.ts +103 -0
- package/lib/core/tool-guards.js +77 -0
- package/lib/core/tool-search.d.ts +152 -0
- package/lib/core/tool-search.js +311 -0
- package/lib/core/tools/bash.d.ts +281 -0
- package/lib/core/tools/bash.js +871 -0
- package/lib/core/tools/command-runner.d.ts +84 -0
- package/lib/core/tools/command-runner.js +68 -0
- package/lib/core/tools/fs-tools.d.ts +23 -0
- package/lib/core/tools/fs-tools.js +247 -0
- package/lib/core/tools/index.d.ts +8 -0
- package/lib/core/tools/index.js +4 -0
- package/lib/core/tools/sandbox-args.d.ts +51 -0
- package/lib/core/tools/sandbox-args.js +90 -0
- package/lib/core/tools/search-tools.d.ts +3 -0
- package/lib/core/tools/search-tools.js +153 -0
- package/lib/core/tools.d.ts +96 -0
- package/lib/core/tools.js +53 -0
- package/lib/core/ui-boot-source.d.ts +71 -0
- package/lib/core/ui-boot-source.js +121 -0
- package/lib/core/ui-bundles.d.ts +249 -0
- package/lib/core/ui-bundles.js +830 -0
- package/lib/core/ui-combo.d.ts +49 -0
- package/lib/core/ui-combo.js +55 -0
- package/lib/core/ui-events.d.ts +81 -0
- package/lib/core/ui-events.js +364 -0
- package/lib/core/ui-hmr.d.ts +36 -0
- package/lib/core/ui-hmr.js +128 -0
- package/lib/core/ui-methods.d.ts +69 -0
- package/lib/core/ui-methods.js +341 -0
- package/lib/core/ui-route.d.ts +69 -0
- package/lib/core/ui-route.js +122 -0
- package/lib/core/ui-server.d.ts +75 -0
- package/lib/core/ui-server.js +369 -0
- package/lib/core/ui-trust.d.ts +47 -0
- package/lib/core/ui-trust.js +164 -0
- package/lib/core/untrusted.d.ts +30 -0
- package/lib/core/untrusted.js +48 -0
- package/lib/core/update-check.d.ts +81 -0
- package/lib/core/update-check.js +177 -0
- package/lib/core/usage-log.d.ts +82 -0
- package/lib/core/usage-log.js +306 -0
- package/lib/core/version.d.ts +1 -0
- package/lib/core/version.js +37 -0
- package/lib/core/web-http.d.ts +57 -0
- package/lib/core/web-http.js +137 -0
- package/lib/core/web-static.d.ts +31 -0
- package/lib/core/web-static.js +75 -0
- package/lib/headless.d.ts +1 -0
- package/lib/headless.js +31 -0
- package/lib/host/kernel.d.ts +33 -0
- package/lib/host/kernel.js +451 -0
- package/lib/index.d.ts +41 -0
- package/lib/index.js +35 -0
- package/lib/plugins/agent.d.ts +2 -0
- package/lib/plugins/agent.js +274 -0
- package/lib/plugins/approval-floor.d.ts +2 -0
- package/lib/plugins/approval-floor.js +223 -0
- package/lib/plugins/approval.d.ts +16 -0
- package/lib/plugins/approval.js +674 -0
- package/lib/plugins/ask.d.ts +2 -0
- package/lib/plugins/ask.js +245 -0
- package/lib/plugins/browser.d.ts +68 -0
- package/lib/plugins/browser.js +1341 -0
- package/lib/plugins/commands.d.ts +23 -0
- package/lib/plugins/commands.js +498 -0
- package/lib/plugins/compact.d.ts +21 -0
- package/lib/plugins/compact.js +274 -0
- package/lib/plugins/computer-use.d.ts +47 -0
- package/lib/plugins/computer-use.js +539 -0
- package/lib/plugins/desktop-dock.d.ts +2 -0
- package/lib/plugins/desktop-dock.js +626 -0
- package/lib/plugins/dock-browser.d.ts +34 -0
- package/lib/plugins/dock-browser.js +765 -0
- package/lib/plugins/dsh-compat.d.ts +25 -0
- package/lib/plugins/dsh-compat.js +37 -0
- package/lib/plugins/file-review.d.ts +108 -0
- package/lib/plugins/file-review.js +393 -0
- package/lib/plugins/git.d.ts +26 -0
- package/lib/plugins/git.js +132 -0
- package/lib/plugins/goal.d.ts +20 -0
- package/lib/plugins/goal.js +245 -0
- package/lib/plugins/guards.d.ts +14 -0
- package/lib/plugins/guards.js +18 -0
- package/lib/plugins/hooks.d.ts +19 -0
- package/lib/plugins/hooks.js +583 -0
- package/lib/plugins/host-stdio.d.ts +88 -0
- package/lib/plugins/host-stdio.js +317 -0
- package/lib/plugins/image-diet.d.ts +17 -0
- package/lib/plugins/image-diet.js +85 -0
- package/lib/plugins/lifecycle-hooks.d.ts +26 -0
- package/lib/plugins/lifecycle-hooks.js +338 -0
- package/lib/plugins/llm.d.ts +13 -0
- package/lib/plugins/llm.js +215 -0
- package/lib/plugins/lsp.d.ts +54 -0
- package/lib/plugins/lsp.js +608 -0
- package/lib/plugins/mcp.d.ts +16 -0
- package/lib/plugins/mcp.js +673 -0
- package/lib/plugins/memory.d.ts +17 -0
- package/lib/plugins/memory.js +858 -0
- package/lib/plugins/microcompact.d.ts +18 -0
- package/lib/plugins/microcompact.js +119 -0
- package/lib/plugins/mode.d.ts +18 -0
- package/lib/plugins/mode.js +115 -0
- package/lib/plugins/permission-presets.d.ts +18 -0
- package/lib/plugins/permission-presets.js +135 -0
- package/lib/plugins/plan.d.ts +2 -0
- package/lib/plugins/plan.js +192 -0
- package/lib/plugins/plugin-manager.d.ts +2 -0
- package/lib/plugins/plugin-manager.js +165 -0
- package/lib/plugins/presets.d.ts +2 -0
- package/lib/plugins/presets.js +182 -0
- package/lib/plugins/prompt.d.ts +2 -0
- package/lib/plugins/prompt.js +264 -0
- package/lib/plugins/ptc.d.ts +2 -0
- package/lib/plugins/ptc.js +272 -0
- package/lib/plugins/remote/http.d.ts +11 -0
- package/lib/plugins/remote/http.js +11 -0
- package/lib/plugins/remote/routes.d.ts +24 -0
- package/lib/plugins/remote/routes.js +384 -0
- package/lib/plugins/remote/types.d.ts +135 -0
- package/lib/plugins/remote/types.js +87 -0
- package/lib/plugins/remote.d.ts +17 -0
- package/lib/plugins/remote.js +1028 -0
- package/lib/plugins/runtime-api.d.ts +16 -0
- package/lib/plugins/runtime-api.js +99 -0
- package/lib/plugins/runtime.d.ts +10 -0
- package/lib/plugins/runtime.js +451 -0
- package/lib/plugins/sandbox.d.ts +2 -0
- package/lib/plugins/sandbox.js +761 -0
- package/lib/plugins/schedule.d.ts +26 -0
- package/lib/plugins/schedule.js +538 -0
- package/lib/plugins/self-improve.d.ts +61 -0
- package/lib/plugins/self-improve.js +953 -0
- package/lib/plugins/session-search.d.ts +16 -0
- package/lib/plugins/session-search.js +308 -0
- package/lib/plugins/session-title.d.ts +19 -0
- package/lib/plugins/session-title.js +109 -0
- package/lib/plugins/session.d.ts +7 -0
- package/lib/plugins/session.js +296 -0
- package/lib/plugins/settings.d.ts +3 -0
- package/lib/plugins/settings.js +705 -0
- package/lib/plugins/skills.d.ts +2 -0
- package/lib/plugins/skills.js +360 -0
- package/lib/plugins/spill.d.ts +16 -0
- package/lib/plugins/spill.js +200 -0
- package/lib/plugins/subagent.d.ts +2 -0
- package/lib/plugins/subagent.js +862 -0
- package/lib/plugins/surfaces.d.ts +11 -0
- package/lib/plugins/surfaces.js +20 -0
- package/lib/plugins/team.d.ts +16 -0
- package/lib/plugins/team.js +149 -0
- package/lib/plugins/todo.d.ts +19 -0
- package/lib/plugins/todo.js +188 -0
- package/lib/plugins/tool-search.d.ts +2 -0
- package/lib/plugins/tool-search.js +425 -0
- package/lib/plugins/tools-default.d.ts +12 -0
- package/lib/plugins/tools-default.js +275 -0
- package/lib/plugins/tools.d.ts +16 -0
- package/lib/plugins/tools.js +62 -0
- package/lib/plugins/transcript.d.ts +15 -0
- package/lib/plugins/transcript.js +311 -0
- package/lib/plugins/tui.d.ts +2 -0
- package/lib/plugins/tui.js +98 -0
- package/lib/plugins/waiting.d.ts +12 -0
- package/lib/plugins/waiting.js +34 -0
- package/lib/plugins/web-search.d.ts +14 -0
- package/lib/plugins/web-search.js +263 -0
- package/lib/plugins/webserver.d.ts +48 -0
- package/lib/plugins/webserver.js +228 -0
- package/lib/remote/assets/app-DAcUCOEn.js +14 -0
- package/lib/remote/assets/icon-192.png +0 -0
- package/lib/remote/assets/icon-512.png +0 -0
- package/lib/remote/assets/index.html +34 -0
- package/lib/remote/assets/manifest.json +27 -0
- package/lib/remote/assets/style-DIB6729x.css +1 -0
- package/lib/remote/assets/sw.js +66 -0
- package/lib/services/types.d.ts +1228 -0
- package/lib/services/types.js +1 -0
- package/lib/tools/config-cli.d.ts +1 -0
- package/lib/tools/config-cli.js +89 -0
- package/lib/ui/arrival.d.ts +72 -0
- package/lib/ui/arrival.js +105 -0
- package/lib/ui/assets/app-B70nVIKd.js +69 -0
- package/lib/ui/assets/chunk-2UxHyX5q.js +1 -0
- package/lib/ui/assets/chunk-B1dDrJ26.js +1 -0
- package/lib/ui/assets/chunk-B6aJPvgy.js +1 -0
- package/lib/ui/assets/chunk-BEwlwnbL.js +1 -0
- package/lib/ui/assets/chunk-BGcgwlCI.js +12 -0
- package/lib/ui/assets/chunk-BIGW1oBm.js +1 -0
- package/lib/ui/assets/chunk-BPQ3VLAy.js +1 -0
- package/lib/ui/assets/chunk-BRH0KZbk.js +141 -0
- package/lib/ui/assets/chunk-BX6H_ySx.js +1 -0
- package/lib/ui/assets/chunk-B_P3UbPa.js +1 -0
- package/lib/ui/assets/chunk-B_TYUkTI.js +1 -0
- package/lib/ui/assets/chunk-B_vNuMnf.js +1 -0
- package/lib/ui/assets/chunk-BajyYBss.js +10 -0
- package/lib/ui/assets/chunk-BdnUsdx6.js +1 -0
- package/lib/ui/assets/chunk-Buea-lGh.js +1 -0
- package/lib/ui/assets/chunk-C0PvZCCE.js +1 -0
- package/lib/ui/assets/chunk-C0m74zRD.js +1 -0
- package/lib/ui/assets/chunk-C27-OAKa.js +1 -0
- package/lib/ui/assets/chunk-C2oV4EkX.js +1 -0
- package/lib/ui/assets/chunk-C7zT0LnQ.js +1 -0
- package/lib/ui/assets/chunk-C9GSunVT.js +1 -0
- package/lib/ui/assets/chunk-C9tS-k6U.js +1 -0
- package/lib/ui/assets/chunk-CHLpvVh8.js +1 -0
- package/lib/ui/assets/chunk-CLxacb5B.js +1 -0
- package/lib/ui/assets/chunk-COt5Ahok.js +1 -0
- package/lib/ui/assets/chunk-CPTIWCL2.js +1 -0
- package/lib/ui/assets/chunk-CQLl-L-p.js +1 -0
- package/lib/ui/assets/chunk-CUWRgxuq.js +55 -0
- package/lib/ui/assets/chunk-CWanVSXC.js +1 -0
- package/lib/ui/assets/chunk-Cf5RLm7j.js +1 -0
- package/lib/ui/assets/chunk-CickPsom.js +1 -0
- package/lib/ui/assets/chunk-Cj5Yp3dK.js +1 -0
- package/lib/ui/assets/chunk-Cmh6b_Ma.js +1 -0
- package/lib/ui/assets/chunk-Cp-IABpG.js +1 -0
- package/lib/ui/assets/chunk-CqE71os6.js +1 -0
- package/lib/ui/assets/chunk-CtKP3W-j.js +1 -0
- package/lib/ui/assets/chunk-Cvjx9yec.js +1 -0
- package/lib/ui/assets/chunk-CxGP3dtY.js +1 -0
- package/lib/ui/assets/chunk-CylS5w8V.js +1 -0
- package/lib/ui/assets/chunk-D38fbIBN.js +1 -0
- package/lib/ui/assets/chunk-D97Zzqfu.js +1 -0
- package/lib/ui/assets/chunk-DAi9KRSo.js +1 -0
- package/lib/ui/assets/chunk-DHK4yRfg.js +1 -0
- package/lib/ui/assets/chunk-DJeabLx-.js +1 -0
- package/lib/ui/assets/chunk-DNRxmY5a.js +1 -0
- package/lib/ui/assets/chunk-DNSN1z5r.js +1 -0
- package/lib/ui/assets/chunk-DNasK_ZG.js +1 -0
- package/lib/ui/assets/chunk-DPvrY3IQ.js +1 -0
- package/lib/ui/assets/chunk-DXmwc3jG.js +1 -0
- package/lib/ui/assets/chunk-Dd0kTxKP.js +1 -0
- package/lib/ui/assets/chunk-De0Btta0.js +1 -0
- package/lib/ui/assets/chunk-Des-eS-w.js +1 -0
- package/lib/ui/assets/chunk-Df6bDoY_.js +1 -0
- package/lib/ui/assets/chunk-DijEV5ha.js +1 -0
- package/lib/ui/assets/chunk-DkvoVjww.js +1 -0
- package/lib/ui/assets/chunk-DlC-OlHO.js +1 -0
- package/lib/ui/assets/chunk-DnzrXTVv.js +1 -0
- package/lib/ui/assets/chunk-Dualf0xi.js +1 -0
- package/lib/ui/assets/chunk-EXT84bkm.js +1 -0
- package/lib/ui/assets/chunk-GwR3hkPK.js +1 -0
- package/lib/ui/assets/chunk-P80f7IUj.js +1 -0
- package/lib/ui/assets/chunk-VOosw3JB.js +1 -0
- package/lib/ui/assets/chunk-YQ4lDkt_.js +140 -0
- package/lib/ui/assets/chunk-Yzrsuije.js +1 -0
- package/lib/ui/assets/chunk-Z72CF80r.js +1 -0
- package/lib/ui/assets/chunk-g9-lgVsj.js +1 -0
- package/lib/ui/assets/chunk-vGWfd6FD.js +1 -0
- package/lib/ui/assets/chunk-wDzz0qaB.js +1 -0
- package/lib/ui/assets/chunk-ySF7HWmS.js +1 -0
- package/lib/ui/assets/icon.png +0 -0
- package/lib/ui/assets/index.html +14 -0
- package/lib/ui/assets/pdf.worker.min-CjEcRF4W.mjs +28 -0
- package/lib/ui/assets/style-Bq01xH_b.css +1 -0
- package/lib/ui/frames.d.ts +67 -0
- package/lib/ui/frames.js +146 -0
- package/lib/ui/index.d.ts +59 -0
- package/lib/ui/index.js +50 -0
- package/lib/ui/manifest.d.ts +172 -0
- package/lib/ui/manifest.js +158 -0
- package/lib/ui/plugin.d.ts +161 -0
- package/lib/ui/plugin.js +7 -0
- package/lib/ui/plugins/browser/client.js +290 -0
- package/lib/ui/plugins/browser/icon.png +0 -0
- package/lib/ui/plugins/composer/client.js +1843 -0
- package/lib/ui/plugins/composer/icon.png +0 -0
- package/lib/ui/plugins/files/client.js +646 -0
- package/lib/ui/plugins/files/icon.png +0 -0
- package/lib/ui/plugins/manifest.json +107 -0
- package/lib/ui/plugins/plugins/client.js +682 -0
- package/lib/ui/plugins/plugins/icon.png +0 -0
- package/lib/ui/plugins/preview/client.js +197 -0
- package/lib/ui/plugins/preview/icon.png +0 -0
- package/lib/ui/plugins/prompt/client.js +653 -0
- package/lib/ui/plugins/prompt/icon.png +0 -0
- package/lib/ui/plugins/sessions/client.js +1577 -0
- package/lib/ui/plugins/sessions/icon.png +0 -0
- package/lib/ui/plugins/settings/client.js +5470 -0
- package/lib/ui/plugins/settings/icon.png +0 -0
- package/lib/ui/plugins/skills/client.js +485 -0
- package/lib/ui/plugins/skills/icon.png +0 -0
- package/lib/ui/plugins/status/client.js +1420 -0
- package/lib/ui/plugins/status/icon.png +0 -0
- package/lib/ui/plugins/statusbar/client.js +504 -0
- package/lib/ui/plugins/statusbar/icon.png +0 -0
- package/lib/ui/plugins/tasks/client.js +52 -0
- package/lib/ui/plugins/tasks/icon.png +0 -0
- package/lib/ui/plugins/team/client.js +527 -0
- package/lib/ui/plugins/team/icon.png +0 -0
- package/lib/ui/plugins/terminal/client.js +232 -0
- package/lib/ui/plugins/terminal/icon.png +0 -0
- package/lib/ui/plugins/trace/client.js +1376 -0
- package/lib/ui/plugins/trace/icon.png +0 -0
- package/lib/ui/plugins/transcript/client.js +2661 -0
- package/lib/ui/plugins/transcript/icon.png +0 -0
- package/lib/ui/scoped-slots.d.ts +20 -0
- package/lib/ui/scoped-slots.js +21 -0
- package/lib/ui/sdk/@dsc/ui/index.d.ts +242 -0
- package/lib/ui/sdk/@dsc/ui/package.json +16 -0
- package/lib/ui/sdk/@dsc/ui-core/contract.d.ts +1973 -0
- package/lib/ui/sdk/@dsc/ui-core/core/diff-text.d.ts +74 -0
- package/lib/ui/sdk/@dsc/ui-core/core/dock-browser.d.ts +137 -0
- package/lib/ui/sdk/@dsc/ui-core/core/dock-ops.d.ts +59 -0
- package/lib/ui/sdk/@dsc/ui-core/core/model-caps.d.ts +83 -0
- package/lib/ui/sdk/@dsc/ui-core/core/native-bridge.d.ts +135 -0
- package/lib/ui/sdk/@dsc/ui-core/core/token-estimate.d.ts +55 -0
- package/lib/ui/sdk/@dsc/ui-core/package.json +16 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/arrival.d.ts +72 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/frames.d.ts +67 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/index.d.ts +59 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/manifest.d.ts +172 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/plugin.d.ts +161 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/scoped-slots.d.ts +20 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/services-react.d.ts +27 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/services.d.ts +63 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/slots-react.d.ts +28 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/slots.d.ts +481 -0
- package/lib/ui/sdk/@dsc/ui-core/ui/store.d.ts +89 -0
- package/lib/ui/sdk/@dsc/ui-dockkit/dock-model.d.ts +238 -0
- package/lib/ui/sdk/@dsc/ui-dockkit/dock-state.d.ts +163 -0
- package/lib/ui/sdk/@dsc/ui-dockkit/dock.d.ts +24 -0
- package/lib/ui/sdk/@dsc/ui-dockkit/index.d.ts +15 -0
- package/lib/ui/sdk/@dsc/ui-dockkit/package.json +16 -0
- package/lib/ui/sdk/@dsc/ui-layout/app.d.ts +74 -0
- package/lib/ui/sdk/@dsc/ui-layout/appearance.d.ts +70 -0
- package/lib/ui/sdk/@dsc/ui-layout/host-channel.d.ts +112 -0
- package/lib/ui/sdk/@dsc/ui-layout/index.d.ts +34 -0
- package/lib/ui/sdk/@dsc/ui-layout/package.json +16 -0
- package/lib/ui/sdk/@dsc/ui-layout/page-state.d.ts +14 -0
- package/lib/ui/sdk/@dsc/ui-layout/review-pane.d.ts +21 -0
- package/lib/ui/sdk/@dsc/ui-layout/runtime-context.d.ts +44 -0
- package/lib/ui/sdk/@dsc/ui-layout/thread-view.d.ts +28 -0
- package/lib/ui/sdk/@dsc/ui-layout/update-button.d.ts +21 -0
- package/lib/ui/sdk/@dsc/ui-primitives/code-file-icon-artwork.d.ts +53 -0
- package/lib/ui/sdk/@dsc/ui-primitives/code-view.d.ts +15 -0
- package/lib/ui/sdk/@dsc/ui-primitives/compat.d.ts +27 -0
- package/lib/ui/sdk/@dsc/ui-primitives/completion-sound.d.ts +24 -0
- package/lib/ui/sdk/@dsc/ui-primitives/confirm.d.ts +33 -0
- package/lib/ui/sdk/@dsc/ui-primitives/css.d.ts +47 -0
- package/lib/ui/sdk/@dsc/ui-primitives/diff-rows.d.ts +20 -0
- package/lib/ui/sdk/@dsc/ui-primitives/file-icons.d.ts +38 -0
- package/lib/ui/sdk/@dsc/ui-primitives/file-type-classify.d.ts +66 -0
- package/lib/ui/sdk/@dsc/ui-primitives/file-type-icon.d.ts +57 -0
- package/lib/ui/sdk/@dsc/ui-primitives/highlight.d.ts +24 -0
- package/lib/ui/sdk/@dsc/ui-primitives/hover-delay.d.ts +17 -0
- package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +109 -0
- package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +55 -0
- package/lib/ui/sdk/@dsc/ui-primitives/lang-table.d.ts +10 -0
- package/lib/ui/sdk/@dsc/ui-primitives/markdown.d.ts +20 -0
- package/lib/ui/sdk/@dsc/ui-primitives/native.d.ts +41 -0
- package/lib/ui/sdk/@dsc/ui-primitives/package.json +16 -0
- package/lib/ui/sdk/@dsc/ui-primitives/panels.d.ts +86 -0
- package/lib/ui/sdk/@dsc/ui-primitives/paths.d.ts +11 -0
- package/lib/ui/sdk/@dsc/ui-primitives/pdf-view.d.ts +13 -0
- package/lib/ui/sdk/@dsc/ui-primitives/plugin-text.d.ts +15 -0
- package/lib/ui/sdk/@dsc/ui-primitives/select.d.ts +35 -0
- package/lib/ui/sdk/@dsc/ui-primitives/table-view.d.ts +23 -0
- package/lib/ui/sdk/@dsc/ui-primitives/thread-resizer.d.ts +22 -0
- package/lib/ui/sdk/@dsc/ui-primitives/time.d.ts +33 -0
- package/lib/ui/sdk/@dsc/ui-primitives/toast.d.ts +16 -0
- package/lib/ui/sdk/@dsc/ui-primitives/tokens.d.ts +14 -0
- package/lib/ui/sdk/@dsc/ui-primitives/tool-args.d.ts +49 -0
- package/lib/ui/sdk/@dsc/ui-primitives/tool-summary.d.ts +64 -0
- package/lib/ui/sdk/@dsc/ui-renderer/boot.d.ts +121 -0
- package/lib/ui/sdk/@dsc/ui-renderer/hmr.d.ts +43 -0
- package/lib/ui/sdk/@dsc/ui-renderer/index.d.ts +20 -0
- package/lib/ui/sdk/@dsc/ui-renderer/package.json +16 -0
- package/lib/ui/sdk/@dsc/ui-slots/index.d.ts +19 -0
- package/lib/ui/sdk/@dsc/ui-slots/package.json +16 -0
- package/lib/ui/sdk/@dsc/ui-slots/slots-react.d.ts +48 -0
- package/lib/ui/sdk/@dsc/ui-slots/slots.d.ts +102 -0
- package/lib/ui/services-react.d.ts +27 -0
- package/lib/ui/services-react.js +32 -0
- package/lib/ui/services.d.ts +63 -0
- package/lib/ui/services.js +121 -0
- package/lib/ui/slots-ink.d.ts +26 -0
- package/lib/ui/slots-ink.js +78 -0
- package/lib/ui/slots-react.d.ts +28 -0
- package/lib/ui/slots-react.js +88 -0
- package/lib/ui/slots.d.ts +481 -0
- package/lib/ui/slots.js +550 -0
- package/lib/ui/store.d.ts +89 -0
- package/lib/ui/store.js +62 -0
- package/lib/ui/tui-plugin-api.d.ts +23 -0
- package/lib/ui/tui-plugin-api.js +23 -0
- package/lib/ui/tui-plugins.d.ts +47 -0
- package/lib/ui/tui-plugins.js +220 -0
- package/package.json +58 -6
|
@@ -0,0 +1,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;
|