@agent-relay/sdk 3.2.2 → 3.2.4

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

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

@@ -0,0 +1,45 @@
+import { type Message, type MessageCallback } from '../types.js';
+type ToolResult = {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    details: Record<string, unknown>;
+};
+type RelayTool = {
+    name: string;
+    label: string;
+    description: string;
+    parameters: unknown;
+    execute: (toolCallId: string, params: any, signal?: AbortSignal, onUpdate?: unknown) => Promise<ToolResult>;
+};
+type PiSessionLike = {
+    isStreaming: boolean;
+    steer(text: string): Promise<void>;
+    followUp(text: string): Promise<void>;
+};
+type PiConfigLike = {
+    customTools?: RelayTool[];
+    onSessionCreated?: (session: PiSessionLike) => void | Promise<void>;
+};
+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 Pi agent config.
+ * @param name - Agent name for relay registration.
+ * @param config - Pi agent session config to augment.
+ * @param relay - Optional pre-configured Relay instance.
+ * @returns Augmented config with relay tools and session hook.
+ */
+export declare function onRelay<TConfig extends PiConfigLike>(name: string, config: TConfig, relay?: RelayLike): TConfig & {
+    customTools: RelayTool[];
+    onSessionCreated: (session: PiSessionLike) => Promise<void>;
+    cleanup: () => void;
+};
+export {};
+//# sourceMappingURL=pi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pi.d.ts","sourceRoot":"","sources":["../../../src/communicate/adapters/pi.ts"],"names":[],"mappings":"AAGA,OAAO,EAAwC,KAAK,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEvG,KAAK,UAAU,GAAG;IAChB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,CACP,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,GAAG,EACX,MAAM,CAAC,EAAE,WAAW,EACpB,QAAQ,CAAC,EAAE,OAAO,KACf,OAAO,CAAC,UAAU,CAAC,CAAC;CAC1B,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC;IAC1B,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE,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;AAyBF;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,OAAO,SAAS,YAAY,EAClD,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,EACf,KAAK,GAAE,SAA2B,GACjC,OAAO,GAAG;IAAE,WAAW,EAAE,SAAS,EAAE,CAAC;IAAC,gBAAgB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,CA4B1H"}

package/dist/communicate/adapters/pi.js

@@ -0,0 +1,59 @@
+import { Type } from '@sinclair/typebox';
+import { Relay } from '../core.js';
+import { formatRelayInbox, formatRelayMessage } from '../types.js';
+const txt = (text) => ({ content: [{ type: 'text', text }], details: {} });
+function createRelayTools(relay) {
+    const toolDefs = [
+        ['relay_send', 'Send a direct message to another relay agent.',
+            Type.Object({ to: Type.String(), text: Type.String() }),
+            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.',
+            Type.Object({}),
+            async () => formatRelayInbox(await relay.inbox())],
+        ['relay_post', 'Post a message to a relay channel.',
+            Type.Object({ channel: Type.String(), text: Type.String() }),
+            async (p) => { await relay.post(p.channel, p.text); return `Posted relay message to #${p.channel}.`; }],
+        ['relay_agents', 'List currently online relay agents.',
+            Type.Object({}),
+            async () => (await relay.agents()).join('\n')],
+    ];
+    return toolDefs.map(([name, description, parameters, run]) => ({
+        name, label: name.replace('_', ' '), description, parameters,
+        async execute(_id, params) { return txt(await run(params)); },
+    }));
+}
+/**
+ * Attach relay communication tools and message routing to a Pi agent config.
+ * @param name - Agent name for relay registration.
+ * @param config - Pi agent session config to augment.
+ * @param relay - Optional pre-configured Relay instance.
+ * @returns Augmented config with relay tools and session hook.
+ */
+export function onRelay(name, config, relay = new Relay(name)) {
+    const customTools = [...(config.customTools ?? []), ...createRelayTools(relay)];
+    const originalOnSessionCreated = config.onSessionCreated;
+    let unsubscribe;
+    return {
+        ...config,
+        customTools,
+        async onSessionCreated(session) {
+            if (originalOnSessionCreated) {
+                await originalOnSessionCreated(session);
+            }
+            unsubscribe?.();
+            unsubscribe = relay.onMessage(async (message) => {
+                const prompt = formatRelayMessage(message);
+                if (session.isStreaming) {
+                    await session.steer(prompt);
+                    return;
+                }
+                await session.followUp(prompt);
+            });
+        },
+        cleanup() {
+            unsubscribe?.();
+            unsubscribe = undefined;
+        },
+    };
+}
+//# sourceMappingURL=pi.js.map

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

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

package/dist/communicate/core.d.ts

@@ -0,0 +1,58 @@
+import { RelayTransport } from './transport.js';
+import { type Message, type MessageCallback, type RelayConfig } from './types.js';
+/**
+ * Core relay client for inter-agent communication.
+ *
+ * Lazily connects on first API call. Buffers incoming WebSocket messages
+ * for {@link inbox} when no callbacks are registered.
+ */
+export declare class Relay {
+    readonly agentName: string;
+    readonly config: import("./types.js").ResolvedRelayConfig;
+    readonly transport: RelayTransport;
+    private pending;
+    private callbacks;
+    private connectPromise?;
+    private connected;
+    private readonly exitHandler?;
+    constructor(agentName: string, config?: RelayConfig);
+    /**
+     * Send a direct message to another agent.
+     * @param to - Recipient agent name.
+     * @param text - Message content.
+     */
+    send(to: string, text: string): Promise<void>;
+    /**
+     * Post a message to a channel.
+     * @param channel - Target channel name.
+     * @param text - Message content.
+     */
+    post(channel: string, text: string): Promise<void>;
+    /**
+     * Reply to a specific message in a thread.
+     * @param messageId - ID of the message to reply to.
+     * @param text - Reply content.
+     */
+    reply(messageId: string, text: string): Promise<void>;
+    /**
+     * Drain and return all buffered messages, clearing the buffer.
+     * @returns Array of buffered messages.
+     */
+    inbox(): Promise<Message[]>;
+    /**
+     * Register a callback for incoming messages.
+     * @param callback - Invoked for each received message.
+     * @returns Unsubscribe function.
+     */
+    onMessage(callback: MessageCallback): () => void;
+    /**
+     * List currently online agents.
+     * @returns Array of agent names.
+     */
+    agents(): Promise<string[]>;
+    /** Unregister the agent, close the WebSocket, and clean up. */
+    close(): Promise<void>;
+    private ensureConnected;
+    private handleTransportMessage;
+}
+//# sourceMappingURL=core.d.ts.map

package/dist/communicate/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/communicate/core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,WAAW,EAEjB,MAAM,YAAY,CAAC;AAIpB;;;;;GAKG;AACH,qBAAa,KAAK;IAChB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,2CAAC;IAChB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IAEnC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,cAAc,CAAC,CAAgB;IACvC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAa;gBAE9B,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,WAAgB;IAgBvD;;;;OAIG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD;;;;OAIG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxD;;;;OAIG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3D;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAOjC;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,IAAI;IAShD;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKjC,+DAA+D;IACzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAYd,eAAe;YAqBf,sBAAsB;CAerC"}