@manifesto-ai/sdk 1.1.0 → 1.2.1

package/README.md

@@ -81,21 +81,13 @@ SDK re-exports public contract types and errors (for example `AppConfig`, `AppSt
 | Delegates to | `@manifesto-ai/runtime` | All orchestration via runtime pipeline |
 | Uses | `@manifesto-ai/core` | Schema and expression types |
 | Uses | `@manifesto-ai/world` | World protocol types |
-| Legacy predecessor | `@manifesto-ai/app` | Deprecated compatibility facade (R1), scheduled for removal in R2 |
+| Legacy predecessor | App facade package | Removed in R2 (see API retirement record) |
 
 ---
 
-## Migration from @manifesto-ai/app
+## Migration from Legacy App Facade
 
-`@manifesto-ai/app` imports should be replaced with `@manifesto-ai/sdk`.
-
-```typescript
-// Before
-import { createApp } from "@manifesto-ai/app";
-
-// After
-import { createApp } from "@manifesto-ai/sdk";
-```
+Legacy app-facade imports should be replaced with `@manifesto-ai/sdk`.
 
 For automated rewrite guidance, see:
 - [docs/guides/migrate-app-to-sdk.md](../../docs/guides/migrate-app-to-sdk.md)

package/dist/__tests__/public-exports.test.js

@@ -37,6 +37,7 @@ describe('sdk public exports contract', () => {
             'createAppRef',
             'createHookContext',
             'createTestApp',
+            'defineOps',
         ].sort();
         expect(exportedKeys).toEqual(expectedKeys);
     });

package/dist/__tests__/public-exports.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"public-exports.test.js","sourceRoot":"","sources":["../../src/__tests__/public-exports.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AAEnC,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAE7C,MAAM,YAAY,GAAG;YACnB,mBAAmB;YACnB,qBAAqB;YACrB,wBAAwB;YACxB,qBAAqB;YACrB,oBAAoB;YACpB,kBAAkB;YAClB,kBAAkB;YAClB,YAAY;YACZ,yBAAyB;YACzB,qBAAqB;YACrB,oBAAoB;YACpB,qBAAqB;YACrB,iBAAiB;YACjB,mBAAmB;YACnB,cAAc;YACd,UAAU;YACV,cAAc;YACd,mBAAmB;YACnB,qBAAqB;YACrB,0BAA0B;YAC1B,iBAAiB;YACjB,yBAAyB;YACzB,wBAAwB;YACxB,6BAA6B;YAC7B,2BAA2B;YAC3B,0BAA0B;YAC1B,oBAAoB;YACpB,wBAAwB;YACxB,8BAA8B;YAC9B,WAAW;YACX,cAAc;YACd,mBAAmB;YACnB,eAAe;SAChB,CAAC,IAAI,EAAE,CAAC;QAET,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,SAAS,GAAG;YAChB,2BAA2B;YAC3B,2BAA2B;YAC3B,4BAA4B;YAC5B,0BAA0B;YAC1B,eAAe;YACf,6BAA6B;YAC7B,wBAAwB;SACzB,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,MAAM,CAAE,GAA+B,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAChE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"public-exports.test.js","sourceRoot":"","sources":["../../src/__tests__/public-exports.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,KAAK,GAAG,MAAM,aAAa,CAAC;AAEnC,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAE7C,MAAM,YAAY,GAAG;YACnB,mBAAmB;YACnB,qBAAqB;YACrB,wBAAwB;YACxB,qBAAqB;YACrB,oBAAoB;YACpB,kBAAkB;YAClB,kBAAkB;YAClB,YAAY;YACZ,yBAAyB;YACzB,qBAAqB;YACrB,oBAAoB;YACpB,qBAAqB;YACrB,iBAAiB;YACjB,mBAAmB;YACnB,cAAc;YACd,UAAU;YACV,cAAc;YACd,mBAAmB;YACnB,qBAAqB;YACrB,0BAA0B;YAC1B,iBAAiB;YACjB,yBAAyB;YACzB,wBAAwB;YACxB,6BAA6B;YAC7B,2BAA2B;YAC3B,0BAA0B;YAC1B,oBAAoB;YACpB,wBAAwB;YACxB,8BAA8B;YAC9B,WAAW;YACX,cAAc;YACd,mBAAmB;YACnB,eAAe;YACf,WAAW;SACZ,CAAC,IAAI,EAAE,CAAC;QAET,MAAM,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,SAAS,GAAG;YAChB,2BAA2B;YAC3B,2BAA2B;YAC3B,4BAA4B;YAC5B,0BAA0B;YAC1B,eAAe;YACf,6BAA6B;YAC7B,wBAAwB;SACzB,CAAC;QAEF,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,MAAM,CAAE,GAA+B,CAAC,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAChE,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/typed-ops-scenarios.test.d.ts

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

package/dist/__tests__/typed-ops-scenarios.test.d.ts.map

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

package/dist/__tests__/typed-ops-scenarios.test.js

@@ -0,0 +1,334 @@
+/**
+ * Typed Ops Usage Pattern Simulation
+ *
+ * Tests real-world usage patterns and edge cases to verify type-level
+ * correctness before shipping to users.
+ */
+import { describe, it, expect, expectTypeOf } from "vitest";
+import { defineOps } from "../typed-ops.js";
+describe("Scenario 1: Todo App", () => {
+    const ops = defineOps();
+    it("should set primitive fields", () => {
+        const p1 = ops.set("count", 10);
+        expect(p1).toEqual({ op: "set", path: "count", value: 10 });
+        const p2 = ops.set("filter", "active");
+        expect(p2).toEqual({ op: "set", path: "filter", value: "active" });
+    });
+    it("should replace entire array", () => {
+        const newTodos = [
+            { id: "1", title: "Test", completed: false },
+        ];
+        const p = ops.set("todos", newTodos);
+        expect(p).toEqual({ op: "set", path: "todos", value: newTodos });
+    });
+    it("should NOT allow merge on primitive or array fields", () => {
+        expectTypeOf().not.toMatchTypeOf();
+        expectTypeOf().not.toMatchTypeOf();
+        expectTypeOf().not.toMatchTypeOf();
+    });
+    it("should work in effect handler return pattern", () => {
+        const handler = async () => {
+            return [
+                ops.set("count", 5),
+                ops.set("filter", "completed"),
+            ];
+        };
+        expectTypeOf(handler).returns.resolves.toMatchTypeOf();
+    });
+    it("should NOT generate nested paths for array items", () => {
+        expectTypeOf().not.toMatchTypeOf();
+        expectTypeOf().not.toMatchTypeOf();
+    });
+});
+describe("Scenario 2: E-commerce (deep nesting)", () => {
+    const ops = defineOps();
+    it("should autocomplete paths up to 3 levels of nesting", () => {
+        // root
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        // 1 level nested
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        // 2 levels nested
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+    });
+    it("should type-check values at nested paths", () => {
+        const p1 = ops.set("customer.address.city", "Seoul");
+        expect(p1.value).toBe("Seoul");
+        const p2 = ops.set("customer.preferences.theme", "dark");
+        expect(p2.value).toBe("dark");
+        const p3 = ops.set("status", "checkout");
+        expect(p3.value).toBe("checkout");
+    });
+    it("should merge at object paths only", () => {
+        const p1 = ops.merge("customer.address", { city: "Busan", zip: "12345" });
+        expect(p1).toEqual({
+            op: "merge",
+            path: "customer.address",
+            value: { city: "Busan", zip: "12345" },
+        });
+        const p2 = ops.merge("customer.preferences", { newsletter: true });
+        expect(p2).toEqual({
+            op: "merge",
+            path: "customer.preferences",
+            value: { newsletter: true },
+        });
+        const p3 = ops.merge("customer", { name: "Kim" });
+        expect(p3.value).toEqual({ name: "Kim" });
+    });
+    it("should handle null union fields", () => {
+        const p1 = ops.set("error", "Payment failed");
+        expect(p1.value).toBe("Payment failed");
+        const p2 = ops.set("error", null);
+        expect(p2.value).toBeNull();
+    });
+});
+describe("Scenario 3: Optional fields", () => {
+    const ops = defineOps();
+    it("should handle optional primitive fields", () => {
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+    });
+    it("should handle optional object fields and their nested paths", () => {
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+    });
+    it("should type-check optional field values correctly", () => {
+        const p1 = ops.set("bio", "Hello world");
+        expect(p1.value).toBe("Hello world");
+        const p2 = ops.set("avatar", { url: "https://example.com/a.png", width: 100, height: 100 });
+        expect(p2.value).toEqual({ url: "https://example.com/a.png", width: 100, height: 100 });
+    });
+    it("should allow merge on optional object paths", () => {
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        const p = ops.merge("avatar", { url: "https://new.com/b.png" });
+        expect(p.value).toEqual({ url: "https://new.com/b.png" });
+    });
+    it("should exclude undefined from set() for optional fields", () => {
+        expectTypeOf().toMatchTypeOf(); // ValueAt still includes undefined
+        // But the set() method signature rejects it:
+        // ops.set("bio", undefined)  →  TS compile error
+        // ops.unset("bio")           →  correct way to clear
+        const p = ops.set("bio", "Hello");
+        expect(p.value).toBe("Hello");
+    });
+});
+describe("Scenario 4: Effect handler pattern", () => {
+    const ops = defineOps();
+    it("should build success patch sequence", () => {
+        const now = "2026-02-19T00:00:00Z";
+        const items = ["a", "b", "c"];
+        const patches = [
+            ops.set("data.items", items),
+            ops.set("data.lastSync", now),
+            ops.set("syncStatus", "success"),
+            ops.set("errorMessage", null),
+        ];
+        expect(patches).toHaveLength(4);
+        expect(patches[0]).toEqual({ op: "set", path: "data.items", value: items });
+        expect(patches[2]).toEqual({ op: "set", path: "syncStatus", value: "success" });
+    });
+    it("should build error patch sequence", () => {
+        const patches = [
+            ops.set("syncStatus", "error"),
+            ops.set("errorMessage", "Network timeout"),
+            ops.set("retryCount", 3),
+        ];
+        expect(patches).toHaveLength(3);
+    });
+    it("should merge data object partially", () => {
+        const p = ops.merge("data", { lastSync: "2026-02-19T12:00:00Z" });
+        expect(p).toEqual({
+            op: "merge",
+            path: "data",
+            value: { lastSync: "2026-02-19T12:00:00Z" },
+        });
+    });
+    it("should create error convenience patch", () => {
+        const p = ops.error("SYNC_FAILED", "API returned 500", { context: { endpoint: "/api/items" } });
+        expect(p.op).toBe("set");
+        expect(p.path).toBe("system.lastError");
+    });
+    it("should create error patch with source metadata", () => {
+        const p = ops.error("SYNC_FAILED", "API returned 500", {
+            source: { actionId: "sync-action", nodePath: "sync.fetch" },
+            timestamp: Date.now(),
+            context: { endpoint: "/api/items" },
+        });
+        expect(p.op).toBe("set");
+        expect(p.value.code).toBe("SYNC_FAILED");
+        expect(p.value.source.actionId).toBe("sync-action");
+    });
+});
+describe("Scenario 5: raw escape hatch", () => {
+    const ops = defineOps();
+    it("should allow platform namespace paths via raw", () => {
+        const p1 = ops.raw.set("$host.intentSlots", { slot1: "value" });
+        expect(p1.path).toBe("$host.intentSlots");
+        const p2 = ops.raw.merge("$host.config", { debug: true });
+        expect(p2.path).toBe("$host.config");
+    });
+    it("should allow system paths via raw", () => {
+        const p = ops.raw.set("system.status", "idle");
+        expect(p).toEqual({ op: "set", path: "system.status", value: "idle" });
+    });
+    it("should allow input paths via raw", () => {
+        const p = ops.raw.set("input.amount", 100);
+        expect(p).toEqual({ op: "set", path: "input.amount", value: 100 });
+    });
+    it("should allow array item access via raw", () => {
+        const todoOps = defineOps();
+        // Typed API only allows whole-array replacement
+        const p1 = todoOps.set("todos", [{ id: "1", title: "a", completed: false }]);
+        expect(p1.op).toBe("set");
+        // Raw allows individual item access
+        const p2 = todoOps.raw.set("todos.0.completed", true);
+        expect(p2).toEqual({ op: "set", path: "todos.0.completed", value: true });
+    });
+});
+describe("Scenario 6: Flat state (no nesting)", () => {
+    const ops = defineOps();
+    it("should have only top-level paths", () => {
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+    });
+    it("should have no mergeable paths (all primitives)", () => {
+        expectTypeOf().not.toMatchTypeOf();
+        expectTypeOf().not.toMatchTypeOf();
+        expectTypeOf().not.toMatchTypeOf();
+    });
+    it("should create correct patches", () => {
+        expect(ops.set("a", "hello")).toEqual({ op: "set", path: "a", value: "hello" });
+        expect(ops.set("b", 42)).toEqual({ op: "set", path: "b", value: 42 });
+        expect(ops.set("c", true)).toEqual({ op: "set", path: "c", value: true });
+        expect(ops.unset("a")).toEqual({ op: "unset", path: "a" });
+    });
+});
+describe("Scenario 7: Record<string, T> fields", () => {
+    const ops = defineOps();
+    it("should include Record field as a valid path", () => {
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+    });
+    it("should NOT generate sub-paths for Record<string, T> fields", () => {
+        expectTypeOf().not.toMatchTypeOf();
+        expectTypeOf().not.toMatchTypeOf();
+    });
+    it("should still resolve Record sub-path value type via ValueAt", () => {
+        expectTypeOf().toEqualTypeOf();
+    });
+    it("should allow merge on Record fields", () => {
+        const p = ops.merge("widgets", {
+            widget1: { title: "Chart", visible: true },
+        });
+        expect(p).toEqual({
+            op: "merge",
+            path: "widgets",
+            value: { widget1: { title: "Chart", visible: true } },
+        });
+    });
+    it("should allow set to replace entire Record", () => {
+        const p = ops.set("widgets", {
+            w1: { title: "A", visible: true },
+            w2: { title: "B", visible: false },
+        });
+        expect(p.op).toBe("set");
+    });
+});
+describe("Scenario 8: Depth limit (D=3)", () => {
+    it("should resolve up to root + 3 levels of nesting (4 segments)", () => {
+        expectTypeOf().toMatchTypeOf(); // 1 segment
+        expectTypeOf().toMatchTypeOf(); // 2 segments
+        expectTypeOf().toMatchTypeOf(); // 3 segments
+        expectTypeOf().toMatchTypeOf(); // 4 segments (limit)
+    });
+    it("should NOT resolve beyond 4 segments", () => {
+        // 5 segments → blocked by depth limit
+        expectTypeOf().not.toMatchTypeOf();
+        // 6 segments → also blocked
+        expectTypeOf().not.toMatchTypeOf();
+    });
+    it("should still allow raw for deep paths beyond limit", () => {
+        const ops = defineOps();
+        const p = ops.raw.set("a.b.c.d.e.value", "deep");
+        expect(p.value).toBe("deep");
+    });
+});
+describe("Scenario 9: Multiple instances isolation", () => {
+    it("should not leak paths between instances", () => {
+        const opsA = defineOps();
+        const opsB = defineOps();
+        const pA = opsA.set("x", 42);
+        expect(pA.value).toBe(42);
+        const pB = opsB.set("y", "hello");
+        expect(pB.value).toBe("hello");
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().not.toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().not.toMatchTypeOf();
+    });
+});
+// ============================================================================
+// Scenario 10: Patch[] accumulation pattern
+// ============================================================================
+describe("Scenario 10: Batch accumulation", () => {
+    const ops = defineOps();
+    it("should accumulate heterogeneous patches in array", () => {
+        const patches = [];
+        patches.push(ops.set("status", "checkout"));
+        patches.push(ops.merge("customer", { email: "new@test.com" }));
+        patches.push(ops.unset("error"));
+        patches.push(ops.set("total", 99.99));
+        expect(patches).toHaveLength(4);
+        expect(patches.map((p) => p.op)).toEqual(["set", "merge", "unset", "set"]);
+    });
+});
+// ============================================================================
+// Scenario 11: ValueAt edge cases
+// ============================================================================
+describe("Scenario 11: ValueAt edge cases", () => {
+    it("should resolve nullable types", () => {
+        expectTypeOf().toEqualTypeOf();
+    });
+    it("should resolve union literal types", () => {
+        expectTypeOf().toEqualTypeOf();
+    });
+    it("should resolve array types as-is", () => {
+        expectTypeOf().toEqualTypeOf();
+    });
+    it("should return never for invalid paths", () => {
+        expectTypeOf().toEqualTypeOf();
+    });
+});
+describe("Scenario 12: Reserved snapshot root exclusion", () => {
+    const ops = defineOps();
+    it("should allow non-reserved paths", () => {
+        const p1 = ops.set("count", 42);
+        expect(p1).toEqual({ op: "set", path: "count", value: 42 });
+        const p2 = ops.set("safe.nested", "hello");
+        expect(p2).toEqual({ op: "set", path: "safe.nested", value: "hello" });
+    });
+    it("should exclude reserved root paths from DataPaths", () => {
+        // DataPaths itself still generates these (it's generic)
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        // But TypedOps interface filters them — verified by:
+        // ops.set("system", ...) → TS error
+        // ops.set("system.foo", ...) → TS error
+        // Users should use raw for reserved namespace access.
+    });
+    it("should allow reserved path access via raw escape hatch", () => {
+        const p = ops.raw.set("system.status", "idle");
+        expect(p).toEqual({ op: "set", path: "system.status", value: "idle" });
+    });
+    it("should not filter reserved names in nested positions", () => {
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+    });
+});
+//# sourceMappingURL=typed-ops-scenarios.test.js.map

package/dist/__tests__/typed-ops-scenarios.test.js.map

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

package/dist/__tests__/typed-ops.test.d.ts

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

package/dist/__tests__/typed-ops.test.d.ts.map

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

package/dist/__tests__/typed-ops.test.js

@@ -0,0 +1,210 @@
+import { describe, it, expect, expectTypeOf } from "vitest";
+import { defineOps } from "../typed-ops.js";
+// ============================================================================
+// Compile-Time Type Tests
+// ============================================================================
+describe("Type-level: DataPaths", () => {
+    it("should include top-level keys", () => {
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+    });
+    it("should include nested object paths", () => {
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+    });
+    it("should NOT include invalid paths", () => {
+        expectTypeOf().not.toMatchTypeOf();
+        expectTypeOf().not.toMatchTypeOf();
+        expectTypeOf().not.toMatchTypeOf();
+    });
+});
+describe("Type-level: ValueAt", () => {
+    it("should resolve top-level field types", () => {
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
+    });
+    it("should resolve nested field types", () => {
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
+    });
+    it("should resolve object types", () => {
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
+    });
+});
+describe("Type-level: ObjectPaths", () => {
+    it("should include plain object paths", () => {
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+    });
+    it("should exclude primitive and array paths", () => {
+        expectTypeOf().not.toMatchTypeOf();
+        expectTypeOf().not.toMatchTypeOf();
+        expectTypeOf().not.toMatchTypeOf();
+        expectTypeOf().not.toMatchTypeOf();
+        expectTypeOf().not.toMatchTypeOf();
+        expectTypeOf().not.toMatchTypeOf();
+    });
+});
+// ============================================================================
+// Runtime Tests
+// ============================================================================
+describe("defineOps", () => {
+    const ops = defineOps();
+    describe("set", () => {
+        it("should create a set patch for a top-level field", () => {
+            const patch = ops.set("count", 42);
+            expect(patch).toEqual({ op: "set", path: "count", value: 42 });
+        });
+        it("should create a set patch for a nested field", () => {
+            const patch = ops.set("user.name", "Alice");
+            expect(patch).toEqual({ op: "set", path: "user.name", value: "Alice" });
+        });
+        it("should create a set patch for an enum field", () => {
+            const patch = ops.set("filter", "active");
+            expect(patch).toEqual({ op: "set", path: "filter", value: "active" });
+        });
+        it("should create a set patch for a deeply nested field", () => {
+            const patch = ops.set("user.address.city", "Seoul");
+            expect(patch).toEqual({
+                op: "set",
+                path: "user.address.city",
+                value: "Seoul",
+            });
+        });
+        it("should create a set patch for an array field", () => {
+            const todos = [{ title: "test", completed: false }];
+            const patch = ops.set("todos", todos);
+            expect(patch).toEqual({ op: "set", path: "todos", value: todos });
+        });
+        it("should return SetPatch type", () => {
+            const patch = ops.set("count", 1);
+            expectTypeOf(patch).toEqualTypeOf();
+        });
+    });
+    describe("unset", () => {
+        it("should create an unset patch", () => {
+            const patch = ops.unset("count");
+            expect(patch).toEqual({ op: "unset", path: "count" });
+        });
+        it("should create an unset patch for nested field", () => {
+            const patch = ops.unset("user.name");
+            expect(patch).toEqual({ op: "unset", path: "user.name" });
+        });
+        it("should return UnsetPatch type", () => {
+            const patch = ops.unset("count");
+            expectTypeOf(patch).toEqualTypeOf();
+        });
+    });
+    describe("merge", () => {
+        it("should create a merge patch for an object field", () => {
+            const patch = ops.merge("user", { name: "Bob" });
+            expect(patch).toEqual({
+                op: "merge",
+                path: "user",
+                value: { name: "Bob" },
+            });
+        });
+        it("should create a merge patch for a nested object", () => {
+            const patch = ops.merge("user.address", { city: "Busan" });
+            expect(patch).toEqual({
+                op: "merge",
+                path: "user.address",
+                value: { city: "Busan" },
+            });
+        });
+        it("should return MergePatch type", () => {
+            const patch = ops.merge("user", { age: 30 });
+            expectTypeOf(patch).toEqualTypeOf();
+        });
+    });
+    describe("error", () => {
+        it("should create a system.lastError set patch", () => {
+            const patch = ops.error("VALIDATION", "Field required");
+            expect(patch).toEqual({
+                op: "set",
+                path: "system.lastError",
+                value: {
+                    code: "VALIDATION",
+                    message: "Field required",
+                    source: { actionId: "", nodePath: "" },
+                    timestamp: 0,
+                },
+            });
+        });
+        it("should include context when provided", () => {
+            const patch = ops.error("API_ERROR", "Timeout", { context: { endpoint: "/api/v1" } });
+            expect(patch.value).toEqual(expect.objectContaining({
+                code: "API_ERROR",
+                context: { endpoint: "/api/v1" },
+            }));
+        });
+        it("should accept source and timestamp overrides", () => {
+            const patch = ops.error("SYNC_FAIL", "Timeout", {
+                source: { actionId: "act-1", nodePath: "sync.run" },
+                timestamp: 1700000000,
+            });
+            expect(patch.value).toEqual(expect.objectContaining({
+                code: "SYNC_FAIL",
+                source: { actionId: "act-1", nodePath: "sync.run" },
+                timestamp: 1700000000,
+            }));
+        });
+        it("should return SetPatch type", () => {
+            const patch = ops.error("CODE", "msg");
+            expectTypeOf(patch).toEqualTypeOf();
+        });
+    });
+    describe("raw", () => {
+        it("should create untyped set patch", () => {
+            const patch = ops.raw.set("$host.custom", { key: "value" });
+            expect(patch).toEqual({
+                op: "set",
+                path: "$host.custom",
+                value: { key: "value" },
+            });
+        });
+        it("should create untyped unset patch", () => {
+            const patch = ops.raw.unset("$host.temp");
+            expect(patch).toEqual({ op: "unset", path: "$host.temp" });
+        });
+        it("should create untyped merge patch", () => {
+            const patch = ops.raw.merge("$host.config", { enabled: true });
+            expect(patch).toEqual({
+                op: "merge",
+                path: "$host.config",
+                value: { enabled: true },
+            });
+        });
+    });
+    describe("integration with apply()", () => {
+        it("should produce patches compatible with Core apply", () => {
+            const patches = [
+                ops.set("count", 10),
+                ops.set("user.name", "Charlie"),
+                ops.merge("user.address", { zip: "12345" }),
+            ];
+            // Verify all patches have valid structure
+            for (const patch of patches) {
+                expect(patch).toHaveProperty("op");
+                expect(patch).toHaveProperty("path");
+                expect(typeof patch.path).toBe("string");
+                expect(patch.path.length).toBeGreaterThan(0);
+            }
+        });
+    });
+});
+//# sourceMappingURL=typed-ops.test.js.map

package/dist/__tests__/typed-ops.test.js.map

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

package/dist/index.d.ts

@@ -18,4 +18,6 @@ export { HookableImpl } from './hooks/index.js';
 export type { HookState } from './hooks/index.js';
 export { JobQueue } from './hooks/index.js';
 export { HookContextImpl, createHookContext } from './hooks/index.js';
+export { defineOps } from './typed-ops.js';
+export type { TypedOps, DataPaths, ValueAt, ObjectPaths } from './typed-ops.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":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD,YAAY,EAEV,SAAS,EACT,WAAW,EACX,WAAW,EAGX,WAAW,EAGX,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,6BAA6B,EAC7B,cAAc,EAGd,YAAY,EACZ,kBAAkB,EAGlB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,cAAc,EAGd,QAAQ,EACR,WAAW,EACX,YAAY,EAGZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,wBAAwB,EAGxB,aAAa,EACb,gBAAgB,EAChB,WAAW,EAGX,GAAG,EACH,YAAY,EACZ,MAAM,EACN,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,QAAQ,EACR,WAAW,EACX,cAAc,EAGd,SAAS,EAGT,QAAQ,EAGR,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EAGX,WAAW,EAGX,SAAS,EACT,MAAM,EACN,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,OAAO,EACP,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,MAAM,EACN,yBAAyB,EACzB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,KAAK,EACL,OAAO,EACP,QAAQ,EACR,KAAK,EACL,SAAS,EAGT,OAAO,EACP,gBAAgB,EAChB,aAAa,EAGb,UAAU,EAGV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAEL,iBAAiB,EAGjB,gBAAgB,EAChB,gBAAgB,EAGhB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EAGnB,iBAAiB,EAGjB,uBAAuB,EAGvB,yBAAyB,EACzB,wBAAwB,EAGxB,mBAAmB,EAGnB,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,sBAAsB,EAGtB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EAGf,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAM3D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAMxC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD,YAAY,EAEV,SAAS,EACT,WAAW,EACX,WAAW,EAGX,WAAW,EAGX,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,6BAA6B,EAC7B,cAAc,EAGd,YAAY,EACZ,kBAAkB,EAGlB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,WAAW,EACX,UAAU,EACV,WAAW,EACX,cAAc,EACd,gBAAgB,EAChB,cAAc,EAGd,QAAQ,EACR,WAAW,EACX,YAAY,EAGZ,eAAe,EACf,cAAc,EACd,aAAa,EACb,YAAY,EACZ,wBAAwB,EAGxB,aAAa,EACb,gBAAgB,EAChB,WAAW,EAGX,GAAG,EACH,YAAY,EACZ,MAAM,EACN,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,QAAQ,EACR,WAAW,EACX,cAAc,EAGd,SAAS,EAGT,QAAQ,EAGR,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EAGX,WAAW,EAGX,SAAS,EACT,MAAM,EACN,QAAQ,EACR,cAAc,EACd,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,OAAO,EACP,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,MAAM,EACN,yBAAyB,EACzB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,KAAK,EACL,OAAO,EACP,QAAQ,EACR,KAAK,EACL,SAAS,EAGT,OAAO,EACP,gBAAgB,EAChB,aAAa,EAGb,UAAU,EAGV,OAAO,GACR,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAEL,iBAAiB,EAGjB,gBAAgB,EAChB,gBAAgB,EAGhB,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EAGnB,iBAAiB,EAGjB,uBAAuB,EAGvB,yBAAyB,EACzB,wBAAwB,EAGxB,mBAAmB,EAGnB,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,sBAAsB,EAGtB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EAGf,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAM/B,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAM3D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAMxC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAMtE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -46,4 +46,8 @@ export { AppRefImpl, createAppRef } from './hooks/index.js';
 export { HookableImpl } from './hooks/index.js';
 export { JobQueue } from './hooks/index.js';
 export { HookContextImpl, createHookContext } from './hooks/index.js';
+// =============================================================================
+// Typed Patch Operations
+// =============================================================================
+export { defineOps } from './typed-ops.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;;;;;;;;GAQG;AA2HH,gFAAgF;AAChF,2CAA2C;AAC3C,gFAAgF;AAEhF,OAAO;AACL,OAAO;AACP,iBAAiB;AAEjB,YAAY;AACZ,gBAAgB,EAChB,gBAAgB;AAEhB,SAAS;AACT,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB;AAEnB,OAAO;AACP,iBAAiB;AAEjB,UAAU;AACV,uBAAuB;AAEvB,SAAS;AACT,yBAAyB,EACzB,wBAAwB;AAExB,SAAS;AACT,mBAAmB;AAEnB,eAAe;AACf,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,sBAAsB;AAEtB,QAAQ;AACR,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,eAAe;AAEf,oBAAoB;AACpB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAE/B,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE3D,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,gFAAgF;AAChF,oDAAoD;AACpD,gFAAgF;AAEhF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AA2HH,gFAAgF;AAChF,2CAA2C;AAC3C,gFAAgF;AAEhF,OAAO;AACL,OAAO;AACP,iBAAiB;AAEjB,YAAY;AACZ,gBAAgB,EAChB,gBAAgB;AAEhB,SAAS;AACT,mBAAmB,EACnB,iBAAiB,EACjB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB;AAEnB,OAAO;AACP,iBAAiB;AAEjB,UAAU;AACV,uBAAuB;AAEvB,SAAS;AACT,yBAAyB,EACzB,wBAAwB;AAExB,SAAS;AACT,mBAAmB;AAEnB,eAAe;AACf,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,sBAAsB;AAEtB,QAAQ;AACR,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,eAAe;AAEf,oBAAoB;AACpB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAE/B,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE3D,gFAAgF;AAChF,eAAe;AACf,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,gFAAgF;AAChF,oDAAoD;AACpD,gFAAgF;AAEhF,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEtE,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/typed-ops.d.ts

@@ -0,0 +1,148 @@
+import type { SetPatch, UnsetPatch, MergePatch } from "@manifesto-ai/core";
+/**
+ * Depth counter for recursive type operations.
+ * Prevents infinite recursion in TypeScript's type system.
+ *
+ * Usage: Prev[4] = 3, Prev[3] = 2, ... Prev[0] = never
+ */
+type Prev = [never, 0, 1, 2, 3, 4];
+/**
+ * Extract all valid dot-separated paths from a data type.
+ *
+ * - Object keys become path segments
+ * - Nested objects generate dot-separated paths (e.g. "user.name")
+ * - Arrays, primitives, and Record<string, T> are leaf nodes
+ *   (Record sub-paths are not supported by Core's path resolution)
+ * - Limited to 3 levels of nesting to avoid TS recursion limits
+ *   (root key + 3 nested levels = max 4 path segments)
+ *
+ * @example
+ * type State = { user: { name: string; age: number }; count: number };
+ * type P = DataPaths<State>;
+ * // "user" | "user.name" | "user.age" | "count"
+ */
+export type DataPaths<T, D extends number = 3> = [D] extends [never] ? never : T extends Record<string, unknown> ? T extends unknown[] ? never : {
+    [K in keyof T & string]: K | (NonNullable<T[K]> extends Record<string, unknown> ? NonNullable<T[K]> extends unknown[] ? never : string extends keyof NonNullable<T[K]> ? never : `${K}.${DataPaths<NonNullable<T[K]>, Prev[D]>}` : never);
+}[keyof T & string] : never;
+/**
+ * Resolve the value type at a dot-separated path.
+ *
+ * @example
+ * type State = { user: { name: string } };
+ * type V = ValueAt<State, "user.name">; // string
+ * type U = ValueAt<State, "user">;      // { name: string }
+ */
+export type ValueAt<T, P extends string> = P extends `${infer K}.${infer Rest}` ? K extends keyof T ? ValueAt<NonNullable<T[K]>, Rest> : never : P extends keyof T ? T[P] : never;
+/**
+ * Paths that resolve to plain object types (valid targets for merge).
+ * Arrays and primitives are excluded since merge performs shallow object merge.
+ *
+ * @example
+ * type State = { user: { name: string }; tags: string[]; count: number };
+ * type M = ObjectPaths<State>;
+ * // "user" (tags and count excluded - not plain objects)
+ */
+export type ObjectPaths<T, D extends number = 3> = [D] extends [never] ? never : T extends Record<string, unknown> ? T extends unknown[] ? never : {
+    [K in keyof T & string]: (NonNullable<T[K]> extends Record<string, unknown> ? NonNullable<T[K]> extends unknown[] ? never : K : never) | (NonNullable<T[K]> extends Record<string, unknown> ? NonNullable<T[K]> extends unknown[] ? never : string extends keyof NonNullable<T[K]> ? never : `${K}.${ObjectPaths<NonNullable<T[K]>, Prev[D]>}` : never);
+}[keyof T & string] : never;
+/**
+ * Snapshot root prefixes reserved by Core's splitPatchPath().
+ * Paths starting with these are routed to snapshot.system / .input / etc.,
+ * NOT to snapshot.data. Typed ops exclude them to prevent silent misrouting.
+ */
+type ReservedRoot = "system" | "input" | "computed" | "meta";
+/** DataPaths with reserved snapshot roots filtered out. */
+type SafeDataPaths<T extends Record<string, unknown>> = Exclude<DataPaths<T>, ReservedRoot | `${ReservedRoot}.${string}`>;
+/** ObjectPaths with reserved snapshot roots filtered out. */
+type SafeObjectPaths<T extends Record<string, unknown>> = Exclude<ObjectPaths<T>, ReservedRoot | `${ReservedRoot}.${string}`>;
+/**
+ * Type-safe patch operations builder.
+ *
+ * Provides IDE autocomplete for state paths and compile-time type checking
+ * for patch values. All methods return standard Patch objects compatible
+ * with Core's apply() function.
+ *
+ * @typeParam TData - The shape of domain state (snapshot.data)
+ */
+export interface TypedOps<TData extends Record<string, unknown>> {
+    /**
+     * Create a set patch — replace value at path (create if missing).
+     *
+     * @example
+     * ops.set('count', 5);
+     * ops.set('user.name', 'Alice');
+     */
+    set<P extends SafeDataPaths<TData>>(path: P, value: Exclude<ValueAt<TData, P>, undefined>): SetPatch;
+    /**
+     * Create an unset patch — remove property at path.
+     *
+     * @example
+     * ops.unset('temporaryField');
+     */
+    unset<P extends SafeDataPaths<TData>>(path: P): UnsetPatch;
+    /**
+     * Create a merge patch — shallow merge at object path.
+     * Only valid for paths that resolve to plain object types.
+     *
+     * @example
+     * ops.merge('user', { name: 'Bob' });
+     */
+    merge<P extends SafeObjectPaths<TData>>(path: P, value: {
+        [K in keyof ValueAt<TData, P>]?: Exclude<ValueAt<TData, P>[K], undefined>;
+    }): MergePatch;
+    /**
+     * Create an error patch targeting system.lastError.
+     *
+     * Convenience for writing error state from effect handlers.
+     * Provide source and timestamp for full audit trail;
+     * omitted fields default to empty/zero.
+     */
+    error(code: string, message: string, options?: {
+        source?: {
+            actionId: string;
+            nodePath: string;
+        };
+        timestamp?: number;
+        context?: Record<string, unknown>;
+    }): SetPatch;
+    /**
+     * Raw (untyped) patch creation — escape hatch for dynamic paths
+     * or platform namespace ($*) targets.
+     */
+    raw: {
+        set(path: string, value: unknown): SetPatch;
+        unset(path: string): UnsetPatch;
+        merge(path: string, value: Record<string, unknown>): MergePatch;
+    };
+}
+/**
+ * Create a type-safe patch operations builder.
+ *
+ * Injects the domain state type to enable:
+ * - IDE autocomplete on all valid state paths
+ * - Compile-time type checking of patch values
+ * - Merge restricted to object-typed paths
+ *
+ * @typeParam TData - The shape of domain state (snapshot.data)
+ *
+ * @example
+ * type State = {
+ *   count: number;
+ *   user: { name: string; age: number };
+ *   tags: string[];
+ * };
+ *
+ * const ops = defineOps<State>();
+ *
+ * ops.set('count', 5);              // OK — value: number
+ * ops.set('user.name', 'Alice');    // OK — value: string
+ * ops.set('count', 'hello');        // TS error — expected number
+ * ops.merge('user', { name: 'B' }); // OK — partial object merge
+ * ops.unset('tags');                // OK
+ *
+ * // Escape hatch for dynamic / platform paths
+ * ops.raw.set('$host.custom', { key: 'value' });
+ */
+export declare function defineOps<TData extends Record<string, unknown>>(): TypedOps<TData>;
+export {};
+//# sourceMappingURL=typed-ops.d.ts.map

package/dist/typed-ops.d.ts.map

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

package/dist/typed-ops.js

@@ -0,0 +1,69 @@
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Create a type-safe patch operations builder.
+ *
+ * Injects the domain state type to enable:
+ * - IDE autocomplete on all valid state paths
+ * - Compile-time type checking of patch values
+ * - Merge restricted to object-typed paths
+ *
+ * @typeParam TData - The shape of domain state (snapshot.data)
+ *
+ * @example
+ * type State = {
+ *   count: number;
+ *   user: { name: string; age: number };
+ *   tags: string[];
+ * };
+ *
+ * const ops = defineOps<State>();
+ *
+ * ops.set('count', 5);              // OK — value: number
+ * ops.set('user.name', 'Alice');    // OK — value: string
+ * ops.set('count', 'hello');        // TS error — expected number
+ * ops.merge('user', { name: 'B' }); // OK — partial object merge
+ * ops.unset('tags');                // OK
+ *
+ * // Escape hatch for dynamic / platform paths
+ * ops.raw.set('$host.custom', { key: 'value' });
+ */
+export function defineOps() {
+    return {
+        set(path, value) {
+            return { op: "set", path, value };
+        },
+        unset(path) {
+            return { op: "unset", path };
+        },
+        merge(path, value) {
+            return { op: "merge", path, value: value };
+        },
+        error(code, message, options) {
+            return {
+                op: "set",
+                path: "system.lastError",
+                value: {
+                    code,
+                    message,
+                    source: options?.source ?? { actionId: "", nodePath: "" },
+                    timestamp: options?.timestamp ?? 0,
+                    ...(options?.context !== undefined ? { context: options.context } : {}),
+                },
+            };
+        },
+        raw: {
+            set(path, value) {
+                return { op: "set", path, value };
+            },
+            unset(path) {
+                return { op: "unset", path };
+            },
+            merge(path, value) {
+                return { op: "merge", path, value };
+            },
+        },
+    };
+}
+//# sourceMappingURL=typed-ops.js.map

package/dist/typed-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-ops.js","sourceRoot":"","sources":["../src/typed-ops.ts"],"names":[],"mappings":"AAwLA,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,SAAS;IAGvB,OAAO;QACL,GAAG,CAAC,IAAY,EAAE,KAAc;YAC9B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACpC,CAAC;QACD,KAAK,CAAC,IAAY;YAChB,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC/B,CAAC;QACD,KAAK,CAAC,IAAY,EAAE,KAAc;YAChC,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAgC,EAAE,CAAC;QACxE,CAAC;QACD,KAAK,CACH,IAAY,EACZ,OAAe,EACf,OAIC;YAED,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,IAAI,EAAE,kBAAkB;gBACxB,KAAK,EAAE;oBACL,IAAI;oBACJ,OAAO;oBACP,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;oBACzD,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,CAAC;oBAClC,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxE;aACF,CAAC;QACJ,CAAC;QACD,GAAG,EAAE;YACH,GAAG,CAAC,IAAY,EAAE,KAAc;gBAC9B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YACpC,CAAC;YACD,KAAK,CAAC,IAAY;gBAChB,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC/B,CAAC;YACD,KAAK,CAAC,IAAY,EAAE,KAA8B;gBAChD,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YACtC,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manifesto-ai/sdk",
-  "version": "1.1.0",
+  "version": "1.2.1",
   "description": "Manifesto SDK - Public developer API layer",
   "author": "eggplantiny <eggplantiny@gmail.com>",
   "license": "MIT",
@@ -35,9 +35,9 @@
     "dist"
   ],
   "dependencies": {
-    "@manifesto-ai/core": "2.4.0",
-    "@manifesto-ai/world": "2.3.0",
-    "@manifesto-ai/runtime": "0.1.1"
+    "@manifesto-ai/runtime": "0.1.2",
+    "@manifesto-ai/core": "2.5.0",
+    "@manifesto-ai/world": "2.4.0"
   },
   "devDependencies": {
     "typescript": "^5.9.3"