@forestadmin/workflow-executor 1.0.0

package/dist/ports/logger-port.d.ts

@@ -0,0 +1,6 @@
+export interface Logger {
+    error(message: string, context: Record<string, unknown>): void;
+    warn(message: string, context: Record<string, unknown>): void;
+    info(message: string, context: Record<string, unknown>): void;
+}
+//# sourceMappingURL=logger-port.d.ts.map

package/dist/ports/logger-port.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nZ2VyLXBvcnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvcG9ydHMvbG9nZ2VyLXBvcnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/dist/ports/run-store.d.ts

@@ -0,0 +1,9 @@
+import type { Logger } from './logger-port';
+import type { StepExecutionData } from '../types/step-execution-data';
+export interface RunStore {
+    init(logger?: Logger): Promise<void>;
+    close(logger?: Logger): Promise<void>;
+    getStepExecutions(runId: string): Promise<StepExecutionData[]>;
+    saveStepExecution(runId: string, stepExecution: StepExecutionData): Promise<void>;
+}
+//# sourceMappingURL=run-store.d.ts.map

package/dist/ports/run-store.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicnVuLXN0b3JlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3BvcnRzL3J1bi1zdG9yZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/dist/ports/workflow-port.d.ts

@@ -0,0 +1,30 @@
+import type { AvailableStepExecution, StepUser } from '../types/execution-context';
+import type { CollectionSchema } from '../types/validated/collection';
+import type { StepOutcome } from '../types/validated/step-outcome';
+import type { ToolConfig } from '@forestadmin/ai-proxy';
+export interface MalformedRunInfo {
+    runId: string;
+    stepId: string | null;
+    stepIndex: number | null;
+    userMessage: string;
+    technicalMessage: string;
+}
+export interface AvailableRunDispatch {
+    step: AvailableStepExecution;
+    auth: {
+        forestServerToken: string;
+    };
+}
+export interface AvailableRunsBatch {
+    pending: AvailableRunDispatch[];
+    malformed: MalformedRunInfo[];
+}
+export interface WorkflowPort {
+    getAvailableRuns(): Promise<AvailableRunsBatch>;
+    getAvailableRun(runId: string): Promise<AvailableRunDispatch | null>;
+    updateStepExecution(runId: string, stepOutcome: StepOutcome): Promise<AvailableRunDispatch | null>;
+    getCollectionSchema(collectionName: string, runId: string): Promise<CollectionSchema>;
+    getMcpServerConfigs(): Promise<Record<string, ToolConfig>>;
+    hasRunAccess(runId: string, user: StepUser): Promise<boolean>;
+}
+//# sourceMappingURL=workflow-port.d.ts.map

package/dist/ports/workflow-port.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid29ya2Zsb3ctcG9ydC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9wb3J0cy93b3JrZmxvdy1wb3J0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiIifQ==

package/dist/remote-tool-fetcher.d.ts

@@ -0,0 +1,19 @@
+import type { AiModelPort } from './ports/ai-model-port';
+import type { Logger } from './ports/logger-port';
+import type { WorkflowPort } from './ports/workflow-port';
+import type { RemoteTool, ToolConfig } from '@forestadmin/ai-proxy';
+export declare function scopeConfigsToServer(configs: Record<string, ToolConfig>, mcpServerId: string): Record<string, ToolConfig>;
+export interface FetchRemoteToolsResult {
+    tools: RemoteTool[];
+    mcpServerName?: string;
+}
+export default class RemoteToolFetcher {
+    private readonly workflowPort;
+    private readonly aiModelPort;
+    private readonly logger;
+    constructor(workflowPort: WorkflowPort, aiModelPort: AiModelPort, logger: Logger);
+    fetch(mcpServerId: string): Promise<FetchRemoteToolsResult>;
+    private warnMissingTargetServer;
+    private errorOnPartialLoadFailure;
+}
+//# sourceMappingURL=remote-tool-fetcher.d.ts.map

package/dist/remote-tool-fetcher.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scopeConfigsToServer = scopeConfigsToServer;
+// Match by config.id, not by Record key: server names can collide across configs.
+function scopeConfigsToServer(configs, mcpServerId) {
+    return Object.fromEntries(Object.entries(configs).filter(([, cfg]) => cfg.id === mcpServerId));
+}
+class RemoteToolFetcher {
+    constructor(workflowPort, aiModelPort, logger) {
+        this.workflowPort = workflowPort;
+        this.aiModelPort = aiModelPort;
+        this.logger = logger;
+    }
+    async fetch(mcpServerId) {
+        const configs = await this.workflowPort.getMcpServerConfigs();
+        const scoped = scopeConfigsToServer(configs, mcpServerId);
+        const [mcpServerName] = Object.keys(scoped);
+        this.warnMissingTargetServer(configs, scoped, mcpServerId, mcpServerName);
+        if (Object.keys(scoped).length === 0)
+            return { tools: [], mcpServerName };
+        const tools = await this.aiModelPort.loadRemoteTools(scoped);
+        this.errorOnPartialLoadFailure(scoped, tools, mcpServerId, mcpServerName);
+        return { tools, mcpServerName };
+    }
+    // Distinguish "no configs at all" (deployment misconfig) from "configs exist but none match"
+    // (orchestrator/executor drift on server id) — both yield zero tools, but ops need to know
+    // which one to fix.
+    warnMissingTargetServer(configs, scoped, mcpServerId, mcpServerName) {
+        if (Object.keys(scoped).length > 0)
+            return;
+        const availableMcpServerIds = Object.values(configs)
+            .map(cfg => cfg.id)
+            .filter((id) => Boolean(id));
+        this.logger.warn(Object.keys(configs).length === 0
+            ? 'MCP step targets a server but orchestrator returned no MCP configs'
+            : 'MCP step targets a server not advertised by the orchestrator', { requestedMcpServerId: mcpServerId, mcpServerName, availableMcpServerIds });
+    }
+    // Partial-failure detection: McpClient swallows per-server load errors and returns whatever
+    // succeeded. Match config.id against tool.mcpServerId — both providers populate it from the
+    // orchestrator's persisted id, so the check is uniform across MCP and Forest connectors.
+    errorOnPartialLoadFailure(scoped, tools, mcpServerId, mcpServerName) {
+        const loadedMcpServerIds = new Set(tools.map(t => t.mcpServerId));
+        const failedConfigNames = Object.entries(scoped)
+            .filter(([, cfg]) => !loadedMcpServerIds.has(cfg.id))
+            .map(([name]) => name);
+        if (failedConfigNames.length === 0)
+            return;
+        this.logger.error('MCP servers failed to load tools', {
+            requestedMcpServerId: mcpServerId,
+            mcpServerName,
+            failedConfigNames,
+        });
+    }
+}
+exports.default = RemoteToolFetcher;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVtb3RlLXRvb2wtZmV0Y2hlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9yZW1vdGUtdG9vbC1mZXRjaGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBTUEsb0RBS0M7QUFORCxrRkFBa0Y7QUFDbEYsU0FBZ0Isb0JBQW9CLENBQ2xDLE9BQW1DLEVBQ25DLFdBQW1CO0lBRW5CLE9BQU8sTUFBTSxDQUFDLFdBQVcsQ0FBQyxNQUFNLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsRUFBRSxHQUFHLENBQUMsRUFBRSxFQUFFLENBQUMsR0FBRyxDQUFDLEVBQUUsS0FBSyxXQUFXLENBQUMsQ0FBQyxDQUFDO0FBQ2pHLENBQUM7QUFPRCxNQUFxQixpQkFBaUI7SUFLcEMsWUFBWSxZQUEwQixFQUFFLFdBQXdCLEVBQUUsTUFBYztRQUM5RSxJQUFJLENBQUMsWUFBWSxHQUFHLFlBQVksQ0FBQztRQUNqQyxJQUFJLENBQUMsV0FBVyxHQUFHLFdBQVcsQ0FBQztRQUMvQixJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztJQUN2QixDQUFDO0lBRUQsS0FBSyxDQUFDLEtBQUssQ0FBQyxXQUFtQjtRQUM3QixNQUFNLE9BQU8sR0FBRyxNQUFNLElBQUksQ0FBQyxZQUFZLENBQUMsbUJBQW1CLEVBQUUsQ0FBQztRQUM5RCxNQUFNLE1BQU0sR0FBRyxvQkFBb0IsQ0FBQyxPQUFPLEVBQUUsV0FBVyxDQUFDLENBQUM7UUFDMUQsTUFBTSxDQUFDLGFBQWEsQ0FBQyxHQUFHLE1BQU0sQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLENBQUM7UUFFNUMsSUFBSSxDQUFDLHVCQUF1QixDQUFDLE9BQU8sRUFBRSxNQUFNLEVBQUUsV0FBVyxFQUFFLGFBQWEsQ0FBQyxDQUFDO1FBRTFFLElBQUksTUFBTSxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsQ0FBQyxNQUFNLEtBQUssQ0FBQztZQUFFLE9BQU8sRUFBRSxLQUFLLEVBQUUsRUFBRSxFQUFFLGFBQWEsRUFBRSxDQUFDO1FBRTFFLE1BQU0sS0FBSyxHQUFHLE1BQU0sSUFBSSxDQUFDLFdBQVcsQ0FBQyxlQUFlLENBQUMsTUFBTSxDQUFDLENBQUM7UUFFN0QsSUFBSSxDQUFDLHlCQUF5QixDQUFDLE1BQU0sRUFBRSxLQUFLLEVBQUUsV0FBVyxFQUFFLGFBQWEsQ0FBQyxDQUFDO1FBRTFFLE9BQU8sRUFBRSxLQUFLLEVBQUUsYUFBYSxFQUFFLENBQUM7SUFDbEMsQ0FBQztJQUVELDZGQUE2RjtJQUM3RiwyRkFBMkY7SUFDM0Ysb0JBQW9CO0lBQ1osdUJBQXVCLENBQzdCLE9BQW1DLEVBQ25DLE1BQWtDLEVBQ2xDLFdBQW1CLEVBQ25CLGFBQWlDO1FBRWpDLElBQUksTUFBTSxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsQ0FBQyxNQUFNLEdBQUcsQ0FBQztZQUFFLE9BQU87UUFFM0MsTUFBTSxxQkFBcUIsR0FBRyxNQUFNLENBQUMsTUFBTSxDQUFDLE9BQU8sQ0FBQzthQUNqRCxHQUFHLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDO2FBQ2xCLE1BQU0sQ0FBQyxDQUFDLEVBQUUsRUFBZ0IsRUFBRSxDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDO1FBRTdDLElBQUksQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUNkLE1BQU0sQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUMsTUFBTSxLQUFLLENBQUM7WUFDL0IsQ0FBQyxDQUFDLG9FQUFvRTtZQUN0RSxDQUFDLENBQUMsOERBQThELEVBQ2xFLEVBQUUsb0JBQW9CLEVBQUUsV0FBVyxFQUFFLGFBQWEsRUFBRSxxQkFBcUIsRUFBRSxDQUM1RSxDQUFDO0lBQ0osQ0FBQztJQUVELDRGQUE0RjtJQUM1Riw0RkFBNEY7SUFDNUYseUZBQXlGO0lBQ2pGLHlCQUF5QixDQUMvQixNQUFrQyxFQUNsQyxLQUFtQixFQUNuQixXQUFtQixFQUNuQixhQUFpQztRQUVqQyxNQUFNLGtCQUFrQixHQUFHLElBQUksR0FBRyxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUMsV0FBVyxDQUFDLENBQUMsQ0FBQztRQUNsRSxNQUFNLGlCQUFpQixHQUFHLE1BQU0sQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDO2FBQzdDLE1BQU0sQ0FBQyxDQUFDLENBQUMsRUFBRSxHQUFHLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQyxrQkFBa0IsQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxDQUFDO2FBQ3BELEdBQUcsQ0FBQyxDQUFDLENBQUMsSUFBSSxDQUFDLEVBQUUsRUFBRSxDQUFDLElBQUksQ0FBQyxDQUFDO1FBRXpCLElBQUksaUJBQWlCLENBQUMsTUFBTSxLQUFLLENBQUM7WUFBRSxPQUFPO1FBRTNDLElBQUksQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLGtDQUFrQyxFQUFFO1lBQ3BELG9CQUFvQixFQUFFLFdBQVc7WUFDakMsYUFBYTtZQUNiLGlCQUFpQjtTQUNsQixDQUFDLENBQUM7SUFDTCxDQUFDO0NBQ0Y7QUF4RUQsb0NBd0VDIn0=

package/dist/runner.d.ts

@@ -0,0 +1,50 @@
+import type { ActivityLogPortFactory } from './ports/activity-log-port';
+import type { AgentPort } from './ports/agent-port';
+import type { AiModelPort } from './ports/ai-model-port';
+import type { Logger } from './ports/logger-port';
+import type { RunStore } from './ports/run-store';
+import type { WorkflowPort } from './ports/workflow-port';
+import type SchemaCache from './schema-cache';
+import type { StepExecutionData } from './types/step-execution-data';
+export type RunnerState = 'idle' | 'running' | 'draining' | 'stopped';
+export interface RunnerConfig {
+    agentPort: AgentPort;
+    workflowPort: WorkflowPort;
+    runStore: RunStore;
+    schemaCache: SchemaCache;
+    pollingIntervalMs: number;
+    aiModelPort: AiModelPort;
+    activityLogPortFactory: ActivityLogPortFactory;
+    envSecret: string;
+    authSecret: string;
+    logger?: Logger;
+    stopTimeoutMs?: number;
+    stepTimeoutMs?: number;
+    aiInvokeTimeoutMs?: number;
+    maxChainDepth?: number;
+}
+export default class Runner {
+    private readonly config;
+    private pollingTimer;
+    private readonly inFlightRuns;
+    private readonly logger;
+    private readonly remoteToolFetcher;
+    private _state;
+    constructor(config: RunnerConfig);
+    get state(): RunnerState;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getRunStepExecutions(runId: string): Promise<StepExecutionData[]>;
+    triggerPoll(runId: string, options?: {
+        pendingData?: unknown;
+        bearerUserId?: number;
+    }): Promise<void>;
+    private assertRunNotInFlight;
+    private schedulePoll;
+    private runPollCycle;
+    private reportMalformedRun;
+    private executeStep;
+    private doExecuteStep;
+    private get contextConfig();
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.js

@@ -0,0 +1,317 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const console_logger_1 = __importDefault(require("./adapters/console-logger"));
+const defaults_1 = require("./defaults");
+const errors_1 = require("./errors");
+const step_executor_factory_1 = __importDefault(require("./executors/step-executor-factory"));
+const in_flight_run_registry_1 = __importDefault(require("./in-flight-run-registry"));
+const remote_tool_fetcher_1 = __importDefault(require("./remote-tool-fetcher"));
+const step_outcome_1 = require("./types/validated/step-outcome");
+const validate_secrets_1 = __importDefault(require("./validate-secrets"));
+class Runner {
+    constructor(config) {
+        this.pollingTimer = null;
+        this.inFlightRuns = new in_flight_run_registry_1.default();
+        this._state = 'idle';
+        this.config = config;
+        this.logger = config.logger ?? new console_logger_1.default();
+        this.remoteToolFetcher = new remote_tool_fetcher_1.default(config.workflowPort, config.aiModelPort, this.logger);
+    }
+    get state() {
+        return this._state;
+    }
+    async start() {
+        if (this._state === 'stopped' || this._state === 'draining') {
+            throw new Error('Runner has been stopped and cannot be restarted');
+        }
+        if (this._state === 'running')
+            return;
+        (0, validate_secrets_1.default)({ envSecret: this.config.envSecret, authSecret: this.config.authSecret });
+        // Probe the agent first so we fail fast without opening DB connections when unreachable.
+        await this.config.agentPort.probe();
+        this.logger.info('Agent probe passed', {});
+        await this.config.runStore.init(this.logger);
+        this._state = 'running';
+        this.schedulePoll();
+    }
+    async stop() {
+        if (this._state === 'idle' || this._state === 'stopped' || this._state === 'draining')
+            return;
+        this._state = 'draining';
+        this.logger.info('Graceful shutdown initiated', { inFlightRuns: this.inFlightRuns.size });
+        if (this.pollingTimer !== null) {
+            clearTimeout(this.pollingTimer);
+            this.pollingTimer = null;
+        }
+        try {
+            // Drain in-flight runs (each entry may cover a whole auto-chain).
+            if (this.inFlightRuns.size > 0) {
+                this.logger.info('Draining in-flight runs', {
+                    count: this.inFlightRuns.size,
+                    runs: [...this.inFlightRuns.keys()],
+                });
+                const timeout = this.config.stopTimeoutMs ?? defaults_1.DEFAULT_STOP_TIMEOUT_MS;
+                let drainTimer;
+                const drainResult = await Promise.race([
+                    this.inFlightRuns.drain().then(() => {
+                        if (drainTimer)
+                            clearTimeout(drainTimer);
+                        return 'drained';
+                    }),
+                    new Promise(resolve => {
+                        drainTimer = setTimeout(() => resolve('timeout'), timeout);
+                    }),
+                ]);
+                if (drainResult === 'timeout') {
+                    this.logger.error('Drain timeout — runs still in flight', {
+                        remainingRuns: [...this.inFlightRuns.keys()],
+                        timeoutMs: timeout,
+                    });
+                }
+                else {
+                    this.logger.info('All in-flight runs drained', {});
+                }
+            }
+            // Wait for fire-and-forget activity-log transitions to settle before closing resources —
+            // otherwise audit-trail rows can be left stuck in Pending.
+            await this.config.activityLogPortFactory.drain();
+            const results = await Promise.allSettled([
+                this.config.aiModelPort.closeConnections(),
+                this.config.runStore.close(this.logger),
+            ]);
+            for (const result of results) {
+                if (result.status === 'rejected') {
+                    this.logger.error('Resource cleanup failed during shutdown', {
+                        error: result.reason instanceof Error ? result.reason.message : String(result.reason),
+                    });
+                }
+            }
+        }
+        finally {
+            this._state = 'stopped';
+            this.logger.info('Workflow executor stopped', {});
+        }
+    }
+    async getRunStepExecutions(runId) {
+        return this.config.runStore.getStepExecutions(runId);
+    }
+    async triggerPoll(runId, options) {
+        // Best-effort local short-circuit: skip the orchestrator round-trip when THIS instance is
+        // already running the run. It is NOT a concurrency guard — inFlightRuns is per-instance and a
+        // deployment can run several executors, so genuine duplicate-execution prevention is the
+        // orchestrator's job (it atomically claims a pending run; concurrent triggers get nothing).
+        this.assertRunNotInFlight(runId);
+        let dispatch;
+        try {
+            dispatch = await this.config.workflowPort.getAvailableRun(runId);
+        }
+        catch (err) {
+            if (err instanceof errors_1.MalformedRunError) {
+                await this.reportMalformedRun(err.info);
+            }
+            throw err;
+        }
+        if (!dispatch)
+            throw new errors_1.RunNotFoundError(runId);
+        const { step, auth } = dispatch;
+        if (options?.bearerUserId !== undefined && step.user.id !== options.bearerUserId) {
+            throw new errors_1.UserMismatchError(runId);
+        }
+        await this.executeStep(step, auth.forestServerToken, options?.pendingData);
+    }
+    assertRunNotInFlight(runId) {
+        if (this.inFlightRuns.has(runId)) {
+            this.logger.info('Trigger ignored — run already in flight', { runId });
+            throw new errors_1.RunAlreadyInFlightError(runId);
+        }
+    }
+    schedulePoll() {
+        if (this._state !== 'running')
+            return;
+        this.pollingTimer = setTimeout(() => this.runPollCycle(), this.config.pollingIntervalMs);
+    }
+    async runPollCycle() {
+        try {
+            const { pending, malformed } = await this.config.workflowPort.getAvailableRuns();
+            // Each reportMalformedRun has its own try/catch, no individual failure poisons the cycle.
+            await Promise.allSettled(malformed.map(info => this.reportMalformedRun(info)));
+            const dispatchable = pending.filter(d => !this.inFlightRuns.has(d.step.runId));
+            this.logger.info('Poll cycle completed', {
+                fetched: pending.length,
+                dispatching: dispatchable.length,
+                malformed: malformed.length,
+            });
+            await Promise.allSettled(dispatchable.map(d => this.executeStep(d.step, d.auth.forestServerToken)));
+        }
+        catch (error) {
+            this.logger.error('Poll cycle failed', {
+                error: (0, errors_1.extractErrorMessage)(error),
+                stack: error instanceof Error ? error.stack : undefined,
+            });
+        }
+        finally {
+            this.schedulePoll();
+        }
+    }
+    // Posts an error outcome so the orchestrator marks the run failed and stops re-dispatching it.
+    // Idempotent server-side. If stepIndex is null (empty/corrupt history), log loudly and skip —
+    // ops has to clean up manually.
+    async reportMalformedRun(info) {
+        if (info.stepId === null || info.stepIndex === null) {
+            this.logger.error('Malformed run cannot be reported — no available step identified', {
+                runId: info.runId,
+                error: info.technicalMessage,
+            });
+            return;
+        }
+        try {
+            await this.config.workflowPort.updateStepExecution(info.runId, {
+                type: 'record',
+                stepId: info.stepId,
+                stepIndex: info.stepIndex,
+                status: 'error',
+                error: info.userMessage,
+            });
+            this.logger.error('Malformed run reported as error', {
+                runId: info.runId,
+                stepIndex: info.stepIndex,
+                error: info.technicalMessage,
+            });
+        }
+        catch (reportErr) {
+            this.logger.error('Malformed run — also failed to report', {
+                runId: info.runId,
+                mappingError: info.technicalMessage,
+                reportError: (0, errors_1.extractErrorMessage)(reportErr),
+            });
+        }
+    }
+    executeStep(step, forestServerToken, incomingPendingData) {
+        // The tracked promise covers the entire auto-chain for this run plus the map cleanup —
+        // register it once, clean up once. Storing per-step entries (or Promise.resolve()) would
+        // break drain: Promise.allSettled would see already-resolved entries and stop waiting while
+        // the chain is still running.
+        return this.inFlightRuns.track(step.runId, this.doExecuteStep(step, forestServerToken, incomingPendingData));
+    }
+    async doExecuteStep(step, forestServerToken, incomingPendingData) {
+        let currentStep = step;
+        let currentToken = forestServerToken;
+        let currentIncomingData = incomingPendingData;
+        let chainedCount = 0; // additional steps chained after the initial one
+        const maxDepth = this.config.maxChainDepth ?? defaults_1.DEFAULT_MAX_CHAIN_DEPTH;
+        // Sequential by design: each step's outcome drives the next dispatch; steps within one run
+        // cannot overlap. The no-await-in-loop rule doesn't apply here.
+        /* eslint-disable no-await-in-loop, no-constant-condition */
+        while (true) {
+            let result;
+            try {
+                const executor = await step_executor_factory_1.default.create(currentStep, this.contextConfig, this.config.activityLogPortFactory.forRun(currentToken), mcpServerId => this.remoteToolFetcher.fetch(mcpServerId), currentIncomingData);
+                result = await executor.execute();
+            }
+            catch (error) {
+                this.logger.error('FATAL: executor contract violated — reporting synthetic error outcome', {
+                    runId: currentStep.runId,
+                    stepId: currentStep.stepId,
+                    stepIndex: currentStep.stepIndex,
+                    error: (0, errors_1.extractErrorMessage)(error),
+                });
+                // Report a synthetic error outcome so the orchestrator marks the run failed and stops
+                // re-dispatching — without this, the contract-violating step loops forever.
+                const syntheticOutcome = {
+                    type: (0, step_outcome_1.stepTypeToOutcomeType)(currentStep.stepDefinition.type),
+                    stepId: currentStep.stepId,
+                    stepIndex: currentStep.stepIndex,
+                    status: 'error',
+                    error: 'An unexpected error occurred.',
+                };
+                try {
+                    await this.config.workflowPort.updateStepExecution(currentStep.runId, syntheticOutcome);
+                }
+                catch (reportErr) {
+                    this.logger.error('FATAL: also failed to report synthetic error outcome', {
+                        runId: currentStep.runId,
+                        stepId: currentStep.stepId,
+                        reportError: (0, errors_1.extractErrorMessage)(reportErr),
+                    });
+                }
+                return;
+            }
+            let nextDispatch;
+            try {
+                nextDispatch = await this.config.workflowPort.updateStepExecution(currentStep.runId, result.stepOutcome);
+            }
+            catch (error) {
+                this.logger.error('Failed to report step outcome', {
+                    runId: currentStep.runId,
+                    stepId: currentStep.stepId,
+                    stepIndex: currentStep.stepIndex,
+                    error: (0, errors_1.extractErrorMessage)(error),
+                    cause: (0, errors_1.causeMessage)(error),
+                    stack: error instanceof Error ? error.stack : undefined,
+                });
+                return;
+            }
+            if (nextDispatch === null) {
+                this.logger.info('Chain completed — orchestrator returned no further step', {
+                    runId: currentStep.runId,
+                    stepIndex: currentStep.stepIndex,
+                });
+                return;
+            }
+            // Progression safety: the server must advance the workflow within the same run. A cross-run
+            // dispatch would execute under the initial run's inFlightRuns key (and leak the map entry
+            // on cleanup); a non-progressing stepIndex would loop forever. Both are server bugs —
+            // exit the chain and let the next poll re-fetch authoritative state.
+            if (nextDispatch.step.runId !== currentStep.runId ||
+                nextDispatch.step.stepIndex <= currentStep.stepIndex) {
+                this.logger.error('Server returned non-progressing next step — exiting chain', {
+                    runId: currentStep.runId,
+                    currentStepIndex: currentStep.stepIndex,
+                    returnedRunId: nextDispatch.step.runId,
+                    returnedStepIndex: nextDispatch.step.stepIndex,
+                });
+                return;
+            }
+            // Cap check BEFORE incrementing: chainedCount counts chained steps we've already executed.
+            // maxDepth=2 means "run up to 2 chained steps after the initial one" (3 total).
+            if (chainedCount >= maxDepth) {
+                this.logger.info('Chain depth cap reached — yielding to next poll', {
+                    runId: currentStep.runId,
+                    stepIndex: currentStep.stepIndex,
+                    maxDepth,
+                });
+                return;
+            }
+            // Graceful stop: finish the current step, then yield instead of chaining further.
+            if (this._state === 'draining') {
+                this.logger.info('Chain interrupted by stop() — yielding', {
+                    runId: currentStep.runId,
+                    stepIndex: currentStep.stepIndex,
+                });
+                return;
+            }
+            chainedCount += 1;
+            currentStep = nextDispatch.step;
+            currentToken = nextDispatch.auth.forestServerToken;
+            currentIncomingData = undefined; // chained steps never carry pending data
+        }
+        /* eslint-enable no-await-in-loop, no-constant-condition */
+    }
+    get contextConfig() {
+        return {
+            aiModelPort: this.config.aiModelPort,
+            agentPort: this.config.agentPort,
+            workflowPort: this.config.workflowPort,
+            runStore: this.config.runStore,
+            schemaCache: this.config.schemaCache,
+            logger: this.logger,
+            stepTimeoutMs: this.config.stepTimeoutMs,
+            aiInvokeTimeoutMs: this.config.aiInvokeTimeoutMs,
+        };
+    }
+}
+exports.default = Runner;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicnVubmVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL3J1bm5lci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7OztBQVlBLCtFQUFzRDtBQUN0RCx5Q0FBOEU7QUFDOUUscUNBT2tCO0FBQ2xCLDhGQUFvRTtBQUNwRSxzRkFBMkQ7QUFDM0QsZ0ZBQXNEO0FBQ3RELGlFQUF1RTtBQUN2RSwwRUFBaUQ7QUE0QmpELE1BQXFCLE1BQU07SUFRekIsWUFBWSxNQUFvQjtRQU54QixpQkFBWSxHQUEwQixJQUFJLENBQUM7UUFDbEMsaUJBQVksR0FBRyxJQUFJLGdDQUFtQixFQUFFLENBQUM7UUFHbEQsV0FBTSxHQUFnQixNQUFNLENBQUM7UUFHbkMsSUFBSSxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUM7UUFDckIsSUFBSSxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUMsTUFBTSxJQUFJLElBQUksd0JBQWEsRUFBRSxDQUFDO1FBQ25ELElBQUksQ0FBQyxpQkFBaUIsR0FBRyxJQUFJLDZCQUFpQixDQUM1QyxNQUFNLENBQUMsWUFBWSxFQUNuQixNQUFNLENBQUMsV0FBVyxFQUNsQixJQUFJLENBQUMsTUFBTSxDQUNaLENBQUM7SUFDSixDQUFDO0lBRUQsSUFBSSxLQUFLO1FBQ1AsT0FBTyxJQUFJLENBQUMsTUFBTSxDQUFDO0lBQ3JCLENBQUM7SUFFRCxLQUFLLENBQUMsS0FBSztRQUNULElBQUksSUFBSSxDQUFDLE1BQU0sS0FBSyxTQUFTLElBQUksSUFBSSxDQUFDLE1BQU0sS0FBSyxVQUFVLEVBQUUsQ0FBQztZQUM1RCxNQUFNLElBQUksS0FBSyxDQUFDLGlEQUFpRCxDQUFDLENBQUM7UUFDckUsQ0FBQztRQUVELElBQUksSUFBSSxDQUFDLE1BQU0sS0FBSyxTQUFTO1lBQUUsT0FBTztRQUV0QyxJQUFBLDBCQUFlLEVBQUMsRUFBRSxTQUFTLEVBQUUsSUFBSSxDQUFDLE1BQU0sQ0FBQyxTQUFTLEVBQUUsVUFBVSxFQUFFLElBQUksQ0FBQyxNQUFNLENBQUMsVUFBVSxFQUFFLENBQUMsQ0FBQztRQUUxRix5RkFBeUY7UUFDekYsTUFBTSxJQUFJLENBQUMsTUFBTSxDQUFDLFNBQVMsQ0FBQyxLQUFLLEVBQUUsQ0FBQztRQUNwQyxJQUFJLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxvQkFBb0IsRUFBRSxFQUFFLENBQUMsQ0FBQztRQUMzQyxNQUFNLElBQUksQ0FBQyxNQUFNLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsTUFBTSxDQUFDLENBQUM7UUFFN0MsSUFBSSxDQUFDLE1BQU0sR0FBRyxTQUFTLENBQUM7UUFFeEIsSUFBSSxDQUFDLFlBQVksRUFBRSxDQUFDO0lBQ3RCLENBQUM7SUFFRCxLQUFLLENBQUMsSUFBSTtRQUNSLElBQUksSUFBSSxDQUFDLE1BQU0sS0FBSyxNQUFNLElBQUksSUFBSSxDQUFDLE1BQU0sS0FBSyxTQUFTLElBQUksSUFBSSxDQUFDLE1BQU0sS0FBSyxVQUFVO1lBQUUsT0FBTztRQUU5RixJQUFJLENBQUMsTUFBTSxHQUFHLFVBQVUsQ0FBQztRQUN6QixJQUFJLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyw2QkFBNkIsRUFBRSxFQUFFLFlBQVksRUFBRSxJQUFJLENBQUMsWUFBWSxDQUFDLElBQUksRUFBRSxDQUFDLENBQUM7UUFFMUYsSUFBSSxJQUFJLENBQUMsWUFBWSxLQUFLLElBQUksRUFBRSxDQUFDO1lBQy9CLFlBQVksQ0FBQyxJQUFJLENBQUMsWUFBWSxDQUFDLENBQUM7WUFDaEMsSUFBSSxDQUFDLFlBQVksR0FBRyxJQUFJLENBQUM7UUFDM0IsQ0FBQztRQUVELElBQUksQ0FBQztZQUNILGtFQUFrRTtZQUNsRSxJQUFJLElBQUksQ0FBQyxZQUFZLENBQUMsSUFBSSxHQUFHLENBQUMsRUFBRSxDQUFDO2dCQUMvQixJQUFJLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyx5QkFBeUIsRUFBRTtvQkFDMUMsS0FBSyxFQUFFLElBQUksQ0FBQyxZQUFZLENBQUMsSUFBSTtvQkFDN0IsSUFBSSxFQUFFLENBQUMsR0FBRyxJQUFJLENBQUMsWUFBWSxDQUFDLElBQUksRUFBRSxDQUFDO2lCQUNwQyxDQUFDLENBQUM7Z0JBRUgsTUFBTSxPQUFPLEdBQUcsSUFBSSxDQUFDLE1BQU0sQ0FBQyxhQUFhLElBQUksa0NBQXVCLENBQUM7Z0JBQ3JFLElBQUksVUFBc0MsQ0FBQztnQkFDM0MsTUFBTSxXQUFXLEdBQUcsTUFBTSxPQUFPLENBQUMsSUFBSSxDQUFDO29CQUNyQyxJQUFJLENBQUMsWUFBWSxDQUFDLEtBQUssRUFBRSxDQUFDLElBQUksQ0FBQyxHQUFHLEVBQUU7d0JBQ2xDLElBQUksVUFBVTs0QkFBRSxZQUFZLENBQUMsVUFBVSxDQUFDLENBQUM7d0JBRXpDLE9BQU8sU0FBa0IsQ0FBQztvQkFDNUIsQ0FBQyxDQUFDO29CQUNGLElBQUksT0FBTyxDQUFZLE9BQU8sQ0FBQyxFQUFFO3dCQUMvQixVQUFVLEdBQUcsVUFBVSxDQUFDLEdBQUcsRUFBRSxDQUFDLE9BQU8sQ0FBQyxTQUFTLENBQUMsRUFBRSxPQUFPLENBQUMsQ0FBQztvQkFDN0QsQ0FBQyxDQUFDO2lCQUNILENBQUMsQ0FBQztnQkFFSCxJQUFJLFdBQVcsS0FBSyxTQUFTLEVBQUUsQ0FBQztvQkFDOUIsSUFBSSxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsc0NBQXNDLEVBQUU7d0JBQ3hELGFBQWEsRUFBRSxDQUFDLEdBQUcsSUFBSSxDQUFDLFlBQVksQ0FBQyxJQUFJLEVBQUUsQ0FBQzt3QkFDNUMsU0FBUyxFQUFFLE9BQU87cUJBQ25CLENBQUMsQ0FBQztnQkFDTCxDQUFDO3FCQUFNLENBQUM7b0JBQ04sSUFBSSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsNEJBQTRCLEVBQUUsRUFBRSxDQUFDLENBQUM7Z0JBQ3JELENBQUM7WUFDSCxDQUFDO1lBRUQseUZBQXlGO1lBQ3pGLDJEQUEyRDtZQUMzRCxNQUFNLElBQUksQ0FBQyxNQUFNLENBQUMsc0JBQXNCLENBQUMsS0FBSyxFQUFFLENBQUM7WUFFakQsTUFBTSxPQUFPLEdBQUcsTUFBTSxPQUFPLENBQUMsVUFBVSxDQUFDO2dCQUN2QyxJQUFJLENBQUMsTUFBTSxDQUFDLFdBQVcsQ0FBQyxnQkFBZ0IsRUFBRTtnQkFDMUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxRQUFRLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUM7YUFDeEMsQ0FBQyxDQUFDO1lBRUgsS0FBSyxNQUFNLE1BQU0sSUFBSSxPQUFPLEVBQUUsQ0FBQztnQkFDN0IsSUFBSSxNQUFNLENBQUMsTUFBTSxLQUFLLFVBQVUsRUFBRSxDQUFDO29CQUNqQyxJQUFJLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyx5Q0FBeUMsRUFBRTt3QkFDM0QsS0FBSyxFQUFFLE1BQU0sQ0FBQyxNQUFNLFlBQVksS0FBSyxDQUFDLENBQUMsQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUM7cUJBQ3RGLENBQUMsQ0FBQztnQkFDTCxDQUFDO1lBQ0gsQ0FBQztRQUNILENBQUM7Z0JBQVMsQ0FBQztZQUNULElBQUksQ0FBQyxNQUFNLEdBQUcsU0FBUyxDQUFDO1lBQ3hCLElBQUksQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLDJCQUEyQixFQUFFLEVBQUUsQ0FBQyxDQUFDO1FBQ3BELENBQUM7SUFDSCxDQUFDO0lBRUQsS0FBSyxDQUFDLG9CQUFvQixDQUFDLEtBQWE7UUFDdEMsT0FBTyxJQUFJLENBQUMsTUFBTSxDQUFDLFFBQVEsQ0FBQyxpQkFBaUIsQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUN2RCxDQUFDO0lBRUQsS0FBSyxDQUFDLFdBQVcsQ0FDZixLQUFhLEVBQ2IsT0FBMEQ7UUFFMUQsMEZBQTBGO1FBQzFGLDhGQUE4RjtRQUM5Rix5RkFBeUY7UUFDekYsNEZBQTRGO1FBQzVGLElBQUksQ0FBQyxvQkFBb0IsQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUVqQyxJQUFJLFFBQXFDLENBQUM7UUFFMUMsSUFBSSxDQUFDO1lBQ0gsUUFBUSxHQUFHLE1BQU0sSUFBSSxDQUFDLE1BQU0sQ0FBQyxZQUFZLENBQUMsZUFBZSxDQUFDLEtBQUssQ0FBQyxDQUFDO1FBQ25FLENBQUM7UUFBQyxPQUFPLEdBQUcsRUFBRSxDQUFDO1lBQ2IsSUFBSSxHQUFHLFlBQVksMEJBQWlCLEVBQUUsQ0FBQztnQkFDckMsTUFBTSxJQUFJLENBQUMsa0JBQWtCLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDO1lBQzFDLENBQUM7WUFFRCxNQUFNLEdBQUcsQ0FBQztRQUNaLENBQUM7UUFFRCxJQUFJLENBQUMsUUFBUTtZQUFFLE1BQU0sSUFBSSx5QkFBZ0IsQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUVqRCxNQUFNLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxHQUFHLFFBQVEsQ0FBQztRQUVoQyxJQUFJLE9BQU8sRUFBRSxZQUFZLEtBQUssU0FBUyxJQUFJLElBQUksQ0FBQyxJQUFJLENBQUMsRUFBRSxLQUFLLE9BQU8sQ0FBQyxZQUFZLEVBQUUsQ0FBQztZQUNqRixNQUFNLElBQUksMEJBQWlCLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDckMsQ0FBQztRQUVELE1BQU0sSUFBSSxDQUFDLFdBQVcsQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLGlCQUFpQixFQUFFLE9BQU8sRUFBRSxXQUFXLENBQUMsQ0FBQztJQUM3RSxDQUFDO0lBRU8sb0JBQW9CLENBQUMsS0FBYTtRQUN4QyxJQUFJLElBQUksQ0FBQyxZQUFZLENBQUMsR0FBRyxDQUFDLEtBQUssQ0FBQyxFQUFFLENBQUM7WUFDakMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMseUNBQXlDLEVBQUUsRUFBRSxLQUFLLEVBQUUsQ0FBQyxDQUFDO1lBRXZFLE1BQU0sSUFBSSxnQ0FBdUIsQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUMzQyxDQUFDO0lBQ0gsQ0FBQztJQUVPLFlBQVk7UUFDbEIsSUFBSSxJQUFJLENBQUMsTUFBTSxLQUFLLFNBQVM7WUFBRSxPQUFPO1FBQ3RDLElBQUksQ0FBQyxZQUFZLEdBQUcsVUFBVSxDQUFDLEdBQUcsRUFBRSxDQUFDLElBQUksQ0FBQyxZQUFZLEVBQUUsRUFBRSxJQUFJLENBQUMsTUFBTSxDQUFDLGlCQUFpQixDQUFDLENBQUM7SUFDM0YsQ0FBQztJQUVPLEtBQUssQ0FBQyxZQUFZO1FBQ3hCLElBQUksQ0FBQztZQUNILE1BQU0sRUFBRSxPQUFPLEVBQUUsU0FBUyxFQUFFLEdBQUcsTUFBTSxJQUFJLENBQUMsTUFBTSxDQUFDLFlBQVksQ0FBQyxnQkFBZ0IsRUFBRSxDQUFDO1lBQ2pGLDBGQUEwRjtZQUMxRixNQUFNLE9BQU8sQ0FBQyxVQUFVLENBQUMsU0FBUyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLElBQUksQ0FBQyxrQkFBa0IsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLENBQUM7WUFFL0UsTUFBTSxZQUFZLEdBQUcsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsSUFBSSxDQUFDLFlBQVksQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDO1lBQy9FLElBQUksQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLHNCQUFzQixFQUFFO2dCQUN2QyxPQUFPLEVBQUUsT0FBTyxDQUFDLE1BQU07Z0JBQ3ZCLFdBQVcsRUFBRSxZQUFZLENBQUMsTUFBTTtnQkFDaEMsU0FBUyxFQUFFLFNBQVMsQ0FBQyxNQUFNO2FBQzVCLENBQUMsQ0FBQztZQUNILE1BQU0sT0FBTyxDQUFDLFVBQVUsQ0FDdEIsWUFBWSxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLElBQUksQ0FBQyxXQUFXLENBQUMsQ0FBQyxDQUFDLElBQUksRUFBRSxDQUFDLENBQUMsSUFBSSxDQUFDLGlCQUFpQixDQUFDLENBQUMsQ0FDMUUsQ0FBQztRQUNKLENBQUM7UUFBQyxPQUFPLEtBQUssRUFBRSxDQUFDO1lBQ2YsSUFBSSxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsbUJBQW1CLEVBQUU7Z0JBQ3JDLEtBQUssRUFBRSxJQUFBLDRCQUFtQixFQUFDLEtBQUssQ0FBQztnQkFDakMsS0FBSyxFQUFFLEtBQUssWUFBWSxLQUFLLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLFNBQVM7YUFDeEQsQ0FBQyxDQUFDO1FBQ0wsQ0FBQztnQkFBUyxDQUFDO1lBQ1QsSUFBSSxDQUFDLFlBQVksRUFBRSxDQUFDO1FBQ3RCLENBQUM7SUFDSCxDQUFDO0lBRUQsK0ZBQStGO0lBQy9GLDhGQUE4RjtJQUM5RixnQ0FBZ0M7SUFDeEIsS0FBSyxDQUFDLGtCQUFrQixDQUFDLElBQXNCO1FBQ3JELElBQUksSUFBSSxDQUFDLE1BQU0sS0FBSyxJQUFJLElBQUksSUFBSSxDQUFDLFNBQVMsS0FBSyxJQUFJLEVBQUUsQ0FBQztZQUNwRCxJQUFJLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxpRUFBaUUsRUFBRTtnQkFDbkYsS0FBSyxFQUFFLElBQUksQ0FBQyxLQUFLO2dCQUNqQixLQUFLLEVBQUUsSUFBSSxDQUFDLGdCQUFnQjthQUM3QixDQUFDLENBQUM7WUFFSCxPQUFPO1FBQ1QsQ0FBQztRQUVELElBQUksQ0FBQztZQUNILE1BQU0sSUFBSSxDQUFDLE1BQU0sQ0FBQyxZQUFZLENBQUMsbUJBQW1CLENBQUMsSUFBSSxDQUFDLEtBQUssRUFBRTtnQkFDN0QsSUFBSSxFQUFFLFFBQVE7Z0JBQ2QsTUFBTSxFQUFFLElBQUksQ0FBQyxNQUFNO2dCQUNuQixTQUFTLEVBQUUsSUFBSSxDQUFDLFNBQVM7Z0JBQ3pCLE1BQU0sRUFBRSxPQUFPO2dCQUNmLEtBQUssRUFBRSxJQUFJLENBQUMsV0FBVzthQUN4QixDQUFDLENBQUM7WUFDSCxJQUFJLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxpQ0FBaUMsRUFBRTtnQkFDbkQsS0FBSyxFQUFFLElBQUksQ0FBQyxLQUFLO2dCQUNqQixTQUFTLEVBQUUsSUFBSSxDQUFDLFNBQVM7Z0JBQ3pCLEtBQUssRUFBRSxJQUFJLENBQUMsZ0JBQWdCO2FBQzdCLENBQUMsQ0FBQztRQUNMLENBQUM7UUFBQyxPQUFPLFNBQVMsRUFBRSxDQUFDO1lBQ25CLElBQUksQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLHVDQUF1QyxFQUFFO2dCQUN6RCxLQUFLLEVBQUUsSUFBSSxDQUFDLEtBQUs7Z0JBQ2pCLFlBQVksRUFBRSxJQUFJLENBQUMsZ0JBQWdCO2dCQUNuQyxXQUFXLEVBQUUsSUFBQSw0QkFBbUIsRUFBQyxTQUFTLENBQUM7YUFDNUMsQ0FBQyxDQUFDO1FBQ0wsQ0FBQztJQUNILENBQUM7SUFFTyxXQUFXLENBQ2pCLElBQTRCLEVBQzVCLGlCQUF5QixFQUN6QixtQkFBNkI7UUFFN0IsdUZBQXVGO1FBQ3ZGLHlGQUF5RjtRQUN6Riw0RkFBNEY7UUFDNUYsOEJBQThCO1FBQzlCLE9BQU8sSUFBSSxDQUFDLFlBQVksQ0FBQyxLQUFLLENBQzVCLElBQUksQ0FBQyxLQUFLLEVBQ1YsSUFBSSxDQUFDLGFBQWEsQ0FBQyxJQUFJLEVBQUUsaUJBQWlCLEVBQUUsbUJBQW1CLENBQUMsQ0FDakUsQ0FBQztJQUNKLENBQUM7SUFFTyxLQUFLLENBQUMsYUFBYSxDQUN6QixJQUE0QixFQUM1QixpQkFBeUIsRUFDekIsbUJBQTZCO1FBRTdCLElBQUksV0FBVyxHQUFHLElBQUksQ0FBQztRQUN2QixJQUFJLFlBQVksR0FBRyxpQkFBaUIsQ0FBQztRQUNyQyxJQUFJLG1CQUFtQixHQUFHLG1CQUFtQixDQUFDO1FBQzlDLElBQUksWUFBWSxHQUFHLENBQUMsQ0FBQyxDQUFDLGlEQUFpRDtRQUN2RSxNQUFNLFFBQVEsR0FBRyxJQUFJLENBQUMsTUFBTSxDQUFDLGFBQWEsSUFBSSxrQ0FBdUIsQ0FBQztRQUV0RSwyRkFBMkY7UUFDM0YsZ0VBQWdFO1FBQ2hFLDREQUE0RDtRQUM1RCxPQUFPLElBQUksRUFBRSxDQUFDO1lBQ1osSUFBSSxNQUEyQixDQUFDO1lBRWhDLElBQUksQ0FBQztnQkFDSCxNQUFNLFFBQVEsR0FBRyxNQUFNLCtCQUFtQixDQUFDLE1BQU0sQ0FDL0MsV0FBVyxFQUNYLElBQUksQ0FBQyxhQUFhLEVBQ2xCLElBQUksQ0FBQyxNQUFNLENBQUMsc0JBQXNCLENBQUMsTUFBTSxDQUFDLFlBQVksQ0FBQyxFQUN2RCxXQUFXLENBQUMsRUFBRSxDQUFDLElBQUksQ0FBQyxpQkFBaUIsQ0FBQyxLQUFLLENBQUMsV0FBVyxDQUFDLEVBQ3hELG1CQUFtQixDQUNwQixDQUFDO2dCQUNGLE1BQU0sR0FBRyxNQUFNLFFBQVEsQ0FBQyxPQUFPLEVBQUUsQ0FBQztZQUNwQyxDQUFDO1lBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztnQkFDZixJQUFJLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyx1RUFBdUUsRUFBRTtvQkFDekYsS0FBSyxFQUFFLFdBQVcsQ0FBQyxLQUFLO29CQUN4QixNQUFNLEVBQUUsV0FBVyxDQUFDLE1BQU07b0JBQzFCLFNBQVMsRUFBRSxXQUFXLENBQUMsU0FBUztvQkFDaEMsS0FBSyxFQUFFLElBQUEsNEJBQW1CLEVBQUMsS0FBSyxDQUFDO2lCQUNsQyxDQUFDLENBQUM7Z0JBRUgsc0ZBQXNGO2dCQUN0Riw0RUFBNEU7Z0JBQzVFLE1BQU0sZ0JBQWdCLEdBQWdCO29CQUNwQyxJQUFJLEVBQUUsSUFBQSxvQ0FBcUIsRUFBQyxXQUFXLENBQUMsY0FBYyxDQUFDLElBQUksQ0FBQztvQkFDNUQsTUFBTSxFQUFFLFdBQVcsQ0FBQyxNQUFNO29CQUMxQixTQUFTLEVBQUUsV0FBVyxDQUFDLFNBQVM7b0JBQ2hDLE1BQU0sRUFBRSxPQUFPO29CQUNmLEtBQUssRUFBRSwrQkFBK0I7aUJBQ3ZDLENBQUM7Z0JBRUYsSUFBSSxDQUFDO29CQUNILE1BQU0sSUFBSSxDQUFDLE1BQU0sQ0FBQyxZQUFZLENBQUMsbUJBQW1CLENBQUMsV0FBVyxDQUFDLEtBQUssRUFBRSxnQkFBZ0IsQ0FBQyxDQUFDO2dCQUMxRixDQUFDO2dCQUFDLE9BQU8sU0FBUyxFQUFFLENBQUM7b0JBQ25CLElBQUksQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLHNEQUFzRCxFQUFFO3dCQUN4RSxLQUFLLEVBQUUsV0FBVyxDQUFDLEtBQUs7d0JBQ3hCLE1BQU0sRUFBRSxXQUFXLENBQUMsTUFBTTt3QkFDMUIsV0FBVyxFQUFFLElBQUEsNEJBQW1CLEVBQUMsU0FBUyxDQUFDO3FCQUM1QyxDQUFDLENBQUM7Z0JBQ0wsQ0FBQztnQkFFRCxPQUFPO1lBQ1QsQ0FBQztZQUVELElBQUksWUFBeUMsQ0FBQztZQUU5QyxJQUFJLENBQUM7Z0JBQ0gsWUFBWSxHQUFHLE1BQU0sSUFBSSxDQUFDLE1BQU0sQ0FBQyxZQUFZLENBQUMsbUJBQW1CLENBQy9ELFdBQVcsQ0FBQyxLQUFLLEVBQ2pCLE1BQU0sQ0FBQyxXQUFXLENBQ25CLENBQUM7WUFDSixDQUFDO1lBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztnQkFDZixJQUFJLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQywrQkFBK0IsRUFBRTtvQkFDakQsS0FBSyxFQUFFLFdBQVcsQ0FBQyxLQUFLO29CQUN4QixNQUFNLEVBQUUsV0FBVyxDQUFDLE1BQU07b0JBQzFCLFNBQVMsRUFBRSxXQUFXLENBQUMsU0FBUztvQkFDaEMsS0FBSyxFQUFFLElBQUEsNEJBQW1CLEVBQUMsS0FBSyxDQUFDO29CQUNqQyxLQUFLLEVBQUUsSUFBQSxxQkFBWSxFQUFDLEtBQUssQ0FBQztvQkFDMUIsS0FBSyxFQUFFLEtBQUssWUFBWSxLQUFLLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLFNBQVM7aUJBQ3hELENBQUMsQ0FBQztnQkFFSCxPQUFPO1lBQ1QsQ0FBQztZQUVELElBQUksWUFBWSxLQUFLLElBQUksRUFBRSxDQUFDO2dCQUMxQixJQUFJLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyx5REFBeUQsRUFBRTtvQkFDMUUsS0FBSyxFQUFFLFdBQVcsQ0FBQyxLQUFLO29CQUN4QixTQUFTLEVBQUUsV0FBVyxDQUFDLFNBQVM7aUJBQ2pDLENBQUMsQ0FBQztnQkFFSCxPQUFPO1lBQ1QsQ0FBQztZQUVELDRGQUE0RjtZQUM1RiwwRkFBMEY7WUFDMUYsc0ZBQXNGO1lBQ3RGLHFFQUFxRTtZQUNyRSxJQUNFLFlBQVksQ0FBQyxJQUFJLENBQUMsS0FBSyxLQUFLLFdBQVcsQ0FBQyxLQUFLO2dCQUM3QyxZQUFZLENBQUMsSUFBSSxDQUFDLFNBQVMsSUFBSSxXQUFXLENBQUMsU0FBUyxFQUNwRCxDQUFDO2dCQUNELElBQUksQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLDJEQUEyRCxFQUFFO29CQUM3RSxLQUFLLEVBQUUsV0FBVyxDQUFDLEtBQUs7b0JBQ3hCLGdCQUFnQixFQUFFLFdBQVcsQ0FBQyxTQUFTO29CQUN2QyxhQUFhLEVBQUUsWUFBWSxDQUFDLElBQUksQ0FBQyxLQUFLO29CQUN0QyxpQkFBaUIsRUFBRSxZQUFZLENBQUMsSUFBSSxDQUFDLFNBQVM7aUJBQy9DLENBQUMsQ0FBQztnQkFFSCxPQUFPO1lBQ1QsQ0FBQztZQUVELDJGQUEyRjtZQUMzRixnRkFBZ0Y7WUFDaEYsSUFBSSxZQUFZLElBQUksUUFBUSxFQUFFLENBQUM7Z0JBQzdCLElBQUksQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLGlEQUFpRCxFQUFFO29CQUNsRSxLQUFLLEVBQUUsV0FBVyxDQUFDLEtBQUs7b0JBQ3hCLFNBQVMsRUFBRSxXQUFXLENBQUMsU0FBUztvQkFDaEMsUUFBUTtpQkFDVCxDQUFDLENBQUM7Z0JBRUgsT0FBTztZQUNULENBQUM7WUFFRCxrRkFBa0Y7WUFDbEYsSUFBSSxJQUFJLENBQUMsTUFBTSxLQUFLLFVBQVUsRUFBRSxDQUFDO2dCQUMvQixJQUFJLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyx3Q0FBd0MsRUFBRTtvQkFDekQsS0FBSyxFQUFFLFdBQVcsQ0FBQyxLQUFLO29CQUN4QixTQUFTLEVBQUUsV0FBVyxDQUFDLFNBQVM7aUJBQ2pDLENBQUMsQ0FBQztnQkFFSCxPQUFPO1lBQ1QsQ0FBQztZQUVELFlBQVksSUFBSSxDQUFDLENBQUM7WUFDbEIsV0FBVyxHQUFHLFlBQVksQ0FBQyxJQUFJLENBQUM7WUFDaEMsWUFBWSxHQUFHLFlBQVksQ0FBQyxJQUFJLENBQUMsaUJBQWlCLENBQUM7WUFDbkQsbUJBQW1CLEdBQUcsU0FBUyxDQUFDLENBQUMseUNBQXlDO1FBQzVFLENBQUM7UUFDRCwyREFBMkQ7SUFDN0QsQ0FBQztJQUVELElBQVksYUFBYTtRQUN2QixPQUFPO1lBQ0wsV0FBVyxFQUFFLElBQUksQ0FBQyxNQUFNLENBQUMsV0FBVztZQUNwQyxTQUFTLEVBQUUsSUFBSSxDQUFDLE1BQU0sQ0FBQyxTQUFTO1lBQ2hDLFlBQVksRUFBRSxJQUFJLENBQUMsTUFBTSxDQUFDLFlBQVk7WUFDdEMsUUFBUSxFQUFFLElBQUksQ0FBQyxNQUFNLENBQUMsUUFBUTtZQUM5QixXQUFXLEVBQUUsSUFBSSxDQUFDLE1BQU0sQ0FBQyxXQUFXO1lBQ3BDLE1BQU0sRUFBRSxJQUFJLENBQUMsTUFBTTtZQUNuQixhQUFhLEVBQUUsSUFBSSxDQUFDLE1BQU0sQ0FBQyxhQUFhO1lBQ3hDLGlCQUFpQixFQUFFLElBQUksQ0FBQyxNQUFNLENBQUMsaUJBQWlCO1NBQ2pELENBQUM7SUFDSixDQUFDO0NBQ0Y7QUF4WEQseUJBd1hDIn0=

package/dist/schema-cache.d.ts

@@ -0,0 +1,11 @@
+import type { CollectionSchema } from './types/validated/collection';
+export default class SchemaCache {
+    private readonly store;
+    private readonly ttlMs;
+    private readonly now;
+    constructor(ttlMs?: number, now?: () => number);
+    get(collectionName: string): CollectionSchema | undefined;
+    set(collectionName: string, schema: CollectionSchema): void;
+    [Symbol.iterator](): IterableIterator<[string, CollectionSchema]>;
+}
+//# sourceMappingURL=schema-cache.d.ts.map

package/dist/schema-cache.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const defaults_1 = require("./defaults");
+class SchemaCache {
+    constructor(ttlMs = defaults_1.DEFAULT_SCHEMA_CACHE_TTL_MS, now = Date.now) {
+        this.store = new Map();
+        this.ttlMs = ttlMs;
+        this.now = now;
+    }
+    get(collectionName) {
+        const entry = this.store.get(collectionName);
+        if (!entry)
+            return undefined;
+        if (this.now() - entry.fetchedAt > this.ttlMs) {
+            this.store.delete(collectionName);
+            return undefined;
+        }
+        return entry.schema;
+    }
+    set(collectionName, schema) {
+        this.store.set(collectionName, { schema, fetchedAt: this.now() });
+    }
+    // Yields non-expired entries; deletes stale ones along the way.
+    *[Symbol.iterator]() {
+        const now = this.now();
+        for (const [key, entry] of this.store) {
+            if (now - entry.fetchedAt <= this.ttlMs) {
+                yield [key, entry.schema];
+            }
+            else {
+                this.store.delete(key);
+            }
+        }
+    }
+}
+exports.default = SchemaCache;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2NoZW1hLWNhY2hlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL3NjaGVtYS1jYWNoZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUVBLHlDQUF5RDtBQUV6RCxNQUFxQixXQUFXO0lBSzlCLFlBQVksUUFBZ0Isc0NBQTJCLEVBQUUsTUFBb0IsSUFBSSxDQUFDLEdBQUc7UUFKcEUsVUFBSyxHQUFHLElBQUksR0FBRyxFQUEyRCxDQUFDO1FBSzFGLElBQUksQ0FBQyxLQUFLLEdBQUcsS0FBSyxDQUFDO1FBQ25CLElBQUksQ0FBQyxHQUFHLEdBQUcsR0FBRyxDQUFDO0lBQ2pCLENBQUM7SUFFRCxHQUFHLENBQUMsY0FBc0I7UUFDeEIsTUFBTSxLQUFLLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsY0FBYyxDQUFDLENBQUM7UUFFN0MsSUFBSSxDQUFDLEtBQUs7WUFBRSxPQUFPLFNBQVMsQ0FBQztRQUU3QixJQUFJLElBQUksQ0FBQyxHQUFHLEVBQUUsR0FBRyxLQUFLLENBQUMsU0FBUyxHQUFHLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUM5QyxJQUFJLENBQUMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxjQUFjLENBQUMsQ0FBQztZQUVsQyxPQUFPLFNBQVMsQ0FBQztRQUNuQixDQUFDO1FBRUQsT0FBTyxLQUFLLENBQUMsTUFBTSxDQUFDO0lBQ3RCLENBQUM7SUFFRCxHQUFHLENBQUMsY0FBc0IsRUFBRSxNQUF3QjtRQUNsRCxJQUFJLENBQUMsS0FBSyxDQUFDLEdBQUcsQ0FBQyxjQUFjLEVBQUUsRUFBRSxNQUFNLEVBQUUsU0FBUyxFQUFFLElBQUksQ0FBQyxHQUFHLEVBQUUsRUFBRSxDQUFDLENBQUM7SUFDcEUsQ0FBQztJQUVELGdFQUFnRTtJQUNoRSxDQUFDLENBQUMsTUFBTSxDQUFDLFFBQVEsQ0FBQztRQUNoQixNQUFNLEdBQUcsR0FBRyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUM7UUFFdkIsS0FBSyxNQUFNLENBQUMsR0FBRyxFQUFFLEtBQUssQ0FBQyxJQUFJLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUN0QyxJQUFJLEdBQUcsR0FBRyxLQUFLLENBQUMsU0FBUyxJQUFJLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztnQkFDeEMsTUFBTSxDQUFDLEdBQUcsRUFBRSxLQUFLLENBQUMsTUFBTSxDQUFDLENBQUM7WUFDNUIsQ0FBQztpQkFBTSxDQUFDO2dCQUNOLElBQUksQ0FBQyxLQUFLLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxDQUFDO1lBQ3pCLENBQUM7UUFDSCxDQUFDO0lBQ0gsQ0FBQztDQUNGO0FBeENELDhCQXdDQyJ9

package/dist/schema-resolver.d.ts

@@ -0,0 +1,11 @@
+import type { WorkflowPort } from './ports/workflow-port';
+import type SchemaCache from './schema-cache';
+import type { CollectionSchema } from './types/validated/collection';
+export default class SchemaResolver {
+    private readonly cache;
+    private readonly workflowPort;
+    private readonly runId;
+    constructor(cache: SchemaCache, workflowPort: WorkflowPort, runId: string);
+    resolve(collectionName: string): Promise<CollectionSchema>;
+}
+//# sourceMappingURL=schema-resolver.d.ts.map

package/dist/schema-resolver.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Per-run schema resolution: binds the shared SchemaCache, the orchestrator port and the
+// current runId once, so callers never thread a loader. Writes into the SAME SchemaCache
+// instance AgentClientAgentPort reads from (get/iterate): the resolver always populates an
+// entry before the agent-port reads it, so the agent-port's SchemaNotCachedError guard does
+// not fire under normal TTLs (a TTL shorter than a single step's round-trip could still evict).
+class SchemaResolver {
+    constructor(cache, workflowPort, runId) {
+        this.cache = cache;
+        this.workflowPort = workflowPort;
+        this.runId = runId;
+    }
+    async resolve(collectionName) {
+        const cached = this.cache.get(collectionName);
+        if (cached)
+            return cached;
+        const schema = await this.workflowPort.getCollectionSchema(collectionName, this.runId);
+        this.cache.set(collectionName, schema);
+        return schema;
+    }
+}
+exports.default = SchemaResolver;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2NoZW1hLXJlc29sdmVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL3NjaGVtYS1yZXNvbHZlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUlBLHlGQUF5RjtBQUN6Rix5RkFBeUY7QUFDekYsMkZBQTJGO0FBQzNGLDRGQUE0RjtBQUM1RixnR0FBZ0c7QUFDaEcsTUFBcUIsY0FBYztJQUtqQyxZQUFZLEtBQWtCLEVBQUUsWUFBMEIsRUFBRSxLQUFhO1FBQ3ZFLElBQUksQ0FBQyxLQUFLLEdBQUcsS0FBSyxDQUFDO1FBQ25CLElBQUksQ0FBQyxZQUFZLEdBQUcsWUFBWSxDQUFDO1FBQ2pDLElBQUksQ0FBQyxLQUFLLEdBQUcsS0FBSyxDQUFDO0lBQ3JCLENBQUM7SUFFRCxLQUFLLENBQUMsT0FBTyxDQUFDLGNBQXNCO1FBQ2xDLE1BQU0sTUFBTSxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLGNBQWMsQ0FBQyxDQUFDO1FBQzlDLElBQUksTUFBTTtZQUFFLE9BQU8sTUFBTSxDQUFDO1FBRTFCLE1BQU0sTUFBTSxHQUFHLE1BQU0sSUFBSSxDQUFDLFlBQVksQ0FBQyxtQkFBbUIsQ0FBQyxjQUFjLEVBQUUsSUFBSSxDQUFDLEtBQUssQ0FBQyxDQUFDO1FBQ3ZGLElBQUksQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLGNBQWMsRUFBRSxNQUFNLENBQUMsQ0FBQztRQUV2QyxPQUFPLE1BQU0sQ0FBQztJQUNoQixDQUFDO0NBQ0Y7QUFwQkQsaUNBb0JDIn0=

package/dist/stores/build-run-store.d.ts

@@ -0,0 +1,5 @@
+import type { RunStore } from '../ports/run-store';
+import type { Options } from 'sequelize';
+export declare function buildDatabaseRunStore(options: Options): Promise<RunStore>;
+export declare function buildInMemoryRunStore(): Promise<RunStore>;
+//# sourceMappingURL=build-run-store.d.ts.map