@ariaflowagents/cf-agent 0.7.0 → 0.9.0

package/dist/AriaFlowAgent.d.ts

@@ -0,0 +1,109 @@
+/**
+ * AriaFlowAgent -- AriaFlow on Cloudflare Durable Objects.
+ *
+ * Extends CF's AIChatAgent and works WITH it, not against it:
+ *
+ *   CF owns:      messages, persistence, WebSocket, resumability
+ *   AriaFlow owns: agent orchestration (current agent, working memory,
+ *                  flow state, handoff history, extraction data)
+ *
+ * On each chat message:
+ *   1. CF calls onChatMessage() with this.messages already populated
+ *   2. We build a BridgeSessionStore from CF messages + orchestration state
+ *   3. AriaFlow Runtime runs the agent pipeline
+ *   4. We return an SSE Response in AI SDK format
+ *   5. CF's _reply() reads the SSE stream, builds message parts,
+ *      calls persistMessages(), broadcasts to clients, handles resumability
+ *
+ * AriaFlow's orchestration state (current agent, working memory, flow state)
+ * is stored in a separate lightweight SQLite table via OrchestrationStore.
+ */
+import { AIChatAgent } from '@cloudflare/ai-chat';
+import type { HarnessConfig } from '@ariaflowagents/core';
+import type { StreamTextOnFinishCallback, ToolSet } from 'ai';
+import type { OnChatMessageOptions } from '@cloudflare/ai-chat';
+import type { StreamAdapterConfig } from './types.js';
+/**
+ * Abstract base class for running AriaFlow agents on Cloudflare.
+ *
+ * @example
+ * ```typescript
+ * import { AriaFlowAgent } from '@ariaflowagents/cf-agent';
+ * import { openai } from '@ai-sdk/openai';
+ *
+ * class MyAgent extends AriaFlowAgent<Env> {
+ *   protected getAgents(): HarnessConfig['agents'] {
+ *     return [{
+ *       id: 'assistant',
+ *       name: 'Assistant',
+ *       type: 'llm',
+ *       model: openai('gpt-4o', { apiKey: this.env.OPENAI_API_KEY }),
+ *       prompt: 'You are a helpful assistant.',
+ *     }];
+ *   }
+ *
+ *   protected getDefaultAgentId() { return 'assistant'; }
+ * }
+ * ```
+ */
+export declare abstract class AriaFlowAgent<Env = any, State = unknown> extends AIChatAgent<Env, State> {
+    private runtime;
+    /**
+     * Required: Define the agents for this runtime.
+     */
+    protected abstract getAgents(): HarnessConfig['agents'];
+    /**
+     * Required: Which agent handles the first message.
+     */
+    protected abstract getDefaultAgentId(): string;
+    /**
+     * Optional: Additional runtime config (hooks, model, processors, etc.).
+     * Merged with agents + defaultAgentId + sessionStore.
+     */
+    protected getRuntimeConfig(): Partial<HarnessConfig>;
+    /**
+     * Optional: Configure which AriaFlow events become data parts in the stream.
+     */
+    protected getStreamConfig(): Partial<StreamAdapterConfig>;
+    /**
+     * Get the SQL executor for the Durable Object.
+     * CF's AIChatAgent exposes this.sql as a tagged template function.
+     */
+    private getSql;
+    /**
+     * Get the Durable Object ID as the session identifier.
+     */
+    private getSessionId;
+    /**
+     * Called by CF when a chat message arrives.
+     *
+     * CF has already:
+     *   1. Received the WebSocket message from the client
+     *   2. Parsed and validated it
+     *   3. Persisted the user message to cf_ai_chat_agent_messages
+     *   4. Populated this.messages with the full conversation history
+     *
+     * We:
+     *   1. Create a BridgeSessionStore (CF messages + orchestration state)
+     *   2. Build and run AriaFlow Runtime
+     *   3. Return an SSE Response
+     *
+     * CF then:
+     *   1. Reads the SSE stream via _reply()
+     *   2. Builds assistant message parts via applyChunkToParts()
+     *   3. Persists the assistant message
+     *   4. Broadcasts to all connected clients
+     *   5. Handles stream resumability
+     */
+    onChatMessage(onFinish: StreamTextOnFinishCallback<ToolSet>, options?: OnChatMessageOptions): Promise<Response>;
+    /**
+     * Extract the text content of the last user message from CF's messages array.
+     */
+    private getLastUserInput;
+    /**
+     * HTTP endpoint handler.
+     * Adds AriaFlow-specific endpoints on top of CF's defaults.
+     */
+    onRequest(request: Request): Promise<Response>;
+}
+//# sourceMappingURL=AriaFlowAgent.d.ts.map

package/dist/AriaFlowAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AriaFlowAgent.d.ts","sourceRoot":"","sources":["../src/AriaFlowAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,KAAK,EACV,aAAa,EAGd,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,0BAA0B,EAAE,OAAO,EAAa,MAAM,IAAI,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,KAAK,EAAE,mBAAmB,EAAe,MAAM,YAAY,CAAC;AAGnE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,8BAAsB,aAAa,CACjC,GAAG,GAAG,GAAG,EACT,KAAK,GAAG,OAAO,CACf,SAAQ,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC;IAC/B,OAAO,CAAC,OAAO,CAAwB;IAEvC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,IAAI,aAAa,CAAC,QAAQ,CAAC;IAEvD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,iBAAiB,IAAI,MAAM;IAE9C;;;OAGG;IACH,SAAS,CAAC,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC;IAIpD;;OAEG;IACH,SAAS,CAAC,eAAe,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAIzD;;;OAGG;IACH,OAAO,CAAC,MAAM;IAId;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,aAAa,CACjB,QAAQ,EAAE,0BAA0B,CAAC,OAAO,CAAC,EAC7C,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,QAAQ,CAAC;IA4CpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAexB;;;OAGG;IACG,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;CAerD"}

package/dist/AriaFlowAgent.js

@@ -0,0 +1,170 @@
+/**
+ * AriaFlowAgent -- AriaFlow on Cloudflare Durable Objects.
+ *
+ * Extends CF's AIChatAgent and works WITH it, not against it:
+ *
+ *   CF owns:      messages, persistence, WebSocket, resumability
+ *   AriaFlow owns: agent orchestration (current agent, working memory,
+ *                  flow state, handoff history, extraction data)
+ *
+ * On each chat message:
+ *   1. CF calls onChatMessage() with this.messages already populated
+ *   2. We build a BridgeSessionStore from CF messages + orchestration state
+ *   3. AriaFlow Runtime runs the agent pipeline
+ *   4. We return an SSE Response in AI SDK format
+ *   5. CF's _reply() reads the SSE stream, builds message parts,
+ *      calls persistMessages(), broadcasts to clients, handles resumability
+ *
+ * AriaFlow's orchestration state (current agent, working memory, flow state)
+ * is stored in a separate lightweight SQLite table via OrchestrationStore.
+ */
+import { AIChatAgent } from '@cloudflare/ai-chat';
+import { Runtime } from '@ariaflowagents/core';
+import { BridgeSessionStore } from './BridgeSessionStore.js';
+import { createSSEResponse } from './StreamAdapter.js';
+import { DEFAULT_STREAM_CONFIG } from './types.js';
+/**
+ * Abstract base class for running AriaFlow agents on Cloudflare.
+ *
+ * @example
+ * ```typescript
+ * import { AriaFlowAgent } from '@ariaflowagents/cf-agent';
+ * import { openai } from '@ai-sdk/openai';
+ *
+ * class MyAgent extends AriaFlowAgent<Env> {
+ *   protected getAgents(): HarnessConfig['agents'] {
+ *     return [{
+ *       id: 'assistant',
+ *       name: 'Assistant',
+ *       type: 'llm',
+ *       model: openai('gpt-4o', { apiKey: this.env.OPENAI_API_KEY }),
+ *       prompt: 'You are a helpful assistant.',
+ *     }];
+ *   }
+ *
+ *   protected getDefaultAgentId() { return 'assistant'; }
+ * }
+ * ```
+ */
+export class AriaFlowAgent extends AIChatAgent {
+    runtime = null;
+    /**
+     * Optional: Additional runtime config (hooks, model, processors, etc.).
+     * Merged with agents + defaultAgentId + sessionStore.
+     */
+    getRuntimeConfig() {
+        return {};
+    }
+    /**
+     * Optional: Configure which AriaFlow events become data parts in the stream.
+     */
+    getStreamConfig() {
+        return {};
+    }
+    /**
+     * Get the SQL executor for the Durable Object.
+     * CF's AIChatAgent exposes this.sql as a tagged template function.
+     */
+    getSql() {
+        return this.sql.bind(this);
+    }
+    /**
+     * Get the Durable Object ID as the session identifier.
+     */
+    getSessionId() {
+        return this.ctx?.id?.toString() ?? crypto.randomUUID();
+    }
+    /**
+     * Called by CF when a chat message arrives.
+     *
+     * CF has already:
+     *   1. Received the WebSocket message from the client
+     *   2. Parsed and validated it
+     *   3. Persisted the user message to cf_ai_chat_agent_messages
+     *   4. Populated this.messages with the full conversation history
+     *
+     * We:
+     *   1. Create a BridgeSessionStore (CF messages + orchestration state)
+     *   2. Build and run AriaFlow Runtime
+     *   3. Return an SSE Response
+     *
+     * CF then:
+     *   1. Reads the SSE stream via _reply()
+     *   2. Builds assistant message parts via applyChunkToParts()
+     *   3. Persists the assistant message
+     *   4. Broadcasts to all connected clients
+     *   5. Handles stream resumability
+     */
+    async onChatMessage(onFinish, options) {
+        // Extract the latest user input from CF's messages
+        const lastUserMessage = this.getLastUserInput();
+        if (!lastUserMessage) {
+            return new Response('No user message', { status: 400 });
+        }
+        const sessionId = this.getSessionId();
+        const defaultAgentId = this.getDefaultAgentId();
+        // Build session store that bridges CF messages with AriaFlow state
+        const sessionStore = new BridgeSessionStore({
+            sqlExecutor: this.getSql(),
+            cfMessages: this.messages,
+            sessionId,
+            defaultAgentId,
+        });
+        // Build runtime (fresh per request to pick up latest config)
+        const extraConfig = this.getRuntimeConfig();
+        this.runtime = new Runtime({
+            ...extraConfig,
+            agents: this.getAgents(),
+            defaultAgentId,
+            sessionStore,
+        });
+        // Run AriaFlow
+        const stream = this.runtime.stream({
+            input: lastUserMessage,
+            sessionId,
+            userId: options?.body?.userId,
+            abortSignal: options?.abortSignal,
+        });
+        // Convert to SSE Response that CF's _reply() can parse
+        const streamConfig = {
+            ...DEFAULT_STREAM_CONFIG,
+            ...this.getStreamConfig(),
+        };
+        return createSSEResponse(stream, streamConfig);
+    }
+    /**
+     * Extract the text content of the last user message from CF's messages array.
+     */
+    getLastUserInput() {
+        for (let i = this.messages.length - 1; i >= 0; i--) {
+            const msg = this.messages[i];
+            if (msg.role !== 'user')
+                continue;
+            const text = msg.parts
+                ?.filter((p) => p.type === 'text')
+                .map((p) => p.text ?? '')
+                .join('');
+            if (text?.trim())
+                return text;
+        }
+        return null;
+    }
+    /**
+     * HTTP endpoint handler.
+     * Adds AriaFlow-specific endpoints on top of CF's defaults.
+     */
+    async onRequest(request) {
+        const url = new URL(request.url);
+        if (url.pathname.endsWith('/orchestration-state')) {
+            const { OrchestrationStore } = await import('./OrchestrationStore.js');
+            const store = new OrchestrationStore(this.getSql());
+            const state = await store.get();
+            return Response.json({
+                sessionId: this.getSessionId(),
+                state: state ?? null,
+            });
+        }
+        return super.onRequest(request);
+    }
+}
+//# sourceMappingURL=AriaFlowAgent.js.map

package/dist/AriaFlowAgent.js.map

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

package/dist/BridgeSessionStore.d.ts

@@ -0,0 +1,37 @@
+import type { Session, SessionStore } from '@ariaflowagents/core';
+import type { UIMessage } from 'ai';
+/**
+ * Bridge SessionStore that splits concerns between CF and AriaFlow.
+ *
+ * CF owns messages (via AIChatAgent's cf_ai_chat_agent_messages table).
+ * AriaFlow owns orchestration state (via OrchestrationStore).
+ *
+ * On get(): reconstructs a Session by combining CF's messages with
+ * AriaFlow's orchestration state.
+ *
+ * On save(): extracts orchestration state from the Session and saves
+ * it. Does NOT save messages -- CF handles that via persistMessages().
+ */
+export declare class BridgeSessionStore implements SessionStore {
+    private orchestration;
+    private cfMessages;
+    private sessionId;
+    private defaultAgentId;
+    constructor(options: {
+        sqlExecutor: (...args: any[]) => any;
+        cfMessages: UIMessage[];
+        sessionId: string;
+        defaultAgentId: string;
+    });
+    /**
+     * Reconstruct a Session from CF messages + orchestration state.
+     */
+    get(id: string): Promise<Session | null>;
+    /**
+     * Save only orchestration state. CF handles message persistence.
+     */
+    save(session: Session): Promise<void>;
+    delete(id: string): Promise<void>;
+    list(): Promise<Session[]>;
+}
+//# sourceMappingURL=BridgeSessionStore.d.ts.map

package/dist/BridgeSessionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BridgeSessionStore.d.ts","sourceRoot":"","sources":["../src/BridgeSessionStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAIpC;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,cAAc,CAAS;gBAEnB,OAAO,EAAE;QACnB,WAAW,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;QACrC,UAAU,EAAE,SAAS,EAAE,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;KACxB;IAOD;;OAEG;IACG,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAsB9C;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBrC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,IAAI,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;CAKjC"}

package/dist/BridgeSessionStore.js

@@ -0,0 +1,120 @@
+import { OrchestrationStore } from './OrchestrationStore.js';
+/**
+ * Bridge SessionStore that splits concerns between CF and AriaFlow.
+ *
+ * CF owns messages (via AIChatAgent's cf_ai_chat_agent_messages table).
+ * AriaFlow owns orchestration state (via OrchestrationStore).
+ *
+ * On get(): reconstructs a Session by combining CF's messages with
+ * AriaFlow's orchestration state.
+ *
+ * On save(): extracts orchestration state from the Session and saves
+ * it. Does NOT save messages -- CF handles that via persistMessages().
+ */
+export class BridgeSessionStore {
+    orchestration;
+    cfMessages;
+    sessionId;
+    defaultAgentId;
+    constructor(options) {
+        this.orchestration = new OrchestrationStore(options.sqlExecutor);
+        this.cfMessages = options.cfMessages;
+        this.sessionId = options.sessionId;
+        this.defaultAgentId = options.defaultAgentId;
+    }
+    /**
+     * Reconstruct a Session from CF messages + orchestration state.
+     */
+    async get(id) {
+        const orchState = await this.orchestration.get();
+        // Convert CF UIMessages to AriaFlow ModelMessages
+        const messages = convertUIMessagesToModelMessages(this.cfMessages);
+        return {
+            id: id || this.sessionId,
+            createdAt: new Date(),
+            updatedAt: new Date(),
+            messages,
+            currentAgent: orchState?.currentAgent ?? this.defaultAgentId,
+            workingMemory: orchState?.workingMemory ?? {},
+            agentStates: (orchState?.agentStates ?? {}),
+            handoffHistory: (orchState?.handoffHistory ?? []).map(h => ({
+                ...h,
+                timestamp: new Date(h.timestamp),
+            })),
+            state: orchState?.state,
+        };
+    }
+    /**
+     * Save only orchestration state. CF handles message persistence.
+     */
+    async save(session) {
+        const state = {
+            currentAgent: session.currentAgent,
+            workingMemory: session.workingMemory,
+            agentStates: session.agentStates,
+            handoffHistory: (session.handoffHistory ?? []).map(h => ({
+                from: h.from,
+                to: h.to,
+                reason: h.reason,
+                timestamp: h.timestamp instanceof Date
+                    ? h.timestamp.toISOString()
+                    : String(h.timestamp),
+            })),
+            state: session.state,
+        };
+        await this.orchestration.save(state);
+    }
+    async delete(id) {
+        await this.orchestration.clear();
+    }
+    async list() {
+        // Single DO = single session
+        const session = await this.get(this.sessionId);
+        return session ? [session] : [];
+    }
+}
+/**
+ * Convert CF UIMessages (parts-based) to AriaFlow ModelMessages (content-based).
+ *
+ * UIMessage has: { id, role, parts: [{type:'text', text:'...'}, {type:'tool-...'}] }
+ * ModelMessage has: { role, content: string | [{type:'text', text:'...'}] }
+ */
+function convertUIMessagesToModelMessages(messages) {
+    const result = [];
+    for (const msg of messages) {
+        if (msg.role === 'user') {
+            // Extract text from user message parts
+            const text = msg.parts
+                ?.filter((p) => p.type === 'text')
+                .map((p) => p.text ?? '')
+                .join('') ?? '';
+            if (text) {
+                result.push({ role: 'user', content: text });
+            }
+        }
+        else if (msg.role === 'assistant') {
+            // Build content array from assistant parts
+            const content = [];
+            for (const part of msg.parts ?? []) {
+                if (part.type === 'text' && 'text' in part) {
+                    content.push({ type: 'text', text: part.text });
+                }
+                else if ('toolCallId' in part && 'toolName' in part) {
+                    // Tool invocation part
+                    const toolPart = part;
+                    content.push({
+                        type: 'tool-call',
+                        toolCallId: toolPart.toolCallId,
+                        toolName: toolPart.toolName,
+                        args: toolPart.input,
+                    });
+                }
+            }
+            if (content.length > 0) {
+                result.push({ role: 'assistant', content });
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=BridgeSessionStore.js.map

package/dist/BridgeSessionStore.js.map

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

package/dist/OrchestrationStore.d.ts

@@ -0,0 +1,25 @@
+import type { SqlExecutor, OrchestrationState } from './types.js';
+/**
+ * Lightweight store for AriaFlow orchestration state.
+ *
+ * This is NOT a SessionStore. CF owns message persistence via its
+ * cf_ai_chat_agent_messages table. This store only tracks the state
+ * AriaFlow needs for multi-agent orchestration:
+ *
+ *   - currentAgent: which agent is active
+ *   - workingMemory: key-value context injected into prompts
+ *   - agentStates: per-agent state (flow node, extraction data, etc.)
+ *   - handoffHistory: agent-to-agent transfer log
+ *
+ * Single table, single row per Durable Object (keyed by 'default').
+ */
+export declare class OrchestrationStore {
+    private sql;
+    private initialized;
+    constructor(sql: SqlExecutor);
+    private ensureTable;
+    get(): Promise<OrchestrationState | null>;
+    save(state: OrchestrationState): Promise<void>;
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=OrchestrationStore.d.ts.map

package/dist/OrchestrationStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrchestrationStore.d.ts","sourceRoot":"","sources":["../src/OrchestrationStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,GAAG,CAAc;IACzB,OAAO,CAAC,WAAW,CAAS;gBAEhB,GAAG,EAAE,WAAW;IAI5B,OAAO,CAAC,WAAW;IAYb,GAAG,IAAI,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAezC,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/OrchestrationStore.js

@@ -0,0 +1,63 @@
+/**
+ * Lightweight store for AriaFlow orchestration state.
+ *
+ * This is NOT a SessionStore. CF owns message persistence via its
+ * cf_ai_chat_agent_messages table. This store only tracks the state
+ * AriaFlow needs for multi-agent orchestration:
+ *
+ *   - currentAgent: which agent is active
+ *   - workingMemory: key-value context injected into prompts
+ *   - agentStates: per-agent state (flow node, extraction data, etc.)
+ *   - handoffHistory: agent-to-agent transfer log
+ *
+ * Single table, single row per Durable Object (keyed by 'default').
+ */
+export class OrchestrationStore {
+    sql;
+    initialized = false;
+    constructor(sql) {
+        this.sql = sql;
+    }
+    ensureTable() {
+        if (this.initialized)
+            return;
+        this.sql `
+      CREATE TABLE IF NOT EXISTS ariaflow_orchestration (
+        id TEXT PRIMARY KEY DEFAULT 'default',
+        state TEXT NOT NULL,
+        updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+      )
+    `;
+        this.initialized = true;
+    }
+    async get() {
+        this.ensureTable();
+        const rows = this.sql `
+      SELECT state FROM ariaflow_orchestration WHERE id = 'default'
+    `.toArray();
+        if (rows.length === 0)
+            return null;
+        try {
+            return JSON.parse(rows[0].state);
+        }
+        catch {
+            return null;
+        }
+    }
+    async save(state) {
+        this.ensureTable();
+        const json = JSON.stringify(state);
+        this.sql `
+      INSERT INTO ariaflow_orchestration (id, state, updated_at)
+      VALUES ('default', ${json}, datetime('now'))
+      ON CONFLICT(id) DO UPDATE SET
+        state = excluded.state,
+        updated_at = excluded.updated_at
+    `;
+    }
+    async clear() {
+        this.ensureTable();
+        this.sql `DELETE FROM ariaflow_orchestration WHERE id = 'default'`;
+    }
+}
+//# sourceMappingURL=OrchestrationStore.js.map

package/dist/OrchestrationStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrchestrationStore.js","sourceRoot":"","sources":["../src/OrchestrationStore.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,kBAAkB;IACrB,GAAG,CAAc;IACjB,WAAW,GAAG,KAAK,CAAC;IAE5B,YAAY,GAAgB;QAC1B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAEO,WAAW;QACjB,IAAI,IAAI,CAAC,WAAW;YAAE,OAAO;QAC7B,IAAI,CAAC,GAAG,CAAA;;;;;;KAMP,CAAC;QACF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,GAAG;QACP,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAA;;KAEpB,CAAC,OAAO,EAA8B,CAAC;QAExC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAEnC,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAuB,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,KAAyB;QAClC,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,CAAA;;2BAEe,IAAI;;;;KAI1B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,IAAI,CAAC,GAAG,CAAA,yDAAyD,CAAC;IACpE,CAAC;CACF"}

package/dist/StreamAdapter.d.ts

@@ -0,0 +1,19 @@
+import type { HarnessStreamPart } from '@ariaflowagents/core';
+import type { StreamAdapterConfig } from './types.js';
+/**
+ * Convert AriaFlow's HarnessStreamPart generator into an SSE Response
+ * that CF's AIChatAgent._reply() can parse.
+ *
+ * CF's _streamSSEReply reads lines in the format:
+ *   data: {"type":"text-start"}\n\n
+ *   data: {"type":"text-delta","delta":"Hello"}\n\n
+ *   data: {"type":"tool-input-available","toolCallId":"...","toolName":"...","input":{...}}\n\n
+ *   data: {"type":"tool-output-available","toolCallId":"...","output":{...}}\n\n
+ *   data: {"type":"data-handoff","data":{...}}\n\n
+ *   data: {"type":"text-end"}\n\n
+ *
+ * CF's applyChunkToParts() then builds UIMessage parts from these chunks.
+ * CF handles persistence, broadcasting, and resumability.
+ */
+export declare function createSSEResponse(stream: AsyncGenerator<HarnessStreamPart>, config?: StreamAdapterConfig): Response;
+//# sourceMappingURL=StreamAdapter.d.ts.map

package/dist/StreamAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamAdapter.d.ts","sourceRoot":"","sources":["../src/StreamAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGtD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,cAAc,CAAC,iBAAiB,CAAC,EACzC,MAAM,GAAE,mBAA2C,GAClD,QAAQ,CAuCV"}