@agent-relay/sdk 3.2.2 → 3.2.4

package/dist/communicate/a2a-types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * A2A (Agent-to-Agent) protocol data model types.
+ */
+export interface A2APart {
+    text?: string;
+    file?: Record<string, unknown>;
+    data?: Record<string, unknown>;
+}
+export interface A2AMessage {
+    role: 'user' | 'agent';
+    parts: A2APart[];
+    messageId?: string;
+    contextId?: string;
+    taskId?: string;
+}
+export type A2ATaskState = 'submitted' | 'working' | 'completed' | 'failed' | 'canceled';
+export declare const VALID_TASK_STATES: ReadonlySet<string>;
+export interface A2ATaskStatus {
+    state: A2ATaskState;
+    message?: A2AMessage;
+    timestamp?: string;
+}
+export interface A2ATask {
+    id: string;
+    contextId?: string;
+    status: A2ATaskStatus;
+    messages: A2AMessage[];
+    artifacts: Record<string, unknown>[];
+}
+export interface A2ASkill {
+    id: string;
+    name: string;
+    description: string;
+}
+export interface A2AAgentCard {
+    name: string;
+    description: string;
+    url: string;
+    version: string;
+    capabilities: Record<string, unknown>;
+    skills: A2ASkill[];
+    defaultInputModes: string[];
+    defaultOutputModes: string[];
+}
+export interface A2AConfig {
+    /** Server mode */
+    serverPort?: number;
+    serverHost?: string;
+    /** Client mode */
+    targetUrl?: string;
+    /** Agent Card registry (known A2A agent URLs) */
+    registry?: string[];
+    /** Auth */
+    authScheme?: 'bearer' | 'api_key' | string;
+    authToken?: string;
+    /** Agent metadata */
+    agentDescription?: string;
+    skills?: A2ASkill[];
+}
+export declare function createA2APart(text?: string): A2APart;
+export declare function createA2AMessage(role: 'user' | 'agent', parts: A2APart[], opts?: {
+    messageId?: string;
+    contextId?: string;
+    taskId?: string;
+}): A2AMessage;
+export declare function createA2ATaskStatus(state: A2ATaskState, message?: A2AMessage): A2ATaskStatus;
+export declare function createA2ATask(id: string, contextId?: string): A2ATask;
+export declare function createA2AAgentCard(name: string, description: string, url: string, skills?: A2ASkill[]): A2AAgentCard;
+export declare function a2aPartToDict(part: A2APart): Record<string, unknown>;
+export declare function a2aPartFromDict(d: Record<string, unknown>): A2APart;
+export declare function a2aMessageToDict(msg: A2AMessage): Record<string, unknown>;
+export declare function a2aMessageFromDict(d: Record<string, unknown>): A2AMessage;
+export declare function a2aMessageGetText(msg: A2AMessage): string;
+export declare function a2aTaskStatusToDict(status: A2ATaskStatus): Record<string, unknown>;
+export declare function a2aTaskStatusFromDict(d: Record<string, unknown>): A2ATaskStatus;
+export declare function a2aTaskToDict(task: A2ATask): Record<string, unknown>;
+export declare function a2aTaskFromDict(d: Record<string, unknown>): A2ATask;
+export declare function a2aSkillToDict(skill: A2ASkill): Record<string, unknown>;
+export declare function a2aSkillFromDict(d: Record<string, unknown>): A2ASkill;
+export declare function a2aAgentCardToDict(card: A2AAgentCard): Record<string, unknown>;
+export declare function a2aAgentCardFromDict(d: Record<string, unknown>): A2AAgentCard;
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    method: string;
+    params: Record<string, unknown>;
+    id: string | number;
+}
+export interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+    };
+    id: string | number | null;
+}
+export declare function makeJsonRpcRequest(method: string, params: Record<string, unknown>, id?: string | number): JsonRpcRequest;
+export declare function makeJsonRpcResponse(result: unknown, id: string | number): JsonRpcResponse;
+export declare function makeJsonRpcError(code: number, message: string, id: string | number | null): JsonRpcResponse;
+export declare const JSONRPC_PARSE_ERROR = -32700;
+export declare const JSONRPC_INVALID_REQUEST = -32600;
+export declare const JSONRPC_METHOD_NOT_FOUND = -32601;
+export declare const JSONRPC_INVALID_PARAMS = -32602;
+export declare const JSONRPC_INTERNAL_ERROR = -32603;
+export declare const A2A_TASK_NOT_FOUND = -32001;
+export declare const A2A_TASK_NOT_CANCELABLE = -32002;
+//# sourceMappingURL=a2a-types.d.ts.map

package/dist/communicate/a2a-types.d.ts.map

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

package/dist/communicate/a2a-types.js

@@ -0,0 +1,209 @@
+/**
+ * A2A (Agent-to-Agent) protocol data model types.
+ */
+import { randomUUID } from 'node:crypto';
+export const VALID_TASK_STATES = new Set([
+    'submitted',
+    'working',
+    'completed',
+    'failed',
+    'canceled',
+]);
+// --- Factories ---
+export function createA2APart(text) {
+    const part = {};
+    if (text !== undefined)
+        part.text = text;
+    return part;
+}
+export function createA2AMessage(role, parts, opts) {
+    return {
+        role,
+        parts,
+        messageId: opts?.messageId ?? randomUUID(),
+        contextId: opts?.contextId,
+        taskId: opts?.taskId,
+    };
+}
+export function createA2ATaskStatus(state, message) {
+    return {
+        state,
+        message,
+        timestamp: new Date().toISOString(),
+    };
+}
+export function createA2ATask(id, contextId) {
+    return {
+        id,
+        contextId,
+        status: createA2ATaskStatus('submitted'),
+        messages: [],
+        artifacts: [],
+    };
+}
+export function createA2AAgentCard(name, description, url, skills = []) {
+    return {
+        name,
+        description,
+        url,
+        version: '1.0.0',
+        capabilities: { streaming: true, pushNotifications: false },
+        skills,
+        defaultInputModes: ['text'],
+        defaultOutputModes: ['text'],
+    };
+}
+// --- Serialization helpers ---
+export function a2aPartToDict(part) {
+    const d = {};
+    if (part.text !== undefined)
+        d.text = part.text;
+    if (part.file !== undefined)
+        d.file = part.file;
+    if (part.data !== undefined)
+        d.data = part.data;
+    return d;
+}
+export function a2aPartFromDict(d) {
+    return {
+        text: d.text,
+        file: d.file,
+        data: d.data,
+    };
+}
+export function a2aMessageToDict(msg) {
+    const d = {
+        role: msg.role,
+        parts: msg.parts.map(a2aPartToDict),
+    };
+    if (msg.messageId !== undefined)
+        d.messageId = msg.messageId;
+    if (msg.contextId !== undefined)
+        d.contextId = msg.contextId;
+    if (msg.taskId !== undefined)
+        d.taskId = msg.taskId;
+    return d;
+}
+export function a2aMessageFromDict(d) {
+    const parts = (d.parts ?? []).map(a2aPartFromDict);
+    return {
+        role: d.role,
+        parts,
+        messageId: d.messageId,
+        contextId: d.contextId,
+        taskId: d.taskId,
+    };
+}
+export function a2aMessageGetText(msg) {
+    return msg.parts
+        .filter((p) => p.text)
+        .map((p) => p.text)
+        .join(' ');
+}
+export function a2aTaskStatusToDict(status) {
+    const d = { state: status.state };
+    if (status.message !== undefined)
+        d.message = a2aMessageToDict(status.message);
+    if (status.timestamp !== undefined)
+        d.timestamp = status.timestamp;
+    return d;
+}
+export function a2aTaskStatusFromDict(d) {
+    let message;
+    if (d.message !== undefined && d.message !== null) {
+        message = a2aMessageFromDict(d.message);
+    }
+    return {
+        state: d.state,
+        message,
+        timestamp: d.timestamp,
+    };
+}
+export function a2aTaskToDict(task) {
+    return {
+        id: task.id,
+        contextId: task.contextId,
+        status: a2aTaskStatusToDict(task.status),
+        messages: task.messages.map(a2aMessageToDict),
+        artifacts: task.artifacts,
+    };
+}
+export function a2aTaskFromDict(d) {
+    const status = d.status
+        ? a2aTaskStatusFromDict(d.status)
+        : createA2ATaskStatus('submitted');
+    const messages = (d.messages ?? []).map(a2aMessageFromDict);
+    return {
+        id: d.id,
+        contextId: d.contextId,
+        status,
+        messages,
+        artifacts: d.artifacts ?? [],
+    };
+}
+export function a2aSkillToDict(skill) {
+    return { id: skill.id, name: skill.name, description: skill.description };
+}
+export function a2aSkillFromDict(d) {
+    return {
+        id: d.id,
+        name: d.name,
+        description: d.description,
+    };
+}
+export function a2aAgentCardToDict(card) {
+    return {
+        name: card.name,
+        description: card.description,
+        url: card.url,
+        version: card.version,
+        capabilities: card.capabilities,
+        skills: card.skills.map(a2aSkillToDict),
+        defaultInputModes: card.defaultInputModes,
+        defaultOutputModes: card.defaultOutputModes,
+    };
+}
+export function a2aAgentCardFromDict(d) {
+    const skills = (d.skills ?? []).map(a2aSkillFromDict);
+    return {
+        name: d.name,
+        description: d.description,
+        url: d.url,
+        version: d.version ?? '1.0.0',
+        capabilities: d.capabilities ?? {
+            streaming: true,
+            pushNotifications: false,
+        },
+        skills,
+        defaultInputModes: d.defaultInputModes ?? ['text'],
+        defaultOutputModes: d.defaultOutputModes ?? ['text'],
+    };
+}
+export function makeJsonRpcRequest(method, params, id) {
+    return {
+        jsonrpc: '2.0',
+        method,
+        params,
+        id: id ?? randomUUID(),
+    };
+}
+export function makeJsonRpcResponse(result, id) {
+    return { jsonrpc: '2.0', result, id };
+}
+export function makeJsonRpcError(code, message, id) {
+    return {
+        jsonrpc: '2.0',
+        error: { code, message },
+        id,
+    };
+}
+// Standard JSON-RPC error codes
+export const JSONRPC_PARSE_ERROR = -32700;
+export const JSONRPC_INVALID_REQUEST = -32600;
+export const JSONRPC_METHOD_NOT_FOUND = -32601;
+export const JSONRPC_INVALID_PARAMS = -32602;
+export const JSONRPC_INTERNAL_ERROR = -32603;
+// A2A-specific error codes
+export const A2A_TASK_NOT_FOUND = -32001;
+export const A2A_TASK_NOT_CANCELABLE = -32002;
+//# sourceMappingURL=a2a-types.js.map

package/dist/communicate/a2a-types.js.map

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

package/dist/communicate/adapters/claude-sdk.d.ts

@@ -0,0 +1,28 @@
+import { type Message } from '../types.js';
+type HookResult = {
+    continue?: boolean;
+    systemMessage?: string;
+};
+type HookCallback = (...args: unknown[]) => Promise<HookResult>;
+type HookMatcher = {
+    matcher?: string;
+    hooks: HookCallback[];
+    timeout?: number;
+};
+type ClaudeOptionsLike = {
+    mcpServers?: Record<string, unknown>;
+    hooks?: Partial<Record<'PostToolUse' | 'Stop', HookMatcher[]>>;
+};
+type RelayLike = {
+    inbox(): Promise<Message[]>;
+};
+/**
+ * Attach relay communication to Claude Agent SDK options via MCP server and hooks.
+ * @param _name - Agent name for relay registration.
+ * @param options - Claude SDK query options to augment.
+ * @param relay - Optional pre-configured Relay instance.
+ * @returns Augmented options with relaycast MCP server and inbox-draining hooks.
+ */
+export declare function onRelay<TOptions extends ClaudeOptionsLike>(_name: string, options: TOptions, relay?: RelayLike): TOptions;
+export {};
+//# sourceMappingURL=claude-sdk.d.ts.map

package/dist/communicate/adapters/claude-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-sdk.d.ts","sourceRoot":"","sources":["../../../src/communicate/adapters/claude-sdk.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAE/D,KAAK,UAAU,GAAG;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,KAAK,YAAY,GAAG,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;AAEhE,KAAK,WAAW,GAAG;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,GAAG,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;CAChE,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;CAC7B,CAAC;AAwBF;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,QAAQ,SAAS,iBAAiB,EACxD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,QAAQ,EACjB,KAAK,GAAE,SAA4B,GAClC,QAAQ,CA0BV"}

package/dist/communicate/adapters/claude-sdk.js

@@ -0,0 +1,47 @@
+import { Relay } from '../core.js';
+import { formatRelayMessage } from '../types.js';
+function appendHook(hooks, event, callback) {
+    const matchers = [...(hooks?.[event] ?? []), { hooks: [callback] }];
+    return {
+        ...hooks,
+        [event]: matchers,
+    };
+}
+async function drainInbox(relay) {
+    const messages = await relay.inbox();
+    if (messages.length === 0) {
+        return undefined;
+    }
+    return `New messages from other agents:\n${messages.map((message) => formatRelayMessage(message)).join('\n')}`;
+}
+/**
+ * Attach relay communication to Claude Agent SDK options via MCP server and hooks.
+ * @param _name - Agent name for relay registration.
+ * @param options - Claude SDK query options to augment.
+ * @param relay - Optional pre-configured Relay instance.
+ * @returns Augmented options with relaycast MCP server and inbox-draining hooks.
+ */
+export function onRelay(_name, options, relay = new Relay(_name)) {
+    const mcpServers = {
+        ...(options.mcpServers ?? {}),
+        relaycast: {
+            command: 'agent-relay',
+            args: ['mcp'],
+        },
+    };
+    let hooks = options.hooks;
+    hooks = appendHook(hooks, 'PostToolUse', async () => {
+        const systemMessage = await drainInbox(relay);
+        return systemMessage ? { systemMessage } : {};
+    });
+    hooks = appendHook(hooks, 'Stop', async () => {
+        const systemMessage = await drainInbox(relay);
+        return systemMessage ? { continue: true, systemMessage } : {};
+    });
+    return {
+        ...options,
+        mcpServers,
+        hooks,
+    };
+}
+//# sourceMappingURL=claude-sdk.js.map

package/dist/communicate/adapters/claude-sdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-sdk.js","sourceRoot":"","sources":["../../../src/communicate/adapters/claude-sdk.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAgB,MAAM,aAAa,CAAC;AAwB/D,SAAS,UAAU,CACjB,KAAiC,EACjC,KAA6B,EAC7B,QAAsB;IAEtB,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAEpE,OAAO;QACL,GAAG,KAAK;QACR,CAAC,KAAK,CAAC,EAAE,QAAQ;KAClB,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,KAAgB;IACxC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IACrC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,oCAAoC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACjH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CACrB,KAAa,EACb,OAAiB,EACjB,QAAmB,IAAI,KAAK,CAAC,KAAK,CAAC;IAEnC,MAAM,UAAU,GAAG;QACjB,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;QAC7B,SAAS,EAAE;YACT,OAAO,EAAE,aAAa;YACtB,IAAI,EAAE,CAAC,KAAK,CAAC;SACd;KACF,CAAC;IAEF,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAE1B,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,aAAa,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,aAAa,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,aAAa,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,aAAa,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,OAAO;QACV,UAAU;QACV,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/communicate/adapters/crewai.d.ts

@@ -0,0 +1,42 @@
+import { type Message, type MessageCallback } from '../types.js';
+type CrewAIAgentLike = {
+    role: string;
+    tools: any[];
+    step_callback?: ((step: any) => void) | null;
+};
+type CrewAICrewLike = {
+    agents: CrewAIAgentLike[];
+    task_callback?: ((output: any) => void) | null;
+};
+type RelayLike = {
+    send(to: string, text: string): Promise<void>;
+    post(channel: string, text: string): Promise<void>;
+    inbox(): Promise<Message[]>;
+    agents(): Promise<string[]>;
+    onMessage(callback: MessageCallback): () => void;
+};
+/**
+ * Attach relay communication tools and message routing to a CrewAI Agent.
+ *
+ * Adds relay tools to the agent's `tools` array and installs a `step_callback`
+ * that receives incoming relay messages.
+ *
+ * @param agent - A CrewAI Agent instance (or duck-typed equivalent).
+ * @param relay - Optional pre-configured Relay instance.
+ * @returns Object with an `unsubscribe` function to stop message routing.
+ */
+export declare function onRelay(agent: CrewAIAgentLike, relay?: RelayLike): {
+    unsubscribe: () => void;
+};
+/**
+ * Attach relay communication tools to all agents in a CrewAI Crew.
+ *
+ * @param crew - A CrewAI Crew instance (or duck-typed equivalent).
+ * @param relay - Optional pre-configured Relay instance.
+ * @returns Object with an `unsubscribe` function to stop all message routing.
+ */
+export declare function onCrewRelay(crew: CrewAICrewLike, relay?: RelayLike): {
+    unsubscribe: () => void;
+};
+export {};
+//# sourceMappingURL=crewai.d.ts.map

package/dist/communicate/adapters/crewai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crewai.d.ts","sourceRoot":"","sources":["../../../src/communicate/adapters/crewai.ts"],"names":[],"mappings":"AACA,OAAO,EAAwC,KAAK,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAavG,KAAK,eAAe,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,GAAG,EAAE,CAAC;IACb,aAAa,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9C,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;CAChD,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5B,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5B,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI,CAAC;CAClD,CAAC;AAqCF;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,eAAe,EACtB,KAAK,CAAC,EAAE,SAAS,GAChB;IAAE,WAAW,EAAE,MAAM,IAAI,CAAA;CAAE,CAgC7B;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,cAAc,EACpB,KAAK,CAAC,EAAE,SAAS,GAChB;IAAE,WAAW,EAAE,MAAM,IAAI,CAAA;CAAE,CAe7B"}

package/dist/communicate/adapters/crewai.js

@@ -0,0 +1,95 @@
+import { Relay } from '../core.js';
+import { formatRelayInbox, formatRelayMessage } from '../types.js';
+function createRelayTools(relay) {
+    return [
+        {
+            tool_name: 'relay_send',
+            description: 'Send a direct message to another relay agent.',
+            async execute(args) {
+                await relay.send(args.to, args.text);
+                return `Sent relay message to ${args.to}.`;
+            },
+        },
+        {
+            tool_name: 'relay_inbox',
+            description: 'Drain and inspect newly received relay messages.',
+            async execute() {
+                return formatRelayInbox(await relay.inbox());
+            },
+        },
+        {
+            tool_name: 'relay_post',
+            description: 'Post a message to a relay channel.',
+            async execute(args) {
+                await relay.post(args.channel, args.text);
+                return `Posted relay message to #${args.channel}.`;
+            },
+        },
+        {
+            tool_name: 'relay_agents',
+            description: 'List currently online relay agents.',
+            async execute() {
+                return (await relay.agents()).join('\n');
+            },
+        },
+    ];
+}
+/**
+ * Attach relay communication tools and message routing to a CrewAI Agent.
+ *
+ * Adds relay tools to the agent's `tools` array and installs a `step_callback`
+ * that receives incoming relay messages.
+ *
+ * @param agent - A CrewAI Agent instance (or duck-typed equivalent).
+ * @param relay - Optional pre-configured Relay instance.
+ * @returns Object with an `unsubscribe` function to stop message routing.
+ */
+export function onRelay(agent, relay) {
+    const relayInstance = relay ?? new Relay(agent.role);
+    const relayTools = createRelayTools(relayInstance);
+    // Append relay tools to agent's tools array
+    for (const tool of relayTools) {
+        agent.tools.push(tool);
+    }
+    // Install message routing via step_callback
+    const originalCallback = agent.step_callback;
+    const unsubscribe = relayInstance.onMessage(async (message) => {
+        const formatted = formatRelayMessage(message);
+        // Route relay messages through the original callback if one exists
+        if (originalCallback) {
+            originalCallback({ relay_message: formatted });
+        }
+    });
+    // Compose original callback with relay step forwarding
+    if (originalCallback) {
+        agent.step_callback = (step) => {
+            // Forward non-relay steps to original callback
+            if (!step?.relay_message) {
+                originalCallback(step);
+            }
+        };
+    }
+    return { unsubscribe };
+}
+/**
+ * Attach relay communication tools to all agents in a CrewAI Crew.
+ *
+ * @param crew - A CrewAI Crew instance (or duck-typed equivalent).
+ * @param relay - Optional pre-configured Relay instance.
+ * @returns Object with an `unsubscribe` function to stop all message routing.
+ */
+export function onCrewRelay(crew, relay) {
+    const unsubscribers = [];
+    for (const agent of crew.agents) {
+        const result = onRelay(agent, relay);
+        unsubscribers.push(result.unsubscribe);
+    }
+    return {
+        unsubscribe() {
+            for (const unsub of unsubscribers) {
+                unsub();
+            }
+        },
+    };
+}
+//# sourceMappingURL=crewai.js.map

package/dist/communicate/adapters/crewai.js.map

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

package/dist/communicate/adapters/google-adk.d.ts

@@ -0,0 +1,53 @@
+import { type Message, type MessageCallback } from '../types.js';
+type FunctionToolLike = {
+    name: string;
+    description: string;
+};
+type ToolUnionLike = FunctionToolLike;
+type RunnerLike = {
+    runAsync(params: {
+        userId: string;
+        sessionId: string;
+        newMessage: {
+            role: string;
+            parts: Array<{
+                text: string;
+            }>;
+        };
+    }): AsyncGenerator<unknown, void, undefined>;
+};
+type LlmAgentLike = {
+    name: string;
+    tools: ToolUnionLike[];
+};
+type RelayLike = {
+    send(to: string, text: string): Promise<void>;
+    post(channel: string, text: string): Promise<void>;
+    inbox(): Promise<Message[]>;
+    agents(): Promise<string[]>;
+    onMessage(callback: MessageCallback): () => void;
+};
+interface GoogleAdkRelayOptions {
+    /** Google ADK LlmAgent instance. */
+    agent: LlmAgentLike;
+    /** Optional Runner for routing incoming messages to the agent. */
+    runner?: RunnerLike;
+    /** User ID for runner sessions. Defaults to 'relay'. */
+    userId?: string;
+    /** Session ID for runner sessions. Defaults to 'relay-session'. */
+    sessionId?: string;
+}
+/**
+ * Attach relay communication tools and message routing to a Google ADK agent.
+ * @param name - Agent name for relay registration.
+ * @param options - Google ADK agent and optional runner configuration.
+ * @param relay - Optional pre-configured Relay instance.
+ * @returns Object with the augmented agent, an unsubscribe function, and the relay tools added.
+ */
+export declare function onRelay(name: string, options: GoogleAdkRelayOptions, relay?: RelayLike): {
+    agent: LlmAgentLike;
+    tools: FunctionToolLike[];
+    unsubscribe: () => void;
+};
+export {};
+//# sourceMappingURL=google-adk.d.ts.map

package/dist/communicate/adapters/google-adk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-adk.d.ts","sourceRoot":"","sources":["../../../src/communicate/adapters/google-adk.ts"],"names":[],"mappings":"AACA,OAAO,EAAwC,KAAK,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAQvG,KAAK,gBAAgB,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,KAAK,aAAa,GAAG,gBAAgB,CAAC;AAEtC,KAAK,UAAU,GAAG;IAChB,QAAQ,CAAC,MAAM,EAAE;QACf,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;KAC9D,GAAG,cAAc,CAAC,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;CAC9C,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5B,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5B,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI,CAAC;CAClD,CAAC;AAEF,UAAU,qBAAqB;IAC7B,oCAAoC;IACpC,KAAK,EAAE,YAAY,CAAC;IACpB,kEAAkE;IAClE,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAwDD;;;;;;GAMG;AACH,wBAAgB,OAAO,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,qBAAqB,EAC9B,KAAK,GAAE,SAA2B,GACjC;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,IAAI,CAAA;CAAE,CAyB7E"}