@mclawnet/shared 0.1.7 → 0.1.9

package/dist/__tests__/chat-protocol.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chat-protocol.test.d.ts.map

package/dist/__tests__/chat-protocol.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-protocol.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/chat-protocol.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/chat-protocol.test.js

@@ -0,0 +1,32 @@
+import { describe, it, expect } from "vitest";
+describe("ChatCreateConversation (N4)", () => {
+    it("accepts backendType + sticky fields", () => {
+        const msg = {
+            type: "create_conversation",
+            agentId: "a1",
+            backendType: "codex",
+            stickyModel: "gpt-4o",
+            stickyMode: "workspace-write",
+        };
+        expect(msg.backendType).toBe("codex");
+        expect(msg.stickyModel).toBe("gpt-4o");
+        expect(msg.stickyMode).toBe("workspace-write");
+    });
+    it("backendType is optional (back-compat)", () => {
+        const msg = {
+            type: "create_conversation",
+            agentId: "a1",
+        };
+        expect(msg.backendType).toBeUndefined();
+        expect(msg.stickyModel).toBeUndefined();
+        expect(msg.stickyMode).toBeUndefined();
+    });
+    it("accepts 'claude' backendType literal", () => {
+        const msg = {
+            type: "create_conversation",
+            backendType: "claude",
+        };
+        expect(msg.backendType).toBe("claude");
+    });
+});
+//# sourceMappingURL=chat-protocol.test.js.map

package/dist/__tests__/chat-protocol.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-protocol.test.js","sourceRoot":"","sources":["../../src/__tests__/chat-protocol.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAG9C,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,GAAG,GAA2B;YAClC,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,IAAI;YACb,WAAW,EAAE,OAAO;YACpB,WAAW,EAAE,QAAQ;YACrB,UAAU,EAAE,iBAAiB;SAC9B,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,GAAG,GAA2B;YAClC,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,IAAI;SACd,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,aAAa,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,aAAa,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,aAAa,EAAE,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,GAAG,GAA2B;YAClC,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE,QAAQ;SACtB,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/model-catalog.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=model-catalog.test.d.ts.map

package/dist/__tests__/model-catalog.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/model-catalog.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/model-catalog.test.js

@@ -0,0 +1,55 @@
+import { describe, it, expect } from "vitest";
+describe("model-catalog types", () => {
+    it("ModelDescriptor accepts minimum required shape", () => {
+        const m = { code: "opus", label: "Claude Opus 4" };
+        expect(m.code).toBe("opus");
+    });
+    it("ModeDescriptor accepts minimum required shape", () => {
+        const m = { code: "default", label: "Default" };
+        expect(m.code).toBe("default");
+    });
+    it("AgentManifestPayload allows installed=false with empty models", () => {
+        const p = {
+            manifestVersion: 1,
+            backends: [
+                {
+                    kind: "codex",
+                    installed: false,
+                    unavailableReason: "not on PATH",
+                    models: [],
+                    modes: [],
+                },
+            ],
+        };
+        expect(p.backends[0].installed).toBe(false);
+        expect(p.backends[0].kind).toBe("codex");
+    });
+    it("AgentManifestPayload accepts installed=true with rich descriptors", () => {
+        const p = {
+            manifestVersion: 1,
+            backends: [
+                {
+                    kind: "claude",
+                    installed: true,
+                    binaryPath: "/usr/local/bin/claude",
+                    version: "2.0.1",
+                    models: [
+                        {
+                            code: "opus",
+                            label: "Claude Opus 4",
+                            tier: "premium",
+                            contextWindow: 200_000,
+                            supportsVision: true,
+                            supportsToolUse: true,
+                            default: true,
+                        },
+                    ],
+                    modes: [{ code: "default", label: "Default", default: true }],
+                },
+            ],
+        };
+        expect(p.backends[0].models[0].tier).toBe("premium");
+        expect(p.manifestVersion).toBe(1);
+    });
+});
+//# sourceMappingURL=model-catalog.test.js.map

package/dist/__tests__/model-catalog.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.test.js","sourceRoot":"","sources":["../../src/__tests__/model-catalog.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAO9C,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,GAAoB,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC;QACpE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,CAAC,GAAmB,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAChE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,CAAC,GAAyB;YAC9B,eAAe,EAAE,CAAC;YAClB,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,OAAO;oBACb,SAAS,EAAE,KAAK;oBAChB,iBAAiB,EAAE,aAAa;oBAChC,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,EAAE;iBACV;aACF;SACF,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5C,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,CAAC,GAAyB;YAC9B,eAAe,EAAE,CAAC;YAClB,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,QAAQ;oBACd,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,uBAAuB;oBACnC,OAAO,EAAE,OAAO;oBAChB,MAAM,EAAE;wBACN;4BACE,IAAI,EAAE,MAAM;4BACZ,KAAK,EAAE,eAAe;4BACtB,IAAI,EAAE,SAAS;4BACf,aAAa,EAAE,OAAO;4BACtB,cAAc,EAAE,IAAI;4BACpB,eAAe,EAAE,IAAI;4BACrB,OAAO,EAAE,IAAI;yBACd;qBACF;oBACD,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;iBAC9D;aACF;SACF,CAAC;QACF,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrD,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/session-protocol-schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=session-protocol-schema.test.d.ts.map

package/dist/__tests__/session-protocol-schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-protocol-schema.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/session-protocol-schema.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/session-protocol-schema.test.js

@@ -0,0 +1,149 @@
+import { describe, it, expect } from "vitest";
+import { createSessionSchema, sessionCreatePayloadSchema, sessionInputPayloadSchema, sessionUpdateStickyPayloadSchema, } from "../schemas.js";
+describe("session protocol schemas", () => {
+    describe("createSessionSchema (REST POST /api/sessions)", () => {
+        it("accepts default backend (claude)", () => {
+            const r = createSessionSchema.safeParse({});
+            expect(r.success).toBe(true);
+            if (r.success)
+                expect(r.data.backendType).toBe("claude");
+        });
+        it("accepts explicit codex", () => {
+            const r = createSessionSchema.safeParse({ backendType: "codex" });
+            expect(r.success).toBe(true);
+        });
+        it("rejects openclaw — REST enum now aligned with wire backendKindSchema", () => {
+            const r = createSessionSchema.safeParse({ backendType: "openclaw" });
+            expect(r.success).toBe(false);
+        });
+    });
+    describe("sessionCreatePayloadSchema", () => {
+        it("accepts minimal valid payload", () => {
+            const r = sessionCreatePayloadSchema.safeParse({ sessionId: "s1", backend: "claude" });
+            expect(r.success).toBe(true);
+        });
+        it("accepts full payload with sticky + initialInput", () => {
+            const r = sessionCreatePayloadSchema.safeParse({
+                sessionId: "s1",
+                workDir: "/tmp",
+                backend: "codex",
+                sticky: { model: "gpt-4o", mode: "workspace-write" },
+                systemPrompt: "you are helpful",
+                useBrainCore: false,
+                initialInput: "hi",
+            });
+            expect(r.success).toBe(true);
+        });
+        it("rejects unknown backend (openclaw not allowed)", () => {
+            const r = sessionCreatePayloadSchema.safeParse({ sessionId: "s1", backend: "openclaw" });
+            expect(r.success).toBe(false);
+        });
+        it("rejects missing sessionId", () => {
+            const r = sessionCreatePayloadSchema.safeParse({ backend: "claude" });
+            expect(r.success).toBe(false);
+        });
+        it("accepts useWorktree=true on session.create", () => {
+            const r = sessionCreatePayloadSchema.safeParse({
+                sessionId: "s1",
+                backend: "claude",
+                useWorktree: true,
+            });
+            expect(r.success).toBe(true);
+        });
+        it("useWorktree is optional (back-compat)", () => {
+            const r = sessionCreatePayloadSchema.safeParse({
+                sessionId: "s1",
+                backend: "claude",
+            });
+            expect(r.success).toBe(true);
+        });
+    });
+    describe("sessionInputPayloadSchema", () => {
+        it("accepts minimal", () => {
+            const r = sessionInputPayloadSchema.safeParse({ sessionId: "s1", content: "hello" });
+            expect(r.success).toBe(true);
+        });
+        it("accepts with messageMeta override", () => {
+            const r = sessionInputPayloadSchema.safeParse({
+                sessionId: "s1",
+                content: "hello",
+                messageMeta: { model: "opus", mode: "plan" },
+            });
+            expect(r.success).toBe(true);
+        });
+        it("accepts empty content (e.g. retry signal)", () => {
+            const r = sessionInputPayloadSchema.safeParse({ sessionId: "s1", content: "" });
+            expect(r.success).toBe(true);
+        });
+        it("accepts backendSessionId for restart-recovery hint", () => {
+            const r = sessionInputPayloadSchema.safeParse({
+                sessionId: "s1",
+                content: "hello",
+                backendSessionId: "abc-123-uuid",
+            });
+            expect(r.success).toBe(true);
+        });
+        it("accepts content + messageMeta + backendSessionId together", () => {
+            const r = sessionInputPayloadSchema.safeParse({
+                sessionId: "s1",
+                content: "hello",
+                messageMeta: { model: "opus" },
+                backendSessionId: "abc",
+            });
+            expect(r.success).toBe(true);
+        });
+        it("rejects backendSessionId exceeding 256 chars (DOS cap)", () => {
+            const r = sessionInputPayloadSchema.safeParse({
+                sessionId: "s1",
+                content: "hello",
+                backendSessionId: "x".repeat(257),
+            });
+            expect(r.success).toBe(false);
+        });
+        it("accepts workDir + useBrainCore for restart-recovery context", () => {
+            const r = sessionInputPayloadSchema.safeParse({
+                sessionId: "s1",
+                content: "hi",
+                workDir: "/repo",
+                useBrainCore: true,
+            });
+            expect(r.success).toBe(true);
+        });
+        it("rejects workDir exceeding 4096 chars", () => {
+            const r = sessionInputPayloadSchema.safeParse({
+                sessionId: "s1",
+                content: "hi",
+                workDir: "x".repeat(4097),
+            });
+            expect(r.success).toBe(false);
+        });
+    });
+    describe("sessionUpdateStickyPayloadSchema", () => {
+        it("accepts partial sticky", () => {
+            const r = sessionUpdateStickyPayloadSchema.safeParse({
+                sessionId: "s1",
+                sticky: { model: "sonnet" },
+            });
+            expect(r.success).toBe(true);
+        });
+        it("rejects empty sticky object (must specify at least one field)", () => {
+            const r = sessionUpdateStickyPayloadSchema.safeParse({
+                sessionId: "s1",
+                sticky: {},
+            });
+            expect(r.success).toBe(false);
+        });
+        it("accepts sticky with mode only", () => {
+            const r = sessionUpdateStickyPayloadSchema.safeParse({
+                sessionId: "s1",
+                sticky: { mode: "plan" },
+            });
+            expect(r.success).toBe(true);
+        });
+        it("rejects missing sticky", () => {
+            const r = sessionUpdateStickyPayloadSchema.safeParse({ sessionId: "s1" });
+            expect(r.success).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=session-protocol-schema.test.js.map

package/dist/__tests__/session-protocol-schema.test.js.map

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

package/dist/__tests__/swarm-protocol.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=swarm-protocol.test.d.ts.map

package/dist/__tests__/swarm-protocol.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-protocol.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/swarm-protocol.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/swarm-protocol.test.js

@@ -0,0 +1,35 @@
+import { describe, it, expect } from "vitest";
+describe("ChatCreateSwarmConversation (N4.5)", () => {
+    it("roles[] accepts model + mode + backend + sandbox", () => {
+        const msg = {
+            type: "create_swarm_conversation",
+            roles: [{
+                    roleName: "dev",
+                    backend: "codex",
+                    sandbox: "workspace-write",
+                    model: "gpt-4o",
+                    mode: "workspace-write",
+                }],
+        };
+        expect(msg.roles?.[0].model).toBe("gpt-4o");
+        expect(msg.roles?.[0].mode).toBe("workspace-write");
+    });
+    it("model/mode are optional (back-compat)", () => {
+        const msg = {
+            type: "create_swarm_conversation",
+            roles: [{ roleName: "dev" }],
+        };
+        expect(msg.roles?.[0].model).toBeUndefined();
+    });
+});
+describe("ChatUpgradeToSwarm (N4.5)", () => {
+    it("roles[] accepts model + mode", () => {
+        const msg = {
+            type: "upgrade_to_swarm",
+            sessionId: "s1",
+            roles: [{ roleName: "dev", model: "opus", mode: "plan" }],
+        };
+        expect(msg.roles[0].model).toBe("opus");
+    });
+});
+//# sourceMappingURL=swarm-protocol.test.js.map

package/dist/__tests__/swarm-protocol.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-protocol.test.js","sourceRoot":"","sources":["../../src/__tests__/swarm-protocol.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAG9C,QAAQ,CAAC,oCAAoC,EAAE,GAAG,EAAE;IAClD,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,GAAG,GAAgC;YACvC,IAAI,EAAE,2BAA2B;YACjC,KAAK,EAAE,CAAC;oBACN,QAAQ,EAAE,KAAK;oBACf,OAAO,EAAE,OAAO;oBAChB,OAAO,EAAE,iBAAiB;oBAC1B,KAAK,EAAE,QAAQ;oBACf,IAAI,EAAE,iBAAiB;iBACxB,CAAC;SACH,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,GAAG,GAAgC;YACvC,IAAI,EAAE,2BAA2B;YACjC,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;SAC7B,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,GAAG,GAAuB;YAC9B,IAAI,EAAE,kBAAkB;YACxB,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SAC1D,CAAC;QACF,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/constants.d.ts

@@ -23,7 +23,7 @@ export declare const WS_CLOSE_SERVER_SHUTDOWN = 4005;
  * track lastOutputAt explicitly (PR2), keep the threshold generous.
  */
 export declare const STUCK_STREAMING_THRESHOLD_MS: number;
-export declare const BACKEND_TYPES: readonly ["claude-code", "openclaw", "codex"];
+export declare const BACKEND_TYPES: readonly ["claude", "codex", "openclaw"];
 export type BackendType = (typeof BACKEND_TYPES)[number];
 export declare const USER_ROLES: readonly ["admin", "user"];
 export type UserRole = (typeof USER_ROLES)[number];

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,oCAAoC;AACpC,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAE1C,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAIvC,+BAA+B;AAC/B,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,2BAA2B;AAC3B,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,yCAAyC;AACzC,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,2BAA2B;AAC3B,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,QAAgB,CAAC;AAI1D,eAAO,MAAM,aAAa,+CAAgD,CAAC;AAC3E,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAIzD,eAAO,MAAM,UAAU,4BAA6B,CAAC;AACrD,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAInD,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAI/C,eAAO,MAAM,aAAa,0CAA2C,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAIzD,eAAO,MAAM,aAAa,mEAAoE,CAAC;AAC/F,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAIzD,eAAO,MAAM,cAAc,gCAAiC,CAAC;AAC7D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,uEAAuE;AACvE,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAE5C,oCAAoC;AACpC,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AAE1C,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAIvC,+BAA+B;AAC/B,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C,2BAA2B;AAC3B,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,yCAAyC;AACzC,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,2BAA2B;AAC3B,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C;;;;;;;GAOG;AACH,eAAO,MAAM,4BAA4B,QAAgB,CAAC;AAO1D,eAAO,MAAM,aAAa,0CAA2C,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAIzD,eAAO,MAAM,UAAU,4BAA6B,CAAC;AACrD,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAInD,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAI/C,eAAO,MAAM,aAAa,0CAA2C,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAIzD,eAAO,MAAM,aAAa,mEAAoE,CAAC;AAC/F,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAIzD,eAAO,MAAM,cAAc,gCAAiC,CAAC;AAC7D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/constants.js

@@ -26,7 +26,10 @@ export const WS_CLOSE_SERVER_SHUTDOWN = 4005;
  */
 export const STUCK_STREAMING_THRESHOLD_MS = 5 * 60 * 1000;
 // ── Backend Types ────────────────────────────────────────────────────
-export const BACKEND_TYPES = ["claude-code", "openclaw", "codex"];
+// N1.T9 migration: backend_type column values are now 'claude' | 'codex' | 'openclaw'
+// (DB CHECK constraint added in drizzle/0012). Legacy 'claude-code' rows were
+// UPDATEd to 'claude' by the same migration.
+export const BACKEND_TYPES = ["claude", "codex", "openclaw"];
 // ── User Roles ───────────────────────────────────────────────────────
 export const USER_ROLES = ["admin", "user"];
 // ── Feature Flags ───────────────────────────────────────────────────

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC,uEAAuE;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAE5C,oCAAoC;AACpC,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAE1C,0DAA0D;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC,wEAAwE;AAExE,+BAA+B;AAC/B,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,2BAA2B;AAC3B,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAE1C,yCAAyC;AACzC,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,2BAA2B;AAC3B,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAE1D,wEAAwE;AAExE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC;AAG3E,wEAAwE;AAExE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,CAAU,CAAC;AAGrD,uEAAuE;AAEvE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAE/C,wEAAwE;AAExE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAU,CAAC;AAGtE,wEAAwE;AAExE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC;AAG/F,wEAAwE;AAExE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAU,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC,uEAAuE;AACvE,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAE5C,oCAAoC;AACpC,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,CAAC;AAE1C,0DAA0D;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEvC,wEAAwE;AAExE,+BAA+B;AAC/B,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAE3C,2BAA2B;AAC3B,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAE1C,yCAAyC;AACzC,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C,2BAA2B;AAC3B,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC;AAE7C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;AAE1D,wEAAwE;AAExE,sFAAsF;AACtF,8EAA8E;AAC9E,6CAA6C;AAC7C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC;AAGtE,wEAAwE;AAExE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,CAAU,CAAC;AAGrD,uEAAuE;AAEvE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAE/C,wEAAwE;AAExE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAU,CAAC;AAGtE,wEAAwE;AAExE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,CAAU,CAAC;AAG/F,wEAAwE;AAExE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAU,CAAC"}

package/dist/encode-cwd.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Pure string transform that encodes an absolute path into a single-segment
+ * identifier ClawNet uses for per-project directories (e.g.
+ * `~/.clawnet/projects/<encodedCwd>/...`).
+ *
+ *   POSIX: /Users/lcf/code/foo  → -Users-lcf-code-foo
+ *   Win32: C:\Users\lcf\code\foo → C--Users-lcf-code-foo  (colon and \ both → -)
+ *          \\server\share\path  → --server-share-path
+ *
+ * Lives in @mclawnet/shared (browser-safe, no node:os/fs deps) so both the
+ * node-side @mclawnet/task and the browser-side UI can use the same encoding
+ * without drift. @mclawnet/task re-exports it; UI imports it directly.
+ */
+export declare function encodeCwd(absPath: string): string;
+//# sourceMappingURL=encode-cwd.d.ts.map

package/dist/encode-cwd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode-cwd.d.ts","sourceRoot":"","sources":["../src/encode-cwd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAajD"}

package/dist/encode-cwd.js

@@ -0,0 +1,27 @@
+/**
+ * Pure string transform that encodes an absolute path into a single-segment
+ * identifier ClawNet uses for per-project directories (e.g.
+ * `~/.clawnet/projects/<encodedCwd>/...`).
+ *
+ *   POSIX: /Users/lcf/code/foo  → -Users-lcf-code-foo
+ *   Win32: C:\Users\lcf\code\foo → C--Users-lcf-code-foo  (colon and \ both → -)
+ *          \\server\share\path  → --server-share-path
+ *
+ * Lives in @mclawnet/shared (browser-safe, no node:os/fs deps) so both the
+ * node-side @mclawnet/task and the browser-side UI can use the same encoding
+ * without drift. @mclawnet/task re-exports it; UI imports it directly.
+ */
+export function encodeCwd(absPath) {
+    const isPosix = absPath.startsWith("/");
+    const isWin = /^[a-zA-Z]:[\\/]/.test(absPath) || absPath.startsWith("\\\\");
+    if (!isPosix && !isWin) {
+        throw new Error(`encodeCwd requires an absolute path, got: ${absPath}`);
+    }
+    // Trim a single trailing slash/backslash (but never reduce a root to empty).
+    const trimmed = absPath.length > 1 && (absPath.endsWith("/") || absPath.endsWith("\\"))
+        ? absPath.slice(0, -1)
+        : absPath;
+    // Replace path separators and the Windows drive colon with a dash.
+    return trimmed.replace(/[\\/:]/g, "-");
+}
+//# sourceMappingURL=encode-cwd.js.map

package/dist/encode-cwd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encode-cwd.js","sourceRoot":"","sources":["../src/encode-cwd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5E,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,6CAA6C,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,6EAA6E;IAC7E,MAAM,OAAO,GACX,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACtB,CAAC,CAAC,OAAO,CAAC;IACd,mEAAmE;IACnE,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC"}

package/dist/index.d.ts

@@ -3,4 +3,7 @@ export * from "./schemas.js";
 export * from "./types/index.js";
 export * from "./protocol/index.js";
 export * from "./token-ladder.js";
+export * from "./encode-cwd.js";
+export * from "./sandbox.js";
+export * from "./model-catalog.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -4,4 +4,7 @@ export * from "./schemas.js";
 export * from "./types/index.js";
 export * from "./protocol/index.js";
 export * from "./token-ladder.js";
+export * from "./encode-cwd.js";
+export * from "./sandbox.js";
+export * from "./model-catalog.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/dist/model-catalog.d.ts

@@ -0,0 +1,53 @@
+export interface ModelDescriptor {
+    /** Stable wire code, e.g. "opus", "sonnet", "gpt-5". */
+    code: string;
+    /** Human-readable label for UI, e.g. "Claude Opus 4". */
+    label: string;
+    /** Optional one-line description. */
+    description?: string;
+    /** Capability tier hint for grouping in pickers. */
+    tier?: "premium" | "standard" | "lite";
+    /** Context window in tokens, if known. */
+    contextWindow?: number;
+    /** True if this model accepts images. */
+    supportsVision?: boolean;
+    /** True if this model accepts tool/function calls. */
+    supportsToolUse?: boolean;
+    /** True if this is the backend's default pick. At most one per backend. */
+    default?: boolean;
+}
+export interface ModeDescriptor {
+    /** Stable wire code, e.g. "default", "plan", "build". */
+    code: string;
+    /** Human-readable label for UI. */
+    label: string;
+    /** Optional one-line description. */
+    description?: string;
+    /** True if this is the backend's default pick. At most one per backend. */
+    default?: boolean;
+}
+/**
+ * Active backend kinds for new sessions. Intentionally excludes 'openclaw'
+ * (legacy, no longer accepting new sessions) which the DB CHECK constraint
+ * in chat_sessions still permits for historical rows. Hub readers that
+ * encounter backend_type='openclaw' on a legacy row should treat it as
+ * read-only history, not as a manifest-eligible kind.
+ */
+export type BackendKind = "claude" | "codex";
+export interface BackendManifestEntry {
+    kind: BackendKind;
+    /** False ⇒ binary not present / unusable; models/modes will be empty. */
+    installed: boolean;
+    binaryPath?: string;
+    version?: string;
+    /** Populated when `installed === false`, e.g. "not on PATH". */
+    unavailableReason?: string;
+    models: ModelDescriptor[];
+    modes: ModeDescriptor[];
+}
+export interface AgentManifestPayload {
+    /** Schema version; bump when wire shape changes incompatibly. */
+    manifestVersion: 1;
+    backends: BackendManifestEntry[];
+}
+//# sourceMappingURL=model-catalog.d.ts.map

package/dist/model-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.d.ts","sourceRoot":"","sources":["../src/model-catalog.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACvC,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sDAAsD;IACtD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7C,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,WAAW,CAAC;IAClB,yEAAyE;IACzE,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,iEAAiE;IACjE,eAAe,EAAE,CAAC,CAAC;IACnB,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC"}

package/dist/model-catalog.js

@@ -0,0 +1,5 @@
+// Cross-package descriptors for backend capabilities (models + modes) reported
+// by an agent to the hub. Used by `agent.manifest` wire frame and stored in
+// `agents.manifest_json` (DB).
+export {};
+//# sourceMappingURL=model-catalog.js.map

package/dist/model-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-catalog.js","sourceRoot":"","sources":["../src/model-catalog.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,4EAA4E;AAC5E,+BAA+B"}