agent-relay 2.3.13 → 2.4.0

package/packages/broker-sdk/dist/workflows/trajectory.js

@@ -1,362 +0,0 @@
-/**
- * WorkflowTrajectory — records a structured trajectory for each workflow run.
- *
- * Writes trajectory JSON files directly to `.trajectories/active/` in a format
- * compatible with `trail show`. No external CLI or package dependency required.
- *
- * Design principles:
- *   1. One trajectory per workflow run
- *   2. Chapters map to workflow phases, not individual steps
- *   3. Non-blocking — trajectory recording never fails the workflow
- *   4. Opt-in but default-on
- */
-import { randomBytes } from 'node:crypto';
-import { existsSync } from 'node:fs';
-import { mkdir, writeFile, rename } from 'node:fs/promises';
-import path from 'node:path';
-// ── WorkflowTrajectory ──────────────────────────────────────────────────────
-export class WorkflowTrajectory {
-    trajectory = null;
-    currentChapterId = null;
-    enabled;
-    reflectOnBarriers;
-    reflectOnConverge;
-    autoDecisions;
-    dataDir;
-    runId;
-    startTime = 0;
-    constructor(config, runId, cwd) {
-        const cfg = config === false ? { enabled: false } : (config ?? {});
-        this.enabled = cfg.enabled !== false;
-        this.reflectOnBarriers = cfg.reflectOnBarriers !== false;
-        this.reflectOnConverge = cfg.reflectOnConverge !== false;
-        this.autoDecisions = cfg.autoDecisions !== false;
-        this.runId = runId;
-        this.dataDir = process.env.TRAJECTORIES_DATA_DIR
-            ?? path.join(cwd, '.trajectories');
-    }
-    // ── Lifecycle ──────────────────────────────────────────────────────────────
-    /** Start the trajectory (called at run:started). */
-    async start(workflowName, stepCount, trackInfo) {
-        if (!this.enabled)
-            return;
-        this.startTime = Date.now();
-        const id = `traj_${Date.now()}_${randomBytes(4).toString('hex')}`;
-        this.trajectory = {
-            id,
-            version: 1,
-            task: {
-                title: `${workflowName} run #${this.runId.slice(0, 8)}`,
-                source: { system: 'workflow-runner', id: this.runId },
-            },
-            status: 'active',
-            startedAt: new Date().toISOString(),
-            agents: [{ name: 'orchestrator', role: 'workflow-runner', joinedAt: new Date().toISOString() }],
-            chapters: [],
-        };
-        // Open Planning chapter
-        this.openChapter('Planning', 'orchestrator');
-        this.addEvent('note', `Workflow "${workflowName}" started with ${stepCount} steps`);
-        if (trackInfo) {
-            this.addEvent('note', trackInfo);
-        }
-        await this.flush();
-    }
-    // ── Chapters ───────────────────────────────────────────────────────────────
-    /** Begin a new parallel track chapter. */
-    async beginTrack(trackName) {
-        if (!this.enabled || !this.trajectory)
-            return;
-        this.closeCurrentChapter();
-        this.openChapter(`Execution: ${trackName}`, 'orchestrator');
-        await this.flush();
-    }
-    /** Begin a convergence chapter (after barrier/parallel completion). */
-    async beginConvergence(label) {
-        if (!this.enabled || !this.trajectory)
-            return;
-        this.closeCurrentChapter();
-        this.openChapter(`Convergence: ${label}`, 'orchestrator');
-        await this.flush();
-    }
-    /** Begin the retrospective chapter. */
-    openRetrospective() {
-        if (!this.trajectory)
-            return;
-        this.closeCurrentChapter();
-        this.openChapter('Retrospective', 'orchestrator');
-    }
-    // ── Step events ────────────────────────────────────────────────────────────
-    /** Record step started. */
-    async stepStarted(step, agent) {
-        if (!this.enabled || !this.trajectory)
-            return;
-        // Register agent if not seen
-        if (!this.trajectory.agents.some((a) => a.name === agent)) {
-            this.trajectory.agents.push({
-                name: agent,
-                role: step.agent,
-                joinedAt: new Date().toISOString(),
-            });
-        }
-        this.addEvent('note', `Step "${step.name}" assigned to agent "${agent}"`);
-        await this.flush();
-    }
-    /** Record step completed with output summary. */
-    async stepCompleted(step, output, attempt) {
-        if (!this.enabled || !this.trajectory)
-            return;
-        const suffix = attempt > 1 ? ` (attempt ${attempt})` : '';
-        const summary = output.length > 200 ? output.slice(0, 200) + '...' : output;
-        this.addEvent('finding', `Step "${step.name}" completed${suffix}: ${summary}`, 'medium');
-        await this.flush();
-    }
-    /** Record step failed. */
-    async stepFailed(step, error, attempt, maxRetries) {
-        if (!this.enabled || !this.trajectory)
-            return;
-        this.addEvent('error', `Step "${step.name}" failed (attempt ${attempt}/${maxRetries + 1}): ${error}`, 'high');
-        await this.flush();
-    }
-    /** Record step skipped. */
-    async stepSkipped(step, reason) {
-        if (!this.enabled || !this.trajectory)
-            return;
-        this.addEvent('note', `Skipped step "${step.name}": ${reason}`);
-        await this.flush();
-    }
-    /** Record step retrying. */
-    async stepRetrying(step, attempt, maxRetries) {
-        if (!this.enabled || !this.trajectory)
-            return;
-        this.addEvent('note', `Retrying step "${step.name}" (attempt ${attempt}/${maxRetries + 1})`);
-        await this.flush();
-    }
-    // ── Reflections ────────────────────────────────────────────────────────────
-    /** Record a reflection at a convergence point. */
-    async reflect(synthesis, confidence, focalPoints) {
-        if (!this.enabled || !this.trajectory)
-            return;
-        const raw = { confidence };
-        if (focalPoints?.length) {
-            raw.focalPoints = focalPoints;
-        }
-        this.addEvent('reflection', synthesis, 'high', raw);
-        await this.flush();
-    }
-    /** Synthesize and reflect after a set of steps complete (barrier or parallel convergence). */
-    async synthesizeAndReflect(label, outcomes, unblocks) {
-        if (!this.enabled || !this.trajectory)
-            return;
-        const synthesis = this.buildSynthesis(label, outcomes, unblocks);
-        const confidence = this.computeConfidence(outcomes);
-        const focalPoints = outcomes.map((o) => `${o.name}: ${o.status}`);
-        await this.beginConvergence(label);
-        await this.reflect(synthesis, confidence, focalPoints);
-    }
-    // ── Decisions ──────────────────────────────────────────────────────────────
-    /** Record an orchestrator decision. */
-    async decide(question, chosen, reasoning) {
-        if (!this.enabled || !this.trajectory || !this.autoDecisions)
-            return;
-        this.addEvent('decision', `${question} → ${chosen}: ${reasoning}`, 'medium', {
-            question,
-            chosen,
-            reasoning,
-        });
-        await this.flush();
-    }
-    // ── Completion ─────────────────────────────────────────────────────────────
-    /** Complete the trajectory with a summary. */
-    async complete(summary, confidence, meta) {
-        if (!this.enabled || !this.trajectory)
-            return;
-        this.openRetrospective();
-        const elapsed = Date.now() - this.startTime;
-        const elapsedStr = elapsed > 60_000
-            ? `${Math.round(elapsed / 60_000)} minutes`
-            : `${Math.round(elapsed / 1_000)} seconds`;
-        this.addEvent('reflection', `${summary} (completed in ${elapsedStr})`, 'high');
-        this.trajectory.status = 'completed';
-        this.trajectory.completedAt = new Date().toISOString();
-        this.trajectory.retrospective = {
-            summary,
-            approach: 'workflow-runner DAG execution',
-            confidence,
-            learnings: meta?.learnings,
-            challenges: meta?.challenges,
-        };
-        this.closeCurrentChapter();
-        await this.flush();
-        await this.moveToCompleted();
-    }
-    /** Abandon the trajectory. */
-    async abandon(reason) {
-        if (!this.enabled || !this.trajectory)
-            return;
-        this.addEvent('error', `Workflow abandoned: ${reason}`, 'high');
-        this.trajectory.status = 'abandoned';
-        this.trajectory.completedAt = new Date().toISOString();
-        this.closeCurrentChapter();
-        await this.flush();
-        await this.moveToCompleted();
-    }
-    // ── Getters ────────────────────────────────────────────────────────────────
-    isEnabled() {
-        return this.enabled;
-    }
-    shouldReflectOnConverge() {
-        return this.enabled && this.reflectOnConverge;
-    }
-    shouldReflectOnBarriers() {
-        return this.enabled && this.reflectOnBarriers;
-    }
-    getTrajectoryId() {
-        return this.trajectory?.id ?? null;
-    }
-    // ── Synthesis helpers ──────────────────────────────────────────────────────
-    buildSynthesis(label, outcomes, unblocks) {
-        const completed = outcomes.filter((o) => o.status === 'completed');
-        const failed = outcomes.filter((o) => o.status === 'failed');
-        const retried = outcomes.filter((o) => o.attempts > 1 && o.status !== 'failed');
-        const parts = [
-            `${label} resolved.`,
-            `${completed.length}/${outcomes.length} steps completed.`,
-        ];
-        if (failed.length > 0) {
-            parts.push(`${failed.length} step(s) failed: ${failed.map((s) => s.name).join(', ')}.`);
-        }
-        if (retried.length > 0) {
-            parts.push(`${retried.length} step(s) required retries: ${retried.map((s) => s.name).join(', ')}.`);
-        }
-        else if (failed.length === 0) {
-            parts.push('All steps completed on first attempt.');
-        }
-        if (unblocks?.length) {
-            parts.push(`Unblocking: ${unblocks.join(', ')}.`);
-        }
-        return parts.join(' ');
-    }
-    computeConfidence(outcomes) {
-        if (outcomes.length === 0)
-            return 0.7;
-        const total = outcomes.length;
-        const completed = outcomes.filter((o) => o.status === 'completed').length;
-        const firstAttempt = outcomes.filter((o) => o.attempts === 1 && o.status === 'completed').length;
-        const verified = outcomes.filter((o) => o.verificationPassed).length;
-        // Base: 0.5 scaled by completion rate, +0.25 for first-attempt, +0.25 for verified
-        const completionRate = completed / total;
-        return Math.min(1.0, 0.5 * completionRate +
-            (firstAttempt / total) * 0.25 +
-            (verified / total) * 0.25);
-    }
-    buildRunSummary(outcomes) {
-        const completed = outcomes.filter((o) => o.status === 'completed').length;
-        const failed = outcomes.filter((o) => o.status === 'failed').length;
-        const skipped = outcomes.filter((o) => o.status === 'skipped').length;
-        const totalRetries = outcomes.reduce((sum, o) => sum + Math.max(0, o.attempts - 1), 0);
-        const elapsed = Date.now() - this.startTime;
-        const elapsedStr = elapsed > 60_000
-            ? `${Math.round(elapsed / 60_000)} minutes`
-            : `${Math.round(elapsed / 1_000)} seconds`;
-        const parts = [`Workflow completed in ${elapsedStr}.`];
-        parts.push(`${completed}/${outcomes.length} steps passed.`);
-        if (failed > 0)
-            parts.push(`${failed} failed.`);
-        if (skipped > 0)
-            parts.push(`${skipped} skipped.`);
-        if (totalRetries > 0)
-            parts.push(`${totalRetries} total retries.`);
-        return parts.join(' ');
-    }
-    extractLearnings(outcomes) {
-        const learnings = [];
-        const retried = outcomes.filter((o) => o.attempts > 1 && o.status === 'completed');
-        if (retried.length > 0) {
-            learnings.push(`Steps requiring retries: ${retried.map((o) => `${o.name} (${o.attempts} attempts)`).join(', ')}`);
-        }
-        return learnings;
-    }
-    extractChallenges(outcomes) {
-        const challenges = [];
-        const failed = outcomes.filter((o) => o.status === 'failed');
-        for (const step of failed) {
-            challenges.push(`${step.name}: ${step.error ?? 'unknown error'}`);
-        }
-        return challenges;
-    }
-    // ── Internal helpers ───────────────────────────────────────────────────────
-    openChapter(title, agentName) {
-        if (!this.trajectory)
-            return;
-        const chapter = {
-            id: `ch_${randomBytes(4).toString('hex')}`,
-            title,
-            agentName,
-            startedAt: new Date().toISOString(),
-            events: [],
-        };
-        this.trajectory.chapters.push(chapter);
-        this.currentChapterId = chapter.id;
-    }
-    closeCurrentChapter() {
-        if (!this.trajectory || !this.currentChapterId)
-            return;
-        const chapter = this.trajectory.chapters.find((c) => c.id === this.currentChapterId);
-        if (chapter && !chapter.endedAt) {
-            chapter.endedAt = new Date().toISOString();
-        }
-        this.currentChapterId = null;
-    }
-    addEvent(type, content, significance, raw) {
-        if (!this.trajectory)
-            return;
-        // Find current chapter or create a default one
-        let chapter = this.trajectory.chapters.find((c) => c.id === this.currentChapterId);
-        if (!chapter) {
-            this.openChapter('Execution', 'orchestrator');
-            chapter = this.trajectory.chapters[this.trajectory.chapters.length - 1];
-        }
-        const event = {
-            ts: Date.now(),
-            type,
-            content,
-        };
-        if (significance)
-            event.significance = significance;
-        if (raw)
-            event.raw = raw;
-        chapter.events.push(event);
-    }
-    async flush() {
-        if (!this.trajectory)
-            return;
-        try {
-            const activeDir = path.join(this.dataDir, 'active');
-            await mkdir(activeDir, { recursive: true });
-            const filePath = path.join(activeDir, `${this.trajectory.id}.json`);
-            await writeFile(filePath, JSON.stringify(this.trajectory, null, 2), 'utf-8');
-        }
-        catch {
-            // Non-blocking: trajectory recording failure should never break the workflow
-        }
-    }
-    async moveToCompleted() {
-        if (!this.trajectory)
-            return;
-        try {
-            const activeDir = path.join(this.dataDir, 'active');
-            const completedDir = path.join(this.dataDir, 'completed');
-            await mkdir(completedDir, { recursive: true });
-            const activePath = path.join(activeDir, `${this.trajectory.id}.json`);
-            const completedPath = path.join(completedDir, `${this.trajectory.id}.json`);
-            if (existsSync(activePath)) {
-                await rename(activePath, completedPath);
-            }
-        }
-        catch {
-            // Non-blocking
-        }
-    }
-}
-//# sourceMappingURL=trajectory.js.map

package/packages/broker-sdk/dist/workflows/trajectory.js.map

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

package/packages/broker-sdk/dist/workflows/types.d.ts

@@ -1,140 +0,0 @@
-/**
- * Workflow Types for Relay Cloud Swarm Patterns
- *
- * Shared TypeScript types for relay.yaml configuration, workflow execution,
- * and database row representations.
- */
-/** Top-level relay.yaml configuration file structure. */
-export interface RelayYamlConfig {
-    version: string;
-    name: string;
-    description?: string;
-    swarm: SwarmConfig;
-    agents: AgentDefinition[];
-    workflows?: WorkflowDefinition[];
-    coordination?: CoordinationConfig;
-    state?: StateConfig;
-    errorHandling?: ErrorHandlingConfig;
-    trajectories?: TrajectoryConfig | false;
-}
-/** Configuration for workflow trajectory recording. */
-export interface TrajectoryConfig {
-    /** Enable trajectory recording (default: true). */
-    enabled?: boolean;
-    /** Auto-reflect when barriers resolve (default: true). */
-    reflectOnBarriers?: boolean;
-    /** Auto-reflect when parallel tracks converge (default: true). */
-    reflectOnConverge?: boolean;
-    /** Record retry/skip/fail decisions automatically (default: true). */
-    autoDecisions?: boolean;
-}
-/** Swarm-level settings controlling the overall pattern. */
-export interface SwarmConfig {
-    pattern: SwarmPattern;
-    maxConcurrency?: number;
-    timeoutMs?: number;
-    channel?: string;
-}
-export type SwarmPattern = "fan-out" | "pipeline" | "hub-spoke" | "consensus" | "mesh" | "handoff" | "cascade" | "dag" | "debate" | "hierarchical" | "map-reduce" | "scatter-gather" | "supervisor" | "reflection" | "red-team" | "verifier" | "auction" | "escalation" | "saga" | "circuit-breaker" | "blackboard" | "swarm";
-/** Definition of an agent participating in a workflow. */
-export interface AgentDefinition {
-    name: string;
-    cli: AgentCli;
-    role?: string;
-    task?: string;
-    channels?: string[];
-    constraints?: AgentConstraints;
-}
-export type AgentCli = "claude" | "codex" | "gemini" | "aider" | "goose";
-/** Resource and behavioral constraints for an agent. */
-export interface AgentConstraints {
-    maxTokens?: number;
-    timeoutMs?: number;
-    retries?: number;
-    model?: string;
-    /** Silence duration in seconds before the agent is considered idle (0 = disabled, default: 30). */
-    idleThresholdSecs?: number;
-}
-/** A named workflow composed of sequential or parallel steps. */
-export interface WorkflowDefinition {
-    name: string;
-    description?: string;
-    steps: WorkflowStep[];
-    onError?: "fail" | "skip" | "retry";
-}
-/** A single step within a workflow. */
-export interface WorkflowStep {
-    name: string;
-    agent: string;
-    task: string;
-    dependsOn?: string[];
-    verification?: VerificationCheck;
-    timeoutMs?: number;
-    retries?: number;
-}
-/** Verification check to validate a step's output. */
-export interface VerificationCheck {
-    type: "output_contains" | "exit_code" | "file_exists" | "custom";
-    value: string;
-    description?: string;
-}
-/** Coordination settings for multi-agent synchronization. */
-export interface CoordinationConfig {
-    barriers?: Barrier[];
-    votingThreshold?: number;
-    consensusStrategy?: "majority" | "unanimous" | "quorum";
-}
-/** A synchronization barrier that gates downstream work. */
-export interface Barrier {
-    name: string;
-    waitFor: string[];
-    timeoutMs?: number;
-}
-/** Shared state configuration for workflows. */
-export interface StateConfig {
-    backend: "memory" | "redis" | "database";
-    ttlMs?: number;
-    namespace?: string;
-}
-/** Global error handling configuration. */
-export interface ErrorHandlingConfig {
-    strategy: "fail-fast" | "continue" | "retry";
-    maxRetries?: number;
-    retryDelayMs?: number;
-    notifyChannel?: string;
-}
-export type WorkflowRunStatus = "pending" | "running" | "completed" | "failed" | "cancelled";
-/** Database row representing a workflow run. */
-export interface WorkflowRunRow {
-    id: string;
-    workspaceId: string;
-    workflowName: string;
-    pattern: SwarmPattern;
-    status: WorkflowRunStatus;
-    config: RelayYamlConfig;
-    stateSnapshot?: Record<string, unknown>;
-    startedAt: string;
-    completedAt?: string;
-    error?: string;
-    createdAt: string;
-    updatedAt: string;
-}
-export type WorkflowStepStatus = "pending" | "running" | "completed" | "failed" | "skipped";
-/** Database row representing a single workflow step execution. */
-export interface WorkflowStepRow {
-    id: string;
-    runId: string;
-    stepName: string;
-    agentName: string;
-    status: WorkflowStepStatus;
-    task: string;
-    dependsOn: string[];
-    output?: string;
-    error?: string;
-    startedAt?: string;
-    completedAt?: string;
-    retryCount: number;
-    createdAt: string;
-    updatedAt: string;
-}
-//# sourceMappingURL=types.d.ts.map

package/packages/broker-sdk/dist/workflows/types.d.ts.map

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

package/packages/broker-sdk/dist/workflows/types.js

@@ -1,8 +0,0 @@
-/**
- * Workflow Types for Relay Cloud Swarm Patterns
- *
- * Shared TypeScript types for relay.yaml configuration, workflow execution,
- * and database row representations.
- */
-export {};
-//# sourceMappingURL=types.js.map

package/packages/broker-sdk/dist/workflows/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workflows/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/packages/broker-sdk/package.json

@@ -1,81 +0,0 @@
-{
-  "name": "@agent-relay/broker-sdk",
-  "version": "2.3.13",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
-    },
-    "./client": {
-      "types": "./dist/client.d.ts",
-      "import": "./dist/client.js",
-      "default": "./dist/client.js"
-    },
-    "./protocol": {
-      "types": "./dist/protocol.d.ts",
-      "import": "./dist/protocol.js",
-      "default": "./dist/protocol.js"
-    },
-    "./relay": {
-      "types": "./dist/relay.d.ts",
-      "import": "./dist/relay.js",
-      "default": "./dist/relay.js"
-    },
-    "./logs": {
-      "types": "./dist/logs.d.ts",
-      "import": "./dist/logs.js",
-      "default": "./dist/logs.js"
-    },
-    "./consensus": {
-      "types": "./dist/consensus.d.ts",
-      "import": "./dist/consensus.js",
-      "default": "./dist/consensus.js"
-    },
-    "./shadow": {
-      "types": "./dist/shadow.d.ts",
-      "import": "./dist/shadow.js",
-      "default": "./dist/shadow.js"
-    },
-    "./browser": {
-      "types": "./dist/browser.d.ts",
-      "import": "./dist/browser.js",
-      "default": "./dist/browser.js"
-    },
-    "./workflows": {
-      "types": "./dist/workflows/index.d.ts",
-      "import": "./dist/workflows/index.js",
-      "default": "./dist/workflows/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "bin",
-    "README.md",
-    "package.json"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "build:full": "tsc -p tsconfig.json && npm run bundle:binary",
-    "bundle:binary": "node ./scripts/bundle-agent-relay.mjs",
-    "check": "tsc -p tsconfig.json --noEmit",
-    "test": "tsc -p tsconfig.json && node --test dist/__tests__/integration.test.js",
-    "test:quickstart": "node --test dist/__tests__/quickstart.test.js",
-    "quickstart": "node dist/examples/quickstart.js",
-    "demo": "node dist/examples/demo.js",
-    "ralph": "node dist/examples/ralph-loop.js",
-    "example": "node dist/examples/example.js",
-    "prepack": "npm run build:full"
-  },
-  "devDependencies": {
-    "@types/node": "^22.13.10",
-    "typescript": "^5.7.3"
-  },
-  "dependencies": {
-    "@relaycast/sdk": "^0.3.0",
-    "yaml": "^2.7.0"
-  }
-}