@automagik/omni 2.260520.20 → 2.260524.1

package/dist/commands/a2a.d.ts

@@ -0,0 +1,10 @@
+/**
+ * A2A Commands
+ *
+ * omni a2a list [--include-unconfigured]
+ * omni a2a card <agent-id>
+ * omni a2a send <instance-id> --text <message> [--context <id>] [--task <id>] [--wait]
+ */
+import { Command } from 'commander';
+export declare function createA2ACommand(): Command;
+//# sourceMappingURL=a2a.d.ts.map

package/dist/commands/a2a.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2a.d.ts","sourceRoot":"","sources":["../../src/commands/a2a.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC,wBAAgB,gBAAgB,IAAI,OAAO,CAmE1C"}

package/dist/commands/instances.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../src/commands/instances.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgMpC,wBAAgB,sBAAsB,IAAI,OAAO,CAkuChD"}
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../src/commands/instances.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiMpC,wBAAgB,sBAAsB,IAAI,OAAO,CAkuChD"}

package/dist/index.js

@@ -24083,11 +24083,13 @@ async function getStreamInfo(jsm) {
   }
   return result;
 }
-var import_nats, log, STREAM_NAMES, daysToNs = (days) => days * 24 * 60 * 60 * 1e9, STREAM_CONFIGS;
+var nats, log, NATS_STORAGE_FILE, NATS_RETENTION_LIMITS, STREAM_NAMES, daysToNs = (days) => days * 24 * 60 * 60 * 1e9, STREAM_CONFIGS;
 var init_streams = __esm(() => {
   init_logger();
-  import_nats = __toESM(require_mod4(), 1);
+  nats = __toESM(require_mod4(), 1);
   log = createLogger("nats:streams");
+  NATS_STORAGE_FILE = nats.StorageType.File;
+  NATS_RETENTION_LIMITS = nats.RetentionPolicy.Limits;
   STREAM_NAMES = {
     MESSAGE: "MESSAGE",
     REACTION: "REACTION",
@@ -24105,80 +24107,80 @@ var init_streams = __esm(() => {
       name: STREAM_NAMES.MESSAGE,
       subjects: ["message.>"],
       max_age: daysToNs(30),
-      storage: import_nats.StorageType.File,
-      retention: import_nats.RetentionPolicy.Limits,
+      storage: NATS_STORAGE_FILE,
+      retention: NATS_RETENTION_LIMITS,
       description: "All message lifecycle events (received, sent, delivered, read, failed)"
     },
     [STREAM_NAMES.REACTION]: {
       name: STREAM_NAMES.REACTION,
       subjects: ["reaction.>"],
       max_age: daysToNs(7),
-      storage: import_nats.StorageType.File,
-      retention: import_nats.RetentionPolicy.Limits,
+      storage: NATS_STORAGE_FILE,
+      retention: NATS_RETENTION_LIMITS,
       description: "Reaction events (received, removed)"
     },
     [STREAM_NAMES.INSTANCE]: {
       name: STREAM_NAMES.INSTANCE,
       subjects: ["instance.>"],
       max_age: daysToNs(7),
-      storage: import_nats.StorageType.File,
-      retention: import_nats.RetentionPolicy.Limits,
+      storage: NATS_STORAGE_FILE,
+      retention: NATS_RETENTION_LIMITS,
       description: "Instance lifecycle events (connected, disconnected, qr_code)"
     },
     [STREAM_NAMES.IDENTITY]: {
       name: STREAM_NAMES.IDENTITY,
       subjects: ["identity.>"],
       max_age: daysToNs(90),
-      storage: import_nats.StorageType.File,
-      retention: import_nats.RetentionPolicy.Limits,
+      storage: NATS_STORAGE_FILE,
+      retention: NATS_RETENTION_LIMITS,
       description: "Identity management events (created, linked, merged, unlinked)"
     },
     [STREAM_NAMES.MEDIA]: {
       name: STREAM_NAMES.MEDIA,
       subjects: ["media.>"],
       max_age: daysToNs(7),
-      storage: import_nats.StorageType.File,
-      retention: import_nats.RetentionPolicy.Limits,
+      storage: NATS_STORAGE_FILE,
+      retention: NATS_RETENTION_LIMITS,
       description: "Media processing events (received, processed)"
     },
     [STREAM_NAMES.ACCESS]: {
       name: STREAM_NAMES.ACCESS,
       subjects: ["access.>"],
       max_age: daysToNs(30),
-      storage: import_nats.StorageType.File,
-      retention: import_nats.RetentionPolicy.Limits,
+      storage: NATS_STORAGE_FILE,
+      retention: NATS_RETENTION_LIMITS,
       description: "Access control events (allowed, denied)"
     },
     [STREAM_NAMES.SESSION]: {
       name: STREAM_NAMES.SESSION,
       subjects: ["session.>"],
       max_age: daysToNs(7),
-      storage: import_nats.StorageType.File,
-      retention: import_nats.RetentionPolicy.Limits,
+      storage: NATS_STORAGE_FILE,
+      retention: NATS_RETENTION_LIMITS,
       description: "Session lifecycle events (reset)"
     },
     [STREAM_NAMES.CUSTOM]: {
       name: STREAM_NAMES.CUSTOM,
       subjects: ["custom.>"],
       max_age: daysToNs(7),
-      storage: import_nats.StorageType.File,
-      retention: import_nats.RetentionPolicy.Limits,
+      storage: NATS_STORAGE_FILE,
+      retention: NATS_RETENTION_LIMITS,
       description: "User-defined custom events (webhooks, triggers, etc.)"
     },
     [STREAM_NAMES.SYSTEM]: {
       name: STREAM_NAMES.SYSTEM,
       subjects: ["system.>", "sync.>", "batch-job.>", "presence.>", "chat.>", "follow_up.>"],
       max_age: daysToNs(7),
-      storage: import_nats.StorageType.File,
-      retention: import_nats.RetentionPolicy.Limits,
+      storage: NATS_STORAGE_FILE,
+      retention: NATS_RETENTION_LIMITS,
       description: "Internal system events (dead_letter, replay, health, sync, batch-job, presence, chat, follow_up)"
     },
     [STREAM_NAMES.AGENT]: {
       name: STREAM_NAMES.AGENT,
       subjects: ["agent.>"],
       max_age: daysToNs(30),
-      storage: import_nats.StorageType.File,
-      retention: import_nats.RetentionPolicy.Limits,
+      storage: NATS_STORAGE_FILE,
+      retention: NATS_RETENTION_LIMITS,
       description: "Agent lifecycle events (state, tasks, A2A, internal routing)"
     }
   };
@@ -24195,7 +24197,7 @@ function buildConsumerConfig(pattern, options = {}) {
   } = options;
   const config2 = {
     filter_subject: pattern,
-    ack_policy: import_nats2.AckPolicy.Explicit,
+    ack_policy: nats2.AckPolicy.Explicit,
     ack_wait: ackWaitMs * 1e6,
     max_deliver: maxRetries + 1,
     max_ack_pending: DEFAULT_CONSUMER_CONFIG.maxAckPending,
@@ -24213,15 +24215,15 @@ function buildConsumerConfig(pattern, options = {}) {
 }
 function mapStartFrom(startFrom) {
   if (startFrom instanceof Date) {
-    return import_nats2.DeliverPolicy.StartTime;
+    return nats2.DeliverPolicy.StartTime;
   }
   switch (startFrom) {
     case "first":
-      return import_nats2.DeliverPolicy.All;
+      return nats2.DeliverPolicy.All;
     case "last":
-      return import_nats2.DeliverPolicy.Last;
+      return nats2.DeliverPolicy.Last;
     default:
-      return import_nats2.DeliverPolicy.New;
+      return nats2.DeliverPolicy.New;
   }
 }
 function generateConsumerName(pattern) {
@@ -24244,10 +24246,10 @@ function calculateBackoffDelay(retryCount, baseDelayMs = DEFAULT_CONSUMER_CONFIG
   const jitter = delay * 0.1 * (Math.random() * 2 - 1);
   return Math.floor(Math.min(delay + jitter, maxDelayMs));
 }
-var import_nats2, DEFAULT_CONSUMER_CONFIG;
+var nats2, DEFAULT_CONSUMER_CONFIG;
 var init_consumer = __esm(() => {
   init_streams();
-  import_nats2 = __toESM(require_mod4(), 1);
+  nats2 = __toESM(require_mod4(), 1);
   DEFAULT_CONSUMER_CONFIG = {
     maxRetries: 3,
     retryDelayMs: 1000,
@@ -28633,7 +28635,7 @@ function buildTraceHeaders() {
       return null;
     const flags = (ctx.traceFlags ?? 0).toString(16).padStart(2, "0");
     const traceparent = `00-${ctx.traceId}-${ctx.spanId}-${flags}`;
-    const h = import_nats3.headers();
+    const h = import_nats.headers();
     h.set("traceparent", traceparent);
     h.set("x-trace-id", ctx.traceId);
     h.set("x-span-id", ctx.spanId);
@@ -28648,7 +28650,7 @@ class NatsEventBus {
   js = null;
   jsm = null;
   config;
-  sc = import_nats3.StringCodec();
+  sc = import_nats.StringCodec();
   subscriptionManager = new SubscriptionManager;
   connectionAttempts = 0;
   isClosing = false;
@@ -28681,7 +28683,7 @@ class NatsEventBus {
     }
     try {
       this.connectionAttempts++;
-      this.nc = await import_nats3.connect(connectionOptions);
+      this.nc = await import_nats.connect(connectionOptions);
       this.setupConnectionHandlers();
       this.js = this.nc.jetstream();
       this.jsm = await this.nc.jetstreamManager();
@@ -28956,7 +28958,7 @@ async function connectEventBus(config2) {
   await bus.connect();
   return bus;
 }
-var import_api2, import_nats3, log4, DEFAULTS;
+var import_api2, import_nats, log4, DEFAULTS;
 var init_client = __esm(() => {
   init_logger();
   init_consumer();
@@ -28964,7 +28966,7 @@ var init_client = __esm(() => {
   init_streams();
   init_subscription();
   import_api2 = __toESM(require_src(), 1);
-  import_nats3 = __toESM(require_mod4(), 1);
+  import_nats = __toESM(require_mod4(), 1);
   log4 = createLogger("nats");
   DEFAULTS = {
     url: "nats://localhost:4222",
@@ -29214,8 +29216,10 @@ var init_common = __esm(() => {
     "discord",
     "slack",
     "telegram",
+    "a2a",
     "gupshup",
-    "twilio-whatsapp"
+    "twilio-whatsapp",
+    "internal"
   ]);
   ContentTypeSchema = exports_external.enum([
     "text",
@@ -29244,6 +29248,7 @@ var init_agent2 = __esm(() => {
   AgentCardSchema = exports_external.object({
     name: exports_external.string(),
     url: exports_external.string().optional(),
+    supportedInterfaces: exports_external.array(exports_external.unknown()).optional(),
     version: exports_external.string().optional(),
     skills: exports_external.array(exports_external.unknown()).optional()
   }).passthrough();
@@ -29277,7 +29282,8 @@ var init_agent2 = __esm(() => {
     configPath: exports_external.string().optional(),
     isInternal: exports_external.boolean().default(false),
     isActive: exports_external.boolean().default(true),
-    metadata: MetadataSchema.optional()
+    metadata: MetadataSchema.optional(),
+    agentCard: AgentCardSchema.optional()
   });
   UpdateAgentSchema = CreateAgentSchema.partial();
 });
@@ -61849,7 +61855,7 @@ class A2AClient {
   }
   async run(request) {
     const startMs = Date.now();
-    const body = this.buildJsonRpcRequest("message/send", request);
+    const body = this.buildJsonRpcRequest("SendMessage", request);
     const response = await this.post(body, request.timeoutMs ?? this.defaultTimeoutMs);
     if (!response.ok) {
       throw new ProviderError(`A2A request failed: ${response.status}`, "SERVER_ERROR", response.status);
@@ -61866,13 +61872,13 @@ class A2AClient {
       throw new ProviderError("A2A response missing task.id", "INVALID_RESPONSE");
     }
     const state = task?.status?.state;
-    if (state === "completed" || state === "failed") {
+    if (isTerminalState(state)) {
       return this.taskToProviderResponse(task, taskId, startMs);
     }
     return this.pollUntilComplete(taskId, startMs, request.timeoutMs ?? this.defaultTimeoutMs);
   }
   async* stream(request) {
-    const body = this.buildJsonRpcRequest("message/stream", request);
+    const body = this.buildJsonRpcRequest("SendStreamingMessage", request);
     const controller = new AbortController;
     const timeoutMs = request.timeoutMs ?? this.defaultTimeoutMs;
     const timer = setTimeout(() => controller.abort(), timeoutMs);
@@ -61909,16 +61915,18 @@ class A2AClient {
       const response = await fetch(this.baseUrl, {
         method: "POST",
         headers: this.headers({ "Content-Type": "application/json" }),
-        body: JSON.stringify({ jsonrpc: "2.0", id: "health", method: "tasks/get", params: { id: "ping" } }),
+        body: JSON.stringify({ jsonrpc: "2.0", id: "health", method: "GetTask", params: { id: "ping" } }),
         signal: AbortSignal.timeout(5000)
       });
-      return { healthy: response.ok, latencyMs: Date.now() - start };
+      const healthy = response.status < 500 && response.status !== 401 && response.status !== 403;
+      return { healthy, latencyMs: Date.now() - start, error: healthy ? undefined : `HTTP ${response.status}` };
     } catch (error2) {
       return { healthy: false, latencyMs: Date.now() - start, error: String(error2) };
     }
   }
   headers(extra) {
     return {
+      "A2A-Version": "1.0",
       ...this.apiKey ? { Authorization: `Bearer ${this.apiKey}` } : {},
       ...extra
     };
@@ -61950,12 +61958,13 @@ class A2AClient {
       method,
       params: {
         message: {
-          role: "user",
-          parts: [{ type: "text", text: request.message }],
+          role: "ROLE_USER",
+          parts: [{ text: request.message, mediaType: "text/plain" }],
           messageId: `msg-${crypto.randomUUID()}`
         },
         configuration: {
-          acceptedOutputModes: ["text"]
+          acceptedOutputModes: ["text/plain"],
+          returnImmediately: true
         },
         contextId: request.sessionId
       }
@@ -61998,13 +62007,49 @@ class A2AClient {
     }
   }
   parseSSEEvent(event) {
+    const result = event.result ?? event;
+    return this.parseArtifactUpdate(result) ?? this.parseStatusUpdate(result) ?? this.parseLegacySSEEvent(event);
+  }
+  parseArtifactUpdate(result) {
+    const artifactUpdate = result.taskArtifactUpdate ?? result.artifactUpdate ?? result.artifact_update;
+    if (artifactUpdate) {
+      const artifact = artifactUpdate.artifact;
+      if (!artifact)
+        return null;
+      const text = extractTextFromParts(artifact.parts ?? []);
+      if (!text)
+        return null;
+      return {
+        event: "artifact",
+        content: text,
+        isComplete: false,
+        runId: artifactUpdate.taskId
+      };
+    }
+    return null;
+  }
+  parseStatusUpdate(result) {
+    const statusUpdate = result.taskStatusUpdate ?? result.statusUpdate ?? result.status_update;
+    if (statusUpdate) {
+      const status = statusUpdate.status;
+      const state = status?.state;
+      if (isTerminalState(state)) {
+        return {
+          event: "final",
+          isComplete: true,
+          runId: statusUpdate.taskId
+        };
+      }
+    }
+    return null;
+  }
+  parseLegacySSEEvent(event) {
     const type = event.type;
     if (type === "taskArtifactUpdateEvent") {
       const artifact = event.artifact;
       if (!artifact)
         return null;
-      const parts = artifact.parts ?? [];
-      const textParts = parts.filter((p11) => p11.type === "text").map((p11) => p11.text).join("");
+      const textParts = extractTextFromParts(artifact.parts ?? []);
       if (!textParts)
         return null;
       return {
@@ -62017,7 +62062,7 @@ class A2AClient {
     if (type === "taskStatusUpdateEvent") {
       const status = event.status;
       const state = status?.state;
-      const isFinal = event.final === true || state === "completed" || state === "failed";
+      const isFinal = event.final === true || isTerminalState(state);
       if (isFinal) {
         return {
           event: "final",
@@ -62033,11 +62078,9 @@ class A2AClient {
     const textParts = [];
     for (const artifact of artifacts) {
       const parts = artifact.parts ?? [];
-      for (const part of parts) {
-        if (part.type === "text" && part.text) {
-          textParts.push(part.text);
-        }
-      }
+      const text = extractTextFromParts(parts);
+      if (text)
+        textParts.push(text);
     }
     const status = task?.status;
     const state = status?.state;
@@ -62046,7 +62089,7 @@ class A2AClient {
 `),
       runId: taskId,
       sessionId: task?.contextId ?? taskId,
-      status: state === "failed" ? "failed" : "completed",
+      status: state === "TASK_STATE_COMPLETED" || state === "completed" ? "completed" : "failed",
       metrics: {
         inputTokens: 0,
         outputTokens: 0,
@@ -62063,7 +62106,7 @@ class A2AClient {
       const body = {
         jsonrpc: "2.0",
         id: `poll-${attempt}`,
-        method: "tasks/get",
+        method: "GetTask",
         params: { id: taskId }
       };
       const response = await this.post(body, Math.min(1e4, Math.max(0, deadline - Date.now())));
@@ -62082,7 +62125,7 @@ class A2AClient {
       const task = taskResult?.task;
       const status = task?.status;
       const state = status?.state;
-      if (state === "completed" || state === "failed") {
+      if (isTerminalState(state)) {
         return this.taskToProviderResponse(task, taskId, startMs);
       }
       await sleep3(POLL_INTERVAL_MS);
@@ -62093,6 +62136,12 @@ class A2AClient {
 function sleep3(ms) {
   return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
+function isTerminalState(state) {
+  return state === "TASK_STATE_COMPLETED" || state === "TASK_STATE_FAILED" || state === "TASK_STATE_CANCELED" || state === "TASK_STATE_REJECTED" || state === "TASK_STATE_INPUT_REQUIRED" || state === "TASK_STATE_AUTH_REQUIRED" || state === "completed" || state === "failed" || state === "canceled";
+}
+function extractTextFromParts(parts) {
+  return parts.filter((part) => typeof part.text === "string").map((part) => part.text).join("");
+}
 function createA2AClient(config2) {
   return new A2AClient(config2);
 }
@@ -62228,7 +62277,7 @@ class NatsGenieProvider {
   schema = "nats-genie";
   mode;
   nc = null;
-  sc = import_nats4.StringCodec();
+  sc = import_nats2.StringCodec();
   replySubscription = null;
   constructor(id, name, config2) {
     this.id = id;
@@ -62386,7 +62435,7 @@ class NatsGenieProvider {
   async ensureConnected() {
     if (this.nc)
       return;
-    this.nc = await import_nats4.connect({
+    this.nc = await import_nats2.connect({
       servers: this.config.natsUrl,
       name: `omni-nats-genie-${this.config.instanceId}`,
       reconnect: true,
@@ -62425,10 +62474,10 @@ class NatsGenieProvider {
     }
   }
 }
-var import_nats4, log17;
+var import_nats2, log17;
 var init_nats_genie_provider = __esm(() => {
   init_logger();
-  import_nats4 = __toESM(require_mod4(), 1);
+  import_nats2 = __toESM(require_mod4(), 1);
   log17 = createLogger("provider:nats-genie");
 });
 
@@ -122557,13 +122606,23 @@ function createOmniClient(config) {
     throw new OmniConfigError("apiKey is required");
   }
   const baseUrl = config.baseUrl.replace(/\/$/, "");
+  const authHeader = config.authHeader ?? "x-api-key";
+  const applyAuthHeaders = (headers) => {
+    if (authHeader === "bearer") {
+      headers.set("Authorization", `Bearer ${config.apiKey}`);
+      headers.delete("x-api-key");
+    } else {
+      headers.set("x-api-key", config.apiKey);
+      headers.delete("Authorization");
+    }
+    headers.set("Accept-Encoding", "identity");
+    if (config.cliVersion) {
+      headers.set("x-omni-cli-version", config.cliVersion);
+    }
+  };
   const authMiddleware = {
     async onRequest({ request }) {
-      request.headers.set("x-api-key", config.apiKey);
-      request.headers.set("Accept-Encoding", "identity");
-      if (config.cliVersion) {
-        request.headers.set("x-omni-cli-version", config.cliVersion);
-      }
+      applyAuthHeaders(request.headers);
       if (config.signRequest) {
         const url = new URL(request.url);
         const path = `${url.pathname}${url.search}`;
@@ -122582,11 +122641,7 @@ function createOmniClient(config) {
   };
   const apiFetch = (url, init) => {
     const headers = new Headers(init?.headers);
-    headers.set("x-api-key", config.apiKey);
-    headers.set("Accept-Encoding", "identity");
-    if (config.cliVersion) {
-      headers.set("x-omni-cli-version", config.cliVersion);
-    }
+    applyAuthHeaders(headers);
     if (config.signRequest) {
       const u = new URL(url);
       const path = `${u.pathname}${u.search}`;
@@ -124129,6 +124184,57 @@ function createOmniClient(config) {
         return json.data;
       }
     },
+    a2a: {
+      async listAgents(params) {
+        const search = new URLSearchParams;
+        if (params?.includeUnconfigured !== undefined) {
+          search.set("includeUnconfigured", String(params.includeUnconfigured));
+        }
+        const suffix = search.toString() ? `?${search.toString()}` : "";
+        const resp = await apiFetch(`${baseUrl}/api/v2/a2a/agents${suffix}`);
+        const json = await resp.json();
+        if (!resp.ok)
+          throw OmniApiError.from(json, resp.status);
+        return json.items ?? [];
+      },
+      async getAgentCard(agentId) {
+        const resp = await apiFetch(`${baseUrl}/api/v2/a2a/agents/${agentId}/card`);
+        const json = await resp.json();
+        if (!resp.ok)
+          throw OmniApiError.from(json, resp.status);
+        if (!json.data)
+          throw new OmniApiError("Agent Card not found", "NOT_FOUND", undefined, resp.status);
+        return json.data;
+      },
+      async sendMessage(instanceId, text, options) {
+        const body = {
+          jsonrpc: "2.0",
+          id: `sdk-${Date.now()}`,
+          method: "SendMessage",
+          params: {
+            ...options?.taskId ? { taskId: options.taskId } : {},
+            ...options?.contextId ? { contextId: options.contextId } : {},
+            message: {
+              role: "ROLE_USER",
+              parts: [{ text, mediaType: "text/plain" }]
+            },
+            configuration: {
+              returnImmediately: options?.returnImmediately ?? true
+            }
+          }
+        };
+        const resp = await apiFetch(`${baseUrl}/a2a/${instanceId}`, {
+          method: "POST",
+          headers: { "Content-Type": "application/json", "A2A-Version": "1.0" },
+          body: JSON.stringify(body)
+        });
+        const json = await resp.json();
+        if (!resp.ok || json.error) {
+          throw new OmniApiError(json.error?.message ?? "A2A request failed", String(json.error?.code ?? "A2A_ERROR"), { data: json.error?.data }, resp.status);
+        }
+        return json.result;
+      }
+    },
     agents: {
       async list(params) {
         const { data, error, response } = await client.GET("/agents", {
@@ -124354,7 +124460,7 @@ import { fileURLToPath } from "url";
 // package.json
 var package_default = {
   name: "@automagik/omni",
-  version: "2.260520.20",
+  version: "2.260524.1",
   description: "LLM-optimized CLI for Omni",
   type: "module",
   bin: {
@@ -124557,6 +124663,55 @@ function signRequestIfHandshook() {
   return (method, path, body) => ctx.signRequest(method, path, body);
 }
 
+// src/commands/a2a.ts
+init_output();
+function createA2ACommand() {
+  const a2a = new Command("a2a").description("A2A agent registry and JSON-RPC helpers");
+  a2a.command("list").description("List agents discoverable through A2A").option("--include-unconfigured", "Include active agents that do not have an active A2A instance").action(async (options) => {
+    const client = getClient();
+    try {
+      const agents = await client.a2a.listAgents({ includeUnconfigured: options.includeUnconfigured });
+      const rows = agents.map((agent) => ({
+        id: agent.agentId,
+        name: agent.name,
+        configured: agent.configured ? "yes" : "no",
+        instance: agent.instanceId ?? "-",
+        provider: agent.providerSchema ?? agent.provider ?? "-",
+        model: agent.model ?? "-"
+      }));
+      list(rows, { emptyMessage: "No A2A agents found.", rawData: agents });
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error";
+      error(`Failed to list A2A agents: ${message}`);
+    }
+  });
+  a2a.command("card <agent-id>").description("Get the extended A2A Agent Card for an agent").action(async (agentId) => {
+    const client = getClient();
+    try {
+      const card = await client.a2a.getAgentCard(agentId);
+      data(card);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error";
+      error(`Failed to get A2A Agent Card: ${message}`);
+    }
+  });
+  a2a.command("send <instance-id>").description("Send a text message to an A2A instance").requiredOption("--text <message>", "Text message to send").option("--context <id>", "A2A context id").option("--task <id>", "A2A task id").option("--wait", "Wait for completion instead of returning immediately").action(async (instanceId, options) => {
+    const client = getClient();
+    try {
+      const result = await client.a2a.sendMessage(instanceId, options.text, {
+        contextId: options.context,
+        taskId: options.task,
+        returnImmediately: !options.wait
+      });
+      data(result);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error";
+      error(`Failed to send A2A message: ${message}`);
+    }
+  });
+  return a2a;
+}
+
 // src/commands/access.ts
 init_output();
 function createAccessCommand() {
@@ -131663,6 +131818,7 @@ var VALID_CHANNELS2 = [
   "discord",
   "slack",
   "telegram",
+  "a2a",
   "gupshup",
   "twilio-whatsapp"
 ];
@@ -138173,6 +138329,12 @@ var COMMANDS = [
     helpGroup: "Core",
     helpDescription: "Voice channel operations (join, stream, sessions)"
   },
+  {
+    create: createA2ACommand,
+    category: "standard",
+    helpGroup: "Core",
+    helpDescription: "A2A agent registry and JSON-RPC helpers"
+  },
   {
     create: createChannelsCommand,
     category: "core",