@agent-relay/sdk 2.3.13 → 2.4.0

package/dist/workflows/types.d.ts

@@ -0,0 +1,306 @@
+/**
+ * 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;
+}
+/** Configuration for idle agent detection and nudging. */
+export interface IdleNudgeConfig {
+    /** ms after idle detection before first nudge (default: 120_000 = 2 min). */
+    nudgeAfterMs?: number;
+    /** ms after nudge before force-release (default: 120_000 = 2 min). */
+    escalateAfterMs?: number;
+    /** Max nudges before escalation (default: 1). */
+    maxNudges?: number;
+}
+/** Swarm-level settings controlling the overall pattern. */
+export interface SwarmConfig {
+    pattern: SwarmPattern;
+    maxConcurrency?: number;
+    timeoutMs?: number;
+    channel?: string;
+    /** Idle agent detection and nudging configuration for interactive agents. */
+    idleNudge?: IdleNudgeConfig;
+}
+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' | 'competitive' | 'review-loop';
+export type AgentPreset = 'lead' | 'worker' | 'reviewer' | 'analyst';
+/** Definition of an agent participating in a workflow. */
+export interface AgentDefinition {
+    name: string;
+    cli: AgentCli;
+    role?: string;
+    task?: string;
+    channels?: string[];
+    constraints?: AgentConstraints;
+    /** When false, the agent runs as a non-interactive subprocess (no PTY, no relay messaging).
+     *  It receives its task as a CLI prompt argument and returns stdout as output.
+     *  Default: true (interactive PTY mode). */
+    interactive?: boolean;
+    /** Working directory for this agent, resolved relative to the YAML file. */
+    cwd?: string;
+    /** Additional paths the agent needs read/write access to. */
+    additionalPaths?: string[];
+    /**
+     * Role preset that automatically configures interactive mode and injects
+     * appropriate task guardrails. Overrides are still accepted.
+     *   lead     → interactive PTY, relay-aware, coordinates workers via channels
+     *   worker   → interactive: false, produces structured output, no sub-agents
+     *   reviewer → interactive: false, reads artifacts, produces verdict, no sub-agents
+     *   analyst  → interactive: false, reads code/files, writes findings, no sub-agents
+     */
+    preset?: AgentPreset;
+}
+export type AgentCli = 'claude' | 'codex' | 'gemini' | 'aider' | 'goose' | 'opencode' | 'droid';
+/** 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;
+}
+/** Preflight check that runs before any workflow steps. */
+export interface PreflightCheck {
+    /** Shell command to execute. */
+    command: string;
+    /** Fail if output matches this condition: "non-empty", "empty", or a regex pattern. */
+    failIf?: 'non-empty' | 'empty' | string;
+    /** Succeed only if output matches this condition. */
+    successIf?: string;
+    /** Human-readable description of what this check validates. */
+    description?: string;
+}
+/** A named workflow composed of sequential or parallel steps. */
+export interface WorkflowDefinition {
+    name: string;
+    description?: string;
+    /** Preflight checks that run before any steps. All must pass. */
+    preflight?: PreflightCheck[];
+    steps: WorkflowStep[];
+    onError?: 'fail' | 'skip' | 'retry';
+}
+/** Step type: agent (LLM-powered), deterministic (shell command), or worktree (git worktree setup). */
+export type WorkflowStepType = 'agent' | 'deterministic' | 'worktree';
+/** Parameter definition for a custom step. */
+export interface CustomStepParam {
+    /** Parameter name. */
+    name: string;
+    /** Whether this parameter is required. Default: false. */
+    required?: boolean;
+    /** Default value if not provided. */
+    default?: string;
+    /** Human-readable description of the parameter. */
+    description?: string;
+}
+/** A reusable custom step definition stored in .relay/steps.yaml. */
+export interface CustomStepDefinition {
+    /** Parameters that can be passed when using this step. */
+    params?: CustomStepParam[];
+    /** Step type: "deterministic" or "worktree". */
+    type?: 'deterministic' | 'worktree';
+    /** Shell command to execute (for deterministic steps). Supports {{param}} interpolation. */
+    command?: string;
+    /** Branch name (for worktree steps). Supports {{param}} interpolation. */
+    branch?: string;
+    /** Base branch (for worktree steps). */
+    baseBranch?: string;
+    /** Worktree path (for worktree steps). */
+    path?: string;
+    /** Create branch if missing (for worktree steps). */
+    createBranch?: boolean;
+    /** Fail if command exit code is non-zero. Default: true. */
+    failOnError?: boolean;
+    /** Capture stdout as step output. Default: true. */
+    captureOutput?: boolean;
+    /** Timeout in milliseconds. */
+    timeoutMs?: number;
+    /** Human-readable description of this step. */
+    description?: string;
+}
+/** Configuration file for custom step definitions (.relay/steps.yaml). */
+export interface CustomStepsConfig {
+    /** Map of step name to step definition. */
+    steps: Record<string, CustomStepDefinition>;
+}
+/**
+ * A single step within a workflow.
+ *
+ * Steps can be either:
+ * - Agent steps (type: undefined or "agent"): Spawn an LLM agent to execute a task
+ * - Deterministic steps (type: "deterministic"): Execute a shell command
+ */
+export interface WorkflowStep {
+    /** Unique step name within the workflow. */
+    name: string;
+    /** Step type: "agent" (default) or "deterministic". */
+    type?: WorkflowStepType;
+    /** Reference to a custom step definition from .relay/steps.yaml. */
+    use?: string;
+    /** Step names that must complete before this step runs. */
+    dependsOn?: string[];
+    /** Timeout in milliseconds. */
+    timeoutMs?: number;
+    /** Name of the agent to execute this step (required for agent steps). */
+    agent?: string;
+    /** Task description for the agent (required for agent steps). */
+    task?: string;
+    /** Verification check to validate step output. */
+    verification?: VerificationCheck;
+    /** Number of retry attempts on failure. */
+    retries?: number;
+    /** Maximum iterations for steps that may need to retry (e.g., fix-failures). */
+    maxIterations?: number;
+    /** Shell command to execute (required for deterministic steps). */
+    command?: string;
+    /** Fail if command exit code is non-zero. Default: true. */
+    failOnError?: boolean;
+    /** Capture stdout as step output for downstream steps. Default: true. */
+    captureOutput?: boolean;
+    /** Branch name for the worktree (required for worktree steps). */
+    branch?: string;
+    /** Base branch to create the worktree from. Default: HEAD. */
+    baseBranch?: string;
+    /** Explicit path for the worktree. Default: .worktrees/<step-name>. */
+    path?: string;
+    /** Create the branch if it doesn't exist. Default: true. */
+    createBranch?: boolean;
+}
+/** Type guard: Check if a step is a deterministic (shell command) step. */
+export declare function isDeterministicStep(step: WorkflowStep): boolean;
+/** Type guard: Check if a step is a worktree (git worktree setup) step. */
+export declare function isWorktreeStep(step: WorkflowStep): boolean;
+/** Type guard: Check if a step uses a custom step definition. */
+export declare function isCustomStep(step: WorkflowStep): boolean;
+/** Type guard: Check if a step is an agent (LLM-powered) step. */
+export declare function isAgentStep(step: WorkflowStep): boolean;
+export type AgentWorkflowStep = WorkflowStep;
+export type DeterministicWorkflowStep = WorkflowStep;
+/** 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;
+}
+/** A single execution wave in a dry-run simulation. */
+export interface DryRunWave {
+    wave: number;
+    /** Steps in this wave. Agent is undefined for deterministic steps. */
+    steps: Array<{
+        name: string;
+        agent?: string;
+        dependsOn: string[];
+    }>;
+}
+/** Report produced by a dry-run validation of a workflow config. */
+export interface DryRunReport {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    name: string;
+    description?: string;
+    pattern: string;
+    agents: Array<{
+        name: string;
+        cli: string;
+        role?: string;
+        cwd?: string;
+        stepCount: number;
+    }>;
+    waves: DryRunWave[];
+    totalSteps: number;
+    maxConcurrency?: number;
+    estimatedWaves: number;
+    /** Estimated peak concurrent agents. */
+    estimatedPeakConcurrency?: number;
+    /** Estimated total agent-steps (counting retries as additional steps). */
+    estimatedTotalAgentSteps?: number;
+}
+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;
+    /** Agent name for agent steps, null for deterministic/worktree steps. */
+    agentName: string | null;
+    /** Step type: agent, deterministic, or worktree. */
+    stepType: WorkflowStepType;
+    status: WorkflowStepStatus;
+    /** Task description for agent steps, command for deterministic steps, branch for worktree steps. */
+    task: string;
+    dependsOn: string[];
+    output?: string;
+    error?: string;
+    startedAt?: string;
+    completedAt?: string;
+    retryCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workflows/types.d.ts.map

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

package/dist/workflows/types.js

@@ -0,0 +1,23 @@
+/**
+ * Workflow Types for Relay Cloud Swarm Patterns
+ *
+ * Shared TypeScript types for relay.yaml configuration, workflow execution,
+ * and database row representations.
+ */
+/** Type guard: Check if a step is a deterministic (shell command) step. */
+export function isDeterministicStep(step) {
+    return step.type === 'deterministic';
+}
+/** Type guard: Check if a step is a worktree (git worktree setup) step. */
+export function isWorktreeStep(step) {
+    return step.type === 'worktree';
+}
+/** Type guard: Check if a step uses a custom step definition. */
+export function isCustomStep(step) {
+    return step.use !== undefined;
+}
+/** Type guard: Check if a step is an agent (LLM-powered) step. */
+export function isAgentStep(step) {
+    return step.type !== 'deterministic' && step.type !== 'worktree';
+}
+//# sourceMappingURL=types.js.map

package/dist/workflows/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workflows/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuPH,2EAA2E;AAC3E,MAAM,UAAU,mBAAmB,CAAC,IAAkB;IACpD,OAAO,IAAI,CAAC,IAAI,KAAK,eAAe,CAAC;AACvC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,cAAc,CAAC,IAAkB;IAC/C,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC;AAClC,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,YAAY,CAAC,IAAkB;IAC7C,OAAO,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC;AAChC,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,WAAW,CAAC,IAAkB;IAC5C,OAAO,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC;AACnE,CAAC"}

package/dist/workflows/validator.d.ts

@@ -0,0 +1,11 @@
+import type { RelayYamlConfig } from './types.js';
+export interface ValidationIssue {
+    severity: 'error' | 'warning' | 'info';
+    code: string;
+    message: string;
+    fix?: string;
+    location?: string;
+}
+export declare function validateWorkflow(config: RelayYamlConfig): ValidationIssue[];
+export declare function formatValidationReport(issues: ValidationIssue[], yamlPath: string): string;
+//# sourceMappingURL=validator.d.ts.map

package/dist/workflows/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/workflows/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAiC,MAAM,YAAY,CAAC;AAEjF,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,eAAe,EAAE,CAmG3E;AAWD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA8B1F"}

package/dist/workflows/validator.js

@@ -0,0 +1,128 @@
+export function validateWorkflow(config) {
+    const issues = [];
+    const agentMap = new Map(config.agents.map((a) => [a.name, a]));
+    for (const workflow of config.workflows ?? []) {
+        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('relay_spawn') &&
+                !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 relay_spawn or add_agent to spawn sub-agents." to the task, or use \`interactive: false\`.`,
+                    location: `step:${step.name}`,
+                });
+            }
+            // Check 4: non-interactive agent that references relay_send in task
+            if (def.interactive === false &&
+                (task.includes('relay_send') || task.includes('post_message') || task.includes('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 5: 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/workflows/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/workflows/validator.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhE,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;QAC9C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;YACxC,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;gBAAE,SAAS;YACxE,IAAI,CAAC,IAAI,CAAC,KAAK;gBAAE,SAAS;YAE1B,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACxC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC;oBACV,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,+BAA+B,IAAI,CAAC,KAAK,GAAG;oBACvE,QAAQ,EAAE,QAAQ,IAAI,CAAC,IAAI,EAAE;iBAC9B,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,iBAAiB;YACjB,MAAM,GAAG,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;YACzC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;YAE7B,8CAA8C;YAC9C,IAAI,GAAG,CAAC,WAAW,KAAK,KAAK,IAAI,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnE,MAAM,CAAC,IAAI,CAAC;oBACV,QAAQ,EAAE,SAAS;oBACnB,IAAI,EAAE,sBAAsB;oBAC5B,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,wCAAwC,IAAI,CAAC,KAAK,oGAAoG;oBACjL,GAAG,EAAE,wCAAwC,IAAI,CAAC,KAAK,sDAAsD;oBAC7G,QAAQ,EAAE,QAAQ,IAAI,CAAC,IAAI,EAAE;iBAC9B,CAAC,CAAC;YACL,CAAC;YAED,mDAAmD;YACnD,IAAI,GAAG,CAAC,WAAW,KAAK,KAAK,IAAI,GAAG,CAAC,GAAG,KAAK,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChF,MAAM,CAAC,IAAI,CAAC;oBACV,QAAQ,EAAE,SAAS;oBACnB,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,0GAA0G;oBACrI,GAAG,EAAE,8FAA8F;oBACnG,QAAQ,EAAE,QAAQ,IAAI,CAAC,IAAI,EAAE;iBAC9B,CAAC,CAAC;YACL,CAAC;YAED,0EAA0E;YAC1E,IACE,GAAG,CAAC,WAAW,KAAK,KAAK;gBACzB,GAAG,CAAC,GAAG,KAAK,QAAQ;gBACpB,IAAI,CAAC,MAAM,GAAG,GAAG;gBACjB,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACxB,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBACxB,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAC7B,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAC3B,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC;oBACV,QAAQ,EAAE,MAAM;oBAChB,IAAI,EAAE,uBAAuB;oBAC7B,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,4GAA4G;oBACvI,GAAG,EAAE,4GAA4G;oBACjH,QAAQ,EAAE,QAAQ,IAAI,CAAC,IAAI,EAAE;iBAC9B,CAAC,CAAC;YACL,CAAC;YAED,oEAAoE;YACpE,IACE,GAAG,CAAC,WAAW,KAAK,KAAK;gBACzB,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,EAC9F,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC;oBACV,QAAQ,EAAE,SAAS;oBACnB,IAAI,EAAE,sBAAsB;oBAC5B,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,oHAAoH;oBAC/I,GAAG,EAAE,yEAAyE;oBAC9E,QAAQ,EAAE,QAAQ,IAAI,CAAC,IAAI,EAAE;iBAC9B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,qDAAqD;QACrD,MAAM,gBAAgB,GAAG,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YAC3D,IAAI,CAAC,CAAC,IAAI,KAAK,eAAe;gBAAE,OAAO,KAAK,CAAC;YAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YACxC,OAAO,GAAG,IAAI,oBAAoB,CAAC,GAAG,CAAC,CAAC,WAAW,KAAK,KAAK,CAAC;QAChE,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC;QAClD,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC;gBACV,QAAQ,EAAE,SAAS;gBACnB,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,aAAa,QAAQ,CAAC,IAAI,SAAS,gBAAgB,CAAC,MAAM,2CAA2C,OAAO,yGAAyG;gBAC9N,GAAG,EAAE,iGAAiG;gBACtG,QAAQ,EAAE,YAAY,QAAQ,CAAC,IAAI,EAAE;aACtC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,oBAAoB,CAAC,GAAoB;IAChD,IAAI,CAAC,GAAG,CAAC,MAAM;QAAE,OAAO,GAAG,CAAC;IAC5B,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IACzD,IAAI,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACzE,OAAO,EAAE,GAAG,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAyB,EAAE,QAAgB;IAChF,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC;IAE1D,MAAM,KAAK,GAAa,CAAC,cAAc,QAAQ,KAAK,EAAE,EAAE,CAAC,CAAC;IAE1D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,IAAI,GAA2B,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAEvF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,CAAC;QAC7D,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;QAClC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,MAAM,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzF,IAAI,QAAQ,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,WAAW,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACjG,IAAI,KAAK,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAE/B,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/package.json

@@ -1,82 +1,88 @@
 {
   "name": "@agent-relay/sdk",
-  "version": "2.3.13",
-  "description": "Lightweight SDK for agent-to-agent communication via Agent Relay",
+  "version": "2.4.0",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    },
-    "./protocol": {
-      "types": "./dist/protocol/index.d.ts",
-      "import": "./dist/protocol/index.js",
-      "default": "./dist/protocol/index.js"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     },
     "./client": {
       "types": "./dist/client.d.ts",
       "import": "./dist/client.js",
       "default": "./dist/client.js"
     },
-    "./discovery": {
-      "types": "./dist/discovery.d.ts",
-      "import": "./dist/discovery.js",
-      "default": "./dist/discovery.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"
     },
-    "./errors": {
-      "types": "./dist/errors.d.ts",
-      "import": "./dist/errors.js",
-      "default": "./dist/errors.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",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "clean": "rm -rf dist",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "npm run build"
-  },
-  "keywords": [
-    "agent-relay",
-    "agent",
-    "ai",
-    "communication",
-    "sdk"
+    "bin",
+    "README.md",
+    "package.json"
   ],
-  "author": "Khaliq Gant",
-  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/AgentWorkforce/relay.git",
     "directory": "packages/sdk"
   },
-  "publishConfig": {
-    "access": "public"
-  },
-  "dependencies": {
-    "@agent-relay/protocol": "2.3.13",
-    "@agent-relay/utils": "2.3.13"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "peerDependencies": {
-    "@agent-relay/daemon": "*"
-  },
-  "peerDependenciesMeta": {
-    "@agent-relay/daemon": {
-      "optional": true
-    }
+  "scripts": {
+    "prebuild": "npm --prefix ../config run build",
+    "build": "tsc -p tsconfig.build.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": "npm run build && 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.19.3",
-    "typescript": "^5.9.3",
-    "vitest": "^3.0.0"
+    "@types/node": "^22.13.10",
+    "typescript": "^5.7.3"
+  },
+  "dependencies": {
+    "@agent-relay/config": "2.4.0",
+    "@relaycast/sdk": "^0.4.0",
+    "yaml": "^2.7.0"
   }
 }

package/dist/discovery.d.ts

@@ -1,10 +0,0 @@
-/**
- * Socket Discovery & Cloud Workspace Detection
- *
- * Re-exports all discovery functionality from @agent-relay/utils,
- * which is the single source of truth. This module exists so SDK
- * consumers can import discovery from either '@agent-relay/sdk'
- * or '@agent-relay/sdk/discovery'.
- */
-export { type CloudWorkspace, type DiscoveryResult, type CloudConnectionOptions, type CloudConnectionInfo, detectCloudWorkspace, isCloudWorkspace, getCloudSocketPath, getCloudOutboxPath, discoverSocket, cloudApiRequest, getWorkspaceStatus, getConnectionInfo, getCloudEnvironmentSummary, discoverAgentName, } from '@agent-relay/utils/discovery';
-//# sourceMappingURL=discovery.d.ts.map