@agentvault/secure-channel 0.1.2 → 0.4.0

package/dist/__tests__/functional.test.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Functional QA Test Suite — Agent Setup & Connection
+ *
+ * Tests the full agent lifecycle against the production API:
+ * 1. Package installation & CLI
+ * 2. Crypto operations (key gen, proof, fingerprint)
+ * 3. API connectivity & error handling
+ * 4. Full enrollment flow (create invite → enroll → approve → activate → connect)
+ *
+ * Requires env vars:
+ *   CLERK_SECRET_KEY     — Clerk backend secret for session token creation
+ *   CLERK_SESSION_ID     — Active Clerk session ID (for Eric's account)
+ *   API_URL              — Backend API URL (default: https://api.agentvault.chat)
+ *
+ * Rate limit note: enrollment is limited to 5 requests/IP/10min.
+ * This suite uses 2 enrollment calls (4.2 + 4.9). Error-case enrollment
+ * tests (3.3, 3.4) are removed to conserve rate limit budget.
+ * Test 4.2 will retry with backoff if rate-limited (up to 3 retries, 30s apart).
+ */
+export {};
+//# sourceMappingURL=functional.test.d.ts.map

package/dist/__tests__/functional.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functional.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/functional.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/__tests__/multi-session.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=multi-session.test.d.ts.map

package/dist/__tests__/multi-session.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-session.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/multi-session.test.ts"],"names":[],"mappings":""}

package/dist/channel.d.ts

@@ -5,9 +5,9 @@ export declare class SecureChannel extends EventEmitter {
     private _state;
     private _deviceId;
     private _fingerprint;
-    private _conversationId;
+    private _primaryConversationId;
     private _deviceJwt;
-    private _ratchet;
+    private _sessions;
     private _ws;
     private _pollTimer;
     private _reconnectAttempt;
@@ -18,18 +18,61 @@ export declare class SecureChannel extends EventEmitter {
     get state(): ChannelState;
     get deviceId(): string | null;
     get fingerprint(): string | null;
+    /** Returns the primary conversation ID (backward-compatible). */
     get conversationId(): string | null;
+    /** Returns all active conversation IDs. */
+    get conversationIds(): string[];
+    /** Returns the number of active sessions. */
+    get sessionCount(): number;
     start(): Promise<void>;
+    /**
+     * Append a message to persistent history for cross-device replay.
+     */
+    private _appendHistory;
+    /**
+     * Encrypt and send a message to ALL owner devices (fanout).
+     * Each session gets the same plaintext encrypted independently.
+     */
     send(plaintext: string): Promise<void>;
     stop(): Promise<void>;
     private _enroll;
     private _poll;
     private _activate;
     private _connect;
+    /**
+     * Handle an incoming encrypted message from a specific conversation.
+     * Decrypts using the appropriate session ratchet, emits to the agent,
+     * and relays as sync messages to sibling sessions.
+     */
+    private _handleIncomingMessage;
+    /**
+     * Relay an owner's message to all sibling sessions as encrypted sync messages.
+     * This allows all owner devices to see messages from any single device.
+     */
+    private _relaySyncToSiblings;
+    /**
+     * Send stored message history to a newly-activated session.
+     * Batches all history into a single encrypted message.
+     */
+    private _replayHistoryToSession;
+    /**
+     * Handle a device_linked event: a new owner device has joined.
+     * Fetches the new device's public keys, performs X3DH, and initializes
+     * a new ratchet session.
+     */
+    private _handleDeviceLinked;
+    /**
+     * Sync missed messages across ALL sessions.
+     * For each conversation, fetches messages since last sync and decrypts.
+     */
     private _syncMissedMessages;
     private _scheduleReconnect;
     private _setState;
     private _handleError;
+    /**
+     * Persist all ratchet session states to disk.
+     * Syncs live ratchet states back into the persisted sessions map.
+     */
     private _persistState;
 }
 //# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAY3C,OAAO,KAAK,EACV,mBAAmB,EACnB,YAAY,EAGb,MAAM,YAAY,CAAC;AAkBpB,qBAAa,aAAc,SAAQ,YAAY;IAcjC,OAAO,CAAC,MAAM;IAb1B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,eAAe,CAA8C;IACrE,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAA+B;gBAE7B,MAAM,EAAE,mBAAmB;IAI/C,IAAI,KAAK,IAAI,YAAY,CAExB;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAE5B;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAED,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,CAElC;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBtB,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAoBb,OAAO;IA+CrB,OAAO,CAAC,KAAK;YAgCC,SAAS;IAgDvB,OAAO,CAAC,QAAQ;YAgFF,mBAAmB;IAuDjC,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,YAAY;YAKN,aAAa;CAK5B"}
+{"version":3,"file":"channel.d.ts","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAa3C,OAAO,KAAK,EACV,mBAAmB,EACnB,YAAY,EAKb,MAAM,YAAY,CAAC;AAiDpB,qBAAa,aAAc,SAAQ,YAAY;IAiBjC,OAAO,CAAC,MAAM;IAhB1B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,sBAAsB,CAAc;IAC5C,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,SAAS,CAGH;IACd,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,eAAe,CAA8C;IACrE,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAA+B;gBAE7B,MAAM,EAAE,mBAAmB;IAI/C,IAAI,KAAK,IAAI,YAAY,CAExB;IAED,IAAI,QAAQ,IAAI,MAAM,GAAG,IAAI,CAE5B;IAED,IAAI,WAAW,IAAI,MAAM,GAAG,IAAI,CAE/B;IAED,iEAAiE;IACjE,IAAI,cAAc,IAAI,MAAM,GAAG,IAAI,CAElC;IAED,2CAA2C;IAC3C,IAAI,eAAe,IAAI,MAAM,EAAE,CAE9B;IAED,6CAA6C;IAC7C,IAAI,YAAY,IAAI,MAAM,CAEzB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsC5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBtB;;;OAGG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAoBb,OAAO;IAgDrB,OAAO,CAAC,KAAK;YAgCC,SAAS;IA2HvB,OAAO,CAAC,QAAQ;IA4DhB;;;;OAIG;YACW,sBAAsB;IAoFpC;;;OAGG;YACW,oBAAoB;IAmClC;;;OAGG;YACW,uBAAuB;IAkCrC;;;;OAIG;YACW,mBAAmB;IAkEjC;;;OAGG;YACW,mBAAmB;IAwFjC,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,YAAY;IAKpB;;;OAGG;YACW,aAAa;CAc5B"}