@ferricstore/ferricstore 0.11.11 → 0.12.0

package/README.md

@@ -16,9 +16,22 @@ npm install @ferricstore/ferricstore
 
 Requires Node.js 22.22 or newer. The SDK ships ESM and CommonJS builds and is tested with Node 22, 24, and 26.
 
+Agent framework adapters are optional:
+
+```bash
+npm install @ferricstore/ferricstore @langchain/langgraph @langchain/core
+# or
+npm install @ferricstore/ferricstore @openai/agents
+```
+
+Use `@ferricstore/ferricstore/langgraph` for a LangGraph.js checkpointer,
+long-term `BaseStore`, and FerricFlow handler bridge. Use
+`@ferricstore/ferricstore/openai-agents` for an atomic, idempotent OpenAI
+Agents SDK `Session`. See [docs/agent-frameworks.md](docs/agent-frameworks.md).
+
 ## Compatibility
 
-TypeScript SDK `0.11.11` requires FerricStore server `0.11.4` or newer. With
+TypeScript SDK `0.12.0` requires FerricStore server `0.11.4` or newer. With
 FerricStore 0.11.11 it negotiates compact Stream mode 34 for homogeneous auto-ID
 `XADD` pipelines and compact Pub/Sub mode 35 for homogeneous `PUBLISH`
 pipelines. Native wire protocol v1 and the generic fallback are unchanged.
@@ -649,6 +662,8 @@ Runnable examples live in the `examples/` directory:
 - [signals.ts](examples/signals.ts)
 - [value-refs.ts](examples/value-refs.ts)
 - [kv-store.ts](examples/kv-store.ts)
+- [langgraph.ts](examples/langgraph.ts)
+- [openai-agents-session.ts](examples/openai-agents-session.ts)
 
 ## Codecs
 

package/dist/durability-DlDCsdlo.d.cts

@@ -0,0 +1,16 @@
+import { C as CommandArgument, a as Command } from './internal-lEEDZpPH.cjs';
+
+interface FerricStoreCommandClient {
+    command(...args: CommandArgument[]): Promise<unknown>;
+    pipeline?(commands: readonly Command[]): Promise<unknown[]>;
+}
+interface FerricStoreLockOptions {
+    /** Lease duration for adapter mutation locks. Defaults to five minutes. */
+    lockTtlMs?: number;
+    /** Maximum time to wait for a contended mutation lock. Defaults to 30 seconds. */
+    lockWaitMs?: number;
+    /** Delay between lock acquisition attempts. Defaults to 10 milliseconds. */
+    lockRetryMs?: number;
+}
+
+export type { FerricStoreCommandClient as F, FerricStoreLockOptions as a };

package/dist/durability-DplL0SbW.d.ts

@@ -0,0 +1,16 @@
+import { C as CommandArgument, a as Command } from './internal-lEEDZpPH.js';
+
+interface FerricStoreCommandClient {
+    command(...args: CommandArgument[]): Promise<unknown>;
+    pipeline?(commands: readonly Command[]): Promise<unknown[]>;
+}
+interface FerricStoreLockOptions {
+    /** Lease duration for adapter mutation locks. Defaults to five minutes. */
+    lockTtlMs?: number;
+    /** Maximum time to wait for a contended mutation lock. Defaults to 30 seconds. */
+    lockWaitMs?: number;
+    /** Delay between lock acquisition attempts. Defaults to 10 milliseconds. */
+    lockRetryMs?: number;
+}
+
+export type { FerricStoreCommandClient as F, FerricStoreLockOptions as a };

package/dist/index.cjs

@@ -21378,7 +21378,7 @@ var WorkflowWorker = class {
 };
 
 // src/version.ts
-var FERRICSTORE_SDK_VERSION = "0.11.11";
+var FERRICSTORE_SDK_VERSION = "0.12.0";
 var FERRICSTORE_MINIMUM_SERVER_VERSION = "0.11.4";
 var FERRICSTORE_NATIVE_PROTOCOL_VERSION = 1;
 // Annotate the CommonJS export names for ESM import in node: