@agent-relay/sdk 0.1.0

package/dist/protocol/types.d.ts

@@ -0,0 +1,341 @@
+/**
+ * Agent Relay Protocol Types
+ * @agent-relay/sdk
+ *
+ * These types define the wire protocol for agent-to-agent communication.
+ */
+export declare const PROTOCOL_VERSION = 1;
+export type MessageType = 'HELLO' | 'WELCOME' | 'SEND' | 'DELIVER' | 'ACK' | 'NACK' | 'PING' | 'PONG' | 'ERROR' | 'BUSY' | 'RESUME' | 'BYE' | 'STATE' | 'SYNC' | 'SYNC_SNAPSHOT' | 'SYNC_DELTA' | 'SUBSCRIBE' | 'UNSUBSCRIBE' | 'SHADOW_BIND' | 'SHADOW_UNBIND' | 'LOG' | 'CHANNEL_JOIN' | 'CHANNEL_LEAVE' | 'CHANNEL_MESSAGE' | 'CHANNEL_INFO' | 'CHANNEL_MEMBERS' | 'CHANNEL_TYPING' | 'SPAWN' | 'SPAWN_RESULT' | 'RELEASE' | 'RELEASE_RESULT';
+export type PayloadKind = 'message' | 'action' | 'state' | 'thinking';
+/**
+ * Base envelope structure for all protocol messages.
+ */
+export interface Envelope<T = unknown> {
+    /** Protocol version */
+    v: number;
+    /** Message type */
+    type: MessageType;
+    /** Unique message ID */
+    id: string;
+    /** Timestamp (Unix ms) */
+    ts: number;
+    /** Sender name */
+    from?: string;
+    /** Recipient name or '*' for broadcast */
+    to?: string | '*';
+    /** Topic for pub/sub */
+    topic?: string;
+    /** Message payload */
+    payload: T;
+}
+/**
+ * Entity type distinguishes between AI agents and human users.
+ */
+export type EntityType = 'agent' | 'user';
+export interface HelloPayload {
+    /** Agent name */
+    agent: string;
+    /** Client capabilities */
+    capabilities: {
+        ack: boolean;
+        resume: boolean;
+        max_inflight: number;
+        supports_topics: boolean;
+    };
+    /** Entity type: 'agent' (default) or 'user' */
+    entityType?: EntityType;
+    /** CLI identifier (claude, codex, gemini, etc.) */
+    cli?: string;
+    /** Program identifier */
+    program?: string;
+    /** Model identifier */
+    model?: string;
+    /** Task/role description */
+    task?: string;
+    /** Working directory */
+    workingDirectory?: string;
+    /** Display name for human users */
+    displayName?: string;
+    /** Avatar URL for human users */
+    avatarUrl?: string;
+    /** Session resume info */
+    session?: {
+        resume_token?: string;
+    };
+}
+export interface WelcomePayload {
+    /** Session ID assigned by server */
+    session_id: string;
+    /** Token for session resume */
+    resume_token?: string;
+    /** Server configuration */
+    server: {
+        max_frame_bytes: number;
+        heartbeat_ms: number;
+    };
+}
+export interface SendPayload {
+    /** Message type */
+    kind: PayloadKind;
+    /** Message body */
+    body: string;
+    /** Optional structured data */
+    data?: Record<string, unknown>;
+    /** Thread ID for grouping related messages */
+    thread?: string;
+}
+export interface SyncMeta {
+    /** Correlation ID for matching responses */
+    correlationId: string;
+    /** Timeout for blocking sends (ms) */
+    timeoutMs?: number;
+    /** Whether sender should block awaiting ACK */
+    blocking: boolean;
+}
+export interface SendMeta {
+    requires_ack?: boolean;
+    ttl_ms?: number;
+    /** Importance level (0-100, higher = more important) */
+    importance?: number;
+    /** Correlation ID for replies */
+    replyTo?: string;
+    /** Sync metadata for blocking sends */
+    sync?: SyncMeta;
+}
+export interface DeliveryInfo {
+    /** Delivery sequence number */
+    seq: number;
+    /** Session ID */
+    session_id: string;
+    /** Original 'to' field ('*' indicates broadcast) */
+    originalTo?: string;
+}
+export interface AckPayload {
+    /** ID of the message being acknowledged */
+    ack_id: string;
+    /** Sequence number */
+    seq: number;
+    /** Cumulative acknowledgment */
+    cumulative_seq?: number;
+    /** Selective acknowledgments */
+    sack?: number[];
+    /**
+     * Correlation ID for matching ACK to original blocking SEND.
+     * Set by daemon when forwarding ACK back to the sender.
+     */
+    correlationId?: string;
+    /**
+     * Response status for sync messaging.
+     * Common values: 'OK', 'ERROR', 'ACCEPTED', 'REJECTED'.
+     * Allows richer status codes than a simple boolean.
+     */
+    response?: string;
+    /**
+     * Optional structured response data.
+     * Can contain any additional information the responder wants to include.
+     */
+    responseData?: unknown;
+}
+export interface NackPayload {
+    /** ID of the message being rejected */
+    ack_id: string;
+    /** Rejection code */
+    code?: 'BUSY' | 'INVALID' | 'FORBIDDEN' | 'STALE';
+    /** Legacy reason field */
+    reason?: 'busy' | 'invalid' | 'forbidden';
+    /** Human-readable message */
+    message?: string;
+}
+export interface BusyPayload {
+    /** Time before retry (ms) */
+    retry_after_ms: number;
+    /** Current queue depth */
+    queue_depth: number;
+}
+export interface PingPayload {
+    nonce: string;
+}
+export interface PongPayload {
+    nonce: string;
+}
+export type ErrorCode = 'BAD_REQUEST' | 'UNAUTHORIZED' | 'NOT_FOUND' | 'INTERNAL' | 'RESUME_TOO_OLD';
+export interface ErrorPayload {
+    /** Error code */
+    code: ErrorCode;
+    /** Error message */
+    message: string;
+    /** Whether the error is fatal (connection should be closed) */
+    fatal: boolean;
+}
+export interface LogPayload {
+    /** Log/output data */
+    data: string;
+    /** Timestamp (defaults to envelope ts) */
+    timestamp?: number;
+}
+export interface SyncStream {
+    topic: string;
+    peer: string;
+    last_seq: number;
+    server_last_seq?: number;
+}
+export interface SyncPayload {
+    session_id: string;
+    streams: SyncStream[];
+}
+/**
+ * Attachment metadata for messages.
+ */
+export interface MessageAttachment {
+    id: string;
+    filename: string;
+    mimeType: string;
+    size?: number;
+    url?: string;
+    data?: string;
+}
+/**
+ * Payload for CHANNEL_JOIN message.
+ */
+export interface ChannelJoinPayload {
+    /** Channel to join (e.g., '#general') */
+    channel: string;
+    /** Display name for the channel member list */
+    displayName?: string;
+    /** Avatar URL */
+    avatarUrl?: string;
+    /** Member name to add (for admin operations) */
+    member?: string;
+}
+/**
+ * Payload for CHANNEL_LEAVE message.
+ */
+export interface ChannelLeavePayload {
+    /** Channel to leave */
+    channel: string;
+    /** Reason for leaving */
+    reason?: string;
+    /** Member name to remove (for admin operations) */
+    member?: string;
+}
+/**
+ * Payload for CHANNEL_MESSAGE.
+ */
+export interface ChannelMessagePayload {
+    /** Target channel */
+    channel: string;
+    /** Message content */
+    body: string;
+    /** Thread ID for threaded replies */
+    thread?: string;
+    /** Mentioned usernames/agent names */
+    mentions?: string[];
+    /** File attachments */
+    attachments?: MessageAttachment[];
+    /** Optional structured data */
+    data?: Record<string, unknown>;
+}
+export type SpeakOnTrigger = 'SESSION_END' | 'CODE_WRITTEN' | 'REVIEW_REQUEST' | 'EXPLICIT_ASK' | 'ALL_MESSAGES';
+export interface ShadowConfig {
+    /** Primary agent this shadow is attached to */
+    primaryAgent: string;
+    /** When the shadow should speak */
+    speakOn: SpeakOnTrigger[];
+    /** Receive messages TO the primary */
+    receiveIncoming?: boolean;
+    /** Receive messages FROM the primary */
+    receiveOutgoing?: boolean;
+}
+export interface ShadowBindPayload {
+    primaryAgent: string;
+    speakOn?: SpeakOnTrigger[];
+    receiveIncoming?: boolean;
+    receiveOutgoing?: boolean;
+}
+export interface ShadowUnbindPayload {
+    primaryAgent: string;
+}
+export interface SpawnPayload {
+    /** Name for the new agent */
+    name: string;
+    /** CLI to use (claude, codex, gemini, etc.) */
+    cli: string;
+    /** Task description */
+    task: string;
+    /** Team name */
+    team?: string;
+    /** Working directory */
+    cwd?: string;
+    /** Socket path for the spawned agent */
+    socketPath?: string;
+    /** Parent agent name */
+    spawnerName?: string;
+    /** Interactive mode */
+    interactive?: boolean;
+    /** Spawn as shadow of this agent */
+    shadowOf?: string;
+    /** Shadow speak-on triggers */
+    shadowSpeakOn?: SpeakOnTrigger[];
+    /** User ID for cloud persistence */
+    userId?: string;
+}
+export interface SpawnPolicyDecision {
+    allowed: boolean;
+    reason?: string;
+    quotaRemaining?: number;
+}
+export interface SpawnResultPayload {
+    /** Correlation ID (matches original SPAWN envelope ID) */
+    replyTo: string;
+    /** Whether spawn succeeded */
+    success: boolean;
+    /** Spawned agent name */
+    name: string;
+    /** Process ID (if successful) */
+    pid?: number;
+    /** Error message (if failed) */
+    error?: string;
+    /** Policy decision (if blocked) */
+    policyDecision?: SpawnPolicyDecision;
+}
+export interface ReleasePayload {
+    /** Agent name to release */
+    name: string;
+}
+export interface ReleaseResultPayload {
+    /** Correlation ID */
+    replyTo: string;
+    /** Whether release succeeded */
+    success: boolean;
+    /** Released agent name */
+    name: string;
+    /** Error message (if failed) */
+    error?: string;
+}
+export type HelloEnvelope = Envelope<HelloPayload>;
+export type WelcomeEnvelope = Envelope<WelcomePayload>;
+export type SendEnvelope = Envelope<SendPayload> & {
+    payload_meta?: SendMeta;
+};
+export type DeliverEnvelope = Envelope<SendPayload> & {
+    delivery: DeliveryInfo;
+    payload_meta?: SendMeta;
+};
+export type AckEnvelope = Envelope<AckPayload>;
+export type NackEnvelope = Envelope<NackPayload>;
+export type PingEnvelope = Envelope<PingPayload>;
+export type PongEnvelope = Envelope<PongPayload>;
+export type ErrorEnvelope = Envelope<ErrorPayload>;
+export type BusyEnvelope = Envelope<BusyPayload>;
+export type LogEnvelope = Envelope<LogPayload>;
+export type ShadowBindEnvelope = Envelope<ShadowBindPayload>;
+export type ShadowUnbindEnvelope = Envelope<ShadowUnbindPayload>;
+export type SyncEnvelope = Envelope<SyncPayload>;
+export type SpawnEnvelope = Envelope<SpawnPayload>;
+export type SpawnResultEnvelope = Envelope<SpawnResultPayload>;
+export type ReleaseEnvelope = Envelope<ReleasePayload>;
+export type ReleaseResultEnvelope = Envelope<ReleaseResultPayload>;
+export type ChannelJoinEnvelope = Envelope<ChannelJoinPayload>;
+export type ChannelLeaveEnvelope = Envelope<ChannelLeavePayload>;
+export type ChannelMessageEnvelope = Envelope<ChannelMessagePayload>;
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/protocol/types.js

@@ -0,0 +1,8 @@
+/**
+ * Agent Relay Protocol Types
+ * @agent-relay/sdk
+ *
+ * These types define the wire protocol for agent-to-agent communication.
+ */
+export const PROTOCOL_VERSION = 1;
+//# sourceMappingURL=types.js.map

package/dist/protocol/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC"}

package/dist/standalone.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Standalone Relay - Dead Simple Agent Communication
+ *
+ * Use Agent Relay as a pure communication layer without any external setup.
+ * Just import and go.
+ *
+ * @example
+ * ```typescript
+ * import { createRelay } from '@agent-relay/sdk/standalone';
+ *
+ * const relay = await createRelay();
+ *
+ * const alice = await relay.client('Alice');
+ * const bob = await relay.client('Bob');
+ *
+ * bob.onMessage = (from, { body }) => console.log(`${from}: ${body}`);
+ * alice.sendMessage('Bob', 'Hello!');
+ *
+ * await relay.stop();
+ * ```
+ */
+import { RelayClient, type ClientConfig } from './client.js';
+export interface RelayConfig {
+    /** Socket path for IPC. Default: /tmp/agent-relay-standalone.sock */
+    socketPath?: string;
+    /** Suppress console logging. Default: true */
+    quiet?: boolean;
+}
+export interface Relay {
+    /** Create a connected client for an agent */
+    client(name: string, config?: Partial<ClientConfig>): Promise<RelayClient>;
+    /** Stop the relay and disconnect all clients */
+    stop(): Promise<void>;
+    /** Check if relay is running */
+    readonly isRunning: boolean;
+    /** The socket path being used */
+    readonly socketPath: string;
+}
+/**
+ * Create a standalone relay for pure agent-to-agent communication.
+ *
+ * This starts an in-process daemon - no external setup required.
+ * Perfect for using Agent Relay as just a communication layer.
+ *
+ * @example Basic Usage
+ * ```typescript
+ * const relay = await createRelay();
+ *
+ * const agent1 = await relay.client('Agent1');
+ * const agent2 = await relay.client('Agent2');
+ *
+ * agent2.onMessage = (from, payload) => {
+ *   console.log(`Message from ${from}: ${payload.body}`);
+ * };
+ *
+ * agent1.sendMessage('Agent2', 'Hello!');
+ * ```
+ *
+ * @example With Custom Socket
+ * ```typescript
+ * const relay = await createRelay({ socketPath: '/tmp/my-relay.sock' });
+ * ```
+ */
+export declare function createRelay(config?: RelayConfig): Promise<Relay>;
+/**
+ * Quick helper to create two connected agents for simple communication.
+ *
+ * @example
+ * ```typescript
+ * const { alice, bob, stop } = await createPair('Alice', 'Bob');
+ *
+ * bob.onMessage = (from, { body }) => console.log(`${from}: ${body}`);
+ * alice.sendMessage('Bob', 'Hi there!');
+ *
+ * await stop();
+ * ```
+ */
+export declare function createPair(name1: string, name2: string, config?: RelayConfig): Promise<{
+    [K in typeof name1]: RelayClient;
+} & {
+    [K in typeof name2]: RelayClient;
+} & {
+    relay: Relay;
+    stop: () => Promise<void>;
+}>;
+export { RelayClient, type ClientConfig } from './client.js';
+//# sourceMappingURL=standalone.d.ts.map

package/dist/standalone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.d.ts","sourceRoot":"","sources":["../src/standalone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAS7D,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,KAAK;IACpB,6CAA6C;IAC7C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3E,gDAAgD;IAChD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,gCAAgC;IAChC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,iCAAiC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAID;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,WAAW,CAAC,MAAM,GAAE,WAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,CA2D1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,WAAgB,GACvB,OAAO,CAAC;KACR,CAAC,IAAI,OAAO,KAAK,GAAG,WAAW;CACjC,GAAG;KACD,CAAC,IAAI,OAAO,KAAK,GAAG,WAAW;CACjC,GAAG;IACF,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,CAAC,CAWD;AAGD,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/standalone.js

@@ -0,0 +1,126 @@
+/**
+ * Standalone Relay - Dead Simple Agent Communication
+ *
+ * Use Agent Relay as a pure communication layer without any external setup.
+ * Just import and go.
+ *
+ * @example
+ * ```typescript
+ * import { createRelay } from '@agent-relay/sdk/standalone';
+ *
+ * const relay = await createRelay();
+ *
+ * const alice = await relay.client('Alice');
+ * const bob = await relay.client('Bob');
+ *
+ * bob.onMessage = (from, { body }) => console.log(`${from}: ${body}`);
+ * alice.sendMessage('Bob', 'Hello!');
+ *
+ * await relay.stop();
+ * ```
+ */
+import { RelayClient } from './client.js';
+const DEFAULT_SOCKET_PATH = '/tmp/agent-relay-standalone.sock';
+/**
+ * Create a standalone relay for pure agent-to-agent communication.
+ *
+ * This starts an in-process daemon - no external setup required.
+ * Perfect for using Agent Relay as just a communication layer.
+ *
+ * @example Basic Usage
+ * ```typescript
+ * const relay = await createRelay();
+ *
+ * const agent1 = await relay.client('Agent1');
+ * const agent2 = await relay.client('Agent2');
+ *
+ * agent2.onMessage = (from, payload) => {
+ *   console.log(`Message from ${from}: ${payload.body}`);
+ * };
+ *
+ * agent1.sendMessage('Agent2', 'Hello!');
+ * ```
+ *
+ * @example With Custom Socket
+ * ```typescript
+ * const relay = await createRelay({ socketPath: '/tmp/my-relay.sock' });
+ * ```
+ */
+export async function createRelay(config = {}) {
+    const socketPath = config.socketPath ?? DEFAULT_SOCKET_PATH;
+    const quiet = config.quiet ?? true;
+    // Lazy-load daemon to keep SDK lightweight for client-only users
+    let Daemon;
+    try {
+        const daemonModule = await import('@agent-relay/daemon');
+        Daemon = daemonModule.Daemon;
+    }
+    catch {
+        throw new Error('To use standalone relay, install @agent-relay/daemon:\n' +
+            '  npm install @agent-relay/daemon\n\n' +
+            'Or if you have an external daemon running, use RelayClient directly.');
+    }
+    const daemon = new Daemon({
+        socketPath,
+        consensus: false, // Minimal mode - just messaging
+        cloudSync: false, // No cloud features
+    });
+    await daemon.start();
+    const clients = [];
+    return {
+        async client(name, clientConfig = {}) {
+            const client = new RelayClient({
+                agentName: name,
+                socketPath,
+                quiet,
+                reconnect: true,
+                ...clientConfig,
+            });
+            await client.connect();
+            clients.push(client);
+            return client;
+        },
+        async stop() {
+            // Disconnect all clients first
+            for (const client of clients) {
+                client.destroy();
+            }
+            clients.length = 0;
+            // Stop the daemon
+            await daemon.stop();
+        },
+        get isRunning() {
+            return daemon.isRunning;
+        },
+        get socketPath() {
+            return socketPath;
+        },
+    };
+}
+/**
+ * Quick helper to create two connected agents for simple communication.
+ *
+ * @example
+ * ```typescript
+ * const { alice, bob, stop } = await createPair('Alice', 'Bob');
+ *
+ * bob.onMessage = (from, { body }) => console.log(`${from}: ${body}`);
+ * alice.sendMessage('Bob', 'Hi there!');
+ *
+ * await stop();
+ * ```
+ */
+export async function createPair(name1, name2, config = {}) {
+    const relay = await createRelay(config);
+    const client1 = await relay.client(name1);
+    const client2 = await relay.client(name2);
+    return {
+        [name1]: client1,
+        [name2]: client2,
+        relay,
+        stop: () => relay.stop(),
+    };
+}
+// Re-export client for convenience
+export { RelayClient } from './client.js';
+//# sourceMappingURL=standalone.js.map

package/dist/standalone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone.js","sourceRoot":"","sources":["../src/standalone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,WAAW,EAAqB,MAAM,aAAa,CAAC;AA2B7D,MAAM,mBAAmB,GAAG,kCAAkC,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,SAAsB,EAAE;IACxD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,mBAAmB,CAAC;IAC5D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC;IAEnC,iEAAiE;IACjE,IAAI,MAA2D,CAAC;IAChE,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QACzD,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,yDAAyD;YACzD,uCAAuC;YACvC,sEAAsE,CACvE,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;QACxB,UAAU;QACV,SAAS,EAAE,KAAK,EAAE,gCAAgC;QAClD,SAAS,EAAE,KAAK,EAAE,oBAAoB;KACvC,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IAErB,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,eAAsC,EAAE;YACjE,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC;gBAC7B,SAAS,EAAE,IAAI;gBACf,UAAU;gBACV,KAAK;gBACL,SAAS,EAAE,IAAI;gBACf,GAAG,YAAY;aAChB,CAAC,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,KAAK,CAAC,IAAI;YACR,+BAA+B;YAC/B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,CAAC;YACD,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;YACnB,kBAAkB;YAClB,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;QAED,IAAI,SAAS;YACX,OAAO,MAAM,CAAC,SAAS,CAAC;QAC1B,CAAC;QAED,IAAI,UAAU;YACZ,OAAO,UAAU,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,KAAa,EACb,KAAa,EACb,SAAsB,EAAE;IASxB,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE1C,OAAO;QACL,CAAC,KAAK,CAAC,EAAE,OAAO;QAChB,CAAC,KAAK,CAAC,EAAE,OAAO;QAChB,KAAK;QACL,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE;KAClB,CAAC;AACX,CAAC;AAED,mCAAmC;AACnC,OAAO,EAAE,WAAW,EAAqB,MAAM,aAAa,CAAC"}

package/package.json

@@ -0,0 +1,80 @@
+{
+  "name": "@agent-relay/sdk",
+  "version": "0.1.0",
+  "description": "Lightweight SDK for agent-to-agent communication via Agent Relay",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./standalone": {
+      "types": "./dist/standalone.d.ts",
+      "import": "./dist/standalone.js",
+      "default": "./dist/standalone.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol/index.d.ts",
+      "import": "./dist/protocol/index.js",
+      "default": "./dist/protocol/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js",
+      "default": "./dist/client.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "agent-relay",
+    "agent",
+    "ai",
+    "communication",
+    "sdk"
+  ],
+  "author": "Khaliq Gant",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relay.git",
+    "directory": "packages/sdk"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@agent-relay/protocol": "^0.1.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "@agent-relay/daemon": "^0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@agent-relay/daemon": {
+      "optional": true
+    }
+  },
+  "optionalDependencies": {
+    "@msgpack/msgpack": "^3.0.0"
+  },
+  "devDependencies": {
+    "@agent-relay/daemon": "^0.1.0",
+    "@types/node": "^22.19.3",
+    "typescript": "^5.9.3",
+    "vitest": "^3.0.0"
+  }
+}