beam-protocol-sdk 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,63 @@
+import { BeamDirectory } from './directory.js';
+import type { BeamClientConfig, BeamIdString, IntentFrame, ResultFrame, AgentRecord } from './types.js';
+type IntentHandler = (frame: IntentFrame, respond: (options: {
+    success: boolean;
+    payload?: Record<string, unknown>;
+    error?: string;
+    errorCode?: string;
+    latency?: number;
+}) => ResultFrame) => void | Promise<void>;
+export declare class BeamClient {
+    private readonly _identity;
+    private readonly _directory;
+    private readonly _directoryUrl;
+    private _ws;
+    private _wsConnected;
+    private readonly _pendingResults;
+    private readonly _intentHandlers;
+    constructor(config: BeamClientConfig);
+    get beamId(): BeamIdString;
+    get directory(): BeamDirectory;
+    register(displayName: string, capabilities: string[]): Promise<AgentRecord>;
+    connect(): Promise<void>;
+    private _handleMessage;
+    send(to: BeamIdString, intent: string, payload?: Record<string, unknown>, timeoutMs?: number): Promise<ResultFrame>;
+    private _sendViaWebSocket;
+    private _sendViaHttp;
+    on(intent: string, handler: IntentHandler): this;
+    /**
+     * Send a natural language message to another agent.
+     * The receiving agent uses its LLM to interpret and respond.
+     *
+     * @example
+     * const reply = await client.talk(
+     *   'clara@coppen.beam.directory',
+     *   'Was weißt du über Chris Schnorrenberg?'
+     * )
+     * console.log(reply.message) // Natural language response
+     * console.log(reply.structured) // Optional structured data
+     */
+    talk(to: BeamIdString, message: string, options?: {
+        context?: Record<string, unknown>;
+        language?: string;
+        timeoutMs?: number;
+    }): Promise<{
+        message: string;
+        structured?: Record<string, unknown>;
+        raw: ResultFrame;
+    }>;
+    /**
+     * Register a natural language handler.
+     * Convenience wrapper that listens for conversation.message intents.
+     *
+     * @example
+     * client.onTalk(async (message, from, respond) => {
+     *   const answer = await myLLM.generate(message)
+     *   respond(answer)
+     * })
+     */
+    onTalk(handler: (message: string, from: BeamIdString, respond: (reply: string, structured?: Record<string, unknown>) => void, frame: IntentFrame) => void | Promise<void>): this;
+    disconnect(): void;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAE9C,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACZ,MAAM,YAAY,CAAA;AAanB,KAAK,aAAa,GAAG,CACnB,KAAK,EAAE,WAAW,EAClB,OAAO,EAAE,CAAC,OAAO,EAAE;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,KAAK,WAAW,KACd,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAiBzB,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAQ;IACtC,OAAO,CAAC,GAAG,CAA6B;IACxC,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmC;IACnE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmC;gBAEvD,MAAM,EAAE,gBAAgB;IAMpC,IAAI,MAAM,IAAI,YAAY,CAEzB;IAED,IAAI,SAAS,IAAI,aAAa,CAE7B;IAEK,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAa3E,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA0D9B,OAAO,CAAC,cAAc;IAqDhB,IAAI,CACR,EAAE,EAAE,YAAY,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,SAAS,SAAS,GACjB,OAAO,CAAC,WAAW,CAAC;IAUvB,OAAO,CAAC,iBAAiB;YAmBX,YAAY;IAa1B,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAKhD;;;;;;;;;;;OAWG;IACG,IAAI,CACR,EAAE,EAAE,YAAY,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACjC,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,GACA,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,GAAG,EAAE,WAAW,CAAA;KAAE,CAAC;IA4BvF;;;;;;;;;OASG;IACH,MAAM,CACJ,OAAO,EAAE,CACP,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,EACtE,KAAK,EAAE,WAAW,KACf,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACxB,IAAI;IAiBP,UAAU,IAAI,IAAI;CAanB"}

package/dist/client.js

@@ -0,0 +1,254 @@
+import { BeamIdentity } from './identity.js';
+import { BeamDirectory } from './directory.js';
+import { createIntentFrame, createResultFrame, signFrame, validateIntentFrame } from './frames.js';
+async function openWebSocket(url) {
+    if (typeof globalThis.WebSocket !== 'undefined') {
+        return new globalThis.WebSocket(url);
+    }
+    // Node 18-20: use ws package
+    const { default: WS } = await import('ws');
+    return new WS(url);
+}
+export class BeamClient {
+    _identity;
+    _directory;
+    _directoryUrl;
+    _ws = null;
+    _wsConnected = false;
+    _pendingResults = new Map();
+    _intentHandlers = new Map();
+    constructor(config) {
+        this._identity = BeamIdentity.fromData(config.identity);
+        this._directoryUrl = config.directoryUrl;
+        this._directory = new BeamDirectory({ baseUrl: config.directoryUrl });
+    }
+    get beamId() {
+        return this._identity.beamId;
+    }
+    get directory() {
+        return this._directory;
+    }
+    async register(displayName, capabilities) {
+        const parsed = BeamIdentity.parseBeamId(this._identity.beamId);
+        if (!parsed)
+            throw new Error('Invalid beam ID on identity');
+        return this._directory.register({
+            beamId: this._identity.beamId,
+            displayName,
+            capabilities,
+            publicKey: this._identity.publicKeyBase64,
+            org: parsed.org
+        });
+    }
+    async connect() {
+        if (this._ws && this._wsConnected)
+            return;
+        // Convert http(s) scheme to ws(s) and append /ws path with beamId query param
+        const wsUrl = this._directoryUrl
+            .replace(/^http:\/\//, 'ws://')
+            .replace(/^https:\/\//, 'wss://')
+            .replace(/\/$/, '') + `/ws?beamId=${encodeURIComponent(this._identity.beamId)}`;
+        return new Promise((resolve, reject) => {
+            openWebSocket(wsUrl).then((ws) => {
+                this._ws = ws;
+                ws.onopen = () => {
+                    // Wait for the server's connected message before resolving
+                };
+                ws.onmessage = (event) => {
+                    this._handleMessage(event.data);
+                };
+                ws.onclose = () => {
+                    this._wsConnected = false;
+                    this._ws = null;
+                    // Reject all pending results
+                    for (const [nonce, pending] of this._pendingResults) {
+                        clearTimeout(pending.timer);
+                        pending.reject(new Error('WebSocket connection closed'));
+                        this._pendingResults.delete(nonce);
+                    }
+                };
+                ws.onerror = (event) => {
+                    if (!this._wsConnected) {
+                        reject(new Error(`WebSocket connection error: ${String(event)}`));
+                    }
+                };
+                // We resolve after receiving the 'connected' message
+                const originalHandleMessage = this._handleMessage.bind(this);
+                this._handleMessage = (data) => {
+                    try {
+                        const msg = JSON.parse(data);
+                        if (msg.type === 'connected') {
+                            this._wsConnected = true;
+                            this._handleMessage = originalHandleMessage;
+                            resolve();
+                            return;
+                        }
+                    }
+                    catch {
+                        // ignore parse errors during connect phase
+                    }
+                    originalHandleMessage(data);
+                };
+            }).catch(reject);
+        });
+    }
+    _handleMessage(data) {
+        let msg;
+        try {
+            msg = JSON.parse(data);
+        }
+        catch {
+            return;
+        }
+        if (msg['type'] === 'result') {
+            const frame = msg['frame'];
+            if (!frame)
+                return;
+            const pending = this._pendingResults.get(frame.nonce);
+            if (pending) {
+                clearTimeout(pending.timer);
+                this._pendingResults.delete(frame.nonce);
+                pending.resolve(frame);
+            }
+        }
+        else if (msg['type'] === 'intent') {
+            const frame = msg['frame'];
+            const senderPublicKey = msg['senderPublicKey'];
+            if (!frame || !senderPublicKey)
+                return;
+            const validation = validateIntentFrame(frame, senderPublicKey);
+            if (!validation.valid)
+                return;
+            const handler = this._intentHandlers.get(frame.intent) ?? this._intentHandlers.get('*');
+            if (!handler)
+                return;
+            const startTime = Date.now();
+            const respond = (options) => {
+                const latency = options.latency ?? (Date.now() - startTime);
+                const resultFrame = createResultFrame({ ...options, nonce: frame.nonce, latency }, this._identity);
+                if (this._ws && this._wsConnected) {
+                    this._ws.send(JSON.stringify({ type: 'result', frame: resultFrame }));
+                }
+                return resultFrame;
+            };
+            Promise.resolve(handler(frame, respond)).catch(() => {
+                // Swallow handler errors to avoid unhandled rejections
+            });
+        }
+    }
+    async send(to, intent, payload, timeoutMs = 30_000) {
+        const frame = createIntentFrame({ intent, from: this._identity.beamId, to, payload }, this._identity);
+        signFrame(frame, this._identity.export().privateKeyBase64);
+        if (this._ws && this._wsConnected) {
+            return this._sendViaWebSocket(frame, timeoutMs);
+        }
+        return this._sendViaHttp(frame);
+    }
+    _sendViaWebSocket(frame, timeoutMs) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this._pendingResults.delete(frame.nonce);
+                reject(new Error(`Intent "${frame.intent}" timed out after ${timeoutMs}ms`));
+            }, timeoutMs);
+            this._pendingResults.set(frame.nonce, { resolve, reject, timer });
+            try {
+                this._ws.send(JSON.stringify({ type: 'intent', frame }));
+            }
+            catch (err) {
+                clearTimeout(timer);
+                this._pendingResults.delete(frame.nonce);
+                reject(err);
+            }
+        });
+    }
+    async _sendViaHttp(frame) {
+        const baseUrl = this._directoryUrl.replace(/\/$/, '');
+        const res = await fetch(`${baseUrl}/intents`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify(frame)
+        });
+        if (!res.ok) {
+            throw new Error(`HTTP intent delivery failed: ${res.status} ${res.statusText}`);
+        }
+        return res.json();
+    }
+    on(intent, handler) {
+        this._intentHandlers.set(intent, handler);
+        return this;
+    }
+    /**
+     * Send a natural language message to another agent.
+     * The receiving agent uses its LLM to interpret and respond.
+     *
+     * @example
+     * const reply = await client.talk(
+     *   'clara@coppen.beam.directory',
+     *   'Was weißt du über Chris Schnorrenberg?'
+     * )
+     * console.log(reply.message) // Natural language response
+     * console.log(reply.structured) // Optional structured data
+     */
+    async talk(to, message, options) {
+        if (!message || message.length === 0) {
+            throw new Error('Message must be non-empty');
+        }
+        if (message.length > 32768) {
+            throw new Error('Message exceeds maximum length of 32768 characters');
+        }
+        const payload = {
+            message,
+        };
+        if (options?.context)
+            payload['context'] = options.context;
+        if (options?.language)
+            payload['language'] = options.language;
+        const result = await this.send(to, 'conversation.message', payload, options?.timeoutMs ?? 60_000 // Longer default for NL (LLM processing)
+        );
+        return {
+            message: result.payload?.['message'] ?? '',
+            structured: result.payload?.['structured'],
+            raw: result,
+        };
+    }
+    /**
+     * Register a natural language handler.
+     * Convenience wrapper that listens for conversation.message intents.
+     *
+     * @example
+     * client.onTalk(async (message, from, respond) => {
+     *   const answer = await myLLM.generate(message)
+     *   respond(answer)
+     * })
+     */
+    onTalk(handler) {
+        this.on('conversation.message', (frame, rawRespond) => {
+            const message = frame.payload?.['message'] ?? '';
+            const respond = (reply, structured) => {
+                rawRespond({
+                    success: true,
+                    payload: {
+                        message: reply,
+                        ...(structured ? { structured } : {}),
+                    },
+                });
+            };
+            return handler(message, frame.from, respond, frame);
+        });
+        return this;
+    }
+    disconnect() {
+        if (this._ws) {
+            this._wsConnected = false;
+            // Reject all pending results before closing
+            for (const [nonce, pending] of this._pendingResults) {
+                clearTimeout(pending.timer);
+                pending.reject(new Error('Client disconnected'));
+                this._pendingResults.delete(nonce);
+            }
+            this._ws.close();
+            this._ws = null;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/directory.d.ts

@@ -0,0 +1,15 @@
+import type { AgentRecord, AgentRegistration, AgentSearchQuery, BeamIdString, DirectoryConfig } from './types.js';
+export declare class BeamDirectoryError extends Error {
+    readonly statusCode: number;
+    constructor(message: string, statusCode: number);
+}
+export declare class BeamDirectory {
+    private readonly baseUrl;
+    private readonly headers;
+    constructor(config: DirectoryConfig);
+    register(registration: AgentRegistration): Promise<AgentRecord>;
+    lookup(beamId: BeamIdString): Promise<AgentRecord | null>;
+    search(query: AgentSearchQuery): Promise<AgentRecord[]>;
+    heartbeat(beamId: BeamIdString): Promise<void>;
+}
+//# sourceMappingURL=directory.d.ts.map

package/dist/directory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directory.d.ts","sourceRoot":"","sources":["../src/directory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,eAAe,EAChB,MAAM,YAAY,CAAA;AAiBnB,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,UAAU,EAAE,MAAM;gBADlC,OAAO,EAAE,MAAM,EACC,UAAU,EAAE,MAAM;CAKrC;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;gBAEpC,MAAM,EAAE,eAAe;IAQ7B,QAAQ,CAAC,YAAY,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAa/D,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IASzD,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAcvD,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CASrD"}

package/dist/directory.js

@@ -0,0 +1,82 @@
+/** Normalize snake_case server response to camelCase AgentRecord */
+function normalizeAgent(raw) {
+    return {
+        beamId: (raw.beamId ?? raw.beam_id),
+        displayName: (raw.displayName ?? raw.display_name ?? ''),
+        capabilities: (raw.capabilities ?? []),
+        publicKey: (raw.publicKey ?? raw.public_key ?? ''),
+        org: (raw.org ?? ''),
+        trustScore: (raw.trustScore ?? raw.trust_score ?? 0),
+        verified: (raw.verified ?? false),
+        createdAt: (raw.createdAt ?? raw.created_at ?? ''),
+        lastSeen: (raw.lastSeen ?? raw.last_seen ?? ''),
+    };
+}
+export class BeamDirectoryError extends Error {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = 'BeamDirectoryError';
+    }
+}
+export class BeamDirectory {
+    baseUrl;
+    headers;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+        this.headers = {
+            'Content-Type': 'application/json',
+            ...(config.apiKey && { Authorization: `Bearer ${config.apiKey}` })
+        };
+    }
+    async register(registration) {
+        const res = await fetch(`${this.baseUrl}/agents/register`, {
+            method: 'POST',
+            headers: this.headers,
+            body: JSON.stringify(registration)
+        });
+        if (!res.ok) {
+            const body = await res.json().catch(() => ({ error: res.statusText }));
+            throw new BeamDirectoryError(`Registration failed: ${body.error}`, res.status);
+        }
+        return res.json();
+    }
+    async lookup(beamId) {
+        const res = await fetch(`${this.baseUrl}/agents/${encodeURIComponent(beamId)}`, {
+            headers: this.headers
+        });
+        if (res.status === 404)
+            return null;
+        if (!res.ok)
+            throw new BeamDirectoryError(`Lookup failed: ${res.statusText}`, res.status);
+        return res.json();
+    }
+    async search(query) {
+        const params = new URLSearchParams();
+        if (query.org)
+            params.set('org', query.org);
+        if (query.capabilities?.length)
+            params.set('capabilities', query.capabilities.join(','));
+        if (query.minTrustScore !== undefined)
+            params.set('minTrustScore', String(query.minTrustScore));
+        if (query.limit !== undefined)
+            params.set('limit', String(query.limit));
+        const res = await fetch(`${this.baseUrl}/agents/search?${params}`, { headers: this.headers });
+        if (!res.ok)
+            throw new BeamDirectoryError(`Search failed: ${res.statusText}`, res.status);
+        const body = await res.json();
+        const raw = Array.isArray(body) ? body : (body?.agents ?? []);
+        return raw.map(normalizeAgent);
+    }
+    async heartbeat(beamId) {
+        const res = await fetch(`${this.baseUrl}/agents/${encodeURIComponent(beamId)}/heartbeat`, {
+            method: 'POST',
+            headers: this.headers
+        });
+        if (!res.ok && res.status !== 404) {
+            throw new BeamDirectoryError(`Heartbeat failed: ${res.statusText}`, res.status);
+        }
+    }
+}
+//# sourceMappingURL=directory.js.map

package/dist/directory.js.map

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

package/dist/frames.d.ts

@@ -0,0 +1,29 @@
+import type { IntentFrame, ResultFrame, BeamIdString } from './types.js';
+import { BeamIdentity } from './identity.js';
+export declare const MAX_FRAME_SIZE: number;
+export declare const REPLAY_WINDOW_MS: number;
+export declare function createIntentFrame(options: {
+    intent: string;
+    from: BeamIdString;
+    to: BeamIdString;
+    payload?: Record<string, unknown>;
+}, identity: BeamIdentity): IntentFrame;
+export declare function signFrame(frame: IntentFrame, privateKeyBase64: string): IntentFrame;
+export declare function createResultFrame(options: {
+    nonce: string;
+    success: boolean;
+    payload?: Record<string, unknown>;
+    error?: string;
+    errorCode?: string;
+    latency?: number;
+}, identity: BeamIdentity): ResultFrame;
+export declare function validateIntentFrame(frame: unknown, senderPublicKey: string): {
+    valid: boolean;
+    error?: string;
+};
+export declare function validateResultFrame(frame: unknown, senderPublicKey: string): {
+    valid: boolean;
+    error?: string;
+};
+export declare function canonicalizeFrame(frame: Record<string, unknown>): string;
+//# sourceMappingURL=frames.d.ts.map

package/dist/frames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../src/frames.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE5C,eAAO,MAAM,cAAc,QAAW,CAAA;AACtC,eAAO,MAAM,gBAAgB,QAAgB,CAAA;AAE7C,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE;IACP,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,YAAY,CAAA;IAClB,EAAE,EAAE,YAAY,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC,EACD,QAAQ,EAAE,YAAY,GACrB,WAAW,CAWb;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,GAAG,WAAW,CAiBnF;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE;IACP,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,EACD,QAAQ,EAAE,YAAY,GACrB,WAAW,CAab;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,eAAe,EAAE,MAAM,GACtB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA8CpC;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,eAAe,EAAE,MAAM,GACtB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAkBpC;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAExE"}

package/dist/frames.js

@@ -0,0 +1,133 @@
+import { randomUUID, createPrivateKey, sign } from 'node:crypto';
+import { BeamIdentity } from './identity.js';
+export const MAX_FRAME_SIZE = 4 * 1024; // 4KB hard limit
+export const REPLAY_WINDOW_MS = 5 * 60 * 1000; // 5 minutes
+export function createIntentFrame(options, identity) {
+    const frame = {
+        v: '1',
+        intent: options.intent,
+        from: options.from,
+        to: options.to,
+        payload: options.payload ?? {},
+        nonce: randomUUID(),
+        timestamp: new Date().toISOString()
+    };
+    return signFrame(frame, identity.export().privateKeyBase64);
+}
+export function signFrame(frame, privateKeyBase64) {
+    const signedPayload = JSON.stringify({
+        type: 'intent',
+        from: frame.from,
+        to: frame.to,
+        intent: frame.intent,
+        payload: frame.payload,
+        timestamp: frame.timestamp,
+        nonce: frame.nonce,
+    });
+    const privateKey = createPrivateKey({
+        key: Buffer.from(privateKeyBase64, 'base64'),
+        format: 'der',
+        type: 'pkcs8',
+    });
+    frame.signature = sign(null, Buffer.from(signedPayload, 'utf8'), privateKey).toString('base64');
+    return frame;
+}
+export function createResultFrame(options, identity) {
+    const frame = {
+        v: '1',
+        success: options.success,
+        nonce: options.nonce,
+        timestamp: new Date().toISOString(),
+        ...(options.payload !== undefined && { payload: options.payload }),
+        ...(options.error !== undefined && { error: options.error }),
+        ...(options.errorCode !== undefined && { errorCode: options.errorCode }),
+        ...(options.latency !== undefined && { latency: options.latency })
+    };
+    frame.signature = identity.sign(canonicalizeFrame(frame));
+    return frame;
+}
+export function validateIntentFrame(frame, senderPublicKey) {
+    if (!frame || typeof frame !== 'object') {
+        return { valid: false, error: 'Frame must be an object' };
+    }
+    const f = frame;
+    if (f['v'] !== '1')
+        return { valid: false, error: 'Invalid protocol version' };
+    if (typeof f['intent'] !== 'string' || !f['intent'])
+        return { valid: false, error: 'Missing or empty intent' };
+    if (typeof f['from'] !== 'string' || !BeamIdentity.parseBeamId(f['from'])) {
+        return { valid: false, error: 'Invalid from Beam ID' };
+    }
+    if (typeof f['to'] !== 'string' || !BeamIdentity.parseBeamId(f['to'])) {
+        return { valid: false, error: 'Invalid to Beam ID' };
+    }
+    if (typeof f['nonce'] !== 'string' || !f['nonce'])
+        return { valid: false, error: 'Missing nonce' };
+    if (typeof f['timestamp'] !== 'string')
+        return { valid: false, error: 'Missing timestamp' };
+    if (!f['payload'] || typeof f['payload'] !== 'object' || Array.isArray(f['payload'])) {
+        return { valid: false, error: 'Payload must be an object' };
+    }
+    const size = Buffer.byteLength(JSON.stringify(frame), 'utf8');
+    if (size > MAX_FRAME_SIZE) {
+        return { valid: false, error: `Frame size ${size} exceeds limit of ${MAX_FRAME_SIZE} bytes` };
+    }
+    const frameTime = new Date(f['timestamp']).getTime();
+    if (isNaN(frameTime))
+        return { valid: false, error: 'Invalid timestamp format' };
+    if (Math.abs(Date.now() - frameTime) > REPLAY_WINDOW_MS) {
+        return { valid: false, error: 'Frame timestamp outside replay window (±5 minutes)' };
+    }
+    if (typeof f['signature'] !== 'string')
+        return { valid: false, error: 'Missing signature' };
+    const signedPayload = JSON.stringify({
+        type: 'intent',
+        from: f['from'],
+        to: f['to'],
+        intent: f['intent'],
+        payload: f['payload'],
+        timestamp: f['timestamp'],
+        nonce: f['nonce'],
+    });
+    if (!BeamIdentity.verify(signedPayload, f['signature'], senderPublicKey)) {
+        return { valid: false, error: 'Signature verification failed' };
+    }
+    return { valid: true };
+}
+export function validateResultFrame(frame, senderPublicKey) {
+    if (!frame || typeof frame !== 'object') {
+        return { valid: false, error: 'Frame must be an object' };
+    }
+    const f = frame;
+    if (f['v'] !== '1')
+        return { valid: false, error: 'Invalid protocol version' };
+    if (typeof f['success'] !== 'boolean')
+        return { valid: false, error: 'Missing success boolean' };
+    if (typeof f['nonce'] !== 'string' || !f['nonce'])
+        return { valid: false, error: 'Missing nonce' };
+    if (typeof f['timestamp'] !== 'string')
+        return { valid: false, error: 'Missing timestamp' };
+    if (typeof f['signature'] !== 'string')
+        return { valid: false, error: 'Missing signature' };
+    const { signature, ...unsigned } = f;
+    if (!BeamIdentity.verify(canonicalizeFrame(unsigned), signature, senderPublicKey)) {
+        return { valid: false, error: 'Signature verification failed' };
+    }
+    return { valid: true };
+}
+export function canonicalizeFrame(frame) {
+    return JSON.stringify(deepSortKeys(frame));
+}
+function deepSortKeys(value) {
+    if (Array.isArray(value))
+        return value.map(deepSortKeys);
+    if (value !== null && typeof value === 'object') {
+        const sorted = {};
+        for (const key of Object.keys(value).sort()) {
+            sorted[key] = deepSortKeys(value[key]);
+        }
+        return sorted;
+    }
+    return value;
+}
+//# sourceMappingURL=frames.js.map

package/dist/frames.js.map

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

package/dist/identity.d.ts

@@ -0,0 +1,19 @@
+import type { BeamIdString, BeamIdentityConfig, BeamIdentityData } from './types.js';
+export declare class BeamIdentity {
+    readonly beamId: BeamIdString;
+    readonly publicKeyBase64: string;
+    private readonly _privateKey;
+    private readonly _publicKey;
+    private constructor();
+    static generate(config: BeamIdentityConfig): BeamIdentity;
+    static fromData(data: BeamIdentityData): BeamIdentity;
+    export(): BeamIdentityData;
+    sign(data: string): string;
+    static verify(data: string, signatureBase64: string, publicKeyBase64: string): boolean;
+    static parseBeamId(beamId: string): {
+        agent: string;
+        org: string;
+    } | null;
+    static generateNonce(): string;
+}
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAEpF,qBAAa,YAAY;IACvB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAW;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAW;IAEtC,OAAO;IAOP,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY;IAMzD,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY;IAcrD,MAAM,IAAI,gBAAgB;IAQ1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAK1B,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO;IAkBtF,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAMzE,MAAM,CAAC,aAAa,IAAI,MAAM;CAG/B"}

package/dist/identity.js

@@ -0,0 +1,65 @@
+import { generateKeyPairSync, sign, verify, createPrivateKey, createPublicKey, randomUUID } from 'node:crypto';
+export class BeamIdentity {
+    beamId;
+    publicKeyBase64;
+    _privateKey;
+    _publicKey;
+    constructor(beamId, privateKey, publicKey) {
+        this.beamId = beamId;
+        this._privateKey = privateKey;
+        this._publicKey = publicKey;
+        this.publicKeyBase64 = publicKey.export({ type: 'spki', format: 'der' }).toString('base64');
+    }
+    static generate(config) {
+        const { privateKey, publicKey } = generateKeyPairSync('ed25519');
+        const beamId = `${config.agentName}@${config.orgName}.beam.directory`;
+        return new BeamIdentity(beamId, privateKey, publicKey);
+    }
+    static fromData(data) {
+        const privateKey = createPrivateKey({
+            key: Buffer.from(data.privateKeyBase64, 'base64'),
+            format: 'der',
+            type: 'pkcs8'
+        });
+        const publicKey = createPublicKey({
+            key: Buffer.from(data.publicKeyBase64, 'base64'),
+            format: 'der',
+            type: 'spki'
+        });
+        return new BeamIdentity(data.beamId, privateKey, publicKey);
+    }
+    export() {
+        return {
+            beamId: this.beamId,
+            publicKeyBase64: this.publicKeyBase64,
+            privateKeyBase64: this._privateKey.export({ type: 'pkcs8', format: 'der' }).toString('base64')
+        };
+    }
+    sign(data) {
+        const signature = sign(null, Buffer.from(data, 'utf8'), this._privateKey);
+        return signature.toString('base64');
+    }
+    static verify(data, signatureBase64, publicKeyBase64) {
+        try {
+            const publicKey = createPublicKey({
+                key: Buffer.from(publicKeyBase64, 'base64'),
+                format: 'der',
+                type: 'spki'
+            });
+            return verify(null, Buffer.from(data, 'utf8'), publicKey, Buffer.from(signatureBase64, 'base64'));
+        }
+        catch {
+            return false;
+        }
+    }
+    static parseBeamId(beamId) {
+        const match = beamId.match(/^([a-z0-9_-]+)@([a-z0-9_-]+)\.beam\.directory$/);
+        if (!match)
+            return null;
+        return { agent: match[1], org: match[2] };
+    }
+    static generateNonce() {
+        return randomUUID();
+    }
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { BeamIdentity } from './identity.js';
+export { BeamDirectory, BeamDirectoryError } from './directory.js';
+export { BeamClient } from './client.js';
+export { createIntentFrame, createResultFrame, signFrame, validateIntentFrame, validateResultFrame, canonicalizeFrame, MAX_FRAME_SIZE, REPLAY_WINDOW_MS } from './frames.js';
+export type { BeamIdString, BeamIdentityConfig, BeamIdentityData, IntentFrame, ResultFrame, AgentRegistration, AgentRecord, DirectoryConfig, BeamClientConfig, AgentSearchQuery } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EACjB,MAAM,aAAa,CAAA;AACpB,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { BeamIdentity } from './identity.js';
+export { BeamDirectory, BeamDirectoryError } from './directory.js';
+export { BeamClient } from './client.js';
+export { createIntentFrame, createResultFrame, signFrame, validateIntentFrame, validateResultFrame, canonicalizeFrame, MAX_FRAME_SIZE, REPLAY_WINDOW_MS } from './frames.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,SAAS,EACT,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EACjB,MAAM,aAAa,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,60 @@
+/** Beam ID format: agent@org.beam.directory */
+export type BeamIdString = `${string}@${string}.beam.directory`;
+export interface BeamIdentityConfig {
+    agentName: string;
+    orgName: string;
+}
+export interface BeamIdentityData {
+    beamId: BeamIdString;
+    publicKeyBase64: string;
+    privateKeyBase64: string;
+}
+export interface IntentFrame {
+    v: '1';
+    intent: string;
+    from: BeamIdString;
+    to: BeamIdString;
+    payload: Record<string, unknown>;
+    nonce: string;
+    timestamp: string;
+    signature?: string;
+}
+export interface ResultFrame {
+    v: '1';
+    success: boolean;
+    payload?: Record<string, unknown>;
+    error?: string;
+    errorCode?: string;
+    nonce: string;
+    timestamp: string;
+    latency?: number;
+    signature?: string;
+}
+export interface AgentRegistration {
+    beamId: BeamIdString;
+    displayName: string;
+    capabilities: string[];
+    publicKey: string;
+    org: string;
+}
+export interface AgentRecord extends AgentRegistration {
+    trustScore: number;
+    verified: boolean;
+    createdAt: string;
+    lastSeen: string;
+}
+export interface DirectoryConfig {
+    baseUrl: string;
+    apiKey?: string;
+}
+export interface BeamClientConfig {
+    identity: BeamIdentityData;
+    directoryUrl: string;
+}
+export interface AgentSearchQuery {
+    org?: string;
+    capabilities?: string[];
+    minTrustScore?: number;
+    limit?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,MAAM,YAAY,GAAG,GAAG,MAAM,IAAI,MAAM,iBAAiB,CAAA;AAE/D,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,GAAG,CAAA;IACN,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,YAAY,CAAA;IAClB,EAAE,EAAE,YAAY,CAAA;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,GAAG,CAAA;IACN,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACjC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,YAAY,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,EAAE,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,WAAY,SAAQ,iBAAiB;IACpD,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,gBAAgB,CAAA;IAC1B,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "beam-protocol-sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the Beam Protocol \u2014 Agent-to-Agent communication",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "@types/ws": "^8.5.10",
+    "typescript": "^5.3.3",
+    "vitest": "^1.2.0"
+  },
+  "optionalDependencies": {
+    "ws": "^8.16.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "Apache-2.0",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Beam-directory/beam-protocol.git",
+    "directory": "packages/sdk-typescript"
+  },
+  "homepage": "https://beam.directory",
+  "keywords": [
+    "beam",
+    "protocol",
+    "agent",
+    "a2a",
+    "ai",
+    "communication",
+    "ed25519"
+  ]
+}