@kuntur/a2a-carbon-chat-adapter 0.1.1 → 0.1.3

package/README.md

@@ -12,14 +12,15 @@ npm install @kuntur/a2a-carbon-chat-adapter @carbon/ai-chat react react-dom
 
 ```tsx
 import { A2AChat } from '@kuntur/a2a-carbon-chat-adapter';
-import '@carbon/ai-chat/styles.css';
+import '@kuntur/a2a-carbon-chat-adapter/styles'; // Adapter layout styles
+import '@carbon/ai-chat/dist/styles.css';        // Carbon AI Chat styles (if not already imported)
 
 function App() {
   return (
     <A2AChat
       agentUrl="https://your-agent.example.com"
       agentName="My Agent"
-      layout="fullscreen"
+      layout="sidebar"
     />
   );
 }
@@ -67,9 +68,12 @@ function ChatWithSwitcher() {
 import { createA2AHandler } from '@kuntur/a2a-carbon-chat-adapter/server';
 
 export const POST = createA2AHandler({
-  allowedAgentUrls: ['https://trusted-agents.example.com'],
+  allowedAgentUrls: ['https://trusted-agent.example.com'],
   timeout: 120000,
 });
+
+export const runtime = 'nodejs';
+export const dynamic = 'force-dynamic';
 ```
 
 ## Programmatic Usage with Hooks

package/dist/server.cjs

@@ -0,0 +1,147 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/server/index.ts
+var server_exports = {};
+__export(server_exports, {
+  createA2AHandler: () => createA2AHandler
+});
+module.exports = __toCommonJS(server_exports);
+
+// src/server/create-api-handler.ts
+function generateUUID() {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function createA2AHandler(options = {}) {
+  const { onRequest, onError, timeout = 12e4, allowedAgentUrls } = options;
+  return async function handler(request) {
+    try {
+      let body = await request.json();
+      if (!body.agentUrl || !body.message) {
+        return new Response(
+          JSON.stringify({ error: "Missing required fields: agentUrl, message" }),
+          { status: 400, headers: { "Content-Type": "application/json" } }
+        );
+      }
+      if (allowedAgentUrls && allowedAgentUrls.length > 0) {
+        const isAllowed = allowedAgentUrls.some((pattern) => {
+          if (typeof pattern === "string") {
+            return body.agentUrl.startsWith(pattern);
+          }
+          return pattern.test(body.agentUrl);
+        });
+        if (!isAllowed) {
+          return new Response(
+            JSON.stringify({ error: "Agent URL not allowed" }),
+            { status: 403, headers: { "Content-Type": "application/json" } }
+          );
+        }
+      }
+      if (onRequest) {
+        body = await onRequest(body);
+      }
+      let normalizedUrl = body.agentUrl.replace(/\/$/, "");
+      if (!normalizedUrl.endsWith("/jsonrpc")) {
+        normalizedUrl = `${normalizedUrl}/jsonrpc/`;
+      } else {
+        normalizedUrl = `${normalizedUrl}/`;
+      }
+      const payload = {
+        jsonrpc: "2.0",
+        method: "message/stream",
+        params: {
+          message: {
+            role: "user",
+            messageId: generateUUID(),
+            parts: [{ kind: "text", text: body.message }]
+          },
+          ...body.extensions && { extensions: body.extensions }
+        },
+        id: generateUUID()
+      };
+      const headers = {
+        "Content-Type": "application/json",
+        Accept: "text/event-stream"
+      };
+      if (body.apiKey) {
+        headers["Authorization"] = `Bearer ${body.apiKey}`;
+      }
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), timeout);
+      try {
+        const agentResponse = await fetch(normalizedUrl, {
+          method: "POST",
+          headers,
+          body: JSON.stringify(payload),
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (!agentResponse.ok) {
+          const errorText = await agentResponse.text();
+          return new Response(
+            JSON.stringify({
+              error: `Agent error: ${agentResponse.status}`,
+              details: errorText
+            }),
+            { status: agentResponse.status, headers: { "Content-Type": "application/json" } }
+          );
+        }
+        if (!agentResponse.body) {
+          return new Response(
+            JSON.stringify({ error: "Agent response body is null" }),
+            { status: 500, headers: { "Content-Type": "application/json" } }
+          );
+        }
+        return new Response(agentResponse.body, {
+          headers: {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache",
+            Connection: "keep-alive"
+          }
+        });
+      } finally {
+        clearTimeout(timeoutId);
+      }
+    } catch (error) {
+      onError?.(error);
+      if (error.name === "AbortError") {
+        return new Response(
+          JSON.stringify({ error: "Request timeout" }),
+          { status: 504, headers: { "Content-Type": "application/json" } }
+        );
+      }
+      return new Response(
+        JSON.stringify({
+          error: "Internal server error",
+          message: error.message
+        }),
+        { status: 500, headers: { "Content-Type": "application/json" } }
+      );
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createA2AHandler
+});
+//# sourceMappingURL=server.cjs.map

package/dist/server.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/index.ts","../src/server/create-api-handler.ts"],"sourcesContent":["/**\n * Server-side utilities\n *\n * @example\n * import { createA2AHandler } from '@kuntur/a2a-carbon-chat-adapter/server';\n */\n\nexport { createA2AHandler } from './create-api-handler';\nexport type { A2AHandlerOptions } from './create-api-handler';\n","/**\n * Factory for creating Next.js API route handlers for A2A proxy\n *\n * @example\n * // app/api/agent/chat/route.ts\n * import { createA2AHandler } from '@kuntur/a2a-carbon-chat-adapter/server';\n *\n * export const POST = createA2AHandler({\n *   allowedAgentUrls: ['https://trusted-agents.example.com']\n * });\n */\n\nexport interface A2AHandlerOptions {\n  /**\n   * Called before forwarding request to agent\n   * Use for authentication, validation, rate limiting\n   */\n  onRequest?: (request: {\n    agentUrl: string;\n    apiKey?: string;\n    message: string;\n    extensions?: Record<string, unknown>;\n  }) => Promise<typeof request> | typeof request;\n\n  /**\n   * Called on error\n   */\n  onError?: (error: Error) => void;\n\n  /**\n   * Request timeout in milliseconds\n   * @default 120000 (2 minutes)\n   */\n  timeout?: number;\n\n  /**\n   * Allowed agent URL patterns (for security)\n   * If provided, requests to non-matching URLs will be rejected\n   */\n  allowedAgentUrls?: (string | RegExp)[];\n}\n\nfunction generateUUID(): string {\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === 'x' ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\nexport function createA2AHandler(options: A2AHandlerOptions = {}) {\n  const { onRequest, onError, timeout = 120000, allowedAgentUrls } = options;\n\n  return async function handler(request: Request): Promise<Response> {\n    try {\n      let body = await request.json();\n\n      // Validate required fields\n      if (!body.agentUrl || !body.message) {\n        return new Response(\n          JSON.stringify({ error: 'Missing required fields: agentUrl, message' }),\n          { status: 400, headers: { 'Content-Type': 'application/json' } }\n        );\n      }\n\n      // Check allowed URLs\n      if (allowedAgentUrls && allowedAgentUrls.length > 0) {\n        const isAllowed = allowedAgentUrls.some((pattern) => {\n          if (typeof pattern === 'string') {\n            return body.agentUrl.startsWith(pattern);\n          }\n          return pattern.test(body.agentUrl);\n        });\n\n        if (!isAllowed) {\n          return new Response(\n            JSON.stringify({ error: 'Agent URL not allowed' }),\n            { status: 403, headers: { 'Content-Type': 'application/json' } }\n          );\n        }\n      }\n\n      // Allow request transformation\n      if (onRequest) {\n        body = await onRequest(body);\n      }\n\n      // Normalize URL\n      let normalizedUrl = body.agentUrl.replace(/\\/$/, '');\n      if (!normalizedUrl.endsWith('/jsonrpc')) {\n        normalizedUrl = `${normalizedUrl}/jsonrpc/`;\n      } else {\n        normalizedUrl = `${normalizedUrl}/`;\n      }\n\n      // Build A2A payload\n      const payload = {\n        jsonrpc: '2.0',\n        method: 'message/stream',\n        params: {\n          message: {\n            role: 'user',\n            messageId: generateUUID(),\n            parts: [{ kind: 'text', text: body.message }],\n          },\n          ...(body.extensions && { extensions: body.extensions }),\n        },\n        id: generateUUID(),\n      };\n\n      const headers: Record<string, string> = {\n        'Content-Type': 'application/json',\n        Accept: 'text/event-stream',\n      };\n\n      if (body.apiKey) {\n        headers['Authorization'] = `Bearer ${body.apiKey}`;\n      }\n\n      // Create abort controller for timeout\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n      try {\n        const agentResponse = await fetch(normalizedUrl, {\n          method: 'POST',\n          headers,\n          body: JSON.stringify(payload),\n          signal: controller.signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        if (!agentResponse.ok) {\n          const errorText = await agentResponse.text();\n          return new Response(\n            JSON.stringify({\n              error: `Agent error: ${agentResponse.status}`,\n              details: errorText,\n            }),\n            { status: agentResponse.status, headers: { 'Content-Type': 'application/json' } }\n          );\n        }\n\n        if (!agentResponse.body) {\n          return new Response(\n            JSON.stringify({ error: 'Agent response body is null' }),\n            { status: 500, headers: { 'Content-Type': 'application/json' } }\n          );\n        }\n\n        // Stream the response\n        return new Response(agentResponse.body, {\n          headers: {\n            'Content-Type': 'text/event-stream',\n            'Cache-Control': 'no-cache',\n            Connection: 'keep-alive',\n          },\n        });\n      } finally {\n        clearTimeout(timeoutId);\n      }\n    } catch (error) {\n      onError?.(error as Error);\n\n      if ((error as Error).name === 'AbortError') {\n        return new Response(\n          JSON.stringify({ error: 'Request timeout' }),\n          { status: 504, headers: { 'Content-Type': 'application/json' } }\n        );\n      }\n\n      return new Response(\n        JSON.stringify({\n          error: 'Internal server error',\n          message: (error as Error).message,\n        }),\n        { status: 500, headers: { 'Content-Type': 'application/json' } }\n      );\n    }\n  };\n}\n\nexport default createA2AHandler;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC0CA,SAAS,eAAuB;AAC9B,SAAO,uCAAuC,QAAQ,SAAS,CAAC,MAAM;AACpE,UAAM,IAAK,KAAK,OAAO,IAAI,KAAM;AACjC,UAAM,IAAI,MAAM,MAAM,IAAK,IAAI,IAAO;AACtC,WAAO,EAAE,SAAS,EAAE;AAAA,EACtB,CAAC;AACH;AAEO,SAAS,iBAAiB,UAA6B,CAAC,GAAG;AAChE,QAAM,EAAE,WAAW,SAAS,UAAU,MAAQ,iBAAiB,IAAI;AAEnE,SAAO,eAAe,QAAQ,SAAqC;AACjE,QAAI;AACF,UAAI,OAAO,MAAM,QAAQ,KAAK;AAG9B,UAAI,CAAC,KAAK,YAAY,CAAC,KAAK,SAAS;AACnC,eAAO,IAAI;AAAA,UACT,KAAK,UAAU,EAAE,OAAO,6CAA6C,CAAC;AAAA,UACtE,EAAE,QAAQ,KAAK,SAAS,EAAE,gBAAgB,mBAAmB,EAAE;AAAA,QACjE;AAAA,MACF;AAGA,UAAI,oBAAoB,iBAAiB,SAAS,GAAG;AACnD,cAAM,YAAY,iBAAiB,KAAK,CAAC,YAAY;AACnD,cAAI,OAAO,YAAY,UAAU;AAC/B,mBAAO,KAAK,SAAS,WAAW,OAAO;AAAA,UACzC;AACA,iBAAO,QAAQ,KAAK,KAAK,QAAQ;AAAA,QACnC,CAAC;AAED,YAAI,CAAC,WAAW;AACd,iBAAO,IAAI;AAAA,YACT,KAAK,UAAU,EAAE,OAAO,wBAAwB,CAAC;AAAA,YACjD,EAAE,QAAQ,KAAK,SAAS,EAAE,gBAAgB,mBAAmB,EAAE;AAAA,UACjE;AAAA,QACF;AAAA,MACF;AAGA,UAAI,WAAW;AACb,eAAO,MAAM,UAAU,IAAI;AAAA,MAC7B;AAGA,UAAI,gBAAgB,KAAK,SAAS,QAAQ,OAAO,EAAE;AACnD,UAAI,CAAC,cAAc,SAAS,UAAU,GAAG;AACvC,wBAAgB,GAAG,aAAa;AAAA,MAClC,OAAO;AACL,wBAAgB,GAAG,aAAa;AAAA,MAClC;AAGA,YAAM,UAAU;AAAA,QACd,SAAS;AAAA,QACT,QAAQ;AAAA,QACR,QAAQ;AAAA,UACN,SAAS;AAAA,YACP,MAAM;AAAA,YACN,WAAW,aAAa;AAAA,YACxB,OAAO,CAAC,EAAE,MAAM,QAAQ,MAAM,KAAK,QAAQ,CAAC;AAAA,UAC9C;AAAA,UACA,GAAI,KAAK,cAAc,EAAE,YAAY,KAAK,WAAW;AAAA,QACvD;AAAA,QACA,IAAI,aAAa;AAAA,MACnB;AAEA,YAAM,UAAkC;AAAA,QACtC,gBAAgB;AAAA,QAChB,QAAQ;AAAA,MACV;AAEA,UAAI,KAAK,QAAQ;AACf,gBAAQ,eAAe,IAAI,UAAU,KAAK,MAAM;AAAA,MAClD;AAGA,YAAM,aAAa,IAAI,gBAAgB;AACvC,YAAM,YAAY,WAAW,MAAM,WAAW,MAAM,GAAG,OAAO;AAE9D,UAAI;AACF,cAAM,gBAAgB,MAAM,MAAM,eAAe;AAAA,UAC/C,QAAQ;AAAA,UACR;AAAA,UACA,MAAM,KAAK,UAAU,OAAO;AAAA,UAC5B,QAAQ,WAAW;AAAA,QACrB,CAAC;AAED,qBAAa,SAAS;AAEtB,YAAI,CAAC,cAAc,IAAI;AACrB,gBAAM,YAAY,MAAM,cAAc,KAAK;AAC3C,iBAAO,IAAI;AAAA,YACT,KAAK,UAAU;AAAA,cACb,OAAO,gBAAgB,cAAc,MAAM;AAAA,cAC3C,SAAS;AAAA,YACX,CAAC;AAAA,YACD,EAAE,QAAQ,cAAc,QAAQ,SAAS,EAAE,gBAAgB,mBAAmB,EAAE;AAAA,UAClF;AAAA,QACF;AAEA,YAAI,CAAC,cAAc,MAAM;AACvB,iBAAO,IAAI;AAAA,YACT,KAAK,UAAU,EAAE,OAAO,8BAA8B,CAAC;AAAA,YACvD,EAAE,QAAQ,KAAK,SAAS,EAAE,gBAAgB,mBAAmB,EAAE;AAAA,UACjE;AAAA,QACF;AAGA,eAAO,IAAI,SAAS,cAAc,MAAM;AAAA,UACtC,SAAS;AAAA,YACP,gBAAgB;AAAA,YAChB,iBAAiB;AAAA,YACjB,YAAY;AAAA,UACd;AAAA,QACF,CAAC;AAAA,MACH,UAAE;AACA,qBAAa,SAAS;AAAA,MACxB;AAAA,IACF,SAAS,OAAO;AACd,gBAAU,KAAc;AAExB,UAAK,MAAgB,SAAS,cAAc;AAC1C,eAAO,IAAI;AAAA,UACT,KAAK,UAAU,EAAE,OAAO,kBAAkB,CAAC;AAAA,UAC3C,EAAE,QAAQ,KAAK,SAAS,EAAE,gBAAgB,mBAAmB,EAAE;AAAA,QACjE;AAAA,MACF;AAEA,aAAO,IAAI;AAAA,QACT,KAAK,UAAU;AAAA,UACb,OAAO;AAAA,UACP,SAAU,MAAgB;AAAA,QAC5B,CAAC;AAAA,QACD,EAAE,QAAQ,KAAK,SAAS,EAAE,gBAAgB,mBAAmB,EAAE;AAAA,MACjE;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/server.d.cts

@@ -0,0 +1,40 @@
+/**
+ * Factory for creating Next.js API route handlers for A2A proxy
+ *
+ * @example
+ * // app/api/agent/chat/route.ts
+ * import { createA2AHandler } from '@kuntur/a2a-carbon-chat-adapter/server';
+ *
+ * export const POST = createA2AHandler({
+ *   allowedAgentUrls: ['https://trusted-agents.example.com']
+ * });
+ */
+interface A2AHandlerOptions {
+    /**
+     * Called before forwarding request to agent
+     * Use for authentication, validation, rate limiting
+     */
+    onRequest?: (request: {
+        agentUrl: string;
+        apiKey?: string;
+        message: string;
+        extensions?: Record<string, unknown>;
+    }) => Promise<typeof request> | typeof request;
+    /**
+     * Called on error
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Request timeout in milliseconds
+     * @default 120000 (2 minutes)
+     */
+    timeout?: number;
+    /**
+     * Allowed agent URL patterns (for security)
+     * If provided, requests to non-matching URLs will be rejected
+     */
+    allowedAgentUrls?: (string | RegExp)[];
+}
+declare function createA2AHandler(options?: A2AHandlerOptions): (request: Request) => Promise<Response>;
+
+export { type A2AHandlerOptions, createA2AHandler };

package/dist/server.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Factory for creating Next.js API route handlers for A2A proxy
+ *
+ * @example
+ * // app/api/agent/chat/route.ts
+ * import { createA2AHandler } from '@kuntur/a2a-carbon-chat-adapter/server';
+ *
+ * export const POST = createA2AHandler({
+ *   allowedAgentUrls: ['https://trusted-agents.example.com']
+ * });
+ */
+interface A2AHandlerOptions {
+    /**
+     * Called before forwarding request to agent
+     * Use for authentication, validation, rate limiting
+     */
+    onRequest?: (request: {
+        agentUrl: string;
+        apiKey?: string;
+        message: string;
+        extensions?: Record<string, unknown>;
+    }) => Promise<typeof request> | typeof request;
+    /**
+     * Called on error
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Request timeout in milliseconds
+     * @default 120000 (2 minutes)
+     */
+    timeout?: number;
+    /**
+     * Allowed agent URL patterns (for security)
+     * If provided, requests to non-matching URLs will be rejected
+     */
+    allowedAgentUrls?: (string | RegExp)[];
+}
+declare function createA2AHandler(options?: A2AHandlerOptions): (request: Request) => Promise<Response>;
+
+export { type A2AHandlerOptions, createA2AHandler };

package/dist/server.js

@@ -0,0 +1,120 @@
+// src/server/create-api-handler.ts
+function generateUUID() {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function createA2AHandler(options = {}) {
+  const { onRequest, onError, timeout = 12e4, allowedAgentUrls } = options;
+  return async function handler(request) {
+    try {
+      let body = await request.json();
+      if (!body.agentUrl || !body.message) {
+        return new Response(
+          JSON.stringify({ error: "Missing required fields: agentUrl, message" }),
+          { status: 400, headers: { "Content-Type": "application/json" } }
+        );
+      }
+      if (allowedAgentUrls && allowedAgentUrls.length > 0) {
+        const isAllowed = allowedAgentUrls.some((pattern) => {
+          if (typeof pattern === "string") {
+            return body.agentUrl.startsWith(pattern);
+          }
+          return pattern.test(body.agentUrl);
+        });
+        if (!isAllowed) {
+          return new Response(
+            JSON.stringify({ error: "Agent URL not allowed" }),
+            { status: 403, headers: { "Content-Type": "application/json" } }
+          );
+        }
+      }
+      if (onRequest) {
+        body = await onRequest(body);
+      }
+      let normalizedUrl = body.agentUrl.replace(/\/$/, "");
+      if (!normalizedUrl.endsWith("/jsonrpc")) {
+        normalizedUrl = `${normalizedUrl}/jsonrpc/`;
+      } else {
+        normalizedUrl = `${normalizedUrl}/`;
+      }
+      const payload = {
+        jsonrpc: "2.0",
+        method: "message/stream",
+        params: {
+          message: {
+            role: "user",
+            messageId: generateUUID(),
+            parts: [{ kind: "text", text: body.message }]
+          },
+          ...body.extensions && { extensions: body.extensions }
+        },
+        id: generateUUID()
+      };
+      const headers = {
+        "Content-Type": "application/json",
+        Accept: "text/event-stream"
+      };
+      if (body.apiKey) {
+        headers["Authorization"] = `Bearer ${body.apiKey}`;
+      }
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), timeout);
+      try {
+        const agentResponse = await fetch(normalizedUrl, {
+          method: "POST",
+          headers,
+          body: JSON.stringify(payload),
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        if (!agentResponse.ok) {
+          const errorText = await agentResponse.text();
+          return new Response(
+            JSON.stringify({
+              error: `Agent error: ${agentResponse.status}`,
+              details: errorText
+            }),
+            { status: agentResponse.status, headers: { "Content-Type": "application/json" } }
+          );
+        }
+        if (!agentResponse.body) {
+          return new Response(
+            JSON.stringify({ error: "Agent response body is null" }),
+            { status: 500, headers: { "Content-Type": "application/json" } }
+          );
+        }
+        return new Response(agentResponse.body, {
+          headers: {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache",
+            Connection: "keep-alive"
+          }
+        });
+      } finally {
+        clearTimeout(timeoutId);
+      }
+    } catch (error) {
+      onError?.(error);
+      if (error.name === "AbortError") {
+        return new Response(
+          JSON.stringify({ error: "Request timeout" }),
+          { status: 504, headers: { "Content-Type": "application/json" } }
+        );
+      }
+      return new Response(
+        JSON.stringify({
+          error: "Internal server error",
+          message: error.message
+        }),
+        { status: 500, headers: { "Content-Type": "application/json" } }
+      );
+    }
+  };
+}
+export {
+  createA2AHandler
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server/create-api-handler.ts"],"sourcesContent":["/**\n * Factory for creating Next.js API route handlers for A2A proxy\n *\n * @example\n * // app/api/agent/chat/route.ts\n * import { createA2AHandler } from '@kuntur/a2a-carbon-chat-adapter/server';\n *\n * export const POST = createA2AHandler({\n *   allowedAgentUrls: ['https://trusted-agents.example.com']\n * });\n */\n\nexport interface A2AHandlerOptions {\n  /**\n   * Called before forwarding request to agent\n   * Use for authentication, validation, rate limiting\n   */\n  onRequest?: (request: {\n    agentUrl: string;\n    apiKey?: string;\n    message: string;\n    extensions?: Record<string, unknown>;\n  }) => Promise<typeof request> | typeof request;\n\n  /**\n   * Called on error\n   */\n  onError?: (error: Error) => void;\n\n  /**\n   * Request timeout in milliseconds\n   * @default 120000 (2 minutes)\n   */\n  timeout?: number;\n\n  /**\n   * Allowed agent URL patterns (for security)\n   * If provided, requests to non-matching URLs will be rejected\n   */\n  allowedAgentUrls?: (string | RegExp)[];\n}\n\nfunction generateUUID(): string {\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === 'x' ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\nexport function createA2AHandler(options: A2AHandlerOptions = {}) {\n  const { onRequest, onError, timeout = 120000, allowedAgentUrls } = options;\n\n  return async function handler(request: Request): Promise<Response> {\n    try {\n      let body = await request.json();\n\n      // Validate required fields\n      if (!body.agentUrl || !body.message) {\n        return new Response(\n          JSON.stringify({ error: 'Missing required fields: agentUrl, message' }),\n          { status: 400, headers: { 'Content-Type': 'application/json' } }\n        );\n      }\n\n      // Check allowed URLs\n      if (allowedAgentUrls && allowedAgentUrls.length > 0) {\n        const isAllowed = allowedAgentUrls.some((pattern) => {\n          if (typeof pattern === 'string') {\n            return body.agentUrl.startsWith(pattern);\n          }\n          return pattern.test(body.agentUrl);\n        });\n\n        if (!isAllowed) {\n          return new Response(\n            JSON.stringify({ error: 'Agent URL not allowed' }),\n            { status: 403, headers: { 'Content-Type': 'application/json' } }\n          );\n        }\n      }\n\n      // Allow request transformation\n      if (onRequest) {\n        body = await onRequest(body);\n      }\n\n      // Normalize URL\n      let normalizedUrl = body.agentUrl.replace(/\\/$/, '');\n      if (!normalizedUrl.endsWith('/jsonrpc')) {\n        normalizedUrl = `${normalizedUrl}/jsonrpc/`;\n      } else {\n        normalizedUrl = `${normalizedUrl}/`;\n      }\n\n      // Build A2A payload\n      const payload = {\n        jsonrpc: '2.0',\n        method: 'message/stream',\n        params: {\n          message: {\n            role: 'user',\n            messageId: generateUUID(),\n            parts: [{ kind: 'text', text: body.message }],\n          },\n          ...(body.extensions && { extensions: body.extensions }),\n        },\n        id: generateUUID(),\n      };\n\n      const headers: Record<string, string> = {\n        'Content-Type': 'application/json',\n        Accept: 'text/event-stream',\n      };\n\n      if (body.apiKey) {\n        headers['Authorization'] = `Bearer ${body.apiKey}`;\n      }\n\n      // Create abort controller for timeout\n      const controller = new AbortController();\n      const timeoutId = setTimeout(() => controller.abort(), timeout);\n\n      try {\n        const agentResponse = await fetch(normalizedUrl, {\n          method: 'POST',\n          headers,\n          body: JSON.stringify(payload),\n          signal: controller.signal,\n        });\n\n        clearTimeout(timeoutId);\n\n        if (!agentResponse.ok) {\n          const errorText = await agentResponse.text();\n          return new Response(\n            JSON.stringify({\n              error: `Agent error: ${agentResponse.status}`,\n              details: errorText,\n            }),\n            { status: agentResponse.status, headers: { 'Content-Type': 'application/json' } }\n          );\n        }\n\n        if (!agentResponse.body) {\n          return new Response(\n            JSON.stringify({ error: 'Agent response body is null' }),\n            { status: 500, headers: { 'Content-Type': 'application/json' } }\n          );\n        }\n\n        // Stream the response\n        return new Response(agentResponse.body, {\n          headers: {\n            'Content-Type': 'text/event-stream',\n            'Cache-Control': 'no-cache',\n            Connection: 'keep-alive',\n          },\n        });\n      } finally {\n        clearTimeout(timeoutId);\n      }\n    } catch (error) {\n      onError?.(error as Error);\n\n      if ((error as Error).name === 'AbortError') {\n        return new Response(\n          JSON.stringify({ error: 'Request timeout' }),\n          { status: 504, headers: { 'Content-Type': 'application/json' } }\n        );\n      }\n\n      return new Response(\n        JSON.stringify({\n          error: 'Internal server error',\n          message: (error as Error).message,\n        }),\n        { status: 500, headers: { 'Content-Type': 'application/json' } }\n      );\n    }\n  };\n}\n\nexport default createA2AHandler;\n"],"mappings":"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","names":[]}

package/dist/styles/index.css

@@ -0,0 +1,284 @@
+/* src/styles/index.css */
+.a2a-chat {
+  position: relative;
+}
+.a2a-chat--fullscreen {
+  height: 100vh;
+  width: 100%;
+}
+.a2a-chat--sidebar {
+  height: 100%;
+  width: 400px;
+  border-left: 1px solid var(--cds-border-subtle, #e0e0e0);
+}
+.a2a-chat--float {
+  position: fixed;
+  bottom: 20px;
+  right: 20px;
+  z-index: 1000;
+}
+.a2a-chat--loading {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 200px;
+}
+.a2a-chat__spinner {
+  width: 40px;
+  height: 40px;
+  border: 3px solid var(--cds-border-subtle, #e0e0e0);
+  border-top-color: var(--cds-interactive, #0f62fe);
+  border-radius: 50%;
+  animation: a2a-spin 1s linear infinite;
+}
+@keyframes a2a-spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+.a2a-chat--error {
+  padding: 1rem;
+  color: var(--cds-text-error, #da1e28);
+}
+.a2a-chat__form-overlay {
+  position: absolute;
+  inset: 0;
+  background: var(--cds-overlay, rgba(22, 22, 22, 0.5));
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 100;
+}
+.a2a-sources-list {
+  margin-top: 1rem;
+  padding-top: 1rem;
+  border-top: 1px solid var(--cds-border-subtle, #e0e0e0);
+}
+.a2a-sources-list__title {
+  font-size: 0.875rem;
+  font-weight: 600;
+  margin-bottom: 0.5rem;
+  color: var(--cds-text-secondary, #525252);
+}
+.a2a-sources-list__items {
+  list-style: decimal inside;
+  margin: 0;
+  padding: 0;
+}
+.a2a-sources-list__item {
+  font-size: 0.875rem;
+  margin-bottom: 0.25rem;
+}
+.a2a-sources-list__item a {
+  color: var(--cds-link-primary, #0f62fe);
+  text-decoration: none;
+}
+.a2a-sources-list__item a:hover {
+  text-decoration: underline;
+}
+.a2a-agent-switcher {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+}
+.a2a-agent-switcher__label {
+  font-size: 0.875rem;
+  color: var(--cds-text-secondary, #525252);
+}
+.a2a-agent-switcher__select {
+  padding: 0.5rem;
+  border: 1px solid var(--cds-border-strong, #8d8d8d);
+  border-radius: 4px;
+  background: var(--cds-field, #f4f4f4);
+  font-size: 0.875rem;
+}
+.a2a-agent-switcher--tabs .a2a-agent-switcher__tabs {
+  display: flex;
+  gap: 0;
+  border-bottom: 1px solid var(--cds-border-subtle, #e0e0e0);
+}
+.a2a-agent-switcher__tab {
+  padding: 0.75rem 1rem;
+  border: none;
+  background: transparent;
+  cursor: pointer;
+  font-size: 0.875rem;
+  color: var(--cds-text-secondary, #525252);
+  border-bottom: 2px solid transparent;
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  transition: color 0.15s, border-color 0.15s;
+}
+.a2a-agent-switcher__tab:hover {
+  color: var(--cds-text-primary, #161616);
+}
+.a2a-agent-switcher__tab--active {
+  color: var(--cds-text-primary, #161616);
+  border-bottom-color: var(--cds-interactive, #0f62fe);
+}
+.a2a-agent-switcher__icon {
+  width: 20px;
+  height: 20px;
+  border-radius: 50%;
+}
+.a2a-agent-switcher--cards .a2a-agent-switcher__cards {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.75rem;
+}
+.a2a-agent-switcher__card {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  padding: 0.75rem 1rem;
+  border: 1px solid var(--cds-border-subtle, #e0e0e0);
+  border-radius: 8px;
+  background: var(--cds-layer, #ffffff);
+  cursor: pointer;
+  transition: border-color 0.2s, box-shadow 0.2s;
+}
+.a2a-agent-switcher__card:hover {
+  border-color: var(--cds-interactive, #0f62fe);
+}
+.a2a-agent-switcher__card--active {
+  border-color: var(--cds-interactive, #0f62fe);
+  box-shadow: 0 0 0 1px var(--cds-interactive, #0f62fe);
+}
+.a2a-agent-switcher__card-icon {
+  width: 32px;
+  height: 32px;
+  border-radius: 50%;
+}
+.a2a-agent-switcher__card-content {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+}
+.a2a-agent-switcher__card-name {
+  font-size: 0.875rem;
+  font-weight: 500;
+  color: var(--cds-text-primary, #161616);
+}
+.a2a-agent-switcher__card-description {
+  font-size: 0.75rem;
+  color: var(--cds-text-secondary, #525252);
+}
+.a2a-citation-marker {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 1.25rem;
+  height: 1.25rem;
+  padding: 0 0.25rem;
+  margin: 0 0.125rem;
+  font-size: 0.75rem;
+  font-weight: 500;
+  color: var(--cds-link-primary, #0f62fe);
+  background: var(--cds-background-hover, #e8e8e8);
+  border-radius: 0.25rem;
+  cursor: pointer;
+  vertical-align: super;
+  transition: background-color 0.15s;
+}
+.a2a-citation-marker:hover {
+  background: var(--cds-background-active, #c6c6c6);
+}
+.a2a-error {
+  padding: 1rem;
+  background: var(--cds-notification-error-background, #fff1f1);
+  border-left: 3px solid var(--cds-support-error, #da1e28);
+  border-radius: 0 4px 4px 0;
+}
+.a2a-error__title {
+  font-weight: 600;
+  color: var(--cds-text-error, #da1e28);
+  margin-bottom: 0.5rem;
+}
+.a2a-error__message {
+  font-size: 0.875rem;
+  color: var(--cds-text-primary, #161616);
+}
+.a2a-error__stack {
+  margin-top: 0.75rem;
+  padding: 0.75rem;
+  background: var(--cds-field, #f4f4f4);
+  border-radius: 4px;
+  font-family: monospace;
+  font-size: 0.75rem;
+  white-space: pre-wrap;
+  overflow-x: auto;
+}
+.a2a-form {
+  background: var(--cds-layer, #ffffff);
+  border-radius: 8px;
+  padding: 1.5rem;
+  max-width: 400px;
+  width: 100%;
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.15);
+}
+.a2a-form__title {
+  font-size: 1.125rem;
+  font-weight: 600;
+  margin-bottom: 0.5rem;
+}
+.a2a-form__description {
+  font-size: 0.875rem;
+  color: var(--cds-text-secondary, #525252);
+  margin-bottom: 1.5rem;
+}
+.a2a-form__fields {
+  display: flex;
+  flex-direction: column;
+  gap: 1rem;
+}
+.a2a-form__field {
+  display: flex;
+  flex-direction: column;
+  gap: 0.375rem;
+}
+.a2a-form__label {
+  font-size: 0.875rem;
+  font-weight: 500;
+}
+.a2a-form__input {
+  padding: 0.625rem 0.75rem;
+  border: 1px solid var(--cds-border-strong, #8d8d8d);
+  border-radius: 4px;
+  font-size: 0.875rem;
+  background: var(--cds-field, #f4f4f4);
+}
+.a2a-form__input:focus {
+  outline: 2px solid var(--cds-focus, #0f62fe);
+  outline-offset: -2px;
+}
+.a2a-form__actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 0.75rem;
+  margin-top: 1.5rem;
+}
+.a2a-form__button {
+  padding: 0.625rem 1rem;
+  border-radius: 4px;
+  font-size: 0.875rem;
+  font-weight: 500;
+  cursor: pointer;
+  transition: background-color 0.15s;
+}
+.a2a-form__button--secondary {
+  background: transparent;
+  border: 1px solid var(--cds-border-strong, #8d8d8d);
+  color: var(--cds-text-primary, #161616);
+}
+.a2a-form__button--secondary:hover {
+  background: var(--cds-background-hover, #e8e8e8);
+}
+.a2a-form__button--primary {
+  background: var(--cds-interactive, #0f62fe);
+  border: none;
+  color: #ffffff;
+}
+.a2a-form__button--primary:hover {
+  background: var(--cds-interactive-hover, #0353e9);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kuntur/a2a-carbon-chat-adapter",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "A2A protocol adapter for Carbon AI Chat - connect any A2A agent to Carbon Chat UI",
   "type": "module",
   "main": "./dist/index.cjs",