opencode-resolve 0.1.13 → 0.1.16

package/dist/agents.js

@@ -27,14 +27,14 @@ export const DEFAULT_AGENT_CONFIG = {
             "Together with Resolver you form a verified resolve loop.",
             "",
             "Read ONLY files you need. Make the SMALLEST correct change.",
-            "Verify: type check or lint on changed files. Report exit code + errors.",
+            "Verify: type check or lint on changed files. Full-repo lint is optional; if it fails outside your changes, report that as unrelated instead of chasing it.",
             "After editing: check LSP diagnostics (if available) for the file. If errors remain, fix before reporting.",
             "Return: changed files + verification result. No unnecessary prose.",
             "Dispatch explorer ONLY to locate 3+ unknown files. Otherwise use local read/grep/glob.",
             "",
             "NO EVIDENCE = INCOMPLETE WORK.",
             "",
-            "NEVER: as any / @ts-ignore / empty catch / delete failing tests / leave code broken / commit without request.",
+            "NEVER: as any / @ts-ignore / empty catch / delete failing tests / leave code broken / commit without request / git add . / git add -A / stage unrelated files.",
         ].join("\n"),
         permission: {
             edit: "allow",
@@ -236,23 +236,23 @@ export const GLM_CODER_PROMPT = [
     "You are Coder (GLM profile), a concise implementation subagent for OpenCode Resolve.",
     "",
     "Read ONLY files you will edit. Make the SMALLEST correct change.",
-    "Verify immediately: type check or lint on changed files. Check LSP diagnostics when available. Report exit code + errors.",
+    "Verify immediately: type check or lint on changed files. Full-repo lint is optional; if it fails outside your changes, report that as unrelated. Check LSP diagnostics when available. Report exit code + errors.",
     "Return: changed files + verification result. No prose.",
     "",
     "NO EVIDENCE = INCOMPLETE WORK.",
     "",
-    "NEVER: as any / @ts-ignore / empty catch / delete failing tests / leave code broken.",
+    "NEVER: as any / @ts-ignore / empty catch / delete failing tests / leave code broken / commit without request / git add . / git add -A / stage unrelated files.",
 ].join("\n");
 export const GPT_CODER_PROMPT = [
     "You are Coder (GPT profile), an implementation subagent for OpenCode Resolve.",
     "",
     "Read ONLY files you need. Make the SMALLEST correct change.",
-    "Verify: type check or lint on changed files. Check LSP diagnostics when available. Report exit code + errors.",
+    "Verify: type check or lint on changed files. Full-repo lint is optional; if it fails outside your changes, report that as unrelated. Check LSP diagnostics when available. Report exit code + errors.",
     "Return: changed files + verification result. Keep it concise.",
     "",
     "NO EVIDENCE = INCOMPLETE WORK.",
     "",
-    "NEVER: as any / @ts-ignore / empty catch / delete failing tests / leave code broken.",
+    "NEVER: as any / @ts-ignore / empty catch / delete failing tests / leave code broken / commit without request / git add . / git add -A / stage unrelated files.",
 ].join("\n");
 export function buildGLMResolverPrompt(maxParallelSubagents) {
     const limit = typeof maxParallelSubagents === "number" && Number.isFinite(maxParallelSubagents)
@@ -277,10 +277,10 @@ export function buildGLMResolverPrompt(maxParallelSubagents) {
         "",
         "If piloci MCP available: piloci_recall before inspecting code, piloci_memory after learning something non-obvious.",
         "",
-        "Verify: type check or lint MUST pass on changed files. NO EVIDENCE = NOT COMPLETE.",
+        "Verify: type check or lint MUST pass on changed files. Full-repo lint is optional; if it fails outside your changes, report the unrelated failure instead of fixing unrelated files. NO EVIDENCE = NOT COMPLETE.",
         "After non-trivial work: ask user to capture lesson → HARNESS.md (infra) or AGENTS.md (agent behavior).",
         "",
-        "NEVER: as any / @ts-ignore / leave code broken / delete failing tests / commit without request.",
+        "NEVER: as any / @ts-ignore / leave code broken / delete failing tests / commit without request / git add . / git add -A / stage unrelated files.",
         "",
         "Specialists: explorer (scope unknown), reviewer (verification gap), debugger (verify failure diagnosis), planner (user asks for plan). No deep-reviewer.",
         "",
@@ -302,10 +302,10 @@ export function buildGPTResolverPrompt() {
         "",
         "If piloci MCP available: piloci_recall before inspecting code, piloci_memory after learning something non-obvious.",
         "",
-        "Verify: type check or lint MUST pass on changed files. NO EVIDENCE = NOT COMPLETE.",
+        "Verify: type check or lint MUST pass on changed files. Full-repo lint is optional; if it fails outside your changes, report the unrelated failure instead of fixing unrelated files. NO EVIDENCE = NOT COMPLETE.",
         "After non-trivial work: ask user to capture lesson → HARNESS.md (infra) or AGENTS.md (agent behavior).",
         "",
-        "NEVER: as any / @ts-ignore / leave code broken / delete failing tests / commit without request.",
+        "NEVER: as any / @ts-ignore / leave code broken / delete failing tests / commit without request / git add . / git add -A / stage unrelated files.",
         "",
         "Specialists: explorer (scope unknown), reviewer (verification gap), deep-reviewer (risky/security/architectural), debugger (verify failure diagnosis), planner (user asks for plan).",
         "",
@@ -324,9 +324,9 @@ export function buildCodexResolverPrompt() {
         "Trivial fixes → apply yourself. No subagent needed.",
         "3 consecutive failures → STOP, REVERT, REPORT, ASK user.",
         "",
-        "Verify: type check or lint MUST pass on changed files. Check LSP diagnostics when available. NO EVIDENCE = NOT COMPLETE.",
+        "Verify: type check or lint MUST pass on changed files. Full-repo lint is optional; if it fails outside your changes, report the unrelated failure instead of fixing unrelated files. Check LSP diagnostics when available. NO EVIDENCE = NOT COMPLETE.",
         "",
-        "NEVER: as any / @ts-ignore / leave code broken / delete failing tests / commit without request.",
+        "NEVER: as any / @ts-ignore / leave code broken / delete failing tests / commit without request / git add . / git add -A / stage unrelated files.",
         "",
         "CONTINUATION: After context compression or any intermediate step, immediately continue the current task. Do NOT pause, summarize status, or ask the user unless you face a CRITICAL decision requiring their input (destructive action, ambiguous requirement, security concern). Keep moving.",
     ].join("\n");
@@ -355,10 +355,10 @@ export function buildResolverPrompt(maxParallelSubagents) {
         "",
         "If piloci MCP available: piloci_recall before inspecting code, piloci_memory after learning something non-obvious.",
         "",
-        "Verify: type check or lint MUST pass on changed files. Check LSP diagnostics when available. NO EVIDENCE = NOT COMPLETE.",
+        "Verify: type check or lint MUST pass on changed files. Full-repo lint is optional; if it fails outside your changes, report the unrelated failure instead of fixing unrelated files. Check LSP diagnostics when available. NO EVIDENCE = NOT COMPLETE.",
         "After non-trivial work: ask user to capture lesson → HARNESS.md (infra) or AGENTS.md (agent behavior).",
         "",
-        "NEVER: as any / @ts-ignore / leave code broken / delete failing tests / commit without request.",
+        "NEVER: as any / @ts-ignore / leave code broken / delete failing tests / commit without request / git add . / git add -A / stage unrelated files.",
         "",
         "Specialists: explorer (scope unknown), reviewer (verification gap), deep-reviewer (risky/security/architectural), debugger (verify failure diagnosis), planner (user asks for plan).",
         "",

package/dist/config.d.ts

@@ -27,3 +27,4 @@ export declare const VALID_TOP_LEVEL_KEYS: Set<string>;
 export declare const VALID_AGENT_KEYS: Set<string>;
 export declare const VALID_MODES: Set<string>;
 export declare const VALID_PERMISSION_VALUES: Set<string>;
+export declare const VALID_LANGUAGES: Set<string>;

package/dist/config.js

@@ -138,6 +138,7 @@ export function mergeResolveConfig(...configs) {
         result.autoApprove = config.autoApprove ?? result.autoApprove;
         result.maxParallelSubagents = config.maxParallelSubagents ?? result.maxParallelSubagents;
         result.autoUpdate = config.autoUpdate ?? result.autoUpdate;
+        result.language = config.language ?? result.language;
         result.models = { ...result.models, ...config.models };
         result.agents = mergeAgents(result.agents, config.agents);
     }
@@ -244,6 +245,13 @@ export function normalizeResolveConfig(value, source) {
         }
         result.tier = tier;
     }
+    if (config.language !== undefined) {
+        const language = expectString(config.language, `${source}.language`);
+        if (!VALID_LANGUAGES.has(language)) {
+            throw new Error(`Unknown language "${language}" in ${source}.language. Valid: ${[...VALID_LANGUAGES].join(", ")}`);
+        }
+        result.language = language;
+    }
     if (config.maxParallelSubagents !== undefined) {
         const limit = expectNumber(config.maxParallelSubagents, `${source}.maxParallelSubagents`);
         if (!Number.isInteger(limit) || limit < 1) {
@@ -387,6 +395,7 @@ export const VALID_TOP_LEVEL_KEYS = new Set([
     "autoApprove",
     "maxParallelSubagents",
     "autoUpdate",
+    "language",
     "config",
 ]);
 export const VALID_AGENT_KEYS = new Set([
@@ -402,3 +411,4 @@ export const VALID_AGENT_KEYS = new Set([
 ]);
 export const VALID_MODES = new Set(["subagent", "primary", "all"]);
 export const VALID_PERMISSION_VALUES = new Set(["ask", "allow", "deny"]);
+export const VALID_LANGUAGES = new Set(["auto", "en", "ko"]);

package/dist/hooks/index.js

@@ -1,12 +1,82 @@
 import { DIAGNOSTICS_TTL_MS, FAILURE_PATTERN_TTL_MS, FAILURE_THRESHOLD, STRATEGY_PIVOT_THRESHOLD, EDIT_HOTSPOT_TTL_MS, EDIT_HOTSPOT_THRESHOLD } from "../state.js";
 import { classifyBashCommand, maybeAutoUpdate, detectProjectContext } from "../utils.js";
 import { loadResolveConfig, applyResolveConfig } from "../config.js";
+import { contextMessage, narrate, resolveLocale, t, agentDisplayName, PLUGIN_BRAND } from "../messages.js";
 function capTemperature(current, cap) {
     return typeof current === "number" && Number.isFinite(current)
         ? Math.min(current, cap)
         : cap;
 }
+const DISPATCH_KEYS = {
+    coder: "dispatch.coder",
+    reviewer: "dispatch.reviewer",
+    "deep-reviewer": "dispatch.deepReviewer",
+    explorer: "dispatch.explorer",
+    planner: "dispatch.planner",
+    architect: "dispatch.architect",
+    researcher: "dispatch.researcher",
+    debugger: "dispatch.debugger",
+    codex: "dispatch.codex",
+    glm: "dispatch.glm",
+    gpt: "dispatch.gpt",
+    "gpt-coder": "dispatch.gptCoder",
+};
+function extractSubagentType(args) {
+    if (!args || typeof args !== "object")
+        return undefined;
+    const candidate = args.subagent_type ?? args.subagentType ?? args.agent ?? args.type ?? args.role;
+    return typeof candidate === "string" && candidate.length > 0 ? candidate : undefined;
+}
+function extractDispatchGoal(args) {
+    if (!args || typeof args !== "object")
+        return "";
+    const candidate = args.description ?? args.title ?? args.task ?? args.prompt;
+    if (typeof candidate !== "string")
+        return "";
+    const trimmed = candidate.trim().split("\n")[0] ?? "";
+    return trimmed.length > 80 ? trimmed.slice(0, 77) + "…" : trimmed;
+}
 export function getHooks(directory, options, sessionState) {
+    const narrateToolStart = (input, output) => {
+        const tool = input.tool;
+        if (tool === "task") {
+            const sub = extractSubagentType(output?.args ?? input?.args);
+            if (!sub)
+                return;
+            const goal = extractDispatchGoal(output?.args ?? input?.args);
+            const to = agentDisplayName(sub, sessionState.locale);
+            const key = DISPATCH_KEYS[sub] ?? "dispatch.fromResolver";
+            narrate(sessionState, key, { to, goal });
+            return;
+        }
+        if (tool === "edit" || tool === "write") {
+            narrate(sessionState, "narration.editing");
+            return;
+        }
+        if (tool === "grep" || tool === "glob") {
+            narrate(sessionState, "narration.searching");
+            return;
+        }
+        if (tool === "read") {
+            narrate(sessionState, "narration.reading");
+            return;
+        }
+        if (tool === "bash") {
+            narrate(sessionState, "narration.bashing");
+            return;
+        }
+    };
+    const narrateToolEnd = (input, output) => {
+        if (input.tool !== "task")
+            return;
+        const sub = extractSubagentType(input?.args);
+        if (!sub)
+            return;
+        const to = agentDisplayName(sub, sessionState.locale);
+        const errorPresent = Boolean(output?.error) ||
+            (typeof output?.metadata === "object" && output.metadata?.error);
+        narrate(sessionState, errorPresent ? "dispatch.failed" : "dispatch.completed", { to });
+    };
     return {
         event: async (input) => {
             const evt = input.event;
@@ -134,6 +204,7 @@ export function getHooks(directory, options, sessionState) {
             const projectContext = await detectProjectContext(directory);
             sessionState.storedConfig = resolveConfig;
             sessionState.storedProjectContext = projectContext;
+            sessionState.locale = resolveLocale(resolveConfig.language, process.env.LANG);
             applyResolveConfig(config, resolveConfig, projectContext);
             if (resolveConfig.autoUpdate !== false && process.env.OPENCODE_RESOLVE_NO_AUTO_UPDATE !== "1") {
                 maybeAutoUpdate().catch(() => { });
@@ -169,6 +240,9 @@ export function getHooks(directory, options, sessionState) {
             }
         },
         "chat.params": async (input, output) => {
+            if (typeof input.agent === "string" && input.agent.length > 0) {
+                sessionState.currentAgent = input.agent;
+            }
             const profile = sessionState.storedConfig?.profile;
             if (profile === "glm") {
                 output.temperature = capTemperature(output.temperature, 0.4);
@@ -198,19 +272,23 @@ export function getHooks(directory, options, sessionState) {
             }
         },
         "tool.definition": async (input, output) => {
-            const hints = {
-                edit: "\n[opencode-resolve] Read the file first. Make the smallest correct change. Verify after editing.",
-                write: "\n[opencode-resolve] Only write new files when explicitly needed. Prefer editing existing files.",
-                bash: "\n[opencode-resolve] Commands run in non-interactive mode. No interactive editors, pagers, or REPLs. Use -c flags for scripting.",
-                task: "\n[opencode-resolve] Dispatch subagents with: TASK (atomic goal), OUTCOME (success criteria), MUST DO, MUST NOT DO, CONTEXT.",
-                glob: "\n[opencode-resolve] Use specific patterns. Avoid '**/*' unless genuinely needed — prefer scoped searches.",
-                grep: "\n[opencode-resolve] Use specific regex patterns. Combine with include filter for targeted search.",
-                read: "\n[opencode-resolve] Read only what you need. Use offset/limit for large files. Check file-info tool for quick metadata.",
-                webfetch: "\n[opencode-resolve] Only fetch URLs when you genuinely need external information. Prefer local docs and code first.",
-                todowrite: "\n[opencode-resolve] Keep todos current. Mark completed immediately. One in_progress at a time.",
+            const prefix = `[${PLUGIN_BRAND}]`;
+            const hintKeys = {
+                edit: "tool.edit",
+                write: "tool.write",
+                bash: "tool.bash",
+                task: "tool.task",
+                glob: "tool.glob",
+                grep: "tool.grep",
+                read: "tool.read",
+                webfetch: "tool.webfetch",
+                todowrite: "tool.todowrite",
             };
-            if (hints[input.toolID]) {
-                output.description = output.description + hints[input.toolID];
+            const key = hintKeys[input.toolID];
+            if (key) {
+                // Tool definitions are shipped as tool descriptions on every turn, so
+                // keep them English (context-bound) regardless of session locale.
+                output.description = output.description + `\n${prefix} ${t(key, "en")}`;
             }
         },
         "command.execute.before": async (_input, output) => {
@@ -222,7 +300,7 @@ export function getHooks(directory, options, sessionState) {
                 sessionID: "",
                 messageID: "",
                 type: "text",
-                text: "[opencode-resolve] Drive to verified resolution. Classify intent, dispatch focused subagents, verify after each, iterate on failure. Report completion only when verified.",
+                text: contextMessage(sessionState.currentAgent, "system.driveResolution"),
             });
         },
         "tool.execute.before": async (input, output) => {
@@ -242,6 +320,8 @@ export function getHooks(directory, options, sessionState) {
                     output.args = { ...output.args, _resolve_meta: meta };
                 }
             }
+            // Role-play narration → terminal only. Does NOT enter LLM context.
+            narrateToolStart(input, output);
         },
         "chat.headers": async (input, output) => {
             const providerID = input.provider?.info?.id ?? "";
@@ -290,6 +370,8 @@ export function getHooks(directory, options, sessionState) {
                     }
                 }
             }
+            // Role-play narration → terminal only. Does NOT enter LLM context.
+            narrateToolEnd(input, output);
             // For bash: extract key error lines from failing commands
             if (input.tool === "bash") {
                 const outputText = typeof output.output === "string" ? output.output
@@ -308,6 +390,7 @@ export function getHooks(directory, options, sessionState) {
             }
         },
         "experimental.session.compacting": async (_input, output) => {
+            narrate(sessionState, "narration.compacting");
             const ctx = sessionState.storedProjectContext;
             const cfg = sessionState.storedConfig;
             if (!ctx && !cfg)
@@ -347,7 +430,7 @@ export function getHooks(directory, options, sessionState) {
                 contextLines.push(`Session stats: ${sessionState.totalEdits} edits, ${sessionState.totalToolCalls} tool calls.`);
             }
             if (contextLines.length > 0) {
-                output.context.push("[" + "opencode-resolve" + "] Project context (preserve): " + contextLines.join(" "));
+                output.context.push(`[${PLUGIN_BRAND}] ` + t("compaction.contextHeader", "en", { body: contextLines.join(" ") }));
             }
         },
         "experimental.chat.messages.transform": async (_input, output) => {
@@ -407,59 +490,67 @@ export function getHooks(directory, options, sessionState) {
             if (!ctx && !hasFailures && !hasLoops)
                 return;
             const lines = [];
+            const agent = sessionState.currentAgent;
+            // All entries below land in LLM context — keep them English.
             if (ctx?.knowledgeFiles.length) {
-                lines.push(`[opencode-resolve] Project knowledge: ${ctx.knowledgeFiles.join(", ")}. Read when relevant before modifying code.`);
+                lines.push(contextMessage(agent, "system.projectKnowledge", { files: ctx.knowledgeFiles.join(", ") }));
             }
             if (ctx?.contextFiles.length) {
-                lines.push(`[opencode-resolve] Context docs: ${ctx.contextFiles.slice(0, 20).join(", ")}. MVI: load only task-relevant docs.`);
+                lines.push(contextMessage(agent, "system.contextDocs", { files: ctx.contextFiles.slice(0, 20).join(", ") }));
             }
             if (ctx?.verifyCommands.length) {
-                lines.push(`[opencode-resolve] Verify commands: ${ctx.verifyCommands.join("; ")}. Run after changes.`);
+                lines.push(contextMessage(agent, "system.verifyCommands", { commands: ctx.verifyCommands.join("; ") }));
             }
             if (ctx?.hasTypeScript) {
-                lines.push("[opencode-resolve] TypeScript project — type safety is mandatory. No `as any` or `@ts-ignore`.");
+                lines.push(contextMessage(agent, "system.typescriptMandatory"));
             }
             // Inject failure pattern warnings — encourage trying different approaches, don't stop
             if (hasFailures) {
-                lines.push("[opencode-resolve] ⚠️ Recurring failures detected:");
+                lines.push(contextMessage(agent, "system.failuresHeader"));
                 for (const w of sessionState.failureWarnings.slice(0, 3)) {
                     lines.push(`  - ${w}`);
                 }
-                lines.push("Keep going — try a different approach for the same goal. The Ralph Loop should drive to completion.");
+                lines.push(t("system.failuresFooter", "en"));
             }
             // Strategy Pivot: after many total failures, suggest architect intervention
             if (sessionState.totalFailures >= STRATEGY_PIVOT_THRESHOLD) {
-                lines.push(`[opencode-resolve] 🔀 STRATEGY PIVOT: ${sessionState.totalFailures} total failures detected.`);
-                lines.push("The current approach is not working. Dispatch ARCHITECT to analyze the problem from scratch and propose a fundamentally different strategy.");
-                lines.push("Then apply the new strategy. Do NOT keep retrying the same approach.");
+                lines.push(contextMessage(agent, "system.strategyPivotHeader", { count: sessionState.totalFailures }));
+                lines.push(t("system.strategyPivotBody", "en"));
+                lines.push(t("system.strategyPivotTail", "en"));
             }
             // Ralph Loop: inject strategy hints when same file edited many times
             if (hasLoops) {
-                lines.push("[opencode-resolve] 🔄 Ralph Loop: heavy editing detected on same file(s):");
+                lines.push(contextMessage(agent, "system.ralphHeader"));
                 for (const w of sessionState.loopWarnings.slice(0, 3)) {
                     lines.push(`  - ${w}`);
                 }
-                const strategies = [
-                    "Re-read the file carefully. You may be missing existing code that conflicts with your edit.",
-                    "Try a completely different approach — revert your last change and try a different fix.",
-                    "Use resolve-diagnostics to check current LSP errors before the next edit.",
-                    "Break the problem into smaller pieces. Edit one function at a time, verify between each.",
-                    "Check if the error is actually in a DIFFERENT file — the real issue may be upstream.",
-                    "Read the test file if it exists — the test often reveals the expected behavior.",
-                    "Check imports — missing or wrong imports are a common cause of cascading errors.",
-                    "Use resolve-search to find similar patterns elsewhere in the codebase.",
+                const strategyKeys = [
+                    "strategy.rereadFile",
+                    "strategy.tryDifferent",
+                    "strategy.useDiagnostics",
+                    "strategy.smallerPieces",
+                    "strategy.differentFile",
+                    "strategy.readTest",
+                    "strategy.checkImports",
+                    "strategy.searchSimilar",
                 ];
-                const hint = strategies[Math.floor(Date.now() / 30_000) % strategies.length];
+                const pickedKey = strategyKeys[Math.floor(Date.now() / 30_000) % strategyKeys.length];
+                const hint = t(pickedKey, "en");
                 if (hint !== sessionState.lastStrategyHint) {
-                    lines.push(`Strategy suggestion: ${hint}`);
+                    lines.push(`${t("strategy.suggestionLabel", "en")}: ${hint}`);
                     sessionState.lastStrategyHint = hint;
                 }
-                lines.push("Keep driving — the Ralph Loop should keep iterating until verified resolution.");
+                lines.push(t("system.ralphKeepGoing", "en"));
             }
             // Ralph Loop: inject session context when significant work done
             if (sessionState.totalEdits >= 20 && sessionState.failureWarnings.length > 0) {
-                lines.push(`[opencode-resolve] 📊 Session stats: ${sessionState.totalEdits} edits, ${sessionState.totalToolCalls} tool calls, ${Math.round((Date.now() - sessionState.sessionStartTime) / 1000)}s elapsed.`);
-                lines.push("Significant iteration with failures. Consider a fundamentally different approach — but keep going.");
+                const elapsed = Math.round((Date.now() - sessionState.sessionStartTime) / 1000);
+                lines.push(contextMessage(agent, "system.sessionStats", {
+                    edits: sessionState.totalEdits,
+                    calls: sessionState.totalToolCalls,
+                    elapsed,
+                }));
+                lines.push(t("system.iterationWarning", "en"));
             }
             if (lines.length > 0) {
                 output.system.push(lines.join("\n"));
@@ -482,11 +573,11 @@ export function getHooks(directory, options, sessionState) {
             const loopSignals = ["trying again", "attempting", "retrying", "second attempt", "third attempt", "another approach", "let me try"];
             const looksLikeLoop = loopSignals.some(s => text.toLowerCase().includes(s));
             if (looksLikeEdit && !alreadyVerified && !isHandoff) {
-                output.text = text + "\n\n[opencode-resolve] Reminder: verify your changes (resolve-verify) before reporting completion.";
+                output.text = text + "\n\n" + contextMessage(sessionState.currentAgent, "reminder.verify");
             }
             // Ralph Loop: if loop detected in text AND hotspot exists, suggest strategy change
             if (looksLikeLoop && sessionState.loopWarnings.length > 0) {
-                output.text = (output.text ?? text) + "\n\n[opencode-resolve] 🔄 Ralph Loop: heavy iteration detected. Use resolve-diagnostics to check current state, then try a different approach. Keep driving to completion.";
+                output.text = (output.text ?? text) + "\n\n" + contextMessage(sessionState.currentAgent, "reminder.ralphLoopText");
             }
         }
     };

package/dist/messages.d.ts

@@ -0,0 +1,34 @@
+export type Locale = "en" | "ko";
+export declare const PLUGIN_BRAND = "opencode-resolve";
+/** Resolve a Locale from explicit config (`"ko"|"en"|"auto"`) or env. */
+export declare function resolveLocale(configured: string | undefined, envLang: string | undefined): Locale;
+/** Bracketed brand for the currently-active agent. */
+export declare function brand(agent: string | undefined): string;
+/** Friendly display name per agent (used in role-play narration). */
+export declare function agentDisplayName(agent: string | undefined, locale: Locale): string;
+export type MessageKey = "reminder.verify" | "reminder.ralphLoopText" | "system.driveResolution" | "system.projectKnowledge" | "system.contextDocs" | "system.verifyCommands" | "system.typescriptMandatory" | "system.failuresHeader" | "system.failuresFooter" | "system.strategyPivotHeader" | "system.strategyPivotBody" | "system.strategyPivotTail" | "system.ralphHeader" | "system.ralphKeepGoing" | "system.sessionStats" | "system.iterationWarning" | "compaction.contextHeader" | "tool.edit" | "tool.write" | "tool.bash" | "tool.task" | "tool.glob" | "tool.grep" | "tool.read" | "tool.webfetch" | "tool.todowrite" | "dispatch.toSubagent" | "dispatch.fromResolver" | "dispatch.coder" | "dispatch.reviewer" | "dispatch.deepReviewer" | "dispatch.explorer" | "dispatch.planner" | "dispatch.architect" | "dispatch.researcher" | "dispatch.debugger" | "dispatch.codex" | "dispatch.glm" | "dispatch.gpt" | "dispatch.gptCoder" | "dispatch.completed" | "dispatch.failed" | "narration.editing" | "narration.searching" | "narration.reading" | "narration.thinking" | "narration.bashing" | "narration.compacting" | "narration.writing" | "narration.testing" | "narration.typechecking" | "narration.linting" | "narration.git" | "narration.fetch" | "narration.todo" | "narration.diagnostics" | "narration.context" | "narration.verifyPass" | "narration.verifyFail" | "narration.idle" | "strategy.smallerPieces" | "strategy.differentFile" | "strategy.readTest" | "strategy.checkImports" | "strategy.searchSimilar" | "strategy.rereadFile" | "strategy.tryDifferent" | "strategy.useDiagnostics" | "strategy.suggestionLabel";
+type Params = Record<string, string | number>;
+/** Render a message in the requested locale. Picks a random variant if multiple are defined. */
+export declare function t(key: MessageKey, locale: Locale, params?: Params): string;
+/** Compose `[agent] message` for session-time nudges. */
+export declare function brandedMessage(agent: string | undefined, locale: Locale, key: MessageKey, params?: Params): string;
+/** Compose `[opencode-resolve] message` for plugin-level notices. */
+export declare function pluginMessage(locale: Locale, key: MessageKey, params?: Params): string;
+/**
+ * Render a context-bound message — always English, regardless of session locale.
+ * Use for everything that lands in LLM context (system reminders, tool definitions,
+ * end-of-turn reminders that become part of conversation history).
+ */
+export declare function contextMessage(agent: string | undefined, key: MessageKey, params?: Params): string;
+/**
+ * Print a terminal-only narration. Uses session locale (Korean if configured).
+ * Does NOT enter LLM context — only the user sees it in the OpenCode UI/log.
+ * Free to be playful, varied, and bilingual.
+ */
+export declare function narrate(state: {
+    locale: Locale;
+    currentAgent?: string;
+}, key: MessageKey, params?: Params): void;
+/** All registered message keys, derived from the English table. */
+export declare const ALL_MESSAGE_KEYS: ReadonlyArray<MessageKey>;
+export {};