@falai/agent 3.4.5 → 4.0.0-alpha.2

package/dist/cjs/core/predicate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicate.d.ts","sourceRoot":"","sources":["../../../src/core/predicate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGpE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAC9B,IAAI,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACnB,GAAG,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EACrB,UAAU,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,GAC7B,OAAO,CA8BT;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CASzD"}

package/dist/cjs/core/predicate.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluate = evaluate;
+exports.deepEqual = deepEqual;
+const errors_js_1 = require("../types/errors.js");
+const schema_js_1 = require("../utils/schema.js");
+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) => (0, schema_js_1.isKnown)(data[field]));
+                break;
+            case "silenced":
+                holds = (ctx.silenced !== undefined) === Boolean(arg);
+                break;
+            default: {
+                const condition = conditions[name];
+                if (!condition) {
+                    throw new errors_js_1.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;
+}
+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/cjs/core/predicate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predicate.js","sourceRoot":"","sources":["../../../src/core/predicate.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAMH,4BAkCC;AAED,8BASC;AAjDD,kDAA4D;AAE5D,kDAA6C;AAE7C,SAAgB,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,IAAA,mBAAO,EAAC,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,kCAAsB,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,SAAgB,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/cjs/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, 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/cjs/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":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACpF,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG7H,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC9D,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvF,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACpG,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC7H,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAClH,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACxG,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAGjG,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,YAAY,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,YAAY,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,YAAY,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AACvE,YAAY,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAEnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACnF,YAAY,EACV,aAAa,EACb,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,8BAA8B,EAAE,MAAM,gDAAgD,CAAC;AAChG,YAAY,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AAG9F,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAGrF,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC1E,YAAY,EACV,mBAAmB,EACnB,aAAa,EACb,WAAW,GACZ,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,WAAW,EACX,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,MAAM,EACN,SAAS,EACT,SAAS,EACT,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,uBAAuB,EACvB,UAAU,EACV,oBAAoB,EACpB,MAAM,EACN,aAAa,EACb,KAAK,EACL,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,aAAa,EACb,MAAM,EACN,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,QAAQ,EACR,SAAS,EACT,IAAI,EACJ,oBAAoB,EACpB,qBAAqB,EACrB,UAAU,EACV,0BAA0B,EAC1B,OAAO,EACP,WAAW,EACX,IAAI,EACJ,MAAM,EACN,SAAS,EACT,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,IAAI,EACJ,eAAe,EACf,QAAQ,EACR,SAAS,EACT,WAAW,EACX,IAAI,EACJ,OAAO,EACP,oBAAoB,EACpB,eAAe,EACf,MAAM,EACN,IAAI,EACJ,GAAG,EACH,SAAS,EACT,OAAO,EACP,SAAS,EACT,UAAU,EACV,aAAa,EACb,OAAO,EACP,QAAQ,EACR,eAAe,EACf,IAAI,EACJ,QAAQ,EACR,WAAW,EACX,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,KAAK,EACL,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,QAAQ,EACR,IAAI,EACJ,QAAQ,EACR,OAAO,EACP,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,oBAAoB,EACpB,OAAO,EACP,WAAW,EACX,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,UAAU,EACV,eAAe,EACf,eAAe,EACf,aAAa,EACb,QAAQ,GACT,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/cjs/index.js

@@ -5,37 +5,51 @@
  * The AI understands. The code is in control.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toolMessage = exports.assistantMessage = exports.userMessage = exports.eventsToHistory = exports.eventToHistoryItem = exports.historyToEvents = exports.historyItemToEvent = exports.hasProgrammaticConditions = exports.extractAIContextStrings = exports.createConditionEvaluator = exports.ConditionEvaluator = exports.formatKnowledgeBase = exports.generateToolId = exports.generateStepId = exports.generateFlowId = exports.OpenSearchAdapter = exports.MemoryAdapter = exports.SQLiteAdapter = exports.PostgreSQLAdapter = exports.MongoAdapter = exports.RedisAdapter = exports.PrismaAdapter = exports.resolveRetryConfig = exports.ProviderAdapter = exports.createOpenAICompatibleProvider = exports.OpenAICompatibleProvider = exports.FallbackAiProvider = exports.DeepSeekProvider = exports.AnthropicProvider = exports.ZaiProvider = exports.OpenRouterProvider = exports.OpenAIProvider = exports.GeminiProvider = exports.ProviderError = exports.SessionConflictError = exports.NotImplementedError = exports.ToolExecutionError = exports.ToolCreationError = exports.ToolManager = exports.SessionManager = exports.PersistenceManager = exports.convertHistoryToEvents = exports.adaptEvent = exports.flow = exports.FlowConfigurationError = exports.Step = exports.Flow = exports.createAgent = exports.ResponseGenerationError = exports.Agent = void 0;
-exports.mergeCollected = exports.isFlowCompletedThisSession = exports.completeCurrentFlow = exports.enterStep = exports.enterFlow = exports.createPersistedState = exports.createSessionId = exports.createSession = exports.restoreSession = exports.MessageRole = exports.EventKind = exports.systemMessage = void 0;
+exports.MessageRole = exports.EventKind = exports.userMessage = exports.toolMessage = exports.systemMessage = exports.historyToEvents = exports.historyItemToEvent = exports.eventToHistoryItem = exports.eventsToHistory = exports.assistantMessage = exports.resolveRetryConfig = exports.ProviderAdapter = exports.createOpenAICompatibleProvider = exports.OpenAICompatibleProvider = exports.FallbackAiProvider = exports.DeepSeekProvider = exports.AnthropicProvider = exports.ZaiProvider = exports.OpenRouterProvider = exports.OpenAIProvider = exports.GeminiProvider = exports.OpenSearchStore = exports.SQLiteStore = exports.MongoStore = exports.RedisStore = exports.PrismaStore = exports.PostgresStore = exports.MemoryStore = exports.migrateSession = exports.InvalidSessionError = exports.assertSession = exports.OUTCOME_MESSAGES = exports.parseDuration = exports.isDuration = exports.assertDuration = exports.MemoryScheduler = exports.fakeClock = exports.validateFlow = exports.toSpec = exports.fromSpec = exports.flowSpecSchema = exports.SessionConflictError = exports.ProviderError = exports.FlowConfigurationError = exports.Agent = exports.falai = void 0;
 // Core
+var falai_js_1 = require("./core/falai.js");
+Object.defineProperty(exports, "falai", { enumerable: true, get: function () { return falai_js_1.falai; } });
 var Agent_js_1 = require("./core/Agent.js");
 Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return Agent_js_1.Agent; } });
-var ResponseGenerationError_js_1 = require("./core/ResponseGenerationError.js");
-Object.defineProperty(exports, "ResponseGenerationError", { enumerable: true, get: function () { return ResponseGenerationError_js_1.ResponseGenerationError; } });
-var createAgent_js_1 = require("./core/createAgent.js");
-Object.defineProperty(exports, "createAgent", { enumerable: true, get: function () { return createAgent_js_1.createAgent; } });
-var Flow_js_1 = require("./core/Flow.js");
-Object.defineProperty(exports, "Flow", { enumerable: true, get: function () { return Flow_js_1.Flow; } });
-var Step_js_1 = require("./core/Step.js");
-Object.defineProperty(exports, "Step", { enumerable: true, get: function () { return Step_js_1.Step; } });
-Object.defineProperty(exports, "FlowConfigurationError", { enumerable: true, get: function () { return Step_js_1.FlowConfigurationError; } });
-var flow_namespace_js_1 = require("./core/flow-namespace.js");
-Object.defineProperty(exports, "flow", { enumerable: true, get: function () { return flow_namespace_js_1.flow; } });
-var Events_js_1 = require("./core/Events.js");
-Object.defineProperty(exports, "adaptEvent", { enumerable: true, get: function () { return Events_js_1.adaptEvent; } });
-Object.defineProperty(exports, "convertHistoryToEvents", { enumerable: true, get: function () { return Events_js_1.convertHistoryToEvents; } });
-var PersistenceManager_js_1 = require("./core/PersistenceManager.js");
-Object.defineProperty(exports, "PersistenceManager", { enumerable: true, get: function () { return PersistenceManager_js_1.PersistenceManager; } });
-var SessionManager_js_1 = require("./core/SessionManager.js");
-Object.defineProperty(exports, "SessionManager", { enumerable: true, get: function () { return SessionManager_js_1.SessionManager; } });
-var ToolManager_js_1 = require("./core/ToolManager.js");
-Object.defineProperty(exports, "ToolManager", { enumerable: true, get: function () { return ToolManager_js_1.ToolManager; } });
-Object.defineProperty(exports, "ToolCreationError", { enumerable: true, get: function () { return ToolManager_js_1.ToolCreationError; } });
-Object.defineProperty(exports, "ToolExecutionError", { enumerable: true, get: function () { return ToolManager_js_1.ToolExecutionError; } });
 var errors_js_1 = require("./types/errors.js");
-Object.defineProperty(exports, "NotImplementedError", { enumerable: true, get: function () { return errors_js_1.NotImplementedError; } });
-Object.defineProperty(exports, "SessionConflictError", { enumerable: true, get: function () { return errors_js_1.SessionConflictError; } });
+Object.defineProperty(exports, "FlowConfigurationError", { enumerable: true, get: function () { return errors_js_1.FlowConfigurationError; } });
 Object.defineProperty(exports, "ProviderError", { enumerable: true, get: function () { return errors_js_1.ProviderError; } });
+Object.defineProperty(exports, "SessionConflictError", { enumerable: true, get: function () { return errors_js_1.SessionConflictError; } });
+// Stored flows as JSON
+var FlowSpec_js_1 = require("./core/FlowSpec.js");
+Object.defineProperty(exports, "flowSpecSchema", { enumerable: true, get: function () { return FlowSpec_js_1.flowSpecSchema; } });
+Object.defineProperty(exports, "fromSpec", { enumerable: true, get: function () { return FlowSpec_js_1.fromSpec; } });
+Object.defineProperty(exports, "toSpec", { enumerable: true, get: function () { return FlowSpec_js_1.toSpec; } });
+Object.defineProperty(exports, "validateFlow", { enumerable: true, get: function () { return FlowSpec_js_1.validateFlow; } });
+// Time: a clock you control and an in-memory scheduler (tests, playground)
+var clock_js_1 = require("./utils/clock.js");
+Object.defineProperty(exports, "fakeClock", { enumerable: true, get: function () { return clock_js_1.fakeClock; } });
+Object.defineProperty(exports, "MemoryScheduler", { enumerable: true, get: function () { return clock_js_1.MemoryScheduler; } });
+var duration_js_1 = require("./utils/duration.js");
+Object.defineProperty(exports, "assertDuration", { enumerable: true, get: function () { return duration_js_1.assertDuration; } });
+Object.defineProperty(exports, "isDuration", { enumerable: true, get: function () { return duration_js_1.isDuration; } });
+Object.defineProperty(exports, "parseDuration", { enumerable: true, get: function () { return duration_js_1.parseDuration; } });
+var outcomes_js_1 = require("./utils/outcomes.js");
+Object.defineProperty(exports, "OUTCOME_MESSAGES", { enumerable: true, get: function () { return outcomes_js_1.OUTCOME_MESSAGES; } });
+// Sessions: reading stored blobs and the seven stores
+var Migrate_js_1 = require("./core/Migrate.js");
+Object.defineProperty(exports, "assertSession", { enumerable: true, get: function () { return Migrate_js_1.assertSession; } });
+Object.defineProperty(exports, "InvalidSessionError", { enumerable: true, get: function () { return Migrate_js_1.InvalidSessionError; } });
+Object.defineProperty(exports, "migrateSession", { enumerable: true, get: function () { return Migrate_js_1.migrateSession; } });
+var MemoryStore_js_1 = require("./persistence/MemoryStore.js");
+Object.defineProperty(exports, "MemoryStore", { enumerable: true, get: function () { return MemoryStore_js_1.MemoryStore; } });
+var PostgresStore_js_1 = require("./persistence/PostgresStore.js");
+Object.defineProperty(exports, "PostgresStore", { enumerable: true, get: function () { return PostgresStore_js_1.PostgresStore; } });
+var PrismaStore_js_1 = require("./persistence/PrismaStore.js");
+Object.defineProperty(exports, "PrismaStore", { enumerable: true, get: function () { return PrismaStore_js_1.PrismaStore; } });
+var RedisStore_js_1 = require("./persistence/RedisStore.js");
+Object.defineProperty(exports, "RedisStore", { enumerable: true, get: function () { return RedisStore_js_1.RedisStore; } });
+var MongoStore_js_1 = require("./persistence/MongoStore.js");
+Object.defineProperty(exports, "MongoStore", { enumerable: true, get: function () { return MongoStore_js_1.MongoStore; } });
+var SQLiteStore_js_1 = require("./persistence/SQLiteStore.js");
+Object.defineProperty(exports, "SQLiteStore", { enumerable: true, get: function () { return SQLiteStore_js_1.SQLiteStore; } });
+var OpenSearchStore_js_1 = require("./persistence/OpenSearchStore.js");
+Object.defineProperty(exports, "OpenSearchStore", { enumerable: true, get: function () { return OpenSearchStore_js_1.OpenSearchStore; } });
 // Providers
 var GeminiProvider_js_1 = require("./providers/GeminiProvider.js");
 Object.defineProperty(exports, "GeminiProvider", { enumerable: true, get: function () { return GeminiProvider_js_1.GeminiProvider; } });
@@ -61,53 +75,17 @@ Object.defineProperty(exports, "createOpenAICompatibleProvider", { enumerable: t
 var ProviderAdapter_js_1 = require("./providers/ProviderAdapter.js");
 Object.defineProperty(exports, "ProviderAdapter", { enumerable: true, get: function () { return ProviderAdapter_js_1.ProviderAdapter; } });
 Object.defineProperty(exports, "resolveRetryConfig", { enumerable: true, get: function () { return ProviderAdapter_js_1.resolveRetryConfig; } });
-// Adapters
-var PrismaAdapter_js_1 = require("./adapters/PrismaAdapter.js");
-Object.defineProperty(exports, "PrismaAdapter", { enumerable: true, get: function () { return PrismaAdapter_js_1.PrismaAdapter; } });
-var RedisAdapter_js_1 = require("./adapters/RedisAdapter.js");
-Object.defineProperty(exports, "RedisAdapter", { enumerable: true, get: function () { return RedisAdapter_js_1.RedisAdapter; } });
-var MongoAdapter_js_1 = require("./adapters/MongoAdapter.js");
-Object.defineProperty(exports, "MongoAdapter", { enumerable: true, get: function () { return MongoAdapter_js_1.MongoAdapter; } });
-var PostgreSQLAdapter_js_1 = require("./adapters/PostgreSQLAdapter.js");
-Object.defineProperty(exports, "PostgreSQLAdapter", { enumerable: true, get: function () { return PostgreSQLAdapter_js_1.PostgreSQLAdapter; } });
-var SQLiteAdapter_js_1 = require("./adapters/SQLiteAdapter.js");
-Object.defineProperty(exports, "SQLiteAdapter", { enumerable: true, get: function () { return SQLiteAdapter_js_1.SQLiteAdapter; } });
-var MemoryAdapter_js_1 = require("./adapters/MemoryAdapter.js");
-Object.defineProperty(exports, "MemoryAdapter", { enumerable: true, get: function () { return MemoryAdapter_js_1.MemoryAdapter; } });
-var OpenSearchAdapter_js_1 = require("./adapters/OpenSearchAdapter.js");
-Object.defineProperty(exports, "OpenSearchAdapter", { enumerable: true, get: function () { return OpenSearchAdapter_js_1.OpenSearchAdapter; } });
-// Utils
-var id_js_1 = require("./utils/id.js");
-Object.defineProperty(exports, "generateFlowId", { enumerable: true, get: function () { return id_js_1.generateFlowId; } });
-Object.defineProperty(exports, "generateStepId", { enumerable: true, get: function () { return id_js_1.generateStepId; } });
-Object.defineProperty(exports, "generateToolId", { enumerable: true, get: function () { return id_js_1.generateToolId; } });
-var template_js_1 = require("./utils/template.js");
-Object.defineProperty(exports, "formatKnowledgeBase", { enumerable: true, get: function () { return template_js_1.formatKnowledgeBase; } });
-var condition_js_1 = require("./utils/condition.js");
-Object.defineProperty(exports, "ConditionEvaluator", { enumerable: true, get: function () { return condition_js_1.ConditionEvaluator; } });
-Object.defineProperty(exports, "createConditionEvaluator", { enumerable: true, get: function () { return condition_js_1.createConditionEvaluator; } });
-Object.defineProperty(exports, "extractAIContextStrings", { enumerable: true, get: function () { return condition_js_1.extractAIContextStrings; } });
-Object.defineProperty(exports, "hasProgrammaticConditions", { enumerable: true, get: function () { return condition_js_1.hasProgrammaticConditions; } });
+// History helpers
 var history_js_1 = require("./utils/history.js");
+Object.defineProperty(exports, "assistantMessage", { enumerable: true, get: function () { return history_js_1.assistantMessage; } });
+Object.defineProperty(exports, "eventsToHistory", { enumerable: true, get: function () { return history_js_1.eventsToHistory; } });
+Object.defineProperty(exports, "eventToHistoryItem", { enumerable: true, get: function () { return history_js_1.eventToHistoryItem; } });
 Object.defineProperty(exports, "historyItemToEvent", { enumerable: true, get: function () { return history_js_1.historyItemToEvent; } });
 Object.defineProperty(exports, "historyToEvents", { enumerable: true, get: function () { return history_js_1.historyToEvents; } });
-Object.defineProperty(exports, "eventToHistoryItem", { enumerable: true, get: function () { return history_js_1.eventToHistoryItem; } });
-Object.defineProperty(exports, "eventsToHistory", { enumerable: true, get: function () { return history_js_1.eventsToHistory; } });
-Object.defineProperty(exports, "userMessage", { enumerable: true, get: function () { return history_js_1.userMessage; } });
-Object.defineProperty(exports, "assistantMessage", { enumerable: true, get: function () { return history_js_1.assistantMessage; } });
-Object.defineProperty(exports, "toolMessage", { enumerable: true, get: function () { return history_js_1.toolMessage; } });
 Object.defineProperty(exports, "systemMessage", { enumerable: true, get: function () { return history_js_1.systemMessage; } });
+Object.defineProperty(exports, "toolMessage", { enumerable: true, get: function () { return history_js_1.toolMessage; } });
+Object.defineProperty(exports, "userMessage", { enumerable: true, get: function () { return history_js_1.userMessage; } });
 var index_js_1 = require("./types/index.js");
 Object.defineProperty(exports, "EventKind", { enumerable: true, get: function () { return index_js_1.EventKind; } });
 Object.defineProperty(exports, "MessageRole", { enumerable: true, get: function () { return index_js_1.MessageRole; } });
-var index_js_2 = require("./utils/index.js");
-Object.defineProperty(exports, "restoreSession", { enumerable: true, get: function () { return index_js_2.restoreSession; } });
-Object.defineProperty(exports, "createSession", { enumerable: true, get: function () { return index_js_2.createSession; } });
-Object.defineProperty(exports, "createSessionId", { enumerable: true, get: function () { return index_js_2.createSessionId; } });
-Object.defineProperty(exports, "createPersistedState", { enumerable: true, get: function () { return index_js_2.createPersistedState; } });
-Object.defineProperty(exports, "enterFlow", { enumerable: true, get: function () { return index_js_2.enterFlow; } });
-Object.defineProperty(exports, "enterStep", { enumerable: true, get: function () { return index_js_2.enterStep; } });
-Object.defineProperty(exports, "completeCurrentFlow", { enumerable: true, get: function () { return index_js_2.completeCurrentFlow; } });
-Object.defineProperty(exports, "isFlowCompletedThisSession", { enumerable: true, get: function () { return index_js_2.isFlowCompletedThisSession; } });
-Object.defineProperty(exports, "mergeCollected", { enumerable: true, get: function () { return index_js_2.mergeCollected; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;AAEH,OAAO;AACP,4CAAwC;AAA/B,iGAAA,KAAK,OAAA;AAEd,gFAA4E;AAAnE,qIAAA,uBAAuB,OAAA;AAEhC,wDAAoD;AAA3C,6GAAA,WAAW,OAAA;AACpB,0CAAsC;AAA7B,+FAAA,IAAI,OAAA;AACb,0CAA8D;AAArD,+FAAA,IAAI,OAAA;AAAE,iHAAA,sBAAsB,OAAA;AACrC,8DAAgD;AAAvC,yGAAA,IAAI,OAAA;AAEb,8CAAsE;AAA7D,uGAAA,UAAU,OAAA;AAAE,mHAAA,sBAAsB,OAAA;AAC3C,sEAAkE;AAAzD,2HAAA,kBAAkB,OAAA;AAC3B,8DAA0D;AAAjD,mHAAA,cAAc,OAAA;AACvB,wDAA2F;AAAlF,6GAAA,WAAW,OAAA;AAAE,mHAAA,iBAAiB,OAAA;AAAE,oHAAA,kBAAkB,OAAA;AAC3D,+CAA6F;AAApF,gHAAA,mBAAmB,OAAA;AAAE,iHAAA,oBAAoB,OAAA;AAAE,0GAAA,aAAa,OAAA;AAIjE,YAAY;AACZ,mEAA+D;AAAtD,mHAAA,cAAc,OAAA;AAEvB,mEAA+D;AAAtD,mHAAA,cAAc,OAAA;AAEvB,2EAAuE;AAA9D,2HAAA,kBAAkB,OAAA;AAE3B,6DAAyD;AAAhD,6GAAA,WAAW,OAAA;AAEpB,yEAAqE;AAA5D,yHAAA,iBAAiB,OAAA;AAE1B,uEAAmE;AAA1D,uHAAA,gBAAgB,OAAA;AAEzB,2EAAuE;AAA9D,2HAAA,kBAAkB,OAAA;AAE3B,6EAA6E;AAC7E,uFAAmF;AAA1E,uIAAA,wBAAwB,OAAA;AAMjC,qGAAgG;AAAvF,oJAAA,8BAA8B,OAAA;AAEvC,wEAAwE;AACxE,yDAAyD;AACzD,qEAAqF;AAA5E,qHAAA,eAAe,OAAA;AAAE,wHAAA,kBAAkB,OAAA;AAU5C,WAAW;AACX,gEAA4D;AAAnD,iHAAA,aAAa,OAAA;AAMtB,8DAA0D;AAAjD,+GAAA,YAAY,OAAA;AAErB,8DAA0D;AAAjD,+GAAA,YAAY,OAAA;AAOrB,wEAAoE;AAA3D,yHAAA,iBAAiB,OAAA;AAM1B,gEAA4D;AAAnD,iHAAA,aAAa,OAAA;AAMtB,gEAA4D;AAAnD,iHAAA,aAAa,OAAA;AACtB,wEAAoE;AAA3D,yHAAA,iBAAiB,OAAA;AAM1B,QAAQ;AACR,uCAA+E;AAAtE,uGAAA,cAAc,OAAA;AAAE,uGAAA,cAAc,OAAA;AAAE,uGAAA,cAAc,OAAA;AACvD,mDAA0D;AAAjD,kHAAA,mBAAmB,OAAA;AAC5B,qDAK8B;AAJ5B,kHAAA,kBAAkB,OAAA;AAClB,wHAAA,wBAAwB,OAAA;AACxB,uHAAA,uBAAuB,OAAA;AACvB,yHAAA,yBAAyB,OAAA;AAE3B,iDAS4B;AAR1B,gHAAA,kBAAkB,OAAA;AAClB,6GAAA,eAAe,OAAA;AACf,gHAAA,kBAAkB,OAAA;AAClB,6GAAA,eAAe,OAAA;AACf,yGAAA,WAAW,OAAA;AACX,8GAAA,gBAAgB,OAAA;AAChB,yGAAA,WAAW,OAAA;AACX,2GAAA,aAAa,OAAA;AAmGf,6CAA0D;AAAjD,qGAAA,SAAS,OAAA;AAAE,uGAAA,WAAW,OAAA;AAC/B,6CAA+L;AAAtL,0GAAA,cAAc,OAAA;AAAE,yGAAA,aAAa,OAAA;AAAE,2GAAA,eAAe,OAAA;AAAE,gHAAA,oBAAoB,OAAA;AAAE,qGAAA,SAAS,OAAA;AAAE,qGAAA,SAAS,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAAE,sHAAA,0BAA0B,OAAA;AAAE,0GAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,OAAO;AACP,4CAAwC;AAA/B,iGAAA,KAAK,OAAA;AAEd,4CAAwC;AAA/B,iGAAA,KAAK,OAAA;AACd,+CAI2B;AAHzB,mHAAA,sBAAsB,OAAA;AACtB,0GAAA,aAAa,OAAA;AACb,iHAAA,oBAAoB,OAAA;AAItB,uBAAuB;AACvB,kDAAoF;AAA3E,6GAAA,cAAc,OAAA;AAAE,uGAAA,QAAQ,OAAA;AAAE,qGAAA,MAAM,OAAA;AAAE,2GAAA,YAAY,OAAA;AAGvD,2EAA2E;AAC3E,6CAA8D;AAArD,qGAAA,SAAS,OAAA;AAAE,2GAAA,eAAe,OAAA;AAEnC,mDAAgF;AAAvE,6GAAA,cAAc,OAAA;AAAE,yGAAA,UAAU,OAAA;AAAE,4GAAA,aAAa,OAAA;AAClD,mDAAuD;AAA9C,+GAAA,gBAAgB,OAAA;AAEzB,sDAAsD;AACtD,gDAAuF;AAA9E,2GAAA,aAAa,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AAAE,4GAAA,cAAc,OAAA;AAE3D,+DAA2D;AAAlD,6GAAA,WAAW,OAAA;AACpB,mEAA+D;AAAtD,iHAAA,aAAa,OAAA;AAEtB,+DAA2D;AAAlD,6GAAA,WAAW,OAAA;AAEpB,6DAAyD;AAAhD,2GAAA,UAAU,OAAA;AAEnB,6DAAyD;AAAhD,2GAAA,UAAU,OAAA;AAEnB,+DAA2D;AAAlD,6GAAA,WAAW,OAAA;AAEpB,uEAAmE;AAA1D,qHAAA,eAAe,OAAA;AAGxB,YAAY;AACZ,mEAA+D;AAAtD,mHAAA,cAAc,OAAA;AAEvB,mEAA+D;AAAtD,mHAAA,cAAc,OAAA;AAEvB,2EAAuE;AAA9D,2HAAA,kBAAkB,OAAA;AAE3B,6DAAyD;AAAhD,6GAAA,WAAW,OAAA;AAEpB,yEAAqE;AAA5D,yHAAA,iBAAiB,OAAA;AAE1B,uEAAmE;AAA1D,uHAAA,gBAAgB,OAAA;AAEzB,2EAAuE;AAA9D,2HAAA,kBAAkB,OAAA;AAE3B,6EAA6E;AAC7E,uFAAmF;AAA1E,uIAAA,wBAAwB,OAAA;AAMjC,qGAAgG;AAAvF,oJAAA,8BAA8B,OAAA;AAEvC,wEAAwE;AACxE,yDAAyD;AACzD,qEAAqF;AAA5E,qHAAA,eAAe,OAAA;AAAE,wHAAA,kBAAkB,OAAA;AAU5C,kBAAkB;AAClB,iDAS4B;AAR1B,8GAAA,gBAAgB,OAAA;AAChB,6GAAA,eAAe,OAAA;AACf,gHAAA,kBAAkB,OAAA;AAClB,gHAAA,kBAAkB,OAAA;AAClB,6GAAA,eAAe,OAAA;AACf,2GAAA,aAAa,OAAA;AACb,yGAAA,WAAW,OAAA;AACX,yGAAA,WAAW,OAAA;AA+Fb,6CAA0D;AAAjD,qGAAA,SAAS,OAAA;AAAE,uGAAA,WAAW,OAAA"}

package/dist/cjs/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/cjs/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/cjs/persistence/MemoryStore.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryStore = void 0;
+const errors_js_1 = require("../types/errors.js");
+const sessionRow_js_1 = require("./sessionRow.js");
+class MemoryStore {
+    constructor() {
+        this.rows = new Map();
+    }
+    load(id) {
+        return (0, sessionRow_js_1.asPromise)(() => {
+            const row = this.rows.get(id);
+            return row ? (0, sessionRow_js_1.readBlob)(row.blob, id) : null;
+        });
+    }
+    save(session, expectedVersion) {
+        return (0, sessionRow_js_1.asPromise)(() => {
+            const current = this.rows.get(session.id);
+            const conflict = expectedVersion === 0 ? current !== undefined : current?.version !== expectedVersion;
+            if (conflict)
+                throw new errors_js_1.SessionConflictError(session.id, expectedVersion, current?.version);
+            const blob = (0, sessionRow_js_1.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();
+    }
+}
+exports.MemoryStore = MemoryStore;
+//# sourceMappingURL=MemoryStore.js.map

package/dist/cjs/persistence/MemoryStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryStore.js","sourceRoot":"","sources":["../../../src/persistence/MemoryStore.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,kDAA0D;AAE1D,mDAA8D;AAE9D,MAAa,WAAW;IAAxB;QACmB,SAAI,GAAG,IAAI,GAAG,EAA6C,CAAC;IAwB/E,CAAC;IAtBC,IAAI,CAAC,EAAU;QACb,OAAO,IAAA,yBAAS,EAAC,GAAG,EAAE;YACpB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC9B,OAAO,GAAG,CAAC,CAAC,CAAC,IAAA,wBAAQ,EAAI,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,IAAA,yBAAS,EAAC,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,gCAAoB,CAAC,OAAO,CAAC,EAAE,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC5F,MAAM,IAAI,GAAG,IAAA,sBAAM,EAAC,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;AAzBD,kCAyBC"}

package/dist/cjs/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/cjs/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/cjs/persistence/MongoStore.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoStore = void 0;
+const json_js_1 = require("../utils/json.js");
+const errors_js_1 = require("../types/errors.js");
+const sessionRow_js_1 = require("./sessionRow.js");
+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 ? (0, sessionRow_js_1.readBlob)(doc.blob, id) : null;
+    }
+    async save(session, expectedVersion) {
+        const next = expectedVersion + 1;
+        const blob = (0, sessionRow_js_1.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 errors_js_1.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 errors_js_1.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;
+    }
+}
+exports.MongoStore = MongoStore;
+/** The driver's `MongoServerError` for a unique index hit. */
+const isDuplicateKey = (error) => (0, json_js_1.isRecord)(error) && error.code === 11000;
+//# sourceMappingURL=MongoStore.js.map

package/dist/cjs/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/cjs/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