@sayknow-cli/coding-agent 0.3.16 → 0.4.1

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

@@ -1,69 +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";
-    /** Per-rule TTSR repeat mode override. */
-    repeatMode?: "once" | "after-gap";
-    /** Per-rule TTSR repeat gap override. */
-    repeatGap?: number;
-    [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";
-    /** Per-rule TTSR repeat mode override (falls back to global ttsr.repeatMode). */
-    repeatMode?: "once" | "after-gap";
-    /** Per-rule TTSR repeat gap override (falls back to global ttsr.repeatGap). */
-    repeatGap?: number;
-    /** 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,57 +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;
-    credential?: 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,8 +0,0 @@
-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/completion-cli.d.ts

@@ -1,41 +0,0 @@
-import type { CommandCtor, CommandEntry } from "@sayknow-cli/utils/cli";
-export type FigName = string | string[];
-export interface FigArg {
-    name: string;
-    description?: string;
-    isOptional?: boolean;
-    isVariadic?: boolean;
-    suggestions?: string[];
-}
-export interface FigOption {
-    name: FigName;
-    description?: string;
-    args?: FigArg;
-    isRepeatable?: boolean;
-}
-export interface FigSubcommand {
-    name: FigName;
-    description?: string;
-    options?: FigOption[];
-    args?: FigArg | FigArg[];
-}
-export interface FigSpec extends FigSubcommand {
-    name: string;
-    subcommands?: FigSubcommand[];
-}
-export type InshellisenseIndexStatus = "created" | "updated" | "already-compatible" | "overwritten";
-export interface InstallSkcInshellisenseSpecOptions {
-    dir?: string;
-    force?: boolean;
-}
-export interface InstallSkcInshellisenseSpecResult {
-    directory: string;
-    specPath: string;
-    indexPath: string;
-    indexStatus: InshellisenseIndexStatus;
-}
-export declare function defaultInshellisenseSpecDir(homeDir?: string): string;
-export declare function buildSkcFigSpec(entries: CommandEntry[], rootCommandOverride?: CommandCtor): Promise<FigSpec>;
-export declare function renderFigSpecModule(spec: FigSpec): string;
-export declare function renderInshellisenseIndexModule(): string;
-export declare function installSkcInshellisenseSpec(spec: FigSpec, options?: InstallSkcInshellisenseSpecOptions): Promise<InstallSkcInshellisenseSpecResult>;

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

@@ -1,23 +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;
-        showSecrets?: 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,27 +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;
-    /** Show runtime detail and the full roots list in human output. */
-    verbose?: 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/fixture-report.d.ts

@@ -1,20 +0,0 @@
-import type { TaskTokenLog } from "../task/types";
-export interface LiveRunReportShape {
-    schemaVersion: 1;
-    binaryId: string;
-    fixtureId: string;
-    totals: {
-        turns: number;
-        inputTokens: number;
-        outputTokens: number;
-        cacheReadTokens: number;
-        cacheWriteTokens: number;
-        totalTokens: number;
-    };
-    cacheHitRate: number | null;
-    receiptArtifactRatio: number | null;
-    spawnDecisions: number | null;
-    roi: number | null;
-}
-export declare function buildFixtureReport(fixtureId: string, logs: readonly TaskTokenLog[]): LiveRunReportShape;
-export declare function runFixtureReport(fixtureId: string): Promise<number>;

package/dist/types/cli/fixture-report.test.d.ts

@@ -1 +0,0 @@
-export {};

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;