npm - @ferricstore/ferricstore - Versions diffs - 0.12.0 → 0.12.2 - Mend

@ferricstore/ferricstore 0.12.0 → 0.12.2

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

package/README.md +3 -0
package/dist/langgraph.cjs +395 -125
package/dist/langgraph.cjs.map +1 -1
package/dist/langgraph.d.cts +17 -7
package/dist/langgraph.d.ts +17 -7
package/dist/langgraph.js +396 -126
package/dist/langgraph.js.map +1 -1
package/dist/openai-agents.cjs +161 -24
package/dist/openai-agents.cjs.map +1 -1
package/dist/openai-agents.d.cts +10 -4
package/dist/openai-agents.d.ts +10 -4
package/dist/openai-agents.js +161 -24
package/dist/openai-agents.js.map +1 -1
package/docs/agent-api/assets/hierarchy.js +1 -0
package/docs/agent-api/assets/highlight.css +92 -0
package/docs/agent-api/assets/icons.js +18 -0
package/docs/agent-api/assets/icons.svg +1 -0
package/docs/agent-api/assets/main.js +60 -0
package/docs/agent-api/assets/navigation.js +1 -0
package/docs/agent-api/assets/search.js +1 -0
package/docs/agent-api/assets/style.css +1648 -0
package/docs/agent-api/classes/langgraph.FerricStoreSaver.html +297 -0
package/docs/agent-api/classes/langgraph.FerricStoreStore.html +298 -0
package/docs/agent-api/classes/langgraph.LangGraphFlow.html +190 -0
package/docs/agent-api/classes/langgraph.LangGraphFlowContext.html +158 -0
package/docs/agent-api/classes/langgraph.LangGraphFlowRun.html +133 -0
package/docs/agent-api/classes/openai-agents.FerricStoreSession.html +241 -0
package/docs/agent-api/hierarchy.html +44 -0
package/docs/agent-api/index.html +142 -0
package/docs/agent-api/interfaces/langgraph.FerricFlowHandlerContext.html +94 -0
package/docs/agent-api/interfaces/langgraph.FerricStoreCommandClient.html +77 -0
package/docs/agent-api/interfaces/langgraph.FerricStoreLockOptions.html +81 -0
package/docs/agent-api/interfaces/langgraph.FerricStoreSaverOptions.html +106 -0
package/docs/agent-api/interfaces/langgraph.FerricStoreStoreOptions.html +98 -0
package/docs/agent-api/interfaces/langgraph.InvokableLangGraph.html +83 -0
package/docs/agent-api/interfaces/langgraph.LangGraphFlowOptions.html +116 -0
package/docs/agent-api/interfaces/openai-agents.FerricStoreSessionOptions.html +114 -0
package/docs/agent-api/interfaces/openai-agents.Session.html +208 -0
package/docs/agent-api/interfaces/openai-agents.SessionHistoryRewriteAwareSession.html +230 -0
package/docs/agent-api/interfaces/openai-agents.SessionHistoryTransactionAwareSession.html +237 -0
package/docs/agent-api/modules/langgraph.html +44 -0
package/docs/agent-api/modules/openai-agents.html +44 -0
package/docs/agent-api/modules.html +35 -0
package/docs/agent-api/types/langgraph.LangGraphChannelVersions.html +33 -0
package/docs/agent-api/types/langgraph.LangGraphInvocationConfig.html +33 -0
package/docs/agent-api/types/langgraph.LangGraphOutcomeMapper.html +50 -0
package/docs/agent-api/types/langgraph.LangGraphPendingWrite.html +33 -0
package/docs/agent-api/types/openai-agents.AgentInputItem.html +35 -0
package/docs/agent-frameworks.md +25 -8
package/docs/api/index.html +4 -1
package/docs/api/media/agent-frameworks.md +25 -8
package/package.json +5 -5

package/docs/agent-api/types/langgraph.LangGraphChannelVersions.html ADDED Viewed

@@ -0,0 +1,33 @@
+<!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>LangGraphChannelVersions | @ferricstore/ferricstore</title><meta name="description" content="Documentation for @ferricstore/ferricstore"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script><script async src="../assets/hierarchy.js" id="tsd-hierarchy-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar">
+<div class="tsd-toolbar-contents container"><a href="../index.html" class="title">@ferricstore/ferricstore</a>
+<div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/>
+<ul role="listbox" id="tsd-search-results"></ul>
+<div id="tsd-search-status" aria-live="polite" aria-atomic="true">
+<div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header>
+<div class="container container-main">
+<div class="col-content">
+<div class="tsd-page-title">
+<ul class="tsd-breadcrumb" aria-label="Breadcrumb">
+<li><a href="../modules/langgraph.html">langgraph</a></li>
+<li><a href="" aria-current="page">LangGraphChannelVersions</a></li></ul>
+<h1>Type Alias LangGraphChannelVersions</h1></div>
+<div class="tsd-signature"><span class="tsd-kind-type-alias">LangGraphChannelVersions</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">Record</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">string</span><span class="tsd-signature-symbol">,</span> <span class="tsd-signature-type">string</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">number</span><span class="tsd-signature-symbol">&gt;</span></div><aside class="tsd-sources">
+<ul>
+<li>Defined in <a href="https://github.com/ferricstore/ferricstore-typescript/blob/main/src/langgraph/checkpoint.ts#L26">langgraph/checkpoint.ts:26</a></li></ul></aside></div>
+<div class="col-sidebar">
+<div class="page-menu">
+<div class="tsd-navigation settings">
+<details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg>
+<h3>Settings</h3></summary>
+<div class="tsd-accordion-details">
+<div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span>
+<ul id="tsd-filter-options">
+<li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li>
+<li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li>
+<li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div>
+<div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div>
+<div class="site-menu">
+<nav class="tsd-navigation"><a href="../modules.html">@ferricstore/ferricstore</a>
+<ul class="tsd-small-nested-navigation" id="tsd-nav-container">
+<li>Loading...</li></ul></nav></div></div></div><footer></footer>
+<div class="overlay"></div></body></html>

package/docs/agent-api/types/langgraph.LangGraphInvocationConfig.html ADDED Viewed

@@ -0,0 +1,33 @@
+<!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>LangGraphInvocationConfig | @ferricstore/ferricstore</title><meta name="description" content="Documentation for @ferricstore/ferricstore"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script><script async src="../assets/hierarchy.js" id="tsd-hierarchy-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar">
+<div class="tsd-toolbar-contents container"><a href="../index.html" class="title">@ferricstore/ferricstore</a>
+<div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/>
+<ul role="listbox" id="tsd-search-results"></ul>
+<div id="tsd-search-status" aria-live="polite" aria-atomic="true">
+<div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header>
+<div class="container container-main">
+<div class="col-content">
+<div class="tsd-page-title">
+<ul class="tsd-breadcrumb" aria-label="Breadcrumb">
+<li><a href="../modules/langgraph.html">langgraph</a></li>
+<li><a href="" aria-current="page">LangGraphInvocationConfig</a></li></ul>
+<h1>Type Alias LangGraphInvocationConfig</h1></div>
+<div class="tsd-signature"><span class="tsd-kind-type-alias">LangGraphInvocationConfig</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">RunnableConfig</span> <span class="tsd-signature-symbol">&amp;</span> <span class="tsd-signature-symbol">{</span> <span class="tsd-kind-property">context</span><span class="tsd-signature-symbol">?:</span> <span class="tsd-signature-type">unknown</span> <span class="tsd-signature-symbol">}</span> <span class="tsd-signature-symbol">&amp;</span> <span class="tsd-signature-type">Record</span><span class="tsd-signature-symbol">&lt;</span><br/>    <span class="tsd-signature-type">string</span><span class="tsd-signature-symbol">,</span><br/>    <span class="tsd-signature-type">unknown</span><span class="tsd-signature-symbol">,</span><br/><span class="tsd-signature-symbol">&gt;</span></div><aside class="tsd-sources">
+<ul>
+<li>Defined in <a href="https://github.com/ferricstore/ferricstore-typescript/blob/main/src/langgraph/flow.ts#L8">langgraph/flow.ts:8</a></li></ul></aside></div>
+<div class="col-sidebar">
+<div class="page-menu">
+<div class="tsd-navigation settings">
+<details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg>
+<h3>Settings</h3></summary>
+<div class="tsd-accordion-details">
+<div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span>
+<ul id="tsd-filter-options">
+<li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li>
+<li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li>
+<li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div>
+<div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div>
+<div class="site-menu">
+<nav class="tsd-navigation"><a href="../modules.html">@ferricstore/ferricstore</a>
+<ul class="tsd-small-nested-navigation" id="tsd-nav-container">
+<li>Loading...</li></ul></nav></div></div></div><footer></footer>
+<div class="overlay"></div></body></html>

package/docs/agent-api/types/langgraph.LangGraphOutcomeMapper.html ADDED Viewed

@@ -0,0 +1,50 @@
+<!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>LangGraphOutcomeMapper | @ferricstore/ferricstore</title><meta name="description" content="Documentation for @ferricstore/ferricstore"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script><script async src="../assets/hierarchy.js" id="tsd-hierarchy-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar">
+<div class="tsd-toolbar-contents container"><a href="../index.html" class="title">@ferricstore/ferricstore</a>
+<div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/>
+<ul role="listbox" id="tsd-search-results"></ul>
+<div id="tsd-search-status" aria-live="polite" aria-atomic="true">
+<div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header>
+<div class="container container-main">
+<div class="col-content">
+<div class="tsd-page-title">
+<ul class="tsd-breadcrumb" aria-label="Breadcrumb">
+<li><a href="../modules/langgraph.html">langgraph</a></li>
+<li><a href="" aria-current="page">LangGraphOutcomeMapper</a></li></ul>
+<h1>Type Alias LangGraphOutcomeMapper&lt;Output&gt;</h1></div>
+<div class="tsd-signature"><span class="tsd-kind-type-alias">LangGraphOutcomeMapper</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-symbol">(</span><br/>    <span class="tsd-kind-parameter">run</span><span class="tsd-signature-symbol">:</span> <a href="../classes/langgraph.LangGraphFlowRun.html" class="tsd-signature-type tsd-kind-class">LangGraphFlowRun</a><span class="tsd-signature-symbol">&lt;</span><a class="tsd-signature-type tsd-kind-type-parameter" href="#output">Output</a><span class="tsd-signature-symbol">&gt;</span><span class="tsd-signature-symbol">,</span><br/>    <span class="tsd-kind-parameter">flow</span><span class="tsd-signature-symbol">:</span> <a href="../interfaces/langgraph.FerricFlowHandlerContext.html" class="tsd-signature-type tsd-kind-interface">FerricFlowHandlerContext</a><span class="tsd-signature-symbol">,</span><br/><span class="tsd-signature-symbol">)</span> <span class="tsd-signature-symbol">=&gt;</span> <span class="tsd-signature-type">Outcome</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">Outcome</span><span class="tsd-signature-symbol">&gt;</span></div>
+<section class="tsd-panel">
+<h4>Type Parameters</h4>
+<ul class="tsd-type-parameter-list">
+<li><span id="output"><span class="tsd-kind-type-parameter">Output</span></span></li></ul></section>
+<div class="tsd-type-declaration">
+<h4>Type Declaration</h4>
+<ul class="tsd-parameters">
+<li class="tsd-parameter-signature">
+<ul class="tsd-signatures">
+<li class="tsd-signature" id="__type"><span class="tsd-signature-symbol">(</span><br/>    <span class="tsd-kind-parameter">run</span><span class="tsd-signature-symbol">:</span> <a href="../classes/langgraph.LangGraphFlowRun.html" class="tsd-signature-type tsd-kind-class">LangGraphFlowRun</a><span class="tsd-signature-symbol">&lt;</span><a class="tsd-signature-type tsd-kind-type-parameter" href="#output">Output</a><span class="tsd-signature-symbol">&gt;</span><span class="tsd-signature-symbol">,</span><br/>    <span class="tsd-kind-parameter">flow</span><span class="tsd-signature-symbol">:</span> <a href="../interfaces/langgraph.FerricFlowHandlerContext.html" class="tsd-signature-type tsd-kind-interface">FerricFlowHandlerContext</a><span class="tsd-signature-symbol">,</span><br/><span class="tsd-signature-symbol">)</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">Outcome</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">Outcome</span><span class="tsd-signature-symbol">&gt;</span></li>
+<li class="tsd-description">
+<div class="tsd-parameters">
+<h4 class="tsd-parameters-title">Parameters</h4>
+<ul class="tsd-parameter-list">
+<li><span><span class="tsd-kind-parameter">run</span>: <a href="../classes/langgraph.LangGraphFlowRun.html" class="tsd-signature-type tsd-kind-class">LangGraphFlowRun</a><span class="tsd-signature-symbol">&lt;</span><a class="tsd-signature-type tsd-kind-type-parameter" href="#output">Output</a><span class="tsd-signature-symbol">&gt;</span></span></li>
+<li><span><span class="tsd-kind-parameter">flow</span>: <a href="../interfaces/langgraph.FerricFlowHandlerContext.html" class="tsd-signature-type tsd-kind-interface">FerricFlowHandlerContext</a></span></li></ul></div>
+<h4 class="tsd-returns-title">Returns <span class="tsd-signature-type">Outcome</span> <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">Promise</span><span class="tsd-signature-symbol">&lt;</span><span class="tsd-signature-type">Outcome</span><span class="tsd-signature-symbol">&gt;</span></h4></li></ul></li></ul></div><aside class="tsd-sources">
+<ul>
+<li>Defined in <a href="https://github.com/ferricstore/ferricstore-typescript/blob/main/src/langgraph/flow.ts#L68">langgraph/flow.ts:68</a></li></ul></aside></div>
+<div class="col-sidebar">
+<div class="page-menu">
+<div class="tsd-navigation settings">
+<details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg>
+<h3>Settings</h3></summary>
+<div class="tsd-accordion-details">
+<div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span>
+<ul id="tsd-filter-options">
+<li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li>
+<li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li>
+<li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div>
+<div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div>
+<div class="site-menu">
+<nav class="tsd-navigation"><a href="../modules.html">@ferricstore/ferricstore</a>
+<ul class="tsd-small-nested-navigation" id="tsd-nav-container">
+<li>Loading...</li></ul></nav></div></div></div><footer></footer>
+<div class="overlay"></div></body></html>

package/docs/agent-api/types/langgraph.LangGraphPendingWrite.html ADDED Viewed

@@ -0,0 +1,33 @@
+<!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>LangGraphPendingWrite | @ferricstore/ferricstore</title><meta name="description" content="Documentation for @ferricstore/ferricstore"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script><script async src="../assets/hierarchy.js" id="tsd-hierarchy-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar">
+<div class="tsd-toolbar-contents container"><a href="../index.html" class="title">@ferricstore/ferricstore</a>
+<div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/>
+<ul role="listbox" id="tsd-search-results"></ul>
+<div id="tsd-search-status" aria-live="polite" aria-atomic="true">
+<div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header>
+<div class="container container-main">
+<div class="col-content">
+<div class="tsd-page-title">
+<ul class="tsd-breadcrumb" aria-label="Breadcrumb">
+<li><a href="../modules/langgraph.html">langgraph</a></li>
+<li><a href="" aria-current="page">LangGraphPendingWrite</a></li></ul>
+<h1>Type Alias LangGraphPendingWrite</h1></div>
+<div class="tsd-signature"><span class="tsd-kind-type-alias">LangGraphPendingWrite</span><span class="tsd-signature-symbol">:</span> <span class="tsd-signature-symbol">[</span>channel<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">string</span><span class="tsd-signature-symbol">,</span> value<span class="tsd-signature-symbol">:</span> <span class="tsd-signature-type">unknown</span><span class="tsd-signature-symbol">]</span></div><aside class="tsd-sources">
+<ul>
+<li>Defined in <a href="https://github.com/ferricstore/ferricstore-typescript/blob/main/src/langgraph/checkpoint.ts#L25">langgraph/checkpoint.ts:25</a></li></ul></aside></div>
+<div class="col-sidebar">
+<div class="page-menu">
+<div class="tsd-navigation settings">
+<details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg>
+<h3>Settings</h3></summary>
+<div class="tsd-accordion-details">
+<div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span>
+<ul id="tsd-filter-options">
+<li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li>
+<li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li>
+<li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div>
+<div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div>
+<div class="site-menu">
+<nav class="tsd-navigation"><a href="../modules.html">@ferricstore/ferricstore</a>
+<ul class="tsd-small-nested-navigation" id="tsd-nav-container">
+<li>Loading...</li></ul></nav></div></div></div><footer></footer>
+<div class="overlay"></div></body></html>

package/docs/agent-api/types/openai-agents.AgentInputItem.html ADDED Viewed

@@ -0,0 +1,35 @@
+<!DOCTYPE html><html class="default" lang="en" data-base="../"><head><meta charset="utf-8"/><meta http-equiv="x-ua-compatible" content="IE=edge"/><title>AgentInputItem | @ferricstore/ferricstore</title><meta name="description" content="Documentation for @ferricstore/ferricstore"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="stylesheet" href="../assets/style.css"/><link rel="stylesheet" href="../assets/highlight.css"/><script defer src="../assets/main.js"></script><script async src="../assets/icons.js" id="tsd-icons-script"></script><script async src="../assets/search.js" id="tsd-search-script"></script><script async src="../assets/navigation.js" id="tsd-nav-script"></script><script async src="../assets/hierarchy.js" id="tsd-hierarchy-script"></script></head><body><script>document.documentElement.dataset.theme = localStorage.getItem("tsd-theme") || "os";document.body.style.display="none";setTimeout(() => window.app?app.showPage():document.body.style.removeProperty("display"),500)</script><header class="tsd-page-toolbar">
+<div class="tsd-toolbar-contents container"><a href="../index.html" class="title">@ferricstore/ferricstore</a>
+<div id="tsd-toolbar-links"></div><button id="tsd-search-trigger" class="tsd-widget" aria-label="Search"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-search"></use></svg></button><dialog id="tsd-search" aria-label="Search"><input role="combobox" id="tsd-search-input" aria-controls="tsd-search-results" aria-autocomplete="list" aria-expanded="true" autocapitalize="off" autocomplete="off" placeholder="Search the docs" maxLength="100"/>
+<ul role="listbox" id="tsd-search-results"></ul>
+<div id="tsd-search-status" aria-live="polite" aria-atomic="true">
+<div>Preparing search index...</div></div></dialog><a href="#" class="tsd-widget menu" id="tsd-toolbar-menu-trigger" data-toggle="menu" aria-label="Menu"><svg width="16" height="16" viewBox="0 0 16 16" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-menu"></use></svg></a></div></header>
+<div class="container container-main">
+<div class="col-content">
+<div class="tsd-page-title">
+<ul class="tsd-breadcrumb" aria-label="Breadcrumb">
+<li><a href="../modules/openai-agents.html">openai-agents</a></li>
+<li><a href="" aria-current="page">AgentInputItem</a></li></ul>
+<h1>Type Alias AgentInputItem</h1></div>
+<div class="tsd-signature"><span class="tsd-kind-type-alias">AgentInputItem</span><span class="tsd-signature-symbol">:</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">UserMessageItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">AssistantMessageItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">SystemMessageItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">ToolSearchCallItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">ToolSearchOutputItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">HostedToolCallItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">ProgramCallItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">ProgramCallResultItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">FunctionCallItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">ComputerUseCallItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">ShellCallItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">ApplyPatchCallItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">FunctionCallResultItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">ComputerCallResultItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">ShellCallResultItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">ApplyPatchCallResultItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">ReasoningItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">CompactionItem</span><br/>    <span class="tsd-signature-symbol">|</span> <span class="tsd-signature-type">UnknownItem</span></div>
+<div class="tsd-comment tsd-typography"><p>Agent input</p>
+</div><aside class="tsd-sources">
+<ul>
+<li>Defined in <a href="https://github.com/ferricstore/ferricstore-typescript/blob/main/src/../node_modules/@openai/agents-core/dist/types/aliases.d.ts#L17">../node_modules/@openai/agents-core/dist/types/aliases.d.ts:17</a></li></ul></aside></div>
+<div class="col-sidebar">
+<div class="page-menu">
+<div class="tsd-navigation settings">
+<details class="tsd-accordion"><summary class="tsd-accordion-summary"><svg width="20" height="20" viewBox="0 0 24 24" fill="none" aria-hidden="true"><use href="../assets/icons.svg#icon-chevronDown"></use></svg>
+<h3>Settings</h3></summary>
+<div class="tsd-accordion-details">
+<div class="tsd-filter-visibility"><span class="settings-label">Member Visibility</span>
+<ul id="tsd-filter-options">
+<li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-protected" name="protected"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Protected</span></label></li>
+<li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-inherited" name="inherited" checked/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>Inherited</span></label></li>
+<li class="tsd-filter-item"><label class="tsd-filter-input"><input type="checkbox" id="tsd-filter-external" name="external"/><svg width="32" height="32" viewBox="0 0 32 32" aria-hidden="true"><rect class="tsd-checkbox-background" width="30" height="30" x="1" y="1" rx="6" fill="none"></rect><path class="tsd-checkbox-checkmark" d="M8.35422 16.8214L13.2143 21.75L24.6458 10.25" stroke="none" stroke-width="3.5" stroke-linejoin="round" fill="none"></path></svg><span>External</span></label></li></ul></div>
+<div class="tsd-theme-toggle"><label class="settings-label" for="tsd-theme">Theme</label><select id="tsd-theme"><option value="os">OS</option><option value="light">Light</option><option value="dark">Dark</option></select></div></div></details></div></div>
+<div class="site-menu">
+<nav class="tsd-navigation"><a href="../modules.html">@ferricstore/ferricstore</a>
+<ul class="tsd-small-nested-navigation" id="tsd-nav-container">
+<li>Loading...</li></ul></nav></div></div></div><footer></footer>
+<div class="overlay"></div></body></html>

package/docs/agent-frameworks.md CHANGED Viewed

@@ -106,6 +106,12 @@ outcomes; interrupts can transition to a chosen Flow state or use a custom
 outcome mapper. Call `resume(flowContext, value)` from a handler to send a
 LangGraph `Command({ resume: value })`.
+Static `invokeOptions` and values returned by the `config` callback are merged,
+including their nested `configurable` and `metadata` objects. Dynamic values
+override static values; the bridge always owns `thread_id`, `checkpoint_ns`, and
+the `ferricflow_*` metadata fields. An explicitly supplied runtime context is
+preserved.
 The graph checkpointer and FerricFlow solve different layers and are intended
 to be used together:
@@ -142,13 +148,19 @@ clear, compaction replacement, function-call history rewrites, and atomic
 `append_items` / `replace_suffix` transactions. A transaction stores its
 operation ID and history mutation in one atomic record. Repeating the same
 operation is a no-op; reusing its ID for different content or replacing a
-non-matching suffix fails without changing history.
-All session mutations use a renewable FerricStore lock. Reads see either the
-old or new complete session record, never a partial history. `clearSession()`
-also clears transaction receipts. Session persistence stores conversation
-history; put the overall agent run in FerricFlow when it also needs durable
-leases, retries, timers, signals, or multi-step business state.
+non-matching suffix fails without changing history. Versioned transaction
+digests are deterministic across worker locales, while receipts created by the
+original locale-ordered format remain valid during migration. When an existing
+deployment also changes locale, pass its previous locale tags through
+`legacyReceiptLocales` until its receipts have been replayed and upgraded.
+All session mutations use a renewable FerricStore lock for contention control
+and a native compare-and-swap commit for correctness. Reads see either the old
+or new complete session record, never a partial history, and a writer whose
+lock expires cannot overwrite a newer state. `clearSession()` also clears
+transaction receipts. Session persistence stores conversation history; put the
+overall agent run in FerricFlow when it also needs durable leases, retries,
+timers, signals, or multi-step business state.
 ## Operational options
@@ -156,4 +168,9 @@ All three adapters accept `keyPrefix`, `lockTtlMs`, `lockWaitMs`, and
 `lockRetryMs`. The saver and store also accept `scanCount`; the saver accepts a
 custom LangGraph serializer. Defaults are suitable for ordinary use. Give
 different applications or environments different prefixes when they share a
-FerricStore deployment.
+FerricStore deployment. `lockRetryMs` must be lower than `lockTtlMs`. Before
+publishing authoritative state, the adapters use FerricStore CAS. LangGraph
+checkpoint deletion advances a thread epoch, and BaseStore deletion writes a
+CAS tombstone; their discovery indexes are append-only and validated on reads.
+These rules make late commands from expired writers harmless even across
+processes.

package/docs/api/index.html CHANGED Viewed

@@ -26,7 +26,10 @@
 <p>Use <code>@ferricstore/ferricstore/langgraph</code> for a LangGraph.js checkpointer,
 long-term <code>BaseStore</code>, and FerricFlow handler bridge. Use
 <code>@ferricstore/ferricstore/openai-agents</code> for an atomic, idempotent OpenAI
-Agents SDK <code>Session</code>. See <a href="media/agent-frameworks.md">docs/agent-frameworks.md</a>.</p>
+Agents SDK <code>Session</code>. See <a href="media/agent-frameworks.md">docs/agent-frameworks.md</a>.
+The generated
+<a href="https://unpkg.com/@ferricstore/ferricstore/docs/agent-api/modules.html">agent framework API reference</a>
+covers every public adapter class and option.</p>
 <h2 id="compatibility" class="tsd-anchor-link">Compatibility<a href="#compatibility" aria-label="Permalink" class="tsd-anchor-icon"><svg viewBox="0 0 24 24" aria-hidden="true"><use href="assets/icons.svg#icon-anchor"></use></svg></a></h2>
 <p>TypeScript SDK <code>0.12.0</code> requires FerricStore server <code>0.11.4</code> or newer. With
 FerricStore 0.11.11 it negotiates compact Stream mode 34 for homogeneous auto-ID

package/docs/api/media/agent-frameworks.md CHANGED Viewed

@@ -106,6 +106,12 @@ outcomes; interrupts can transition to a chosen Flow state or use a custom
 outcome mapper. Call `resume(flowContext, value)` from a handler to send a
 LangGraph `Command({ resume: value })`.
+Static `invokeOptions` and values returned by the `config` callback are merged,
+including their nested `configurable` and `metadata` objects. Dynamic values
+override static values; the bridge always owns `thread_id`, `checkpoint_ns`, and
+the `ferricflow_*` metadata fields. An explicitly supplied runtime context is
+preserved.
 The graph checkpointer and FerricFlow solve different layers and are intended
 to be used together:
@@ -142,13 +148,19 @@ clear, compaction replacement, function-call history rewrites, and atomic
 `append_items` / `replace_suffix` transactions. A transaction stores its
 operation ID and history mutation in one atomic record. Repeating the same
 operation is a no-op; reusing its ID for different content or replacing a
-non-matching suffix fails without changing history.
-All session mutations use a renewable FerricStore lock. Reads see either the
-old or new complete session record, never a partial history. `clearSession()`
-also clears transaction receipts. Session persistence stores conversation
-history; put the overall agent run in FerricFlow when it also needs durable
-leases, retries, timers, signals, or multi-step business state.
+non-matching suffix fails without changing history. Versioned transaction
+digests are deterministic across worker locales, while receipts created by the
+original locale-ordered format remain valid during migration. When an existing
+deployment also changes locale, pass its previous locale tags through
+`legacyReceiptLocales` until its receipts have been replayed and upgraded.
+All session mutations use a renewable FerricStore lock for contention control
+and a native compare-and-swap commit for correctness. Reads see either the old
+or new complete session record, never a partial history, and a writer whose
+lock expires cannot overwrite a newer state. `clearSession()` also clears
+transaction receipts. Session persistence stores conversation history; put the
+overall agent run in FerricFlow when it also needs durable leases, retries,
+timers, signals, or multi-step business state.
 ## Operational options
@@ -156,4 +168,9 @@ All three adapters accept `keyPrefix`, `lockTtlMs`, `lockWaitMs`, and
 `lockRetryMs`. The saver and store also accept `scanCount`; the saver accepts a
 custom LangGraph serializer. Defaults are suitable for ordinary use. Give
 different applications or environments different prefixes when they share a
-FerricStore deployment.
+FerricStore deployment. `lockRetryMs` must be lower than `lockTtlMs`. Before
+publishing authoritative state, the adapters use FerricStore CAS. LangGraph
+checkpoint deletion advances a thread epoch, and BaseStore deletion writes a
+CAS tombstone; their discovery indexes are append-only and validated on reads.
+These rules make late commands from expired writers harmless even across
+processes.

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@ferricstore/ferricstore",
-  "version": "0.12.0",
+  "version": "0.12.2",
   "description": "TypeScript SDK for FerricStore and FerricFlow",
   "type": "module",
   "license": "Apache-2.0",
@@ -83,8 +83,8 @@
   "scripts": {
     "build": "tsup src/index.ts src/langgraph.ts src/openai-agents.ts --format esm,cjs --dts --sourcemap --clean --splitting false",
     "check": "npm run typecheck && npm run lint && npm run test && npm run build && npm run test:exports && npm run docs:check",
-    "docs": "typedoc",
-    "docs:check": "typedoc --logLevel Warn && node scripts/check-generated-docs.mjs",
+    "docs": "typedoc --logLevel Warn && typedoc --options typedoc.agent.json --logLevel Warn",
+    "docs:check": "npm run docs && node scripts/check-generated-docs.mjs",
     "integration:down": "docker compose down -v",
     "integration:up": "docker compose up -d ferricstore && node scripts/wait-for-ferricstore.mjs",
     "lint": "eslint .",
@@ -108,11 +108,11 @@
     "@langchain/langgraph": "^1.4.12",
     "@openai/agents": "^0.17.0",
     "@types/node": "^22.20.1",
-    "eslint": "^10.9.0",
+    "eslint": "^10.9.1",
     "tsup": "^8.5.1",
     "typedoc": "^0.28.20",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.67.0",
+    "typescript-eslint": "^8.68.0",
     "vitest": "^4.1.11"
   },
   "peerDependencies": {