@sayknow-cli/coding-agent 0.3.1 → 0.3.4

package/bin/skc.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env bun
+import { runCli } from "@sayknow-cli/coding-agent/cli";
+
+await runCli(process.argv.slice(2));

package/dist/types/cli/mcp-cli.d.ts

@@ -0,0 +1,25 @@
+import type { MCPServerConfig } from "../runtime-mcp/types";
+export type MCPAction = "add" | "list" | "remove";
+export interface MCPCommandArgs {
+    action: MCPAction;
+    name?: string;
+    commandArgs?: string[];
+    flags: {
+        project?: boolean;
+        force?: boolean;
+        json?: boolean;
+        type?: "stdio" | "http" | "sse";
+        command?: string;
+        url?: string;
+        arg?: string[];
+        env?: string[];
+        header?: string[];
+        cwd?: string;
+        timeout?: number;
+    };
+    cwd?: string;
+}
+export declare class MCPArgsError extends Error {
+}
+export declare function redactMCPServerConfig(config: MCPServerConfig): MCPServerConfig;
+export declare function runMCPCommand(args: MCPCommandArgs): Promise<void>;

package/dist/types/cli/plugin-cli.d.ts

@@ -17,6 +17,8 @@ export interface PluginCommandArgs {
         disable?: string;
         set?: string;
         scope?: "user" | "project";
+        user?: boolean;
+        project?: boolean;
     };
 }
 /**

package/dist/types/cli.d.ts

@@ -1,3 +1,9 @@
 #!/usr/bin/env bun
+/**
+ * CLI entry point — registers all commands explicitly and delegates to the
+ * lightweight CLI runner from pi-utils.
+ */
+import { type CommandEntry } from "@sayknow-cli/utils/cli";
+export declare const commands: CommandEntry[];
 /** Run the CLI with the given argv (no `process.argv` prefix). */
 export declare function runCli(argv: string[]): Promise<void>;

package/dist/types/commands/mcp.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Direct MCP server registration for standalone SKC.
+ */
+import { Command } from "@sayknow-cli/utils/cli";
+import { type MCPAction } from "../cli/mcp-cli";
+export default class MCP extends Command {
+    static description: string;
+    static delegateHelp: boolean;
+    static examples: string[];
+    static args: {
+        action: import("@sayknow-cli/utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            options: MCPAction[];
+        };
+        name: import("@sayknow-cli/utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+        };
+        commandArgs: import("@sayknow-cli/utils/cli").ArgDescriptor & {
+            description: string;
+            required: false;
+            multiple: true;
+        };
+    };
+    static flags: {
+        project: import("@sayknow-cli/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        force: import("@sayknow-cli/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+            default: boolean;
+        };
+        json: import("@sayknow-cli/utils/cli").FlagDescriptor<"boolean"> & {
+            char: string;
+            description: string;
+            default: boolean;
+        };
+        type: import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            options: string[];
+        };
+        command: import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        url: import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        arg: import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            multiple: true;
+        };
+        env: import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            multiple: true;
+        };
+        header: import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            multiple: true;
+        };
+        cwd: import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        timeout: import("@sayknow-cli/utils/cli").FlagDescriptor<"integer"> & {
+            description: string;
+        };
+    };
+    run(): Promise<void>;
+    private printHelp;
+}

package/dist/types/commands/plugin.d.ts

@@ -47,6 +47,12 @@ export default class Plugin extends Command {
             description: string;
             options: string[];
         };
+        user: import("@sayknow-cli/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
+        project: import("@sayknow-cli/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+        };
     };
     run(): Promise<void>;
 }

package/dist/types/commands/session.d.ts

@@ -18,6 +18,12 @@ export default class Session extends Command {
             description: string;
             default: boolean;
         };
+        "session-id": import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
+        "state-file": import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
     };
     static examples: string[];
     run(): Promise<void>;

package/dist/types/config/keybindings.d.ts

@@ -230,8 +230,8 @@ export declare const KEYBINDINGS: {
         readonly description: "Open external editor";
     };
     readonly "app.message.followUp": {
-        readonly defaultKeys: "ctrl+enter";
-        readonly description: "Send follow-up message";
+        readonly defaultKeys: [];
+        readonly description: "Send follow-up message (no default; Ctrl+Enter inserts a newline)";
     };
     readonly "app.message.queue": {
         readonly defaultKeys: "alt+enter";

package/dist/types/config/model-profile-activation.d.ts

@@ -1,7 +1,7 @@
 import type { ThinkingLevel } from "@sayknow-cli/agent-core";
 import type { Api, Model } from "@sayknow-cli/ai";
 import type { AgentSession } from "../session/agent-session";
-import { type ModelRegistry } from "./model-registry";
+import { type ModelRegistry, type SkcModelAssignmentTargetId } from "./model-registry";
 import type { Settings } from "./settings";
 type ModelProfileActivationSession = Pick<AgentSession, "model" | "thinkingLevel" | "sessionId"> & {
     setModelTemporary?: AgentSession["setModelTemporary"];
@@ -40,6 +40,13 @@ export interface PreparedModelProfileActivation {
      */
     previousSessionDefaultModel: string | undefined;
 }
+export interface MaterializeModelProfileAssignmentOptions {
+    session: Pick<ModelProfileActivationSession, "model" | "thinkingLevel" | "setActiveModelProfile" | "getActiveModelProfile">;
+    settings: Pick<Settings, "clearOverride" | "get" | "override" | "set">;
+    role: SkcModelAssignmentTargetId;
+    selector: string;
+}
+export declare function materializeActiveModelProfileAssignment(options: MaterializeModelProfileAssignmentOptions): boolean;
 export declare function formatModelProfileCredentialError(profileName: string, providers: readonly string[]): string;
 export declare function prepareModelProfileActivation(options: PrepareModelProfileActivationOptions): Promise<PreparedModelProfileActivation>;
 export declare function applyPreparedModelProfileActivation(prepared: PreparedModelProfileActivation, options?: {

package/dist/types/config/model-profiles.d.ts

@@ -20,8 +20,8 @@ export interface ModelProfileDefinition {
 }
 export interface ResolvedProfileBinding {
     defaultSelector?: string;
-    modelRoles: Partial<Record<"vision", string>>;
-    agentModelOverrides: Partial<Record<Exclude<ModelProfileRole, "default" | "vision">, string>>;
+    modelRoles: Record<string, string>;
+    agentModelOverrides: Partial<Record<Exclude<ModelProfileRole, "default">, string>>;
 }
 export declare function deriveModelProfileMappedProviders(definition: Pick<ModelProfileDefinition, "modelMapping">): string[];
 export declare function aggregateModelProfileRequiredProviders(requiredProviders: readonly string[], definition: Pick<ModelProfileDefinition, "modelMapping">): string[];

package/dist/types/config/model-registry.d.ts

@@ -11,7 +11,7 @@ import { type Settings } from "./settings";
 export type { CanonicalModelIndex, CanonicalModelRecord, CanonicalModelVariant, ModelEquivalenceConfig };
 export declare const kNoAuth = "N/A";
 export declare function isAuthenticated(apiKey: string | undefined | null): apiKey is string;
-export type ModelRole = "default" | "vision";
+export type ModelRole = "default";
 export interface ModelRoleInfo {
     tag?: string;
     name: string;
@@ -19,7 +19,7 @@ export interface ModelRoleInfo {
 }
 export declare const MODEL_ROLES: Record<ModelRole, ModelRoleInfo>;
 export declare const MODEL_ROLE_IDS: ModelRole[];
-export type SkcModelAssignmentTargetId = "default" | "vision" | "executor" | "architect" | "planner" | "critic";
+export type SkcModelAssignmentTargetId = "default" | "executor" | "architect" | "planner" | "critic";
 export interface SkcModelAssignmentTargetInfo extends ModelRoleInfo {
     id: SkcModelAssignmentTargetId;
     settingsPath: "modelRoles" | "task.agentModelOverrides";
@@ -268,7 +268,7 @@ export declare const ModelsConfigFile: ConfigFile<{
     profiles?: Record<string, {
         required_providers: string[];
         display_name?: string | undefined;
-        model_mapping: Partial<Record<"architect" | "critic" | "default" | "executor" | "planner" | "vision", string>>;
+        model_mapping: Partial<Record<"architect" | "critic" | "default" | "executor" | "planner", string>>;
     }> | undefined;
 }>;
 /** Provider override config (baseUrl, headers, apiKey, compat, transport) without custom models */

package/dist/types/config/models-config-schema.d.ts

@@ -68,7 +68,6 @@ export declare const ProfileRoleSchema: z.ZodEnum<{
     default: "default";
     executor: "executor";
     planner: "planner";
-    vision: "vision";
 }>;
 export declare const ProfileModelSelectorSchema: z.ZodString;
 export declare const ProfileModelMappingSchema: z.ZodRecord<z.ZodEnum<{
@@ -77,7 +76,6 @@ export declare const ProfileModelMappingSchema: z.ZodRecord<z.ZodEnum<{
     default: "default";
     executor: "executor";
     planner: "planner";
-    vision: "vision";
 }> & z.core.$partial, z.ZodString>;
 export declare const ProfileDefinitionSchema: z.ZodObject<{
     required_providers: z.ZodArray<z.ZodString>;
@@ -88,7 +86,6 @@ export declare const ProfileDefinitionSchema: z.ZodObject<{
         default: "default";
         executor: "executor";
         planner: "planner";
-        vision: "vision";
     }> & z.core.$partial, z.ZodString>;
 }, z.core.$strict>;
 export declare const ProfilesSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -100,7 +97,6 @@ export declare const ProfilesSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
         default: "default";
         executor: "executor";
         planner: "planner";
-        vision: "vision";
     }> & z.core.$partial, z.ZodString>;
 }, z.core.$strict>>;
 export declare const ModelOverrideSchema: z.ZodObject<{
@@ -691,7 +687,6 @@ export declare const ModelsConfigSchema: z.ZodObject<{
             default: "default";
             executor: "executor";
             planner: "planner";
-            vision: "vision";
         }> & z.core.$partial, z.ZodString>;
     }, z.core.$strict>>>;
 }, z.core.$strict>;

package/dist/types/config/settings-schema.d.ts

@@ -10,7 +10,7 @@ import { type SkillDiscoverySettings } from "./skill-settings-defaults";
  *   settings.get("compaction.enabled")  // => boolean
  *   settings.set("theme.dark", "red-octopus")  // sync, saves in background
  */
-export type SettingTab = "appearance" | "model" | "interaction" | "notifications" | "context" | "memory" | "editing" | "tools" | "tasks" | "providers";
+export type SettingTab = "appearance" | "model" | "interaction" | "context" | "memory" | "editing" | "tools" | "tasks" | "providers";
 /** Tab display metadata - icon is resolved via theme.symbol() */
 export type TabMetadata = {
     label: string;
@@ -56,13 +56,10 @@ interface UiString extends UiBase {
      *  - Omitted → renders as a free text input.
      */
     options?: ReadonlyArray<SubmenuOption> | "runtime";
-    /** When true, the value is masked in the settings list display but edited in full. */
-    secret?: boolean;
 }
 /** Wide ui shape exposed to consumers that walk the schema generically. */
 export type AnyUiMetadata = UiBase & {
     options?: ReadonlyArray<SubmenuOption> | "runtime";
-    secret?: boolean;
 };
 interface BooleanDef {
     type: "boolean";
@@ -124,94 +121,39 @@ export declare const SETTINGS_SCHEMA: {
     readonly "notifications.enabled": {
         readonly type: "boolean";
         readonly default: false;
-        readonly ui: {
-            readonly tab: "notifications";
-            readonly label: "Enabled";
-            readonly description: "Master switch for notifications. Requires at least one adapter (Telegram/Discord/Slack) configured with a token and a chat/channel to actually deliver.";
-        };
     };
     readonly "notifications.telegram.botToken": {
         readonly type: "string";
         readonly default: undefined;
-        readonly ui: {
-            readonly tab: "notifications";
-            readonly label: "Telegram bot token";
-            readonly description: "Telegram BotFather HTTP API token. Stored locally; shown masked.";
-            readonly secret: true;
-        };
     };
     readonly "notifications.telegram.chatId": {
         readonly type: "string";
         readonly default: undefined;
-        readonly ui: {
-            readonly tab: "notifications";
-            readonly label: "Telegram chat ID";
-            readonly description: "Target chat. For end-to-end per-session delivery this must be a forum-enabled supergroup the bot can manage; a private chat id is only enough for setup/status.";
-        };
     };
     readonly "notifications.discord.botToken": {
         readonly type: "string";
         readonly default: undefined;
-        readonly ui: {
-            readonly tab: "notifications";
-            readonly label: "Discord bot token";
-            readonly description: "Discord bot token for the notifications adapter. Stored locally; shown masked.";
-            readonly secret: true;
-        };
     };
     readonly "notifications.discord.channelId": {
         readonly type: "string";
         readonly default: undefined;
-        readonly ui: {
-            readonly tab: "notifications";
-            readonly label: "Discord channel ID";
-            readonly description: "Discord channel that receives notifications and routes replies back.";
-        };
     };
     readonly "notifications.slack.botToken": {
         readonly type: "string";
         readonly default: undefined;
-        readonly ui: {
-            readonly tab: "notifications";
-            readonly label: "Slack bot token";
-            readonly description: "Slack bot token for the notifications adapter. Stored locally; shown masked.";
-            readonly secret: true;
-        };
     };
     readonly "notifications.slack.channelId": {
         readonly type: "string";
         readonly default: undefined;
-        readonly ui: {
-            readonly tab: "notifications";
-            readonly label: "Slack channel ID";
-            readonly description: "Slack channel that receives notifications and routes replies back.";
-        };
     };
     readonly "notifications.redact": {
         readonly type: "boolean";
         readonly default: false;
-        readonly ui: {
-            readonly tab: "notifications";
-            readonly label: "Redact";
-            readonly description: "Strip idle summaries and streamed content before remote delivery. Ask prompts are always sent so they remain answerable.";
-        };
     };
     readonly "notifications.verbosity": {
         readonly type: "string";
         readonly default: "lean";
         readonly validate: (value: string) => value is "lean" | "verbose";
-        readonly ui: {
-            readonly tab: "notifications";
-            readonly label: "Verbosity";
-            readonly description: "How much session context to stream to Telegram.";
-            readonly options: readonly [{
-                readonly value: "lean";
-                readonly label: "Lean";
-            }, {
-                readonly value: "verbose";
-                readonly label: "Verbose";
-            }];
-        };
     };
     readonly "notifications.daemon.idleTimeoutMs": {
         readonly type: "number";
@@ -2550,15 +2492,6 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Enable the recipe tool when a justfile / package.json / Cargo.toml / Makefile / Taskfile is present";
         };
     };
-    readonly "inspect_image.enabled": {
-        readonly type: "boolean";
-        readonly default: false;
-        readonly ui: {
-            readonly tab: "tools";
-            readonly label: "Inspect Image";
-            readonly description: "Enable the inspect_image tool, delegating image understanding to a vision-capable model";
-        };
-    };
     readonly "checkpoint.enabled": {
         readonly type: "boolean";
         readonly default: false;
@@ -2652,6 +2585,16 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Ordered fallback web search providers after the active model native provider";
         };
     };
+    readonly "web_search.timeout": {
+        readonly type: "number";
+        readonly default: 300;
+        readonly validate: (value: number) => boolean;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Web Search Timeout";
+            readonly description: "Hard timeout in seconds for a single web search request (default 300)";
+        };
+    };
     readonly "browser.enabled": {
         readonly type: "boolean";
         readonly default: true;
@@ -2679,6 +2622,45 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Directory to save screenshots. If unset, screenshots go to a temp file. Supports ~. Examples: ~/Downloads, ~/Desktop, /sdcard/Download (Android)";
         };
     };
+    readonly "browser.gc.enabled": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Browser Tab GC";
+            readonly description: "Automatically reclaim idle, unheld SKC-managed headless/spawned browser tabs.";
+        };
+    };
+    readonly "browser.gc.idleMs": {
+        readonly type: "number";
+        readonly default: 300000;
+        readonly validate: (value: number) => boolean;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Browser Tab GC Idle (ms)";
+            readonly description: "Evict headless/spawned tabs idle longer than this many milliseconds.";
+        };
+    };
+    readonly "browser.gc.rssLimitMb": {
+        readonly type: "number";
+        readonly default: 1536;
+        readonly validate: (value: number) => boolean;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Browser Tab GC RSS Limit (MB)";
+            readonly description: "Parent-process RSS (MB) above which idle tabs are opportunistically evicted LRU.";
+        };
+    };
+    readonly "resourceGc.sweepIntervalMs": {
+        readonly type: "number";
+        readonly default: 30000;
+        readonly validate: (value: number) => boolean;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Resource GC Sweep Interval (ms)";
+            readonly description: "How often the resource GC sweeps browser tabs and stale screenshot directories.";
+        };
+    };
     readonly "computer.enabled": {
         readonly type: "boolean";
         readonly default: false;
@@ -2733,6 +2715,35 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Persist audit records for enabled computer-use actions.";
         };
     };
+    readonly "computer.screenshotGc.enabled": {
+        readonly type: "boolean";
+        readonly default: true;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Computer Screenshot GC";
+            readonly description: "Delete stale computer-use screenshot fallback directories on disk.";
+        };
+    };
+    readonly "computer.screenshotGc.staleMs": {
+        readonly type: "number";
+        readonly default: 43200000;
+        readonly validate: (value: number) => boolean;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Computer Screenshot GC Stale Age (ms)";
+            readonly description: "Remove screenshot fallback directories whose mtime is older than this many milliseconds.";
+        };
+    };
+    readonly "computer.screenshotGc.scanIntervalMs": {
+        readonly type: "number";
+        readonly default: 1800000;
+        readonly validate: (value: number) => boolean;
+        readonly ui: {
+            readonly tab: "tools";
+            readonly label: "Computer Screenshot GC Scan Interval (ms)";
+            readonly description: "Minimum interval between os.tmpdir scans for stale screenshot directories.";
+        };
+    };
     readonly "tools.intentTracing": {
         readonly type: "boolean";
         readonly default: true;

package/dist/types/deep-interview/plaintext-gate-guard.d.ts

@@ -0,0 +1,11 @@
+export type DeepInterviewPlaintextAskLeakOption = "Yes, crystallize" | "Adjust wording" | "Missing scope";
+export type DeepInterviewPlaintextAskLeakResult = {
+    kind: "deep_interview_plaintext_ask_leak";
+    matchedOptions: DeepInterviewPlaintextAskLeakOption[];
+    signals: {
+        optionsHeading: true;
+        restateIntent: true;
+        deepInterviewContext: boolean;
+    };
+};
+export declare function detectDeepInterviewPlaintextAskLeak(text: string): DeepInterviewPlaintextAskLeakResult | null;