@sayknow-cli/coding-agent 0.3.9 → 0.3.11

package/CHANGELOG.md

@@ -4,6 +4,27 @@ Sayknow-CLI is a rebranded fork of [gajae-code](https://github.com/Yeachan-Heo/g
 This file tracks the **fork's own releases**; upstream's full feature history lives
 in that project. Each release notes the upstream version it is built on.
 
+## [0.3.11] — 2026-07-09
+
+### Fixed
+
+- Restored npm source-install native loading by probing the platform optional
+  package (`@sayknow-cli/natives-<platform>`) when the stable native loader package
+  no longer carries `.node` binaries directly.
+
+## [0.3.10] — 2026-07-09
+
+### Changed
+
+- Synced onto upstream **gajae-code v0.9.2**, carrying the 0.9.2 patch set into
+  Sayknow-CLI while preserving the SKC fork layer and release surface.
+
+### Fixed
+
+- Updated the release version surfaces so `skc --version`, package metadata,
+  native sentinel exports, plugin metadata, schemas, and public sync checks report
+  **0.3.10** consistently.
+
 ## [0.3.0] — 2026-06-23
 
 ### Changed

package/dist/types/cli/args.d.ts

@@ -14,6 +14,7 @@ export interface Args {
     mpreset?: string;
     default?: boolean;
     apiKey?: string;
+    credential?: string;
     systemPrompt?: string;
     appendSystemPrompt?: string;
     thinking?: Effort;

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

@@ -19,12 +19,17 @@ export interface NotifyCommandDeps {
     setupRedact?: boolean;
     setupInteractive?: boolean;
     threadedModePrompt?: (message: string) => Promise<string>;
+    tokenPrompt?: () => Promise<string>;
+    setExitCode?: (code: number) => void;
+    exitProcess?: (code: number) => void;
 }
 export declare function parseNotifyArgs(args: string[]): NotifyCommandArgs | undefined;
 export declare function runNotifyCommand(cmd: NotifyCommandArgs, deps?: NotifyCommandDeps): Promise<void>;
+export declare function runNotifyCliCommand(cmd: NotifyCommandArgs, deps?: NotifyCommandDeps): Promise<void>;
 type TokenPromptInput = NodeJS.ReadStream & {
     isRaw?: boolean;
     setRawMode?: (mode: boolean) => unknown;
+    pause?: () => unknown;
 };
 type TokenPromptOutput = Pick<NodeJS.WriteStream, "write">;
 export declare function promptForToken(input?: TokenPromptInput, output?: TokenPromptOutput): Promise<string>;

package/dist/types/cli.d.ts

@@ -40,6 +40,9 @@ export declare class RootHelpCommand extends Command {
         "api-key": import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
             description: string;
         };
+        credential: import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
         "system-prompt": import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
             description: string;
         };

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

@@ -37,6 +37,9 @@ export default class Index extends Command {
         "api-key": import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
             description: string;
         };
+        credential: import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+        };
         "system-prompt": import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
             description: string;
         };

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

@@ -1,4 +1,4 @@
-import type { ThinkingLevel } from "@sayknow-cli/agent-core";
+import { ThinkingLevel } from "@sayknow-cli/agent-core";
 import type { Api, Model } from "@sayknow-cli/ai";
 import type { AgentSession } from "../session/agent-session";
 import { type ModelRegistry, type SkcModelAssignmentTargetId } from "./model-registry";
@@ -16,6 +16,10 @@ export interface PrepareModelProfileActivationOptions {
     settings: Pick<Settings, "get">;
     profileName: string;
 }
+export interface ApplyModelProfileActivationOptions {
+    persistDefault?: boolean;
+    thinkingLevelOverride?: ThinkingLevel;
+}
 export interface PreparedModelProfileActivation {
     profileName: string;
     session: ModelProfileActivationSession & {
@@ -55,10 +59,6 @@ export declare function materializeActiveModelProfileAssignment(options: Materia
 export declare function materializeActiveModelProfileAssignments(options: MaterializeModelProfileAssignmentsOptions): 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?: {
-    persistDefault?: boolean;
-}): Promise<void>;
-export declare function activateModelProfile(options: PrepareModelProfileActivationOptions, applyOptions?: {
-    persistDefault?: boolean;
-}): Promise<void>;
+export declare function applyPreparedModelProfileActivation(prepared: PreparedModelProfileActivation, options?: ApplyModelProfileActivationOptions): Promise<void>;
+export declare function activateModelProfile(options: PrepareModelProfileActivationOptions, applyOptions?: ApplyModelProfileActivationOptions): Promise<void>;
 export {};

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

@@ -1,4 +1,4 @@
-import { type Api, type AssistantMessageEventStream, type CacheRetention, type Context, type Model, type ModelRefreshStrategy, type ModelRequestTransform, type SimpleStreamOptions, type ThinkingConfig } from "@sayknow-cli/ai";
+import { type Api, type AssistantMessageEventStream, type AuthCredentialSelector, type CacheRetention, type Context, type Model, type ModelRefreshStrategy, type ModelRequestTransform, type SimpleStreamOptions, type ThinkingConfig } from "@sayknow-cli/ai";
 import type { OAuthCredentials, OAuthLoginCallbacks } from "@sayknow-cli/ai/utils/oauth/types";
 import { type ThemeColor } from "../modes/theme/theme";
 import type { AuthStorage } from "../session/auth-storage";
@@ -19,6 +19,8 @@ export interface ModelRoleInfo {
 }
 export declare const MODEL_ROLES: Record<ModelRole, ModelRoleInfo>;
 export declare const MODEL_ROLE_IDS: ModelRole[];
+export declare const MODEL_PROFILE_NAME_PATTERN: RegExp;
+export declare const MODEL_PROFILE_NAME_PATTERN_DESCRIPTION = "lowercase letters, numbers, dots, underscores, or hyphens";
 export type SkcModelAssignmentTargetId = "default" | "executor" | "architect" | "planner" | "critic";
 export interface SkcModelAssignmentTargetInfo extends ModelRoleInfo {
     id: SkcModelAssignmentTargetId;
@@ -342,6 +344,8 @@ export declare class ModelRegistry {
     getModelProfile(name: string): ModelProfileDefinition | undefined;
     getAvailableModelProfileNames(): string[];
     saveCustomModelProfile(name: string, definition: ModelProfileConfig): Promise<ModelProfileDefinition>;
+    renameCustomModelProfile(name: string, displayName: string): Promise<ModelProfileDefinition>;
+    deleteCustomModelProfile(name: string): Promise<ModelProfileConfig>;
     applyConfiguredModelBindings(targetSettings: Settings): void;
     /**
      * Get all models (built-in + custom).
@@ -382,11 +386,15 @@ export declare class ModelRegistry {
     /**
      * Get API key for a model.
      */
-    getApiKey(model: Model<Api>, sessionId?: string): Promise<string | undefined>;
+    getApiKey(model: Model<Api>, sessionId?: string, options?: {
+        credentialSelector?: AuthCredentialSelector;
+    }): Promise<string | undefined>;
     /**
      * Get API key for a provider (e.g., "openai").
      */
-    getApiKeyForProvider(provider: string, sessionId?: string, baseUrl?: string): Promise<string | undefined>;
+    getApiKeyForProvider(provider: string, sessionId?: string, baseUrl?: string, options?: {
+        credentialSelector?: AuthCredentialSelector;
+    }): Promise<string | undefined>;
     /**
      * Check if a model is using OAuth credentials (subscription).
      */

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

@@ -2,7 +2,7 @@
  * Model resolution, scoping, and initial selection
  */
 import { ThinkingLevel } from "@sayknow-cli/agent-core";
-import { type Api, type Effort, type KnownProvider, type Model } from "@sayknow-cli/ai";
+import { type Api, type KnownProvider, type Model } from "@sayknow-cli/ai";
 import { type ModelRegistry, type ModelRole } from "./model-registry";
 import type { Settings } from "./settings";
 /** Default model IDs for each known provider */
@@ -204,7 +204,7 @@ export declare function findInitialModel(options: {
     isContinuing: boolean;
     defaultProvider?: string;
     defaultModelId?: string;
-    defaultThinkingSelector?: Effort;
+    defaultThinkingSelector?: ThinkingLevel;
     modelRegistry: InitialModelRegistry;
 }): Promise<InitialModelResult>;
 /**

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

@@ -950,7 +950,7 @@ export declare const SETTINGS_SCHEMA: {
     };
     readonly defaultThinkingLevel: {
         readonly type: "enum";
-        readonly values: readonly Effort[];
+        readonly values: readonly ["off", ...Effort[]];
         readonly default: Effort;
         readonly ui: {
             readonly tab: "model";

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

@@ -82,6 +82,13 @@ export declare class Settings {
      * Call before exit to ensure all changes are persisted.
      */
     flush(): Promise<void>;
+    /**
+     * Like {@link flush}, but rejects if the durable save fails instead of
+     * swallowing the error. Use where the caller must confirm persistence before
+     * reporting success (e.g. the Telegram `/rich` toggle). In-memory instances
+     * ({@link isolated}) short-circuit in {@link #saveNow} and never throw.
+     */
+    flushOrThrow(): Promise<void>;
     cloneForCwd(cwd: string): Promise<Settings>;
     getStorage(): AgentStorage | null;
     getCwd(): string;

package/dist/types/extensibility/runtime-skill-discovery.d.ts

@@ -0,0 +1,20 @@
+import type { SkillsSettings } from "../config/settings-schema";
+import type { Skill } from "./skills";
+export type RuntimeSkillDiscoverySource = "project" | "user";
+export interface RuntimeSkillDiscoveryCandidate {
+    name: string;
+    description: string;
+    source: RuntimeSkillDiscoverySource;
+    path: string;
+    useWhen?: string[];
+}
+export interface DiscoverRuntimeSkillsOptions {
+    cwd: string;
+    home?: string;
+    query?: string;
+    limit?: number;
+    source?: RuntimeSkillDiscoverySource | "all";
+    policy?: SkillsSettings;
+}
+export declare function discoverRuntimeSkills(options: DiscoverRuntimeSkillsOptions): Promise<RuntimeSkillDiscoveryCandidate[]>;
+export declare function findRuntimeSkillByName(cwd: string, name: string, policy?: SkillsSettings, home?: string): Promise<Skill | undefined>;

package/dist/types/modes/components/settings-selector.d.ts

@@ -1,4 +1,4 @@
-import type { ThinkingLevel } from "@sayknow-cli/agent-core";
+import { type ThinkingLevel as ThinkingLevelValue } from "@sayknow-cli/agent-core";
 import type { Effort } from "@sayknow-cli/ai";
 import { Container, SettingsList } from "@sayknow-cli/tui";
 import { type SettingPath } from "../../config/settings";
@@ -13,7 +13,7 @@ export interface SettingsRuntimeContext {
     /** Available thinking levels (from session) */
     availableThinkingLevels: Effort[];
     /** Current thinking level (from session) */
-    thinkingLevel: ThinkingLevel | undefined;
+    thinkingLevel: ThinkingLevelValue | undefined;
     /** Available themes */
     availableThemes: string[];
     /** Available model profile names (from the model registry) */

package/dist/types/modes/components/thinking-selector.d.ts

@@ -1,10 +1,15 @@
 import { type ThinkingLevel as ThinkingLevelValue } from "@sayknow-cli/agent-core";
 import { Container, SelectList } from "@sayknow-cli/tui";
+export interface ThinkingSelectorSelection {
+    level: ThinkingLevelValue;
+    persistDefault: boolean;
+}
 /**
  * Component that renders a thinking level selector with borders
  */
 export declare class ThinkingSelectorComponent extends Container {
     #private;
-    constructor(currentLevel: ThinkingLevelValue | undefined, availableLevels: ThinkingLevelValue[], onSelect: (level: ThinkingLevelValue) => void, onCancel: () => void);
+    constructor(currentLevel: ThinkingLevelValue | undefined, availableLevels: ThinkingLevelValue[], onSelect: (selection: ThinkingSelectorSelection) => void, onCancel: () => void);
+    handleInput(data: string): void;
     getSelectList(): SelectList;
 }

package/dist/types/modes/types.d.ts

@@ -28,6 +28,7 @@ import type { Theme } from "./theme/theme";
 export type CompactionQueuedMessage = {
     text: string;
     mode: "steer" | "followUp";
+    followUpQueuePolicy?: "sequential";
 };
 export type SubmittedUserInput = {
     text: string;

package/dist/types/notifications/config-commands.d.ts

@@ -18,6 +18,35 @@ export interface ConfigCommandChange {
     verbosity?: "lean" | "verbose";
     redact?: boolean;
 }
+export type TelegramControlCommandName = "reasoning" | "usage" | "context" | "compact";
+export type TelegramControlCommand = {
+    name: "reasoning";
+    action: "cycle" | "status" | "set";
+    level?: string;
+} | {
+    name: "usage";
+} | {
+    name: "context";
+} | {
+    name: "compact";
+    instructions?: string;
+};
+export type TelegramControlCommandParseResult = {
+    kind: "none";
+} | {
+    kind: "ignored";
+    commandName: TelegramControlCommandName;
+} | {
+    kind: "command";
+    command: TelegramControlCommand;
+} | {
+    kind: "invalid";
+    commandName: TelegramControlCommandName;
+    usage: string;
+};
+export declare function telegramControlCommandUsage(commandName: TelegramControlCommandName): string;
+/** Parse deterministic Telegram session-control commands. Recognised roots fail closed. */
+export declare function parseTelegramControlCommand(text: string, botUsername?: string): TelegramControlCommandParseResult;
 /**
  * Parse an in-thread config command. Returns the requested change, or
  * `undefined` when the text is not a recognised config command (so the daemon

package/dist/types/notifications/index.d.ts

@@ -18,7 +18,7 @@
  * generated), or `SKC_NOTIFICATIONS_TOKEN`.
  */
 import { Settings } from "../config/settings";
-import type { ExtensionAPI } from "../extensibility/extensions";
+import type { ExtensionAPI, ExtensionContext } from "../extensibility/extensions";
 /** Where a `session_create` should run. Discriminated by `kind`. */
 export type SessionCreateTarget = {
     kind: "existing_path";
@@ -176,6 +176,17 @@ export interface SessionReadyFrame {
  */
 export declare function readGitRepoName(cwd: string): string | undefined;
 export declare function notificationsEnabled(): boolean;
+interface NotificationControlCommandPayload {
+    name?: unknown;
+    action?: unknown;
+    level?: unknown;
+    instructions?: unknown;
+}
+export declare function executeNotificationControlCommand(command: NotificationControlCommandPayload | undefined, ctx: ExtensionContext, api: ExtensionAPI): Promise<{
+    status: "ok" | "error" | "unavailable";
+    message: string;
+}>;
 export declare function createNotificationsExtension(api: ExtensionAPI, options?: {
     settings?: Settings;
 }): void;
+export {};

package/dist/types/notifications/threaded-render.d.ts

@@ -67,6 +67,8 @@ interface ThreadedFrame {
     name?: unknown;
     verbosity?: unknown;
     redact?: unknown;
+    status?: unknown;
+    message?: unknown;
 }
 /** Format the one-time identity header as pinned bullets. */
 export declare function formatIdentityHeader(frame: {

package/dist/types/notifications/topic-registry.d.ts

@@ -58,11 +58,10 @@ export declare class TopicRegistry {
     markIdentitySent(sessionId: string): void;
     /** Whether the identity header still needs sending for this session. */
     needsIdentity(sessionId: string): boolean;
-    /**
-     * Record the topic's applied title. Returns `true` when it changed (so the
-     * caller should `editForumTopic`), `false` when already current or unknown.
-     */
-    applyName(sessionId: string, name: string): boolean;
+    /** Whether a known session topic's applied title differs from `name`. */
+    needsRename(sessionId: string, name: string): boolean;
+    /** Commit a successfully-applied Telegram topic title. */
+    markNameApplied(sessionId: string, name: string): void;
     /** Remove a session topic record after Telegram deletes the topic. */
     delete(sessionId: string): boolean;
     /** Serialise for atomic persistence beside the daemon state. */

package/dist/types/runtime-credential-selector.d.ts

@@ -0,0 +1,7 @@
+import type { AuthCredentialSelector } from "@sayknow-cli/ai";
+export interface CliCredentialSelector {
+    provider?: string;
+    selector: AuthCredentialSelector;
+    raw: string;
+}
+export declare function parseCliCredentialSelector(raw: string): CliCredentialSelector;

package/dist/types/sdk.d.ts

@@ -1,5 +1,5 @@
 import { type AgentTelemetryConfig, type ThinkingLevel } from "@sayknow-cli/agent-core";
-import { type Model, type ProviderSessionState } from "@sayknow-cli/ai";
+import { type AuthCredentialSelector, type Model, type ProviderSessionState } from "@sayknow-cli/ai";
 import { createAppendOnlyContextManager, providerSupportsAppendOnlyAuto, resolveAppendOnlyMode } from "./append-only-mode";
 import { type Rule } from "./capability/rule";
 import { ModelRegistry } from "./config/model-registry";
@@ -55,6 +55,12 @@ export interface CreateAgentSessionOptions {
     /** Optional provider-facing session identifier for prompt caches and sticky auth selection.
      * Keeps persisted session files isolated while reusing provider-side caches. */
     providerSessionId?: string;
+    /** Runtime credential selector for multi-account auth pools. */
+    credentialSelector?: {
+        provider?: string;
+        selector: AuthCredentialSelector;
+        raw: string;
+    };
     /** Custom tools to register (in addition to built-in tools). Accepts both CustomTool and ToolDefinition. */
     customTools?: (CustomTool | ToolDefinition)[];
     /** Explicit parent/phase used to load active SKC sub-skill tools for this session. */

package/dist/types/session/agent-session.d.ts

@@ -270,6 +270,8 @@ export interface PromptOptions {
     images?: ImageContent[];
     /** When streaming, how to queue the message: "steer" (interrupt) or "followUp" (wait). */
     streamingBehavior?: "steer" | "followUp";
+    /** When set to "sequential", this follow-up is delivered one prompt at a time even if followUpMode is "all". */
+    followUpQueuePolicy?: "respect-mode" | "sequential";
     /** Optional tool choice override for the next LLM call. */
     toolChoice?: ToolChoice;
     /** Send as developer/system message instead of user. Providers that support it use the developer role; others fall back to user. */
@@ -657,7 +659,7 @@ export declare class AgentSession {
      * @throws Error if no model selected or no API key available (when not streaming)
      */
     prompt(text: string, options?: PromptOptions): Promise<void>;
-    promptCustomMessage<T = unknown>(message: Pick<CustomMessage<T>, "customType" | "content" | "display" | "details" | "attribution">, options?: Pick<PromptOptions, "streamingBehavior" | "toolChoice">): Promise<void>;
+    promptCustomMessage<T = unknown>(message: Pick<CustomMessage<T>, "customType" | "content" | "display" | "details" | "attribution">, options?: Pick<PromptOptions, "streamingBehavior" | "toolChoice" | "followUpQueuePolicy">): Promise<void>;
     /**
      * Queue a steering message to interrupt the agent mid-run.
      */
@@ -665,7 +667,7 @@ export declare class AgentSession {
     /**
      * Queue a follow-up message to process after the agent would otherwise stop.
      */
-    followUp(text: string, images?: ImageContent[]): Promise<void>;
+    followUp(text: string, images?: ImageContent[], options?: Pick<PromptOptions, "followUpQueuePolicy">): Promise<void>;
     queueDeferredMessage(message: CustomMessage): void;
     queueDeferredMessageForTests(message: CustomMessage, triggerTurn?: boolean): void;
     /**
@@ -679,6 +681,7 @@ export declare class AgentSession {
     sendCustomMessage<T = unknown>(message: Pick<CustomMessage<T>, "customType" | "content" | "display" | "details" | "attribution">, options?: {
         triggerTurn?: boolean;
         deliverAs?: "steer" | "followUp" | "nextTurn";
+        followUpQueuePolicy?: "respect-mode" | "sequential";
     }): Promise<void>;
     /** Remove undelivered queued custom messages matching `predicate` from executable queues and tagged display mirrors. */
     purgeQueuedCustomMessages(predicate: (message: CustomMessage) => boolean): PurgeQueuedCustomMessagesResult;
@@ -834,7 +837,7 @@ export declare class AgentSession {
     getAvailableModels(): Model[];
     /**
      * Set thinking level.
-     * Saves the effective metadata-clamped level to session and settings only if it changes.
+     * Saves the effective metadata-clamped level to the session, and to settings when requested.
      */
     setThinkingLevel(level: ThinkingLevel | undefined, persist?: boolean): void;
     /**

package/dist/types/tools/index.d.ts

@@ -53,6 +53,7 @@ export * from "./review";
 export * from "./search";
 export * from "./search-tool-bm25";
 export * from "./skill";
+export * from "./skill-discovery";
 export * from "./ssh";
 export * from "./subagent";
 export * from "./telegram-send";

package/dist/types/tools/skill-discovery.d.ts

@@ -0,0 +1,40 @@
+import type { AgentTool, AgentToolResult } from "@sayknow-cli/agent-core";
+import * as z from "zod/v4";
+import { type RuntimeSkillDiscoveryCandidate } from "../extensibility/runtime-skill-discovery";
+import type { ToolSession } from ".";
+declare const skillDiscoverySchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        all: "all";
+        project: "project";
+        user: "user";
+    }>>>;
+    limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, z.core.$strict>;
+export type SkillDiscoveryToolInput = z.infer<typeof skillDiscoverySchema>;
+export interface SkillDiscoveryToolDetails {
+    candidates: RuntimeSkillDiscoveryCandidate[];
+    count: number;
+}
+export declare class SkillDiscoveryTool implements AgentTool<typeof skillDiscoverySchema, SkillDiscoveryToolDetails> {
+    #private;
+    readonly name = "skill_discovery";
+    readonly label = "SkillDiscovery";
+    readonly summary = "Discover project and user runtime skills by thin metadata";
+    readonly loadMode = "essential";
+    readonly description: string;
+    readonly parameters: z.ZodObject<{
+        query: z.ZodOptional<z.ZodString>;
+        source: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+            all: "all";
+            project: "project";
+            user: "user";
+        }>>>;
+        limit: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    }, z.core.$strict>;
+    readonly strict = true;
+    constructor(session: ToolSession);
+    static createIf(session: ToolSession): SkillDiscoveryTool | null;
+    execute(_toolCallId: string, input: SkillDiscoveryToolInput, signal?: AbortSignal): Promise<AgentToolResult<SkillDiscoveryToolDetails>>;
+}
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@sayknow-cli/coding-agent",
-	"version": "0.3.9",
+	"version": "0.3.11",
 	"description": "Sayknow-CLI CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://sayknow-cli.com",
 	"author": "jaybeyond",
@@ -52,12 +52,12 @@
 		"@agentclientprotocol/sdk": "0.21.0",
 		"@babel/parser": "^7.29.3",
 		"@mozilla/readability": "^0.6.0",
-		"@sayknow-cli/stats": "0.3.9",
-		"@sayknow-cli/agent-core": "0.3.9",
-		"@sayknow-cli/ai": "0.3.9",
-		"@sayknow-cli/natives": "0.3.9",
-		"@sayknow-cli/tui": "0.3.9",
-		"@sayknow-cli/utils": "0.3.9",
+		"@sayknow-cli/stats": "0.3.11",
+		"@sayknow-cli/agent-core": "0.3.11",
+		"@sayknow-cli/ai": "0.3.11",
+		"@sayknow-cli/natives": "0.3.11",
+		"@sayknow-cli/tui": "0.3.11",
+		"@sayknow-cli/utils": "0.3.11",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",

package/src/cli/args.ts

@@ -3,6 +3,7 @@
  */
 import { type Effort, THINKING_EFFORTS } from "@sayknow-cli/ai";
 import { APP_NAME, CONFIG_DIR_NAME, logger } from "@sayknow-cli/utils";
+import { CliParseError } from "@sayknow-cli/utils/cli";
 import chalk from "chalk";
 import { parseEffort } from "../thinking";
 import { BUILTIN_TOOLS } from "../tools";
@@ -20,6 +21,7 @@ export interface Args {
 	mpreset?: string;
 	default?: boolean;
 	apiKey?: string;
+	credential?: string;
 	systemPrompt?: string;
 	appendSystemPrompt?: string;
 	thinking?: Effort;
@@ -136,6 +138,12 @@ export function parseArgs(args: string[]): Args {
 			result.default = true;
 		} else if (arg === "--api-key" && i + 1 < args.length) {
 			result.apiKey = args[++i];
+		} else if (arg === "--credential") {
+			const next = args[i + 1];
+			if (!next || next.startsWith("-")) {
+				throw new CliParseError("--credential requires <selector>");
+			}
+			result.credential = args[++i];
 		} else if (arg === "--system-prompt" && i + 1 < args.length) {
 			result.systemPrompt = args[++i];
 		} else if (arg === "--append-system-prompt" && i + 1 < args.length) {

package/src/cli/notify-cli.ts

@@ -31,6 +31,9 @@ export interface NotifyCommandDeps {
 	setupRedact?: boolean;
 	setupInteractive?: boolean;
 	threadedModePrompt?: (message: string) => Promise<string>;
+	tokenPrompt?: () => Promise<string>;
+	setExitCode?: (code: number) => void;
+	exitProcess?: (code: number) => void;
 }
 
 interface TelegramApiResponse<T> {
@@ -126,6 +129,27 @@ export async function runNotifyCommand(cmd: NotifyCommandArgs, deps: NotifyComma
 	}
 }
 
+export async function runNotifyCliCommand(cmd: NotifyCommandArgs, deps: NotifyCommandDeps = {}): Promise<void> {
+	try {
+		await runNotifyCommand(cmd, deps);
+	} catch (error) {
+		if (cmd.action !== "setup" || !(error instanceof Error)) {
+			throw error;
+		}
+
+		const cancelled = error.message === "Telegram bot token prompt cancelled.";
+		process.stderr.write(cancelled ? "Telegram notify setup cancelled.\n" : `Error: ${error.message}\n`);
+		const code = cancelled ? 130 : 1;
+		if (deps.setExitCode) {
+			deps.setExitCode(code);
+		} else {
+			process.exitCode = code;
+		}
+		const exitProcess = deps.exitProcess ?? (deps.setExitCode ? undefined : process.exit);
+		exitProcess?.(code);
+	}
+}
+
 async function getSettings(deps: NotifyCommandDeps): Promise<Settings> {
 	if (deps.settings) return deps.settings;
 	const { Settings } = await import("../config/settings");
@@ -136,7 +160,7 @@ async function runSetup(deps: NotifyCommandDeps): Promise<void> {
 	const settings = await getSettings(deps);
 	const fetchImpl = deps.fetchImpl ?? globalThis.fetch;
 	const apiBase = deps.apiBase ?? DEFAULT_API_BASE;
-	const token = deps.setupToken ?? (await promptForToken());
+	const token = deps.setupToken ?? (await (deps.tokenPrompt ?? promptForToken)());
 	if (!token.trim()) {
 		throw new Error("Telegram bot token is required.");
 	}
@@ -179,6 +203,7 @@ async function runSetup(deps: NotifyCommandDeps): Promise<void> {
 type TokenPromptInput = NodeJS.ReadStream & {
 	isRaw?: boolean;
 	setRawMode?: (mode: boolean) => unknown;
+	pause?: () => unknown;
 };
 
 type TokenPromptOutput = Pick<NodeJS.WriteStream, "write">;
@@ -206,6 +231,7 @@ export async function promptForToken(
 			input.off("data", onData);
 			input.off("error", onError);
 			input.setRawMode?.(wasRaw);
+			input.pause?.();
 			output.write("\n");
 		};