openmates 0.12.0-alpha.16 → 0.12.0-alpha.18

package/README.md

@@ -24,6 +24,7 @@ openmates apps list
 openmates apps ai ask "What is Docker?"
 openmates apps code run --language python --code 'print("Hello")'
 openmates settings account export data --json
+openmates learning-mode status --json
 openmates settings memories list --json
 openmates docs list
 openmates benchmark model google/gemini-3.5-flash --dry-run --json

package/dist/{chunk-2L7XCIUT.js → chunk-L5U4RDFT.js}

@@ -2979,6 +2979,41 @@ var OpenMatesClient = class _OpenMatesClient {
     saveSession(session);
     return response.data.user ?? {};
   }
+  async getLearningModeStatus() {
+    this.requireSession();
+    const response = await this.http.get(
+      "/v1/learning-mode",
+      this.getCliRequestHeaders()
+    );
+    if (!response.ok) {
+      throw new Error(`Learning Mode status failed with HTTP ${response.status}`);
+    }
+    return response.data;
+  }
+  async activateLearningMode(params) {
+    this.requireSession();
+    const response = await this.http.post(
+      "/v1/learning-mode/activate",
+      { age_group: params.ageGroup, passcode: params.passcode },
+      this.getCliRequestHeaders()
+    );
+    if (!response.ok) {
+      throw new Error(`Learning Mode activation failed with HTTP ${response.status}`);
+    }
+    return response.data;
+  }
+  async deactivateLearningMode(passcode) {
+    this.requireSession();
+    const response = await this.http.post(
+      "/v1/learning-mode/deactivate",
+      { passcode },
+      this.getCliRequestHeaders()
+    );
+    if (!response.ok) {
+      throw new Error(`Learning Mode deactivation failed with HTTP ${response.status}`);
+    }
+    return response.data;
+  }
   async logout() {
     if (this.session) {
       await this.http.post("/v1/auth/logout", {}, this.getCliRequestHeaders()).catch(() => void 0);
@@ -3680,6 +3715,12 @@ var OpenMatesClient = class _OpenMatesClient {
     if (params.benchmarkMetadata) {
       messagePayload.benchmark_metadata = params.benchmarkMetadata;
     }
+    if (params.learningMode) {
+      messagePayload.learning_mode = {
+        enabled: params.learningMode.enabled,
+        age_group: params.learningMode.ageGroup ?? null
+      };
+    }
     if (params.incognito) {
       const providedHistory = (params.messageHistory ?? []).map((historyMessage) => ({
         ...historyMessage,
@@ -20689,7 +20730,7 @@ line_count: 37`,
   metadata: {
     featured: true,
     order: 2,
-    content_embed_examples: ["code.application"]
+    content_embed_examples: []
   }
 };
 
@@ -26250,6 +26291,9 @@ Only output the final Markdown table. Do NOT include explanations, notes, or any
     anonymous_free_usage: {
       feature_notice: {
         text: "You are using free anonymous credits. File uploads, memories, chat sync, and some other features require creating an account."
+      },
+      daily_credits_exhausted: {
+        text: "You used up your free daily credits. Sign up & buy credits to make full use of OpenMates."
       }
     },
     interactive_question_failed: {
@@ -27924,6 +27968,44 @@ Only output the final Markdown table. Do NOT include explanations, notes, or any
     account_created_second_login_info: {
       text: "If you signed up with a passkey, add password plus 2FA as a backup. If you signed up with password plus 2FA, add a passkey for faster secure login."
     },
+    existing_account: {
+      subject: {
+        text: "An OpenMates account already exists for this email"
+      },
+      title: {
+        text: "An account with your email already exists"
+      },
+      intro: {
+        text: "Someone tried to create a new OpenMates account with this email address, but this email is already connected to an existing account."
+      },
+      saved_logins_title: {
+        text: "Check your saved logins"
+      },
+      saved_logins_body: {
+        text: "Your browser, password manager, or device may already have the login saved. Look for OpenMates in saved passwords or passkeys before creating a new account."
+      },
+      login_methods_title: {
+        text: "Try your login methods"
+      },
+      login_methods_body: {
+        text: "You can log in with a passkey, or with your password plus 2FA. If you set up backup codes, keep them ready for the 2FA step."
+      },
+      login_button: {
+        text: "Log in to OpenMates"
+      },
+      recovery_key_title: {
+        text: "Have your recovery key?"
+      },
+      recovery_key_body: {
+        text: "If you do not remember your password or passkey but still have your recovery key, use recovery key login. It preserves your encrypted chats and account data."
+      },
+      recovery_button: {
+        text: "Open login and use recovery key"
+      },
+      reset_warning: {
+        text: "If you lost every login method and your recovery key, account reset is the last resort. Because OpenMates encrypts your data, resetting the account can permanently delete encrypted chats, memories, app settings, embeds, passkeys, and API keys."
+      }
+    },
     password_security_reminder: {
       subject: {
         text: "Action needed to secure your OpenMates account"
@@ -28941,6 +29023,9 @@ Only output the final Markdown table. Do NOT include explanations, notes, or any
     }
   },
   embeds: {
+    learning_mode_shortened_notice: {
+      text: "Shortened since Learning Mode is active."
+    },
     weather: {
       rain_radar: {
         no_rain: {
@@ -37648,6 +37733,90 @@ As of mid-2026, the severe supply shocks from the 2024\u20132025 avian flu have
     incognito: {
       text: "Incognito"
     },
+    learning_mode: {
+      text: "Learning"
+    },
+    learning_mode_active: {
+      text: "Active for all chats on this account"
+    },
+    learning_mode_inactive: {
+      text: "Teach step-by-step instead of giving complete answers"
+    },
+    learning_mode_load_error: {
+      text: "Could not load Learning Mode status."
+    },
+    learning_mode_save_error: {
+      text: "Could not update Learning Mode."
+    },
+    learning_mode_enabled: {
+      text: "Learning Mode enabled."
+    },
+    learning_mode_disabled: {
+      text: "Learning Mode disabled."
+    },
+    learning_mode_age_group_prompt: {
+      text: "Learner age group: under_10, 10_12, 13_15, 16_18, or adult"
+    },
+    learning_mode_enable_passcode_prompt: {
+      text: "Set a Learning Mode passcode."
+    },
+    learning_mode_disable_passcode_prompt: {
+      text: "Enter the Learning Mode passcode to disable it."
+    },
+    learning_mode_invalid_age_group: {
+      text: "Invalid age group. Use under_10, 10_12, 13_15, 16_18, or adult."
+    },
+    learning_mode_enable_description: {
+      text: "Choose the learner age group and set a passcode. Learning Mode will apply to every chat on this account."
+    },
+    learning_mode_disable_description: {
+      text: "Enter the Learning Mode passcode to turn it off for this account."
+    },
+    learning_mode_active_detail: {
+      text: "Learning Mode is active for every chat on this account. Answers stay teaching-first and selected tools are restricted."
+    },
+    learning_mode_inactive_detail: {
+      text: "When enabled, OpenMates guides the learner step by step instead of giving complete answers."
+    },
+    learning_mode_age_group_label: {
+      text: "Learner age group"
+    },
+    learning_mode_age_under_10: {
+      text: "Under 10"
+    },
+    learning_mode_age_10_12: {
+      text: "10 to 12"
+    },
+    learning_mode_age_13_15: {
+      text: "13 to 15"
+    },
+    learning_mode_age_16_18: {
+      text: "16 to 18"
+    },
+    learning_mode_age_adult: {
+      text: "Adult"
+    },
+    learning_mode_enable_passcode_label: {
+      text: "Set passcode"
+    },
+    learning_mode_disable_passcode_label: {
+      text: "Enter passcode"
+    },
+    learning_mode_enable_passcode_placeholder: {
+      text: "Create a passcode"
+    },
+    learning_mode_disable_passcode_placeholder: {
+      text: "Learning Mode passcode"
+    },
+    learning_mode_passcode_required: {
+      text: "Enter a passcode to continue."
+    },
+    learning_mode_enable_button: {
+      text: "Start Learning Mode"
+    },
+    learning_mode_disable_button: {
+      text: "Turn off Learning Mode"
+    },
     incognito_explainer_description: {
       text: "Incognito mode applies only to new chats you create. New chats created while incognito mode is active are not synced across devices, not stored on the server, and not cached. These chats exist only in your current browser session. Existing chats remain unchanged."
     },
@@ -42645,6 +42814,10 @@ async function main() {
       printSettingsHelp(client);
       return;
     }
+    if (command === "learning-mode") {
+      printLearningModeHelp();
+      return;
+    }
     if (command === "signup") {
       printSignupHelp();
       return;
@@ -42743,6 +42916,10 @@ async function main() {
     await handleSettings(client, subcommand, rest, parsed.flags);
     return;
   }
+  if (command === "learning-mode") {
+    await handleLearningMode(client, subcommand, parsed.flags);
+    return;
+  }
   if (command === "inspirations") {
     await handleInspirations(client, parsed.flags);
     return;
@@ -45126,6 +45303,71 @@ async function handleSettings(client, subcommand, rest, flags) {
   printSettingsHelp(client, [subcommand]);
   process.exit(1);
 }
+var LEARNING_MODE_AGE_GROUPS = /* @__PURE__ */ new Set([
+  "under_10",
+  "10_12",
+  "13_15",
+  "16_18",
+  "adult"
+]);
+async function handleLearningMode(client, subcommand, flags) {
+  if (!subcommand || subcommand === "help" || flags.help === true) {
+    printLearningModeHelp();
+    return;
+  }
+  if (subcommand === "status") {
+    printLearningModeStatus(await client.getLearningModeStatus(), flags.json === true);
+    return;
+  }
+  if (subcommand === "enable") {
+    const ageGroup = parseLearningModeAgeGroup(flags["age-group"]);
+    const passcode = parseRequiredStringFlag(flags.passcode, "--passcode");
+    printLearningModeStatus(
+      await client.activateLearningMode({ ageGroup, passcode }),
+      flags.json === true
+    );
+    return;
+  }
+  if (subcommand === "disable") {
+    const passcode = parseRequiredStringFlag(flags.passcode, "--passcode");
+    printLearningModeStatus(await client.deactivateLearningMode(passcode), flags.json === true);
+    return;
+  }
+  console.error(`Unknown learning-mode command '${subcommand}'.
+`);
+  printLearningModeHelp();
+  process.exit(1);
+}
+function parseLearningModeAgeGroup(value) {
+  if (typeof value !== "string" || !LEARNING_MODE_AGE_GROUPS.has(value)) {
+    throw new Error("Provide --age-group as one of: under_10, 10_12, 13_15, 16_18, adult.");
+  }
+  return value;
+}
+function parseRequiredStringFlag(value, name) {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new Error(`Provide ${name}.`);
+  }
+  return value;
+}
+function printLearningModeStatus(status, json) {
+  if (json) {
+    printJson2(status);
+    return;
+  }
+  console.log(`Learning Mode: ${status.enabled ? "enabled" : "disabled"}`);
+  if (status.age_group) console.log(`Age group: ${status.age_group}`);
+  if (status.failed_attempts > 0) console.log(`Failed disable attempts: ${status.failed_attempts}`);
+  if (status.deactivation_blocked_until) {
+    console.log(`Disable blocked until: ${new Date(status.deactivation_blocked_until * 1e3).toISOString()}`);
+  }
+}
+function learningModeStatusToContext(status) {
+  return {
+    enabled: status.enabled,
+    ageGroup: status.age_group
+  };
+}
 async function handleMemories(client, rest, flags) {
   const action = rest[0];
   if (!action || action === "help") {
@@ -45737,6 +45979,7 @@ async function sendMessageStreaming(client, params, redactor) {
   const urlResult = prepareUrlEmbeds(finalMessage);
   finalMessage = urlResult.message;
   preparedEmbeds.push(...urlResult.embeds);
+  const learningMode = learningModeStatusToContext(await client.getLearningModeStatus());
   const result = await client.sendMessage({
     message: finalMessage,
     chatId: params.chatId,
@@ -45746,6 +45989,7 @@ async function sendMessageStreaming(client, params, redactor) {
     onSubChatApprovalRequest,
     autoApproveSubChats: params.autoApproveSubChats,
     autoApproveMemories: params.autoApproveMemories,
+    learningMode,
     preparedEmbeds: preparedEmbeds.length > 0 ? preparedEmbeds : void 0,
     piiMappings: piiResult.mappings.map((mapping) => ({
       placeholder: mapping.placeholder,
@@ -47052,6 +47296,7 @@ Commands:
   openmates mentions [--help]                List available @mentions
   openmates embeds [--help]                  Embed commands (show)
   openmates settings [--help]                Predefined settings commands
+  openmates learning-mode [--help]           Account-wide Learning Mode controls
   openmates inspirations [--lang <code>] [--json]   Daily inspirations
   openmates newchatsuggestions [--limit <n>] [--json]   Personalized new chat suggestions
   openmates feedback [--help]                Assistant response feedback helpers
@@ -47078,6 +47323,22 @@ Options:
   --rating <1-5>  Required star rating
   --json          Output the decision contract as JSON`);
 }
+function printLearningModeHelp() {
+  console.log(`Learning Mode commands:
+  openmates learning-mode status [--json]
+  openmates learning-mode enable --age-group <group> --passcode <passcode> [--json]
+  openmates learning-mode disable --passcode <passcode> [--json]
+
+Learning Mode is account-wide and applies to CLI, web, Apple, and API chat requests.
+
+Age groups:
+  under_10, 10_12, 13_15, 16_18, adult
+
+Options:
+  --age-group <group>  Required for enable
+  --passcode <value>   Required for enable and disable
+  --json               Output backend status JSON`);
+}
 function printSignupHelp() {
   console.log(`Signup command:
   openmates signup --email <email> --username <name> --invite-code <code>

package/dist/cli.js

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

package/dist/index.d.ts

@@ -249,6 +249,17 @@ interface ConnectedAccountTurnTokenRef {
     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;
+}
 /** A single field definition within a memory type schema. */
 interface MemoryFieldDef {
     type: string;
@@ -557,6 +568,12 @@ declare class OpenMatesClient {
     }): 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;
@@ -709,6 +726,8 @@ declare class OpenMatesClient {
         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<{

package/dist/index.js

@@ -9,7 +9,7 @@ import {
   deriveAppUrl,
   getExtForLang,
   serializeToYaml
-} from "./chunk-2L7XCIUT.js";
+} from "./chunk-L5U4RDFT.js";
 import "./chunk-AXNRPVLE.js";
 export {
   ASSISTANT_FEEDBACK_REPORT_TITLE,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openmates",
-  "version": "0.12.0-alpha.16",
+  "version": "0.12.0-alpha.18",
   "description": "OpenMates CLI and SDK",
   "type": "module",
   "main": "dist/index.js",