a2a-mesh-adapters 1.0.0

package/dist/index.d.cts

@@ -0,0 +1,184 @@
+import { A2AServer, AnyAgentCard, A2AServerOptions, Task, Message, Artifact, ExtensibleArtifact } from 'a2a-mesh';
+import OpenAI from 'openai';
+
+/**
+ * @file BaseAdapter.ts
+ * Abstract base adapter for A2A implementations.
+ */
+
+declare abstract class BaseAdapter extends A2AServer {
+    constructor(card: AnyAgentCard, options?: A2AServerOptions);
+    /**
+     * Must handle a single task and return generated artifacts.
+     */
+    abstract handleTask(task: Task, message: Message): Promise<Artifact[]>;
+}
+
+/**
+ * @file OpenAIAdapter.ts
+ * Adapter wrapping modern OpenAI Chat/Responses API.
+ * Experimental: Supports textual input and output.
+ */
+
+declare class OpenAIAdapter extends BaseAdapter {
+    private client;
+    private model;
+    private systemPrompt;
+    constructor(card: AnyAgentCard, client: OpenAI, model?: string, systemPrompt?: string);
+    handleTask(task: Task, message: Message): Promise<Artifact[]>;
+    private extractText;
+}
+
+/**
+ * @file LangChainAdapter.ts
+ * Adapter wrapping a LangChain JS v1 runnable / compiled graph.
+ * Experimental: Maps task history to LangChain messages and invokes the runnable.
+ */
+
+interface LangChainRunnable {
+    invoke(input: unknown, options?: unknown): Promise<unknown>;
+}
+declare class LangChainAdapter extends BaseAdapter {
+    private runnable;
+    constructor(card: AnyAgentCard, runnable: LangChainRunnable);
+    handleTask(task: Task, message: Message): Promise<Artifact[]>;
+    private extractText;
+}
+
+/**
+ * @file AnthropicAdapter.ts
+ * Anthropic Claude Messages API adapter.
+ */
+
+interface AnthropicContentTextBlock {
+    type: 'text';
+    text: string;
+}
+interface AnthropicContentToolUseBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+type AnthropicContentBlock = AnthropicContentTextBlock | AnthropicContentToolUseBlock;
+interface AnthropicMessageResponse {
+    content: AnthropicContentBlock[];
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+}
+interface AnthropicTextDeltaEvent {
+    type: 'content_block_delta';
+    delta: {
+        type: 'text_delta';
+        text: string;
+    };
+}
+interface AnthropicClientLike {
+    messages: {
+        create(payload: Record<string, unknown>): Promise<AnthropicMessageResponse> | AsyncIterable<AnthropicTextDeltaEvent>;
+    };
+}
+/**
+ * Adapter for Anthropic Claude Messages-compatible runtimes.
+ *
+ * @since 1.0.0
+ */
+declare class AnthropicAdapter extends BaseAdapter {
+    private readonly client;
+    private readonly model;
+    private readonly systemPrompt?;
+    private readonly maxTokens;
+    constructor(card: AnyAgentCard, client: AnthropicClientLike, model?: string, systemPrompt?: string | undefined, maxTokens?: number);
+    handleTask(task: Task, message: Message): Promise<Artifact[]>;
+}
+
+/**
+ * @file GoogleADKAdapter.ts
+ * HTTP adapter for deployed Google Agent Development Kit agents.
+ */
+
+/**
+ * Remote HTTP adapter for Google Agent Development Kit deployments.
+ *
+ * @experimental
+ * @since 1.0.0
+ */
+declare class GoogleADKAdapter extends BaseAdapter {
+    private readonly adkEndpoint;
+    private readonly apiKey?;
+    constructor(card: AnyAgentCard, adkEndpoint: string, apiKey?: string | undefined);
+    handleTask(task: Task, message: Message): Promise<Artifact[]>;
+}
+
+/**
+ * @file LlamaIndexAdapter.ts
+ * Adapter for LlamaIndex query and chat engines.
+ */
+
+interface LlamaIndexNodeWithScore {
+    score?: number;
+    node?: {
+        metadata?: Record<string, unknown>;
+    };
+}
+interface QueryEngineLike {
+    query(input: string | {
+        query: string;
+    }): Promise<string | {
+        response?: string;
+        sourceNodes?: LlamaIndexNodeWithScore[];
+    }>;
+}
+interface ChatEngineLike {
+    chat(input: string | {
+        message: string;
+        stream?: boolean;
+        chatHistory?: Array<{
+            role: 'user' | 'assistant';
+            content: string;
+        }>;
+    }): Promise<string | {
+        response?: string;
+        message?: string;
+        sourceNodes?: LlamaIndexNodeWithScore[];
+    } | AsyncIterable<{
+        response: string;
+    }>>;
+}
+/**
+ * Adapter for LlamaIndex query and chat engines.
+ *
+ * @since 1.0.0
+ */
+declare class LlamaIndexAdapter extends BaseAdapter {
+    private readonly engine;
+    constructor(card: AnyAgentCard, engine: QueryEngineLike | ChatEngineLike);
+    handleTask(task: Task, message: Message): Promise<ExtensibleArtifact[]>;
+    private isChatEngine;
+    private toArtifact;
+    private isAsyncIterable;
+}
+
+/**
+ * @file CrewAIAdapter.ts
+ * Thin HTTP bridge adapter for CrewAI Python services.
+ *
+ * @beta
+ */
+
+/**
+ * Thin HTTP bridge adapter for CrewAI Python services.
+ *
+ * @beta
+ * @since 1.0.0
+ */
+declare class CrewAIAdapter extends BaseAdapter {
+    private readonly bridgeUrl;
+    constructor(card: AnyAgentCard, bridgeUrl: string);
+    handleTask(task: Task, message: Message): Promise<ExtensibleArtifact[]>;
+}
+
+export { AnthropicAdapter, BaseAdapter, CrewAIAdapter, GoogleADKAdapter, LangChainAdapter, LlamaIndexAdapter, OpenAIAdapter };
+export type { ChatEngineLike, LangChainRunnable, LlamaIndexNodeWithScore, QueryEngineLike };

package/dist/index.d.mts

@@ -0,0 +1,184 @@
+import { A2AServer, AnyAgentCard, A2AServerOptions, Task, Message, Artifact, ExtensibleArtifact } from 'a2a-mesh';
+import OpenAI from 'openai';
+
+/**
+ * @file BaseAdapter.ts
+ * Abstract base adapter for A2A implementations.
+ */
+
+declare abstract class BaseAdapter extends A2AServer {
+    constructor(card: AnyAgentCard, options?: A2AServerOptions);
+    /**
+     * Must handle a single task and return generated artifacts.
+     */
+    abstract handleTask(task: Task, message: Message): Promise<Artifact[]>;
+}
+
+/**
+ * @file OpenAIAdapter.ts
+ * Adapter wrapping modern OpenAI Chat/Responses API.
+ * Experimental: Supports textual input and output.
+ */
+
+declare class OpenAIAdapter extends BaseAdapter {
+    private client;
+    private model;
+    private systemPrompt;
+    constructor(card: AnyAgentCard, client: OpenAI, model?: string, systemPrompt?: string);
+    handleTask(task: Task, message: Message): Promise<Artifact[]>;
+    private extractText;
+}
+
+/**
+ * @file LangChainAdapter.ts
+ * Adapter wrapping a LangChain JS v1 runnable / compiled graph.
+ * Experimental: Maps task history to LangChain messages and invokes the runnable.
+ */
+
+interface LangChainRunnable {
+    invoke(input: unknown, options?: unknown): Promise<unknown>;
+}
+declare class LangChainAdapter extends BaseAdapter {
+    private runnable;
+    constructor(card: AnyAgentCard, runnable: LangChainRunnable);
+    handleTask(task: Task, message: Message): Promise<Artifact[]>;
+    private extractText;
+}
+
+/**
+ * @file AnthropicAdapter.ts
+ * Anthropic Claude Messages API adapter.
+ */
+
+interface AnthropicContentTextBlock {
+    type: 'text';
+    text: string;
+}
+interface AnthropicContentToolUseBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+type AnthropicContentBlock = AnthropicContentTextBlock | AnthropicContentToolUseBlock;
+interface AnthropicMessageResponse {
+    content: AnthropicContentBlock[];
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+}
+interface AnthropicTextDeltaEvent {
+    type: 'content_block_delta';
+    delta: {
+        type: 'text_delta';
+        text: string;
+    };
+}
+interface AnthropicClientLike {
+    messages: {
+        create(payload: Record<string, unknown>): Promise<AnthropicMessageResponse> | AsyncIterable<AnthropicTextDeltaEvent>;
+    };
+}
+/**
+ * Adapter for Anthropic Claude Messages-compatible runtimes.
+ *
+ * @since 1.0.0
+ */
+declare class AnthropicAdapter extends BaseAdapter {
+    private readonly client;
+    private readonly model;
+    private readonly systemPrompt?;
+    private readonly maxTokens;
+    constructor(card: AnyAgentCard, client: AnthropicClientLike, model?: string, systemPrompt?: string | undefined, maxTokens?: number);
+    handleTask(task: Task, message: Message): Promise<Artifact[]>;
+}
+
+/**
+ * @file GoogleADKAdapter.ts
+ * HTTP adapter for deployed Google Agent Development Kit agents.
+ */
+
+/**
+ * Remote HTTP adapter for Google Agent Development Kit deployments.
+ *
+ * @experimental
+ * @since 1.0.0
+ */
+declare class GoogleADKAdapter extends BaseAdapter {
+    private readonly adkEndpoint;
+    private readonly apiKey?;
+    constructor(card: AnyAgentCard, adkEndpoint: string, apiKey?: string | undefined);
+    handleTask(task: Task, message: Message): Promise<Artifact[]>;
+}
+
+/**
+ * @file LlamaIndexAdapter.ts
+ * Adapter for LlamaIndex query and chat engines.
+ */
+
+interface LlamaIndexNodeWithScore {
+    score?: number;
+    node?: {
+        metadata?: Record<string, unknown>;
+    };
+}
+interface QueryEngineLike {
+    query(input: string | {
+        query: string;
+    }): Promise<string | {
+        response?: string;
+        sourceNodes?: LlamaIndexNodeWithScore[];
+    }>;
+}
+interface ChatEngineLike {
+    chat(input: string | {
+        message: string;
+        stream?: boolean;
+        chatHistory?: Array<{
+            role: 'user' | 'assistant';
+            content: string;
+        }>;
+    }): Promise<string | {
+        response?: string;
+        message?: string;
+        sourceNodes?: LlamaIndexNodeWithScore[];
+    } | AsyncIterable<{
+        response: string;
+    }>>;
+}
+/**
+ * Adapter for LlamaIndex query and chat engines.
+ *
+ * @since 1.0.0
+ */
+declare class LlamaIndexAdapter extends BaseAdapter {
+    private readonly engine;
+    constructor(card: AnyAgentCard, engine: QueryEngineLike | ChatEngineLike);
+    handleTask(task: Task, message: Message): Promise<ExtensibleArtifact[]>;
+    private isChatEngine;
+    private toArtifact;
+    private isAsyncIterable;
+}
+
+/**
+ * @file CrewAIAdapter.ts
+ * Thin HTTP bridge adapter for CrewAI Python services.
+ *
+ * @beta
+ */
+
+/**
+ * Thin HTTP bridge adapter for CrewAI Python services.
+ *
+ * @beta
+ * @since 1.0.0
+ */
+declare class CrewAIAdapter extends BaseAdapter {
+    private readonly bridgeUrl;
+    constructor(card: AnyAgentCard, bridgeUrl: string);
+    handleTask(task: Task, message: Message): Promise<ExtensibleArtifact[]>;
+}
+
+export { AnthropicAdapter, BaseAdapter, CrewAIAdapter, GoogleADKAdapter, LangChainAdapter, LlamaIndexAdapter, OpenAIAdapter };
+export type { ChatEngineLike, LangChainRunnable, LlamaIndexNodeWithScore, QueryEngineLike };

package/dist/index.d.ts

@@ -0,0 +1,184 @@
+import { A2AServer, AnyAgentCard, A2AServerOptions, Task, Message, Artifact, ExtensibleArtifact } from 'a2a-mesh';
+import OpenAI from 'openai';
+
+/**
+ * @file BaseAdapter.ts
+ * Abstract base adapter for A2A implementations.
+ */
+
+declare abstract class BaseAdapter extends A2AServer {
+    constructor(card: AnyAgentCard, options?: A2AServerOptions);
+    /**
+     * Must handle a single task and return generated artifacts.
+     */
+    abstract handleTask(task: Task, message: Message): Promise<Artifact[]>;
+}
+
+/**
+ * @file OpenAIAdapter.ts
+ * Adapter wrapping modern OpenAI Chat/Responses API.
+ * Experimental: Supports textual input and output.
+ */
+
+declare class OpenAIAdapter extends BaseAdapter {
+    private client;
+    private model;
+    private systemPrompt;
+    constructor(card: AnyAgentCard, client: OpenAI, model?: string, systemPrompt?: string);
+    handleTask(task: Task, message: Message): Promise<Artifact[]>;
+    private extractText;
+}
+
+/**
+ * @file LangChainAdapter.ts
+ * Adapter wrapping a LangChain JS v1 runnable / compiled graph.
+ * Experimental: Maps task history to LangChain messages and invokes the runnable.
+ */
+
+interface LangChainRunnable {
+    invoke(input: unknown, options?: unknown): Promise<unknown>;
+}
+declare class LangChainAdapter extends BaseAdapter {
+    private runnable;
+    constructor(card: AnyAgentCard, runnable: LangChainRunnable);
+    handleTask(task: Task, message: Message): Promise<Artifact[]>;
+    private extractText;
+}
+
+/**
+ * @file AnthropicAdapter.ts
+ * Anthropic Claude Messages API adapter.
+ */
+
+interface AnthropicContentTextBlock {
+    type: 'text';
+    text: string;
+}
+interface AnthropicContentToolUseBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+type AnthropicContentBlock = AnthropicContentTextBlock | AnthropicContentToolUseBlock;
+interface AnthropicMessageResponse {
+    content: AnthropicContentBlock[];
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+}
+interface AnthropicTextDeltaEvent {
+    type: 'content_block_delta';
+    delta: {
+        type: 'text_delta';
+        text: string;
+    };
+}
+interface AnthropicClientLike {
+    messages: {
+        create(payload: Record<string, unknown>): Promise<AnthropicMessageResponse> | AsyncIterable<AnthropicTextDeltaEvent>;
+    };
+}
+/**
+ * Adapter for Anthropic Claude Messages-compatible runtimes.
+ *
+ * @since 1.0.0
+ */
+declare class AnthropicAdapter extends BaseAdapter {
+    private readonly client;
+    private readonly model;
+    private readonly systemPrompt?;
+    private readonly maxTokens;
+    constructor(card: AnyAgentCard, client: AnthropicClientLike, model?: string, systemPrompt?: string | undefined, maxTokens?: number);
+    handleTask(task: Task, message: Message): Promise<Artifact[]>;
+}
+
+/**
+ * @file GoogleADKAdapter.ts
+ * HTTP adapter for deployed Google Agent Development Kit agents.
+ */
+
+/**
+ * Remote HTTP adapter for Google Agent Development Kit deployments.
+ *
+ * @experimental
+ * @since 1.0.0
+ */
+declare class GoogleADKAdapter extends BaseAdapter {
+    private readonly adkEndpoint;
+    private readonly apiKey?;
+    constructor(card: AnyAgentCard, adkEndpoint: string, apiKey?: string | undefined);
+    handleTask(task: Task, message: Message): Promise<Artifact[]>;
+}
+
+/**
+ * @file LlamaIndexAdapter.ts
+ * Adapter for LlamaIndex query and chat engines.
+ */
+
+interface LlamaIndexNodeWithScore {
+    score?: number;
+    node?: {
+        metadata?: Record<string, unknown>;
+    };
+}
+interface QueryEngineLike {
+    query(input: string | {
+        query: string;
+    }): Promise<string | {
+        response?: string;
+        sourceNodes?: LlamaIndexNodeWithScore[];
+    }>;
+}
+interface ChatEngineLike {
+    chat(input: string | {
+        message: string;
+        stream?: boolean;
+        chatHistory?: Array<{
+            role: 'user' | 'assistant';
+            content: string;
+        }>;
+    }): Promise<string | {
+        response?: string;
+        message?: string;
+        sourceNodes?: LlamaIndexNodeWithScore[];
+    } | AsyncIterable<{
+        response: string;
+    }>>;
+}
+/**
+ * Adapter for LlamaIndex query and chat engines.
+ *
+ * @since 1.0.0
+ */
+declare class LlamaIndexAdapter extends BaseAdapter {
+    private readonly engine;
+    constructor(card: AnyAgentCard, engine: QueryEngineLike | ChatEngineLike);
+    handleTask(task: Task, message: Message): Promise<ExtensibleArtifact[]>;
+    private isChatEngine;
+    private toArtifact;
+    private isAsyncIterable;
+}
+
+/**
+ * @file CrewAIAdapter.ts
+ * Thin HTTP bridge adapter for CrewAI Python services.
+ *
+ * @beta
+ */
+
+/**
+ * Thin HTTP bridge adapter for CrewAI Python services.
+ *
+ * @beta
+ * @since 1.0.0
+ */
+declare class CrewAIAdapter extends BaseAdapter {
+    private readonly bridgeUrl;
+    constructor(card: AnyAgentCard, bridgeUrl: string);
+    handleTask(task: Task, message: Message): Promise<ExtensibleArtifact[]>;
+}
+
+export { AnthropicAdapter, BaseAdapter, CrewAIAdapter, GoogleADKAdapter, LangChainAdapter, LlamaIndexAdapter, OpenAIAdapter };
+export type { ChatEngineLike, LangChainRunnable, LlamaIndexNodeWithScore, QueryEngineLike };