@falai/agent 3.4.5 → 4.0.0-alpha.10

package/dist/core/predicate.js

@@ -0,0 +1,54 @@
+/**
+ * Code predicates: a function runs as is; a `ConditionSpec` is AND over its
+ * keys, with `equals`, `known` and `silenced` built in and every other key
+ * looked up in the agent's conditions.
+ */
+import { FlowConfigurationError } from "../types/errors.js";
+import { isKnown } from "../utils/schema.js";
+export function evaluate(pred, ctx, conditions) {
+    if (typeof pred === "function")
+        return pred(ctx);
+    const data = ctx.data;
+    for (const [name, arg] of Object.entries(pred)) {
+        if (arg === undefined)
+            continue;
+        let holds;
+        switch (name) {
+            case "equals":
+                holds = Object.entries(arg).every(([field, value]) => deepEqual(data[field], value));
+                break;
+            case "known":
+                holds = arg.every((field) => isKnown(data[field]));
+                break;
+            case "silenced":
+                holds = (ctx.silenced !== undefined) === Boolean(arg);
+                break;
+            default: {
+                const condition = conditions[name];
+                if (!condition) {
+                    throw new FlowConfigurationError(`[FlowConfigurationError] unknown condition "${name}": it is not one of the agent's conditions. ` +
+                        `Register it under \`conditions\` or fix the name.`);
+                }
+                holds = condition.check(ctx, arg);
+            }
+        }
+        if (!holds)
+            return false;
+    }
+    return true;
+}
+export function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== "object" || typeof b !== "object" || a === null || b === null)
+        return false;
+    if (Array.isArray(a) !== Array.isArray(b))
+        return false;
+    const ka = Object.keys(a);
+    const kb = Object.keys(b);
+    if (ka.length !== kb.length)
+        return false;
+    const bRecord = b;
+    return ka.every((k) => k in bRecord && deepEqual(a[k], bRecord[k]));
+}
+//# sourceMappingURL=predicate.js.map

package/dist/core/predicate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicate.js","sourceRoot":"","sources":["../../src/core/predicate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,MAAM,UAAU,QAAQ,CACtB,IAAmB,EACnB,GAAqB,EACrB,UAA8B;IAE9B,IAAI,OAAO,IAAI,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,IAAI,GAA4B,GAAG,CAAC,IAAI,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,IAAI,GAAG,KAAK,SAAS;YAAE,SAAS;QAChC,IAAI,KAAc,CAAC;QACnB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,QAAQ;gBACX,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAA8B,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;gBAChH,MAAM;YACR,KAAK,OAAO;gBACV,KAAK,GAAI,GAAgB,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACjE,MAAM;YACR,KAAK,UAAU;gBACb,KAAK,GAAG,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;gBACtD,MAAM;YACR,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,SAAS,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;gBACnC,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,MAAM,IAAI,sBAAsB,CAC9B,+CAA+C,IAAI,8CAA8C;wBAC/F,mDAAmD,CACtD,CAAC;gBACJ,CAAC;gBACD,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QACD,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,CAAU,EAAE,CAAU;IAC9C,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC7F,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACxD,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,OAAO,GAAG,CAA4B,CAAC;IAC7C,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,OAAO,IAAI,SAAS,CAAE,CAA6B,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnG,CAAC"}

package/dist/index.d.ts

@@ -3,20 +3,32 @@
  *
  * The AI understands. The code is in control.
  */
+export { falai } from "./core/falai.js";
+export type { DataOf, Falai, FalaiRoot } from "./core/falai.js";
 export { Agent } from "./core/Agent.js";
-export type { RespondParams, StreamOptions, GenerateOptions } from "./core/ResponseModal.js";
-export { ResponseGenerationError } from "./core/ResponseGenerationError.js";
-export type { EndedFlow } from "./types/agent.js";
-export { createAgent } from "./core/createAgent.js";
-export { Flow } from "./core/Flow.js";
-export { Step, FlowConfigurationError } from "./core/Step.js";
-export { flow } from "./core/flow-namespace.js";
-export { adaptEvent, convertHistoryToEvents } from "./core/Events.js";
-export { PersistenceManager } from "./core/PersistenceManager.js";
-export { SessionManager } from "./core/SessionManager.js";
-export { ToolManager, ToolCreationError, ToolExecutionError } from "./core/ToolManager.js";
-export { NotImplementedError, SessionConflictError, ProviderError } from "./types/errors.js";
+export { FlowConfigurationError, ProviderError, SessionConflictError, } from "./types/errors.js";
 export type { ErrorKind } from "./types/errors.js";
+export { flowSpecSchema, fromSpec, toSpec, validateFlow } from "./core/FlowSpec.js";
+export type { BranchSpec, FlowSpec, InstructionSpec, Registries, StepKind, StepSpec, TriggerSpec } from "./core/FlowSpec.js";
+export { fakeClock, MemoryScheduler } from "./utils/clock.js";
+export type { FakeClock } from "./utils/clock.js";
+export { assertDuration, isDuration, parseDuration } from "./utils/duration.js";
+export { OUTCOME_MESSAGES } from "./utils/outcomes.js";
+export { assertSession, InvalidSessionError, migrateSession } from "./core/Migrate.js";
+export type { MigrateOptions } from "./core/Migrate.js";
+export { MemoryStore } from "./persistence/MemoryStore.js";
+export { PostgresStore } from "./persistence/PostgresStore.js";
+export type { PgClient, PgQueryResult, PostgresStoreOptions } from "./persistence/PostgresStore.js";
+export { PrismaStore } from "./persistence/PrismaStore.js";
+export type { PrismaClient, PrismaSessionField, PrismaSessionModel, PrismaStoreOptions } from "./persistence/PrismaStore.js";
+export { RedisStore } from "./persistence/RedisStore.js";
+export type { RedisClient, RedisStoreOptions } from "./persistence/RedisStore.js";
+export { MongoStore } from "./persistence/MongoStore.js";
+export type { MongoClient, MongoCollection, MongoDatabase, MongoStoreOptions } from "./persistence/MongoStore.js";
+export { SQLiteStore } from "./persistence/SQLiteStore.js";
+export type { SqliteDatabase, SqliteStatement, SQLiteStoreOptions } from "./persistence/SQLiteStore.js";
+export { OpenSearchStore } from "./persistence/OpenSearchStore.js";
+export type { OpenSearchClient, OpenSearchStoreOptions } from "./persistence/OpenSearchStore.js";
 export { GeminiProvider } from "./providers/GeminiProvider.js";
 export type { GeminiProviderOptions } from "./providers/GeminiProvider.js";
 export { OpenAIProvider } from "./providers/OpenAIProvider.js";
@@ -38,24 +50,7 @@ export type { OpenAICompatibleOptions } from "./providers/GenericOpenAICompatibl
 export { ProviderAdapter, resolveRetryConfig } from "./providers/ProviderAdapter.js";
 export type { JsonWithToolsProbe, ProbeOptions } from "@providerkit/core";
 export type { ProviderAdapterInit, RequestConfig, RetryConfig, } from "./providers/ProviderAdapter.js";
-export { PrismaAdapter } from "./adapters/PrismaAdapter.js";
-export type { PrismaClient, FieldMappings, PrismaAdapterOptions, } from "./adapters/PrismaAdapter.js";
-export { RedisAdapter } from "./adapters/RedisAdapter.js";
-export type { RedisClient, RedisAdapterOptions } from "./adapters/RedisAdapter.js";
-export { MongoAdapter } from "./adapters/MongoAdapter.js";
-export type { MongoClient, MongoDatabase, MongoCollection, MongoAdapterOptions, } from "./adapters/MongoAdapter.js";
-export { PostgreSQLAdapter } from "./adapters/PostgreSQLAdapter.js";
-export type { PgClient, PgQueryResult, PostgreSQLAdapterOptions, } from "./adapters/PostgreSQLAdapter.js";
-export { SQLiteAdapter } from "./adapters/SQLiteAdapter.js";
-export type { SqliteDatabase, SqliteStatement, SQLiteAdapterOptions, } from "./adapters/SQLiteAdapter.js";
-export { MemoryAdapter } from "./adapters/MemoryAdapter.js";
-export { OpenSearchAdapter } from "./adapters/OpenSearchAdapter.js";
-export type { OpenSearchClient, OpenSearchAdapterOptions, } from "./adapters/OpenSearchAdapter.js";
-export { generateFlowId, generateStepId, generateToolId } from "./utils/id.js";
-export { formatKnowledgeBase } from "./utils/template.js";
-export { ConditionEvaluator, createConditionEvaluator, extractAIContextStrings, hasProgrammaticConditions } from "./utils/condition.js";
-export { historyItemToEvent, historyToEvents, eventToHistoryItem, eventsToHistory, userMessage, assistantMessage, toolMessage, systemMessage, } from "./utils/history.js";
-export type { AgentOptions, AgentCompactionConfig, AgentResponse, Term, Instruction, ScopedInstructions, AppliedInstruction, ContextLifecycleHooks, ContextProvider, HookContext, ExitReason, Event, EmittedEvent, MessageEventData, ToolEventData, StatusEventData, Participant, FlowRef, StepRef, FlowOptions, StepOptions, FlowLifecycleHooks, StepLifecycleHooks, SessionState, SignalsState, SignalTriggerState, Signal, SignalContext, SignalDirective, ResolvedSignalDirective, SignalPredicate, SignalPredicateContext, SignalFiring, SignalSchema, ToolContext, ToolResult, ToolHandler, Tool, ToolValidationResult, ToolPermissionResult, ToolCallRequest, ToolExecutionUpdate, CompactionOptions, CompactionResult, DataEnrichmentConfig, ValidationConfig, ValidationError, ApiCallConfig, ComputationConfig, ToolScope, AiProvider, ProviderCapabilities, GenerateMessageInput, GenerateMessageOutput, AgentStructuredResponse, ReasoningConfig, StructuredSchema, SessionData, MessageData, CollectedStateData, SessionStatus, SessionRepository, SessionUpdateOptions, MessageRepository, PersistenceConfig, CreateSessionOptions, SaveMessageOptions, AgentResponseStreamChunk, Role, HistoryItem, History, PersistenceAdapter, Template, TemplateContext, ConditionEvaluationResult, UserHistoryItem, AssistantHistoryItem, ToolHistoryItem, SystemHistoryItem, StoppedReason, PrepareResult, Directive, BranchEntry, BranchMap, BranchPredicate, BranchPredicateContext, ConditionPredicate, ConditionIf, ConditionWhen, } from "./types/index.js";
+export { assistantMessage, eventsToHistory, eventToHistoryItem, historyItemToEvent, historyToEvents, systemMessage, toolMessage, userMessage, } from "./utils/history.js";
+export type { Action, ActionCtx, ActionMap, ActionResult, AgentCompactionConfig, AgentOptions, AgentStructuredResponse, AiProvider, AssistantHistoryItem, Branch, BusinessHours, Clock, CompactionOptions, CompactionResult, Condition, ConditionMap, ConditionSpec, DoStep, Duration, EmittedEvent, EndReason, Event, EventDef, EventMap, EventToolResult, FieldDef, FieldDefs, Flow, GenerateMessageInput, GenerateMessageOutput, TokenUsage, GenerateMessageStreamChunk, History, HistoryItem, Idle, IfStep, InferData, InferParams, Instruction, MessageEventData, Next, OutboundMessage, ParamDef, ParamDefs, Participant, PendingWakesInput, Pred, PredCtx, ProviderCapabilities, ReasoningConfig, Repeat, Role, Run, RunStatus, SayStep, ScalarDef, ScalarType, ScheduleEntry, Session, Silenced, StatusEventData, Step, StepBase, StepOutcome, StepOutcomeCode, StepOutcomeKind, StepOutcomeStatus, Store, StructuredSchema, SystemHistoryItem, TalkStep, Template, Tool, ToolCall, ToolCtx, ToolEventData, ToolHistoryItem, ToolPermissionResult, ToolResult, ToolValidationResult, Trigger, TriggerKind, TurnBase, TurnInput, TurnKind, TurnResult, TurnStreamChunk, UserHistoryItem, WaitEventStep, WaitStep, } from "./types/index.js";
 export { EventKind, MessageRole } from "./types/index.js";
-export { restoreSession, createSession, createSessionId, createPersistedState, enterFlow, enterStep, completeCurrentFlow, isFlowCompletedThisSession, mergeCollected } from "./utils/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -4,17 +4,24 @@
  * The AI understands. The code is in control.
  */
 // Core
+export { falai } from "./core/falai.js";
 export { Agent } from "./core/Agent.js";
-export { ResponseGenerationError } from "./core/ResponseGenerationError.js";
-export { createAgent } from "./core/createAgent.js";
-export { Flow } from "./core/Flow.js";
-export { Step, FlowConfigurationError } from "./core/Step.js";
-export { flow } from "./core/flow-namespace.js";
-export { adaptEvent, convertHistoryToEvents } from "./core/Events.js";
-export { PersistenceManager } from "./core/PersistenceManager.js";
-export { SessionManager } from "./core/SessionManager.js";
-export { ToolManager, ToolCreationError, ToolExecutionError } from "./core/ToolManager.js";
-export { NotImplementedError, SessionConflictError, ProviderError } from "./types/errors.js";
+export { FlowConfigurationError, ProviderError, SessionConflictError, } from "./types/errors.js";
+// Stored flows as JSON
+export { flowSpecSchema, fromSpec, toSpec, validateFlow } from "./core/FlowSpec.js";
+// Time: a clock you control and an in-memory scheduler (tests, playground)
+export { fakeClock, MemoryScheduler } from "./utils/clock.js";
+export { assertDuration, isDuration, parseDuration } from "./utils/duration.js";
+export { OUTCOME_MESSAGES } from "./utils/outcomes.js";
+// Sessions: reading stored blobs and the seven stores
+export { assertSession, InvalidSessionError, migrateSession } from "./core/Migrate.js";
+export { MemoryStore } from "./persistence/MemoryStore.js";
+export { PostgresStore } from "./persistence/PostgresStore.js";
+export { PrismaStore } from "./persistence/PrismaStore.js";
+export { RedisStore } from "./persistence/RedisStore.js";
+export { MongoStore } from "./persistence/MongoStore.js";
+export { SQLiteStore } from "./persistence/SQLiteStore.js";
+export { OpenSearchStore } from "./persistence/OpenSearchStore.js";
 // Providers
 export { GeminiProvider } from "./providers/GeminiProvider.js";
 export { OpenAIProvider } from "./providers/OpenAIProvider.js";
@@ -29,19 +36,7 @@ export { createOpenAICompatibleProvider } from "./providers/GenericOpenAICompati
 // The bridge every provider above is built on — subclass it to bind any
 // `@providerkit/core` provider to this framework's seam.
 export { ProviderAdapter, resolveRetryConfig } from "./providers/ProviderAdapter.js";
-// Adapters
-export { PrismaAdapter } from "./adapters/PrismaAdapter.js";
-export { RedisAdapter } from "./adapters/RedisAdapter.js";
-export { MongoAdapter } from "./adapters/MongoAdapter.js";
-export { PostgreSQLAdapter } from "./adapters/PostgreSQLAdapter.js";
-export { SQLiteAdapter } from "./adapters/SQLiteAdapter.js";
-export { MemoryAdapter } from "./adapters/MemoryAdapter.js";
-export { OpenSearchAdapter } from "./adapters/OpenSearchAdapter.js";
-// Utils
-export { generateFlowId, generateStepId, generateToolId } from "./utils/id.js";
-export { formatKnowledgeBase } from "./utils/template.js";
-export { ConditionEvaluator, createConditionEvaluator, extractAIContextStrings, hasProgrammaticConditions } from "./utils/condition.js";
-export { historyItemToEvent, historyToEvents, eventToHistoryItem, eventsToHistory, userMessage, assistantMessage, toolMessage, systemMessage, } from "./utils/history.js";
+// History helpers
+export { assistantMessage, eventsToHistory, eventToHistoryItem, historyItemToEvent, historyToEvents, systemMessage, toolMessage, userMessage, } from "./utils/history.js";
 export { EventKind, MessageRole } from "./types/index.js";
-export { restoreSession, createSession, createSessionId, createPersistedState, enterFlow, enterStep, completeCurrentFlow, isFlowCompletedThisSession, mergeCollected } from "./utils/index.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO;AACP,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAE5E,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAI7F,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,6EAA6E;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AAMnF,OAAO,EAAE,8BAA8B,EAAE,MAAM,gDAAgD,CAAC;AAEhG,wEAAwE;AACxE,yDAAyD;AACzD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAUrF,WAAW;AACX,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAM5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAO1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAMpE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAM5D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAMpE,QAAQ;AACR,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,aAAa,GACd,MAAM,oBAAoB,CAAC;AAkG5B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,oBAAoB,EAAE,SAAS,EAAE,SAAS,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO;AACP,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,uBAAuB;AACvB,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGpF,2EAA2E;AAC3E,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,sDAAsD;AACtD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEvF,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGnE,YAAY;AACZ,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,6EAA6E;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AAMnF,OAAO,EAAE,8BAA8B,EAAE,MAAM,gDAAgD,CAAC;AAEhG,wEAAwE;AACxE,yDAAyD;AACzD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAUrF,kBAAkB;AAClB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAC;AA+F5B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/persistence/MemoryStore.d.ts

@@ -0,0 +1,15 @@
+/**
+ * In-memory Store: tests, the playground, prototypes. Nothing survives the
+ * process. Rows are kept as JSON text and read back through the same check
+ * every other store runs, so a session round-trips here exactly as it would
+ * through PostgreSQL or Redis: Dates come back as text, `undefined` drops.
+ */
+import type { Session, Store } from "../types/session.js";
+export declare class MemoryStore<D = unknown> implements Store<D> {
+    private readonly rows;
+    load(id: string): Promise<Session<D> | null>;
+    save(session: Session<D>, expectedVersion: number): Promise<Session<D>>;
+    /** Drop every session. */
+    clear(): void;
+}
+//# sourceMappingURL=MemoryStore.d.ts.map

package/dist/persistence/MemoryStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryStore.d.ts","sourceRoot":"","sources":["../../src/persistence/MemoryStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG1D,qBAAa,WAAW,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwD;IAE7E,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAO5C,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAWvE,0BAA0B;IAC1B,KAAK,IAAI,IAAI;CAGd"}

package/dist/persistence/MemoryStore.js

@@ -0,0 +1,35 @@
+/**
+ * In-memory Store: tests, the playground, prototypes. Nothing survives the
+ * process. Rows are kept as JSON text and read back through the same check
+ * every other store runs, so a session round-trips here exactly as it would
+ * through PostgreSQL or Redis: Dates come back as text, `undefined` drops.
+ */
+import { SessionConflictError } from "../types/errors.js";
+import { asPromise, readBlob, toBlob } from "./sessionRow.js";
+export class MemoryStore {
+    constructor() {
+        this.rows = new Map();
+    }
+    load(id) {
+        return asPromise(() => {
+            const row = this.rows.get(id);
+            return row ? readBlob(row.blob, id) : null;
+        });
+    }
+    save(session, expectedVersion) {
+        return asPromise(() => {
+            const current = this.rows.get(session.id);
+            const conflict = expectedVersion === 0 ? current !== undefined : current?.version !== expectedVersion;
+            if (conflict)
+                throw new SessionConflictError(session.id, expectedVersion, current?.version);
+            const blob = toBlob(session, expectedVersion + 1);
+            this.rows.set(session.id, { version: blob.version, blob: JSON.stringify(blob) });
+            return blob;
+        });
+    }
+    /** Drop every session. */
+    clear() {
+        this.rows.clear();
+    }
+}
+//# sourceMappingURL=MemoryStore.js.map

package/dist/persistence/MemoryStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryStore.js","sourceRoot":"","sources":["../../src/persistence/MemoryStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9D,MAAM,OAAO,WAAW;IAAxB;QACmB,SAAI,GAAG,IAAI,GAAG,EAA6C,CAAC;IAwB/E,CAAC;IAtBC,IAAI,CAAC,EAAU;QACb,OAAO,SAAS,CAAC,GAAG,EAAE;YACpB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9B,OAAO,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAI,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,OAAmB,EAAE,eAAuB;QAC/C,OAAO,SAAS,CAAC,GAAG,EAAE;YACpB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC1C,MAAM,QAAQ,GAAG,eAAe,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,KAAK,eAAe,CAAC;YACtG,IAAI,QAAQ;gBAAE,MAAM,IAAI,oBAAoB,CAAC,OAAO,CAAC,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC5F,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,eAAe,GAAG,CAAC,CAAC,CAAC;YAClD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjF,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAED,0BAA0B;IAC1B,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;CACF"}

package/dist/persistence/MongoStore.d.ts

@@ -0,0 +1,42 @@
+/**
+ * MongoDB Store over the official driver's client.
+ *
+ * One document per session: `_id` (the session id), `version`, `blob`,
+ * `createdAt`, `updatedAt`. A first save is `insertOne`, and the duplicate
+ * key error is the conflict; later saves are `updateOne` filtered on
+ * `{ _id, version }`, and `matchedCount === 0` is the conflict.
+ */
+import type { Session, Store } from "../types/session.js";
+/** Matches the mongodb driver's Collection. */
+export interface MongoCollection<T = Record<string, unknown>> {
+    insertOne(doc: T): Promise<unknown>;
+    findOne(filter: Record<string, unknown>): Promise<T | null>;
+    updateOne(filter: Record<string, unknown>, update: Record<string, unknown>): Promise<{
+        matchedCount: number;
+    }>;
+}
+export interface MongoDatabase {
+    collection<T = Record<string, unknown>>(name: string): MongoCollection<T>;
+}
+export interface MongoClient {
+    db(name?: string): MongoDatabase;
+    close(): Promise<void>;
+}
+export interface MongoStoreOptions {
+    client: MongoClient;
+    databaseName: string;
+    /** Collection name. Default `agent_sessions`. */
+    collections?: {
+        sessions?: string;
+    };
+}
+export declare class MongoStore<D = unknown> implements Store<D> {
+    private readonly client;
+    private readonly sessions;
+    constructor(options: MongoStoreOptions);
+    disconnect(): Promise<void>;
+    load(id: string): Promise<Session<D> | null>;
+    save(session: Session<D>, expectedVersion: number): Promise<Session<D>>;
+    private storedVersion;
+}
+//# sourceMappingURL=MongoStore.d.ts.map

package/dist/persistence/MongoStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MongoStore.d.ts","sourceRoot":"","sources":["../../src/persistence/MongoStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG1D,+CAA+C;AAC/C,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D,SAAS,CAAC,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5D,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChH;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;CAC3E;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;IACjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,WAAW,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrC;AAED,qBAAa,UAAU,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;gBAE/B,OAAO,EAAE,iBAAiB;IAKhC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAK5C,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YA0B/D,aAAa;CAI5B"}

package/dist/persistence/MongoStore.js

@@ -0,0 +1,56 @@
+/**
+ * MongoDB Store over the official driver's client.
+ *
+ * One document per session: `_id` (the session id), `version`, `blob`,
+ * `createdAt`, `updatedAt`. A first save is `insertOne`, and the duplicate
+ * key error is the conflict; later saves are `updateOne` filtered on
+ * `{ _id, version }`, and `matchedCount === 0` is the conflict.
+ */
+import { isRecord } from "../utils/json.js";
+import { SessionConflictError } from "../types/errors.js";
+import { readBlob, toBlob } from "./sessionRow.js";
+export class MongoStore {
+    constructor(options) {
+        this.client = options.client;
+        this.sessions = options.client.db(options.databaseName).collection(options.collections?.sessions ?? "agent_sessions");
+    }
+    async disconnect() {
+        await this.client.close();
+    }
+    async load(id) {
+        const doc = await this.sessions.findOne({ _id: id });
+        return doc ? readBlob(doc.blob, id) : null;
+    }
+    async save(session, expectedVersion) {
+        const next = expectedVersion + 1;
+        const blob = toBlob(session, next);
+        // ponytail: the blob is stored as JSON text, not a sub-document, because
+        // claim keys carry channel message ids and those may contain dots, which
+        // older servers reject in field names. Upgrade: a sub-document once keys
+        // are escaped, for queries on runs and claims.
+        const json = JSON.stringify(blob);
+        const now = new Date();
+        if (expectedVersion === 0) {
+            try {
+                await this.sessions.insertOne({ _id: session.id, version: next, blob: json, createdAt: now, updatedAt: now });
+            }
+            catch (error) {
+                if (!isDuplicateKey(error))
+                    throw error;
+                throw new SessionConflictError(session.id, 0, await this.storedVersion(session.id));
+            }
+            return blob;
+        }
+        const { matchedCount } = await this.sessions.updateOne({ _id: session.id, version: expectedVersion }, { $set: { version: next, blob: json, updatedAt: now } });
+        if (matchedCount === 0)
+            throw new SessionConflictError(session.id, expectedVersion, await this.storedVersion(session.id));
+        return blob;
+    }
+    async storedVersion(id) {
+        const doc = await this.sessions.findOne({ _id: id });
+        return typeof doc?.version === "number" ? doc.version : undefined;
+    }
+}
+/** The driver's `MongoServerError` for a unique index hit. */
+const isDuplicateKey = (error) => isRecord(error) && error.code === 11000;
+//# sourceMappingURL=MongoStore.js.map

package/dist/persistence/MongoStore.js.map

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

package/dist/persistence/OpenSearchStore.d.ts

@@ -0,0 +1,86 @@
+/**
+ * OpenSearch Store over the official client (Elasticsearch 7.x fits too).
+ *
+ * One document per session: `id`, `version`, `blob` (stored, not indexed),
+ * `createdAt`, `updatedAt`. A first save is an `index` with `op_type:
+ * 'create'`, and the 409 is the conflict; later saves are a scripted
+ * `update` that compares `version` and becomes a `noop` when it differs,
+ * so the check and the write happen together on the shard (3.x read, then
+ * wrote).
+ */
+import type { Session, Store } from "../types/session.js";
+type Refresh = boolean | "wait_for";
+/** Matches `@opensearch-project/opensearch`'s Client. */
+export interface OpenSearchClient {
+    index(params: {
+        index: string;
+        id: string;
+        body: Record<string, unknown>;
+        op_type?: "index" | "create";
+        refresh?: Refresh;
+    }): Promise<{
+        body: {
+            result: string;
+        };
+    }>;
+    update(params: {
+        index: string;
+        id: string;
+        body: Record<string, unknown>;
+        retry_on_conflict?: number;
+        refresh?: Refresh;
+    }): Promise<{
+        body: {
+            result: string;
+        };
+    }>;
+    get(params: {
+        index: string;
+        id: string;
+    }): Promise<{
+        body: {
+            _source: Record<string, unknown>;
+        };
+    }>;
+    indices: {
+        exists(params: {
+            index: string;
+        }): Promise<{
+            body: boolean;
+        }>;
+        create(params: {
+            index: string;
+            body: {
+                mappings?: Record<string, unknown>;
+            };
+        }): Promise<{
+            body: {
+                acknowledged: boolean;
+            };
+        }>;
+    };
+}
+export interface OpenSearchStoreOptions {
+    /** Index name. Default `agent_sessions`. */
+    indices?: {
+        sessions?: string;
+    };
+    /** Create the index with its mappings on `initialize()`. Default true. */
+    autoCreateIndices?: boolean;
+    /** Refresh policy on writes: `true` at once, `false` in the background, `'wait_for'` blocks. Default false. */
+    refresh?: Refresh;
+}
+export declare class OpenSearchStore<D = unknown> implements Store<D> {
+    private readonly client;
+    private readonly index;
+    private readonly autoCreateIndices;
+    private readonly refresh;
+    constructor(client: OpenSearchClient, options?: OpenSearchStoreOptions);
+    /** Create the index with its mappings when it is missing and `autoCreateIndices` is on. */
+    initialize(): Promise<void>;
+    load(id: string): Promise<Session<D> | null>;
+    save(session: Session<D>, expectedVersion: number): Promise<Session<D>>;
+    private storedVersion;
+}
+export {};
+//# sourceMappingURL=OpenSearchStore.d.ts.map

package/dist/persistence/OpenSearchStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OpenSearchStore.d.ts","sourceRoot":"","sources":["../../src/persistence/OpenSearchStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAG1D,KAAK,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;AAEpC,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,MAAM,EAAE;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;QAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAC1C,MAAM,CAAC,MAAM,EAAE;QACb,KAAK,EAAE,MAAM,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IAC1C,GAAG,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;IACpG,OAAO,EAAE;QACP,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC;YAAE,IAAI,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE;gBAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;aAAE,CAAA;SAAE,GAAG,OAAO,CAAC;YAAE,IAAI,EAAE;gBAAE,YAAY,EAAE,OAAO,CAAA;aAAE,CAAA;SAAE,CAAC,CAAC;KAC/H,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,+GAA+G;IAC/G,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAOD,qBAAa,eAAe,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,KAAK,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEtB,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAE,sBAA2B;IAO1E,2FAA2F;IACrF,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB3B,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAU5C,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAqC/D,aAAa;CAU5B"}

package/dist/persistence/OpenSearchStore.js

@@ -0,0 +1,116 @@
+/**
+ * OpenSearch Store over the official client (Elasticsearch 7.x fits too).
+ *
+ * One document per session: `id`, `version`, `blob` (stored, not indexed),
+ * `createdAt`, `updatedAt`. A first save is an `index` with `op_type:
+ * 'create'`, and the 409 is the conflict; later saves are a scripted
+ * `update` that compares `version` and becomes a `noop` when it differs,
+ * so the check and the write happen together on the shard (3.x read, then
+ * wrote).
+ */
+import { SessionConflictError } from "../types/errors.js";
+import { readBlob, toBlob } from "./sessionRow.js";
+/** Writes the new version only when the stored one is the expected one; otherwise a noop. */
+const CAS_SCRIPT = "if (ctx._source.version != params.expected) { ctx.op = 'noop' } " +
+    "else { ctx._source.version = params.version; ctx._source.blob = params.blob; ctx._source.updatedAt = params.updatedAt }";
+export class OpenSearchStore {
+    constructor(client, options = {}) {
+        this.client = client;
+        this.index = options.indices?.sessions ?? "agent_sessions";
+        this.autoCreateIndices = options.autoCreateIndices ?? true;
+        this.refresh = options.refresh ?? false;
+    }
+    /** Create the index with its mappings when it is missing and `autoCreateIndices` is on. */
+    async initialize() {
+        if (!this.autoCreateIndices)
+            return;
+        const exists = await this.client.indices.exists({ index: this.index });
+        if (exists.body)
+            return;
+        await this.client.indices.create({
+            index: this.index,
+            body: {
+                mappings: {
+                    properties: {
+                        id: { type: "keyword" },
+                        version: { type: "integer" },
+                        blob: { type: "object", enabled: false },
+                        createdAt: { type: "date" },
+                        updatedAt: { type: "date" },
+                    },
+                },
+            },
+        });
+    }
+    async load(id) {
+        try {
+            const response = await this.client.get({ index: this.index, id });
+            return readBlob(response.body._source.blob, id);
+        }
+        catch (error) {
+            if (statusCodeOf(error) === 404)
+                return null;
+            throw error;
+        }
+    }
+    async save(session, expectedVersion) {
+        const next = expectedVersion + 1;
+        const blob = toBlob(session, next);
+        const now = new Date().toISOString();
+        if (expectedVersion === 0) {
+            try {
+                await this.client.index({
+                    index: this.index,
+                    id: session.id,
+                    op_type: "create",
+                    body: { id: session.id, version: next, blob, createdAt: now, updatedAt: now },
+                    refresh: this.refresh,
+                });
+            }
+            catch (error) {
+                if (statusCodeOf(error) !== 409)
+                    throw error;
+                throw new SessionConflictError(session.id, 0, await this.storedVersion(session.id));
+            }
+            return blob;
+        }
+        try {
+            const response = await this.client.update({
+                index: this.index,
+                id: session.id,
+                retry_on_conflict: 3,
+                refresh: this.refresh,
+                body: {
+                    script: { lang: "painless", source: CAS_SCRIPT, params: { expected: expectedVersion, version: next, blob, updatedAt: now } },
+                },
+            });
+            if (response.body.result !== "noop")
+                return blob;
+        }
+        catch (error) {
+            const status = statusCodeOf(error);
+            if (status !== 404 && status !== 409)
+                throw error;
+        }
+        throw new SessionConflictError(session.id, expectedVersion, await this.storedVersion(session.id));
+    }
+    async storedVersion(id) {
+        try {
+            const response = await this.client.get({ index: this.index, id });
+            const version = response.body._source.version;
+            return typeof version === "number" ? version : undefined;
+        }
+        catch (error) {
+            if (statusCodeOf(error) === 404)
+                return undefined;
+            throw error;
+        }
+    }
+}
+/** The client's `ResponseError` carries the HTTP status as `statusCode`. */
+function statusCodeOf(error) {
+    return typeof error === "object" && error !== null && "statusCode" in error && typeof error.statusCode === "number"
+        ? error.statusCode
+        : undefined;
+}
+//# sourceMappingURL=OpenSearchStore.js.map