@sayknow-cli/coding-agent 0.3.12 → 0.3.13

package/dist/types/cli/list-models.d.ts

@@ -1,36 +0,0 @@
-import type { ModelRegistry } from "../config/model-registry";
-import { type ExtensionFactory } from "../extensibility/extensions";
-/**
- * List available models, optionally filtered by search pattern
- */
-export declare function listModels(modelRegistry: ModelRegistry, searchPattern?: string): Promise<void>;
-/**
- * Options for the `--list-models` command entry point.
- */
-export interface RunListModelsOptions {
-    modelRegistry: ModelRegistry;
-    cwd: string;
-    /** CLI-supplied extension paths (e.g. from `-e <path>`). */
-    additionalExtensionPaths?: string[];
-    /** In-process extension factories to load without filesystem discovery. */
-    extensionFactories?: Array<{
-        factory: ExtensionFactory;
-        name: string;
-    }>;
-    /** Extension paths configured under `extensions:` in user settings. */
-    settingsExtensions?: string[];
-    /** Disabled extension ids from settings (`disabledExtensions`). */
-    disabledExtensionIds?: string[];
-    /** When true, skip discovery and only load `additionalExtensionPaths`. */
-    disableExtensionDiscovery?: boolean;
-    searchPattern?: string;
-}
-/**
- * Loads extensions (CLI `-e` paths and `settings.extensions`) and surfaces
- * any provider/model registrations on the supplied `modelRegistry` before
- * delegating to {@link listModels}. This is the single entry point used by
- * `--list-models` and exists to ensure extension-contributed providers are
- * visible in the listing (issue #905). The load is intentionally narrow:
- * no agent loop, no MCP servers, no custom-tool registration.
- */
-export declare function runListModelsCommand(options: RunListModelsOptions): Promise<void>;

package/dist/types/cli/local-provider-smoke.d.ts

@@ -1,59 +0,0 @@
-import type { ModelsConfig } from "../config/models-config-schema";
-export interface LocalProviderSmokeCommandArgs {
-    model?: string;
-    modelsPath?: string;
-    timeoutMs?: number;
-    json?: boolean;
-    smoke?: boolean;
-}
-export interface LocalOpenAICompatConfig {
-    baseUrl: string;
-    apiKey?: string;
-}
-export type LocalProviderDiagnosticCheckName = "config" | "models" | "chat_stream";
-export type LocalProviderDiagnosticStatus = "ok" | "skipped" | "error";
-export type LocalProviderDiagnosticCategory = "auth" | "timeout" | "unreachable" | "not_ready" | "oom" | "malformed_response" | "http_error" | "configuration" | "empty_response";
-export interface LocalProviderDiagnosticCheck {
-    name: LocalProviderDiagnosticCheckName;
-    status: LocalProviderDiagnosticStatus;
-    message: string;
-    action?: string;
-    category?: LocalProviderDiagnosticCategory;
-    error?: string;
-    httpStatus?: number;
-}
-export interface LocalProviderSmokeResult {
-    ok: boolean;
-    baseUrl?: string;
-    model?: string;
-    message: string;
-    error?: string;
-    category?: LocalProviderDiagnosticCategory;
-    action?: string;
-}
-export interface LocalProviderDiscoveryResult {
-    ok: boolean;
-    provider: string;
-    baseUrl?: string;
-    models: string[];
-    message: string;
-    error?: string;
-    category?: LocalProviderDiagnosticCategory;
-    action?: string;
-}
-export interface LocalProviderStatusResult {
-    ok: boolean;
-    provider: "local";
-    baseUrl?: string;
-    model?: string;
-    models: string[];
-    checks: LocalProviderDiagnosticCheck[];
-    message: string;
-}
-export declare function getLocalOpenAICompatConfig(config: ModelsConfig | undefined): LocalOpenAICompatConfig | undefined;
-export declare function runLocalProviderDiscover(cmd: Omit<LocalProviderSmokeCommandArgs, "model" | "smoke">): Promise<LocalProviderDiscoveryResult>;
-export declare function runLocalProviderStatus(cmd: LocalProviderSmokeCommandArgs): Promise<LocalProviderStatusResult>;
-export declare function runLocalProviderSmoke(cmd: LocalProviderSmokeCommandArgs): Promise<LocalProviderSmokeResult>;
-export declare function runLocalProviderDiscoverCommand(cmd: Omit<LocalProviderSmokeCommandArgs, "model" | "smoke">): Promise<void>;
-export declare function runLocalProviderStatusCommand(cmd: LocalProviderSmokeCommandArgs): Promise<void>;
-export declare function runLocalProviderSmokeCommand(cmd: LocalProviderSmokeCommandArgs): Promise<void>;

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

@@ -1,25 +0,0 @@
-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/migrate-cli.d.ts

@@ -1,20 +0,0 @@
-import { type MigrateReport, type MigrateSource } from "../migrate/types";
-export interface MigrateCommandArgs {
-    from: string[];
-    project: boolean;
-    force: boolean;
-    dryRun: boolean;
-    json: boolean;
-    /** Test seam: override home dir for source discovery. */
-    homeDir?: string;
-    /** Test seam: override cwd for project-scope destinations. */
-    cwd?: string;
-}
-export declare class MigrateArgsError extends Error {
-}
-/** Expand `all`/repeated `--from`, validate, and return sources in canonical order. */
-export declare function resolveSources(from: string[]): MigrateSource[];
-/** Run the migration and return the report (does not set process.exitCode). */
-export declare function runMigrate(args: MigrateCommandArgs): Promise<MigrateReport>;
-/** CLI entry: run, render, and set the process exit code. */
-export declare function runMigrateCommand(args: MigrateCommandArgs): Promise<void>;

package/dist/types/cli/nofile-limit.d.ts

@@ -1,11 +0,0 @@
-import { execFileSync } from "node:child_process";
-export declare const RECOMMENDED_MACOS_NOFILE_LIMIT = 4096;
-export declare function parseNoFileLimit(text: string): number | undefined;
-export declare function buildMacOSNoFileLimitWarning(currentLimit: number): string;
-export interface WarnIfMacOSNoFileLimitTooLowDeps {
-    platform?: NodeJS.Platform;
-    env?: NodeJS.ProcessEnv;
-    execFileSync?: typeof execFileSync;
-    writeStderr?: (text: string) => void;
-}
-export declare function warnIfMacOSNoFileLimitTooLow(deps?: WarnIfMacOSNoFileLimitTooLowDeps): void;

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

@@ -1,37 +0,0 @@
-import type { Settings } from "../config/settings";
-export type NotifyAction = "setup" | "status" | "daemon-internal";
-export interface NotifyCommandArgs {
-    action: NotifyAction;
-    smoke?: boolean;
-    rawArgs: string[];
-    token?: string;
-    chatId?: string;
-    redact?: boolean;
-}
-export interface NotifyCommandDeps {
-    fetchImpl?: typeof fetch;
-    apiBase?: string;
-    settings?: Settings;
-    setupToken?: string;
-    pollTimeoutMs?: number;
-    pollIntervalMs?: number;
-    setupChatId?: string;
-    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>;
-export declare function printNotifyHelp(): void;
-export {};

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

@@ -1,34 +0,0 @@
-/**
- * Plugin CLI command handlers.
- *
- * Handles `skc plugin <command>` subcommands for plugin lifecycle management.
- */
-export type PluginAction = "install" | "uninstall" | "list" | "link" | "doctor" | "features" | "config" | "enable" | "disable" | "marketplace" | "discover" | "upgrade";
-export interface PluginCommandArgs {
-    action: PluginAction;
-    args: string[];
-    flags: {
-        json?: boolean;
-        fix?: boolean;
-        force?: boolean;
-        dryRun?: boolean;
-        local?: boolean;
-        enable?: string;
-        disable?: string;
-        set?: string;
-        scope?: "user" | "project";
-        user?: boolean;
-        project?: boolean;
-    };
-}
-/**
- * Parse plugin subcommand arguments.
- * Returns undefined if not a plugin command.
- */
-export declare function parsePluginArgs(args: string[]): PluginCommandArgs | undefined;
-export { classifyInstallTarget } from "./classify-install-target";
-/**
- * Run a plugin command.
- */
-export declare function runPluginCommand(cmd: PluginCommandArgs): Promise<void>;
-export declare function printPluginHelp(): void;

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

@@ -1,4 +0,0 @@
-export interface ReadCommandArgs {
-    path: string;
-}
-export declare function runReadCommand(cmd: ReadCommandArgs): Promise<void>;

package/dist/types/cli/session-picker.d.ts

@@ -1,3 +0,0 @@
-import type { SessionInfo } from "../session/session-manager";
-/** Show TUI session selector and return selected session path or null if cancelled */
-export declare function selectSession(sessions: SessionInfo[]): Promise<string | null>;

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

@@ -1,73 +0,0 @@
-/**
- * Setup CLI command handler.
- *
- * Handles `skc setup [component]` to install the normal defaults or optional feature dependencies.
- */
-import { AuthStorage, SqliteAuthCredentialStore } from "@sayknow-cli/ai";
-import { runExternalCredentialAutoImport } from "../setup/credential-auto-import";
-export type SetupComponent = "claude" | "codex" | "credentials" | "defaults" | "hermes" | "hooks" | "provider" | "python" | "stt";
-export interface SetupCommandArgs {
-    component: SetupComponent;
-    flags: {
-        json?: boolean;
-        check?: boolean;
-        force?: boolean;
-        preset?: string;
-        compat?: string;
-        provider?: string;
-        baseUrl?: string;
-        apiKeyEnv?: string;
-        model?: string[];
-        modelsPath?: string;
-        smoke?: boolean;
-        install?: boolean;
-        root?: string[];
-        repo?: string;
-        profile?: string;
-        sessionCommand?: string;
-        noWorktree?: boolean;
-        worktreeName?: string;
-        stateRoot?: string;
-        mutation?: string[];
-        artifactByteCap?: string;
-        serverKey?: string;
-        skcCommand?: string;
-        target?: string;
-        profileDir?: string;
-        yes?: boolean;
-        dryRun?: boolean;
-        keychain?: boolean;
-    };
-}
-/**
- * Parse setup subcommand arguments.
- * Returns undefined if not a setup command.
- */
-export declare function parseSetupArgs(args: string[]): SetupCommandArgs | undefined;
-/**
- * Install Python packages using uv (preferred) or pip.
- */
-/**
- * Run the setup command.
- */
-export declare function runSetupCommand(cmd: SetupCommandArgs): Promise<void>;
-/**
- * Discover existing Claude Code / Codex CLI credentials and import them into the
- * skc credential store after a redacted preview + confirmation. Falls back to
- * manual-setup guidance when nothing importable is found.
- */
-export interface CredentialsSetupDependencies {
-    openStore?: typeof SqliteAuthCredentialStore.open;
-    createAuthStorage?: (store: Awaited<ReturnType<typeof SqliteAuthCredentialStore.open>>) => AuthStorage;
-    discover?: Parameters<typeof runExternalCredentialAutoImport>[0]["discover"];
-}
-export declare function handleCredentialsSetup(flags: {
-    json?: boolean;
-    yes?: boolean;
-    dryRun?: boolean;
-    keychain?: boolean;
-}, deps?: CredentialsSetupDependencies): Promise<void>;
-/**
- * Print setup command help.
- */
-export declare function printSetupHelp(): void;

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

@@ -1,8 +0,0 @@
-export interface ShellCommandArgs {
-    cwd?: string;
-    timeoutMs?: number;
-    noSnapshot?: boolean;
-}
-export declare function parseShellArgs(args: string[]): ShellCommandArgs | undefined;
-export declare function runShellCommand(cmd: ShellCommandArgs): Promise<void>;
-export declare function printShellHelp(): void;

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

@@ -1,9 +0,0 @@
-export type SkillsAction = "list" | "read";
-export interface SkillsCommandArgs {
-    action: SkillsAction;
-    name?: string;
-    flags?: {
-        json?: boolean;
-    };
-}
-export declare function runSkillsCommand(cmd: SkillsCommandArgs): Promise<void>;

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

@@ -1,21 +0,0 @@
-/**
- * SSH CLI command handlers.
- *
- * Handles `skc ssh <command>` subcommands for SSH host configuration management.
- */
-export type SSHAction = "add" | "remove" | "list";
-export interface SSHCommandArgs {
-    action: SSHAction;
-    args: string[];
-    flags: {
-        json?: boolean;
-        host?: string;
-        user?: string;
-        port?: string;
-        key?: string;
-        desc?: string;
-        compat?: boolean;
-        scope?: "project" | "user";
-    };
-}
-export declare function runSSHCommand(cmd: SSHCommandArgs): Promise<void>;

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

@@ -1,17 +0,0 @@
-/**
- * Stats CLI command handlers.
- *
- * Handles `skc stats` subcommand for viewing AI usage statistics.
- */
-export interface StatsCommandArgs {
-    port: number;
-    json: boolean;
-    summary: boolean;
-}
-/**
- * Parse stats subcommand arguments.
- * Returns undefined if not a stats command.
- */
-export declare function parseStatsArgs(args: string[]): StatsCommandArgs | undefined;
-export declare function runStatsCommand(cmd: StatsCommandArgs): Promise<void>;
-export declare function printStatsHelp(): void;

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

@@ -1,13 +0,0 @@
-/**
- * `skc telegram` command handlers — start/status/env for the Telegram Remote
- * integration, driven entirely by the `telegram.*` settings group.
- */
-export type TelegramAction = "start" | "status" | "env" | "__gateway";
-export interface TelegramCommandArgs {
-    action: TelegramAction;
-    flags: {
-        json?: boolean;
-    };
-}
-export declare const TELEGRAM_ACTIONS: readonly TelegramAction[];
-export declare function runTelegramCommand(cmd: TelegramCommandArgs): Promise<void>;

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

@@ -1,89 +0,0 @@
-/** Result from running the installed binary and parsing its reported version. */
-export interface InstalledVersionVerification {
-    ok: boolean;
-    actual?: string;
-    path?: string;
-    smokeTestFailed?: boolean;
-    smokeTestOutput?: string;
-    cleanupWarning?: string;
-}
-export interface PackageManagerUpdateResult {
-    exitCode: number | null;
-    text: () => string;
-}
-export type PackageManagerUpdateRunner = (expectedVersion: string) => Promise<PackageManagerUpdateResult>;
-export interface PackageManagerUpdateOptions {
-    managerName: string;
-    expectedVersion: string;
-    runInstall: PackageManagerUpdateRunner;
-    verifyInstalledRuntime: (expectedVersion: string) => Promise<InstalledVersionVerification>;
-    printVerificationResult?: (expectedVersion: string) => Promise<void>;
-    printRecoveredVerification?: (expectedVersion: string) => void;
-}
-/** Paths and verifier used while replacing a downloaded binary update. */
-export interface BinaryReplacementOptions {
-    targetPath: string;
-    tempPath: string;
-    backupPath: string;
-    expectedVersion: string;
-    verifyInstalledVersion: (expectedVersion: string) => Promise<InstalledVersionVerification>;
-}
-/**
- * Parse update subcommand arguments.
- * Returns undefined if not an update command.
- */
-export declare function parseUpdateArgs(args: string[]): {
-    force: boolean;
-    check: boolean;
-} | undefined;
-type PackageManagerTarget = {
-    manager: "npm";
-    packageName: string;
-};
-type PathPlatform = NodeJS.Platform;
-type PackageExists = (packageName: string, packageRoot: string) => boolean;
-export declare function resolveUpdateMethodForTest(ompPath: string, bunBinDir: string | undefined): "bun" | "npm" | "binary";
-export declare function resolveNpmManagedTargetForTest(ompPath: string, platform: PathPlatform, packageExists: PackageExists): PackageManagerTarget | undefined;
-export declare function formatBinaryDownloadFailureMessageForTest(binaryName: string, url: string, status: string | number, platform?: NodeJS.Platform): string;
-export declare function buildReleaseBinaryUrlForTest(version: string, platform?: NodeJS.Platform, arch?: string): string;
-export declare function formatManualUpdateInstructionsForTest(platform?: NodeJS.Platform): string;
-export declare function formatVerificationFailureForTest(result: InstalledVersionVerification, expectedVersion: string): string;
-/**
- * Atomically replace the installed binary and roll back if version verification fails.
- */
-export declare function replaceBinaryForUpdate(options: BinaryReplacementOptions): Promise<InstalledVersionVerification>;
-export declare function runPackageManagerUpdateForTest(options: PackageManagerUpdateOptions): Promise<InstalledVersionVerification>;
-export declare function fsyncFileForTest(filePath: string): Promise<void>;
-/** Injectable steps of the binary update flow (seams for testing ordering). */
-export interface BinaryUpdateFlow {
-    download(url: string, tempPath: string): Promise<void>;
-    fsync(filePath: string): Promise<void>;
-    replace(options: BinaryReplacementOptions): Promise<InstalledVersionVerification>;
-    verifyInstalledVersion(expectedVersion: string): Promise<InstalledVersionVerification>;
-    /** Best-effort cleanup of the temp file when the flow aborts before replace. */
-    removeTemp?(filePath: string): Promise<void>;
-    /** Called once fsync has succeeded, right before replacement begins. */
-    beforeReplace?(): void;
-}
-/**
- * Orchestrate download → fsync → replace → verify with a strict ordering
- * contract: the downloaded temp binary MUST be flushed to stable storage
- * before it is published (renamed into place) or exec'd for verification.
- *
- * If fsync fails the temp bytes are not durable, so we abort before
- * replacement/verification and clean up the temp file rather than installing a
- * possibly-truncated binary.
- */
-export declare function runBinaryUpdateFlow(targetPath: string, url: string, expectedVersion: string, flow: BinaryUpdateFlow): Promise<InstalledVersionVerification>;
-/**
- * Run the update command.
- */
-export declare function runUpdateCommand(opts: {
-    force: boolean;
-    check: boolean;
-}): Promise<void>;
-/**
- * Print update command help.
- */
-export declare function printUpdateHelp(): void;
-export {};

package/dist/types/cli/web-search-cli.d.ts

@@ -1,32 +0,0 @@
-/**
- * Web search CLI command handlers.
- *
- * Handles `skc q`/`skc web-search` subcommands for testing web search providers.
- */
-import { type SearchQueryParams } from "../web/search/index";
-import type { SearchProviderId } from "../web/search/types";
-export interface SearchCommandArgs {
-    query: string;
-    provider?: SearchProviderId | "auto";
-    recency?: "day" | "week" | "month" | "year";
-    limit?: number;
-    expanded: boolean;
-    xaiSearchMode?: SearchQueryParams["xai_search_mode"];
-    allowedDomains?: string[];
-    excludedDomains?: string[];
-    allowedXHandles?: string[];
-    excludedXHandles?: string[];
-    fromDate?: string;
-    toDate?: string;
-    enableImageUnderstanding?: boolean;
-    enableImageSearch?: boolean;
-    enableVideoUnderstanding?: boolean;
-    noInlineCitations?: boolean;
-}
-/**
- * Parse web search subcommand arguments.
- * Returns undefined if not a web search command.
- */
-export declare function parseSearchArgs(args: string[]): SearchCommandArgs | undefined;
-export declare function runSearchCommand(cmd: SearchCommandArgs): Promise<void>;
-export declare function printSearchHelp(): void;

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

@@ -1,26 +0,0 @@
-type WorktreeKind = "pr-checkout" | "task-isolation" | "empty" | "stray";
-export interface WorktreeEntry {
-    /** Absolute path to the worktree dir (or stray container) under `~/.skc/wt/`. */
-    path: string;
-    /** Classification of what we found on disk. */
-    kind: WorktreeKind;
-    /** Parent repo root, when this is a registered git worktree. */
-    parentRepo?: string;
-    /** Branch name extracted from the parent's tracking file, when available. */
-    branch?: string;
-    /** When set, the entry is unhealthy and `skc worktree clear` will remove it. */
-    orphanReason?: string;
-}
-export interface ListWorktreesOptions {
-    json: boolean;
-}
-export interface ClearWorktreesOptions {
-    /** Remove every entry, including live PR-checkout worktrees. */
-    all: boolean;
-    /** Print what would be removed without touching the filesystem. */
-    dryRun: boolean;
-    json: boolean;
-}
-export declare function listWorktrees(options: ListWorktreesOptions): Promise<void>;
-export declare function clearWorktrees(options: ClearWorktreesOptions): Promise<void>;
-export {};