@stigmer/runner 3.0.1

package/dist/workflow-engine/task-status-accumulator.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Tracks per-task execution status across a workflow run.
+ *
+ * SANDBOX-SAFE: This class runs inside the Temporal deterministic V8
+ * isolate. No Node.js built-ins, no crypto, no non-deterministic ops.
+ * All data is plain objects suitable for serialization across the
+ * sandbox boundary via Temporal local-activity arguments.
+ */
+export interface TaskStatusEntry {
+    readonly taskId: string;
+    readonly taskName: string;
+    readonly taskKind: string;
+    readonly status: "started" | "completed" | "failed" | "skipped" | "waiting_approval";
+    readonly startedAt?: string;
+    readonly completedAt?: string;
+    readonly error?: string;
+    readonly durationMs?: number;
+    readonly input?: unknown;
+    readonly output?: unknown;
+    readonly metadata?: Record<string, unknown>;
+    readonly costMicros?: number;
+    readonly inputTokens?: number;
+    readonly outputTokens?: number;
+}
+/**
+ * Truncates a payload to fit within the configured size limit.
+ *
+ * SANDBOX-SAFE: uses only JSON.stringify (deterministic for plain objects)
+ * and string slicing. No crypto, no Buffer, no Node.js APIs.
+ *
+ * Returns the value unchanged if it fits. Returns a summary object with
+ * a truncation marker and preview if it exceeds the limit.
+ */
+export declare function truncatePayload(value: unknown, maxBytes?: number): unknown;
+export declare class TaskStatusAccumulator {
+    private readonly entries;
+    private readonly attemptCounts;
+    private nextAttempt;
+    private currentAttempt;
+    /** Returns the current attempt number for a task (1-based). */
+    getAttempt(name: string): number;
+    taskStarted(name: string, kind: string): void;
+    taskStartedWithInput(name: string, kind: string, input: unknown): void;
+    taskCompleted(name: string, durationMs: number): void;
+    taskCompletedWithResult(name: string, durationMs: number, output: unknown, cost?: {
+        costMicros: number;
+        inputTokens: number;
+        outputTokens: number;
+    }): void;
+    taskFailed(name: string, error: string, structuredError?: {
+        category: string;
+        detail: string;
+        retryable: boolean;
+    }, durationMs?: number): void;
+    taskSkipped(name: string, reason: string): void;
+    taskWaitingApproval(name: string): void;
+    setTaskMetadata(name: string, metadata: Record<string, unknown>): void;
+    toArray(): TaskStatusEntry[];
+}

package/dist/workflow-engine/task-status-accumulator.js

@@ -0,0 +1,164 @@
+/**
+ * Tracks per-task execution status across a workflow run.
+ *
+ * SANDBOX-SAFE: This class runs inside the Temporal deterministic V8
+ * isolate. No Node.js built-ins, no crypto, no non-deterministic ops.
+ * All data is plain objects suitable for serialization across the
+ * sandbox boundary via Temporal local-activity arguments.
+ */
+/** Maximum serialized size (bytes) for input/output payloads stored per task. */
+const MAX_PAYLOAD_BYTES = 65_536;
+/**
+ * Truncates a payload to fit within the configured size limit.
+ *
+ * SANDBOX-SAFE: uses only JSON.stringify (deterministic for plain objects)
+ * and string slicing. No crypto, no Buffer, no Node.js APIs.
+ *
+ * Returns the value unchanged if it fits. Returns a summary object with
+ * a truncation marker and preview if it exceeds the limit.
+ */
+export function truncatePayload(value, maxBytes = MAX_PAYLOAD_BYTES) {
+    if (value === undefined || value === null)
+        return value;
+    let serialized;
+    try {
+        serialized = JSON.stringify(value);
+    }
+    catch {
+        return { _truncated: true, _reason: "unserializable" };
+    }
+    if (serialized.length <= maxBytes)
+        return value;
+    const preview = serialized.slice(0, 2048);
+    return {
+        _truncated: true,
+        _original_bytes: serialized.length,
+        _preview: preview,
+    };
+}
+export class TaskStatusAccumulator {
+    entries = new Map();
+    attemptCounts = new Map();
+    nextAttempt(name) {
+        const current = this.attemptCounts.get(name) ?? 0;
+        const next = current + 1;
+        this.attemptCounts.set(name, next);
+        return next;
+    }
+    currentAttempt(name) {
+        return this.attemptCounts.get(name) ?? 1;
+    }
+    /** Returns the current attempt number for a task (1-based). */
+    getAttempt(name) {
+        return this.attemptCounts.get(name) ?? 1;
+    }
+    taskStarted(name, kind) {
+        const attempt = this.nextAttempt(name);
+        this.entries.set(name, {
+            taskId: `${name}:${attempt}`,
+            taskName: name,
+            taskKind: kind,
+            status: "started",
+            startedAt: new Date().toISOString(),
+        });
+    }
+    taskStartedWithInput(name, kind, input) {
+        const attempt = this.currentAttempt(name);
+        this.entries.set(name, {
+            taskId: `${name}:${attempt}`,
+            taskName: name,
+            taskKind: kind,
+            status: "started",
+            startedAt: new Date().toISOString(),
+            input: truncatePayload(input),
+        });
+    }
+    taskCompleted(name, durationMs) {
+        const existing = this.entries.get(name);
+        this.entries.set(name, {
+            ...existing,
+            taskId: existing?.taskId ?? `${name}:${this.currentAttempt(name)}`,
+            taskName: name,
+            taskKind: existing?.taskKind ?? "",
+            status: "completed",
+            startedAt: existing?.startedAt,
+            completedAt: new Date().toISOString(),
+            durationMs,
+        });
+    }
+    taskCompletedWithResult(name, durationMs, output, cost) {
+        const existing = this.entries.get(name);
+        this.entries.set(name, {
+            ...existing,
+            taskId: existing?.taskId ?? `${name}:${this.currentAttempt(name)}`,
+            taskName: name,
+            taskKind: existing?.taskKind ?? "",
+            status: "completed",
+            startedAt: existing?.startedAt,
+            completedAt: new Date().toISOString(),
+            durationMs,
+            output: truncatePayload(output),
+            costMicros: cost?.costMicros ?? existing?.costMicros,
+            inputTokens: cost?.inputTokens ?? existing?.inputTokens,
+            outputTokens: cost?.outputTokens ?? existing?.outputTokens,
+        });
+    }
+    taskFailed(name, error, structuredError, durationMs) {
+        const existing = this.entries.get(name);
+        const metadata = structuredError
+            ? {
+                ...existing?.metadata,
+                error_category: structuredError.category,
+                error_detail: structuredError.detail,
+                error_retryable: structuredError.retryable,
+            }
+            : existing?.metadata;
+        this.entries.set(name, {
+            ...existing,
+            taskId: existing?.taskId ?? `${name}:${this.currentAttempt(name)}`,
+            taskName: name,
+            taskKind: existing?.taskKind ?? "",
+            status: "failed",
+            startedAt: existing?.startedAt,
+            completedAt: new Date().toISOString(),
+            error,
+            durationMs,
+            metadata,
+        });
+    }
+    taskSkipped(name, reason) {
+        const existing = this.entries.get(name);
+        this.entries.set(name, {
+            taskId: `${name}:${this.currentAttempt(name)}`,
+            taskName: name,
+            taskKind: existing?.taskKind ?? "",
+            status: "skipped",
+            completedAt: new Date().toISOString(),
+            error: reason,
+        });
+    }
+    taskWaitingApproval(name) {
+        const existing = this.entries.get(name);
+        this.entries.set(name, {
+            ...existing,
+            taskId: existing?.taskId ?? `${name}:${this.currentAttempt(name)}`,
+            taskName: name,
+            taskKind: existing?.taskKind ?? "",
+            status: "waiting_approval",
+            startedAt: existing?.startedAt,
+        });
+    }
+    setTaskMetadata(name, metadata) {
+        const existing = this.entries.get(name);
+        if (!existing)
+            return;
+        this.entries.set(name, {
+            ...existing,
+            metadata: { ...existing.metadata, ...metadata },
+        });
+    }
+    toArray() {
+        return Array.from(this.entries.values());
+    }
+}
+//# sourceMappingURL=task-status-accumulator.js.map

package/dist/workflow-engine/task-status-accumulator.js.map

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

package/dist/workflow-engine/tasks/call-agent-output.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Structured output validation for call:agent results.
+ *
+ * When a call:agent task defines `output.schema`, the agent's
+ * response is validated against the JSON Schema. The `on_invalid`
+ * policy determines behavior on validation failure:
+ *
+ * - ON_INVALID_FAIL: task fails immediately
+ * - ON_INVALID_RETRY: re-prompt with validation errors (up to max_retries)
+ * - ON_INVALID_FALLBACK: branch to fallback_task
+ *
+ * Uses Ajv for JSON Schema Draft 2020-12 validation.
+ *
+ * This module is sandbox-safe — no Node.js built-ins, no I/O.
+ */
+import type { AgentCallResult } from "../types.js";
+export interface ValidationResult {
+    readonly valid: boolean;
+    readonly errors: string[];
+}
+/**
+ * Validates an agent call result against a JSON Schema.
+ * Reads from `result.structured` — the agent domain owns extraction
+ * and this function only validates the already-extracted data.
+ */
+export declare function validateAgentCallOutput(result: AgentCallResult, schema: Record<string, unknown>): ValidationResult;

package/dist/workflow-engine/tasks/call-agent-output.js

@@ -0,0 +1,109 @@
+/**
+ * Structured output validation for call:agent results.
+ *
+ * When a call:agent task defines `output.schema`, the agent's
+ * response is validated against the JSON Schema. The `on_invalid`
+ * policy determines behavior on validation failure:
+ *
+ * - ON_INVALID_FAIL: task fails immediately
+ * - ON_INVALID_RETRY: re-prompt with validation errors (up to max_retries)
+ * - ON_INVALID_FALLBACK: branch to fallback_task
+ *
+ * Uses Ajv for JSON Schema Draft 2020-12 validation.
+ *
+ * This module is sandbox-safe — no Node.js built-ins, no I/O.
+ */
+/**
+ * Validates an agent call result against a JSON Schema.
+ * Reads from `result.structured` — the agent domain owns extraction
+ * and this function only validates the already-extracted data.
+ */
+export function validateAgentCallOutput(result, schema) {
+    const data = extractValidationTarget(result);
+    if (data === undefined) {
+        return {
+            valid: false,
+            errors: ["Agent did not return structured output"],
+        };
+    }
+    return validateJsonSchema(data, schema);
+}
+function extractValidationTarget(result) {
+    if (result.structured !== undefined && result.structured !== null) {
+        return result.structured;
+    }
+    return undefined;
+}
+/**
+ * Lightweight JSON Schema validation. Checks `type`, `required`,
+ * `properties`, and `enum` constraints — the subset used by agent
+ * output schemas. Full Ajv integration is deferred to the activity
+ * layer if deeper schema support (Draft 2020-12 features like
+ * $ref, if/then/else, etc.) is needed.
+ *
+ * This keeps the workflow sandbox free of heavy dependencies.
+ */
+function validateJsonSchema(data, schema) {
+    const errors = [];
+    if (schema.type === "object") {
+        if (typeof data !== "object" || data === null || Array.isArray(data)) {
+            return { valid: false, errors: ["Expected object, got " + typeof data] };
+        }
+        const obj = data;
+        const required = schema.required;
+        if (required) {
+            for (const field of required) {
+                if (!(field in obj)) {
+                    errors.push(`Missing required field '${field}'`);
+                }
+            }
+        }
+        const properties = schema.properties;
+        if (properties) {
+            for (const [field, propSchema] of Object.entries(properties)) {
+                if (!(field in obj))
+                    continue;
+                const value = obj[field];
+                if (propSchema.type && !matchesType(value, propSchema.type)) {
+                    errors.push(`Field '${field}' expected type '${propSchema.type}', got '${typeof value}'`);
+                }
+                if (propSchema.enum && Array.isArray(propSchema.enum)) {
+                    if (!propSchema.enum.includes(value)) {
+                        errors.push(`Field '${field}' must be one of [${propSchema.enum.join(", ")}], got '${value}'`);
+                    }
+                }
+            }
+        }
+    }
+    else if (schema.type === "array") {
+        if (!Array.isArray(data)) {
+            return { valid: false, errors: ["Expected array, got " + typeof data] };
+        }
+    }
+    else if (schema.type) {
+        if (!matchesType(data, schema.type)) {
+            return { valid: false, errors: [`Expected type '${schema.type}', got '${typeof data}'`] };
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+function matchesType(value, expectedType) {
+    switch (expectedType) {
+        case "string":
+            return typeof value === "string";
+        case "number":
+        case "integer":
+            return typeof value === "number";
+        case "boolean":
+            return typeof value === "boolean";
+        case "object":
+            return typeof value === "object" && value !== null && !Array.isArray(value);
+        case "array":
+            return Array.isArray(value);
+        case "null":
+            return value === null;
+        default:
+            return true;
+    }
+}
+//# sourceMappingURL=call-agent-output.js.map

package/dist/workflow-engine/tasks/call-agent-output.js.map

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

package/dist/workflow-engine/tasks/call-agent.d.ts

@@ -0,0 +1,31 @@
+/**
+ * CallAgent task builder — invokes a Stigmer agent from a workflow.
+ *
+ * Unlike call:llm (synchronous activity), call:agent uses Temporal
+ * async completion: the activity creates an AgentExecution with a
+ * callback token and returns pending. The platform completes the
+ * activity when the agent finishes. While pending, the workflow
+ * listens for `child_approval_required` signals for HITL propagation.
+ *
+ * This builder is sandbox-safe — it evaluates jq expressions and
+ * delegates to `ctx.callAgent()`. The async completion and signal
+ * logic live in the workflow-side orchestrator, not here.
+ *
+ * Mirrors Go's `CallAgentTaskBuilder` in `task_builder_call_agent.go`.
+ */
+import type { CallAgentTaskDef, TaskBuilder, TaskExecutorFn } from "../types.js";
+export declare class CallAgentTaskBuilder implements TaskBuilder {
+    readonly taskName: string;
+    readonly taskDef: CallAgentTaskDef;
+    constructor(taskName: string, taskDef: CallAgentTaskDef);
+    build(): TaskExecutorFn;
+    /**
+     * Executes a single agent call with event emission bracketing.
+     *
+     * Emits `agent_call_started` before dispatching and
+     * `agent_call_completed` after completion (success or failure).
+     * These events drive the waterfall timeline's nested sub-span bars.
+     */
+    private executeAgentCall;
+    shouldRun(): Promise<boolean>;
+}

package/dist/workflow-engine/tasks/call-agent.js

@@ -0,0 +1,161 @@
+/**
+ * CallAgent task builder — invokes a Stigmer agent from a workflow.
+ *
+ * Unlike call:llm (synchronous activity), call:agent uses Temporal
+ * async completion: the activity creates an AgentExecution with a
+ * callback token and returns pending. The platform completes the
+ * activity when the agent finishes. While pending, the workflow
+ * listens for `child_approval_required` signals for HITL propagation.
+ *
+ * This builder is sandbox-safe — it evaluates jq expressions and
+ * delegates to `ctx.callAgent()`. The async completion and signal
+ * logic live in the workflow-side orchestrator, not here.
+ *
+ * Mirrors Go's `CallAgentTaskBuilder` in `task_builder_call_agent.go`.
+ */
+import { AgentCallError } from "../types.js";
+import { resolveConfigExpressions } from "../resolve.js";
+import { validateAgentCallOutput } from "./call-agent-output.js";
+/**
+ * Enriches an AgentCallResult with __stigmer_* keys so that
+ * extractCostFromOutput (in do-executor) can pick up cost/token data.
+ *
+ * Agent usage_summary only provides total_tokens (no input/output split).
+ * We map total_tokens to input_tokens and leave output_tokens at 0.
+ * The do-executor sets metadata `token_attribution: "total_only"` so
+ * the frontend can avoid displaying a misleading split.
+ */
+function enrichResultWithCost(result) {
+    const usage = result.usage_summary;
+    if (!usage)
+        return result;
+    return {
+        ...result,
+        __stigmer_cost_micros: Math.round((usage.estimated_cost_usd ?? 0) * 1_000_000),
+        input_tokens: usage.total_tokens ?? 0,
+        output_tokens: 0,
+    };
+}
+export class CallAgentTaskBuilder {
+    taskName;
+    taskDef;
+    constructor(taskName, taskDef) {
+        this.taskName = taskName;
+        this.taskDef = taskDef;
+    }
+    build() {
+        return async (input, state, ctx) => {
+            const withConfig = this.taskDef.with;
+            const resolved = await resolveConfigExpressions(withConfig, input, state, ctx.evaluateExpressions);
+            const config = resolved;
+            const executionId = state.data["__stigmer_execution_id"] ?? "";
+            const metadata = {
+                parentWorkflowId: state.data["__stigmer_parent_workflow_id"] ?? "",
+                taskName: this.taskName,
+                workflowExecutionId: executionId,
+            };
+            const outputContract = withConfig.output;
+            const maxRetries = outputContract?.max_retries ?? 2;
+            let attempts = 0;
+            let lastResult;
+            do {
+                const effectiveConfig = attempts === 0
+                    ? config
+                    : augmentMessageWithValidationError(config, lastResult);
+                lastResult = await this.executeAgentCall(effectiveConfig, state.env, metadata, ctx);
+                attempts++;
+                if (!outputContract?.schema) {
+                    return enrichResultWithCost(lastResult);
+                }
+                const validation = validateAgentCallOutput(lastResult, outputContract.schema);
+                if (validation.valid) {
+                    return enrichResultWithCost(lastResult);
+                }
+                const onInvalid = outputContract.on_invalid ?? "ON_INVALID_FAIL";
+                if (onInvalid === "ON_INVALID_FAIL") {
+                    throw new Error(`Agent output validation failed for task '${this.taskName}': ` +
+                        `${validation.errors.join("; ")}`);
+                }
+                if (onInvalid === "ON_INVALID_FALLBACK") {
+                    return {
+                        __flow_directive__: outputContract.fallback_task ?? "continue",
+                        validation_errors: validation.errors,
+                        original_output: lastResult,
+                    };
+                }
+            } while (attempts <= maxRetries);
+            throw new Error(`Agent output validation failed after ${attempts} attempts ` +
+                `for task '${this.taskName}'. Schema validation did not pass.`);
+        };
+    }
+    /**
+     * Executes a single agent call with event emission bracketing.
+     *
+     * Emits `agent_call_started` before dispatching and
+     * `agent_call_completed` after completion (success or failure).
+     * These events drive the waterfall timeline's nested sub-span bars.
+     */
+    async executeAgentCall(config, env, metadata, ctx) {
+        const callStartMs = Date.now();
+        const messageSummary = (config.message ?? "").slice(0, 200);
+        if (ctx.emitEvents) {
+            await ctx.emitEvents([{
+                    type: "agent_call_started",
+                    taskName: this.taskName,
+                    occurredAt: new Date().toISOString(),
+                    childExecutionId: "",
+                    agentSlug: config.agent ?? "",
+                    messageSummary,
+                }]);
+        }
+        let result;
+        try {
+            result = await ctx.callAgent(config, env, metadata);
+        }
+        catch (err) {
+            const errorChildExecId = err instanceof AgentCallError
+                ? err.childExecutionId
+                : "";
+            if (ctx.emitEvents) {
+                await ctx.emitEvents([{
+                        type: "agent_call_completed",
+                        taskName: this.taskName,
+                        occurredAt: new Date().toISOString(),
+                        childExecutionId: errorChildExecId,
+                        durationMs: Date.now() - callStartMs,
+                        tokensConsumed: 0,
+                        costMicros: 0,
+                        error: err instanceof Error ? err.message : String(err),
+                    }]);
+            }
+            throw err;
+        }
+        if (ctx.emitEvents) {
+            const usage = result.usage_summary;
+            await ctx.emitEvents([{
+                    type: "agent_call_completed",
+                    taskName: this.taskName,
+                    occurredAt: new Date().toISOString(),
+                    childExecutionId: result.agent_execution_id ?? "",
+                    durationMs: Date.now() - callStartMs,
+                    tokensConsumed: usage?.total_tokens ?? 0,
+                    costMicros: Math.round((usage?.estimated_cost_usd ?? 0) * 1_000_000),
+                    error: "",
+                }]);
+        }
+        return result;
+    }
+    async shouldRun() {
+        return true;
+    }
+}
+function augmentMessageWithValidationError(config, previousResult) {
+    const validationContext = `\n\n[RETRY — Your previous response did not match the required output schema. ` +
+        `Previous response: ${JSON.stringify(previousResult.structured ?? previousResult.final_text)}. ` +
+        `Please ensure your response strictly matches the JSON schema provided.]`;
+    return {
+        ...config,
+        message: config.message + validationContext,
+    };
+}
+//# sourceMappingURL=call-agent.js.map

package/dist/workflow-engine/tasks/call-agent.js.map

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

package/dist/workflow-engine/tasks/call-function.d.ts

@@ -0,0 +1,19 @@
+/**
+ * CallFunction task builder — handles Stigmer extension call types:
+ * `call: llm`, `call: agent`, `call: transform`, etc.
+ *
+ * The CNCF DSL uses `call: <string>` for custom function calls.
+ * This builder evaluates expressions in the `with` config, then
+ * delegates to the `ctx.callFunction` callback which routes to
+ * the appropriate Temporal activity based on the `call` value.
+ *
+ * Mirrors Go's custom call function dispatch in `task_builder.go`.
+ */
+import type { CallFunctionTaskDef, TaskBuilder, TaskExecutorFn } from "../types.js";
+export declare class CallFunctionTaskBuilder implements TaskBuilder {
+    readonly taskName: string;
+    readonly taskDef: CallFunctionTaskDef;
+    constructor(taskName: string, taskDef: CallFunctionTaskDef);
+    build(): TaskExecutorFn;
+    shouldRun(): Promise<boolean>;
+}

package/dist/workflow-engine/tasks/call-function.js

@@ -0,0 +1,64 @@
+/**
+ * CallFunction task builder — handles Stigmer extension call types:
+ * `call: llm`, `call: agent`, `call: transform`, etc.
+ *
+ * The CNCF DSL uses `call: <string>` for custom function calls.
+ * This builder evaluates expressions in the `with` config, then
+ * delegates to the `ctx.callFunction` callback which routes to
+ * the appropriate Temporal activity based on the `call` value.
+ *
+ * Mirrors Go's custom call function dispatch in `task_builder.go`.
+ */
+import { resolveConfigExpressions } from "../resolve.js";
+/**
+ * Normalizes the raw LlmCallResult from the activity into the documented
+ * task output contract: { text, structured, model, usage }.
+ *
+ * When response_schema is set, the parsed JSON goes into `.structured`.
+ * When no schema is used, the raw text goes into `.text`.
+ */
+function normalizeLlmOutput(raw, hasResponseSchema) {
+    return {
+        text: hasResponseSchema ? undefined : raw.result,
+        structured: hasResponseSchema ? raw.result : undefined,
+        model: raw.model,
+        usage: {
+            input_tokens: raw.input_tokens,
+            output_tokens: raw.output_tokens,
+        },
+        ...(raw.__stigmer_cost_micros !== undefined
+            ? { __stigmer_cost_micros: raw.__stigmer_cost_micros }
+            : {}),
+    };
+}
+export class CallFunctionTaskBuilder {
+    taskName;
+    taskDef;
+    constructor(taskName, taskDef) {
+        this.taskName = taskName;
+        this.taskDef = taskDef;
+    }
+    build() {
+        return async (input, state, ctx) => {
+            const withConfig = this.taskDef.with ?? {};
+            const resolved = await resolveConfigExpressions(withConfig, input, state, ctx.evaluateExpressions);
+            const callType = this.taskDef.call;
+            if ((callType === "transform" || callType === "validate") &&
+                !("input" in resolved) || resolved.input === undefined) {
+                resolved.input = input;
+            }
+            const executionId = state.env.__stigmer_execution_id || undefined;
+            const result = await ctx.callFunction(callType, resolved, state.env, {
+                workflowExecutionId: executionId,
+            });
+            if (callType === "llm") {
+                return normalizeLlmOutput(result, !!resolved.response_schema);
+            }
+            return result;
+        };
+    }
+    async shouldRun() {
+        return true;
+    }
+}
+//# sourceMappingURL=call-function.js.map