va-agent-protocol 0.1.0

package/dist/adapter/va-auto-pilot-adapter.js

@@ -0,0 +1,275 @@
+/**
+ * VaAutoPilotAdapter — wraps va-auto-pilot's sprint-board.mjs CLI
+ * as a protocol-compliant agent.
+ *
+ * Key design: we call va-auto-pilot via child_process, NOT via library import.
+ * This preserves the "convention-based" contract. Any tool that exposes the
+ * same CLI interface can be adapted with the same pattern.
+ */
+import { execFile } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { promisify } from "node:util";
+import path from "node:path";
+import { generateCorrelationId } from "../types/index.js";
+import { consoleLogger } from "../utils/logger.js";
+import { BaseAdapter } from "./agent-adapter.js";
+const execFileAsync = promisify(execFile);
+/**
+ * Maps between va-auto-pilot's sprint-board CLI and the universal protocol.
+ *
+ * Execution flow:
+ * 1. dispatch() → sprint-board add + update "In Progress" → spawns worker
+ * 2. poll() → reads sprint-state.json via sprint-board next --json
+ * 3. cancel() → sprint-board update "Failed"
+ */
+export class VaAutoPilotAdapter extends BaseAdapter {
+    id;
+    projectRoot;
+    sprintBoardPath;
+    qualityGateCommand;
+    log;
+    runningProcesses = new Map();
+    constructor(options) {
+        super();
+        this.projectRoot = options.projectRoot;
+        this.id = `va-auto-pilot:${path.basename(options.projectRoot)}`;
+        this.sprintBoardPath =
+            options.sprintBoardPath ??
+                path.join(options.projectRoot, "scripts", "sprint-board.mjs");
+        this.qualityGateCommand =
+            options.qualityGateCommand ?? "npm run check:all";
+        this.log = options.logger ?? consoleLogger;
+    }
+    capabilities() {
+        return {
+            agentId: this.id,
+            name: "va-auto-pilot",
+            version: "0.1.0",
+            capabilities: [
+                "code-generation",
+                "code-review",
+                "testing",
+                "refactoring",
+                "strategic-decomposition",
+            ],
+            modelRequirement: "frontier",
+            interface: {
+                type: "cli",
+                command: `node ${this.sprintBoardPath}`,
+                workingDirectory: this.projectRoot,
+            },
+            constraints: {
+                maxConcurrent: 1,
+                requiresNetwork: false,
+                requiresHumanApproval: ["destructive-operations", "architecture-decisions"],
+                maxRetries: 3,
+            },
+        };
+    }
+    async dispatch(task) {
+        const correlationId = generateCorrelationId();
+        try {
+            // 1. Add task to sprint board
+            const addResult = await this.runSprintBoard([
+                "add",
+                "--title",
+                task.objective,
+                "--priority",
+                task.priority ?? "P1",
+                "--source",
+                "va-agent-protocol",
+            ]);
+            // Extract task ID from output (e.g., "Added AP-016 ...")
+            const taskIdMatch = addResult.stdout.match(/Added\s+(\S+)/);
+            const sprintTaskId = taskIdMatch?.[1];
+            if (!sprintTaskId) {
+                return {
+                    correlationId,
+                    accepted: false,
+                    reason: `Failed to create task: ${addResult.stdout}`,
+                };
+            }
+            // 2. Move to "In Progress"
+            await this.runSprintBoard([
+                "update",
+                "--id",
+                sprintTaskId,
+                "--state",
+                "In Progress",
+            ]);
+            // Track this execution
+            this.setExecution(correlationId, sprintTaskId, "running");
+            this.runningProcesses.set(correlationId, {});
+            return { correlationId, accepted: true };
+        }
+        catch (err) {
+            return {
+                correlationId,
+                accepted: false,
+                reason: err instanceof Error ? err.message : String(err),
+            };
+        }
+    }
+    async poll(correlationId) {
+        const execution = this.executions.get(correlationId);
+        if (!execution) {
+            return {
+                correlationId,
+                state: "failed",
+                evidence: {
+                    taskId: "unknown",
+                    status: "failed",
+                    failureDetail: {
+                        failureType: "unknown",
+                        attempted: "poll",
+                        hypothesis: `No execution found for correlation ${correlationId}`,
+                    },
+                },
+            };
+        }
+        try {
+            // Read sprint-state.json directly to find the specific task by ID
+            const stateFilePath = path.join(this.projectRoot, ".va-auto-pilot", "sprint-state.json");
+            const stateContent = await readFile(stateFilePath, "utf-8");
+            const sprintState = JSON.parse(stateContent);
+            const task = sprintState.tasks.find((t) => t.id === execution.taskId);
+            if (!task) {
+                return {
+                    correlationId,
+                    state: "failed",
+                    evidence: {
+                        taskId: execution.taskId,
+                        status: "failed",
+                        failureDetail: {
+                            failureType: "unknown",
+                            attempted: "poll",
+                            hypothesis: `Task ${execution.taskId} not found in sprint state`,
+                        },
+                    },
+                };
+            }
+            // Map va-auto-pilot states to protocol states
+            const stateMap = {
+                Backlog: "pending",
+                "In Progress": "running",
+                Review: "running",
+                Testing: "running",
+                Done: "completed",
+                Failed: "failed",
+            };
+            const mappedState = stateMap[task.state] ?? "running";
+            const evidence = mappedState === "completed" || mappedState === "failed"
+                ? this.buildEvidence(task, mappedState)
+                : undefined;
+            return {
+                correlationId,
+                state: mappedState,
+                progress: {
+                    taskId: execution.taskId,
+                    phase: task.state.toLowerCase(),
+                    summary: `Task ${execution.taskId}: ${task.title} [${task.state}]`,
+                },
+                evidence,
+            };
+        }
+        catch (err) {
+            return {
+                correlationId,
+                state: "failed",
+                evidence: {
+                    taskId: execution.taskId,
+                    status: "failed",
+                    failureDetail: {
+                        failureType: "crash",
+                        attempted: "poll sprint board",
+                        hypothesis: err instanceof Error ? err.message : String(err),
+                    },
+                },
+            };
+        }
+    }
+    async cancel(correlationId) {
+        const execution = this.executions.get(correlationId);
+        if (!execution)
+            return;
+        try {
+            await this.runSprintBoard([
+                "update",
+                "--id",
+                execution.taskId,
+                "--state",
+                "Failed",
+                "--reason",
+                "Cancelled by orchestrator",
+            ]);
+        }
+        finally {
+            this.setExecution(correlationId, execution.taskId, "cancelled");
+            this.runningProcesses.delete(correlationId);
+        }
+    }
+    /**
+     * Run quality gates and return structured results.
+     */
+    async runQualityGates() {
+        const gates = this.qualityGateCommand.split("&&").map((g) => g.trim());
+        const results = [];
+        for (const gate of gates) {
+            const startTime = Date.now();
+            try {
+                const { stdout, stderr } = await execFileAsync("sh", ["-c", gate], {
+                    cwd: this.projectRoot,
+                    timeout: 120_000,
+                });
+                results.push({
+                    gate: gate.split(" ").pop() ?? gate,
+                    command: gate,
+                    exitCode: 0,
+                    passed: true,
+                    output: (stdout + stderr).slice(0, 2000),
+                    durationMs: Date.now() - startTime,
+                });
+            }
+            catch (err) {
+                const execErr = err;
+                results.push({
+                    gate: gate.split(" ").pop() ?? gate,
+                    command: gate,
+                    exitCode: execErr.code ?? 1,
+                    passed: false,
+                    output: ((execErr.stdout ?? "") + (execErr.stderr ?? "")).slice(0, 2000),
+                    durationMs: Date.now() - startTime,
+                });
+                break; // Stop on first failure
+            }
+        }
+        return results;
+    }
+    // ─── Private helpers ─────────────────────────────────────────────────────
+    async runSprintBoard(args) {
+        return execFileAsync("node", [this.sprintBoardPath, ...args], {
+            cwd: this.projectRoot,
+            timeout: 30_000,
+        });
+    }
+    buildEvidence(task, status) {
+        const evidence = {
+            taskId: task.id,
+            status,
+        };
+        if (status === "failed" && task.failureDetail) {
+            evidence.failureDetail = {
+                failureType: task.failureDetail.failureType,
+                attempted: task.failureDetail.attempted,
+                hypothesis: task.failureDetail.hypothesis,
+                missingContext: task.failureDetail.missingContext,
+            };
+        }
+        return evidence;
+    }
+    async dispose() {
+        this.runningProcesses.clear();
+        await super.dispose();
+    }
+}
+//# sourceMappingURL=va-auto-pilot-adapter.js.map

package/dist/adapter/va-auto-pilot-adapter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * va-agent-protocol — Universal Agent Task Protocol
+ *
+ * The USB interface for CLI agents.
+ */
+export type { TaskUnit, TaskContext, Pitfall, Priority, InputRef, OutputContract, AgentCapability, AgentInterface, AgentConstraints, InterfaceType, ModelRequirement, TaskState, StateTransition, TaskExecution, Evidence, EvidenceStatus, Artifact, ArtifactType, GateResult, GateType, GateSeverity, FailureDetail, FailureType, DimensionFeedback, BlockReason, BlockType, ProtocolMessage, MessageType, MessagePayload, DispatchPayload, AcceptedPayload, ProgressPayload, ProgressLog, CompletedPayload, FailedPayload, BlockedPayload, CancelPayload, } from "./types/index.js";
+export { PROTOCOL_NAME, PROTOCOL_VERSION, VALID_TRANSITIONS, createMessage, isValidTransition, isInputRef, generateCorrelationId, } from "./types/index.js";
+export type { Logger } from "./utils/logger.js";
+export { consoleLogger, noopLogger } from "./utils/logger.js";
+export type { AgentAdapter, DispatchResult, PollResult, } from "./adapter/agent-adapter.js";
+export { BaseAdapter } from "./adapter/agent-adapter.js";
+export { VaAutoPilotAdapter, type VaAutoPilotAdapterOptions, } from "./adapter/va-auto-pilot-adapter.js";
+export { CodexAdapter, type CodexAdapterOptions, } from "./adapter/codex-adapter.js";
+export { AgentRegistry, type RegisteredAgent, } from "./orchestrator/registry.js";
+export { Scheduler, type ScheduleResult, type ScheduleDecision, type ScheduleRejection } from "./orchestrator/scheduler.js";
+export { Orchestrator, type OrchestratorOptions, } from "./orchestrator/orchestrator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAEV,QAAQ,EACR,WAAW,EACX,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,cAAc,EAEd,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAEhB,SAAS,EACT,eAAe,EACf,aAAa,EAEb,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,SAAS,EAET,eAAe,EACf,WAAW,EACX,cAAc,EACd,eAAe,EACf,eAAe,EACf,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG9D,YAAY,EACV,YAAY,EACZ,cAAc,EACd,UAAU,GACX,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,GAC/B,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,aAAa,EACb,KAAK,eAAe,GACrB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAE5H,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,GACzB,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+/**
+ * va-agent-protocol — Universal Agent Task Protocol
+ *
+ * The USB interface for CLI agents.
+ */
+export { PROTOCOL_NAME, PROTOCOL_VERSION, VALID_TRANSITIONS, createMessage, isValidTransition, isInputRef, generateCorrelationId, } from "./types/index.js";
+export { consoleLogger, noopLogger } from "./utils/logger.js";
+export { BaseAdapter } from "./adapter/agent-adapter.js";
+export { VaAutoPilotAdapter, } from "./adapter/va-auto-pilot-adapter.js";
+export { CodexAdapter, } from "./adapter/codex-adapter.js";
+// ─── Orchestrator ────────────────────────────────────────────────────────────
+export { AgentRegistry, } from "./orchestrator/registry.js";
+export { Scheduler } from "./orchestrator/scheduler.js";
+export { Orchestrator, } from "./orchestrator/orchestrator.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgDH,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAS9D,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EACL,kBAAkB,GAEnB,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EACL,YAAY,GAEb,MAAM,4BAA4B,CAAC;AAEpC,gFAAgF;AAChF,OAAO,EACL,aAAa,GAEd,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,SAAS,EAAsE,MAAM,6BAA6B,CAAC;AAE5H,OAAO,EACL,YAAY,GAEb,MAAM,gCAAgC,CAAC"}

package/dist/orchestrator/orchestrator.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Orchestrator — the core dispatch loop.
+ *
+ * Reads task queue → matches to agents → dispatches → collects results.
+ *
+ * Design:
+ * - Polling-based (v0.1): orchestrator drives the loop, not event-driven
+ * - Single-threaded dispatch with async execution
+ * - Retry policy is configurable
+ * - Human escalation on blocked tasks
+ */
+import type { TaskUnit, Evidence, TaskState, ProgressPayload } from "../types/index.js";
+import type { Logger } from "../utils/logger.js";
+import type { AgentRegistry } from "./registry.js";
+export interface OrchestratorOptions {
+    /** Polling interval in ms. Default: 5000 */
+    pollIntervalMs?: number;
+    /** Maximum retries per task. Default: 3 */
+    maxRetries?: number;
+    /** Logger instance. Defaults to console-based logger. */
+    logger?: Logger;
+    /** Callback when a task reports progress. Called on every poll with progress data. */
+    onProgress?: (taskId: string, progress: ProgressPayload) => void;
+    /** Callback when a task needs human input. */
+    onBlocked?: (taskId: string, reason: string) => void;
+    /** Callback when a task completes. */
+    onCompleted?: (taskId: string, evidence: Evidence) => void;
+    /** Callback when a task fails permanently. */
+    onFailed?: (taskId: string, evidence: Evidence) => void;
+    /** Callback when a task is dispatched to an agent. */
+    onDispatched?: (taskId: string, agentId: string, correlationId: string) => void;
+}
+export declare class Orchestrator {
+    private readonly registry;
+    private readonly scheduler;
+    private readonly log;
+    private readonly options;
+    private activeTasks;
+    private taskQueue;
+    private retryAttempts;
+    private completedTaskIds;
+    /** Stores evidence from completed tasks, keyed by task ID. Used to resolve InputRef values. */
+    private completedEvidence;
+    private pollTimer;
+    private running;
+    private tickInProgress;
+    constructor(registry: AgentRegistry, options?: OrchestratorOptions);
+    /** Enqueue tasks for dispatch. Rejects tasks involved in dependency cycles. */
+    enqueue(...tasks: TaskUnit[]): void;
+    /** Get current status of all active tasks. */
+    status(): Array<{
+        taskId: string;
+        agentId: string;
+        state: TaskState;
+        attempt: number;
+    }>;
+    /** Number of tasks in queue + active. */
+    get pendingCount(): number;
+    /**
+     * Start the orchestration loop.
+     * Dispatches queued tasks and polls active ones.
+     */
+    start(): void;
+    /** Stop the orchestration loop. */
+    stop(): void;
+    /**
+     * Dispatch a single task immediately (bypasses queue).
+     * Returns the correlation ID.
+     */
+    dispatchNow(task: TaskUnit): Promise<string | null>;
+    /**
+     * Unblock a task that is in "blocked" state.
+     * Transitions it back to "running" and optionally forwards a resolution
+     * string to the adapter (if the adapter supports it).
+     */
+    unblock(correlationId: string, resolution?: string): Promise<void>;
+    /**
+     * Cancel a running task.
+     */
+    cancelTask(correlationId: string): Promise<void>;
+    private tick;
+    private dispatchQueued;
+    private pollActive;
+    private handlePollResult;
+    /**
+     * Detect dependency cycles among the given tasks plus already-queued tasks.
+     * Returns a set of task IDs that are involved in cycles.
+     */
+    private detectCycles;
+    /**
+     * Resolve InputRef values in task.inputs using completed task evidence.
+     * Static values are passed through unchanged. InputRef values are replaced
+     * with the actual output from the referenced task.
+     */
+    private resolveInputs;
+    /** Enrich a task with pitfall from its previous failure (for retry). */
+    private enrichWithPitfall;
+    /** Shut down: stop loop and dispose all adapters. */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/orchestrator/orchestrator.d.ts.map

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