@ekairos/story 1.21.30-beta.0 → 1.21.32-beta.0

package/dist/stores/instant.store.js

@@ -0,0 +1,207 @@
+import { id, lookup } from "@instantdb/admin";
+import { convertEventsToModelMessages } from "../events";
+export { parseAndStoreDocument } from "./instant.document-parser";
+import { expandEventsWithInstantDocuments } from "./instant.documents";
+export { coerceDocumentTextPages, expandEventsWithInstantDocuments, } from "./instant.documents";
+export class InstantStore {
+    constructor(db) {
+        this.db = db;
+    }
+    async getOrCreateContext(contextIdentifier) {
+        if (!contextIdentifier) {
+            return this.createContext();
+        }
+        const context = await this.getContext(contextIdentifier);
+        if (!context) {
+            return this.createContext(contextIdentifier.key ? { key: contextIdentifier.key } : null, contextIdentifier.id);
+        }
+        return context;
+    }
+    async createContext(contextKey, contextId) {
+        let contextData = {
+            createdAt: new Date(),
+            content: {},
+            key: null,
+            status: "open",
+        };
+        const newContextId = contextId ?? id();
+        if (contextKey?.key) {
+            contextData = { ...contextData, key: contextKey.key };
+        }
+        await this.db.transact([
+            this.db.tx.context_contexts[newContextId].create(contextData),
+        ]);
+        const ctx = await this.getContext({ id: newContextId });
+        if (!ctx)
+            throw new Error("InstantStore: failed to create context");
+        return ctx;
+    }
+    async getContext(contextIdentifier) {
+        try {
+            if (contextIdentifier.id) {
+                const res = await this.db.query({
+                    context_contexts: {
+                        $: { where: { id: contextIdentifier.id }, limit: 1 },
+                    },
+                });
+                return res.context_contexts?.[0] ?? null;
+            }
+            if (contextIdentifier.key) {
+                const res = await this.db.query({
+                    context_contexts: {
+                        $: { where: { key: contextIdentifier.key } },
+                    },
+                });
+                return res.context_contexts?.[0] ?? null;
+            }
+            return null;
+        }
+        catch (error) {
+            throw new Error("InstantStore: Error getting context: " + error.message);
+        }
+    }
+    async updateContextContent(contextIdentifier, content) {
+        const contextDBIdentifier = contextIdentifier.id ?? lookup("key", contextIdentifier.key);
+        await this.db.transact([
+            this.db.tx.context_contexts[contextDBIdentifier].update({
+                content: content,
+                updatedAt: new Date(),
+            }),
+        ]);
+        const ctx = await this.getContext(contextIdentifier);
+        if (!ctx)
+            throw new Error("InstantStore: context not found after update");
+        return ctx;
+    }
+    async updateContextStatus(contextIdentifier, status) {
+        const txs = [];
+        if (contextIdentifier.id) {
+            txs.push(this.db.tx.context_contexts[contextIdentifier.id].update({
+                status,
+                updatedAt: new Date(),
+            }));
+        }
+        else {
+            txs.push(this.db.tx.context_contexts[lookup("key", contextIdentifier.key)].update({
+                status,
+                updatedAt: new Date(),
+            }));
+        }
+        await this.db.transact(txs);
+    }
+    async saveEvent(contextIdentifier, event) {
+        const txs = [
+            this.db.tx.context_events[event.id].update({
+                ...event,
+                status: "stored",
+            }),
+        ];
+        if (contextIdentifier.id) {
+            txs.push(this.db.tx.context_events[event.id].link({ context: contextIdentifier.id }));
+        }
+        else {
+            txs.push(this.db.tx.context_events[event.id].link({ context: lookup("key", contextIdentifier.key) }));
+        }
+        await this.db.transact(txs);
+        const persisted = await this.getEvent(event.id);
+        if (!persisted)
+            throw new Error("InstantStore: failed to read event after save");
+        return persisted;
+    }
+    async updateEvent(eventId, event) {
+        await this.db.transact([this.db.tx.context_events[eventId].update(event)]);
+        const persisted = await this.getEvent(eventId);
+        if (!persisted)
+            throw new Error("InstantStore: event not found after update");
+        return persisted;
+    }
+    async getEvent(eventId) {
+        const res = await this.db.query({
+            context_events: {
+                $: { where: { id: eventId } },
+            },
+        });
+        return res.context_events?.[0] ?? null;
+    }
+    async getEvents(contextIdentifier) {
+        const contextWhere = contextIdentifier.id
+            ? { context: contextIdentifier.id }
+            : { context: lookup("key", contextIdentifier.key) };
+        const res = await this.db.query({
+            context_events: {
+                $: {
+                    where: contextWhere,
+                    limit: 30,
+                    order: { createdAt: "asc" },
+                },
+            },
+        });
+        return res.context_events ?? [];
+    }
+    async createExecution(contextIdentifier, triggerEventId, reactionEventId) {
+        const executionId = id();
+        const execCreate = this.db.tx.story_executions[executionId].create({
+            createdAt: new Date(),
+            status: "executing",
+        });
+        const txs = [execCreate];
+        if (contextIdentifier.id) {
+            txs.push(this.db.tx.story_executions[executionId].link({ context: contextIdentifier.id }));
+            txs.push(this.db.tx.context_contexts[contextIdentifier.id].link({ currentExecution: executionId }));
+        }
+        else {
+            const ctxLookup = lookup("key", contextIdentifier.key);
+            txs.push(this.db.tx.story_executions[executionId].link({ context: ctxLookup }));
+            txs.push(this.db.tx.context_contexts[ctxLookup].link({ currentExecution: executionId }));
+        }
+        txs.push(this.db.tx.story_executions[executionId].link({ trigger: triggerEventId }));
+        txs.push(this.db.tx.story_executions[executionId].link({ reaction: reactionEventId }));
+        await this.db.transact(txs);
+        return { id: executionId };
+    }
+    async completeExecution(contextIdentifier, executionId, status) {
+        const txs = [];
+        txs.push(this.db.tx.story_executions[executionId].update({ status, updatedAt: new Date() }));
+        // Update context status back to "open" when execution completes
+        if (contextIdentifier.id) {
+            txs.push(this.db.tx.context_contexts[contextIdentifier.id].update({ status: "open", updatedAt: new Date() }));
+        }
+        else {
+            txs.push(this.db.tx.context_contexts[lookup("key", contextIdentifier.key)].update({ status: "open", updatedAt: new Date() }));
+        }
+        await this.db.transact(txs);
+    }
+    async eventsToModelMessages(events) {
+        // Default behavior for Instant-backed stories:
+        // - Expand file parts into derived `document.parsed` events (persisting parsed content into document_documents)
+        // - Then convert expanded events to model messages
+        const expanded = await expandEventsWithInstantDocuments({
+            db: this.db,
+            events,
+            derivedEventType: "document.parsed",
+        });
+        return await convertEventsToModelMessages(expanded);
+    }
+}
+/**
+ * Helper to create a StoryRuntimeResolver that returns an InstantStore.
+ *
+ * This keeps the app-level `ekairos.ts` extremely small.
+ */
+export function createInstantStoreRuntime(params) {
+    const storesByOrg = new Map();
+    return async (env) => {
+        const orgId = params.getOrgId?.(env) ??
+            (typeof env?.orgId === "string" ? String(env.orgId) : "");
+        if (!orgId) {
+            throw new Error('[instant] Missing orgId in env. Provide env.orgId (or customize getOrgId).');
+        }
+        const cached = storesByOrg.get(orgId);
+        if (cached)
+            return { store: cached };
+        const db = await params.getDb(orgId);
+        const store = new InstantStore(db);
+        storesByOrg.set(orgId, store);
+        return { store };
+    };
+}

package/dist/stores/instant.store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instant.store.js","sourceRoot":"","sources":["../../src/stores/instant.store.ts"],"names":[],"mappings":"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","sourcesContent":["import { id, lookup } from \"@instantdb/admin\"\r\n\r\nimport { storyDomain } from \"../schema\"\r\nimport { convertEventsToModelMessages } from \"../events\"\r\nimport type { ModelMessage } from \"ai\"\r\nimport type {\r\n  ContextEvent,\r\n  ContextIdentifier,\r\n  ContextStatus,\r\n  StoredContext,\r\n  StoryStore,\r\n} from \"../story.store\"\r\nexport { parseAndStoreDocument } from \"./instant.document-parser\"\r\n\r\n/**\r\n * InstantDB-backed StoryStore.\r\n *\r\n * This is intentionally kept behind the store boundary so the core story engine\r\n * can remain database-agnostic.\r\n */\r\nexport type InstantStoreDb = any\r\n\r\nexport class InstantStore implements StoryStore {\r\n  private db: any\r\n\r\n  constructor(db: InstantStoreDb) {\r\n    this.db = db\r\n  }\r\n\r\n  async getOrCreateContext<C>(\r\n    contextIdentifier: ContextIdentifier | null,\r\n  ): Promise<StoredContext<C>> {\r\n    if (!contextIdentifier) {\r\n      return this.createContext<C>()\r\n    }\r\n\r\n    const context = await this.getContext<C>(contextIdentifier)\r\n    if (!context) {\r\n      return this.createContext<C>(\r\n        contextIdentifier.key ? { key: contextIdentifier.key } : null,\r\n        contextIdentifier.id,\r\n      )\r\n    }\r\n\r\n    return context\r\n  }\r\n\r\n  private async createContext<C>(\r\n    contextKey?: { key: string } | null,\r\n    contextId?: string,\r\n  ): Promise<StoredContext<C>> {\r\n    let contextData: {\r\n      createdAt: Date\r\n      content: Record<string, unknown>\r\n      key: string | null\r\n      status: \"open\"\r\n    } = {\r\n      createdAt: new Date(),\r\n      content: {},\r\n      key: null,\r\n      status: \"open\",\r\n    }\r\n\r\n    const newContextId = contextId ?? id()\r\n    if (contextKey?.key) {\r\n      contextData = { ...contextData, key: contextKey.key }\r\n    }\r\n\r\n    await this.db.transact([\r\n      this.db.tx.context_contexts[newContextId].create(contextData),\r\n    ])\r\n\r\n    const ctx = await this.getContext<C>({ id: newContextId })\r\n    if (!ctx) throw new Error(\"InstantStore: failed to create context\")\r\n    return ctx\r\n  }\r\n\r\n  async getContext<C>(\r\n    contextIdentifier: ContextIdentifier,\r\n  ): Promise<StoredContext<C> | null> {\r\n    try {\r\n      if (contextIdentifier.id) {\r\n        const res = await this.db.query({\r\n          context_contexts: {\r\n            $: { where: { id: contextIdentifier.id as any }, limit: 1 },\r\n          },\r\n        })\r\n        return (res.context_contexts?.[0] as any) ?? null\r\n      }\r\n\r\n      if (contextIdentifier.key) {\r\n        const res = await this.db.query({\r\n          context_contexts: {\r\n            $: { where: { key: contextIdentifier.key } },\r\n          },\r\n        })\r\n        return (res.context_contexts?.[0] as any) ?? null\r\n      }\r\n\r\n      return null\r\n    } catch (error: any) {\r\n      throw new Error(\"InstantStore: Error getting context: \" + error.message)\r\n    }\r\n  }\r\n\r\n  async updateContextContent<C>(\r\n    contextIdentifier: ContextIdentifier,\r\n    content: C,\r\n  ): Promise<StoredContext<C>> {\r\n    const contextDBIdentifier =\r\n      contextIdentifier.id ?? lookup(\"key\", contextIdentifier.key)\r\n\r\n    await this.db.transact([\r\n      this.db.tx.context_contexts[contextDBIdentifier].update({\r\n        content: content as any,\r\n        updatedAt: new Date(),\r\n      }),\r\n    ])\r\n\r\n    const ctx = await this.getContext<C>(contextIdentifier)\r\n    if (!ctx) throw new Error(\"InstantStore: context not found after update\")\r\n    return ctx\r\n  }\r\n\r\n  async updateContextStatus(\r\n    contextIdentifier: ContextIdentifier,\r\n    status: ContextStatus,\r\n  ): Promise<void> {\r\n    const txs: any[] = []\r\n    if (contextIdentifier.id) {\r\n      txs.push(\r\n        this.db.tx.context_contexts[contextIdentifier.id].update({\r\n          status,\r\n          updatedAt: new Date(),\r\n        }),\r\n      )\r\n    } else {\r\n      txs.push(\r\n        this.db.tx.context_contexts[lookup(\"key\", contextIdentifier.key)].update({\r\n          status,\r\n          updatedAt: new Date(),\r\n        }),\r\n      )\r\n    }\r\n\r\n    await this.db.transact(txs)\r\n  }\r\n\r\n  async saveEvent(\r\n    contextIdentifier: ContextIdentifier,\r\n    event: ContextEvent,\r\n  ): Promise<ContextEvent> {\r\n    const txs = [\r\n      this.db.tx.context_events[event.id].update({\r\n        ...(event as any),\r\n        status: \"stored\",\r\n      }),\r\n    ]\r\n\r\n    if (contextIdentifier.id) {\r\n      txs.push(this.db.tx.context_events[event.id].link({ context: contextIdentifier.id }))\r\n    } else {\r\n      txs.push(this.db.tx.context_events[event.id].link({ context: lookup(\"key\", contextIdentifier.key) }))\r\n    }\r\n\r\n    await this.db.transact(txs as any)\r\n\r\n    const persisted = await this.getEvent(event.id)\r\n    if (!persisted) throw new Error(\"InstantStore: failed to read event after save\")\r\n    return persisted\r\n  }\r\n\r\n  async updateEvent(eventId: string, event: ContextEvent): Promise<ContextEvent> {\r\n    await this.db.transact([this.db.tx.context_events[eventId].update(event as any)])\r\n    const persisted = await this.getEvent(eventId)\r\n    if (!persisted) throw new Error(\"InstantStore: event not found after update\")\r\n    return persisted\r\n  }\r\n\r\n  async getEvent(eventId: string): Promise<ContextEvent | null> {\r\n    const res = await this.db.query({\r\n      context_events: {\r\n        $: { where: { id: eventId as any } },\r\n      },\r\n    })\r\n    return (res.context_events?.[0] as any) ?? null\r\n  }\r\n\r\n  async getEvents(contextIdentifier: ContextIdentifier): Promise<ContextEvent[]> {\r\n    const contextWhere: any = contextIdentifier.id\r\n      ? { context: contextIdentifier.id }\r\n      : { context: lookup(\"key\", contextIdentifier.key) }\r\n\r\n    const res = await this.db.query({\r\n      context_events: {\r\n        $: {\r\n          where: contextWhere,\r\n          limit: 30,\r\n          order: { createdAt: \"asc\" },\r\n        },\r\n      },\r\n    })\r\n    return (res.context_events as any) ?? []\r\n  }\r\n\r\n  async createExecution(\r\n    contextIdentifier: ContextIdentifier,\r\n    triggerEventId: string,\r\n    reactionEventId: string,\r\n  ): Promise<{ id: string }> {\r\n    const executionId = id()\r\n    const execCreate = this.db.tx.story_executions[executionId].create({\r\n      createdAt: new Date(),\r\n      status: \"executing\",\r\n    })\r\n\r\n    const txs: any[] = [execCreate]\r\n\r\n    if (contextIdentifier.id) {\r\n      txs.push(this.db.tx.story_executions[executionId].link({ context: contextIdentifier.id }))\r\n      txs.push(this.db.tx.context_contexts[contextIdentifier.id].link({ currentExecution: executionId }))\r\n    } else {\r\n      const ctxLookup = lookup(\"key\", contextIdentifier.key)\r\n      txs.push(this.db.tx.story_executions[executionId].link({ context: ctxLookup }))\r\n      txs.push(this.db.tx.context_contexts[ctxLookup].link({ currentExecution: executionId }))\r\n    }\r\n\r\n    txs.push(this.db.tx.story_executions[executionId].link({ trigger: triggerEventId }))\r\n    txs.push(this.db.tx.story_executions[executionId].link({ reaction: reactionEventId }))\r\n\r\n    await this.db.transact(txs)\r\n\r\n    return { id: executionId }\r\n  }\r\n\r\n  async completeExecution(\r\n    contextIdentifier: ContextIdentifier,\r\n    executionId: string,\r\n    status: \"completed\" | \"failed\",\r\n  ): Promise<void> {\r\n    const txs: any[] = []\r\n    txs.push(this.db.tx.story_executions[executionId].update({ status, updatedAt: new Date() }))\r\n\r\n    // Update context status back to \"open\" when execution completes\r\n    if (contextIdentifier.id) {\r\n      txs.push(this.db.tx.context_contexts[contextIdentifier.id].update({ status: \"open\", updatedAt: new Date() }))\r\n    } else {\r\n      txs.push(this.db.tx.context_contexts[lookup(\"key\", contextIdentifier.key)].update({ status: \"open\", updatedAt: new Date() }))\r\n    }\r\n\r\n    await this.db.transact(txs)\r\n  }\r\n\r\n  async eventsToModelMessages(events: ContextEvent[]): Promise<ModelMessage[]> {\r\n    return await convertEventsToModelMessages(events)\r\n  }\r\n}\r\n\r\n/**\r\n * Helper to create a StoryRuntimeResolver that returns an InstantStore.\r\n *\r\n * This keeps the app-level `ekairos.ts` extremely small.\r\n */\r\nexport function createInstantStoreRuntime(params: {\r\n  getDb: (orgId: string) => Promise<InstantStoreDb> | InstantStoreDb\r\n  getOrgId?: (env: Record<string, unknown>) => string\r\n}) {\r\n  const storesByOrg = new Map<string, InstantStore>()\r\n\r\n  return async (env: Record<string, unknown>) => {\r\n    const orgId =\r\n      params.getOrgId?.(env) ??\r\n      (typeof (env as any)?.orgId === \"string\" ? String((env as any).orgId) : \"\")\r\n    if (!orgId) {\r\n      throw new Error('[instant] Missing orgId in env. Provide env.orgId (or customize getOrgId).')\r\n    }\r\n\r\n    const cached = storesByOrg.get(orgId)\r\n    if (cached) return { store: cached }\r\n\r\n    const db = await params.getDb(orgId)\r\n    const store = new InstantStore(db)\r\n    storesByOrg.set(orgId, store)\r\n    return { store }\r\n  }\r\n}\r\n\r\n\r\n\r\n"]}

package/dist/story.builder.d.ts

@@ -0,0 +1,116 @@
+import type { Tool } from "ai";
+import type { StoryEnvironment } from "./story.config";
+import { Story, type StoryModelInit, type StoryOptions, type ShouldContinue, type StoryShouldContinueArgs, type StoryReactParams } from "./story.engine";
+import type { ContextEvent, StoredContext } from "./story.store";
+import { type StoryKey } from "./story.registry";
+export interface StoryConfig<Context, Env extends StoryEnvironment = StoryEnvironment> {
+    context: (context: StoredContext<Context>, env: Env) => Promise<Context> | Context;
+    /**
+     * Event expansion stage (first-class; executed by the engine on every loop iteration).
+     *
+     * Runs inside the Story loop after events are loaded from the store and before
+     * they are converted into model messages.
+     *
+     * This is the intended place to do "document expansion" (turn file references
+     * into text parts) using LlamaCloud/Reducto/etc.
+     *
+     * If you do not provide an implementation, the default is an identity transform
+     * (events pass through unchanged).
+     *
+     * If you do I/O here, implement it as a `"use step"` function.
+     */
+    expandEvents?: (events: ContextEvent[], context: StoredContext<Context>, env: Env) => Promise<ContextEvent[]> | ContextEvent[];
+    /**
+     * Story-first "system" message for the model for this story run.
+     */
+    narrative: (context: StoredContext<Context>, env: Env) => Promise<string> | string;
+    /**
+     * Actions available to the model (aka "tools" in AI SDK terminology).
+     */
+    actions: (context: StoredContext<Context>, env: Env) => Promise<Record<string, Tool>> | Record<string, Tool>;
+    /**
+     * @deprecated Use `actions()` instead.
+     */
+    tools?: (context: StoredContext<Context>, env: Env) => Promise<Record<string, Tool>> | Record<string, Tool>;
+    /**
+     * Model configuration (DurableAgent-style).
+     *
+     * - `string`: AI Gateway model id, resolved in the LLM step (e.g. `"openai/gpt-5.1-thinking"`).
+     * - `() => Promise<model>`: model factory. For Workflow compatibility, provide a `"use step"` function
+     *   so it can be serialized by reference.
+     * - `(context, env) => ...`: dynamic selection based on current context/env (runs in workflow context).
+     */
+    model?: StoryModelInit | ((context: StoredContext<Context>, env: Env) => StoryModelInit);
+    /**
+     * Called after each streamed model "reaction" and subsequent tool executions.
+     *
+     * Use this to decide whether the story loop should continue.
+     *
+     * - `true`  => continue looping
+     * - `false` => finalize the story run
+     */
+    shouldContinue?: (args: StoryShouldContinueArgs<Context, Env>) => Promise<ShouldContinue> | ShouldContinue;
+    opts?: StoryOptions<Context, Env>;
+}
+export type StoryInstance<Context, Env extends StoryEnvironment = StoryEnvironment> = Story<Context, Env> & {
+    readonly __config: StoryConfig<Context, Env>;
+};
+export declare function story<Context, Env extends StoryEnvironment = StoryEnvironment>(config: StoryConfig<Context, Env>): StoryInstance<Context, Env>;
+type AnyContextInitializer<Env extends StoryEnvironment> = (context: StoredContext<any>, env: Env) => Promise<any> | any;
+type InferContextFromInitializer<I extends AnyContextInitializer<any>> = Awaited<ReturnType<I>>;
+type BuilderSystemPrompt<Context, Env extends StoryEnvironment> = (context: StoredContext<Context>, env: Env) => Promise<string> | string;
+type BuilderTools<Context, Env extends StoryEnvironment> = (context: StoredContext<Context>, env: Env) => Promise<Record<string, Tool>> | Record<string, Tool>;
+type BuilderExpandEvents<Context, Env extends StoryEnvironment> = (events: ContextEvent[], context: StoredContext<Context>, env: Env) => Promise<ContextEvent[]> | ContextEvent[];
+type BuilderShouldContinue<Context, Env extends StoryEnvironment> = (args: StoryShouldContinueArgs<Context, Env>) => Promise<ShouldContinue> | ShouldContinue;
+type BuilderModel<Context, Env extends StoryEnvironment> = StoryModelInit | ((context: StoredContext<Context>, env: Env) => StoryModelInit);
+export type RegistrableStoryBuilder = {
+    key: StoryKey;
+    register: () => void;
+};
+type FluentStoryBuilder<Context, Env extends StoryEnvironment> = {
+    key: StoryKey;
+    expandEvents(fn: BuilderExpandEvents<Context, Env>): FluentStoryBuilder<Context, Env>;
+    narrative(fn: BuilderSystemPrompt<Context, Env>): FluentStoryBuilder<Context, Env>;
+    /**
+     * "System" facade (AI SDK terminology).
+     */
+    system(fn: BuilderSystemPrompt<Context, Env>): FluentStoryBuilder<Context, Env>;
+    actions(fn: BuilderTools<Context, Env>): FluentStoryBuilder<Context, Env>;
+    /**
+     * @deprecated Use `actions()` instead.
+     */
+    tools(fn: BuilderTools<Context, Env>): FluentStoryBuilder<Context, Env>;
+    model(model: BuilderModel<Context, Env>): FluentStoryBuilder<Context, Env>;
+    /**
+     * Stop/continue hook (DurableAgent-like stop condition).
+     */
+    shouldContinue(fn: BuilderShouldContinue<Context, Env>): FluentStoryBuilder<Context, Env>;
+    opts(opts: StoryOptions<Context, Env>): FluentStoryBuilder<Context, Env>;
+    /**
+     * Convenience: react to an incoming event without requiring an explicit `.build()`.
+     *
+     * This still validates the config is complete (same as `.build()`), then delegates to the
+     * underlying `Story.react(...)`.
+     */
+    react(triggerEvent: ContextEvent, params: StoryReactParams<Env>): ReturnType<Story<Context, Env>["react"]>;
+    /**
+     * @deprecated Use `react()` instead. Kept for backwards compatibility.
+     */
+    stream(triggerEvent: ContextEvent, params: StoryReactParams<Env>): ReturnType<Story<Context, Env>["react"]>;
+    /**
+     * Registers this story definition in the global registry under `key`.
+     *
+     * This is intended to be called at module load / boot time so durable workflows
+     * can resume and still resolve the story by key without requiring an endpoint
+     * to call `.build()` again.
+     */
+    register(): void;
+    config(): StoryConfig<Context, Env>;
+    build(): StoryInstance<Context, Env>;
+};
+type CreateStoryEntry<Env extends StoryEnvironment> = {
+    context<Initializer extends AnyContextInitializer<Env>>(initializer: Initializer): FluentStoryBuilder<InferContextFromInitializer<Initializer>, Env>;
+    initialize<Initializer extends AnyContextInitializer<Env>>(initializer: Initializer): FluentStoryBuilder<InferContextFromInitializer<Initializer>, Env>;
+};
+export declare function createStory<Env extends StoryEnvironment = StoryEnvironment>(key: StoryKey): CreateStoryEntry<Env>;
+export {};

package/dist/story.builder.d.ts.map

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

package/dist/story.builder.js

@@ -0,0 +1,130 @@
+import { Story, } from "./story.engine";
+import { registerStory } from "./story.registry";
+export function story(config) {
+    class FunctionalStory extends Story {
+        constructor() {
+            super(config.opts);
+            this.__config = config;
+        }
+        async initialize(context, env) {
+            return config.context(context, env);
+        }
+        async expandEvents(events, context, env) {
+            if (config.expandEvents)
+                return config.expandEvents(events, context, env);
+            return super.expandEvents(events, context, env);
+        }
+        async buildSystemPrompt(context, env) {
+            if (config.narrative)
+                return config.narrative(context, env);
+            throw new Error("Story config is missing narrative()");
+        }
+        async buildTools(context, env) {
+            // Back-compat: accept `tools` in old configs.
+            if (config.actions)
+                return config.actions(context, env);
+            if (config.tools)
+                return config.tools(context, env);
+            throw new Error("Story config is missing actions()");
+        }
+        getModel(context, env) {
+            if (typeof config.model === "function")
+                return config.model(context, env);
+            return config.model ?? super.getModel(context, env);
+        }
+        async shouldContinue(args) {
+            if (config.shouldContinue)
+                return config.shouldContinue(args);
+            return true;
+        }
+    }
+    const instance = new FunctionalStory();
+    return Object.assign(instance, { __config: config });
+}
+function assertConfigComplete(config) {
+    if (!config.context) {
+        throw new Error("createStory: you must define context() before building the story.");
+    }
+    if (!config.narrative) {
+        throw new Error("createStory: you must define narrative() before building the story.");
+    }
+    if (!config.actions && !config.tools) {
+        throw new Error("createStory: you must define actions() before building the story.");
+    }
+}
+export function createStory(key) {
+    const initializeBuilder = (initializer) => {
+        const typedInitializer = (ctx, env) => initializer(ctx, env);
+        const fluentState = {
+            context: typedInitializer,
+        };
+        let cached = null;
+        const builder = {
+            key,
+            expandEvents(fn) {
+                fluentState.expandEvents = fn;
+                return builder;
+            },
+            narrative(narrative) {
+                fluentState.narrative = narrative;
+                return builder;
+            },
+            system(system) {
+                // Facade alias.
+                fluentState.narrative = system;
+                return builder;
+            },
+            actions(actionsFactory) {
+                fluentState.actions = actionsFactory;
+                return builder;
+            },
+            tools(toolsFactory) {
+                // Back-compat alias.
+                fluentState.actions = toolsFactory;
+                return builder;
+            },
+            model(model) {
+                fluentState.model = model;
+                return builder;
+            },
+            shouldContinue(fn) {
+                fluentState.shouldContinue = fn;
+                return builder;
+            },
+            opts(options) {
+                fluentState.opts = options;
+                return builder;
+            },
+            react(triggerEvent, params) {
+                assertConfigComplete(fluentState);
+                if (!cached) {
+                    const config = fluentState;
+                    cached = story(config);
+                }
+                return cached.react(triggerEvent, params);
+            },
+            stream(triggerEvent, params) {
+                return builder.react(triggerEvent, params);
+            },
+            register() {
+                assertConfigComplete(fluentState);
+                const config = fluentState;
+                registerStory(key, () => story(config));
+            },
+            config() {
+                assertConfigComplete(fluentState);
+                return fluentState;
+            },
+            build() {
+                assertConfigComplete(fluentState);
+                const config = fluentState;
+                return story(config);
+            },
+        };
+        return builder;
+    };
+    return {
+        context: initializeBuilder,
+        initialize: initializeBuilder,
+    };
+}

package/dist/story.builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"story.builder.js","sourceRoot":"","sources":["../src/story.builder.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Tool } from \"ai\"\n\nimport type { StoryEnvironment } from \"./story.config\"\nimport { Story, type StoryOptions } from \"./story.engine\"\nimport type { ContextEvent, StoredContext } from \"./story.store\"\nimport { registerStory, type StoryKey } from \"./story.registry\"\n\nexport interface StoryConfig<\n  Context,\n  Env extends StoryEnvironment = StoryEnvironment,\n> {\n  context: (context: StoredContext<Context>, env: Env) => Promise<Context> | Context\n  /**\n   * Event expansion stage (first-class; executed by the engine on every loop iteration).\n   *\n   * Runs inside the Story loop after events are loaded from the store and before\n   * they are converted into model messages.\n   *\n   * This is the intended place to do \"document expansion\" (turn file references\n   * into text parts) using LlamaCloud/Reducto/etc.\n   *\n   * If you do not provide an implementation, the default is an identity transform\n   * (events pass through unchanged).\n   *\n   * If you do I/O here, implement it as a `\"use step\"` function.\n   */\n  expandEvents?: (\n    events: ContextEvent[],\n    context: StoredContext<Context>,\n    env: Env,\n  ) => Promise<ContextEvent[]> | ContextEvent[]\n  systemPrompt: (\n    context: StoredContext<Context>,\n    env: Env,\n  ) => Promise<string> | string\n  tools: (\n    context: StoredContext<Context>,\n    env: Env,\n  ) => Promise<Record<string, Tool>> | Record<string, Tool>\n  model?: any | ((context: StoredContext<Context>, env: Env) => any)\n  opts?: StoryOptions<Context, Env>\n}\n\nexport type StoryInstance<\n  Context,\n  Env extends StoryEnvironment = StoryEnvironment,\n> = Story<Context, Env> & {\n  readonly __config: StoryConfig<Context, Env>\n}\n\nexport function story<\n  Context,\n  Env extends StoryEnvironment = StoryEnvironment,\n>(config: StoryConfig<Context, Env>): StoryInstance<Context, Env> {\n  class FunctionalStory extends Story<Context, Env> {\n    public readonly __config = config\n\n    constructor() {\n      super(config.opts)\n    }\n\n    protected async initialize(context: StoredContext<Context>, env: Env) {\n      return config.context(context, env)\n    }\n\n    protected async expandEvents(\n      events: ContextEvent[],\n      context: StoredContext<Context>,\n      env: Env,\n    ) {\n      if (config.expandEvents) return config.expandEvents(events, context, env)\n      return super.expandEvents(events, context, env)\n    }\n\n    protected async buildSystemPrompt(context: StoredContext<Context>, env: Env) {\n      return config.systemPrompt(context, env)\n    }\n\n    protected async buildTools(context: StoredContext<Context>, env: Env) {\n      return config.tools(context, env)\n    }\n\n    protected getModel(context: StoredContext<Context>, env: Env) {\n      if (typeof config.model === \"function\") return config.model(context, env)\n      return config.model ?? super.getModel(context, env)\n    }\n  }\n\n  const instance = new FunctionalStory()\n  return Object.assign(instance, { __config: config })\n}\n\ntype AnyContextInitializer<Env extends StoryEnvironment> = (\n  context: StoredContext<any>,\n  env: Env,\n) => Promise<any> | any\n\ntype InferContextFromInitializer<I extends AnyContextInitializer<any>> = Awaited<\n  ReturnType<I>\n>\n\ntype BuilderSystemPrompt<Context, Env extends StoryEnvironment> = (\n  context: StoredContext<Context>,\n  env: Env,\n) => Promise<string> | string\n\ntype BuilderTools<Context, Env extends StoryEnvironment> = (\n  context: StoredContext<Context>,\n  env: Env,\n) => Promise<Record<string, Tool>> | Record<string, Tool>\n\ntype BuilderExpandEvents<Context, Env extends StoryEnvironment> = (\n  events: ContextEvent[],\n  context: StoredContext<Context>,\n  env: Env,\n) => Promise<ContextEvent[]> | ContextEvent[]\n\ntype BuilderModel<Context, Env extends StoryEnvironment> =\n  | any\n  | ((context: StoredContext<Context>, env: Env) => any)\n\nexport type RegistrableStoryBuilder = {\n  key: StoryKey\n  register: () => void\n}\n\ntype FluentStoryBuilder<Context, Env extends StoryEnvironment> = {\n  key: StoryKey\n  expandEvents(fn: BuilderExpandEvents<Context, Env>): FluentStoryBuilder<Context, Env>\n  systemPrompt(fn: BuilderSystemPrompt<Context, Env>): FluentStoryBuilder<Context, Env>\n  tools(fn: BuilderTools<Context, Env>): FluentStoryBuilder<Context, Env>\n  model(model: BuilderModel<Context, Env>): FluentStoryBuilder<Context, Env>\n  opts(opts: StoryOptions<Context, Env>): FluentStoryBuilder<Context, Env>\n  /**\n   * Registers this story definition in the global registry under `key`.\n   *\n   * This is intended to be called at module load / boot time so durable workflows\n   * can resume and still resolve the story by key without requiring an endpoint\n   * to call `.build()` again.\n   */\n  register(): void\n  config(): StoryConfig<Context, Env>\n  build(): StoryInstance<Context, Env>\n}\n\ntype CreateStoryEntry<Env extends StoryEnvironment> = {\n  context<Initializer extends AnyContextInitializer<Env>>(\n    initializer: Initializer,\n  ): FluentStoryBuilder<InferContextFromInitializer<Initializer>, Env>\n  initialize<Initializer extends AnyContextInitializer<Env>>(\n    initializer: Initializer,\n  ): FluentStoryBuilder<InferContextFromInitializer<Initializer>, Env>\n}\n\nfunction assertConfigComplete<Context, Env extends StoryEnvironment>(\n  config: Partial<StoryConfig<Context, Env>>,\n): asserts config is StoryConfig<Context, Env> {\n  if (!config.context) {\n    throw new Error(\"createStory: you must define context() before building the story.\")\n  }\n  if (!config.systemPrompt) {\n    throw new Error(\"createStory: you must define systemPrompt() before building the story.\")\n  }\n  if (!config.tools) {\n    throw new Error(\"createStory: you must define tools() before building the story.\")\n  }\n}\n\nexport function createStory<Env extends StoryEnvironment = StoryEnvironment>(\n  key: StoryKey,\n): CreateStoryEntry<Env>\n\nexport function createStory<Env extends StoryEnvironment = StoryEnvironment>(\n  key: StoryKey,\n): CreateStoryEntry<Env> {\n  const initializeBuilder = <Initializer extends AnyContextInitializer<Env>>(\n    initializer: Initializer,\n  ) => {\n    type Context = InferContextFromInitializer<Initializer>\n\n    const typedInitializer: StoryConfig<Context, Env>[\"context\"] = (ctx, env) =>\n      initializer(ctx as StoredContext<Context>, env)\n\n    const fluentState: Partial<StoryConfig<Context, Env>> = {\n      context: typedInitializer,\n    }\n\n    const builder: FluentStoryBuilder<Context, Env> = {\n      key,\n                  expandEvents(fn) {\n                    fluentState.expandEvents = fn\n                    return builder\n                  },\n      systemPrompt(systemPrompt) {\n        fluentState.systemPrompt = systemPrompt\n        return builder\n      },\n      tools(toolsFactory) {\n        fluentState.tools = toolsFactory\n        return builder\n      },\n      model(model) {\n        fluentState.model = model as any\n        return builder\n      },\n      opts(options) {\n        fluentState.opts = options\n        return builder\n      },\n      register() {\n        assertConfigComplete(fluentState)\n        const config = fluentState as StoryConfig<Context, Env>\n        registerStory(key, () => story(config) as any)\n      },\n      config() {\n        assertConfigComplete(fluentState)\n        return fluentState\n      },\n      build() {\n        assertConfigComplete(fluentState)\n        const config = fluentState as StoryConfig<Context, Env>\n        return story(config)\n      },\n    }\n\n    return builder\n  }\n\n  return {\n    context: initializeBuilder,\n    initialize: initializeBuilder,\n  }\n}\n\n\n\n"]}

package/dist/story.config.d.ts

@@ -0,0 +1,43 @@
+import type { StoryStore } from "./story.store";
+/**
+ * ## story.config.ts
+ *
+ * Workflow-first story execution means we **cannot** keep non-serializable runtime objects
+ * (database clients, network handles, SDK instances) inside workflow state.
+ *
+ * Instead, we centralize runtime construction behind a global resolver:
+ * - The workflow passes a **serializable** `StoryEnvironment` into steps.
+ * - Steps call `resolveStoryRuntime(env)` to instantiate the right store (Instant/Postgres/etc).
+ *
+ * This keeps `createStory(...)` purely declarative while still allowing per-tenant/per-org routing.
+ */
+export type StoryEnvironment = Record<string, unknown>;
+export type StoryRuntime = {
+    store: StoryStore;
+};
+export type StoryRuntimeResolver<Env extends StoryEnvironment = StoryEnvironment> = (env: Env) => Promise<StoryRuntime> | StoryRuntime;
+/**
+ * Optional global bootstrap hook for step runtimes.
+ *
+ * Motivation:
+ * - Workflow step runtimes may execute in a separate process/bundle.
+ * - If the app's `ekairos.ts` was not evaluated in that runtime yet, the story runtime
+ *   resolver won't be configured and store steps will fail.
+ *
+ * Convention:
+ * - Apps should have a single `ekairos.ts` that creates `ekairosConfig` and calls `ekairosConfig.setup()`.
+ * - That module (or `createEkairosConfig().setup()`) can register this bootstrap function,
+ *   so library steps can "pull" initialization on-demand before first store access.
+ */
+type RuntimeBootstrap = () => void | Promise<void>;
+export declare function configureStoryRuntimeBootstrap(bootstrap: RuntimeBootstrap): void;
+/**
+ * Configure the story runtime resolver (global).
+ *
+ * This should be called once during initialization (module load) in your app.
+ * The resolver itself will be invoked inside steps, where it can safely create DB clients.
+ */
+export declare function configureStoryRuntime<Env extends StoryEnvironment>(resolver: StoryRuntimeResolver<Env>): void;
+export declare function isStoryRuntimeConfigured(): boolean;
+export declare function resolveStoryRuntime(env: StoryEnvironment): Promise<StoryRuntime>;
+export {};

package/dist/story.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"story.config.d.ts","sourceRoot":"","sources":["../src/story.config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAE/C;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEtD,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,UAAU,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,oBAAoB,CAAC,GAAG,SAAS,gBAAgB,GAAG,gBAAgB,IAAI,CAClF,GAAG,EAAE,GAAG,KACL,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAA;AAIzC;;;;;;;;;;;;GAYG;AACH,KAAK,gBAAgB,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAIlD,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,gBAAgB,QAEzE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,SAAS,gBAAgB,EAChE,QAAQ,EAAE,oBAAoB,CAAC,GAAG,CAAC,QAGpC;AAED,wBAAgB,wBAAwB,YAEvC;AAED,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAmBtF"}

package/dist/story.config.js

@@ -0,0 +1,57 @@
+let runtimeResolver = null;
+function getRuntimeResolver() {
+    return runtimeResolver;
+}
+let runtimeBootstrap = null;
+export function configureStoryRuntimeBootstrap(bootstrap) {
+    runtimeBootstrap = bootstrap;
+}
+/**
+ * Configure the story runtime resolver (global).
+ *
+ * This should be called once during initialization (module load) in your app.
+ * The resolver itself will be invoked inside steps, where it can safely create DB clients.
+ */
+export function configureStoryRuntime(resolver) {
+    runtimeResolver = resolver;
+}
+export function isStoryRuntimeConfigured() {
+    return Boolean(runtimeResolver);
+}
+export async function resolveStoryRuntime(env) {
+    if (!getRuntimeResolver()) {
+        // Best-effort: allow the step runtime to self-bootstrap once.
+        if (runtimeBootstrap) {
+            await runtimeBootstrap();
+        }
+        // Convention bootstrap (Next.js / monorepo apps):
+        // If the app exposes `src/ekairos.ts` and uses the `@/` alias, loading that module will
+        // run `ekairosConfig.setup()` which configures the resolver + bootstrap hook.
+        //
+        // This is intentionally ONLY attempted when runtime is missing, and is safe as long as
+        // `story.config` is not part of client bundles (see `@ekairos/story/runtime`).
+        if (!getRuntimeResolver()) {
+            try {
+                // @ts-expect-error - optional, app-provided convention module
+                await import("@/ekairos");
+            }
+            catch {
+                // ignore: module missing / alias not configured
+            }
+        }
+        // If bootstrap succeeded, proceed.
+        const resolver = getRuntimeResolver();
+        if (resolver)
+            return await resolver(env);
+        throw new Error([
+            "Story runtime is not configured.",
+            "",
+            "Convention:",
+            "- Create an app-level `ekairos.ts` that exports `ekairosConfig = createEkairosConfig({ runtime })`",
+            "- Ensure `ekairosConfig.setup()` runs in the step runtime (module load / worker boot).",
+            "",
+            "If you already have that file, ensure it is evaluated in the step runtime before calling story store steps.",
+        ].join("\n"));
+    }
+    return await getRuntimeResolver()(env);
+}

package/dist/story.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"story.config.js","sourceRoot":"","sources":["../src/story.config.ts"],"names":[],"mappings":"AAyBA,IAAI,eAAe,GAAqC,IAAI,CAAA;AAiB5D,IAAI,gBAAgB,GAA4B,IAAI,CAAA;AAEpD,MAAM,UAAU,8BAA8B,CAAC,SAA2B;IACxE,gBAAgB,GAAG,SAAS,CAAA;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAmC;IAEnC,eAAe,GAAG,QAAe,CAAA;AACnC,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,OAAO,CAAC,eAAe,CAAC,CAAA;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAqB;IAC7D,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,8DAA8D;QAC9D,IAAI,gBAAgB,EAAE,CAAC;YACrB,MAAM,gBAAgB,EAAE,CAAA;QAC1B,CAAC;QACD,MAAM,IAAI,KAAK,CACb;YACE,kCAAkC;YAClC,EAAE;YACF,aAAa;YACb,oGAAoG;YACpG,wFAAwF;YACxF,EAAE;YACF,6GAA6G;SAC9G,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAA;IACH,CAAC;IACD,OAAO,MAAM,eAAe,CAAC,GAAG,CAAC,CAAA;AACnC,CAAC","sourcesContent":["import type { StoryStore } from \"./story.store\"\r\n\r\n/**\r\n * ## story.config.ts\r\n *\r\n * Workflow-first story execution means we **cannot** keep non-serializable runtime objects\r\n * (database clients, network handles, SDK instances) inside workflow state.\r\n *\r\n * Instead, we centralize runtime construction behind a global resolver:\r\n * - The workflow passes a **serializable** `StoryEnvironment` into steps.\r\n * - Steps call `resolveStoryRuntime(env)` to instantiate the right store (Instant/Postgres/etc).\r\n *\r\n * This keeps `createStory(...)` purely declarative while still allowing per-tenant/per-org routing.\r\n */\r\n\r\nexport type StoryEnvironment = Record<string, unknown>\r\n\r\nexport type StoryRuntime = {\r\n  store: StoryStore\r\n}\r\n\r\nexport type StoryRuntimeResolver<Env extends StoryEnvironment = StoryEnvironment> = (\r\n  env: Env\r\n) => Promise<StoryRuntime> | StoryRuntime\r\n\r\nlet runtimeResolver: StoryRuntimeResolver<any> | null = null\r\n\r\n/**\r\n * Optional global bootstrap hook for step runtimes.\r\n *\r\n * Motivation:\r\n * - Workflow step runtimes may execute in a separate process/bundle.\r\n * - If the app's `ekairos.ts` was not evaluated in that runtime yet, the story runtime\r\n *   resolver won't be configured and store steps will fail.\r\n *\r\n * Convention:\r\n * - Apps should have a single `ekairos.ts` that creates `ekairosConfig` and calls `ekairosConfig.setup()`.\r\n * - That module (or `createEkairosConfig().setup()`) can register this bootstrap function,\r\n *   so library steps can \"pull\" initialization on-demand before first store access.\r\n */\r\ntype RuntimeBootstrap = () => void | Promise<void>\r\n\r\nlet runtimeBootstrap: RuntimeBootstrap | null = null\r\n\r\nexport function configureStoryRuntimeBootstrap(bootstrap: RuntimeBootstrap) {\r\n  runtimeBootstrap = bootstrap\r\n}\r\n\r\n/**\r\n * Configure the story runtime resolver (global).\r\n *\r\n * This should be called once during initialization (module load) in your app.\r\n * The resolver itself will be invoked inside steps, where it can safely create DB clients.\r\n */\r\nexport function configureStoryRuntime<Env extends StoryEnvironment>(\r\n  resolver: StoryRuntimeResolver<Env>,\r\n) {\r\n  runtimeResolver = resolver as any\r\n}\r\n\r\nexport function isStoryRuntimeConfigured() {\r\n  return Boolean(runtimeResolver)\r\n}\r\n\r\nexport async function resolveStoryRuntime(env: StoryEnvironment): Promise<StoryRuntime> {\r\n  if (!runtimeResolver) {\r\n    // Best-effort: allow the step runtime to self-bootstrap once.\r\n    if (runtimeBootstrap) {\r\n      await runtimeBootstrap()\r\n    }\r\n    throw new Error(\r\n      [\r\n        \"Story runtime is not configured.\",\r\n        \"\",\r\n        \"Convention:\",\r\n        \"- Create an app-level `ekairos.ts` that exports `ekairosConfig = createEkairosConfig({ runtime })`\",\r\n        \"- Ensure `ekairosConfig.setup()` runs in the step runtime (module load / worker boot).\",\r\n        \"\",\r\n        \"If you already have that file, ensure it is evaluated in the step runtime before calling story store steps.\",\r\n      ].join(\"\\n\"),\r\n    )\r\n  }\r\n  return await runtimeResolver(env)\r\n}\r\n\r\n\r\n\r\n"]}