@ferricstore/ferricstore 0.12.0 → 0.12.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/README.md +3 -0
  2. package/dist/langgraph.cjs +395 -125
  3. package/dist/langgraph.cjs.map +1 -1
  4. package/dist/langgraph.d.cts +17 -7
  5. package/dist/langgraph.d.ts +17 -7
  6. package/dist/langgraph.js +396 -126
  7. package/dist/langgraph.js.map +1 -1
  8. package/dist/openai-agents.cjs +161 -24
  9. package/dist/openai-agents.cjs.map +1 -1
  10. package/dist/openai-agents.d.cts +10 -4
  11. package/dist/openai-agents.d.ts +10 -4
  12. package/dist/openai-agents.js +161 -24
  13. package/dist/openai-agents.js.map +1 -1
  14. package/docs/agent-api/assets/hierarchy.js +1 -0
  15. package/docs/agent-api/assets/highlight.css +92 -0
  16. package/docs/agent-api/assets/icons.js +18 -0
  17. package/docs/agent-api/assets/icons.svg +1 -0
  18. package/docs/agent-api/assets/main.js +60 -0
  19. package/docs/agent-api/assets/navigation.js +1 -0
  20. package/docs/agent-api/assets/search.js +1 -0
  21. package/docs/agent-api/assets/style.css +1648 -0
  22. package/docs/agent-api/classes/langgraph.FerricStoreSaver.html +297 -0
  23. package/docs/agent-api/classes/langgraph.FerricStoreStore.html +298 -0
  24. package/docs/agent-api/classes/langgraph.LangGraphFlow.html +190 -0
  25. package/docs/agent-api/classes/langgraph.LangGraphFlowContext.html +158 -0
  26. package/docs/agent-api/classes/langgraph.LangGraphFlowRun.html +133 -0
  27. package/docs/agent-api/classes/openai-agents.FerricStoreSession.html +241 -0
  28. package/docs/agent-api/hierarchy.html +44 -0
  29. package/docs/agent-api/index.html +142 -0
  30. package/docs/agent-api/interfaces/langgraph.FerricFlowHandlerContext.html +94 -0
  31. package/docs/agent-api/interfaces/langgraph.FerricStoreCommandClient.html +77 -0
  32. package/docs/agent-api/interfaces/langgraph.FerricStoreLockOptions.html +81 -0
  33. package/docs/agent-api/interfaces/langgraph.FerricStoreSaverOptions.html +106 -0
  34. package/docs/agent-api/interfaces/langgraph.FerricStoreStoreOptions.html +98 -0
  35. package/docs/agent-api/interfaces/langgraph.InvokableLangGraph.html +83 -0
  36. package/docs/agent-api/interfaces/langgraph.LangGraphFlowOptions.html +116 -0
  37. package/docs/agent-api/interfaces/openai-agents.FerricStoreSessionOptions.html +114 -0
  38. package/docs/agent-api/interfaces/openai-agents.Session.html +208 -0
  39. package/docs/agent-api/interfaces/openai-agents.SessionHistoryRewriteAwareSession.html +230 -0
  40. package/docs/agent-api/interfaces/openai-agents.SessionHistoryTransactionAwareSession.html +237 -0
  41. package/docs/agent-api/modules/langgraph.html +44 -0
  42. package/docs/agent-api/modules/openai-agents.html +44 -0
  43. package/docs/agent-api/modules.html +35 -0
  44. package/docs/agent-api/types/langgraph.LangGraphChannelVersions.html +33 -0
  45. package/docs/agent-api/types/langgraph.LangGraphInvocationConfig.html +33 -0
  46. package/docs/agent-api/types/langgraph.LangGraphOutcomeMapper.html +50 -0
  47. package/docs/agent-api/types/langgraph.LangGraphPendingWrite.html +33 -0
  48. package/docs/agent-api/types/openai-agents.AgentInputItem.html +35 -0
  49. package/docs/agent-frameworks.md +25 -8
  50. package/docs/api/index.html +4 -1
  51. package/docs/api/media/agent-frameworks.md +25 -8
  52. package/package.json +3 -3
@@ -15,7 +15,7 @@ interface FerricStoreSaverOptions extends FerricStoreLockOptions {
15
15
  /** Optional LangGraph serializer. The framework JSON-plus serializer is used by default. */
16
16
  serde?: SerializerProtocol;
17
17
  }
18
- /** Durable LangGraph.js checkpoint saver backed by FerricStore. */
18
+ /** Durable, epoch-fenced LangGraph.js checkpoint saver backed by FerricStore. */
19
19
  declare class FerricStoreSaver extends BaseCheckpointSaver {
20
20
  readonly client: FerricStoreCommandClient;
21
21
  readonly keyPrefix: string;
@@ -37,14 +37,22 @@ declare class FerricStoreSaver extends BaseCheckpointSaver {
37
37
  private threadLockKey;
38
38
  private threadKey;
39
39
  private checkpointIndexKey;
40
+ private threadEpochKey;
41
+ private atomicCheckpointIndexKey;
42
+ private atomicPendingWriteIndexKey;
43
+ private checkpointRecordKey;
44
+ private pendingWriteKey;
45
+ private readThreadEpoch;
46
+ private ensureThreadEpoch;
47
+ private assertCurrentEpoch;
40
48
  private serialize;
41
49
  private deserialize;
42
- private readRecord;
43
- private pendingWrites;
50
+ private readRecordAtEpoch;
51
+ private pendingWritesAtEpoch;
44
52
  private tupleFromRecord;
45
53
  private scanHash;
46
54
  private threadKeys;
47
- private checkpointIds;
55
+ private checkpointIdsAtEpoch;
48
56
  private collectGlobal;
49
57
  }
50
58
 
@@ -58,9 +66,9 @@ interface FerricStoreStoreOptions extends FerricStoreLockOptions {
58
66
  * LangGraph.js long-term memory store backed by FerricStore.
59
67
  *
60
68
  * It implements hierarchical namespaces, exact/comparison filters, ordered
61
- * pagination, batching, and failure-safe indexes. Vector search is deliberately
62
- * rejected until a semantic index is configured rather than silently returning
63
- * an unranked result.
69
+ * pagination, batching, CAS-protected item commits, and append-only discovery
70
+ * indexes. Vector search is deliberately rejected until a semantic index is
71
+ * configured rather than silently returning an unranked result.
64
72
  */
65
73
  declare class FerricStoreStore extends BaseStore {
66
74
  readonly client: FerricStoreCommandClient;
@@ -72,11 +80,13 @@ declare class FerricStoreStore extends BaseStore {
72
80
  private catalogKey;
73
81
  private namespaceKey;
74
82
  private itemLockKey;
83
+ private itemDataKey;
75
84
  private getOperation;
76
85
  private putOperation;
77
86
  private searchOperation;
78
87
  private listNamespacesOperation;
79
88
  private readCatalogItem;
89
+ private readItemSnapshot;
80
90
  private catalogLocators;
81
91
  }
82
92
 
@@ -15,7 +15,7 @@ interface FerricStoreSaverOptions extends FerricStoreLockOptions {
15
15
  /** Optional LangGraph serializer. The framework JSON-plus serializer is used by default. */
16
16
  serde?: SerializerProtocol;
17
17
  }
18
- /** Durable LangGraph.js checkpoint saver backed by FerricStore. */
18
+ /** Durable, epoch-fenced LangGraph.js checkpoint saver backed by FerricStore. */
19
19
  declare class FerricStoreSaver extends BaseCheckpointSaver {
20
20
  readonly client: FerricStoreCommandClient;
21
21
  readonly keyPrefix: string;
@@ -37,14 +37,22 @@ declare class FerricStoreSaver extends BaseCheckpointSaver {
37
37
  private threadLockKey;
38
38
  private threadKey;
39
39
  private checkpointIndexKey;
40
+ private threadEpochKey;
41
+ private atomicCheckpointIndexKey;
42
+ private atomicPendingWriteIndexKey;
43
+ private checkpointRecordKey;
44
+ private pendingWriteKey;
45
+ private readThreadEpoch;
46
+ private ensureThreadEpoch;
47
+ private assertCurrentEpoch;
40
48
  private serialize;
41
49
  private deserialize;
42
- private readRecord;
43
- private pendingWrites;
50
+ private readRecordAtEpoch;
51
+ private pendingWritesAtEpoch;
44
52
  private tupleFromRecord;
45
53
  private scanHash;
46
54
  private threadKeys;
47
- private checkpointIds;
55
+ private checkpointIdsAtEpoch;
48
56
  private collectGlobal;
49
57
  }
50
58
 
@@ -58,9 +66,9 @@ interface FerricStoreStoreOptions extends FerricStoreLockOptions {
58
66
  * LangGraph.js long-term memory store backed by FerricStore.
59
67
  *
60
68
  * It implements hierarchical namespaces, exact/comparison filters, ordered
61
- * pagination, batching, and failure-safe indexes. Vector search is deliberately
62
- * rejected until a semantic index is configured rather than silently returning
63
- * an unranked result.
69
+ * pagination, batching, CAS-protected item commits, and append-only discovery
70
+ * indexes. Vector search is deliberately rejected until a semantic index is
71
+ * configured rather than silently returning an unranked result.
64
72
  */
65
73
  declare class FerricStoreStore extends BaseStore {
66
74
  readonly client: FerricStoreCommandClient;
@@ -72,11 +80,13 @@ declare class FerricStoreStore extends BaseStore {
72
80
  private catalogKey;
73
81
  private namespaceKey;
74
82
  private itemLockKey;
83
+ private itemDataKey;
75
84
  private getOperation;
76
85
  private putOperation;
77
86
  private searchOperation;
78
87
  private listNamespacesOperation;
79
88
  private readCatalogItem;
89
+ private readItemSnapshot;
80
90
  private catalogLocators;
81
91
  }
82
92