@forestadmin/workflow-executor 1.0.0

package/dist/errors.js

@@ -0,0 +1,327 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MalformedRunError = exports.DomainValidationError = exports.InvalidStepDefinitionError = exports.RecordIdSerializationError = exports.UnsupportedStepTypeError = exports.AgentProbeError = exports.InvalidPreRecordedArgsError = exports.InvalidPendingDataError = exports.PendingDataNotFoundError = exports.RunAlreadyInFlightError = exports.UserMismatchError = exports.RunNotFoundError = exports.ConfigurationError = exports.McpToolInvocationError = exports.AiModelPortError = exports.WorkflowPortError = exports.SchemaNotCachedError = exports.AgentPortError = exports.McpToolNotFoundError = exports.NoMcpToolsError = exports.AiInvokeTimeoutError = exports.StepTimeoutError = exports.ActivityLogCreationError = exports.StepStateError = exports.ActionNotFoundError = exports.FieldTypeMissingError = exports.FieldNotFoundError = exports.RelationNotFoundError = exports.InvalidAiRequestError = exports.InvalidAIResponseError = exports.RelatedRecordNotFoundError = exports.NoRelationshipFieldsError = exports.RunStorePortError = exports.UnsupportedActionFormError = exports.NoActionsError = exports.NoWritableFieldsError = exports.NoResolvedFieldsError = exports.NoReadableFieldsError = exports.NoRecordsError = exports.RecordNotFoundError = exports.MalformedToolCallError = exports.MissingToolCallError = exports.WorkflowExecutorError = void 0;
+exports.causeMessage = causeMessage;
+exports.extractErrorMessage = extractErrorMessage;
+function causeMessage(error) {
+    const { cause } = error;
+    return cause instanceof Error ? cause.message : undefined;
+}
+// Cascades through err.message → err.parent.message (Sequelize) → err.cause.message → err.name,
+// so wrapped infra errors (SequelizeConnectionRefusedError has an empty .message) don't log as empty.
+function extractErrorMessage(err) {
+    if (err === undefined)
+        return undefined;
+    if (!(err instanceof Error))
+        return String(err);
+    if (err.message)
+        return err.message;
+    const { parent } = err;
+    if (parent instanceof Error && parent.message)
+        return parent.message;
+    const { cause } = err;
+    if (cause instanceof Error && cause.message)
+        return cause.message;
+    return err.name || 'Unknown error';
+}
+class WorkflowExecutorError extends Error {
+    constructor(message, userMessage) {
+        super(message);
+        this.name = this.constructor.name;
+        this.userMessage = userMessage ?? message;
+    }
+}
+exports.WorkflowExecutorError = WorkflowExecutorError;
+class MissingToolCallError extends WorkflowExecutorError {
+    constructor() {
+        super('AI did not return a tool call', "The AI couldn't decide what to do. Try rephrasing the step's prompt.");
+    }
+}
+exports.MissingToolCallError = MissingToolCallError;
+class MalformedToolCallError extends WorkflowExecutorError {
+    constructor(toolName, details) {
+        super(`AI returned a malformed tool call for "${toolName}": ${details}`, "The AI returned an unexpected response. Try rephrasing the step's prompt.");
+        this.toolName = toolName;
+    }
+}
+exports.MalformedToolCallError = MalformedToolCallError;
+class RecordNotFoundError extends WorkflowExecutorError {
+    constructor(collectionName, recordId) {
+        super(`Record not found: collection "${collectionName}", id "${recordId.join('|')}"`, 'The record no longer exists. It may have been deleted.');
+    }
+}
+exports.RecordNotFoundError = RecordNotFoundError;
+class NoRecordsError extends WorkflowExecutorError {
+    constructor() {
+        super('No records available');
+    }
+}
+exports.NoRecordsError = NoRecordsError;
+class NoReadableFieldsError extends WorkflowExecutorError {
+    constructor(collectionName) {
+        super(`No readable fields on record from collection "${collectionName}"`, 'This record type has no readable fields configured in Forest Admin.');
+    }
+}
+exports.NoReadableFieldsError = NoReadableFieldsError;
+class NoResolvedFieldsError extends WorkflowExecutorError {
+    constructor(fieldNames) {
+        super(`None of the requested fields could be resolved: ${fieldNames.join(', ')}`, "The AI selected fields that don't exist on this record. Try rephrasing the step's prompt.");
+    }
+}
+exports.NoResolvedFieldsError = NoResolvedFieldsError;
+class NoWritableFieldsError extends WorkflowExecutorError {
+    constructor(collectionName) {
+        super(`No writable fields on record from collection "${collectionName}"`, 'This record type has no editable fields configured in Forest Admin.');
+    }
+}
+exports.NoWritableFieldsError = NoWritableFieldsError;
+class NoActionsError extends WorkflowExecutorError {
+    constructor(collectionName) {
+        super(`No actions available on collection "${collectionName}"`, 'No actions are available on this record.');
+    }
+}
+exports.NoActionsError = NoActionsError;
+class UnsupportedActionFormError extends WorkflowExecutorError {
+    constructor(actionDisplayName) {
+        super(`Action "${actionDisplayName}" requires a form which is not supported by the executor`, 'This action requires user input via a form, which is not yet supported in workflows.');
+    }
+}
+exports.UnsupportedActionFormError = UnsupportedActionFormError;
+class RunStorePortError extends WorkflowExecutorError {
+    constructor(operation, cause) {
+        super(`Run store "${operation}" failed: ${cause instanceof Error ? cause.message : String(cause)}`, 'The step state could not be accessed. Please retry.');
+        this.cause = cause;
+    }
+}
+exports.RunStorePortError = RunStorePortError;
+class NoRelationshipFieldsError extends WorkflowExecutorError {
+    constructor(collectionName) {
+        super(`No relationship fields on record from collection "${collectionName}"`, 'This record type has no relations configured in Forest Admin.');
+    }
+}
+exports.NoRelationshipFieldsError = NoRelationshipFieldsError;
+class RelatedRecordNotFoundError extends WorkflowExecutorError {
+    constructor(collectionName, relationName) {
+        super(`No related record found for relation "${relationName}" on collection "${collectionName}"`, 'The related record could not be found. It may have been deleted.');
+    }
+}
+exports.RelatedRecordNotFoundError = RelatedRecordNotFoundError;
+class InvalidAIResponseError extends WorkflowExecutorError {
+    constructor(message) {
+        super(message, "The AI made an unexpected choice. Try rephrasing the step's prompt.");
+    }
+}
+exports.InvalidAIResponseError = InvalidAIResponseError;
+class InvalidAiRequestError extends WorkflowExecutorError {
+    constructor(message) {
+        super(message, 'Step configuration error — please contact your administrator.');
+    }
+}
+exports.InvalidAiRequestError = InvalidAiRequestError;
+class RelationNotFoundError extends WorkflowExecutorError {
+    constructor(name, collectionName) {
+        super(`Relation "${name}" not found in collection "${collectionName}"`, "The AI selected a relation that doesn't exist on this record. Try rephrasing the step's prompt.");
+    }
+}
+exports.RelationNotFoundError = RelationNotFoundError;
+class FieldNotFoundError extends WorkflowExecutorError {
+    constructor(name, collectionName) {
+        super(`Field "${name}" not found in collection "${collectionName}"`, "The AI selected a field that doesn't exist on this record. Try rephrasing the step's prompt.");
+    }
+}
+exports.FieldNotFoundError = FieldNotFoundError;
+class FieldTypeMissingError extends WorkflowExecutorError {
+    constructor(name, collectionName) {
+        super(`Field "${name}" in collection "${collectionName}" has no column type`, "This field can't be updated because its type is missing from the schema. " +
+            'Contact your administrator if the problem persists.');
+    }
+}
+exports.FieldTypeMissingError = FieldTypeMissingError;
+class ActionNotFoundError extends WorkflowExecutorError {
+    constructor(name, collectionName) {
+        super(`Action "${name}" not found in collection "${collectionName}"`, "The AI selected an action that doesn't exist on this record. Try rephrasing the step's prompt.");
+    }
+}
+exports.ActionNotFoundError = ActionNotFoundError;
+class StepStateError extends WorkflowExecutorError {
+    constructor(message) {
+        super(message, 'An unexpected error occurred while processing this step.');
+    }
+}
+exports.StepStateError = StepStateError;
+// Bubbles from base-step-executor, which converts it to a step error — no step runs without an audit log.
+class ActivityLogCreationError extends WorkflowExecutorError {
+    constructor(cause) {
+        super('Failed to create activity log', 'Could not record this step in the audit log. Please try again, or contact your administrator if the problem persists.');
+        this.cause = cause;
+    }
+}
+exports.ActivityLogCreationError = ActivityLogCreationError;
+class StepTimeoutError extends WorkflowExecutorError {
+    constructor(timeoutMs) {
+        super(`Step execution exceeded timeout of ${timeoutMs}ms`, 'The step took too long to complete. Please try again, or contact your administrator if the problem persists.');
+    }
+}
+exports.StepTimeoutError = StepTimeoutError;
+// Thrown when the AI provider does not respond within the configured timeout — distinct from
+// StepTimeoutError so we can surface a provider-specific message and tune the AI timeout
+// independently of the step timeout (AI hangs are common; record fetches are not).
+class AiInvokeTimeoutError extends WorkflowExecutorError {
+    constructor(timeoutMs) {
+        super(`AI provider did not respond within ${timeoutMs}ms`, 'The AI provider did not respond in time. Please try again, or contact your administrator if the problem persists.');
+    }
+}
+exports.AiInvokeTimeoutError = AiInvokeTimeoutError;
+class NoMcpToolsError extends WorkflowExecutorError {
+    constructor(requestedMcpServerId) {
+        super(`No MCP tools available for mcpServerId="${requestedMcpServerId}"`, 'Tools could not be loaded for the targeted server. Please try again, or contact your administrator if the problem persists.');
+    }
+}
+exports.NoMcpToolsError = NoMcpToolsError;
+class McpToolNotFoundError extends WorkflowExecutorError {
+    constructor(name) {
+        super(`MCP tool "${name}" not found`, "The AI selected a tool that doesn't exist. Try rephrasing the step's prompt.");
+    }
+}
+exports.McpToolNotFoundError = McpToolNotFoundError;
+class AgentPortError extends WorkflowExecutorError {
+    constructor(operation, cause) {
+        super(`Agent port "${operation}" failed: ${cause instanceof Error ? cause.message : String(cause)}`, 'An error occurred while accessing your data. Please try again.');
+        this.cause = cause;
+    }
+}
+exports.AgentPortError = AgentPortError;
+// Invariant guard: the agent port reads a collection's schema (for its primary keys) from the
+// cache, which the executor must populate via getCollectionSchema before any record access.
+class SchemaNotCachedError extends WorkflowExecutorError {
+    constructor(collectionName) {
+        super(`Collection schema for "${collectionName}" was not loaded before access — call getCollectionSchema first`, 'An error occurred while accessing your data. Please try again.');
+    }
+}
+exports.SchemaNotCachedError = SchemaNotCachedError;
+class WorkflowPortError extends WorkflowExecutorError {
+    constructor(operation, cause) {
+        super(`Workflow port "${operation}" failed: ${cause instanceof Error ? cause.message : String(cause)}`, "This step couldn't be completed. Please try again, and contact your administrator if the problem continues.");
+        this.cause = cause;
+    }
+}
+exports.WorkflowPortError = WorkflowPortError;
+class AiModelPortError extends WorkflowExecutorError {
+    constructor(operation, cause) {
+        super(`AI model "${operation}" failed: ${cause instanceof Error ? cause.message : String(cause)}`, 'The AI service is unavailable. Please try again or contact your administrator.');
+        this.cause = cause;
+    }
+}
+exports.AiModelPortError = AiModelPortError;
+class McpToolInvocationError extends WorkflowExecutorError {
+    constructor(toolName, cause) {
+        super(`MCP tool "${toolName}" invocation failed: ${cause instanceof Error ? cause.message : String(cause)}`, 'The tool failed to execute. Please try again or contact your administrator.');
+        this.cause = cause;
+    }
+}
+exports.McpToolInvocationError = McpToolInvocationError;
+class ConfigurationError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigurationError';
+    }
+}
+exports.ConfigurationError = ConfigurationError;
+class RunNotFoundError extends Error {
+    constructor(runId, cause) {
+        super(`Run "${runId}" not found or unavailable`);
+        this.name = 'RunNotFoundError';
+        if (cause !== undefined)
+            this.cause = cause;
+    }
+}
+exports.RunNotFoundError = RunNotFoundError;
+class UserMismatchError extends Error {
+    constructor(runId) {
+        super(`User not authorized for run "${runId}"`);
+        this.name = 'UserMismatchError';
+    }
+}
+exports.UserMismatchError = UserMismatchError;
+class RunAlreadyInFlightError extends Error {
+    constructor(runId) {
+        super(`Run "${runId}" is already being processed`);
+        this.name = 'RunAlreadyInFlightError';
+    }
+}
+exports.RunAlreadyInFlightError = RunAlreadyInFlightError;
+class PendingDataNotFoundError extends Error {
+    constructor(runId, stepIndex) {
+        super(`Step ${stepIndex} in run "${runId}" not found or has no pending data`);
+        this.name = 'PendingDataNotFoundError';
+    }
+}
+exports.PendingDataNotFoundError = PendingDataNotFoundError;
+class InvalidPendingDataError extends WorkflowExecutorError {
+    constructor(issues) {
+        super('Invalid pending data', 'The request body is invalid.');
+        this.issues = issues;
+    }
+}
+exports.InvalidPendingDataError = InvalidPendingDataError;
+class InvalidPreRecordedArgsError extends WorkflowExecutorError {
+    constructor(detail) {
+        super(`Invalid pre-recorded args: ${detail}`, 'The pre-configured step parameters are invalid');
+    }
+}
+exports.InvalidPreRecordedArgsError = InvalidPreRecordedArgsError;
+// Boundary error — surfaces from Runner.start() and is caught at the CLI/HTTP layer, not by step executors.
+class AgentProbeError extends Error {
+    constructor(message, options) {
+        super(`Agent probe failed: ${message}`);
+        this.name = 'AgentProbeError';
+        if (options?.cause !== undefined)
+            this.cause = options.cause;
+    }
+}
+exports.AgentProbeError = AgentProbeError;
+class UnsupportedStepTypeError extends WorkflowExecutorError {
+    constructor(stepType) {
+        super(`Step type "${stepType}" is not supported by the executor`, 'This step type is not yet supported.');
+    }
+}
+exports.UnsupportedStepTypeError = UnsupportedStepTypeError;
+class RecordIdSerializationError extends WorkflowExecutorError {
+    constructor(part) {
+        super(`Composite record id part "${part}" cannot contain the "|" separator`, 'A record identifier contains an unsupported character and cannot be processed.');
+    }
+}
+exports.RecordIdSerializationError = RecordIdSerializationError;
+class InvalidStepDefinitionError extends WorkflowExecutorError {
+    constructor(detail) {
+        super(`Invalid step definition: ${detail}`, 'The workflow step configuration is invalid. Please check the workflow designer.');
+    }
+}
+exports.InvalidStepDefinitionError = InvalidStepDefinitionError;
+// Thrown when zod validation fails on a domain object produced internally (e.g. by the
+// run-to-pending-step mapper). Distinct from InvalidStepDefinitionError (which flags wire-format
+// bugs coming from the orchestrator) so the two can be triaged separately in Sentry.
+class DomainValidationError extends WorkflowExecutorError {
+    constructor(runId, zodError) {
+        const issues = zodError.issues.map(i => ({
+            path: i.path.join('.') || '(root)',
+            message: i.message,
+        }));
+        const summary = issues.length
+            ? issues.map(i => `${i.path}: ${i.message}`).join('; ')
+            : '(no zod issues reported — unexpected empty ZodError)';
+        super(`Run ${runId} mapper produced invalid AvailableStepExecution — ${summary}`, 'Internal validation error occurred while preparing the step. Please contact support.');
+        this.cause = zodError;
+        this.issues = issues;
+    }
+}
+exports.DomainValidationError = DomainValidationError;
+// Carries MalformedRunInfo so the Runner can report the run without re-parsing the message.
+class MalformedRunError extends WorkflowExecutorError {
+    constructor(info) {
+        super(info.technicalMessage, info.userMessage);
+        this.info = info;
+    }
+}
+exports.MalformedRunError = MalformedRunError;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2Vycm9ycy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFLQSxvQ0FJQztBQUlELGtEQVlDO0FBcEJELFNBQWdCLFlBQVksQ0FBQyxLQUFjO0lBQ3pDLE1BQU0sRUFBRSxLQUFLLEVBQUUsR0FBRyxLQUE0QixDQUFDO0lBRS9DLE9BQU8sS0FBSyxZQUFZLEtBQUssQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsU0FBUyxDQUFDO0FBQzVELENBQUM7QUFFRCxnR0FBZ0c7QUFDaEcsc0dBQXNHO0FBQ3RHLFNBQWdCLG1CQUFtQixDQUFDLEdBQWE7SUFDL0MsSUFBSSxHQUFHLEtBQUssU0FBUztRQUFFLE9BQU8sU0FBUyxDQUFDO0lBQ3hDLElBQUksQ0FBQyxDQUFDLEdBQUcsWUFBWSxLQUFLLENBQUM7UUFBRSxPQUFPLE1BQU0sQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUNoRCxJQUFJLEdBQUcsQ0FBQyxPQUFPO1FBQUUsT0FBTyxHQUFHLENBQUMsT0FBTyxDQUFDO0lBRXBDLE1BQU0sRUFBRSxNQUFNLEVBQUUsR0FBRyxHQUEyQixDQUFDO0lBQy9DLElBQUksTUFBTSxZQUFZLEtBQUssSUFBSSxNQUFNLENBQUMsT0FBTztRQUFFLE9BQU8sTUFBTSxDQUFDLE9BQU8sQ0FBQztJQUVyRSxNQUFNLEVBQUUsS0FBSyxFQUFFLEdBQUcsR0FBMEIsQ0FBQztJQUM3QyxJQUFJLEtBQUssWUFBWSxLQUFLLElBQUksS0FBSyxDQUFDLE9BQU87UUFBRSxPQUFPLEtBQUssQ0FBQyxPQUFPLENBQUM7SUFFbEUsT0FBTyxHQUFHLENBQUMsSUFBSSxJQUFJLGVBQWUsQ0FBQztBQUNyQyxDQUFDO0FBRUQsTUFBc0IscUJBQXNCLFNBQVEsS0FBSztJQUl2RCxZQUFZLE9BQWUsRUFBRSxXQUFvQjtRQUMvQyxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDZixJ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

package/dist/executors/activity-log.d.ts

@@ -0,0 +1,14 @@
+import type { ActivityLogPort, CreateActivityLogArgs } from '../ports/activity-log-port';
+import type { StepUser } from '../types/execution-context';
+export type AuditTarget = Omit<CreateActivityLogArgs, 'renderingId'>;
+export type TrackOptions<T> = {
+    operation: () => Promise<T>;
+    beforeCall?: () => Promise<void>;
+};
+export default class ActivityLog {
+    private readonly activityLogPort;
+    private readonly user;
+    constructor(activityLogPort: ActivityLogPort, user: StepUser);
+    track<T>(target: AuditTarget, { operation, beforeCall }: TrackOptions<T>): Promise<T>;
+}
+//# sourceMappingURL=activity-log.d.ts.map

package/dist/executors/activity-log.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Runs an operation while recording an activity-log entry around it (pending → success/failed).
+// It both executes `operation` and owns the activity-log transitions, so callers never touch the
+// ActivityLogPort directly. `beforeCall` runs after createPending, just before the operation, so
+// an audit-creation failure never leaves an orphan write-ahead marker.
+class ActivityLog {
+    constructor(activityLogPort, user) {
+        this.activityLogPort = activityLogPort;
+        this.user = user;
+    }
+    async track(target, { operation, beforeCall }) {
+        const handle = await this.activityLogPort.createPending({
+            renderingId: this.user.renderingId,
+            ...target,
+        });
+        try {
+            if (beforeCall)
+                await beforeCall();
+            const result = await operation();
+            void this.activityLogPort.markSucceeded(handle);
+            return result;
+        }
+        catch (err) {
+            // The step error is logged/surfaced by base-step-executor when rethrown, so the audit
+            // transition only needs the handle.
+            void this.activityLogPort.markFailed(handle);
+            throw err;
+        }
+    }
+}
+exports.default = ActivityLog;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWN0aXZpdHktbG9nLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2V4ZWN1dG9ycy9hY3Rpdml0eS1sb2cudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFhQSxnR0FBZ0c7QUFDaEcsaUdBQWlHO0FBQ2pHLGlHQUFpRztBQUNqRyx1RUFBdUU7QUFDdkUsTUFBcUIsV0FBVztJQUs5QixZQUFZLGVBQWdDLEVBQUUsSUFBYztRQUMxRCxJQUFJLENBQUMsZUFBZSxHQUFHLGVBQWUsQ0FBQztRQUN2QyxJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQztJQUNuQixDQUFDO0lBRUQsS0FBSyxDQUFDLEtBQUssQ0FBSSxNQUFtQixFQUFFLEVBQUUsU0FBUyxFQUFFLFVBQVUsRUFBbUI7UUFDNUUsTUFBTSxNQUFNLEdBQUcsTUFBTSxJQUFJLENBQUMsZUFBZSxDQUFDLGFBQWEsQ0FBQztZQUN0RCxXQUFXLEVBQUUsSUFBSSxDQUFDLElBQUksQ0FBQyxXQUFXO1lBQ2xDLEdBQUcsTUFBTTtTQUNWLENBQUMsQ0FBQztRQUVILElBQUksQ0FBQztZQUNILElBQUksVUFBVTtnQkFBRSxNQUFNLFVBQVUsRUFBRSxDQUFDO1lBQ25DLE1BQU0sTUFBTSxHQUFHLE1BQU0sU0FBUyxFQUFFLENBQUM7WUFDakMsS0FBSyxJQUFJLENBQUMsZUFBZSxDQUFDLGFBQWEsQ0FBQyxNQUFNLENBQUMsQ0FBQztZQUVoRCxPQUFPLE1BQU0sQ0FBQztRQUNoQixDQUFDO1FBQUMsT0FBTyxHQUFHLEVBQUUsQ0FBQztZQUNiLHNGQUFzRjtZQUN0RixvQ0FBb0M7WUFDcEMsS0FBSyxJQUFJLENBQUMsZUFBZSxDQUFDLFVBQVUsQ0FBQyxNQUFNLENBQUMsQ0FBQztZQUM3QyxNQUFNLEdBQUcsQ0FBQztRQUNaLENBQUM7SUFDSCxDQUFDO0NBQ0Y7QUE3QkQsOEJBNkJDIn0=

package/dist/executors/agent-with-log.d.ts

@@ -0,0 +1,33 @@
+import type ActivityLog from './activity-log';
+import type { AgentPort, ExecuteActionQuery, GetActionFormInfoQuery, GetRecordQuery, GetRelatedDataQuery, GetSingleRelatedDataQuery, UpdateRecordQuery } from '../ports/agent-port';
+import type SchemaResolver from '../schema-resolver';
+import type { StepUser } from '../types/execution-context';
+import type { RecordData } from '../types/validated/collection';
+type WriteOptions = {
+    beforeCall: () => Promise<void>;
+};
+export interface AgentWithLogDeps {
+    agentPort: AgentPort;
+    schemaResolver: SchemaResolver;
+    user: StepUser;
+    activityLog: ActivityLog;
+}
+export default class AgentWithLog {
+    private readonly agentPort;
+    private readonly schemaResolver;
+    private readonly user;
+    private readonly activityLog;
+    constructor(deps: AgentWithLogDeps);
+    getRecord(query: GetRecordQuery): Promise<RecordData>;
+    getRelatedData(query: GetRelatedDataQuery): Promise<RecordData[]>;
+    getSingleRelatedData(query: GetSingleRelatedDataQuery): Promise<RecordData | null>;
+    updateRecord(query: UpdateRecordQuery, opts: WriteOptions): Promise<RecordData>;
+    executeAction(query: ExecuteActionQuery, opts: WriteOptions): Promise<unknown>;
+    getActionFormInfo(query: GetActionFormInfoQuery): Promise<{
+        hasForm: boolean;
+    }>;
+    private relationLabel;
+    private resolveSchema;
+}
+export {};
+//# sourceMappingURL=agent-with-log.d.ts.map

package/dist/executors/agent-with-log.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Wraps AgentPort and runs each data-access call through the ActivityLog so it records an
+// activity-log entry. The audit target is derived from the call: the numeric collectionId is
+// resolved from the call's collection name, the recordId from its id. Idempotency stays in the
+// executors: write methods forward a `beforeCall` thunk (the executor's write-ahead marker).
+class AgentWithLog {
+    constructor(deps) {
+        this.agentPort = deps.agentPort;
+        this.schemaResolver = deps.schemaResolver;
+        this.user = deps.user;
+        this.activityLog = deps.activityLog;
+    }
+    async getRecord(query) {
+        const { collectionId } = await this.resolveSchema(query.collection);
+        return this.activityLog.track({ action: 'index', type: 'read', collectionId, recordId: query.id }, { operation: () => this.agentPort.getRecord(query, this.user) });
+    }
+    async getRelatedData(query) {
+        const schema = await this.resolveSchema(query.collection);
+        return this.activityLog.track({
+            action: 'listRelatedData',
+            type: 'read',
+            collectionId: schema.collectionId,
+            recordId: query.id,
+            label: this.relationLabel(schema, query.relation),
+        }, { operation: () => this.agentPort.getRelatedData(query, this.user) });
+    }
+    async getSingleRelatedData(query) {
+        const schema = await this.resolveSchema(query.collection);
+        return this.activityLog.track({
+            action: 'listRelatedData',
+            type: 'read',
+            collectionId: schema.collectionId,
+            recordId: query.id,
+            label: this.relationLabel(schema, query.relation),
+        }, { operation: () => this.agentPort.getSingleRelatedData(query, this.user) });
+    }
+    async updateRecord(query, opts) {
+        const { collectionId } = await this.resolveSchema(query.collection);
+        return this.activityLog.track({ action: 'update', type: 'write', collectionId, recordId: query.id, label: 'updated' }, {
+            operation: () => this.agentPort.updateRecord(query, this.user),
+            beforeCall: opts.beforeCall,
+        });
+    }
+    async executeAction(query, opts) {
+        const { collectionId } = await this.resolveSchema(query.collection);
+        return this.activityLog.track({
+            action: 'action',
+            type: 'write',
+            collectionId,
+            recordId: query.id,
+            label: `triggered the action "${query.action}"`,
+        }, {
+            operation: () => this.agentPort.executeAction(query, this.user),
+            beforeCall: opts.beforeCall,
+        });
+    }
+    // Unaudited passthrough: form-info is a read-only probe (does this action have a form?),
+    // not a data access, so unlike the methods above it records NO activity-log entry.
+    getActionFormInfo(query) {
+        return this.agentPort.getActionFormInfo(query, this.user);
+    }
+    // ISO with the browser engine: `list relation "<displayName>"`. The query carries the technical
+    // relation name; resolve its displayName from the source schema, falling back to the technical
+    // name when the field is absent (resilient to orchestrator schema drift).
+    relationLabel(schema, relation) {
+        const displayName = schema.fields.filter(f => f.isRelationship).find(f => f.fieldName === relation)
+            ?.displayName ?? relation;
+        return `list relation "${displayName}"`;
+    }
+    resolveSchema(collectionName) {
+        return this.schemaResolver.resolve(collectionName);
+    }
+}
+exports.default = AgentWithLog;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWdlbnQtd2l0aC1sb2cuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZXhlY3V0b3JzL2FnZW50LXdpdGgtbG9nLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBdUJBLDBGQUEwRjtBQUMxRiw2RkFBNkY7QUFDN0YsK0ZBQStGO0FBQy9GLDZGQUE2RjtBQUM3RixNQUFxQixZQUFZO0lBUy9CLFlBQVksSUFBc0I7UUFDaEMsSUFBSSxDQUFDLFNBQVMsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDO1FBQ2hDLElBQUksQ0FBQyxjQUFjLEdBQUcsSUFBSSxDQUFDLGNBQWMsQ0FBQztRQUMxQyxJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQyxJQUFJLENBQUM7UUFDdEIsSUFBSSxDQUFDLFdBQVcsR0FBRyxJQUFJLENBQUMsV0FBVyxDQUFDO0lBQ3RDLENBQUM7SUFFRCxLQUFLLENBQUMsU0FBUyxDQUFDLEtBQXFCO1FBQ25DLE1BQU0sRUFBRSxZQUFZLEVBQUUsR0FBRyxNQUFNLElBQUksQ0FBQyxhQUFhLENBQUMsS0FBSyxDQUFDLFVBQVUsQ0FBQyxDQUFDO1FBRXBFLE9BQU8sSUFBSSxDQUFDLFdBQVcsQ0FBQyxLQUFLLENBQzNCLEVBQUUsTUFBTSxFQUFFLE9BQU8sRUFBRSxJQUFJLEVBQUUsTUFBTSxFQUFFLFlBQVksRUFBRSxRQUFRLEVBQUUsS0FBSyxDQUFDLEVBQUUsRUFBRSxFQUNuRSxFQUFFLFNBQVMsRUFBRSxHQUFHLEVBQUUsQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLFNBQVMsQ0FBQyxLQUFLLEVBQUUsSUFBSSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQ2hFLENBQUM7SUFDSixDQUFDO0lBRUQsS0FBSyxDQUFDLGNBQWMsQ0FBQyxLQUEwQjtRQUM3QyxNQUFNLE1BQU0sR0FBRyxNQUFNLElBQUksQ0FBQyxhQUFhLENBQUMsS0FBSyxDQUFDLFVBQVUsQ0FBQyxDQUFDO1FBRTFELE9BQU8sSUFBSSxDQUFDLFdB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

package/dist/executors/base-step-executor.d.ts

@@ -0,0 +1,40 @@
+import type { ExecutionContext, IStepExecutor, StepExecutionResult } from '../types/execution-context';
+import type { ConfirmableStepExecutionData, StepExecutionData } from '../types/step-execution-data';
+import type { Step } from '../types/validated/execution';
+import type { StepDefinition } from '../types/validated/step-definition';
+import type { StepStatus } from '../types/validated/step-outcome';
+import type { BaseMessage, DynamicStructuredTool, StructuredToolInterface } from '@forestadmin/ai-proxy';
+import { SystemMessage } from '@forestadmin/ai-proxy';
+export default abstract class BaseStepExecutor<TStep extends StepDefinition = StepDefinition> implements IStepExecutor {
+    protected readonly context: ExecutionContext<TStep>;
+    constructor(context: ExecutionContext<TStep>);
+    execute(): Promise<StepExecutionResult>;
+    protected abstract doExecute(): Promise<StepExecutionResult>;
+    protected checkIdempotency(): Promise<StepExecutionResult | null>;
+    private runWithTimeout;
+    protected abstract buildOutcomeResult(outcome: {
+        status: StepStatus;
+        error?: string;
+    }): StepExecutionResult;
+    protected findPendingExecution<TExec extends ConfirmableStepExecutionData>(type: string): Promise<TExec | undefined>;
+    protected patchAndReloadPendingData<TExec extends ConfirmableStepExecutionData>(pendingData?: unknown): Promise<TExec | undefined>;
+    protected handleConfirmationFlow<TExec extends ConfirmableStepExecutionData>(execution: TExec, resolveAndExecute: (execution: TExec) => Promise<StepExecutionResult>): Promise<StepExecutionResult>;
+    protected buildContextMessage(): SystemMessage;
+    protected buildPreviousStepsMessages(): Promise<SystemMessage[]>;
+    protected resolveStepExecution(step: Step, executions: StepExecutionData[]): StepExecutionData | undefined;
+    private static mergeLeadingSystemMessages;
+    private static assertNoMidArraySystemMessages;
+    protected invokeWithTools<T = Record<string, unknown>>(messages: BaseMessage[], tools: StructuredToolInterface[]): Promise<{
+        toolName: string;
+        args: T;
+    }>;
+    protected invokeWithTool<T = Record<string, unknown>>(messages: BaseMessage[], tool: DynamicStructuredTool): Promise<T>;
+    protected getExtraLogContext(): Record<string, unknown>;
+    protected get logCtx(): {
+        runId: string;
+        stepId: string;
+        stepIndex: number;
+        stepType: import("../types/validated/step-definition").StepType;
+    };
+}
+//# sourceMappingURL=base-step-executor.d.ts.map