@snap-protocol/core 0.1.0

package/dist/agent/AgentCardBuilder.d.ts

@@ -0,0 +1,26 @@
+import type { AgentCard, Skill, Capabilities, Trust, Provider, EndpointProtocol } from '../types/agent-card.js';
+import type { P2TRAddress } from '../types/keys.js';
+import type { MediaType } from '../types/part.js';
+/** Fluent builder for constructing an AgentCard. */
+export declare class AgentCardBuilder {
+    private readonly card;
+    name(name: string): this;
+    description(description: string): this;
+    version(version: string): this;
+    identity(address: P2TRAddress): this;
+    endpoint(protocol: EndpointProtocol, url: string): this;
+    nostrRelay(url: string): this;
+    protocolVersion(version: string): this;
+    supportedVersion(version: string): this;
+    capabilities(caps: Capabilities): this;
+    skill(skill: Skill): this;
+    defaultInputModes(modes: MediaType[]): this;
+    defaultOutputModes(modes: MediaType[]): this;
+    trust(trust: Trust): this;
+    provider(provider: Provider): this;
+    iconUrl(url: string): this;
+    documentationUrl(url: string): this;
+    /** Build the AgentCard, validating that all required fields are set. */
+    build(): AgentCard;
+}
+//# sourceMappingURL=AgentCardBuilder.d.ts.map

package/dist/agent/AgentCardBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentCardBuilder.d.ts","sourceRoot":"","sources":["../../src/agent/AgentCardBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,KAAK,EACL,YAAY,EACZ,KAAK,EACL,QAAQ,EACR,gBAAgB,EAEjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,oDAAoD;AACpD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;IAE/C,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKtC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK9B,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAKpC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAMvD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAM7B,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKtC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMvC,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAKtC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAMzB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI;IAK3C,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI;IAK5C,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAKzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAKlC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK1B,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKnC,wEAAwE;IACxE,KAAK,IAAI,SAAS;CAkBnB"}

package/dist/agent/AgentCardBuilder.js

@@ -0,0 +1,99 @@
+/** Fluent builder for constructing an AgentCard. */
+export class AgentCardBuilder {
+    card = {};
+    name(name) {
+        this.card.name = name;
+        return this;
+    }
+    description(description) {
+        this.card.description = description;
+        return this;
+    }
+    version(version) {
+        this.card.version = version;
+        return this;
+    }
+    identity(address) {
+        this.card.identity = address;
+        return this;
+    }
+    endpoint(protocol, url) {
+        if (!this.card.endpoints)
+            this.card.endpoints = [];
+        this.card.endpoints.push({ protocol, url });
+        return this;
+    }
+    nostrRelay(url) {
+        if (!this.card.nostrRelays)
+            this.card.nostrRelays = [];
+        this.card.nostrRelays.push(url);
+        return this;
+    }
+    protocolVersion(version) {
+        this.card.protocolVersion = version;
+        return this;
+    }
+    supportedVersion(version) {
+        if (!this.card.supportedVersions)
+            this.card.supportedVersions = [];
+        this.card.supportedVersions.push(version);
+        return this;
+    }
+    capabilities(caps) {
+        this.card.capabilities = caps;
+        return this;
+    }
+    skill(skill) {
+        if (!this.card.skills)
+            this.card.skills = [];
+        this.card.skills.push(skill);
+        return this;
+    }
+    defaultInputModes(modes) {
+        this.card.defaultInputModes = modes;
+        return this;
+    }
+    defaultOutputModes(modes) {
+        this.card.defaultOutputModes = modes;
+        return this;
+    }
+    trust(trust) {
+        this.card.trust = trust;
+        return this;
+    }
+    provider(provider) {
+        this.card.provider = provider;
+        return this;
+    }
+    iconUrl(url) {
+        this.card.iconUrl = url;
+        return this;
+    }
+    documentationUrl(url) {
+        this.card.documentationUrl = url;
+        return this;
+    }
+    /** Build the AgentCard, validating that all required fields are set. */
+    build() {
+        const missing = [];
+        if (!this.card.name)
+            missing.push('name');
+        if (!this.card.description)
+            missing.push('description');
+        if (!this.card.version)
+            missing.push('version');
+        if (!this.card.identity)
+            missing.push('identity');
+        if (!this.card.skills || this.card.skills.length === 0)
+            missing.push('skills');
+        if (!this.card.defaultInputModes || this.card.defaultInputModes.length === 0)
+            missing.push('defaultInputModes');
+        if (!this.card.defaultOutputModes || this.card.defaultOutputModes.length === 0)
+            missing.push('defaultOutputModes');
+        if (missing.length > 0) {
+            throw new Error(`AgentCard missing required fields: ${missing.join(', ')}`);
+        }
+        return { ...this.card };
+    }
+}
+//# sourceMappingURL=AgentCardBuilder.js.map

package/dist/agent/AgentCardBuilder.js.map

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

package/dist/agent/SnapAgent.d.ts

@@ -0,0 +1,61 @@
+import type { P2TRAddress, PrivateKeyHex, Network } from '../types/keys.js';
+import type { SnapMessage, MethodName } from '../types/message.js';
+import type { TransportPlugin, TransportSendOptions, ReplayStore, TaskStore, Middleware } from '../types/plugin.js';
+import type { AgentCard } from '../types/agent-card.js';
+import type { MethodPayloadMap, MethodHandler, StreamMethodHandler } from '../types/handler.js';
+import type { MessageSendResponse, TasksGetResponse, TasksCancelResponse } from '../types/payloads.js';
+import type { InnerMessage } from '../types/task.js';
+export interface SnapAgentConfig {
+    privateKey: PrivateKeyHex;
+    card: AgentCard;
+    network?: Network;
+}
+/** Unified agent peer — sends, receives, and streams SNAP messages. */
+export declare class SnapAgent {
+    readonly address: P2TRAddress;
+    readonly card: AgentCard;
+    private readonly signer;
+    private readonly privateKey;
+    private readonly transports;
+    private readonly middlewares;
+    private readonly handlers;
+    private readonly streamHandlers;
+    private _replayStore?;
+    private _taskStore?;
+    constructor(config: SnapAgentConfig);
+    /** Register a request-response handler for a method. */
+    handle<M extends keyof MethodPayloadMap>(method: M, handler: MethodHandler<M>): this;
+    /** Register a streaming handler for a method. */
+    handleStream<M extends keyof MethodPayloadMap>(method: M, handler: StreamMethodHandler<M>): this;
+    /** Add a transport plugin. */
+    transport(plugin: TransportPlugin): this;
+    /** Add a middleware. */
+    use(middleware: Middleware): this;
+    /** Set the replay store. */
+    replayStore(store: ReplayStore): this;
+    /** Set the task store. */
+    taskStore(store: TaskStore): this;
+    /** Start listening on all transports. */
+    start(): Promise<void>;
+    /** Stop all transports. */
+    stop(): Promise<void>;
+    /** Process an inbound message and return a response. */
+    processMessage(inbound: SnapMessage): Promise<SnapMessage>;
+    /** Process an inbound streaming request. */
+    processStream(inbound: SnapMessage): AsyncIterable<SnapMessage>;
+    /** Send a message to another agent via the first available transport. */
+    send<P extends Record<string, unknown> = Record<string, unknown>>(to: P2TRAddress, endpoint: string, method: MethodName, payload: P, options?: Partial<TransportSendOptions>): Promise<SnapMessage>;
+    /** Send a streaming request to another agent. */
+    sendStream<P extends Record<string, unknown> = Record<string, unknown>>(to: P2TRAddress, endpoint: string, method: MethodName, payload: P, options?: Partial<TransportSendOptions>): AsyncIterable<SnapMessage>;
+    /** Send a message/send request. */
+    sendMessage(to: P2TRAddress, endpoint: string, message: InnerMessage, options?: Partial<TransportSendOptions>): Promise<MessageSendResponse>;
+    /** Stream a message/stream request. */
+    streamMessage(to: P2TRAddress, endpoint: string, message: InnerMessage, options?: Partial<TransportSendOptions>): AsyncIterable<SnapMessage>;
+    /** Get a task by ID. */
+    getTask(to: P2TRAddress, endpoint: string, taskId: string, options?: Partial<TransportSendOptions>): Promise<TasksGetResponse>;
+    /** Cancel a task. */
+    cancelTask(to: P2TRAddress, endpoint: string, taskId: string, options?: Partial<TransportSendOptions>): Promise<TasksCancelResponse>;
+    private buildMessage;
+    private runMiddleware;
+}
+//# sourceMappingURL=SnapAgent.d.ts.map

package/dist/agent/SnapAgent.d.ts.map

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

package/dist/agent/SnapAgent.js

@@ -0,0 +1,245 @@
+import { randomUUID } from 'node:crypto';
+import { MessageBuilder } from '../messaging/MessageBuilder.js';
+import { MessageSigner } from '../messaging/MessageSigner.js';
+import { MessageValidator } from '../messaging/MessageValidator.js';
+import { SnapError } from '../errors/SnapError.js';
+/** Unified agent peer — sends, receives, and streams SNAP messages. */
+export class SnapAgent {
+    address;
+    card;
+    signer;
+    privateKey;
+    transports = [];
+    middlewares = [];
+    handlers = new Map();
+    streamHandlers = new Map();
+    _replayStore;
+    _taskStore;
+    constructor(config) {
+        this.privateKey = config.privateKey;
+        this.signer = new MessageSigner(config.privateKey);
+        this.address = this.signer.getAddress(config.network ?? 'mainnet');
+        this.card = { ...config.card, identity: this.address };
+    }
+    /** Register a request-response handler for a method. */
+    handle(method, handler) {
+        this.handlers.set(method, handler);
+        return this;
+    }
+    /** Register a streaming handler for a method. */
+    handleStream(method, handler) {
+        this.streamHandlers.set(method, handler);
+        return this;
+    }
+    /** Add a transport plugin. */
+    transport(plugin) {
+        this.transports.push(plugin);
+        return this;
+    }
+    /** Add a middleware. */
+    use(middleware) {
+        this.middlewares.push(middleware);
+        return this;
+    }
+    /** Set the replay store. */
+    replayStore(store) {
+        this._replayStore = store;
+        return this;
+    }
+    /** Set the task store. */
+    taskStore(store) {
+        this._taskStore = store;
+        return this;
+    }
+    /** Start listening on all transports. */
+    async start() {
+        for (const tp of this.transports) {
+            if (tp.listen) {
+                await tp.listen((msg) => this.processMessage(msg));
+            }
+            const streamTp = tp;
+            if (typeof streamTp.listenStream === 'function') {
+                await streamTp.listenStream((msg) => this.processStream(msg));
+            }
+        }
+    }
+    /** Stop all transports. */
+    async stop() {
+        for (const tp of this.transports) {
+            if (tp.close) {
+                await tp.close();
+            }
+        }
+    }
+    /** Process an inbound message and return a response. */
+    async processMessage(inbound) {
+        // 1. Validate structure and signature
+        MessageValidator.validate(inbound);
+        // 2. Check destination
+        if (inbound.to !== this.address) {
+            throw SnapError.invalidMessage(`Message not addressed to this agent: ${inbound.to}`);
+        }
+        // 3. Replay check
+        if (this._replayStore) {
+            const seen = await this._replayStore.hasSeen(inbound.from, inbound.id);
+            if (seen) {
+                throw SnapError.duplicateMessage(inbound.id, inbound.from);
+            }
+            await this._replayStore.markSeen(inbound.from, inbound.id, inbound.timestamp);
+        }
+        // 4. Inbound middleware
+        await this.runMiddleware({ message: inbound, direction: 'inbound' });
+        // 5. Route to handler
+        const handler = this.handlers.get(inbound.method);
+        if (!handler) {
+            throw SnapError.invalidMessage(`No handler registered for method: ${inbound.method}`);
+        }
+        const context = {
+            message: inbound,
+            taskStore: this._taskStore,
+        };
+        const responsePayload = await handler(inbound.payload, context);
+        // 6. Build and sign response
+        const unsigned = this.buildMessage({
+            to: inbound.from,
+            type: 'response',
+            method: inbound.method,
+            payload: responsePayload,
+        });
+        const response = this.signer.sign(unsigned);
+        // 7. Outbound middleware
+        await this.runMiddleware({ message: response, direction: 'outbound' });
+        return response;
+    }
+    /** Process an inbound streaming request. */
+    async *processStream(inbound) {
+        // 1. Validate
+        MessageValidator.validate(inbound);
+        // 2. Check destination
+        if (inbound.to !== this.address) {
+            throw SnapError.invalidMessage(`Message not addressed to this agent: ${inbound.to}`);
+        }
+        // 3. Replay check
+        if (this._replayStore) {
+            const seen = await this._replayStore.hasSeen(inbound.from, inbound.id);
+            if (seen) {
+                throw SnapError.duplicateMessage(inbound.id, inbound.from);
+            }
+            await this._replayStore.markSeen(inbound.from, inbound.id, inbound.timestamp);
+        }
+        // 4. Inbound middleware
+        await this.runMiddleware({ message: inbound, direction: 'inbound' });
+        // 5. Route to stream handler
+        const handler = this.streamHandlers.get(inbound.method);
+        if (!handler) {
+            throw SnapError.invalidMessage(`No stream handler registered for method: ${inbound.method}`);
+        }
+        const context = {
+            message: inbound,
+            taskStore: this._taskStore,
+        };
+        // 6. Yield each event signed
+        for await (const event of handler(inbound.payload, context)) {
+            // Events from handler are already SnapMessages (or we wrap them)
+            if (event.sig) {
+                yield event;
+            }
+            else {
+                // Sign event messages
+                const unsigned = this.buildMessage({
+                    to: inbound.from,
+                    type: event.type ?? 'event',
+                    method: event.method ?? inbound.method,
+                    payload: event.payload ?? {},
+                });
+                yield this.signer.sign(unsigned);
+            }
+        }
+    }
+    // --- Outbound methods ---
+    /** Send a message to another agent via the first available transport. */
+    async send(to, endpoint, method, payload, options) {
+        const unsigned = this.buildMessage({ to, type: 'request', method, payload: payload });
+        const signed = this.signer.sign(unsigned);
+        await this.runMiddleware({ message: signed, direction: 'outbound' });
+        const sendOptions = {
+            endpoint,
+            ...options,
+        };
+        // Try transports in order
+        let lastError;
+        for (const tp of this.transports) {
+            try {
+                const response = await tp.send(signed, sendOptions);
+                return response;
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+            }
+        }
+        throw lastError ?? new Error('No transports configured');
+    }
+    /** Send a streaming request to another agent. */
+    async *sendStream(to, endpoint, method, payload, options) {
+        const unsigned = this.buildMessage({ to, type: 'request', method, payload: payload });
+        const signed = this.signer.sign(unsigned);
+        await this.runMiddleware({ message: signed, direction: 'outbound' });
+        const sendOptions = {
+            endpoint,
+            ...options,
+        };
+        // Find a streaming transport
+        for (const tp of this.transports) {
+            const streamTp = tp;
+            if (typeof streamTp.sendStream === 'function') {
+                yield* streamTp.sendStream(signed, sendOptions);
+                return;
+            }
+        }
+        throw new Error('No streaming transport configured');
+    }
+    // --- Convenience methods ---
+    /** Send a message/send request. */
+    async sendMessage(to, endpoint, message, options) {
+        const response = await this.send(to, endpoint, 'message/send', { message }, options);
+        return response.payload;
+    }
+    /** Stream a message/stream request. */
+    async *streamMessage(to, endpoint, message, options) {
+        yield* this.sendStream(to, endpoint, 'message/stream', { message }, options);
+    }
+    /** Get a task by ID. */
+    async getTask(to, endpoint, taskId, options) {
+        const response = await this.send(to, endpoint, 'tasks/get', { taskId }, options);
+        return response.payload;
+    }
+    /** Cancel a task. */
+    async cancelTask(to, endpoint, taskId, options) {
+        const response = await this.send(to, endpoint, 'tasks/cancel', { taskId }, options);
+        return response.payload;
+    }
+    // --- Private helpers ---
+    buildMessage(opts) {
+        return new MessageBuilder()
+            .id(randomUUID())
+            .from(this.address)
+            .to(opts.to)
+            .type(opts.type)
+            .method(opts.method)
+            .payload(opts.payload)
+            .timestamp(Math.floor(Date.now() / 1000))
+            .build();
+    }
+    async runMiddleware(ctx) {
+        const stack = [...this.middlewares];
+        let index = 0;
+        const next = async () => {
+            if (index < stack.length) {
+                const mw = stack[index++];
+                await mw.handle(ctx, next);
+            }
+        };
+        await next();
+    }
+}
+//# sourceMappingURL=SnapAgent.js.map

package/dist/agent/SnapAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapAgent.js","sourceRoot":"","sources":["../../src/agent/SnapAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AASzC,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AASnD,uEAAuE;AACvE,MAAM,OAAO,SAAS;IACX,OAAO,CAAc;IACrB,IAAI,CAAY;IAER,MAAM,CAAgB;IACtB,UAAU,CAAgB;IAC1B,UAAU,GAAsB,EAAE,CAAC;IACnC,WAAW,GAAiB,EAAE,CAAC;IAC/B,QAAQ,GAAG,IAAI,GAAG,EAA8B,CAAC;IACjD,cAAc,GAAG,IAAI,GAAG,EAAoC,CAAC;IACtE,YAAY,CAAe;IAC3B,UAAU,CAAa;IAE/B,YAAY,MAAuB;QACjC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACnD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,IAAI,SAAS,CAAC,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,EAAE,GAAG,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IACzD,CAAC;IAED,wDAAwD;IACxD,MAAM,CACJ,MAAS,EACT,OAAyB;QAEzB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iDAAiD;IACjD,YAAY,CACV,MAAS,EACT,OAA+B;QAE/B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8BAA8B;IAC9B,SAAS,CAAC,MAAuB;QAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wBAAwB;IACxB,GAAG,CAAC,UAAsB;QACxB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4BAA4B;IAC5B,WAAW,CAAC,KAAkB;QAC5B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0BAA0B;IAC1B,SAAS,CAAC,KAAgB;QACxB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yCAAyC;IACzC,KAAK,CAAC,KAAK;QACT,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACjC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;gBACd,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC;YACrD,CAAC;YAED,MAAM,QAAQ,GAAG,EAA2B,CAAC;YAC7C,IAAI,OAAO,QAAQ,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;gBAChD,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,KAAK,CAAC,IAAI;QACR,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACjC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;gBACb,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;YACnB,CAAC;QACH,CAAC;IACH,CAAC;IAED,wDAAwD;IACxD,KAAK,CAAC,cAAc,CAAC,OAAoB;QACvC,sCAAsC;QACtC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAEnC,uBAAuB;QACvB,IAAI,OAAO,CAAC,EAAE,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAChC,MAAM,SAAS,CAAC,cAAc,CAAC,wCAAwC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QACvF,CAAC;QAED,kBAAkB;QAClB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YACvE,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,SAAS,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7D,CAAC;YACD,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAChF,CAAC;QAED,wBAAwB;QACxB,MAAM,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;QAErE,sBAAsB;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,SAAS,CAAC,cAAc,CAAC,qCAAqC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,OAAO,GAAmB;YAC9B,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,IAAI,CAAC,UAAU;SAC3B,CAAC;QAEF,MAAM,eAAe,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAEhE,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC;YACjC,EAAE,EAAE,OAAO,CAAC,IAAI;YAChB,IAAI,EAAE,UAAU;YAChB,MAAM,EAAE,OAAO,CAAC,MAAoB;YACpC,OAAO,EAAE,eAA0C;SACpD,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE5C,yBAAyB;QACzB,MAAM,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;QAEvE,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,4CAA4C;IAC5C,KAAK,CAAC,CAAC,aAAa,CAAC,OAAoB;QACvC,cAAc;QACd,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAEnC,uBAAuB;QACvB,IAAI,OAAO,CAAC,EAAE,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;YAChC,MAAM,SAAS,CAAC,cAAc,CAAC,wCAAwC,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QACvF,CAAC;QAED,kBAAkB;QAClB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;YACvE,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,SAAS,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;YAC7D,CAAC;YACD,MAAM,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAChF,CAAC;QAED,wBAAwB;QACxB,MAAM,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC;QAErE,6BAA6B;QAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,SAAS,CAAC,cAAc,CAAC,4CAA4C,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/F,CAAC;QAED,MAAM,OAAO,GAAmB;YAC9B,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE,IAAI,CAAC,UAAU;SAC3B,CAAC;QAEF,6BAA6B;QAC7B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;YAC5D,iEAAiE;YACjE,IAAI,KAAK,CAAC,GAAG,EAAE,CAAC;gBACd,MAAM,KAAK,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,sBAAsB;gBACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC;oBACjC,EAAE,EAAE,OAAO,CAAC,IAAI;oBAChB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,OAAO;oBAC3B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAK,OAAO,CAAC,MAAqB;oBACtD,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,EAAE;iBAC7B,CAAC,CAAC;gBACH,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;IACH,CAAC;IAED,2BAA2B;IAE3B,yEAAyE;IACzE,KAAK,CAAC,IAAI,CACR,EAAe,EACf,QAAgB,EAChB,MAAkB,EAClB,OAAU,EACV,OAAuC;QAEvC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAkC,EAAE,CAAC,CAAC;QACjH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE1C,MAAM,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;QAErE,MAAM,WAAW,GAAyB;YACxC,QAAQ;YACR,GAAG,OAAO;SACX,CAAC;QAEF,0BAA0B;QAC1B,IAAI,SAA4B,CAAC;QACjC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;gBACpD,OAAO,QAAQ,CAAC;YAClB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAED,MAAM,SAAS,IAAI,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC3D,CAAC;IAED,iDAAiD;IACjD,KAAK,CAAC,CAAC,UAAU,CACf,EAAe,EACf,QAAgB,EAChB,MAAkB,EAClB,OAAU,EACV,OAAuC;QAEvC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAkC,EAAE,CAAC,CAAC;QACjH,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE1C,MAAM,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC,CAAC;QAErE,MAAM,WAAW,GAAyB;YACxC,QAAQ;YACR,GAAG,OAAO;SACX,CAAC;QAEF,6BAA6B;QAC7B,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,EAA2B,CAAC;YAC7C,IAAI,OAAO,QAAQ,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBAC9C,KAAK,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;gBAChD,OAAO;YACT,CAAC;QACH,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,8BAA8B;IAE9B,mCAAmC;IACnC,KAAK,CAAC,WAAW,CACf,EAAe,EACf,QAAgB,EAChB,OAAqB,EACrB,OAAuC;QAEvC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACrF,OAAO,QAAQ,CAAC,OAA8B,CAAC;IACjD,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,CAAC,aAAa,CAClB,EAAe,EACf,QAAgB,EAChB,OAAqB,EACrB,OAAuC;QAEvC,KAAK,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED,wBAAwB;IACxB,KAAK,CAAC,OAAO,CACX,EAAe,EACf,QAAgB,EAChB,MAAc,EACd,OAAuC;QAEvC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QACjF,OAAO,QAAQ,CAAC,OAA2B,CAAC;IAC9C,CAAC;IAED,qBAAqB;IACrB,KAAK,CAAC,UAAU,CACd,EAAe,EACf,QAAgB,EAChB,MAAc,EACd,OAAuC;QAEvC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QACpF,OAAO,QAAQ,CAAC,OAA8B,CAAC;IACjD,CAAC;IAED,0BAA0B;IAElB,YAAY,CAAC,IAKpB;QACC,OAAO,IAAI,cAAc,EAAE;aACxB,EAAE,CAAC,UAAU,EAAE,CAAC;aAChB,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;aAClB,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;aACX,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;aACf,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;aACnB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;aACrB,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;aACxC,KAAK,EAAE,CAAC;IACb,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,GAAsB;QAChD,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;QACpC,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,MAAM,IAAI,GAAW,KAAK,IAAI,EAAE;YAC9B,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBACzB,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;gBAC1B,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC;QAEF,MAAM,IAAI,EAAE,CAAC;IACf,CAAC;CACF"}

package/dist/agent/index.d.ts

@@ -0,0 +1,4 @@
+export { AgentCardBuilder } from './AgentCardBuilder.js';
+export { SnapAgent } from './SnapAgent.js';
+export type { SnapAgentConfig } from './SnapAgent.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/agent/index.js

@@ -0,0 +1,3 @@
+export { AgentCardBuilder } from './AgentCardBuilder.js';
+export { SnapAgent } from './SnapAgent.js';
+//# sourceMappingURL=index.js.map

package/dist/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/crypto/Canonicalizer.d.ts

@@ -0,0 +1,9 @@
+export declare class Canonicalizer {
+    /**
+     * Canonicalize a JSON-serializable object per RFC 8785 (JCS).
+     * Returns the canonical JSON string.
+     * @throws if input cannot be serialized.
+     */
+    static canonicalize(obj: unknown): string;
+}
+//# sourceMappingURL=Canonicalizer.d.ts.map

package/dist/crypto/Canonicalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Canonicalizer.d.ts","sourceRoot":"","sources":["../../src/crypto/Canonicalizer.ts"],"names":[],"mappings":"AAKA,qBAAa,aAAa;IACxB;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM;CAO1C"}

package/dist/crypto/Canonicalizer.js

@@ -0,0 +1,18 @@
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const canonicalizeFn = require('canonicalize');
+export class Canonicalizer {
+    /**
+     * Canonicalize a JSON-serializable object per RFC 8785 (JCS).
+     * Returns the canonical JSON string.
+     * @throws if input cannot be serialized.
+     */
+    static canonicalize(obj) {
+        const result = canonicalizeFn(obj);
+        if (result === undefined) {
+            throw new Error('Cannot canonicalize input: result is undefined');
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=Canonicalizer.js.map

package/dist/crypto/Canonicalizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Canonicalizer.js","sourceRoot":"","sources":["../../src/crypto/Canonicalizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,CAA2C,CAAC;AAEzF,MAAM,OAAO,aAAa;IACxB;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,GAAY;QAC9B,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/crypto/KeyManager.d.ts

@@ -0,0 +1,31 @@
+import type { Network, P2TRAddress, PublicKeyXOnly, PrivateKeyHex, KeyPair } from '../types/keys.js';
+export declare class KeyManager {
+    /**
+     * Derive x-only public key from a private key.
+     * @returns 64-char lowercase hex string.
+     */
+    static getPublicKey(privateKey: PrivateKeyHex): PublicKeyXOnly;
+    /**
+     * Encode an x-only public key as a P2TR bech32m address.
+     * Uses witness version 1.
+     */
+    static publicKeyToP2TR(publicKey: PublicKeyXOnly, network?: Network): P2TRAddress;
+    /**
+     * Decode a P2TR address to its x-only public key hex.
+     * Validates bech32m checksum and witness version.
+     */
+    static p2trToPublicKey(address: P2TRAddress): PublicKeyXOnly;
+    /**
+     * Detect network from a P2TR address prefix.
+     */
+    static detectNetwork(address: P2TRAddress): Network;
+    /**
+     * Validate that a P2TR address is well-formed.
+     */
+    static validateP2TR(address: P2TRAddress): boolean;
+    /**
+     * Derive a full KeyPair from a private key.
+     */
+    static deriveKeyPair(privateKey: PrivateKeyHex, network?: Network): KeyPair;
+}
+//# sourceMappingURL=KeyManager.d.ts.map

package/dist/crypto/KeyManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyManager.d.ts","sourceRoot":"","sources":["../../src/crypto/KeyManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAOrG,qBAAa,UAAU;IACrB;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,aAAa,GAAG,cAAc;IAK9D;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,GAAE,OAAmB,GAAG,WAAW;IAM5F;;;OAGG;IACH,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc;IAa5D;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IAMnD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO;IAYlD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,GAAE,OAAmB,GAAG,OAAO;CAKvF"}

package/dist/crypto/KeyManager.js

@@ -0,0 +1,79 @@
+import { schnorr } from '@noble/curves/secp256k1.js';
+import { bytesToHex, hexToBytes } from '@noble/hashes/utils';
+import { bech32m } from 'bech32';
+const PREFIXES = {
+    mainnet: 'bc',
+    testnet: 'tb',
+};
+export class KeyManager {
+    /**
+     * Derive x-only public key from a private key.
+     * @returns 64-char lowercase hex string.
+     */
+    static getPublicKey(privateKey) {
+        const pubBytes = schnorr.getPublicKey(hexToBytes(privateKey));
+        return bytesToHex(pubBytes);
+    }
+    /**
+     * Encode an x-only public key as a P2TR bech32m address.
+     * Uses witness version 1.
+     */
+    static publicKeyToP2TR(publicKey, network = 'mainnet') {
+        const pubBytes = typeof publicKey === 'string' ? hexToBytes(publicKey) : publicKey;
+        const words = bech32m.toWords(pubBytes);
+        return bech32m.encode(PREFIXES[network], [1, ...words]);
+    }
+    /**
+     * Decode a P2TR address to its x-only public key hex.
+     * Validates bech32m checksum and witness version.
+     */
+    static p2trToPublicKey(address) {
+        const { prefix, words } = bech32m.decode(address);
+        if (prefix !== 'bc' && prefix !== 'tb') {
+            throw new Error(`Invalid P2TR prefix: ${prefix}`);
+        }
+        const witnessVersion = words[0];
+        if (witnessVersion !== 1) {
+            throw new Error(`Invalid witness version: ${witnessVersion}, expected 1`);
+        }
+        const pubBytes = bech32m.fromWords(words.slice(1));
+        return bytesToHex(new Uint8Array(pubBytes));
+    }
+    /**
+     * Detect network from a P2TR address prefix.
+     */
+    static detectNetwork(address) {
+        if (address.startsWith('bc1p'))
+            return 'mainnet';
+        if (address.startsWith('tb1p'))
+            return 'testnet';
+        throw new Error(`Cannot detect network from address: ${address}`);
+    }
+    /**
+     * Validate that a P2TR address is well-formed.
+     */
+    static validateP2TR(address) {
+        try {
+            if (address.length !== 62)
+                return false;
+            if (!address.startsWith('bc1p') && !address.startsWith('tb1p'))
+                return false;
+            const { words } = bech32m.decode(address);
+            if (words[0] !== 1)
+                return false;
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Derive a full KeyPair from a private key.
+     */
+    static deriveKeyPair(privateKey, network = 'mainnet') {
+        const publicKey = KeyManager.getPublicKey(privateKey);
+        const address = KeyManager.publicKeyToP2TR(publicKey, network);
+        return { privateKey, publicKey, address, network };
+    }
+}
+//# sourceMappingURL=KeyManager.js.map

package/dist/crypto/KeyManager.js.map

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