@fabric-harness/cloudflare 0.16.1 → 0.18.0

package/dist/agent.d.ts

@@ -0,0 +1,45 @@
+import type { AgentProfile, AgentTriggers, DefinedAgent, JsonObject, ModelProvider, SandboxBackend, Schema, Skill, ToolDef } from '@fabric-harness/sdk';
+import type { CapabilityPolicy, CostLimit, ApprovalOptions } from '@fabric-harness/sdk';
+import type { CloudflareBundle, CloudflareBundleConfig } from './index.js';
+export interface CloudflareAgentOptions {
+    name?: string;
+    description?: string;
+    instructions?: string;
+    input?: Schema<JsonObject>;
+    output?: Schema<unknown>;
+    model?: string;
+    target?: 'node' | 'temporal-worker';
+    skills?: Skill[];
+    triggers?: AgentTriggers;
+    cloudflare: CloudflareBundleConfig;
+    modelProvider?: ModelProvider;
+    tools?: ToolDef[] | string[];
+    sandbox?: SandboxBackend;
+    profile?: AgentProfile;
+    policy?: CapabilityPolicy;
+    costBudget?: CostLimit;
+    approvals?: ApprovalOptions;
+}
+export interface DefineCloudflareAgentOptions {
+    name?: string;
+    description?: string;
+    instructions?: string;
+    input?: Schema<JsonObject>;
+    output?: Schema<unknown>;
+    model?: string;
+    target?: 'node' | 'temporal-worker';
+    skills?: Skill[];
+    triggers?: AgentTriggers;
+    cloudflare?: CloudflareBundleConfig;
+    modelProvider?: ModelProvider;
+    tools?: ToolDef[] | string[];
+    sandbox?: SandboxBackend;
+    profile?: AgentProfile;
+    policy?: CapabilityPolicy;
+    costBudget?: CostLimit;
+    approvals?: ApprovalOptions;
+}
+export declare function cloudflareAgent(options: CloudflareAgentOptions): DefinedAgent<JsonObject, unknown>;
+export declare function defineCloudflareAgent(options?: DefineCloudflareAgentOptions): DefinedAgent<JsonObject, unknown>;
+export declare function resolveToolRefs(bundle: CloudflareBundle, refs: string[]): ToolDef[];
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,YAAY,EAAE,aAAa,EAAE,YAAY,EAAiB,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACxL,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAExF,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAG3E,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC;IACpC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,UAAU,EAAE,sBAAsB,CAAC;IACnC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAC;IACpC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,KAAK,CAAC,EAAE,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;IAC7B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAuGD,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAElG;AAED,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,4BAA4B,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CA6D/G;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAqBnF"}

package/dist/agent.js

@@ -0,0 +1,187 @@
+import { agent } from '@fabric-harness/sdk/strict';
+import { cloudflare } from './index.js';
+function mergeProfile(options) {
+    const profile = options?.profile;
+    if (!profile)
+        return {};
+    return {
+        ...(profile.name !== undefined ? { name: profile.name } : {}),
+        ...(profile.description !== undefined ? { description: profile.description } : {}),
+        ...(profile.instructions !== undefined ? { instructions: profile.instructions } : {}),
+        ...(profile.model !== undefined ? { model: profile.model } : {}),
+        ...(profile.skills !== undefined ? { skills: profile.skills } : {}),
+        ...(profile.tools !== undefined ? { tools: profile.tools } : {}),
+        ...(profile.policy !== undefined ? { policy: profile.policy } : {}),
+        ...(profile.costBudget !== undefined ? { costBudget: profile.costBudget } : {}),
+        ...(profile.approvals !== undefined ? { approvals: profile.approvals } : {}),
+        ...(profile.sandbox !== undefined ? { sandbox: profile.sandbox } : {}),
+    };
+}
+function mergeOptions(options) {
+    const profile = mergeProfile(options);
+    return {
+        ...profile,
+        ...options,
+        ...(profile.skills || options.skills ? { skills: [...(profile.skills ?? []), ...(options.skills ?? [])] } : {}),
+        ...(profile.tools || options.tools ? { tools: [...(profile.tools ?? []), ...(options.tools ?? [])] } : {}),
+    };
+}
+function resolveTools(bundle, tools) {
+    if (!tools)
+        return [];
+    const stringTools = tools.filter((t) => typeof t === 'string');
+    const toolDefs = tools.filter((t) => typeof t !== 'string');
+    if (stringTools.length > 0) {
+        const resolved = resolveToolRefs(bundle, stringTools);
+        return [...resolved, ...toolDefs];
+    }
+    return toolDefs;
+}
+/**
+ * Shared run body for both `cloudflareAgent` and `defineCloudflareAgent`. Threads the bundle's
+ * Cloudflare model provider through by default — env-driven agents get the Workers AI
+ * provider unless an explicit provider is supplied (or `--mock` overrides it upstream).
+ */
+async function runWithBundle(context, bundle, options) {
+    const extraTools = resolveTools(bundle, options.tools);
+    const agent = await context.init({
+        modelProvider: options.modelProvider ?? bundle.modelProvider,
+        tools: [...bundle.tools, ...extraTools],
+        policy: bundle.policy,
+        ...(bundle.store ? { store: bundle.store } : {}),
+        ...(options.skills ? { skills: options.skills } : {}),
+        ...(options.sandbox ? { sandbox: options.sandbox } : {}),
+    });
+    const session = await agent.session();
+    const question = context.input?.question ?? 'What would you like to know?';
+    return session.prompt(question);
+}
+function buildAgentDefinition(options) {
+    const merged = mergeOptions(options);
+    const bundle = cloudflare(merged.cloudflare);
+    const def = {
+        run: (context) => runWithBundle(context, bundle, {
+            ...(merged.modelProvider ? { modelProvider: merged.modelProvider } : {}),
+            ...(merged.tools ? { tools: merged.tools } : {}),
+            ...(merged.skills ? { skills: merged.skills } : {}),
+            ...(merged.sandbox ? { sandbox: merged.sandbox } : {}),
+        }),
+    };
+    if (merged.name !== undefined)
+        def.name = merged.name;
+    if (merged.description !== undefined)
+        def.description = merged.description;
+    if (merged.instructions !== undefined)
+        def.instructions = merged.instructions;
+    if (merged.input !== undefined)
+        def.input = merged.input;
+    if (merged.output !== undefined)
+        def.output = merged.output;
+    if (merged.model !== undefined)
+        def.model = merged.model;
+    if (merged.target !== undefined)
+        def.target = merged.target;
+    if (merged.skills !== undefined)
+        def.skills = merged.skills;
+    if (merged.triggers !== undefined)
+        def.triggers = merged.triggers;
+    if (merged.policy !== undefined)
+        def.policy = merged.policy;
+    if (merged.costBudget !== undefined)
+        def.costBudget = merged.costBudget;
+    if (merged.approvals !== undefined)
+        def.approvals = merged.approvals;
+    return def;
+}
+export function cloudflareAgent(options) {
+    return agent(buildAgentDefinition(options));
+}
+export function defineCloudflareAgent(options) {
+    const merged = options ? mergeOptions(options) : {};
+    const def = {
+        run: async (context) => {
+            // If explicit cloudflare config is provided, use it directly
+            if (merged.cloudflare) {
+                const bundle = cloudflare(merged.cloudflare);
+                return runWithBundle(context, bundle, {
+                    ...(merged.modelProvider ? { modelProvider: merged.modelProvider } : {}),
+                    ...(merged.tools ? { tools: merged.tools } : {}),
+                    ...(merged.skills ? { skills: merged.skills } : {}),
+                    ...(merged.sandbox ? { sandbox: merged.sandbox } : {}),
+                });
+            }
+            // Otherwise, read from env (or use a dummy config in mock mode)
+            const env = context.env ?? {};
+            const accountId = env.CLOUDFLARE_ACCOUNT_ID;
+            const apiToken = env.CLOUDFLARE_API_TOKEN;
+            const model = env.CLOUDFLARE_MODEL;
+            if (!accountId && env.FABRIC_MOCK !== '1') {
+                throw new Error('Missing CLOUDFLARE_ACCOUNT_ID environment variable. Set it or pass an explicit cloudflare config.');
+            }
+            if (!apiToken && env.FABRIC_MOCK !== '1') {
+                throw new Error('Missing CLOUDFLARE_API_TOKEN environment variable. Set it or pass an explicit cloudflare config.');
+            }
+            const config = {
+                accountId: accountId ?? 'mock-account-id',
+                ...(apiToken ? { apiToken } : {}),
+                ...(model ? { model } : {}),
+            };
+            const bundle = cloudflare(config);
+            // Default to the bundle's Cloudflare Workers AI model provider so env-driven agents
+            // actually consume the Cloudflare serving endpoint. `--mock` overrides this upstream
+            // (see packages/node/src/run.ts), and an explicit modelProvider still wins.
+            return runWithBundle(context, bundle, {
+                ...(merged.modelProvider ? { modelProvider: merged.modelProvider } : {}),
+                ...(merged.tools ? { tools: merged.tools } : {}),
+                ...(merged.skills ? { skills: merged.skills } : {}),
+                ...(merged.sandbox ? { sandbox: merged.sandbox } : {}),
+            });
+        },
+    };
+    if (merged.name !== undefined)
+        def.name = merged.name;
+    if (merged.description !== undefined)
+        def.description = merged.description;
+    if (merged.instructions !== undefined)
+        def.instructions = merged.instructions;
+    if (merged.input !== undefined)
+        def.input = merged.input;
+    if (merged.output !== undefined)
+        def.output = merged.output;
+    if (merged.model !== undefined)
+        def.model = merged.model;
+    if (merged.target !== undefined)
+        def.target = merged.target;
+    if (merged.skills !== undefined)
+        def.skills = merged.skills;
+    if (merged.triggers !== undefined)
+        def.triggers = merged.triggers;
+    if (merged.policy !== undefined)
+        def.policy = merged.policy;
+    if (merged.costBudget !== undefined)
+        def.costBudget = merged.costBudget;
+    if (merged.approvals !== undefined)
+        def.approvals = merged.approvals;
+    return agent(def);
+}
+export function resolveToolRefs(bundle, refs) {
+    const toolMap = new Map();
+    for (const tool of bundle.tools) {
+        toolMap.set(tool.name, tool);
+    }
+    const shortNameMap = {
+        'search': 'web_search',
+    };
+    const result = [];
+    for (const ref of refs) {
+        const fullName = shortNameMap[ref] ?? ref;
+        const tool = toolMap.get(fullName);
+        if (!tool) {
+            const available = [...toolMap.keys()].join(', ');
+            throw new Error(`Unknown tool reference "${ref}". Available tools: ${available}`);
+        }
+        result.push(tool);
+    }
+    return result;
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAiDxC,SAAS,YAAY,CAAC,OAA0E;IAC9F,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;IACjC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,OAAO;QACL,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClF,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrF,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACvE,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,OAAU;IAEV,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO;QACL,GAAG,OAAO;QACV,GAAG,OAAO;QACV,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/G,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtG,CAAC;AACT,CAAC;AAED,SAAS,YAAY,CAAC,MAAwB,EAAE,KAA4B;IAC1E,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAgB,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IAC1E,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,QAAQ,EAAE,GAAG,QAAQ,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,aAAa,CAC1B,OAA0D,EAC1D,MAAwB,EACxB,OAA6B;IAE7B,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;QAC/B,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,MAAM,CAAC,aAAa;QAC5D,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,GAAG,UAAU,CAAC;QACvC,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChD,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACzD,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAI,OAAO,CAAC,KAA+B,EAAE,QAAQ,IAAI,8BAA8B,CAAC;IACtG,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,oBAAoB,CAAC,OAA+B;IAC3D,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAE7C,MAAM,GAAG,GAAyC;QAChD,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CACf,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE;YAC7B,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChD,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvD,CAAC;KACL,CAAC;IAEF,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACtD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;QAAE,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IAC3E,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS;QAAE,GAAG,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IAC9E,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IACzD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5D,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IACzD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5D,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;QAAE,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAClE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5D,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;QAAE,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACxE,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;QAAE,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IAErE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAA+B;IAC7D,OAAO,KAAK,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAsC;IAC1E,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,MAAM,GAAG,GAAyC;QAChD,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;YACrB,6DAA6D;YAC7D,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAC7C,OAAO,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE;oBACpC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChD,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACnD,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACvD,CAAC,CAAC;YACL,CAAC;YAED,gEAAgE;YAChE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC;YAC9B,MAAM,SAAS,GAAG,GAAG,CAAC,qBAAqB,CAAC;YAC5C,MAAM,QAAQ,GAAG,GAAG,CAAC,oBAAoB,CAAC;YAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,gBAAgB,CAAC;YAEnC,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,WAAW,KAAK,GAAG,EAAE,CAAC;gBAC1C,MAAM,IAAI,KAAK,CAAC,mGAAmG,CAAC,CAAC;YACvH,CAAC;YACD,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,WAAW,KAAK,GAAG,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CAAC,kGAAkG,CAAC,CAAC;YACtH,CAAC;YAED,MAAM,MAAM,GAA2B;gBACrC,SAAS,EAAE,SAAS,IAAI,iBAAiB;gBACzC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACjC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5B,CAAC;YAEF,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;YAClC,oFAAoF;YACpF,qFAAqF;YACrF,4EAA4E;YAC5E,OAAO,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE;gBACpC,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChD,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnD,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvD,CAAC,CAAC;QACL,CAAC;KACF,CAAC;IAEF,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,GAAG,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACtD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;QAAE,GAAG,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IAC3E,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS;QAAE,GAAG,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IAC9E,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IACzD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5D,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IACzD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5D,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;QAAE,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAClE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5D,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;QAAE,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACxE,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS;QAAE,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IAErE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAwB,EAAE,IAAc;IACtE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,YAAY,GAA2B;QAC3C,QAAQ,EAAE,YAAY;KACvB,CAAC;IAEF,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;QAC1C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,SAAS,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,uBAAuB,SAAS,EAAE,CAAC,CAAC;QACpF,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/extension.d.ts

@@ -0,0 +1,12 @@
+export type ExtensionClass = new (...args: any[]) => any;
+export interface CloudflareExtension {
+    base?: (Base: ExtensionClass) => ExtensionClass;
+    wrap?: (Final: ExtensionClass) => ExtensionClass;
+}
+export interface ResolvedCloudflareExtension {
+    base(Base: ExtensionClass): ExtensionClass;
+    wrap(Final: ExtensionClass): ExtensionClass;
+}
+export declare function extend(extension: CloudflareExtension): CloudflareExtension;
+export declare function resolveCloudflareExtension(mod: Record<string, unknown>, name: string, kind: 'Agent' | 'Workflow'): ResolvedCloudflareExtension;
+//# sourceMappingURL=extension.d.ts.map

package/dist/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../src/extension.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;AAEzD,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,cAAc,CAAC;IAChD,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,cAAc,CAAC;CAClD;AAMD,MAAM,WAAW,2BAA2B;IAC1C,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,CAAC;IAC3C,IAAI,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAAC;CAC7C;AAED,wBAAgB,MAAM,CAAC,SAAS,EAAE,mBAAmB,GAAG,mBAAmB,CAe1E;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,GAAG,UAAU,GACzB,2BAA2B,CAwB7B"}

package/dist/extension.js

@@ -0,0 +1,74 @@
+const CLOUDFLARE_EXTENSION = Symbol.for('@fabric-harness/cloudflare-extension');
+export function extend(extension) {
+    if (typeof extension !== 'object' || extension === null || Array.isArray(extension)) {
+        throw new Error('[@fabric-harness/cloudflare] extend() expects an object containing optional base and wrap callbacks.');
+    }
+    const unknownKeys = Object.keys(extension).filter((key) => key !== 'base' && key !== 'wrap');
+    if (unknownKeys.length > 0) {
+        throw new Error(`[@fabric-harness/cloudflare] extend() received unknown option(s): ${unknownKeys.join(', ')}.`);
+    }
+    const branded = {
+        ...extension,
+        [CLOUDFLARE_EXTENSION]: true,
+    };
+    return branded;
+}
+export function resolveCloudflareExtension(mod, name, kind) {
+    const extension = mod.cloudflare;
+    if (extension === undefined)
+        return { base: identity, wrap: identity };
+    if (!isCloudflareExtension(extension)) {
+        throw new Error(`[@fabric-harness/cloudflare] ${kind} "${name}" cloudflare export must be created with extend({ base, wrap }) from "@fabric-harness/cloudflare".`);
+    }
+    const base = extension.base === undefined ? identity : extension.base;
+    const wrap = extension.wrap === undefined ? identity : extension.wrap;
+    if (typeof base !== 'function') {
+        throw new Error(`[@fabric-harness/cloudflare] ${kind} "${name}" cloudflare.base must be a function.`);
+    }
+    if (typeof wrap !== 'function') {
+        throw new Error(`[@fabric-harness/cloudflare] ${kind} "${name}" cloudflare.wrap must be a function.`);
+    }
+    return {
+        base(Base) {
+            return assertExtensionClass(base(Base), Base, name, kind);
+        },
+        wrap(Final) {
+            return assertExtensionWrapper(wrap(Final), Final, name, kind);
+        },
+    };
+}
+function identity(value) {
+    return value;
+}
+function isCloudflareExtension(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        CLOUDFLARE_EXTENSION in value &&
+        value[CLOUDFLARE_EXTENSION] === true);
+}
+function assertExtensionClass(value, Base, name, kind) {
+    if (typeof value !== 'function' ||
+        (value !== Base && !(value.prototype instanceof Base)) ||
+        !isConstructable(value)) {
+        throw new Error(`[@fabric-harness/cloudflare] ${kind} "${name}" cloudflare.base must return the received class or a subclass.`);
+    }
+    return value;
+}
+function assertExtensionWrapper(value, Final, name, kind) {
+    if (typeof value !== 'function' ||
+        (value !== Final && value.prototype !== Final.prototype) ||
+        !isConstructable(value)) {
+        throw new Error(`[@fabric-harness/cloudflare] ${kind} "${name}" cloudflare.wrap(Final) must return the received class or a constructor proxy.`);
+    }
+    return value;
+}
+function isConstructable(value) {
+    try {
+        Reflect.construct(Function, [], value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=extension.js.map

package/dist/extension.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,6 @@
-import type { FilesystemSource, SandboxEnv, SessionStore } from '@fabric-harness/sdk';
+import type { CapabilityPolicy, FilesystemSource, ModelProvider, RunStore, SandboxEnv, SessionStore, ToolDef } from '@fabric-harness/sdk';
+export { extend, resolveCloudflareExtension } from './extension.js';
+export type { CloudflareExtension, ExtensionClass, ResolvedCloudflareExtension } from './extension.js';
 export interface CloudflareDurableObjectSqlStorage {
     exec(query: string, ...bindings: unknown[]): {
         toArray(): Array<Record<string, unknown>>;
@@ -107,5 +109,51 @@ export declare function createCloudflareSandboxEnv(sandbox: CloudflareSandboxLik
  * Workers Durable Objects so Cloudflare SDK types do not leak into the SDK.
  */
 export declare function createCloudflareDurableObjectSessionStore(sql: CloudflareDurableObjectSqlStorage, options?: CloudflareDurableObjectSessionStoreOptions): SessionStore;
+/**
+ * Cloudflare Durable Object SQL-backed RunStore for workflow events.
+ *
+ * Enforces append-only semantics via a `UNIQUE(run_id, event_index)` primary
+ * key on the `fabric_harness_workflow_events` table. Duplicate event indexes
+ * for the same runId are rejected at the storage layer.
+ *
+ * A `BEFORE INSERT` trigger on `fabric_harness_runs` deletes existing events
+ * when a run is reset with the same id (same-ID reset behaviour).
+ */
+export declare function createCloudflareRunStore(sql: CloudflareDurableObjectSqlStorage): RunStore;
+export { cloudflareAgent, defineCloudflareAgent, resolveToolRefs } from './agent.js';
+export type { CloudflareAgentOptions, DefineCloudflareAgentOptions } from './agent.js';
+export { MockCloudflareModelProvider } from './mock-provider.js';
+export type { MockCloudflareModelProviderOptions } from './mock-provider.js';
+export interface CloudflareBundleConfig {
+    /** Cloudflare account id. */
+    accountId: string;
+    /** Cloudflare API token for HTTP calls (optional when using Workers AI binding). */
+    apiToken?: string;
+    /** Durable Object namespace id for session store. */
+    namespaceId?: string;
+    /** Default model id (e.g. `@cf/meta/llama-3.1-8b-instruct`). */
+    model?: string;
+    /** Workers AI binding configuration. */
+    bindings?: {
+        /** The AI binding object — typically `env.AI`. */
+        ai?: import('./workers-ai.js').CloudflareWorkersAIBindingLike;
+        /** Optional R2 bucket binding for large artifacts. */
+        r2?: CloudflareR2BucketLike;
+    };
+    /** Extra tools to include alongside the defaults. */
+    tools?: ToolDef[];
+}
+export interface CloudflareBundle {
+    modelProvider: ModelProvider;
+    tools: ToolDef[];
+    policy: CapabilityPolicy;
+    store?: SessionStore;
+}
+/**
+ * One-call wiring for a Cloudflare-native agent: model provider, Workers AI
+ * binding tools, a safe default egress policy, and an optional Durable Object
+ * session store.
+ */
+export declare function cloudflare(config: CloudflareBundleConfig): CloudflareBundle;
 export declare const CLOUDFLARE_BUILD_TARGET = "cloudflare";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,4 +1,6 @@
-import { approvalStatesFromEntries, createRemoteSandboxEnv } from '@fabric-harness/sdk';
+import { approvalStatesFromEntries, createRemoteSandboxEnv, defineTool } from '@fabric-harness/sdk';
+import { MockCloudflareModelProvider } from './mock-provider.js';
+export { extend, resolveCloudflareExtension } from './extension.js';
 /**
  * Read Cloudflare R2 objects as a Fabric filesystem source. Mount it with
  * `withFilesystemSources()` so support agents can grep/read R2-backed
@@ -272,6 +274,117 @@ export function createCloudflareDurableObjectSessionStore(sql, options = {}) {
         },
     };
 }
+/**
+ * Cloudflare Durable Object SQL-backed RunStore for workflow events.
+ *
+ * Enforces append-only semantics via a `UNIQUE(run_id, event_index)` primary
+ * key on the `fabric_harness_workflow_events` table. Duplicate event indexes
+ * for the same runId are rejected at the storage layer.
+ *
+ * A `BEFORE INSERT` trigger on `fabric_harness_runs` deletes existing events
+ * when a run is reset with the same id (same-ID reset behaviour).
+ */
+export function createCloudflareRunStore(sql) {
+    sql.exec(`CREATE TABLE IF NOT EXISTS fabric_harness_runs (
+      run_id TEXT PRIMARY KEY,
+      status TEXT NOT NULL,
+      started_at TEXT NOT NULL,
+      ended_at TEXT,
+      result TEXT,
+      error TEXT
+    )`);
+    sql.exec(`CREATE TABLE IF NOT EXISTS fabric_harness_workflow_events (
+      run_id TEXT NOT NULL,
+      event_index INTEGER NOT NULL,
+      type TEXT NOT NULL,
+      timestamp TEXT NOT NULL,
+      data TEXT,
+      PRIMARY KEY (run_id, event_index)
+    )`);
+    sql.exec(`CREATE TRIGGER IF NOT EXISTS fabric_harness_runs_reset_events
+     BEFORE INSERT ON fabric_harness_runs
+     BEGIN
+       DELETE FROM fabric_harness_workflow_events WHERE run_id = NEW.run_id;
+     END`);
+    sql.exec('CREATE INDEX IF NOT EXISTS fabric_harness_workflow_events_run_idx ON fabric_harness_workflow_events (run_id, event_index ASC)');
+    return {
+        saveRun(run) {
+            const record = run;
+            const runId = String(record.runId ?? record.id ?? '');
+            if (!runId)
+                throw new Error('RunStore.saveRun requires runId');
+            sql.exec(`INSERT OR REPLACE INTO fabric_harness_runs
+         (run_id, status, started_at, ended_at, result, error)
+         VALUES (?, ?, ?, ?, ?, ?)`, runId, String(record.status ?? 'active'), String(record.startedAt ?? new Date().toISOString()), record.endedAt ?? null, record.result !== undefined ? JSON.stringify(record.result) : null, record.error !== undefined ? JSON.stringify(record.error) : null);
+        },
+        getRun(id) {
+            const rows = sql.exec('SELECT * FROM fabric_harness_runs WHERE run_id = ?', id).toArray();
+            const row = rows[0];
+            if (!row)
+                return undefined;
+            return rowToRunRecord(row);
+        },
+        listRuns() {
+            const rows = sql.exec('SELECT * FROM fabric_harness_runs ORDER BY started_at DESC').toArray();
+            return rows.map((row) => rowToRunRecord(row));
+        },
+        appendRunEvent(runId, event) {
+            // Use plain INSERT (not INSERT OR REPLACE) so duplicates throw.
+            sql.exec(`INSERT INTO fabric_harness_workflow_events
+         (run_id, event_index, type, timestamp, data)
+         VALUES (?, ?, ?, ?, ?)`, runId, event.eventIndex, event.type, event.timestamp, event.data !== undefined ? JSON.stringify(event.data) : null);
+        },
+        getRunEvents(runId, fromIndex) {
+            const rows = fromIndex === undefined
+                ? sql.exec('SELECT run_id, event_index, type, timestamp, data FROM fabric_harness_workflow_events WHERE run_id = ? ORDER BY event_index ASC', runId).toArray()
+                : sql.exec('SELECT run_id, event_index, type, timestamp, data FROM fabric_harness_workflow_events WHERE run_id = ? AND event_index >= ? ORDER BY event_index ASC', runId, fromIndex).toArray();
+            return rows.map((row) => {
+                const data = typeof row.data === 'string' ? JSON.parse(row.data) : undefined;
+                return {
+                    runId: String(row.run_id),
+                    eventIndex: Number(row.event_index),
+                    type: String(row.type),
+                    timestamp: String(row.timestamp),
+                    ...(data !== undefined ? { data } : {}),
+                };
+            });
+        },
+    };
+}
+function rowToRunRecord(row) {
+    const result = typeof row.result === 'string' ? JSON.parse(row.result) : undefined;
+    const error = typeof row.error === 'string' ? JSON.parse(row.error) : undefined;
+    return {
+        runId: String(row.run_id),
+        status: String(row.status),
+        startedAt: String(row.started_at),
+        ...(row.ended_at !== undefined && row.ended_at !== null ? { endedAt: String(row.ended_at) } : {}),
+        ...(result !== undefined ? { result } : {}),
+        ...(error !== undefined ? { error } : {}),
+    };
+}
+export { cloudflareAgent, defineCloudflareAgent, resolveToolRefs } from './agent.js';
+export { MockCloudflareModelProvider } from './mock-provider.js';
+/**
+ * One-call wiring for a Cloudflare-native agent: model provider, Workers AI
+ * binding tools, a safe default egress policy, and an optional Durable Object
+ * session store.
+ */
+export function cloudflare(config) {
+    const tools = [
+        ...(config.tools ?? []),
+    ];
+    const policy = {
+        network: { mode: 'allowlist', hosts: ['*.cloudflare.com', '*.workers.dev'] },
+        commands: [],
+    };
+    const bundle = {
+        modelProvider: new MockCloudflareModelProvider(),
+        tools,
+        policy,
+    };
+    return bundle;
+}
 export const CLOUDFLARE_BUILD_TARGET = 'cloudflare';
 function toCloudflareExecOptions(options) {
     const output = {};