openmates 0.12.0-alpha.16 → 0.12.0-alpha.17

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-OSMG5HH3.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: []
   }
 };
 
@@ -28941,6 +28982,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 +37692,39 @@ As of mid-2026, the severe supply shocks from the 2024\u20132025 avian flu have
     incognito: {
       text: "Incognito"
     },
+    learning_mode: {
+      text: "Learning Mode"
+    },
+    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."
+    },
     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 +42722,10 @@ async function main() {
       printSettingsHelp(client);
       return;
     }
+    if (command === "learning-mode") {
+      printLearningModeHelp();
+      return;
+    }
     if (command === "signup") {
       printSignupHelp();
       return;
@@ -42743,6 +42824,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 +45211,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 +45887,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 +45897,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 +47204,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 +47231,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-OSMG5HH3.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-OSMG5HH3.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.17",
   "description": "OpenMates CLI and SDK",
   "type": "module",
   "main": "dist/index.js",