@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,67 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 界面壳侧的帧归并:把宿主推来的全量/增量帧并进一份快照。
|
|
3
|
+
*
|
|
4
|
+
* 线协议与遥控端(`remote-web/src/lib/reduce.ts`)是**同一份**(`core/remote/frames.ts` 定的
|
|
5
|
+
* 契约:全量 `{type:'snapshot', seq, full:true, ...字段铺平}`、增量
|
|
6
|
+
* `{type:'delta', seq, full:false, meta, added, updated, removedIds, liveEntries}`)。
|
|
7
|
+
*
|
|
8
|
+
* 与遥控端那份的区别只有一个,而且是有意的:**这里是严格版**。遥控端要容忍版本漂移
|
|
9
|
+
* (客户端的页面可能是旧构建、宿主可能是旧版本,字段形状对不上也得画出来),所以它有一整套
|
|
10
|
+
* `normalize*` 兜底;界面壳与宿主永远同一次构建一起发(壳就是从宿主的 `/` 里取回来的),
|
|
11
|
+
* 认不出的帧直接当错误处理——把「容忍」换成「早暴露」,省掉的兜底代码不再需要维护两遍口径。
|
|
12
|
+
*
|
|
13
|
+
* 条目按 id 合并后统一按 id 升序:宿主发号递增,id 序就是时间序,比维护插入序少一处状态。
|
|
14
|
+
*
|
|
15
|
+
* 另外这里**认帧号**(`seq`):首帧必须是全量、游标只许前进、增量不许跳号。
|
|
16
|
+
* 遥控端那份只看内容不看序号,所以漏帧要等下一帧全量锚才发现;壳这边当场就能发现。
|
|
17
|
+
*
|
|
18
|
+
* @module dsc/ui/frames
|
|
19
|
+
*/
|
|
20
|
+
/** 帧里的条目:id 是宿主发的正数(负 id 是直播尾,走 liveEntries)。 */
|
|
21
|
+
export interface HostEntry {
|
|
22
|
+
id: number;
|
|
23
|
+
[key: string]: unknown;
|
|
24
|
+
}
|
|
25
|
+
/** 归并后的快照:`meta`(除 entries / liveEntries 之外的字段)+ 条目 + 直播尾。 */
|
|
26
|
+
export interface HostSnapshot {
|
|
27
|
+
seq: number;
|
|
28
|
+
entries: HostEntry[];
|
|
29
|
+
liveEntries: HostEntry[];
|
|
30
|
+
[key: string]: unknown;
|
|
31
|
+
}
|
|
32
|
+
/** 认不出的帧抛这个(严格版:宁可报错也不要画出一份半对不对的状态)。 */
|
|
33
|
+
export declare class HostFrameError extends Error {
|
|
34
|
+
}
|
|
35
|
+
/**
|
|
36
|
+
* 帧号中间缺了几帧抛这个。
|
|
37
|
+
*
|
|
38
|
+
* 为什么单独成一个类型:缺口的处理方式与「帧认不出」不同——认不出的帧扔掉就行,缺口却
|
|
39
|
+
* 永远补不回来(增量是相对上一帧的差),只能整条通道重开去换一帧全量。调用方
|
|
40
|
+
* (`ui-shell/src/host-channel.ts`)据此主动断开 EventSource 触发干净重连。
|
|
41
|
+
*
|
|
42
|
+
* 继承 HostFrameError:只判「帧有问题」的调用方不必改。
|
|
43
|
+
*/
|
|
44
|
+
export declare class HostFrameGapError extends HostFrameError {
|
|
45
|
+
}
|
|
46
|
+
/** 帧顶层是不是全量(先看 `full`,再看 `type`)。 */
|
|
47
|
+
export declare function isFullFrame(raw: unknown): boolean;
|
|
48
|
+
/** 帧顶层的 seq。 */
|
|
49
|
+
export declare function readFrameSeq(raw: unknown): number | null;
|
|
50
|
+
/**
|
|
51
|
+
* 把一帧并进当前快照。
|
|
52
|
+
*
|
|
53
|
+
* 三条序号不变量(对齐 `packages/api/gateway/src/client/snapshot-stream.ts` 的语义:
|
|
54
|
+
* 每一代(一次连接)的第一帧必须是全量,游标只许前进):
|
|
55
|
+
*
|
|
56
|
+
* 1. `previous === null` 时只收全量帧:增量是相对上一帧的差,没有基准可并;
|
|
57
|
+
* 2. `seq <= previous.seq`(重复帧、回退帧)直接丢掉,返回原状态——重连补帧会重发;
|
|
58
|
+
* 3. 增量帧 `seq > previous.seq + 1`(缺口)抛 {@link HostFrameGapError}。
|
|
59
|
+
* 全量帧不查缺口:它自带完整状态,跳多远都能直接顶上(跨窗口重连给的正是这种)。
|
|
60
|
+
*
|
|
61
|
+
* @param previous - 当前快照(首帧传 null)
|
|
62
|
+
* @param raw - 宿主推来的一帧(已 JSON 解析)
|
|
63
|
+
* @returns 新的快照;回退/重复帧返回传入的 `previous`(引用不变)
|
|
64
|
+
* @throws {HostFrameGapError} 增量帧跳号(缺口)
|
|
65
|
+
* @throws {HostFrameError} 帧认不出(不是对象、缺 seq、首帧不是全量、条目形状不对)
|
|
66
|
+
*/
|
|
67
|
+
export declare function applyHostFrame(previous: HostSnapshot | null, raw: unknown): HostSnapshot;
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 插件版界面的共用核心:宿主(组清单、发 bundle)与界面壳(建注册表、装插件)
|
|
3
|
+
* 共用这一份,浏览器安全——不 import 任何 node 内置模块。
|
|
4
|
+
*
|
|
5
|
+
* @module dsc/ui
|
|
6
|
+
*/
|
|
7
|
+
export * from './frames.js';
|
|
8
|
+
export * from './manifest.js';
|
|
9
|
+
export * from './arrival.js';
|
|
10
|
+
export * from './plugin.js';
|
|
11
|
+
export * from './slots.js';
|
|
12
|
+
export * from './store.js';
|
|
13
|
+
export * from './scoped-slots.js';
|
|
14
|
+
export * from './services.js';
|
|
15
|
+
/**
|
|
16
|
+
* 服务表的 React 订阅面(`ServicesProvider` / `useService`):壳把装载出来的服务表
|
|
17
|
+
* 经 context 交给条目组件,插件跟着服务的出现/消失换数据源。
|
|
18
|
+
*/
|
|
19
|
+
export * from './services-react.js';
|
|
20
|
+
/**
|
|
21
|
+
* 槽位注册表的 React 订阅面(useSlot / useSlotFaults):浏览器壳与终端壳共用。
|
|
22
|
+
* 为什么在共享层:两个壳的「组件」都是 React 组件,订阅语义只有一份;
|
|
23
|
+
* 渲染出口(SlotOutlet)各壳自持——条目外层的包装是载体自己的事。
|
|
24
|
+
*/
|
|
25
|
+
export * from './slots-react.js';
|
|
26
|
+
/**
|
|
27
|
+
* 原生桥的规格(操作名 + 实参形状 + 校验)也从这里转出去。
|
|
28
|
+
*
|
|
29
|
+
* 为什么宿主侧的一份 `core` 模块能进界面壳的入口:`core/native-bridge.ts` 与上面几份
|
|
30
|
+
* 守同一个约束——**零 node 依赖、浏览器安全**。桌面主进程与界面壳因此读的是同一份规格:
|
|
31
|
+
* 加一个原生操作,两侧同时知道;漂移在编译期就暴露(而不是等线上某个插件调到 undefined)。
|
|
32
|
+
*/
|
|
33
|
+
export * from '../core/native-bridge.js';
|
|
34
|
+
/**
|
|
35
|
+
* 正文 token 粗估(`core/token-estimate.ts`)也进共享面:消息流的「~N tok」回落读数
|
|
36
|
+
* 与宿主自动压缩的阈值必须同源。它与 native-bridge 守同一条约束——纯函数、零 node 依赖、
|
|
37
|
+
* 浏览器安全,所以界面壳可以直接拿这一份,不必在壳里再抄一个口径。
|
|
38
|
+
*/
|
|
39
|
+
export * from '../core/token-estimate.js';
|
|
40
|
+
/**
|
|
41
|
+
* 模型能力枚举(`core/model-caps.ts`):设置 → 模型页的思考档位 / 档位字段 / 输入模态
|
|
42
|
+
* 三组勾选与这里一字不差——档位清单、中文标签、线上值提示只有一份,宿主发请求的口径
|
|
43
|
+
* 与界面上勾的东西才不会各说各话。同一条约束(type-only import,浏览器安全)。
|
|
44
|
+
*/
|
|
45
|
+
export * from '../core/model-caps.js';
|
|
46
|
+
/**
|
|
47
|
+
* 文本差异算法(`core/diff-text.ts`)同理进共享面:工具卡的「将做的改动」在界面侧
|
|
48
|
+
* 从参数 + 盘上现值推演 diff,用的就是宿主算轮尾差异的同一份算法。
|
|
49
|
+
*/
|
|
50
|
+
export * from '../core/diff-text.js';
|
|
51
|
+
/**
|
|
52
|
+
* 宿主那些**界面要读的**视图类型的再导出。
|
|
53
|
+
*
|
|
54
|
+
* 为什么全是 `export type`:编译期就擦掉了,浏览器壳不会因为这一行把 `contract.ts`
|
|
55
|
+
* 拉进包里,也就不引入任何运行期耦合。为什么值得这么做:消息流要按条目种类分别渲染,
|
|
56
|
+
* 靠 `unknown` 手写类型收窄的话,宿主改一个字段名壳这边不会报错——那恰好是最该被
|
|
57
|
+
* 编译器抓住的一类改动。
|
|
58
|
+
*/
|
|
59
|
+
export type { ApprovalAnswer, ArchivedPage, ArchivedSessionView, ApprovalDiffView, ApprovalPolicy, ApprovalReviewer, PermissionPresetSurface, PermissionPresetView, ApprovalRequestView, AskOptionView, AskUserView, BackgroundOutputView, BackgroundWorkView, ChangedFileView, CollaborationMode, ConnectionTestOutcome, ConnectionTestView, ContextSegmentsView, DiffHunkView, DiffLineView, EffortLevel, EffortMap, GitSurface, GoalView, LinkShareData, ModeSurface, ModelChoiceView, ModelConfigView, Modality, NoticeMessageView, PairShareData, PlanDecision, PlanEntryView, PlanView, PolicySurface, PresetDraft, PresetFileView, PresetSurface, PresetView, ProviderDraft, ProviderModelView, ProviderView, QueuedMessageView, RuntimeSnapshot, ScheduledTaskView, SessionRunState, SessionSummary, SettingsField, SettingsGroupView, SettingsMutation, SettingsSectionView, SettingsValue, SettingsValues, StatusView, SubagentCardView, TeammateView, ThemeMode, ThinkingLevel, ThinkingParam, TierOption, TodoItemView, TodoStatus, TodoView, TokenUsageView, ToolCallView, ToolEntryView, ToolStatus, TranscriptEntry, TurnEndReason, UiDensity, UiFontSize, UiCommandView, UiPrefsView, UsageDayView, UsageModelView, UsageStatsView, } from '../contract.js';
|
|
@@ -0,0 +1,172 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 插件版界面的启动清单(boot graph):宿主告诉界面壳「要加载哪几个插件包、
|
|
3
|
+
* 按什么顺序、每个包从哪个地址取」。
|
|
4
|
+
*
|
|
5
|
+
* 这一份是宿主与浏览器壳之间的**唯一契约**(对齐 dsh 的 `window.__DSH_BOOT__`
|
|
6
|
+
* 与它的 WebBootEntry / WebBootGraph)。
|
|
7
|
+
*
|
|
8
|
+
* 为什么顺序要算而不是照抄声明顺序:插件包之间有依赖(A 的组件要 import B 的槽),
|
|
9
|
+
* 顺序错了 A 会在 B 的槽还没声明时去注册,当场报错。所以这里做一次拓扑排序,
|
|
10
|
+
* 并且在成环时**报出来是哪几个包成环**而不是死循环。
|
|
11
|
+
*
|
|
12
|
+
* @module dsc/ui/manifest
|
|
13
|
+
*/
|
|
14
|
+
/** 插件包能跑在哪种壳里。web = 浏览器壳(桌面与远程共用),tui = 终端壳(同进程)。 */
|
|
15
|
+
export type UiPlatform = 'web' | 'tui';
|
|
16
|
+
/**
|
|
17
|
+
* 一个批的调度档位:`early` 是首屏批(壳装完它才画第一帧),`application` 是其余全部。
|
|
18
|
+
*
|
|
19
|
+
* 为什么不用参考实现的 `'bootstrap' | 'application'`:它的 bootstrap 批是**页面里的模块系统
|
|
20
|
+
* 本身**(parser-blocking、先于壳执行);dsc 的壳就是普通 ESM app,没有这一层。照抄会得到一个
|
|
21
|
+
* 永远为空的批或一个误导性的词。只对齐「批描述符 + 每 entry 恰属一批」的不变量,词表用我们自己的。
|
|
22
|
+
*
|
|
23
|
+
* 这是**页面加载级**的属性:HMR 重更一条插件不会改它的 phase,改 phase 要刷新页面。
|
|
24
|
+
*/
|
|
25
|
+
export type UiBootPhase = 'early' | 'application';
|
|
26
|
+
/**
|
|
27
|
+
* 一个启动批:一次取数覆盖的一组成员。
|
|
28
|
+
*
|
|
29
|
+
* 批 URL 是 combo(`plugins/??<id>/client.js,…&rev=<批 rev>`,A3 起由
|
|
30
|
+
* {@link uiComboBatchUrl} 生成);`url`/`rev` 可选是为了向前兼容——旧宿主(或探针手工组图)不给
|
|
31
|
+
* 这两个字段时,界面壳按 entries 逐条走单资源 URL。
|
|
32
|
+
*/
|
|
33
|
+
export interface UiBootBatch {
|
|
34
|
+
phase: UiBootPhase;
|
|
35
|
+
/** 批脚本的地址(document-relative,形状同 {@link UiPluginEntry.url})。 */
|
|
36
|
+
url?: string;
|
|
37
|
+
/** 批内容的版本锚:任一成员 rev 变则它变(与 url 同生共死)。 */
|
|
38
|
+
rev?: string;
|
|
39
|
+
/** 本批要注册工厂的 entry id,按执行顺序。 */
|
|
40
|
+
entries: string[];
|
|
41
|
+
}
|
|
42
|
+
/** 宿主发现的一个插件包(还没算地址)。 */
|
|
43
|
+
export interface UiPluginRow {
|
|
44
|
+
/** 稳定 id,也是 /plugins/<id>/client.js 里的那一段。 */
|
|
45
|
+
id: string;
|
|
46
|
+
/** 允许它 import 的额外模块名;其余一律拒绝(白名单,见界面壳的加载器)。 */
|
|
47
|
+
external?: string[];
|
|
48
|
+
/**
|
|
49
|
+
* 依赖名单。**双关**:先按「清单里另一个插件的 id」解(拓扑排序用的就是它),
|
|
50
|
+
* 再按「服务名」解(A1 的服务表里有没有提供者)。
|
|
51
|
+
*
|
|
52
|
+
* 顺序上的意义只是优化(被依赖的排前面);硬语义在装载器:两条路都解不到时这个插件
|
|
53
|
+
* **不 apply**,报告里留一行中文原因(「插件 X 没装上:…」或「服务 X 还没有提供者」)。
|
|
54
|
+
* 提供者缺席要软降级(有回落实现)的插件不要写进来,用 `ui.consume` 在渲染期读。
|
|
55
|
+
*/
|
|
56
|
+
inject?: string[];
|
|
57
|
+
/** 第一档预取:需要尽早出现的插件(大小药丸、状态条之类)。与 phase 正交。 */
|
|
58
|
+
immediately?: boolean;
|
|
59
|
+
/** 调度档位;缺省 application。只对 web 载体的批有意义(TUI 是同进程顺序装载)。 */
|
|
60
|
+
phase?: UiBootPhase;
|
|
61
|
+
/** 缺省 web。 */
|
|
62
|
+
platform?: UiPlatform;
|
|
63
|
+
/**
|
|
64
|
+
* 插件声明的 `@dsc/ui` 契约版本区间(semver,如 `^1.0.0`)。宿主拿它对壳的
|
|
65
|
+
* `apiVersion` 做门禁:不满足就不进启动图,原因写进 problems——
|
|
66
|
+
* 判定在宿主侧,浏览器产物里不需要 semver。内置清单(构建产物自带
|
|
67
|
+
* `apiVersion`)的条目没有这一项,视为与壳同源、总是满足。
|
|
68
|
+
*/
|
|
69
|
+
api?: string;
|
|
70
|
+
}
|
|
71
|
+
/** 清单里的一条(已经算好地址与版本)。 */
|
|
72
|
+
export interface UiPluginEntry {
|
|
73
|
+
id: string;
|
|
74
|
+
/** 相对页面的地址,形如 `plugins/hello/client.js?rev=abc123`。 */
|
|
75
|
+
url: string;
|
|
76
|
+
/** 产物版本:文件内容的短哈希,换字节就换地址。 */
|
|
77
|
+
rev: string;
|
|
78
|
+
inject?: string[];
|
|
79
|
+
external?: string[];
|
|
80
|
+
immediately?: boolean;
|
|
81
|
+
}
|
|
82
|
+
/** 宿主注入页面的启动图。 */
|
|
83
|
+
export interface UiBootGraph {
|
|
84
|
+
/** 整图的一致性锚:任一条(含声明的 phase)变了它就变。 */
|
|
85
|
+
rev: string;
|
|
86
|
+
entries: UiPluginEntry[];
|
|
87
|
+
/**
|
|
88
|
+
* 启动批,按执行顺序(early 在前)。每个 entry 恰好属于一个批;
|
|
89
|
+
* 没有 `phase` 声明的条目全部进 application 批——零声明的现状就是单批一行。
|
|
90
|
+
*/
|
|
91
|
+
batches: UiBootBatch[];
|
|
92
|
+
/** 界面壳要显示的宿主身份(哪台机器、哪个版本)。 */
|
|
93
|
+
host: {
|
|
94
|
+
name: string;
|
|
95
|
+
version: string;
|
|
96
|
+
};
|
|
97
|
+
}
|
|
98
|
+
/** 摘要函数:把若干字段拼成一个短哈希。默认那份不依赖 node,浏览器壳也能算。 */
|
|
99
|
+
export type HashFn = (...parts: readonly string[]) => string;
|
|
100
|
+
/**
|
|
101
|
+
* 一个插件包的地址。相对路径:页面挂在 `/` 或子路径下都成立。
|
|
102
|
+
* @param id - 插件 id
|
|
103
|
+
* @param rev - 产物版本
|
|
104
|
+
*/
|
|
105
|
+
export declare function pluginBundleUrl(id: string, rev: string): string;
|
|
106
|
+
/**
|
|
107
|
+
* 一个批的 combo 地址:`plugins/??<id>/client.js,<id>/client.js&rev=<批 rev>`。
|
|
108
|
+
*
|
|
109
|
+
* 形状对齐参考实现(每个资源带 `/client.js` 后缀、`rev` 用 `&` 分隔);批的 rev 是
|
|
110
|
+
* 成员 rev 的派生({@link uiComboBatchRev}),所以任一成员换字节整个批地址就换。
|
|
111
|
+
* 这是**路由地址**,不是产物路径——`??` 是宿主路由的判据。
|
|
112
|
+
*
|
|
113
|
+
* id 单段编码:第三方 id 可能是 `@scope/name`,`/` 在 query 里合法但编码最省心;
|
|
114
|
+
* 宿主按精确 URL 查表,浏览器原样转述这里生成的串,两边不会分叉。
|
|
115
|
+
*/
|
|
116
|
+
export declare function uiComboBatchUrl(ids: readonly string[], rev: string): string;
|
|
117
|
+
/** 批 rev:成员 rev 的有序派生(任一成员变则变)。 */
|
|
118
|
+
export declare function uiComboBatchRev(members: readonly {
|
|
119
|
+
id: string;
|
|
120
|
+
rev: string;
|
|
121
|
+
}[]): string;
|
|
122
|
+
/** 把若干字段拼成短哈希;字段间加长度前缀,防止内容在字段边界上搬家。 */
|
|
123
|
+
export declare function shortHash(...parts: readonly string[]): string;
|
|
124
|
+
/** 文件系统指纹:mtime / ctime / 大小三项,够判「文件换了没有」。 */
|
|
125
|
+
export interface ArtifactStat {
|
|
126
|
+
mtimeMs: number;
|
|
127
|
+
ctimeMs: number;
|
|
128
|
+
size: number;
|
|
129
|
+
}
|
|
130
|
+
/**
|
|
131
|
+
* 由文件指纹算产物版本(不读文件内容,构建后立刻能算)。
|
|
132
|
+
*
|
|
133
|
+
* 指纹取毫秒原值而不是取整:同一毫秒内、大小又恰好相同的重写会算出同一个版本,
|
|
134
|
+
* 那样浏览器一年内都不会回源拿新字节。
|
|
135
|
+
* @param stat - 文件指纹
|
|
136
|
+
* @param hash - 摘要函数;宿主侧传 sha256 那份(浏览器壳用不到这个函数)
|
|
137
|
+
*/
|
|
138
|
+
export declare function artifactRev(stat: ArtifactStat, hash?: HashFn): string;
|
|
139
|
+
/**
|
|
140
|
+
* 拓扑排序:被依赖的排在依赖者前面。
|
|
141
|
+
*
|
|
142
|
+
* 快照顺序来自宿主的扫描顺序(调用方传进来的顺序),只有依赖边会改变它,
|
|
143
|
+
* 所以同一批插件每次算出来的顺序都一样,界面不会重排。
|
|
144
|
+
*
|
|
145
|
+
* 顺序只是**优化**不是正确性前提:插件要往别人声明的槽里放东西,用
|
|
146
|
+
* `slots.injectSlot` 等声明出现即可,排不排都能成。
|
|
147
|
+
*
|
|
148
|
+
* @param rows - 宿主发现的插件包
|
|
149
|
+
* @returns 排好序的一份新数组
|
|
150
|
+
* @throws {Error} 成环或 id 重复时抛出(后者会让界面静默少一块,不能放过)
|
|
151
|
+
*/
|
|
152
|
+
export declare function orderUiPlugins<T extends UiPluginRow>(rows: readonly T[]): T[];
|
|
153
|
+
/**
|
|
154
|
+
* 由「插件 id + 产物版本」拼出启动图。顺序与分批在这里定,地址在这里算。
|
|
155
|
+
*
|
|
156
|
+
* 整图 rev 对**整条 entry**(含 inject / external / immediately)与**批结构**
|
|
157
|
+
* (含每条声明的 phase)做摘要:只改清单里的声明(不动 bundle)时整图 rev 也必须跟着变,
|
|
158
|
+
* 否则「靠 rev 判断要不要重载」的那一侧会漏掉声明类变更。
|
|
159
|
+
*
|
|
160
|
+
* 分批规则:按 phase 切片(early 在前),批内保持 `orderUiPlugins` 之后的相对顺序;
|
|
161
|
+
* 没写 phase 的条目全部进 application——零声明的现状等于「单批」,与今天的加载顺序等价。
|
|
162
|
+
* 空批不发(entries 非空不变量)。
|
|
163
|
+
*
|
|
164
|
+
* @param host - 宿主身份
|
|
165
|
+
* @param artifacts - 已算出 rev 的插件包(顺序即扫描顺序)
|
|
166
|
+
*/
|
|
167
|
+
export declare function composeUiBootGraph(host: {
|
|
168
|
+
name: string;
|
|
169
|
+
version: string;
|
|
170
|
+
}, artifacts: readonly (UiPluginRow & {
|
|
171
|
+
rev: string;
|
|
172
|
+
})[]): UiBootGraph;
|
|
@@ -0,0 +1,161 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 界面插件的契约:第三方与内置插件写的是同一份东西。
|
|
3
|
+
*
|
|
4
|
+
* 一个界面插件就是一个 JS bundle + 一次 `apply(ui)` 调用。它拿到的 `ui`
|
|
5
|
+
* 上有槽位注册表(往界面上放组件)和宿主身份(要显示版本号之类的用),
|
|
6
|
+
* 没有别的——网络、会话、宿主的 RPC 都**不**从这里给,那属于壳自己的事。
|
|
7
|
+
*
|
|
8
|
+
* 为什么不给插件任意 import 权限:界面代码跑在渲染进程里,能调宿主暴露的全部方法;
|
|
9
|
+
* 所以加载器只放行白名单模块(react / react-dom / @dsc/ui),其余 require 直接抛。
|
|
10
|
+
*
|
|
11
|
+
* @module dsc/ui/plugin
|
|
12
|
+
*/
|
|
13
|
+
import type { HostSnapshot } from './frames.js';
|
|
14
|
+
import type { FactoryDefinitionPropsOf, FactoryMapLike, SlotChildrenOf, SlotComponentLike, SlotEntry, SlotFactoryRegisterOptions, SlotKindOf, SlotMapLike, SlotPropsOf, SlotRegisterOptions } from './slots.js';
|
|
15
|
+
import type { SeatInstanceOf, StoreHandle } from './store.js';
|
|
16
|
+
import type { ServiceRegistry } from './services.js';
|
|
17
|
+
import type { UiPlatform } from './manifest.js';
|
|
18
|
+
/** 界面要显示的宿主身份。 */
|
|
19
|
+
export interface UiHostInfo {
|
|
20
|
+
/** 产品的显示名,例如 `Pneuma`。 */
|
|
21
|
+
name: string;
|
|
22
|
+
/** 宿主版本,例如 `0.6.67`。 */
|
|
23
|
+
version: string;
|
|
24
|
+
/**
|
|
25
|
+
* 装载这个插件的载体(阶段 6 起)。插件按它分支注册进哪条槽——
|
|
26
|
+
* 同一份 bundle 在浏览器壳与终端壳里各跑一次,靠的就是这一个字段;
|
|
27
|
+
* 缺省当 `web`(清单里 platform 缺省也是这个语义)。
|
|
28
|
+
*/
|
|
29
|
+
platform?: UiPlatform;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* 插件看到的那一面槽位注册表。
|
|
33
|
+
*
|
|
34
|
+
* 为什么给接口而不是直接把注册表类交出去:插件只需要「声明槽、注册组件、等一个槽
|
|
35
|
+
* 出现、查已经画了什么」,不需要知道谁崩了、怎么退位(那是壳的事)。接口窄一点,
|
|
36
|
+
* 将来给壳加内部能力时不会顺手把权限也扩给插件;而且加载器可以传一个**记账外壳**
|
|
37
|
+
* 进去,插件卸载或重试时按账本回滚。
|
|
38
|
+
*
|
|
39
|
+
* 三个类型参数与注册表同形:`M`(槽位契约表)在插件 import 的那个模块里合并,
|
|
40
|
+
* 槽名/owner/children/chain matched 全从表里推;`FM` 是 Factory 契约表。
|
|
41
|
+
*
|
|
42
|
+
* @typeParam C - 组件类型
|
|
43
|
+
* @typeParam M - 槽位契约表(未收窄时是开放的 `SlotMapLike`)
|
|
44
|
+
* @typeParam FM - Factory 契约表(未收窄时是开放的 `FactoryMapLike`)
|
|
45
|
+
*/
|
|
46
|
+
export interface UiSlotApi<C = unknown, M = SlotMapLike, FM = FactoryMapLike> {
|
|
47
|
+
/** 已声明的槽名(诊断与「这个槽在不在」的判断用)。 */
|
|
48
|
+
readonly slots: string[];
|
|
49
|
+
/** 某个槽的形态;没声明过给 undefined。 */
|
|
50
|
+
spec<K extends keyof M & string>(slot: K): SlotKindOf<M, K> | undefined;
|
|
51
|
+
declare<K extends keyof M & string>(slot: K, kind: SlotKindOf<M, K>): () => void;
|
|
52
|
+
/**
|
|
53
|
+
* 往一个已声明的槽里登记组件(props 约束从契约表推,写错在调用点就编不过)。
|
|
54
|
+
*/
|
|
55
|
+
register<K extends keyof M & string, const D extends SlotChildrenOf<M> = Record<never, never>, H extends StoreHandle<any, any> | undefined = undefined>(slot: K, options: SlotRegisterOptions<M, K, D, H>, component: C & SlotComponentLike<SlotPropsOf<M, K, D, H, FM>>): () => void;
|
|
56
|
+
/** 注册一个可复用的 Factory 定义(D2)。 */
|
|
57
|
+
registerFactory<F extends keyof FM & string>(options: SlotFactoryRegisterOptions<M, FM, F>, component: C & SlotComponentLike<FactoryDefinitionPropsOf<M, FM, F>>): () => void;
|
|
58
|
+
/**
|
|
59
|
+
* 读一个席位的共享实例(该 handle 已有登记才给实例,没有给 undefined)。
|
|
60
|
+
*
|
|
61
|
+
* 典型用法:插件经服务表(`useService`)拿到别的插件 provide 的 handle,
|
|
62
|
+
* 再经这里读同一份共享状态——team 抽名单、status 面板读同一份就是这条路。
|
|
63
|
+
*/
|
|
64
|
+
seat<H extends StoreHandle<any, any>>(handle: H): SeatInstanceOf<H> | undefined;
|
|
65
|
+
injectSlot<K extends keyof M & string>(slot: K, contribute: () => void | (() => void)): () => void;
|
|
66
|
+
entriesOf(slot: string): readonly SlotEntry<C>[];
|
|
67
|
+
winners(slot: string): readonly SlotEntry<C>[];
|
|
68
|
+
}
|
|
69
|
+
/**
|
|
70
|
+
* 插件拿到的运行时通道:订阅宿主快照 + 调宿主方法。
|
|
71
|
+
*
|
|
72
|
+
* 这一份是界面壳对「宿主」的全部认识——插件不必知道底下是 SSE、WebSocket 还是 IPC
|
|
73
|
+
* (桌面窗口走的是宿主伺服的同一份壳,浏览器里跑的是同一份代码)。
|
|
74
|
+
*/
|
|
75
|
+
export interface UiRuntimeApi {
|
|
76
|
+
/** 当前快照;还没收到第一帧时 null。 */
|
|
77
|
+
getSnapshot(): HostSnapshot | null;
|
|
78
|
+
/** 订阅变化(配合 React 的 useSyncExternalStore 用)。 */
|
|
79
|
+
subscribe(listener: () => void): () => void;
|
|
80
|
+
/**
|
|
81
|
+
* 调一个宿主方法(方法名与参数形状就是 `INVOKABLE_METHODS` 那一份白名单)。
|
|
82
|
+
* @param method - 方法名
|
|
83
|
+
* @param args - 实参
|
|
84
|
+
* @throws {Error} 方法不在白名单里、或执行失败
|
|
85
|
+
*/
|
|
86
|
+
invoke<T = unknown>(method: string, args?: unknown[]): Promise<T>;
|
|
87
|
+
}
|
|
88
|
+
/**
|
|
89
|
+
* 插件拿到的那一份 API。
|
|
90
|
+
*
|
|
91
|
+
* @typeParam C - 组件类型(浏览器壳是 React 组件,TUI 壳是 ink 组件)
|
|
92
|
+
* @typeParam M - 槽位契约表(declare module 合并到插件 import 的那个模块)
|
|
93
|
+
* @typeParam FM - Factory 契约表
|
|
94
|
+
*/
|
|
95
|
+
export interface UiPluginApi<C = unknown, M = SlotMapLike, FM = FactoryMapLike> {
|
|
96
|
+
/** 这个插件的 id(清单里那一条),诊断与去重都用它。 */
|
|
97
|
+
id: string;
|
|
98
|
+
/** 槽位注册表:声明过的槽才能注册,没声明的当场报错;想等一个槽出现用 `injectSlot`。 */
|
|
99
|
+
slots: UiSlotApi<C, M, FM>;
|
|
100
|
+
/** 宿主身份。 */
|
|
101
|
+
host: UiHostInfo;
|
|
102
|
+
/** 运行时通道:看状态、调方法。 */
|
|
103
|
+
runtime: UiRuntimeApi;
|
|
104
|
+
/**
|
|
105
|
+
* 提供一个服务(A1)。同一个名字第二次 provide 抛装配错误(带两个插件 id 的人话);
|
|
106
|
+
* 返回值随插件卸载释放(进装载账本)——provider 停用后 consumer 下一次读会变 undefined。
|
|
107
|
+
*/
|
|
108
|
+
provide<T>(name: string, value: T): void;
|
|
109
|
+
/**
|
|
110
|
+
* 读一个服务;缺席给 undefined(软依赖)。
|
|
111
|
+
*
|
|
112
|
+
* 想「提供者缺席就不装」用 `plugin.json` 的 `inject` 声明**硬依赖**——装载器会等它
|
|
113
|
+
* 就绪、缺席时报告一行原因(见 `manifest.ts` 的 inject 双关说明)。
|
|
114
|
+
*/
|
|
115
|
+
consume<T>(name: string): T | undefined;
|
|
116
|
+
}
|
|
117
|
+
/** 插件 bundle 必须导出的形状。 */
|
|
118
|
+
export interface UiPluginModule<C = unknown, M = SlotMapLike, FM = FactoryMapLike> {
|
|
119
|
+
/** 显示名(可缺省,缺省就用清单里的 id)。 */
|
|
120
|
+
name?: string;
|
|
121
|
+
/**
|
|
122
|
+
* 界面半边:注册自己的槽位。只能在这里登记,不要起副作用之外的定时器。
|
|
123
|
+
* @param ui - 插件 API
|
|
124
|
+
* @returns 可选的退订函数:壳体卸载这个插件时调用(HMR、重试都靠它)
|
|
125
|
+
*/
|
|
126
|
+
apply(ui: UiPluginApi<C, M, FM>): void | (() => void);
|
|
127
|
+
}
|
|
128
|
+
/**
|
|
129
|
+
* 标识函数:给插件作者写 `export default defineUiPlugin({ apply })` 用的,
|
|
130
|
+
* 作用只是让类型检查提前发现「apply 写错了」这类笔误。
|
|
131
|
+
*/
|
|
132
|
+
export declare function defineUiPlugin<C, M, FM>(module: UiPluginModule<C, M, FM>): UiPluginModule<C, M, FM>;
|
|
133
|
+
/** 一个插件的加载结果(界面壳把失败的列出来,不要静默)。 */
|
|
134
|
+
export interface UiPluginLoadReport {
|
|
135
|
+
id: string;
|
|
136
|
+
/** 插件自己报的显示名(没报就没有这一项)。 */
|
|
137
|
+
name?: string;
|
|
138
|
+
ok: boolean;
|
|
139
|
+
/** 失败原因(加载脚本失败、没导出 apply、apply 抛错、等服务就绪都算)。 */
|
|
140
|
+
error?: string;
|
|
141
|
+
/** 第几次尝试才装上(1 = 一次就成;依赖别的插件的会 > 1)。 */
|
|
142
|
+
attempts?: number;
|
|
143
|
+
/** 这个插件 provide 过的服务名(装成功后填,诊断区可读)。 */
|
|
144
|
+
provides?: string[];
|
|
145
|
+
}
|
|
146
|
+
/** 一次装载的总结果。 */
|
|
147
|
+
export interface UiPluginLoadResult {
|
|
148
|
+
/** 每个插件一条,成功的也记(诊断区看得见谁装上了)。 */
|
|
149
|
+
reports: UiPluginLoadReport[];
|
|
150
|
+
/** 装载结束时的服务名快照(诊断区显示用)。 */
|
|
151
|
+
services: readonly string[];
|
|
152
|
+
/** 服务表本体:渲染侧的服务订阅(`useService`)要经 context 拿它。 */
|
|
153
|
+
serviceRegistry: ServiceRegistry;
|
|
154
|
+
/**
|
|
155
|
+
* 撤掉这一轮装上的全部插件。
|
|
156
|
+
*
|
|
157
|
+
* 为什么要有:`apply` 交回来的退订函数原先被直接丢掉,于是「装完就固定」——
|
|
158
|
+
* 想再挂一个新插件只能整页刷新。有了它,热更新、失败重试、测试收尾都有落点。
|
|
159
|
+
*/
|
|
160
|
+
disposeAll(): void;
|
|
161
|
+
}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 装载器的「记账外壳」:把插件在 `apply` 期间做的槽位登记全部记账,卸载或重试时按账本
|
|
3
|
+
* 逆序回滚。浏览器壳(`ui-shell/src/ui-renderer/boot.ts`)与终端壳(`src/ui/tui-plugins.ts`)共用
|
|
4
|
+
* 这一份——装载语义两壳一致是契约的一部分。
|
|
5
|
+
*
|
|
6
|
+
* 为什么单独一个文件:类型收窄(D1)后,外壳的方法必须与注册表的公开重载**逐字同形**
|
|
7
|
+
* (插件作者的调用点才是类型检查发生的地方),这份镜像放一处才不会两边漂移。
|
|
8
|
+
*
|
|
9
|
+
* @module dsc/ui/scoped-slots
|
|
10
|
+
*/
|
|
11
|
+
import type { FactoryMapLike, SlotMapLike } from './slots.js';
|
|
12
|
+
import type { SlotRegistry } from './slots.js';
|
|
13
|
+
import type { UiSlotApi } from './plugin.js';
|
|
14
|
+
/**
|
|
15
|
+
* 给一个插件的槽位外壳。
|
|
16
|
+
* @param slots - 壳的注册表
|
|
17
|
+
* @param record - 记账函数:把一个退订动作挂到该插件的账本上(原样返回它)
|
|
18
|
+
* @returns 插件看到的那一面(与 {@link UiSlotApi} 同形)
|
|
19
|
+
*/
|
|
20
|
+
export declare function createScopedSlotApi<C, M = SlotMapLike, FM = FactoryMapLike>(slots: SlotRegistry<C, M, FM>, record: (release: () => void) => () => void): UiSlotApi<C, M, FM>;
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 服务表的 React 订阅面(A1):壳把装载出来的服务表经 context 交给条目组件,
|
|
3
|
+
* 插件用 `useService(name)` 读一个服务,并跟着它出现/消失重渲染。
|
|
4
|
+
*
|
|
5
|
+
* 为什么要有它:`ui.consume` 只在 `apply` 那一刻读得到,而「提供者后装上/中途停用」
|
|
6
|
+
* 是常态(team 与 status 的关系就是例子)——界面要能自动换数据源,而不是刷新页面。
|
|
7
|
+
*
|
|
8
|
+
* 为什么走 context 而不是模块级单例:探针会在同一进程里装载多轮(每轮一张新表),
|
|
9
|
+
* 单例会让上一轮的服务泄漏进下一轮;context 由壳在装载处提供给自己的 React 树。
|
|
10
|
+
*
|
|
11
|
+
* @module dsc/ui/services-react
|
|
12
|
+
*/
|
|
13
|
+
import { type ReactNode } from 'react';
|
|
14
|
+
import type { ServiceRegistry } from './services.js';
|
|
15
|
+
/** 把一棵 React 树接到某张服务表上(壳在装载结束后包在界面外层)。 */
|
|
16
|
+
export declare function ServicesProvider({ services, children }: {
|
|
17
|
+
services: ServiceRegistry;
|
|
18
|
+
children: ReactNode;
|
|
19
|
+
}): ReactNode;
|
|
20
|
+
/**
|
|
21
|
+
* 读一个服务;缺席给 undefined。
|
|
22
|
+
*
|
|
23
|
+
* 订阅按值判等(`consume` 返回的就是表里存的那份引用),所以「同一份 handle 被重新
|
|
24
|
+
* provide」不会抖,真换了才重渲染。
|
|
25
|
+
* @param name - 服务名
|
|
26
|
+
*/
|
|
27
|
+
export declare function useService<T>(name: string): T | undefined;
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 客户端服务表(A1):插件之间「谁提供、谁消费」的值表。
|
|
3
|
+
*
|
|
4
|
+
* 与参考实现的语义差,如实写清:dsh 的客户端服务是 cordis 的 `Service`(挂 fiber 生命周期、
|
|
5
|
+
* `ctx.inject` 动态等待);dsc 这份是**装载期的值表**——没有 fiber,等待语义在装载循环里
|
|
6
|
+
* 实现(`inject` 名单解析 + 失败重试一轮,两个装载器共用 {@link unmetInjections})。
|
|
7
|
+
* 表本身只负责三件事:提供、读取、订阅(服务出现/消失时让界面换数据源)。
|
|
8
|
+
*
|
|
9
|
+
* 一个名字只能有一个提供者:第二次 `provide` 抛 {@link ServiceConflictError}(人话里带
|
|
10
|
+
* 两个插件 id)——「跨插件重名冲突必须报出来」落在这一处,席位(D3)本身没有字符串键。
|
|
11
|
+
*
|
|
12
|
+
* @module dsc/ui/services
|
|
13
|
+
*/
|
|
14
|
+
/** 同一个服务名有两个提供者时抛这个(谁提供必须唯一,不能靠加载顺序偷偷决定)。 */
|
|
15
|
+
export declare class ServiceConflictError extends Error {
|
|
16
|
+
constructor(name: string, first: string, second: string);
|
|
17
|
+
}
|
|
18
|
+
/** `provide` 的名字不合法(空串或非字符串)时抛这个:空名字读不出来,等于静默丢东西。 */
|
|
19
|
+
export declare class UndeclaredServiceError extends Error {
|
|
20
|
+
constructor(name: unknown);
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* 服务表。装载器每次装载建一张(不是模块级单例——探针与多轮装载各自隔离)。
|
|
24
|
+
*/
|
|
25
|
+
export declare class ServiceRegistry {
|
|
26
|
+
private readonly records;
|
|
27
|
+
private readonly listeners;
|
|
28
|
+
/**
|
|
29
|
+
* 提供一个服务。
|
|
30
|
+
* @param name - 服务名(非空字符串)
|
|
31
|
+
* @param value - 服务值(任意)
|
|
32
|
+
* @param provider - 提供者的插件 id
|
|
33
|
+
* @returns 退订函数:撤掉这次提供(进插件账本,卸载/重试回滚时调用)
|
|
34
|
+
* @throws {UndeclaredServiceError} 名字为空/非字符串
|
|
35
|
+
* @throws {ServiceConflictError} 同名已有提供者
|
|
36
|
+
*/
|
|
37
|
+
provide<T>(name: string, value: T, provider: string): () => void;
|
|
38
|
+
/** 读一个服务;缺席给 undefined。 */
|
|
39
|
+
consume<T>(name: string): T | undefined;
|
|
40
|
+
/** 这个服务现在有没有提供者。 */
|
|
41
|
+
has(name: string): boolean;
|
|
42
|
+
/** 当前的服务名(诊断行与装载结果快照用)。 */
|
|
43
|
+
names(): string[];
|
|
44
|
+
/** 某个服务的提供者插件 id;没有给 undefined。 */
|
|
45
|
+
providerOf(name: string): string | undefined;
|
|
46
|
+
/** 订阅提供/撤销(`useService` 与诊断用)。 */
|
|
47
|
+
subscribe(listener: () => void): () => void;
|
|
48
|
+
private notify;
|
|
49
|
+
}
|
|
50
|
+
/**
|
|
51
|
+
* 解析一条 `inject` 名单,返回未满足的原因(空数组 = 可以装)。
|
|
52
|
+
*
|
|
53
|
+
* `inject` 是**双关**:先按「清单里另一个插件的 id」解(既有拓扑排序用的就是它),
|
|
54
|
+
* 再按「服务名」解(提供者还没装上/被停用)。两档失败文案分开——没有提供者 vs
|
|
55
|
+
* 提供者没装上;插件 id 在清单里时以它为准(见 `manifest.ts` 的注释)。
|
|
56
|
+
* @param names - 插件声明的 inject 名单
|
|
57
|
+
* @param reportOf - 查另一个插件的装载报告(按插件 id)
|
|
58
|
+
* @param services - 当前的服务表
|
|
59
|
+
*/
|
|
60
|
+
export declare function unmetInjections(names: readonly string[] | undefined, reportOf: (id: string) => {
|
|
61
|
+
ok: boolean;
|
|
62
|
+
error?: string;
|
|
63
|
+
} | undefined, services: ServiceRegistry): string[];
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
import type { SlotEntry, SlotFault } from './slots.js';
|
|
2
|
+
import type { SlotRegistry } from './slots.js';
|
|
3
|
+
import type { ActionsDecl, BakedActions, SeatInstance, SeatInstanceOf, SnapshotSelectorHook, StoreHandle } from './store.js';
|
|
4
|
+
/** 订阅一个槽里的登记(快照的引用稳定由注册表按槽版本保证)。 */
|
|
5
|
+
export declare function useSlot<C, M, FM>(slots: SlotRegistry<C, M, FM>, slot: string): readonly SlotEntry<C>[];
|
|
6
|
+
/** 订阅壳记下的故障(诊断区用:哪个插件的哪一块崩了、崩在哪一步)。 */
|
|
7
|
+
export declare function useSlotFaults<C, M, FM>(slots: SlotRegistry<C, M, FM>): readonly SlotFault[];
|
|
8
|
+
/**
|
|
9
|
+
* 读一个席位实例(selector + 可选相等判断,与 `useHostSelector` 同一手法)。
|
|
10
|
+
*
|
|
11
|
+
* 实例缺席(undefined——提供者还没装上、或已卸载)时返回 undefined,调用方据此决定
|
|
12
|
+
* 要不要走本地回落(D3 的 status 面板就是这样用)。订阅随实例出现/消失切换:同一个
|
|
13
|
+
* 组件在两个实例之间换源不需要重挂。
|
|
14
|
+
*/
|
|
15
|
+
export declare function useSeat<T extends object, A extends ActionsDecl<T>, S>(instance: SeatInstance<T, A> | undefined, selector: (state: T) => S, isEqual?: (a: S, b: S) => boolean): S | undefined;
|
|
16
|
+
/**
|
|
17
|
+
* 登记过席位的条目用:把实例的组件面(`useStore` + `actions`)拼好交给条目组件
|
|
18
|
+
* (渲染出口在渲染时展开在 owner / 渲染能力之后)。
|
|
19
|
+
*
|
|
20
|
+
* 只在真有席位的条目里调用;`handle === null` 的条目拿空份额。有登记就意味着注册表
|
|
21
|
+
* 持有这个席位——实例一定在账上(`seat()` 首次渲染读时懒建)。
|
|
22
|
+
*/
|
|
23
|
+
export declare function useSeatProps<T extends object, A extends ActionsDecl<T>>(slots: {
|
|
24
|
+
seat<H extends StoreHandle<any, any>>(handle: H): SeatInstanceOf<H> | undefined;
|
|
25
|
+
}, handle: StoreHandle<T, A> | null): {
|
|
26
|
+
useStore: SnapshotSelectorHook<T>;
|
|
27
|
+
actions: BakedActions<T, A>;
|
|
28
|
+
} | Record<string, never>;
|