@sayknow-cli/coding-agent 0.3.5 → 0.3.7

package/src/commands/notify.ts

@@ -55,7 +55,7 @@ export default class Notify extends Command {
 			redact: Boolean(flags.redact),
 		};
 
-		await initTheme();
+		if (action !== "daemon-internal") await initTheme();
 		await runNotifyCommand(cmd);
 	}
 }

package/src/commands/ralplan.ts

@@ -8,6 +8,7 @@ export default class Ralplan extends Command {
 		'$ skc ralplan "<task description>"',
 		'$ skc ralplan --interactive --deliberate "<task description>"',
 		'$ skc ralplan --write --stage planner --stage_n 1 --artifact "<markdown or path>"',
+		"$ skc ralplan --write --stage critic --stage_n 1 --artifact-env SKC_RALPLAN_ARTIFACT",
 	];
 
 	async run(): Promise<void> {

package/src/commands/telegram.ts

@@ -0,0 +1,47 @@
+/**
+ * `skc telegram` — manage the Telegram Remote integration.
+ */
+import { Args, Command, Flags, renderCommandHelp } from "@sayknow-cli/utils/cli";
+import {
+	runTelegramCommand,
+	TELEGRAM_ACTIONS,
+	type TelegramAction,
+	type TelegramCommandArgs,
+} from "../cli/telegram-cli";
+import { initTheme } from "../modes/theme/theme";
+
+export default class Telegram extends Command {
+	static description = "Manage the Telegram Remote integration (start/status/env)";
+
+	static args = {
+		action: Args.string({
+			description: "Sub-command",
+			required: false,
+			options: [...TELEGRAM_ACTIONS],
+		}),
+	};
+
+	static flags = {
+		json: Flags.boolean({ description: "Output JSON (status)" }),
+	};
+
+	static examples = [
+		"# Start the Telegram gateway with current settings\n  skc telegram start",
+		"# Show integration status\n  skc telegram status",
+		"# Show the env vars the gateway would receive\n  skc telegram env",
+	];
+
+	async run(): Promise<void> {
+		const { args, flags } = await this.parse(Telegram);
+		if (!args.action) {
+			renderCommandHelp("skc", "telegram", Telegram);
+			return;
+		}
+		const cmd: TelegramCommandArgs = {
+			action: args.action as TelegramAction,
+			flags: { json: flags.json },
+		};
+		await initTheme();
+		await runTelegramCommand(cmd);
+	}
+}

package/src/config/keybindings.ts

@@ -22,6 +22,7 @@ interface AppKeybindings {
 	"app.suspend": true;
 	"app.thinking.cycle": true;
 	"app.thinking.toggle": true;
+	"app.commandPalette.open": true;
 	"app.model.cycleForward": true;
 	"app.model.cycleBackward": true;
 	"app.model.select": true;
@@ -59,6 +60,10 @@ declare module "@sayknow-cli/tui" {
 	interface Keybindings extends AppKeybindings {}
 }
 
+export function defaultMessageQueueKeysForPlatform(platform: NodeJS.Platform = process.platform): KeyId {
+	return platform === "win32" ? "alt+q" : "alt+enter";
+}
+
 /**
  * All keybindings definitions: TUI + app-specific.
  */
@@ -88,12 +93,16 @@ export const KEYBINDINGS = {
 		defaultKeys: "ctrl+t",
 		description: "Toggle thinking mode",
 	},
-	"app.model.cycleForward": {
+	"app.commandPalette.open": {
 		defaultKeys: "ctrl+p",
+		description: "Open command palette",
+	},
+	"app.model.cycleForward": {
+		defaultKeys: "alt+n",
 		description: "Cycle to next model",
 	},
 	"app.model.cycleBackward": {
-		defaultKeys: "shift+ctrl+p",
+		defaultKeys: "alt+shift+n",
 		description: "Cycle to previous model",
 	},
 	"app.model.select": {
@@ -118,10 +127,10 @@ export const KEYBINDINGS = {
 	},
 	"app.message.followUp": {
 		defaultKeys: [],
-		description: "Send follow-up message (no default; Ctrl+Enter inserts a newline)",
+		description: "Send follow-up message (no default; Ctrl+Enter submits)",
 	},
 	"app.message.queue": {
-		defaultKeys: "alt+enter",
+		defaultKeys: defaultMessageQueueKeysForPlatform(),
 		description: "Queue message for next turn",
 	},
 	"app.message.dequeue": {
@@ -141,8 +150,8 @@ export const KEYBINDINGS = {
 		description: "Copy prompt",
 	},
 	"app.session.new": {
-		defaultKeys: [],
-		description: "Create new session",
+		defaultKeys: "ctrl+n",
+		description: "Start a new session",
 	},
 	"app.session.tree": {
 		defaultKeys: [],

package/src/config/mcp-schema.json

@@ -96,6 +96,10 @@
           "type": "boolean",
           "description": "Whether SKC should try to connect this server."
         },
+        "autoload": {
+          "type": "boolean",
+          "description": "Whether to connect this server automatically at session startup (default: true). When false the server stays configured until connected explicitly (e.g. /mcp connect <name>)."
+        },
         "timeout": {
           "type": "number",
           "exclusiveMinimum": 0,

package/src/config/model-registry.ts

@@ -243,6 +243,7 @@ interface ProviderValidationConfig {
 	requestTransform?: ModelRequestTransform;
 	disableStrictTools?: boolean;
 	cacheRetention?: CacheRetention;
+	openaiCompat?: { baseUrl: string; apiKey?: string; apiKeyEnv?: string };
 	modelOverrides?: Record<string, unknown>;
 	models: ProviderValidationModel[];
 }
@@ -271,11 +272,12 @@ function validateProviderConfiguration(
 				!config.disableStrictTools &&
 				!config.requestTransform &&
 				!config.cacheRetention &&
+				!config.openaiCompat &&
 				!hasModelOverrides &&
 				!config.discovery
 			) {
 				throw new Error(
-					`Provider ${providerName}: must specify "baseUrl", "headers", "apiKey", "compat", "requestTransform", "cacheRetention", "disableStrictTools", "modelOverrides", "discovery", or "models"`,
+					`Provider ${providerName}: must specify "baseUrl", "headers", "apiKey", "compat", "requestTransform", "cacheRetention", "disableStrictTools", "modelOverrides", "discovery", "openaiCompat", or "models"`,
 				);
 			}
 		}
@@ -389,6 +391,7 @@ export const ModelsConfigFile = new ConfigFile<ModelsConfig>("models", ModelsCon
 					requestTransform: providerConfig.requestTransform,
 					disableStrictTools: providerConfig.disableStrictTools,
 					cacheRetention: providerConfig.cacheRetention,
+					openaiCompat: providerConfig.openaiCompat,
 					modelOverrides: providerConfig.modelOverrides,
 					models: (providerConfig.models ?? []) as ProviderValidationModel[],
 				},
@@ -436,6 +439,18 @@ function resolveProviderBaseUrlFromEnv(provider: string): string | undefined {
 	return $pickenv(...getProviderBaseUrlEnvKeys(provider));
 }
 
+function normalizeLocalOpenAICompatBaseUrl(baseUrl: string): string {
+	try {
+		const parsed = new URL(baseUrl);
+		const trimmedPath = parsed.pathname.replace(/\/+$/g, "");
+		parsed.pathname = trimmedPath.endsWith("/v1") ? trimmedPath || "/v1" : `${trimmedPath}/v1`;
+		return `${parsed.protocol}//${parsed.host}${parsed.pathname}`;
+	} catch {
+		const trimmed = baseUrl.replace(/\/+$/g, "");
+		return trimmed.endsWith("/v1") ? trimmed : `${trimmed}/v1`;
+	}
+}
+
 /**
  * Merge a freshly discovered model with the matching bundled/configured entry
  * (or a runtime provider override when no bundled entry exists).
@@ -1409,6 +1424,45 @@ export class ModelRegistry {
 		for (const [providerName, providerConfig] of providerEntries) {
 			if (providerConfig.webSearch) this.#providerWebSearchModes.set(providerName, providerConfig.webSearch);
 			const providerApiKeyConfig = providerConfig.apiKey ?? resolveApiKeyEnvConfig(providerConfig.apiKeyEnv);
+			const localOpenAICompat = providerConfig.openaiCompat;
+			const localOpenAICompatApiKeyConfig = localOpenAICompat
+				? (localOpenAICompat.apiKey ?? resolveApiKeyEnvConfig(localOpenAICompat.apiKeyEnv))
+				: undefined;
+			if (localOpenAICompat) {
+				const localOpenAICompatBaseUrl = normalizeLocalOpenAICompatBaseUrl(localOpenAICompat.baseUrl);
+				const localCompatResolvedKey = localOpenAICompat.apiKeyEnv
+					? resolveApiKeyEnvConfig(localOpenAICompat.apiKeyEnv)
+					: localOpenAICompat.apiKey
+						? resolveApiKeyConfig(localOpenAICompat.apiKey)
+						: undefined;
+				overrides.set(providerName, {
+					baseUrl: localOpenAICompatBaseUrl,
+					apiKey: localOpenAICompatApiKeyConfig,
+					compat: {
+						supportsStore: false,
+						supportsDeveloperRole: false,
+						supportsReasoningEffort: false,
+					},
+				});
+				discoverableProviders.push({
+					provider: providerName,
+					api: "openai-completions",
+					baseUrl: localOpenAICompatBaseUrl,
+					compat: {
+						supportsStore: false,
+						supportsDeveloperRole: false,
+						supportsReasoningEffort: false,
+					},
+					discovery: { type: "openai-models-list" },
+					optional: false,
+				});
+				if (localCompatResolvedKey) {
+					this.#customProviderApiKeys.set(providerName, localCompatResolvedKey);
+					this.authStorage.setConfigApiKey(providerName, localCompatResolvedKey);
+				} else {
+					keylessProviders.add(providerName);
+				}
+			}
 			// Always set overrides when baseUrl/headers/apiKey/authHeader/compat/disableStrictTools/transport are present
 			if (
 				providerConfig.baseUrl ||

package/src/config/models-config-schema.ts

@@ -193,6 +193,14 @@ export const ProviderDiscoverySchema = z.object({
 	type: z.enum(["ollama", "llama.cpp", "lm-studio", "openai-models-list"]),
 });
 
+const LocalOpenAICompatSchema = z
+	.object({
+		baseUrl: z.string().min(1),
+		apiKey: z.string().min(1).optional(),
+		apiKeyEnv: z.string().min(1).optional(),
+	})
+	.strict();
+
 export const ProviderAuthSchema = z.enum(["apiKey", "none", "oauth"]);
 
 export type ProviderAuthMode = z.infer<typeof ProviderAuthSchema>;
@@ -237,6 +245,7 @@ const ProviderConfigSchema = z
 		 */
 		transport: z.literal("pi-native").optional(),
 		cacheRetention: CacheRetentionSchema.optional(),
+		openaiCompat: LocalOpenAICompatSchema.optional(),
 	})
 	.strict();
 

package/src/config/settings-schema.ts

@@ -36,7 +36,8 @@ export type SettingTab =
 	| "editing"
 	| "tools"
 	| "tasks"
-	| "providers";
+	| "providers"
+	| "integrations";
 
 /** Tab display metadata - icon is resolved via theme.symbol() */
 export type TabMetadata = { label: string; icon: `tab.${string}` };
@@ -52,6 +53,7 @@ export const SETTING_TABS: SettingTab[] = [
 	"tools",
 	"tasks",
 	"providers",
+	"integrations",
 ];
 
 /** Tab display metadata - icon is a symbol key from theme.ts (tab.*) */
@@ -65,6 +67,7 @@ export const TAB_METADATA: Record<SettingTab, { label: string; icon: `tab.${stri
 	tools: { label: "Tools", icon: "tab.tools" },
 	tasks: { label: "Tasks", icon: "tab.tasks" },
 	providers: { label: "Providers", icon: "tab.providers" },
+	integrations: { label: "Integrations", icon: "tab.integrations" },
 };
 
 /** Status line segment identifiers */
@@ -275,6 +278,44 @@ export const SETTINGS_SCHEMA = {
 		validate: (value: number) => Number.isFinite(value) && value > 0,
 	},
 
+	"notifications.terminalBell": {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "interaction",
+			label: "Terminal Bell",
+			description:
+				"Emit a BEL character for local terminal notifications. Windows Terminal may keep BEL silent depending on profile/system sound settings; use completion.notifyCommand for a PowerShell Console.Beep workaround.",
+		},
+	},
+	"notifications.bellOnComplete": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "interaction",
+			label: "Bell on Completion",
+			description: "Ring the terminal bell when an agent turn completes",
+		},
+	},
+	"notifications.bellOnApproval": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "interaction",
+			label: "Bell on Approval",
+			description: "Ring the terminal bell when a plan or approval prompt needs attention",
+		},
+	},
+	"notifications.bellOnAsk": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "interaction",
+			label: "Bell on Ask",
+			description: "Ring the terminal bell when an ask/user-input prompt needs attention",
+		},
+	},
+
 	autoResume: {
 		type: "boolean",
 		default: false,
@@ -439,7 +480,7 @@ export const SETTINGS_SCHEMA = {
 	// Status line
 	"statusLine.preset": {
 		type: "enum",
-		values: ["default", "minimal", "compact", "full", "nerd", "ascii", "custom"] as const,
+		values: ["default", "default-usage", "minimal", "compact", "full", "nerd", "ascii", "custom"] as const,
 		default: "default",
 		ui: {
 			tab: "appearance",
@@ -447,6 +488,11 @@ export const SETTINGS_SCHEMA = {
 			description: "Pre-built status line configurations",
 			options: [
 				{ value: "default", label: "Default", description: "Model, path, git, context, tokens, cost" },
+				{
+					value: "default-usage",
+					label: "Default + Usage",
+					description: "Default layout with provider usage quota",
+				},
 				{ value: "minimal", label: "Minimal", description: "Path and git only" },
 				{ value: "compact", label: "Compact", description: "Model, git, cost, context" },
 				{ value: "full", label: "Full", description: "All segments including time" },
@@ -486,6 +532,21 @@ export const SETTINGS_SCHEMA = {
 			description: "Use the session name color for the editor border and status line gap",
 		},
 	},
+	"statusLine.maxRows": {
+		type: "number",
+		default: 1,
+		ui: {
+			tab: "appearance",
+			label: "Status Line Rows",
+			description:
+				"Maximum rows for the status line. When greater than 1, overflowing segments wrap onto additional rows instead of being dropped.",
+			options: [
+				{ value: "1", label: "1 row", description: "Single line; overflow is truncated (default)" },
+				{ value: "2", label: "2 rows", description: "Wrap overflow onto a second row" },
+				{ value: "3", label: "3 rows", description: "Wrap overflow across up to three rows" },
+			],
+		},
+	},
 	"tools.artifactSpillThreshold": {
 		type: "number",
 		default: 50,
@@ -1157,6 +1218,16 @@ export const SETTINGS_SCHEMA = {
 		default: "on",
 		ui: { tab: "interaction", label: "Completion Notification", description: "Notify when the agent completes" },
 	},
+	"completion.notifyCommand": {
+		type: "string",
+		default: "",
+		ui: {
+			tab: "interaction",
+			label: "Completion Notification Command",
+			description:
+				"Optional user-level shell command to run when an agent turn completes; receives SKC_NOTIFICATION_* environment variables. On Windows, this can call PowerShell [Console]::Beep when terminal BEL is silent.",
+		},
+	},
 
 	"ask.timeout": {
 		type: "number",
@@ -2179,6 +2250,11 @@ export const SETTINGS_SCHEMA = {
 		ui: { tab: "tools", label: "Web Search", description: "Enable the web_search tool for web searching" },
 	},
 
+	"web_search.provider": {
+		type: "enum",
+		values: ["auto", ...CONFIGURABLE_SEARCH_PROVIDER_IDS] as const,
+		default: "auto",
+	},
 	"web_search.fallback": {
 		type: "array",
 		default: EMPTY_STRING_ARRAY,
@@ -2442,7 +2518,7 @@ export const SETTINGS_SCHEMA = {
 	"tools.discoveryMode": {
 		type: "enum",
 		values: ["off", "all"] as const,
-		default: "off",
+		default: "all",
 		ui: {
 			tab: "tools",
 			label: "Tool Discovery",
@@ -2457,7 +2533,7 @@ export const SETTINGS_SCHEMA = {
 			tab: "tools",
 			label: "Essential Tools Override",
 			description:
-				"Override the always-loaded built-in tools (default: read, bash, edit). Leave empty to use defaults.",
+				"Override the always-loaded built-in tools (default: read, bash, edit, write, search, find). Leave empty to use defaults.",
 		},
 	},
 
@@ -3109,6 +3185,151 @@ export const SETTINGS_SCHEMA = {
 			description: "Score threshold (0–100) above which block mode denies install. Default 60.",
 		},
 	},
+
+	// Telegram Remote — two-way messaging integration.
+	// Maps to SKC_TELEGRAM_REMOTE_* env vars consumed by the
+	// @sayknow-cli/telegram-remote gateway (packages/telegram-remote).
+	// The settings bridge converts these into env before spawning the gateway.
+	"telegram.enabled": {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "integrations",
+			label: "Telegram Remote",
+			description: "Enable two-way Telegram bot control of skc sessions",
+		},
+	},
+
+	"telegram.botToken": {
+		type: "string",
+		default: undefined,
+		ui: {
+			tab: "integrations",
+			label: "Bot Token",
+			description: "Telegram bot token from @BotFather (required when enabled)",
+		},
+	},
+
+	"telegram.allowedUserIds": {
+		type: "string",
+		default: undefined,
+		ui: {
+			tab: "integrations",
+			label: "Allowed User IDs",
+			description: "Comma-separated Telegram user IDs permitted to send commands",
+		},
+	},
+
+	"telegram.allowedChatIds": {
+		type: "string",
+		default: undefined,
+		ui: {
+			tab: "integrations",
+			label: "Allowed Chat IDs",
+			description: "Comma-separated Telegram chat IDs permitted to send commands",
+		},
+	},
+
+	"telegram.backend": {
+		type: "enum",
+		values: ["coordinator", "rpc"] as const,
+		default: "coordinator",
+		ui: {
+			tab: "integrations",
+			label: "Backend",
+			description: "Coordinator (multi-session lifecycle) or RPC (single persistent session)",
+			options: [
+				{ value: "coordinator", label: "Coordinator", description: "Multi-session lifecycle + observation" },
+				{ value: "rpc", label: "RPC", description: "Attach/detach to one persistent session socket" },
+			],
+		},
+	},
+
+	"telegram.enableStop": {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "integrations",
+			label: "Enable /stop",
+			description: "Allow graceful stop requests (adds the reports mutation class)",
+		},
+	},
+
+	"telegram.enableRich": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "integrations",
+			label: "Rich Messages",
+			description: "HTML formatting + inline keyboards",
+		},
+	},
+
+	"telegram.enablePush": {
+		type: "boolean",
+		default: false,
+		ui: {
+			tab: "integrations",
+			label: "Push Notifications",
+			description: "Follow/Mute subscriptions via coordinator event watch",
+		},
+	},
+
+	"telegram.registerCommands": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "integrations",
+			label: "Register Bot Menu",
+			description: "Register the Bot command menu at startup",
+		},
+	},
+
+	"telegram.presets": {
+		type: "string",
+		default: undefined,
+		ui: {
+			tab: "integrations",
+			label: "Session Presets",
+			description: "JSON array of {id, workdir, sessionCommand, taskTemplate?, taskMaxLen?}",
+		},
+	},
+
+	"telegram.rpcSocket": {
+		type: "string",
+		default: undefined,
+		ui: {
+			tab: "integrations",
+			label: "RPC Socket",
+			description: "Path to the skc launch --output rpc UNIX socket (RPC backend only)",
+		},
+	},
+
+	"telegram.stateDir": {
+		type: "string",
+		default: undefined,
+		ui: {
+			tab: "integrations",
+			label: "State Directory",
+			description: "Gateway state dir for reconnect/resync (required for RPC backend)",
+		},
+	},
+
+	// Telegram advanced — hidden from UI, editable via config.yml
+	"telegram.pollTimeoutSec": { type: "number", default: 30 },
+	"telegram.apiBase": { type: "string", default: undefined },
+	"telegram.coordinatorCommand": { type: "string", default: "skc" },
+	"telegram.coordinatorArgs": { type: "string", default: "mcp-serve,coordinator" },
+	"telegram.enableEditMessageText": { type: "boolean", default: false },
+	"telegram.richCallbackTtlMs": { type: "number", default: 600000 },
+	"telegram.richCallbackMaxTokens": { type: "number", default: 500 },
+	"telegram.defaultTaskMaxLen": { type: "number", default: 2000 },
+	"telegram.livenessMs": { type: "number", default: 60000 },
+	"telegram.followTtlMs": { type: "number", default: 86400000 },
+	"telegram.subscriptionsMax": { type: "number", default: 1000 },
+	"telegram.longPollMs": { type: "number", default: 25000 },
+	"telegram.digestThreshold": { type: "number", default: 5 },
+	"telegram.allowAttachSocketArg": { type: "boolean", default: false },
 } as const;
 
 // ═══════════════════════════════════════════════════════════════════════════
@@ -3276,6 +3497,7 @@ export interface ExaSettings {
 export interface StatusLineSettings {
 	preset: StatusLinePreset;
 	separator: StatusLineSeparatorStyle;
+	maxRows: number;
 	showHookStatus: boolean;
 	showSkillHud: boolean;
 	leftSegments: StatusLineSegmentId[];
@@ -3336,6 +3558,35 @@ export interface NotificationsSettings {
 	};
 }
 
+export interface TelegramSettings {
+	enabled: boolean;
+	botToken: string | undefined;
+	allowedUserIds: string | undefined;
+	allowedChatIds: string | undefined;
+	backend: "coordinator" | "rpc";
+	enableStop: boolean;
+	enableRich: boolean;
+	enablePush: boolean;
+	registerCommands: boolean;
+	presets: string | undefined;
+	rpcSocket: string | undefined;
+	stateDir: string | undefined;
+	pollTimeoutSec: number;
+	apiBase: string | undefined;
+	coordinatorCommand: string;
+	coordinatorArgs: string;
+	enableEditMessageText: boolean;
+	richCallbackTtlMs: number;
+	richCallbackMaxTokens: number;
+	defaultTaskMaxLen: number;
+	livenessMs: number;
+	followTtlMs: number;
+	subscriptionsMax: number;
+	longPollMs: number;
+	digestThreshold: number;
+	allowAttachSocketArg: boolean;
+}
+
 /** Map group prefix -> typed settings interface */
 export interface GroupTypeMap {
 	compaction: CompactionSettings;
@@ -3354,6 +3605,7 @@ export interface GroupTypeMap {
 	modelTags: ModelTagsSettings;
 	cycleOrder: string[];
 	shellMinimizer: ShellMinimizerSettings;
+	telegram: TelegramSettings;
 	notifications: NotificationsSettings;
 }
 

package/src/config/settings.ts

@@ -298,6 +298,17 @@ export class Settings {
 		return getDefault(path);
 	}
 
+	/**
+	 * Get a setting value from the user/global config only.
+	 *
+	 * Use for machine-local command hooks and other settings that must not be
+	 * activated by project-scoped config files.
+	 */
+	getGlobal<P extends SettingPath>(path: P): SettingValue<P> | undefined {
+		const value = getByPath(this.#global, path.split("."));
+		return value === undefined ? undefined : (value as SettingValue<P>);
+	}
+
 	/** Check whether a setting is present in loaded settings/overrides rather than coming from schema defaults. */
 	has(path: SettingPath): boolean {
 		return getByPath(this.#merged, path.split(".")) !== undefined;