@relayflows/core 0.0.1 → 1.0.1

package/dist/integrations/slack.js

@@ -0,0 +1,355 @@
+import { SlackClient } from '@relayflows/slack-primitive';
+import { SlackAction, SLACK_ACTIONS, } from '@relayflows/slack-primitive';
+const SLACK_INTEGRATION = 'slack';
+const RESERVED_PARAM_KEYS = new Set(['action', 'config', 'slackConfig', 'output', 'params']);
+/**
+ * Create a Relay integration step for posting a Slack message.
+ * @param config - Slack step configuration.
+ * @returns Workflow integration step.
+ */
+export function createSlackStep(config) {
+    validateSlackStepConfig(config);
+    const params = {
+        text: config.text,
+    };
+    if (config.channel !== undefined)
+        params.channel = config.channel;
+    if (config.threadTs !== undefined)
+        params.threadTs = config.threadTs;
+    if (config.mentions !== undefined)
+        params.mentions = JSON.stringify(config.mentions);
+    if (config.unfurl !== undefined)
+        params.unfurl = String(config.unfurl);
+    if (config.config !== undefined)
+        params.config = JSON.stringify(config.config);
+    if (config.output !== undefined)
+        params.output = JSON.stringify(config.output);
+    const step = {
+        name: config.name,
+        type: 'integration',
+        integration: SLACK_INTEGRATION,
+        action: config.action,
+        params,
+    };
+    if (config.dependsOn !== undefined)
+        step.dependsOn = config.dependsOn;
+    if (config.timeoutMs !== undefined)
+        step.timeoutMs = config.timeoutMs;
+    if (config.retries !== undefined)
+        step.retries = config.retries;
+    return step;
+}
+export class SlackStepExecutor {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async executeAgentStep() {
+        throw new Error('SlackStepExecutor only executes Slack integration steps.');
+    }
+    async execute(config, context = {}) {
+        validateSlackStepConfig(config);
+        const runtimeConfig = mergeRuntimeConfig(this.options, context.config, config.config);
+        const client = context.client ?? new SlackClient(runtimeConfig);
+        const params = buildActionParams(config);
+        const result = await client.executeAction(SlackAction.PostMessage, params);
+        const output = formatStepOutput(config, result);
+        return {
+            success: result.success,
+            output,
+            result,
+            error: result.error,
+        };
+    }
+    async executeIntegrationStep(step, resolvedParams) {
+        if (step.integration !== SLACK_INTEGRATION) {
+            return {
+                success: false,
+                output: `SlackStepExecutor only handles "${SLACK_INTEGRATION}" integration steps`,
+            };
+        }
+        try {
+            const config = slackStepConfigFromWorkflowStep(step, resolvedParams);
+            const result = await this.execute(config);
+            return {
+                success: result.success,
+                output: result.success ? result.output : result.output || result.error || 'Slack step failed',
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                output: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+}
+/**
+ * Rebuild a Slack step config from resolved workflow params.
+ * @param step - Workflow step.
+ * @param resolvedParams - Params after workflow templating.
+ * @returns Slack step configuration.
+ */
+export function slackStepConfigFromWorkflowStep(step, resolvedParams) {
+    const params = normalizeResolvedParams(resolvedParams);
+    const action = step.action;
+    if (action !== SlackAction.PostMessage) {
+        throw new Error(`Slack step "${step.name}" requires action "postMessage"`);
+    }
+    const config = readJsonParam(params.config ?? params.slackConfig, 'config') ?? undefined;
+    const output = readJsonParam(params.output, 'output') ?? undefined;
+    const actionParams = readActionParams(params);
+    return {
+        name: step.name,
+        dependsOn: step.dependsOn,
+        action: SlackAction.PostMessage,
+        channel: readOptionalString(actionParams.channel),
+        text: readRequiredString(actionParams.text, 'text'),
+        threadTs: readOptionalString(actionParams.threadTs),
+        mentions: readStringArray(actionParams.mentions),
+        unfurl: readOptionalBoolean(actionParams.unfurl, 'unfurl'),
+        config,
+        output,
+        timeoutMs: step.timeoutMs,
+        retries: step.retries,
+    };
+}
+export function renderSlackTemplates(value, data) {
+    return value.replace(/\{\{\s*steps\.([A-Za-z0-9_-]+)\.output(?:\.([A-Za-z0-9_.-]+))?\s*\}\}/g, (_match, step, path) => {
+        const stepData = data.steps;
+        if (!isRecord(stepData))
+            return '';
+        const entry = stepData[String(step)];
+        if (!isRecord(entry))
+            return '';
+        const output = entry.output;
+        const resolved = typeof path === 'string' && path.length > 0 ? resolvePath(output, path) : output;
+        return projectionToText(resolved);
+    });
+}
+function validateSlackStepConfig(config) {
+    if (!config.name) {
+        throw new Error('Slack step requires a non-empty name');
+    }
+    if (!SLACK_ACTIONS.includes(config.action)) {
+        throw new Error(`Slack step "${config.name}" uses unsupported action "${config.action}"`);
+    }
+    if (config.action !== SlackAction.PostMessage) {
+        throw new Error(`Slack step "${config.name}" requires action "postMessage"`);
+    }
+    if (typeof config.text !== 'string' || config.text.length === 0) {
+        throw new Error(`Slack step "${config.name}" requires message text`);
+    }
+}
+function buildActionParams(config) {
+    return {
+        channel: config.channel,
+        text: config.text,
+        threadTs: config.threadTs,
+        mentions: config.mentions,
+        unfurl: config.unfurl,
+    };
+}
+function readActionParams(params) {
+    const serializedParams = params.params;
+    if (serializedParams !== undefined) {
+        const parsed = readJsonParam(serializedParams, 'params');
+        if (parsed === undefined)
+            return {};
+        if (!isRecord(parsed)) {
+            throw new Error('Slack step params.params must be a JSON object');
+        }
+        return parsed;
+    }
+    const actionParams = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (RESERVED_PARAM_KEYS.has(key))
+            continue;
+        actionParams[key] = value;
+    }
+    return actionParams;
+}
+function mergeRuntimeConfig(...configs) {
+    const merged = {};
+    for (const config of configs) {
+        if (!config)
+            continue;
+        const { env, ...flatConfig } = config;
+        Object.assign(merged, flatConfig);
+        if (env) {
+            merged.env = {
+                ...merged.env,
+                ...env,
+            };
+        }
+    }
+    return merged;
+}
+function formatStepOutput(config, result) {
+    const outputConfig = config.output ?? {};
+    const mode = outputConfig.mode ?? 'data';
+    const format = outputConfig.format ?? 'json';
+    if (mode === 'none') {
+        return '';
+    }
+    let projection = buildOutputProjection(mode, result, outputConfig);
+    if (outputConfig.path) {
+        projection = resolvePath(projection, outputConfig.path);
+    }
+    if (format === 'text') {
+        return projectionToText(projection);
+    }
+    return JSON.stringify(projection, undefined, outputConfig.pretty ? 2 : undefined);
+}
+function buildOutputProjection(mode, result, outputConfig) {
+    if (mode === 'raw')
+        return result.output;
+    if (mode === 'summary') {
+        return withOptionalMetadata(summarizeResult(result), result, outputConfig);
+    }
+    if (mode === 'result') {
+        const projected = {
+            success: result.success,
+            output: result.output,
+        };
+        if (result.data !== undefined)
+            projected.data = result.data;
+        if (result.error !== undefined)
+            projected.error = result.error;
+        return withOptionalMetadata(projected, result, outputConfig);
+    }
+    return withOptionalMetadata(result.data ?? (result.output ? result.output : (result.error ?? null)), result, outputConfig);
+}
+function summarizeResult(result) {
+    if (!result.success) {
+        return {
+            success: false,
+            error: result.error ?? 'Slack action failed',
+        };
+    }
+    if (isRecord(result.data)) {
+        return {
+            success: true,
+            channel: result.data.channel,
+            ts: result.data.ts,
+            unresolvedMentions: result.data.unresolvedMentions,
+        };
+    }
+    return {
+        success: true,
+        value: result.data ?? result.output,
+    };
+}
+function withOptionalMetadata(value, result, outputConfig) {
+    if (!outputConfig.includeMetadata || result.metadata === undefined) {
+        return value;
+    }
+    return {
+        value,
+        metadata: result.metadata,
+    };
+}
+function projectionToText(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value === null || value === undefined)
+        return '';
+    if (Array.isArray(value))
+        return value.map((entry) => projectionToText(entry)).join('\n');
+    if (isRecord(value)) {
+        if ('output' in value)
+            return projectionToText(value.output);
+        if ('value' in value)
+            return projectionToText(value.value);
+        if ('text' in value)
+            return projectionToText(value.text);
+        if ('ts' in value)
+            return projectionToText(value.ts);
+        if ('channel' in value)
+            return projectionToText(value.channel);
+    }
+    return JSON.stringify(value);
+}
+function resolvePath(value, path) {
+    if (!path)
+        return value;
+    let current = value;
+    for (const segment of path.split('.')) {
+        if (Array.isArray(current) && /^\d+$/.test(segment)) {
+            current = current[Number(segment)];
+            continue;
+        }
+        if (isRecord(current)) {
+            current = current[segment];
+            continue;
+        }
+        return undefined;
+    }
+    return current;
+}
+function normalizeResolvedParams(params) {
+    const normalized = {};
+    for (const [key, value] of Object.entries(params)) {
+        normalized[key] = coerceScalar(value);
+    }
+    return normalized;
+}
+function coerceScalar(value) {
+    if (typeof value !== 'string') {
+        return value;
+    }
+    const trimmed = value.trim();
+    if ((trimmed.startsWith('{') && trimmed.endsWith('}')) ||
+        (trimmed.startsWith('[') && trimmed.endsWith(']')) ||
+        (trimmed.startsWith('"') && trimmed.endsWith('"'))) {
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch {
+            return value;
+        }
+    }
+    return value;
+}
+function readJsonParam(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string')
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch (error) {
+        throw new Error(`Slack step params.${name} must be valid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+function readRequiredString(value, name) {
+    if (typeof value === 'string' && value.length > 0)
+        return value;
+    throw new Error(`Slack step requires ${name}`);
+}
+function readOptionalString(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function readStringArray(value) {
+    if (value === undefined)
+        return undefined;
+    if (Array.isArray(value) && value.every((item) => typeof item === 'string'))
+        return value;
+    throw new Error('Slack step mentions must be a string array');
+}
+function readOptionalBoolean(value, name) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value === 'boolean')
+        return value;
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    throw new Error(`Slack step ${name} must be a boolean`);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=slack.js.map

package/dist/integrations/slack.js.map

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

package/dist/listr-renderer.d.ts

@@ -0,0 +1,26 @@
+import type { WorkflowEventListener } from './runner.js';
+export interface WorkflowRenderer {
+    /** Pass this to `.run({ onEvent })` in your TypeScript workflow. */
+    onEvent: WorkflowEventListener;
+    /** Start the listr renderer. Run this concurrently with your workflow. */
+    start: () => Promise<void>;
+    /** Restore console.log after the workflow finishes. */
+    unmount: () => void;
+}
+/**
+ * Creates a listr2-based renderer for TypeScript workflows.
+ *
+ * @example
+ * ```typescript
+ * import { workflow, createWorkflowRenderer } from '@relayflows/core';
+ *
+ * const renderer = createWorkflowRenderer();
+ * const [result] = await Promise.all([
+ *   workflow('my-workflow').step(...).run({ onEvent: renderer.onEvent }),
+ *   renderer.start(),
+ * ]);
+ * renderer.unmount();
+ * ```
+ */
+export declare function createWorkflowRenderer(): WorkflowRenderer;
+//# sourceMappingURL=listr-renderer.d.ts.map

package/dist/listr-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listr-renderer.d.ts","sourceRoot":"","sources":["../src/listr-renderer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiB,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAmCxE,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,OAAO,EAAE,qBAAqB,CAAC;IAC/B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,uDAAuD;IACvD,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAsNzD"}

package/dist/listr-renderer.js

@@ -0,0 +1,230 @@
+import chalk from 'chalk';
+// Filter console.log while listr owns the terminal.
+// Blocks [broker] noise and [workflow HH:MM] timing lines, but lets the
+// observer URL and channel name through so users can track the run.
+function installOutputFilter() {
+    const orig = console.log.bind(console);
+    console.log = (...args) => {
+        const str = String(args[0] ?? '');
+        // Always show the observer URL and channel so users can follow the run
+        if (str.includes('Observer:') || str.includes('agentrelay.com') || str.includes('Channel: wf-')) {
+            orig(...args);
+            return;
+        }
+        // Block [broker] lines and [workflow HH:MM] timing lines
+        if (/\[broker\]/.test(str) || /\[workflow\s+\d{2}:\d{2}\]/.test(str))
+            return;
+        orig(...args);
+    };
+    return () => {
+        console.log = orig;
+    };
+}
+/**
+ * Creates a listr2-based renderer for TypeScript workflows.
+ *
+ * @example
+ * ```typescript
+ * import { workflow, createWorkflowRenderer } from '@relayflows/core';
+ *
+ * const renderer = createWorkflowRenderer();
+ * const [result] = await Promise.all([
+ *   workflow('my-workflow').step(...).run({ onEvent: renderer.onEvent }),
+ *   renderer.start(),
+ * ]);
+ * renderer.unmount();
+ * ```
+ */
+export function createWorkflowRenderer() {
+    const stepHandles = new Map();
+    let resolveWorkflow;
+    let rejectWorkflow;
+    const workflowDone = new Promise((resolve, reject) => {
+        resolveWorkflow = resolve;
+        rejectWorkflow = reject;
+    });
+    // Prevent unhandled rejection if run:failed fires before the header task
+    // reaches `await workflowDone`.
+    workflowDone.catch(() => { });
+    let setHeader = () => { };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let listr = null;
+    const pendingAdds = [];
+    async function ensureListr() {
+        if (listr)
+            return listr;
+        const { Listr } = await import('listr2');
+        listr = new Listr([
+            {
+                title: chalk.dim('Workflow starting...'),
+                task: async (_ctx, task) => {
+                    setHeader = (text) => {
+                        task.title = text;
+                    };
+                    await workflowDone;
+                },
+            },
+        ], {
+            concurrent: true,
+            renderer: process.stdout.isTTY ? 'default' : 'verbose',
+            rendererOptions: {
+                collapseErrors: false,
+                showErrorMessage: true,
+            },
+        });
+        for (const task of pendingAdds)
+            listr.add(task);
+        pendingAdds.length = 0;
+        return listr;
+    }
+    const addTask = (task) => {
+        if (listr)
+            listr.add(task);
+        else
+            pendingAdds.push(task);
+    };
+    const onEvent = (event) => {
+        switch (event.type) {
+            case 'run:started': {
+                setHeader(chalk.dim(`[workflow] run ${event.runId.slice(0, 8)}...`));
+                break;
+            }
+            case 'step:started': {
+                let resolveStep;
+                let rejectStep;
+                let taskRef = null;
+                let skipped = false;
+                const done = new Promise((resolve, reject) => {
+                    resolveStep = resolve;
+                    rejectStep = reject;
+                });
+                // Prevent unhandled rejection if the step fails before the listr
+                // task function has started and reached `await done`.
+                done.catch(() => { });
+                stepHandles.set(event.stepName, {
+                    resolve: resolveStep,
+                    reject: rejectStep,
+                    setOutput: (text) => {
+                        if (taskRef)
+                            taskRef.output = text;
+                    },
+                    markSkipped: () => {
+                        skipped = true;
+                        if (taskRef)
+                            taskRef.title = chalk.dim(`${event.stepName} (skipped)`);
+                    },
+                });
+                addTask({
+                    title: chalk.white(event.stepName),
+                    task: async (_ctx, task) => {
+                        taskRef = task;
+                        if (skipped)
+                            taskRef.title = chalk.dim(`${event.stepName} (skipped)`);
+                        await done;
+                    },
+                    rendererOptions: { persistentOutput: true },
+                });
+                break;
+            }
+            case 'step:owner-assigned': {
+                const handle = stepHandles.get(event.stepName);
+                if (handle) {
+                    handle.setOutput(chalk.dim(`> Owner: ${event.ownerName}`) +
+                        (event.specialistName ? chalk.dim(` · specialist: ${event.specialistName}`) : ''));
+                }
+                break;
+            }
+            case 'step:retrying': {
+                stepHandles.get(event.stepName)?.setOutput(chalk.yellow(`Retrying (attempt ${event.attempt})`));
+                break;
+            }
+            case 'step:nudged': {
+                stepHandles.get(event.stepName)?.setOutput(chalk.dim(`> Nudge #${event.nudgeCount}`));
+                break;
+            }
+            case 'step:force-released': {
+                stepHandles.get(event.stepName)?.setOutput(chalk.yellow('> Force-released'));
+                break;
+            }
+            case 'step:review-completed': {
+                stepHandles
+                    .get(event.stepName)
+                    ?.setOutput(chalk.dim(`> Review: ${event.decision} by ${event.reviewerName}`));
+                break;
+            }
+            case 'step:owner-timeout': {
+                stepHandles.get(event.stepName)?.setOutput(chalk.red(`> Owner ${event.ownerName} timed out`));
+                break;
+            }
+            case 'step:agent-report': {
+                const handle = stepHandles.get(event.stepName);
+                if (handle) {
+                    const model = event.report.model ? `:${event.report.model}` : '';
+                    handle.setOutput(chalk.dim(`> Report collected (${event.report.cli}${model})`));
+                }
+                break;
+            }
+            case 'step:completed': {
+                stepHandles.get(event.stepName)?.resolve();
+                break;
+            }
+            case 'step:skipped': {
+                const handle = stepHandles.get(event.stepName);
+                if (handle) {
+                    handle.markSkipped();
+                    handle.resolve();
+                }
+                else {
+                    // Step was skipped without ever being started (downstream of a failure).
+                    addTask({
+                        title: chalk.dim(`${event.stepName} (skipped)`),
+                        task: async () => { },
+                        rendererOptions: { persistentOutput: true },
+                    });
+                }
+                break;
+            }
+            case 'step:failed': {
+                stepHandles.get(event.stepName)?.reject(new Error(event.error ?? 'Step failed'));
+                break;
+            }
+            case 'run:completed': {
+                setHeader(chalk.green('Workflow completed'));
+                resolveWorkflow();
+                break;
+            }
+            case 'run:failed': {
+                setHeader(chalk.red(`Workflow failed: ${event.error ?? 'unknown error'}`));
+                rejectWorkflow(new Error(event.error ?? 'Workflow failed'));
+                break;
+            }
+            case 'run:cancelled': {
+                setHeader(chalk.yellow('Workflow cancelled'));
+                resolveWorkflow();
+                break;
+            }
+            case 'broker:event':
+                break;
+            default: {
+                const _exhaustive = event;
+                void _exhaustive;
+            }
+        }
+    };
+    let restoreConsole;
+    return {
+        onEvent,
+        start: async () => {
+            restoreConsole = installOutputFilter();
+            const l = await ensureListr();
+            return l.run().catch(() => {
+                // Step failures are already represented in the workflow result.
+            });
+        },
+        unmount: () => {
+            restoreConsole?.();
+            restoreConsole = undefined;
+        },
+    };
+}
+//# sourceMappingURL=listr-renderer.js.map

package/dist/listr-renderer.js.map

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

package/dist/memory-db.d.ts

@@ -0,0 +1,17 @@
+import type { WorkflowRunRow, WorkflowStepRow } from './types.js';
+import type { WorkflowDb } from './runner.js';
+/**
+ * In-memory implementation of WorkflowDb for local workflow runs.
+ * No persistence — state lives only for the duration of the process.
+ */
+export declare class InMemoryWorkflowDb implements WorkflowDb {
+    private runs;
+    private steps;
+    insertRun(run: WorkflowRunRow): Promise<void>;
+    updateRun(id: string, patch: Partial<WorkflowRunRow>): Promise<void>;
+    getRun(id: string): Promise<WorkflowRunRow | null>;
+    insertStep(step: WorkflowStepRow): Promise<void>;
+    updateStep(id: string, patch: Partial<WorkflowStepRow>): Promise<void>;
+    getStepsByRunId(runId: string): Promise<WorkflowStepRow[]>;
+}
+//# sourceMappingURL=memory-db.d.ts.map

package/dist/memory-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-db.d.ts","sourceRoot":"","sources":["../src/memory-db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;;GAGG;AACH,qBAAa,kBAAmB,YAAW,UAAU;IACnD,OAAO,CAAC,IAAI,CAAqC;IACjD,OAAO,CAAC,KAAK,CAAsC;IAE7C,SAAS,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAIlD,UAAU,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtE,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;CAGjE"}