@cortexkit/opencode-magic-context 0.27.3 → 0.28.0

package/dist/index.js

@@ -169,6 +169,98 @@ var init_logger = __esm(() => {
   }
 });
 
+// src/agents/language-directive.ts
+function resolveLanguageName(language) {
+  const code = typeof language === "string" ? language.trim().toLowerCase() : "";
+  if (!/^[a-z]{2}$/.test(code))
+    return "";
+  let english;
+  try {
+    english = ENGLISH_LANGUAGE_NAMES.of(code) ?? undefined;
+  } catch {
+    return "";
+  }
+  if (!english)
+    return "";
+  let endonym;
+  try {
+    endonym = new Intl.DisplayNames([code], { type: "language", fallback: "none" }).of(code) ?? undefined;
+  } catch {
+    endonym = undefined;
+  }
+  return endonym && endonym !== english ? `${english} (${endonym})` : english;
+}
+function isValidLanguageCode(language) {
+  return resolveLanguageName(language) !== "";
+}
+function buildContentLanguageDirective(language, options = {}) {
+  const target = resolveLanguageName(language);
+  if (!target)
+    return "";
+  const lines = [
+    "## Output language",
+    "",
+    `Write human-readable prose you author in: ${target}.`,
+    "",
+    "Do not translate or rename structural tokens. Copy required output schemas exactly:",
+    "- XML tag names, XML attribute names, JSON keys, tool names, tool-call argument keys, enum values, booleans/null, and required sentinel strings stay in English exactly as shown.",
+    "- Keep code identifiers, file paths, commands, config keys, CLI flags, URLs, commit hashes, model/provider IDs, stack traces, diagnostics, and transcript role markers such as U:, A:, and TC: verbatim.",
+    "- Localize only free-text prose values/content: summaries, memory text, explanations, titles, observations, and answers — unless the prompt says to preserve original wording.",
+    "",
+    "These literal values must remain English when used:",
+    "PROJECT_RULES, ARCHITECTURE, CONSTRAINTS, CONFIG_VALUES, NAMING;",
+    "causal_incident, trajectory_correction;",
+    "feature, design, docs, release, investigation, bug, refactor, infra;",
+    "memory, observation; true, false; No relevant memories found.",
+    "",
+    "Preserve the required output shape. Do not add commentary outside the requested XML/JSON/tool output."
+  ];
+  if (options.preserveUserQuotes) {
+    lines.push("", `Preserve U: lines and directly quoted user text in their original source language; write the surrounding summary prose in ${target}.`);
+  }
+  if (options.retrospective) {
+    lines.push("", `Write the lesson text in ${target}; paraphrase source text and never quote the user.`);
+  }
+  return lines.join(`
+`);
+}
+function withContentLanguageDirective(systemPrompt, language, options = {}) {
+  const directive = buildContentLanguageDirective(language, options);
+  return directive ? `${systemPrompt}
+
+${directive}` : systemPrompt;
+}
+function buildMigrationLanguageDirective(language) {
+  const target = resolveLanguageName(language);
+  if (!target)
+    return "";
+  return [
+    "## Output language",
+    "",
+    "Preserve each migrated memory's existing language — do NOT translate a memory just because an output language is set. When merging memories written in different languages, use the language of the clearest / source-majority memory; otherwise keep the source phrasing. Only the category re-mapping changes."
+  ].join(`
+`);
+}
+function withMigrationLanguageDirective(systemPrompt, language) {
+  const directive = buildMigrationLanguageDirective(language);
+  return directive ? `${systemPrompt}
+
+${directive}` : systemPrompt;
+}
+function buildPrimaryLanguageDirective(language) {
+  const target = resolveLanguageName(language);
+  if (!target)
+    return "";
+  return `Use ${target} for your natural-language replies to the user unless the user explicitly asks for another language. Keep code, identifiers, file paths, commands, logs, and quoted text verbatim.`;
+}
+var ENGLISH_LANGUAGE_NAMES;
+var init_language_directive = __esm(() => {
+  ENGLISH_LANGUAGE_NAMES = new Intl.DisplayNames(["en"], {
+    type: "language",
+    fallback: "none"
+  });
+});
+
 // src/shared/jsonc-parser.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
 function stripJsonComments(content) {
@@ -15155,6 +15247,7 @@ function defaultTaskConfig(task) {
 var DEFAULT_EXECUTE_THRESHOLD_PERCENTAGE = 65, EXECUTE_THRESHOLD_CAP_MESSAGE = "execute_threshold is capped at 80% for cache safety: a single large agent step can overflow the context window before Magic Context can compact between turns, forcing OpenCode's native compaction (hard to recover from). 80% also leaves headroom below the 85%/95% emergency bands. Use a value between 20 and 80.", DEFAULT_HISTORIAN_TIMEOUT_MS = 300000, DEFAULT_HISTORY_BUDGET_PERCENTAGE = 0.15, DEFAULT_LOCAL_EMBEDDING_MODEL = "Xenova/all-MiniLM-L6-v2", DreamingTaskSchema, PiThinkingLevelSchema, CronScheduleSchema, DreamTaskBaseConfigSchema, PromotionThresholdSchema, PrimerPromotionThresholdSchema, DreamTaskConfigSchema, ReviewUserMemoriesTaskConfigSchema, PromotePrimersTaskConfigSchema, DEFAULT_TASK_SCHEDULES, DreamTasksSchema, DreamerConfigSchema, SidekickConfigSchema, HistorianConfigSchema, BaseEmbeddingConfigSchema, EmbeddingConfigSchema, MagicContextConfigSchema;
 var init_magic_context = __esm(() => {
   init_zod();
+  init_language_directive();
   init_cron();
   init_task_registry();
   init_agent_overrides();
@@ -15276,6 +15369,7 @@ var init_magic_context = __esm(() => {
   MagicContextConfigSchema = exports_external.object({
     enabled: exports_external.boolean().default(true).describe("Enable magic context (default: true)"),
     auto_update: exports_external.boolean().optional().describe("Enable automatic npm self-update checks for the OpenCode plugin. Security: USER-only in config loader, so hostile project configs cannot suppress updates."),
+    language: exports_external.string().trim().toLowerCase().refine((s) => isValidLanguageCode(s), 'language must be a 2-letter ISO 639-1 code (e.g. "tr", "es", "de")').optional().describe("Output language for Magic Context's generated content and guidance, as a " + '2-letter ISO 639-1 code (e.g. "tr", "es", "de", "ja", "pt"). When set, the ' + "historian, dreamer, sidekick, and the agent-guidance block instruct the model to " + "write its PROSE in this language while keeping all structural tokens (XML tags, " + "the five memory category names, code identifiers, file paths) in English. " + "USER-LEVEL ONLY (ignored in project config for security). Unset = today's " + "behavior (model mirrors the conversation; English scaffolding). Changing it " + "triggers one cache re-materialization; existing compartments/memories keep their " + "original language until naturally rewritten."),
     ctx_reduce_enabled: exports_external.boolean().default(true).describe("When false, ctx_reduce tool is hidden, all nudges disabled, and prompt guidance about ctx_reduce stripped. Heuristic cleanup, compartments, memory, and other features still work. (default: true)"),
     historian: HistorianConfigSchema.describe("Historian agent configuration (model, fallback_models, variant, temperature, maxTokens, permission, two_pass, etc.)"),
     dreamer: DreamerConfigSchema.optional().describe("Dreamer agent + scheduling configuration (model, fallback_models, disable, schedule, tasks, etc.)"),
@@ -155736,10 +155830,18 @@ function getOldestActiveUnprotectedToolTags(db, sessionId, protectedTags = 0, li
                     WHERE session_id = ? AND status = 'active'
                     ORDER BY tag_number DESC LIMIT 1 OFFSET ?
                 )` : "";
-  const params = protectedTags > 0 ? [sessionId, sessionId, protectedTags - 1, boundedLimit] : [sessionId, boundedLimit];
+  const excludeStateTools = RECLAIM_HINT_EXCLUDED_LIST ? `AND (tool_name IS NULL OR tool_name NOT IN (${RECLAIM_HINT_EXCLUDED_LIST}))` : "";
+  const valueFloor = `AND (
+            (token_count IS NULL AND input_token_count IS NULL)
+            OR (COALESCE(token_count, 0) + COALESCE(input_token_count, 0)) >= ?
+        )`;
+  const params = protectedTags > 0 ? [sessionId, RECLAIM_HINT_MIN_TOKENS, sessionId, protectedTags - 1, boundedLimit] : [sessionId, RECLAIM_HINT_MIN_TOKENS, boundedLimit];
   const rows = db.prepare(`SELECT tag_number, tool_name
              FROM tags
-             WHERE session_id = ? AND status = 'active' AND type = 'tool' ${whereProtected}
+             WHERE session_id = ? AND status = 'active' AND type = 'tool'
+             ${excludeStateTools}
+             ${valueFloor}
+             ${whereProtected}
              ORDER BY tag_number ASC, id ASC
              LIMIT ?`).all(...params);
   return rows.filter((row) => typeof row.tag_number === "number").map((row) => ({
@@ -156129,7 +156231,7 @@ function deleteToolTagsByOwner(db, sessionId, ownerMsgId) {
   const result = getDeleteToolTagsByOwnerStatement(db).run(sessionId, ownerMsgId);
   return result.changes ?? 0;
 }
-var insertTagStatements, updateTagStatusStatements, updateTagDropModeStatements, updateTagMessageIdStatements, getTagNumbersByMessageIdStatements, deleteTagsByMessageIdStatements, getMaxTagNumberBySessionStatements, getTagNumberByMessageIdStatements, updateTagByteSizeStatements, updateTagInputByteSizeStatements, CONTENT_ID_SUFFIX, updateTagTokenCountStatements, updateTagInputTokenCountStatements, getOwnerScopedToolTagNumbersStatements, getMinMessageTagNumberForRawIdStatements, TAGGER_FLOOR_SCAN_MESSAGES = 8, TAGGER_FLOOR_MAX_PROBES = 64, TAGGER_FLOOR_SAFETY_MARGIN = 256, TAGGER_FLOOR_PER_SKIP_MARGIN = 64, TAG_SELECT_COLUMNS = "id, message_id, type, status, drop_mode, tool_name, input_byte_size, byte_size, reasoning_byte_size, session_id, tag_number, caveman_depth, tool_owner_message_id", getActiveTagsBySessionStatements, getMaxDroppedTagNumberStatements, getToolTagNumberByOwnerStatements, getNullOwnerToolTagStatements, adoptNullOwnerToolTagStatements, deleteToolTagsByOwnerStatements;
+var insertTagStatements, updateTagStatusStatements, updateTagDropModeStatements, updateTagMessageIdStatements, getTagNumbersByMessageIdStatements, deleteTagsByMessageIdStatements, getMaxTagNumberBySessionStatements, getTagNumberByMessageIdStatements, updateTagByteSizeStatements, updateTagInputByteSizeStatements, CONTENT_ID_SUFFIX, RECLAIM_HINT_EXCLUDED_TOOLS, RECLAIM_HINT_MIN_TOKENS = 250, RECLAIM_HINT_EXCLUDED_LIST, updateTagTokenCountStatements, updateTagInputTokenCountStatements, getOwnerScopedToolTagNumbersStatements, getMinMessageTagNumberForRawIdStatements, TAGGER_FLOOR_SCAN_MESSAGES = 8, TAGGER_FLOOR_MAX_PROBES = 64, TAGGER_FLOOR_SAFETY_MARGIN = 256, TAGGER_FLOOR_PER_SKIP_MARGIN = 64, TAG_SELECT_COLUMNS = "id, message_id, type, status, drop_mode, tool_name, input_byte_size, byte_size, reasoning_byte_size, session_id, tag_number, caveman_depth, tool_owner_message_id", getActiveTagsBySessionStatements, getMaxDroppedTagNumberStatements, getToolTagNumberByOwnerStatements, getNullOwnerToolTagStatements, adoptNullOwnerToolTagStatements, deleteToolTagsByOwnerStatements;
 var init_storage_tags = __esm(() => {
   insertTagStatements = new WeakMap;
   updateTagStatusStatements = new WeakMap;
@@ -156142,6 +156244,8 @@ var init_storage_tags = __esm(() => {
   updateTagByteSizeStatements = new WeakMap;
   updateTagInputByteSizeStatements = new WeakMap;
   CONTENT_ID_SUFFIX = /:(?:p|file)\d+$/;
+  RECLAIM_HINT_EXCLUDED_TOOLS = ["todowrite"];
+  RECLAIM_HINT_EXCLUDED_LIST = RECLAIM_HINT_EXCLUDED_TOOLS.map((name2) => `'${name2.replace(/'/g, "''")}'`).join(", ");
   updateTagTokenCountStatements = new WeakMap;
   updateTagInputTokenCountStatements = new WeakMap;
   getOwnerScopedToolTagNumbersStatements = new WeakMap;
@@ -165855,7 +165959,7 @@ __export(exports_task_config, {
   dreamTaskScheduled: () => dreamTaskScheduled,
   buildDreamTaskRuntimeConfigs: () => buildDreamTaskRuntimeConfigs
 });
-function buildDreamTaskRuntimeConfigs(dreamer) {
+function buildDreamTaskRuntimeConfigs(dreamer, language) {
   const tasks = dreamer.tasks ?? {};
   return CANONICAL_DREAM_TASKS.map((task) => {
     const t = tasks[task] ?? {
@@ -165871,6 +165975,7 @@ function buildDreamTaskRuntimeConfigs(dreamer) {
       model,
       fallbackModels,
       thinkingLevel,
+      language,
       timeoutMinutes: t.timeout_minutes ?? 20,
       promotionThreshold: t.promotion_threshold
     };
@@ -177223,8 +177328,8 @@ function buildHistorianFailureNotice(failureCount, lastError) {
   ].join(`
 `);
 }
-function buildHistorianRepairPrompt(originalPrompt, previousOutput, validationError) {
-  return [
+function buildHistorianRepairPrompt(originalPrompt, previousOutput, validationError, language) {
+  const prompt = [
     originalPrompt,
     "",
     "Your previous XML response was invalid and cannot be persisted.",
@@ -177237,6 +177342,7 @@ function buildHistorianRepairPrompt(originalPrompt, previousOutput, validationEr
     previousOutput
   ].join(`
 `);
+  return withContentLanguageDirective(prompt, language, { preserveUserQuotes: true });
 }
 function validateStoredCompartments(compartments) {
   if (compartments.length === 0) {
@@ -177313,6 +177419,7 @@ function getReducedRecompTokenBudget(currentBudget) {
 }
 var MIN_RECOMP_CHUNK_TOKEN_BUDGET = 20, HISTORIAN_PERSISTENT_FAILURE_THRESHOLD = 3;
 var init_compartment_runner_validation = __esm(async () => {
+  init_language_directive();
   init_compartment_parser();
   await init_compartment_runner_mapping();
 });
@@ -177350,7 +177457,7 @@ async function runValidatedHistorianPass(args) {
     return finalResult;
   }
   await args.callbacks?.onRepairRetry?.(firstValidation.error ?? "invalid compartment output");
-  const repairPrompt = buildHistorianRepairPrompt(args.prompt, firstRun.result, firstValidation.error ?? "invalid compartment output");
+  const repairPrompt = buildHistorianRepairPrompt(args.prompt, firstRun.result, firstValidation.error ?? "invalid compartment output", args.language);
   const repairRun = await runHistorianPrompt({
     ...args,
     prompt: repairPrompt,
@@ -182735,7 +182842,8 @@ ${chunkText}`,
       timeoutMs: historianTimeoutMs,
       fallbackModelId: deps.fallbackModelId,
       fallbackModels: deps.fallbackModels,
-      twoPass: deps.historianTwoPass
+      twoPass: deps.historianTwoPass,
+      language: deps.language
     });
     if (!validatedPass.ok) {
       sessionLog(sessionId, `historian failure: source=validation reason="${validatedPass.error}" chunkRange=${chunk.startIndex}-${chunk.endIndex} fallbackModel=${deps.fallbackModelId ?? "<none>"} twoPass=${deps.historianTwoPass ? "true" : "false"}`);
@@ -183211,6 +183319,7 @@ Historian pass ${passCount + 1}, attempt ${passAttempt} started for messages ${c
         twoPass: deps.historianTwoPass,
         subagentKind: "recomp",
         agentId: HISTORIAN_RECOMP_AGENT,
+        language: deps.language,
         callbacks: {
           onRepairRetry: async (error51) => {
             emitProgress(`Repair retry (pass ${passCount + 1})…`);
@@ -183653,6 +183762,7 @@ Historian pass ${passCount + 1}, attempt ${passAttempt} started for messages ${c
         twoPass: deps.historianTwoPass,
         subagentKind: "recomp",
         agentId: HISTORIAN_RECOMP_AGENT,
+        language: deps.language,
         callbacks: {
           onRepairRetry: async (error51) => {
             await sendIgnoredMessage(client, sessionId, `## Magic Recomp — Partial
@@ -186013,7 +186123,7 @@ async function runMemoryMigration(deps) {
           query: { directory },
           body: {
             agent: HISTORIAN_AGENT,
-            system: MIGRATION_SYSTEM_PROMPT,
+            system: withMigrationLanguageDirective(MIGRATION_SYSTEM_PROMPT, deps.language),
             ...modelOverride ? { model: modelOverride } : {},
             parts: [{ type: "text", text: prompt, synthetic: true }]
           }
@@ -186092,6 +186202,7 @@ async function runMemoryMigration(deps) {
 }
 var V2_CATEGORIES, MIGRATED_BLOCK_RE, USER_OBS_BLOCK_RE, CATEGORY_BLOCK_RE = (cat) => new RegExp(`<${cat}>([\\s\\S]*?)</${cat}>`), MIGRATION_SYSTEM_PROMPT;
 var init_memory_migration = __esm(async () => {
+  init_language_directive();
   init_shared();
   init_assistant_message_extractor();
   init_logger();
@@ -186208,6 +186319,7 @@ function buildRecompDeps(ctx, sessionId) {
     memoryEnabled: ctx.memoryEnabled,
     autoPromote: ctx.autoPromote,
     fallbackModels: ctx.fallbackModels,
+    language: ctx.language,
     fallbackModelId: ctx.fallbackModelId ?? resolveLiveModelKey(ctx.liveSessionState, sessionId),
     historianTwoPass: ctx.historianTwoPass,
     ensureProjectRegistered: ctx.ensureProjectRegistered,
@@ -186339,7 +186451,8 @@ async function runUpgradeMemoryMigration(ctx, sessionId, migrationDirectory) {
       primaryModelId: ctx.fallbackModelId ?? resolveLiveModelKey(ctx.liveSessionState, sessionId),
       fallbackModels: ctx.fallbackModels,
       timeoutMs: ctx.historianTimeoutMs,
-      userMemoriesEnabled: ctx.userMemoriesEnabled
+      userMemoriesEnabled: ctx.userMemoriesEnabled,
+      language: ctx.language
     });
     return outcome.summary;
   } catch (error51) {
@@ -186415,15 +186528,12 @@ function shouldShowAnnouncement() {
   }
   return ordering > 0;
 }
-var ANNOUNCEMENT_VERSION = "0.27.0", ANNOUNCEMENT_FEATURES, ANNOUNCEMENT_FOOTER = "Join us on Discord: https://discord.gg/F2uWxjGnU", STATE_FILENAME = "last_announced_version";
+var ANNOUNCEMENT_VERSION = "0.28.0", ANNOUNCEMENT_FEATURES, ANNOUNCEMENT_FOOTER = "Join us on Discord: https://discord.gg/F2uWxjGnU", STATE_FILENAME = "last_announced_version";
 var init_announcement = __esm(() => {
   init_data_path();
   ANNOUNCEMENT_FEATURES = [
-    "Dreamer V2: each maintenance task now runs on its own schedule (cron), with its own model. Configure them in setup, the dashboard, or magic-context.jsonc.",
-    "New 'classify' task scores each memory's importance so the most relevant stay in context as your work shifts; new 'retrospective' learns from moments you had to correct or re-explain. Both cache-safe, on by default, off anytime.",
-    "New Primers: durable answers to the questions that keep coming up about your project, kept current by the dreamer investigating the actual code.",
-    "Embedding storage no longer wipes your vectors when you change model or endpoint. Different models now coexist, so switching providers keeps your existing vectors.",
-    "Config moved to a shared CortexKit location (~/.config/cortexkit/ and <project>/.cortexkit/). This happens automatically on first run; your old file is preserved."
+    `New 'language' option: set a top-level 2-letter language code (e.g. "tr" or "es") and Magic Context writes its summaries, memories, and guidance in that language, while keeping all structure (tags, categories, code, paths) in English. User-level only, off by default.`,
+    "The ctx_reduce reminder now reflects how much tool output is actually reclaimable, instead of escalating to 'urgent' just because you're near compaction. It also no longer suggests dropping the agent's task list or tiny status outputs."
   ];
 });
 
@@ -186717,6 +186827,9 @@ function buildHiddenAgentConfig(prompt, allowedTools, maxSteps, overrides, agent
   };
 }
 
+// src/index.ts
+init_language_directive();
+
 // src/config/index.ts
 init_jsonc_parser();
 import { existsSync as existsSync5, readFileSync as readFileSync5 } from "node:fs";
@@ -187461,6 +187574,10 @@ function stripUnsafeProjectConfigFields(projectRaw) {
     delete projectRaw.auto_update;
     warnings.push("Ignoring auto_update from project config (security: this setting only honors user-level config).");
   }
+  if ("language" in projectRaw) {
+    delete projectRaw.language;
+    warnings.push("Ignoring language from project config (security: output language is a user-level setting).");
+  }
   if ("sqlite" in projectRaw) {
     delete projectRaw.sqlite;
     warnings.push("Ignoring sqlite.* from project config (security: SQLite cache/mmap PRAGMAs apply to the " + "process-global shared database handle; only user-level config may set them).");
@@ -188293,6 +188410,9 @@ function buildDreamTaskPrompt(task, args) {
 // src/index.ts
 init_project_identity();
 
+// src/features/magic-context/sidekick/agent.ts
+init_language_directive();
+
 // src/agents/sidekick.ts
 var SIDEKICK_AGENT = "sidekick";
 
@@ -188360,12 +188480,13 @@ async function runSidekick(deps) {
       throw error51;
     }
     const childSessionId = agentSessionId;
+    const systemPrompt = withContentLanguageDirective(deps.config.system_prompt?.trim() || deps.config.prompt?.trim() || SIDEKICK_SYSTEM_PROMPT, deps.language);
     const sidekickRun = await promptSyncWithValidatedOutputRetry(deps.client, {
       path: { id: childSessionId },
       query: { directory: deps.sessionDirectory ?? deps.projectPath },
       body: {
         agent: SIDEKICK_AGENT,
-        system: deps.config.system_prompt?.trim() || deps.config.prompt?.trim() || SIDEKICK_SYSTEM_PROMPT,
+        system: systemPrompt,
         parts: [{ type: "text", text: deps.userMessage, synthetic: true }]
       }
     }, {
@@ -189928,6 +190049,7 @@ var DREAMER_DOCS_AGENT = "dreamer-docs";
 var DREAMER_REVIEWER_AGENT = "dreamer-reviewer";
 
 // src/features/magic-context/dreamer/task-executor.ts
+init_language_directive();
 init_shared();
 init_assistant_message_extractor();
 init_logger();
@@ -189936,6 +190058,7 @@ init_memory();
 init_subagent_token_capture();
 
 // src/features/magic-context/user-memory/review-user-memories.ts
+init_language_directive();
 init_shared();
 init_assistant_message_extractor();
 init_logger();
@@ -190050,7 +190173,7 @@ If no promotions are warranted, return empty arrays. Always consume reviewed can
       query: { directory: args.sessionDirectory },
       body: {
         agent: DREAMER_REVIEWER_AGENT,
-        system: REVIEW_USER_MEMORIES_SYSTEM_PROMPT,
+        system: withContentLanguageDirective(REVIEW_USER_MEMORIES_SYSTEM_PROMPT, args.language),
         ...modelBodyField(args.model),
         parts: [{ type: "text", text: prompt, synthetic: true }]
       }
@@ -192634,6 +192757,7 @@ async function promotePrimers(args) {
 }
 
 // src/features/magic-context/dreamer/refresh-primers.ts
+init_language_directive();
 init_read_session_formatting();
 init_shared();
 init_assistant_message_extractor();
@@ -192872,7 +192996,7 @@ async function refreshOnePrimer(args, primer, sliceMs, signal) {
       query: { directory: args.sessionDirectory },
       body: {
         agent: DREAMER_PRIMER_INVESTIGATOR_AGENT,
-        system: PRIMER_INVESTIGATOR_SYSTEM_PROMPT,
+        system: withContentLanguageDirective(PRIMER_INVESTIGATOR_SYSTEM_PROMPT, args.language),
         ...modelBodyField(args.model),
         parts: [{ type: "text", text: prompt, synthetic: true }]
       }
@@ -193108,6 +193232,7 @@ function insertDreamRun(db, run) {
 init_task_registry();
 
 // src/features/magic-context/dreamer/verify.ts
+init_language_directive();
 init_shared();
 init_assistant_message_extractor();
 init_logger();
@@ -193335,7 +193460,7 @@ async function verifyOneBatch(args, batch, sliceMs, signal) {
       query: { directory: args.sessionDirectory },
       body: {
         agent: DREAMER_MEMORY_MAPPER_AGENT,
-        system: VERIFY_SYSTEM_PROMPT,
+        system: withContentLanguageDirective(VERIFY_SYSTEM_PROMPT, args.language),
         ...modelBodyField(args.model),
         parts: [{ type: "text", text: prompt, synthetic: true }]
       }
@@ -193615,7 +193740,8 @@ function createDreamTaskExecutor(deps) {
           deadline,
           promotionThreshold: config2.promotionThreshold ?? 3,
           model: config2.model,
-          fallbackModels: config2.fallbackModels
+          fallbackModels: config2.fallbackModels,
+          language: config2.language ?? deps.language
         });
         recordRun("completed", null);
         log(`[dreamer] review-user-memories: promoted=${result.promoted} merged=${result.merged} dismissed=${result.dismissed}`);
@@ -193651,7 +193777,8 @@ function createDreamTaskExecutor(deps) {
           deadline,
           forceBroad: config2.task === "verify-broad",
           model: config2.model,
-          fallbackModels: config2.fallbackModels
+          fallbackModels: config2.fallbackModels,
+          language: config2.language ?? deps.language
         });
         recordRun("completed", null, {
           memoryChanges: computeMemoryDelta(memoryBefore)
@@ -193703,6 +193830,7 @@ function createDreamTaskExecutor(deps) {
           deadline,
           model: config2.model,
           fallbackModels: config2.fallbackModels,
+          language: config2.language ?? deps.language,
           rawProviderFactory: deps.primerRawProviderFactory
         });
         recordRun("completed", null);
@@ -193820,6 +193948,7 @@ function retrospectiveEventsForSessions(db, sessionIds) {
     try {
       for (const event of getCompartmentEvents(db, sessionId)) {
         if (event.kind !== "causal_incident" && event.kind !== "trajectory_correction") {
+          log(`[dreamer] dropping event: unknown kind="${event.kind}"`);
           continue;
         }
         events.push({
@@ -193944,7 +194073,9 @@ async function runRetrospectiveTask(config2, ctx, helpers) {
     const frictionWindow = renderFrictionWindow(messages, flagged.map((message) => message.ordinal));
     const eventSessionIds = new Set(messages.map((message) => message.sessionId));
     const events = retrospectiveEventsForSessions(db, eventSessionIds);
-    const deepenRun = await runChildTurn(RETROSPECTIVE_SYSTEM_PROMPT, buildRetrospectivePrompt({ projectPath: projectIdentity, frictionWindow, events }));
+    const deepenRun = await runChildTurn(withContentLanguageDirective(RETROSPECTIVE_SYSTEM_PROMPT, config2.language ?? deps.language, {
+      retrospective: true
+    }), buildRetrospectivePrompt({ projectPath: projectIdentity, frictionWindow, events }));
     if (leaseLost)
       throw new Error("Dream lease lost during retrospective");
     const sourceSessionId = flagged[0]?.sessionId ?? userMessages[0]?.sessionId ?? "retrospective";
@@ -194030,7 +194161,7 @@ async function runAgenticTask(config2, ctx, helpers) {
       query: { directory: docsDir },
       body: {
         agent: task === "maintain-docs" ? DREAMER_DOCS_AGENT : DREAMER_AGENT,
-        system: task === "maintain-docs" ? MAINTAIN_DOCS_SYSTEM_PROMPT : CURATE_SYSTEM_PROMPT,
+        system: task === "maintain-docs" ? MAINTAIN_DOCS_SYSTEM_PROMPT : withContentLanguageDirective(CURATE_SYSTEM_PROMPT, config2.language ?? deps.language),
         ...modelBodyField(config2.model),
         parts: [{ type: "text", text: taskPrompt, synthetic: true }]
       }
@@ -194852,7 +194983,7 @@ async function sweepProject(reg, origin, db, gitCommitEnabled) {
   }
   try {
     await runCompiledSmartNoteSweep(reg, db);
-    const runtimeConfigs = buildDreamTaskRuntimeConfigs(dreamerConfig);
+    const runtimeConfigs = buildDreamTaskRuntimeConfigs(dreamerConfig, reg.language);
     const executor = createDreamTaskExecutor({
       client: reg.client,
       sessionDirectory: reg.directory,
@@ -194860,7 +194991,8 @@ async function sweepProject(reg, origin, db, gitCommitEnabled) {
       retrospectiveRawProvider: reg.retrospectiveRawProvider ?? ((db2) => new OpenCodeRetrospectiveRawProvider({ contextDb: db2, openOpenCodeDb })),
       primerRawProviderFactory: reg.primerRawProviderFactory,
       userMemoryCollectionEnabled: userMemoryCollectionEnabled(dreamerConfig),
-      ensureProjectRegistered: reg.ensureRegistered
+      ensureProjectRegistered: reg.ensureRegistered,
+      language: reg.language
     });
     const ran = await runDueTasksForProject({
       db,
@@ -196224,7 +196356,8 @@ Provide a prompt to augment with project memory context.`, {});
     projectPath: deps.sidekick.projectPath,
     sessionDirectory: deps.sidekick.sessionDirectory,
     userMessage: prompt,
-    config: deps.sidekick.config
+    config: deps.sidekick.config,
+    language: deps.sidekick.language
   });
   let augmentedPrompt;
   if (sidekickResult) {
@@ -196831,6 +196964,7 @@ function channel1RefireTokens(workingWindowTokens) {
 var S_GENTLE = 0.2;
 var S_FIRM = 0.4;
 var S_URGENT = 0.65;
+var CHANNEL1_PRESSURE_FLOOR = 0.8;
 var LEVEL_RANK = { gentle: 1, firm: 2, urgent: 3 };
 var DROP_SENTINELS = ["[dropped", "[truncated"];
 function isDroppedToolOutput(output) {
@@ -196895,7 +197029,8 @@ function computeTailTokenEstimate(messages) {
   };
 }
 function decideChannel1(input) {
-  const { undroppedTokens, pressure, workingWindowTokens, hasRecentReduce } = input;
+  const { undroppedTokens, workingWindowTokens, hasRecentReduce } = input;
+  const pressure = Math.min(1, Math.max(0, input.pressure));
   const resetCycle = hasRecentReduce || undroppedTokens < input.lastNudgeUndropped;
   const lastNudge = resetCycle ? 0 : input.lastNudgeUndropped;
   const lastLevel = resetCycle ? "" : input.lastNudgeLevel;
@@ -196910,8 +197045,10 @@ function decideChannel1(input) {
     return quiet();
   if (undroppedTokens < CHANNEL1_FLOOR_TOKENS)
     return quiet();
-  const budget = workingWindowTokens > 0 ? workingWindowTokens : undroppedTokens || 1;
-  const severity = undroppedTokens / budget * pressure;
+  if (pressure < CHANNEL1_PRESSURE_FLOOR)
+    return quiet();
+  const denom = Math.max(input.estimatedInputTokens, 1);
+  const severity = Math.min(1, undroppedTokens / denom);
   if (severity < S_GENTLE)
     return quiet();
   let level;
@@ -202764,6 +202901,7 @@ function maybeInjectChannel1Nudge(args, sessionId, tool, output) {
   const decision = decideChannel1({
     undroppedTokens,
     pressure,
+    estimatedInputTokens: state.lastInputTokens + state.turnToolTokens,
     workingWindowTokens,
     lastNudgeUndropped: getLastNudgeUndropped(args.db, sessionId),
     lastNudgeLevel: getLastNudgeLevel(args.db, sessionId),
@@ -202829,6 +202967,7 @@ init_send_session_notification();
 import { createHash as createHash13 } from "node:crypto";
 
 // src/agents/magic-context-prompt.ts
+init_language_directive();
 var LONG_TERM_PARTNER_FRAME = `### You are the user's long-term partner on this project — not a one-off hire
 
 Most AI sessions are disposable: one session per task, discarded when it's done — like hiring a developer for a single bug fix and letting them go the moment they finish. Magic Context changes this completely. This session is a durable working relationship: you carry the full history and accumulated knowledge of this project, and you continue across many tasks, bugs, and features — with memory that persists across restarts. This session may continue for weeks, months, or even years.
@@ -202907,7 +203046,7 @@ Drop silently — do not narrate it. NEVER drop large ranges blindly (e.g., "1-5
 Older tool calls may show \`[dropped §N§]\` sentinels; that is normal context management, not a pattern to copy. ALWAYS make fresh real tool calls when you need data again; never fabricate or inline tool output.`;
 var CAVEMAN_COMPRESSION_WARNING = `
 **BEWARE**: History compression is on; older user AND assistant text — including your own earlier responses — has been deterministically rewritten in a terse caveman style (dropped articles, missing auxiliaries, \`//\` instead of connectives like \`because\`). This is automatic context compression that runs after the fact, not your actual prior wording or the user's. **DO NOT mimic this style in new turns.** Write fresh responses in normal prose. If you notice your output drifting into caveman cadence, that drift is in-context-learning bleeding from the compressed history — consciously revert to full sentences.`;
-function buildMagicContextSection(_agent, protectedTags, ctxReduceEnabled = true, dreamerEnabled = false, temporalAwarenessEnabled = false, cavemanTextCompressionEnabled = false, subagentMode = false) {
+function buildMagicContextSection(_agent, protectedTags, ctxReduceEnabled = true, dreamerEnabled = false, temporalAwarenessEnabled = false, cavemanTextCompressionEnabled = false, subagentMode = false, language) {
   if (subagentMode) {
     return `## Magic Context
 
@@ -202919,13 +203058,17 @@ The dreamer evaluates smart note conditions during nightly runs and surfaces the
 Example: \`ctx_note(action="write", content="Implement X because Y", surface_condition="When PR #42 is merged in this repo")\`` : "";
   const temporalGuidance = temporalAwarenessEnabled ? TEMPORAL_AWARENESS_GUIDANCE : "";
   const cavemanWarning = cavemanTextCompressionEnabled && !ctxReduceEnabled ? CAVEMAN_COMPRESSION_WARNING : "";
+  const languageDirective = buildPrimaryLanguageDirective(language);
+  const languageGuidance = languageDirective ? `
+
+${languageDirective}` : "";
   if (!ctxReduceEnabled) {
     return `## Magic Context
 
 ${LONG_TERM_PARTNER_FRAME}
 ${PARTNER_FRAME_CLOSER_NO_REDUCE}
 
-${BASE_INTRO_NO_REDUCE()}${smartNoteGuidance}${temporalGuidance}${cavemanWarning}`;
+${BASE_INTRO_NO_REDUCE()}${smartNoteGuidance}${temporalGuidance}${cavemanWarning}${languageGuidance}`;
   }
   return `## Magic Context
 
@@ -202935,7 +203078,7 @@ ${PARTNER_FRAME_CLOSER_REDUCE}
 ${BASE_INTRO(protectedTags)}${smartNoteGuidance}${temporalGuidance}
 ${GENERIC_SECTION}
 
-Prefer many small targeted operations over one large blanket operation, and keep the working set tidy as routine maintenance.`;
+Prefer many small targeted operations over one large blanket operation, and keep the working set tidy as routine maintenance.${languageGuidance}`;
 }
 
 // src/hooks/magic-context/system-prompt-hash.ts
@@ -202993,7 +203136,7 @@ function createSystemPromptHashHandler(deps) {
     const fullPrompt = output.system.join(`
 `);
     if (fullPrompt.length > 0 && !fullPrompt.includes(MAGIC_CONTEXT_MARKER) && !skipGuidanceForDisabledSubagent) {
-      const guidance = buildMagicContextSection(null, deps.protectedTags, effectiveCtxReduceEnabled, deps.dreamerEnabled, deps.experimentalTemporalAwareness, deps.experimentalCavemanTextCompression, subagentReduceMode);
+      const guidance = buildMagicContextSection(null, deps.protectedTags, effectiveCtxReduceEnabled, deps.dreamerEnabled, deps.experimentalTemporalAwareness, deps.experimentalCavemanTextCompression, subagentReduceMode, deps.language);
       output.system.push(guidance);
       sessionLog(sessionId, `injected generic guidance into system prompt (ctxReduce=${effectiveCtxReduceEnabled}, subagent=${isSubagentSession}, subagentReduceMode=${subagentReduceMode})`);
     }
@@ -203281,6 +203424,7 @@ function createMagicContextHook(deps) {
     memoryEnabled: deps.config.memory?.enabled ?? true,
     autoPromote: deps.config.memory?.auto_promote ?? true,
     fallbackModels: historianFallbackModels,
+    language: deps.config.language,
     fallbackModelId: (() => {
       const model = resolveLiveModel(sessionId);
       return model ? `${model.providerID}/${model.modelID}` : undefined;
@@ -203319,7 +203463,7 @@ function createMagicContextHook(deps) {
         signal,
         onProgress: ({ embedded, total }) => {
           const cur = recompProgressBySession.get(sessionId);
-          if (!cur || cur.phase !== "recomp")
+          if (cur?.phase !== "recomp")
             return;
           recompProgressBySession.set(sessionId, {
             ...cur,
@@ -203522,7 +203666,7 @@ function createMagicContextHook(deps) {
       return;
     }
     lastScheduleCheckMs = now;
-    const runtimeConfigs = buildDreamTaskRuntimeConfigs(dreaming);
+    const runtimeConfigs = buildDreamTaskRuntimeConfigs(dreaming, deps.config.language);
     const executor = createDreamTaskExecutor({
       client: deps.client,
       sessionDirectory: deps.directory,
@@ -203531,7 +203675,8 @@ function createMagicContextHook(deps) {
         contextDb: providerDb,
         openOpenCodeDb
       }),
-      userMemoryCollectionEnabled: userMemoryCollectionEnabled(dreaming)
+      userMemoryCollectionEnabled: userMemoryCollectionEnabled(dreaming),
+      language: deps.config.language
     });
     runDueTasksForProject({
       db,
@@ -203580,7 +203725,8 @@ function createMagicContextHook(deps) {
       config: sidekickConfig,
       projectPath,
       sessionDirectory: deps.directory,
-      client: deps.client
+      client: deps.client,
+      language: deps.config.language
     } : undefined,
     dreamer: dreamerConfig ? {
       config: dreamerConfig,
@@ -203588,7 +203734,7 @@ function createMagicContextHook(deps) {
       runManual: (task) => runManualDream({
         db,
         projectIdentity: projectPath,
-        tasks: buildDreamTaskRuntimeConfigs(dreamerConfig),
+        tasks: buildDreamTaskRuntimeConfigs(dreamerConfig, deps.config.language),
         executor: createDreamTaskExecutor({
           client: deps.client,
           sessionDirectory: deps.directory,
@@ -203597,7 +203743,8 @@ function createMagicContextHook(deps) {
             contextDb: providerDb,
             openOpenCodeDb
           }),
-          userMemoryCollectionEnabled: userMemoryCollectionEnabled(dreamerConfig)
+          userMemoryCollectionEnabled: userMemoryCollectionEnabled(dreamerConfig),
+          language: deps.config.language
         }),
         task
       })
@@ -203608,6 +203755,7 @@ function createMagicContextHook(deps) {
     protectedTags: deps.config.protected_tags,
     ctxReduceEnabled,
     dreamerEnabled: dreamerRunnable,
+    language: deps.config.language,
     injectDocs: deps.config.dreamer?.inject_docs !== false,
     directory: deps.directory,
     historyRefreshSessions,
@@ -206339,6 +206487,7 @@ var server2 = async (ctx) => {
       projectIdentity: resolveProjectIdentity(ctx.directory),
       client: ctx.client,
       dreamerConfig: dreamerRunnable ? pluginConfig.dreamer : undefined,
+      language: pluginConfig.language,
       embeddingConfig: pluginConfig.embedding,
       memoryEnabled: pluginConfig.memory?.enabled === true,
       gitCommitIndexing: pluginConfig.memory.git_commit_indexing?.enabled ? {
@@ -206510,9 +206659,9 @@ var server2 = async (ctx) => {
         const registrations = buildHiddenAgentRegistrations({
           dreamerPrompt: DREAMER_SYSTEM_PROMPT,
           smartNoteCompilerPrompt: SMART_NOTE_COMPILER_SYSTEM_PROMPT,
-          historianPrompt: COMPARTMENT_AGENT_SYSTEM_PROMPT,
-          historianRecompPrompt: COMPARTMENT_STRUCTURAL_SYSTEM_PROMPT,
-          historianEditorPrompt: HISTORIAN_EDITOR_SYSTEM_PROMPT,
+          historianPrompt: withContentLanguageDirective(COMPARTMENT_AGENT_SYSTEM_PROMPT, pluginConfig.language, { preserveUserQuotes: true }),
+          historianRecompPrompt: withContentLanguageDirective(COMPARTMENT_STRUCTURAL_SYSTEM_PROMPT, pluginConfig.language, { preserveUserQuotes: true }),
+          historianEditorPrompt: withContentLanguageDirective(HISTORIAN_EDITOR_SYSTEM_PROMPT, pluginConfig.language, { preserveUserQuotes: true }),
           sidekickPrompt: SIDEKICK_SYSTEM_PROMPT,
           dreamerOverrides: dreamerAgentOverrides,
           historianOverrides: historianAgentOverrides,

package/dist/plugin/dream-timer.d.ts

@@ -14,6 +14,7 @@ interface ProjectRegistration {
     projectIdentity: string;
     client: PluginContext["client"];
     dreamerConfig?: DreamerConfig;
+    language?: string;
     gitCommitIndexing?: {
         enabled: boolean;
         since_days: number;