@sayknow-cli/coding-agent 0.3.11 → 0.3.13

package/dist/types/debug/log-viewer.d.ts

@@ -1,68 +0,0 @@
-import { type Component } from "@sayknow-cli/tui";
-import type { DebugLogSource } from "./report-bundle";
-export declare const SESSION_BOUNDARY_WARNING = "### WARNING - Logs above are older than current session!";
-export declare const LOAD_OLDER_LABEL = "### MOVE UP TO LOAD MORE...";
-type DebugLogViewerModelOptions = {
-    processStartMs?: number;
-    processPid?: number;
-    hasOlderLogs?: () => boolean;
-    loadOlderLogs?: (limitDays?: number) => Promise<string>;
-};
-type ViewerRow = {
-    kind: "warning";
-} | {
-    kind: "load-older";
-} | {
-    kind: "log";
-    logIndex: number;
-};
-export declare function splitLogText(logText: string): string[];
-export declare function buildLogCopyPayload(lines: string[]): string;
-export declare class DebugLogViewerModel {
-    #private;
-    constructor(logText: string, options?: DebugLogViewerModelOptions);
-    get logCount(): number;
-    get visibleLogCount(): number;
-    get rows(): readonly ViewerRow[];
-    get cursorRowIndex(): number | undefined;
-    get cursorLogIndex(): number | undefined;
-    get filterQuery(): string;
-    get cursorRowKind(): ViewerRow["kind"] | undefined;
-    get expandedCount(): number;
-    isProcessFilterEnabled(): boolean;
-    isCursorAtFirstSelectableRow(): boolean;
-    getRawLine(logIndex: number): string;
-    setFilterQuery(query: string): void;
-    toggleProcessFilter(): void;
-    moveCursor(delta: number, extendSelection: boolean): void;
-    getSelectedLogIndices(): number[];
-    getSelectedCount(): number;
-    isSelected(logIndex: number): boolean;
-    isExpanded(logIndex: number): boolean;
-    expandSelected(): void;
-    collapseSelected(): void;
-    getSelectedRawLines(): string[];
-    selectAllVisible(): void;
-    canLoadOlder(): boolean;
-    loadOlder(additionalCount?: number): Promise<boolean>;
-    prependLogs(logText: string): number;
-}
-interface DebugLogViewerComponentOptions {
-    logs: string;
-    terminalRows: number;
-    onExit: () => void;
-    onStatus?: (message: string) => void;
-    onError?: (message: string) => void;
-    processStartMs?: number;
-    processPid?: number;
-    logSource?: DebugLogSource;
-    onUpdate?: () => void;
-}
-export declare class DebugLogViewerComponent implements Component {
-    #private;
-    constructor(options: DebugLogViewerComponentOptions);
-    handleInput(keyData: string): void;
-    invalidate(): void;
-    render(width: number): string[];
-}
-export {};

package/dist/types/debug/profiler.d.ts

@@ -1,24 +0,0 @@
-/**
- * CPU and heap profiling wrappers for debug reports.
- */
-export interface CpuProfile {
-    data: string;
-    markdown: string;
-}
-export interface ProfilerSession {
-    /** Stop profiling and return the profile data */
-    stop(): Promise<CpuProfile>;
-}
-/**
- * Start CPU profiling.
- * Returns a session that can be stopped to get the profile data.
- */
-export declare function startCpuProfile(): Promise<ProfilerSession>;
-export interface HeapSnapshot {
-    data: string;
-}
-/**
- * Generate a heap snapshot.
- * Uses Bun's built-in generateHeapSnapshot.
- */
-export declare function generateHeapSnapshotData(): HeapSnapshot;

package/dist/types/debug/raw-sse-buffer.d.ts

@@ -1,44 +0,0 @@
-import type { Model, ProviderResponseMetadata, RawSseEvent } from "@sayknow-cli/ai";
-export type RawSseDebugRecord = {
-    kind: "response";
-    sequence: number;
-    timestamp: number;
-    provider?: string;
-    model?: string;
-    api?: string;
-    status: number;
-    requestId?: string | null;
-    transport?: string;
-} | {
-    kind: "event";
-    sequence: number;
-    timestamp: number;
-    provider?: string;
-    model?: string;
-    api?: string;
-    event: string | null;
-    raw: string[];
-    truncated: boolean;
-    originalChars: number;
-};
-export interface RawSseDebugSnapshot {
-    records: readonly RawSseDebugRecord[];
-    droppedRecords: number;
-    droppedChars: number;
-    totalEvents: number;
-    lastUpdatedAt?: number;
-}
-export declare function formatRawSseIsoTime(timestamp: number): string;
-export declare function formatRawSseResponseComment(record: Extract<RawSseDebugRecord, {
-    kind: "response";
-}>): string;
-export declare function rawSseRecordLines(record: RawSseDebugRecord): string[];
-export declare class RawSseDebugBuffer {
-    #private;
-    subscribe(listener: () => void): () => void;
-    recordResponse(response: ProviderResponseMetadata, model?: Model): void;
-    recordEvent(event: RawSseEvent, model?: Model): void;
-    snapshot(): RawSseDebugSnapshot;
-    toRawText(): string;
-}
-export declare function resolveRawSseDebugBuffer(owner?: object): RawSseDebugBuffer;

package/dist/types/debug/raw-sse.d.ts

@@ -1,16 +0,0 @@
-import { type Component } from "@sayknow-cli/tui";
-import { type RawSseDebugBuffer } from "./raw-sse-buffer";
-export interface RawSseViewerOptions {
-    buffer: RawSseDebugBuffer;
-    terminalRows: number;
-    onExit: () => void;
-    onStatus?: (message: string) => void;
-    onUpdate?: () => void;
-}
-export declare class RawSseViewerComponent implements Component {
-    #private;
-    constructor(options: RawSseViewerOptions);
-    handleInput(keyData: string): void;
-    invalidate(): void;
-    render(width: number): string[];
-}

package/dist/types/debug/report-bundle.d.ts

@@ -1,55 +0,0 @@
-import type { WorkProfile } from "@sayknow-cli/natives";
-import type { CpuProfile, HeapSnapshot } from "./profiler";
-export interface ReportBundleOptions {
-    /** Session file path */
-    sessionFile: string | undefined;
-    /** Settings to include */
-    settings?: Record<string, unknown>;
-    /** CPU profile (for performance reports) */
-    cpuProfile?: CpuProfile;
-    /** Heap snapshot (for memory reports) */
-    heapSnapshot?: HeapSnapshot;
-    /** Work profile (for work scheduling reports) */
-    workProfile?: WorkProfile;
-}
-export interface ReportBundleResult {
-    path: string;
-    files: string[];
-}
-export interface DebugLogSource {
-    getInitialText(): Promise<string>;
-    hasOlderLogs(): boolean;
-    loadOlderLogs(limitDays?: number): Promise<string>;
-}
-/**
- * Create a debug report bundle.
- *
- * Bundle contents:
- * - session.jsonl: Current session transcript
- * - artifacts/: Session artifacts directory
- * - subagents/: Subagent sessions + artifacts
- * - logs.txt: Recent log entries
- * - system.json: OS, arch, CPU, memory, versions
- * - env.json: Sanitized environment variables
- * - config.json: Resolved settings
- * - profile.cpuprofile: CPU profile (performance report only)
- * - profile.md: Markdown CPU profile (performance report only)
- * - heap.heapsnapshot: Heap snapshot (memory report only)
- * - work.folded: Work profile folded stacks (work report only)
- * - work.md: Work profile summary (work report only)
- * - work.svg: Work profile flamegraph (work report only)
- */
-export declare function createReportBundle(options: ReportBundleOptions): Promise<ReportBundleResult>;
-/** Get recent log entries for display (tail-limited to avoid OOM on large files). */
-export declare function getLogText(): Promise<string>;
-export declare function createDebugLogSource(): Promise<DebugLogSource>;
-/** Calculate total size of artifact cache */
-export declare function getArtifactCacheStats(sessionsDir: string): Promise<{
-    count: number;
-    totalSize: number;
-    oldestDate: Date | null;
-}>;
-/** Clear artifact cache older than N days */
-export declare function clearArtifactCache(sessionsDir: string, daysOld?: number): Promise<{
-    removed: number;
-}>;

package/dist/types/debug/runtime-gauges.d.ts

@@ -1,6 +0,0 @@
-/**
- * Current runtime owner counts, keyed by `<owner>.<resource>`. Extend as more
- * owners (Python kernels, LSP clients, browser tabs, async jobs, streaming
- * queues) expose count getters.
- */
-export declare function getRuntimeResourceCounts(): Record<string, number>;

package/dist/types/debug/system-info.d.ts

@@ -1,26 +0,0 @@
-/**
- * System information collection for debug reports.
- */
-export interface SystemInfo {
-    os: string;
-    arch: string;
-    cpu: string;
-    memory: {
-        total: number;
-        free: number;
-    };
-    versions: {
-        app: string;
-        bun: string;
-        node: string;
-    };
-    cwd: string;
-    shell: string;
-    terminal: string | undefined;
-}
-/** Collect system information */
-export declare function collectSystemInfo(): Promise<SystemInfo>;
-/** Format system info for display */
-export declare function formatSystemInfo(info: SystemInfo): string;
-/** Sanitize environment variables by redacting sensitive values */
-export declare function sanitizeEnv(env: Record<string, string | undefined>): Record<string, string>;

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

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

package/dist/types/deep-interview/render-middleware.d.ts

@@ -1,6 +0,0 @@
-import { type Component } from "@sayknow-cli/tui";
-import { type Theme } from "../modes/theme/theme";
-export declare function renderDeepInterviewAssistantText(text: string, uiTheme: Theme): Component | null;
-export declare function renderDeepInterviewAskQuestion(question: string, uiTheme: Theme): Component | null;
-export declare function isDeepInterviewAskQuestion(question: string): boolean;
-export declare function formatDeepInterviewSelectorPrompt(question: string): string | null;

package/dist/types/defaults/skc/extensions/grok-build/index.d.ts

@@ -1 +0,0 @@
-export { default } from "../grok-cli-vendor/src/index.js";

package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/index.d.ts

@@ -1 +0,0 @@
-export { default } from './provider/register.js';

package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/models/catalog.d.ts

@@ -1,25 +0,0 @@
-/**
- * Model definitions for Grok CLI's API.
- */
-export interface GrokCliModelConfig {
-    id: string;
-    name: string;
-    reasoning: boolean;
-    input: ('text' | 'image')[];
-    cost: {
-        input: number;
-        output: number;
-        cacheRead: number;
-        cacheWrite: number;
-    };
-    contextWindow: number;
-    maxTokens: number;
-    /** Models that don't support reasoning.effort get a thinkingLevelMap. */
-    thinkingLevelMap?: Record<string, string | null>;
-}
-export declare function supportsReasoningEffort(modelId: string): boolean;
-/**
- * Resolve the active model list. If `SKC_GROK_CLI_MODELS` is set,
- * it filters/reorders the fallback list; unknown IDs get sensible defaults.
- */
-export declare function resolveModels(): GrokCliModelConfig[];

package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/payload/sanitize.d.ts

@@ -1,27 +0,0 @@
-/**
- * Payload sanitization for xAI's Responses API via cli-chat-proxy.grok.com.
- *
- * xAI's endpoint has quirks compared to stock OpenAI:
- *   - Replayed or encrypted `reasoning` items in input cause 400 errors.
- *   - `reasoning.effort` is only supported on a subset of models.
- *   - Empty-string content items cause validation failures.
- *   - `function_call_output.output` cannot contain image arrays.
- *   - `image_url` parts must be normalized to `input_image` with data URIs.
- *   - Local image paths must be resolved to base64 data URIs.
- *   - xAI rejects `role: "developer"` and `role: "system"` in the input
- *     array; these must be moved to top-level `instructions`.
- *   - xAI uses `text.format` instead of OpenAI's `response_format`.
- *   - xAI uses `prompt_cache_key` for conversation caching.
- *   - xAI doesn't support `prompt_cache_retention`.
- *
- * Additional Grok CLI-specific behavior:
- *   - Adds x-grok-* headers for client identification
- *   - Uses prompt_cache_key for session affinity
- */
-/**
- * Sanitize a provider request payload for xAI's Responses API via
- * cli-chat-proxy.grok.com.
- *
- * Returns the modified payload.  Mutates the input in place for efficiency.
- */
-export declare function sanitizePayload(params: Record<string, unknown>, modelId: string, sessionId: string | undefined, cwd: string): Record<string, unknown>;

package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/provider/billing.d.ts

@@ -1,8 +0,0 @@
-interface BillingUsage {
-    monthlyLimit: number;
-    used: number;
-    billingPeriodEnd: string;
-}
-export declare function fetchBillingUsage(token: string): Promise<BillingUsage>;
-export declare function formatQuota(usage: BillingUsage | undefined): string[];
-export {};

package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/provider/register.d.ts

@@ -1,5 +0,0 @@
-/**
- * SKC Grok Build provider — SuperGrok OAuth + cli-chat-proxy models.
- */
-import type { ExtensionAPI } from '@sayknow-cli/coding-agent';
-export default function registerGrokCli(api: ExtensionAPI): void;

package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/provider/stream.d.ts

@@ -1,10 +0,0 @@
-import type { Api, AssistantMessageEventStream, Context, Model, SimpleStreamOptions } from '@sayknow-cli/ai';
-/**
- * Stream function that adds Grok CLI-specific headers to requests.
- *
- * SKC Grok Build extension sends cli-chat-proxy headers (see agent.models.grok-cli.yml):
- *   - x-grok-conv-id: <session/conversation ID>
- *   - x-grok-model-override: <model ID>
- *   - x-xai-token-auth: xai-grok-cli
- */
-export declare function streamGrokCli(model: Model<Api>, context: Context, options?: SimpleStreamOptions): AssistantMessageEventStream;

package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/provider/usage.d.ts

@@ -1,2 +0,0 @@
-import type { ExtensionAPI } from '@sayknow-cli/coding-agent';
-export declare function registerUsageCommand(api: Pick<ExtensionAPI, 'registerCommand'>): void;

package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/shared/base-url.d.ts

@@ -1,2 +0,0 @@
-export declare function getBaseUrl(): string;
-export declare function isGrokBuildBaseUrlOverrideIgnored(): boolean;

package/dist/types/defaults/skc/extensions/grok-cli-vendor/src/shared/errors.d.ts

@@ -1,38 +0,0 @@
-/**
- * Typed error for xAI OAuth failures.
- *
- * Codes allow the login flow and stream handlers to distinguish
- * retryable failures (network) from fatal ones (revoked refresh token).
- */
-export declare class XaiOAuthError extends Error {
-    readonly code: string;
-    readonly reloginRequired: boolean;
-    constructor(message: string, code: string, reloginRequired?: boolean);
-}
-/** Well-known error codes. */
-export declare const XaiErrorCode: {
-    /** OIDC discovery failed (network, invalid response). */
-    readonly DISCOVERY_FAILED: 'discovery_failed';
-    /** Discovery endpoint returned a non-xAI origin. */
-    readonly DISCOVERY_INVALID_ORIGIN: 'discovery_invalid_origin';
-    /** Authorization was denied or errored in the browser. */
-    readonly AUTHORIZATION_FAILED: 'authorization_failed';
-    /** CSRF state mismatch between request and callback. */
-    readonly STATE_MISMATCH: 'state_mismatch';
-    /** Callback did not include an authorization code. */
-    readonly CODE_MISSING: 'code_missing';
-    /** Token exchange failed (network, invalid response). */
-    readonly TOKEN_EXCHANGE_FAILED: 'token_exchange_failed';
-    /** Token exchange returned an invalid payload. */
-    readonly TOKEN_EXCHANGE_INVALID: 'token_exchange_invalid';
-    /** Refresh token is missing or empty. */
-    readonly REFRESH_MISSING: 'refresh_missing';
-    /** Token refresh failed (expired, revoked). */
-    readonly REFRESH_FAILED: 'refresh_failed';
-    /** No credentials stored. */
-    readonly AUTH_MISSING: 'auth_missing';
-    /** Loopback callback server could not bind. */
-    readonly CALLBACK_BIND_FAILED: 'callback_bind_failed';
-    /** Loopback callback timed out. */
-    readonly CALLBACK_TIMEOUT: 'callback_timeout';
-};

package/dist/types/defaults/skc-defaults.d.ts

@@ -1,64 +0,0 @@
-export declare const DEFAULT_SKC_DEFINITION_NAMES: readonly ["deep-interview", "ralplan", "team", "ultragoal"];
-export type DefaultSkcDefinitionName = (typeof DEFAULT_SKC_DEFINITION_NAMES)[number];
-export type DefaultSkcDefinitionKind = "skill" | "skill-fragment";
-export type EmbeddedDefaultSkcSkill = {
-    name: DefaultSkcDefinitionName;
-    description: string;
-    filePath: string;
-    baseDir: string;
-    source: "bundled:default";
-    hide?: boolean;
-    content: string;
-};
-export type DefaultSkcInstallStatus = "different" | "matching" | "missing" | "skipped" | "written";
-export interface DefaultSkcSkillDefinition {
-    kind: "skill";
-    name: DefaultSkcDefinitionName;
-    relativePath: string;
-    content: string;
-}
-export interface DefaultSkcSkillFragmentDefinition {
-    kind: "skill-fragment";
-    parentSkillName: DefaultSkcDefinitionName;
-    relativePath: string;
-    content: string;
-}
-export type DefaultSkcDefinition = DefaultSkcSkillDefinition | DefaultSkcSkillFragmentDefinition;
-export interface InstallDefaultSkcDefinitionsOptions {
-    check?: boolean;
-    force?: boolean;
-    /**
-     * Only rewrite default definition files that already exist on disk but whose
-     * content differs from the embedded defaults. Files that are absent are left
-     * absent (status "missing"). Used by `skc update` to refresh opted-in copies
-     * without materializing new on-disk copies for users who never installed them.
-     */
-    refreshOnly?: boolean;
-    targetRoot?: string;
-}
-export type DefaultSkcDefinitionInstallFile = {
-    kind: "skill";
-    name: DefaultSkcDefinitionName;
-    path: string;
-    status: DefaultSkcInstallStatus;
-} | {
-    kind: "skill-fragment";
-    parentSkillName: DefaultSkcDefinitionName;
-    path: string;
-    status: DefaultSkcInstallStatus;
-};
-export interface DefaultSkcDefinitionInstallResult {
-    targetRoot: string;
-    total: number;
-    written: number;
-    skipped: number;
-    matching: number;
-    missing: number;
-    different: number;
-    files: DefaultSkcDefinitionInstallFile[];
-}
-export declare function getDefaultSkcDefinitions(): readonly DefaultSkcDefinition[];
-export declare function getDefaultSkcAgentDefinitions(): readonly DefaultSkcDefinition[];
-export declare function getEmbeddedDefaultSkcSkillFragments(parentSkillName: DefaultSkcDefinitionName): DefaultSkcSkillFragmentDefinition[];
-export declare function getEmbeddedDefaultSkcSkills(): EmbeddedDefaultSkcSkill[];
-export declare function installDefaultSkcDefinitions(options?: InstallDefaultSkcDefinitionsOptions): Promise<DefaultSkcDefinitionInstallResult>;

package/dist/types/defaults/skc-grok-cli.d.ts

@@ -1,5 +0,0 @@
-import type { ExtensionFactory } from "../extensibility/extensions/types";
-export declare const BUNDLED_GROK_BUILD_EXTENSION_ID = "bundled:grok-build";
-export declare function getBundledGrokBuildExtensionFactory(): ExtensionFactory;
-export declare function getBundledGrokCliModelDefaults(): string;
-export declare function assertBundledGrokCliDefaults(): Promise<void>;

package/dist/types/discovery/agents-md.d.ts

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

package/dist/types/discovery/agents.d.ts

@@ -1,12 +0,0 @@
-import type { LoadContext } from "../capability/types";
-/**
- * Project-level paths: walk up from cwd to repoRoot, returning `.agent/<segments>`
- * and `.agents/<segments>` at each ancestor.
- *
- * The user home directory is skipped: `~/.agent[s]/` is by definition
- * user-level config and is already enumerated by {@link getUserPathCandidates}.
- * Without this guard, any cwd under `$HOME` (with no closer git repoRoot) would
- * walk up to home and yield duplicate project+user entries for the same
- * directory — see https://github.com/jaybeyond/Sayknow_CLI/issues/1116.
- */
-export declare function getProjectPathCandidates(ctx: LoadContext, ...segments: string[]): string[];

package/dist/types/discovery/builtin.d.ts

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

package/dist/types/discovery/claude-plugins.d.ts

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

package/dist/types/discovery/claude.d.ts

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

package/dist/types/discovery/cline.d.ts

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

package/dist/types/discovery/codex.d.ts

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

package/dist/types/discovery/cursor.d.ts

@@ -1,19 +0,0 @@
-/**
- * Cursor Provider
- *
- * Loads configuration from Cursor's config directories.
- * Priority: 50 (tool-specific provider)
- *
- * Sources:
- * - User: ~/.cursor
- * - Project: .cursor/ (cwd only)
- *
- * Capabilities:
- * - rules: From rules/*.mdc files with MDC frontmatter (description, globs, alwaysApply)
- * - settings: From settings.json if present
- *
- * MCP servers are intentionally NOT inherited live from Cursor config: SKC owns
- * MCP runtime execution. Use `skc mcp import cursor` to copy definitions into
- * SKC's own mcp.json instead.
- */
-export {};

package/dist/types/discovery/gemini.d.ts

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

package/dist/types/discovery/github.d.ts

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