@relayflows/core 0.0.1 → 1.0.0

package/dist/validator.js

@@ -0,0 +1,186 @@
+import { CodexModels } from '@agent-relay/config';
+const CHANNEL_NAME_RE = /^[a-z0-9][a-z0-9-]*$/;
+export function validateWorkflow(config) {
+    const issues = [];
+    // Validate channel name format (must be lowercase alphanumeric + hyphens)
+    const channel = config.swarm?.channel ?? config.channel;
+    if (channel && !CHANNEL_NAME_RE.test(channel)) {
+        issues.push({
+            severity: 'error',
+            code: 'INVALID_CHANNEL_NAME',
+            message: `Channel name "${channel}" is invalid. Must be lowercase alphanumeric and hyphens, starting with a letter or number.`,
+            fix: `Use .toLowerCase().replace(/[^a-z0-9-]/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '') on the channel name.`,
+            location: 'swarm:channel',
+        });
+    }
+    const agentMap = new Map(config.agents.map((a) => [a.name, a]));
+    const hasReviewerAgent = config.agents.some((a) => {
+        const role = a.role?.toLowerCase() ?? '';
+        const name = a.name.toLowerCase();
+        return (a.preset === 'reviewer' ||
+            role.includes('review') ||
+            role.includes('critic') ||
+            role.includes('verifier') ||
+            role.includes('qa') ||
+            name.includes('review'));
+    });
+    for (const workflow of config.workflows ?? []) {
+        const hasInteractiveAgentSteps = workflow.steps.some((step) => {
+            if (step.type === 'deterministic' || step.type === 'worktree')
+                return false;
+            if (!step.agent)
+                return false;
+            const raw = agentMap.get(step.agent);
+            if (!raw)
+                return false;
+            return resolveForValidation(raw).interactive !== false;
+        });
+        if (hasInteractiveAgentSteps && !hasReviewerAgent) {
+            issues.push({
+                severity: 'warning',
+                code: 'NO_REVIEW_AGENT',
+                message: `Workflow "${workflow.name}" has interactive agent steps but no obvious reviewer agent. The runner can auto-fallback, but dedicated reviewers improve step hardening.`,
+                fix: `Add an agent with role/preset like \`reviewer\`, \`critic\`, or \`verifier\`.`,
+                location: `workflow:${workflow.name}`,
+            });
+        }
+        for (const step of workflow.steps ?? []) {
+            if (step.type === 'deterministic' || step.type === 'worktree')
+                continue;
+            if (!step.agent)
+                continue;
+            const rawDef = agentMap.get(step.agent);
+            if (!rawDef) {
+                issues.push({
+                    severity: 'error',
+                    code: 'UNKNOWN_AGENT',
+                    message: `Step "${step.name}" references unknown agent "${step.agent}"`,
+                    location: `step:${step.name}`,
+                });
+                continue;
+            }
+            // Resolve preset
+            const def = resolveForValidation(rawDef);
+            const task = step.task ?? '';
+            // Check 1: step chaining on interactive agent
+            if (def.interactive !== false && /\{\{steps\.[^}]+\}\}/.test(task)) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'CHAIN_ON_INTERACTIVE',
+                    message: `Step "${step.name}" uses {{steps.X.output}} but agent "${step.agent}" is interactive. PTY output includes TUI chrome — step chaining will receive raw terminal output.`,
+                    fix: `Add \`interactive: false\` to agent "${step.agent}", or use \`preset: worker\` / \`preset: reviewer\`.`,
+                    location: `step:${step.name}`,
+                });
+            }
+            // Check 2: interactive codex missing /exit in task
+            if (def.interactive !== false && def.cli === 'codex' && !task.includes('/exit')) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'CODEX_NO_EXIT',
+                    message: `Step "${step.name}" uses interactive codex but the task has no /exit instruction. Interactive codex may hang indefinitely.`,
+                    fix: `End the task with an explicit /exit example:\n  When done, output:\n  TASK_COMPLETE\n  /exit`,
+                    location: `step:${step.name}`,
+                });
+            }
+            // Check 3: interactive agent with no sub-agent guardrail on complex tasks
+            if (def.interactive !== false &&
+                def.cli === 'claude' &&
+                task.length > 500 &&
+                !task.includes('do not') &&
+                !task.includes('Do NOT') &&
+                !task.includes('mcp__relaycast__add_agent') &&
+                !task.includes('add_agent')) {
+                issues.push({
+                    severity: 'info',
+                    code: 'CLAUDE_NO_SPAWN_GUARD',
+                    message: `Step "${step.name}" uses interactive claude with a long task. Claude may spontaneously spawn sub-agents via relay MCP tools.`,
+                    fix: `Add "Do NOT use mcp__relaycast__add_agent or add_agent to spawn sub-agents." to the task, or use \`interactive: false\`.`,
+                    location: `step:${step.name}`,
+                });
+            }
+            // Check 4: codex-spark cannot be used in non-interactive mode
+            const CODEX_SPARK_MODELS = [CodexModels.GPT_5_3_CODEX_SPARK];
+            if (def.interactive === false &&
+                def.cli === 'codex' &&
+                def.constraints?.model &&
+                (CODEX_SPARK_MODELS.includes(def.constraints.model) || /codex-spark/i.test(def.constraints.model))) {
+                issues.push({
+                    severity: 'error',
+                    code: 'CODEX_SPARK_NON_INTERACTIVE',
+                    message: `Agent "${step.agent}" uses codex-spark model in non-interactive mode. Codex Spark does not support non-interactive (headless) execution.`,
+                    fix: `Switch to a different model (e.g. gpt-5.3-codex) or set the agent to interactive mode.`,
+                    location: `step:${step.name}`,
+                });
+            }
+            // Check 5: non-interactive agent that references relay messaging tools in task
+            if (def.interactive === false &&
+                (task.includes('mcp__relaycast__send_dm') ||
+                    task.includes('mcp__relaycast__post_message') ||
+                    task.includes('mcp__relaycast__check_inbox'))) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'NONINTERACTIVE_RELAY',
+                    message: `Step "${step.name}" has \`interactive: false\` but the task mentions relay tools. Non-interactive agents cannot use relay MCP tools.`,
+                    fix: `Remove relay tool calls from the task, or set the agent to interactive.`,
+                    location: `step:${step.name}`,
+                });
+            }
+        }
+        // Check 6: maxConcurrency vs interactive agent count
+        const interactiveSteps = (workflow.steps ?? []).filter((s) => {
+            if (s.type === 'deterministic')
+                return false;
+            const def = agentMap.get(s.agent ?? '');
+            return def && resolveForValidation(def).interactive !== false;
+        });
+        const maxConc = config.swarm.maxConcurrency ?? 10;
+        if (interactiveSteps.length > 4 && maxConc > 4) {
+            issues.push({
+                severity: 'warning',
+                code: 'HIGH_CONCURRENCY',
+                message: `Workflow "${workflow.name}" has ${interactiveSteps.length} interactive steps with maxConcurrency: ${maxConc}. Spawning many interactive PTY agents simultaneously can saturate the broker and cause spawn timeouts.`,
+                fix: `Set \`maxConcurrency: 3\` or lower, or convert implementation agents to \`interactive: false\`.`,
+                location: `workflow:${workflow.name}`,
+            });
+        }
+    }
+    return issues;
+}
+function resolveForValidation(def) {
+    if (!def.preset)
+        return def;
+    const nonInteractive = ['worker', 'reviewer', 'analyst'];
+    if (nonInteractive.includes(def.preset) && def.interactive === undefined) {
+        return { ...def, interactive: false };
+    }
+    return def;
+}
+export function formatValidationReport(issues, yamlPath) {
+    const errors = issues.filter((i) => i.severity === 'error');
+    const warnings = issues.filter((i) => i.severity === 'warning');
+    const infos = issues.filter((i) => i.severity === 'info');
+    const lines = [`Validating ${yamlPath}...`, ''];
+    if (issues.length === 0) {
+        lines.push('No issues found');
+        return lines.join('\n');
+    }
+    const icon = { error: 'ERROR', warning: 'WARN', info: 'INFO' };
+    for (const issue of issues) {
+        const loc = issue.location ? ` [${issue.location}]` : '';
+        lines.push(`${icon[issue.severity]} ${issue.message}${loc}`);
+        if (issue.fix) {
+            lines.push(`  -> ${issue.fix}`);
+        }
+        lines.push('');
+    }
+    const summary = [];
+    if (errors.length)
+        summary.push(`${errors.length} error${errors.length > 1 ? 's' : ''}`);
+    if (warnings.length)
+        summary.push(`${warnings.length} warning${warnings.length > 1 ? 's' : ''}`);
+    if (infos.length)
+        summary.push(`${infos.length} info`);
+    lines.push(summary.join(', '));
+    return lines.join('\n');
+}
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

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

package/dist/verification.d.ts

@@ -0,0 +1,53 @@
+import type { CompletionEvidenceSignal, CompletionEvidenceToolSideEffect, VerificationCheck, WorkflowStepCompletionReason } from './types.js';
+export type { VerificationCheck } from './types.js';
+export interface VerificationResult {
+    passed: boolean;
+    completionReason?: WorkflowStepCompletionReason;
+    error?: string;
+}
+export interface VerificationOptions {
+    allowFailure?: boolean;
+    completionMarkerFound?: boolean;
+    cwd?: string;
+}
+export declare class WorkflowCompletionError extends Error {
+    completionReason?: WorkflowStepCompletionReason;
+    constructor(message: string, completionReason?: WorkflowStepCompletionReason);
+}
+export interface VerificationSideEffects {
+    recordStepToolSideEffect?: (stepName: string, effect: Omit<CompletionEvidenceToolSideEffect, 'observedAt'> & {
+        observedAt?: string;
+    }) => void;
+    getOrCreateStepEvidenceRecord?: (stepName: string) => {
+        evidence: {
+            coordinationSignals: CompletionEvidenceSignal[];
+        };
+    };
+    log?: (message: string) => void;
+}
+export declare function runVerification(check: VerificationCheck, output: string, stepName: string, injectedTaskText?: string, options?: VerificationOptions, sideEffects?: VerificationSideEffects): VerificationResult;
+export declare function stripInjectedTaskEcho(output: string, injectedTaskText?: string): string;
+export declare function checkExitCode(_expectedExitCode: string): boolean;
+export declare function checkOutputContains(output: string, token: string, injectedTaskText?: string): boolean;
+/**
+ * Returns the first GitHub PR URL found in {@link output}. When
+ * {@link repoQualifier} is non-empty (format: `<owner>/<repo>`, case
+ * insensitive), only URLs belonging to that repository are accepted.
+ *
+ * Use via `verification: { type: 'pr_url', value: 'owner/repo' }` to require
+ * a step to publish a pull request before completing. The check exists so
+ * workflow runners can refuse `OWNER_DECISION: COMPLETE` from workers that
+ * shipped code locally but never opened a PR.
+ */
+export declare function findPrUrl(output: string, repoQualifier?: string, injectedTaskText?: string): string | null;
+export declare function execCustomVerification(command: string, cwd: string, timeoutMs?: number): {
+    passed: boolean;
+    output: string;
+};
+export declare function checkCustom(value: string, output: string, cwd?: string): {
+    passed: boolean;
+    stdout?: string;
+    error?: string;
+};
+export declare function checkFileExists(filePath: string, cwd?: string): boolean;
+//# sourceMappingURL=verification.d.ts.map

package/dist/verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verification.d.ts","sourceRoot":"","sources":["../src/verification.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,wBAAwB,EACxB,gCAAgC,EAChC,iBAAiB,EACjB,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;gBAEpC,OAAO,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,4BAA4B;CAK7E;AAED,MAAM,WAAW,uBAAuB;IACtC,wBAAwB,CAAC,EAAE,CACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,IAAI,CAAC,gCAAgC,EAAE,YAAY,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,KACnF,IAAI,CAAC;IACV,6BAA6B,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK;QACpD,QAAQ,EAAE;YAAE,mBAAmB,EAAE,wBAAwB,EAAE,CAAA;SAAE,CAAC;KAC/D,CAAC;IACF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,iBAAiB,EACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,MAAM,EACzB,OAAO,GAAE,mBAAwB,EACjC,WAAW,GAAE,uBAA4B,GACxC,kBAAkB,CAoHpB;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAmBvF;AAED,wBAAgB,aAAa,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAIhE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,CAKrG;AAID;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgB1G;AAMD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,SAAS,SAAmC,GAC3C;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA6BrC;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,GAAG,SAAgB,GAClB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA6BtD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAgB,GAAG,OAAO,CAc9E"}

package/dist/verification.js

@@ -0,0 +1,238 @@
+import { execSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+export class WorkflowCompletionError extends Error {
+    completionReason;
+    constructor(message, completionReason) {
+        super(message);
+        this.name = 'WorkflowCompletionError';
+        this.completionReason = completionReason;
+    }
+}
+export function runVerification(check, output, stepName, injectedTaskText, options = {}, sideEffects = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const fail = (message) => {
+        const observedAt = new Date().toISOString();
+        sideEffects.recordStepToolSideEffect?.(stepName, {
+            type: 'verification_observed',
+            detail: message,
+            observedAt,
+            raw: { passed: false, type: check.type, value: check.value },
+        });
+        sideEffects.getOrCreateStepEvidenceRecord?.(stepName).evidence.coordinationSignals.push({
+            kind: 'verification_failed',
+            source: 'verification',
+            text: message,
+            observedAt,
+            value: check.value,
+        });
+        if (options.allowFailure) {
+            return {
+                passed: false,
+                completionReason: 'failed_verification',
+                error: message,
+            };
+        }
+        throw new WorkflowCompletionError(message, 'failed_verification');
+    };
+    switch (check.type) {
+        case 'output_contains': {
+            const token = check.value;
+            if (!checkOutputContains(output, token, injectedTaskText)) {
+                return fail(`Verification failed for "${stepName}": output does not contain "${token}"`);
+            }
+            break;
+        }
+        case 'exit_code':
+            if (!checkExitCode(check.value)) {
+                return fail(`Verification failed for "${stepName}": exit code did not match "${check.value}"`);
+            }
+            break;
+        case 'file_exists':
+            if (!checkFileExists(check.value, cwd)) {
+                return fail(`Verification failed for "${stepName}": file "${check.value}" does not exist`);
+            }
+            break;
+        case 'custom': {
+            if (check.value) {
+                const result = execCustomVerification(check.value, cwd, check.timeoutMs);
+                if (!result.passed) {
+                    return fail('Verification failed for "' +
+                        stepName +
+                        '": custom check "' +
+                        check.value +
+                        '" failed\n' +
+                        result.output);
+                }
+            }
+            else {
+                // No command provided — preserved legacy no-op behavior
+                return { passed: false };
+            }
+            break;
+        }
+        case 'pr_url': {
+            const found = findPrUrl(output, check.value, injectedTaskText);
+            if (!found) {
+                const repoQualifier = check.value ? ` for repository "${check.value}"` : '';
+                return fail(`Verification failed for "${stepName}": step output does not contain a GitHub PR URL${repoQualifier}. ` +
+                    `Workers must open a pull request and include the URL in their output before reporting completion.`);
+            }
+            break;
+        }
+        default:
+            break;
+    }
+    if (options.completionMarkerFound === false) {
+        sideEffects.log?.(`[${stepName}] Verification passed without legacy STEP_COMPLETE marker; allowing completion`);
+    }
+    const observedAt = new Date().toISOString();
+    const successMessage = options.completionMarkerFound === false
+        ? 'Verification passed without legacy STEP_COMPLETE marker'
+        : 'Verification passed';
+    sideEffects.recordStepToolSideEffect?.(stepName, {
+        type: 'verification_observed',
+        detail: successMessage,
+        observedAt,
+        raw: { passed: true, type: check.type, value: check.value },
+    });
+    sideEffects.getOrCreateStepEvidenceRecord?.(stepName).evidence.coordinationSignals.push({
+        kind: 'verification_passed',
+        source: 'verification',
+        text: successMessage,
+        observedAt,
+        value: check.value,
+    });
+    return {
+        passed: true,
+        completionReason: 'completed_verified',
+    };
+}
+export function stripInjectedTaskEcho(output, injectedTaskText) {
+    if (!injectedTaskText) {
+        return output;
+    }
+    const candidates = [
+        injectedTaskText,
+        injectedTaskText.replace(/\r\n/g, '\n'),
+        injectedTaskText.replace(/\n/g, '\r\n'),
+    ].filter((candidate, index, all) => candidate.length > 0 && all.indexOf(candidate) === index);
+    for (const candidate of candidates) {
+        const start = output.indexOf(candidate);
+        if (start !== -1) {
+            return output.slice(0, start) + output.slice(start + candidate.length);
+        }
+    }
+    return output;
+}
+export function checkExitCode(_expectedExitCode) {
+    // Existing runner semantics treat process success as established before this
+    // verification hook runs, so this check is currently an unconditional pass.
+    return true;
+}
+export function checkOutputContains(output, token, injectedTaskText) {
+    if (!token) {
+        return false;
+    }
+    return stripInjectedTaskEcho(output, injectedTaskText).includes(token);
+}
+const PR_URL_PATTERN = /https?:\/\/github\.com\/([\w.-]+)\/([\w.-]+)\/pull\/(\d+)\b/gi;
+/**
+ * Returns the first GitHub PR URL found in {@link output}. When
+ * {@link repoQualifier} is non-empty (format: `<owner>/<repo>`, case
+ * insensitive), only URLs belonging to that repository are accepted.
+ *
+ * Use via `verification: { type: 'pr_url', value: 'owner/repo' }` to require
+ * a step to publish a pull request before completing. The check exists so
+ * workflow runners can refuse `OWNER_DECISION: COMPLETE` from workers that
+ * shipped code locally but never opened a PR.
+ */
+export function findPrUrl(output, repoQualifier, injectedTaskText) {
+    const sanitized = stripInjectedTaskEcho(output, injectedTaskText);
+    const qualifier = repoQualifier?.trim().toLowerCase();
+    PR_URL_PATTERN.lastIndex = 0;
+    let match;
+    while ((match = PR_URL_PATTERN.exec(sanitized))) {
+        if (!qualifier) {
+            return match[0];
+        }
+        const owner = match[1]?.toLowerCase();
+        const repo = match[2]?.toLowerCase();
+        if (`${owner}/${repo}` === qualifier) {
+            return match[0];
+        }
+    }
+    return null;
+}
+const DEFAULT_CUSTOM_VERIFY_TIMEOUT_MS = parseInt(process.env.CUSTOM_VERIFY_TIMEOUT_MS ?? '30000', 10);
+const REGEX_PREFIX = 'regex:';
+export function execCustomVerification(command, cwd, timeoutMs = DEFAULT_CUSTOM_VERIFY_TIMEOUT_MS) {
+    try {
+        const stdout = execSync(command, {
+            cwd,
+            timeout: timeoutMs,
+            killSignal: 'SIGKILL',
+            stdio: ['ignore', 'pipe', 'pipe'],
+            encoding: 'utf-8',
+        });
+        return { passed: true, output: stdout.trim() };
+    }
+    catch (error) {
+        const execError = error;
+        const stdout = typeof execError.stdout === 'string' ? execError.stdout : (execError.stdout?.toString('utf-8') ?? '');
+        const stderr = typeof execError.stderr === 'string' ? execError.stderr : (execError.stderr?.toString('utf-8') ?? '');
+        const combinedOutput = [stdout, stderr]
+            .filter((chunk) => chunk.length > 0)
+            .join('\n')
+            .trim();
+        const truncated = combinedOutput.length > 2000 ? combinedOutput.slice(-2000) : combinedOutput;
+        return {
+            passed: false,
+            output: truncated || execError.message,
+        };
+    }
+}
+export function checkCustom(value, output, cwd = process.cwd()) {
+    // Regex shorthand: "regex:<pattern>"
+    if (value.startsWith(REGEX_PREFIX)) {
+        const pattern = value.slice(REGEX_PREFIX.length);
+        try {
+            const re = new RegExp(pattern);
+            const matched = re.test(output);
+            return matched
+                ? { passed: true }
+                : { passed: false, error: `output did not match pattern /${pattern}/` };
+        }
+        catch (err) {
+            return { passed: false, error: `invalid regex: ${err.message}` };
+        }
+    }
+    // Shell command: execute value with STEP_OUTPUT env var
+    try {
+        const result = execSync(value, {
+            cwd,
+            env: { ...process.env, STEP_OUTPUT: output },
+            timeout: DEFAULT_CUSTOM_VERIFY_TIMEOUT_MS,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            maxBuffer: 1024 * 1024,
+        });
+        return { passed: true, stdout: result.toString('utf-8').trim() };
+    }
+    catch (err) {
+        const message = err?.stderr?.toString('utf-8')?.trim() || err.message;
+        return { passed: false, error: message };
+    }
+}
+export function checkFileExists(filePath, cwd = process.cwd()) {
+    const normalizedCwd = path.resolve(cwd);
+    const resolved = path.isAbsolute(filePath) ? path.resolve(filePath) : path.resolve(normalizedCwd, filePath);
+    // Relative artifact paths stay scoped to the workflow cwd; absolute paths
+    // are already explicit and are allowed for temp/output artifacts.
+    if (!path.isAbsolute(filePath) &&
+        !resolved.startsWith(normalizedCwd + path.sep) &&
+        resolved !== normalizedCwd) {
+        return false;
+    }
+    return existsSync(resolved);
+}
+//# sourceMappingURL=verification.js.map

package/dist/verification.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@relayflows/core",
-  "version": "0.0.1",
-  "description": "Workflow engine and types for Agent Relay workflows (npm namespace placeholder — real release ships as 0.1.0+).",
+  "version": "1.0.0",
+  "description": "Workflow engine and types for Agent Relay workflows",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -52,18 +52,22 @@
     "directory": "packages/core"
   },
   "dependencies": {
-    "@agent-relay/browser-primitive": "^7.1.1",
-    "@agent-relay/cloud": "^7.1.1",
-    "@agent-relay/config": "^7.1.1",
-    "@agent-relay/github-primitive": "^7.1.1",
-    "@agent-relay/sdk": "^7.1.1",
-    "@agent-relay/slack-primitive": "^7.1.1",
+    "@agent-relay/cloud": "^8.2.0",
+    "@agent-relay/config": "^8.2.0",
+    "@agent-relay/harness-driver": "^8.2.0",
+    "@agent-relay/harnesses": "^8.2.0",
+    "@agent-relay/sdk": "^8.2.0",
     "@relaycast/sdk": "^1.1.0",
+    "@relayfile/sdk": "^0.8.0",
+    "@relayflows/browser-primitive": "1.0.0",
+    "@relayflows/github-primitive": "1.0.0",
+    "@relayflows/slack-primitive": "1.0.0",
     "@sinclair/typebox": "^0.34.48",
     "agent-trajectories": "^0.6.0",
     "chalk": "^4.1.2",
     "ignore": "^7.0.5",
     "listr2": "^10.2.1",
+    "strip-ansi": "^7.2.0",
     "yaml": "^2.7.0",
     "zod": "^3.23.8"
   },