@snap-protocol/core 0.1.0

package/dist/transport/NostrTransport.js

@@ -0,0 +1,211 @@
+import { SimplePool, finalizeEvent, getPublicKey, } from 'nostr-tools';
+import * as nip44 from 'nostr-tools/nip44';
+import { hexToBytes } from '@noble/hashes/utils';
+import { KeyManager } from '../crypto/KeyManager.js';
+/** Default Nostr event kind for encrypted SNAP messages. */
+export const SNAP_MESSAGE_KIND = 21339;
+/** Default Nostr event kind for agent card publication (replaceable). */
+export const SNAP_AGENT_CARD_KIND = 31337;
+/** Nostr transport: encrypted messaging via relays + agent card discovery. */
+export class NostrTransport {
+    name = 'nostr';
+    config;
+    pool;
+    pubkey;
+    secretKeyBytes;
+    subscriptionCloser = null;
+    constructor(config) {
+        this.config = {
+            ...config,
+            timeout: config.timeout ?? 30_000,
+            messageKind: config.messageKind ?? SNAP_MESSAGE_KIND,
+            agentCardKind: config.agentCardKind ?? SNAP_AGENT_CARD_KIND,
+            responseLookbackSeconds: config.responseLookbackSeconds ?? 5,
+            logger: config.logger,
+        };
+        this.pool = new SimplePool();
+        this.secretKeyBytes = hexToBytes(config.privateKey);
+        this.pubkey = getPublicKey(this.secretKeyBytes);
+    }
+    /**
+     * Send an encrypted SNAP message to another agent via Nostr.
+     * The recipient is determined by converting message.to (P2TR) to a hex pubkey.
+     */
+    async send(message, options) {
+        const recipientPubkey = KeyManager.p2trToPublicKey(message.to);
+        const conversationKey = nip44.v2.utils.getConversationKey(this.secretKeyBytes, recipientPubkey);
+        const encrypted = nip44.v2.encrypt(JSON.stringify(message), conversationKey);
+        const eventTemplate = {
+            kind: this.config.messageKind,
+            tags: [['p', recipientPubkey]],
+            content: encrypted,
+            created_at: Math.floor(Date.now() / 1000),
+        };
+        const signed = finalizeEvent(eventTemplate, this.secretKeyBytes);
+        // Publish to all relays
+        await Promise.allSettled(this.pool.publish(this.config.relays, signed));
+        // Wait for response
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                sub.close();
+                reject(new Error('Nostr response timed out'));
+            }, options.timeout ?? this.config.timeout);
+            const filter = {
+                kinds: [this.config.messageKind],
+                '#p': [this.pubkey],
+                since: Math.floor(Date.now() / 1000) - this.config.responseLookbackSeconds,
+            };
+            const sub = this.pool.subscribeMany(this.config.relays, filter, {
+                onevent: (event) => {
+                    try {
+                        const senderConvKey = nip44.v2.utils.getConversationKey(this.secretKeyBytes, event.pubkey);
+                        const decrypted = nip44.v2.decrypt(event.content, senderConvKey);
+                        const response = JSON.parse(decrypted);
+                        // Verify that the SNAP message `from` matches the Nostr event pubkey
+                        const expectedAddress = KeyManager.publicKeyToP2TR(event.pubkey);
+                        if (response.from !== expectedAddress) {
+                            this.config.logger?.('warn', `Identity mismatch in response: SNAP from=${response.from} but Nostr pubkey maps to ${expectedAddress}`);
+                            return;
+                        }
+                        // Check if this is a response to our message
+                        if (response.type === 'response' && response.method === message.method) {
+                            clearTimeout(timeout);
+                            sub.close();
+                            resolve(response);
+                        }
+                    }
+                    catch (err) {
+                        this.config.logger?.('debug', 'Failed to decrypt/parse Nostr event in send()', err);
+                    }
+                },
+            });
+        });
+    }
+    /** Subscribe to incoming SNAP messages. */
+    async listen(handler) {
+        const filter = {
+            kinds: [this.config.messageKind],
+            '#p': [this.pubkey],
+            since: Math.floor(Date.now() / 1000),
+        };
+        this.subscriptionCloser = this.pool.subscribeMany(this.config.relays, filter, {
+            onevent: async (event) => {
+                try {
+                    const conversationKey = nip44.v2.utils.getConversationKey(this.secretKeyBytes, event.pubkey);
+                    const decrypted = nip44.v2.decrypt(event.content, conversationKey);
+                    const inbound = JSON.parse(decrypted);
+                    // Verify that the SNAP message `from` matches the Nostr event pubkey
+                    const expectedAddress = KeyManager.publicKeyToP2TR(event.pubkey);
+                    if (inbound.from !== expectedAddress) {
+                        this.config.logger?.('warn', `Identity mismatch: SNAP from=${inbound.from} but Nostr pubkey maps to ${expectedAddress}`);
+                        return;
+                    }
+                    const response = await handler(inbound);
+                    if (response) {
+                        const respEncrypted = nip44.v2.encrypt(JSON.stringify(response), conversationKey);
+                        const respEvent = {
+                            kind: this.config.messageKind,
+                            tags: [['p', event.pubkey]],
+                            content: respEncrypted,
+                            created_at: Math.floor(Date.now() / 1000),
+                        };
+                        const signed = finalizeEvent(respEvent, this.secretKeyBytes);
+                        await Promise.allSettled(this.pool.publish(this.config.relays, signed));
+                    }
+                }
+                catch (err) {
+                    this.config.logger?.('warn', 'Failed to process inbound Nostr message', err);
+                }
+            },
+        });
+    }
+    /** Publish an agent card as a Nostr replaceable event (kind 31337). */
+    async publishAgentCard(card) {
+        const tags = [
+            ['d', card.identity],
+            ['name', card.name],
+            ['version', card.version],
+        ];
+        for (const skill of card.skills) {
+            tags.push(['skill', skill.id, skill.name]);
+        }
+        if (card.endpoints) {
+            for (const ep of card.endpoints) {
+                tags.push(['endpoint', ep.protocol, ep.url]);
+            }
+        }
+        if (card.nostrRelays) {
+            for (const relay of card.nostrRelays) {
+                tags.push(['relay', relay]);
+            }
+        }
+        const eventTemplate = {
+            kind: this.config.agentCardKind,
+            tags,
+            content: JSON.stringify(card),
+            created_at: Math.floor(Date.now() / 1000),
+        };
+        const signed = finalizeEvent(eventTemplate, this.secretKeyBytes);
+        await Promise.allSettled(this.pool.publish(this.config.relays, signed));
+    }
+    /** Query Nostr relays for agent cards matching the filter. */
+    async discoverAgents(filter) {
+        const nostrFilter = {
+            kinds: [this.config.agentCardKind],
+        };
+        if (filter.identity) {
+            nostrFilter['#d'] = [filter.identity];
+        }
+        if (filter.skills) {
+            nostrFilter['#skill'] = filter.skills;
+        }
+        if (filter.name) {
+            nostrFilter['#name'] = [filter.name];
+        }
+        const events = await this.pool.querySync(this.config.relays, nostrFilter);
+        return events.map((event) => {
+            try {
+                return JSON.parse(event.content);
+            }
+            catch (err) {
+                this.config.logger?.('warn', 'Failed to parse agent card from Nostr event', err);
+                return null;
+            }
+        }).filter((card) => card !== null);
+    }
+    /** Fetch offline messages since a given unix timestamp. */
+    async fetchOfflineMessages(since) {
+        const filter = {
+            kinds: [this.config.messageKind],
+            '#p': [this.pubkey],
+            since,
+        };
+        const events = await this.pool.querySync(this.config.relays, filter);
+        const messages = [];
+        for (const event of events) {
+            try {
+                const conversationKey = nip44.v2.utils.getConversationKey(this.secretKeyBytes, event.pubkey);
+                const decrypted = nip44.v2.decrypt(event.content, conversationKey);
+                const parsed = JSON.parse(decrypted);
+                // Verify that the SNAP message `from` matches the Nostr event pubkey
+                const expectedAddress = KeyManager.publicKeyToP2TR(event.pubkey);
+                if (parsed.from !== expectedAddress) {
+                    this.config.logger?.('warn', `Identity mismatch in offline message: SNAP from=${parsed.from} but Nostr pubkey maps to ${expectedAddress}`);
+                    continue;
+                }
+                messages.push(parsed);
+            }
+            catch (err) {
+                this.config.logger?.('debug', 'Skipping undecryptable offline message', err);
+            }
+        }
+        return messages;
+    }
+    /** Close all relay connections and subscriptions. */
+    async close() {
+        this.subscriptionCloser?.close();
+        this.subscriptionCloser = null;
+        this.pool.destroy();
+    }
+}
+//# sourceMappingURL=NostrTransport.js.map

package/dist/transport/NostrTransport.js.map

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

package/dist/transport/WebSocketTransport.d.ts

@@ -0,0 +1,41 @@
+import type { SnapMessage } from '../types/message.js';
+import type { TransportSendOptions, TransportLogger } from '../types/plugin.js';
+import type { StreamTransportPlugin } from '../types/transport.js';
+export interface WebSocketTransportConfig {
+    /** Port to listen on (default: 8080). */
+    port?: number;
+    /** Hostname to bind to (default: '0.0.0.0'). */
+    host?: string;
+    /** Heartbeat interval in ms (default: 30000). Set to 0 to disable. */
+    heartbeatInterval?: number;
+    /** Request timeout in ms (default: 30000). */
+    timeout?: number;
+    /** Optional logger for diagnostic events. */
+    logger?: TransportLogger;
+}
+/** WebSocket transport: full-duplex request-response and streaming. */
+export declare class WebSocketTransport implements StreamTransportPlugin {
+    readonly name = "websocket";
+    private readonly config;
+    private httpServer;
+    private wss;
+    private handler;
+    private streamHandler;
+    private heartbeatTimer;
+    constructor(config?: WebSocketTransportConfig);
+    /** Send a request and wait for a single response. */
+    send(message: SnapMessage, options: TransportSendOptions): Promise<SnapMessage>;
+    /** Send a request and receive a stream of responses. */
+    sendStream(message: SnapMessage, options: TransportSendOptions): AsyncIterable<SnapMessage>;
+    /** Start the WebSocket server and handle incoming messages. */
+    listen(handler: (message: SnapMessage) => Promise<SnapMessage | void>): Promise<void>;
+    /** Register a stream handler for incoming requests. */
+    listenStream(handler: (message: SnapMessage) => AsyncIterable<SnapMessage>): Promise<void>;
+    /** Stop the WebSocket server. */
+    close(): Promise<void>;
+    /** The port the server is listening on (undefined if not started). */
+    get port(): number | undefined;
+    private connect;
+    private ensureServer;
+}
+//# sourceMappingURL=WebSocketTransport.d.ts.map

package/dist/transport/WebSocketTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocketTransport.d.ts","sourceRoot":"","sources":["../../src/transport/WebSocketTransport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEnE,MAAM,WAAW,wBAAwB;IACvC,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAeD,uEAAuE;AACvE,qBAAa,kBAAmB,YAAW,qBAAqB;IAC9D,QAAQ,CAAC,IAAI,eAAe;IAE5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoF;IAC3G,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,GAAG,CAAgC;IAC3C,OAAO,CAAC,OAAO,CAAwE;IACvF,OAAO,CAAC,aAAa,CAAuE;IAC5F,OAAO,CAAC,cAAc,CAA+C;gBAEzD,MAAM,CAAC,EAAE,wBAAwB;IAU7C,qDAAqD;IAC/C,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;IAiCrF,wDAAwD;IACjD,UAAU,CACf,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,oBAAoB,GAC5B,aAAa,CAAC,WAAW,CAAC;IAiE7B,+DAA+D;IACzD,MAAM,CACV,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAC7D,OAAO,CAAC,IAAI,CAAC;IAKhB,uDAAuD;IACjD,YAAY,CAChB,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,aAAa,CAAC,WAAW,CAAC,GAC5D,OAAO,CAAC,IAAI,CAAC;IAKhB,iCAAiC;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB5B,sEAAsE;IACtE,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAI7B;IAED,OAAO,CAAC,OAAO;YAQD,YAAY;CAmD3B"}

package/dist/transport/WebSocketTransport.js

@@ -0,0 +1,206 @@
+import { WebSocketServer, WebSocket as WsWebSocket } from 'ws';
+import { createServer } from 'node:http';
+/** WebSocket transport: full-duplex request-response and streaming. */
+export class WebSocketTransport {
+    name = 'websocket';
+    config;
+    httpServer = null;
+    wss = null;
+    handler = null;
+    streamHandler = null;
+    heartbeatTimer = null;
+    constructor(config) {
+        this.config = {
+            port: config?.port ?? 8080,
+            host: config?.host ?? '0.0.0.0',
+            heartbeatInterval: config?.heartbeatInterval ?? 30_000,
+            timeout: config?.timeout ?? 30_000,
+            logger: config?.logger,
+        };
+    }
+    /** Send a request and wait for a single response. */
+    async send(message, options) {
+        const ws = await this.connect(options.endpoint);
+        const timeout = options.timeout ?? this.config.timeout;
+        try {
+            return await new Promise((resolve, reject) => {
+                const timer = setTimeout(() => {
+                    reject(new Error('WebSocket request timed out'));
+                }, timeout);
+                const onMessage = (data) => {
+                    clearTimeout(timer);
+                    ws.off('message', onMessage);
+                    try {
+                        resolve(JSON.parse(data.toString()));
+                    }
+                    catch (err) {
+                        reject(err);
+                    }
+                };
+                ws.on('message', onMessage);
+                ws.on('error', (err) => {
+                    clearTimeout(timer);
+                    reject(err);
+                });
+                ws.send(JSON.stringify(message));
+            });
+        }
+        finally {
+            ws.close();
+        }
+    }
+    /** Send a request and receive a stream of responses. */
+    async *sendStream(message, options) {
+        const ws = await this.connect(options.endpoint);
+        const timeout = options.timeout ?? this.config.timeout;
+        const queue = [];
+        let done = false;
+        let error = null;
+        let resolveWait = null;
+        const resetTimer = () => {
+            clearTimeout(timer);
+            timer = setTimeout(() => {
+                error = new Error('WebSocket stream timed out');
+                done = true;
+                resolveWait?.();
+            }, timeout);
+        };
+        let timer = setTimeout(() => {
+            error = new Error('WebSocket stream timed out');
+            done = true;
+            resolveWait?.();
+        }, timeout);
+        ws.on('message', (data) => {
+            resetTimer();
+            const msg = JSON.parse(data.toString());
+            queue.push(msg);
+            if (msg.type === 'response') {
+                done = true;
+            }
+            resolveWait?.();
+        });
+        ws.on('error', (err) => {
+            clearTimeout(timer);
+            error = err instanceof Error ? err : new Error(String(err));
+            done = true;
+            resolveWait?.();
+        });
+        ws.on('close', () => {
+            clearTimeout(timer);
+            done = true;
+            resolveWait?.();
+        });
+        ws.send(JSON.stringify(message));
+        try {
+            while (true) {
+                while (queue.length > 0) {
+                    yield queue.shift();
+                }
+                if (error)
+                    throw error;
+                if (done)
+                    break;
+                await new Promise((r) => { resolveWait = r; });
+                resolveWait = null;
+            }
+        }
+        finally {
+            clearTimeout(timer);
+            ws.close();
+        }
+    }
+    /** Start the WebSocket server and handle incoming messages. */
+    async listen(handler) {
+        this.handler = handler;
+        await this.ensureServer();
+    }
+    /** Register a stream handler for incoming requests. */
+    async listenStream(handler) {
+        this.streamHandler = handler;
+        await this.ensureServer();
+    }
+    /** Stop the WebSocket server. */
+    async close() {
+        if (this.heartbeatTimer) {
+            clearInterval(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+        if (this.wss) {
+            const wss = this.wss;
+            this.wss = null;
+            for (const client of wss.clients) {
+                client.close();
+            }
+            await new Promise((resolve) => wss.close(() => resolve()));
+        }
+        if (this.httpServer) {
+            const server = this.httpServer;
+            this.httpServer = null;
+            await new Promise((resolve, reject) => {
+                server.close((err) => (err ? reject(err) : resolve()));
+            });
+        }
+    }
+    /** The port the server is listening on (undefined if not started). */
+    get port() {
+        const addr = this.httpServer?.address();
+        if (addr && typeof addr === 'object')
+            return addr.port;
+        return undefined;
+    }
+    connect(endpoint) {
+        return new Promise((resolve, reject) => {
+            const ws = new WsWebSocket(endpoint);
+            ws.once('open', () => resolve(ws));
+            ws.once('error', reject);
+        });
+    }
+    async ensureServer() {
+        if (this.wss)
+            return;
+        this.httpServer = createServer();
+        this.wss = new WebSocketServer({ server: this.httpServer });
+        this.wss.on('connection', (ws) => {
+            ws.isAlive = true;
+            ws.on('pong', () => { ws.isAlive = true; });
+            ws.on('message', async (data) => {
+                try {
+                    const message = JSON.parse(data.toString());
+                    const isStreamRequest = message.method === 'message/stream' ||
+                        message.method === 'tasks/resubscribe';
+                    if (isStreamRequest && this.streamHandler) {
+                        for await (const event of this.streamHandler(message)) {
+                            ws.send(JSON.stringify(event));
+                        }
+                    }
+                    else if (this.handler) {
+                        const response = await this.handler(message);
+                        if (response) {
+                            ws.send(JSON.stringify(response));
+                        }
+                    }
+                }
+                catch (err) {
+                    this.config.logger?.('warn', 'Failed to process WebSocket message', err);
+                }
+            });
+        });
+        // Heartbeat
+        if (this.config.heartbeatInterval > 0) {
+            this.heartbeatTimer = setInterval(() => {
+                this.wss?.clients.forEach((ws) => {
+                    if (ws.isAlive === false) {
+                        ws.terminate();
+                        return;
+                    }
+                    ws.isAlive = false;
+                    ws.ping();
+                });
+            }, this.config.heartbeatInterval);
+        }
+        await new Promise((resolve) => {
+            this.httpServer.listen(this.config.port, this.config.host, () => resolve());
+        });
+    }
+}
+//# sourceMappingURL=WebSocketTransport.js.map

package/dist/transport/WebSocketTransport.js.map

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

package/dist/transport/index.d.ts

@@ -0,0 +1,7 @@
+export { HttpTransport } from './HttpTransport.js';
+export type { HttpTransportConfig } from './HttpTransport.js';
+export { WebSocketTransport } from './WebSocketTransport.js';
+export type { WebSocketTransportConfig } from './WebSocketTransport.js';
+export { NostrTransport, SNAP_MESSAGE_KIND, SNAP_AGENT_CARD_KIND } from './NostrTransport.js';
+export type { NostrTransportConfig, AgentDiscoveryFilter } from './NostrTransport.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AAExE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC9F,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/transport/index.js

@@ -0,0 +1,4 @@
+export { HttpTransport } from './HttpTransport.js';
+export { WebSocketTransport } from './WebSocketTransport.js';
+export { NostrTransport, SNAP_MESSAGE_KIND, SNAP_AGENT_CARD_KIND } from './NostrTransport.js';
+//# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/types/agent-card.d.ts

@@ -0,0 +1,53 @@
+import type { P2TRAddress } from './keys.js';
+import type { MediaType } from './part.js';
+/** A capability that the agent provides. */
+export interface Skill {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+    examples?: string[];
+    inputModes?: MediaType[];
+    outputModes?: MediaType[];
+}
+/** Optional feature flags for an agent. */
+export interface Capabilities {
+    streaming?: boolean;
+    pushNotifications?: boolean;
+}
+/** Domain verification for trust anchoring. */
+export interface Trust {
+    domain: string;
+}
+/** Organization operating the agent. */
+export interface Provider {
+    organization?: string;
+    url?: string;
+}
+/** Transport protocol type for an agent endpoint. */
+export type EndpointProtocol = 'http' | 'wss';
+/** A transport endpoint declared in the Agent Card. */
+export interface AgentEndpoint {
+    protocol: EndpointProtocol;
+    url: string;
+}
+/** Describes an agent's identity, capabilities, and how to communicate with it. */
+export interface AgentCard {
+    name: string;
+    description: string;
+    version: string;
+    identity: P2TRAddress;
+    endpoints?: AgentEndpoint[];
+    nostrRelays?: string[];
+    protocolVersion?: string;
+    supportedVersions?: string[];
+    capabilities?: Capabilities;
+    skills: Skill[];
+    defaultInputModes: MediaType[];
+    defaultOutputModes: MediaType[];
+    trust?: Trust;
+    provider?: Provider;
+    iconUrl?: string;
+    documentationUrl?: string;
+}
+//# sourceMappingURL=agent-card.d.ts.map

package/dist/types/agent-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-card.d.ts","sourceRoot":"","sources":["../../src/types/agent-card.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,4CAA4C;AAC5C,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,SAAS,EAAE,CAAC;CAC3B;AAED,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,+CAA+C;AAC/C,MAAM,WAAW,KAAK;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wCAAwC;AACxC,MAAM,WAAW,QAAQ;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qDAAqD;AACrD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,KAAK,CAAC;AAE9C,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,mFAAmF;AACnF,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,WAAW,CAAC;IACtB,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,iBAAiB,EAAE,SAAS,EAAE,CAAC;IAC/B,kBAAkB,EAAE,SAAS,EAAE,CAAC;IAChC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/types/agent-card.js

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

package/dist/types/agent-card.js.map

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

package/dist/types/artifact.d.ts

@@ -0,0 +1,8 @@
+import type { Part } from './part.js';
+/** Output produced by a task. Contains one or more parts. */
+export interface Artifact {
+    artifactId: string;
+    name?: string;
+    parts: Part[];
+}
+//# sourceMappingURL=artifact.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../src/types/artifact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,6DAA6D;AAC7D,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,IAAI,EAAE,CAAC;CACf"}

package/dist/types/artifact.js

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

package/dist/types/artifact.js.map

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

package/dist/types/errors.d.ts

@@ -0,0 +1,25 @@
+export interface SnapErrorData {
+    code: number;
+    message: string;
+    data?: Record<string, unknown>;
+}
+export declare const ErrorCodes: {
+    readonly TASK_NOT_FOUND: 1001;
+    readonly TASK_NOT_CANCELABLE: 1002;
+    readonly INVALID_MESSAGE: 1003;
+    readonly INVALID_PAYLOAD: 1004;
+    readonly CONTENT_TYPE_NOT_SUPPORTED: 1005;
+    readonly PUSH_NOTIFICATION_ERROR: 1006;
+    readonly METHOD_NOT_FOUND: 1007;
+    readonly SIGNATURE_INVALID: 2001;
+    readonly SIGNATURE_MISSING: 2002;
+    readonly IDENTITY_MISMATCH: 2003;
+    readonly TIMESTAMP_EXPIRED: 2004;
+    readonly IDENTITY_INVALID: 2005;
+    readonly DUPLICATE_MESSAGE: 2006;
+    readonly RATE_LIMIT_EXCEEDED: 3001;
+    readonly TRANSPORT_ERROR: 4001;
+    readonly INTERNAL_ERROR: 5001;
+};
+export type ErrorCode = (typeof ErrorCodes)[keyof typeof ErrorCodes];
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;CA0Bb,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC"}