pulseed 0.0.1 → 0.1.0

package/dist/adapters/a2a-adapter.js

@@ -0,0 +1,211 @@
+// ─── A2AAdapter ───
+//
+// IAdapter implementation for the Google A2A (Agent-to-Agent) Protocol v0.3.
+// Wraps A2AClient for network I/O and maps between PulSeed's AgentTask/AgentResult
+// and A2A's Message/Task types. Supports both polling and SSE streaming.
+import { randomUUID } from "node:crypto";
+import { A2AClient } from "./a2a-client.js";
+import { A2A_TERMINAL_STATES } from "../types/a2a.js";
+// ─── Adapter ───
+export class A2AAdapter {
+    adapterType;
+    client;
+    preferStreaming;
+    contextId;
+    resolvedCapabilities;
+    agentCard = null;
+    constructor(config) {
+        this.adapterType = config.adapterType ?? "a2a";
+        this.client = new A2AClient(config);
+        this.preferStreaming = config.preferStreaming ?? true;
+        this.contextId = config.contextId;
+        this.resolvedCapabilities = config.capabilities ?? null;
+    }
+    get capabilities() {
+        return this.resolvedCapabilities ?? ["general_purpose"];
+    }
+    /**
+     * Fetch Agent Card and derive capabilities from skills.
+     * Called lazily on first execute() if capabilities were not provided in config.
+     * Safe to call multiple times (cached).
+     */
+    async discoverCapabilities() {
+        if (this.agentCard)
+            return;
+        try {
+            this.agentCard = await this.client.fetchAgentCard();
+            if (!this.resolvedCapabilities && this.agentCard.skills?.length) {
+                this.resolvedCapabilities = this.agentCard.skills.flatMap((s) => s.tags ?? [s.id]);
+            }
+        }
+        catch {
+            // Agent Card not available — continue with default capabilities
+        }
+    }
+    async execute(task) {
+        const startedAt = Date.now();
+        // Lazy capability discovery
+        if (!this.agentCard) {
+            await this.discoverCapabilities();
+        }
+        // Build A2A message from PulSeed's prompt
+        const message = {
+            role: "user",
+            parts: [{ kind: "text", text: task.prompt }],
+            messageId: randomUUID(),
+            ...(this.contextId ? { contextId: this.contextId } : {}),
+        };
+        // Timeout via AbortController
+        const controller = new AbortController();
+        const timeoutHandle = setTimeout(() => controller.abort(), task.timeout_ms);
+        try {
+            let a2aTask;
+            const supportsStreaming = this.preferStreaming &&
+                this.agentCard?.capabilities?.streaming === true;
+            if (supportsStreaming) {
+                // ── SSE streaming path ──
+                a2aTask = await this.client.sendMessageStream(message, undefined, // onStatus callback — not needed for basic adapter
+                controller.signal);
+            }
+            else {
+                // ── Polling path ──
+                const initial = await this.client.sendMessage(message);
+                if (A2A_TERMINAL_STATES.has(initial.status.state)) {
+                    a2aTask = initial;
+                }
+                else {
+                    a2aTask = await this.client.waitForCompletion(initial.id, controller.signal);
+                }
+            }
+            clearTimeout(timeoutHandle);
+            return this.mapTaskToResult(a2aTask, startedAt);
+        }
+        catch (err) {
+            clearTimeout(timeoutHandle);
+            const elapsed = Date.now() - startedAt;
+            const errMessage = err instanceof Error ? err.message : String(err);
+            // Distinguish timeout from other errors
+            if (controller.signal.aborted ||
+                errMessage.includes("did not complete within")) {
+                return {
+                    success: false,
+                    output: "",
+                    error: `Timed out after ${task.timeout_ms}ms`,
+                    exit_code: null,
+                    elapsed_ms: elapsed,
+                    stopped_reason: "timeout",
+                };
+            }
+            return {
+                success: false,
+                output: "",
+                error: errMessage,
+                exit_code: null,
+                elapsed_ms: elapsed,
+                stopped_reason: "error",
+            };
+        }
+    }
+    // ─── Private: map A2A Task to PulSeed AgentResult ───
+    mapTaskToResult(task, startedAt) {
+        const elapsed = Date.now() - startedAt;
+        // Extract text output from artifacts
+        const output = this.extractTextOutput(task);
+        switch (task.status.state) {
+            case "completed":
+                return {
+                    success: true,
+                    output,
+                    error: null,
+                    exit_code: null,
+                    elapsed_ms: elapsed,
+                    stopped_reason: "completed",
+                };
+            case "failed":
+                return {
+                    success: false,
+                    output,
+                    error: task.status.message ?? "A2A task failed",
+                    exit_code: null,
+                    elapsed_ms: elapsed,
+                    stopped_reason: "error",
+                };
+            case "canceled":
+                return {
+                    success: false,
+                    output,
+                    error: "A2A task was canceled",
+                    exit_code: null,
+                    elapsed_ms: elapsed,
+                    stopped_reason: "timeout", // closest mapping
+                };
+            case "rejected":
+                return {
+                    success: false,
+                    output,
+                    error: task.status.message ??
+                        "A2A task was rejected by the remote agent",
+                    exit_code: null,
+                    elapsed_ms: elapsed,
+                    stopped_reason: "error",
+                };
+            case "input-required":
+            case "auth-required":
+                return {
+                    success: false,
+                    output,
+                    error: `A2A task requires ${task.status.state}: ${task.status.message ?? "no details"}. ` +
+                        "PulSeed does not support interactive input through adapters.",
+                    exit_code: null,
+                    elapsed_ms: elapsed,
+                    stopped_reason: "error",
+                };
+            default:
+                // Should not reach here after waitForCompletion, but handle gracefully
+                return {
+                    success: false,
+                    output,
+                    error: `A2A task in unexpected state: ${task.status.state}`,
+                    exit_code: null,
+                    elapsed_ms: elapsed,
+                    stopped_reason: "error",
+                };
+        }
+    }
+    /**
+     * Extract text content from A2A artifacts and history.
+     * Concatenates all text parts from artifacts (preferred) or last agent message.
+     */
+    extractTextOutput(task) {
+        // Prefer artifacts
+        if (task.artifacts?.length) {
+            const texts = [];
+            for (const artifact of task.artifacts) {
+                for (const part of artifact.parts) {
+                    if (part.kind === "text") {
+                        texts.push(part.text);
+                    }
+                }
+            }
+            if (texts.length > 0)
+                return texts.join("\n");
+        }
+        // Fallback: last agent message in history
+        if (task.history?.length) {
+            const agentMessages = task.history.filter((m) => m.role === "agent");
+            const last = agentMessages[agentMessages.length - 1];
+            if (last) {
+                const texts = [];
+                for (const part of last.parts) {
+                    if (part.kind === "text") {
+                        texts.push(part.text);
+                    }
+                }
+                if (texts.length > 0)
+                    return texts.join("\n");
+            }
+        }
+        return "";
+    }
+}
+//# sourceMappingURL=a2a-adapter.js.map

package/dist/adapters/a2a-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-adapter.js","sourceRoot":"","sources":["../../src/adapters/a2a-adapter.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,EAAE;AACF,6EAA6E;AAC7E,mFAAmF;AACnF,yEAAyE;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMzC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AA4BtD,kBAAkB;AAElB,MAAM,OAAO,UAAU;IACZ,WAAW,CAAS;IAEZ,MAAM,CAAY;IAClB,eAAe,CAAU;IACzB,SAAS,CAAU;IAC5B,oBAAoB,CAAkB;IACtC,SAAS,GAAwB,IAAI,CAAC;IAE9C,YAAY,MAAwB;QAClC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,KAAK,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,IAAI,IAAI,CAAC;QACtD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,oBAAoB,GAAG,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC;IAC1D,CAAC;IAED,IAAI,YAAY;QACd,OAAO,IAAI,CAAC,oBAAoB,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC1D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,oBAAoB;QACxB,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC;YACH,IAAI,CAAC,SAAS,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YACpD,IAAI,CAAC,IAAI,CAAC,oBAAoB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;gBAChE,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CACvD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CACxB,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gEAAgE;QAClE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAe;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,4BAA4B;QAC5B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACpC,CAAC;QAED,0CAA0C;QAC1C,MAAM,OAAO,GAAe;YAC1B,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5C,SAAS,EAAE,UAAU,EAAE;YACvB,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC;QAEF,8BAA8B;QAC9B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,aAAa,GAAG,UAAU,CAC9B,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EACxB,IAAI,CAAC,UAAU,CAChB,CAAC;QAEF,IAAI,CAAC;YACH,IAAI,OAAgB,CAAC;YAErB,MAAM,iBAAiB,GACrB,IAAI,CAAC,eAAe;gBACpB,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,KAAK,IAAI,CAAC;YAEnD,IAAI,iBAAiB,EAAE,CAAC;gBACtB,2BAA2B;gBAC3B,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAC3C,OAAO,EACP,SAAS,EAAE,mDAAmD;gBAC9D,UAAU,CAAC,MAAM,CAClB,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,qBAAqB;gBACrB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBAEvD,IAAI,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;oBAClD,OAAO,GAAG,OAAO,CAAC;gBACpB,CAAC;qBAAM,CAAC;oBACN,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAC3C,OAAO,CAAC,EAAE,EACV,UAAU,CAAC,MAAM,CAClB,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,YAAY,CAAC,aAAa,CAAC,CAAC;YAC5B,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,YAAY,CAAC,aAAa,CAAC,CAAC;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACvC,MAAM,UAAU,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAEpE,wCAAwC;YACxC,IACE,UAAU,CAAC,MAAM,CAAC,OAAO;gBACzB,UAAU,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAC9C,CAAC;gBACD,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,mBAAmB,IAAI,CAAC,UAAU,IAAI;oBAC7C,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,OAAO;oBACnB,cAAc,EAAE,SAAS;iBAC1B,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,UAAU;gBACjB,SAAS,EAAE,IAAI;gBACf,UAAU,EAAE,OAAO;gBACnB,cAAc,EAAE,OAAO;aACxB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,uDAAuD;IAE/C,eAAe,CAAC,IAAa,EAAE,SAAiB;QACtD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAEvC,qCAAqC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAE5C,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC1B,KAAK,WAAW;gBACd,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,MAAM;oBACN,KAAK,EAAE,IAAI;oBACX,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,OAAO;oBACnB,cAAc,EAAE,WAAW;iBAC5B,CAAC;YAEJ,KAAK,QAAQ;gBACX,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM;oBACN,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,iBAAiB;oBAC/C,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,OAAO;oBACnB,cAAc,EAAE,OAAO;iBACxB,CAAC;YAEJ,KAAK,UAAU;gBACb,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM;oBACN,KAAK,EAAE,uBAAuB;oBAC9B,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,OAAO;oBACnB,cAAc,EAAE,SAAS,EAAE,kBAAkB;iBAC9C,CAAC;YAEJ,KAAK,UAAU;gBACb,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM;oBACN,KAAK,EACH,IAAI,CAAC,MAAM,CAAC,OAAO;wBACnB,2CAA2C;oBAC7C,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,OAAO;oBACnB,cAAc,EAAE,OAAO;iBACxB,CAAC;YAEJ,KAAK,gBAAgB,CAAC;YACtB,KAAK,eAAe;gBAClB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM;oBACN,KAAK,EACH,qBAAqB,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,YAAY,IAAI;wBAClF,8DAA8D;oBAChE,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,OAAO;oBACnB,cAAc,EAAE,OAAO;iBACxB,CAAC;YAEJ;gBACE,uEAAuE;gBACvE,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM;oBACN,KAAK,EAAE,iCAAiC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE;oBAC3D,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,OAAO;oBACnB,cAAc,EAAE,OAAO;iBACxB,CAAC;QACN,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,iBAAiB,CAAC,IAAa;QACrC,mBAAmB;QACnB,IAAI,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACtC,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;oBAClC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;wBACzB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACxB,CAAC;gBACH,CAAC;YACH,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;QAED,0CAA0C;QAC1C,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACzB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;YACrE,MAAM,IAAI,GAAG,aAAa,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACrD,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,KAAK,GAAa,EAAE,CAAC;gBAC3B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBAC9B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;wBACzB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACxB,CAAC;gBACH,CAAC;gBACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;oBAAE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/adapters/a2a-client.d.ts

@@ -0,0 +1,28 @@
+import type { A2AAgentCard, A2ATask, A2ATaskState, A2AMessage } from "../types/a2a.js";
+export interface A2AClientConfig {
+    /** Base URL of the A2A agent (e.g. "https://agent.example.com") */
+    baseUrl: string;
+    /** Auth token (Bearer). Optional — depends on agent's securitySchemes. */
+    authToken?: string;
+    /** Polling interval when SSE is not supported. Default: 2000ms */
+    pollIntervalMs?: number;
+    /** Maximum total wait time for task completion. Default: 300_000ms (5 min) */
+    maxWaitMs?: number;
+}
+export declare class A2AClient {
+    private readonly baseUrl;
+    private readonly authToken?;
+    private readonly pollIntervalMs;
+    private readonly maxWaitMs;
+    constructor(config: A2AClientConfig);
+    fetchAgentCard(): Promise<A2AAgentCard>;
+    sendMessage(message: A2AMessage): Promise<A2ATask>;
+    getTask(taskId: string): Promise<A2ATask>;
+    cancelTask(taskId: string): Promise<void>;
+    waitForCompletion(taskId: string, signal?: AbortSignal): Promise<A2ATask>;
+    sendMessageStream(message: A2AMessage, onStatus?: (state: A2ATaskState, msg?: string) => void, signal?: AbortSignal): Promise<A2ATask>;
+    private buildHeaders;
+    private httpGet;
+    private jsonRpc;
+}
+//# sourceMappingURL=a2a-client.d.ts.map

package/dist/adapters/a2a-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-client.d.ts","sourceRoot":"","sources":["../../src/adapters/a2a-client.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,UAAU,EAEX,MAAM,iBAAiB,CAAC;AAUzB,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,EAAE,eAAe;IAS7B,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC;IAQvC,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAalD,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAazC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzC,iBAAiB,CACrB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC;IA6Bb,iBAAiB,CACrB,OAAO,EAAE,UAAU,EACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,EACtD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC;IA2EnB,OAAO,CAAC,YAAY;YAWN,OAAO;YAUP,OAAO;CAqBtB"}

package/dist/adapters/a2a-client.js

@@ -0,0 +1,178 @@
+// ─── A2AClient ───
+//
+// HTTP/SSE client for A2A (Agent-to-Agent) Protocol v0.3 JSON-RPC calls.
+// Uses Node.js built-in fetch (Node 18+) to avoid external HTTP dependencies.
+import { randomUUID } from "node:crypto";
+import { A2AAgentCardSchema, A2ATaskSchema, A2AJsonRpcResponseSchema, A2A_TERMINAL_STATES, } from "../types/a2a.js";
+// ─── Client ───
+export class A2AClient {
+    baseUrl;
+    authToken;
+    pollIntervalMs;
+    maxWaitMs;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, "");
+        this.authToken = config.authToken;
+        this.pollIntervalMs = config.pollIntervalMs ?? 2_000;
+        this.maxWaitMs = config.maxWaitMs ?? 300_000;
+    }
+    // ─── Agent Card Discovery ───
+    async fetchAgentCard() {
+        const url = `${this.baseUrl}/.well-known/agent.json`;
+        const res = await this.httpGet(url);
+        return A2AAgentCardSchema.parse(res);
+    }
+    // ─── message/send (blocking) ───
+    async sendMessage(message) {
+        const body = {
+            jsonrpc: "2.0",
+            id: randomUUID(),
+            method: "message/send",
+            params: { message },
+        };
+        const res = await this.jsonRpc(body);
+        return A2ATaskSchema.parse(res);
+    }
+    // ─── tasks/get ───
+    async getTask(taskId) {
+        const body = {
+            jsonrpc: "2.0",
+            id: randomUUID(),
+            method: "tasks/get",
+            params: { id: taskId },
+        };
+        const res = await this.jsonRpc(body);
+        return A2ATaskSchema.parse(res);
+    }
+    // ─── tasks/cancel ───
+    async cancelTask(taskId) {
+        const body = {
+            jsonrpc: "2.0",
+            id: randomUUID(),
+            method: "tasks/cancel",
+            params: { id: taskId },
+        };
+        await this.jsonRpc(body);
+    }
+    // ─── Polling loop ───
+    async waitForCompletion(taskId, signal) {
+        const deadline = Date.now() + this.maxWaitMs;
+        while (Date.now() < deadline) {
+            if (signal?.aborted) {
+                throw new Error("A2A task wait aborted");
+            }
+            const task = await this.getTask(taskId);
+            if (A2A_TERMINAL_STATES.has(task.status.state)) {
+                return task;
+            }
+            await sleep(this.pollIntervalMs);
+        }
+        // Attempt cancel on timeout
+        try {
+            await this.cancelTask(taskId);
+        }
+        catch {
+            /* best-effort */
+        }
+        throw new Error(`A2A task ${taskId} did not complete within ${this.maxWaitMs}ms`);
+    }
+    // ─── SSE streaming (message/stream) ───
+    async sendMessageStream(message, onStatus, signal) {
+        const body = {
+            jsonrpc: "2.0",
+            id: randomUUID(),
+            method: "message/stream",
+            params: { message },
+        };
+        const res = await fetch(`${this.baseUrl}`, {
+            method: "POST",
+            headers: this.buildHeaders(),
+            body: JSON.stringify(body),
+            signal,
+        });
+        if (!res.ok) {
+            throw new Error(`A2A stream request failed: ${res.status} ${res.statusText}`);
+        }
+        if (!res.body) {
+            throw new Error("A2A stream response has no body");
+        }
+        // Parse SSE events from the response stream
+        let latestTask = null;
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        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 = line.slice(6).trim();
+                    if (!data || data === "[DONE]")
+                        continue;
+                    try {
+                        const parsed = JSON.parse(data);
+                        const kind = parsed.kind;
+                        if (kind === "task" || (!kind && parsed.id && parsed.status)) {
+                            latestTask = A2ATaskSchema.parse(parsed);
+                        }
+                        else if (kind === "status-update" && parsed.status) {
+                            const status = parsed.status;
+                            if (status.state) {
+                                onStatus?.(status.state, status.message);
+                            }
+                        }
+                        // artifact-update events are accumulated in the task object
+                    }
+                    catch {
+                        // Skip malformed SSE data lines
+                    }
+                }
+            }
+        }
+        if (!latestTask) {
+            throw new Error("A2A stream ended without returning a task");
+        }
+        return latestTask;
+    }
+    // ─── Private ───
+    buildHeaders() {
+        const headers = {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+        };
+        if (this.authToken) {
+            headers["Authorization"] = `Bearer ${this.authToken}`;
+        }
+        return headers;
+    }
+    async httpGet(url) {
+        const res = await fetch(url, { headers: this.buildHeaders() });
+        if (!res.ok) {
+            throw new Error(`A2A GET ${url} failed: ${res.status} ${res.statusText}`);
+        }
+        return res.json();
+    }
+    async jsonRpc(body) {
+        const res = await fetch(`${this.baseUrl}`, {
+            method: "POST",
+            headers: this.buildHeaders(),
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            throw new Error(`A2A JSON-RPC failed: ${res.status} ${res.statusText}`);
+        }
+        const json = A2AJsonRpcResponseSchema.parse(await res.json());
+        if (json.error) {
+            throw new Error(`A2A JSON-RPC error ${json.error.code}: ${json.error.message}`);
+        }
+        return json.result;
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=a2a-client.js.map

package/dist/adapters/a2a-client.js.map

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

package/dist/adapters/browser-use-cli.d.ts

@@ -0,0 +1,19 @@
+import type { IAdapter, AgentTask, AgentResult } from "../execution/adapter-layer.js";
+export interface BrowserUseCLIAdapterConfig {
+    /** The executable name / path for the browser-use CLI. Default: "browser-use" */
+    cliPath?: string;
+    /** Whether to run the browser in headless mode. Default: true */
+    headless?: boolean;
+    /** Whether to request JSON-formatted output. Default: true */
+    jsonOutput?: boolean;
+}
+export declare class BrowserUseCLIAdapter implements IAdapter {
+    readonly adapterType = "browser_use_cli";
+    readonly capabilities: readonly ["browse_web", "web_scraping", "form_filling", "screenshot"];
+    private readonly cliPath;
+    private readonly headless;
+    private readonly jsonOutput;
+    constructor(config?: BrowserUseCLIAdapterConfig);
+    execute(task: AgentTask): Promise<AgentResult>;
+}
+//# sourceMappingURL=browser-use-cli.d.ts.map

package/dist/adapters/browser-use-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-use-cli.d.ts","sourceRoot":"","sources":["../../src/adapters/browser-use-cli.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAGtF,MAAM,WAAW,0BAA0B;IACzC,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,oBAAqB,YAAW,QAAQ;IACnD,QAAQ,CAAC,WAAW,qBAAqB;IACzC,QAAQ,CAAC,YAAY,wEAAyE;IAE9F,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;gBAEzB,MAAM,GAAE,0BAA+B;IAM7C,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAwDrD"}

package/dist/adapters/browser-use-cli.js

@@ -0,0 +1,70 @@
+// ─── BrowserUseCLIAdapter ───
+//
+// IAdapter implementation that spawns the `browser-use` CLI process.
+// The task prompt is passed via stdin to avoid exposing it in the
+// process argument list (visible via `ps aux`).
+// Uses --headless for non-interactive browser automation and --json
+// for structured output.
+//
+// Invocation pattern:
+//   echo "<prompt>" | browser-use run --headless --json
+//
+// The CLI takes a natural language task, controls a browser with AI,
+// and returns the result (JSON when --json is used).
+import { spawnWithTimeout } from "./spawn-helper.js";
+export class BrowserUseCLIAdapter {
+    adapterType = "browser_use_cli";
+    capabilities = ["browse_web", "web_scraping", "form_filling", "screenshot"];
+    cliPath;
+    headless;
+    jsonOutput;
+    constructor(config = {}) {
+        this.cliPath = config.cliPath ?? "browser-use";
+        this.headless = config.headless !== false;
+        this.jsonOutput = config.jsonOutput !== false;
+    }
+    async execute(task) {
+        const startedAt = Date.now();
+        // Build argument list: run [--headless] [--json]
+        // Prompt is written to stdin to avoid exposure in `ps aux`.
+        const spawnArgs = ["run"];
+        if (this.headless) {
+            spawnArgs.push("--headless");
+        }
+        if (this.jsonOutput) {
+            spawnArgs.push("--json");
+        }
+        const result = await spawnWithTimeout(this.cliPath, spawnArgs, { env: process.env, stdinData: task.prompt }, task.timeout_ms);
+        const elapsed = Date.now() - startedAt;
+        if (result.timedOut) {
+            return {
+                success: false,
+                output: result.stdout,
+                error: `Timed out after ${task.timeout_ms}ms`,
+                exit_code: result.exitCode,
+                elapsed_ms: elapsed,
+                stopped_reason: "timeout",
+            };
+        }
+        if (result.exitCode === null) {
+            return {
+                success: false,
+                output: result.stdout,
+                error: result.stderr,
+                exit_code: null,
+                elapsed_ms: elapsed,
+                stopped_reason: "error",
+            };
+        }
+        const success = result.exitCode === 0;
+        return {
+            success,
+            output: result.stdout,
+            error: success ? null : result.stderr || `Process exited with code ${result.exitCode}`,
+            exit_code: result.exitCode,
+            elapsed_ms: elapsed,
+            stopped_reason: success ? "completed" : "error",
+        };
+    }
+}
+//# sourceMappingURL=browser-use-cli.js.map

package/dist/adapters/browser-use-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-use-cli.js","sourceRoot":"","sources":["../../src/adapters/browser-use-cli.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,EAAE;AACF,qEAAqE;AACrE,kEAAkE;AAClE,gDAAgD;AAChD,oEAAoE;AACpE,yBAAyB;AACzB,EAAE;AACF,sBAAsB;AACtB,wDAAwD;AACxD,EAAE;AACF,qEAAqE;AACrE,qDAAqD;AAGrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAWrD,MAAM,OAAO,oBAAoB;IACtB,WAAW,GAAG,iBAAiB,CAAC;IAChC,YAAY,GAAG,CAAC,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,CAAU,CAAC;IAE7E,OAAO,CAAS;IAChB,QAAQ,CAAU;IAClB,UAAU,CAAU;IAErC,YAAY,SAAqC,EAAE;QACjD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,aAAa,CAAC;QAC/C,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,KAAK,KAAK,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAe;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,iDAAiD;QACjD,4DAA4D;QAC5D,MAAM,SAAS,GAAa,CAAC,KAAK,CAAC,CAAC;QAEpC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACnC,IAAI,CAAC,OAAO,EACZ,SAAS,EACT,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,EAC5C,IAAI,CAAC,UAAU,CAChB,CAAC;QAEF,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAEvC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK,EAAE,mBAAmB,IAAI,CAAC,UAAU,IAAI;gBAC7C,SAAS,EAAE,MAAM,CAAC,QAAQ;gBAC1B,UAAU,EAAE,OAAO;gBACnB,cAAc,EAAE,SAAS;aAC1B,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC7B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,KAAK,EAAE,MAAM,CAAC,MAAM;gBACpB,SAAS,EAAE,IAAI;gBACf,UAAU,EAAE,OAAO;gBACnB,cAAc,EAAE,OAAO;aACxB,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC;QACtC,OAAO;YACL,OAAO;YACP,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,4BAA4B,MAAM,CAAC,QAAQ,EAAE;YACtF,SAAS,EAAE,MAAM,CAAC,QAAQ;YAC1B,UAAU,EAAE,OAAO;YACnB,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO;SAChD,CAAC;IACJ,CAAC;CACF"}

package/dist/adapters/claude-api.d.ts

@@ -0,0 +1,10 @@
+import type { IAdapter, AgentTask, AgentResult } from "../execution/adapter-layer.js";
+import type { ILLMClient } from "../llm/llm-client.js";
+export declare class ClaudeAPIAdapter implements IAdapter {
+    readonly adapterType = "claude_api";
+    readonly capabilities: readonly ["text_generation", "analysis", "planning"];
+    private readonly llmClient;
+    constructor(llmClient: ILLMClient);
+    execute(task: AgentTask): Promise<AgentResult>;
+}
+//# sourceMappingURL=claude-api.d.ts.map

package/dist/adapters/claude-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-api.d.ts","sourceRoot":"","sources":["../../src/adapters/claude-api.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,QAAQ,CAAC,WAAW,gBAAgB;IACpC,QAAQ,CAAC,YAAY,uDAAwD;IAE7E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAa;gBAE3B,SAAS,EAAE,UAAU;IAI3B,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAqDrD"}

package/dist/adapters/claude-api.js

@@ -0,0 +1,63 @@
+// ─── ClaudeAPIAdapter ───
+//
+// IAdapter implementation that wraps ILLMClient.sendMessage().
+// Intended for tasks where a single LLM call is sufficient.
+// Timeout is handled via Promise.race().
+export class ClaudeAPIAdapter {
+    adapterType = "claude_api";
+    capabilities = ["text_generation", "analysis", "planning"];
+    llmClient;
+    constructor(llmClient) {
+        this.llmClient = llmClient;
+    }
+    async execute(task) {
+        const startedAt = Date.now();
+        // Build a timeout promise that resolves to a timeout AgentResult.
+        let timeoutHandle;
+        const timeoutPromise = new Promise((resolve) => {
+            timeoutHandle = setTimeout(() => {
+                resolve({
+                    success: false,
+                    output: "",
+                    error: `Timed out after ${task.timeout_ms}ms`,
+                    exit_code: null,
+                    elapsed_ms: Date.now() - startedAt,
+                    stopped_reason: "timeout",
+                });
+            }, task.timeout_ms);
+        });
+        // The actual LLM call.
+        const llmPromise = (async () => {
+            try {
+                const response = await this.llmClient.sendMessage([
+                    { role: "user", content: task.prompt },
+                ]);
+                return {
+                    success: true,
+                    output: response.content,
+                    error: null,
+                    exit_code: null,
+                    elapsed_ms: Date.now() - startedAt,
+                    stopped_reason: "completed",
+                };
+            }
+            catch (err) {
+                return {
+                    success: false,
+                    output: "",
+                    error: err instanceof Error ? err.message : String(err),
+                    exit_code: null,
+                    elapsed_ms: Date.now() - startedAt,
+                    stopped_reason: "error",
+                };
+            }
+        })();
+        const result = await Promise.race([llmPromise, timeoutPromise]);
+        // Clear the timeout once a result is determined.
+        if (timeoutHandle !== undefined) {
+            clearTimeout(timeoutHandle);
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=claude-api.js.map

package/dist/adapters/claude-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-api.js","sourceRoot":"","sources":["../../src/adapters/claude-api.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,EAAE;AACF,+DAA+D;AAC/D,4DAA4D;AAC5D,yCAAyC;AAKzC,MAAM,OAAO,gBAAgB;IAClB,WAAW,GAAG,YAAY,CAAC;IAC3B,YAAY,GAAG,CAAC,iBAAiB,EAAE,UAAU,EAAE,UAAU,CAAU,CAAC;IAE5D,SAAS,CAAa;IAEvC,YAAY,SAAqB;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAe;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,kEAAkE;QAClE,IAAI,aAAwD,CAAC;QAC7D,MAAM,cAAc,GAAyB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACnE,aAAa,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,OAAO,CAAC;oBACN,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,mBAAmB,IAAI,CAAC,UAAU,IAAI;oBAC7C,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,cAAc,EAAE,SAAS;iBAC1B,CAAC,CAAC;YACL,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,uBAAuB;QACvB,MAAM,UAAU,GAAyB,CAAC,KAAK,IAAI,EAAE;YACnD,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;oBAChD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE;iBACvC,CAAC,CAAC;gBACH,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,MAAM,EAAE,QAAQ,CAAC,OAAO;oBACxB,KAAK,EAAE,IAAI;oBACX,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,cAAc,EAAE,WAAoB;iBACrC,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;oBACvD,SAAS,EAAE,IAAI;oBACf,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;oBAClC,cAAc,EAAE,OAAgB;iBACjC,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;QAEhE,iDAAiD;QACjD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,YAAY,CAAC,aAAa,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/adapters/claude-code-cli.d.ts

@@ -0,0 +1,14 @@
+import type { IAdapter, AgentTask, AgentResult } from "../execution/adapter-layer.js";
+export declare class ClaudeCodeCLIAdapter implements IAdapter {
+    readonly adapterType = "claude_code_cli";
+    readonly capabilities: readonly ["execute_code", "read_files", "write_files", "run_commands"];
+    /**
+     * The executable name / path for the claude CLI.
+     * Override in tests to point at a different binary (e.g. "echo").
+     */
+    private readonly cliPath;
+    private readonly workDir;
+    constructor(cliPath?: string, workDir?: string);
+    execute(task: AgentTask): Promise<AgentResult>;
+}
+//# sourceMappingURL=claude-code-cli.d.ts.map

package/dist/adapters/claude-code-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-cli.d.ts","sourceRoot":"","sources":["../../src/adapters/claude-code-cli.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAGtF,qBAAa,oBAAqB,YAAW,QAAQ;IACnD,QAAQ,CAAC,WAAW,qBAAqB;IACzC,QAAQ,CAAC,YAAY,yEAA0E;IAE/F;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,OAAO,GAAE,MAAiB,EAAE,OAAO,CAAC,EAAE,MAAM;IAKlD,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;CAwBrD"}