@loomwork/plugin-durable-state 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,202 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+

package/NOTICE

@@ -0,0 +1,8 @@
+Loom
+Copyright 2026 Sushil Chhetri
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this project except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0

package/README.md

@@ -1,3 +1,83 @@
-# Temporary Holding Version
+# @loomwork/plugin-durable-state — typed, versioned state that survives between runs
 
-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.
+Keyed state that a bounded run loads at the start and saves at the end, for work that wakes on a
+schedule and has to remember something between wakes (a cursor, a watermark, counters). Each value has
+a zod schema and a contract version, older versions are migrated on load, and writes are
+compare-and-set on a revision. `load`, `save` and `clear` run as recorded effects, so on replay the
+recorded result is used and the store is not read again (ADR 0053). Use it directly for any
+carried state, or through `sentinelState` for a `schedule$`-driven agent.
+
+```ts
+import { defineConfig } from "@loomwork/app";
+import { flow$ } from "@loomwork/core";
+import { InMemoryDurableStateStore, durableState } from "@loomwork/plugin-durable-state";
+import type { FlowRunner, RegisteredFlow } from "@loomwork/workflow-runtime";
+import { z } from "zod";
+
+const watcher = durableState({
+  id: "watcher.state",
+  version: 2,
+  schema: z.object({ cursor: z.string(), failures: z.number() }),
+  // migrations[n] turns a version-n payload into version n+1
+  migrations: { 1: (old) => ({ ...(old as { cursor: string }), failures: 0 }) },
+  store: new InMemoryDurableStateStore(), // use SqliteDurableStateStore / PostgresDurableStateStore to persist
+});
+
+const runner: FlowRunner<unknown, { cursor: string }> = async (ctx) => {
+  const loaded = await watcher.load(ctx, "tenant-1"); // { found, value, revision, migrated, ... }
+  const next = { cursor: "next-page", failures: loaded.value?.failures ?? 0 };
+  await watcher.save(ctx, "tenant-1", next, loaded.revision); // revision 0 means "create"
+  return { cursor: next.cursor };
+};
+
+const io = z.object({}).passthrough();
+const flow: RegisteredFlow = {
+  definition: flow$({ id: "watch", name: "Watch", version: "1.0.0", inputSchema: io, outputSchema: z.any(), steps: [] }),
+  runner: runner as FlowRunner<unknown, unknown>,
+};
+
+export const app = defineConfig({
+  storage: { kind: "memory" },
+  flows: [flow],
+  execution: { registerEffects: (effects) => watcher.register(effects) },
+});
+```
+
+## Surface
+
+- **`durableState(config)`** returns a handle with `load(ctx, key)`, `save(ctx, key, value, expectedRevision)`,
+  `clear(ctx, key)`, `register(effects)`, and the underlying `tasks`, `effects` and `toolIds`
+  (`<id>.load`, `<id>.save`, `<id>.clear`). Register the effects at the composition root before a flow
+  calls them. Pass `{ stepId }` for a second load or save of the same handle in one run.
+- **`sentinelState(config)`** derives the key `sentinel:<scheduleId>` from a `schedule$` definition and
+  exposes `load(ctx)`, `save(ctx, value, expectedRevision)` and `clear(ctx)` without the key argument.
+- **Stores.** `DurableStateStore` is the SPI: `load`, `save` with an expected revision, `clear`.
+  `InMemoryDurableStateStore` is here; durable ones are `SqliteDurableStateStore`
+  (`@loomwork/plugin-sqlite`) and `PostgresDurableStateStore` (`@loomwork/plugin-postgres`).
+- **Errors.** `RevisionConflictError` and `StateContractMismatchError` (reasons: `no-migration-path`,
+  `migration-failed`, `future-version`, `validation-failed`).
+
+## Behaviour that surprises people
+
+- **A bad contract fails loudly.** A missing migration step, a migration that throws, a stored version
+  newer than yours, or a payload that fails the current schema all throw `StateContractMismatchError`;
+  state is never coerced. A `save` also validates against the schema before writing.
+- **Migrating on load does not rewrite the stored value.** `load` reports `migrated: { from, to }`; the
+  stored envelope changes on your next `save`.
+- **Conflicts are not retried for you.** A stale `expectedRevision` throws `RevisionConflictError`.
+  The exception is a crash-recovery re-run of a `save` that already committed, which is adopted when
+  the stored envelope equals what it tried to write.
+- **This is not `memory$`.** It is journaled step output, so a read during replay returns what the
+  original run saw, even if the store has changed since.
+
+## Status / See also
+
+Unpublished for now: inside this repo use `workspace:*`; from a sibling checkout use a `link:` override
+(see [AGENTS.md](../../AGENTS.md)).
+
+- [ADR 0053](../../docs/adr/0053-durable-state-plugin.md) and
+  [ADR 0051](../../docs/adr/0051-perpetual-agents-placement-schedule-remodel.md): the design.
+- `@loomwork/plugin-sentinel` bundles this with a schedule and claim-checked telemetry.
+- API reference: section "`@loomwork/plugin-durable-state` — carry state across wakes" in
+  [docs/api-reference.org](../../docs/api-reference.org).
+- Guides: [docs/plugins.md](../../docs/plugins.md), [docs/user-guide.md](../../docs/user-guide.md).

package/dist/InMemoryDurableStateStore.d.ts

@@ -0,0 +1,17 @@
+import type { DurableStateRecord, DurableStateStore } from "./types";
+/**
+ * Reference in-memory backend — the conformance baseline, and the test/dev
+ * default. Deep-clones on both write and read so callers can never alias the
+ * stored record (matching the value semantics of the durable backends, where
+ * a JSON round-trip breaks aliasing anyway).
+ */
+export declare class InMemoryDurableStateStore implements DurableStateStore {
+    private readonly records;
+    load(key: string): Promise<DurableStateRecord | null>;
+    save(key: string, value: {
+        contractVersion: number;
+        payload: unknown;
+    }, expectedRevision: number): Promise<DurableStateRecord>;
+    clear(key: string): Promise<void>;
+}
+//# sourceMappingURL=InMemoryDurableStateStore.d.ts.map

package/dist/InMemoryDurableStateStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryDurableStateStore.d.ts","sourceRoot":"","sources":["../src/InMemoryDurableStateStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAErE;;;;;GAKG;AACH,qBAAa,yBAA0B,YAAW,iBAAiB;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyC;IAE3D,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAKrD,IAAI,CACR,GAAG,EAAE,MAAM,EACX,KAAK,EAAE;QAAE,eAAe,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EACpD,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC,kBAAkB,CAAC;IAcxB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxC"}

package/dist/InMemoryDurableStateStore.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryDurableStateStore = void 0;
+const errors_1 = require("./errors");
+/**
+ * Reference in-memory backend — the conformance baseline, and the test/dev
+ * default. Deep-clones on both write and read so callers can never alias the
+ * stored record (matching the value semantics of the durable backends, where
+ * a JSON round-trip breaks aliasing anyway).
+ */
+class InMemoryDurableStateStore {
+    records = new Map();
+    async load(key) {
+        const record = this.records.get(key);
+        return record === undefined ? null : structuredClone(record);
+    }
+    async save(key, value, expectedRevision) {
+        const actual = this.records.get(key)?.revision ?? 0;
+        if (expectedRevision !== actual) {
+            throw new errors_1.RevisionConflictError(key, expectedRevision, actual);
+        }
+        const record = {
+            contractVersion: value.contractVersion,
+            revision: actual + 1,
+            payload: structuredClone(value.payload),
+        };
+        this.records.set(key, record);
+        return structuredClone(record);
+    }
+    async clear(key) {
+        this.records.delete(key);
+    }
+}
+exports.InMemoryDurableStateStore = InMemoryDurableStateStore;
+//# sourceMappingURL=InMemoryDurableStateStore.js.map

package/dist/InMemoryDurableStateStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryDurableStateStore.js","sourceRoot":"","sources":["../src/InMemoryDurableStateStore.ts"],"names":[],"mappings":";;;AAAA,qCAAiD;AAGjD;;;;;GAKG;AACH,MAAa,yBAAyB;IACnB,OAAO,GAAG,IAAI,GAAG,EAA8B,CAAC;IAEjE,KAAK,CAAC,IAAI,CAAC,GAAW;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,IAAI,CACR,GAAW,EACX,KAAoD,EACpD,gBAAwB;QAExB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,IAAI,CAAC,CAAC;QACpD,IAAI,gBAAgB,KAAK,MAAM,EAAE,CAAC;YAChC,MAAM,IAAI,8BAAqB,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,MAAM,GAAuB;YACjC,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,QAAQ,EAAE,MAAM,GAAG,CAAC;YACpB,OAAO,EAAE,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC;SACxC,CAAC;QACF,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC9B,OAAO,eAAe,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAW;QACrB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;CACF;AA7BD,8DA6BC"}

package/dist/canonical.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Canonical JSON serialization: object keys sorted, `undefined` properties
+ * skipped (JSON semantics). Used for the save effect's adopt-own-write check —
+ * value equality must not depend on property insertion order.
+ */
+export declare function stableStringify(value: unknown, depth?: number): string;
+export declare function canonicalEqual(a: unknown, b: unknown): boolean;
+//# sourceMappingURL=canonical.d.ts.map

package/dist/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,MAAM,CAgBjE;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAE9D"}

package/dist/canonical.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stableStringify = stableStringify;
+exports.canonicalEqual = canonicalEqual;
+/**
+ * Depth cap for canonicalization. JSON nesting beyond this is pathological
+ * (and could stack-overflow the save path — audit W8); exceeding it throws a
+ * loud RangeError rather than crashing the process.
+ */
+const MAX_DEPTH = 256;
+/**
+ * Canonical JSON serialization: object keys sorted, `undefined` properties
+ * skipped (JSON semantics). Used for the save effect's adopt-own-write check —
+ * value equality must not depend on property insertion order.
+ */
+function stableStringify(value, depth = 0) {
+    if (value === null || typeof value !== "object") {
+        return JSON.stringify(value) ?? "null";
+    }
+    if (depth >= MAX_DEPTH) {
+        throw new RangeError(`stableStringify: value nests deeper than ${MAX_DEPTH} levels`);
+    }
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => stableStringify(item, depth + 1)).join(",")}]`;
+    }
+    const entries = Object.keys(value)
+        .sort()
+        .map((key) => [key, value[key]])
+        .filter(([, v]) => v !== undefined)
+        .map(([key, v]) => `${JSON.stringify(key)}:${stableStringify(v, depth + 1)}`);
+    return `{${entries.join(",")}}`;
+}
+function canonicalEqual(a, b) {
+    return stableStringify(a) === stableStringify(b);
+}
+//# sourceMappingURL=canonical.js.map

package/dist/canonical.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.js","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":";;AAYA,0CAgBC;AAED,wCAEC;AAhCD;;;;GAIG;AACH,MAAM,SAAS,GAAG,GAAG,CAAC;AAEtB;;;;GAIG;AACH,SAAgB,eAAe,CAAC,KAAc,EAAE,KAAK,GAAG,CAAC;IACvD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC;IACzC,CAAC;IACD,IAAI,KAAK,IAAI,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,UAAU,CAAC,4CAA4C,SAAS,SAAS,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAChF,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC;SAC1D,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAG,KAAiC,CAAC,GAAG,CAAC,CAAU,CAAC;SACrE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;SAClC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;IAChF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AAClC,CAAC;AAED,SAAgB,cAAc,CAAC,CAAU,EAAE,CAAU;IACnD,OAAO,eAAe,CAAC,CAAC,CAAC,KAAK,eAAe,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/durableState.d.ts

@@ -0,0 +1,10 @@
+import type { DurableStateConfig, DurableStateHandle } from "./types";
+/**
+ * ADR 0051 D2 — typed, versioned, migratable keyed state as RECORDED effects.
+ * `load`/`save` run through `ctx.execute`, so results land in STEP_COMPLETED:
+ * replay folds the recorded value and never touches the backing store —
+ * replay-correct by construction (DS-1). This is deliberately NOT `memory$`,
+ * which is a non-replayable agent-layer side channel.
+ */
+export declare function durableState<T>(config: DurableStateConfig<T>): DurableStateHandle<T>;
+//# sourceMappingURL=durableState.d.ts.map

package/dist/durableState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durableState.d.ts","sourceRoot":"","sources":["../src/durableState.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,kBAAkB,EAClB,kBAAkB,EAQnB,MAAM,SAAS,CAAC;AAsEjB;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CA0LpF"}

package/dist/durableState.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.durableState = durableState;
+const effect_runtime_1 = require("@loomwork/effect-runtime");
+const zod_1 = require("zod");
+const canonical_1 = require("./canonical");
+const errors_1 = require("./errors");
+/**
+ * DS-3 — bring a stored envelope to the current contract: apply the
+ * version-to-version migration chain, then validate against the current
+ * schema. Every failure mode is a loud, typed {@link StateContractMismatchError}
+ * (DS-2: a run never proceeds on unvalidated state).
+ */
+function migrateRecord(config, key, record) {
+    const from = record.contractVersion;
+    if (from > config.version) {
+        throw new errors_1.StateContractMismatchError(config.id, "future-version", from, config.version, `key "${key}" was written by a newer deployment`);
+    }
+    let payload = record.payload;
+    for (let v = from; v < config.version; v++) {
+        const step = config.migrations?.[v];
+        if (step === undefined) {
+            throw new errors_1.StateContractMismatchError(config.id, "no-migration-path", from, config.version, `key "${key}": no migration registered for v${v} → v${v + 1}`);
+        }
+        try {
+            payload = step(payload);
+        }
+        catch (err) {
+            throw new errors_1.StateContractMismatchError(config.id, "migration-failed", from, config.version, `key "${key}": migration v${v} → v${v + 1} threw: ${String(err)}`);
+        }
+    }
+    const parsed = config.schema.safeParse(payload);
+    if (!parsed.success) {
+        throw new errors_1.StateContractMismatchError(config.id, "validation-failed", from, config.version, `key "${key}": ${parsed.error.issues.map((i) => `${i.path.join(".") || "<root>"}: ${i.message}`).join("; ")}`);
+    }
+    return {
+        value: parsed.data,
+        migrated: from < config.version ? { from, to: config.version } : null,
+    };
+}
+function isRevisionConflict(err) {
+    return (err instanceof errors_1.RevisionConflictError ||
+        (typeof err === "object" && err !== null && err.name === "RevisionConflictError"));
+}
+/**
+ * ADR 0051 D2 — typed, versioned, migratable keyed state as RECORDED effects.
+ * `load`/`save` run through `ctx.execute`, so results land in STEP_COMPLETED:
+ * replay folds the recorded value and never touches the backing store —
+ * replay-correct by construction (DS-1). This is deliberately NOT `memory$`,
+ * which is a non-replayable agent-layer side channel.
+ */
+function durableState(config) {
+    if (config.id.length === 0) {
+        throw new TypeError("durableState: config.id must be a non-empty string");
+    }
+    if (!Number.isInteger(config.version) || config.version < 1) {
+        throw new TypeError(`durableState "${config.id}": version must be an integer ≥ 1`);
+    }
+    const toolIds = {
+        load: `${config.id}.load`,
+        save: `${config.id}.save`,
+        clear: `${config.id}.clear`,
+    };
+    const loadOutputSchema = zod_1.z.object({
+        found: zod_1.z.boolean(),
+        value: config.schema.nullable(),
+        revision: zod_1.z.number().int().nonnegative(),
+        contractVersion: zod_1.z.number().int().positive(),
+        migrated: zod_1.z
+            .object({ from: zod_1.z.number().int().positive(), to: zod_1.z.number().int().positive() })
+            .nullable(),
+    });
+    const tasks = {
+        load: {
+            _tag: "TaskDefinition",
+            kind: "memory",
+            id: toolIds.load,
+            toolId: toolIds.load,
+            name: `${config.id} load`,
+            inputSchema: zod_1.z.object({ key: zod_1.z.string() }),
+            outputSchema: loadOutputSchema,
+        },
+        save: {
+            _tag: "TaskDefinition",
+            kind: "memory",
+            id: toolIds.save,
+            toolId: toolIds.save,
+            name: `${config.id} save`,
+            outputSchema: zod_1.z.object({ revision: zod_1.z.number().int().positive() }),
+        },
+        clear: {
+            _tag: "TaskDefinition",
+            kind: "memory",
+            id: toolIds.clear,
+            toolId: toolIds.clear,
+            name: `${config.id} clear`,
+            outputSchema: zod_1.z.object({ cleared: zod_1.z.literal(true) }),
+        },
+    };
+    const loadEffect = new effect_runtime_1.ToolEffect(async ({ key }) => {
+        const record = await config.store.load(key);
+        if (record === null) {
+            return {
+                found: false,
+                value: null,
+                revision: 0,
+                contractVersion: config.version,
+                migrated: null,
+            };
+        }
+        const { value, migrated } = migrateRecord(config, key, record);
+        return {
+            found: true,
+            value,
+            revision: record.revision,
+            contractVersion: config.version,
+            migrated,
+        };
+    }, 
+    // ADR 0073 — deliberately NO `mode`. `load` is genuinely dual-seam: journaled
+    // inside a flow (where the recorded value is what replay folds), and a
+    // perfectly reasonable ambient read outside one — an operator dashboard
+    // peeking at a sentinel's carry state changes nothing and should not have to
+    // start an execution to look. Pinning it to either seam would forbid a
+    // legitimate caller, which is why the marker is opt-in rather than required.
+    { idempotent: true });
+    // K9 — declared idempotent: the CAS makes a crash-recovery re-run safe. If the
+    // prior attempt committed, the re-run's expectedRevision now trails by exactly
+    // one; when the stored envelope is byte-equal to what we tried to write, adopt
+    // it as our own committed write. A genuinely concurrent writer either lands at
+    // a different revision or a different payload — both still conflict loudly.
+    const saveEffect = new effect_runtime_1.ToolEffect(async ({ key, value, expectedRevision }) => {
+        const parsed = config.schema.safeParse(value);
+        if (!parsed.success) {
+            throw new errors_1.StateContractMismatchError(config.id, "validation-failed", config.version, config.version, `key "${key}" (save): ${parsed.error.issues.map((i) => `${i.path.join(".") || "<root>"}: ${i.message}`).join("; ")}`);
+        }
+        try {
+            const record = await config.store.save(key, { contractVersion: config.version, payload: parsed.data }, expectedRevision);
+            return { revision: record.revision };
+        }
+        catch (err) {
+            if (isRevisionConflict(err) && err.actualRevision === expectedRevision + 1) {
+                const current = await config.store.load(key);
+                if (current !== null &&
+                    current.revision === expectedRevision + 1 &&
+                    current.contractVersion === config.version &&
+                    (0, canonical_1.canonicalEqual)(current.payload, parsed.data)) {
+                    return { revision: current.revision };
+                }
+            }
+            throw err;
+        }
+    }, {
+        idempotent: true,
+        // ADR 0073 — a mutation that MUST be recorded. The whole contract of this
+        // plugin is "RECORDED effects: replay folds the recorded value, never the
+        // store" (ADR 0053). A transient write would mutate the store while the log
+        // learns nothing, so replay would fold a state the run never produced —
+        // exactly the split-brain the recorded-effect design exists to prevent.
+        mode: "journaled",
+    });
+    const clearEffect = new effect_runtime_1.ToolEffect(async ({ key }) => {
+        await config.store.clear(key);
+        return { cleared: true };
+    }, {
+        idempotent: true,
+        // ADR 0073 — a mutation that MUST be recorded. The whole contract of this
+        // plugin is "RECORDED effects: replay folds the recorded value, never the
+        // store" (ADR 0053). A transient write would mutate the store while the log
+        // learns nothing, so replay would fold a state the run never produced —
+        // exactly the split-brain the recorded-effect design exists to prevent.
+        mode: "journaled",
+    });
+    const effects = {
+        load: loadEffect,
+        save: saveEffect,
+        clear: clearEffect,
+    };
+    const taskWith = (task, stepId) => (stepId === undefined ? task : { ...task, id: stepId });
+    return {
+        id: config.id,
+        version: config.version,
+        toolIds,
+        tasks,
+        effects,
+        register(runtime) {
+            runtime.register(toolIds.load, loadEffect);
+            runtime.register(toolIds.save, saveEffect);
+            runtime.register(toolIds.clear, clearEffect);
+        },
+        load(ctx, key, opts) {
+            return ctx.execute(taskWith(tasks.load, opts?.stepId), { key });
+        },
+        save(ctx, key, value, expectedRevision, opts) {
+            return ctx.execute(taskWith(tasks.save, opts?.stepId), { key, value, expectedRevision });
+        },
+        clear(ctx, key, opts) {
+            return ctx.execute(taskWith(tasks.clear, opts?.stepId), { key });
+        },
+    };
+}
+//# sourceMappingURL=durableState.js.map

package/dist/durableState.js.map

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