openmates 0.12.0-alpha.2 → 0.12.0-alpha.21

package/dist/cli.js

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

package/dist/index.d.ts

@@ -226,6 +226,41 @@ interface SubChatApprovalRequest {
     existingSubChats: number | null;
     remainingSubChats: number | null;
 }
+interface ConnectedAccountDirectoryEntry {
+    connected_account_id: string;
+    app_id: string;
+    account_ref: string;
+    label: string;
+    capabilities: string[];
+    runtime_modes?: Record<string, string>;
+}
+interface ConnectedAccountTurnTokenRefInput {
+    connected_account_id: string;
+    app_id: string;
+    allowed_actions: string[];
+    refresh_token_envelope: Record<string, unknown>;
+    action_scope?: Record<string, unknown>;
+}
+interface ConnectedAccountTurnTokenRef {
+    connected_account_id: string;
+    app_id: string;
+    turn_token_ref: string;
+    allowed_actions: string[];
+    action_scope?: Record<string, unknown>;
+    expires_at: number;
+}
+type LearningModeAgeGroup = "under_10" | "10_12" | "13_15" | "16_18" | "adult";
+interface LearningModeStatus {
+    enabled: boolean;
+    age_group: LearningModeAgeGroup | null;
+    failed_attempts: number;
+    deactivation_blocked_until: number | null;
+}
+interface LearningModeContext {
+    enabled: boolean;
+    ageGroup?: LearningModeAgeGroup | null;
+    source?: "anonymous_session";
+}
 /** A single field definition within a memory type schema. */
 interface MemoryFieldDef {
     type: string;
@@ -266,6 +301,7 @@ interface SkillParam {
     description: string;
     required: boolean;
     default?: unknown;
+    inputShape?: "requests" | "flat";
 }
 interface ChatListPage {
     chats: ChatListItem[];
@@ -274,6 +310,23 @@ interface ChatListPage {
     limit: number;
     hasMore: boolean;
 }
+interface BenchmarkMetadata {
+    source: "benchmark";
+    benchmark_run_id: string;
+    benchmark_suite: string;
+    benchmark_case: string;
+    benchmark_target_model: string;
+    benchmark_judge_model?: string;
+}
+interface BenchmarkHistoryMessage {
+    message_id: string;
+    role: "user" | "assistant" | "system";
+    sender_name: string;
+    content: string;
+    created_at: number;
+    chat_id?: string;
+    category?: string | null;
+}
 /** Decrypted message for display */
 interface DecryptedMessage {
     id: string;
@@ -297,6 +350,35 @@ interface DecryptedEmbed {
     skillId: string | null;
     createdAt: number | null;
 }
+interface EmbedVersionMeta {
+    version_number: number;
+    created_at: number;
+    has_snapshot: boolean;
+    has_patch: boolean;
+    encrypted_snapshot?: string | null;
+    encrypted_patch?: string | null;
+}
+interface EmbedVersionsResponse {
+    embed_id: string;
+    current_version: number;
+    versions: EmbedVersionMeta[];
+    readonly: boolean;
+}
+interface EmbedVersionContentResponse {
+    embed_id: string;
+    version_number: number;
+    current_version: number;
+    content?: string;
+    rows?: EmbedVersionMeta[];
+    readonly: boolean;
+}
+interface EmbedVersionRestoreResponse {
+    embed_id: string;
+    restored_from_version: number;
+    version_number: number;
+    content: string;
+    content_hash: string;
+}
 /** Video metadata attached to a daily inspiration. */
 interface DailyInspirationVideo {
     youtube_id: string;
@@ -339,17 +421,11 @@ declare const MATE_NAMES: Record<string, string>;
  *
  * Mirrors the format used by NewChatSuggestions.svelte in the web app.
  * The `body` text is the plain text to insert into the message input.
- * The optional `appId` and `skillId` are parsed from the `[app-skill]` prefix
- * (e.g. "[web-search] What's the weather today?" → appId="web", skillId="search").
  */
 interface DecryptedNewChatSuggestion {
     id: string;
     chatId: string | null;
     body: string;
-    /** App ID if the suggestion has an [app-skill] or [app] prefix. */
-    appId: string | null;
-    /** Skill ID if the suggestion has an [app-skill] prefix. */
-    skillId: string | null;
     createdAt: number;
 }
 /** A decrypted memory entry as returned to CLI callers. */
@@ -436,6 +512,12 @@ interface BackupCodesResult {
     message: string;
     backup_codes: string[];
 }
+interface AnonymousFreeUsageStatus {
+    active: boolean;
+    reason: string | null;
+    resetAt: string | null;
+    cta: string | null;
+}
 /**
  * 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.
@@ -449,8 +531,51 @@ declare class OpenMatesClient {
     constructor(options?: OpenMatesClientOptions);
     static load(options?: OpenMatesClientOptions): OpenMatesClient;
     hasSession(): boolean;
+    getAnonymousFreeUsageStatus(): Promise<AnonymousFreeUsageStatus>;
+    sendAnonymousMessage(params: {
+        message: string;
+        learningMode?: LearningModeContext;
+    }): Promise<{
+        status: "completed";
+        chatId: string;
+        messageId: string;
+        assistant: string;
+        category: string | null;
+        modelName: string | null;
+        mateName: string | null;
+        followUpSuggestions: string[];
+        subChatEvents: SubChatEvent[];
+        appSettingsMemoryRequests: Array<{
+            requestId: string | null;
+            requestedKeys: string[];
+            approvedKeys: string[];
+            entryCount: number;
+        }>;
+    }>;
+    createTurnTokenRefs(params: {
+        chatId: string;
+        messageId: string;
+        refs: ConnectedAccountTurnTokenRefInput[];
+    }): Promise<ConnectedAccountTurnTokenRef[]>;
+    cancelConnectedAccountAction(params: {
+        actionId: string;
+        chatId: string;
+        messageId: string;
+    }): Promise<Record<string, unknown>>;
+    undoConnectedAccountAction(params: {
+        actionId: string;
+        chatId: string;
+        messageId: string;
+        turnTokenRef: string;
+    }): Promise<Record<string, unknown>>;
     loginWithPairAuth(): Promise<void>;
     whoAmI(): Promise<Record<string, unknown>>;
+    getLearningModeStatus(): Promise<LearningModeStatus>;
+    activateLearningMode(params: {
+        ageGroup: LearningModeAgeGroup;
+        passcode: string;
+    }): Promise<LearningModeStatus>;
+    deactivateLearningMode(passcode: string): Promise<LearningModeStatus>;
     logout(): Promise<void>;
     requestSignupEmailCode(params: {
         email: string;
@@ -589,6 +714,24 @@ declare class OpenMatesClient {
         encryptedEmbeds?: EncryptedEmbed[];
         /** Prepared embeds to encrypt after the real chat/message IDs are known. */
         preparedEmbeds?: PreparedEmbed[];
+        /** Placeholder-to-original PII mappings created before sending the user message. */
+        piiMappings?: Array<{
+            placeholder: string;
+            original: string;
+            type: string;
+        }>;
+        /** Redacted connected-account directory for AI-visible account selection. */
+        connectedAccountDirectory?: ConnectedAccountDirectoryEntry[];
+        /** Refresh-token envelopes to convert into short-lived token refs before send. */
+        connectedAccountTokenRefInputs?: ConnectedAccountTurnTokenRefInput[];
+        /** Non-sensitive CLI benchmark labels for usage-source grouping. */
+        benchmarkMetadata?: BenchmarkMetadata;
+        /** Full plaintext history for incognito benchmark turns. */
+        messageHistory?: BenchmarkHistoryMessage[];
+        /** Account-wide Learning Mode context when already known by the caller. */
+        learningMode?: LearningModeContext;
+        /** Start collecting before send for latency-sensitive benchmark turns. */
+        precollectResponse?: boolean;
     }): Promise<{
         status: "completed" | "waiting_for_user";
         chatId: string;
@@ -610,6 +753,7 @@ declare class OpenMatesClient {
         }>;
     }>;
     private persistStreamedEmbeds;
+    private persistPostProcessingMetadata;
     /**
      * Delete a chat by ID.
      *
@@ -823,6 +967,12 @@ declare class OpenMatesClient {
      * @returns Full share URL, e.g. https://openmates.org/share/embed/{id}#key={blob}
      */
     createEmbedShareLink(embedIdOrShort: string, durationSeconds?: ShareDuration, password?: string): Promise<string>;
+    listEmbedVersions(embedIdOrShort: string): Promise<EmbedVersionsResponse>;
+    getEmbedVersion(embedIdOrShort: string, version: number): Promise<EmbedVersionContentResponse>;
+    restoreEmbedVersion(embedIdOrShort: string, version: number): Promise<EmbedVersionRestoreResponse>;
+    private reconstructEncryptedEmbedVersion;
+    private formatEmbedVersionError;
+    private resolveEmbedId;
     /**
      * Build the context needed for CLI mention resolution.
      * Fetches apps (with skills, focus modes, memory categories) and
@@ -859,7 +1009,8 @@ declare class OpenMatesClient {
      * The sync cache stores encrypted data — decryption is always on-demand.
      * SECURITY: decrypted user content is NEVER written to disk.
      */
-    ensureSynced(forceRefresh?: boolean): Promise<SyncCache>;
+    ensureSynced(forceRefresh?: boolean, refreshChatIds?: string[]): Promise<SyncCache>;
+    private persistPendingAIResponsesFromSync;
     private prompt;
     private waitForPairAuthorization;
     private installPairExitListener;
@@ -895,23 +1046,17 @@ interface DocsSearchResult {
     title: string;
     snippet: string;
 }
-/**
- * Parse the [app-skill] or [app] prefix from a new-chat suggestion text.
- *
- * Mirrors parseSuggestion() in NewChatSuggestions.svelte (web app).
- *
- * Examples:
- *   "[web-search] What's the weather today?" → { body: "What's the weather today?", appId: "web", skillId: "search" }
- *   "[images-generate] Draw a cat" → { body: "Draw a cat", appId: "images", skillId: "generate" }
- *   "[web] Open my bookmarks" → { body: "Open my bookmarks", appId: "web", skillId: null }
- *   "How do I fix this bug?" → { body: "How do I fix this bug?", appId: null, skillId: null }
- */
-declare function parseNewChatSuggestionText(text: string): {
-    body: string;
-    appId: string | null;
-    skillId: string | null;
-};
 
 declare function defaultCloneBranchForVersion(version: string): string | null;
 
-export { type AuthMethodsStatus, type BackupCodesResult, type BankTransferOrderDetails, type BankTransferStatus, type CachedChat, type CachedNewChatSuggestion, type ChatListPage, type CliSignupResult, type DecryptedEmbed, type DecryptedMemoryEntry, type DecryptedMessage, type DecryptedNewChatSuggestion, type DocsFile, type DocsFolder, type DocsSearchResult, type DocsTree, type GiftCardBankTransferStatus, MATE_NAMES, MEMORY_TYPE_REGISTRY, type MemoryFieldDef, type MemoryTypeDef, OpenMatesClient, type OpenMatesClientOptions, type OpenMatesSession, type SyncCache, type TotpSetupStartResult, defaultCloneBranchForVersion, deriveAppUrl, parseNewChatSuggestionText };
+declare const ASSISTANT_FEEDBACK_THANKS = "Thanks for the feedback!";
+declare const ASSISTANT_FEEDBACK_REPORT_TITLE = "Assistant response quality bad:";
+type AssistantFeedbackDecision = {
+    rating: number;
+    action: "thanks" | "report_issue";
+    message: string;
+    reportTitle?: string;
+};
+declare function buildAssistantFeedbackDecision(rating: number): AssistantFeedbackDecision;
+
+export { ASSISTANT_FEEDBACK_REPORT_TITLE, ASSISTANT_FEEDBACK_THANKS, type AssistantFeedbackDecision, type AuthMethodsStatus, type BackupCodesResult, type BankTransferOrderDetails, type BankTransferStatus, type CachedChat, type CachedNewChatSuggestion, type ChatListPage, type CliSignupResult, type DecryptedEmbed, type DecryptedMemoryEntry, type DecryptedMessage, type DecryptedNewChatSuggestion, type DocsFile, type DocsFolder, type DocsSearchResult, type DocsTree, type GiftCardBankTransferStatus, MATE_NAMES, MEMORY_TYPE_REGISTRY, type MemoryFieldDef, type MemoryTypeDef, OpenMatesClient, type OpenMatesClientOptions, type OpenMatesSession, type SyncCache, type TotpSetupStartResult, buildAssistantFeedbackDecision, defaultCloneBranchForVersion, deriveAppUrl };

package/dist/index.js

@@ -1,21 +1,25 @@
 import {
+  ASSISTANT_FEEDBACK_REPORT_TITLE,
+  ASSISTANT_FEEDBACK_THANKS,
   MATE_NAMES,
   MEMORY_TYPE_REGISTRY,
   OpenMatesClient,
+  buildAssistantFeedbackDecision,
   defaultCloneBranchForVersion,
   deriveAppUrl,
   getExtForLang,
-  parseNewChatSuggestionText,
   serializeToYaml
-} from "./chunk-UG4LLEOG.js";
+} from "./chunk-REXWGRCR.js";
 import "./chunk-AXNRPVLE.js";
 export {
+  ASSISTANT_FEEDBACK_REPORT_TITLE,
+  ASSISTANT_FEEDBACK_THANKS,
   MATE_NAMES,
   MEMORY_TYPE_REGISTRY,
   OpenMatesClient,
+  buildAssistantFeedbackDecision,
   defaultCloneBranchForVersion,
   deriveAppUrl,
   getExtForLang,
-  parseNewChatSuggestionText,
   serializeToYaml
 };

package/fixtures/brandenburger-tor.svg

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="800" viewBox="0 0 1200 800">
+  <rect width="1200" height="800" fill="#d8ecff"/>
+  <rect y="560" width="1200" height="240" fill="#d7c39a"/>
+  <text x="600" y="88" text-anchor="middle" font-family="Arial, sans-serif" font-size="44" font-weight="700" fill="#23344d">Brandenburger Tor, Berlin</text>
+  <g transform="translate(160 170)" fill="#c9aa6a" stroke="#5d4522" stroke-width="8">
+    <rect x="80" y="160" width="800" height="58"/>
+    <rect x="120" y="218" width="720" height="48"/>
+    <rect x="150" y="266" width="660" height="42"/>
+    <g fill="#d9bd7d">
+      <rect x="170" y="308" width="54" height="250"/>
+      <rect x="285" y="308" width="54" height="250"/>
+      <rect x="400" y="308" width="54" height="250"/>
+      <rect x="515" y="308" width="54" height="250"/>
+      <rect x="630" y="308" width="54" height="250"/>
+      <rect x="745" y="308" width="54" height="250"/>
+    </g>
+    <rect x="130" y="558" width="700" height="50"/>
+    <path d="M480 30 C530 72 620 88 682 48 L720 84 C652 142 530 124 456 78 Z" fill="#3e6f5f"/>
+    <circle cx="510" cy="92" r="22" fill="#3e6f5f"/>
+    <circle cx="625" cy="92" r="22" fill="#3e6f5f"/>
+    <path d="M565 38 l26 78 h-52 z" fill="#3e6f5f"/>
+  </g>
+  <text x="600" y="740" text-anchor="middle" font-family="Arial, sans-serif" font-size="32" fill="#23344d">Neoclassical gate with Quadriga on top</text>
+</svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmates",
-  "version": "0.12.0-alpha.2",
+  "version": "0.12.0-alpha.21",
   "description": "OpenMates CLI and SDK",
   "type": "module",
   "main": "dist/index.js",
@@ -9,7 +9,8 @@
     "openmates": "dist/cli.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "fixtures"
   ],
   "scripts": {
     "build": "tsup src/index.ts src/cli.ts --format esm --dts --clean",
@@ -28,7 +29,8 @@
     "test:unit:billing": "node --test tests/billing.test.ts",
     "test:unit:account-delete": "node --test tests/account-delete.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 tests/ws.test.ts tests/urlEmbed.test.ts && node --test --experimental-strip-types tests/embedRenderers.test.ts && node --test tests/cli.test.ts tests/billing.test.ts tests/account-delete.test.ts tests/signup.test.ts tests/security-setup.test.ts tests/e2e-provisioning.test.ts"
+    "test:unit:benchmark": "node --test --experimental-strip-types --loader ./tests/loader.mjs src/__tests__/benchmark.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 src/__tests__/benchmark.test.ts && node --test --experimental-strip-types tests/embedRenderers.test.ts && node --test tests/cli.test.ts tests/billing.test.ts tests/account-delete.test.ts tests/signup.test.ts tests/security-setup.test.ts tests/e2e-provisioning.test.ts"
   },
   "keywords": [
     "openmates",