@agent-relay/protocol 0.1.2

package/dist/channels.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Channel and User Protocol Types
+ *
+ * Extends the Agent Relay Protocol to support:
+ * - First-class user entities (humans, not just AI agents)
+ * - Channels for group communication
+ * - Direct messaging between any combination of users and agents
+ */
+import { PROTOCOL_VERSION, type EntityType, type MessageAttachment, type ChannelJoinEnvelope, type ChannelLeaveEnvelope, type ChannelMessageEnvelope } from './types.js';
+export type { MessageAttachment, ChannelJoinPayload, ChannelLeavePayload, ChannelMessagePayload, ChannelJoinEnvelope, ChannelLeaveEnvelope, ChannelMessageEnvelope, } from './types.js';
+export { PROTOCOL_VERSION };
+/**
+ * Extended message types for channels.
+ */
+export type ChannelMessageType = 'CHANNEL_JOIN' | 'CHANNEL_LEAVE' | 'CHANNEL_MESSAGE' | 'CHANNEL_INFO' | 'CHANNEL_MEMBERS' | 'CHANNEL_TYPING';
+/**
+ * Channel member info.
+ */
+export interface ChannelMember {
+    name: string;
+    entityType: EntityType;
+    displayName?: string;
+    avatarUrl?: string;
+    status?: 'online' | 'away' | 'offline';
+}
+/**
+ * Payload for CHANNEL_INFO.
+ * Contains metadata about a channel.
+ */
+export interface ChannelInfoPayload {
+    /** Channel identifier */
+    channel: string;
+    /** Human-readable channel name */
+    name: string;
+    /** Optional description */
+    description?: string;
+    /** Optional current topic */
+    topic?: string;
+    /** List of members */
+    members: ChannelMember[];
+    /** When the channel was created */
+    createdAt: string;
+    /** Whether the channel is private */
+    isPrivate?: boolean;
+}
+/**
+ * Payload for CHANNEL_MEMBERS.
+ * List of members in a channel.
+ */
+export interface ChannelMembersPayload {
+    channel: string;
+    members: ChannelMember[];
+}
+/**
+ * Payload for CHANNEL_TYPING.
+ * Indicates someone is typing in a channel.
+ */
+export interface ChannelTypingPayload {
+    channel: string;
+    isTyping: boolean;
+}
+/**
+ * Check if an entity type represents a user.
+ */
+export declare function isUserEntity(entityType: EntityType | undefined): boolean;
+/**
+ * Check if an entity type represents an agent.
+ * Undefined defaults to agent for backwards compatibility.
+ */
+export declare function isAgentEntity(entityType: EntityType | undefined): boolean;
+/**
+ * Type guard to check if an envelope is a channel message.
+ */
+export declare function isChannelMessage(envelope: {
+    type: string;
+}): envelope is ChannelMessageEnvelope;
+/**
+ * Type guard to check if an envelope is a channel join.
+ */
+export declare function isChannelJoin(envelope: {
+    type: string;
+}): envelope is ChannelJoinEnvelope;
+/**
+ * Type guard to check if an envelope is a channel leave.
+ */
+export declare function isChannelLeave(envelope: {
+    type: string;
+}): envelope is ChannelLeaveEnvelope;
+/**
+ * Create a CHANNEL_JOIN envelope.
+ */
+export declare function createChannelJoinEnvelope(from: string, channel: string, options?: {
+    displayName?: string;
+    avatarUrl?: string;
+}): ChannelJoinEnvelope;
+/**
+ * Create a CHANNEL_LEAVE envelope.
+ */
+export declare function createChannelLeaveEnvelope(from: string, channel: string, reason?: string): ChannelLeaveEnvelope;
+/**
+ * Create a CHANNEL_MESSAGE envelope.
+ */
+export declare function createChannelMessageEnvelope(from: string, channel: string, body: string, options?: {
+    thread?: string;
+    mentions?: string[];
+    attachments?: MessageAttachment[];
+    data?: Record<string, unknown>;
+}): ChannelMessageEnvelope;
+/**
+ * Parse a DM channel name to extract participants.
+ * DM channels follow the format: dm:<participant1>:<participant2>:...
+ */
+export declare function parseDmChannel(channel: string): string[] | null;
+/**
+ * Create a DM channel name from participants.
+ * Participants are sorted alphabetically for consistency.
+ */
+export declare function createDmChannelName(...participants: string[]): string;
+/**
+ * Check if a channel is a DM (direct message).
+ */
+export declare function isDmChannel(channel: string): boolean;
+/**
+ * Check if a channel is private.
+ */
+export declare function isPrivateChannel(channel: string): boolean;
+/**
+ * Check if a channel is a public channel (starts with #).
+ */
+export declare function isPublicChannel(channel: string): boolean;
+/**
+ * Normalize channel name for storage/lookup.
+ * - Removes leading # from public channels
+ * - Sorts participants in DM channels
+ */
+export declare function normalizeChannelName(channel: string): string;
+//# sourceMappingURL=channels.d.ts.map

package/dist/channels.d.ts.map

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

package/dist/channels.js

@@ -0,0 +1,154 @@
+/**
+ * Channel and User Protocol Types
+ *
+ * Extends the Agent Relay Protocol to support:
+ * - First-class user entities (humans, not just AI agents)
+ * - Channels for group communication
+ * - Direct messaging between any combination of users and agents
+ */
+import { generateId } from './id-generator.js';
+import { PROTOCOL_VERSION, } from './types.js';
+// Re-export for convenience
+export { PROTOCOL_VERSION };
+/**
+ * Check if an entity type represents a user.
+ */
+export function isUserEntity(entityType) {
+    return entityType === 'user';
+}
+/**
+ * Check if an entity type represents an agent.
+ * Undefined defaults to agent for backwards compatibility.
+ */
+export function isAgentEntity(entityType) {
+    return entityType === 'agent' || entityType === undefined;
+}
+/**
+ * Type guard to check if an envelope is a channel message.
+ */
+export function isChannelMessage(envelope) {
+    return envelope.type === 'CHANNEL_MESSAGE';
+}
+/**
+ * Type guard to check if an envelope is a channel join.
+ */
+export function isChannelJoin(envelope) {
+    return envelope.type === 'CHANNEL_JOIN';
+}
+/**
+ * Type guard to check if an envelope is a channel leave.
+ */
+export function isChannelLeave(envelope) {
+    return envelope.type === 'CHANNEL_LEAVE';
+}
+/**
+ * Create a CHANNEL_JOIN envelope.
+ */
+export function createChannelJoinEnvelope(from, channel, options) {
+    return {
+        v: PROTOCOL_VERSION,
+        type: 'CHANNEL_JOIN',
+        id: generateId(),
+        ts: Date.now(),
+        from,
+        payload: {
+            channel,
+            displayName: options?.displayName,
+            avatarUrl: options?.avatarUrl,
+        },
+    };
+}
+/**
+ * Create a CHANNEL_LEAVE envelope.
+ */
+export function createChannelLeaveEnvelope(from, channel, reason) {
+    return {
+        v: PROTOCOL_VERSION,
+        type: 'CHANNEL_LEAVE',
+        id: generateId(),
+        ts: Date.now(),
+        from,
+        payload: {
+            channel,
+            reason,
+        },
+    };
+}
+/**
+ * Create a CHANNEL_MESSAGE envelope.
+ */
+export function createChannelMessageEnvelope(from, channel, body, options) {
+    return {
+        v: PROTOCOL_VERSION,
+        type: 'CHANNEL_MESSAGE',
+        id: generateId(),
+        ts: Date.now(),
+        from,
+        payload: {
+            channel,
+            body,
+            thread: options?.thread,
+            mentions: options?.mentions,
+            attachments: options?.attachments,
+            data: options?.data,
+        },
+    };
+}
+/**
+ * Parse a DM channel name to extract participants.
+ * DM channels follow the format: dm:<participant1>:<participant2>:...
+ */
+export function parseDmChannel(channel) {
+    if (!channel.startsWith('dm:')) {
+        return null;
+    }
+    const parts = channel.split(':').slice(1);
+    return parts.length >= 2 ? parts : null;
+}
+/**
+ * Create a DM channel name from participants.
+ * Participants are sorted alphabetically for consistency.
+ */
+export function createDmChannelName(...participants) {
+    if (participants.length < 2) {
+        throw new Error('DM requires at least 2 participants');
+    }
+    const sorted = [...participants].sort();
+    return `dm:${sorted.join(':')}`;
+}
+/**
+ * Check if a channel is a DM (direct message).
+ */
+export function isDmChannel(channel) {
+    return channel.startsWith('dm:');
+}
+/**
+ * Check if a channel is private.
+ */
+export function isPrivateChannel(channel) {
+    return channel.startsWith('private:');
+}
+/**
+ * Check if a channel is a public channel (starts with #).
+ */
+export function isPublicChannel(channel) {
+    return channel.startsWith('#');
+}
+/**
+ * Normalize channel name for storage/lookup.
+ * - Removes leading # from public channels
+ * - Sorts participants in DM channels
+ */
+export function normalizeChannelName(channel) {
+    if (channel.startsWith('#')) {
+        return channel.slice(1);
+    }
+    if (channel.startsWith('dm:')) {
+        const participants = parseDmChannel(channel);
+        if (participants) {
+            return createDmChannelName(...participants);
+        }
+    }
+    return channel;
+}
+//# sourceMappingURL=channels.js.map

package/dist/channels.js.map

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

package/dist/framing.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Frame encoding/decoding for the Agent Relay protocol.
+ * @agent-relay/sdk
+ *
+ * Wire format:
+ * - 1 byte: format indicator (0 = JSON, 1 = MessagePack)
+ * - 4 bytes: big-endian payload length
+ * - N bytes: payload (JSON or MessagePack encoded)
+ *
+ * Legacy format (for backwards compatibility):
+ * - 4 bytes: big-endian payload length
+ * - N bytes: JSON payload
+ */
+import type { Envelope } from './types.js';
+export declare const MAX_FRAME_BYTES: number;
+export declare const HEADER_SIZE = 5;
+export declare const LEGACY_HEADER_SIZE = 4;
+export type WireFormat = 'json' | 'msgpack';
+/**
+ * Initialize MessagePack support.
+ * Install @msgpack/msgpack to enable: npm install @msgpack/msgpack
+ */
+export declare function initMessagePack(): Promise<boolean>;
+/**
+ * Check if MessagePack is available.
+ */
+export declare function hasMessagePack(): boolean;
+/**
+ * Encode a message envelope into a framed buffer.
+ *
+ * @param envelope - The envelope to encode
+ * @param format - Wire format to use (default: 'json')
+ * @returns Framed buffer ready for socket write
+ */
+export declare function encodeFrame(envelope: Envelope, format?: WireFormat): Buffer;
+/**
+ * Encode a frame in legacy format (no format byte, JSON only).
+ * Used for backwards compatibility with older clients.
+ */
+export declare function encodeFrameLegacy(envelope: Envelope): Buffer;
+/**
+ * Ring buffer-based frame parser for streaming data.
+ */
+export declare class FrameParser {
+    private ring;
+    private head;
+    private tail;
+    private readonly capacity;
+    private readonly maxFrameBytes;
+    private format;
+    private legacyMode;
+    constructor(maxFrameBytes?: number);
+    /**
+     * Set the expected wire format for parsing.
+     */
+    setFormat(format: WireFormat): void;
+    /**
+     * Enable legacy mode (4-byte header, JSON only).
+     */
+    setLegacyMode(legacy: boolean): void;
+    /**
+     * Get current unread bytes in buffer.
+     */
+    get pendingBytes(): number;
+    /**
+     * Push data into the parser and extract complete frames.
+     *
+     * @param data - Incoming data buffer
+     * @returns Array of parsed envelope frames
+     */
+    push(data: Buffer): Envelope[];
+    private extractFrames;
+    private decodePayload;
+    private compact;
+    /**
+     * Reset parser state.
+     */
+    reset(): void;
+}
+//# sourceMappingURL=framing.d.ts.map

package/dist/framing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.d.ts","sourceRoot":"","sources":["../src/framing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,eAAO,MAAM,eAAe,QAAc,CAAC;AAC3C,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAS5C;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAgBxD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAE,UAAmB,GAAG,MAAM,CAsBnF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAY5D;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,UAAU,CAAS;gBAEf,aAAa,GAAE,MAAwB;IAMnD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAInC;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIpC;;OAEG;IACH,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE;IAiB9B,OAAO,CAAC,aAAa;IA8CrB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,OAAO;IAWf;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}

package/dist/framing.js

@@ -0,0 +1,206 @@
+/**
+ * Frame encoding/decoding for the Agent Relay protocol.
+ * @agent-relay/sdk
+ *
+ * Wire format:
+ * - 1 byte: format indicator (0 = JSON, 1 = MessagePack)
+ * - 4 bytes: big-endian payload length
+ * - N bytes: payload (JSON or MessagePack encoded)
+ *
+ * Legacy format (for backwards compatibility):
+ * - 4 bytes: big-endian payload length
+ * - N bytes: JSON payload
+ */
+export const MAX_FRAME_BYTES = 1024 * 1024; // 1 MiB
+export const HEADER_SIZE = 5; // 1 byte format + 4 bytes length
+export const LEGACY_HEADER_SIZE = 4; // For backwards compatibility
+// Format indicator bytes
+const FORMAT_JSON = 0;
+const FORMAT_MSGPACK = 1;
+// Optional MessagePack - loaded dynamically if available
+let msgpack = null;
+/**
+ * Initialize MessagePack support.
+ * Install @msgpack/msgpack to enable: npm install @msgpack/msgpack
+ */
+export async function initMessagePack() {
+    if (msgpack)
+        return true;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const mod = await import('@msgpack/msgpack');
+        const encode = mod.encode || mod.default?.encode;
+        const decode = mod.decode || mod.default?.decode;
+        if (encode && decode) {
+            msgpack = { encode, decode };
+            return true;
+        }
+        return false;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if MessagePack is available.
+ */
+export function hasMessagePack() {
+    return msgpack !== null;
+}
+/**
+ * Encode a message envelope into a framed buffer.
+ *
+ * @param envelope - The envelope to encode
+ * @param format - Wire format to use (default: 'json')
+ * @returns Framed buffer ready for socket write
+ */
+export function encodeFrame(envelope, format = 'json') {
+    let data;
+    let formatByte;
+    if (format === 'msgpack' && msgpack) {
+        const encoded = msgpack.encode(envelope);
+        data = Buffer.from(encoded.buffer, encoded.byteOffset, encoded.byteLength);
+        formatByte = FORMAT_MSGPACK;
+    }
+    else {
+        data = Buffer.from(JSON.stringify(envelope), 'utf-8');
+        formatByte = FORMAT_JSON;
+    }
+    if (data.length > MAX_FRAME_BYTES) {
+        throw new Error(`Frame too large: ${data.length} > ${MAX_FRAME_BYTES}`);
+    }
+    const header = Buffer.alloc(HEADER_SIZE);
+    header.writeUInt8(formatByte, 0);
+    header.writeUInt32BE(data.length, 1);
+    return Buffer.concat([header, data]);
+}
+/**
+ * Encode a frame in legacy format (no format byte, JSON only).
+ * Used for backwards compatibility with older clients.
+ */
+export function encodeFrameLegacy(envelope) {
+    const json = JSON.stringify(envelope);
+    const data = Buffer.from(json, 'utf-8');
+    if (data.length > MAX_FRAME_BYTES) {
+        throw new Error(`Frame too large: ${data.length} > ${MAX_FRAME_BYTES}`);
+    }
+    const header = Buffer.alloc(LEGACY_HEADER_SIZE);
+    header.writeUInt32BE(data.length, 0);
+    return Buffer.concat([header, data]);
+}
+/**
+ * Ring buffer-based frame parser for streaming data.
+ */
+export class FrameParser {
+    ring;
+    head = 0;
+    tail = 0;
+    capacity;
+    maxFrameBytes;
+    format = 'json';
+    legacyMode = false;
+    constructor(maxFrameBytes = MAX_FRAME_BYTES) {
+        this.maxFrameBytes = maxFrameBytes;
+        this.capacity = maxFrameBytes * 2 + HEADER_SIZE;
+        this.ring = Buffer.allocUnsafe(this.capacity);
+    }
+    /**
+     * Set the expected wire format for parsing.
+     */
+    setFormat(format) {
+        this.format = format;
+    }
+    /**
+     * Enable legacy mode (4-byte header, JSON only).
+     */
+    setLegacyMode(legacy) {
+        this.legacyMode = legacy;
+    }
+    /**
+     * Get current unread bytes in buffer.
+     */
+    get pendingBytes() {
+        return this.tail - this.head;
+    }
+    /**
+     * Push data into the parser and extract complete frames.
+     *
+     * @param data - Incoming data buffer
+     * @returns Array of parsed envelope frames
+     */
+    push(data) {
+        const spaceAtEnd = this.capacity - this.tail;
+        if (data.length > spaceAtEnd) {
+            this.compact();
+            if (data.length > this.capacity - this.tail) {
+                throw new Error(`Buffer overflow: data ${data.length} exceeds capacity`);
+            }
+        }
+        data.copy(this.ring, this.tail);
+        this.tail += data.length;
+        return this.extractFrames();
+    }
+    extractFrames() {
+        const frames = [];
+        const headerSize = this.legacyMode ? LEGACY_HEADER_SIZE : HEADER_SIZE;
+        while (this.pendingBytes >= headerSize) {
+            let formatByte = FORMAT_JSON;
+            let frameLength;
+            if (this.legacyMode) {
+                frameLength = this.ring.readUInt32BE(this.head);
+            }
+            else {
+                formatByte = this.ring.readUInt8(this.head);
+                frameLength = this.ring.readUInt32BE(this.head + 1);
+            }
+            if (frameLength > this.maxFrameBytes) {
+                throw new Error(`Frame too large: ${frameLength} > ${this.maxFrameBytes}`);
+            }
+            const totalLength = headerSize + frameLength;
+            if (this.pendingBytes < totalLength) {
+                break;
+            }
+            const payloadStart = this.head + headerSize;
+            const payloadEnd = this.head + totalLength;
+            let envelope;
+            try {
+                envelope = this.decodePayload(formatByte, payloadStart, payloadEnd);
+            }
+            catch (err) {
+                throw new Error(`Invalid frame payload: ${err}`);
+            }
+            this.head += totalLength;
+            frames.push(envelope);
+        }
+        if (this.head > this.capacity / 2 && this.pendingBytes < this.capacity / 4) {
+            this.compact();
+        }
+        return frames;
+    }
+    decodePayload(formatByte, start, end) {
+        if (formatByte === FORMAT_MSGPACK && msgpack) {
+            return msgpack.decode(this.ring.subarray(start, end));
+        }
+        else {
+            return JSON.parse(this.ring.toString('utf-8', start, end));
+        }
+    }
+    compact() {
+        if (this.head === 0)
+            return;
+        const unread = this.pendingBytes;
+        if (unread > 0) {
+            this.ring.copy(this.ring, 0, this.head, this.tail);
+        }
+        this.head = 0;
+        this.tail = unread;
+    }
+    /**
+     * Reset parser state.
+     */
+    reset() {
+        this.head = 0;
+        this.tail = 0;
+    }
+}
+//# sourceMappingURL=framing.js.map

package/dist/framing.js.map

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

package/dist/id-generator.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Monotonic ID Generator
+ *
+ * Generates unique, lexicographically sortable IDs that are faster than UUID v4.
+ *
+ * Format: <timestamp-base36>-<counter-base36>-<nodeId>
+ * Example: "lxyz5g8-0001-7d2a"
+ *
+ * Properties:
+ * - Lexicographically sortable by time
+ * - Unique across processes (node prefix)
+ * - ~16x faster than UUID v4
+ * - Shorter (20-24 chars vs 36 chars)
+ */
+export declare class IdGenerator {
+    private counter;
+    private readonly prefix;
+    private lastTs;
+    constructor(nodeId?: string);
+    /**
+     * Generate a unique, monotonically increasing ID.
+     */
+    next(): string;
+    /**
+     * Generate a short ID (just timestamp + counter, no node prefix).
+     * Use when you don't need cross-process uniqueness.
+     */
+    short(): string;
+}
+export declare const idGen: IdGenerator;
+/**
+ * Generate a unique ID (drop-in replacement for uuid()).
+ */
+export declare function generateId(): string;
+//# sourceMappingURL=id-generator.d.ts.map

package/dist/id-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id-generator.d.ts","sourceRoot":"","sources":["../src/id-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,MAAM,CAAK;gBAEP,MAAM,CAAC,EAAE,MAAM;IAK3B;;OAEG;IACH,IAAI,IAAI,MAAM;IAcd;;;OAGG;IACH,KAAK,IAAI,MAAM;CAYhB;AAGD,eAAO,MAAM,KAAK,aAAoB,CAAC;AAEvC;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC"}