@agent-relay/sdk 3.2.3 → 3.2.5

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"}

package/dist/communicate/adapters/google-adk.js

@@ -0,0 +1,77 @@
+import { Relay } from '../core.js';
+import { formatRelayInbox, formatRelayMessage } from '../types.js';
+/**
+ * Create a FunctionTool-shaped object for Google ADK.
+ * We construct the tool objects duck-typed to avoid importing the actual
+ * FunctionTool class (which requires @google/genai at runtime).
+ */
+function createRelayFunctionTools(relay) {
+    // We dynamically import FunctionTool to create real ADK tool instances
+    // For now, we build tool-like objects that match the FunctionTool constructor shape
+    // and lazily construct them.
+    const toolDefs = [
+        {
+            name: 'relay_send',
+            description: 'Send a direct message to another relay agent.',
+            parameters: { type: 'object', properties: { to: { type: 'string' }, text: { type: 'string' } }, required: ['to', 'text'] },
+            async execute(input) {
+                await relay.send(input.to, input.text);
+                return { result: `Sent relay message to ${input.to}.` };
+            },
+        },
+        {
+            name: 'relay_inbox',
+            description: 'Drain and inspect newly received relay messages.',
+            parameters: { type: 'object', properties: {}, required: [] },
+            async execute() {
+                return { result: formatRelayInbox(await relay.inbox()) };
+            },
+        },
+        {
+            name: 'relay_post',
+            description: 'Post a message to a relay channel.',
+            parameters: { type: 'object', properties: { channel: { type: 'string' }, text: { type: 'string' } }, required: ['channel', 'text'] },
+            async execute(input) {
+                await relay.post(input.channel, input.text);
+                return { result: `Posted relay message to #${input.channel}.` };
+            },
+        },
+        {
+            name: 'relay_agents',
+            description: 'List currently online relay agents.',
+            parameters: { type: 'object', properties: {}, required: [] },
+            async execute() {
+                return { result: (await relay.agents()).join('\n') };
+            },
+        },
+    ];
+    return toolDefs;
+}
+/**
+ * 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 function onRelay(name, options, relay = new Relay(name)) {
+    const { agent, runner, userId = 'relay', sessionId = 'relay-session' } = options;
+    const relayTools = createRelayFunctionTools(relay);
+    // Append relay tools to the agent's tool list
+    for (const tool of relayTools) {
+        agent.tools.push(tool);
+    }
+    let unsubscribe = () => { };
+    if (runner) {
+        unsubscribe = relay.onMessage(async (message) => {
+            const prompt = formatRelayMessage(message);
+            const content = { role: 'user', parts: [{ text: prompt }] };
+            // Drain the async generator to completion
+            for await (const _event of runner.runAsync({ userId, sessionId, newMessage: content })) {
+                // Events are consumed; the agent handles them internally.
+            }
+        });
+    }
+    return { agent, tools: relayTools, unsubscribe };
+}
+//# sourceMappingURL=google-adk.js.map

package/dist/communicate/adapters/google-adk.js.map

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

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

@@ -0,0 +1,7 @@
+export { onRelay as onPiRelay } from './pi.js';
+export { onRelay as onClaudeRelay } from './claude-sdk.js';
+export { onRelay as onCrewAIRelay, onCrewRelay } from './crewai.js';
+export { onRelay as onOpenAIAgentsRelay } from './openai-agents.js';
+export { onRelay as onLangGraphRelay } from './langgraph.js';
+export { onRelay as onGoogleAdkRelay } from './google-adk.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/communicate/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/communicate/adapters/index.js

@@ -0,0 +1,7 @@
+export { onRelay as onPiRelay } from './pi.js';
+export { onRelay as onClaudeRelay } from './claude-sdk.js';
+export { onRelay as onCrewAIRelay, onCrewRelay } from './crewai.js';
+export { onRelay as onOpenAIAgentsRelay } from './openai-agents.js';
+export { onRelay as onLangGraphRelay } from './langgraph.js';
+export { onRelay as onGoogleAdkRelay } from './google-adk.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/communicate/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,40 @@
+import { type Message, type MessageCallback } from '../types.js';
+/** Minimal shape of a LangGraph CompiledStateGraph for relay integration. */
+type CompiledGraphLike = {
+    invoke(input: Record<string, unknown>, config?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    nodes: Record<string, unknown>;
+};
+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;
+};
+/** A tool definition compatible with LangGraph ToolNode. */
+export interface RelayToolDef {
+    name: string;
+    description: string;
+    schema: Record<string, unknown>;
+    invoke(input: Record<string, string>): Promise<string>;
+}
+export interface LangGraphRelayResult {
+    /** Relay tool definitions to pass to a LangGraph ToolNode. */
+    tools: RelayToolDef[];
+    /** Unsubscribe from incoming relay messages. */
+    unsubscribe: () => void;
+}
+/**
+ * Attach relay communication tools and message routing to a LangGraph compiled graph.
+ *
+ * Tools are returned as objects compatible with LangGraph's ToolNode. Incoming
+ * relay messages are routed into the graph via `graph.invoke()` with a
+ * `messages` state update.
+ *
+ * @param graph - A compiled LangGraph state graph.
+ * @param relayOrName - Optional pre-configured Relay instance or agent name string (defaults to 'langgraph').
+ * @returns Relay tools and an unsubscribe handle.
+ */
+export declare function onRelay(graph: CompiledGraphLike, relayOrName?: RelayLike | string): LangGraphRelayResult;
+export {};
+//# sourceMappingURL=langgraph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"langgraph.d.ts","sourceRoot":"","sources":["../../../src/communicate/adapters/langgraph.ts"],"names":[],"mappings":"AACA,OAAO,EAAwC,KAAK,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEvG,6EAA6E;AAC7E,KAAK,iBAAiB,GAAG;IACvB,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3G,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,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,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACxD;AAuDD,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,gDAAgD;IAChD,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,iBAAiB,EACxB,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,GAC/B,oBAAoB,CAYtB"}

package/dist/communicate/adapters/langgraph.js

@@ -0,0 +1,77 @@
+import { Relay } from '../core.js';
+import { formatRelayInbox, formatRelayMessage } from '../types.js';
+function createRelayTools(relay) {
+    return [
+        {
+            name: 'relay_send',
+            description: 'Send a direct message to another relay agent.',
+            schema: {
+                type: 'object',
+                properties: {
+                    to: { type: 'string', description: 'Recipient agent name' },
+                    text: { type: 'string', description: 'Message text' },
+                },
+                required: ['to', 'text'],
+            },
+            async invoke(input) {
+                await relay.send(input.to, input.text);
+                return `Sent relay message to ${input.to}.`;
+            },
+        },
+        {
+            name: 'relay_inbox',
+            description: 'Drain and inspect newly received relay messages.',
+            schema: { type: 'object', properties: {}, required: [] },
+            async invoke() {
+                return formatRelayInbox(await relay.inbox());
+            },
+        },
+        {
+            name: 'relay_post',
+            description: 'Post a message to a relay channel.',
+            schema: {
+                type: 'object',
+                properties: {
+                    channel: { type: 'string', description: 'Channel name' },
+                    text: { type: 'string', description: 'Message text' },
+                },
+                required: ['channel', 'text'],
+            },
+            async invoke(input) {
+                await relay.post(input.channel, input.text);
+                return `Posted relay message to #${input.channel}.`;
+            },
+        },
+        {
+            name: 'relay_agents',
+            description: 'List currently online relay agents.',
+            schema: { type: 'object', properties: {}, required: [] },
+            async invoke() {
+                return (await relay.agents()).join('\n');
+            },
+        },
+    ];
+}
+/**
+ * Attach relay communication tools and message routing to a LangGraph compiled graph.
+ *
+ * Tools are returned as objects compatible with LangGraph's ToolNode. Incoming
+ * relay messages are routed into the graph via `graph.invoke()` with a
+ * `messages` state update.
+ *
+ * @param graph - A compiled LangGraph state graph.
+ * @param relayOrName - Optional pre-configured Relay instance or agent name string (defaults to 'langgraph').
+ * @returns Relay tools and an unsubscribe handle.
+ */
+export function onRelay(graph, relayOrName) {
+    const r = typeof relayOrName === 'string'
+        ? new Relay(relayOrName)
+        : relayOrName ?? new Relay('langgraph');
+    const tools = createRelayTools(r);
+    const unsubscribe = r.onMessage(async (message) => {
+        const prompt = formatRelayMessage(message);
+        await graph.invoke({ messages: [{ role: 'user', content: prompt }] });
+    });
+    return { tools, unsubscribe };
+}
+//# sourceMappingURL=langgraph.js.map

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

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

package/dist/communicate/adapters/openai-agents.d.ts

@@ -0,0 +1,25 @@
+import { type Message, type MessageCallback } from '../types.js';
+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;
+};
+type AgentLike = {
+    name: string;
+    instructions: string | ((...args: unknown[]) => string | Promise<string>);
+    tools: unknown[];
+};
+/**
+ * Attach relay communication tools and message routing to an OpenAI Agent.
+ * @param agent - OpenAI Agent instance to augment with relay tools.
+ * @param relay - Optional pre-configured Relay instance.
+ * @returns Object with the augmented agent and a cleanup function.
+ */
+export declare function onRelay<TAgent extends AgentLike>(agent: TAgent, relay?: RelayLike): {
+    agent: TAgent;
+    cleanup: () => void;
+};
+export {};
+//# sourceMappingURL=openai-agents.d.ts.map

package/dist/communicate/adapters/openai-agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-agents.d.ts","sourceRoot":"","sources":["../../../src/communicate/adapters/openai-agents.ts"],"names":[],"mappings":"AACA,OAAO,EAAwC,KAAK,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEvG,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;AAoBF,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1E,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB,CAAC;AAqCF;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,MAAM,SAAS,SAAS,EAC9C,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,SAAiC,GACvC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CAiCxC"}

package/dist/communicate/adapters/openai-agents.js

@@ -0,0 +1,70 @@
+import { Relay } from '../core.js';
+import { formatRelayInbox, formatRelayMessage } from '../types.js';
+function schema(props, required) {
+    return { type: 'object', properties: props, required, additionalProperties: false };
+}
+function createRelayTools(relay) {
+    const defs = [
+        ['relay_send', 'Send a direct message to another relay agent.',
+            schema({ to: { type: 'string' }, text: { type: 'string' } }, ['to', 'text']),
+            async (p) => { await relay.send(p.to, p.text); return `Sent relay message to ${p.to}.`; }],
+        ['relay_inbox', 'Drain and inspect newly received relay messages.',
+            schema({}, []),
+            async () => formatRelayInbox(await relay.inbox())],
+        ['relay_post', 'Post a message to a relay channel.',
+            schema({ channel: { type: 'string' }, text: { type: 'string' } }, ['channel', 'text']),
+            async (p) => { await relay.post(p.channel, p.text); return `Posted relay message to #${p.channel}.`; }],
+        ['relay_agents', 'List currently online relay agents.',
+            schema({}, []),
+            async () => (await relay.agents()).join('\n')],
+    ];
+    return defs.map(([name, description, parameters, run]) => ({
+        type: 'function',
+        name,
+        description,
+        parameters,
+        strict: false,
+        needsApproval: false,
+        isEnabled: true,
+        async invoke(_runContext, input) {
+            const params = input ? JSON.parse(input) : {};
+            return run(params);
+        },
+    }));
+}
+/**
+ * Attach relay communication tools and message routing to an OpenAI Agent.
+ * @param agent - OpenAI Agent instance to augment with relay tools.
+ * @param relay - Optional pre-configured Relay instance.
+ * @returns Object with the augmented agent and a cleanup function.
+ */
+export function onRelay(agent, relay = new Relay(agent.name)) {
+    const relayTools = createRelayTools(relay);
+    agent.tools = [...agent.tools, ...relayTools];
+    const pendingMessages = [];
+    const originalInstructions = agent.instructions;
+    const unsubscribe = relay.onMessage(async (message) => {
+        pendingMessages.push(formatRelayMessage(message));
+    });
+    agent.instructions = async (...args) => {
+        let base;
+        if (typeof originalInstructions === 'function') {
+            base = await originalInstructions(...args);
+        }
+        else {
+            base = originalInstructions ?? '';
+        }
+        if (pendingMessages.length > 0) {
+            const msgs = pendingMessages.splice(0, pendingMessages.length);
+            return `${base}\n\n--- Relay Messages ---\n${msgs.join('\n')}`;
+        }
+        return base;
+    };
+    const cleanup = () => {
+        unsubscribe();
+        agent.instructions = originalInstructions;
+        agent.tools = agent.tools.filter((t) => !relayTools.includes(t));
+    };
+    return { agent, cleanup };
+}
+//# sourceMappingURL=openai-agents.js.map

package/dist/communicate/adapters/openai-agents.js.map

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