@sayknow-cli/coding-agent 0.3.4 → 0.3.6

package/dist/types/capability/rule.d.ts

@@ -1,61 +0,0 @@
-import type { SourceMeta } from "./types";
-/**
- * Parsed frontmatter from rule files.
- */
-export interface RuleFrontmatter {
-    description?: string;
-    globs?: string[];
-    alwaysApply?: boolean;
-    /** New key for TTSR match conditions. */
-    condition?: string | string[];
-    /** New key for TTSR stream scope. */
-    scope?: string | string[];
-    /** Per-rule TTSR interrupt mode override. */
-    interruptMode?: "never" | "prose-only" | "tool-only" | "always";
-    [key: string]: unknown;
-}
-/**
- * A rule providing project-specific guidance and constraints.
- */
-export interface Rule {
-    /** Rule name (derived from filename) */
-    name: string;
-    /** Absolute path to rule file */
-    path: string;
-    /** Rule content (after frontmatter stripped) */
-    content: string;
-    /** Globs this rule applies to (if any) */
-    globs?: string[];
-    /** Whether to always include this rule */
-    alwaysApply?: boolean;
-    /** Description (for agent-requested rules) */
-    description?: string;
-    /** Regex condition(s) that can trigger TTSR interruption. */
-    condition?: string[];
-    /** Optional stream scope tokens (for example: text, thinking, tool:edit(*.ts)). */
-    scope?: string[];
-    /** Per-rule TTSR interrupt mode override (falls back to global ttsr.interruptMode). */
-    interruptMode?: "never" | "prose-only" | "tool-only" | "always";
-    /** Source metadata */
-    _source: SourceMeta;
-}
-/**
- * Parse `condition` + `scope` from rule frontmatter.
- *
- * - `condition` accepts string or string[]
- * - `scope` accepts string or string[]
- * - legacy `ttsr_trigger` / `ttsrTrigger` are accepted as a `condition` fallback
- * - condition tokens that look like file globs become scope shorthands:
- *   `*.rs` => `tool:edit(*.rs)`, `tool:write(*.rs)` and a catch-all condition `.*`
- */
-export declare function parseRuleConditionAndScope(frontmatter: RuleFrontmatter): Pick<Rule, "condition" | "scope">;
-/**
- * Process-global snapshot of rules the active session loaded.
- * Read by internal URL protocol handlers (rule://).
- */
-export declare function getActiveRules(): readonly Rule[];
-/** Replace the active rule snapshot. Called once per top-level session. */
-export declare function setActiveRules(value: readonly Rule[]): void;
-/** Reset the active rule snapshot. Test-only. */
-export declare function resetActiveRulesForTests(): void;
-export declare const ruleCapability: import("./types").Capability<Rule>;

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

@@ -1,15 +0,0 @@
-import type { SourceMeta } from "./types";
-/**
- * A settings file.
- */
-export interface Settings {
-    /** Absolute path to settings file */
-    path: string;
-    /** Parsed settings data */
-    data: Record<string, unknown>;
-    /** Source level */
-    level: "user" | "project";
-    /** Source metadata */
-    _source: SourceMeta;
-}
-export declare const settingsCapability: import("./types").Capability<Settings>;

package/dist/types/capability/skill.d.ts

@@ -1,36 +0,0 @@
-import type { SourceMeta } from "./types";
-/**
- * Parsed frontmatter from a skill file.
- */
-export interface SkillFrontmatter {
-    name?: string;
-    description?: string;
-    globs?: string[];
-    alwaysApply?: boolean;
-    /**
-     * When `true`, the skill is loaded and accessible via `skill://<name>` (and
-     * `/skill:<name>` slash commands), but is omitted from the rendered system
-     * prompt's skill listing. Use for skills the user opts into explicitly
-     * rather than ones the model should auto-discover.
-     */
-    hide?: boolean;
-    [key: string]: unknown;
-}
-/**
- * A skill that provides specialized knowledge or workflows.
- */
-export interface Skill {
-    /** Skill name (unique key, derived from filename or frontmatter) */
-    name: string;
-    /** Absolute path to skill file */
-    path: string;
-    /** Skill content (markdown) */
-    content: string;
-    /** Parsed frontmatter */
-    frontmatter?: SkillFrontmatter;
-    /** Source level */
-    level: "user" | "project";
-    /** Source metadata */
-    _source: SourceMeta;
-}
-export declare const skillCapability: import("./types").Capability<Skill>;

package/dist/types/capability/slash-command.d.ts

@@ -1,17 +0,0 @@
-import type { SourceMeta } from "./types";
-/**
- * A file-based slash command.
- */
-export interface SlashCommand {
-    /** Command name (without leading slash) */
-    name: string;
-    /** Absolute path to command file */
-    path: string;
-    /** Command content (markdown template) */
-    content: string;
-    /** Source level */
-    level: "user" | "project" | "native";
-    /** Source metadata */
-    _source: SourceMeta;
-}
-export declare const slashCommandCapability: import("./types").Capability<SlashCommand>;

package/dist/types/capability/ssh.d.ts

@@ -1,23 +0,0 @@
-import type { SourceMeta } from "./types";
-/**
- * Canonical SSH host entry.
- */
-export interface SSHHost {
-    /** Host name (config key) */
-    name: string;
-    /** Host address or DNS name */
-    host: string;
-    /** Optional username override */
-    username?: string;
-    /** Optional port override */
-    port?: number;
-    /** Optional identity key path */
-    keyPath?: string;
-    /** Optional host description */
-    description?: string;
-    /** Optional compatibility mode flag */
-    compat?: boolean;
-    /** Source metadata (added by loader) */
-    _source: SourceMeta;
-}
-export declare const sshCapability: import("./types").Capability<SSHHost>;

package/dist/types/capability/system-prompt.d.ts

@@ -1,15 +0,0 @@
-import type { SourceMeta } from "./types";
-/**
- * A system prompt customization file.
- */
-export interface SystemPrompt {
-    /** Absolute path to the file */
-    path: string;
-    /** File content */
-    content: string;
-    /** Which level this came from */
-    level: "user" | "project";
-    /** Source metadata */
-    _source: SourceMeta;
-}
-export declare const systemPromptCapability: import("./types").Capability<SystemPrompt>;

package/dist/types/capability/tool.d.ts

@@ -1,19 +0,0 @@
-import type { SourceMeta } from "./types";
-/**
- * A custom tool definition.
- */
-export interface CustomTool {
-    /** Tool name (unique key) */
-    name: string;
-    /** Absolute path to tool definition file */
-    path: string;
-    /** Tool description */
-    description: string;
-    /** Tool implementation (script path or inline) */
-    implementation?: string;
-    /** Source level */
-    level: "user" | "project";
-    /** Source metadata */
-    _source: SourceMeta;
-}
-export declare const toolCapability: import("./types").Capability<CustomTool>;

package/dist/types/capability/types.d.ts

@@ -1,154 +0,0 @@
-/**
- * Core types for the capability-based config discovery system.
- *
- * This architecture inverts control: instead of callers knowing provider-specific
- * paths like `.skc`, `.gemini`, or `.vscode`, they simply ask for `load("mcps")`
- * and get back a unified array of MCP servers.
- */
-/**
- * Context passed to every provider loader.
- */
-export interface LoadContext {
-    /** Current working directory (project root) */
-    cwd: string;
-    /** User home directory */
-    home: string;
-    /** Git repository root (directory containing .git), or null if not in a repo */
-    repoRoot: string | null;
-}
-/**
- * Result from a provider's load function.
- */
-export interface LoadResult<T> {
-    items: T[];
-    /** Warnings encountered during loading (parse errors, etc.) */
-    warnings?: string[];
-}
-/**
- * A provider that can load items for a capability.
- */
-export interface Provider<T> {
-    /** Unique provider ID (e.g., "Anthropic model", "skc", "mcp-json", "agents-md") */
-    id: string;
-    /** Human-readable name for UI display (e.g., "Anthropic Code", "OpenAI code provider") */
-    displayName: string;
-    /** Short description for settings UI (e.g., "Load config from .skc/") */
-    description: string;
-    /**
-     * Priority (higher = checked first, wins on conflicts).
-     * Suggested ranges:
-     *   100+ : Primary providers (skc, pi)
-     *   50-99: Tool-specific providers (Anthropic model, OpenAI code backend, gemini)
-     *   1-49 : Shared standards (mcp-json, agents-md)
-     */
-    priority: number;
-    /**
-     * Load items for this capability.
-     * Returns items in provider's preferred order (usually project before user).
-     */
-    load(ctx: LoadContext): Promise<LoadResult<T>>;
-}
-/**
- * Options for loading a capability.
- */
-export interface LoadOptions {
-    /** Only use these providers (by ID). Default: all registered */
-    providers?: string[];
-    /** Exclude these providers (by ID). Default: none */
-    excludeProviders?: string[];
-    /** Custom cwd. Default: getProjectDir() */
-    cwd?: string;
-    /** Include items even if they fail validation. Default: false */
-    includeInvalid?: boolean;
-    /** Include items disabled via settings. Default: false */
-    includeDisabled?: boolean;
-    /** Explicit disabled extension IDs to apply instead of settings. */
-    disabledExtensions?: string[];
-}
-/**
- * Source metadata attached to every loaded item.
- */
-export interface SourceMeta {
-    /** Provider ID that loaded this item */
-    provider: string;
-    /** Provider display name (for UI) */
-    providerName: string;
-    /** Absolute path to the source file */
-    path: string;
-    /** Whether this came from user-level, project-level, or native config */
-    level: "user" | "project" | "native";
-}
-/**
- * Merged result from loading a capability across all providers.
- */
-export interface CapabilityResult<T> {
-    /** Deduplicated items in priority order */
-    items: Array<T & {
-        _source: SourceMeta;
-    }>;
-    /** All items including shadowed duplicates (for diagnostics) */
-    all: Array<T & {
-        _source: SourceMeta;
-        _shadowed?: boolean;
-    }>;
-    /** Warnings from all providers */
-    warnings: string[];
-    /** Which providers contributed items (IDs) */
-    providers: string[];
-}
-/**
- * Definition of a capability.
- */
-export interface Capability<T> {
-    /** Capability ID (e.g., "mcps", "skills", "context-files") */
-    id: string;
-    /** Human-readable name for UI display (e.g., "MCP Servers", "Skills") */
-    displayName: string;
-    /** Short description for settings/status UI */
-    description: string;
-    /**
-     * Extract a unique key from an item for deduplication.
-     * Items with the same key: first one wins (highest priority provider).
-     * Return undefined to never deduplicate (all items kept).
-     */
-    key(item: T): string | undefined;
-    /**
-     * Optional validation. Return error message if invalid, undefined if valid.
-     */
-    validate?(item: T): string | undefined;
-    /**
-     * Optional disabledExtensions ID for this item.
-     * When present, loadCapability() can hide items disabled via settings.
-     */
-    toExtensionId?(item: T): string | undefined;
-    /** Registered providers, sorted by priority (highest first) */
-    providers: Provider<T>[];
-}
-/**
- * Metadata about a capability (for introspection/UI).
- */
-export interface CapabilityInfo {
-    id: string;
-    displayName: string;
-    description: string;
-    providers: Array<{
-        id: string;
-        displayName: string;
-        description: string;
-        priority: number;
-        enabled: boolean;
-    }>;
-}
-/**
- * Metadata about a provider (for introspection/UI).
- */
-export interface ProviderInfo {
-    id: string;
-    displayName: string;
-    description: string;
-    priority: number;
-    /** Which capabilities this provider is registered for */
-    capabilities: string[];
-    /** Whether this provider is currently enabled */
-    enabled: boolean;
-}

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

@@ -1,12 +0,0 @@
-export type AgentsAction = "unpack";
-export interface AgentsCommandArgs {
-    action: AgentsAction;
-    flags: {
-        force?: boolean;
-        json?: boolean;
-        dir?: string;
-        user?: boolean;
-        project?: boolean;
-    };
-}
-export declare function runAgentsCommand(cmd: AgentsCommandArgs): Promise<void>;

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

@@ -1,56 +0,0 @@
-/**
- * CLI argument parsing and help display
- */
-import { type Effort } from "@sayknow-cli/ai";
-export type Mode = "text" | "json" | "rpc" | "acp" | "rpc-ui" | "bridge";
-export interface Args {
-    cwd?: string;
-    allowHome?: boolean;
-    provider?: string;
-    model?: string;
-    smol?: string;
-    slow?: string;
-    plan?: string;
-    mpreset?: string;
-    default?: boolean;
-    apiKey?: string;
-    systemPrompt?: string;
-    appendSystemPrompt?: string;
-    thinking?: Effort;
-    continue?: boolean;
-    resume?: string | true;
-    help?: boolean;
-    version?: boolean;
-    mode?: Mode;
-    noSession?: boolean;
-    sessionDir?: string;
-    rpcListen?: string;
-    providerSessionId?: string;
-    fork?: string;
-    models?: string[];
-    tools?: string[];
-    noTools?: boolean;
-    noLsp?: boolean;
-    noPty?: boolean;
-    tmux?: boolean;
-    /** Retained for runtime/test compatibility; extension loading flags are no longer parsed. */
-    hooks?: string[];
-    extensions?: string[];
-    noExtensions?: boolean;
-    pluginDirs?: string[];
-    print?: boolean;
-    export?: string;
-    /** Retained for runtime/test compatibility; arbitrary skill discovery is always disabled. */
-    noSkills?: boolean;
-    skills?: string[];
-    noRules?: boolean;
-    listModels?: string | true;
-    noTitle?: boolean;
-    messages: string[];
-    fileArgs: string[];
-    /** Retained for test/runtime compatibility; extension-defined flags are no longer parsed. */
-    unknownFlags: Map<string, boolean | string>;
-}
-export declare function parseArgs(args: string[]): Args;
-export declare function getExtraHelpText(): string;
-export declare function printHelp(): void;

package/dist/types/cli/auth-broker-cli.d.ts

@@ -1,25 +0,0 @@
-export type AuthBrokerAction = "serve" | "token" | "login" | "logout" | "status" | "import" | "migrate";
-export interface AuthBrokerCommandArgs {
-    action: AuthBrokerAction;
-    flags: {
-        json?: boolean;
-        bind?: string;
-        regenerate?: boolean;
-        via?: string;
-        provider?: string;
-        dryRun?: boolean;
-        /** `login`/`logout`: provider id. `import`: filesystem path. */
-        source?: string;
-        /** `import`: keep credentials whose JSON had `disabled: true`. */
-        includeDisabled?: boolean;
-        /** `migrate`: also upload local OAuth (default: api_key only, since OAuth is via cliproxy import). */
-        includeOauth?: boolean;
-        /** `migrate`: also capture env-var API keys for providers not yet on broker. */
-        includeEnv?: boolean;
-        /** `migrate`: required `--from-local` source. Reserved for future sources. */
-        fromLocal?: boolean;
-    };
-}
-declare const ACTIONS: readonly AuthBrokerAction[];
-export declare function runAuthBrokerCommand(cmd: AuthBrokerCommandArgs): Promise<void>;
-export { ACTIONS as AUTH_BROKER_ACTIONS };

package/dist/types/cli/auth-gateway-cli.d.ts

@@ -1,18 +0,0 @@
-export type AuthGatewayAction = "serve" | "token" | "status" | "check";
-export interface AuthGatewayCommandArgs {
-    action: AuthGatewayAction;
-    flags: {
-        json?: boolean;
-        bind?: string;
-        regenerate?: boolean;
-        /**
-         * Disable bearer-token auth on inbound requests. Useful when the gateway
-         * is bound to loopback (the default `127.0.0.1:4000`) and you don't want
-         * to wire token-paste plumbing into every local client.
-         */
-        noAuth?: boolean;
-    };
-}
-declare const ACTIONS: readonly AuthGatewayAction[];
-export declare function runAuthGatewayCommand(cmd: AuthGatewayCommandArgs): Promise<void>;
-export { ACTIONS as AUTH_GATEWAY_ACTIONS };

package/dist/types/cli/classify-install-target.d.ts

@@ -1,18 +0,0 @@
-/**
- * Classify an install spec as a marketplace plugin reference or a plain npm package.
- *
- * Rules (applied in order):
- *  1. Starts with `@` (scoped npm) -> always npm.
- *  2. Contains `@` after the first character -> split on the LAST `@`.
- *     If the right-hand side is a known marketplace name, it's a marketplace ref.
- *     Otherwise it's an npm spec (e.g. `pkg@1.2.3`).
- *  3. No `@` -> npm.
- */
-export declare function classifyInstallTarget(spec: string, knownMarketplaces: Set<string>): {
-    type: "marketplace";
-    name: string;
-    marketplace: string;
-} | {
-    type: "npm";
-    spec: string;
-};

package/dist/types/cli/commands/init-xdg.d.ts

@@ -1 +0,0 @@
-export declare function initXdg(): Promise<void>;

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

@@ -1,22 +0,0 @@
-/**
- * Config CLI command handlers.
- *
- * Handles `skc config <command>` subcommands for managing settings.
- * Uses the settings schema as the source of truth for available settings.
- */
-export type ConfigAction = "list" | "get" | "set" | "reset" | "path" | "init-xdg";
-export interface ConfigCommandArgs {
-    action: ConfigAction;
-    key?: string;
-    value?: string;
-    flags: {
-        json?: boolean;
-    };
-}
-/**
- * Parse config subcommand arguments.
- * Returns undefined if not a config command.
- */
-export declare function parseConfigArgs(args: string[]): ConfigCommandArgs | undefined;
-export declare function runConfigCommand(cmd: ConfigCommandArgs): Promise<void>;
-export declare function printConfigHelp(): void;

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

@@ -1,25 +0,0 @@
-/**
- * `skc daemon` command handler.
- *
- * Generic over the static built-in daemon controller map: lists/inspects
- * daemons and drives cooperative stop/reload. Telegram is the only kind today.
- */
-import { Settings } from "../config/settings";
-import type { BuiltInDaemonController, DaemonKind } from "../daemon/control-types";
-export type DaemonCliAction = "list" | "status" | "stop" | "reload";
-export interface DaemonCommandArgs {
-    action: DaemonCliAction;
-    kinds: DaemonKind[];
-    all: boolean;
-    json: boolean;
-    force: boolean;
-    gracefulTimeoutMs?: number;
-    killTimeoutMs?: number;
-    spawnIfStopped?: boolean;
-}
-export interface DaemonCommandDeps {
-    settings?: Settings;
-    controllers?: BuiltInDaemonController[];
-}
-export declare function parseDaemonArgs(argv: string[]): DaemonCommandArgs | undefined;
-export declare function runDaemonCommand(cmd: DaemonCommandArgs, deps?: DaemonCommandDeps): Promise<void>;

package/dist/types/cli/fast-help.d.ts

@@ -1 +0,0 @@
-export declare function getExtraHelpText(): string;

package/dist/types/cli/file-processor.d.ts

@@ -1,11 +0,0 @@
-import type { ImageContent } from "@sayknow-cli/ai";
-export interface ProcessedFiles {
-    text: string;
-    images: ImageContent[];
-}
-export interface ProcessFileOptions {
-    /** Whether to auto-resize images to 2000x2000 max. Default: true */
-    autoResizeImages?: boolean;
-}
-/** Process @file arguments into text content and image attachments */
-export declare function processFileArguments(fileArgs: string[], options?: ProcessFileOptions): Promise<ProcessedFiles>;

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

@@ -1,17 +0,0 @@
-import { GrepOutputMode } from "@sayknow-cli/natives";
-export interface GrepCommandArgs {
-    pattern: string;
-    path: string;
-    glob?: string;
-    limit: number;
-    context: number;
-    mode: GrepOutputMode;
-    gitignore: boolean;
-}
-/**
- * Parse grep subcommand arguments.
- * Returns undefined if not a grep command.
- */
-export declare function parseGrepArgs(args: string[]): GrepCommandArgs | undefined;
-export declare function runGrepCommand(cmd: GrepCommandArgs): Promise<void>;
-export declare function printGrepHelp(): void;

package/dist/types/cli/initial-message.d.ts

@@ -1,17 +0,0 @@
-import type { ImageContent } from "@sayknow-cli/ai";
-import type { Args } from "./args";
-export interface InitialMessageInput {
-    parsed: Args;
-    fileText?: string;
-    fileImages?: ImageContent[];
-    stdinContent?: string;
-}
-export interface InitialMessageResult {
-    initialMessage?: string;
-    initialImages?: ImageContent[];
-}
-/**
- * Combine stdin content, @file text, and the first CLI message into a single
- * initial prompt for non-interactive mode.
- */
-export declare function buildInitialMessage({ parsed, fileText, fileImages, stdinContent }: InitialMessageInput): InitialMessageResult;

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/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>;