@forestadmin/workflow-executor 1.0.0

package/dist/http/executor-http-server.js

@@ -0,0 +1,170 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const bodyparser_1 = __importDefault(require("@koa/bodyparser"));
+const router_1 = __importDefault(require("@koa/router"));
+const http_1 = __importDefault(require("http"));
+const koa_1 = __importDefault(require("koa"));
+const koa_jwt_1 = __importDefault(require("koa-jwt"));
+const step_serializer_1 = __importDefault(require("./step-serializer"));
+const console_logger_1 = __importDefault(require("../adapters/console-logger"));
+const errors_1 = require("../errors");
+class ExecutorHttpServer {
+    constructor(options) {
+        this.server = null;
+        this.options = options;
+        this.logger = options.logger ?? new console_logger_1.default();
+        this.app = new koa_1.default();
+        // Error middleware — catches all errors (including JWT 401) and returns structured JSON
+        this.app.use(async (ctx, next) => {
+            try {
+                await next();
+            }
+            catch (err) {
+                const { status } = err;
+                if (status === 401) {
+                    ctx.status = 401;
+                    ctx.body = { error: 'Unauthorized' };
+                    return;
+                }
+                this.logger.error('Unhandled HTTP error', {
+                    method: ctx.method,
+                    path: ctx.path,
+                    error: (0, errors_1.extractErrorMessage)(err),
+                    stack: err instanceof Error ? err.stack : undefined,
+                });
+                ctx.status = 500;
+                ctx.body = { error: 'Internal server error' };
+            }
+        });
+        // Health endpoint — before JWT so it's publicly accessible (infra probes don't send tokens)
+        this.app.use(async (ctx, next) => {
+            if (ctx.method === 'GET' && ctx.path === '/health') {
+                const { state } = this.options.runner;
+                ctx.status = state === 'running' || state === 'draining' ? 200 : 503;
+                ctx.body = { state };
+                return;
+            }
+            await next();
+        });
+        this.app.use((0, bodyparser_1.default)());
+        // JWT middleware — validates Bearer token using authSecret
+        // tokenKey: 'rawToken' exposes the raw token string on ctx.state.rawToken for downstream use
+        this.app.use((0, koa_jwt_1.default)({ secret: options.authSecret, cookie: 'forest_session_token', tokenKey: 'rawToken' }));
+        const router = new router_1.default();
+        // hasRunAccess authorization — only on GET (read-only route).
+        // Trigger handles its own authz by comparing bearer user with step.user.
+        router.get('/runs/:runId', this.hasRunAccessMiddleware.bind(this), this.handleGetRun.bind(this));
+        router.post('/runs/:runId/trigger', this.handleTrigger.bind(this));
+        this.app.use(router.routes());
+        this.app.use(router.allowedMethods());
+    }
+    async start() {
+        return new Promise((resolve, reject) => {
+            this.server = http_1.default.createServer(this.app.callback());
+            this.server.once('error', reject);
+            this.server.listen(this.options.port, resolve);
+        });
+    }
+    async stop() {
+        return new Promise((resolve, reject) => {
+            if (!this.server) {
+                resolve();
+                return;
+            }
+            this.server.close(err => {
+                if (err) {
+                    reject(err);
+                }
+                else {
+                    this.server = null;
+                    resolve();
+                }
+            });
+        });
+    }
+    get callback() {
+        return this.app.callback();
+    }
+    async hasRunAccessMiddleware(ctx, next) {
+        const user = ctx.state.user;
+        try {
+            const allowed = await this.options.workflowPort.hasRunAccess(ctx.params.runId, user);
+            if (!allowed) {
+                ctx.status = 403;
+                ctx.body = { error: 'Forbidden' };
+                return;
+            }
+        }
+        catch (err) {
+            this.logger.error('Failed to check run access', {
+                runId: ctx.params.runId,
+                method: ctx.method,
+                path: ctx.path,
+                error: (0, errors_1.extractErrorMessage)(err),
+                stack: err instanceof Error ? err.stack : undefined,
+            });
+            ctx.status = 503;
+            ctx.body = { error: 'Service unavailable' };
+            return;
+        }
+        await next();
+    }
+    async handleGetRun(ctx) {
+        const steps = await this.options.runner.getRunStepExecutions(ctx.params.runId);
+        ctx.body = { steps: steps.map(step_serializer_1.default) };
+    }
+    async handleTrigger(ctx) {
+        const { runId } = ctx.params;
+        const rawId = ctx.state.user?.id;
+        const bearerUserId = typeof rawId === 'number' ? rawId : Number(rawId);
+        if (!Number.isFinite(bearerUserId)) {
+            ctx.status = 400;
+            ctx.body = { error: 'Missing or invalid user id in token' };
+            return;
+        }
+        const pendingData = ctx.request.body?.pendingData;
+        try {
+            await this.options.runner.triggerPoll(runId, {
+                pendingData,
+                bearerUserId,
+            });
+        }
+        catch (err) {
+            if (err instanceof errors_1.RunNotFoundError) {
+                ctx.status = 404;
+                ctx.body = { error: 'Run not found or unavailable' };
+                return;
+            }
+            if (err instanceof errors_1.RunAlreadyInFlightError) {
+                ctx.status = 400;
+                ctx.body = { error: err.message };
+                return;
+            }
+            if (err instanceof errors_1.UserMismatchError) {
+                this.logger.error('User mismatch on trigger', { runId, bearerUserId });
+                ctx.status = 403;
+                ctx.body = { error: 'Forbidden' };
+                return;
+            }
+            if (err instanceof errors_1.WorkflowExecutorError) {
+                this.logger.error('Malformed run on trigger', {
+                    runId,
+                    bearerUserId,
+                    error: (0, errors_1.extractErrorMessage)(err),
+                    stack: err.stack,
+                });
+                ctx.status = 400;
+                ctx.body = { error: err.userMessage };
+                return;
+            }
+            throw err;
+        }
+        ctx.status = 200;
+        ctx.body = { triggered: true };
+    }
+}
+exports.default = ExecutorHttpServer;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXhlY3V0b3ItaHR0cC1zZXJ2ZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaHR0cC9leGVjdXRvci1odHRwLXNlcnZlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7OztBQU1BLGlFQUF5QztBQUN6Qyx5REFBaUM7QUFDakMsZ0RBQXdCO0FBQ3hCLDhDQUFzQjtBQUN0QixzREFBNkI7QUFFN0Isd0VBQXFEO0FBQ3JELGdGQUF1RDtBQUN2RCxzQ0FNbUI7QUFVbkIsTUFBcUIsa0JBQWtCO0lBTXJDLFlBQVksT0FBa0M7UUFGdEMsV0FBTSxHQUFrQixJQUFJLENBQUM7UUFHbkMsSUFBSSxDQUFDLE9BQU8sR0FBRyxPQUFPLENBQUM7UUFDdkIsSUFBSSxDQUFDLE1BQU0sR0FBRyxPQUFPLENBQUMsTUFBTSxJQUFJLElBQUksd0JBQWEsRUFBRSxDQUFDO1FBQ3BELElBQUksQ0FBQyxHQUFHLEdBQUcsSUFBSSxhQUFHLEVBQUUsQ0FBQztRQUVyQix3RkFBd0Y7UUFDeEYsSUFBSSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsS0FBSyxFQUFFLEdBQUcsRUFBRSxJQUFJLEVBQUUsRUFBRTtZQUMvQixJQUFJLENBQUM7Z0JBQ0gsTUFBTSxJQUFJLEVBQUUsQ0FBQztZQUNmLENBQUM7WUFBQyxPQUFPLEdBQVksRUFBRSxDQUFDO2dCQUN0QixNQUFNLEVBQUUsTUFBTSxFQUFFLEdBQUcsR0FBMEIsQ0FBQztnQkFFOUMsSUFBSSxNQUFNLEtBQUssR0FBRyxFQUFFLENBQUM7b0JBQ25CLEdBQUcsQ0FBQyxNQUFNLEdBQUcsR0FBRyxDQUFDO29CQUNqQixHQUFHLENBQUMsSUFBSSxHQUFHLEVBQUUsS0FBSyxFQUFFLGNBQWMsRUFBRSxDQUFDO29CQUVyQyxPQUFPO2dCQUNULENBQUM7Z0JBRUQsSUFBSSxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsc0JBQXNCLEVBQUU7b0JBQ3hDLE1BQU0sRUFBRSxHQUFHLENBQUMsTUFBTTtvQkFD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

package/dist/http/pending-data-validators.d.ts

@@ -0,0 +1,25 @@
+import { z } from 'zod';
+declare const updateRecordPatchSchema: z.ZodObject<{
+    userConfirmed: z.ZodBoolean;
+    value: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strict>;
+declare const triggerActionPatchSchema: z.ZodObject<{
+    userConfirmed: z.ZodBoolean;
+    actionResult: z.ZodOptional<z.ZodUnknown>;
+}, z.core.$strict>;
+declare const mcpPatchSchema: z.ZodObject<{
+    userConfirmed: z.ZodBoolean;
+}, z.core.$strict>;
+declare const loadRelatedRecordPatchSchema: z.ZodObject<{
+    userConfirmed: z.ZodOptional<z.ZodBoolean>;
+    fieldName: z.ZodOptional<z.ZodString>;
+    selectedRecordId: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>, z.ZodArray<z.ZodString>>>;
+}, z.core.$strict>;
+export type UpdateRecordConfirmation = z.infer<typeof updateRecordPatchSchema>;
+export type TriggerActionConfirmation = z.infer<typeof triggerActionPatchSchema>;
+export type McpConfirmation = z.infer<typeof mcpPatchSchema>;
+export type LoadRelatedRecordConfirmation = z.infer<typeof loadRelatedRecordPatchSchema>;
+type PatchableStepType = 'update-record' | 'trigger-action' | 'mcp' | 'load-related-record' | 'guidance' | 'condition';
+declare const patchBodySchemas: Partial<Record<PatchableStepType, z.ZodTypeAny>>;
+export default patchBodySchemas;
+//# sourceMappingURL=pending-data-validators.d.ts.map

package/dist/http/pending-data-validators.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const zod_1 = require("zod");
+const record_id_serializer_1 = require("../adapters/record-id-serializer");
+// Per-step-type schemas for the userConfirmation payload sent by the front via
+// POST /runs/:runId/trigger. Validated into `execution.userConfirmation`; schemas
+// use .strict() to reject unknown fields.
+const updateRecordPatchSchema = zod_1.z
+    .object({
+    userConfirmed: zod_1.z.boolean(),
+    value: zod_1.z.unknown().optional(),
+})
+    .strict();
+const triggerActionPatchSchema = zod_1.z
+    .object({
+    userConfirmed: zod_1.z.boolean(),
+    // Opaque action result from the frontend. Required when userConfirmed=true; the
+    // presence check lives in the step-executor so a descriptive StepStateError can
+    // name the runId/stepIndex — not achievable from inside a zod schema.
+    actionResult: zod_1.z.unknown().optional(),
+})
+    .strict();
+const mcpPatchSchema = zod_1.z.object({ userConfirmed: zod_1.z.boolean() }).strict();
+// Accepts two shapes:
+//   1. Confirmation patch: `userConfirmed: boolean` (+ optional overrides) — finalizes
+//      the step or skips it.
+//   2. Field-preview patch: `fieldName: string` alone, with `userConfirmed` omitted —
+//      asks the executor to re-list candidates for a different relation WITHOUT
+//      finalizing. The executor refreshes pendingData and stays awaiting-input.
+//      Required when the frontend lets the user switch relations: the IDs originally
+//      stored under `availableRecordIds` belong to the AI-suggested relation only.
+const loadRelatedRecordPatchSchema = zod_1.z
+    .object({
+    userConfirmed: zod_1.z.boolean().optional(),
+    // User may intentionally switch to a different relation than the one the AI selected.
+    // Sent as the technical fieldName (matches CollectionSchemaField.fieldName from the
+    // orchestrator); the executor re-derives displayName + relatedCollectionName from
+    // the live schema when processing the confirmation.
+    fieldName: zod_1.z.string().min(1).optional(),
+    // User may override the AI-selected record; pipe-separated string (e.g. 'id1|id2'),
+    // deserialized to an id array. Required when confirming with a relation override —
+    // the original record ID belongs to a different collection and cannot be reused.
+    // The .pipe(...) rejects empty segments that would build a bogus PK.
+    selectedRecordId: zod_1.z
+        .string()
+        .min(1)
+        .transform(record_id_serializer_1.deserializeRecordId)
+        .pipe(zod_1.z.array(zod_1.z.string().min(1)))
+        .optional(),
+})
+    .strict()
+    .refine(data => {
+    // Preview patch (no confirm): fieldName alone is sufficient.
+    if (data.userConfirmed === undefined)
+        return data.fieldName !== undefined;
+    // Confirm patch with relation override: selectedRecordId required.
+    if (data.fieldName !== undefined)
+        return data.selectedRecordId !== undefined;
+    return true;
+}, {
+    message: 'selectedRecordId is required when confirming with a relation override, ' +
+        'or omit userConfirmed to preview candidates for a different relation',
+});
+const guidancePatchSchema = zod_1.z
+    .object({
+    userInput: zod_1.z.string().optional(),
+})
+    .strict();
+const conditionPatchSchema = zod_1.z.object({ selectedOption: zod_1.z.string() }).strict();
+const patchBodySchemas = {
+    'update-record': updateRecordPatchSchema,
+    'trigger-action': triggerActionPatchSchema,
+    mcp: mcpPatchSchema,
+    'load-related-record': loadRelatedRecordPatchSchema,
+    guidance: guidancePatchSchema,
+    condition: conditionPatchSchema,
+};
+exports.default = patchBodySchemas;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGVuZGluZy1kYXRhLXZhbGlkYXRvcnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaHR0cC9wZW5kaW5nLWRhdGEtdmFsaWRhdG9ycy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLDZCQUF3QjtBQUV4QiwyRUFBdUU7QUFFdkUsK0VBQStFO0FBQy9FLGtGQUFrRjtBQUNsRiwwQ0FBMEM7QUFFMUMsTUFBTSx1QkFBdUIsR0FBRyxPQUFDO0tBQzlCLE1BQU0sQ0FBQztJQUNOLGFBQWEsRUFBRSxPQUFDLENBQUMsT0FBTyxFQUFFO0lBQzFCLEtBQUssRUFBRSxPQUFDLENBQUMsT0FBTyxFQUFFLENBQUMsUUFBUSxFQUFFO0NBQzlCLENBQUM7S0FDRCxNQUFNLEVBQUUsQ0FBQztBQUVaLE1BQU0sd0JBQXdCLEdBQUcsT0FBQztLQUMvQixNQUFNLENBQUM7SUFDTixhQUFhLEVBQUUsT0FBQyxDQUFDLE9BQU8sRUFBRTtJQUMxQixnRkFBZ0Y7SUFDaEYsZ0ZBQWdGO0lBQ2hGLHNFQUFzRTtJQUN0RSxZQUFZLEVBQUUsT0FBQyxDQUFDLE9BQU8sRUFBRSxDQUFDLFFBQVEsRUFBRTtDQUNyQyxDQUFDO0tBQ0QsTUFBTSxFQUFFLENBQUM7QUFFWixNQUFNLGNBQWMsR0FBRyxPQUFDLENBQUMsTUFBTSxDQUFDLEVBQUUsYUFBYSxFQUFFLE9BQUMsQ0FBQyxPQUFPLEVBQUUsRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUM7QUFFekUsc0JBQXNCO0FBQ3RCLHVGQUF1RjtBQUN2Riw2QkFBNkI7QUFDN0Isc0ZBQXNGO0FBQ3RGLGdGQUFnRjtBQUNoRixnRkFBZ0Y7QUFDaEYscUZBQXFGO0FBQ3JGLG1GQUFtRjtBQUNuRixNQUFNLDRCQUE0QixHQUFHLE9BQUM7S0FDbkMsTUFBTSxDQUFDO0lBQ04sYUFBYSxFQUFFLE9BQUMsQ0FBQyxPQUFPLEVBQUUsQ0FBQyxRQUFRLEVBQUU7SUFDckMsc0ZBQXNGO0lBQ3RGLG9GQUFvRjtJQUNwRixrRkFBa0Y7SUFDbEYsb0RBQW9EO0lBQ3BELFNBQVMsRUFBRSxPQUFDLENBQUMsTUFBTSxFQUFFLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLFFBQVEsRUFBRTtJQUN2QyxvRkFBb0Y7SUFDcEYsbUZBQW1GO0lBQ25GLGlGQUFpRjtJQUNqRixxRUFBcUU7SUFDckUsZ0JBQWdCLEVBQUUsT0FBQztTQUNoQixNQUFNLEVBQUU7U0FDUixHQUFHLENBQUMsQ0FBQyxDQUFDO1NBQ04sU0FBUyxDQUFDLDBDQUFtQixDQUFDO1NBQzlCLElBQUksQ0FBQyxPQUFDLENBQUMsS0FBSyxDQUFDLE9BQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztTQUNoQyxRQUFRLEVBQUU7Q0FDZCxDQUFDO0tBQ0QsTUFBTSxFQUFFO0tBQ1IsTUFBTSxDQUNMLElBQUksQ0FBQyxFQUFFO0lBQ0wsNkRBQTZEO0lBQzdELElBQUksSUFBSSxDQUFDLGFBQWEsS0FBSyxTQUFTO1FBQUUsT0FBTyxJQUFJLENBQUMsU0FBUyxLQUFLLFNBQVMsQ0FBQztJQUMxRSxtRUFBbUU7SUFDbkUsSUFBSSxJQUFJLENBQUMsU0FBUyxLQUFLLFNBQVM7UUFBRSxPQUFPLElBQUksQ0FBQyxnQkFBZ0IsS0FBSyxTQUFTLENBQUM7SUFFN0UsT0FBTyxJQUFJLENBQUM7QUFDZCxDQUFDLEVBQ0Q7SUFDRSxPQUFPLEVBQ0wseUVBQXlFO1FBQ3pFLHNFQUFzRTtDQUN6RSxDQUNGLENBQUM7QUFDSixNQUFNLG1CQUFtQixHQUFHLE9BQUM7S0FDMUIsTUFBTSxDQUFDO0lBQ04sU0FBUyxFQUFFLE9BQUMsQ0FBQyxNQUFNLEVBQUUsQ0FBQyxRQUFRLEVBQUU7Q0FDakMsQ0FBQztLQUNELE1BQU0sRUFBRSxDQUFDO0FBRVosTUFBTSxvQkFBb0IsR0FBRyxPQUFDLENBQUMsTUFBTSxDQUFDLEVBQUUsY0FBYyxFQUFFLE9BQUMsQ0FBQyxNQUFNLEVBQUUsRUFBRSxDQUFDLENBQUMsTUFBTSxFQUFFLENBQUM7QUFpQi9FLE1BQU0sZ0JBQWdCLEdBQXFEO0lBQ3pFLGVBQWUsRUFBRSx1QkFBdUI7SUFDeEMsZ0JBQWdCLEVBQUUsd0JBQXdCO0lBQzFDLEdBQUcsRUFBRSxjQUFjO0lBQ25CLHFCQUFxQixFQUFFLDRCQUE0QjtJQUNuRCxRQUFRLEVBQUUsbUJBQW1CO0lBQzdCLFNBQVMsRUFBRSxvQkFBb0I7Q0FDaEMsQ0FBQztBQUVGLGtCQUFlLGdCQUFnQixDQUFDIn0=

package/dist/http/step-serializer.d.ts

@@ -0,0 +1,3 @@
+import type { StepExecutionData } from '../types/step-execution-data';
+export default function serializeStepForWire(step: StepExecutionData): unknown;
+//# sourceMappingURL=step-serializer.d.ts.map

package/dist/http/step-serializer.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = serializeStepForWire;
+const record_id_serializer_1 = require("../adapters/record-id-serializer");
+function serializeRecordRef(ref) {
+    return { ...ref, recordId: (0, record_id_serializer_1.serializeRecordId)(ref.recordId) };
+}
+function serializeStepForWire(step) {
+    switch (step.type) {
+        case 'read-record':
+        case 'update-record':
+        case 'trigger-action':
+            return { ...step, selectedRecordRef: serializeRecordRef(step.selectedRecordRef) };
+        case 'load-related-record': {
+            const result = {
+                ...step,
+                selectedRecordRef: serializeRecordRef(step.selectedRecordRef),
+            };
+            if (step.pendingData) {
+                const { availableRecordIds, suggestedRecord } = step.pendingData;
+                result.pendingData = {
+                    ...step.pendingData,
+                    availableRecordIds: availableRecordIds.map(c => ({
+                        ...c,
+                        recordId: (0, record_id_serializer_1.serializeRecordId)(c.recordId),
+                    })),
+                    ...(suggestedRecord && {
+                        suggestedRecord: {
+                            ...suggestedRecord,
+                            recordId: (0, record_id_serializer_1.serializeRecordId)(suggestedRecord.recordId),
+                        },
+                    }),
+                };
+            }
+            if (step.executionResult && 'record' in step.executionResult) {
+                result.executionResult = {
+                    ...step.executionResult,
+                    record: serializeRecordRef(step.executionResult.record),
+                };
+            }
+            return result;
+        }
+        default:
+            return step;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RlcC1zZXJpYWxpemVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2h0dHAvc3RlcC1zZXJpYWxpemVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBU0EsdUNBNENDO0FBbERELDJFQUFxRTtBQUVyRSxTQUFTLGtCQUFrQixDQUFDLEdBQWM7SUFDeEMsT0FBTyxFQUFFLEdBQUcsR0FBRyxFQUFFLFFBQVEsRUFBRSxJQUFBLHdDQUFpQixFQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsRUFBRSxDQUFDO0FBQy9ELENBQUM7QUFFRCxTQUF3QixvQkFBb0IsQ0FBQyxJQUF1QjtJQUNsRSxRQUFRLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztRQUNsQixLQUFLLGFBQWEsQ0FBQztRQUNuQixLQUFLLGVBQWUsQ0FBQztRQUNyQixLQUFLLGdCQUFnQjtZQUNuQixPQUFPLEVBQUUsR0FBRyxJQUFJLEVBQUUsaUJBQWlCLEVBQUUsa0JBQWtCLENBQUMsSUFBSSxDQUFDLGlCQUFpQixDQUFDLEVBQUUsQ0FBQztRQUVwRixLQUFLLHFCQUFxQixDQUFDLENBQUMsQ0FBQztZQUMzQixNQUFNLE1BQU0sR0FBNEI7Z0JBQ3RDLEdBQUcsSUFBSTtnQkFDUCxpQkFBaUIsRUFBRSxrQkFBa0IsQ0FBQyxJQUFJLENBQUMsaUJBQWlCLENBQUM7YUFDOUQsQ0FBQztZQUVGLElBQUksSUFBSSxDQUFDLFdBQVcsRUFBRSxDQUFDO2dCQUNyQixNQUFNLEVBQUUsa0JBQWtCLEVBQUUsZUFBZSxFQUFFLEdBQUcsSUFBSSxDQUFDLFdBQVcsQ0FBQztnQkFFakUsTUFBTSxDQUFDLFdBQVcsR0FBRztvQkFDbkIsR0FBRyxJQUFJLENBQUMsV0FBVztvQkFDbkIsa0JBQWtCLEVBQUUsa0JBQWtCLENBQUMsR0FBRyxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQzt3QkFDL0MsR0FBRyxDQUFDO3dCQUNKLFFBQVEsRUFBRSxJQUFBLHdDQUFpQixFQUFDLENBQUMsQ0FBQyxRQUFRLENBQUM7cUJBQ3hDLENBQUMsQ0FBQztvQkFDSCxHQUFHLENBQUMsZUFBZSxJQUFJO3dCQUNyQixlQUFlLEVBQUU7NEJBQ2YsR0FBRyxlQUFlOzRCQUNsQixRQUFRLEVBQUUsSUFBQSx3Q0FBaUIsRUFBQyxlQUFlLENBQUMsUUFBUSxDQUFDO3lCQUN0RDtxQkFDRixDQUFDO2lCQUNILENBQUM7WUFDSixDQUFDO1lBRUQsSUFBSSxJQUFJLENBQUMsZUFBZSxJQUFJLFFBQVEsSUFBSSxJQUFJLENBQUMsZUFBZSxFQUFFLENBQUM7Z0JBQzdELE1BQU0sQ0FBQyxlQUFlLEdBQUc7b0JBQ3ZCLEdBQUcsSUFBSSxDQUFDLGVBQWU7b0JBQ3ZCLE1BQU0sRUFBRSxrQkFBa0IsQ0FBQyxJQUFJLENBQUMsZUFBZSxDQUFDLE1BQU0sQ0FBQztpQkFDeEQsQ0FBQztZQUNKLENBQUM7WUFFRCxPQUFPLE1BQU0sQ0FBQztRQUNoQixDQUFDO1FBRUQ7WUFDRSxPQUFPLElBQUksQ0FBQztJQUNoQixDQUFDO0FBQ0gsQ0FBQyJ9

package/dist/in-flight-run-registry.d.ts

@@ -0,0 +1,9 @@
+export default class InFlightRunRegistry {
+    private readonly runs;
+    get size(): number;
+    keys(): string[];
+    has(runId: string): boolean;
+    track(runId: string, promise: Promise<void>): Promise<void>;
+    drain(): Promise<void>;
+}
+//# sourceMappingURL=in-flight-run-registry.d.ts.map

package/dist/in-flight-run-registry.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Tracks promises for runs currently executing (including their full auto-chain).
+// Keyed by runId — a run has one available step at a time, and a chain advances the stepId
+// between iterations. Keying by runId keeps the dedup guarantee across the whole chain.
+class InFlightRunRegistry {
+    constructor() {
+        this.runs = new Map();
+    }
+    get size() {
+        return this.runs.size;
+    }
+    keys() {
+        return [...this.runs.keys()];
+    }
+    has(runId) {
+        return this.runs.has(runId);
+    }
+    // Registers the promise and automatically removes the entry when it settles.
+    track(runId, promise) {
+        const tracked = promise.finally(() => this.runs.delete(runId));
+        this.runs.set(runId, tracked);
+        return tracked;
+    }
+    drain() {
+        return Promise.allSettled(this.runs.values()).then(() => { });
+    }
+}
+exports.default = InFlightRunRegistry;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW4tZmxpZ2h0LXJ1bi1yZWdpc3RyeS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy9pbi1mbGlnaHQtcnVuLXJlZ2lzdHJ5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBQUEsa0ZBQWtGO0FBQ2xGLDJGQUEyRjtBQUMzRix3RkFBd0Y7QUFDeEYsTUFBcUIsbUJBQW1CO0lBQXhDO1FBQ21CLFNBQUksR0FBRyxJQUFJLEdBQUcsRUFBeUIsQ0FBQztJQXlCM0QsQ0FBQztJQXZCQyxJQUFJLElBQUk7UUFDTixPQUFPLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDO0lBQ3hCLENBQUM7SUFFRCxJQUFJO1FBQ0YsT0FBTyxDQUFDLEdBQUcsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQyxDQUFDO0lBQy9CLENBQUM7SUFFRCxHQUFHLENBQUMsS0FBYTtRQUNmLE9BQU8sSUFBSSxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsS0FBSyxDQUFDLENBQUM7SUFDOUIsQ0FBQztJQUVELDZFQUE2RTtJQUM3RSxLQUFLLENBQUMsS0FBYSxFQUFFLE9BQXNCO1FBQ3pDLE1BQU0sT0FBTyxHQUFHLE9BQU8sQ0FBQyxPQUFPLENBQUMsR0FBRyxFQUFFLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQztRQUMvRCxJQUFJLENBQUMsSUFBSSxDQUFDLEdBQUcsQ0FBQyxLQUFLLEVBQUUsT0FBTyxDQUFDLENBQUM7UUFFOUIsT0FBTyxPQUFPLENBQUM7SUFDakIsQ0FBQztJQUVELEtBQUs7UUFDSCxPQUFPLE9BQU8sQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDLElBQUksQ0FBQyxHQUFHLEVBQUUsR0FBRSxDQUFDLENBQUMsQ0FBQztJQUMvRCxDQUFDO0NBQ0Y7QUExQkQsc0NBMEJDIn0=

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+export { StepType } from './types/validated/step-definition';
+export type { ConditionStepDefinition, ReadRecordStepDefinition, UpdateRecordStepDefinition, TriggerActionStepDefinition, LoadRelatedRecordStepDefinition, RecordStepDefinition, McpStepDefinition, GuidanceStepDefinition, StepDefinition, } from './types/validated/step-definition';
+export type { StepStatus, ConditionStepOutcome, RecordStepOutcome, McpStepOutcome, GuidanceStepOutcome, StepOutcome, } from './types/validated/step-outcome';
+export type { FieldReadSuccess, FieldReadError, FieldReadResult, ActionRef, RelationRef, FieldRef, ConditionStepExecutionData, ReadRecordStepExecutionData, UpdateRecordStepExecutionData, TriggerRecordActionStepExecutionData, RecordStepExecutionData, LoadRelatedRecordPendingData, LoadRelatedRecordStepExecutionData, McpToolRef, McpToolCall, McpStepExecutionData, GuidanceStepExecutionData, ExecutedStepExecutionData, StepExecutionData, } from './types/step-execution-data';
+export type { FieldSchema, ActionSchema, CollectionSchema, RecordRef, RecordData, } from './types/validated/collection';
+export type { StepUser, Step, AvailableStepExecution, StepExecutionResult, ExecutionContext, } from './types/execution-context';
+export type { AgentPort, ExecuteActionQuery, GetActionFormInfoQuery, GetRecordQuery, GetRelatedDataQuery, Id, Limit, UpdateRecordQuery, } from './ports/agent-port';
+export type { WorkflowPort } from './ports/workflow-port';
+export type { RunStore } from './ports/run-store';
+export type { Logger } from './ports/logger-port';
+export { default as ConsoleLogger } from './adapters/console-logger';
+export { WorkflowExecutorError, MissingToolCallError, MalformedToolCallError, RecordNotFoundError, NoRecordsError, NoReadableFieldsError, NoResolvedFieldsError, NoWritableFieldsError, NoActionsError, NoRelationshipFieldsError, RelatedRecordNotFoundError, InvalidAIResponseError, InvalidAiRequestError, RelationNotFoundError, FieldNotFoundError, ActionNotFoundError, StepStateError, NoMcpToolsError, McpToolNotFoundError, McpToolInvocationError, AgentPortError, WorkflowPortError, RunStorePortError, AiModelPortError, AgentProbeError, ConfigurationError, InvalidPreRecordedArgsError, UnsupportedStepTypeError, UnsupportedActionFormError, InvalidStepDefinitionError, DomainValidationError, } from './errors';
+export { default as BaseStepExecutor } from './executors/base-step-executor';
+export { default as ConditionStepExecutor } from './executors/condition-step-executor';
+export { default as ReadRecordStepExecutor } from './executors/read-record-step-executor';
+export { default as UpdateRecordStepExecutor } from './executors/update-record-step-executor';
+export { default as TriggerRecordActionStepExecutor } from './executors/trigger-record-action-step-executor';
+export { default as LoadRelatedRecordStepExecutor } from './executors/load-related-record-step-executor';
+export { default as McpStepExecutor } from './executors/mcp-step-executor';
+export { default as GuidanceStepExecutor } from './executors/guidance-step-executor';
+export { default as AgentClientAgentPort } from './adapters/agent-client-agent-port';
+export { default as ForestServerWorkflowPort } from './adapters/forest-server-workflow-port';
+export { default as ExecutorHttpServer } from './http/executor-http-server';
+export type { ExecutorHttpServerOptions } from './http/executor-http-server';
+export { default as Runner } from './runner';
+export type { RunnerConfig, RunnerState } from './runner';
+export { default as validateSecrets } from './validate-secrets';
+export { default as SchemaCache } from './schema-cache';
+export { default as SchemaResolver } from './schema-resolver';
+export { default as InMemoryStore } from './stores/in-memory-store';
+export { default as DatabaseStore } from './stores/database-store';
+export type { DatabaseStoreOptions } from './stores/database-store';
+export { buildDatabaseRunStore, buildInMemoryRunStore } from './stores/build-run-store';
+export { buildInMemoryExecutor, buildDatabaseExecutor } from './build-workflow-executor';
+export { runCli } from './cli-core';
+export { default as PrettyLogger } from './adapters/pretty-logger';
+export type { WorkflowExecutor, ExecutorOptions, DatabaseExecutorOptions, } from './build-workflow-executor';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,88 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseStore = exports.InMemoryStore = exports.SchemaResolver = exports.SchemaCache = exports.validateSecrets = exports.Runner = exports.ExecutorHttpServer = exports.ForestServerWorkflowPort = exports.AgentClientAgentPort = exports.GuidanceStepExecutor = exports.McpStepExecutor = exports.LoadRelatedRecordStepExecutor = exports.TriggerRecordActionStepExecutor = exports.UpdateRecordStepExecutor = exports.ReadRecordStepExecutor = exports.ConditionStepExecutor = exports.BaseStepExecutor = exports.DomainValidationError = exports.InvalidStepDefinitionError = exports.UnsupportedActionFormError = exports.UnsupportedStepTypeError = exports.InvalidPreRecordedArgsError = exports.ConfigurationError = exports.AgentProbeError = exports.AiModelPortError = exports.RunStorePortError = exports.WorkflowPortError = exports.AgentPortError = exports.McpToolInvocationError = exports.McpToolNotFoundError = exports.NoMcpToolsError = exports.StepStateError = exports.ActionNotFoundError = exports.FieldNotFoundError = exports.RelationNotFoundError = exports.InvalidAiRequestError = exports.InvalidAIResponseError = exports.RelatedRecordNotFoundError = exports.NoRelationshipFieldsError = exports.NoActionsError = exports.NoWritableFieldsError = exports.NoResolvedFieldsError = exports.NoReadableFieldsError = exports.NoRecordsError = exports.RecordNotFoundError = exports.MalformedToolCallError = exports.MissingToolCallError = exports.WorkflowExecutorError = exports.ConsoleLogger = exports.StepType = void 0;
+exports.PrettyLogger = exports.runCli = exports.buildDatabaseExecutor = exports.buildInMemoryExecutor = exports.buildInMemoryRunStore = exports.buildDatabaseRunStore = void 0;
+var step_definition_1 = require("./types/validated/step-definition");
+Object.defineProperty(exports, "StepType", { enumerable: true, get: function () { return step_definition_1.StepType; } });
+var console_logger_1 = require("./adapters/console-logger");
+Object.defineProperty(exports, "ConsoleLogger", { enumerable: true, get: function () { return __importDefault(console_logger_1).default; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "WorkflowExecutorError", { enumerable: true, get: function () { return errors_1.WorkflowExecutorError; } });
+Object.defineProperty(exports, "MissingToolCallError", { enumerable: true, get: function () { return errors_1.MissingToolCallError; } });
+Object.defineProperty(exports, "MalformedToolCallError", { enumerable: true, get: function () { return errors_1.MalformedToolCallError; } });
+Object.defineProperty(exports, "RecordNotFoundError", { enumerable: true, get: function () { return errors_1.RecordNotFoundError; } });
+Object.defineProperty(exports, "NoRecordsError", { enumerable: true, get: function () { return errors_1.NoRecordsError; } });
+Object.defineProperty(exports, "NoReadableFieldsError", { enumerable: true, get: function () { return errors_1.NoReadableFieldsError; } });
+Object.defineProperty(exports, "NoResolvedFieldsError", { enumerable: true, get: function () { return errors_1.NoResolvedFieldsError; } });
+Object.defineProperty(exports, "NoWritableFieldsError", { enumerable: true, get: function () { return errors_1.NoWritableFieldsError; } });
+Object.defineProperty(exports, "NoActionsError", { enumerable: true, get: function () { return errors_1.NoActionsError; } });
+Object.defineProperty(exports, "NoRelationshipFieldsError", { enumerable: true, get: function () { return errors_1.NoRelationshipFieldsError; } });
+Object.defineProperty(exports, "RelatedRecordNotFoundError", { enumerable: true, get: function () { return errors_1.RelatedRecordNotFoundError; } });
+Object.defineProperty(exports, "InvalidAIResponseError", { enumerable: true, get: function () { return errors_1.InvalidAIResponseError; } });
+Object.defineProperty(exports, "InvalidAiRequestError", { enumerable: true, get: function () { return errors_1.InvalidAiRequestError; } });
+Object.defineProperty(exports, "RelationNotFoundError", { enumerable: true, get: function () { return errors_1.RelationNotFoundError; } });
+Object.defineProperty(exports, "FieldNotFoundError", { enumerable: true, get: function () { return errors_1.FieldNotFoundError; } });
+Object.defineProperty(exports, "ActionNotFoundError", { enumerable: true, get: function () { return errors_1.ActionNotFoundError; } });
+Object.defineProperty(exports, "StepStateError", { enumerable: true, get: function () { return errors_1.StepStateError; } });
+Object.defineProperty(exports, "NoMcpToolsError", { enumerable: true, get: function () { return errors_1.NoMcpToolsError; } });
+Object.defineProperty(exports, "McpToolNotFoundError", { enumerable: true, get: function () { return errors_1.McpToolNotFoundError; } });
+Object.defineProperty(exports, "McpToolInvocationError", { enumerable: true, get: function () { return errors_1.McpToolInvocationError; } });
+Object.defineProperty(exports, "AgentPortError", { enumerable: true, get: function () { return errors_1.AgentPortError; } });
+Object.defineProperty(exports, "WorkflowPortError", { enumerable: true, get: function () { return errors_1.WorkflowPortError; } });
+Object.defineProperty(exports, "RunStorePortError", { enumerable: true, get: function () { return errors_1.RunStorePortError; } });
+Object.defineProperty(exports, "AiModelPortError", { enumerable: true, get: function () { return errors_1.AiModelPortError; } });
+Object.defineProperty(exports, "AgentProbeError", { enumerable: true, get: function () { return errors_1.AgentProbeError; } });
+Object.defineProperty(exports, "ConfigurationError", { enumerable: true, get: function () { return errors_1.ConfigurationError; } });
+Object.defineProperty(exports, "InvalidPreRecordedArgsError", { enumerable: true, get: function () { return errors_1.InvalidPreRecordedArgsError; } });
+Object.defineProperty(exports, "UnsupportedStepTypeError", { enumerable: true, get: function () { return errors_1.UnsupportedStepTypeError; } });
+Object.defineProperty(exports, "UnsupportedActionFormError", { enumerable: true, get: function () { return errors_1.UnsupportedActionFormError; } });
+Object.defineProperty(exports, "InvalidStepDefinitionError", { enumerable: true, get: function () { return errors_1.InvalidStepDefinitionError; } });
+Object.defineProperty(exports, "DomainValidationError", { enumerable: true, get: function () { return errors_1.DomainValidationError; } });
+var base_step_executor_1 = require("./executors/base-step-executor");
+Object.defineProperty(exports, "BaseStepExecutor", { enumerable: true, get: function () { return __importDefault(base_step_executor_1).default; } });
+var condition_step_executor_1 = require("./executors/condition-step-executor");
+Object.defineProperty(exports, "ConditionStepExecutor", { enumerable: true, get: function () { return __importDefault(condition_step_executor_1).default; } });
+var read_record_step_executor_1 = require("./executors/read-record-step-executor");
+Object.defineProperty(exports, "ReadRecordStepExecutor", { enumerable: true, get: function () { return __importDefault(read_record_step_executor_1).default; } });
+var update_record_step_executor_1 = require("./executors/update-record-step-executor");
+Object.defineProperty(exports, "UpdateRecordStepExecutor", { enumerable: true, get: function () { return __importDefault(update_record_step_executor_1).default; } });
+var trigger_record_action_step_executor_1 = require("./executors/trigger-record-action-step-executor");
+Object.defineProperty(exports, "TriggerRecordActionStepExecutor", { enumerable: true, get: function () { return __importDefault(trigger_record_action_step_executor_1).default; } });
+var load_related_record_step_executor_1 = require("./executors/load-related-record-step-executor");
+Object.defineProperty(exports, "LoadRelatedRecordStepExecutor", { enumerable: true, get: function () { return __importDefault(load_related_record_step_executor_1).default; } });
+var mcp_step_executor_1 = require("./executors/mcp-step-executor");
+Object.defineProperty(exports, "McpStepExecutor", { enumerable: true, get: function () { return __importDefault(mcp_step_executor_1).default; } });
+var guidance_step_executor_1 = require("./executors/guidance-step-executor");
+Object.defineProperty(exports, "GuidanceStepExecutor", { enumerable: true, get: function () { return __importDefault(guidance_step_executor_1).default; } });
+var agent_client_agent_port_1 = require("./adapters/agent-client-agent-port");
+Object.defineProperty(exports, "AgentClientAgentPort", { enumerable: true, get: function () { return __importDefault(agent_client_agent_port_1).default; } });
+var forest_server_workflow_port_1 = require("./adapters/forest-server-workflow-port");
+Object.defineProperty(exports, "ForestServerWorkflowPort", { enumerable: true, get: function () { return __importDefault(forest_server_workflow_port_1).default; } });
+var executor_http_server_1 = require("./http/executor-http-server");
+Object.defineProperty(exports, "ExecutorHttpServer", { enumerable: true, get: function () { return __importDefault(executor_http_server_1).default; } });
+var runner_1 = require("./runner");
+Object.defineProperty(exports, "Runner", { enumerable: true, get: function () { return __importDefault(runner_1).default; } });
+var validate_secrets_1 = require("./validate-secrets");
+Object.defineProperty(exports, "validateSecrets", { enumerable: true, get: function () { return __importDefault(validate_secrets_1).default; } });
+var schema_cache_1 = require("./schema-cache");
+Object.defineProperty(exports, "SchemaCache", { enumerable: true, get: function () { return __importDefault(schema_cache_1).default; } });
+var schema_resolver_1 = require("./schema-resolver");
+Object.defineProperty(exports, "SchemaResolver", { enumerable: true, get: function () { return __importDefault(schema_resolver_1).default; } });
+var in_memory_store_1 = require("./stores/in-memory-store");
+Object.defineProperty(exports, "InMemoryStore", { enumerable: true, get: function () { return __importDefault(in_memory_store_1).default; } });
+var database_store_1 = require("./stores/database-store");
+Object.defineProperty(exports, "DatabaseStore", { enumerable: true, get: function () { return __importDefault(database_store_1).default; } });
+var build_run_store_1 = require("./stores/build-run-store");
+Object.defineProperty(exports, "buildDatabaseRunStore", { enumerable: true, get: function () { return build_run_store_1.buildDatabaseRunStore; } });
+Object.defineProperty(exports, "buildInMemoryRunStore", { enumerable: true, get: function () { return build_run_store_1.buildInMemoryRunStore; } });
+var build_workflow_executor_1 = require("./build-workflow-executor");
+Object.defineProperty(exports, "buildInMemoryExecutor", { enumerable: true, get: function () { return build_workflow_executor_1.buildInMemoryExecutor; } });
+Object.defineProperty(exports, "buildDatabaseExecutor", { enumerable: true, get: function () { return build_workflow_executor_1.buildDatabaseExecutor; } });
+var cli_core_1 = require("./cli-core");
+Object.defineProperty(exports, "runCli", { enumerable: true, get: function () { return cli_core_1.runCli; } });
+var pretty_logger_1 = require("./adapters/pretty-logger");
+Object.defineProperty(exports, "PrettyLogger", { enumerable: true, get: function () { return __importDefault(pretty_logger_1).default; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7OztBQUFBLHFFQUE2RDtBQUFwRCwyR0FBQSxRQUFRLE9BQUE7QUF5RWpCLDREQUFxRTtBQUE1RCxnSUFBQSxPQUFPLE9BQWlCO0FBRWpDLG1DQWdDa0I7QUEvQmhCLCtHQUFBLHFCQUFxQixPQUFBO0FBQ3JCLDhHQUFBLG9CQUFvQixPQUFBO0FBQ3BCLGdIQUFBLHNCQUFzQixPQUFBO0FBQ3RCLDZHQUFBLG1CQUFtQixPQUFBO0FBQ25CLHdHQUFBLGNBQWMsT0FBQTtBQUNkLCtHQUFBLHFCQUFxQixPQUFBO0FBQ3JCLCtHQUFBLHFCQUFxQixPQUFBO0FBQ3JCLCtHQUFBLHFCQUFxQixPQUFBO0FBQ3JCLHdHQUFBLGNBQWMsT0FBQTtBQUNkLG1IQUFBLHlCQUF5QixPQUFBO0FBQ3pCLG9IQUFBLDBCQUEwQixPQUFBO0FBQzFCLGdIQUFBLHNCQUFzQixPQUFBO0FBQ3RCLCtHQUFBLHFCQUFxQixPQUFBO0FBQ3JCLCtHQUFBLHFCQUFxQixPQUFBO0FBQ3JCLDRHQUFBLGtCQUFrQixPQUFBO0FBQ2xCLDZHQUFBLG1CQUFtQixPQUFBO0FBQ25CLHdHQUFBLGNBQWMsT0FBQTtBQUNkLHlHQUFBLGVBQWUsT0FBQTtBQUNmLDhHQUFBLG9CQUFvQixPQUFBO0FBQ3BCLGdIQUFBLHNCQUFzQixPQUFBO0FBQ3RCLHdHQUFBLGNBQWMsT0FBQTtBQUNkLDJHQUFBLGlCQUFpQixPQUFBO0FBQ2pCLDJHQUFBLGlCQUFpQixPQUFBO0FBQ2pCLDBHQUFBLGdCQUFnQixPQUFBO0FBQ2hCLHlHQUFBLGVBQWUsT0FBQTtBQUNmLDRHQUFBLGtCQUFrQixPQUFBO0FBQ2xCLHFIQUFBLDJCQUEyQixPQUFBO0FBQzNCLGtIQUFBLHdCQUF3QixPQUFBO0FBQ3hCLG9IQUFBLDBCQUEwQixPQUFBO0FBQzFCLG9IQUFBLDBCQUEwQixPQUFBO0FBQzFCLCtHQUFBLHFCQUFxQixPQUFBO0FBRXZCLHFFQUE2RTtBQUFwRSx1SUFBQSxPQUFPLE9BQW9CO0FBQ3BDLCtFQUF1RjtBQUE5RSxpSkFBQSxPQUFPLE9BQXlCO0FBQ3pDLG1GQUEwRjtBQUFqRixvSkFBQSxPQUFPLE9BQTBCO0FBQzFDLHVGQUE4RjtBQUFyRix3SkFBQSxPQUFPLE9BQTRCO0FBQzVDLHVHQUE2RztBQUFwRyx1S0FBQSxPQUFPLE9BQW1DO0FBQ25ELG1HQUF5RztBQUFoRyxtS0FBQSxPQUFPLE9BQWlDO0FBQ2pELG1FQUEyRTtBQUFsRSxxSUFBQSxPQUFPLE9BQW1CO0FBQ25DLDZFQUFxRjtBQUE1RSwrSUFBQSxPQUFPLE9BQXdCO0FBQ3hDLDhFQUFxRjtBQUE1RSxnSkFBQSxPQUFPLE9BQXdCO0FBQ3hDLHNGQUE2RjtBQUFwRix3SkFBQSxPQUFPLE9BQTRCO0FBQzVDLG9FQUE0RTtBQUFuRSwySUFBQSxPQUFPLE9BQXNCO0FBRXRDLG1DQUE2QztBQUFwQyxpSEFBQSxPQUFPLE9BQVU7QUFFMUIsdURBQWdFO0FBQXZELG9JQUFBLE9BQU8sT0FBbUI7QUFDbkMsK0NBQXdEO0FBQS9DLDRIQUFBLE9BQU8sT0FBZTtBQUMvQixxREFBOEQ7QUFBckQsa0lBQUEsT0FBTyxPQUFrQjtBQUNsQyw0REFBb0U7QUFBM0QsaUlBQUEsT0FBTyxPQUFpQjtBQUNqQywwREFBbUU7QUFBMUQsZ0lBQUEsT0FBTyxPQUFpQjtBQUVqQyw0REFBd0Y7QUFBL0Usd0hBQUEscUJBQXFCLE9BQUE7QUFBRSx3SEFBQSxxQkFBcUIsT0FBQTtBQUNyRCxxRUFBeUY7QUFBaEYsZ0lBQUEscUJBQXFCLE9BQUE7QUFBRSxnSUFBQSxxQkFBcUIsT0FBQTtBQUNyRCx1Q0FBb0M7QUFBM0Isa0dBQUEsTUFBTSxPQUFBO0FBQ2YsMERBQW1FO0FBQTFELDhIQUFBLE9BQU8sT0FBZ0IifQ==

package/dist/ports/activity-log-port.d.ts

@@ -0,0 +1,24 @@
+import type { RecordId } from '../types/validated/collection';
+import type { ActivityLogAction, ActivityLogType } from '@forestadmin/forestadmin-client';
+export interface CreateActivityLogArgs {
+    renderingId: number;
+    action: ActivityLogAction;
+    type: ActivityLogType;
+    collectionId: string;
+    recordId?: RecordId;
+    label?: string;
+}
+export interface ActivityLogHandle {
+    id: string;
+    index: string;
+}
+export interface ActivityLogPort {
+    createPending(args: CreateActivityLogArgs): Promise<ActivityLogHandle>;
+    markSucceeded(handle: ActivityLogHandle): Promise<void>;
+    markFailed(handle: ActivityLogHandle): Promise<void>;
+}
+export interface ActivityLogPortFactory {
+    forRun(forestServerToken: string): ActivityLogPort;
+    drain(): Promise<void>;
+}
+//# sourceMappingURL=activity-log-port.d.ts.map

package/dist/ports/activity-log-port.js

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

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

@@ -0,0 +1,54 @@
+import type { StepUser } from '../types/execution-context';
+import type { CollectionSchema, RecordData } from '../types/validated/collection';
+export type Id = string | number;
+export type Limit = {
+    limit: number;
+} | {
+    limit: null;
+};
+export type GetRecordQuery = {
+    collection: string;
+    id: Id[];
+    fields?: string[];
+};
+export type UpdateRecordQuery = {
+    collection: string;
+    id: Id[];
+    values: Record<string, unknown>;
+};
+export type GetRelatedDataQuery = {
+    collection: string;
+    id: Id[];
+    relation: string;
+    relatedSchema: CollectionSchema;
+    fields?: string[];
+} & Limit;
+export type GetSingleRelatedDataQuery = {
+    collection: string;
+    id: Id[];
+    relation: string;
+    relatedSchema: CollectionSchema;
+    fields?: string[];
+};
+export type ExecuteActionQuery = {
+    collection: string;
+    action: string;
+    id?: Id[];
+};
+export type GetActionFormInfoQuery = {
+    collection: string;
+    action: string;
+    id: Id[];
+};
+export interface AgentPort {
+    getRecord(query: GetRecordQuery, user: StepUser): Promise<RecordData>;
+    updateRecord(query: UpdateRecordQuery, user: StepUser): Promise<RecordData>;
+    getRelatedData(query: GetRelatedDataQuery, user: StepUser): Promise<RecordData[]>;
+    getSingleRelatedData(query: GetSingleRelatedDataQuery, user: StepUser): Promise<RecordData | null>;
+    executeAction(query: ExecuteActionQuery, user: StepUser): Promise<unknown>;
+    getActionFormInfo(query: GetActionFormInfoQuery, user: StepUser): Promise<{
+        hasForm: boolean;
+    }>;
+    probe(): Promise<void>;
+}
+//# sourceMappingURL=agent-port.d.ts.map

package/dist/ports/agent-port.js

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

package/dist/ports/ai-model-port.d.ts

@@ -0,0 +1,7 @@
+import type { BaseChatModel, RemoteTool, ToolConfig } from '@forestadmin/ai-proxy';
+export interface AiModelPort {
+    getModel(aiConfigName?: string): BaseChatModel;
+    loadRemoteTools(configs: Record<string, ToolConfig>): Promise<RemoteTool[]>;
+    closeConnections(): Promise<void>;
+}
+//# sourceMappingURL=ai-model-port.d.ts.map

package/dist/ports/ai-model-port.js

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