@agent-relay/sdk 2.3.14 → 2.3.15

package/dist/workflows/templates.js

@@ -0,0 +1,405 @@
+import { existsSync, promises as fs } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+const YAML_EXTENSIONS = ['.yaml', '.yml'];
+export const BUILT_IN_TEMPLATE_NAMES = [
+    'feature-dev',
+    'bug-fix',
+    'code-review',
+    'security-audit',
+    'refactor',
+    'documentation',
+    'review-loop',
+];
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function hasYamlExtension(fileName) {
+    return YAML_EXTENSIONS.some((ext) => fileName.endsWith(ext));
+}
+export class TemplateRegistry {
+    builtInTemplatesDir;
+    customTemplatesDir;
+    fetcher;
+    constructor(options = {}) {
+        this.builtInTemplatesDir = this.resolveBuiltInTemplatesDir(options.builtInTemplatesDir);
+        this.customTemplatesDir = options.customTemplatesDir
+            ? path.resolve(options.customTemplatesDir)
+            : path.resolve(options.workspaceDir ?? process.cwd(), '.relay/workflows');
+        this.fetcher = options.fetcher ?? fetch;
+    }
+    listBuiltInTemplates() {
+        return [...BUILT_IN_TEMPLATE_NAMES];
+    }
+    async listCustomTemplates() {
+        const files = await this.safeReadDir(this.customTemplatesDir);
+        return files
+            .filter((fileName) => hasYamlExtension(fileName))
+            .map((fileName) => this.normalizeTemplateName(fileName))
+            .sort();
+    }
+    async listTemplates() {
+        const custom = await this.listCustomTemplates();
+        const merged = new Set([...BUILT_IN_TEMPLATE_NAMES, ...custom]);
+        return Array.from(merged).sort();
+    }
+    async hasTemplate(name) {
+        try {
+            await this.resolveTemplatePath(name);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async loadTemplate(name, options = {}) {
+        const templatePath = await this.resolveTemplatePath(name);
+        const template = await this.readTemplateFile(templatePath);
+        if (options.overrides && Object.keys(options.overrides).length > 0) {
+            return this.applyOverrides(template, options.overrides);
+        }
+        return template;
+    }
+    async resolveTemplateReference(input, options = {}) {
+        if (typeof input === 'string') {
+            return this.loadTemplate(input, options);
+        }
+        if (this.isTemplateShorthand(input)) {
+            const { swarm, overrides = {}, ...rest } = input;
+            const mergedOverrides = {
+                ...overrides,
+                ...(options.overrides ?? {}),
+            };
+            const baseTemplate = await this.loadTemplate(swarm, {
+                overrides: mergedOverrides,
+            });
+            return this.mergeRelayConfig(baseTemplate, rest);
+        }
+        const config = this.cloneValue(input);
+        if (options.overrides && Object.keys(options.overrides).length > 0) {
+            return this.applyOverrides(config, options.overrides);
+        }
+        return config;
+    }
+    applyOverrides(config, overrides) {
+        const nextConfig = this.cloneValue(config);
+        for (const [overridePath, value] of Object.entries(overrides)) {
+            this.setOverride(nextConfig, overridePath, value);
+        }
+        return nextConfig;
+    }
+    async installExternalTemplate(url, name) {
+        const response = await this.fetcher(url);
+        if (!response.ok) {
+            throw new Error(`Failed to fetch template from ${url}: ${response.status} ${response.statusText}`);
+        }
+        const raw = await response.text();
+        const parsed = parseYaml(raw);
+        if (!isRecord(parsed)) {
+            throw new Error(`Template from ${url} is not a YAML object`);
+        }
+        const inferredName = typeof parsed.name === 'string' ? parsed.name : '';
+        const templateName = this.normalizeTemplateName(name ?? inferredName);
+        if (!templateName) {
+            throw new Error('Template name is required. Provide name explicitly or include a string "name" field.');
+        }
+        if (templateName.includes('/') || templateName.includes('\\') || templateName.includes('..') || path.isAbsolute(templateName)) {
+            throw new Error(`Invalid template name: "${templateName}" contains path separators or traversal sequences`);
+        }
+        this.validateRelayConfig(parsed, url);
+        await fs.mkdir(this.customTemplatesDir, { recursive: true });
+        const targetPath = path.join(this.customTemplatesDir, `${templateName}.yaml`);
+        await fs.writeFile(targetPath, stringifyYaml(parsed), 'utf-8');
+        return targetPath;
+    }
+    isTemplateShorthand(input) {
+        return isRecord(input) && typeof input.swarm === 'string';
+    }
+    mergeRelayConfig(base, patch) {
+        const merged = this.cloneValue(base);
+        for (const [key, value] of Object.entries(patch)) {
+            if (value === undefined) {
+                continue;
+            }
+            merged[key] = this.cloneValue(value);
+        }
+        return merged;
+    }
+    normalizeTemplateName(name) {
+        return name.replace(/\.ya?ml$/i, '').trim();
+    }
+    resolveBuiltInTemplatesDir(explicitDir) {
+        if (explicitDir) {
+            return path.resolve(explicitDir);
+        }
+        const currentDir = path.dirname(fileURLToPath(import.meta.url));
+        const candidates = [
+            path.resolve(currentDir, 'builtin-templates'),
+            path.resolve(currentDir, '../workflows/builtin-templates'),
+        ];
+        for (const candidate of candidates) {
+            if (existsSync(candidate)) {
+                return candidate;
+            }
+        }
+        return candidates[0];
+    }
+    async resolveTemplatePath(name) {
+        const normalizedName = this.normalizeTemplateName(name);
+        const customPath = await this.findTemplatePath(this.customTemplatesDir, normalizedName);
+        if (customPath) {
+            return customPath;
+        }
+        const builtInPath = await this.findTemplatePath(this.builtInTemplatesDir, normalizedName);
+        if (builtInPath) {
+            return builtInPath;
+        }
+        throw new Error(`Template not found: ${name}`);
+    }
+    async findTemplatePath(directory, templateName) {
+        for (const ext of YAML_EXTENSIONS) {
+            const candidate = path.join(directory, `${templateName}${ext}`);
+            try {
+                const stat = await fs.stat(candidate);
+                if (stat.isFile()) {
+                    return candidate;
+                }
+            }
+            catch {
+                // Continue checking other extensions.
+            }
+        }
+        return undefined;
+    }
+    async readTemplateFile(templatePath) {
+        const raw = await fs.readFile(templatePath, 'utf-8');
+        const parsed = parseYaml(raw);
+        if (!isRecord(parsed)) {
+            throw new Error(`Template at ${templatePath} is not a YAML object`);
+        }
+        const normalized = this.normalizeLegacyTemplate(parsed);
+        this.validateRelayConfig(normalized, templatePath);
+        return normalized;
+    }
+    normalizeLegacyTemplate(rawTemplate) {
+        const normalized = this.cloneValue(rawTemplate);
+        if (!isRecord(normalized.swarm) && typeof normalized.pattern === 'string') {
+            normalized.swarm = { pattern: normalized.pattern };
+            delete normalized.pattern;
+        }
+        if (Array.isArray(normalized.agents)) {
+            normalized.agents = normalized.agents.map((agent) => {
+                if (!isRecord(agent)) {
+                    return agent;
+                }
+                if (typeof agent.name !== 'string' && typeof agent.id === 'string') {
+                    return { ...agent, name: agent.id };
+                }
+                return agent;
+            });
+        }
+        if (!Array.isArray(normalized.workflows) && isRecord(normalized.workflow)) {
+            const workflowName = typeof normalized.name === 'string'
+                ? `${normalized.name}-workflow`
+                : 'default-workflow';
+            const workflow = normalized.workflow;
+            const steps = Array.isArray(workflow.steps)
+                ? workflow.steps.map((step) => this.normalizeLegacyStep(step)).filter((step) => step !== null)
+                : [];
+            normalized.workflows = [
+                {
+                    name: workflowName,
+                    description: typeof workflow.description === 'string' ? workflow.description : undefined,
+                    onError: typeof workflow.onError === 'string' ? workflow.onError : undefined,
+                    steps,
+                },
+            ];
+            delete normalized.workflow;
+        }
+        return normalized;
+    }
+    normalizeLegacyStep(step) {
+        if (!isRecord(step)) {
+            return null;
+        }
+        const name = typeof step.name === 'string'
+            ? step.name
+            : typeof step.id === 'string'
+                ? step.id
+                : undefined;
+        const task = typeof step.task === 'string'
+            ? step.task
+            : typeof step.prompt === 'string'
+                ? step.prompt
+                : undefined;
+        if (!name || typeof step.agent !== 'string' || !task) {
+            return null;
+        }
+        const normalized = {
+            name,
+            agent: step.agent,
+            task,
+        };
+        if (Array.isArray(step.dependsOn)) {
+            normalized.dependsOn = step.dependsOn;
+        }
+        if (typeof step.timeoutMs === 'number') {
+            normalized.timeoutMs = step.timeoutMs;
+        }
+        if (typeof step.retries === 'number') {
+            normalized.retries = step.retries;
+        }
+        else if (typeof step.maxRetries === 'number') {
+            normalized.retries = step.maxRetries;
+        }
+        if (isRecord(step.verification)) {
+            normalized.verification = step.verification;
+        }
+        else if (typeof step.expects === 'string') {
+            normalized.verification = {
+                type: 'output_contains',
+                value: step.expects,
+            };
+        }
+        return normalized;
+    }
+    validateRelayConfig(rawConfig, source) {
+        if (!isRecord(rawConfig)) {
+            throw new Error(`Template at ${source} is not an object`);
+        }
+        if (typeof rawConfig.version !== 'string') {
+            throw new Error(`Template at ${source} is missing required string field: version`);
+        }
+        if (typeof rawConfig.name !== 'string') {
+            throw new Error(`Template at ${source} is missing required string field: name`);
+        }
+        if (!isRecord(rawConfig.swarm) || typeof rawConfig.swarm.pattern !== 'string') {
+            throw new Error(`Template at ${source} is missing required field: swarm.pattern`);
+        }
+        if (!Array.isArray(rawConfig.agents) || rawConfig.agents.length === 0) {
+            throw new Error(`Template at ${source} must include a non-empty agents array`);
+        }
+        for (const agent of rawConfig.agents) {
+            if (!isRecord(agent) || typeof agent.name !== 'string' || typeof agent.cli !== 'string') {
+                throw new Error(`Template at ${source} contains an invalid agent definition`);
+            }
+        }
+        if (rawConfig.workflows !== undefined) {
+            if (!Array.isArray(rawConfig.workflows)) {
+                throw new Error(`Template at ${source} has invalid workflows; expected an array`);
+            }
+            for (const workflow of rawConfig.workflows) {
+                if (!isRecord(workflow) || typeof workflow.name !== 'string' || !Array.isArray(workflow.steps)) {
+                    throw new Error(`Template at ${source} contains an invalid workflow definition`);
+                }
+                for (const step of workflow.steps) {
+                    if (!isRecord(step) || typeof step.name !== 'string') {
+                        throw new Error(`Template at ${source} contains an invalid workflow step`);
+                    }
+                    // Deterministic steps require type and command
+                    if (step.type === 'deterministic') {
+                        if (typeof step.command !== 'string') {
+                            throw new Error(`Template at ${source} has deterministic step "${step.name}" without a command`);
+                        }
+                    }
+                    else {
+                        // Agent steps (type is undefined or 'agent') require agent and task
+                        if (typeof step.agent !== 'string' || typeof step.task !== 'string') {
+                            throw new Error(`Template at ${source} has agent step "${step.name}" without agent or task`);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    setOverride(config, overridePath, value) {
+        const pathParts = overridePath
+            .replace(/\[(\d+)\]/g, '.$1')
+            .split('.')
+            .map((part) => part.trim())
+            .filter(Boolean);
+        if (pathParts.length === 0) {
+            return;
+        }
+        if (pathParts[0] === 'steps') {
+            const workflow = config.workflows?.[0];
+            if (!workflow) {
+                throw new Error(`Cannot apply override "${overridePath}": workflows[0] is missing`);
+            }
+            this.setOnValue(workflow.steps, pathParts.slice(1), value, overridePath);
+            return;
+        }
+        if (pathParts[0] === 'workflow' && pathParts[1] === 'steps') {
+            const workflow = config.workflows?.[0];
+            if (!workflow) {
+                throw new Error(`Cannot apply override "${overridePath}": workflows[0] is missing`);
+            }
+            this.setOnValue(workflow.steps, pathParts.slice(2), value, overridePath);
+            return;
+        }
+        this.setOnValue(config, pathParts, value, overridePath);
+    }
+    setOnValue(target, pathParts, value, fullPath) {
+        if (pathParts.length === 0) {
+            throw new Error(`Invalid override path: ${fullPath}`);
+        }
+        let current = target;
+        for (let i = 0; i < pathParts.length - 1; i += 1) {
+            const part = pathParts[i];
+            const nextPart = pathParts[i + 1];
+            if (Array.isArray(current)) {
+                const index = this.resolveArrayItemIndex(current, part);
+                if (index < 0) {
+                    throw new Error(`Cannot apply override "${fullPath}": array item "${part}" was not found`);
+                }
+                current = current[index];
+                continue;
+            }
+            if (!isRecord(current)) {
+                throw new Error(`Cannot apply override "${fullPath}": segment "${part}" is not an object`);
+            }
+            if (!(part in current) || current[part] === undefined || current[part] === null) {
+                current[part] = /^\d+$/.test(nextPart) ? [] : {};
+            }
+            current = current[part];
+        }
+        const finalPart = pathParts[pathParts.length - 1];
+        if (Array.isArray(current)) {
+            const index = this.resolveArrayItemIndex(current, finalPart);
+            if (index < 0) {
+                throw new Error(`Cannot apply override "${fullPath}": array item "${finalPart}" was not found`);
+            }
+            current[index] = value;
+            return;
+        }
+        if (!isRecord(current)) {
+            throw new Error(`Cannot apply override "${fullPath}": parent object is invalid`);
+        }
+        current[finalPart] = value;
+    }
+    resolveArrayItemIndex(items, segment) {
+        if (/^\d+$/.test(segment)) {
+            const index = Number.parseInt(segment, 10);
+            return index >= 0 && index < items.length ? index : -1;
+        }
+        return items.findIndex((item) => isRecord(item) &&
+            ((typeof item.name === 'string' && item.name === segment) ||
+                (typeof item.id === 'string' && item.id === segment)));
+    }
+    async safeReadDir(directory) {
+        try {
+            return await fs.readdir(directory);
+        }
+        catch {
+            return [];
+        }
+    }
+    cloneValue(value) {
+        if (typeof structuredClone === 'function') {
+            return structuredClone(value);
+        }
+        return JSON.parse(JSON.stringify(value));
+    }
+}
+//# sourceMappingURL=templates.js.map

package/dist/workflows/templates.js.map

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

package/dist/workflows/trajectory.d.ts

@@ -0,0 +1,87 @@
+/**
+ * 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 type { TrajectoryConfig, WorkflowStep } from './types.js';
+export interface StepOutcome {
+    name: string;
+    agent: string;
+    status: 'completed' | 'failed' | 'skipped';
+    attempts: number;
+    output?: string;
+    error?: string;
+    verificationPassed?: boolean;
+    /** Sentinel value the step was verifying for, if any. */
+    verificationValue?: string;
+    /** Whether this was a non-interactive (subprocess) step. */
+    nonInteractive?: boolean;
+    /** Duration in ms. */
+    durationMs?: number;
+}
+export declare class WorkflowTrajectory {
+    private trajectory;
+    private currentChapterId;
+    private readonly enabled;
+    private readonly reflectOnBarriers;
+    private readonly reflectOnConverge;
+    private readonly autoDecisions;
+    private readonly dataDir;
+    private readonly runId;
+    private startTime;
+    private swarmPattern;
+    constructor(config: TrajectoryConfig | false | undefined, runId: string, cwd: string);
+    /** Start the trajectory (called at run:started). */
+    start(workflowName: string, stepCount: number, trackInfo?: string, description?: string, pattern?: string): Promise<void>;
+    /** Begin a new parallel track chapter. */
+    beginTrack(trackName: string): Promise<void>;
+    /** Begin a convergence chapter (after barrier/parallel completion). */
+    beginConvergence(label: string): Promise<void>;
+    /** Begin the retrospective chapter. */
+    private openRetrospective;
+    /** Record step started — captures intent, not just assignment. */
+    stepStarted(step: WorkflowStep, agent: string): Promise<void>;
+    /** Record step completed — captures what was accomplished. */
+    stepCompleted(step: WorkflowStep, output: string, attempt: number): Promise<void>;
+    /** Record step failed — categorizes root cause for actionable diagnosis. */
+    stepFailed(step: WorkflowStep, error: string, attempt: number, maxRetries: number, outcome?: Partial<StepOutcome>): Promise<void>;
+    /** Record step skipped — note the cascade impact. */
+    stepSkipped(step: WorkflowStep, reason: string): Promise<void>;
+    /** Record step retrying. */
+    stepRetrying(step: WorkflowStep, attempt: number, maxRetries: number): Promise<void>;
+    /** Record a reflection at a convergence point. */
+    reflect(synthesis: string, confidence: number, focalPoints?: string[]): Promise<void>;
+    /** Synthesize and reflect after a set of steps complete (barrier or parallel convergence). */
+    synthesizeAndReflect(label: string, outcomes: StepOutcome[], unblocks?: string[]): Promise<void>;
+    /** Record an orchestrator decision. */
+    decide(question: string, chosen: string, reasoning: string): Promise<void>;
+    /** Complete the trajectory with a summary. */
+    complete(summary: string, confidence: number, meta?: {
+        learnings?: string[];
+        challenges?: string[];
+    }): Promise<void>;
+    /** Abandon the trajectory. */
+    abandon(reason: string): Promise<void>;
+    isEnabled(): boolean;
+    shouldReflectOnConverge(): boolean;
+    shouldReflectOnBarriers(): boolean;
+    getTrajectoryId(): string | null;
+    buildSynthesis(label: string, outcomes: StepOutcome[], unblocks?: string[]): string;
+    computeConfidence(outcomes: StepOutcome[]): number;
+    buildRunSummary(outcomes: StepOutcome[]): string;
+    extractLearnings(outcomes: StepOutcome[]): string[];
+    extractChallenges(outcomes: StepOutcome[]): string[];
+    private openChapter;
+    private closeCurrentChapter;
+    private addEvent;
+    private flush;
+    private moveToCompleted;
+}
+//# sourceMappingURL=trajectory.d.ts.map

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

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