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

package/README.md

@@ -0,0 +1,174 @@
+# @ekairos/story
+
+Build **durable AI Stories**: an LLM + tool-call loop with a pluggable persistence layer.
+
+## What you get (why you’d use this)
+
+- **Durable runs**: survive serverless timeouts, restarts, and long-running tool calls.
+- **Resumable UX**: users can refresh/reconnect and continue streaming from where they left off.
+- **Retries + observability**: each LLM call and side-effectful tool can be a durable step.
+- **Human approvals**: pause execution for a human decision and resume later.
+- **Multi-tenant ready**: resolve the correct runtime store from a serializable `env` (orgId/tenantId/etc).
+- **Database-agnostic**: InstantDB, Postgres, or anything else via a `StoryStore`.
+
+## Quickstart (5 minutes)
+
+### 1) Configure a runtime resolver (required)
+
+`@ekairos/story` is **declarative**: you define prompts/tools/loop logic with `createStory()`.
+At runtime, the engine needs a `StoryStore` to load/save context + events.
+
+Because stores are **not serializable** (DB clients, SDK instances), you don’t pass them through `env`.
+Instead, you register a single global resolver once, and it will be invoked from inside steps.
+If you skip this, story execution will throw: `Story runtime is not configured...`.
+
+```ts
+import { configureStoryRuntime } from "@ekairos/story";
+import { InstantStore } from "@ekairos/story/instant";
+import { init } from "@instantdb/admin";
+import schema from "./instant.schema";
+
+const storesByOrg = new Map<string, InstantStore>();
+
+configureStoryRuntime(async (env) => {
+  // `env` MUST be serializable (plain object).
+  // Use it for multi-tenant routing (orgId/tenantId/etc).
+  const orgId = String((env as { orgId?: string }).orgId ?? "default");
+
+  const cached = storesByOrg.get(orgId);
+  if (cached) return { store: cached };
+
+  const appId = process.env.NEXT_PUBLIC_INSTANT_APP_ID!;
+  const adminToken = process.env.INSTANT_APP_ADMIN_TOKEN!;
+
+  const db = init({ appId, adminToken, schema });
+  const store = new InstantStore(db);
+  storesByOrg.set(orgId, store);
+  return { store };
+});
+```
+
+### 2) Define a Story (authoring API)
+
+```ts
+import { createStory } from "@ekairos/story";
+
+type Env = { orgId: string };
+type Ctx = { userId: string };
+
+export const myStory = createStory<Env>()
+  .context(async (ctx, _env) => {
+    return { userId: ctx.content?.userId ?? "unknown" } satisfies Ctx;
+  })
+  .systemPrompt((ctx, env) => {
+    return `You are a helpful assistant.\norgId=${env.orgId}\nuserId=${ctx.content?.userId}`;
+  })
+  .tools(async (_ctx, _env) => {
+    return {};
+  })
+  .model("bedrock/claude-4-5-haiku-20251001-v1")
+  .build();
+```
+
+### 3) Run it anywhere (plain Web Streams)
+
+You can run Stories anywhere you can provide a `WritableStream<UIMessageChunk>`.
+For local dev / simple backends, a `TransformStream` is enough:
+
+```ts
+import type { UIMessageChunk } from "ai";
+import { createUIMessageStreamResponse } from "ai";
+
+export async function POST(req: Request) {
+  const { env, event: incomingEvent } = await req.json();
+  const { readable, writable } = new TransformStream<UIMessageChunk, UIMessageChunk>();
+
+  // Start streaming (don’t await if you want the response to return immediately).
+  void myStory.stream({
+    env,
+    incomingEvent,
+    contextIdentifier: null,
+    writable,
+  });
+
+  return createUIMessageStreamResponse({ stream: readable });
+}
+```
+
+That’s it. You now have a streaming Story loop.
+
+## Production runtime: Workflow DevKit (durable + resumable)
+
+This library is **workflow-first** and designed to run on Workflow DevKit:
+
+- [Building Durable AI Agents](https://useworkflow.dev/docs/ai)
+- [Streaming](https://useworkflow.dev/docs/foundations/streaming)
+- [Workflows and Steps](https://useworkflow.dev/docs/foundations/workflows-and-steps)
+
+The key idea: **workflows must be deterministic**, so all I/O happens inside `"use step"` functions.
+If you don’t need durability/resumption, the “Run it anywhere” example above works fine.
+
+## Resumable streaming (production UX)
+
+If you want “refresh-safe” UX, use Workflow DevKit’s resumable streams:
+- [Resumable Streams](https://useworkflow.dev/docs/ai/resumable-streams)
+
+```ts
+import { createUIMessageStreamResponse } from "ai";
+import { start } from "workflow/api";
+
+export async function storyWorkflow(env: { orgId: string }, incomingEvent: any) {
+  "use workflow";
+  await myStory.stream({ env, incomingEvent, contextIdentifier: null });
+}
+
+export async function POST(req: Request) {
+  const { env, event } = await req.json();
+  const run = await start(storyWorkflow, [env, event]);
+
+  return createUIMessageStreamResponse({
+    stream: run.readable,
+    headers: { "x-workflow-run-id": run.runId },
+  });
+}
+```
+
+### Reconnect endpoint (resume from `startIndex`)
+
+```ts
+import { createUIMessageStreamResponse } from "ai";
+import { getRun } from "workflow/api";
+
+export async function GET(
+  request: Request,
+  { params }: { params: Promise<{ id: string }> }
+) {
+  const { id } = await params;
+  const { searchParams } = new URL(request.url);
+  const startIndexParam = searchParams.get("startIndex");
+  const startIndex = startIndexParam ? parseInt(startIndexParam, 10) : undefined;
+
+  const run = getRun(id);
+  const stream = run.getReadable({ startIndex });
+
+  return createUIMessageStreamResponse({ stream });
+}
+```
+
+### Client: `WorkflowChatTransport`
+
+Workflow DevKit provides a drop-in AI SDK transport that handles reconnection for you:
+- [Resumable Streams](https://useworkflow.dev/docs/ai/resumable-streams)
+
+## Tools in workflows
+
+Tools can be:
+- **Step-level** (`"use step"`) for side-effects (DB, fetch) + retries
+- **Workflow-level** for workflow primitives (sleep, hooks, approvals)
+
+See:
+- [Patterns for Defining Tools](https://useworkflow.dev/docs/ai/defining-tools)
+- [Streaming Updates from Tools](https://useworkflow.dev/docs/ai/streaming-updates-from-tools)
+- [Human-in-the-Loop](https://useworkflow.dev/docs/ai/human-in-the-loop)
+
+

package/dist/agent.builder.d.ts

@@ -0,0 +1,52 @@
+import type { InstantAdminDatabase } from "@instantdb/admin";
+import type { Tool } from "ai";
+import type { SchemaOf } from "@ekairos/domain";
+import { storyDomain } from "./schema";
+import { Story, type StoryOptions, type DataStreamWriter } from "./agent.engine";
+import type { StoredContext } from "./service";
+export interface StoryConfig<Context> {
+    db: InstantAdminDatabase<SchemaOf<typeof storyDomain>>;
+    context: (context: StoredContext<Context>) => Promise<Context> | Context;
+    systemPrompt: (context: StoredContext<Context>) => Promise<string> | string;
+    tools: (context: StoredContext<Context>, dataStream: DataStreamWriter) => Promise<Record<string, Tool>> | Record<string, Tool>;
+    model?: string | ((context: StoredContext<Context>) => string);
+    opts?: StoryOptions;
+    includeBaseTools?: {
+        createMessage?: boolean;
+        requestDirection?: boolean;
+        end?: boolean;
+    };
+}
+export type StoryInstance<Context> = Story<Context> & {
+    readonly __config: StoryConfig<Context>;
+};
+export declare function story<Context>(config: StoryConfig<Context>): StoryInstance<Context>;
+type InitializedStoredContext<Context> = StoredContext<Context> & {
+    content: Context;
+};
+type BuilderSystemPrompt<Context> = (context: InitializedStoredContext<Context>) => Promise<string> | string;
+type BuilderTools<Context> = (context: InitializedStoredContext<Context>, dataStream: DataStreamWriter) => Promise<Record<string, Tool>> | Record<string, Tool>;
+type BuilderModel<Context> = string | ((context: InitializedStoredContext<Context>) => string);
+type BuilderIncludeBaseTools = {
+    createMessage?: boolean;
+    requestDirection?: boolean;
+    end?: boolean;
+};
+type FluentAgentBuilder<Context> = {
+    systemPrompt(fn: BuilderSystemPrompt<Context>): FluentAgentBuilder<Context>;
+    tools(fn: BuilderTools<Context>): FluentAgentBuilder<Context>;
+    model(model: BuilderModel<Context>): FluentAgentBuilder<Context>;
+    opts(opts: StoryOptions): FluentAgentBuilder<Context>;
+    includeBaseTools(baseTools: BuilderIncludeBaseTools): FluentAgentBuilder<Context>;
+    config(): StoryConfig<Context>;
+    build(): StoryInstance<Context>;
+};
+type AnyContextInitializer = (context: StoredContext<any>) => Promise<any> | any;
+type InferContextFromInitializer<I extends AnyContextInitializer> = Awaited<ReturnType<I>>;
+type CreateAgentEntry = {
+    context<Initializer extends AnyContextInitializer>(initializer: Initializer): FluentAgentBuilder<InferContextFromInitializer<Initializer>>;
+    initialize<Initializer extends AnyContextInitializer>(initializer: Initializer): FluentAgentBuilder<InferContextFromInitializer<Initializer>>;
+};
+export declare function createStory(db: InstantAdminDatabase<SchemaOf<typeof storyDomain>>): CreateAgentEntry;
+export {};
+//# sourceMappingURL=agent.builder.d.ts.map

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

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

package/dist/agent.builder.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.story = story;
+exports.createStory = createStory;
+const agent_engine_1 = require("./agent.engine");
+function story(config) {
+    class FunctionalAgent extends agent_engine_1.Story {
+        constructor() {
+            super(config.db, config.opts);
+            this.__config = config;
+        }
+        includeBaseTools() {
+            if (config.includeBaseTools) {
+                return {
+                    createMessage: config.includeBaseTools.createMessage ?? true,
+                    requestDirection: config.includeBaseTools.requestDirection ?? true,
+                    end: config.includeBaseTools.end ?? true,
+                };
+            }
+            return super.includeBaseTools();
+        }
+        async buildSystemPrompt(context) {
+            return config.systemPrompt(context);
+        }
+        async buildTools(context, dataStream) {
+            return config.tools(context, dataStream);
+        }
+        async initialize(context) {
+            return config.context(context);
+        }
+        getModel(context) {
+            if (typeof config.model === "function") {
+                return config.model(context);
+            }
+            return config.model || super.getModel(context);
+        }
+    }
+    const instance = new FunctionalAgent();
+    return Object.assign(instance, { __config: config });
+}
+function assertConfigComplete(config) {
+    if (!config.db) {
+        throw new Error("createStory: Debes proporcionar db como parámetro.");
+    }
+    if (!config.context) {
+        throw new Error("createStory: Debes definir context() antes de construir la story.");
+    }
+    if (!config.systemPrompt) {
+        throw new Error("createStory: Debes definir systemPrompt() antes de construir la story.");
+    }
+    if (!config.tools) {
+        throw new Error("createStory: Debes definir tools() antes de construir la story.");
+    }
+}
+function ensureInitializedContext(context) {
+    if (!context.content) {
+        throw new Error("createStory: context() debe devolver datos antes de usar systemPrompt/tools.");
+    }
+    return context;
+}
+function createStory(db) {
+    const initializeBuilder = (initializer) => {
+        const typedInitializer = (context) => initializer(context);
+        const fluentState = {
+            db,
+            context: typedInitializer,
+        };
+        const builder = {
+            systemPrompt(systemPrompt) {
+                fluentState.systemPrompt = (context) => systemPrompt(ensureInitializedContext(context));
+                return builder;
+            },
+            tools(toolsFactory) {
+                fluentState.tools = (context, dataStream) => toolsFactory(ensureInitializedContext(context), dataStream);
+                return builder;
+            },
+            model(model) {
+                if (typeof model === "function") {
+                    fluentState.model = (context) => model(ensureInitializedContext(context));
+                }
+                else {
+                    fluentState.model = model;
+                }
+                return builder;
+            },
+            opts(options) {
+                fluentState.opts = options;
+                return builder;
+            },
+            includeBaseTools(baseTools) {
+                fluentState.includeBaseTools = baseTools;
+                return builder;
+            },
+            config() {
+                assertConfigComplete(fluentState);
+                return fluentState;
+            },
+            build() {
+                assertConfigComplete(fluentState);
+                return story(fluentState);
+            },
+        };
+        return builder;
+    };
+    return {
+        context: initializeBuilder,
+        initialize: initializeBuilder,
+    };
+}
+//# sourceMappingURL=agent.builder.js.map

package/dist/agent.builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.builder.js","sourceRoot":"","sources":["../src/agent.builder.ts"],"names":[],"mappings":"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","sourcesContent":["import type { InstantAdminDatabase } from \"@instantdb/admin\"\r\nimport type { Tool } from \"ai\"\r\nimport type { SchemaOf } from \"@ekairos/domain\"\r\n\r\nimport { storyDomain } from \"./schema\"\r\nimport { Story, type StoryOptions, type DataStreamWriter } from \"./agent.engine\"\r\nimport type { StoredContext } from \"./service\"\r\n\r\nexport interface StoryConfig<Context> {\r\n  db: InstantAdminDatabase<SchemaOf<typeof storyDomain>>\r\n  context: (context: StoredContext<Context>) => Promise<Context> | Context\r\n  systemPrompt: (context: StoredContext<Context>) => Promise<string> | string\r\n  tools: (\r\n    context: StoredContext<Context>,\r\n    dataStream: DataStreamWriter\r\n  ) => Promise<Record<string, Tool>> | Record<string, Tool>\r\n  model?: string | ((context: StoredContext<Context>) => string)\r\n  opts?: StoryOptions\r\n  includeBaseTools?: { createMessage?: boolean; requestDirection?: boolean; end?: boolean }\r\n}\r\n\r\nexport type StoryInstance<Context> = Story<Context> & {\r\n  readonly __config: StoryConfig<Context>\r\n}\r\n\r\nexport function story<Context>(config: StoryConfig<Context>): StoryInstance<Context> {\r\n  class FunctionalAgent extends Story<Context> {\r\n    public readonly __config = config\r\n\r\n    constructor() {\r\n      super(config.db, config.opts)\r\n    }\r\n\r\n    protected includeBaseTools(): { createMessage: boolean; requestDirection: boolean; end: boolean } {\r\n      if (config.includeBaseTools) {\r\n        return {\r\n          createMessage: config.includeBaseTools.createMessage ?? true,\r\n          requestDirection: config.includeBaseTools.requestDirection ?? true,\r\n          end: config.includeBaseTools.end ?? true,\r\n        }\r\n      }\r\n      return super.includeBaseTools()\r\n    }\r\n\r\n    protected async buildSystemPrompt(context: StoredContext<Context>) {\r\n      return config.systemPrompt(context)\r\n    }\r\n\r\n    protected async buildTools(context: StoredContext<Context>, dataStream: DataStreamWriter) {\r\n      return config.tools(context, dataStream)\r\n    }\r\n\r\n    protected async initialize(context: StoredContext<Context>) {\r\n      return config.context(context)\r\n    }\r\n\r\n    protected getModel(context: StoredContext<Context>) {\r\n      if (typeof config.model === \"function\") {\r\n        return config.model(context)\r\n      }\r\n      return config.model || super.getModel(context)\r\n    }\r\n  }\r\n  const instance = new FunctionalAgent()\r\n  return Object.assign(instance, { __config: config })\r\n}\r\n\r\ntype InitializedStoredContext<Context> = StoredContext<Context> & { content: Context }\r\n\r\ntype BuilderSystemPrompt<Context> = (\r\n  context: InitializedStoredContext<Context>\r\n) => Promise<string> | string\r\n\r\ntype BuilderTools<Context> = (\r\n  context: InitializedStoredContext<Context>,\r\n  dataStream: DataStreamWriter\r\n) => Promise<Record<string, Tool>> | Record<string, Tool>\r\n\r\ntype BuilderModel<Context> =\r\n  | string\r\n  | ((context: InitializedStoredContext<Context>) => string)\r\n\r\ntype BuilderIncludeBaseTools = { createMessage?: boolean; requestDirection?: boolean; end?: boolean }\r\n\r\ntype FluentAgentBuilder<Context> = {\r\n  systemPrompt(fn: BuilderSystemPrompt<Context>): FluentAgentBuilder<Context>\r\n  tools(fn: BuilderTools<Context>): FluentAgentBuilder<Context>\r\n  model(model: BuilderModel<Context>): FluentAgentBuilder<Context>\r\n  opts(opts: StoryOptions): FluentAgentBuilder<Context>\r\n  includeBaseTools(baseTools: BuilderIncludeBaseTools): FluentAgentBuilder<Context>\r\n  config(): StoryConfig<Context>\r\n  build(): StoryInstance<Context>\r\n}\r\n\r\ntype AnyContextInitializer = (context: StoredContext<any>) => Promise<any> | any\r\n\r\ntype InferContextFromInitializer<I extends AnyContextInitializer> = Awaited<ReturnType<I>>\r\n\r\ntype CreateAgentEntry = {\r\n  context<Initializer extends AnyContextInitializer>(\r\n    initializer: Initializer\r\n  ): FluentAgentBuilder<InferContextFromInitializer<Initializer>>\r\n  initialize<Initializer extends AnyContextInitializer>(\r\n    initializer: Initializer\r\n  ): FluentAgentBuilder<InferContextFromInitializer<Initializer>>\r\n}\r\n\r\nfunction assertConfigComplete<Context>(\r\n  config: Partial<StoryConfig<Context>>\r\n): asserts config is StoryConfig<Context> {\r\n  if (!config.db) {\r\n    throw new Error(\"createStory: Debes proporcionar db como parámetro.\")\r\n  }\r\n\r\n  if (!config.context) {\r\n    throw new Error(\"createStory: Debes definir context() antes de construir la story.\")\r\n  }\r\n\r\n  if (!config.systemPrompt) {\r\n    throw new Error(\"createStory: Debes definir systemPrompt() antes de construir la story.\")\r\n  }\r\n\r\n  if (!config.tools) {\r\n    throw new Error(\"createStory: Debes definir tools() antes de construir la story.\")\r\n  }\r\n}\r\n\r\nfunction ensureInitializedContext<Context>(\r\n  context: StoredContext<Context>\r\n): InitializedStoredContext<Context> {\r\n  if (!context.content) {\r\n    throw new Error(\r\n      \"createStory: context() debe devolver datos antes de usar systemPrompt/tools.\"\r\n    )\r\n  }\r\n  return context as InitializedStoredContext<Context>\r\n}\r\n\r\nexport function createStory(\r\n  db: InstantAdminDatabase<SchemaOf<typeof storyDomain>>\r\n): CreateAgentEntry {\r\n  const initializeBuilder = <Initializer extends AnyContextInitializer>(initializer: Initializer) => {\r\n    type Context = InferContextFromInitializer<Initializer>\r\n\r\n    const typedInitializer: StoryConfig<Context>[\"context\"] = (context) =>\r\n      initializer(context as StoredContext<Context>)\r\n\r\n    const fluentState: Partial<StoryConfig<Context>> = {\r\n      db,\r\n      context: typedInitializer,\r\n    }\r\n\r\n    const builder: FluentAgentBuilder<Context> = {\r\n      systemPrompt(systemPrompt) {\r\n        fluentState.systemPrompt = (context) =>\r\n          systemPrompt(ensureInitializedContext(context))\r\n        return builder\r\n      },\r\n      tools(toolsFactory) {\r\n        fluentState.tools = (context, dataStream) =>\r\n          toolsFactory(ensureInitializedContext(context), dataStream)\r\n        return builder\r\n      },\r\n      model(model) {\r\n        if (typeof model === \"function\") {\r\n          fluentState.model = (context) =>\r\n            model(ensureInitializedContext(context))\r\n        } else {\r\n          fluentState.model = model\r\n        }\r\n        return builder\r\n      },\r\n      opts(options) {\r\n        fluentState.opts = options\r\n        return builder\r\n      },\r\n      includeBaseTools(baseTools) {\r\n        fluentState.includeBaseTools = baseTools\r\n        return builder\r\n      },\r\n      config() {\r\n        assertConfigComplete(fluentState)\r\n        return fluentState\r\n      },\r\n      build() {\r\n        assertConfigComplete(fluentState)\r\n        return story(fluentState)\r\n      },\r\n    }\r\n\r\n    return builder\r\n  }\r\n\r\n  return {\r\n    context: initializeBuilder,\r\n    initialize: initializeBuilder,\r\n  }\r\n}\r\n\r\n\r\n\r\n"]}

package/dist/agent.d.ts

@@ -1,120 +1,3 @@
-import { InstantAdminDatabase } from "@instantdb/admin";
-import { Tool, UIMessageStreamWriter } from "ai";
-import { UIMessage } from 'ai';
-import { AgentService, ContextEvent, ContextIdentifier, StoredContext } from "./service";
-import { storyDomain } from "./schema";
-import { SchemaOf } from "@ekairos/domain";
-export type AgentMessage = UIMessage<never, // metadata type
-{
-    weather: {
-        city: string;
-        weather?: string;
-        status: 'loading' | 'success';
-    };
-    notification: {
-        message: string;
-        level: 'info' | 'warning' | 'error';
-    };
-}>;
-export interface AgentOptions {
-    onEventCreated?: (event: any) => void | Promise<void>;
-    evaluateToolCalls?: (toolCalls: any[]) => Promise<{
-        success: boolean;
-        message?: string;
-    }>;
-    onToolCallExecuted?: (executionEvent: any) => void | Promise<void>;
-    onEnd?: (lastEvent: ContextEvent) => void | {
-        end?: boolean;
-    } | Promise<void | {
-        end?: boolean;
-    }>;
-}
-export interface ProgressStreamOptions {
-    reasoningEffort?: "off" | "low" | "medium" | "high";
-    webSearch?: boolean;
-}
-export type DataStreamWriter = UIMessageStreamWriter<AgentMessage>;
-export declare abstract class Story<Context> {
-    private opts;
-    protected db: InstantAdminDatabase<SchemaOf<typeof storyDomain>>;
-    protected agentService: AgentService;
-    constructor(db: InstantAdminDatabase<SchemaOf<typeof storyDomain>>, opts?: AgentOptions);
-    protected abstract buildSystemPrompt(context: StoredContext<Context>, ...args: any[]): Promise<string> | string;
-    protected abstract buildTools(context: StoredContext<Context>, dataStream: DataStreamWriter): Promise<Record<string, Tool>>;
-    protected abstract initialize(context: StoredContext<Context>): Promise<Context>;
-    protected getModel(context: StoredContext<Context>): string;
-    protected includeBaseTools(): {
-        createMessage: boolean;
-        requestDirection: boolean;
-        end: boolean;
-    };
-    protected getFinalizationToolNames(): Promise<string[]>;
-    private static readonly FINAL_TOOL_NAMES;
-    protected getBaseTools(dataStream: DataStreamWriter, threadId: string): Record<string, Tool>;
-    protected executeCreateMessage(eventId: string, args: {
-        message: string;
-        type: "info" | "confirmation" | "warning" | "error" | "success";
-        includeContext?: boolean;
-    }, threadId: string, dataStream?: DataStreamWriter): Promise<any>;
-    protected executeRequestDirection(eventId: string, args: {
-        issue: string;
-        context: string;
-        suggestedActions?: string[];
-        urgency: "low" | "medium" | "high";
-    }, threadId: string, _dataStream?: DataStreamWriter): Promise<any>;
-    progressStream(incomingEvent: ContextEvent, contextIdentifier: ContextIdentifier | null, options?: ProgressStreamOptions): Promise<{
-        contextId: unknown;
-        triggerEventId: string;
-        reactionEventId: string;
-        stream: ReadableStream<any>;
-        executionId: string;
-    }>;
-    private saveMessagesToThread;
-    private callOnEnd;
-}
-export interface AgentConfig<Context> {
-    db: InstantAdminDatabase<SchemaOf<typeof storyDomain>>;
-    context: (context: StoredContext<Context>) => Promise<Context> | Context;
-    systemPrompt: (context: StoredContext<Context>) => Promise<string> | string;
-    tools: (context: StoredContext<Context>, dataStream: DataStreamWriter) => Promise<Record<string, Tool>> | Record<string, Tool>;
-    model?: string | ((context: StoredContext<Context>) => string);
-    opts?: AgentOptions;
-    includeBaseTools?: {
-        createMessage?: boolean;
-        requestDirection?: boolean;
-        end?: boolean;
-    };
-}
-export type AgentInstance<Context> = Story<Context> & {
-    readonly __config: AgentConfig<Context>;
-};
-export declare function agent<Context>(config: AgentConfig<Context>): AgentInstance<Context>;
-export { Story as Agent };
-type InitializedStoredContext<Context> = StoredContext<Context> & {
-    content: Context;
-};
-type BuilderSystemPrompt<Context> = (context: InitializedStoredContext<Context>) => Promise<string> | string;
-type BuilderTools<Context> = (context: InitializedStoredContext<Context>, dataStream: DataStreamWriter) => Promise<Record<string, Tool>> | Record<string, Tool>;
-type BuilderModel<Context> = string | ((context: InitializedStoredContext<Context>) => string);
-type BuilderIncludeBaseTools = {
-    createMessage?: boolean;
-    requestDirection?: boolean;
-    end?: boolean;
-};
-type FluentAgentBuilder<Context> = {
-    systemPrompt(fn: BuilderSystemPrompt<Context>): FluentAgentBuilder<Context>;
-    tools(fn: BuilderTools<Context>): FluentAgentBuilder<Context>;
-    model(model: BuilderModel<Context>): FluentAgentBuilder<Context>;
-    opts(opts: AgentOptions): FluentAgentBuilder<Context>;
-    includeBaseTools(baseTools: BuilderIncludeBaseTools): FluentAgentBuilder<Context>;
-    config(): AgentConfig<Context>;
-    build(): AgentInstance<Context>;
-};
-type AnyContextInitializer = (context: StoredContext<any>) => Promise<any> | any;
-type InferContextFromInitializer<I extends AnyContextInitializer> = Awaited<ReturnType<I>>;
-type CreateAgentEntry = {
-    context<Initializer extends AnyContextInitializer>(initializer: Initializer): FluentAgentBuilder<InferContextFromInitializer<Initializer>>;
-    initialize<Initializer extends AnyContextInitializer>(initializer: Initializer): FluentAgentBuilder<InferContextFromInitializer<Initializer>>;
-};
-export declare function createAgent(db: InstantAdminDatabase<SchemaOf<typeof storyDomain>>): CreateAgentEntry;
+export { Story, type StoryOptions, type ProgressStreamOptions, type DataStreamWriter, } from "./agent.engine";
+export { story, createStory, type StoryConfig, type StoryInstance, } from "./agent.builder";
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,EACL,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAEL,KAAK,EACL,WAAW,EACX,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAA"}

package/dist/agent.engine.d.ts

@@ -0,0 +1,75 @@
+import { type InstantAdminDatabase } from "@instantdb/admin";
+import { type Tool, type UIMessage, type UIMessageStreamWriter } from "ai";
+import type { SchemaOf } from "@ekairos/domain";
+import { storyDomain } from "./schema";
+import type { ContextEvent, ContextIdentifier, StoredContext } from "./service";
+import { AgentService } from "./service";
+export type AgentMessage = UIMessage<never, // metadata type
+{
+    weather: {
+        city: string;
+        weather?: string;
+        status: "loading" | "success";
+    };
+    notification: {
+        message: string;
+        level: "info" | "warning" | "error";
+    };
+}>;
+export interface StoryOptions {
+    onEventCreated?: (event: any) => void | Promise<void>;
+    evaluateToolCalls?: (toolCalls: any[]) => Promise<{
+        success: boolean;
+        message?: string;
+    }>;
+    onToolCallExecuted?: (executionEvent: any) => void | Promise<void>;
+    onEnd?: (lastEvent: ContextEvent) => void | {
+        end?: boolean;
+    } | Promise<void | {
+        end?: boolean;
+    }>;
+}
+export interface ProgressStreamOptions {
+    reasoningEffort?: "off" | "low" | "medium" | "high";
+    webSearch?: boolean;
+}
+export type DataStreamWriter = UIMessageStreamWriter<AgentMessage>;
+export declare abstract class Story<Context> {
+    private opts;
+    protected db: InstantAdminDatabase<SchemaOf<typeof storyDomain>>;
+    protected agentService: AgentService;
+    constructor(db: InstantAdminDatabase<SchemaOf<typeof storyDomain>>, opts?: StoryOptions);
+    protected abstract buildSystemPrompt(context: StoredContext<Context>, ...args: any[]): Promise<string> | string;
+    protected abstract buildTools(context: StoredContext<Context>, dataStream: DataStreamWriter): Promise<Record<string, Tool>>;
+    protected abstract initialize(context: StoredContext<Context>): Promise<Context>;
+    protected getModel(_context: StoredContext<Context>): string;
+    protected includeBaseTools(): {
+        createMessage: boolean;
+        requestDirection: boolean;
+        end: boolean;
+    };
+    protected getFinalizationToolNames(): Promise<string[]>;
+    private static readonly FINAL_TOOL_NAMES;
+    protected getBaseTools(_dataStream: DataStreamWriter, _threadId: string): Record<string, Tool>;
+    protected executeCreateMessage(eventId: string, args: {
+        message: string;
+        type: "info" | "confirmation" | "warning" | "error" | "success";
+        includeContext?: boolean;
+    }, threadId: string, dataStream?: DataStreamWriter): Promise<any>;
+    protected executeRequestDirection(eventId: string, args: {
+        issue: string;
+        context: string;
+        suggestedActions?: string[];
+        urgency: "low" | "medium" | "high";
+    }, threadId: string, _dataStream?: DataStreamWriter): Promise<any>;
+    progressStream(incomingEvent: ContextEvent, contextIdentifier: ContextIdentifier | null, options?: ProgressStreamOptions): Promise<{
+        contextId: unknown;
+        triggerEventId: string;
+        reactionEventId: string;
+        stream: ReadableStream<any>;
+        executionId: string;
+    }>;
+    private saveMessagesToThread;
+    private callOnEnd;
+}
+//# sourceMappingURL=agent.engine.d.ts.map

package/dist/agent.engine.d.ts.map

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