pulseed 0.4.17 → 0.4.19

package/README.md

@@ -39,15 +39,22 @@ menu of subcommands.
 - Goal-first orchestration for long-running work
 - Honest goal negotiation when a target is not realistic as stated
 - Bounded agent execution with verification around delegated work
+- Verified playbook memory that turns successful runs into reusable planning hints
 - Local persistent state under `~/.pulseed/`
 - Multiple runtime surfaces: CLI, chat, TUI, daemon, and cron
 - Support for OpenAI, Anthropic, Ollama, and adapter-based execution paths
 
 ## Start Here
 
-PulSeed requires Node.js 22 or 24.
+PulSeed supports Node.js 22 and 24. The default install path below uses Node.js 24 via nvm.
 
 ```bash
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
+export NVM_DIR="$HOME/.nvm"
+[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+nvm install 24
+nvm use 24
+nvm alias default 24
 npm install -g pulseed
 pulseed
 ```
@@ -67,6 +74,11 @@ default for most users is `agent_loop` with OpenAI or Anthropic.
   verify, or stop
 - `AgentLoop` handles bounded tool-using work for task execution, chat, and
   selected runtime phases
+- Centralized AgentLoop profiles keep task execution isolated by default,
+  narrow chat permissions, and run `/review` through a dedicated read-only
+  review posture
+- Dream-backed playbooks can feed verified workflow hints into later task
+  generation without auto-writing executable skills
 - State, reports, schedules, and local memory live under `~/.pulseed/`
 - Software-level approval and verification gates protect delegated work
 

package/dist/adapters/agents/a2a-adapter.d.ts

@@ -0,0 +1,49 @@
+import type { IAdapter, AgentTask, AgentResult } from "../../orchestrator/execution/adapter-layer.js";
+import type { A2AClientConfig } from "./a2a-client.js";
+export interface A2AAdapterConfig extends A2AClientConfig {
+    /**
+     * Adapter type string registered in AdapterRegistry.
+     * Default: "a2a". Override to register multiple A2A agents
+     * (e.g., "a2a_research_agent", "a2a_code_agent").
+     */
+    adapterType?: string;
+    /**
+     * Override capabilities instead of deriving from Agent Card skills.
+     * If not set, capabilities are fetched from the Agent Card on first use.
+     */
+    capabilities?: string[];
+    /**
+     * Prefer SSE streaming over polling. Default: true.
+     * Falls back to polling if the agent does not advertise streaming support.
+     */
+    preferStreaming?: boolean;
+    /**
+     * Context ID for multi-turn conversations. If set, all tasks sent through
+     * this adapter share the same A2A conversation context.
+     */
+    contextId?: string;
+}
+export declare class A2AAdapter implements IAdapter {
+    readonly adapterType: string;
+    private readonly client;
+    private readonly preferStreaming;
+    private readonly contextId?;
+    private resolvedCapabilities;
+    private agentCard;
+    constructor(config: A2AAdapterConfig);
+    get capabilities(): readonly string[];
+    /**
+     * 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).
+     */
+    discoverCapabilities(): Promise<void>;
+    execute(task: AgentTask): Promise<AgentResult>;
+    private mapTaskToResult;
+    /**
+     * Extract text content from A2A artifacts and history.
+     * Concatenates all text parts from artifacts (preferred) or last agent message.
+     */
+    private extractTextOutput;
+}
+//# sourceMappingURL=a2a-adapter.d.ts.map

package/dist/adapters/agents/a2a-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-adapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/a2a-adapter.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,WAAW,EACZ,MAAM,+CAA+C,CAAC;AAEvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMvD,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,qBAAa,UAAW,YAAW,QAAQ;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,oBAAoB,CAAkB;IAC9C,OAAO,CAAC,SAAS,CAA6B;gBAElC,MAAM,EAAE,gBAAgB;IAQpC,IAAI,YAAY,IAAI,SAAS,MAAM,EAAE,CAEpC;IAED;;;;OAIG;IACG,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAcrC,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC;IAsFpD,OAAO,CAAC,eAAe;IA2EvB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;CA+B1B"}

package/dist/adapters/agents/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 "../../base/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/agents/a2a-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-adapter.js","sourceRoot":"","sources":["../../../src/adapters/agents/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,yBAAyB,CAAC;AA4B9D,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/agents/a2a-client.d.ts

@@ -0,0 +1,28 @@
+import type { A2AAgentCard, A2ATask, A2ATaskState, A2AMessage } from "../../base/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/agents/a2a-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a-client.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/a2a-client.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,UAAU,EAEX,MAAM,yBAAyB,CAAC;AAUjC,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/agents/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 "../../base/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/agents/a2a-client.js.map

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

package/dist/adapters/agents/agent-profile-loader.d.ts

@@ -0,0 +1,26 @@
+import { type AgentProfileWithPrompt } from "../../base/types/agent-profile.js";
+export declare class AgentProfileLoader {
+    private readonly agentsDir;
+    constructor(agentsDir: string);
+    /** Load all *.md files from agentsDir. Skips invalid files with a warning. */
+    loadAll(): Promise<AgentProfileWithPrompt[]>;
+    /** Load and validate a single agent profile file. Throws on invalid content. */
+    loadOne(filePath: string): Promise<AgentProfileWithPrompt>;
+    /**
+     * Split content on --- delimiters and parse YAML frontmatter.
+     * Expects format:
+     *   ---
+     *   key: value
+     *   ---
+     *   body text
+     */
+    static parseFrontmatter(content: string): {
+        frontmatter: Record<string, unknown>;
+        body: string;
+    };
+    /** Find a profile by exact name. Returns null if not found. */
+    findByName(profiles: AgentProfileWithPrompt[], name: string): AgentProfileWithPrompt | null;
+    /** Find all profiles that include the given capability. */
+    findByCapability(profiles: AgentProfileWithPrompt[], capability: string): AgentProfileWithPrompt[];
+}
+//# sourceMappingURL=agent-profile-loader.d.ts.map

package/dist/adapters/agents/agent-profile-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-profile-loader.d.ts","sourceRoot":"","sources":["../../../src/adapters/agents/agent-profile-loader.ts"],"names":[],"mappings":"AAQA,OAAO,EAAsB,KAAK,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAIpG,qBAAa,kBAAkB;IACjB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,MAAM;IAE9C,8EAA8E;IACxE,OAAO,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;IAyBlD,gFAAgF;IAC1E,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAOhE;;;;;;;OAOG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IA8BhG,+DAA+D;IAC/D,UAAU,CAAC,QAAQ,EAAE,sBAAsB,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAI3F,2DAA2D;IAC3D,gBAAgB,CAAC,QAAQ,EAAE,sBAAsB,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,sBAAsB,EAAE;CAGnG"}

package/dist/adapters/agents/agent-profile-loader.js

@@ -0,0 +1,88 @@
+// ─── AgentProfileLoader ───
+//
+// Loads agent definition files from ~/.pulseed/agents/*.md.
+// Each file has YAML frontmatter (AgentProfile fields) + a system prompt body.
+import * as fsp from "node:fs/promises";
+import * as path from "node:path";
+import yaml from "js-yaml";
+import { AgentProfileSchema } from "../../base/types/agent-profile.js";
+// ─── AgentProfileLoader ───
+export class AgentProfileLoader {
+    agentsDir;
+    constructor(agentsDir) {
+        this.agentsDir = agentsDir;
+    }
+    /** Load all *.md files from agentsDir. Skips invalid files with a warning. */
+    async loadAll() {
+        let entries;
+        try {
+            entries = await fsp.readdir(this.agentsDir);
+        }
+        catch {
+            return [];
+        }
+        const mdFiles = entries.filter((e) => e.endsWith(".md"));
+        const results = [];
+        for (const file of mdFiles) {
+            const filePath = path.join(this.agentsDir, file);
+            try {
+                const profile = await this.loadOne(filePath);
+                results.push(profile);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.warn(`[agent-profile-loader] Skipping ${file}: ${msg}`);
+            }
+        }
+        return results;
+    }
+    /** Load and validate a single agent profile file. Throws on invalid content. */
+    async loadOne(filePath) {
+        const content = await fsp.readFile(filePath, "utf-8");
+        const { frontmatter, body } = AgentProfileLoader.parseFrontmatter(content);
+        const parsed = AgentProfileSchema.parse(frontmatter);
+        return { ...parsed, system_prompt: body.trim(), file_path: filePath };
+    }
+    /**
+     * Split content on --- delimiters and parse YAML frontmatter.
+     * Expects format:
+     *   ---
+     *   key: value
+     *   ---
+     *   body text
+     */
+    static parseFrontmatter(content) {
+        const lines = content.split("\n");
+        // Must start with ---
+        if (lines[0]?.trim() !== "---") {
+            return { frontmatter: {}, body: content };
+        }
+        // Find the closing ---
+        const closeIdx = lines.findIndex((line, i) => i > 0 && line.trim() === "---");
+        if (closeIdx === -1) {
+            return { frontmatter: {}, body: content };
+        }
+        const yamlLines = lines.slice(1, closeIdx).join("\n");
+        const bodyLines = lines.slice(closeIdx + 1).join("\n");
+        let frontmatter;
+        try {
+            const parsed = yaml.load(yamlLines);
+            frontmatter = (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed))
+                ? parsed
+                : {};
+        }
+        catch {
+            frontmatter = {};
+        }
+        return { frontmatter, body: bodyLines };
+    }
+    /** Find a profile by exact name. Returns null if not found. */
+    findByName(profiles, name) {
+        return profiles.find((p) => p.name === name) ?? null;
+    }
+    /** Find all profiles that include the given capability. */
+    findByCapability(profiles, capability) {
+        return profiles.filter((p) => p.capabilities.includes(capability));
+    }
+}
+//# sourceMappingURL=agent-profile-loader.js.map

package/dist/adapters/agents/agent-profile-loader.js.map

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