@snap-protocol/core 0.1.0

package/dist/types/errors.js

@@ -0,0 +1,24 @@
+export const ErrorCodes = {
+    // 1xxx — Task / Message
+    TASK_NOT_FOUND: 1001,
+    TASK_NOT_CANCELABLE: 1002,
+    INVALID_MESSAGE: 1003,
+    INVALID_PAYLOAD: 1004,
+    CONTENT_TYPE_NOT_SUPPORTED: 1005,
+    PUSH_NOTIFICATION_ERROR: 1006,
+    METHOD_NOT_FOUND: 1007,
+    // 2xxx — Authentication
+    SIGNATURE_INVALID: 2001,
+    SIGNATURE_MISSING: 2002,
+    IDENTITY_MISMATCH: 2003,
+    TIMESTAMP_EXPIRED: 2004,
+    IDENTITY_INVALID: 2005,
+    DUPLICATE_MESSAGE: 2006,
+    // 3xxx — Rate limiting
+    RATE_LIMIT_EXCEEDED: 3001,
+    // 4xxx — Transport
+    TRANSPORT_ERROR: 4001,
+    // 5xxx — Internal
+    INTERNAL_ERROR: 5001,
+};
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,wBAAwB;IACxB,cAAc,EAAE,IAAI;IACpB,mBAAmB,EAAE,IAAI;IACzB,eAAe,EAAE,IAAI;IACrB,eAAe,EAAE,IAAI;IACrB,0BAA0B,EAAE,IAAI;IAChC,uBAAuB,EAAE,IAAI;IAC7B,gBAAgB,EAAE,IAAI;IAEtB,wBAAwB;IACxB,iBAAiB,EAAE,IAAI;IACvB,iBAAiB,EAAE,IAAI;IACvB,iBAAiB,EAAE,IAAI;IACvB,iBAAiB,EAAE,IAAI;IACvB,gBAAgB,EAAE,IAAI;IACtB,iBAAiB,EAAE,IAAI;IAEvB,uBAAuB;IACvB,mBAAmB,EAAE,IAAI;IAEzB,mBAAmB;IACnB,eAAe,EAAE,IAAI;IAErB,kBAAkB;IAClB,cAAc,EAAE,IAAI;CACZ,CAAC"}

package/dist/types/handler.d.ts

@@ -0,0 +1,38 @@
+import type { MessageSendRequest, MessageSendResponse, TasksGetRequest, TasksGetResponse, TasksCancelRequest, TasksCancelResponse } from './payloads.js';
+import type { SnapMessage } from './message.js';
+import type { TaskStore } from './plugin.js';
+/** Maps method names to their request/response payload types. */
+export interface MethodPayloadMap {
+    'message/send': {
+        request: MessageSendRequest;
+        response: MessageSendResponse;
+    };
+    'message/stream': {
+        request: MessageSendRequest;
+        response: MessageSendResponse;
+    };
+    'tasks/get': {
+        request: TasksGetRequest;
+        response: TasksGetResponse;
+    };
+    'tasks/cancel': {
+        request: TasksCancelRequest;
+        response: TasksCancelResponse;
+    };
+    'tasks/resubscribe': {
+        request: TasksGetRequest;
+        response: TasksGetResponse;
+    };
+}
+/** Context passed to every handler. */
+export interface HandlerContext {
+    /** The full inbound SNAP message (already validated). */
+    message: SnapMessage;
+    /** The task store, if configured. */
+    taskStore?: TaskStore;
+}
+/** Request-response handler for a specific method. */
+export type MethodHandler<M extends keyof MethodPayloadMap> = (payload: MethodPayloadMap[M]['request'], context: HandlerContext) => Promise<MethodPayloadMap[M]['response']> | MethodPayloadMap[M]['response'];
+/** Streaming handler — yields events and a final response. */
+export type StreamMethodHandler<M extends keyof MethodPayloadMap> = (payload: MethodPayloadMap[M]['request'], context: HandlerContext) => AsyncIterable<SnapMessage>;
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/types/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE;QAAE,OAAO,EAAE,kBAAkB,CAAC;QAAC,QAAQ,EAAE,mBAAmB,CAAA;KAAE,CAAC;IAC/E,gBAAgB,EAAE;QAAE,OAAO,EAAE,kBAAkB,CAAC;QAAC,QAAQ,EAAE,mBAAmB,CAAA;KAAE,CAAC;IACjF,WAAW,EAAE;QAAE,OAAO,EAAE,eAAe,CAAC;QAAC,QAAQ,EAAE,gBAAgB,CAAA;KAAE,CAAC;IACtE,cAAc,EAAE;QAAE,OAAO,EAAE,kBAAkB,CAAC;QAAC,QAAQ,EAAE,mBAAmB,CAAA;KAAE,CAAC;IAC/E,mBAAmB,EAAE;QAAE,OAAO,EAAE,eAAe,CAAC;QAAC,QAAQ,EAAE,gBAAgB,CAAA;KAAE,CAAC;CAC/E;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,yDAAyD;IACzD,OAAO,EAAE,WAAW,CAAC;IACrB,qCAAqC;IACrC,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,sDAAsD;AACtD,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,gBAAgB,IAAI,CAC5D,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EACvC,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;AAEhF,8DAA8D;AAC9D,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,gBAAgB,IAAI,CAClE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EACvC,OAAO,EAAE,cAAc,KACpB,aAAa,CAAC,WAAW,CAAC,CAAC"}

package/dist/types/handler.js

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

package/dist/types/handler.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,13 @@
+export type { Network, HexString, PublicKeyXOnly, PrivateKeyHex, P2TRAddress, KeyPair, } from './keys.js';
+export type { MessageType, MethodName, TaskState, SchnorrSignatureHex, UnsignedMessage, SnapMessage, SigningIntermediates, } from './message.js';
+export type { SnapErrorData, ErrorCode } from './errors.js';
+export { ErrorCodes } from './errors.js';
+export type { TransportLogger, TransportPlugin, TransportSendOptions, ReplayStore, TaskStore, Middleware, MiddlewareContext, NextFn, } from './plugin.js';
+export type { MediaType, TextPart, RawPart, UrlPart, DataPart, Part, } from './part.js';
+export type { Artifact } from './artifact.js';
+export type { MessageRole, TaskStatus, InnerMessage, Task, } from './task.js';
+export type { Skill, Capabilities, Trust, Provider, EndpointProtocol, AgentEndpoint, AgentCard, } from './agent-card.js';
+export type { MessageSendRequest, MessageSendResponse, TasksGetRequest, TasksGetResponse, TasksCancelRequest, TasksCancelResponse, } from './payloads.js';
+export type { MethodPayloadMap, HandlerContext, MethodHandler, StreamMethodHandler, } from './handler.js';
+export type { StreamTransportPlugin, TaskProgressEvent, TaskArtifactEvent, } from './transport.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,SAAS,EACT,cAAc,EACd,aAAa,EACb,WAAW,EACX,OAAO,GACR,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,WAAW,EACX,UAAU,EACV,SAAS,EACT,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,YAAY,EACV,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,WAAW,EACX,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,MAAM,GACP,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,SAAS,EACT,QAAQ,EACR,OAAO,EACP,OAAO,EACP,QAAQ,EACR,IAAI,GACL,MAAM,WAAW,CAAC;AAEnB,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,YAAY,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,IAAI,GACL,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,KAAK,EACL,YAAY,EACZ,KAAK,EACL,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,SAAS,GACV,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,gBAAgB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export { ErrorCodes } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/types/keys.d.ts

@@ -0,0 +1,15 @@
+export type Network = 'mainnet' | 'testnet';
+export type HexString = string;
+/** 64 hex characters representing a 32-byte x-only public key. */
+export type PublicKeyXOnly = HexString;
+/** 64 hex characters representing a 32-byte private key. */
+export type PrivateKeyHex = HexString;
+/** Bitcoin Pay-to-Taproot address (bc1p... or tb1p..., 62 characters). */
+export type P2TRAddress = string;
+export interface KeyPair {
+    privateKey: PrivateKeyHex;
+    publicKey: PublicKeyXOnly;
+    address: P2TRAddress;
+    network: Network;
+}
+//# sourceMappingURL=keys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/types/keys.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5C,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,kEAAkE;AAClE,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC;AAEvC,4DAA4D;AAC5D,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC;AAEtC,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,MAAM,WAAW,OAAO;IACtB,UAAU,EAAE,aAAa,CAAC;IAC1B,SAAS,EAAE,cAAc,CAAC;IAC1B,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/types/keys.js

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

package/dist/types/keys.js.map

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

package/dist/types/message.d.ts

@@ -0,0 +1,29 @@
+import type { P2TRAddress } from './keys.js';
+export type MessageType = 'request' | 'response' | 'event';
+export type MethodName = 'message/send' | 'message/stream' | 'tasks/get' | 'tasks/cancel' | 'tasks/resubscribe';
+export type TaskState = 'submitted' | 'working' | 'input_required' | 'completed' | 'failed' | 'canceled';
+/** 128 hex characters representing a 64-byte Schnorr signature. */
+export type SchnorrSignatureHex = string;
+/** Message without signature — the input to signing. */
+export interface UnsignedMessage {
+    id: string;
+    version: string;
+    from: P2TRAddress;
+    to: P2TRAddress;
+    type: MessageType;
+    method: MethodName;
+    payload: Record<string, unknown>;
+    timestamp: number;
+}
+/** Fully signed SNAP message. */
+export interface SnapMessage extends UnsignedMessage {
+    sig: SchnorrSignatureHex;
+}
+/** Intermediate signing artifacts for debugging. */
+export interface SigningIntermediates {
+    canonicalPayload: string;
+    signatureInput: string;
+    signatureInputHex: string;
+    sha256Hash: string;
+}
+//# sourceMappingURL=message.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/types/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;AAE3D,MAAM,MAAM,UAAU,GAClB,cAAc,GACd,gBAAgB,GAChB,WAAW,GACX,cAAc,GACd,mBAAmB,CAAC;AAExB,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,SAAS,GACT,gBAAgB,GAChB,WAAW,GACX,QAAQ,GACR,UAAU,CAAC;AAEf,mEAAmE;AACnE,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEzC,wDAAwD;AACxD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,WAAW,CAAC;IAChB,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iCAAiC;AACjC,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,GAAG,EAAE,mBAAmB,CAAC;CAC1B;AAED,oDAAoD;AACpD,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/message.js

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

package/dist/types/message.js.map

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

package/dist/types/part.d.ts

@@ -0,0 +1,25 @@
+/** Media type string (e.g. "text/plain", "application/json"). */
+export type MediaType = string;
+/** Part containing plain text or code content. */
+export interface TextPart {
+    text: string;
+    mediaType?: MediaType;
+}
+/** Part containing base64-encoded binary content. */
+export interface RawPart {
+    raw: string;
+    mediaType: MediaType;
+}
+/** Part referencing external content via URL. */
+export interface UrlPart {
+    url: string;
+    mediaType?: MediaType;
+}
+/** Part containing structured JSON data. */
+export interface DataPart {
+    data: Record<string, unknown>;
+    mediaType?: MediaType;
+}
+/** Content unit within messages and artifacts. Exactly one of text, raw, url, or data. */
+export type Part = TextPart | RawPart | UrlPart | DataPart;
+//# sourceMappingURL=part.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"part.d.ts","sourceRoot":"","sources":["../../src/types/part.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,kDAAkD;AAClD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,qDAAqD;AACrD,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,iDAAiD;AACjD,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,4CAA4C;AAC5C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,0FAA0F;AAC1F,MAAM,MAAM,IAAI,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC"}

package/dist/types/part.js

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

package/dist/types/part.js.map

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

package/dist/types/payloads.d.ts

@@ -0,0 +1,34 @@
+import type { InnerMessage } from './task.js';
+import type { Task } from './task.js';
+import type { SnapErrorData } from './errors.js';
+/** Payload for message/send requests. */
+export interface MessageSendRequest {
+    message: InnerMessage;
+    taskId?: string;
+    idempotencyKey?: string;
+}
+/** Payload for message/send responses. */
+export interface MessageSendResponse {
+    task?: Task;
+    error?: SnapErrorData;
+}
+/** Payload for tasks/get requests. */
+export interface TasksGetRequest {
+    taskId: string;
+    historyLength?: number;
+}
+/** Payload for tasks/get responses. */
+export interface TasksGetResponse {
+    task?: Task;
+    error?: SnapErrorData;
+}
+/** Payload for tasks/cancel requests. */
+export interface TasksCancelRequest {
+    taskId: string;
+}
+/** Payload for tasks/cancel responses. */
+export interface TasksCancelResponse {
+    task?: Task;
+    error?: SnapErrorData;
+}
+//# sourceMappingURL=payloads.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"payloads.d.ts","sourceRoot":"","sources":["../../src/types/payloads.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAID,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,uCAAuC;AACvC,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAID,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB"}

package/dist/types/payloads.js

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

package/dist/types/payloads.js.map

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

package/dist/types/plugin.d.ts

@@ -0,0 +1,33 @@
+import type { SnapMessage } from './message.js';
+import type { Task } from './task.js';
+/** Logger callback for transport-level diagnostic events. */
+export type TransportLogger = (level: 'debug' | 'warn' | 'error', message: string, data?: unknown) => void;
+export interface TransportSendOptions {
+    endpoint: string;
+    timeout?: number;
+}
+export interface TransportPlugin {
+    readonly name: string;
+    send(message: SnapMessage, options: TransportSendOptions): Promise<SnapMessage>;
+    listen?(handler: (message: SnapMessage) => Promise<SnapMessage | void>): Promise<void>;
+    close?(): Promise<void>;
+}
+export interface ReplayStore {
+    hasSeen(from: string, id: string): Promise<boolean>;
+    markSeen(from: string, id: string, timestamp: number): Promise<void>;
+}
+export interface TaskStore {
+    get(taskId: string): Promise<Task | undefined>;
+    set(taskId: string, task: Task): Promise<void>;
+    delete(taskId: string): Promise<void>;
+}
+export interface MiddlewareContext {
+    message: SnapMessage;
+    direction: 'inbound' | 'outbound';
+}
+export type NextFn = () => Promise<void>;
+export interface Middleware {
+    readonly name: string;
+    handle(ctx: MiddlewareContext, next: NextFn): Promise<void>;
+}
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/types/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAItC,6DAA6D;AAC7D,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;AAI3G,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAChF,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvF,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAID,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC;IAC/C,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAID,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,SAAS,GAAG,UAAU,CAAC;CACnC;AAED,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D"}

package/dist/types/plugin.js

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

package/dist/types/plugin.js.map

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

package/dist/types/task.d.ts

@@ -0,0 +1,26 @@
+import type { Part } from './part.js';
+import type { Artifact } from './artifact.js';
+import type { TaskState } from './message.js';
+/** Role of a message within a task conversation. */
+export type MessageRole = 'user' | 'agent';
+/** Current status of a task. */
+export interface TaskStatus {
+    state: TaskState;
+    timestamp: string;
+    message?: string;
+}
+/** A single communication turn within a task. */
+export interface InnerMessage {
+    messageId: string;
+    role: MessageRole;
+    parts: Part[];
+}
+/** A unit of work that may span multiple message turns. */
+export interface Task {
+    id: string;
+    contextId?: string;
+    status: TaskStatus;
+    artifacts?: Artifact[];
+    history?: InnerMessage[];
+}
+//# sourceMappingURL=task.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/types/task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,oDAAoD;AACpD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3C,gCAAgC;AAChC,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AAED,2DAA2D;AAC3D,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B"}

package/dist/types/task.js

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

package/dist/types/task.js.map

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

package/dist/types/transport.d.ts

@@ -0,0 +1,24 @@
+import type { SnapMessage } from './message.js';
+import type { TransportPlugin, TransportSendOptions } from './plugin.js';
+import type { Artifact } from './artifact.js';
+/** Extends TransportPlugin with streaming capability. */
+export interface StreamTransportPlugin extends TransportPlugin {
+    /** Send a request and receive a stream of responses (events + final response). */
+    sendStream(message: SnapMessage, options: TransportSendOptions): AsyncIterable<SnapMessage>;
+    /** Listen for incoming stream requests. Handler returns a stream of responses. */
+    listenStream?(handler: (message: SnapMessage) => AsyncIterable<SnapMessage>): Promise<void>;
+}
+/** Progress update during streaming. */
+export interface TaskProgressEvent {
+    taskId: string;
+    progress?: number;
+    message?: string;
+}
+/** Partial artifact during streaming. */
+export interface TaskArtifactEvent {
+    taskId: string;
+    artifact: Artifact & {
+        partial?: boolean;
+    };
+}
+//# sourceMappingURL=transport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/types/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,yDAAyD;AACzD,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,kFAAkF;IAClF,UAAU,CACR,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,oBAAoB,GAC5B,aAAa,CAAC,WAAW,CAAC,CAAC;IAE9B,kFAAkF;IAClF,YAAY,CAAC,CACX,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,aAAa,CAAC,WAAW,CAAC,GAC5D,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,wCAAwC;AACxC,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,GAAG;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC5C"}

package/dist/types/transport.js

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

package/dist/types/transport.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@snap-protocol/core",
+  "version": "0.1.0",
+  "description": "SNAP Protocol core library — key encoding, signing, verification, message construction",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@noble/curves": "^2.0.1",
+    "@noble/hashes": "^1.7.1",
+    "bech32": "^2.0.0",
+    "canonicalize": "^2.0.0",
+    "nostr-tools": "^2.23.0",
+    "ws": "^8.19.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.0",
+    "@types/ws": "^8.18.1",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">= 20.0.0"
+  },
+  "license": "MIT"
+}