@sprinterai/runtime 0.6.0 → 0.8.0

package/dist/workflow/claim-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-manager.js","sourceRoot":"","sources":["../../src/workflow/claim-manager.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,aAAa;AAElE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,KAAsD,EACtD,gBAAwB,wBAAwB;IAEhD,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,qBAAqB,CAAC,aAAa,CAAC,CAAC;IACjE,OAAO,OAAO,CAAC,MAAM,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,QAAiC;IAC/D,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAiC,EACjC,gBAAwB,wBAAwB;IAEhD,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;IAClE,OAAO,QAAQ,CAAC,MAAM,CACpB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,GAAG,MAAM,CAChF,CAAC;AACJ,CAAC"}

package/dist/workflow/claim-manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=claim-manager.test.d.ts.map

package/dist/workflow/claim-manager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-manager.test.d.ts","sourceRoot":"","sources":["../../src/workflow/claim-manager.test.ts"],"names":[],"mappings":""}

package/dist/workflow/claim-manager.test.js

@@ -0,0 +1,124 @@
+import { describe, it, expect, vi } from 'vitest';
+import { expireStaleWorkflowNodeClaims, hasActiveClaims, findStaleNodeRuns, DEFAULT_CLAIM_TIMEOUT_MS, } from './claim-manager.js';
+function makeNodeRun(overrides) {
+    return {
+        workflow_run_id: 'run-1',
+        entity_id: 'entity-1',
+        tenant_id: 'tenant-1',
+        node_key: 'node-1',
+        node_type: 'agent_task',
+        label: 'Test Node',
+        field_name: null,
+        block_id: null,
+        output_type: 'field',
+        assignee_type: null,
+        assignee_agent_slug: null,
+        depends_on: [],
+        instructions: null,
+        metadata: null,
+        error_message: null,
+        claimed_by: null,
+        claimed_at: null,
+        attempt_count: 0,
+        started_at: null,
+        completed_at: null,
+        duration_ms: null,
+        created_at: '2026-01-01T10:00:00Z',
+        ...overrides,
+    };
+}
+describe('DEFAULT_CLAIM_TIMEOUT_MS', () => {
+    it('is 15 minutes', () => {
+        expect(DEFAULT_CLAIM_TIMEOUT_MS).toBe(15 * 60_000);
+    });
+});
+describe('expireStaleWorkflowNodeClaims', () => {
+    it('calls expireStaleNodeClaims with provided timeout', async () => {
+        const expired = [makeNodeRun({ id: 'n1', status: 'running' })];
+        const store = { expireStaleNodeClaims: vi.fn(async () => expired) };
+        const count = await expireStaleWorkflowNodeClaims(store, 30_000);
+        expect(store.expireStaleNodeClaims).toHaveBeenCalledWith(30_000);
+        expect(count).toBe(1);
+    });
+    it('uses default timeout when not provided', async () => {
+        const store = { expireStaleNodeClaims: vi.fn(async () => []) };
+        await expireStaleWorkflowNodeClaims(store);
+        expect(store.expireStaleNodeClaims).toHaveBeenCalledWith(DEFAULT_CLAIM_TIMEOUT_MS);
+    });
+    it('returns 0 when no claims were expired', async () => {
+        const store = { expireStaleNodeClaims: vi.fn(async () => []) };
+        const count = await expireStaleWorkflowNodeClaims(store, 60_000);
+        expect(count).toBe(0);
+    });
+    it('returns the count of expired claims', async () => {
+        const store = {
+            expireStaleNodeClaims: vi.fn(async () => [
+                makeNodeRun({ id: 'n1', status: 'running' }),
+                makeNodeRun({ id: 'n2', status: 'running' }),
+                makeNodeRun({ id: 'n3', status: 'running' }),
+            ]),
+        };
+        const count = await expireStaleWorkflowNodeClaims(store, 60_000);
+        expect(count).toBe(3);
+    });
+});
+describe('hasActiveClaims', () => {
+    it('returns true when a running node is claimed', () => {
+        const nodes = [makeNodeRun({ id: 'n1', status: 'running', claimed_by: 'agent-1' })];
+        expect(hasActiveClaims(nodes)).toBe(true);
+    });
+    it('returns false when no nodes are claimed', () => {
+        const nodes = [
+            makeNodeRun({ id: 'n1', status: 'pending' }),
+            makeNodeRun({ id: 'n2', status: 'completed' }),
+        ];
+        expect(hasActiveClaims(nodes)).toBe(false);
+    });
+    it('returns false when running but claimed_by is null', () => {
+        const nodes = [makeNodeRun({ id: 'n1', status: 'running', claimed_by: null })];
+        expect(hasActiveClaims(nodes)).toBe(false);
+    });
+    it('returns false for empty array', () => {
+        expect(hasActiveClaims([])).toBe(false);
+    });
+});
+describe('findStaleNodeRuns', () => {
+    it('returns nodes claimed before the cutoff', () => {
+        const staleAt = new Date(Date.now() - 20 * 60_000).toISOString(); // 20 min ago
+        const recentAt = new Date(Date.now() - 5 * 60_000).toISOString(); // 5 min ago
+        const nodes = [
+            makeNodeRun({ id: 'n1', status: 'running', claimed_by: 'agent-1', claimed_at: staleAt }),
+            makeNodeRun({ id: 'n2', status: 'running', claimed_by: 'agent-1', claimed_at: recentAt }),
+        ];
+        const stale = findStaleNodeRuns(nodes, 15 * 60_000);
+        expect(stale).toHaveLength(1);
+        expect(stale[0].id).toBe('n1');
+    });
+    it('excludes non-running nodes', () => {
+        const oldAt = new Date(Date.now() - 60 * 60_000).toISOString();
+        const nodes = [
+            makeNodeRun({ id: 'n1', status: 'pending', claimed_at: oldAt }),
+            makeNodeRun({ id: 'n2', status: 'completed', claimed_at: oldAt }),
+            makeNodeRun({ id: 'n3', status: 'running', claimed_by: 'agent-1', claimed_at: oldAt }),
+        ];
+        const stale = findStaleNodeRuns(nodes);
+        expect(stale).toHaveLength(1);
+        expect(stale[0].id).toBe('n3');
+    });
+    it('returns empty array when no stale nodes', () => {
+        const recentAt = new Date(Date.now() - 1000).toISOString();
+        const nodes = [
+            makeNodeRun({ id: 'n1', status: 'running', claimed_by: 'agent-1', claimed_at: recentAt }),
+        ];
+        const stale = findStaleNodeRuns(nodes, 15 * 60_000);
+        expect(stale).toHaveLength(0);
+    });
+    it('uses DEFAULT_CLAIM_TIMEOUT_MS when not specified', () => {
+        const staleAt = new Date(Date.now() - 20 * 60_000).toISOString();
+        const nodes = [
+            makeNodeRun({ id: 'n1', status: 'running', claimed_by: 'agent-1', claimed_at: staleAt }),
+        ];
+        expect(findStaleNodeRuns(nodes)).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=claim-manager.test.js.map

package/dist/workflow/claim-manager.test.js.map

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

package/dist/workflow/create-node-executor.d.ts

@@ -0,0 +1,40 @@
+import type { EntityStore, ToolDefinition } from '@sprinterai/core';
+import type { LanguageModel } from 'ai';
+import type { ResolveAgentOptions } from '../agent/agent-resolver.js';
+import type { NodeExecutorFn } from './node-executor.js';
+/**
+ * Dependencies injected into the node executor factory.
+ *
+ * This keeps the executor decoupled from concrete AI SDK providers,
+ * store implementations, and tool registries.
+ */
+export interface CreateNodeExecutorOptions {
+    /** Language model to use for agent tasks. */
+    model: LanguageModel;
+    /** Entity store for writing extracted values back. */
+    entityStore: EntityStore;
+    /** Options for resolving agents by slug. */
+    agentResolverOptions?: ResolveAgentOptions;
+    /** All available tools the agent may use (filtered per-node). */
+    availableTools?: ToolDefinition[];
+    /**
+     * Per-field extraction config.
+     * Keys are field names; values contain extraction instructions,
+     * custom tool slugs, schema properties, and max steps.
+     */
+    fieldExtractionConfigs?: Record<string, {
+        instructions?: string;
+        customTools?: string[];
+        schemaProperty?: Record<string, unknown>;
+        maxSteps?: number;
+    }>;
+}
+/**
+ * Create a NodeExecutorFn that bridges the workflow runner to the agent system.
+ *
+ * For `wait_human` nodes: returns success immediately (no-op).
+ * For `agent_task` nodes: resolves an agent, builds a submitValue tool,
+ * calls executeAgentGenerate, and writes the extracted value to the entity store.
+ */
+export declare function createNodeExecutor(options: CreateNodeExecutorOptions): NodeExecutorFn;
+//# sourceMappingURL=create-node-executor.d.ts.map

package/dist/workflow/create-node-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-node-executor.d.ts","sourceRoot":"","sources":["../../src/workflow/create-node-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,IAAI,CAAC;AAItD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAKnE,OAAO,KAAK,EAA6C,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAIjG;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,6CAA6C;IAC7C,KAAK,EAAE,aAAa,CAAC;IACrB,sDAAsD;IACtD,WAAW,EAAE,WAAW,CAAC;IACzB,4CAA4C;IAC5C,oBAAoB,CAAC,EAAE,mBAAmB,CAAC;IAC3C,iEAAiE;IACjE,cAAc,CAAC,EAAE,cAAc,EAAE,CAAC;IAClC;;;;OAIG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAC7B,MAAM,EACN;QACE,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CACF,CAAC;CACH;AAID;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,cAAc,CA0JrF"}

package/dist/workflow/create-node-executor.js

@@ -0,0 +1,234 @@
+import { defineTool } from '@sprinterai/core';
+import { z } from 'zod';
+import { resolveAgent } from '../agent/agent-resolver.js';
+import { executeAgentGenerate } from '../agent/execute-agent.js';
+import { extractValueFromText, isEmptyFieldValue } from './field-recovery.js';
+// ─── Factory ──────────────────────────────────────────────────
+/**
+ * Create a NodeExecutorFn that bridges the workflow runner to the agent system.
+ *
+ * For `wait_human` nodes: returns success immediately (no-op).
+ * For `agent_task` nodes: resolves an agent, builds a submitValue tool,
+ * calls executeAgentGenerate, and writes the extracted value to the entity store.
+ */
+export function createNodeExecutor(options) {
+    const { model, entityStore, agentResolverOptions, availableTools = [], fieldExtractionConfigs = {}, } = options;
+    return async (context) => {
+        const { node, entityId, entityContent, fieldOverrides } = context;
+        // ── wait_human: no-op ────────────────────────────────────
+        if (node.node_type === 'wait_human' || node.node_type === 'human_input') {
+            return { success: true, fieldsExtracted: [] };
+        }
+        // ── agent_task (and legacy extract_field) ────────────────
+        const fieldName = node.field_name;
+        if (!fieldName) {
+            return {
+                success: false,
+                fieldsExtracted: [],
+                error: `Node ${node.node_key} has no field_name assigned`,
+            };
+        }
+        try {
+            // 1. Resolve the agent
+            const agentSlug = node.assignee_agent_slug ?? 'assistant';
+            const agent = await resolveAgent(agentSlug, agentResolverOptions ?? {});
+            // 2. Build the submitValue tool — captures the extracted value
+            let submittedValue = undefined;
+            let submitCalled = false;
+            const fieldConfig = fieldExtractionConfigs[fieldName];
+            const schemaProperty = fieldConfig?.schemaProperty;
+            // Build a Zod schema for the submitValue tool based on the field schema
+            const valueSchema = buildValueSchema(schemaProperty);
+            const submitValueTool = defineTool({
+                slug: 'submitValue',
+                name: 'Submit Value',
+                description: `Submit the extracted value for the "${fieldName}" field. Call this tool with the value you have determined.`,
+                category: 'workflow',
+                icon: 'check',
+                inputSchema: z.object({
+                    value: valueSchema.describe(`The extracted value for "${fieldName}"`),
+                }),
+                execute: async (input) => {
+                    const typed = input;
+                    submittedValue = typed.value;
+                    submitCalled = true;
+                    return { success: true, field: fieldName, value: typed.value };
+                },
+            });
+            // 3. Assemble tools: submitValue + optionally filtered available tools
+            const tools = [submitValueTool];
+            if (fieldConfig?.customTools && fieldConfig.customTools.length > 0) {
+                // Only include tools matching the field's customTools list
+                const customToolSlugs = new Set(fieldConfig.customTools);
+                for (const tool of availableTools) {
+                    if (customToolSlugs.has(tool.slug)) {
+                        tools.push(tool);
+                    }
+                }
+            }
+            else {
+                // Include all available tools
+                tools.push(...availableTools);
+            }
+            // 4. Build system prompt sections
+            const systemSections = [
+                {
+                    label: 'Role',
+                    content: agent.systemPrompt,
+                    priority: 100,
+                },
+                {
+                    label: 'Field Context',
+                    content: buildFieldContextPrompt(fieldName, schemaProperty),
+                    priority: 80,
+                },
+                {
+                    label: 'Task Instructions',
+                    content: buildTaskInstructions(fieldName, node.instructions, fieldConfig?.instructions, fieldOverrides?.[fieldName]),
+                    priority: 60,
+                },
+            ];
+            // 5. Build user message with entity content
+            const userMessage = buildUserMessage(fieldName, entityContent);
+            const messages = [{ role: 'user', content: userMessage }];
+            // 6. Call the agent
+            const maxSteps = fieldConfig?.maxSteps ?? 5;
+            const result = await executeAgentGenerate({
+                model,
+                systemSections,
+                tools,
+                messages,
+                maxSteps,
+                temperature: 0,
+            });
+            // 7. Determine the extracted value
+            let extractedValue;
+            if (submitCalled) {
+                // Agent called submitValue — use that value
+                extractedValue = submittedValue;
+            }
+            else {
+                // Fallback: extract from text response
+                extractedValue = extractValueFromText(result.text, schemaProperty);
+            }
+            // 8. Write to entity store if we have a value
+            if (!isEmptyFieldValue(extractedValue)) {
+                const updatedContent = { ...entityContent, [fieldName]: extractedValue };
+                await entityStore.updateEntity(entityId, {
+                    content: updatedContent,
+                });
+                return {
+                    success: true,
+                    fieldsExtracted: [fieldName],
+                    updatedContent: { [fieldName]: extractedValue },
+                };
+            }
+            // No value extracted — still succeed but with empty fields
+            return {
+                success: true,
+                fieldsExtracted: [],
+            };
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            return {
+                success: false,
+                fieldsExtracted: [],
+                error: `Failed to extract field "${fieldName}": ${errorMessage}`,
+            };
+        }
+    };
+}
+// ─── Helpers ──────────────────────────────────────────────────
+/**
+ * Build a Zod schema for the submitValue tool's value parameter.
+ * Adapts to the field's JSON schema type when available.
+ */
+function buildValueSchema(schemaProperty) {
+    if (!schemaProperty)
+        return z.unknown();
+    const type = schemaProperty.type;
+    switch (type) {
+        case 'string': {
+            const enumValues = schemaProperty.enum;
+            if (enumValues && enumValues.length > 0) {
+                return z.enum(enumValues);
+            }
+            return z.string();
+        }
+        case 'number':
+        case 'integer':
+            return z.number();
+        case 'boolean':
+            return z.boolean();
+        case 'array':
+            return z.array(z.unknown());
+        case 'object':
+            return z.record(z.unknown());
+        default:
+            return z.unknown();
+    }
+}
+/**
+ * Build the field context prompt section.
+ * Tells the agent what field it is extracting and any schema constraints.
+ */
+function buildFieldContextPrompt(fieldName, schemaProperty) {
+    const parts = [`You are extracting a value for the field: "${fieldName}".`];
+    if (schemaProperty) {
+        const type = schemaProperty.type;
+        if (type) {
+            parts.push(`Expected type: ${type}`);
+        }
+        const enumValues = schemaProperty.enum;
+        if (enumValues && enumValues.length > 0) {
+            parts.push(`Allowed values: ${enumValues.join(', ')}`);
+        }
+        const title = schemaProperty.title;
+        if (title) {
+            parts.push(`Field description: ${title}`);
+        }
+    }
+    parts.push('', 'When you have determined the value, call the `submitValue` tool with the result.', 'If you cannot determine the value, respond with your best assessment and call submitValue anyway.');
+    return parts.join('\n');
+}
+/**
+ * Build the task instructions prompt from multiple sources.
+ * Priority: field override instructions > node instructions > extraction config instructions.
+ */
+function buildTaskInstructions(fieldName, nodeInstructions, extractionInstructions, fieldOverride) {
+    const parts = [];
+    // Field override instructions take highest priority
+    if (fieldOverride?.instructions) {
+        parts.push(fieldOverride.instructions);
+    }
+    // Node instructions from the workflow definition
+    if (nodeInstructions) {
+        parts.push(nodeInstructions);
+    }
+    // Extraction config instructions (from entity type field config)
+    if (extractionInstructions && extractionInstructions !== nodeInstructions) {
+        parts.push(extractionInstructions);
+    }
+    if (parts.length === 0) {
+        parts.push(`Extract the value for the "${fieldName}" field from the provided entity data.`);
+    }
+    return parts.join('\n\n');
+}
+/**
+ * Build the user message containing the entity's current content.
+ * The agent uses this as context for extraction.
+ */
+function buildUserMessage(fieldName, entityContent) {
+    const contentJson = JSON.stringify(entityContent, null, 2);
+    return [
+        `Extract the value for the "${fieldName}" field from the following entity data.`,
+        '',
+        '```json',
+        contentJson,
+        '```',
+        '',
+        'Analyze the data above and call the `submitValue` tool with the extracted value.',
+    ].join('\n');
+}
+//# sourceMappingURL=create-node-executor.js.map

package/dist/workflow/create-node-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-node-executor.js","sourceRoot":"","sources":["../../src/workflow/create-node-executor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAoC3E,iEAAiE;AAEjE;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAkC;IACnE,MAAM,EACJ,KAAK,EACL,WAAW,EACX,oBAAoB,EACpB,cAAc,GAAG,EAAE,EACnB,sBAAsB,GAAG,EAAE,GAC5B,GAAG,OAAO,CAAC;IAEZ,OAAO,KAAK,EAAE,OAA6B,EAAgC,EAAE;QAC3E,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;QAElE,4DAA4D;QAC5D,IAAI,IAAI,CAAC,SAAS,KAAK,YAAY,IAAI,IAAI,CAAC,SAAS,KAAK,aAAa,EAAE,CAAC;YACxE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,EAAE,CAAC;QAChD,CAAC;QAED,4DAA4D;QAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC;QAClC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,eAAe,EAAE,EAAE;gBACnB,KAAK,EAAE,QAAQ,IAAI,CAAC,QAAQ,6BAA6B;aAC1D,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,uBAAuB;YACvB,MAAM,SAAS,GAAG,IAAI,CAAC,mBAAmB,IAAI,WAAW,CAAC;YAC1D,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,oBAAoB,IAAI,EAAE,CAAC,CAAC;YAExE,+DAA+D;YAC/D,IAAI,cAAc,GAAY,SAAS,CAAC;YACxC,IAAI,YAAY,GAAG,KAAK,CAAC;YAEzB,MAAM,WAAW,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;YACtD,MAAM,cAAc,GAAG,WAAW,EAAE,cAAc,CAAC;YAEnD,wEAAwE;YACxE,MAAM,WAAW,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC;YAErD,MAAM,eAAe,GAAG,UAAU,CAAC;gBACjC,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,cAAc;gBACpB,WAAW,EAAE,uCAAuC,SAAS,6DAA6D;gBAC1H,QAAQ,EAAE,UAAU;gBACpB,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;oBACpB,KAAK,EAAE,WAAW,CAAC,QAAQ,CAAC,4BAA4B,SAAS,GAAG,CAAC;iBACtE,CAAC;gBACF,OAAO,EAAE,KAAK,EAAE,KAAc,EAAE,EAAE;oBAChC,MAAM,KAAK,GAAG,KAA2B,CAAC;oBAC1C,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC;oBAC7B,YAAY,GAAG,IAAI,CAAC;oBACpB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;gBACjE,CAAC;aACF,CAAC,CAAC;YAEH,uEAAuE;YACvE,MAAM,KAAK,GAAqB,CAAC,eAAe,CAAC,CAAC;YAElD,IAAI,WAAW,EAAE,WAAW,IAAI,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnE,2DAA2D;gBAC3D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;gBACzD,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;oBAClC,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;wBACnC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACnB,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,8BAA8B;gBAC9B,KAAK,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC;YAChC,CAAC;YAED,kCAAkC;YAClC,MAAM,cAAc,GAAoB;gBACtC;oBACE,KAAK,EAAE,MAAM;oBACb,OAAO,EAAE,KAAK,CAAC,YAAY;oBAC3B,QAAQ,EAAE,GAAG;iBACd;gBACD;oBACE,KAAK,EAAE,eAAe;oBACtB,OAAO,EAAE,uBAAuB,CAAC,SAAS,EAAE,cAAc,CAAC;oBAC3D,QAAQ,EAAE,EAAE;iBACb;gBACD;oBACE,KAAK,EAAE,mBAAmB;oBAC1B,OAAO,EAAE,qBAAqB,CAC5B,SAAS,EACT,IAAI,CAAC,YAAY,EACjB,WAAW,EAAE,YAAY,EACzB,cAAc,EAAE,CAAC,SAAS,CAAC,CAC5B;oBACD,QAAQ,EAAE,EAAE;iBACb;aACF,CAAC;YAEF,4CAA4C;YAC5C,MAAM,WAAW,GAAG,gBAAgB,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;YAC/D,MAAM,QAAQ,GAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YAE1E,oBAAoB;YACpB,MAAM,QAAQ,GAAG,WAAW,EAAE,QAAQ,IAAI,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC;gBACxC,KAAK;gBACL,cAAc;gBACd,KAAK;gBACL,QAAQ;gBACR,QAAQ;gBACR,WAAW,EAAE,CAAC;aACf,CAAC,CAAC;YAEH,mCAAmC;YACnC,IAAI,cAAuB,CAAC;YAE5B,IAAI,YAAY,EAAE,CAAC;gBACjB,4CAA4C;gBAC5C,cAAc,GAAG,cAAc,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,uCAAuC;gBACvC,cAAc,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YACrE,CAAC;YAED,8CAA8C;YAC9C,IAAI,CAAC,iBAAiB,CAAC,cAAc,CAAC,EAAE,CAAC;gBACvC,MAAM,cAAc,GAAG,EAAE,GAAG,aAAa,EAAE,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;gBAEzE,MAAM,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE;oBACvC,OAAO,EAAE,cAAc;iBACxB,CAAC,CAAC;gBAEH,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,eAAe,EAAE,CAAC,SAAS,CAAC;oBAC5B,cAAc,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE;iBAChD,CAAC;YACJ,CAAC;YAED,2DAA2D;YAC3D,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,eAAe,EAAE,EAAE;aACpB,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,YAAY,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACtE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,eAAe,EAAE,EAAE;gBACnB,KAAK,EAAE,4BAA4B,SAAS,MAAM,YAAY,EAAE;aACjE,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED,iEAAiE;AAEjE;;;GAGG;AACH,SAAS,gBAAgB,CAAC,cAAwC;IAChE,IAAI,CAAC,cAAc;QAAE,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;IAExC,MAAM,IAAI,GAAG,cAAc,CAAC,IAA0B,CAAC;IAEvD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,UAAU,GAAG,cAAc,CAAC,IAA4B,CAAC;YAC/D,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAmC,CAAC,CAAC;YACrD,CAAC;YACD,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;QACpB,CAAC;QACD,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC;QACpB,KAAK,SAAS;YACZ,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,OAAO;YACV,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9B,KAAK,QAAQ;YACX,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/B;YACE,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB,CAC9B,SAAiB,EACjB,cAAwC;IAExC,MAAM,KAAK,GAAa,CAAC,8CAA8C,SAAS,IAAI,CAAC,CAAC;IAEtF,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,cAAc,CAAC,IAA0B,CAAC;QACvD,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;QACvC,CAAC;QAED,MAAM,UAAU,GAAG,cAAc,CAAC,IAA4B,CAAC;QAC/D,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,mBAAmB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,KAAK,GAAG,cAAc,CAAC,KAA2B,CAAC;QACzD,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,IAAI,CAAC,sBAAsB,KAAK,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CACR,EAAE,EACF,kFAAkF,EAClF,mGAAmG,CACpG,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB,CAC5B,SAAiB,EACjB,gBAA+B,EAC/B,sBAA+B,EAC/B,aAAyC;IAEzC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,oDAAoD;IACpD,IAAI,aAAa,EAAE,YAAY,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IACzC,CAAC;IAED,iDAAiD;IACjD,IAAI,gBAAgB,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC/B,CAAC;IAED,iEAAiE;IACjE,IAAI,sBAAsB,IAAI,sBAAsB,KAAK,gBAAgB,EAAE,CAAC;QAC1E,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,8BAA8B,SAAS,wCAAwC,CAAC,CAAC;IAC9F,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,SAAiB,EAAE,aAAsC;IACjF,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAE3D,OAAO;QACL,8BAA8B,SAAS,yCAAyC;QAChF,EAAE;QACF,SAAS;QACT,WAAW;QACX,KAAK;QACL,EAAE;QACF,kFAAkF;KACnF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/workflow/field-recovery.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Attempt to parse a structured value from an agent's text response.
+ * Used as a fallback when the agent completes without calling submitValue.
+ *
+ * Handles: JSON code blocks, raw JSON, enum matching, number/boolean extraction.
+ */
+export declare function extractValueFromText(text: string, schemaProperty?: Record<string, unknown>): unknown;
+/**
+ * Check if a field value is "empty" for workflow purposes.
+ */
+export declare function isEmptyFieldValue(value: unknown): boolean;
+//# sourceMappingURL=field-recovery.d.ts.map

package/dist/workflow/field-recovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-recovery.d.ts","sourceRoot":"","sources":["../../src/workflow/field-recovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvC,OAAO,CAoET;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIzD"}

package/dist/workflow/field-recovery.js

@@ -0,0 +1,86 @@
+/**
+ * Attempt to parse a structured value from an agent's text response.
+ * Used as a fallback when the agent completes without calling submitValue.
+ *
+ * Handles: JSON code blocks, raw JSON, enum matching, number/boolean extraction.
+ */
+export function extractValueFromText(text, schemaProperty) {
+    const trimmed = text.trim();
+    // Try JSON code block first
+    const jsonBlockMatch = trimmed.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (jsonBlockMatch) {
+        try {
+            return JSON.parse(jsonBlockMatch[1].trim());
+        }
+        catch {
+            // Fall through
+        }
+    }
+    // Try parsing whole response as JSON
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (parsed !== null && typeof parsed !== 'undefined') {
+            if (typeof parsed === 'object' &&
+                !Array.isArray(parsed) &&
+                schemaProperty?.type !== 'object') {
+                const wrapper = parsed;
+                const scalarKey = ['value', 'result', 'answer', 'response'].find((k) => k in wrapper);
+                if (scalarKey !== undefined)
+                    return wrapper[scalarKey];
+            }
+            else {
+                return parsed;
+            }
+        }
+    }
+    catch {
+        // Not JSON
+    }
+    // Enum matching
+    const enumValues = schemaProperty?.enum;
+    if (enumValues && enumValues.length > 0) {
+        const lowerText = trimmed.toLowerCase();
+        for (const enumVal of enumValues) {
+            if (lowerText.includes(enumVal.toLowerCase()))
+                return enumVal;
+        }
+    }
+    // Number extraction
+    const schemaType = schemaProperty?.type;
+    if (schemaType === 'number' || schemaType === 'integer') {
+        const numberMatch = trimmed.match(/-?\d[\d,]*\.?\d*/);
+        if (numberMatch) {
+            const num = Number(numberMatch[0].replace(/,/g, ''));
+            if (!isNaN(num))
+                return num;
+        }
+    }
+    // Boolean extraction
+    if (schemaType === 'boolean') {
+        const lower = trimmed.toLowerCase();
+        if (/\b(false|no)\b/.test(lower))
+            return false;
+        if (/\b(true|yes)\b/.test(lower))
+            return true;
+    }
+    // Short text — use as string value
+    if (trimmed.length <= 2000)
+        return trimmed;
+    // Long text — try last line
+    const lines = trimmed.split('\n').filter((l) => l.trim());
+    const lastLine = lines[lines.length - 1]?.trim();
+    if (lastLine && lastLine.length <= 500)
+        return lastLine;
+    return undefined;
+}
+/**
+ * Check if a field value is "empty" for workflow purposes.
+ */
+export function isEmptyFieldValue(value) {
+    if (value === null || value === undefined || value === '')
+        return true;
+    if (Array.isArray(value) && value.length === 0)
+        return true;
+    return false;
+}
+//# sourceMappingURL=field-recovery.js.map

package/dist/workflow/field-recovery.js.map

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

package/dist/workflow/index.d.ts

@@ -6,4 +6,12 @@ export type { NodeStatusUpdate } from './evaluate-nodes.js';
 export { runWorkflow } from './workflow-runner.js';
 export type { RunWorkflowOptions, RunWorkflowResult } from './workflow-runner.js';
 export type { NodeExecutionContext, NodeExecutionResult, NodeExecutorFn } from './node-executor.js';
+export { extractValueFromText, isEmptyFieldValue } from './field-recovery.js';
+export { createNodeExecutor } from './create-node-executor.js';
+export type { CreateNodeExecutorOptions } from './create-node-executor.js';
+export { runEntityWorkflow } from './run-entity-workflow.js';
+export type { RunEntityWorkflowOptions } from './run-entity-workflow.js';
+export { getWorkflowRunHistory, getActiveWorkflowRuns, getRecentWorkflowRuns, getWorkflowActivitySummary, } from './run-queries.js';
+export type { WorkflowActivitySummary } from './run-queries.js';
+export { expireStaleWorkflowNodeClaims, hasActiveClaims, findStaleNodeRuns, DEFAULT_CLAIM_TIMEOUT_MS, } from './claim-manager.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/workflow/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,YAAY,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAGtE,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAG7D,OAAO,EACL,6BAA6B,EAC7B,eAAe,EACf,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC"}

package/dist/workflow/index.js

@@ -2,4 +2,11 @@ export { compileEntityWorkflowDefinition, getWorkflowLayers } from './compile.js
 export { computeWorkflowProgress, deriveWorkflowStatus } from './status.js';
 export { evaluateNodeStatuses } from './evaluate-nodes.js';
 export { runWorkflow } from './workflow-runner.js';
+export { extractValueFromText, isEmptyFieldValue } from './field-recovery.js';
+export { createNodeExecutor } from './create-node-executor.js';
+export { runEntityWorkflow } from './run-entity-workflow.js';
+// ─── Run Queries ────────────────────────────────────────────
+export { getWorkflowRunHistory, getActiveWorkflowRuns, getRecentWorkflowRuns, getWorkflowActivitySummary, } from './run-queries.js';
+// ─── Claim Manager ──────────────────────────────────────────
+export { expireStaleWorkflowNodeClaims, hasActiveClaims, findStaleNodeRuns, DEFAULT_CLAIM_TIMEOUT_MS, } from './claim-manager.js';
 //# sourceMappingURL=index.js.map

package/dist/workflow/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/workflow/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGhD,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG1D,+DAA+D;AAC/D,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAGvB,+DAA+D;AAC/D,OAAO,EACL,6BAA6B,EAC7B,eAAe,EACf,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC"}

package/dist/workflow/run-entity-workflow.d.ts

@@ -0,0 +1,53 @@
+import type { EntityStore, EntityTypeRecord, ToolDefinition, WorkflowFieldOverride, WorkflowRunStore, WorkflowTriggerType, EventBus } from '@sprinterai/core';
+import type { LanguageModel } from 'ai';
+import type { ResolveAgentOptions } from '../agent/agent-resolver.js';
+import type { RunWorkflowResult } from './workflow-runner.js';
+/** Options for the high-level entity workflow convenience wrapper. */
+export interface RunEntityWorkflowOptions {
+    /** Entity being processed. */
+    entityId: string;
+    /** Tenant scope. */
+    tenantId: string;
+    /** The entity type record (provides field configs, json_schema, etc.). */
+    entityType: EntityTypeRecord;
+    /** Current entity field values. */
+    entityContent: Record<string, unknown>;
+    /** Store for persisting workflow and node run state. */
+    workflowRunStore: WorkflowRunStore;
+    /** Entity store for writing extracted values back. */
+    entityStore: EntityStore;
+    /** Function to resolve a model ID to a LanguageModel instance. */
+    resolveModel: (modelId?: string) => LanguageModel;
+    /** Options for resolving agents by slug. */
+    agentResolverOptions?: ResolveAgentOptions;
+    /** All available tools the agent may use. */
+    allTools?: ToolDefinition[];
+    /** Optional event bus for emitting workflow events. */
+    eventBus?: EventBus;
+    /** Subset of fields to process. If empty/undefined, process all. */
+    fields?: string[];
+    /** Force re-extraction even if fields are already populated. */
+    force?: boolean;
+    /** How this workflow was triggered. */
+    triggerType?: WorkflowTriggerType;
+    /** Who triggered this workflow (userId, agentSlug, etc.). */
+    triggeredBy?: string;
+    /** Per-field instruction overrides. */
+    fieldOverrides?: Record<string, WorkflowFieldOverride>;
+    /** Max agent loop iterations per field (default: 5). */
+    maxSteps?: number;
+}
+/**
+ * Run an entity extraction workflow end-to-end.
+ *
+ * This is a high-level convenience wrapper that:
+ * 1. Reads field configs from the entity type record
+ * 2. Gets schema properties from the entity type's json_schema
+ * 3. Compiles the workflow definition via compileEntityWorkflowDefinition()
+ * 4. Creates a node executor via createNodeExecutor()
+ * 5. Calls runWorkflow() with everything assembled
+ *
+ * Consumers call one function instead of assembling 5 pieces.
+ */
+export declare function runEntityWorkflow(options: RunEntityWorkflowOptions): Promise<RunWorkflowResult>;
+//# sourceMappingURL=run-entity-workflow.d.ts.map