@sayknow-cli/coding-agent 0.2.4 → 0.2.5

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

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

@@ -3,6 +3,8 @@ export interface InstalledVersionVerification {
     ok: boolean;
     actual?: string;
     path?: string;
+    smokeTestFailed?: boolean;
+    smokeTestOutput?: string;
 }
 /** Paths and verifier used while replacing a downloaded binary update. */
 export interface BinaryReplacementOptions {
@@ -24,6 +26,7 @@ export declare function resolveUpdateMethodForTest(ompPath: string, bunBinDir: s
 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.
  */

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

@@ -0,0 +1,33 @@
+/**
+ * Import MCP servers and skills from other coding agents into SKC.
+ */
+import { Command } from "@sayknow-cli/utils/cli";
+export default class Migrate extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        from: import("@sayknow-cli/utils/cli").FlagDescriptor<"string"> & {
+            description: string;
+            multiple: true;
+            required: true;
+        };
+        project: import("@sayknow-cli/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+            default: boolean;
+        };
+        force: import("@sayknow-cli/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+            default: boolean;
+        };
+        "dry-run": import("@sayknow-cli/utils/cli").FlagDescriptor<"boolean"> & {
+            description: string;
+            default: boolean;
+        };
+        json: import("@sayknow-cli/utils/cli").FlagDescriptor<"boolean"> & {
+            char: string;
+            description: string;
+            default: boolean;
+        };
+    };
+    run(): Promise<void>;
+}

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

@@ -173,6 +173,10 @@ export declare const KEYBINDINGS: {
         readonly defaultKeys: ["escape", "ctrl+c"];
         readonly description: "Cancel selection";
     };
+    readonly "tui.global.debug": {
+        readonly defaultKeys: "shift+ctrl+d";
+        readonly description: "Toggle debug overlay";
+    };
     readonly "app.interrupt": {
         readonly defaultKeys: "escape";
         readonly description: "Interrupt current operation";

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

@@ -51,6 +51,7 @@ export declare const ModelsConfigFile: ConfigFile<{
         compat?: {
             supportsStore?: boolean | undefined;
             supportsDeveloperRole?: boolean | undefined;
+            sendSessionHeaders?: boolean | undefined;
             supportsMultipleSystemMessages?: boolean | undefined;
             supportsReasoningEffort?: boolean | undefined;
             reasoningEffortMap?: {
@@ -129,6 +130,7 @@ export declare const ModelsConfigFile: ConfigFile<{
             compat?: {
                 supportsStore?: boolean | undefined;
                 supportsDeveloperRole?: boolean | undefined;
+                sendSessionHeaders?: boolean | undefined;
                 supportsMultipleSystemMessages?: boolean | undefined;
                 supportsReasoningEffort?: boolean | undefined;
                 reasoningEffortMap?: {
@@ -202,6 +204,7 @@ export declare const ModelsConfigFile: ConfigFile<{
             compat?: {
                 supportsStore?: boolean | undefined;
                 supportsDeveloperRole?: boolean | undefined;
+                sendSessionHeaders?: boolean | undefined;
                 supportsMultipleSystemMessages?: boolean | undefined;
                 supportsReasoningEffort?: boolean | undefined;
                 reasoningEffortMap?: {

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

@@ -2,6 +2,7 @@ import * as z from "zod/v4";
 export declare const OpenAICompatSchema: z.ZodObject<{
     supportsStore: z.ZodOptional<z.ZodBoolean>;
     supportsDeveloperRole: z.ZodOptional<z.ZodBoolean>;
+    sendSessionHeaders: z.ZodOptional<z.ZodBoolean>;
     supportsMultipleSystemMessages: z.ZodOptional<z.ZodBoolean>;
     supportsReasoningEffort: z.ZodOptional<z.ZodBoolean>;
     reasoningEffortMap: z.ZodOptional<z.ZodObject<{
@@ -163,6 +164,7 @@ export declare const ModelOverrideSchema: z.ZodObject<{
     compat: z.ZodOptional<z.ZodObject<{
         supportsStore: z.ZodOptional<z.ZodBoolean>;
         supportsDeveloperRole: z.ZodOptional<z.ZodBoolean>;
+        sendSessionHeaders: z.ZodOptional<z.ZodBoolean>;
         supportsMultipleSystemMessages: z.ZodOptional<z.ZodBoolean>;
         supportsReasoningEffort: z.ZodOptional<z.ZodBoolean>;
         reasoningEffortMap: z.ZodOptional<z.ZodObject<{
@@ -276,6 +278,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
         compat: z.ZodOptional<z.ZodObject<{
             supportsStore: z.ZodOptional<z.ZodBoolean>;
             supportsDeveloperRole: z.ZodOptional<z.ZodBoolean>;
+            sendSessionHeaders: z.ZodOptional<z.ZodBoolean>;
             supportsMultipleSystemMessages: z.ZodOptional<z.ZodBoolean>;
             supportsReasoningEffort: z.ZodOptional<z.ZodBoolean>;
             reasoningEffortMap: z.ZodOptional<z.ZodObject<{
@@ -442,6 +445,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
             compat: z.ZodOptional<z.ZodObject<{
                 supportsStore: z.ZodOptional<z.ZodBoolean>;
                 supportsDeveloperRole: z.ZodOptional<z.ZodBoolean>;
+                sendSessionHeaders: z.ZodOptional<z.ZodBoolean>;
                 supportsMultipleSystemMessages: z.ZodOptional<z.ZodBoolean>;
                 supportsReasoningEffort: z.ZodOptional<z.ZodBoolean>;
                 reasoningEffortMap: z.ZodOptional<z.ZodObject<{
@@ -582,6 +586,7 @@ export declare const ModelsConfigSchema: z.ZodObject<{
             compat: z.ZodOptional<z.ZodObject<{
                 supportsStore: z.ZodOptional<z.ZodBoolean>;
                 supportsDeveloperRole: z.ZodOptional<z.ZodBoolean>;
+                sendSessionHeaders: z.ZodOptional<z.ZodBoolean>;
                 supportsMultipleSystemMessages: z.ZodOptional<z.ZodBoolean>;
                 supportsReasoningEffort: z.ZodOptional<z.ZodBoolean>;
                 reasoningEffortMap: z.ZodOptional<z.ZodObject<{

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

@@ -1238,6 +1238,33 @@ export declare const SETTINGS_SCHEMA: {
             readonly description: "Skip welcome screen and startup status messages";
         };
     };
+    readonly "startup.welcomeBannerMode": {
+        readonly type: "enum";
+        readonly values: readonly ["auto", "unicode", "square", "ascii"];
+        readonly default: "auto";
+        readonly ui: {
+            readonly tab: "interaction";
+            readonly label: "Welcome Banner Mode";
+            readonly description: "Logo style for the startup welcome screen";
+            readonly options: readonly [{
+                readonly value: "auto";
+                readonly label: "Auto";
+                readonly description: "Use the rounded Unicode logo";
+            }, {
+                readonly value: "unicode";
+                readonly label: "Unicode";
+                readonly description: "Force the rounded Unicode logo";
+            }, {
+                readonly value: "square";
+                readonly label: "Square Unicode";
+                readonly description: "Force the square-corner Unicode fallback";
+            }, {
+                readonly value: "ascii";
+                readonly label: "ASCII";
+                readonly description: "Force the ASCII-safe logo";
+            }];
+        };
+    };
     readonly "startup.checkUpdate": {
         readonly type: "boolean";
         readonly default: true;

package/dist/types/harness-control-plane/storage.d.ts

@@ -29,11 +29,12 @@ export declare class StorageError extends Error {
     readonly code: string;
     constructor(message: string, code: string);
 }
-/** Resolve the harness state root from explicit value, env, or cwd default. */
+/** Resolve the harness state root from explicit value, env, or cwd/session default. */
 export declare function resolveHarnessRoot(opts?: {
     root?: string;
     cwd?: string;
     env?: NodeJS.ProcessEnv;
+    skcSessionId?: string;
 }): string;
 export declare function assertSafeSessionId(id: string): void;
 export declare function generateSessionId(prefix?: string): string;

package/dist/types/hooks/skill-state.d.ts

@@ -1,7 +1,9 @@
 import type { SkillDiscoverySettings } from "../config/skill-settings-defaults";
 import { type SkillActiveState } from "../skill-state/active-state";
+import { initialPhaseForSkill } from "../skill-state/initial-phase";
+export { initialPhaseForSkill };
 import { type SkcWorkflowSkill } from "./skill-keywords";
-export declare const SKC_STATE_DIR = ".skc/state";
+export declare const SKC_STATE_DIR = ".skc";
 export declare const SKILL_ACTIVE_STATE_FILE = "skill-active-state.json";
 export interface EffectiveSkillConfigInput {
     skillsSettings?: SkillDiscoverySettings;
@@ -55,9 +57,15 @@ export interface UserPromptSubmitStateInput {
 export declare function detectSkillKeywords(text: string): SkillKeywordMatch[];
 export declare function detectPrimarySkillKeyword(text: string): SkillKeywordMatch | null;
 export declare function resolveSkcStateDir(cwd: string, stateDir?: string): string;
-import { initialPhaseForSkill } from "../skill-state/initial-phase";
-export { initialPhaseForSkill };
-export declare function readVisibleSkillActiveState(cwd: string, sessionId?: string, stateDir?: string): Promise<SkillActiveState | null>;
+export interface StateRecoveryDiagnostic {
+    kind: "skill-active-state" | "mode-state";
+    statePath: string;
+    reason: "missing" | "corrupt" | "unreadable";
+    skill?: SkcWorkflowSkill;
+}
+export declare function buildStateRecoveryDiagnosticsContext(diagnostics: readonly StateRecoveryDiagnostic[]): string | null;
+export declare function collectUserPromptStateRecoveryDiagnostics(input: UserPromptSubmitStateInput): Promise<StateRecoveryDiagnostic[]>;
+export declare function readVisibleSkillActiveState(cwd: string, sessionId?: string, _stateDir?: string): Promise<SkillActiveState | null>;
 export declare function recordSkillActivation(input: RecordSkillActivationInput): Promise<SkillActiveState | null>;
 export interface EnsureWorkflowSkillActivationInput {
     cwd: string;

package/dist/types/lsp/startup-events.d.ts

@@ -9,3 +9,4 @@ export type LspStartupEvent = {
     type: "failed";
     error: string;
 };
+export declare function getLspStartupWarningMessage(event: LspStartupEvent): string | null;

package/dist/types/migrate/action-planner.d.ts

@@ -0,0 +1,11 @@
+import type { AdapterResult, MigrateAction, MigrateDestinations, MigrateWarning } from "./types";
+export interface PlanInput {
+    results: AdapterResult[];
+    destinations: MigrateDestinations;
+    force: boolean;
+}
+export interface PlanOutput {
+    actions: MigrateAction[];
+    warnings: MigrateWarning[];
+}
+export declare function planMigration(input: PlanInput): Promise<PlanOutput>;

package/dist/types/migrate/adapters/claude-code.d.ts

@@ -0,0 +1,2 @@
+import { type Adapter } from "./index";
+export declare const claudeCodeAdapter: Adapter;

package/dist/types/migrate/adapters/codex.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Codex adapter: reads `~/.codex/config.toml` ([mcp_servers]) and `~/.codex/prompts`.
+ */
+import { type Adapter } from "./index";
+export declare const codexAdapter: Adapter;

package/dist/types/migrate/adapters/index.d.ts

@@ -0,0 +1,45 @@
+import type { AdapterResult, MigrateSource, SkillCandidate, SourceDiagnostic } from "../types";
+export interface AdapterOptions {
+    /** Home directory root; overridable for tests. */
+    homeDir: string;
+}
+export interface Adapter {
+    source: MigrateSource;
+    collect(options: AdapterOptions): Promise<AdapterResult>;
+}
+export declare function getAdapter(source: MigrateSource): Adapter;
+/** Read a text file, classifying absence/IO errors into source diagnostics. */
+export declare function readSourceText(filePath: string, source: MigrateSource, type: SourceDiagnostic["type"]): Promise<{
+    text: string;
+} | {
+    diagnostic: SourceDiagnostic;
+}>;
+/** Parse JSON text, classifying parse errors into a `failed_invalid_source` diagnostic. */
+export declare function parseSourceJson(text: string, filePath: string, source: MigrateSource, type: SourceDiagnostic["type"]): {
+    data: Record<string, unknown>;
+} | {
+    diagnostic: SourceDiagnostic;
+};
+/**
+ * Collect skill candidates from a directory of `<name>/SKILL.md` entries.
+ * A missing directory yields a `skipped_absent_source` diagnostic.
+ */
+export declare function collectSkillDir(dir: string, source: MigrateSource): Promise<{
+    candidates: SkillCandidate[];
+    diagnostics: SourceDiagnostic[];
+}>;
+/**
+ * Collect skill candidates from a flat directory of `*.md` prompt/command files.
+ */
+export declare function collectMarkdownPrompts(dir: string, source: MigrateSource): Promise<{
+    candidates: SkillCandidate[];
+    diagnostics: SourceDiagnostic[];
+}>;
+/**
+ * Recursively collect skill candidates from any `**​/SKILL.md` under `root`.
+ * The slug derives from the directory that directly contains the `SKILL.md`.
+ */
+export declare function collectSkillTree(root: string, source: MigrateSource): Promise<{
+    candidates: SkillCandidate[];
+    diagnostics: SourceDiagnostic[];
+}>;

package/dist/types/migrate/adapters/opencode.d.ts

@@ -0,0 +1,2 @@
+import { type Adapter } from "./index";
+export declare const opencodeAdapter: Adapter;

package/dist/types/migrate/executor.d.ts

@@ -0,0 +1,2 @@
+import type { MigrateAction } from "./types";
+export declare function executeActions(actions: MigrateAction[]): Promise<MigrateAction[]>;

package/dist/types/migrate/mcp-mapper.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Map raw source MCP server entries onto SKC `MCPServerConfig`.
+ *
+ * Implements the source-schema compatibility matrix from the consensus plan:
+ * preserved (P), transformed (T), omitted-with-warning (OW), skipped (S,
+ * `skipped_unmappable`), and failed (F, `failed_invalid_source`). Secret-indirection
+ * fields are always omitted-with-warning; their values are never read or emitted.
+ */
+import type { MCPServerConfig } from "../runtime-mcp/types";
+import type { MigrateSource } from "./types";
+export type McpMapOutcome = {
+    ok: true;
+    config: MCPServerConfig;
+    warnings: string[];
+} | {
+    ok: false;
+    status: "skipped_unmappable" | "failed_invalid_source";
+    reason: string;
+};
+export declare function mapMcpEntry(source: MigrateSource, name: string, raw: unknown): McpMapOutcome;

package/dist/types/migrate/report.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Build the human-readable and `--json` reports for `skc migrate`.
+ *
+ * Secret values are never read upstream, so the report only ever contains field
+ * names in warnings — but rendering still treats action/warning text as opaque.
+ */
+import { type MigrateAction, type MigrateDestinations, type MigrateReport, type MigrateSource, type MigrateWarning } from "./types";
+export interface BuildReportInput {
+    actions: MigrateAction[];
+    warnings: MigrateWarning[];
+    sources: MigrateSource[];
+    destinations: MigrateDestinations;
+    dryRun: boolean;
+    project: boolean;
+    force: boolean;
+}
+export declare function buildReport(input: BuildReportInput): MigrateReport;
+export declare function renderHuman(report: MigrateReport): string;

package/dist/types/migrate/skill-normalizer.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Normalize a skill from another agent into a native SKC `SKILL.md`.
+ *
+ * SKC derives a skill's loaded name from its directory (`<slug>/SKILL.md`) when no
+ * frontmatter `name` is present, and requires a `description`. To guarantee the
+ * effective loaded name equals the lowercase-hyphen slug, we drop any frontmatter
+ * `name` and place the file at `<slug>/SKILL.md`, synthesizing a `description`
+ * when the source lacks one.
+ */
+export interface NormalizeSkillInput {
+    /** Raw name from the source (filename stem, frontmatter name, etc.). */
+    rawName: string;
+    /** Full source markdown (may or may not have frontmatter). */
+    content: string;
+}
+export interface NormalizedSkill {
+    slug: string;
+    content: string;
+    warnings: string[];
+}
+/** Convert an arbitrary name into a lowercase-hyphen slug. */
+export declare function slugify(name: string): string;
+/**
+ * Produce a `{ slug, content }` pair whose effective SKC-loaded name equals `slug`.
+ * Throws only on an unusable name (cannot produce a slug).
+ */
+export declare function normalizeSkill(input: NormalizeSkillInput): NormalizedSkill;

package/dist/types/migrate/types.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Shared types for `skc migrate`.
+ *
+ * Imports MCP servers and skills from other coding agents (Claude Code, Codex,
+ * OpenCode) into native SKC config. See the consensus plan under
+ * `.skc/plans/ralplan/` for the full taxonomy and force/collision semantics.
+ */
+import type { MCPServerConfig } from "../runtime-mcp/types";
+/** Supported migration sources. */
+export type MigrateSource = "claude-code" | "codex" | "opencode";
+export declare const MIGRATE_SOURCES: readonly MigrateSource[];
+/** Canonical, deterministic ordering used when expanding `--from all` / repeated `--from`. */
+export declare const CANONICAL_SOURCE_ORDER: readonly MigrateSource[];
+/** What kind of thing an action/coverage row is about. */
+export type MigrateItemType = "mcp" | "skill" | "source";
+/**
+ * Per-item outcome taxonomy.
+ *
+ * `skipped_*` outcomes are non-fatal (exit 0). Any `failed_*` outcome sets
+ * `ok=false` and a non-zero process exit code.
+ */
+export type MigrationStatus = "imported" | "updated" | "skipped_exists" | "skipped_absent_source" | "skipped_unmappable" | "failed_invalid_source" | "failed_invalid_destination" | "failed_io";
+export declare const MIGRATION_STATUSES: readonly MigrationStatus[];
+/** Statuses that represent a hard failure (drive `ok=false` + non-zero exit). */
+export declare const FAILURE_STATUSES: ReadonlySet<MigrationStatus>;
+export declare function isFailureStatus(status: MigrationStatus): boolean;
+/** Operation the planner decided for an item. */
+export type MigrateOperation = "create" | "update" | "skip" | "fail";
+/** A raw MCP server candidate parsed from a source, before mapping/destination planning. */
+export interface McpCandidate {
+    source: MigrateSource;
+    name: string;
+    /** The raw, unmapped server entry from the source config (mapped by the planner). */
+    raw: unknown;
+}
+/** A raw skill candidate parsed from a source, before normalization/destination planning. */
+export interface SkillCandidate {
+    source: MigrateSource;
+    /** Slug used as the destination directory and effective loaded name. */
+    slug: string;
+    /** Full SKILL.md content (frontmatter already normalized so loaded name == slug). */
+    content: string;
+    warnings: string[];
+}
+/**
+ * Source-level diagnostic for a single source/type pair (e.g. "codex mcp config
+ * was malformed"). Distinct from per-item actions so absent/unreadable sources
+ * are reported once instead of per item.
+ */
+export interface SourceDiagnostic {
+    source: MigrateSource;
+    type: Exclude<MigrateItemType, "source"> | "source";
+    status: Extract<MigrationStatus, "skipped_absent_source" | "failed_invalid_source" | "failed_io">;
+    message: string;
+}
+/** Normalized candidates + diagnostics returned by an adapter. */
+export interface AdapterResult {
+    mcpCandidates: McpCandidate[];
+    skillCandidates: SkillCandidate[];
+    diagnostics: SourceDiagnostic[];
+}
+/** A single planned action consumed identically by dry-run and live execution. */
+export interface MigrateAction {
+    source: MigrateSource;
+    type: MigrateItemType;
+    name?: string;
+    /** For skills: the effective SKC-loaded name (== slug). */
+    effectiveName?: string;
+    /** Absolute destination path (mcp.json for MCP, <skillsDir>/<slug>/SKILL.md for skills). */
+    destination?: string;
+    operation: MigrateOperation;
+    status: MigrationStatus;
+    reason?: string;
+    warnings?: string[];
+    /** Resolved payload the executor needs; never serialized to the report. */
+    mcp?: {
+        config: MCPServerConfig;
+        force: boolean;
+    };
+    skill?: {
+        content: string;
+    };
+}
+export interface MigrateWarning {
+    source: MigrateSource;
+    type: string;
+    name?: string;
+    message: string;
+}
+export type StatusCounts = Record<MigrationStatus, number>;
+export interface MigrateDestinations {
+    mcpConfigPath: string;
+    skillsDir: string;
+}
+/** The full machine-readable report emitted with `--json`. */
+export interface MigrateReport {
+    ok: boolean;
+    dryRun: boolean;
+    project: boolean;
+    force: boolean;
+    sources: MigrateSource[];
+    destinations: MigrateDestinations;
+    summary: {
+        total: StatusCounts;
+        byType: {
+            mcp: StatusCounts;
+            skill: StatusCounts;
+            source: StatusCounts;
+        };
+        bySource: Record<MigrateSource, StatusCounts>;
+    };
+    actions: Array<{
+        source: MigrateSource;
+        type: MigrateItemType;
+        name?: string;
+        effectiveName?: string;
+        destination?: string;
+        operation: MigrateOperation;
+        status: MigrationStatus;
+        reason?: string;
+        warnings?: string[];
+    }>;
+    warnings: MigrateWarning[];
+}
+/** Create a zeroed status-count record. */
+export declare function emptyStatusCounts(): StatusCounts;

package/dist/types/modes/components/custom-editor.d.ts

@@ -1,5 +1,5 @@
 import { Editor, type KeyId } from "@sayknow-cli/tui";
-import type { AppKeybinding } from "../../config/keybindings";
+import { type AppKeybinding } from "../../config/keybindings";
 type ConfigurableEditorAction = Extract<AppKeybinding, "app.interrupt" | "app.clear" | "app.exit" | "app.suspend" | "app.thinking.cycle" | "app.model.cycleForward" | "app.model.cycleBackward" | "app.model.select" | "app.model.selectTemporary" | "app.tools.expand" | "app.thinking.toggle" | "app.editor.external" | "app.history.search" | "app.message.dequeue" | "app.message.queue" | "app.clipboard.pasteImage" | "app.clipboard.copyPrompt">;
 type PastePendingClearReason = "timeout" | "queue-limit";
 /**

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

@@ -8,6 +8,7 @@ export interface LspServerInfo {
     status: "ready" | "error" | "connecting";
     fileTypes: string[];
 }
+export type WelcomeLogoMode = "unicode" | "square" | "ascii";
 /**
  * Sayknow-CLI launch surface: a blue-gradient SAYKNOW wordmark, compact
  * command affordances, and project signals — a distinct identity, not a
@@ -20,7 +21,8 @@ export declare class WelcomeComponent implements Component {
     private providerName;
     private recentSessions;
     private lspServers;
-    constructor(version: string, modelName: string, providerName: string, recentSessions?: RecentSession[], lspServers?: LspServerInfo[]);
+    private readonly logoMode;
+    constructor(version: string, modelName: string, providerName: string, recentSessions?: RecentSession[], lspServers?: LspServerInfo[], logoMode?: WelcomeLogoMode);
     invalidate(): void;
     /**
      * Play a one-shot intro that sweeps the gradient through every phase

package/dist/types/modes/interactive-mode.d.ts

@@ -23,9 +23,12 @@ import type { HookInputComponent } from "./components/hook-input";
 import type { HookSelectorComponent } from "./components/hook-selector";
 import { StatusLineComponent } from "./components/status-line";
 import type { ToolExecutionHandle } from "./components/tool-execution";
+import { type WelcomeLogoMode } from "./components/welcome";
 import { OAuthManualInputManager } from "./oauth-manual-input";
 import type { Theme } from "./theme/theme";
 import type { CompactionQueuedMessage, InteractiveModeContext, SubmittedUserInput, TodoItem, TodoPhase } from "./types";
+export type WelcomeBannerSettingMode = "auto" | "unicode" | "square" | "ascii";
+export declare function resolveWelcomeLogoMode(mode: WelcomeBannerSettingMode, env?: Record<string, string | undefined>, platform?: NodeJS.Platform): WelcomeLogoMode;
 /** Options for creating an InteractiveMode instance (for future API use) */
 export interface InteractiveModeOptions {
     /** Providers that were migrated during startup */

package/dist/types/modes/prompt-action-autocomplete.d.ts

@@ -13,6 +13,7 @@ interface PromptActionAutocompleteOptions {
     keybindings: KeybindingsManager;
     copyCurrentLine: () => void;
     copyPrompt: () => void;
+    pasteImage: () => void;
     undo: (prefix: string) => void;
     moveCursorToMessageEnd: () => void;
     moveCursorToMessageStart: () => void;

package/dist/types/modes/shared/agent-wire/unattended-audit.d.ts

@@ -41,7 +41,7 @@ export interface AuditLogOptions {
     now?(): number;
     nextId?(): string;
 }
-export declare function defaultAuditPath(runId: string, root?: string): string;
+export declare function defaultAuditPath(runId: string, root?: string, skcSessionId?: string): string;
 /** Append-only audit log writer + reader for one unattended run. */
 export declare class UnattendedAuditLog {
     private readonly filePath;

package/dist/types/research-plan/index.d.ts

@@ -0,0 +1 @@
+export * from "./ledger";

package/dist/types/research-plan/ledger.d.ts

@@ -0,0 +1,33 @@
+export type ResearchPlanConfidence = "low" | "medium" | "high";
+export type ResearchEvidenceVerdict = "support" | "contradict" | "uncertain";
+export interface ResearchPlanItem {
+    claim: string;
+    confidence: ResearchPlanConfidence;
+    unknowns: string[];
+    evidenceNeeded: string[];
+    counterexampleQueries: string[];
+    sourceConflictPolicy: string;
+    dropCondition: string;
+    verifierChecks: string[];
+}
+export interface ResearchEvidenceEntry {
+    claim: string;
+    source: string;
+    confidence: ResearchPlanConfidence;
+    verdict: ResearchEvidenceVerdict;
+    notes?: string;
+}
+export interface ResearchLedgerVerdict {
+    claim: string;
+    finalVerdict: "accepted" | "rejected" | "uncertain";
+    survivingSources: ResearchEvidenceEntry[];
+    rejectReason?: string;
+    unresolvedUnknowns: string[];
+}
+export interface ResearchPlanValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export declare function validateResearchPlanItem(item: Partial<ResearchPlanItem>): ResearchPlanValidationResult;
+export declare function validateResearchEvidenceEntry(entry: Partial<ResearchEvidenceEntry>): ResearchPlanValidationResult;
+export declare function evaluateResearchLedger(item: ResearchPlanItem, evidence: readonly ResearchEvidenceEntry[]): ResearchLedgerVerdict;

package/dist/types/rlm/artifacts.d.ts

@@ -1,5 +1,5 @@
 import type { RlmArtifactPaths } from "./types";
-export declare const RLM_DIR_SEGMENT: string;
+export declare const RLM_DIR_SEGMENT = "rlm";
 export declare function isValidRlmSessionId(sessionId: string): boolean;
 /** Generate a filesystem-safe, sortable session id (timestamp + random suffix). */
 export declare function generateRlmSessionId(now?: Date): string;

package/dist/types/runtime-mcp/config-writer.d.ts

@@ -28,6 +28,32 @@ export declare function addMCPServer(filePath: string, name: string, config: MCP
  * @throws Error if validation fails
  */
 export declare function updateMCPServer(filePath: string, name: string, config: MCPServerConfig): Promise<void>;
+/**
+ * Result of an {@link upsertMCPServer} call.
+ * - `added`: server did not exist and was written.
+ * - `updated`: server existed and was overwritten because `force` was set.
+ * - `skipped`: server existed and `force` was not set, so nothing was written.
+ */
+export type UpsertMCPServerResult = {
+    status: "added";
+} | {
+    status: "updated";
+} | {
+    status: "skipped";
+    reason: "exists";
+};
+/**
+ * Add an MCP server, or overwrite an existing one only when `force` is set.
+ *
+ * Collision-aware wrapper over {@link addMCPServer} / {@link updateMCPServer} used by
+ * `skc migrate`. Never connects to the server. Reuses the underlying writers so the
+ * rest of the config file (including `disabledServers`) is preserved on update.
+ *
+ * @throws Error if the server name or config is invalid (validated before any write).
+ */
+export declare function upsertMCPServer(filePath: string, name: string, config: MCPServerConfig, options?: {
+    force?: boolean;
+}): Promise<UpsertMCPServerResult>;
 /**
  * Remove an MCP server from a config file.
  *