proofscan 0.10.62 → 0.11.1

package/README.ja.md

@@ -24,6 +24,7 @@ proofscan は MCP (Model Context Protocol) サーバー通信の完全な可視
 - 🐚 **[シェルモードガイド](docs/SHELL.ja.md)** - 対話型シェルと @参照
 - 🎭 **[プロキシガイド](docs/PROXY.ja.md)** - MCP プロキシサーバードキュメント
 - 📦 **[POPL ガイド](docs/POPL.ja.md)** - 公開可能証明台帳
+- 🖥️ **[MCP Apps UI](docs/MCP_APPS.ja.md)** - インタラクティブトレースビューア
 - 🔧 **[API ドキュメント](docs/API.ja.md)** - 開発者向け TypeScript API
 
 ## インストール

package/README.md

@@ -30,6 +30,7 @@ proofscan provides complete visibility into MCP (Model Context Protocol) server
 | 📦 **Catalog** | Search and install MCP servers from registry |
 | 📈 **Analyze** | Tool usage analysis across sessions |
 | 📝 **Plans** | Validation plans for automated testing |
+| 🖥️ **MCP Apps** | Interactive trace viewer UI in Claude Desktop |
 | 🌍 **i18n** | Multi-language support (English, 日本語) |
 
 ## Quick Links
@@ -41,6 +42,7 @@ proofscan provides complete visibility into MCP (Model Context Protocol) server
 - 🎭 **[Proxy Guide](docs/PROXY.md)** ([日本語](docs/PROXY.ja.md)) – MCP proxy server
 - 📦 **[POPL Guide](docs/POPL.md)** ([日本語](docs/POPL.ja.md)) – Public Observable Proof Ledger
 - 🔧 **[MCP Server Setup](docs/MCP_SERVER_SETUP_GUIDE.md)** ([日本語](docs/MCP_SERVER_SETUP_GUIDE.ja.md)) – Setting up MCP servers
+- 🖥️ **[MCP Apps UI](docs/MCP_APPS.md)** ([日本語](docs/MCP_APPS.ja.md)) – Interactive trace viewer UI
 
 ### For Developers
 

package/dist/a2a/agent-card.d.ts

@@ -7,6 +7,8 @@ import type { AgentCard } from './types.js';
 export interface FetchAgentCardOptions {
     timeout?: number;
     headers?: Record<string, string>;
+    /** Allow private/local URLs (development only) */
+    allowLocal?: boolean;
 }
 export interface FetchAgentCardResult {
     ok: boolean;

package/dist/a2a/agent-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-card.d.ts","sourceRoot":"","sources":["../../src/a2a/agent-card.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAiDjD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA4BzD;AASD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CA4H/B"}
+{"version":3,"file":"agent-card.d.ts","sourceRoot":"","sources":["../../src/a2a/agent-card.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kDAAkD;IAClD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAiDjD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CA4BzD;AASD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CA4H/B"}

package/dist/a2a/agent-card.js

@@ -111,7 +111,7 @@ function computeHash(body) {
  * @returns FetchAgentCardResult with parsed AgentCard or error
  */
 export async function fetchAgentCard(url, options = {}) {
-    const { timeout = 10000, headers = {} } = options;
+    const { timeout = 10000, headers = {}, allowLocal = false } = options;
     const agentCardUrl = normalizeAgentCardUrl(url);
     // Validate URL format
     try {
@@ -124,7 +124,7 @@ export async function fetchAgentCard(url, options = {}) {
         };
     }
     // SSRF protection: Block private and local URLs
-    if (isPrivateUrl(agentCardUrl)) {
+    if (isPrivateUrl(agentCardUrl) && !allowLocal) {
         return {
             ok: false,
             error: 'Private or local URLs are not allowed',

package/dist/a2a/agent-card.js.map

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

package/dist/a2a/client.d.ts

@@ -2,12 +2,15 @@
  * A2A Client
  *
  * Client for sending messages to A2A agents via JSON-RPC 2.0.
- * Implements message/send, tasks/get, and tasks/cancel operations.
+ * Implements message/send, tasks/get, tasks/list, and tasks/cancel operations.
  *
  * Phase 4 - Client Implementation
+ * Phase 2 - Task Management (getTask, listTasks, cancelTask)
+ * Phase 2.4 - Task DB event recording
  */
-import type { AgentCard, TaskStatusUpdateEvent, TaskArtifactUpdateEvent, StreamMessageResult, A2AMessage, A2ATask } from './types.js';
-export type { A2AMessage, A2ATask } from './types.js';
+import type { AgentCard, TaskStatusUpdateEvent, TaskArtifactUpdateEvent, StreamMessageResult, A2AMessage, A2ATask, Task, ListTasksParams, ListTasksResponse, AgentCapabilities } from './types.js';
+import type { EventsStore } from '../db/events-store.js';
+export type { A2AMessage, A2ATask, Task, ListTasksParams, ListTasksResponse } from './types.js';
 export interface SendMessageOptions {
     timeout?: number;
     headers?: Record<string, string>;
@@ -30,6 +33,29 @@ export interface StreamMessageOptions {
     onError?: (error: string) => void;
     signal?: AbortSignal;
 }
+export interface GetTaskOptions {
+    historyLength?: number;
+    headers?: Record<string, string>;
+    timeout?: number;
+}
+export interface GetTaskResult {
+    ok: boolean;
+    task?: Task;
+    error?: string;
+    statusCode?: number;
+}
+export interface CancelTaskResult {
+    ok: boolean;
+    task?: Task;
+    error?: string;
+    statusCode?: number;
+}
+export interface ListTasksResult {
+    ok: boolean;
+    response?: ListTasksResponse;
+    error?: string;
+    statusCode?: number;
+}
 /**
  * A2A Client for sending messages to agents
  */
@@ -37,27 +63,48 @@ export declare class A2AClient {
     private baseUrl;
     private defaultHeaders;
     private agentCard;
+    private allowLocal;
+    private eventsStore?;
     constructor(agentCard: AgentCard, options?: {
         headers?: Record<string, string>;
+        allowLocal?: boolean;
+        eventsStore?: EventsStore;
     });
+    /**
+     * Get EventsStore instance (Phase 2.4)
+     * @private
+     */
+    private getEventsStore;
     /**
      * Send a message to the agent
      * POST /message/send (JSON-RPC 2.0)
      */
     sendMessage(message: string | A2AMessage, options?: SendMessageOptions): Promise<SendMessageResult>;
     /**
-     * Get task status
-     * POST /tasks/get (JSON-RPC 2.0)
+     * Get task by ID (Phase 2 - A2A Protocol Compliant)
+     * POST /a2a (JSON-RPC 2.0)
+     *
+     * @param taskId - The task ID to retrieve
+     * @param options - Optional: historyLength, headers, timeout
+     * @returns Promise<GetTaskResult> with task or error
+     */
+    getTask(taskId: string, options?: GetTaskOptions): Promise<GetTaskResult>;
+    /**
+     * List tasks with optional filters (Phase 2)
+     * POST /a2a (JSON-RPC 2.0)
+     *
+     * @param params - Optional: contextId, status, pageSize, pageToken, includeArtifacts
+     * @returns Promise<ListTasksResult> with tasks list or error
      */
-    getTask(taskId: string): Promise<SendMessageResult>;
+    listTasks(params?: ListTasksParams): Promise<ListTasksResult>;
     /**
-     * Cancel a task
-     * POST /tasks/cancel (JSON-RPC 2.0)
+     * Cancel a task (Phase 2 - A2A Protocol Compliant)
+     * POST /a2a (JSON-RPC 2.0)
+     *
+     * @param taskId - The task ID to cancel
+     * @returns Promise<CancelTaskResult> with canceled task or error
      */
-    cancelTask(taskId: string): Promise<{
-        ok: boolean;
-        error?: string;
-    }>;
+    cancelTask(taskId: string): Promise<CancelTaskResult>;
     /**
      * Stream message to agent
      * POST /message/stream (JSON-RPC 2.0 + SSE response)
@@ -104,4 +151,19 @@ export declare function createA2AClient(configDir: string, agentId: string): Pro
     ok: false;
     error: string;
 }>;
+/**
+ * Probe agent capabilities (Phase 2.5)
+ *
+ * Detects agent capabilities by:
+ * 1. Checking Agent Card capabilities field (if present)
+ * 2. Probing tasks/list endpoint to detect task support
+ *
+ * Note: Streaming capability is only detected from Agent Card, not probed,
+ * because SSE probing is more complex and unreliable.
+ *
+ * @param agentCard - The agent's Agent Card
+ * @param _allowLocal - Reserved for future use (URL validation)
+ * @returns Promise<AgentCapabilities> with detected capabilities
+ */
+export declare function probeCapabilities(agentCard: AgentCard, _allowLocal?: boolean): Promise<AgentCapabilities>;
 //# sourceMappingURL=client.d.ts.map

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

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

package/dist/a2a/client.js

@@ -2,9 +2,11 @@
  * A2A Client
  *
  * Client for sending messages to A2A agents via JSON-RPC 2.0.
- * Implements message/send, tasks/get, and tasks/cancel operations.
+ * Implements message/send, tasks/get, tasks/list, and tasks/cancel operations.
  *
  * Phase 4 - Client Implementation
+ * Phase 2 - Task Management (getTask, listTasks, cancelTask)
+ * Phase 2.4 - Task DB event recording
  */
 import { randomUUID } from 'crypto';
 import { isPrivateUrl } from './agent-card.js';
@@ -18,11 +20,15 @@ export class A2AClient {
     baseUrl;
     defaultHeaders;
     agentCard;
+    allowLocal;
+    eventsStore; // Phase 2.4: Optional events store for task event recording
     constructor(agentCard, options) {
         this.agentCard = agentCard;
         this.baseUrl = agentCard.url.replace(/\/$/, '');
+        this.allowLocal = options?.allowLocal ?? false;
+        this.eventsStore = options?.eventsStore; // Phase 2.4
         // SSRF protection: Block private URLs in constructor
-        if (isPrivateUrl(this.baseUrl)) {
+        if (isPrivateUrl(this.baseUrl) && !this.allowLocal) {
             throw new Error('Private or local URLs are not allowed');
         }
         this.defaultHeaders = {
@@ -31,16 +37,24 @@ export class A2AClient {
             ...options?.headers,
         };
     }
+    /**
+     * Get EventsStore instance (Phase 2.4)
+     * @private
+     */
+    getEventsStore() {
+        return this.eventsStore;
+    }
     /**
      * Send a message to the agent
      * POST /message/send (JSON-RPC 2.0)
      */
     async sendMessage(message, options = {}) {
         const { timeout = 30000, headers = {}, blocking = false } = options;
-        // Convert string message to A2AMessage
+        // Convert string message to A2AMessage with unique messageId
+        const messageId = randomUUID();
         const a2aMessage = typeof message === 'string'
-            ? { role: 'user', parts: [{ text: message }] }
-            : message;
+            ? { role: 'user', parts: [{ text: message }], messageId }
+            : { ...message, messageId: message.messageId ?? messageId };
         // Build JSON-RPC request with unique ID
         const requestId = randomUUID();
         const request = {
@@ -57,13 +71,13 @@ export class A2AClient {
         const timeoutId = setTimeout(() => controller.abort(), timeout);
         try {
             // SSRF protection (defense-in-depth): Double-check URL even though constructor validates
-            if (isPrivateUrl(this.baseUrl)) {
+            if (isPrivateUrl(this.baseUrl) && !this.allowLocal) {
                 return {
                     ok: false,
                     error: 'Private or local URLs are not allowed',
                 };
             }
-            const response = await fetch(`${this.baseUrl}/message/send`, {
+            const response = await fetch(this.baseUrl, {
                 method: 'POST',
                 headers: { ...this.defaultHeaders, ...headers },
                 body: JSON.stringify(request),
@@ -163,26 +177,34 @@ export class A2AClient {
         }
     }
     /**
-     * Get task status
-     * POST /tasks/get (JSON-RPC 2.0)
+     * Get task by ID (Phase 2 - A2A Protocol Compliant)
+     * POST /a2a (JSON-RPC 2.0)
+     *
+     * @param taskId - The task ID to retrieve
+     * @param options - Optional: historyLength, headers, timeout
+     * @returns Promise<GetTaskResult> with task or error
      */
-    async getTask(taskId) {
+    async getTask(taskId, options = {}) {
+        const { historyLength, headers = {}, timeout = 30000 } = options;
         const requestId = randomUUID();
         const request = {
             jsonrpc: '2.0',
             id: requestId,
             method: 'tasks/get',
             params: {
-                name: `tasks/${taskId}`,
+                id: taskId,
+                ...(historyLength !== undefined && { historyLength }),
             },
         };
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
         try {
-            const response = await fetch(`${this.baseUrl}/tasks/get`, {
+            const response = await fetch(this.baseUrl, {
                 method: 'POST',
-                headers: this.defaultHeaders,
+                headers: { ...this.defaultHeaders, ...headers },
                 body: JSON.stringify(request),
+                signal: controller.signal,
             });
-            // Validate Content-Type
             const contentType = response.headers.get('content-type');
             if (!contentType?.includes('application/json')) {
                 return {
@@ -192,7 +214,6 @@ export class A2AClient {
                 };
             }
             const responseText = await response.text();
-            // Validate response size
             if (responseText.length > MAX_RESPONSE_SIZE) {
                 return {
                     ok: false,
@@ -228,6 +249,105 @@ export class A2AClient {
             const task = this.parseTask(responseData.result);
             return { ok: true, task };
         }
+        catch (error) {
+            if (error instanceof Error) {
+                if (error.name === 'AbortError') {
+                    return {
+                        ok: false,
+                        error: `Request timeout after ${timeout}ms`,
+                    };
+                }
+                return {
+                    ok: false,
+                    error: error.message,
+                };
+            }
+            return {
+                ok: false,
+                error: String(error),
+            };
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * List tasks with optional filters (Phase 2)
+     * POST /a2a (JSON-RPC 2.0)
+     *
+     * @param params - Optional: contextId, status, pageSize, pageToken, includeArtifacts
+     * @returns Promise<ListTasksResult> with tasks list or error
+     */
+    async listTasks(params) {
+        const requestId = randomUUID();
+        const request = {
+            jsonrpc: '2.0',
+            id: requestId,
+            method: 'tasks/list',
+            params: (params || {}),
+        };
+        try {
+            const response = await fetch(this.baseUrl, {
+                method: 'POST',
+                headers: this.defaultHeaders,
+                body: JSON.stringify(request),
+            });
+            const contentType = response.headers.get('content-type');
+            if (!contentType?.includes('application/json')) {
+                return {
+                    ok: false,
+                    statusCode: response.status,
+                    error: `Expected JSON response, got ${contentType || 'unknown'}`,
+                };
+            }
+            const responseText = await response.text();
+            if (responseText.length > MAX_RESPONSE_SIZE) {
+                return {
+                    ok: false,
+                    statusCode: response.status,
+                    error: `Response too large: ${responseText.length} bytes (max ${MAX_RESPONSE_SIZE})`,
+                };
+            }
+            let responseData;
+            try {
+                responseData = JSON.parse(responseText);
+            }
+            catch {
+                return {
+                    ok: false,
+                    statusCode: response.status,
+                    error: `Invalid JSON response: ${responseText.slice(0, 200)}`,
+                };
+            }
+            if (responseData.error) {
+                return {
+                    ok: false,
+                    statusCode: response.status,
+                    error: `${responseData.error.code}: ${responseData.error.message}`,
+                };
+            }
+            if (!responseData.result) {
+                return {
+                    ok: false,
+                    statusCode: response.status,
+                    error: 'No result in response',
+                };
+            }
+            const result = responseData.result;
+            const tasks = [];
+            if (Array.isArray(result.tasks)) {
+                for (const taskData of result.tasks) {
+                    tasks.push(this.parseTask(taskData));
+                }
+            }
+            const listResponse = {
+                tasks,
+                nextPageToken: result.nextPageToken ? String(result.nextPageToken) : '',
+                pageSize: typeof result.pageSize === 'number' ? result.pageSize : 50,
+                totalSize: typeof result.totalSize === 'number' ? result.totalSize : undefined,
+            };
+            return { ok: true, response: listResponse };
+        }
         catch (error) {
             if (error instanceof Error) {
                 return {
@@ -242,8 +362,11 @@ export class A2AClient {
         }
     }
     /**
-     * Cancel a task
-     * POST /tasks/cancel (JSON-RPC 2.0)
+     * Cancel a task (Phase 2 - A2A Protocol Compliant)
+     * POST /a2a (JSON-RPC 2.0)
+     *
+     * @param taskId - The task ID to cancel
+     * @returns Promise<CancelTaskResult> with canceled task or error
      */
     async cancelTask(taskId) {
         const requestId = randomUUID();
@@ -252,28 +375,28 @@ export class A2AClient {
             id: requestId,
             method: 'tasks/cancel',
             params: {
-                name: `tasks/${taskId}`,
+                id: taskId,
             },
         };
         try {
-            const response = await fetch(`${this.baseUrl}/tasks/cancel`, {
+            const response = await fetch(this.baseUrl, {
                 method: 'POST',
                 headers: this.defaultHeaders,
                 body: JSON.stringify(request),
             });
-            // Validate Content-Type
             const contentType = response.headers.get('content-type');
             if (!contentType?.includes('application/json')) {
                 return {
                     ok: false,
+                    statusCode: response.status,
                     error: `Expected JSON response, got ${contentType || 'unknown'}`,
                 };
             }
             const responseText = await response.text();
-            // Validate response size
             if (responseText.length > MAX_RESPONSE_SIZE) {
                 return {
                     ok: false,
+                    statusCode: response.status,
                     error: `Response too large: ${responseText.length} bytes (max ${MAX_RESPONSE_SIZE})`,
                 };
             }
@@ -284,15 +407,22 @@ export class A2AClient {
             catch {
                 return {
                     ok: false,
+                    statusCode: response.status,
                     error: `Invalid JSON response: ${responseText.slice(0, 200)}`,
                 };
             }
             if (responseData.error) {
                 return {
                     ok: false,
+                    statusCode: response.status,
                     error: `${responseData.error.code}: ${responseData.error.message}`,
                 };
             }
+            // Parse the canceled task from response
+            if (responseData.result) {
+                const task = this.parseTask(responseData.result);
+                return { ok: true, task };
+            }
             return { ok: true };
         }
         catch (error) {
@@ -334,7 +464,7 @@ export class A2AClient {
         }
         try {
             // SSRF protection (defense-in-depth)
-            if (isPrivateUrl(this.baseUrl)) {
+            if (isPrivateUrl(this.baseUrl) && !this.allowLocal) {
                 return {
                     ok: false,
                     error: 'Private or local URLs are not allowed',
@@ -435,9 +565,11 @@ export class A2AClient {
             updatedAt: data.updatedAt ? String(data.updatedAt) : undefined,
             contextId: data.contextId ? String(data.contextId) : undefined,
         };
-        // Parse messages
-        if (Array.isArray(data.messages)) {
-            task.messages = data.messages.map(msg => this.parseMessage(msg));
+        // Parse messages (A2A uses 'history' field, some agents use 'messages')
+        const messageList = Array.isArray(data.history) ? data.history :
+            Array.isArray(data.messages) ? data.messages : [];
+        if (messageList.length > 0) {
+            task.messages = messageList.map(msg => this.parseMessage(msg));
         }
         // Parse artifacts
         if (Array.isArray(data.artifacts)) {
@@ -460,7 +592,8 @@ export class A2AClient {
         }
         const obj = data;
         const message = {
-            role: obj.role === 'assistant' ? 'assistant' : 'user',
+            // A2A protocol uses 'agent' for assistant responses
+            role: (obj.role === 'assistant' || obj.role === 'agent') ? 'assistant' : 'user',
             parts: [],
             metadata: obj.metadata,
             contextId: obj.contextId ? String(obj.contextId) : undefined,
@@ -629,7 +762,7 @@ export async function createA2AClient(configDir, agentId) {
     }
     else {
         // Fetch fresh agent card
-        const fetchResult = await fetchAgentCard(config.url);
+        const fetchResult = await fetchAgentCard(config.url, { allowLocal: config.allow_local ?? false });
         if (!fetchResult.ok || !fetchResult.agentCard) {
             return {
                 ok: false,
@@ -648,8 +781,74 @@ export async function createA2AClient(configDir, agentId) {
             expiresAt,
         });
     }
-    // Create client
-    const client = new A2AClient(agentCard);
+    // Create client with allowLocal from config
+    const client = new A2AClient(agentCard, { allowLocal: config.allow_local ?? false });
     return { ok: true, client, agentCard };
 }
+/**
+ * Probe agent capabilities (Phase 2.5)
+ *
+ * Detects agent capabilities by:
+ * 1. Checking Agent Card capabilities field (if present)
+ * 2. Probing tasks/list endpoint to detect task support
+ *
+ * Note: Streaming capability is only detected from Agent Card, not probed,
+ * because SSE probing is more complex and unreliable.
+ *
+ * @param agentCard - The agent's Agent Card
+ * @param _allowLocal - Reserved for future use (URL validation)
+ * @returns Promise<AgentCapabilities> with detected capabilities
+ */
+export async function probeCapabilities(agentCard, _allowLocal = false) {
+    // Default capabilities (all false)
+    const capabilities = {
+        tasks: false,
+        streaming: false,
+    };
+    // First, check Agent Card capabilities field (if present)
+    // This is the authoritative source if provided by the agent
+    if (agentCard.capabilities) {
+        if (agentCard.capabilities.streaming !== undefined) {
+            capabilities.streaming = agentCard.capabilities.streaming;
+        }
+    }
+    // Probe tasks/list endpoint
+    try {
+        const response = await fetch(agentCard.url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify({
+                jsonrpc: '2.0',
+                id: 'probe-tasks',
+                method: 'tasks/list',
+                params: {},
+            }),
+            signal: AbortSignal.timeout(5000), // 5 second timeout for probe
+        });
+        // Check for successful JSON-RPC response
+        // A 200 with { "error": { "code": -32601, ... } } means method not found
+        if (response.ok) {
+            try {
+                const data = await response.json();
+                // Only set tasks=true if we get a result (not a JSON-RPC error)
+                if (data.result !== undefined && !data.error) {
+                    capabilities.tasks = true;
+                }
+            }
+            catch {
+                // If we can't parse JSON, assume tasks not supported
+            }
+        }
+    }
+    catch {
+        // On network error or timeout, assume tasks not supported (keep false)
+    }
+    // Note: We don't probe message/stream here because:
+    // 1. It's more complex (SSE)
+    // 2. The Agent Card capabilities field is the preferred source
+    // 3. Most A2A agents that support tasks also support streaming
+    return capabilities;
+}
 //# sourceMappingURL=client.js.map