openmates 0.11.0-alpha.2 → 0.11.0-alpha.21

package/dist/cli.js

@@ -2,7 +2,8 @@
 import {
   getExtForLang,
   serializeToYaml
-} from "./chunk-N6QY7K6L.js";
+} from "./chunk-JQ5CPV6P.js";
+import "./chunk-AXNRPVLE.js";
 export {
   getExtForLang,
   serializeToYaml

package/dist/index.d.ts

@@ -7,17 +7,13 @@ interface OpenMatesSession {
     wsToken: string | null;
     cookies: Record<string, string>;
     masterKeyExportedB64: string;
+    emailEncryptionKeyB64?: string | null;
     hashedEmail: string;
     userEmailSalt: string;
     createdAt: number;
     authorizerDeviceName: string | null;
     autoLogoutMinutes: number | null;
 }
-interface IncognitoHistoryItem {
-    role: "user" | "assistant";
-    content: string;
-    createdAt: number;
-}
 /**
  * Raw chat record from the WS phase3 payload.
  * All encrypted_* fields are stored as-is (base64 ciphertext).
@@ -70,6 +66,11 @@ interface StreamEvent {
     /** Human-readable model name. */
     modelName: string | null;
 }
+type SubChatEventType = "spawn_sub_chats" | "sub_chat_progress" | "sub_chat_confirmation_required" | "sub_chat_confirmation_resolved" | "awaiting_sub_chats_completion" | "sub_chat_completed" | "awaiting_user_input";
+interface SubChatEvent {
+    type: SubChatEventType;
+    payload: Record<string, unknown>;
+}
 
 /** Minimal model info needed for mention resolution */
 interface ModelInfo {
@@ -109,6 +110,35 @@ interface MentionContext {
     memoryEntries: MemoryEntryInfo[];
 }
 
+/**
+ * @file Embed creation pipeline for the CLI — generates encrypted embeds
+ * with proper key wrapping, matching the web app's zero-knowledge architecture.
+ *
+ * For each embed:
+ * 1. Content is TOON-encoded (or JSON-fallback)
+ * 2. A random AES-256 embed key is generated
+ * 3. Content, type, and text_preview are encrypted with the embed key
+ * 4. The embed key is wrapped with both master key and chat key
+ * 5. SHA-256 hashes are computed for all IDs
+ * 6. The encrypted embed + wrapped keys are attached to chat_message_added
+ *
+ * Mirrors: cryptoService.ts (encryptWithEmbedKey, wrapEmbedKeyWithMasterKey,
+ *          wrapEmbedKeyWithChatKey, generateEmbedKey)
+ *          chatSyncServiceSenders.ts (encrypted_embeds construction)
+ *
+ * Architecture: docs/architecture/embeds.md
+ */
+/** A prepared embed ready for encryption and sending */
+interface PreparedEmbed {
+    embedId: string;
+    type: string;
+    content: string;
+    textPreview: string;
+    status: string;
+    filePath?: string;
+    contentHash?: string;
+    textLengthChars?: number;
+}
 /** A fully encrypted embed ready for the WebSocket payload */
 interface EncryptedEmbed {
     embed_id: string;
@@ -157,6 +187,23 @@ interface EmbedKeyWrapper {
  */
 type ShareDuration = 0 | 60 | 3600 | 86400 | 604800 | 1209600 | 2592000 | 7776000;
 
+interface CliSubChatRequest {
+    id?: string;
+    chat_id?: string;
+    user_message_id?: string;
+    message_id?: string;
+    prompt?: string;
+    wait_for_completion?: boolean;
+}
+interface SubChatApprovalRequest {
+    chatId: string;
+    taskId: string;
+    subChats: CliSubChatRequest[];
+    maxAutoSubChats: number | null;
+    maxDirectSubChats: number | null;
+    existingSubChats: number | null;
+    remainingSubChats: number | null;
+}
 /** A single field definition within a memory type schema. */
 interface MemoryFieldDef {
     type: string;
@@ -298,6 +345,23 @@ interface OpenMatesClientOptions {
     apiUrl?: string;
     session?: OpenMatesSession;
 }
+interface InvoiceListItem {
+    id: string;
+    order_id?: string | null;
+    date: string;
+    amount: string;
+    credits_purchased: number;
+    filename: string;
+    is_gift_card?: boolean;
+    refunded_at?: string | null;
+    refund_status?: string | null;
+    currency?: string | null;
+    provider?: string | null;
+}
+interface DownloadedDocument {
+    filename: string;
+    data: Uint8Array;
+}
 /**
  * Derive the web app URL from the API URL so the pair token is always looked
  * up on the same backend the CLI created it on.
@@ -409,8 +473,16 @@ declare class OpenMatesClient {
         incognito?: boolean;
         /** Streaming callback — fires for typing, chunk, and done events. */
         onStream?: (event: StreamEvent) => void;
+        /** Sub-chat lifecycle callback for progress/status output. */
+        onSubChatEvent?: (event: SubChatEvent) => void;
+        /** Approval callback used when the server asks before starting a large sub-chat batch. */
+        onSubChatApprovalRequest?: (request: SubChatApprovalRequest) => boolean | Promise<boolean>;
+        /** Explicit opt-in for automatic sub-chat approval in non-interactive runs. */
+        autoApproveSubChats?: boolean;
         /** Encrypted file embeds to attach to the message (code, images, PDFs). */
         encryptedEmbeds?: EncryptedEmbed[];
+        /** Prepared embeds to encrypt after the real chat/message IDs are known. */
+        preparedEmbeds?: PreparedEmbed[];
     }): Promise<{
         chatId: string;
         assistant: string;
@@ -419,9 +491,10 @@ declare class OpenMatesClient {
         mateName: string | null;
         /** Follow-up suggestions from post-processing (may be empty for incognito chats). */
         followUpSuggestions: string[];
+        /** Sub-chat lifecycle frames observed while collecting the parent response. */
+        subChatEvents: SubChatEvent[];
     }>;
-    getIncognitoHistory(): IncognitoHistoryItem[];
-    clearIncognitoHistory(): void;
+    private persistStreamedEmbeds;
     /**
      * Delete a chat by ID.
      *
@@ -465,7 +538,7 @@ declare class OpenMatesClient {
     }>;
     settingsGet(path: string): Promise<unknown>;
     settingsPost(path: string, body: Record<string, unknown>): Promise<unknown>;
-    settingsDelete(path: string): Promise<unknown>;
+    settingsDelete(path: string, body?: Record<string, unknown>): Promise<unknown>;
     settingsPatch(path: string, body: Record<string, unknown>): Promise<unknown>;
     redeemGiftCard(code: string): Promise<{
         success: boolean;
@@ -474,6 +547,27 @@ declare class OpenMatesClient {
         message: string;
     }>;
     listRedeemedGiftCards(): Promise<unknown>;
+    listInvoices(): Promise<{
+        invoices: InvoiceListItem[];
+    }>;
+    downloadInvoice(invoiceId: string): Promise<DownloadedDocument>;
+    downloadCreditNote(invoiceId: string): Promise<DownloadedDocument>;
+    requestRefund(invoiceId: string): Promise<unknown>;
+    updateUsername(username: string): Promise<unknown>;
+    updateProfileImage(filePath: string): Promise<unknown>;
+    getNewsletterCategories(): Promise<unknown>;
+    updateNewsletterCategories(categories: Record<string, boolean>): Promise<unknown>;
+    subscribeNewsletter(email: string, language?: string, darkmode?: boolean): Promise<unknown>;
+    confirmNewsletter(token: string): Promise<unknown>;
+    unsubscribeNewsletter(token: string): Promise<unknown>;
+    updateEmailNotificationSettings(payload: {
+        enabled: boolean;
+        email?: string | null;
+        preferences: Record<string, boolean>;
+        backup_reminder_interval_days?: number;
+    }): Promise<unknown>;
+    listNotifications(limit?: number): Promise<unknown>;
+    streamNotifications(): AsyncGenerator<unknown>;
     /**
      * Fetch today's daily inspirations.
      *
@@ -607,6 +701,9 @@ declare class OpenMatesClient {
      */
     buildMentionContext(): Promise<MentionContext>;
     private normalizePath;
+    private downloadPaymentPdf;
+    private ensureEmailEncryptionKey;
+    private hydrateEmailEncryptionKey;
     private requireSession;
     private getMasterKeyBytes;
     private getValidSessionFromDisk;
@@ -684,4 +781,6 @@ declare function parseNewChatSuggestionText(text: string): {
     skillId: string | null;
 };
 
-export { type CachedChat, type CachedNewChatSuggestion, type ChatListPage, type DecryptedEmbed, type DecryptedMemoryEntry, type DecryptedMessage, type DecryptedNewChatSuggestion, type DocsFile, type DocsFolder, type DocsSearchResult, type DocsTree, MATE_NAMES, MEMORY_TYPE_REGISTRY, type MemoryFieldDef, type MemoryTypeDef, OpenMatesClient, type OpenMatesClientOptions, type OpenMatesSession, type SyncCache, deriveAppUrl, parseNewChatSuggestionText };
+declare function defaultCloneBranchForVersion(version: string): string | null;
+
+export { type CachedChat, type CachedNewChatSuggestion, type ChatListPage, type DecryptedEmbed, type DecryptedMemoryEntry, type DecryptedMessage, type DecryptedNewChatSuggestion, type DocsFile, type DocsFolder, type DocsSearchResult, type DocsTree, MATE_NAMES, MEMORY_TYPE_REGISTRY, type MemoryFieldDef, type MemoryTypeDef, OpenMatesClient, type OpenMatesClientOptions, type OpenMatesSession, type SyncCache, defaultCloneBranchForVersion, deriveAppUrl, parseNewChatSuggestionText };

package/dist/index.js

@@ -2,15 +2,18 @@ import {
   MATE_NAMES,
   MEMORY_TYPE_REGISTRY,
   OpenMatesClient,
+  defaultCloneBranchForVersion,
   deriveAppUrl,
   getExtForLang,
   parseNewChatSuggestionText,
   serializeToYaml
-} from "./chunk-N6QY7K6L.js";
+} from "./chunk-JQ5CPV6P.js";
+import "./chunk-AXNRPVLE.js";
 export {
   MATE_NAMES,
   MEMORY_TYPE_REGISTRY,
   OpenMatesClient,
+  defaultCloneBranchForVersion,
   deriveAppUrl,
   getExtForLang,
   parseNewChatSuggestionText,

package/dist/uploadService-S464XJRA.js

@@ -0,0 +1,10 @@
+import {
+  transcribeUploadedAudio,
+  uploadFile,
+  uploadProfileImage
+} from "./chunk-AXNRPVLE.js";
+export {
+  transcribeUploadedAudio,
+  uploadFile,
+  uploadProfileImage
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmates",
-  "version": "0.11.0-alpha.2",
+  "version": "0.11.0-alpha.21",
   "description": "OpenMates CLI and SDK",
   "type": "module",
   "main": "dist/index.js",
@@ -18,9 +18,11 @@
     "test:unit:crypto": "node --test --experimental-strip-types tests/crypto.test.ts",
     "test:unit:storage": "node --test --experimental-strip-types --loader ./tests/loader.mjs tests/storage.test.ts",
     "test:unit:keychain": "node --test --experimental-strip-types tests/keychain.test.ts",
+    "test:unit:ws": "node --test --experimental-strip-types tests/ws.test.ts",
+    "test:unit:url-embed": "node --test --experimental-strip-types --loader ./tests/loader.mjs tests/urlEmbed.test.ts",
     "test:unit:server": "node --test --experimental-strip-types tests/server.test.ts",
     "test:unit:cli": "node --test tests/cli.test.ts",
-    "test": "node --test --experimental-strip-types --loader ./tests/loader.mjs tests/crypto.test.ts tests/storage.test.ts tests/keychain.test.ts tests/mentions.test.ts tests/outputRedactor.test.ts tests/fileEmbed.test.ts tests/embedCreator.test.ts tests/shareEncryption.test.ts tests/server.test.ts && node --test tests/cli.test.ts"
+    "test": "node --test --experimental-strip-types --loader ./tests/loader.mjs tests/crypto.test.ts tests/storage.test.ts tests/keychain.test.ts tests/mentions.test.ts tests/outputRedactor.test.ts tests/fileEmbed.test.ts tests/embedCreator.test.ts tests/shareEncryption.test.ts tests/server.test.ts tests/ws.test.ts tests/urlEmbed.test.ts && node --test tests/cli.test.ts"
   },
   "keywords": [
     "openmates",
@@ -43,7 +45,7 @@
     "@toon-format/toon": "2.1.0",
     "ahocorasick": "1.0.2",
     "qrcode-terminal": "^0.12.0",
-    "ws": "^8.18.3"
+    "ws": "8.20.1"
   },
   "devDependencies": {
     "@types/node": "^24.5.0",