pi-harness-runtime 0.9.2 → 0.9.5

package/packages/a2a-adapter/dist/transport.d.ts

@@ -0,0 +1,55 @@
+/**
+ * A2A Adapter — HTTP Transport (RFC-0069)
+ */
+import type { AgentCard, A2AClientConfig, TaskHandle } from "./types.js";
+/**
+ * HTTP client for A2A protocol
+ */
+export declare class A2ATransport {
+    private baseUrl;
+    private config;
+    constructor(baseUrl: string, config?: A2AClientConfig);
+    private request;
+    /**
+     * Fetch agent card from well-known endpoint
+     */
+    getAgentCard(): Promise<AgentCard>;
+    /**
+     * Send a task message to an agent
+     */
+    sendTask(params: {
+        taskId?: string;
+        sessionId?: string;
+        message: {
+            role: string;
+            content: string;
+        };
+    }): Promise<TaskHandle>;
+    /**
+     * Send task with streaming subscription
+     */
+    sendTaskSubscribe(params: {
+        taskId?: string;
+        sessionId?: string;
+        message: {
+            role: string;
+            content: string;
+        };
+    }): Promise<TaskHandle>;
+    /**
+     * Get task status
+     */
+    getTask(taskId: string): Promise<unknown>;
+    /**
+     * Cancel a task
+     */
+    cancelTask(taskId: string): Promise<{
+        taskId: string;
+        status: string;
+    }>;
+    /**
+     * SSE stream for task updates
+     */
+    streamTaskUpdates(taskId: string): AsyncGenerator<unknown>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/packages/a2a-adapter/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzE;;GAEG;AACH,qBAAa,YAAY;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAkB;IAEhC,YAAY,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,eAAoB,EAGxD;YAEa,OAAO;IA4BrB;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,SAAS,CAAC,CAEvC;IAED;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3C,GAAG,OAAO,CAAC,UAAU,CAAC,CAMtB;IAED;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE;QAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3C,GAAG,OAAO,CAAC,UAAU,CAAC,CAMtB;IAED;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE9C;IAED;;OAEG;IACG,UAAU,CACf,MAAM,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAE7C;IAED;;OAEG;IACI,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,CAqChE;CACD"}

package/packages/a2a-adapter/dist/transport.js

@@ -0,0 +1,109 @@
+/**
+ * A2A Adapter — HTTP Transport (RFC-0069)
+ */
+/**
+ * HTTP client for A2A protocol
+ */
+export class A2ATransport {
+    baseUrl;
+    config;
+    constructor(baseUrl, config = {}) {
+        this.baseUrl = baseUrl.replace(/\/$/, "");
+        this.config = config;
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+            ...this.config.headers,
+        };
+        const response = await fetch(url, {
+            method,
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+            signal: AbortSignal.timeout(this.config.timeout ?? 30000),
+        });
+        if (!response.ok) {
+            throw new Error(`A2A HTTP error: ${response.status} ${response.statusText}`);
+        }
+        return response.json();
+    }
+    /**
+     * Fetch agent card from well-known endpoint
+     */
+    async getAgentCard() {
+        return this.request("GET", "/.well-known/agent.json");
+    }
+    /**
+     * Send a task message to an agent
+     */
+    async sendTask(params) {
+        return this.request("POST", "/a2a/tasks/send", {
+            jsonrpc: "2.0",
+            method: "tasks/send",
+            params,
+        });
+    }
+    /**
+     * Send task with streaming subscription
+     */
+    async sendTaskSubscribe(params) {
+        return this.request("POST", "/a2a/tasks/sendSubscribe", {
+            jsonrpc: "2.0",
+            method: "tasks/sendSubscribe",
+            params,
+        });
+    }
+    /**
+     * Get task status
+     */
+    async getTask(taskId) {
+        return this.request("GET", `/a2a/tasks/${taskId}`);
+    }
+    /**
+     * Cancel a task
+     */
+    async cancelTask(taskId) {
+        return this.request("POST", `/a2a/tasks/${taskId}/cancel`);
+    }
+    /**
+     * SSE stream for task updates
+     */
+    async *streamTaskUpdates(taskId) {
+        const url = `${this.baseUrl}/a2a/tasks/${taskId}/stream`;
+        const response = await fetch(url, {
+            headers: {
+                Accept: "text/event-stream",
+                ...this.config.headers,
+            },
+            signal: AbortSignal.timeout(this.config.timeout ?? 60000),
+        });
+        if (!response.ok || !response.body) {
+            throw new Error(`Stream error: ${response.status}`);
+        }
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split("\n");
+                buffer = lines.pop() ?? "";
+                for (const line of lines) {
+                    if (line.startsWith("data: ")) {
+                        const data = JSON.parse(line.slice(6));
+                        yield data;
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+}
+//# sourceMappingURL=transport.js.map

package/packages/a2a-adapter/dist/transport.js.map

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

package/packages/a2a-adapter/dist/types.d.ts

@@ -0,0 +1,117 @@
+/**
+ * A2A Adapter — Types (RFC-0069)
+ */
+export interface AgentCard {
+    name: string;
+    description: string;
+    url: string;
+    version: string;
+    capabilities: AgentCapabilities;
+    skills: Skill[];
+    authentication?: Authentication;
+    defaultInputModes?: string[];
+    defaultOutputModes?: string[];
+}
+export interface AgentCapabilities {
+    streaming?: boolean;
+    pushNotifications?: boolean;
+    stateTransitionHistory?: boolean;
+}
+export interface Skill {
+    id: string;
+    name: string;
+    description: string;
+    tags?: string[];
+    inputModes?: string[];
+    outputModes?: string[];
+}
+export interface Authentication {
+    schemes: string[];
+    credentials?: string;
+}
+export type TaskStatus = "submitted" | "working" | "completed" | "canceled" | "failed";
+export interface Task {
+    id: string;
+    sessionId?: string;
+    status: TaskStatus;
+    artifacts?: Artifact[];
+    kind: "message" | "search" | "task";
+}
+export interface TaskStatusUpdateEvent {
+    taskId: string;
+    status: TaskStatus;
+    message?: TaskMessage;
+    final?: boolean;
+}
+export interface TaskMessage {
+    role: "agent" | "user";
+    content: string;
+}
+export interface Artifact {
+    name?: string;
+    description?: string;
+    parts: Array<{
+        type: "text";
+        text: string;
+    }>;
+}
+export type A2ARequest = {
+    method: "tasks/send";
+    params: {
+        taskId?: string;
+        sessionId?: string;
+        message: TaskMessage;
+    };
+} | {
+    method: "tasks/sendSubscribe";
+    params: {
+        taskId?: string;
+        sessionId?: string;
+        message: TaskMessage;
+    };
+} | {
+    method: "tasks/get";
+    params: {
+        taskId: string;
+    };
+} | {
+    method: "tasks/cancel";
+    params: {
+        taskId: string;
+    };
+} | {
+    method: "agents/info";
+    params: {
+        agentId?: string;
+    };
+} | {
+    method: "agents/list";
+    params?: {
+        filter?: Record<string, string>;
+    };
+};
+export interface A2AResponse {
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+    };
+}
+export interface A2AClientConfig {
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+export interface TaskHandle {
+    taskId: string;
+    status: TaskStatus;
+}
+export interface A2AAgentConfig {
+    name: string;
+    description: string;
+    url: string;
+    version: string;
+    skills?: Skill[];
+    capabilities?: Partial<AgentCapabilities>;
+    port?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/a2a-adapter/dist/types.d.ts.map

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

package/packages/a2a-adapter/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * A2A Adapter — Types (RFC-0069)
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/packages/a2a-adapter/dist/types.js.map

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

package/packages/a2a-adapter/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@pi/a2a-adapter",
+  "version": "0.9.5",
+  "type": "module",
+  "description": "Google Agent-to-Agent (A2A) protocol adapter for pi-harness",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "bun test"
+  },
+  "devDependencies": {
+    "bun-types": "^1.0.0"
+  }
+}

package/packages/a2a-adapter/src/agent.ts

@@ -0,0 +1,139 @@
+/**
+ * A2A Adapter — A2A Agent (RFC-0069)
+ *
+ * Expose this harness agent as an A2A-compatible agent.
+ */
+
+import type {
+	AgentCard,
+	A2AAgentConfig,
+	Task,
+	TaskMessage,
+	TaskStatus,
+	Skill,
+} from "./types.js";
+import { A2A_PROTOCOL_VERSION } from "./protocol.js";
+
+/**
+ * Task store — in-memory for now
+ */
+const taskStore = new Map<string, Task>();
+
+let taskCounter = 0;
+
+/**
+ * Create an AgentCard for this harness agent
+ */
+export function createAgentCard(config: A2AAgentConfig): AgentCard {
+	return {
+		name: config.name,
+		description: config.description,
+		url: config.url,
+		version: config.version,
+		capabilities: {
+			streaming: true,
+			pushNotifications: false,
+			stateTransitionHistory: false,
+			...config.capabilities,
+		},
+		skills: config.skills ?? [
+			{
+				id: "code-analysis",
+				name: "Code Analysis",
+				description: "Analyze code structure, dependencies, and quality",
+				tags: ["code", "analysis", "static-analysis"],
+				inputModes: ["text"],
+				outputModes: ["text"],
+			},
+			{
+				id: "code-generation",
+				name: "Code Generation",
+				description: "Generate code from specifications",
+				tags: ["code", "generation", "scaffolding"],
+				inputModes: ["text"],
+				outputModes: ["text"],
+			},
+		],
+		defaultInputModes: ["text"],
+		defaultOutputModes: ["text"],
+	};
+}
+
+/**
+ * Route incoming A2A task to harness skill-registry
+ */
+export async function routeTask(message: TaskMessage): Promise<Task> {
+	const taskId = `task-${++taskCounter}-${Date.now()}`;
+	const task: Task = {
+		id: taskId,
+		status: "working",
+		kind: "message",
+		artifacts: [],
+	};
+	taskStore.set(taskId, task);
+
+	try {
+		const response = await processMessage(message);
+		task.artifacts = [
+			{
+				name: "response",
+				description: "Agent response",
+				parts: [{ type: "text", text: response }],
+			},
+		];
+		task.status = "completed";
+	} catch (err) {
+		task.status = "failed";
+		const msg = err instanceof Error ? err.message : String(err);
+		task.artifacts = [{ parts: [{ type: "text", text: `Error: ${msg}` }] }];
+	}
+
+	taskStore.set(taskId, task);
+	return task;
+}
+
+/**
+ * Process message — stub for harness integration
+ */
+async function processMessage(message: TaskMessage): Promise<string> {
+	return `[A2A Stub] Received: ${message.content}. This would be processed by the harness skill-registry.`;
+}
+
+/**
+ * Get task by ID
+ */
+export function getTask(taskId: string): Task | null {
+	return taskStore.get(taskId) ?? null;
+}
+
+/**
+ * Cancel a task
+ */
+export function cancelTask(taskId: string): boolean {
+	const task = taskStore.get(taskId);
+	if (!task) return false;
+	task.status = "canceled";
+	taskStore.set(taskId, task);
+	return true;
+}
+
+/**
+ * Generate task status update SSE
+ */
+export function taskStatusUpdateSSE(taskId: string): string {
+	const task = taskStore.get(taskId);
+	if (!task) return "";
+	// Inline SSE formatting to avoid dynamic require at module level
+	return (
+		`event: task_status_update\ndata: ` +
+		JSON.stringify({
+			taskId: task.id,
+			status: task.status,
+			final:
+				task.status === "completed" ||
+				task.status === "failed" ||
+				task.status === "canceled",
+		}) +
+		"\n\n"
+	);
+}

package/packages/a2a-adapter/src/client.ts

@@ -0,0 +1,107 @@
+/**
+ * A2A Adapter — A2A Client (RFC-0069)
+ *
+ * Discover and delegate to remote A2A agents.
+ */
+
+import { A2ATransport } from "./transport.js";
+import { wellKnownAgentUrl } from "./protocol.js";
+import type {
+	AgentCard,
+	A2AClientConfig,
+	TaskHandle,
+	TaskMessage,
+	Task,
+	Skill,
+} from "./types.js";
+
+export { A2ATransport } from "./transport.js";
+
+export interface AgentSearchCriteria {
+	skill?: string;
+	capability?: string;
+}
+
+/**
+ * A2A Client — discover and delegate to remote agents
+ */
+export class A2AClient {
+	private transport: A2ATransport;
+
+	constructor(baseUrl: string, config?: A2AClientConfig) {
+		this.transport = new A2ATransport(baseUrl, config);
+	}
+
+	/**
+	 * Discover agent via URL
+	 */
+	async discoverAgent(url?: string): Promise<AgentCard> {
+		const agentUrl = url ?? wellKnownAgentUrl(this.transport["baseUrl"]);
+		const transport = new A2ATransport(agentUrl);
+		return transport.getAgentCard();
+	}
+
+	/**
+	 * List agents (if target supports agent listing)
+	 */
+	async listAgents(_filter?: Record<string, string>): Promise<AgentCard[]> {
+		return [];
+	}
+
+	/**
+	 * Find agents by skill/capability
+	 * Note: This requires a registry or directory service
+	 */
+	async findAgents(_criteria: AgentSearchCriteria): Promise<AgentCard[]> {
+		return [];
+	}
+
+	/**
+	 * Send task to agent
+	 */
+	async sendTask(
+		message: string,
+		options: { taskId?: string; sessionId?: string } = {},
+	): Promise<TaskHandle> {
+		const taskMessage: TaskMessage = {
+			role: "user",
+			content: message,
+		};
+		return this.transport.sendTask({ ...options, message: taskMessage });
+	}
+
+	/**
+	 * Send task with streaming updates
+	 */
+	async sendTaskSubscribe(
+		message: string,
+		options: { taskId?: string; sessionId?: string } = {},
+	): Promise<TaskHandle> {
+		const taskMessage: TaskMessage = { role: "user", content: message };
+		return this.transport.sendTaskSubscribe({
+			...options,
+			message: taskMessage,
+		});
+	}
+
+	/**
+	 * Get task result
+	 */
+	async getTaskResult(taskId: string): Promise<Task> {
+		return this.transport.getTask(taskId) as Promise<Task>;
+	}
+
+	/**
+	 * Cancel task
+	 */
+	async cancelTask(taskId: string): Promise<void> {
+		await this.transport.cancelTask(taskId);
+	}
+
+	/**
+	 * Subscribe to task updates via SSE
+	 */
+	async *subscribeToTask(taskId: string): AsyncGenerator<unknown> {
+		yield* this.transport.streamTaskUpdates(taskId);
+	}
+}

package/packages/a2a-adapter/src/index.ts

@@ -0,0 +1,30 @@
+/**
+ * A2A Adapter — Main Entry (RFC-0069)
+ */
+
+export { A2AClient, type AgentSearchCriteria } from "./client.js";
+export { A2ATransport } from "./transport.js";
+export {
+	createAgentCard,
+	routeTask,
+	getTask,
+	cancelTask,
+	taskStatusUpdateSSE,
+} from "./agent.js";
+export type {
+	AgentCard,
+	AgentCapabilities,
+	Skill,
+	Authentication,
+	Task,
+	TaskStatus,
+	TaskStatusUpdateEvent,
+	TaskMessage,
+	Artifact,
+	A2ARequest,
+	A2AResponse,
+	A2AClientConfig,
+	TaskHandle,
+	A2AAgentConfig,
+} from "./types.js";
+export { A2A_PROTOCOL_VERSION, WELL_KNOWN_AGENT_PATH } from "./protocol.js";

package/packages/a2a-adapter/src/protocol.ts

@@ -0,0 +1,46 @@
+/**
+ * A2A Adapter — Protocol Constants (RFC-0069)
+ */
+
+export const A2A_PROTOCOL_VERSION = "1.0.0";
+export const A2A_CONTENT_TYPE = "application/json";
+
+export const HTTP_METHODS = {
+	GET: "GET",
+	POST: "POST",
+} as const;
+
+export const WELL_KNOWN_AGENT_PATH = "/.well-known/agent.json";
+
+// Status codes
+export const STATUS = {
+	SUBMITTED: "submitted",
+	WORKING: "working",
+	COMPLETED: "completed",
+	CANCELED: "canceled",
+	FAILED: "failed",
+} as const;
+
+// Error codes
+export const ERROR_CODES = {
+	INVALID_REQUEST: -32600,
+	METHOD_NOT_FOUND: -32601,
+	INVALID_PARAMS: -32602,
+	INTERNAL_ERROR: -32603,
+	TASK_NOT_FOUND: 40401,
+	TASK_STATE: 40402,
+} as const;
+
+/**
+ * Serialize task as SSE event
+ */
+export function formatSSETaskEvent(event: string, data: unknown): string {
+	return `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
+}
+
+/**
+ * Parse agent card from well-known URL
+ */
+export function wellKnownAgentUrl(baseUrl: string): string {
+	return `${baseUrl.replace(/\/$/, "")}${WELL_KNOWN_AGENT_PATH}`;
+}