@sayknow-cli/coding-agent 0.3.6 → 0.3.7

package/src/discovery/opencode.ts

@@ -7,21 +7,23 @@
  *
  * Capabilities:
  * - context-files: AGENTS.md (user-level only at ~/.config/opencode/AGENTS.md)
- * - mcps: From opencode.json "mcp" key
  * - settings: From opencode.json
  * - skills: From skills/ subdirectories
  * - slash-commands: From commands/ subdirectories
  * - extension-modules: From plugins/ subdirectories
  *
+ * MCP servers are intentionally NOT inherited live from OpenCode config: SKC
+ * owns MCP runtime execution. Use `skc mcp import opencode` to copy definitions
+ * into SKC's own mcp.json instead.
+ *
  * Priority: 55 (tool-specific provider)
  */
 import * as path from "node:path";
-import { logger, parseFrontmatter, tryParseJson } from "@sayknow-cli/utils";
+import { parseFrontmatter, tryParseJson } from "@sayknow-cli/utils";
 import { registerProvider } from "../capability";
 import { type ContextFile, contextFileCapability } from "../capability/context-file";
 import { type ExtensionModule, extensionModuleCapability } from "../capability/extension-module";
 import { readFile } from "../capability/fs";
-import { type MCPServer, mcpCapability } from "../capability/mcp";
 import { type Settings, settingsCapability } from "../capability/settings";
 import { type Skill, skillCapability } from "../capability/skill";
 import { type SlashCommand, slashCommandCapability } from "../capability/slash-command";
@@ -32,7 +34,6 @@ import {
 	buildExtensionModuleItems,
 	createSourceMeta,
 	discoverExtensionModulePaths,
-	expandEnvVarsDeep,
 	getProjectPath,
 	getUserPath,
 	loadFilesFromDir,
@@ -43,22 +44,6 @@ const PROVIDER_ID = "opencode";
 const DISPLAY_NAME = "OpenCode";
 const PRIORITY = 55;
 
-// =============================================================================
-// JSON Config Loading
-// =============================================================================
-
-async function loadJsonConfig(configPath: string): Promise<Record<string, unknown> | null> {
-	const content = await readFile(configPath);
-	if (!content) return null;
-
-	const parsed = tryParseJson<Record<string, unknown>>(content);
-	if (!parsed) {
-		logger.warn("Failed to parse OpenCode JSON config", { path: configPath });
-		return null;
-	}
-	return parsed;
-}
-
 // =============================================================================
 // Context Files (AGENTS.md)
 // =============================================================================
@@ -84,100 +69,6 @@ async function loadContextFiles(ctx: LoadContext): Promise<LoadResult<ContextFil
 	return { items, warnings };
 }
 
-// =============================================================================
-// MCP Servers (opencode.json → mcp)
-// =============================================================================
-
-/** OpenCode MCP server config (from opencode.json "mcp" key) */
-interface OpenCodeMCPConfig {
-	type?: "local" | "remote";
-	command?: string;
-	args?: string[];
-	env?: Record<string, string>;
-	url?: string;
-	headers?: Record<string, string>;
-	enabled?: boolean;
-	timeout?: number;
-}
-
-async function loadMCPServers(ctx: LoadContext): Promise<LoadResult<MCPServer>> {
-	const items: MCPServer[] = [];
-	const warnings: string[] = [];
-
-	// User-level: ~/.config/opencode/opencode.json
-	const userConfigPath = getUserPath(ctx, "opencode", "opencode.json");
-	if (userConfigPath) {
-		const config = await loadJsonConfig(userConfigPath);
-		if (config) {
-			const result = extractMCPServers(config, userConfigPath, "user");
-			items.push(...result.items);
-			if (result.warnings) warnings.push(...result.warnings);
-		}
-	}
-
-	// Project-level: opencode.json in project root
-	const projectConfigPath = path.join(ctx.cwd, "opencode.json");
-	const projectConfig = await loadJsonConfig(projectConfigPath);
-	if (projectConfig) {
-		const result = extractMCPServers(projectConfig, projectConfigPath, "project");
-		items.push(...result.items);
-		if (result.warnings) warnings.push(...result.warnings);
-	}
-
-	return { items, warnings };
-}
-
-function extractMCPServers(
-	config: Record<string, unknown>,
-	configPath: string,
-	level: "user" | "project",
-): LoadResult<MCPServer> {
-	const items: MCPServer[] = [];
-	const warnings: string[] = [];
-
-	if (!config.mcp || typeof config.mcp !== "object") {
-		return { items, warnings };
-	}
-
-	const servers = expandEnvVarsDeep(config.mcp as Record<string, unknown>);
-
-	for (const [name, raw] of Object.entries(servers)) {
-		if (!raw || typeof raw !== "object") {
-			warnings.push(`Invalid MCP config for "${name}" in ${configPath}`);
-			continue;
-		}
-
-		const serverConfig = raw as OpenCodeMCPConfig;
-
-		// Determine transport from OpenCode's "type" field
-		let transport: "stdio" | "sse" | "http" | undefined;
-		if (serverConfig.type === "local") {
-			transport = "stdio";
-		} else if (serverConfig.type === "remote") {
-			transport = "http";
-		} else if (serverConfig.url) {
-			transport = "http";
-		} else if (serverConfig.command) {
-			transport = "stdio";
-		}
-
-		items.push({
-			name,
-			command: serverConfig.command,
-			args: Array.isArray(serverConfig.args) ? (serverConfig.args as string[]) : undefined,
-			env: serverConfig.env && typeof serverConfig.env === "object" ? serverConfig.env : undefined,
-			url: typeof serverConfig.url === "string" ? serverConfig.url : undefined,
-			headers: serverConfig.headers && typeof serverConfig.headers === "object" ? serverConfig.headers : undefined,
-			enabled: serverConfig.enabled,
-			timeout: typeof serverConfig.timeout === "number" ? serverConfig.timeout : undefined,
-			transport,
-			_source: createSourceMeta(PROVIDER_ID, configPath, level),
-		});
-	}
-
-	return { items, warnings };
-}
-
 // =============================================================================
 // Skills (skills/)
 // =============================================================================
@@ -357,14 +248,6 @@ registerProvider(contextFileCapability.id, {
 	load: loadContextFiles,
 });
 
-registerProvider(mcpCapability.id, {
-	id: PROVIDER_ID,
-	displayName: DISPLAY_NAME,
-	description: "Load MCP servers from opencode.json mcp key",
-	priority: PRIORITY,
-	load: loadMCPServers,
-});
-
 registerProvider(skillCapability.id, {
 	id: PROVIDER_ID,
 	displayName: DISPLAY_NAME,

package/src/discovery/windsurf.ts

@@ -6,93 +6,23 @@
  * - Project: .windsurf
  *
  * Supports:
- * - MCP servers from mcp_config.json
  * - Rules from .windsurf/rules/*.md and ~/.codeium/windsurf/memories/global_rules.md
  * - Legacy .windsurfrules file
+ *
+ * MCP servers are intentionally NOT inherited live from Windsurf config: SKC
+ * owns MCP runtime execution. Copy definitions into SKC's own mcp.json instead.
  */
 
-import { tryParseJson } from "@sayknow-cli/utils";
 import { registerProvider } from "../capability";
 import { readFile } from "../capability/fs";
-import { type MCPServer, mcpCapability } from "../capability/mcp";
 import { type Rule, ruleCapability } from "../capability/rule";
 import type { LoadContext, LoadResult } from "../capability/types";
-import {
-	buildRuleFromMarkdown,
-	createSourceMeta,
-	expandEnvVarsDeep,
-	getProjectPath,
-	getUserPath,
-	loadFilesFromDir,
-} from "./helpers";
+import { buildRuleFromMarkdown, createSourceMeta, getProjectPath, getUserPath, loadFilesFromDir } from "./helpers";
 
 const PROVIDER_ID = "windsurf";
 const DISPLAY_NAME = "Windsurf";
 const PRIORITY = 50;
 
-// =============================================================================
-// MCP Servers
-// =============================================================================
-
-function parseServerConfig(
-	name: string,
-	serverConfig: unknown,
-	path: string,
-	scope: "user" | "project",
-): { server?: MCPServer; warning?: string } {
-	if (typeof serverConfig !== "object" || serverConfig === null) {
-		return { warning: `Invalid server config for "${name}" in ${path}` };
-	}
-
-	const server = expandEnvVarsDeep(serverConfig as Record<string, unknown>);
-	return {
-		server: {
-			name,
-			command: server.command as string | undefined,
-			args: server.args as string[] | undefined,
-			env: server.env as Record<string, string> | undefined,
-			url: server.url as string | undefined,
-			headers: server.headers as Record<string, string> | undefined,
-			transport: server.type as "stdio" | "sse" | "http" | undefined,
-			timeout: typeof server.timeout === "number" ? server.timeout : undefined,
-			_source: createSourceMeta(PROVIDER_ID, path, scope),
-		},
-	};
-}
-
-async function loadMCPServers(ctx: LoadContext): Promise<LoadResult<MCPServer>> {
-	const items: MCPServer[] = [];
-	const warnings: string[] = [];
-
-	const userPath = getUserPath(ctx, "windsurf", "mcp_config.json");
-	const [userContent, projectPath] = await Promise.all([
-		userPath ? readFile(userPath) : Promise.resolve(null),
-		getProjectPath(ctx, "windsurf", "mcp_config.json"),
-	]);
-
-	const projectContent = projectPath ? await readFile(projectPath) : null;
-
-	const configs: Array<{ content: string | null; path: string | null; scope: "user" | "project" }> = [
-		{ content: userContent, path: userPath, scope: "user" },
-		{ content: projectContent, path: projectPath, scope: "project" },
-	];
-
-	for (const { content, path, scope } of configs) {
-		if (!content || !path) continue;
-
-		const config = tryParseJson<{ mcpServers?: Record<string, unknown> }>(content);
-		if (!config?.mcpServers) continue;
-
-		for (const [name, serverConfig] of Object.entries(config.mcpServers)) {
-			const result = parseServerConfig(name, serverConfig, path, scope);
-			if (result.warning) warnings.push(result.warning);
-			if (result.server) items.push(result.server);
-		}
-	}
-
-	return { items, warnings };
-}
-
 // =============================================================================
 // Rules
 // =============================================================================
@@ -130,14 +60,6 @@ async function loadRules(ctx: LoadContext): Promise<LoadResult<Rule>> {
 // Provider Registration
 // =============================================================================
 
-registerProvider<MCPServer>(mcpCapability.id, {
-	id: PROVIDER_ID,
-	displayName: DISPLAY_NAME,
-	description: "Load MCP servers from Windsurf config (mcp_config.json)",
-	priority: PRIORITY,
-	load: loadMCPServers,
-});
-
 registerProvider<Rule>(ruleCapability.id, {
 	id: PROVIDER_ID,
 	displayName: DISPLAY_NAME,

package/src/edit/read-file.ts

@@ -14,6 +14,13 @@ import { isNotebookPath, readEditableNotebookText, serializeEditedNotebookText }
  */
 export const MAX_EDIT_FILE_BYTES = 8 * 1024 * 1024;
 
+const UTF8_BOM = [0xef, 0xbb, 0xbf] as const;
+
+async function fileHasUtf8Bom(file: Bun.BunFile): Promise<boolean> {
+	const bytes = await file.slice(0, UTF8_BOM.length).bytes();
+	return UTF8_BOM.every((byte, index) => bytes[index] === byte);
+}
+
 export async function readEditFileText(absolutePath: string, path: string): Promise<string> {
 	try {
 		const file = Bun.file(absolutePath);
@@ -28,7 +35,8 @@ export async function readEditFileText(absolutePath: string, path: string): Prom
 		// Guard BEFORE the notebook fast-path: a >8 MiB .ipynb would otherwise load + JSON-parse
 		// + convert the whole file via readEditableNotebookText, bypassing the F19 freeze guard.
 		if (isNotebookPath(absolutePath)) return await readEditableNotebookText(absolutePath, path);
-		return await file.text();
+		const text = await file.text();
+		return (await fileHasUtf8Bom(file)) && !text.startsWith("\uFEFF") ? `\uFEFF${text}` : text;
 	} catch (error) {
 		if (isEnoent(error)) {
 			throw new Error(`File not found: ${path}`);

package/src/extensibility/extensions/runner.ts

@@ -347,7 +347,8 @@ export class ExtensionRunner {
 		"ctrl+t",
 		"ctrl+g",
 		"shift+tab",
-		"shift+ctrl+p",
+		"alt+n",
+		"alt+shift+n",
 		"ctrl+enter",
 		"alt+enter",
 		"escape",

package/src/extensibility/extensions/types.ts

@@ -136,6 +136,17 @@ export interface ExtensionUIDialogOptions {
 		optionLabel: string;
 		onSubmit: (text: string) => void;
 	};
+	/**
+	 * Inline free-text input for a non-answer clarification action. It is
+	 * separate from `customInput` so callers can distinguish "ask about these
+	 * choices" from "provide my own answer". Empty/whitespace-only submissions
+	 * may be rejected by the selector when `allowEmpty` is false.
+	 */
+	clarificationInput?: {
+		optionLabel: string;
+		onSubmit: (text: string) => void;
+		allowEmpty?: boolean;
+	};
 }
 
 /** Raw terminal input listener for extensions. */

package/src/extensibility/skills.ts

@@ -326,12 +326,28 @@ interface SkillTokenMatch {
 	skill: Skill;
 }
 
+function buildInlineSkillInvocationArgs(text: string, matches: readonly SkillTokenMatch[]): string {
+	const pieces: string[] = [];
+	let cursor = 0;
+	for (const match of matches) {
+		pieces.push(text.slice(cursor, match.index));
+		cursor = match.end;
+	}
+	pieces.push(text.slice(cursor));
+	return pieces
+		.join("")
+		.replace(/[ \t]{2,}/g, " ")
+		.replace(/[ \t]+\n/g, "\n")
+		.replace(/\n[ \t]+/g, "\n")
+		.trim();
+}
+
 export function parseSkillInvocations(
 	text: string,
 	skillsByCommandName: ReadonlyMap<string, Skill>,
 ): ParsedSkillInvocation[] {
 	const trimmedText = text.trim();
-	if (!trimmedText.startsWith("/")) return [];
+	if (!trimmedText) return [];
 	const canonicalSkillCommandPattern = /(^|\s)\/(skill:[^\s]+)/g;
 	const matches: SkillTokenMatch[] = [];
 	for (const match of trimmedText.matchAll(canonicalSkillCommandPattern)) {
@@ -348,7 +364,19 @@ export function parseSkillInvocations(
 			skill,
 		});
 	}
-	if (matches.length === 0 || matches[0]?.index !== 0) return [];
+	if (matches.length === 0) return [];
+	if (matches[0]?.index !== 0) {
+		// Preserve leading slash-command semantics: `/skill:unknown /skill:alpha`
+		// should remain plain text rather than silently skipping the unknown
+		// leading command and invoking the later known one.
+		if (trimmedText.startsWith("/")) return [];
+		const args = buildInlineSkillInvocationArgs(trimmedText, matches);
+		return matches.map(match => ({
+			commandName: match.commandName,
+			args,
+			skill: match.skill,
+		}));
+	}
 	return matches.map((match, index) => {
 		const next = matches[index + 1];
 		return {

package/src/hooks/skill-state.ts

@@ -12,8 +12,7 @@ import {
 	writeGuardedJsonAtomic,
 	writeGuardedWorkflowEnvelopeAtomic,
 } from "../skc-runtime/state-writer";
-import { isUltragoalBypassPrompt, readUltragoalVerificationState } from "../skc-runtime/ultragoal-guard";
-import { getUltragoalRunCompletionState, readUltragoalPlan } from "../skc-runtime/ultragoal-runtime";
+import { isUltragoalBypassPrompt, verifyUltragoalDurableCompletionState } from "../skc-runtime/ultragoal-guard";
 import {
 	readVisibleSkillActiveState as readCanonicalVisibleSkillActiveState,
 	type SkillActiveEntry,
@@ -565,6 +564,10 @@ function modeStateReleasesStop(state: ModeState | null, handoffRequired: boolean
 	return false;
 }
 
+function ultragoalDurableCompletionReleasesStop(state: string): boolean {
+	return state === "inactive" || state === "active_verified_complete";
+}
+
 /**
  * Cross-file coherence guard for a mode-state that claims it releases the Stop
  * block. `modeStateReleasesStop` trusts a single mode-state file; if any writer
@@ -577,18 +580,15 @@ function modeStateReleasesStop(state: ModeState | null, handoffRequired: boolean
  * cheap and read-only — ultragoal reads the durable plan; skills without an
  * independent durable source release as before.
  */
-async function detectStaleModeStateRelease(skill: SkcWorkflowSkill, cwd: string): Promise<string | null> {
-	if (skill === "ultragoal") {
-		const plan = await readUltragoalPlan(cwd);
-		if (!plan) return null;
-		const runState = getUltragoalRunCompletionState(plan);
-		if (runState.incompleteGoals.length > 0) {
-			return `the durable Ultragoal plan still has incomplete required goals (${runState.incompleteGoals
-				.map(goal => goal.id)
-				.join(", ")}); run \`skc ultragoal complete-goals\` to continue`;
-		}
-	}
-	return null;
+async function detectStaleModeStateRelease(
+	skill: SkcWorkflowSkill,
+	cwd: string,
+	sessionId?: string | null,
+): Promise<string | null> {
+	if (skill !== "ultragoal") return null;
+	const diagnostic = await verifyUltragoalDurableCompletionState({ cwd, sessionId });
+	if (ultragoalDurableCompletionReleasesStop(diagnostic.state)) return null;
+	return `${diagnostic.message} Run \`skc ultragoal complete-goals\` to continue, or checkpoint a finished story with \`skc ultragoal checkpoint --status complete --quality-gate-json <file>\`, before stopping`;
 }
 
 /**
@@ -663,19 +663,6 @@ function stateMatchesContext(state: ModeState, sessionId?: string, threadId?: st
 	return true;
 }
 
-async function readCurrentGoalObjectiveFromSessionFile(sessionFile: string | undefined): Promise<string | null> {
-	const trimmed = sessionFile?.trim();
-	if (!trimmed) return null;
-	const entries = (await loadEntriesFromFile(trimmed)).filter(
-		(entry): entry is SessionEntry => entry.type !== "session",
-	);
-	const context = buildSessionContext(entries);
-	const goal = context.modeData?.goal;
-	if (typeof goal !== "object" || goal === null) return null;
-	const objective = (goal as { objective?: unknown }).objective;
-	return typeof objective === "string" && objective.trim().length > 0 ? objective.trim() : null;
-}
-
 async function readLatestAssistantTextFromSessionFile(sessionFile: string | undefined): Promise<string | null> {
 	const trimmed = sessionFile?.trim();
 	if (!trimmed) return null;
@@ -730,34 +717,18 @@ export async function buildActiveUltragoalPromptContext(input: UserPromptSubmitS
 	if (!stateMatchesContext(visibleModeState.state, resolvedSessionId, input.threadId)) return null;
 
 	const phase = String(visibleModeState.state.current_phase ?? "active");
-	const stateObjective =
-		typeof visibleModeState.state.objective === "string"
-			? visibleModeState.state.objective
-			: typeof visibleModeState.state.skcObjective === "string"
-				? visibleModeState.state.skcObjective
-				: "";
-	const sessionObjective = await readCurrentGoalObjectiveFromSessionFile(input.sessionFile);
 	const normalizedPrompt = input.prompt?.replace(/\\?"/g, '"');
 	const isBypassPrompt = Boolean(
 		(normalizedPrompt && isUltragoalBypassPrompt(normalizedPrompt)) ||
 			(input.prompt && /goal[\s\S]{0,80}complete/i.test(input.prompt)),
 	);
 	if (isBypassPrompt) {
-		const objectives = [sessionObjective, stateObjective].filter(
-			(value): value is string => typeof value === "string" && value.trim().length > 0,
-		);
-		if (objectives.length === 0) {
-			return "BLOCK_ULTRAGOAL_COMPLETION: Active Ultragoal completion is blocked until a current SKC goal objective can be verified. Use durable blocker work or run strict `skc ultragoal checkpoint --status complete --quality-gate-json <file> --skc-goal-json <file>` before completion.";
-		}
-		for (const objective of objectives) {
-			const diagnostic = await readUltragoalVerificationState({
-				cwd: input.cwd,
-				currentGoal: { objective },
-			});
-			if (diagnostic.state === "unrelated_goal") continue;
-			if (!["inactive", "active_verified_complete"].includes(diagnostic.state)) {
-				return `BLOCK_ULTRAGOAL_COMPLETION: ${diagnostic.message} Use durable blocker work or run strict \`skc ultragoal checkpoint --status complete --quality-gate-json <file> --skc-goal-json <file>\` before completion.`;
-			}
+		const diagnostic = await verifyUltragoalDurableCompletionState({
+			cwd: input.cwd,
+			sessionId: resolvedSessionId,
+		});
+		if (!ultragoalDurableCompletionReleasesStop(diagnostic.state)) {
+			return `BLOCK_ULTRAGOAL_COMPLETION: ${diagnostic.message} Use durable blocker work or run strict \`skc ultragoal checkpoint --status complete --quality-gate-json <file>\` before completion.`;
 		}
 	}
 	return `Ultragoal is active (phase: ${phase}; state: ${visibleModeState.statePath}). If the user prompt is a steering request, use \`skc ultragoal steer\` to add or steer subgoals. Normal prose should not mutate Ultragoal state.`;
@@ -818,7 +789,7 @@ export async function buildSkillStopOutput(input: StopHookInput): Promise<Record
 			// authoritative durable state. If a stale/incoherent mode-state would
 			// release while the plan/ledger still shows pending work, block instead
 			// of trusting the single file (see #659).
-			const staleRelease = await detectStaleModeStateRelease(entry.skill, input.cwd);
+			const staleRelease = await detectStaleModeStateRelease(entry.skill, input.cwd, resolvedSessionId);
 			if (staleRelease) {
 				const coherenceMessage = `SKC skill "${entry.skill}" mode-state reports it released the Stop block (${modeStatePath(input.cwd, entry.skill, resolvedSessionId)}), but ${staleRelease}. The mode-state is incoherent with authoritative durable state; finish or explicitly clear the pending work before stopping.`;
 				return {
@@ -847,29 +818,18 @@ export async function buildSkillStopOutput(input: StopHookInput): Promise<Record
 		const phase = String(modeState?.current_phase ?? entry.phase ?? skillState.phase ?? "active");
 		const statePath = modeStatePath(input.cwd, entry.skill, resolvedSessionId);
 		if (entry.skill === "ultragoal") {
-			const objective =
-				(await readCurrentGoalObjectiveFromSessionFile(input.sessionFile)) ??
-				(typeof modeState?.objective === "string"
-					? modeState.objective
-					: typeof modeState?.skcObjective === "string"
-						? modeState.skcObjective
-						: "");
-			if (objective) {
-				const diagnostic = await readUltragoalVerificationState({
-					cwd: input.cwd,
-					currentGoal: { objective },
-				});
-				if (diagnostic.state === "active_verified_complete") continue;
-				if (!["inactive", "unrelated_goal"].includes(diagnostic.state)) {
-					const ultragoalMessage = `SKC ultragoal verification is blocking stop: ${diagnostic.message} Run strict checkpoint verification or record review blockers before stopping.`;
-					return {
-						decision: "block",
-						reason: ultragoalMessage,
-						stopReason: `skc_ultragoal_verification_${diagnostic.state}`,
-						systemMessage: ultragoalMessage,
-					};
-				}
-			}
+			const diagnostic = await verifyUltragoalDurableCompletionState({
+				cwd: input.cwd,
+				sessionId: resolvedSessionId,
+			});
+			if (ultragoalDurableCompletionReleasesStop(diagnostic.state)) continue;
+			const ultragoalMessage = `SKC ultragoal verification is blocking stop: ${diagnostic.message} Run \`skc ultragoal checkpoint --status complete --quality-gate-json <file>\` or record review blockers before stopping.`;
+			return {
+				decision: "block",
+				reason: ultragoalMessage,
+				stopReason: `skc_ultragoal_verification_${diagnostic.state}`,
+				systemMessage: ultragoalMessage,
+			};
 		}
 		const systemMessage = handoffRequired
 			? buildHandoffForceAskMessage(entry.skill, phase, statePath)

package/src/i18n/messages/de.ts

@@ -36,6 +36,7 @@ export const de: Partial<Record<MsgKey, string>> = {
 	"settings.tab.tools": "Werkzeuge",
 	"settings.tab.tasks": "Aufgaben",
 	"settings.tab.providers": "Anbieter",
+	"settings.tab.integrations": "Integrationen",
 	"settings.language.label": "Sprache",
 	"settings.language.desc": "Sprache der Oberfläche. Automatisch folgt der Systemsprache.",
 	"help.usage": "VERWENDUNG",

package/src/i18n/messages/en.ts

@@ -43,6 +43,7 @@ export const en = {
 	"settings.tab.tools": "Tools",
 	"settings.tab.tasks": "Tasks",
 	"settings.tab.providers": "Providers",
+	"settings.tab.integrations": "Integrations",
 
 	// ── Language setting ──
 	"settings.language.label": "Language",

package/src/i18n/messages/es.ts

@@ -36,6 +36,7 @@ export const es: Partial<Record<MsgKey, string>> = {
 	"settings.tab.tools": "Herramientas",
 	"settings.tab.tasks": "Tareas",
 	"settings.tab.providers": "Proveedores",
+	"settings.tab.integrations": "Integraciones",
 	"settings.language.label": "Idioma",
 	"settings.language.desc": "Idioma de la interfaz. Automático sigue la configuración regional del sistema.",
 	"help.usage": "USO",

package/src/i18n/messages/fr.ts

@@ -36,6 +36,7 @@ export const fr: Partial<Record<MsgKey, string>> = {
 	"settings.tab.tools": "Outils",
 	"settings.tab.tasks": "Tâches",
 	"settings.tab.providers": "Fournisseurs",
+	"settings.tab.integrations": "Intégrations",
 	"settings.language.label": "Langue",
 	"settings.language.desc": "Langue de l'interface. Auto suit les paramètres régionaux du système.",
 	"help.usage": "UTILISATION",

package/src/i18n/messages/ja.settings.ts

@@ -806,4 +806,32 @@ export const jaSettings: Record<string, string> = {
 	"cmd:move:d": "セッションを別の作業ディレクトリに移動",
 	"cmd:exit:d": "アプリケーションを終了",
 	"set:edit.fuzzyThreshold:d": "あいまい一致の類似度しきい値",
+	"set:telegram.enabled:l": "Telegramリモート",
+	"set:telegram.enabled:d": "skcセッションを双方向Telegramボットで制御",
+	"set:telegram.botToken:l": "ボットトークン",
+	"set:telegram.botToken:d": "@BotFatherから取得したTelegramボットトークン（有効化時に必須）",
+	"set:telegram.allowedUserIds:l": "許可されたユーザーID",
+	"set:telegram.allowedUserIds:d": "コマンドを送信できるTelegramユーザーID（カンマ区切り）",
+	"set:telegram.allowedChatIds:l": "許可されたチャットID",
+	"set:telegram.allowedChatIds:d": "コマンドを送信できるTelegramチャットID（カンマ区切り）",
+	"set:telegram.backend:l": "バックエンド",
+	"set:telegram.backend:d": "コーディネーター（マルチセッション）またはRPC（単一永続セッション）",
+	"set:telegram.backend:o:coordinator:l": "コーディネーター",
+	"set:telegram.backend:o:coordinator:d": "マルチセッションライフサイクル + 監視",
+	"set:telegram.backend:o:rpc:l": "RPC",
+	"set:telegram.backend:o:rpc:d": "単一永続セッションソケットにアタッチ/デタッチ",
+	"set:telegram.enableStop:l": "/stopを有効化",
+	"set:telegram.enableStop:d": "停止リクエストを許可（reportsミューテーションクラスを追加）",
+	"set:telegram.enableRich:l": "リッチメッセージ",
+	"set:telegram.enableRich:d": "HTMLフォーマット + インラインキーボード",
+	"set:telegram.enablePush:l": "プッシュ通知",
+	"set:telegram.enablePush:d": "コーディネーターイベント監視によるフォロー/ミュート購読",
+	"set:telegram.registerCommands:l": "ボットメニュー登録",
+	"set:telegram.registerCommands:d": "起動時にボットコマンドメニューを登録",
+	"set:telegram.presets:l": "セッションプリセット",
+	"set:telegram.presets:d": "{id, workdir, sessionCommand, taskTemplate?, taskMaxLen?} JSON配列",
+	"set:telegram.rpcSocket:l": "RPCソケット",
+	"set:telegram.rpcSocket:d": "skc launch --output rpc UNIXソケットパス（RPCバックエンド専用）",
+	"set:telegram.stateDir:l": "状態ディレクトリ",
+	"set:telegram.stateDir:d": "再接続/再同期用ゲートウェイ状態ディレクトリ（RPCバックエンド必須）",
 };

package/src/i18n/messages/ja.ts

@@ -34,6 +34,7 @@ export const ja: Partial<Record<MsgKey, string>> = {
 	"settings.tab.tools": "ツール",
 	"settings.tab.tasks": "タスク",
 	"settings.tab.providers": "プロバイダー",
+	"settings.tab.integrations": "統合",
 
 	"settings.language.label": "言語",
 	"settings.language.desc": "インターフェース言語。自動はシステムのロケールに従います。",

package/src/i18n/messages/ko.settings.ts

@@ -795,4 +795,32 @@ export const koSettings: Record<string, string> = {
 	"cmd:move:d": "세션을 다른 작업 디렉터리로 이동",
 	"cmd:exit:d": "애플리케이션 종료",
 	"set:edit.fuzzyThreshold:d": "퍼지 매칭의 유사도 임계값",
+	"set:telegram.enabled:l": "텔레그램 리모트",
+	"set:telegram.enabled:d": "skc 세션을 양방향 텔레그램 봇으로 제어",
+	"set:telegram.botToken:l": "봇 토큰",
+	"set:telegram.botToken:d": "@BotFather에서 받은 텔레그램 봇 토큰 (활성화 시 필수)",
+	"set:telegram.allowedUserIds:l": "허용된 사용자 ID",
+	"set:telegram.allowedUserIds:d": "명령을 보낼 수 있는 텔레그램 사용자 ID (쉼표 구분)",
+	"set:telegram.allowedChatIds:l": "허용된 채팅 ID",
+	"set:telegram.allowedChatIds:d": "명령을 보낼 수 있는 텔레그램 채팅 ID (쉼표 구분)",
+	"set:telegram.backend:l": "백엔드",
+	"set:telegram.backend:d": "코디네이터 (다중 세션 수명주기) 또는 RPC (단일 영구 세션)",
+	"set:telegram.backend:o:coordinator:l": "코디네이터",
+	"set:telegram.backend:o:coordinator:d": "다중 세션 수명주기 + 관찰",
+	"set:telegram.backend:o:rpc:l": "RPC",
+	"set:telegram.backend:o:rpc:d": "단일 영구 세션 소켓에 연결/분리",
+	"set:telegram.enableStop:l": "/stop 활성화",
+	"set:telegram.enableStop:d": "정지 요청 허용 (reports 변경 클래스 추가)",
+	"set:telegram.enableRich:l": "리치 메시지",
+	"set:telegram.enableRich:d": "HTML 포맷팅 + 인라인 키보드",
+	"set:telegram.enablePush:l": "푸시 알림",
+	"set:telegram.enablePush:d": "코디네이터 이벤트 감시를 통한 팔로우/뮤트 구독",
+	"set:telegram.registerCommands:l": "봇 메뉴 등록",
+	"set:telegram.registerCommands:d": "시작 시 봇 명령 메뉴 등록",
+	"set:telegram.presets:l": "세션 프리셋",
+	"set:telegram.presets:d": "{id, workdir, sessionCommand, taskTemplate?, taskMaxLen?} JSON 배열",
+	"set:telegram.rpcSocket:l": "RPC 소켓",
+	"set:telegram.rpcSocket:d": "skc launch --output rpc UNIX 소켓 경로 (RPC 백엔드 전용)",
+	"set:telegram.stateDir:l": "상태 디렉터리",
+	"set:telegram.stateDir:d": "재연결/동기화용 게이트웨이 상태 디렉터리 (RPC 백엔드 필수)",
 };