agent-relay 3.2.3 → 3.2.4

package/packages/sdk/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/packages/sdk/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/packages/sdk/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/packages/sdk/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/packages/sdk/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/packages/sdk/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/packages/sdk/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/packages/sdk/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/packages/sdk/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/packages/sdk/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/packages/sdk/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/packages/sdk/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/packages/sdk/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/packages/sdk/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"}

package/packages/sdk/dist/communicate/core.js

@@ -0,0 +1,128 @@
+import { RelayTransport } from './transport.js';
+import { resolveRelayConfig, } from './types.js';
+const MAX_PENDING_MESSAGES = 10_000;
+/**
+ * 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 class Relay {
+    agentName;
+    config;
+    transport;
+    pending = [];
+    callbacks = new Set();
+    connectPromise;
+    connected = false;
+    exitHandler;
+    constructor(agentName, config = {}) {
+        this.agentName = agentName;
+        this.config = resolveRelayConfig(config);
+        this.transport = new RelayTransport(agentName, this.config);
+        this.transport.onWsMessage((message) => this.handleTransportMessage(message));
+        if (this.config.autoCleanup) {
+            this.exitHandler = () => {
+                void this.close();
+            };
+            process.once('beforeExit', this.exitHandler);
+            process.once('SIGTERM', this.exitHandler);
+            process.once('SIGINT', this.exitHandler);
+        }
+    }
+    /**
+     * Send a direct message to another agent.
+     * @param to - Recipient agent name.
+     * @param text - Message content.
+     */
+    async send(to, text) {
+        await this.ensureConnected();
+        await this.transport.sendDm(to, text);
+    }
+    /**
+     * Post a message to a channel.
+     * @param channel - Target channel name.
+     * @param text - Message content.
+     */
+    async post(channel, text) {
+        await this.ensureConnected();
+        await this.transport.postMessage(channel, text);
+    }
+    /**
+     * Reply to a specific message in a thread.
+     * @param messageId - ID of the message to reply to.
+     * @param text - Reply content.
+     */
+    async reply(messageId, text) {
+        await this.ensureConnected();
+        await this.transport.reply(messageId, text);
+    }
+    /**
+     * Drain and return all buffered messages, clearing the buffer.
+     * @returns Array of buffered messages.
+     */
+    async inbox() {
+        await this.ensureConnected();
+        const messages = [...this.pending];
+        this.pending = [];
+        return messages;
+    }
+    /**
+     * Register a callback for incoming messages.
+     * @param callback - Invoked for each received message.
+     * @returns Unsubscribe function.
+     */
+    onMessage(callback) {
+        this.callbacks.add(callback);
+        void this.ensureConnected();
+        return () => {
+            this.callbacks.delete(callback);
+        };
+    }
+    /**
+     * List currently online agents.
+     * @returns Array of agent names.
+     */
+    async agents() {
+        await this.ensureConnected();
+        return this.transport.listAgents();
+    }
+    /** Unregister the agent, close the WebSocket, and clean up. */
+    async close() {
+        if (this.exitHandler) {
+            process.removeListener('beforeExit', this.exitHandler);
+            process.removeListener('SIGTERM', this.exitHandler);
+            process.removeListener('SIGINT', this.exitHandler);
+        }
+        this.connected = false;
+        this.connectPromise = undefined;
+        await this.transport.disconnect();
+    }
+    async ensureConnected() {
+        if (this.connected) {
+            return;
+        }
+        if (!this.connectPromise) {
+            this.connectPromise = this.transport.connect().then(() => {
+                this.connected = true;
+            }, (err) => {
+                // Clear cached promise so the next call can retry
+                this.connectPromise = undefined;
+                throw err;
+            });
+        }
+        await this.connectPromise;
+    }
+    async handleTransportMessage(message) {
+        // Always buffer the message (spec: "both" case — callbacks AND inbox)
+        if (this.pending.length >= MAX_PENDING_MESSAGES) {
+            this.pending.shift();
+            process.emitWarning('Relay pending buffer exceeded 10,000 messages; dropping oldest message.', 'RelayWarning');
+        }
+        this.pending.push(message);
+        for (const callback of [...this.callbacks]) {
+            await callback(message);
+        }
+    }
+}
+//# sourceMappingURL=core.js.map

package/packages/sdk/dist/communicate/core.js.map

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

package/packages/sdk/dist/communicate/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export { Relay } from './core.js';
+export { onPiRelay, onClaudeRelay } from './adapters/index.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/sdk/dist/communicate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/communicate/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/packages/sdk/dist/communicate/index.js

@@ -0,0 +1,4 @@
+export * from './types.js';
+export { Relay } from './core.js';
+export { onPiRelay, onClaudeRelay } from './adapters/index.js';
+//# sourceMappingURL=index.js.map

package/packages/sdk/dist/communicate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/communicate/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/packages/sdk/dist/communicate/transport.d.ts

@@ -0,0 +1,36 @@
+import { type Message, type MessageCallback, type RelayConfig } from './types.js';
+export declare class RelayTransport {
+    readonly agentName: string;
+    readonly config: import("./types.js").ResolvedRelayConfig;
+    agentId?: string;
+    token?: string;
+    private ws?;
+    private messageCallback?;
+    private closing;
+    private reconnectDelayMs;
+    private reconnectTimer?;
+    private wsConnectPromise?;
+    constructor(agentName: string, config?: RelayConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    onWsMessage(callback: MessageCallback): void;
+    registerAgent(): Promise<string>;
+    unregisterAgent(): Promise<void>;
+    sendDm(to: string, text: string): Promise<string>;
+    postMessage(channel: string, text: string): Promise<string>;
+    reply(messageId: string, text: string): Promise<string>;
+    checkInbox(): Promise<Message[]>;
+    listAgents(): Promise<string[]>;
+    private ensureRegistered;
+    private requireConfig;
+    private sendHttpAsAgent;
+    private sendHttp;
+    private connectWebSocket;
+    private wsBaseUrl;
+    private scheduleReconnect;
+    private clearReconnectTimer;
+    private dispatchWsPayload;
+    private messageFromPayload;
+    private errorMessage;
+}
+//# sourceMappingURL=transport.d.ts.map

package/packages/sdk/dist/communicate/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/communicate/transport.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,KAAK,WAAW,EAKjB,MAAM,YAAY,CAAC;AAOpB,qBAAa,cAAc;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,2CAAC;IAEhB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,OAAO,CAAC,EAAE,CAAC,CAAY;IACvB,OAAO,CAAC,eAAe,CAAC,CAAkB;IAC1C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,gBAAgB,CAAC,CAAgB;gBAE7B,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,WAAgB;IAKjD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAOxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BjC,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAItC,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAwChC,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAWhC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAOjD,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW3D,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAWvD,UAAU,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IA2BhC,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YASvB,gBAAgB;IAO9B,OAAO,CAAC,aAAa;YAcP,eAAe;YAiEf,QAAQ;YAiER,gBAAgB;IAsD9B,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,mBAAmB;YAOb,iBAAiB;IAkB/B,OAAO,CAAC,kBAAkB;YAyBZ,YAAY;CAY3B"}