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

package/dist/steps/store.steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.steps.js","sourceRoot":"","sources":["../../src/steps/store.steps.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ModelMessage } from \"ai\"\r\n\r\nimport { resolveStoryRuntime, type StoryEnvironment } from \"../story.config\"\r\nimport type { ContextEvent, ContextIdentifier, StoredContext } from \"../story.store\"\r\n\r\nexport async function generateId(): Promise<string> {\r\n  \"use step\"\r\n  // Use crypto.randomUUID when available (Node 18+)\r\n  const uuid = (globalThis.crypto as any)?.randomUUID?.()\r\n  if (uuid) return uuid\r\n\r\n  // Fallback\r\n  return `${Date.now()}-${Math.random().toString(16).slice(2)}`\r\n}\r\n\r\nexport async function getOrCreateContext<C>(\r\n  env: StoryEnvironment,\r\n  contextIdentifier: ContextIdentifier | null,\r\n): Promise<{ context: StoredContext<C>; isNew: boolean }> {\r\n  \"use step\"\r\n  const { store } = await resolveStoryRuntime(env)\r\n\r\n  // Detect creation explicitly so the engine can run onContextCreated hooks.\r\n  if (!contextIdentifier) {\r\n    const context = await store.getOrCreateContext<C>(null)\r\n    return { context, isNew: true }\r\n  }\r\n\r\n  const existing = await store.getContext<C>(contextIdentifier)\r\n  if (existing) return { context: existing, isNew: false }\r\n\r\n  const created = await store.getOrCreateContext<C>(contextIdentifier)\r\n  return { context: created, isNew: true }\r\n}\r\n\r\nexport async function getContext<C>(\r\n  env: StoryEnvironment,\r\n  contextIdentifier: ContextIdentifier,\r\n): Promise<StoredContext<C> | null> {\r\n  \"use step\"\r\n  const { store } = await resolveStoryRuntime(env)\r\n  return await store.getContext<C>(contextIdentifier)\r\n}\r\n\r\nexport async function updateContextContent<C>(\r\n  env: StoryEnvironment,\r\n  contextIdentifier: ContextIdentifier,\r\n  content: C,\r\n): Promise<StoredContext<C>> {\r\n  \"use step\"\r\n  const { store } = await resolveStoryRuntime(env)\r\n  return await store.updateContextContent<C>(contextIdentifier, content)\r\n}\r\n\r\nexport async function updateContextStatus(\r\n  env: StoryEnvironment,\r\n  contextIdentifier: ContextIdentifier,\r\n  status: \"open\" | \"streaming\" | \"closed\",\r\n): Promise<void> {\r\n  \"use step\"\r\n  const { store } = await resolveStoryRuntime(env)\r\n  await store.updateContextStatus(contextIdentifier, status)\r\n}\r\n\r\nexport async function saveEvent(\r\n  env: StoryEnvironment,\r\n  contextIdentifier: ContextIdentifier,\r\n  event: ContextEvent,\r\n): Promise<ContextEvent> {\r\n  \"use step\"\r\n  const { store } = await resolveStoryRuntime(env)\r\n  return await store.saveEvent(contextIdentifier, event)\r\n}\r\n\r\nexport async function updateEvent(\r\n  env: StoryEnvironment,\r\n  eventId: string,\r\n  event: ContextEvent,\r\n): Promise<ContextEvent> {\r\n  \"use step\"\r\n  const { store } = await resolveStoryRuntime(env)\r\n  return await store.updateEvent(eventId, event)\r\n}\r\n\r\nexport async function getEvents(\r\n  env: StoryEnvironment,\r\n  contextIdentifier: ContextIdentifier,\r\n): Promise<ContextEvent[]> {\r\n  \"use step\"\r\n  const { store } = await resolveStoryRuntime(env)\r\n  return await store.getEvents(contextIdentifier)\r\n}\r\n\r\nexport async function createExecution(\r\n  env: StoryEnvironment,\r\n  contextIdentifier: ContextIdentifier,\r\n  triggerEventId: string,\r\n  reactionEventId: string,\r\n): Promise<{ id: string }> {\r\n  \"use step\"\r\n  const { store } = await resolveStoryRuntime(env)\r\n  return await store.createExecution(contextIdentifier, triggerEventId, reactionEventId)\r\n}\r\n\r\nexport async function completeExecution(\r\n  env: StoryEnvironment,\r\n  contextIdentifier: ContextIdentifier,\r\n  executionId: string,\r\n  status: \"completed\" | \"failed\",\r\n): Promise<void> {\r\n  \"use step\"\r\n  const { store } = await resolveStoryRuntime(env)\r\n  await store.completeExecution(contextIdentifier, executionId, status)\r\n}\r\n\r\nexport async function eventsToModelMessages(\r\n  env: StoryEnvironment,\r\n  events: ContextEvent[],\r\n): Promise<ModelMessage[]> {\r\n  \"use step\"\r\n  const { store } = await resolveStoryRuntime(env)\r\n  return await store.eventsToModelMessages(events)\r\n}\r\n\r\n\r\n\r\n"]}

package/dist/steps/story.steps.d.ts

@@ -0,0 +1,35 @@
+import type { ContextEvent, ContextIdentifier } from "../service";
+import type { ProgressStreamOptions, Story } from "../story.engine";
+/**
+ * A Workflow-compatible writable stream (e.g. `getWritable()` from useworkflow).
+ *
+ * The Workflow DevKit streams are standard Web Streams and can be passed around
+ * (serialized as references) by the workflow runtime.
+ */
+export type WorkflowWritableStream<TChunk = any> = WritableStream<TChunk>;
+/**
+ * Creates Workflow step wrappers for a Story instance.
+ *
+ * Why:
+ * - Workflow functions must be deterministic.
+ * - All side-effects (LLM calls, DB calls, tool execution, stream IO) should happen in steps.
+ *
+ * Usage:
+ * - Inside a Workflow step, call `steps.progressToWritable(...)` and pass the workflow's writable stream.
+ */
+export declare function createStorySteps<Context>(story: Story<Context>): {
+    /**
+     * Runs `story.progressStream(...)` and pipes the resulting UI stream into the provided Workflow writable.
+     *
+     * This is the recommended integration point with Workflow DevKit streaming:
+     * - Workflow owns the stream.
+     * - Story writes chunks into it (via piping).
+     */
+    progressToWritable(params: {
+        incomingEvent: ContextEvent;
+        contextIdentifier: ContextIdentifier | null;
+        options?: ProgressStreamOptions;
+        writable: WorkflowWritableStream<any>;
+    }): Promise<any>;
+};
+//# sourceMappingURL=story.steps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"story.steps.d.ts","sourceRoot":"","sources":["../../src/steps/story.steps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAEnE;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,CAAC,MAAM,GAAG,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAA;AA6BzE;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;IAE3D;;;;;;OAMG;+BAC8B;QAC/B,aAAa,EAAE,YAAY,CAAA;QAC3B,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAA;QAC3C,OAAO,CAAC,EAAE,qBAAqB,CAAA;QAC/B,QAAQ,EAAE,sBAAsB,CAAC,GAAG,CAAC,CAAA;KACtC;EAgBJ"}

package/dist/steps/story.steps.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createStorySteps = createStorySteps;
+async function pipeReadableToWritable(readable, writable) {
+    const reader = readable.getReader();
+    const writer = writable.getWriter();
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            await writer.write(value);
+        }
+    }
+    finally {
+        try {
+            writer.releaseLock();
+        }
+        catch {
+            // noop
+        }
+        try {
+            reader.releaseLock();
+        }
+        catch {
+            // noop
+        }
+    }
+}
+/**
+ * Creates Workflow step wrappers for a Story instance.
+ *
+ * Why:
+ * - Workflow functions must be deterministic.
+ * - All side-effects (LLM calls, DB calls, tool execution, stream IO) should happen in steps.
+ *
+ * Usage:
+ * - Inside a Workflow step, call `steps.progressToWritable(...)` and pass the workflow's writable stream.
+ */
+function createStorySteps(story) {
+    return {
+        /**
+         * Runs `story.progressStream(...)` and pipes the resulting UI stream into the provided Workflow writable.
+         *
+         * This is the recommended integration point with Workflow DevKit streaming:
+         * - Workflow owns the stream.
+         * - Story writes chunks into it (via piping).
+         */
+        async progressToWritable(params) {
+            "use step";
+            const result = await story.progressStream(params.incomingEvent, params.contextIdentifier, params.options);
+            await pipeReadableToWritable(result.stream, params.writable);
+            // Return metadata (no stream) because Workflow already exposes the stream to clients.
+            const { stream: _stream, ...meta } = result;
+            return meta;
+        },
+    };
+}
+//# sourceMappingURL=story.steps.js.map

package/dist/steps/story.steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"story.steps.js","sourceRoot":"","sources":["../../src/steps/story.steps.ts"],"names":[],"mappings":";;AAgDA,4CA8BC;AAnED,KAAK,UAAU,sBAAsB,CACnC,QAAgC,EAChC,QAAwC;IAExC,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAA;IACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAA;IAEnC,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;YAC3C,IAAI,IAAI;gBAAE,MAAK;YACf,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;QAC3B,CAAC;IACH,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,CAAC,WAAW,EAAE,CAAA;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,CAAC,WAAW,EAAE,CAAA;QACtB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,gBAAgB,CAAU,KAAqB;IAC7D,OAAO;QACL;;;;;;WAMG;QACH,KAAK,CAAC,kBAAkB,CAAC,MAKxB;YACC,UAAU,CAAA;YAEV,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,cAAc,CACvC,MAAM,CAAC,aAAa,EACpB,MAAM,CAAC,iBAAiB,EACxB,MAAM,CAAC,OAAO,CACf,CAAA;YAED,MAAM,sBAAsB,CAAC,MAAM,CAAC,MAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;YAEnE,sFAAsF;YACtF,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,MAAa,CAAA;YAClD,OAAO,IAAI,CAAA;QACb,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["import type { ContextEvent, ContextIdentifier } from \"../service\"\r\nimport type { ProgressStreamOptions, Story } from \"../story.engine\"\r\n\r\n/**\r\n * A Workflow-compatible writable stream (e.g. `getWritable()` from useworkflow).\r\n *\r\n * The Workflow DevKit streams are standard Web Streams and can be passed around\r\n * (serialized as references) by the workflow runtime.\r\n */\r\nexport type WorkflowWritableStream<TChunk = any> = WritableStream<TChunk>\r\n\r\nasync function pipeReadableToWritable<TChunk>(\r\n  readable: ReadableStream<TChunk>,\r\n  writable: WorkflowWritableStream<TChunk>,\r\n): Promise<void> {\r\n  const reader = readable.getReader()\r\n  const writer = writable.getWriter()\r\n\r\n  try {\r\n    while (true) {\r\n      const { done, value } = await reader.read()\r\n      if (done) break\r\n      await writer.write(value)\r\n    }\r\n  } finally {\r\n    try {\r\n      writer.releaseLock()\r\n    } catch {\r\n      // noop\r\n    }\r\n    try {\r\n      reader.releaseLock()\r\n    } catch {\r\n      // noop\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Creates Workflow step wrappers for a Story instance.\r\n *\r\n * Why:\r\n * - Workflow functions must be deterministic.\r\n * - All side-effects (LLM calls, DB calls, tool execution, stream IO) should happen in steps.\r\n *\r\n * Usage:\r\n * - Inside a Workflow step, call `steps.progressToWritable(...)` and pass the workflow's writable stream.\r\n */\r\nexport function createStorySteps<Context>(story: Story<Context>) {\r\n  return {\r\n    /**\r\n     * Runs `story.progressStream(...)` and pipes the resulting UI stream into the provided Workflow writable.\r\n     *\r\n     * This is the recommended integration point with Workflow DevKit streaming:\r\n     * - Workflow owns the stream.\r\n     * - Story writes chunks into it (via piping).\r\n     */\r\n    async progressToWritable(params: {\r\n      incomingEvent: ContextEvent\r\n      contextIdentifier: ContextIdentifier | null\r\n      options?: ProgressStreamOptions\r\n      writable: WorkflowWritableStream<any>\r\n    }) {\r\n      \"use step\"\r\n\r\n      const result = await story.progressStream(\r\n        params.incomingEvent,\r\n        params.contextIdentifier,\r\n        params.options,\r\n      )\r\n\r\n      await pipeReadableToWritable(result.stream as any, params.writable)\r\n\r\n      // Return metadata (no stream) because Workflow already exposes the stream to clients.\r\n      const { stream: _stream, ...meta } = result as any\r\n      return meta\r\n    },\r\n  }\r\n}\r\n\r\n\r\n"]}

package/dist/steps/stream.steps.d.ts

@@ -0,0 +1,28 @@
+export declare function writeContextSubstate(params: {
+    /**
+     * Ephemeral substate key for the UI (story engine internal state).
+     *
+     * - Provide a string key like "actions" to set it
+     * - Provide null to clear it
+     */
+    key: string | null;
+    transient?: boolean;
+}): Promise<void>;
+export declare function writeContextIdChunk(params: {
+    contextId: string;
+}): Promise<void>;
+export declare function writeToolOutputs(params: {
+    results: Array<{
+        toolCallId: string;
+        success: true;
+        output: unknown;
+    } | {
+        toolCallId: string;
+        success: false;
+        errorText: string;
+    }>;
+}): Promise<void>;
+export declare function closeStoryStream(params: {
+    preventClose?: boolean;
+    sendFinish?: boolean;
+}): Promise<void>;

package/dist/steps/stream.steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.steps.d.ts","sourceRoot":"","sources":["../../src/steps/stream.steps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAEzC,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,QAAQ,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB,iBAaA;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,QAAQ,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IACzC,OAAO,EAAE,KAAK,CACV;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,IAAI,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,GACtD;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,KAAK,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAC5D,CAAC;CACH,iBAuBA;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,QAAQ,EAAE,cAAc,CAAC,cAAc,CAAC,CAAC;IACzC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,iBAkBA"}

package/dist/steps/stream.steps.js

@@ -0,0 +1,75 @@
+import { getWritable } from "workflow";
+export async function writeContextSubstate(params) {
+    "use step";
+    const writable = getWritable();
+    const writer = writable.getWriter();
+    try {
+        await writer.write({
+            type: "data-context-substate",
+            data: { key: params.key },
+            transient: params.transient ?? true,
+        });
+    }
+    finally {
+        writer.releaseLock();
+    }
+}
+export async function writeContextIdChunk(params) {
+    "use step";
+    const writable = getWritable();
+    const writer = writable.getWriter();
+    try {
+        await writer.write({
+            type: "data-context-id",
+            id: params.contextId,
+            data: { contextId: params.contextId },
+        });
+    }
+    finally {
+        writer.releaseLock();
+    }
+}
+export async function writeToolOutputs(params) {
+    "use step";
+    const writable = getWritable();
+    const writer = writable.getWriter();
+    try {
+        for (const r of params.results) {
+            if (r.success) {
+                await writer.write({
+                    type: "tool-output-available",
+                    toolCallId: r.toolCallId,
+                    output: r.output,
+                });
+            }
+            else {
+                await writer.write({
+                    type: "tool-output-error",
+                    toolCallId: r.toolCallId,
+                    errorText: r.errorText,
+                });
+            }
+        }
+    }
+    finally {
+        writer.releaseLock();
+    }
+}
+export async function closeStoryStream(params) {
+    "use step";
+    const sendFinish = params.sendFinish ?? true;
+    const preventClose = params.preventClose ?? false;
+    const writable = getWritable();
+    if (sendFinish) {
+        const writer = writable.getWriter();
+        try {
+            await writer.write({ type: "finish" });
+        }
+        finally {
+            writer.releaseLock();
+        }
+    }
+    if (!preventClose) {
+        await writable.close();
+    }
+}

package/dist/steps/stream.steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.steps.js","sourceRoot":"","sources":["../../src/steps/stream.steps.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAGzC;IACC,UAAU,CAAC;IAEX,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,KAAK,CAAC;YACjB,IAAI,EAAE,iBAAiB;YACvB,EAAE,EAAE,MAAM,CAAC,SAAS;YACpB,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE;SAC/B,CAAC,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAMtC;IACC,UAAU,CAAC;IAEX,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;IAC3C,IAAI,CAAC;QACH,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC/B,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBACd,MAAM,MAAM,CAAC,KAAK,CAAC;oBACjB,IAAI,EAAE,uBAAuB;oBAC7B,UAAU,EAAE,CAAC,CAAC,UAAU;oBACxB,MAAM,EAAE,CAAC,CAAC,MAAa;iBACjB,CAAC,CAAC;YACZ,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,CAAC,KAAK,CAAC;oBACjB,IAAI,EAAE,mBAAmB;oBACzB,UAAU,EAAE,CAAC,CAAC,UAAU;oBACxB,SAAS,EAAE,CAAC,CAAC,SAAS;iBAChB,CAAC,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,MAItC;IACC,UAAU,CAAC;IAEX,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,IAAI,CAAC;IAC7C,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,IAAI,KAAK,CAAC;IAElD,IAAI,UAAU,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC3C,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAS,CAAC,CAAC;QAChD,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;AACH,CAAC","sourcesContent":["import type { UIMessageChunk } from \"ai\";\r\n\r\nexport async function writeContextIdChunk(params: {\r\n  writable: WritableStream<UIMessageChunk>;\r\n  contextId: string;\r\n}) {\r\n  \"use step\";\r\n\r\n  const writer = params.writable.getWriter();\r\n  try {\r\n    await writer.write({\r\n      type: \"data-context-id\",\r\n      id: params.contextId,\r\n      data: { contextId: params.contextId },\r\n    } as any);\r\n  } finally {\r\n    writer.releaseLock();\r\n  }\r\n}\r\n\r\nexport async function writeToolOutputs(params: {\r\n  writable: WritableStream<UIMessageChunk>;\r\n  results: Array<\r\n    | { toolCallId: string; success: true; output: unknown }\r\n    | { toolCallId: string; success: false; errorText: string }\r\n  >;\r\n}) {\r\n  \"use step\";\r\n\r\n  const writer = params.writable.getWriter();\r\n  try {\r\n    for (const r of params.results) {\r\n      if (r.success) {\r\n        await writer.write({\r\n          type: \"tool-output-available\",\r\n          toolCallId: r.toolCallId,\r\n          output: r.output as any,\r\n        } as any);\r\n      } else {\r\n        await writer.write({\r\n          type: \"tool-output-error\",\r\n          toolCallId: r.toolCallId,\r\n          errorText: r.errorText,\r\n        } as any);\r\n      }\r\n    }\r\n  } finally {\r\n    writer.releaseLock();\r\n  }\r\n}\r\n\r\nexport async function closeStoryStream(params: {\r\n  writable: WritableStream<UIMessageChunk>;\r\n  preventClose?: boolean;\r\n  sendFinish?: boolean;\r\n}) {\r\n  \"use step\";\r\n\r\n  const sendFinish = params.sendFinish ?? true;\r\n  const preventClose = params.preventClose ?? false;\r\n\r\n  if (sendFinish) {\r\n    const writer = params.writable.getWriter();\r\n    try {\r\n      await writer.write({ type: \"finish\" } as any);\r\n    } finally {\r\n      writer.releaseLock();\r\n    }\r\n  }\r\n\r\n  if (!preventClose) {\r\n    await params.writable.close();\r\n  }\r\n}\r\n\r\n"]}

package/dist/stores/instant.document-parser.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Parses a document with LlamaParse and stores it in InstantDB (document_documents + link to file).
+ * Returns the created documentId.
+ */
+export declare function parseAndStoreDocument(db: any, buffer: Buffer, fileName: string, path: string, fileId: string): Promise<string>;

package/dist/stores/instant.document-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instant.document-parser.d.ts","sourceRoot":"","sources":["../../src/stores/instant.document-parser.ts"],"names":[],"mappings":"AAsGA;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,GAAG,EACP,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC,CAsDjB"}

package/dist/stores/instant.document-parser.js

@@ -0,0 +1,116 @@
+import { id } from "@instantdb/admin";
+const LLAMA_CLOUD_BASE_URL = "https://api.cloud.llamaindex.ai/api/v1";
+async function uploadToLlamaCloud(buffer, fileName) {
+    const formData = new FormData();
+    const uint8Array = new Uint8Array(buffer);
+    const blob = new Blob([uint8Array], { type: "application/pdf" });
+    formData.append("file", blob, fileName);
+    formData.append("parse_mode", "parse_page_with_llm");
+    formData.append("high_res_ocr", "true");
+    formData.append("adaptive_long_table", "true");
+    formData.append("outlined_table_extraction", "true");
+    formData.append("output_tables_as_HTML", "true");
+    const response = await fetch(`${LLAMA_CLOUD_BASE_URL}/parsing/upload`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${process.env.LLAMA_CLOUD_API_KEY}`,
+        },
+        body: formData,
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`LlamaCloud upload failed: ${response.status} ${errorText}`);
+    }
+    const result = (await response.json());
+    return result.id;
+}
+async function getJobStatus(jobId) {
+    const response = await fetch(`${LLAMA_CLOUD_BASE_URL}/parsing/job/${jobId}`, {
+        method: "GET",
+        headers: {
+            Authorization: `Bearer ${process.env.LLAMA_CLOUD_API_KEY}`,
+        },
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`LlamaCloud status fetch failed: ${response.status} ${errorText}`);
+    }
+    return (await response.json());
+}
+async function getParseResult(jobId) {
+    const response = await fetch(`${LLAMA_CLOUD_BASE_URL}/parsing/job/${jobId}/result/markdown`, {
+        method: "GET",
+        headers: {
+            Authorization: `Bearer ${process.env.LLAMA_CLOUD_API_KEY}`,
+        },
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`LlamaCloud result fetch failed: ${response.status} ${errorText}`);
+    }
+    return (await response.json());
+}
+async function waitForProcessing(jobId, maxAttempts = 60) {
+    for (let attempt = 0; attempt < maxAttempts; attempt++) {
+        const statusResponse = await getJobStatus(jobId);
+        if (statusResponse.status === "SUCCESS" || statusResponse.status === "COMPLETED") {
+            return await getParseResult(jobId);
+        }
+        if (statusResponse.status === "ERROR" || statusResponse.status === "FAILED") {
+            throw new Error(`LlamaCloud processing failed with status: ${statusResponse.status}`);
+        }
+        await new Promise((resolve) => setTimeout(resolve, 2000));
+    }
+    throw new Error("LlamaCloud processing timeout");
+}
+/**
+ * Parses a document with LlamaParse and stores it in InstantDB (document_documents + link to file).
+ * Returns the created documentId.
+ */
+export async function parseAndStoreDocument(db, buffer, fileName, path, fileId) {
+    const existingDocument = await db.query({
+        document_documents: {
+            $: {
+                where: { "file.id": fileId },
+            },
+            file: {},
+        },
+    });
+    if (existingDocument.document_documents && existingDocument.document_documents.length > 0) {
+        return existingDocument.document_documents[0].id;
+    }
+    const jobId = await uploadToLlamaCloud(buffer, fileName);
+    const result = await waitForProcessing(jobId);
+    const pages = [];
+    if (result.markdown) {
+        pages.push({
+            id: id(),
+            text: result.markdown,
+        });
+    }
+    if (result.pages && result.pages.length > 0) {
+        for (const page of result.pages) {
+            pages.push({
+                id: id(),
+                text: page.text,
+            });
+        }
+    }
+    if (pages.length === 0) {
+        throw new Error("No content extracted from document");
+    }
+    const documentId = id();
+    await db.transact([
+        db.tx.document_documents[documentId].update({
+            content: { pages },
+            name: fileName,
+            mimeType: "application/pdf",
+            createdAt: new Date(),
+            path,
+        }),
+        db.tx.document_documents[documentId].link({
+            file: fileId,
+        }),
+    ]);
+    return documentId;
+}

package/dist/stores/instant.document-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instant.document-parser.js","sourceRoot":"","sources":["../../src/stores/instant.document-parser.ts"],"names":[],"mappings":"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","sourcesContent":["import { id } from \"@instantdb/admin\";\r\n\r\nconst LLAMA_CLOUD_BASE_URL = \"https://api.cloud.llamaindex.ai/api/v1\";\r\n\r\ninterface DocumentPage {\r\n  id: string;\r\n  text: string;\r\n}\r\n\r\ninterface LlamaParseUploadResponse {\r\n  id: string;\r\n  status: string;\r\n}\r\n\r\ninterface LlamaParseStatusResponse {\r\n  status: string;\r\n}\r\n\r\ninterface LlamaParseResultResponse {\r\n  markdown?: string;\r\n  pages?: Array<{ page: number; text: string }>;\r\n}\r\n\r\nasync function uploadToLlamaCloud(buffer: Buffer, fileName: string): Promise<string> {\r\n  const formData = new FormData();\r\n\r\n  const uint8Array = new Uint8Array(buffer);\r\n  const blob = new Blob([uint8Array], { type: \"application/pdf\" });\r\n  formData.append(\"file\", blob, fileName);\r\n  formData.append(\"parse_mode\", \"parse_page_with_llm\");\r\n  formData.append(\"high_res_ocr\", \"true\");\r\n  formData.append(\"adaptive_long_table\", \"true\");\r\n  formData.append(\"outlined_table_extraction\", \"true\");\r\n  formData.append(\"output_tables_as_HTML\", \"true\");\r\n\r\n  const response = await fetch(`${LLAMA_CLOUD_BASE_URL}/parsing/upload`, {\r\n    method: \"POST\",\r\n    headers: {\r\n      Authorization: `Bearer ${process.env.LLAMA_CLOUD_API_KEY}`,\r\n    },\r\n    body: formData,\r\n  });\r\n\r\n  if (!response.ok) {\r\n    const errorText = await response.text();\r\n    throw new Error(`LlamaCloud upload failed: ${response.status} ${errorText}`);\r\n  }\r\n\r\n  const result = (await response.json()) as unknown as LlamaParseUploadResponse;\r\n  return result.id;\r\n}\r\n\r\nasync function getJobStatus(jobId: string): Promise<LlamaParseStatusResponse> {\r\n  const response = await fetch(`${LLAMA_CLOUD_BASE_URL}/parsing/job/${jobId}`, {\r\n    method: \"GET\",\r\n    headers: {\r\n      Authorization: `Bearer ${process.env.LLAMA_CLOUD_API_KEY}`,\r\n    },\r\n  });\r\n\r\n  if (!response.ok) {\r\n    const errorText = await response.text();\r\n    throw new Error(`LlamaCloud status fetch failed: ${response.status} ${errorText}`);\r\n  }\r\n\r\n  return (await response.json()) as unknown as LlamaParseStatusResponse;\r\n}\r\n\r\nasync function getParseResult(jobId: string): Promise<LlamaParseResultResponse> {\r\n  const response = await fetch(`${LLAMA_CLOUD_BASE_URL}/parsing/job/${jobId}/result/markdown`, {\r\n    method: \"GET\",\r\n    headers: {\r\n      Authorization: `Bearer ${process.env.LLAMA_CLOUD_API_KEY}`,\r\n    },\r\n  });\r\n\r\n  if (!response.ok) {\r\n    const errorText = await response.text();\r\n    throw new Error(`LlamaCloud result fetch failed: ${response.status} ${errorText}`);\r\n  }\r\n\r\n  return (await response.json()) as unknown as LlamaParseResultResponse;\r\n}\r\n\r\nasync function waitForProcessing(jobId: string, maxAttempts: number = 60): Promise<LlamaParseResultResponse> {\r\n  for (let attempt = 0; attempt < maxAttempts; attempt++) {\r\n    const statusResponse = await getJobStatus(jobId);\r\n\r\n    if (statusResponse.status === \"SUCCESS\" || statusResponse.status === \"COMPLETED\") {\r\n      return await getParseResult(jobId);\r\n    }\r\n\r\n    if (statusResponse.status === \"ERROR\" || statusResponse.status === \"FAILED\") {\r\n      throw new Error(`LlamaCloud processing failed with status: ${statusResponse.status}`);\r\n    }\r\n\r\n    await new Promise((resolve) => setTimeout(resolve, 2000));\r\n  }\r\n\r\n  throw new Error(\"LlamaCloud processing timeout\");\r\n}\r\n\r\n/**\r\n * Parses a document with LlamaParse and stores it in InstantDB (document_documents + link to file).\r\n * Returns the created documentId.\r\n */\r\nexport async function parseAndStoreDocument(\r\n  db: any,\r\n  buffer: Buffer,\r\n  fileName: string,\r\n  path: string,\r\n  fileId: string,\r\n): Promise<string> {\r\n  const existingDocument = await db.query({\r\n    document_documents: {\r\n      $: {\r\n        where: { \"file.id\": fileId },\r\n      },\r\n      file: {},\r\n    },\r\n  });\r\n\r\n  if (existingDocument.document_documents && existingDocument.document_documents.length > 0) {\r\n    return existingDocument.document_documents[0].id;\r\n  }\r\n\r\n  const jobId = await uploadToLlamaCloud(buffer, fileName);\r\n  const result = await waitForProcessing(jobId);\r\n\r\n  const pages: DocumentPage[] = [];\r\n\r\n  if (result.markdown) {\r\n    pages.push({\r\n      id: id(),\r\n      text: result.markdown,\r\n    });\r\n  }\r\n\r\n  if (result.pages && result.pages.length > 0) {\r\n    for (const page of result.pages) {\r\n      pages.push({\r\n        id: id(),\r\n        text: page.text,\r\n      });\r\n    }\r\n  }\r\n\r\n  if (pages.length === 0) {\r\n    throw new Error(\"No content extracted from document\");\r\n  }\r\n\r\n  const documentId = id();\r\n  await db.transact([\r\n    db.tx.document_documents[documentId].update({\r\n      content: { pages },\r\n      name: fileName,\r\n      mimeType: \"application/pdf\",\r\n      createdAt: new Date(),\r\n      path,\r\n    }),\r\n    db.tx.document_documents[documentId].link({\r\n      file: fileId,\r\n    }),\r\n  ]);\r\n\r\n  return documentId;\r\n}\r\n\r\n\r\n"]}

package/dist/stores/instant.documents.d.ts

@@ -0,0 +1,16 @@
+import type { ContextEvent } from "../story.store";
+export declare function coerceDocumentTextPages(documentRecord: any, opts?: {
+    pageLabelPrefix?: string;
+}): string;
+export declare function expandEventsWithInstantDocuments(params: {
+    db: any;
+    events: ContextEvent[];
+    /**
+     * Hard limit to avoid huge model inputs. Defaults to 120k chars of extracted text.
+     */
+    maxChars?: number;
+    /**
+     * Event type used for derived document text. Defaults to "document.parsed".
+     */
+    derivedEventType?: string;
+}): Promise<ContextEvent[]>;

package/dist/stores/instant.documents.js

@@ -0,0 +1,108 @@
+import { parseAndStoreDocument } from "./instant.document-parser";
+function isFilePart(part) {
+    return Boolean(part &&
+        typeof part === "object" &&
+        (part.type === "file" || part?.providerMetadata?.instant));
+}
+export function coerceDocumentTextPages(documentRecord, opts) {
+    const pages = documentRecord?.content?.pages;
+    if (!Array.isArray(pages) || pages.length === 0)
+        return "";
+    const prefix = opts?.pageLabelPrefix ?? "Page";
+    return pages
+        .map((p, idx) => {
+        const text = typeof p?.text === "string" ? p.text : "";
+        return `\n\n--- ${prefix} ${idx + 1} ---\n\n${text}`;
+    })
+        .join("");
+}
+async function resolveInstantFileRecord(db, params) {
+    const fileId = params.fileId ? String(params.fileId) : null;
+    const filePath = params.path ? String(params.path) : null;
+    if (!fileId && !filePath)
+        return null;
+    if (fileId) {
+        const q = await db.query({
+            $files: { $: { where: { id: fileId }, limit: 1 }, document: {} },
+        });
+        return q?.$files?.[0] ?? null;
+    }
+    const q = await db.query({
+        $files: { $: { where: { path: filePath }, limit: 1 }, document: {} },
+    });
+    return q?.$files?.[0] ?? null;
+}
+async function ensureDocumentParsedForFile(db, params) {
+    const fileRecord = params.fileRecord;
+    const part = params.part;
+    let documentRecord = Array.isArray(fileRecord?.document)
+        ? fileRecord.document?.[0]
+        : fileRecord.document;
+    if (documentRecord?.id)
+        return documentRecord;
+    const fileUrl = typeof fileRecord?.url === "string" ? fileRecord.url : "";
+    if (!fileUrl.startsWith("http://") && !fileUrl.startsWith("https://")) {
+        return null;
+    }
+    const resp = await fetch(fileUrl);
+    if (!resp.ok)
+        throw new Error(`Failed to fetch file for parsing: HTTP ${resp.status}`);
+    const buffer = Buffer.from(await resp.arrayBuffer());
+    const name = (typeof part?.filename === "string" && part.filename) ||
+        (typeof fileRecord?.path === "string" && fileRecord.path) ||
+        "file";
+    const path = (typeof fileRecord?.path === "string" && fileRecord.path) ||
+        `/agent/${Date.now()}-${name}`;
+    const documentId = await parseAndStoreDocument(db, buffer, name, path, String(fileRecord.id));
+    const dq = await db.query({
+        document_documents: { $: { where: { id: documentId }, limit: 1 }, file: {} },
+    });
+    documentRecord = dq?.document_documents?.[0] ?? null;
+    return documentRecord;
+}
+export async function expandEventsWithInstantDocuments(params) {
+    const db = params.db;
+    const maxChars = typeof params.maxChars === "number" ? params.maxChars : 120000;
+    const derivedEventType = params.derivedEventType ?? "document.parsed";
+    const out = [];
+    for (const event of params.events) {
+        out.push(event);
+        const parts = event?.content?.parts;
+        if (!Array.isArray(parts) || parts.length === 0)
+            continue;
+        for (const part of parts) {
+            if (!isFilePart(part))
+                continue;
+            const instantMeta = part?.providerMetadata?.instant ?? {};
+            const fileId = instantMeta?.fileId ? String(instantMeta.fileId) : undefined;
+            const filePath = instantMeta?.path ? String(instantMeta.path) : undefined;
+            const fileRecord = await resolveInstantFileRecord(db, { fileId, path: filePath });
+            if (!fileRecord?.id)
+                continue;
+            const documentRecord = await ensureDocumentParsedForFile(db, { fileRecord, part });
+            const pageText = coerceDocumentTextPages(documentRecord);
+            if (!pageText)
+                continue;
+            const clipped = pageText.length > maxChars
+                ? `${pageText.slice(0, maxChars)}\n\n[truncated: maxChars=${maxChars}]`
+                : pageText;
+            const derived = {
+                id: `derived:${event.id}:${String(fileRecord.id)}`,
+                type: derivedEventType,
+                channel: event.channel ?? "web",
+                createdAt: new Date().toISOString(),
+                content: {
+                    parts: [
+                        {
+                            type: "text",
+                            text: `Parsed document available.\nFile: "${String(fileRecord.path || part.filename || "file")}"\nProvider: llamacloud`,
+                        },
+                        { type: "text", text: `Document transcription:${clipped}` },
+                    ],
+                },
+            };
+            out.push(derived);
+        }
+    }
+    return out;
+}

package/dist/stores/instant.store.d.ts

@@ -0,0 +1,40 @@
+import type { ModelMessage } from "ai";
+import type { ContextEvent, ContextIdentifier, ContextStatus, StoredContext, StoryStore } from "../story.store";
+export { parseAndStoreDocument } from "./instant.document-parser";
+export { coerceDocumentTextPages, expandEventsWithInstantDocuments, } from "./instant.documents";
+/**
+ * InstantDB-backed StoryStore.
+ *
+ * This is intentionally kept behind the store boundary so the core story engine
+ * can remain database-agnostic.
+ */
+export type InstantStoreDb = any;
+export declare class InstantStore implements StoryStore {
+    private db;
+    constructor(db: InstantStoreDb);
+    getOrCreateContext<C>(contextIdentifier: ContextIdentifier | null): Promise<StoredContext<C>>;
+    private createContext;
+    getContext<C>(contextIdentifier: ContextIdentifier): Promise<StoredContext<C> | null>;
+    updateContextContent<C>(contextIdentifier: ContextIdentifier, content: C): Promise<StoredContext<C>>;
+    updateContextStatus(contextIdentifier: ContextIdentifier, status: ContextStatus): Promise<void>;
+    saveEvent(contextIdentifier: ContextIdentifier, event: ContextEvent): Promise<ContextEvent>;
+    updateEvent(eventId: string, event: ContextEvent): Promise<ContextEvent>;
+    getEvent(eventId: string): Promise<ContextEvent | null>;
+    getEvents(contextIdentifier: ContextIdentifier): Promise<ContextEvent[]>;
+    createExecution(contextIdentifier: ContextIdentifier, triggerEventId: string, reactionEventId: string): Promise<{
+        id: string;
+    }>;
+    completeExecution(contextIdentifier: ContextIdentifier, executionId: string, status: "completed" | "failed"): Promise<void>;
+    eventsToModelMessages(events: ContextEvent[]): Promise<ModelMessage[]>;
+}
+/**
+ * Helper to create a StoryRuntimeResolver that returns an InstantStore.
+ *
+ * This keeps the app-level `ekairos.ts` extremely small.
+ */
+export declare function createInstantStoreRuntime(params: {
+    getDb: (orgId: string) => Promise<InstantStoreDb> | InstantStoreDb;
+    getOrgId?: (env: Record<string, unknown>) => string;
+}): (env: Record<string, unknown>) => Promise<{
+    store: InstantStore;
+}>;

package/dist/stores/instant.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instant.store.d.ts","sourceRoot":"","sources":["../../src/stores/instant.store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AACtC,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,UAAU,EACX,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AAEjE;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,GAAG,CAAA;AAEhC,qBAAa,YAAa,YAAW,UAAU;IAC7C,OAAO,CAAC,EAAE,CAAK;gBAEH,EAAE,EAAE,cAAc;IAIxB,kBAAkB,CAAC,CAAC,EACxB,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,GAC1C,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YAgBd,aAAa;IA8BrB,UAAU,CAAC,CAAC,EAChB,iBAAiB,EAAE,iBAAiB,GACnC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IA0B7B,oBAAoB,CAAC,CAAC,EAC1B,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,EAAE,CAAC,GACT,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAgBtB,mBAAmB,CACvB,iBAAiB,EAAE,iBAAiB,EACpC,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,IAAI,CAAC;IAqBV,SAAS,CACb,iBAAiB,EAAE,iBAAiB,EACpC,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,YAAY,CAAC;IAqBlB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAOxE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IASvD,SAAS,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAiBxE,eAAe,CACnB,iBAAiB,EAAE,iBAAiB,EACpC,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,GACtB,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IA0BpB,iBAAiB,CACrB,iBAAiB,EAAE,iBAAiB,EACpC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,WAAW,GAAG,QAAQ,GAC7B,OAAO,CAAC,IAAI,CAAC;IAcV,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAG7E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,KAAK,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAAA;IAClE,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAA;CACpD,IAGe,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;GAgB3C"}