@claw-network/sdk 0.2.3 → 0.4.0

package/dist/index.d.ts

@@ -22,6 +22,8 @@ export { ReputationApi } from './reputation.js';
 export { MarketsApi, InfoMarketApi, TaskMarketApi, CapabilityMarketApi, MarketDisputeApi } from './markets.js';
 export { ContractsApi } from './contracts.js';
 export { DaoApi } from './dao.js';
+export { MessagingApi, RECEIPT_TOPIC } from './messaging.js';
+export type { SendMessageParams, SendMessageResult, SendBatchParams, SendBatchResult, InboxMessage, InboxQueryParams, InboxResponse, } from './messaging.js';
 export * from './types.js';
 import { HttpClient, type HttpClientConfig } from './http.js';
 import { NodeApi } from './node.js';
@@ -31,6 +33,7 @@ import { ReputationApi } from './reputation.js';
 import { MarketsApi } from './markets.js';
 import { ContractsApi } from './contracts.js';
 import { DaoApi } from './dao.js';
+import { MessagingApi } from './messaging.js';
 /** Configuration for the top-level client. */
 export type ClientConfig = HttpClientConfig;
 /**
@@ -49,6 +52,7 @@ export declare class ClawNetClient {
     readonly markets: MarketsApi;
     readonly contracts: ContractsApi;
     readonly dao: DaoApi;
+    readonly messaging: MessagingApi;
     constructor(config?: Partial<ClientConfig>);
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC/G,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAI5C;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBAET,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;CAa3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC/G,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC7D,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,8CAA8C;AAC9C,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAI5C;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;gBAErB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;CAc3C"}

package/dist/index.js

@@ -23,6 +23,7 @@ export { ReputationApi } from './reputation.js';
 export { MarketsApi, InfoMarketApi, TaskMarketApi, CapabilityMarketApi, MarketDisputeApi } from './markets.js';
 export { ContractsApi } from './contracts.js';
 export { DaoApi } from './dao.js';
+export { MessagingApi, RECEIPT_TOPIC } from './messaging.js';
 // ── Shared types ─────────────────────────────────────────────────────────
 export * from './types.js';
 import { HttpClient } from './http.js';
@@ -33,6 +34,7 @@ import { ReputationApi } from './reputation.js';
 import { MarketsApi } from './markets.js';
 import { ContractsApi } from './contracts.js';
 import { DaoApi } from './dao.js';
+import { MessagingApi } from './messaging.js';
 const DEFAULT_BASE_URL = 'http://127.0.0.1:9528';
 /**
  * Top-level client that exposes all ClawNet APIs via REST.
@@ -50,6 +52,7 @@ export class ClawNetClient {
     markets;
     contracts;
     dao;
+    messaging;
     constructor(config) {
         this.http = new HttpClient({
             baseUrl: config?.baseUrl ?? DEFAULT_BASE_URL,
@@ -62,6 +65,7 @@ export class ClawNetClient {
         this.markets = new MarketsApi(this.http);
         this.contracts = new ContractsApi(this.http);
         this.dao = new DaoApi(this.http);
+        this.messaging = new MessagingApi(this.http);
     }
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,4EAA4E;AAC5E,OAAO,EAAE,UAAU,EAAoC,YAAY,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC/G,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,4EAA4E;AAC5E,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAyB,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAKlC,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IACf,IAAI,CAAa;IACjB,IAAI,CAAU;IACd,QAAQ,CAAc;IACtB,MAAM,CAAY;IAClB,UAAU,CAAgB;IAC1B,OAAO,CAAa;IACpB,SAAS,CAAe;IACxB,GAAG,CAAS;IAErB,YAAY,MAA8B;QACxC,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC;YACzB,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,gBAAgB;YAC5C,GAAG,MAAM;SACV,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,4EAA4E;AAC5E,OAAO,EAAE,UAAU,EAAoC,YAAY,EAAE,MAAM,WAAW,CAAC;AACvF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC/G,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAW7D,4EAA4E;AAC5E,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAyB,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAK9C,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AAEjD;;;;;;GAMG;AACH,MAAM,OAAO,aAAa;IACf,IAAI,CAAa;IACjB,IAAI,CAAU;IACd,QAAQ,CAAc;IACtB,MAAM,CAAY;IAClB,UAAU,CAAgB;IAC1B,OAAO,CAAa;IACpB,SAAS,CAAe;IACxB,GAAG,CAAS;IACZ,SAAS,CAAe;IAEjC,YAAY,MAA8B;QACxC,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC;YACzB,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,gBAAgB;YAC5C,GAAG,MAAM;SACV,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/messaging.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Messaging API — send/receive P2P direct messages via the ClawNet node.
+ */
+import type { HttpClient, RequestOptions } from './http.js';
+/** Topic used for delivery receipt notifications via WebSocket. */
+export declare const RECEIPT_TOPIC: "_receipt";
+export interface SendMessageParams {
+    /** Target node's DID (did:claw:z...) */
+    targetDid: string;
+    /** Topic / channel name (e.g. "telagent/envelope") */
+    topic: string;
+    /** Opaque payload — typically base64-encoded */
+    payload: string;
+    /** Time-to-live in seconds (default: 86400 = 24h) */
+    ttlSec?: number;
+    /** Priority level: 0=low, 1=normal, 2=high, 3=urgent */
+    priority?: number;
+    /** Enable gzip compression for payloads > 1KB */
+    compress?: boolean;
+    /** Recipient's X25519 public key hex for E2E encryption */
+    encryptForKeyHex?: string;
+    /** Idempotency key for deduplication (unique per message) */
+    idempotencyKey?: string;
+}
+export interface SendBatchParams {
+    /** Target DIDs (max 100) */
+    targetDids: string[];
+    /** Topic / channel name */
+    topic: string;
+    /** Opaque payload */
+    payload: string;
+    /** Time-to-live in seconds (default: 86400 = 24h) */
+    ttlSec?: number;
+    /** Priority level: 0=low, 1=normal, 2=high, 3=urgent */
+    priority?: number;
+    /** Enable gzip compression for payloads > 1KB */
+    compress?: boolean;
+    /** Idempotency key for deduplication */
+    idempotencyKey?: string;
+    /** Per-recipient X25519 public key hex for E2E encryption (DID → key hex) */
+    recipientKeys?: Record<string, string>;
+}
+export interface SendMessageResult {
+    messageId: string;
+    delivered: boolean;
+    compressed?: boolean;
+    encrypted?: boolean;
+}
+export interface SendBatchResult {
+    results: Array<SendMessageResult & {
+        targetDid: string;
+    }>;
+}
+export interface InboxMessage {
+    messageId: string;
+    sourceDid: string;
+    topic: string;
+    payload: string;
+    receivedAtMs: number;
+    priority: number;
+    seq: number;
+}
+export interface InboxQueryParams {
+    /** Filter by topic */
+    topic?: string;
+    /** Only messages received after this timestamp (ms) */
+    since?: number;
+    /** Only messages with sequence number > sinceSeq (for replay) */
+    sinceSeq?: number;
+    /** Max messages to return (1-500, default 100) */
+    limit?: number;
+}
+export interface InboxResponse {
+    messages: InboxMessage[];
+}
+export interface DidPeerMapResponse {
+    didPeerMap: Record<string, string>;
+}
+export declare class MessagingApi {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Send a message to a target DID via P2P.
+     *
+     * If the target peer is online and reachable, the message is delivered
+     * directly. Otherwise it is queued for delivery when the peer reconnects.
+     */
+    send(params: SendMessageParams, opts?: RequestOptions): Promise<SendMessageResult>;
+    /**
+     * Multicast: send a message to multiple target DIDs.
+     *
+     * Each target is attempted independently — partial success is possible.
+     * Maximum 100 targets per call.
+     */
+    sendBatch(params: SendBatchParams, opts?: RequestOptions): Promise<SendBatchResult>;
+    /**
+     * Query the local inbox for received messages.
+     *
+     * Messages remain in the inbox until explicitly acknowledged via `ack()`.
+     * Use `topic` to filter by application namespace (e.g. "telagent/envelope").
+     */
+    inbox(params?: InboxQueryParams, opts?: RequestOptions): Promise<InboxResponse>;
+    /**
+     * Acknowledge (consume) a message from the inbox.
+     *
+     * Once acknowledged, the message will no longer appear in inbox queries at
+     * all. Call this after your application has processed the message.
+     */
+    ack(messageId: string, opts?: RequestOptions): Promise<void>;
+    /**
+     * Get the current DID → PeerId mapping (for debugging).
+     */
+    peers(opts?: RequestOptions): Promise<DidPeerMapResponse>;
+}
+//# sourceMappingURL=messaging.d.ts.map

package/dist/messaging.d.ts.map

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

package/dist/messaging.js

@@ -0,0 +1,61 @@
+/** Topic used for delivery receipt notifications via WebSocket. */
+export const RECEIPT_TOPIC = '_receipt';
+// ── API Class ────────────────────────────────────────────────────
+export class MessagingApi {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Send a message to a target DID via P2P.
+     *
+     * If the target peer is online and reachable, the message is delivered
+     * directly. Otherwise it is queued for delivery when the peer reconnects.
+     */
+    async send(params, opts) {
+        return this.http.post('/api/v1/messaging/send', params, opts);
+    }
+    /**
+     * Multicast: send a message to multiple target DIDs.
+     *
+     * Each target is attempted independently — partial success is possible.
+     * Maximum 100 targets per call.
+     */
+    async sendBatch(params, opts) {
+        return this.http.post('/api/v1/messaging/send/batch', params, opts);
+    }
+    /**
+     * Query the local inbox for received messages.
+     *
+     * Messages remain in the inbox until explicitly acknowledged via `ack()`.
+     * Use `topic` to filter by application namespace (e.g. "telagent/envelope").
+     */
+    async inbox(params, opts) {
+        const query = {};
+        if (params?.topic)
+            query.topic = params.topic;
+        if (params?.since !== undefined)
+            query.since = params.since;
+        if (params?.sinceSeq !== undefined)
+            query.sinceSeq = params.sinceSeq;
+        if (params?.limit !== undefined)
+            query.limit = params.limit;
+        return this.http.get('/api/v1/messaging/inbox', query, opts);
+    }
+    /**
+     * Acknowledge (consume) a message from the inbox.
+     *
+     * Once acknowledged, the message will no longer appear in inbox queries at
+     * all. Call this after your application has processed the message.
+     */
+    async ack(messageId, opts) {
+        await this.http.delete(`/api/v1/messaging/inbox/${encodeURIComponent(messageId)}`, undefined, opts);
+    }
+    /**
+     * Get the current DID → PeerId mapping (for debugging).
+     */
+    async peers(opts) {
+        return this.http.get('/api/v1/messaging/peers', undefined, opts);
+    }
+}
+//# sourceMappingURL=messaging.js.map

package/dist/messaging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.js","sourceRoot":"","sources":["../src/messaging.ts"],"names":[],"mappings":"AAKA,mEAAmE;AACnE,MAAM,CAAC,MAAM,aAAa,GAAG,UAAmB,CAAC;AAkFjD,oEAAoE;AAEpE,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,MAAyB,EAAE,IAAqB;QACzD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAoB,wBAAwB,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACnF,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CAAC,MAAuB,EAAE,IAAqB;QAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAkB,8BAA8B,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACvF,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,MAAyB,EAAE,IAAqB;QAC1D,MAAM,KAAK,GAA0D,EAAE,CAAC;QACxE,IAAI,MAAM,EAAE,KAAK;YAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC9C,IAAI,MAAM,EAAE,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC5D,IAAI,MAAM,EAAE,QAAQ,KAAK,SAAS;YAAE,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QACrE,IAAI,MAAM,EAAE,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAgB,yBAAyB,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,SAAiB,EAAE,IAAqB;QAChD,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,2BAA2B,kBAAkB,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACtG,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,IAAqB;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAqB,yBAAyB,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACvF,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claw-network/sdk",
-  "version": "0.2.3",
+  "version": "0.4.0",
   "description": "TypeScript SDK for the ClawNet decentralized agent economy",
   "type": "module",
   "main": "dist/index.js",
@@ -25,12 +25,12 @@
   "exports": {
     ".": "./dist/index.js"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsc -b tsconfig.json",
     "test": "vitest run --passWithNoTests",
     "lint": "eslint src --max-warnings=0"
-  },
-  "publishConfig": {
-    "access": "public"
   }
-}
+}