agentstudio 0.1.18 → 0.1.21

package/services/a2a/a2aSdkMcp.d.ts

@@ -0,0 +1,51 @@
+/**
+ * A2A Client SDK MCP Server
+ *
+ * Implements an in-process MCP server using Claude Agent SDK that enables
+ * agents to call external A2A-compatible agents with dynamic tool documentation.
+ *
+ * Features:
+ * - Dynamic tool description based on project's A2A configuration
+ * - SessionId support for multi-turn conversations
+ * - Integration with existing callExternalAgent function
+ */
+import { z } from 'zod';
+/**
+ * Create SDK MCP server for A2A client tool
+ *
+ * This server runs in-process within the Claude Agent SDK and provides
+ * a tool for calling external A2A agents.
+ *
+ * @param projectId - Project identifier for loading A2A configuration
+ * @returns SDK MCP server instance and tool definitions
+ */
+export declare function createA2ASdkMcpServer(projectId: string): Promise<{
+    server: import("@anthropic-ai/claude-agent-sdk").McpSdkServerConfigWithInstance;
+    tool: {
+        name: string;
+        description: string;
+        inputSchema: {
+            agentUrl: z.ZodString;
+            agentName: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            sessionId: z.ZodOptional<z.ZodString>;
+            useTask: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        };
+        handler: (args: {
+            message: string;
+            agentUrl: string;
+            useTask: boolean;
+            sessionId?: string | undefined;
+            agentName?: string | undefined;
+        }, extra: unknown) => Promise<CallToolResult>;
+    };
+}>;
+/**
+ * Get tool name as it appears to Claude
+ *
+ * SDK MCP tools are prefixed with "mcp__{server_name}__"
+ *
+ * @returns Full tool name
+ */
+export declare function getA2AToolName(): string;
+//# sourceMappingURL=a2aSdkMcp.d.ts.map

package/services/a2a/a2aSdkMcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2aSdkMcp.d.ts","sourceRoot":"","sources":["../../../src/services/a2a/a2aSdkMcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyCxB;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;GAgI5D;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}

package/services/a2a/a2aSdkMcp.js

@@ -0,0 +1,185 @@
+"use strict";
+/**
+ * A2A Client SDK MCP Server
+ *
+ * Implements an in-process MCP server using Claude Agent SDK that enables
+ * agents to call external A2A-compatible agents with dynamic tool documentation.
+ *
+ * Features:
+ * - Dynamic tool description based on project's A2A configuration
+ * - SessionId support for multi-turn conversations
+ * - Integration with existing callExternalAgent function
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createA2ASdkMcpServer = createA2ASdkMcpServer;
+exports.getA2AToolName = getA2AToolName;
+const claude_agent_sdk_1 = require("@anthropic-ai/claude-agent-sdk");
+const zod_1 = require("zod");
+const a2aConfigService_js_1 = require("./a2aConfigService.js");
+const a2aClientTool_js_1 = require("./a2aClientTool.js");
+/**
+ * Generate dynamic tool description based on project's A2A configuration
+ *
+ * Lists all enabled external agents to help Claude decide which agent to call.
+ *
+ * @param projectId - Project identifier
+ * @returns Tool description with available agents
+ */
+async function generateToolDescription(projectId) {
+    const config = await (0, a2aConfigService_js_1.loadA2AConfig)(projectId);
+    if (!config) {
+        return 'Call an external A2A-compatible agent. No A2A configuration found for this project.';
+    }
+    const enabledAgents = config.allowedAgents.filter((a) => a.enabled);
+    let description = 'Call an external A2A-compatible agent to delegate tasks or retrieve information. ';
+    if (enabledAgents.length > 0) {
+        description += '\n\nAvailable external agents:\n';
+        for (const agent of enabledAgents) {
+            description += `\n• ${agent.name}`;
+            if (agent.description) {
+                description += `: ${agent.description}`;
+            }
+            description += `\n  URL: ${agent.url}`;
+        }
+        description += '\n\nUse the agentUrl parameter to specify which agent to call. Please also include the agentName parameter for better UI display.';
+    }
+    else {
+        description += 'No external agents are currently configured or enabled.';
+    }
+    return description;
+}
+/**
+ * Create SDK MCP server for A2A client tool
+ *
+ * This server runs in-process within the Claude Agent SDK and provides
+ * a tool for calling external A2A agents.
+ *
+ * @param projectId - Project identifier for loading A2A configuration
+ * @returns SDK MCP server instance and tool definitions
+ */
+async function createA2ASdkMcpServer(projectId) {
+    // Generate dynamic tool description
+    const toolDescription = await generateToolDescription(projectId);
+    // Define the tool
+    const callExternalAgentTool = (0, claude_agent_sdk_1.tool)('call_external_agent', toolDescription, {
+        agentUrl: zod_1.z
+            .string()
+            .url()
+            .describe('Target A2A agent URL (e.g., https://analytics.example.com/a2a/agent-id)'),
+        agentName: zod_1.z
+            .string()
+            .optional()
+            .describe('Name of the agent being called (e.g., "AI Editor"). Please provide this for better UI display.'),
+        message: zod_1.z
+            .string()
+            .min(1)
+            .max(10000)
+            .describe('Message or task description to send to the external agent'),
+        sessionId: zod_1.z
+            .string()
+            .optional()
+            .describe('Session ID for continuing a conversation with the external agent. Provide this if you want to continue a previous session.'),
+        useTask: zod_1.z
+            .boolean()
+            .optional()
+            .default(false)
+            .describe('Use async task mode for long-running operations (default: false for synchronous)'),
+    }, async (args) => {
+        try {
+            // Prepare input for callExternalAgent
+            const input = {
+                agentUrl: args.agentUrl,
+                message: args.message,
+                sessionId: args.sessionId,
+                useTask: args.useTask,
+            };
+            // Call external agent using existing function
+            const result = await (0, a2aClientTool_js_1.callExternalAgent)(input, projectId);
+            // Format response for Claude
+            if (result.success) {
+                const content = [];
+                let responseText = '';
+                if (result.data) {
+                    if (typeof result.data === 'string') {
+                        responseText = result.data;
+                    }
+                    else {
+                        responseText = JSON.stringify(result.data, null, 2);
+                    }
+                }
+                // 1. Add Agent Response
+                content.push({
+                    type: 'text',
+                    text: responseText || 'External agent call completed successfully.',
+                });
+                // Include task information if async mode
+                if (result.taskId) {
+                    let taskInfo = `Task ID: ${result.taskId}`;
+                    if (result.status) {
+                        taskInfo += `\nStatus: ${result.status}`;
+                    }
+                    content.push({
+                        type: 'text',
+                        text: taskInfo,
+                    });
+                }
+                // 2. Add Session ID Info (if present)
+                if (result.sessionId) {
+                    content.push({
+                        type: 'text',
+                        text: `[System] Session ID: ${result.sessionId}\nTo continue this conversation, please use this "sessionId" in your next call to this agent.`,
+                    });
+                }
+                return { content };
+            }
+            else {
+                // Handle error response
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error calling external agent: ${result.error || 'Unknown error'}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        catch (error) {
+            // Handle unexpected errors
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            console.error('[A2A SDK MCP] Error executing call_external_agent tool:', error);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Failed to call external agent: ${errorMessage}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Create SDK MCP server with the tool
+    const server = (0, claude_agent_sdk_1.createSdkMcpServer)({
+        name: 'a2a-client',
+        version: '1.0.0',
+        tools: [callExternalAgentTool],
+    });
+    // Return both server and tool for testing
+    return {
+        server,
+        tool: callExternalAgentTool,
+    };
+}
+/**
+ * Get tool name as it appears to Claude
+ *
+ * SDK MCP tools are prefixed with "mcp__{server_name}__"
+ *
+ * @returns Full tool name
+ */
+function getA2AToolName() {
+    return 'mcp__a2a-client__call_external_agent';
+}
+//# sourceMappingURL=a2aSdkMcp.js.map

package/services/a2a/a2aSdkMcp.js.map

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

package/services/a2a/a2aStreamEvents.d.ts

@@ -0,0 +1,94 @@
+/**
+ * A2A Stream Events
+ *
+ * Global EventEmitter for notifying about A2A streaming call status.
+ * This allows the MCP tool to communicate with the main SSE stream
+ * to notify the frontend about new streaming sessions.
+ *
+ * Uses A2A standard protocol event types:
+ * - Message: Direct response message
+ * - Task: Task object for complex processing
+ * - TaskStatusUpdateEvent: Task status updates with optional message content
+ * - TaskArtifactUpdateEvent: Artifact updates (files, data)
+ */
+import { EventEmitter } from 'events';
+import type { Message, Task, TaskStatusUpdateEvent, TaskArtifactUpdateEvent, Part, TextPart, FilePart, DataPart, TaskState } from '@a2a-js/sdk';
+export type { Message, Task, TaskStatusUpdateEvent, TaskArtifactUpdateEvent, Part, TextPart, FilePart, DataPart, TaskState, };
+/**
+ * A2A Stream Event Data - union of all possible A2A streaming events
+ */
+export type A2AStreamEventData = Message | Task | TaskStatusUpdateEvent | TaskArtifactUpdateEvent;
+/**
+ * Event payload for A2A stream start notification
+ */
+export interface A2AStreamStartEvent {
+    type: 'a2a_stream_start';
+    sessionId: string;
+    contextId?: string;
+    taskId?: string;
+    projectId: string;
+    agentUrl: string;
+    message: string;
+    timestamp: number;
+}
+/**
+ * Event payload for A2A stream data notification (A2A standard event)
+ */
+export interface A2AStreamDataEvent {
+    type: 'a2a_stream_data';
+    sessionId: string;
+    projectId: string;
+    agentUrl: string;
+    event: A2AStreamEventData;
+    timestamp: number;
+}
+/**
+ * Event payload for A2A stream end notification
+ */
+export interface A2AStreamEndEvent {
+    type: 'a2a_stream_end';
+    sessionId: string;
+    projectId: string;
+    success: boolean;
+    error?: string;
+    finalState?: TaskState;
+    timestamp: number;
+}
+export type A2AStreamEvent = A2AStreamStartEvent | A2AStreamDataEvent | A2AStreamEndEvent;
+/**
+ * Global EventEmitter for A2A stream notifications
+ *
+ * Events:
+ * - 'a2a_stream_start': Emitted when a streaming A2A call begins
+ * - 'a2a_stream_data': Emitted for each A2A standard event received
+ * - 'a2a_stream_end': Emitted when the streaming call completes
+ */
+declare class A2AStreamEventEmitter extends EventEmitter {
+    constructor();
+    /**
+     * Emit a2a_stream_start event
+     */
+    emitStreamStart(payload: Omit<A2AStreamStartEvent, 'type' | 'timestamp'>): void;
+    /**
+     * Emit a2a_stream_data event with A2A standard event
+     */
+    emitStreamData(payload: Omit<A2AStreamDataEvent, 'type' | 'timestamp'>): void;
+    /**
+     * Emit a2a_stream_end event
+     */
+    emitStreamEnd(payload: Omit<A2AStreamEndEvent, 'type' | 'timestamp'>): void;
+}
+export declare const a2aStreamEventEmitter: A2AStreamEventEmitter;
+/**
+ * Helper function to extract text content from A2A Part array
+ */
+export declare function extractTextFromParts(parts: Part[]): string;
+/**
+ * Helper function to create a text part
+ */
+export declare function createTextPart(text: string): TextPart;
+/**
+ * Helper function to determine if an event is final (stream should close)
+ */
+export declare function isTerminalState(state: TaskState): boolean;
+//# sourceMappingURL=a2aStreamEvents.d.ts.map

package/services/a2a/a2aStreamEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2aStreamEvents.d.ts","sourceRoot":"","sources":["../../../src/services/a2a/a2aStreamEvents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,KAAK,EACV,OAAO,EACP,IAAI,EACJ,qBAAqB,EACrB,uBAAuB,EACvB,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,EACV,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,OAAO,EACP,IAAI,EACJ,qBAAqB,EACrB,uBAAuB,EACvB,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAS,GACV,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,IAAI,GAAG,qBAAqB,GAAG,uBAAuB,CAAC;AAElG;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,kBAAkB,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;AAE1F;;;;;;;GAOG;AACH,cAAM,qBAAsB,SAAQ,YAAY;;IAO9C;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,mBAAmB,EAAE,MAAM,GAAG,WAAW,CAAC,GAAG,IAAI;IAS/E;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,WAAW,CAAC,GAAG,IAAI;IAS7E;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,WAAW,CAAC,GAAG,IAAI;CAQ5E;AAGD,eAAO,MAAM,qBAAqB,uBAA8B,CAAC;AAEjE;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAK1D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAErD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAEzD"}

package/services/a2a/a2aStreamEvents.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * A2A Stream Events
+ *
+ * Global EventEmitter for notifying about A2A streaming call status.
+ * This allows the MCP tool to communicate with the main SSE stream
+ * to notify the frontend about new streaming sessions.
+ *
+ * Uses A2A standard protocol event types:
+ * - Message: Direct response message
+ * - Task: Task object for complex processing
+ * - TaskStatusUpdateEvent: Task status updates with optional message content
+ * - TaskArtifactUpdateEvent: Artifact updates (files, data)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.a2aStreamEventEmitter = void 0;
+exports.extractTextFromParts = extractTextFromParts;
+exports.createTextPart = createTextPart;
+exports.isTerminalState = isTerminalState;
+const events_1 = require("events");
+/**
+ * Global EventEmitter for A2A stream notifications
+ *
+ * Events:
+ * - 'a2a_stream_start': Emitted when a streaming A2A call begins
+ * - 'a2a_stream_data': Emitted for each A2A standard event received
+ * - 'a2a_stream_end': Emitted when the streaming call completes
+ */
+class A2AStreamEventEmitter extends events_1.EventEmitter {
+    constructor() {
+        super();
+        // Increase max listeners since multiple SSE connections may listen
+        this.setMaxListeners(100);
+    }
+    /**
+     * Emit a2a_stream_start event
+     */
+    emitStreamStart(payload) {
+        const event = {
+            ...payload,
+            type: 'a2a_stream_start',
+            timestamp: Date.now(),
+        };
+        this.emit('a2a_stream_start', event);
+    }
+    /**
+     * Emit a2a_stream_data event with A2A standard event
+     */
+    emitStreamData(payload) {
+        const event = {
+            ...payload,
+            type: 'a2a_stream_data',
+            timestamp: Date.now(),
+        };
+        this.emit('a2a_stream_data', event);
+    }
+    /**
+     * Emit a2a_stream_end event
+     */
+    emitStreamEnd(payload) {
+        const event = {
+            ...payload,
+            type: 'a2a_stream_end',
+            timestamp: Date.now(),
+        };
+        this.emit('a2a_stream_end', event);
+    }
+}
+// Singleton instance
+exports.a2aStreamEventEmitter = new A2AStreamEventEmitter();
+/**
+ * Helper function to extract text content from A2A Part array
+ */
+function extractTextFromParts(parts) {
+    return parts
+        .filter((part) => part.kind === 'text')
+        .map(part => part.text)
+        .join('');
+}
+/**
+ * Helper function to create a text part
+ */
+function createTextPart(text) {
+    return { kind: 'text', text };
+}
+/**
+ * Helper function to determine if an event is final (stream should close)
+ */
+function isTerminalState(state) {
+    return ['completed', 'failed', 'canceled', 'rejected'].includes(state);
+}
+//# sourceMappingURL=a2aStreamEvents.js.map

package/services/a2a/a2aStreamEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a2aStreamEvents.js","sourceRoot":"","sources":["../../../src/services/a2a/a2aStreamEvents.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAsIH,oDAKC;AAKD,wCAEC;AAKD,0CAEC;AAvJD,mCAAsC;AA0EtC;;;;;;;GAOG;AACH,MAAM,qBAAsB,SAAQ,qBAAY;IAC9C;QACE,KAAK,EAAE,CAAC;QACR,mEAAmE;QACnE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,OAAwD;QACtE,MAAM,KAAK,GAAwB;YACjC,GAAG,OAAO;YACV,IAAI,EAAE,kBAAkB;YACxB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,OAAuD;QACpE,MAAM,KAAK,GAAuB;YAChC,GAAG,OAAO;YACV,IAAI,EAAE,iBAAiB;YACvB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAAsD;QAClE,MAAM,KAAK,GAAsB;YAC/B,GAAG,OAAO;YACV,IAAI,EAAE,gBAAgB;YACtB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;CACF;AAED,qBAAqB;AACR,QAAA,qBAAqB,GAAG,IAAI,qBAAqB,EAAE,CAAC;AAEjE;;GAEG;AACH,SAAgB,oBAAoB,CAAC,KAAa;IAChD,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAoB,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC;SACxD,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;SACtB,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,IAAY;IACzC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,KAAgB;IAC9C,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACzE,CAAC"}

package/services/a2a/agentCardService.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Agent Card Service
+ *
+ * Generates Agent Cards from AgentConfig for A2A protocol discovery.
+ * Agent Cards are auto-generated and should never be manually maintained.
+ *
+ * Pure function approach: generateAgentCard(agentConfig, projectContext) -> AgentCard
+ *
+ * Phase 4: US2 - Agent Card Auto-Generation
+ */
+import type { AgentConfig } from '../../types/agents.js';
+import type { AgentCard } from '../../types/a2a.js';
+/**
+ * Project context metadata for Agent Card generation
+ */
+export interface ProjectContext {
+    projectId: string;
+    projectName: string;
+    workingDirectory: string;
+    a2aAgentId: string;
+    baseUrl: string;
+}
+/**
+ * Generate Agent Card from agent configuration (pure function)
+ *
+ * This is a pure function with no side effects - it takes agent config and project context
+ * and returns a complete Agent Card compliant with A2A protocol v1.0.
+ *
+ * @param agentConfig - Agent configuration with tools and metadata
+ * @param projectContext - Project-specific context (ID, name, working directory, A2A ID, baseUrl)
+ * @returns Complete Agent Card ready for A2A protocol exposure
+ */
+export declare function generateAgentCard(agentConfig: AgentConfig, projectContext: ProjectContext): AgentCard;
+//# sourceMappingURL=agentCardService.d.ts.map

package/services/a2a/agentCardService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentCardService.d.ts","sourceRoot":"","sources":["../../../src/services/a2a/agentCardService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,uBAAuB,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAqC,MAAM,oBAAoB,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,cAAc,GAC7B,SAAS,CAwCX"}