@agent-relay/sdk 3.2.2 → 3.2.4

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

package/dist/communicate/transport.js

@@ -0,0 +1,371 @@
+import { setTimeout as sleep } from 'node:timers/promises';
+import { WebSocket } from 'ws';
+import { RelayAuthError, RelayConfigError, RelayConnectionError, resolveRelayConfig, } from './types.js';
+const HTTP_RETRY_ATTEMPTS = 3;
+const WS_RECONNECT_MAX_DELAY_MS = 30_000;
+export class RelayTransport {
+    agentName;
+    config;
+    agentId;
+    token;
+    ws;
+    messageCallback;
+    closing = false;
+    reconnectDelayMs = 1_000;
+    reconnectTimer;
+    wsConnectPromise;
+    constructor(agentName, config = {}) {
+        this.agentName = agentName;
+        this.config = resolveRelayConfig(config);
+    }
+    async connect() {
+        this.requireConfig({ requireWorkspace: true });
+        this.closing = false;
+        await this.registerAgent();
+        await this.connectWebSocket();
+    }
+    async disconnect() {
+        this.closing = true;
+        this.clearReconnectTimer();
+        const socket = this.ws;
+        this.ws = undefined;
+        this.wsConnectPromise = undefined;
+        if (socket && socket.readyState !== WebSocket.CLOSED) {
+            await Promise.race([
+                new Promise((resolve) => {
+                    socket.once('close', () => resolve());
+                    socket.close();
+                }),
+                new Promise((resolve) => setTimeout(resolve, 2_000)),
+            ]);
+        }
+        if (this.agentId) {
+            try {
+                await this.unregisterAgent();
+            }
+            catch {
+                // Best-effort cleanup.
+            }
+        }
+        this.closing = false;
+    }
+    onWsMessage(callback) {
+        this.messageCallback = callback;
+    }
+    async registerAgent() {
+        this.requireConfig({ requireWorkspace: true });
+        if (this.agentId && this.token) {
+            return this.agentId;
+        }
+        let payload;
+        try {
+            payload = await this.sendHttp('POST', '/v1/agents', { name: this.agentName, type: 'agent' });
+        }
+        catch (error) {
+            if (error instanceof RelayConnectionError && error.statusCode === 409) {
+                const agentPayload = await this.sendHttp('GET', `/v1/agents/${encodeURIComponent(this.agentName)}`);
+                const agentData = agentPayload.data ?? agentPayload;
+                this.agentId = String(agentData.id);
+                const rotatePayload = await this.sendHttp('POST', `/v1/agents/${encodeURIComponent(this.agentName)}/rotate-token`);
+                const rotateData = rotatePayload.data ?? rotatePayload;
+                this.token = String(rotateData.token);
+                return this.agentId;
+            }
+            throw error;
+        }
+        const data = payload.data ?? payload;
+        this.agentId = String(data.id);
+        this.token = String(data.token);
+        return this.agentId;
+    }
+    async unregisterAgent() {
+        if (!this.agentId || !this.token) {
+            return;
+        }
+        this.agentId = undefined;
+        const agentToken = this.token;
+        this.token = undefined;
+        await this.sendHttpAsAgent('POST', '/v1/agents/disconnect', undefined, agentToken);
+    }
+    async sendDm(to, text) {
+        await this.ensureRegistered();
+        const payload = await this.sendHttpAsAgent('POST', '/v1/dm', { to, text });
+        const data = payload.data ?? payload;
+        return String(data.id ?? data.message_id ?? '');
+    }
+    async postMessage(channel, text) {
+        await this.ensureRegistered();
+        const payload = await this.sendHttpAsAgent('POST', `/v1/channels/${encodeURIComponent(channel)}/messages`, { text });
+        const data = payload.data ?? payload;
+        return String(data.id ?? data.message_id ?? '');
+    }
+    async reply(messageId, text) {
+        await this.ensureRegistered();
+        const payload = await this.sendHttpAsAgent('POST', `/v1/messages/${encodeURIComponent(messageId)}/replies`, { text });
+        const data = payload.data ?? payload;
+        return String(data.id ?? data.message_id ?? '');
+    }
+    async checkInbox() {
+        await this.ensureRegistered();
+        const payload = await this.sendHttpAsAgent('GET', '/v1/inbox');
+        const data = payload.data ?? payload;
+        const messages = [];
+        for (const mention of (data.mentions ?? [])) {
+            messages.push(this.messageFromPayload(mention));
+        }
+        for (const dm of (data.unread_dms ?? [])) {
+            const last = dm.last_message;
+            if (last?.text) {
+                messages.push({
+                    sender: String(dm.from ?? dm.agent_name ?? 'unknown'),
+                    text: String(last.text),
+                    channel: undefined,
+                    threadId: typeof dm.conversation_id === 'string' ? dm.conversation_id : undefined,
+                    timestamp: typeof last.created_at === 'string' ? undefined : last.created_at,
+                    messageId: typeof last.id === 'string' ? last.id : undefined,
+                });
+            }
+        }
+        return messages;
+    }
+    async listAgents() {
+        const payload = await this.sendHttp('GET', '/v1/agents');
+        const data = payload.data ?? payload.agents ?? [];
+        if (Array.isArray(data)) {
+            return data.map((a) => (typeof a === 'string' ? a : String(a.name ?? a)));
+        }
+        return [];
+    }
+    async ensureRegistered() {
+        if (this.agentId && this.token) {
+            return;
+        }
+        await this.registerAgent();
+    }
+    requireConfig(options = {}) {
+        if (!this.config.apiKey) {
+            throw new RelayConfigError('Missing RELAY_API_KEY. Set the environment variable or pass apiKey to RelayConfig.');
+        }
+        if (options.requireWorkspace && !this.config.workspace) {
+            throw new RelayConfigError('Missing RELAY_WORKSPACE. Set the environment variable or pass workspace to RelayConfig.');
+        }
+    }
+    async sendHttpAsAgent(method, path, payload, overrideToken) {
+        this.requireConfig();
+        const agentToken = overrideToken ?? this.token;
+        if (!agentToken) {
+            throw new RelayConfigError('Agent not registered; no agent token available.');
+        }
+        const url = `${this.config.baseUrl}${path}`;
+        const headers = {
+            authorization: `Bearer ${agentToken}`,
+        };
+        if (payload !== undefined) {
+            headers['content-type'] = 'application/json';
+        }
+        for (let attempt = 1; attempt <= HTTP_RETRY_ATTEMPTS; attempt += 1) {
+            let response;
+            try {
+                response = await fetch(url, {
+                    method,
+                    headers,
+                    body: payload === undefined ? undefined : JSON.stringify(payload),
+                });
+            }
+            catch (error) {
+                if (attempt < HTTP_RETRY_ATTEMPTS) {
+                    await sleep(Math.min(2 ** (attempt - 1) * 1_000, WS_RECONNECT_MAX_DELAY_MS));
+                    continue;
+                }
+                throw new RelayConnectionError(0, error instanceof Error ? error.message : String(error));
+            }
+            if (response.status === 401) {
+                throw new RelayAuthError(await this.errorMessage(response));
+            }
+            if (response.status >= 500 && response.status <= 599) {
+                const message = await this.errorMessage(response);
+                if (attempt < HTTP_RETRY_ATTEMPTS) {
+                    await sleep(Math.min(2 ** (attempt - 1) * 1_000, WS_RECONNECT_MAX_DELAY_MS));
+                    continue;
+                }
+                throw new RelayConnectionError(response.status, message);
+            }
+            if (response.status >= 400) {
+                throw new RelayConnectionError(response.status, await this.errorMessage(response));
+            }
+            if (response.status === 204) {
+                return undefined;
+            }
+            const contentType = response.headers.get('content-type') ?? '';
+            if (contentType.includes('application/json')) {
+                return (await response.json());
+            }
+            return (await response.text());
+        }
+        throw new RelayConnectionError(500, 'Unexpected transport retry failure');
+    }
+    async sendHttp(method, path, payload) {
+        this.requireConfig();
+        const url = `${this.config.baseUrl}${path}`;
+        const headers = {
+            authorization: `Bearer ${this.config.apiKey}`,
+        };
+        if (payload !== undefined) {
+            headers['content-type'] = 'application/json';
+        }
+        for (let attempt = 1; attempt <= HTTP_RETRY_ATTEMPTS; attempt += 1) {
+            let response;
+            try {
+                response = await fetch(url, {
+                    method,
+                    headers,
+                    body: payload === undefined ? undefined : JSON.stringify(payload),
+                });
+            }
+            catch (error) {
+                if (attempt < HTTP_RETRY_ATTEMPTS) {
+                    await sleep(Math.min(2 ** (attempt - 1) * 1_000, WS_RECONNECT_MAX_DELAY_MS));
+                    continue;
+                }
+                throw new RelayConnectionError(0, error instanceof Error ? error.message : String(error));
+            }
+            if (response.status === 401) {
+                throw new RelayAuthError(await this.errorMessage(response));
+            }
+            if (response.status >= 500 && response.status <= 599) {
+                const message = await this.errorMessage(response);
+                if (attempt < HTTP_RETRY_ATTEMPTS) {
+                    await sleep(Math.min(2 ** (attempt - 1) * 1_000, WS_RECONNECT_MAX_DELAY_MS));
+                    continue;
+                }
+                throw new RelayConnectionError(response.status, message);
+            }
+            if (response.status >= 400) {
+                throw new RelayConnectionError(response.status, await this.errorMessage(response));
+            }
+            if (response.status === 204) {
+                return undefined;
+            }
+            const contentType = response.headers.get('content-type') ?? '';
+            if (contentType.includes('application/json')) {
+                return (await response.json());
+            }
+            return (await response.text());
+        }
+        throw new RelayConnectionError(500, 'Unexpected transport retry failure');
+    }
+    async connectWebSocket() {
+        await this.ensureRegistered();
+        if (this.ws && (this.ws.readyState === WebSocket.OPEN || this.ws.readyState === WebSocket.CONNECTING)) {
+            return;
+        }
+        if (this.wsConnectPromise) {
+            return this.wsConnectPromise;
+        }
+        const url = `${this.wsBaseUrl()}/v1/ws?token=${encodeURIComponent(this.token ?? '')}`;
+        const socket = new WebSocket(url);
+        this.wsConnectPromise = new Promise((resolve, reject) => {
+            let settled = false;
+            socket.once('open', () => {
+                settled = true;
+                this.ws = socket;
+                this.reconnectDelayMs = 1_000;
+                resolve();
+            });
+            socket.once('error', (error) => {
+                if (!settled) {
+                    settled = true;
+                    reject(error);
+                }
+            });
+        }).finally(() => {
+            this.wsConnectPromise = undefined;
+        });
+        socket.on('message', (raw) => {
+            void this.dispatchWsPayload(raw.toString());
+        });
+        socket.on('close', () => {
+            if (this.ws === socket) {
+                this.ws = undefined;
+            }
+            if (!this.closing) {
+                this.scheduleReconnect();
+            }
+        });
+        socket.on('error', () => {
+            // The close handler manages reconnects for established sockets.
+        });
+        await this.wsConnectPromise;
+    }
+    wsBaseUrl() {
+        if (this.config.baseUrl.startsWith('https://')) {
+            return `wss://${this.config.baseUrl.slice('https://'.length)}`;
+        }
+        if (this.config.baseUrl.startsWith('http://')) {
+            return `ws://${this.config.baseUrl.slice('http://'.length)}`;
+        }
+        return this.config.baseUrl;
+    }
+    scheduleReconnect() {
+        if (this.reconnectTimer || this.closing) {
+            return;
+        }
+        const delayMs = this.reconnectDelayMs;
+        this.reconnectDelayMs = Math.min(this.reconnectDelayMs * 2, WS_RECONNECT_MAX_DELAY_MS);
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = undefined;
+            void this.connectWebSocket().catch(() => {
+                this.scheduleReconnect();
+            });
+        }, delayMs);
+    }
+    clearReconnectTimer() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+    }
+    async dispatchWsPayload(rawPayload) {
+        const payload = JSON.parse(rawPayload);
+        if (payload.type === 'ping') {
+            this.ws?.send(JSON.stringify({ type: 'pong' }));
+            return;
+        }
+        const messageEvents = new Set([
+            'message.created', 'dm.received', 'direct_message.received',
+            'thread.reply', 'message', 'group_dm.received',
+        ]);
+        if (!messageEvents.has(payload.type) || !this.messageCallback) {
+            return;
+        }
+        await this.messageCallback(this.messageFromPayload(payload));
+    }
+    messageFromPayload(payload) {
+        const m = (typeof payload.message === 'object' && payload.message !== null)
+            ? payload.message
+            : payload;
+        const sender = String(m.sender ?? m.agent_name ?? m.from ?? m.agentName
+            ?? payload.agent_name ?? payload.from ?? 'unknown');
+        const text = String(m.text ?? '');
+        const channel = String(m.channel ?? m.channel_name ?? m.channelName ?? payload.channel ?? payload.channel_name ?? '') || undefined;
+        const threadId = String(m.thread_id ?? m.threadId ?? m.conversation_id ?? m.conversationId ?? payload.thread_id ?? '') || undefined;
+        const rawTs = m.timestamp ?? m.created_at ?? m.createdAt ?? payload.timestamp;
+        const timestamp = typeof rawTs === 'number' ? rawTs : undefined;
+        const messageId = String(m.id ?? m.message_id ?? m.messageId ?? payload.message_id ?? '') || undefined;
+        return { sender, text, channel, threadId, timestamp, messageId };
+    }
+    async errorMessage(response) {
+        const text = await response.text().catch(() => '');
+        try {
+            const payload = JSON.parse(text);
+            if (typeof payload.error === 'object' && payload.error?.message) {
+                return payload.error.message;
+            }
+            return payload.message ?? response.statusText ?? 'Request failed';
+        }
+        catch {
+            return text || response.statusText || 'Request failed';
+        }
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/communicate/transport.js.map

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

package/dist/communicate/types.d.ts

@@ -0,0 +1,58 @@
+export declare const DEFAULT_RELAY_BASE_URL = "https://api.relaycast.dev";
+/** An incoming relay message. All fields except `sender` and `text` are optional. */
+export interface Message {
+    readonly sender: string;
+    readonly text: string;
+    readonly channel?: string;
+    readonly threadId?: string;
+    readonly timestamp?: number;
+    readonly messageId?: string;
+}
+/** Callback invoked when a message is received. */
+export type MessageCallback = (message: Message) => void | Promise<void>;
+/** User-supplied relay configuration. All fields are optional and fall back to env vars or defaults. */
+export interface RelayConfig {
+    workspace?: string;
+    apiKey?: string;
+    baseUrl?: string;
+    channels?: string[];
+    pollIntervalMs?: number;
+    autoCleanup?: boolean;
+}
+export interface ResolvedRelayConfig {
+    workspace?: string;
+    apiKey?: string;
+    baseUrl: string;
+    channels: string[];
+    pollIntervalMs: number;
+    autoCleanup: boolean;
+}
+export declare class RelayConnectionError extends Error {
+    readonly statusCode: number;
+    constructor(statusCode: number, message: string);
+}
+export declare class RelayConfigError extends Error {
+    constructor(message: string);
+}
+export declare class RelayAuthError extends RelayConnectionError {
+    constructor(message?: string, statusCode?: number);
+}
+/**
+ * Resolve a partial config into a fully-populated config with env-var fallbacks.
+ * @param config - Partial user config.
+ * @returns Resolved config with all defaults applied.
+ */
+export declare function resolveRelayConfig(config?: RelayConfig): ResolvedRelayConfig;
+/**
+ * Format a single message for display in agent instructions.
+ * @param message - The relay message to format.
+ * @returns Human-readable message string.
+ */
+export declare function formatRelayMessage(message: Message): string;
+/**
+ * Format an array of messages for display in agent instructions.
+ * @param messages - The relay messages to format.
+ * @returns Human-readable inbox summary.
+ */
+export declare function formatRelayInbox(messages: Message[]): string;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/communicate/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,8BAA8B,CAAC;AAElE,qFAAqF;AACrF,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,mDAAmD;AACnD,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzE,wGAAwG;AACxG,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAKhD;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,cAAe,SAAQ,oBAAoB;gBAC1C,OAAO,SAAiB,EAAE,UAAU,SAAM;CAIvD;AAWD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,WAAgB,GAAG,mBAAmB,CAShF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAI3D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAM5D"}