@wudao-org/server 0.0.0-stage → 0.4.20

package/dist/vault.d.ts

@@ -0,0 +1,23 @@
+/** The op names the vault covers — the MUTATIONS. Dual-form ops
+ *  (`switch`, `recentWorkspaces`) vault only their mutating form (n / add
+ *  present); the read form must stay uncached. Exported for the full-set
+ *  mirror pin (tests/vaulted-mirror.test.ts — the server half of the web
+ *  protocol test's classification pin; the wire payload arrives as parsed
+ *  JSON, so the mirror is intentionally untyped Record<string, unknown>). */
+export declare function isVaultedMutation(o: Record<string, unknown>): boolean;
+/** Deterministic serialization for the vault digest: object keys sorted at
+ *  every depth, compact separators (the same canonical form nanobot's vault
+ *  hashes — key order in a JSON frame must never change the digest). */
+export declare function canonicalJson(v: unknown): string;
+/** One vaulted operation: what the client asked (action + payload digest),
+ *  whether it settled, its reply, and the joiners awaiting that reply. */
+export interface VaultEntry {
+    readonly action: string;
+    readonly digest: string;
+    done: boolean;
+    ok: unknown;
+    err?: string;
+    completedAt: number | null;
+    readonly joiners: ((ok: unknown, err?: string) => void)[];
+}
+//# sourceMappingURL=vault.d.ts.map

package/dist/vault.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault.d.ts","sourceRoot":"","sources":["../src/vault.ts"],"names":[],"mappings":"AAMA;;;;;6EAK6E;AAC7E,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CA4FrE;AAED;;wEAEwE;AACxE,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAOhD;AAED;0EAC0E;AAC1E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC,EAAE,CAAC;CAC3D"}

package/dist/vault.js

@@ -0,0 +1,117 @@
+// @wudao-org/server — ω-3a 变更幂等 vault 的纯函数段外提（多 driver 并发弧 B 的
+// 顺带件，file-size 棘轮纪律：index.ts 的白名单帽只收不涨）。逐字节搬家：
+// isVaultedMutation / canonicalJson / VaultEntry 三段自 index.ts 原样外提；
+// index.ts 的 re-export 门面维持既有公共面（vaulted-mirror.test.ts 把
+// isVaultedMutation 钉在 index 导出上）。
+/** The op names the vault covers — the MUTATIONS. Dual-form ops
+ *  (`switch`, `recentWorkspaces`) vault only their mutating form (n / add
+ *  present); the read form must stay uncached. Exported for the full-set
+ *  mirror pin (tests/vaulted-mirror.test.ts — the server half of the web
+ *  protocol test's classification pin; the wire payload arrives as parsed
+ *  JSON, so the mirror is intentionally untyped Record<string, unknown>). */
+export function isVaultedMutation(o) {
+    switch (o.op) {
+        case "submit":
+        case "interrupt":
+        case "setMode":
+        case "answerPermission":
+        // 借鉴弧 α2/α1 — both new lanes are convergent-on-replay (a replayed
+        // recall/answer finds nothing parked and answers false), but the family
+        // law vaults driver-state mutations so a mid-flap replay re-serves the
+        // original reply instead of re-executing against a MOVED queue (a same-
+        // text entry at the same index would be the wrong kill).
+        case "recallSteer":
+        case "answerAskUser":
+        // 借鉴弧 δ — convergent on replay (a replayed detach finds the call no
+        // longer in flight and answers not_in_flight), but the driver-state
+        // mutation family law vaults it: a mid-flap replay re-serves the
+        // original verdict instead of detaching a MOVED busy row.
+        case "detachToolCall":
+        case "resume":
+        case "rewind":
+        // ω-3a review M1 follow-up: /edit arming IS a mutation (an armed edit
+        // branch is driver state) — vaulted like every other mutation, so a
+        // mid-flap replay re-serves the armed text instead of re-arming.
+        case "edit":
+        case "settingsSaveKey":
+        case "settingsSet":
+        // Provider management §5: a provider write is a side effect that must
+        // survive a mid-flap replay exactly once — vaulted like settingsSet
+        // (delete converges on replay, the /models probe is a read: not vaulted).
+        case "settingsSaveProvider":
+        case "switchWorkspace":
+        case "panelRootSet":
+        case "agentRootSwitch":
+        case "attachmentSave":
+        // ω99-55: the file lane's save writes content-addressed objects — a
+        // side effect, vaulted like the image save (replay joins the original
+        // execution; a re-uploaded duplicate is a dedup no-op anyway).
+        case "fileSave":
+        case "pluginMarketAdd":
+        case "pluginMarketUpdate":
+        case "pluginMarketRemove":
+        case "pluginInstall":
+        case "pluginInstallSpec":
+        case "longtermMemoryForget": // M-Memory — tombstone 幂等 // guided-install 弧 — 与 pluginInstall 同族（重放收敛 already-exists）
+        case "pluginUninstall":
+        case "pluginEnable":
+        case "pluginDisable":
+        // persona-settings T5: persona writes are side effects — vaulted like the
+        // other registry mutations (delete converges on replay; the reads
+        // personaList/personaGet are NOT vaulted).
+        case "personaSave":
+        case "personaDelete":
+        // ω99-235: #2 — the pet lane's three ops are mutations of the SECOND
+        // driver session — vaulted exactly like their main-lane twins, so a
+        // mid-flap replay never double-submits into the sprite's lane.
+        case "petSubmit":
+        case "petInterrupt":
+        case "petAnswerPermission":
+        // ω99-260: the memory decision is a side effect (confirm flips a line,
+        // del removes it) — vaulted so a mid-flap replay never double-decides;
+        // ok/del converge (a replayed second ok answers ok:false, never breaks).
+        // ω99-264: the memory REWRITE rides the same vault seat — its replay
+        // convergence is the driver's content-equal short-circuit (a bare update
+        // is v+1 per call; the vault joins or replays the cached verdict, and a
+        // genuinely re-sent edit converges in the driver, version 恰 +1).
+        case "memoryDecide":
+        case "memoryEdit":
+        // ω99-314: the file-level time machine's restore is a WORKING-face side
+        // effect (it overwrites a workspace file) — vaulted so a mid-flap replay
+        // joins the original execution; a second revert after a later edit must
+        // be a fresh user decision, never a replayed frame.
+        case "fileRevert":
+        // ω99-317: the schedules management face's two writes — setEnabled is a
+        // state write (settingsSet shape), runNow RE-RUNS a task (a mid-flap
+        // replay would double-run) — both vaulted for exactly-once. The delete
+        // (schedulesRemove) converges on replay and stays UN-vaulted, the
+        // sessionDelete/settingsDeleteProvider precedent.
+        case "schedulesSetEnabled":
+        case "schedulesRunNow":
+            return true;
+        // 永续 v6 wave2（reef C1）：改进提案面的五个决策是写副作用（consent 起
+        // 子代理+模型调用、activate 写规则文件）——vaulted 恰一次；list 是读，
+        // 与 schedulesList 同形不 vault。
+        case "improvementFace":
+            return o.action !== "list";
+        case "switch":
+            return o.n !== undefined;
+        case "recentWorkspaces":
+            return o.add !== undefined;
+        default:
+            return false;
+    }
+}
+/** Deterministic serialization for the vault digest: object keys sorted at
+ *  every depth, compact separators (the same canonical form nanobot's vault
+ *  hashes — key order in a JSON frame must never change the digest). */
+export function canonicalJson(v) {
+    if (Array.isArray(v))
+        return `[${v.map(canonicalJson).join(",")}]`;
+    if (typeof v === "object" && v !== null) {
+        const keys = Object.keys(v).sort();
+        return `{${keys.map((k) => `${JSON.stringify(k)}:${canonicalJson(v[k])}`).join(",")}}`;
+    }
+    return JSON.stringify(v) ?? "null";
+}
+//# sourceMappingURL=vault.js.map

package/dist/vault.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vault.js","sourceRoot":"","sources":["../src/vault.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@wudao-org/server",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.4.20",
+  "type": "module",
+  "description": "Localhost WS server for the wudao agent driver — first-frame auth, two-channel state protocol (see PROTOCOL.md).",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.5.12",
+    "typescript": "5.6.3",
+    "vitest": "2.1.8"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT",
+  "author": "feiniaojin",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/feiniaojin/wudao-harness.git"
+  },
+  "keywords": [
+    "agent",
+    "harness",
+    "websocket",
+    "protocol",
+    "llm"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.