@binblink/wasmnest-plugin-sdk-desktop 0.0.0-stage → 0.0.2
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/README.md +307 -2
- package/README_en.md +284 -0
- package/bin/cli.js +602 -0
- package/bin/manifest-gen.js +458 -0
- package/bin/manifest-validate.js +494 -0
- package/bin/permission-vocabulary.json +5 -0
- package/bin/plugin-watch.js +331 -0
- package/bin/wasm-hash.js +124 -0
- package/dev-shell/README.md +122 -0
- package/dev-shell/index.html +12 -0
- package/dev-shell/package.json +28 -0
- package/dev-shell/pnpm-workspace.yaml +9 -0
- package/dev-shell/postcss.config.js +6 -0
- package/dev-shell/src/App.vue +90 -0
- package/dev-shell/src/components/LogPanel.vue +90 -0
- package/dev-shell/src/loader.ts +104 -0
- package/dev-shell/src/locale.ts +29 -0
- package/dev-shell/src/locales.ts +50 -0
- package/dev-shell/src/main.ts +46 -0
- package/dev-shell/src/mock/app-env.ts +102 -0
- package/dev-shell/src/mock/commands.ts +54 -0
- package/dev-shell/src/mock/domain-context.ts +46 -0
- package/dev-shell/src/mock/events.ts +16 -0
- package/dev-shell/src/mock/file-transfer.ts +512 -0
- package/dev-shell/src/mock/tauri-ipc.ts +109 -0
- package/dev-shell/src/registry.ts +90 -0
- package/dev-shell/src/shell/components/AppMountSlot.vue +241 -0
- package/dev-shell/src/shell/components/ShellIcon.vue +141 -0
- package/dev-shell/src/shell/components/ShellStatusBar.vue +87 -0
- package/dev-shell/src/shell/components/ShellToolbar.vue +287 -0
- package/dev-shell/src/shell/mount/appSession.ts +45 -0
- package/dev-shell/src/shell/mount/devAppMount.ts +80 -0
- package/dev-shell/src/shell/types.ts +121 -0
- package/dev-shell/src/styles/dev.css +27 -0
- package/dev-shell/src/styles/shell.css +752 -0
- package/dev-shell/src/styles/style.css +1178 -0
- package/dev-shell/src/theme.ts +140 -0
- package/dev-shell/src/vite-env.d.ts +24 -0
- package/dev-shell/tailwind.config.js +98 -0
- package/dev-shell/vite.config.ts +174 -0
- package/dist/index.d.ts +150 -0
- package/dist/index.js +238 -0
- package/dist/types.d.ts +632 -0
- package/dist/types.js +0 -0
- package/dist/vite-plugin.d.ts +25 -0
- package/dist/vite-plugin.js +80 -0
- package/go/.gitignore +5 -0
- package/go/README.md +80 -0
- package/go/gen/wasmnest/api-call/host-api-call/empty.s +3 -0
- package/go/gen/wasmnest/api-call/host-api-call/host-api-call.wasm.go +13 -0
- package/go/gen/wasmnest/api-call/host-api-call/host-api-call.wit.go +34 -0
- package/go/gen/wasmnest/app/host-app/empty.s +3 -0
- package/go/gen/wasmnest/app/host-app/host-app.wasm.go +29 -0
- package/go/gen/wasmnest/app/host-app/host-app.wit.go +108 -0
- package/go/gen/wasmnest/auth-center/host-auth-center/abi.go +14 -0
- package/go/gen/wasmnest/auth-center/host-auth-center/empty.s +3 -0
- package/go/gen/wasmnest/auth-center/host-auth-center/host-auth-center.wasm.go +49 -0
- package/go/gen/wasmnest/auth-center/host-auth-center/host-auth-center.wit.go +225 -0
- package/go/gen/wasmnest/clipboard/host-clipboard/abi.go +14 -0
- package/go/gen/wasmnest/clipboard/host-clipboard/empty.s +3 -0
- package/go/gen/wasmnest/clipboard/host-clipboard/host-clipboard.wasm.go +17 -0
- package/go/gen/wasmnest/clipboard/host-clipboard/host-clipboard.wit.go +68 -0
- package/go/gen/wasmnest/connection-registry/host-connection-registry/empty.s +3 -0
- package/go/gen/wasmnest/connection-registry/host-connection-registry/host-connection-registry.wasm.go +13 -0
- package/go/gen/wasmnest/connection-registry/host-connection-registry/host-connection-registry.wit.go +50 -0
- package/go/gen/wasmnest/crypto/host-crypto/abi.go +18 -0
- package/go/gen/wasmnest/crypto/host-crypto/empty.s +3 -0
- package/go/gen/wasmnest/crypto/host-crypto/host-crypto.wasm.go +37 -0
- package/go/gen/wasmnest/crypto/host-crypto/host-crypto.wit.go +139 -0
- package/go/gen/wasmnest/fs-desktop/host-fs-desktop/abi.go +14 -0
- package/go/gen/wasmnest/fs-desktop/host-fs-desktop/empty.s +3 -0
- package/go/gen/wasmnest/fs-desktop/host-fs-desktop/host-fs-desktop.wasm.go +21 -0
- package/go/gen/wasmnest/fs-desktop/host-fs-desktop/host-fs-desktop.wit.go +62 -0
- package/go/gen/wasmnest/http/host-http/abi.go +14 -0
- package/go/gen/wasmnest/http/host-http/empty.s +3 -0
- package/go/gen/wasmnest/http/host-http/host-http.wasm.go +13 -0
- package/go/gen/wasmnest/http/host-http/host-http.wit.go +40 -0
- package/go/gen/wasmnest/http-endpoint/host-http-endpoint/empty.s +3 -0
- package/go/gen/wasmnest/http-endpoint/host-http-endpoint/host-http-endpoint.wasm.go +17 -0
- package/go/gen/wasmnest/http-endpoint/host-http-endpoint/host-http-endpoint.wit.go +69 -0
- package/go/gen/wasmnest/mdns/host-mdns/empty.s +3 -0
- package/go/gen/wasmnest/mdns/host-mdns/host-mdns.wasm.go +29 -0
- package/go/gen/wasmnest/mdns/host-mdns/host-mdns.wit.go +101 -0
- package/go/gen/wasmnest/notify/host-notify/empty.s +3 -0
- package/go/gen/wasmnest/notify/host-notify/host-notify.wasm.go +13 -0
- package/go/gen/wasmnest/notify/host-notify/host-notify.wit.go +64 -0
- package/go/gen/wasmnest/peer/host-peer/abi.go +14 -0
- package/go/gen/wasmnest/peer/host-peer/empty.s +3 -0
- package/go/gen/wasmnest/peer/host-peer/host-peer.wasm.go +85 -0
- package/go/gen/wasmnest/peer/host-peer/host-peer.wit.go +357 -0
- package/go/gen/wasmnest/platform-desktop/host-platform-desktop/empty.s +3 -0
- package/go/gen/wasmnest/platform-desktop/host-platform-desktop/host-platform-desktop.wasm.go +21 -0
- package/go/gen/wasmnest/platform-desktop/host-platform-desktop/host-platform-desktop.wit.go +70 -0
- package/go/gen/wasmnest/plugin/abi-form/abi-form.exports.go +11 -0
- package/go/gen/wasmnest/plugin/abi-form/abi-form.wasm.go +13 -0
- package/go/gen/wasmnest/plugin/abi-form/abi-form.wit.go +7 -0
- package/go/gen/wasmnest/plugin/abi-form/empty.s +3 -0
- package/go/gen/wasmnest/plugin/command/command.exports.go +11 -0
- package/go/gen/wasmnest/plugin/command/command.wasm.go +19 -0
- package/go/gen/wasmnest/plugin/command/command.wit.go +6 -0
- package/go/gen/wasmnest/plugin/command/empty.s +3 -0
- package/go/gen/wasmnest/plugin/events/empty.s +3 -0
- package/go/gen/wasmnest/plugin/events/events.exports.go +52 -0
- package/go/gen/wasmnest/plugin/events/events.wasm.go +74 -0
- package/go/gen/wasmnest/plugin/events/events.wit.go +195 -0
- package/go/gen/wasmnest/plugin/host-bus/empty.s +3 -0
- package/go/gen/wasmnest/plugin/host-bus/host-bus.wasm.go +29 -0
- package/go/gen/wasmnest/plugin/host-bus/host-bus.wit.go +94 -0
- package/go/gen/wasmnest/plugin/host-config/abi.go +14 -0
- package/go/gen/wasmnest/plugin/host-config/empty.s +3 -0
- package/go/gen/wasmnest/plugin/host-config/host-config.wasm.go +13 -0
- package/go/gen/wasmnest/plugin/host-config/host-config.wit.go +21 -0
- package/go/gen/wasmnest/plugin/host-events/empty.s +3 -0
- package/go/gen/wasmnest/plugin/host-events/host-events.wasm.go +9 -0
- package/go/gen/wasmnest/plugin/host-events/host-events.wit.go +27 -0
- package/go/gen/wasmnest/plugin/host-fs/abi.go +14 -0
- package/go/gen/wasmnest/plugin/host-fs/empty.s +3 -0
- package/go/gen/wasmnest/plugin/host-fs/host-fs.wasm.go +33 -0
- package/go/gen/wasmnest/plugin/host-fs/host-fs.wit.go +86 -0
- package/go/gen/wasmnest/plugin/host-log/empty.s +3 -0
- package/go/gen/wasmnest/plugin/host-log/host-log.wasm.go +25 -0
- package/go/gen/wasmnest/plugin/host-log/host-log.wit.go +65 -0
- package/go/gen/wasmnest/plugin/host-metrics/empty.s +3 -0
- package/go/gen/wasmnest/plugin/host-metrics/host-metrics.wasm.go +13 -0
- package/go/gen/wasmnest/plugin/host-metrics/host-metrics.wit.go +34 -0
- package/go/gen/wasmnest/plugin/host-platform/empty.s +3 -0
- package/go/gen/wasmnest/plugin/host-platform/host-platform.wasm.go +21 -0
- package/go/gen/wasmnest/plugin/host-platform/host-platform.wit.go +85 -0
- package/go/gen/wasmnest/plugin/host-plugin-database/abi.go +14 -0
- package/go/gen/wasmnest/plugin/host-plugin-database/empty.s +3 -0
- package/go/gen/wasmnest/plugin/host-plugin-database/host-plugin-database.wasm.go +29 -0
- package/go/gen/wasmnest/plugin/host-plugin-database/host-plugin-database.wit.go +70 -0
- package/go/gen/wasmnest/plugin/host-storage/abi.go +14 -0
- package/go/gen/wasmnest/plugin/host-storage/empty.s +3 -0
- package/go/gen/wasmnest/plugin/host-storage/host-storage.wasm.go +21 -0
- package/go/gen/wasmnest/plugin/host-storage/host-storage.wit.go +44 -0
- package/go/gen/wasmnest/plugin/host-worker/empty.s +3 -0
- package/go/gen/wasmnest/plugin/host-worker/host-worker.wasm.go +17 -0
- package/go/gen/wasmnest/plugin/host-worker/host-worker.wit.go +50 -0
- package/go/gen/wasmnest/plugin/lifecycle/empty.s +3 -0
- package/go/gen/wasmnest/plugin/lifecycle/lifecycle.exports.go +32 -0
- package/go/gen/wasmnest/plugin/lifecycle/lifecycle.wasm.go +41 -0
- package/go/gen/wasmnest/plugin/lifecycle/lifecycle.wit.go +9 -0
- package/go/gen/wasmnest/plugin/manifest/empty.s +3 -0
- package/go/gen/wasmnest/plugin/manifest/manifest.exports.go +11 -0
- package/go/gen/wasmnest/plugin/manifest/manifest.wasm.go +13 -0
- package/go/gen/wasmnest/plugin/manifest/manifest.wit.go +6 -0
- package/go/gen/wasmnest/plugin/plugin/plugin.wit.go +4 -0
- package/go/gen/wasmnest/process/host-process/empty.s +3 -0
- package/go/gen/wasmnest/process/host-process/host-process.wasm.go +21 -0
- package/go/gen/wasmnest/process/host-process/host-process.wit.go +56 -0
- package/go/gen/wasmnest/pty/host-pty/abi.go +14 -0
- package/go/gen/wasmnest/pty/host-pty/empty.s +3 -0
- package/go/gen/wasmnest/pty/host-pty/host-pty.wasm.go +33 -0
- package/go/gen/wasmnest/pty/host-pty/host-pty.wit.go +164 -0
- package/go/gen/wasmnest/task/host-task/abi.go +14 -0
- package/go/gen/wasmnest/task/host-task/empty.s +3 -0
- package/go/gen/wasmnest/task/host-task/host-task.wasm.go +29 -0
- package/go/gen/wasmnest/task/host-task/host-task.wit.go +110 -0
- package/go/gen/wasmnest/timer/host-timer/empty.s +3 -0
- package/go/gen/wasmnest/timer/host-timer/host-timer.wasm.go +13 -0
- package/go/gen/wasmnest/timer/host-timer/host-timer.wit.go +25 -0
- package/go/gen/wasmnest/ws/host-websocket/empty.s +3 -0
- package/go/gen/wasmnest/ws/host-websocket/host-websocket.wasm.go +29 -0
- package/go/gen/wasmnest/ws/host-websocket/host-websocket.wit.go +109 -0
- package/go/gen/wasmnest/ws-server/host-websocket-server/empty.s +3 -0
- package/go/gen/wasmnest/ws-server/host-websocket-server/host-websocket-server.wasm.go +49 -0
- package/go/gen/wasmnest/ws-server/host-websocket-server/host-websocket-server.wit.go +220 -0
- package/go/go.mod +14 -0
- package/go/go.sum +2 -0
- package/go/sdk/dispatch.go +49 -0
- package/go/sdk/dispatch_test.go +81 -0
- package/go/sdk/entry_native.go +13 -0
- package/go/sdk/entry_wasip2.go +188 -0
- package/go/sdk/host_http_wasip2.go +42 -0
- package/go/sdk/host_wasip2.go +251 -0
- package/go/sdk/plugin.go +103 -0
- package/go/testplugin/index.js +1 -0
- package/go/testplugin/main.go +67 -0
- package/go/testplugin/plugin.json +24 -0
- package/go/tools/assemble-wit.mjs +152 -0
- package/go/tools/gen-bindings.mjs +51 -0
- package/go/wit/core.wit +273 -0
- package/go/wit/deps/api-call/cap-api-call.wit +20 -0
- package/go/wit/deps/app/cap-app.wit +54 -0
- package/go/wit/deps/auth-center/cap-auth-center.wit +124 -0
- package/go/wit/deps/clipboard/clipboard.wit +48 -0
- package/go/wit/deps/clocks/monotonic-clock.wit +45 -0
- package/go/wit/deps/clocks/wall-clock.wit +42 -0
- package/go/wit/deps/clocks/world.wit +6 -0
- package/go/wit/deps/connection-registry/cap-connection-registry.wit +40 -0
- package/go/wit/deps/crypto/cap-crypto.wit +68 -0
- package/go/wit/deps/filesystem/preopens.wit +8 -0
- package/go/wit/deps/filesystem/types.wit +634 -0
- package/go/wit/deps/filesystem/world.wit +6 -0
- package/go/wit/deps/fs-desktop/cap-fs-desktop.wit +29 -0
- package/go/wit/deps/http/http.wit +28 -0
- package/go/wit/deps/http-endpoint/cap-http.wit +44 -0
- package/go/wit/deps/io/error.wit +34 -0
- package/go/wit/deps/io/poll.wit +41 -0
- package/go/wit/deps/io/streams.wit +262 -0
- package/go/wit/deps/io/world.wit +6 -0
- package/go/wit/deps/mdns/mdns.wit +45 -0
- package/go/wit/deps/notify/notify.wit +51 -0
- package/go/wit/deps/peer/peer.wit +126 -0
- package/go/wit/deps/platform-desktop/cap-platform-desktop.wit +38 -0
- package/go/wit/deps/process/cap-process.wit +25 -0
- package/go/wit/deps/pty/pty.wit +80 -0
- package/go/wit/deps/random/insecure-seed.wit +25 -0
- package/go/wit/deps/random/insecure.wit +22 -0
- package/go/wit/deps/random/random.wit +26 -0
- package/go/wit/deps/random/world.wit +7 -0
- package/go/wit/deps/sockets/instance-network.wit +9 -0
- package/go/wit/deps/sockets/ip-name-lookup.wit +51 -0
- package/go/wit/deps/sockets/network.wit +145 -0
- package/go/wit/deps/sockets/tcp-create-socket.wit +27 -0
- package/go/wit/deps/sockets/tcp.wit +353 -0
- package/go/wit/deps/sockets/udp-create-socket.wit +27 -0
- package/go/wit/deps/sockets/udp.wit +266 -0
- package/go/wit/deps/sockets/world.wit +11 -0
- package/go/wit/deps/task/cap-task.wit +56 -0
- package/go/wit/deps/timer/cap-timer.wit +14 -0
- package/go/wit/deps/wasi-cli/command.wit +7 -0
- package/go/wit/deps/wasi-cli/environment.wit +18 -0
- package/go/wit/deps/wasi-cli/exit.wit +4 -0
- package/go/wit/deps/wasi-cli/imports.wit +20 -0
- package/go/wit/deps/wasi-cli/run.wit +4 -0
- package/go/wit/deps/wasi-cli/stdio.wit +17 -0
- package/go/wit/deps/wasi-cli/terminal.wit +49 -0
- package/go/wit/deps/ws/ws.wit +50 -0
- package/go/wit/deps/ws-server/cap-ws.wit +99 -0
- package/go/wit/go-plugin.wit +28 -0
- package/go/wit/plugin-face.wit +355 -0
- package/go/wit/wasmnest.wit +25 -0
- package/package.json +100 -3
- package/src/config.ts +49 -0
- package/src/global-dialog.ts +169 -0
- package/src/index.ts +88 -0
- package/src/runtime.ts +54 -0
- package/src/types.ts +681 -0
- package/src/ui/AppUpdateSection.d.ts +44 -0
- package/src/ui/AppUpdateSection.vue +253 -0
- package/src/ui/MarkdownEditor.vue +520 -0
- package/src/ui/NumberField.d.ts +49 -0
- package/src/ui/NumberField.vue +390 -0
- package/src/ui/PluginGlobalDialog.vue +401 -0
- package/src/ui/Select.d.ts +36 -0
- package/src/ui/Select.vue +220 -0
- package/src/ui/TerminalInputRail.vue +184 -0
- package/src/ui/apply-select-position.ts +65 -0
- package/src/ui/markdown-editor-syntax.ts +234 -0
- package/src/ui/markdown-editor.d.ts +36 -0
- package/src/ui/plugin-global-dialog.d.ts +12 -0
- package/src/ui/select-position.ts +79 -0
- package/src/ui/terminal-input-rail.d.ts +30 -0
- package/src/ui/zoom-compensation.d.ts +9 -0
- package/src/ui/zoom-compensation.ts +52 -0
- package/src/update.ts +123 -0
- package/src/vite-plugin.ts +124 -0
- package/template/README.md +39 -0
- package/template/package.json +23 -0
- package/template/plugin.json +14 -0
- package/template/rust/Cargo.toml +21 -0
- package/template/rust/src/lib.rs +39 -0
- package/template/src/env.d.ts +24 -0
- package/template/src/index.ts +37 -0
- package/template/tsconfig.json +17 -0
- package/template/vite.config.ts +21 -0
- package/tools/componentize/Cargo.lock +299 -0
- package/tools/componentize/Cargo.toml +18 -0
- package/tools/componentize/src/main.rs +197 -0
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
package wasmnest:plugin@0.1.0;
|
|
2
|
+
|
|
3
|
+
/// Go 后端组件专用 world(issue #21「应用后端 Go 语言支持」Phase 1,SDK Go 壳)
|
|
4
|
+
///
|
|
5
|
+
/// 包版本行由 `go/tools/assemble-wit.mjs` 组装时按拼装产物(wasmnest.wit)回写
|
|
6
|
+
/// 对齐——本文件不持版本字面量(ADR 0051:版本真源在能力仓 wasmnest-contract,
|
|
7
|
+
/// 契约升版本文件零改动)。注意 package 行上方不可加注释:WIT 把紧贴 item 的
|
|
8
|
+
/// 注释行视为其 doc comment,同包第二个带 doc 的 package 声明会被拒。
|
|
9
|
+
///
|
|
10
|
+
/// 与 `world plugin` 的唯一差异:`include wasi:cli/command@0.2.0`——TinyGo 的
|
|
11
|
+
/// wasip2 目标按 WASI command 形态产出组件(导入 clocks / random / io /
|
|
12
|
+
/// filesystem / sockets / cli 标准面并导出 `wasi:cli/run`),宿主 linker 的
|
|
13
|
+
/// WASI p2 面默认全开恰好覆盖,多出的 run 导出宿主不探测、无害(Phase 0 spike
|
|
14
|
+
/// 实证,2026-10-26,见应用仓 issue #21 spike 记录)。
|
|
15
|
+
///
|
|
16
|
+
/// 导出面与 `world plugin` 完全一致(五个必选导出,由 Go SDK 壳 `sdk.Entry`
|
|
17
|
+
/// 全量接线);可选探测导出(events-binary / events-ws / events-task /
|
|
18
|
+
/// auth-policy)首期不提供——宿主按名探测、缺失容忍,不影响加载(spec #21
|
|
19
|
+
/// Implementation Decisions;Rust 侧等价物是 `wasm_entry!` 宏)。
|
|
20
|
+
///
|
|
21
|
+
/// 本文件是 Go 绑定生成的真源之一:`go/tools/gen-bindings.mjs` 把本文件与
|
|
22
|
+
/// 拼装产物 `rust/wit/*.wit`(compose-wit.mjs 维护)以及 TinyGo 发行版自带的
|
|
23
|
+
/// wasi-cli WIT(`lib/wasi-cli/wit/`,按 wasm-tools `deps/` 单层约定平铺——
|
|
24
|
+
/// 嵌套 deps 不被发现)组装成 `go/wit/` 后经 wit-bindgen-go 生成 `go/gen/`。
|
|
25
|
+
world go-plugin {
|
|
26
|
+
include plugin;
|
|
27
|
+
include wasi:cli/command@0.2.0;
|
|
28
|
+
}
|
|
@@ -0,0 +1,355 @@
|
|
|
1
|
+
package wasmnest:plugin@0.1.0;
|
|
2
|
+
|
|
3
|
+
// ======================================================================
|
|
4
|
+
// 插件面(plugin face)——`wasmnest:plugin` 包的非 core 部分
|
|
5
|
+
//
|
|
6
|
+
// ADR 0061(2026-11-07 WIT 按包拆分)后,`wasmnest:plugin` 只保留两类东西:
|
|
7
|
+
// ① `core.wit`:内核机制 import(storage/events/bus/platform/fs/log/config/
|
|
8
|
+
// plugin-database/metrics/worker)+ 三个必选导出(command/lifecycle/manifest);
|
|
9
|
+
// ② 本文件:双端/端独有的**导出面**(events 等)与 binding-only world。
|
|
10
|
+
// 其余能力域接口各自独立成包,住端生成物 `deps/<pkg>/`。
|
|
11
|
+
//
|
|
12
|
+
// 本包是所有应用的公共轴:它的任何改动(core import 或导出面)仍要求全部应用
|
|
13
|
+
// 重建——这是拆包后的有意边界(spec §9.2)。
|
|
14
|
+
// ======================================================================
|
|
15
|
+
|
|
16
|
+
/// WasmNest 插件 Component Model 契约
|
|
17
|
+
///
|
|
18
|
+
/// 桌面端插件契约——**插件面分片**(共享核心在 `wasm-core/wit/core.wit`,
|
|
19
|
+
/// 能力域接口在各自独立包 `deps/`,本文件只承载导出面与 binding-only world;
|
|
20
|
+
/// 端 `wit/` 目录由 `scripts/compose-wit.mjs` 拼装生成,本文件是其真源)。
|
|
21
|
+
///
|
|
22
|
+
/// ADR 0061 拆包后:`host-fs-desktop` / `host-platform-desktop` / `host-api-call` /
|
|
23
|
+
/// `host-timer` / `host-process` / `host-app` / `host-connection-registry` /
|
|
24
|
+
/// `host-auth-center` / `host-task` / `host-crypto` 各自成包(源文件见同目录
|
|
25
|
+
/// `cap-*.wit`),本文件不再定义它们。
|
|
26
|
+
///
|
|
27
|
+
/// 迁移约定(与阶段 B 第 4 点一致):
|
|
28
|
+
/// - `serde_json` 载荷保留:结构化参数/结果一律用 `string` 承载 JSON
|
|
29
|
+
/// (WIT 的 `string` 到 wasm 侧是 UTF-8 字节,等价于现有 (ptr,len) 传递)
|
|
30
|
+
/// - 命令层(`CommandArgs` / `serde_json::Value`)不动,只有传输层换皮
|
|
31
|
+
/// - 错误一律 `result<T, string>`,错误内容为宿主侧可读的 UTF-8 消息
|
|
32
|
+
///
|
|
33
|
+
/// ## 命名空间约定
|
|
34
|
+
///
|
|
35
|
+
/// 宿主能力 import 接口前缀 `host-`,插件导出接口为普通名字:
|
|
36
|
+
/// - import:`host-storage` / `host-plugin-database` / ... (对应 host_functions/*)
|
|
37
|
+
/// - export:`command` / `lifecycle` / `events` / `manifest` / `abi`
|
|
38
|
+
/// (v27 删 `terminal-hooks` 与 `events` 的 `on-session-lifecycle` /
|
|
39
|
+
/// `on-input-submitted`:派发源随会话观察面退役,见下方 v27 版本说明)
|
|
40
|
+
///
|
|
41
|
+
/// ## ABI 版本协商(阶段 A)
|
|
42
|
+
///
|
|
43
|
+
/// `abi` 接口承载原 `__wasmnest_abi_version` 的职责(共享核心只留 `version()` 交集;
|
|
44
|
+
/// `form` 形态声明 v36 拆入 `abi-form`,见本文件 interface 定义)。
|
|
45
|
+
/// - `version()`:与 `abi::ABI_VERSION`(**当前 v36**)比对,语义不变
|
|
46
|
+
/// (逐版权威记账在 SDK `rust/src/abi.rs`,下方保全的版本演进注释与此对应)
|
|
47
|
+
/// - `abi-form.form()`:0 = core module(自研 ABI),1 = component。宿主据此区分
|
|
48
|
+
/// 产物形态,不 bump ABI 大版本
|
|
49
|
+
/// ABI 版本协商(原 __wasmnest_abi_version + 阶段 A 新增 form 形态字段)
|
|
50
|
+
///
|
|
51
|
+
/// 版本演进(与 SDK `abi.rs` 的 ABI_VERSION 序列逐条对应,不得漂移):
|
|
52
|
+
/// - v10:host-peer 原语化收缩第一阶段(dial-peer-endpoint / close /
|
|
53
|
+
/// set-shared-roots + host-mdns / host-platform),纯增量
|
|
54
|
+
/// - v11:host-peer 传输控制三原语(pause-transfer / resume-transfer /
|
|
55
|
+
/// resume-all-transfers),纯增量
|
|
56
|
+
/// - v12:消息总线二进制载荷(host-bus.publish-binary / subscribe-binary)
|
|
57
|
+
/// + 可选导出 events-binary(宿主动态探测,旧插件不受影响)
|
|
58
|
+
/// - v13:host-mdns v2(advertise / stop-advertise / is-advertising 原语 +
|
|
59
|
+
/// 事件定向投递 `mdns:found.<owner>` / `mdns:lost.<owner>`——当时形态,
|
|
60
|
+
/// 后改为 `<owner>::mdns:found|lost`),纯增量
|
|
61
|
+
/// - v14:host-websocket 基础能力服务(客户端域 connect/send/close/
|
|
62
|
+
/// is-connected + 服务端域 register-endpoint/收发/广播/踢出/注销/清单)
|
|
63
|
+
/// + 可选导出 events-ws(宿主动态探测),纯增量,v13 插件不受影响
|
|
64
|
+
/// - v15:host-auth 密钥托管原语(secret-store 四函数 + 主库 plugin_secrets
|
|
65
|
+
/// 持久化),纯增量,v14 插件不受影响
|
|
66
|
+
/// - v16:host-pty 插件私有伪终端原语(spawn/write/resize/kill/ring-fetch/
|
|
67
|
+
/// is-running 六函数 + `<owner>::pty:exit` 事件),纯增量新接口,
|
|
68
|
+
/// v15 及更早插件不受影响。**2026-09-24**:spawn config-json 追加可选字段
|
|
69
|
+
/// `hostBroadcastSessionId`(宿主只读订阅声明,字段级追加不 bump——同 v19 惯例;
|
|
70
|
+
/// **该字段已于 v28 退役**,见下方 v28 条目)
|
|
71
|
+
/// - v17:认证策略导出 auth-policy(verify-device-token,desktop 独有——认证中心
|
|
72
|
+
/// 能力,宿主 server 中间件验签后取策略),纯增量新接口,v16 及更早插件不受影响
|
|
73
|
+
/// - v18:host-auth 认证记录面(trusted-devices-list / trusted-device-revoke /
|
|
74
|
+
/// connection-history-list / auth-setting-set,desktop 独有——会话语义下沉的
|
|
75
|
+
/// 宿主侧追加批次),既有 interface 的函数级追加,v17 及更早插件不受影响
|
|
76
|
+
/// - v19:host-session 配置面(config-upsert / config-get / config-delete,
|
|
77
|
+
/// desktop 独有——会话语义下沉批次之二,权限 `session:config`),既有
|
|
78
|
+
/// interface 的函数级追加,v18 及更早插件不受影响。v19 同批再加两函数:
|
|
79
|
+
/// `annotate`(会话注解槽写入,权限 `session:write`——内核去业务化:
|
|
80
|
+
/// 旧任务字段的 expand 期并行写入面)+ `connections-list`(连接注册表原始
|
|
81
|
+
/// 记录清单,无排序无解读,权限 `session:read`——设备派生视图真源)
|
|
82
|
+
/// - v20:host-task 宿主并发任务域(execute-batch / submit / status / cancel /
|
|
83
|
+
/// list-jobs 五函数,desktop 独有——WASM 插件调度 OS 线程池真并行执行单元
|
|
84
|
+
/// 操作计划,权限 `task:run` + 每单元既有域权限门双门) + 可选导出
|
|
85
|
+
/// events-task#on-task-event(宿主动态探测,同 events-ws 模式,旧产物零回归),
|
|
86
|
+
/// 纯增量新接口,v19 及更早插件不受影响
|
|
87
|
+
/// - v21…v26:函数级追加与新增 interface(host-session 收敛、host-platform、
|
|
88
|
+
/// host-auth 记录面、host-pty、auth-policy、host-websocket、host-mdns v2、
|
|
89
|
+
/// host-crypto 等)——**逐条权威记账在 SDK `rust/src/abi.rs`**,本段不复制
|
|
90
|
+
/// (复制即漂移源)
|
|
91
|
+
/// - **v27:唯一一次破坏性契约变更**——会话原语域整 interface 退役:
|
|
92
|
+
/// ① import 删 `host-session`(12 函数)与 `host-terminal`(`send`);
|
|
93
|
+
/// ② export 删 `terminal-hooks` 整 interface 与 `events` 的
|
|
94
|
+
/// `on-session-lifecycle` / `on-input-submitted`;
|
|
95
|
+
/// ③ 权限位退役 `session:write` / `terminal:observe`。
|
|
96
|
+
/// 会话真源在 `com.wasmnest.bedcode` 登记域(P1-b 起),宿主侧只留
|
|
97
|
+
/// `host-pty`(引擎)与 `host-connection`(连接清单)。旧产物在**实例化**阶段
|
|
98
|
+
/// 即可诊断失败(点明缺失 interface + 重建指引,见宿主
|
|
99
|
+
/// `stale_artifact_rebuild_hint`),须按 v27 SDK 重建
|
|
100
|
+
/// - **v28(websocket 业务下沉专项,2026-09-25)**:
|
|
101
|
+
/// ① `host-websocket` 新增 `connection-context`(已脱敏连接/认证上下文查询,
|
|
102
|
+
/// 仅属主可调,权限 `ws:server`);
|
|
103
|
+
/// ② 破坏性删除:`host-events.broadcast-sync` 退役(宿主不再持同步产品
|
|
104
|
+
/// 载荷与 WS 广播策略,插件事件走 bus/emit)、`host-pty.spawn` 的
|
|
105
|
+
/// `hostBroadcastSessionId` 字段退役(PTY 引擎不再知道 session id,插件
|
|
106
|
+
/// 经 `ring-fetch` 自持)、宿主 `Message`/SyncPayload 等旧 WS 业务类型退出
|
|
107
|
+
/// 生产路径。旧产物(v27 SDK 构建)在**实例化**阶段即可诊断失败
|
|
108
|
+
/// (stale_artifact_rebuild_hint 点明 v28 重建)。
|
|
109
|
+
/// 随包插件产物同步重建(旧产物不兼容、不迁移、不提供 fallback)。
|
|
110
|
+
/// - **v29(HTTP 路由代码注册下沉专项,2026-09-25)**:host-http 新增服务端域
|
|
111
|
+
/// `register-endpoint` / `unregister-endpoint`(插件在 activate 期以代码注册自身
|
|
112
|
+
/// 路由:内部端点段 + 可选对外 URL 别名 + 方法 + `jwt`/`none` 认证档位;
|
|
113
|
+
/// 命名空间由插件名承载,激活期同名拒绝 fail-visible)。函数级追加,旧产物仍可
|
|
114
|
+
/// 实例化但不具备注册能力。权威记账在 SDK `rust/src/abi.rs`
|
|
115
|
+
/// - **v30(传输编排下沉,2026-09-25)**:host-peer 函数级追加
|
|
116
|
+
/// `active-transfers`(会话表投影查询,事件归约首屏兜底)+ `collect-outgoing`
|
|
117
|
+
/// (发送源枚举:目录递归 + 批内同名去重,仅元数据)。纯增量,v29 及更早
|
|
118
|
+
/// 插件不受影响。权威记账在 SDK `rust/src/abi.rs`
|
|
119
|
+
/// - **v31(传输编排下沉,2026-09-25,破坏性)**:host-peer 删
|
|
120
|
+
/// `resume-all-transfers`(“全部恢复”编排归插件逐批调 `resume-transfer`)、
|
|
121
|
+
/// `send-files` 语义收窄为“一次调用 = 一个会话立即发起”(载荷 `concurrency` 字段
|
|
122
|
+
/// 退役,运行期显性报错),旧快照 topic `peer:transfer` / `peer:receive` 退役。
|
|
123
|
+
/// 旧产物在**实例化**阶段即被点名拒绝(stale_artifact_rebuild_hint 点明 v31 重建)。
|
|
124
|
+
/// 权威记账在 SDK `rust/src/abi.rs`
|
|
125
|
+
/// - **v33(认证中心持有入场密钥,2026-09-29,ADR 0033,破坏性)**:`host-auth` 删
|
|
126
|
+
/// `device-token-issue` / `device-token-verify`——认证中心自持入场密钥并自签自验,
|
|
127
|
+
/// 宿主不再持有设备 JWT 密码学(`utils/auth/jwt.rs` 整个退役)。旧产物(v32 SDK
|
|
128
|
+
/// 构建)仍 import 这两函数 → **实例化期**被点名拒绝(stale_artifact_rebuild_hint
|
|
129
|
+
/// 点明 v33 重建)。token wire 格式逐字节不变,移动端零改动。**desktop 独有**,
|
|
130
|
+
/// 移动端 WIT/ABI/SDK 不跟演不投影(mobile ABI 保持 11)。
|
|
131
|
+
///
|
|
132
|
+
/// - **2026-10-13(domain-owned-contracts 票 04,ADR 0052 D2/D3):契约包
|
|
133
|
+
/// minor bump `0.1.0 → 0.2.0`(WIT 包 semver,ADR 0051 D4;整数 ABI 已退役,
|
|
134
|
+
/// 本文件保留的 vNN 号是历史台账,不再递增)**——功能级交集统一:
|
|
135
|
+
/// ① 桌面 `host-events-desktop`(notify)整 interface 退役——`notify` 本体
|
|
136
|
+
/// 进双端共享契约 `wasmnest-notify-engine/wit/notify.wit` 的 `host-notify`
|
|
137
|
+
/// (签名统一为 `notify(title, body, options-json)`,桌面静默忽略不支持的
|
|
138
|
+
/// vibrate/sound)
|
|
139
|
+
/// ② 桌面 `host-platform-desktop.pick-folders` 退役——与 core
|
|
140
|
+
/// `host-platform.pick-folder` 统一为 core `host-platform.pick-folders`
|
|
141
|
+
/// (`string[]` JSON;本端剩 wsl-distros / local-ipv4-addresses / reveal-in-dir
|
|
142
|
+
/// 3 条)
|
|
143
|
+
/// ③ 移动端 `host-notify` 附加 4 函数改名 `host-notify-mobile`(移动 cap)
|
|
144
|
+
/// 旧产物(0.1.0 SDK 构建)的 import 名与 linker 不等 → 实例化期被点名,
|
|
145
|
+
/// 须按当前 SDK 全量重建(`stale_artifact_rebuild_hint`,fail-visible)
|
|
146
|
+
///
|
|
147
|
+
/// **不 bump 版本号的语义变更(落在 v22 批次内)**:host-bus topic 命名空间。
|
|
148
|
+
/// 函数签名零变化,故不动版本号;但**定向事件的 topic 串**由 `<base>.<owner>` 改为
|
|
149
|
+
/// `<owner>::<base>`,且跨属主的订阅/伪发布由「无人拦截」改为**宿主显式拒绝**。
|
|
150
|
+
/// 旧产物不兼容且不会静默断流:按旧形态订阅会在 activate 期拿到点明新形态的错误,
|
|
151
|
+
/// 必须按 v22 SDK(`owned_topic` / `*_event_topic`)重建。宿主独有能力面
|
|
152
|
+
/// (host-pty / host-websocket / host-mdns 的定向事件);移动端 host-mdns 仍用旧形态,
|
|
153
|
+
/// 双端偏离登记见 ADR 0022「双端偏离」口径。
|
|
154
|
+
///
|
|
155
|
+
/// **同样不 bump 的第二例(系统文件选择器权限门,2026-09-27)**:`host-platform` 的
|
|
156
|
+
/// `pick-files` / `pick-folder` / `pick-folders` 由「选择即授权、不设门」改为
|
|
157
|
+
/// **必须 manifest 单独声明 `fs:pick`**,且选择结果要过 `fs_auth` 授权校验。
|
|
158
|
+
/// 判据同 v22 那一例:**WIT 函数签名与 import 面零变化**(`pick-*` 三个 import
|
|
159
|
+
/// 一字未动),变的是 manifest 层准入条件——权限门是运行期机制,不是 ABI 形状,
|
|
160
|
+
/// 与「插件没声明 `fs:read` 就调 `fs.read` 被门」是同一套机制,不构成需要 bump 的
|
|
161
|
+
/// 契约破坏。旧产物(未声明 `fs:pick` 的 v31 SDK 构建)不兼容且**不会静默降级**:
|
|
162
|
+
/// 调用点在弹对话框**之前**就拿到点名缺失权限位的 `Err`,按当前 SDK 在 manifest
|
|
163
|
+
/// 补声明即可重建(宿主不强制 bump,故第三方插件无需为此重编 wasm)。
|
|
164
|
+
/// **双端偏离(2026-10-13 收口,ADR 0049 D7 / ADR 0052 票 04)**:移动端
|
|
165
|
+
/// `host-platform` 的 SAF 选择器曾维持「选择即授权、不设门」(移动端系统本身按
|
|
166
|
+
/// tree URI 授予访问权,ADR 0018 移动独立契约,故当时不跟演本条);单形态后
|
|
167
|
+
/// host-platform 归内核 `core_binding` 单份实现,`fs:pick` 门对双端统一生效,
|
|
168
|
+
/// 移动 manifest 已随票 04 补声明该位(audit §E.1 收口)。
|
|
169
|
+
///
|
|
170
|
+
/// **第三例(出站授权记录与询问,2026-09-28 授权策略增强)**:`host-http` 的 `fetch`
|
|
171
|
+
/// 由「权限位通过即请求」改为「权限位 + 出站授权记录」双门;未记录的新 origin 弹窗询问
|
|
172
|
+
/// (新事件 `plugin:network-auth-request` + 新宿主命令 `plugin_network_auth_respond`,
|
|
173
|
+
/// 应答沿用 fs 侧的宿主面凭证绑定机制;`allow_once` 按 origin 落 allow 记录、
|
|
174
|
+
/// `deny_always` 落 deny 记录)。**WIT 函数签名与 import / return 面零变化**——`fetch`
|
|
175
|
+
/// 仍收同一份 request JSON、仍返回同一形状的响应文本,变的是**宿主内部的准入条件**,
|
|
176
|
+
/// 与上一例的权限门同型。入站方向 `register-endpoint` 零改动(策略只管出站)。
|
|
177
|
+
/// 旧插件不会被静默断流:它若访问新 origin,会拿到显式的授权拒绝 `Err`(错误分类与
|
|
178
|
+
/// 文案同 fs 侧授权拒绝),用户在弹窗点一次允许即恢复——不兼容但可自愈,故不 bump。
|
|
179
|
+
/// 权威记账在 ADR 0022「授权策略 = 安全闸门」节。
|
|
180
|
+
/// **双端偏离**:移动端是自持业务 App,出站授权由其自身 SAF / 网络策略承担,不跟演本条。
|
|
181
|
+
/// v36 切片:`form`(桌面独有形态声明)拆入 [`abi-form`],
|
|
182
|
+
/// 本接口只剩双端交集 `version`。
|
|
183
|
+
|
|
184
|
+
/// 事件回调(桌面词汇 + 移动词汇**并集**)
|
|
185
|
+
///
|
|
186
|
+
/// 并集理由(2026-10-13,file-transfer 单产物,规格
|
|
187
|
+
/// `.scratch/2026-10-13-file-transfer-single-wasm/spec.md`):双端共享 wasm 产物按
|
|
188
|
+
/// 桌面 `world plugin` 构建,必须同时导出两端宿主要按名调用的回调——桌面 dispatcher
|
|
189
|
+
/// 调 `on-message` / `on-process-done`,移动 dispatcher 调 `on-bus-message` /
|
|
190
|
+
/// `on-auth-success` / `on-disconnect` / `on-session-created` / `on-session-stopped`。
|
|
191
|
+
/// wit-bindgen 导出视图按名懒查找,一端不认识的函数对该端无感 ⇒ 并集对两端原生插件
|
|
192
|
+
/// 均为加法(旧产物少导出函数,旧宿主按名调用不受影响)。
|
|
193
|
+
/// 移动侧 5 函数签名逐字照移动 `plugin-face.wit` 的 `interface events`(双端同步维护;
|
|
194
|
+
/// 签名漂移有契约锁拦截)。
|
|
195
|
+
interface events {
|
|
196
|
+
on-message: func(topic: string, sender: string, payload-json: string) -> result<_, string>;
|
|
197
|
+
/// 进程执行完成回调(v8):host-process run 的进程结束时触发
|
|
198
|
+
/// (正常退出 / 非零退出 / 超时 kill),payload-json 为
|
|
199
|
+
/// `{ run_id, exit_code, timed_out }`
|
|
200
|
+
on-process-done: func(payload-json: string) -> result<_, string>;
|
|
201
|
+
/// 以下 5 函数为移动词汇(并集):桌面宿主不调用,桌面原生插件走默认空实现
|
|
202
|
+
on-bus-message: func(topic: string, payload-json: string) -> result<_, string>;
|
|
203
|
+
on-auth-success: func() -> result<_, string>;
|
|
204
|
+
on-disconnect: func(reason: string) -> result<_, string>;
|
|
205
|
+
on-session-created: func(session-id: string) -> result<_, string>;
|
|
206
|
+
on-session-stopped: func(session-id: string) -> result<_, string>;
|
|
207
|
+
}
|
|
208
|
+
/// 产物形态(v36 自 `abi` 拆出,桌面独有):组件(Component Model)形态声明,
|
|
209
|
+
/// 宿主按 `form()==1` 识别;`0` 是 core 形态的自研 ABI(已退役)。
|
|
210
|
+
interface abi-form {
|
|
211
|
+
form: func() -> u32;
|
|
212
|
+
}
|
|
213
|
+
/// v14:WS 消息帧接收(可选导出,**不进 `plugin` world 必选导出列表**——同 events-binary)
|
|
214
|
+
///
|
|
215
|
+
/// 宿主实例化后动态探测 `events-ws`;未导出则:状态事件照收(bus),
|
|
216
|
+
/// 消息帧丢弃并首次 `warn!` + 计数(宿主不缓存)。
|
|
217
|
+
/// kind = "text" | "binary",payload 统一列表(text 为 UTF-8 字节——零 JSON 转义、
|
|
218
|
+
/// 非 UTF-8 直通)。分片 / 压缩 / opcode 已在宿主侧归一,**同一连接内的帧按到达序
|
|
219
|
+
/// 投递**(保序)。
|
|
220
|
+
/// 无返回值(观察型回调,同 terminal-hooks / events-binary):插件处理失败经
|
|
221
|
+
/// host-log 记录;宿主仅 `error!` 记录 trap(含 endpoint-id / client-id 字段)并计数,
|
|
222
|
+
/// 不断开连接、不中断后续帧投递。
|
|
223
|
+
interface events-ws {
|
|
224
|
+
/// 客户端域:handle 为连接句柄 `wsc-<uuid>`
|
|
225
|
+
on-message: func(handle: string, kind: string, payload: list<u8>);
|
|
226
|
+
/// 服务端域:endpoint-id 为端点句柄、client-id 为对端连接 id
|
|
227
|
+
on-client-message: func(endpoint-id: string, client-id: string, kind: string, payload: list<u8>);
|
|
228
|
+
}
|
|
229
|
+
/// v20:宿主并发任务的进度/终态回调(可选导出,**不进 `plugin` world 必选导出列表**——
|
|
230
|
+
/// 同 events-binary / events-ws)。
|
|
231
|
+
///
|
|
232
|
+
/// 宿主实例化后动态探测 `events-task#on-task-event`:
|
|
233
|
+
/// - SDK 产物(`wasm_entry!` 无条件导出默认空实现)→ 探测命中,`submit` 的
|
|
234
|
+
/// 进度/终态回调可达;
|
|
235
|
+
/// - 旧 SDK 产物(未导出本接口)→ 探测为 None:事件丢弃 + 首次 `warn!` + 计数
|
|
236
|
+
/// (宿主不缓存),离线查询原语 `status` / `list-jobs` 自愈——回调是尽力投递,
|
|
237
|
+
/// `status` 是权威快照。
|
|
238
|
+
///
|
|
239
|
+
/// 无返回值(观察型回调,同 events-ws):插件处理失败经 host-log 记录;宿主仅
|
|
240
|
+
/// trap 时 `error!` 记录并计数,不影响任务执行与其余投递。
|
|
241
|
+
///
|
|
242
|
+
/// **重入纪律(红线,宿主与 SDK 文档双写)**:本回调在宿主派发任务中经
|
|
243
|
+
/// `with_wasm_plugin_call` 单线程串行投递(与所有宿主→插件导出调用共用同一把
|
|
244
|
+
/// 实例锁);插件**禁止**在 guest 调用栈内同步等待自己任务的事件(会自死锁)——
|
|
245
|
+
/// 等待语义一律走 `execute-batch`(宿主侧 join,不经 Store);异步任务的结果消费
|
|
246
|
+
/// 只能在事件回调 / 后续空闲调用里做。回调内再 submit 允许(新调用、新拿锁),
|
|
247
|
+
/// 但受宿主每插件在册任务配额约束,避免「回调风暴」模式。
|
|
248
|
+
interface events-task {
|
|
249
|
+
/// event-json(camelCase):
|
|
250
|
+
/// `{ jobId, phase: "started"|"progress"|"completed"|"failed"|"cancelled",
|
|
251
|
+
/// doneUnits?, failedUnits?, result? }` // result 仅终态携带,同 execute-batch 返回
|
|
252
|
+
on-task-event: func(event-json: string);
|
|
253
|
+
}
|
|
254
|
+
/// v17:认证策略导出(**desktop 独有,双端偏离**——认证中心能力,同
|
|
255
|
+
/// host-auth/host-pty 先例,ADR 0022「双端偏离」节:桌面独有接口不要求移动端跟演)
|
|
256
|
+
///
|
|
257
|
+
/// 消费方 = 宿主 server 认证中间件:连接建立的**验签与策略裁决收为
|
|
258
|
+
/// 一次调用**(v33 / ADR 0033:验签执行移入认证中心,密码学引擎随入场密钥一同
|
|
259
|
+
/// 下沉;宿主不再持有任何设备 JWT 密码学),本导出内部先验签再做策略裁决
|
|
260
|
+
/// (claims 结构/时效策略 + 信任撤销检查);该插件未激活 / 调用失败时
|
|
261
|
+
/// **拒绝**(fail-closed,ADR 0031;旧口径的「宿主策略回退」已随 v31 删除)。
|
|
262
|
+
///
|
|
263
|
+
/// 可选导出(**不进 `plugin` world 必选导出列表**——同 events-binary/events-ws):
|
|
264
|
+
/// 宿主实例化后动态探测 `auth-policy#verify-device-token`;未导出
|
|
265
|
+
/// 的插件(旧 SDK 产物 / 非权威插件)不提供策略,宿主中间件仅对**在册认证中心**
|
|
266
|
+
/// (`com.wasmnest.bedcode`,经 `auth-center-register` 显式登记)调用本导出——
|
|
267
|
+
/// 独立认证中心插件已整体退役,不存在第二个候选。
|
|
268
|
+
///
|
|
269
|
+
/// 入参 = 设备入场 JWT token(**中心自持密钥并自行验签**,ADR 0033:宿主不再持有
|
|
270
|
+
/// 任何设备 JWT 密码学,验签与本导出是同一次调用内的两步——先验签再策略裁决);
|
|
271
|
+
/// 返回 claims JSON(放行)或错误(拒绝原因)。
|
|
272
|
+
interface auth-policy {
|
|
273
|
+
/// 策略裁决:claims 结构/时效策略 + 信任撤销检查 → claims JSON | 拒绝原因
|
|
274
|
+
verify-device-token: func(token: string) -> result<string, string>;
|
|
275
|
+
}
|
|
276
|
+
// 端扩展导出面:import/export 并入合成后的 `plugin` world(include plugin-face)
|
|
277
|
+
//
|
|
278
|
+
// 拆包后能力域接口各自成包,本 world 只声明**留在 `wasmnest:plugin` 的导出面**
|
|
279
|
+
// (events 为双端词汇并集,abi-form 为桌面形态声明)。
|
|
280
|
+
world plugin-face {
|
|
281
|
+
export events;
|
|
282
|
+
export abi-form;
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
|
|
286
|
+
/// v11:二进制消息接收专用 world(**仅 SDK 绑定用,宿主不实例化它**)
|
|
287
|
+
///
|
|
288
|
+
/// 宿主对 `plugin` world 的导出全部按必选实例化,旧插件(v10 及更早)不导出
|
|
289
|
+
/// `events-binary`,因此它不能声明进 `plugin` world(否则旧插件无法加载);
|
|
290
|
+
/// 宿主改为实例化后动态探测 `events-binary#on-message-binary`。
|
|
291
|
+
/// 本 world 让 SDK 的 `wasm_binary` 模块生成 events-binary 的 guest 绑定
|
|
292
|
+
/// (Guest trait + export!),使 `wasm_entry!` 能无条件导出默认实现
|
|
293
|
+
/// (空实现亦可被宿主动态探测命中)。
|
|
294
|
+
world plugin-binary {
|
|
295
|
+
export events-binary;
|
|
296
|
+
}
|
|
297
|
+
/// v14:events-ws 绑定专用 world(**仅 SDK 绑定用,宿主不实例化它**)——同 plugin-binary
|
|
298
|
+
///
|
|
299
|
+
/// 宿主对 `plugin` world 的导出全部按必选实例化,未导出 `events-ws` 的插件不能
|
|
300
|
+
/// 因此加载失败,故该接口不声明进 `plugin` world;宿主改为实例化后动态探测。
|
|
301
|
+
/// 本 world 让 SDK 生成 events-ws 的 guest 绑定(Guest trait + export!),
|
|
302
|
+
/// 使 `wasm_entry!` 能无条件导出默认实现(空实现亦可被宿主动态探测命中)。
|
|
303
|
+
world plugin-ws {
|
|
304
|
+
export events-ws;
|
|
305
|
+
}
|
|
306
|
+
/// v20:events-task 绑定专用 world(**仅 SDK 绑定用,宿主不实例化它**)——同
|
|
307
|
+
/// plugin-binary / plugin-ws:宿主对 `plugin` world 的导出全部按必选实例化,未导出
|
|
308
|
+
/// `events-task` 的插件不能因此加载失败,故该接口不声明进 `plugin` world;宿主
|
|
309
|
+
/// 改为实例化后动态探测。本 world 让 SDK 生成 events-task 的 guest 绑定(Guest
|
|
310
|
+
/// trait + export!),使 `wasm_entry!` 能无条件导出默认实现(空实现亦可被宿主
|
|
311
|
+
/// 动态探测命中)。
|
|
312
|
+
world plugin-task {
|
|
313
|
+
export events-task;
|
|
314
|
+
}
|
|
315
|
+
/// v17:auth-policy 绑定专用 world(**仅 SDK 绑定用,宿主不实例化它**)——同 plugin-binary
|
|
316
|
+
///
|
|
317
|
+
/// 本 world 让 SDK 生成 auth-policy 的 guest 绑定(Guest trait + export!),
|
|
318
|
+
/// 使 `wasm_entry!` 能无条件导出默认实现(默认拒绝——非认证中心插件不提供
|
|
319
|
+
/// 策略;宿主动态探测命中但中间件只调用认证中心实例)。
|
|
320
|
+
world plugin-auth-policy {
|
|
321
|
+
export auth-policy;
|
|
322
|
+
}
|
|
323
|
+
/// 系统组件 world(**仅供系统组件构建绑定,宿主仍以 `plugin` world 实例化**)
|
|
324
|
+
///
|
|
325
|
+
/// 系统组件(manifest `type: "system"`)在
|
|
326
|
+
/// `plugin` world 标准导出之外,追加导出其提供的能力接口——能力接口与宿主
|
|
327
|
+
/// import 同形(复用 host-* 接口定义,不引入新的组件组合 world)。宿主按
|
|
328
|
+
/// `plugin` world 实例化后动态探测能力接口导出(同 events-binary 模式),
|
|
329
|
+
/// 命中即把该能力注册为「系统组件实例」提供者;未命中宿主 import 侧仍由
|
|
330
|
+
/// 宿主原语直连,应用插件无感。
|
|
331
|
+
///
|
|
332
|
+
/// `plugin` world 本身不变(既有插件零迁移,ABI 版本无需 bump)。
|
|
333
|
+
world plugin-system {
|
|
334
|
+
export command;
|
|
335
|
+
export lifecycle;
|
|
336
|
+
export events;
|
|
337
|
+
export manifest;
|
|
338
|
+
export abi-form;
|
|
339
|
+
|
|
340
|
+
/// 能力导出:宿主 KV 存储同形接口(装配框架首条路由能力)
|
|
341
|
+
export host-storage;
|
|
342
|
+
}
|
|
343
|
+
|
|
344
|
+
/// 桌面兼容面 binding-only world(2026-10-13,file-transfer 单产物)
|
|
345
|
+
///
|
|
346
|
+
/// **宿主绑定用,插件不实例化它**(同 `plugin-binary` 先例):移动宿主 bindgen 本
|
|
347
|
+
/// world 取得 `host-api-call` / `host-platform-desktop` 的 `Host` trait,为双端共享
|
|
348
|
+
/// wasm 产物(按桌面 `world plugin` 构建、import 这两个 interface)提供 **fail-visible
|
|
349
|
+
/// 桩**——全部函数显性 `Err("unsupported on mobile")`。桌面分支在移动端不可达
|
|
350
|
+
/// (共享产物经 `host-platform.platform()` 探测后不选桌面实现),桩的存在只为满足
|
|
351
|
+
/// 组件实例化的 import 闭合,不是「移动端实现桌面能力」。
|
|
352
|
+
world desktop-compat {
|
|
353
|
+
import wasmnest:api-call/host-api-call@0.0.1;
|
|
354
|
+
import wasmnest:platform-desktop/host-platform-desktop@0.0.1;
|
|
355
|
+
}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
package wasmnest:plugin@0.1.0;
|
|
2
|
+
|
|
3
|
+
world plugin {
|
|
4
|
+
include core;
|
|
5
|
+
include plugin-face;
|
|
6
|
+
include wasmnest:pty/cap-pty@0.0.1;
|
|
7
|
+
include wasmnest:mdns/cap-mdns@0.0.1;
|
|
8
|
+
include wasmnest:peer/cap-peer@0.0.1;
|
|
9
|
+
include wasmnest:http/cap-http@0.0.1;
|
|
10
|
+
include wasmnest:ws/cap-ws@0.0.1;
|
|
11
|
+
include wasmnest:notify/cap-notify@0.0.1;
|
|
12
|
+
include wasmnest:clipboard/cap-clipboard@0.0.1;
|
|
13
|
+
include wasmnest:http-endpoint/cap-http-endpoint@0.0.1;
|
|
14
|
+
include wasmnest:ws-server/cap-ws-server@0.0.1;
|
|
15
|
+
include wasmnest:api-call/cap-api-call@0.0.1;
|
|
16
|
+
include wasmnest:app/cap-app@0.0.1;
|
|
17
|
+
include wasmnest:auth-center/cap-auth-center@0.0.1;
|
|
18
|
+
include wasmnest:connection-registry/cap-connection-registry@0.0.1;
|
|
19
|
+
include wasmnest:crypto/cap-crypto@0.0.1;
|
|
20
|
+
include wasmnest:fs-desktop/cap-fs-desktop@0.0.1;
|
|
21
|
+
include wasmnest:platform-desktop/cap-platform-desktop@0.0.1;
|
|
22
|
+
include wasmnest:process/cap-process@0.0.1;
|
|
23
|
+
include wasmnest:task/cap-task@0.0.1;
|
|
24
|
+
include wasmnest:timer/cap-timer@0.0.1;
|
|
25
|
+
}
|
package/package.json
CHANGED
|
@@ -1,6 +1,103 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@binblink/wasmnest-plugin-sdk-desktop",
|
|
3
|
-
"version": "0.0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
3
|
+
"version": "0.0.2",
|
|
4
|
+
"license": "MIT",
|
|
5
|
+
"publishConfig": {
|
|
6
|
+
"access": "public"
|
|
7
|
+
},
|
|
8
|
+
"type": "module",
|
|
9
|
+
"main": "./dist/index.js",
|
|
10
|
+
"types": "./dist/index.d.ts",
|
|
11
|
+
"bin": {
|
|
12
|
+
"wasmnest-plugin-desktop": "./bin/cli.js"
|
|
13
|
+
},
|
|
14
|
+
"files": [
|
|
15
|
+
"dist",
|
|
16
|
+
"src",
|
|
17
|
+
"bin",
|
|
18
|
+
"go",
|
|
19
|
+
"tools",
|
|
20
|
+
"template",
|
|
21
|
+
"README.md",
|
|
22
|
+
"README_en.md",
|
|
23
|
+
"LICENSE",
|
|
24
|
+
"dev-shell/src",
|
|
25
|
+
"dev-shell/index.html",
|
|
26
|
+
"dev-shell/package.json",
|
|
27
|
+
"dev-shell/vite.config.ts",
|
|
28
|
+
"dev-shell/tailwind.config.js",
|
|
29
|
+
"dev-shell/postcss.config.js",
|
|
30
|
+
"dev-shell/pnpm-workspace.yaml",
|
|
31
|
+
"dev-shell/README.md"
|
|
32
|
+
],
|
|
33
|
+
"exports": {
|
|
34
|
+
".": {
|
|
35
|
+
"types": "./dist/index.d.ts",
|
|
36
|
+
"import": "./dist/index.js"
|
|
37
|
+
},
|
|
38
|
+
"./vite": {
|
|
39
|
+
"types": "./dist/vite-plugin.d.ts",
|
|
40
|
+
"import": "./dist/vite-plugin.js"
|
|
41
|
+
},
|
|
42
|
+
"./ui": {
|
|
43
|
+
"types": "./src/ui/Select.d.ts",
|
|
44
|
+
"import": "./src/ui/Select.vue"
|
|
45
|
+
},
|
|
46
|
+
"./ui/number-field": {
|
|
47
|
+
"types": "./src/ui/NumberField.d.ts",
|
|
48
|
+
"import": "./src/ui/NumberField.vue"
|
|
49
|
+
},
|
|
50
|
+
"./ui/zoom-compensation": {
|
|
51
|
+
"types": "./src/ui/zoom-compensation.d.ts",
|
|
52
|
+
"import": "./src/ui/zoom-compensation.ts"
|
|
53
|
+
},
|
|
54
|
+
"./ui/terminal-input-rail": {
|
|
55
|
+
"types": "./src/ui/terminal-input-rail.d.ts",
|
|
56
|
+
"import": "./src/ui/TerminalInputRail.vue"
|
|
57
|
+
},
|
|
58
|
+
"./ui/plugin-global-dialog": {
|
|
59
|
+
"types": "./src/ui/plugin-global-dialog.d.ts",
|
|
60
|
+
"import": "./src/ui/PluginGlobalDialog.vue"
|
|
61
|
+
},
|
|
62
|
+
"./ui/markdown-editor": {
|
|
63
|
+
"types": "./src/ui/markdown-editor.d.ts",
|
|
64
|
+
"import": "./src/ui/MarkdownEditor.vue"
|
|
65
|
+
},
|
|
66
|
+
"./ui/app-update": {
|
|
67
|
+
"types": "./src/ui/AppUpdateSection.d.ts",
|
|
68
|
+
"import": "./src/ui/AppUpdateSection.vue"
|
|
69
|
+
},
|
|
70
|
+
"./types": {
|
|
71
|
+
"types": "./dist/types.d.ts",
|
|
72
|
+
"import": "./dist/types.js"
|
|
73
|
+
},
|
|
74
|
+
"./bin/manifest-gen.js": "./bin/manifest-gen.js",
|
|
75
|
+
"./bin/wasm-hash.js": "./bin/wasm-hash.js",
|
|
76
|
+
"./bin/plugin-watch.js": "./bin/plugin-watch.js",
|
|
77
|
+
"./tools/componentize/Cargo.toml": "./tools/componentize/Cargo.toml",
|
|
78
|
+
"./package.json": "./package.json"
|
|
79
|
+
},
|
|
80
|
+
"dependencies": {
|
|
81
|
+
"magic-string": "^0.30.21",
|
|
82
|
+
"marked": "^18.0.11"
|
|
83
|
+
},
|
|
84
|
+
"peerDependencies": {
|
|
85
|
+
"reka-ui": "^2.11.0",
|
|
86
|
+
"vite": "^8.0.0",
|
|
87
|
+
"vue": "^3.4.0"
|
|
88
|
+
},
|
|
89
|
+
"devDependencies": {
|
|
90
|
+
"@vitejs/plugin-vue": "^6.0.0",
|
|
91
|
+
"@vue/test-utils": "^2.4.11",
|
|
92
|
+
"happy-dom": "^13.10.1",
|
|
93
|
+
"reka-ui": "^2.11.0",
|
|
94
|
+
"tsup": "^8.5.1",
|
|
95
|
+
"vitest": "^3.2.7"
|
|
96
|
+
},
|
|
97
|
+
"scripts": {
|
|
98
|
+
"build": "tsup src/index.ts src/vite-plugin.ts src/types.ts --format esm --dts --clean",
|
|
99
|
+
"gen:permissions": "cargo run --quiet --manifest-path rust/Cargo.toml --example gen_permission_vocabulary",
|
|
100
|
+
"test": "vitest",
|
|
101
|
+
"test:run": "vitest run"
|
|
102
|
+
}
|
|
6
103
|
}
|
package/src/config.ts
ADDED
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Plugin Configuration Helpers
|
|
3
|
+
*
|
|
4
|
+
* SDK 侧配置约定:统一 storage key + 声明式配置助手。
|
|
5
|
+
* 插件运行时读写配置走 context.storage,与宿主配置页共享 key。
|
|
6
|
+
*/
|
|
7
|
+
|
|
8
|
+
import type { PluginConfiguration, ConfigProperty } from './types'
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* 插件配置在 storage 中的统一键名
|
|
12
|
+
*
|
|
13
|
+
* 插件运行时:context.storage.get(PLUGIN_CONFIG_STORAGE_KEY)
|
|
14
|
+
* 宿主配置页:pluginStorageGet(pluginId, PLUGIN_CONFIG_STORAGE_KEY)
|
|
15
|
+
* 两者共享同一 key,保证数据一致
|
|
16
|
+
*/
|
|
17
|
+
export const PLUGIN_CONFIG_STORAGE_KEY = 'config'
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* 声明式构建插件配置(manifest contributes.configuration)
|
|
21
|
+
*
|
|
22
|
+
* 用途:插件开发者在代码中声明配置 schema,与 plugin.json 中保持一致。
|
|
23
|
+
* 实际 manifest 中的 configuration 以 plugin.json 为单一真源。
|
|
24
|
+
*
|
|
25
|
+
* @example
|
|
26
|
+
* ```ts
|
|
27
|
+
* const config = defineConfiguration('My Plugin Settings', {
|
|
28
|
+
* apiKey: { type: 'string', title: 'API Key', description: 'Your API key' },
|
|
29
|
+
* maxRetries: { type: 'number', title: 'Max Retries', default: 3 },
|
|
30
|
+
* debugMode: { type: 'boolean', title: 'Debug Mode', default: false },
|
|
31
|
+
* })
|
|
32
|
+
* ```
|
|
33
|
+
*/
|
|
34
|
+
export function defineConfiguration(
|
|
35
|
+
title: string,
|
|
36
|
+
properties: Record<string, Omit<ConfigProperty, 'title'> & { title?: string }>,
|
|
37
|
+
): PluginConfiguration {
|
|
38
|
+
const props: Record<string, ConfigProperty> = {}
|
|
39
|
+
for (const [key, value] of Object.entries(properties)) {
|
|
40
|
+
props[key] = {
|
|
41
|
+
type: value.type,
|
|
42
|
+
title: value.title ?? key,
|
|
43
|
+
description: value.description,
|
|
44
|
+
default: value.default,
|
|
45
|
+
enum: value.enum,
|
|
46
|
+
}
|
|
47
|
+
}
|
|
48
|
+
return { title, properties: props }
|
|
49
|
+
}
|