@sayknow-cli/coding-agent 0.3.16 → 0.4.0

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

@@ -1,158 +0,0 @@
-/**
- * Settings singleton with sync get/set and background persistence.
- *
- * Usage:
- *   import { settings } from "./settings";
- *
- *   const enabled = settings.get("compaction.enabled");  // sync read
- *   settings.set("theme.dark", "red-octopus");              // sync write, saves in background
- *
- * For tests:
- *   const isolated = Settings.isolated({ "compaction.enabled": false });
- */
-import { procmgr } from "@sayknow-cli/utils";
-import type { ModelRole } from "../config/model-registry";
-import { AgentStorage } from "../session/agent-storage";
-import { type EditMode } from "../utils/edit-mode";
-import { type BashInterceptorRule, type GroupPrefix, type GroupTypeMap, type SettingPath, type SettingValue } from "./settings-schema";
-export type * from "./settings-schema";
-export * from "./settings-schema";
-/** Raw settings object as stored in YAML */
-export interface RawSettings {
-    [key: string]: unknown;
-}
-export interface SettingsOptions {
-    /** Current working directory for project settings discovery */
-    cwd?: string;
-    /** Agent directory for config.yml storage */
-    agentDir?: string;
-    /** Don't persist to disk (for tests) */
-    inMemory?: boolean;
-    /** Initial overrides */
-    overrides?: Partial<Record<SettingPath, unknown>>;
-}
-export declare class Settings {
-    #private;
-    private constructor();
-    /**
-     * Initialize the global singleton.
-     * Call once at startup before accessing `settings`.
-     */
-    static init(options?: SettingsOptions): Promise<Settings>;
-    /**
-     * Create an isolated instance for testing.
-     * Does not affect the global singleton.
-     */
-    static isolated(overrides?: Partial<Record<SettingPath, unknown>>): Settings;
-    /**
-     * Get the global singleton.
-     * Throws if not initialized.
-     */
-    static get instance(): Settings;
-    /**
-     * Get a setting value (sync).
-     * Returns the merged value from global + project + overrides, or the default.
-     */
-    get<P extends SettingPath>(path: P): SettingValue<P>;
-    /**
-     * Get a setting value from the user/global config only.
-     *
-     * Use for machine-local command hooks and other settings that must not be
-     * activated by project-scoped config files.
-     */
-    getGlobal<P extends SettingPath>(path: P): SettingValue<P> | undefined;
-    /** Check whether a setting is present in loaded settings/overrides rather than coming from schema defaults. */
-    has(path: SettingPath): boolean;
-    /**
-     * Set a setting value (sync).
-     * Updates global settings and queues a background save.
-     * Triggers hooks for settings that have side effects.
-     */
-    set<P extends SettingPath>(path: P, value: SettingValue<P>): void;
-    /**
-     * Apply runtime overrides (not persisted).
-     */
-    override<P extends SettingPath>(path: P, value: SettingValue<P>): void;
-    /**
-     * Clear a runtime override.
-     */
-    clearOverride(path: SettingPath): void;
-    /**
-     * Flush any pending saves to disk.
-     * Call before exit to ensure all changes are persisted.
-     */
-    flush(): Promise<void>;
-    /**
-     * Like {@link flush}, but rejects if the durable save fails instead of
-     * swallowing the error. Use where the caller must confirm persistence before
-     * reporting success (e.g. the Telegram `/rich` toggle). In-memory instances
-     * ({@link isolated}) short-circuit in {@link #saveNow} and never throw.
-     */
-    flushOrThrow(): Promise<void>;
-    cloneForCwd(cwd: string): Promise<Settings>;
-    getStorage(): AgentStorage | null;
-    getCwd(): string;
-    getAgentDir(): string;
-    getPlansDirectory(): string;
-    /**
-     * Get shell configuration based on settings.
-     */
-    getShellConfig(): procmgr.ShellConfig;
-    /**
-     * Get all settings in a group with full type safety.
-     */
-    getGroup<G extends GroupPrefix>(prefix: G): GroupTypeMap[G];
-    /**
-     * Get the edit variant for a specific model.
-     * Returns "patch", "replace", "hashline", "vim", "apply_patch", or null (use global default).
-     */
-    getEditVariantForModel(model: string | undefined): EditMode | null;
-    /**
-     * Get bash interceptor rules (typed accessor for complex array config).
-     */
-    getBashInterceptorRules(): BashInterceptorRule[];
-    /**
-     * Set a model role (helper for modelRoles record).
-     */
-    setModelRole(role: ModelRole | string, modelId: string): void;
-    setGlobalModelRole(role: ModelRole | string, modelId: string | undefined): void;
-    setGlobalModelRoleAndFlush(role: ModelRole | string, modelId: string | undefined): Promise<void>;
-    /**
-     * Set an agent model override while keeping any live runtime override aligned.
-     *
-     * Runtime model profiles override `task.agentModelOverrides` for the current
-     * session. A user-selected role assignment must win immediately in that same
-     * session, but only the explicit agent change should be persisted.
-     */
-    setAgentModelOverride(agentName: string, modelId: string): void;
-    /**
-     * Get a model role (helper for modelRoles record).
-     */
-    getModelRole(role: ModelRole | string): string | undefined;
-    /**
-     * Get all model roles (helper for modelRoles record).
-     */
-    getModelRoles(): ReadOnlyDict<string>;
-    overrideModelRoles(roles: ReadOnlyDict<string>): void;
-    /**
-     * Set disabled providers (for compatibility with discovery system).
-     */
-    setDisabledProviders(ids: string[]): void;
-}
-/**
- * Subscribe to append-only mode setting changes.
- * Returns an unsubscribe function. Multiple sessions (main + subagents)
- * can register independently without overwriting each other.
- */
-export declare function onAppendOnlyModeChanged(cb: (value: string) => void): () => void;
-export declare function isSettingsInitialized(): boolean;
-/**
- * Reset the global singleton for testing.
- * @internal
- */
-export declare function resetSettingsForTest(): void;
-/**
- * The global settings singleton.
- * Must call `Settings.init()` before using.
- */
-export declare const settings: Settings;

package/dist/types/config/skill-settings-defaults.d.ts

@@ -1,14 +0,0 @@
-export interface SkillDiscoverySettings {
-    enabled?: boolean;
-    enableSkillCommands?: boolean;
-    enableCodexUser?: boolean;
-    enableClaudeUser?: boolean;
-    enableClaudeProject?: boolean;
-    enablePiUser?: boolean;
-    enablePiProject?: boolean;
-    customDirectories?: string[];
-    ignoredSkills?: string[];
-    includeSkills?: string[];
-}
-export declare const DEFAULT_SKILL_DISCOVERY_SETTINGS: SkillDiscoverySettings;
-export declare const DEFAULT_DISABLED_EXTENSIONS: string[];

package/dist/types/config/telegram-autostart.d.ts

@@ -1,14 +0,0 @@
-/**
- * Auto-start the Telegram Remote gateway when `telegram.enabled` is on.
- *
- * Called once during skc startup (interactive / persistent modes only — not
- * `-p` print or auto-print). Spawns the gateway as a detached background
- * process, tracks its PID so repeated skc invocations don't double-spawn,
- * and redirects output to a log file under the config root.
- */
-/**
- * If `telegram.enabled` is true and the gateway is not already running, spawn
- * it in the background. Never throws — failures are logged as warnings so the
- * main skc session is unaffected.
- */
-export declare function maybeAutostartTelegramRemote(): Promise<void>;

package/dist/types/config/telegram-env-bridge.d.ts

@@ -1,18 +0,0 @@
-/**
- * Bridge between skc settings (`telegram.*`) and the
- * `@sayknow-cli/telegram-remote` gateway's environment-driven config
- * (`loadConfigFromEnv` in packages/telegram-remote/src/config.ts).
- *
- * The gateway is a standalone process (`skc-telegram-remote`) that reads all
- * configuration from `SKC_TELEGRAM_REMOTE_*` env vars. This module converts the
- * typed settings group into those env vars so skc can spawn the gateway with a
- * consistent, settings-page-driven configuration.
- */
-import type { TelegramSettings } from "./settings-schema";
-/** Convert telegram settings into the env-var map the gateway expects. */
-export declare function telegramSettingsToEnv(s: TelegramSettings): Record<string, string>;
-/**
- * Validate telegram settings before spawning the gateway.
- * Returns a list of human-readable error strings (empty when valid).
- */
-export declare function validateTelegramSettings(s: TelegramSettings): string[];

package/dist/types/config.d.ts

@@ -1,66 +0,0 @@
-export * from "./config/config-file";
-/**
- * Get the base directory for resolving optional package assets (docs, examples).
- * Walk up from import.meta.dir until we find package.json, or fall back to cwd.
- */
-export declare function getPackageDir(): string;
-/** Get path to CHANGELOG.md (optional, may not exist in binary) */
-export declare function getChangelogPath(): string;
-export interface ConfigDirEntry {
-    path: string;
-    source: string;
-    level: "user" | "project";
-}
-export interface GetConfigDirsOptions {
-    /** Include user-level directories (~/.skc/agent/...). Default: true */
-    user?: boolean;
-    /** Include project-level directories (.skc/...). Default: true */
-    project?: boolean;
-    /** Current working directory for project paths. Default: getProjectDir() */
-    cwd?: string;
-    /** Only return directories that exist. Default: false */
-    existingOnly?: boolean;
-}
-/**
- * Get all config directories for a subpath, ordered by priority (highest first).
- *
- * @param subpath - Subpath within config dirs (e.g., "commands", "hooks", "agents")
- * @param options - Options for filtering
- * @returns Array of directory entries, highest priority first
- *
- * @example
- * // Get all command directories
- * getConfigDirs("commands")
- * // → [{ path: "~/.skc/agent/commands", source: ".skc", level: "user" }, ...]
- *
- * @example
- * // Get only existing project skill directories
- * getConfigDirs("skills", { user: false, existingOnly: true })
- */
-export declare function getConfigDirs(subpath: string, options?: GetConfigDirsOptions): ConfigDirEntry[];
-/**
- * Get all config directory paths for a subpath (convenience wrapper).
- * Returns just the paths, highest priority first.
- */
-export declare function getConfigDirPaths(subpath: string, options?: GetConfigDirsOptions): string[];
-export interface ConfigFileResult<T> {
-    path: string;
-    source: string;
-    level: "user" | "project";
-    content: T;
-}
-/**
- * Find the first existing config file (for non-JSON files like SYSTEM.md).
- * Returns just the path, or undefined if not found.
- */
-export declare function findConfigFile(subpath: string, options?: GetConfigDirsOptions): string | undefined;
-/**
- * Find the first existing config file with metadata.
- */
-export declare function findConfigFileWithMeta(subpath: string, options?: GetConfigDirsOptions): Omit<ConfigFileResult<never>, "content"> | undefined;
-/**
- * Find all nearest config directories by walking up from cwd.
- * Returns one entry per config base (.skc, .Anthropic model) - the nearest one found.
- * Results are in priority order (highest first).
- */
-export declare function findAllNearestProjectConfigDirs(subpath: string, cwd?: string): ConfigDirEntry[];

package/dist/types/coordinator/contract.d.ts

@@ -1,4 +0,0 @@
-export declare const COORDINATOR_MCP_PROTOCOL_VERSION = "2024-11-05";
-export declare const COORDINATOR_MCP_SERVER_NAME = "skc-coordinator-mcp";
-export declare const COORDINATOR_MCP_TOOL_NAMES: readonly ["skc_coordinator_list_sessions", "skc_coordinator_read_status", "skc_coordinator_read_tail", "skc_coordinator_list_questions", "skc_coordinator_list_artifacts", "skc_coordinator_read_artifact", "skc_coordinator_read_coordination_status", "skc_coordinator_watch_events", "skc_coordinator_register_session", "skc_coordinator_start_session", "skc_coordinator_stop_session", "skc_coordinator_send_prompt", "skc_coordinator_submit_question_answer", "skc_coordinator_read_turn", "skc_coordinator_await_turn", "skc_coordinator_report_status", "skc_delegate_plan", "skc_delegate_execute", "skc_delegate_team"];
-export type CoordinatorToolName = (typeof COORDINATOR_MCP_TOOL_NAMES)[number];

package/dist/types/coordinator-mcp/model-preset.d.ts

@@ -1,45 +0,0 @@
-import { type ModelProfileDefinition } from "../config/model-profiles";
-/**
- * Loads the merged built-in + custom model-profile registry the way the `skc`
- * CLI resolves `--mpreset`, so coordinator MCP launches select the same
- * authoritative profile the spawned child will activate. Custom profiles live
- * in the shared models config, which the child inherits, so both sides agree.
- */
-export type CoordinatorModelProfileLoader = () => Map<string, ModelProfileDefinition> | Promise<Map<string, ModelProfileDefinition>>;
-/**
- * Thrown by the default loader when `models.yml` exists but is invalid or
- * unreadable. This lets the resolver fail closed with a distinct, stable reason
- * instead of silently collapsing a broken registry to the built-ins-only set
- * (which would misreport a caller's valid custom profile as unknown).
- */
-export declare class CoordinatorModelProfileRegistryError extends Error {
-    constructor(cause?: unknown);
-}
-export declare const loadCoordinatorModelProfiles: CoordinatorModelProfileLoader;
-export type CoordinatorMpresetResolution = {
-    ok: true;
-    mpreset: string | null;
-} | {
-    ok: false;
-    reason: "unknown_model_profile";
-    mpreset: string;
-    available_profiles: string[];
-} | {
-    ok: false;
-    reason: "model_profile_registry_error";
-    mpreset: string;
-    available_profiles: string[];
-};
-/**
- * Resolve a coordinator `mpreset` argument against the merged profile registry.
- *
- * Only an absent (`undefined`/`null`) value is a no-op (`mpreset: null`); an
- * explicit empty/whitespace string is a caller error and is rejected rather
- * than silently launching at the default tier. Legacy aliases are canonicalized
- * exactly like the CLI (e.g. `codex-standard` -> `codex-medium`) so coordinator
- * selection stays in parity with `skc --mpreset <profile>`; the resolved value
- * is the canonical profile name. Unknown names are rejected with the
- * available-profile listing and never reach a spawned child command, and a
- * broken registry fails closed with `model_profile_registry_error`.
- */
-export declare function resolveCoordinatorMpreset(raw: unknown, loadProfiles: CoordinatorModelProfileLoader): Promise<CoordinatorMpresetResolution>;

package/dist/types/coordinator-mcp/policy.d.ts

@@ -1,27 +0,0 @@
-export type CoordinatorMutationClass = "sessions" | "questions" | "reports";
-export interface CoordinatorNamespace {
-    profile: string | null;
-    repo: string | null;
-}
-export interface CoordinatorMcpConfig {
-    allowedRoots: string[];
-    mutationClasses: Set<CoordinatorMutationClass>;
-    artifactByteCap: number;
-    namespace: CoordinatorNamespace;
-    stateRoot: string;
-    sessionCommand: string | null;
-    sessionIdleTtlMs: number;
-    sessionSweepIntervalMs: number;
-    forceStopEnabled: boolean;
-}
-export interface CoordinatorMutationRequest {
-    allow_mutation?: boolean;
-}
-export declare function buildCoordinatorMcpConfig(env?: NodeJS.ProcessEnv): CoordinatorMcpConfig;
-export declare function assertCoordinatorWorkdir(config: CoordinatorMcpConfig, cwd: unknown): Promise<string>;
-export declare function assertCoordinatorArtifactPath(config: CoordinatorMcpConfig, artifactPath: unknown): Promise<{
-    path: string;
-    byteCap: number;
-}>;
-export declare function requireCoordinatorMutation(config: CoordinatorMcpConfig, mutationClass: CoordinatorMutationClass, request: CoordinatorMutationRequest): void;
-export declare function coordinatorNamespacePath(config: CoordinatorMcpConfig): string;

package/dist/types/coordinator-mcp/safety.d.ts

@@ -1,26 +0,0 @@
-import { type CoordinatorMutationClass } from "./policy";
-export declare const COORDINATOR_MUTATION_CLASSES: readonly ["sessions", "questions", "reports"];
-export type { CoordinatorMutationClass };
-export interface CoordinatorSafetyConfig {
-    allowedRoots: string[];
-    artifactMaxBytes: number;
-    enabledMutationClasses: Set<CoordinatorMutationClass>;
-    repo?: string;
-    profile?: string;
-}
-export interface CoordinatorSafetyPolicy {
-    config: CoordinatorSafetyConfig;
-    resolveWorkdir(input: unknown): Promise<string>;
-    resolveArtifactPath(input: unknown): Promise<string>;
-    assertMutationAllowed(mutationClass: CoordinatorMutationClass, args: Record<string, unknown>): {
-        ok: true;
-    } | CoordinatorFailure;
-}
-export interface CoordinatorFailure {
-    ok: false;
-    reason: string;
-    [key: string]: unknown;
-}
-export declare function createCoordinatorSafetyPolicy(options?: {
-    env?: NodeJS.ProcessEnv;
-}): Promise<CoordinatorSafetyPolicy>;

package/dist/types/coordinator-mcp/server.d.ts

@@ -1,139 +0,0 @@
-import { COORDINATOR_MCP_PROTOCOL_VERSION, COORDINATOR_MCP_SERVER_NAME, COORDINATOR_MCP_TOOL_NAMES, type CoordinatorToolName } from "../coordinator/contract";
-import { type OwnerIsolationProbe } from "../skc-runtime/tmux-owner-isolation";
-import { type CoordinatorModelProfileLoader } from "./model-preset";
-import { type CoordinatorMcpConfig } from "./policy";
-import { type SessionReaper } from "./session-reaper";
-export type { CoordinatorToolName };
-export { COORDINATOR_MCP_PROTOCOL_VERSION, COORDINATOR_MCP_SERVER_NAME, COORDINATOR_MCP_TOOL_NAMES };
-interface JsonRpcRequest {
-    jsonrpc: "2.0";
-    id?: string | number | null;
-    method: string;
-    params?: unknown;
-}
-type JsonRpcResult = any;
-interface JsonRpcResponse {
-    jsonrpc: "2.0";
-    id: string | number | null;
-    result?: JsonRpcResult;
-    error?: {
-        code: number;
-        message: string;
-        data?: unknown;
-    };
-}
-interface SessionStartInput {
-    cwd: string;
-    prompt?: string;
-    mpreset?: string | null;
-    namespace: {
-        profile: string | null;
-        repo: string | null;
-    };
-    worktree: true;
-    sessionId: string;
-    launchId: string;
-    /** Canonical, coordinator-owned immutable readiness marker path. */
-    readinessMarkerFile: string;
-    /** @deprecated Compatibility alias for injected launch providers. */
-    readinessFile: string;
-}
-interface CommandResult {
-    exitCode: number;
-    stdout: string;
-    stderr: string;
-}
-type CommandRunner = (command: string[], stdinLine?: string) => Promise<CommandResult>;
-interface CoordinatorServices {
-    listSessions?: () => unknown[] | Promise<unknown[]>;
-    startSession?: (input: SessionStartInput) => unknown | Promise<unknown>;
-    commandRunner?: CommandRunner;
-    forceCloseSession?: (sessionName: string, env: NodeJS.ProcessEnv, expectedSessionId?: string, expectedStateFile?: string) => Promise<unknown>;
-    ownerIsolationProbe?: OwnerIsolationProbe;
-    resolveModelProfiles?: CoordinatorModelProfileLoader;
-}
-interface CoordinatorMcpServerOptions {
-    env?: NodeJS.ProcessEnv;
-    services?: CoordinatorServices;
-}
-interface LegacyHandlerOptions {
-    env?: NodeJS.ProcessEnv;
-    createSession?: (input: SessionStartInput) => unknown;
-}
-/**
- * Append an authoritative `--mpreset <profile>` to the coordinator child launch
- * command so the spawned SKC session activates the selected profile from its
- * first turn. The profile name is validated against the merged registry before
- * reaching here; it is still shell-quoted as defense in depth.
- *
- * Precedence note: this matches `skc --mpreset <profile>` semantics exactly, so
- * an explicit model-affecting flag already present in the operator-configured
- * `sessionCommand` (e.g. a `--model`/`--thinking` baked into the launch command)
- * follows the same CLI precedence as a direct `skc --mpreset ... --model ...`
- * invocation. The effective profile recorded on the session is the
- * coordinator-resolved request, not a child-attested activation receipt; a
- * cross-process activation receipt is a possible future enhancement and is out
- * of scope for the per-session selection contract here.
- */
-export declare function buildCoordinatorSessionCommand(sessionCommand: string, mpreset: string | null | undefined): string;
-export declare const COORDINATOR_AWAIT_TURN_TIMEOUT_MAX_MS: number;
-export declare const COORDINATOR_RUNTIME_PROMPT_ACK_TIMEOUT_MAX_MS: number;
-export declare const COORDINATOR_RUNTIME_READINESS_TIMEOUT_MAX_MS: number;
-export declare const COORDINATOR_EVENT_WATCH_TIMEOUT_MAX_MS = 30000;
-export declare const COORDINATOR_POLL_INTERVAL_MAX_MS = 10000;
-export declare function boundedAwaitTurnTimeoutMs(value: unknown): number;
-export declare function boundedRuntimePromptAckTimeoutMs(value: unknown): number;
-export declare function boundedRuntimeReadinessTimeoutMs(value: unknown): number;
-export declare function boundedEventWatchTimeoutMs(value: unknown): number;
-export declare function boundedPollIntervalMs(value: unknown): number;
-export declare function coordinatorOwnerIsolationProbe(runner: CommandRunner): Promise<OwnerIsolationProbe>;
-export declare function readCoordinatorArtifact(config: CoordinatorMcpConfig, args: {
-    path: unknown;
-}): Promise<Record<string, unknown>>;
-export declare function createCoordinatorMcpServer(options?: CoordinatorMcpServerOptions): {
-    config: CoordinatorMcpConfig;
-    callTool: (name: string, args?: Record<string, unknown>) => Promise<Record<string, unknown>>;
-    handleJsonRpc: (request: JsonRpcRequest) => Promise<JsonRpcResponse>;
-    handle: (request: JsonRpcRequest) => Promise<JsonRpcResponse>;
-    reapSession: (rawId: unknown, opts?: {
-        force?: boolean;
-        reason?: string;
-    }) => Promise<{
-        ok: boolean;
-        reason?: string;
-        killed: boolean;
-        active_turn_id?: string;
-        detail?: string;
-    }>;
-    sessionReaper: SessionReaper;
-};
-export declare function handleCoordinatorMcpRequest(request: JsonRpcRequest, options?: LegacyHandlerOptions): Promise<JsonRpcResponse>;
-export interface PumpCoordinatorOptions {
-    /** Max concurrent in-flight *data* (non-control) handlers. Control frames (ping) bypass this. */
-    maxDataConcurrency?: number;
-    /** Max data requests queued waiting for a slot before overflow is rejected as server_busy. */
-    maxQueueDepth?: number;
-    /** Bounded wait for in-flight handlers/writes to settle after input ends. */
-    drainTimeoutMs?: number;
-}
-/**
- * Pump a newline-delimited JSON-RPC stream with BOUNDED concurrent dispatch.
- *
- * A long-running tool call (e.g. skc_coordinator_await_turn, which polls for
- * minutes) must not block the read loop from answering keepalive pings on the
- * same stdio channel. But naive unbounded concurrency reintroduces its own
- * hazards, so this pump enforces the safety envelope the coordinator needs:
- *
- *  - Control frames (ping) bypass the data-concurrency cap → keepalive is always
- *    answerable even while data handlers saturate.
- *  - Data handlers are capped at `maxDataConcurrency`; excess is queued up to
- *    `maxQueueDepth`, then rejected as `server_busy` (bounded memory / fanout).
- *  - A coded local `EPIPE` terminalizes writer and dispatch together; other
- *    writer faults reject the pump without poisoning the serialized write chain.
- *  - On EOF or a closed peer the pump drains already-running handlers (bounded
- *    by `drainTimeoutMs`) and never promotes queued work.
- *  - Byte chunks are decoded with a streaming decoder so multibyte characters
- *    split across chunks are not corrupted.
- */
-export declare function pumpCoordinatorMcpStream(handleJsonRpc: (request: JsonRpcRequest) => Promise<JsonRpcResponse>, input: AsyncIterable<string | Uint8Array>, writeLine: (line: string) => void | Promise<void>, options?: PumpCoordinatorOptions): Promise<void>;
-export declare function runCoordinatorMcpStdio(options?: CoordinatorMcpServerOptions): Promise<void>;

package/dist/types/coordinator-mcp/session-reaper.d.ts

@@ -1,53 +0,0 @@
-/**
- * Idle reaper for coordinator-managed SKC worker sessions.
- *
- * Every `skc_delegate_*` call that omits `session_id` starts a fresh tmux worker
- * session. Nothing in the coordinator ever tore those down, so completed/crashed
- * sessions accumulated (RAM + worktrees) until something killed them by hand.
- *
- * This is the automatic backstop (defense-in-depth): a periodic sweep force-closes
- * sessions that are (a) ephemeral — coordinator delegate-created, never a user's
- * registered resident session, (b) not mid-turn, and (c) idle past a TTL.
- *
- * The controller is pure + fully injectable (clock / list / reap side-effects) so
- * it is unit-testable without tmux, the filesystem, or wall-clock waits. The
- * scheduling mirrors the proven resource-gc controller: a recursive setTimeout
- * with a generation guard so a stop()+start() can never leak a duplicate timer.
- */
-export declare const DEFAULT_SESSION_IDLE_TTL_MS: number;
-export declare const DEFAULT_SESSION_SWEEP_INTERVAL_MS: number;
-export declare const MIN_SESSION_IDLE_TTL_MS = 60000;
-export declare const MIN_SESSION_SWEEP_INTERVAL_MS = 30000;
-/** Minimal projection of a coordinator session the reaper needs to decide. */
-export interface ReapableSession {
-    sessionId: string;
-    /** True only for coordinator delegate-created sessions. User-registered resident sessions are false and never reaped. */
-    ephemeral: boolean;
-    /** Epoch ms of last observed activity (turn update / session-state write / session creation). */
-    lastActivityMs: number;
-    /** True while a turn is active — never reap mid-turn. */
-    hasActiveTurn: boolean;
-}
-export interface SessionReaperPolicy {
-    idleTtlMs: number;
-    sweepIntervalMs: number;
-}
-/**
- * Pure selection: which sessions are safe to reap at `now`.
- * A session is reapable iff ephemeral AND not mid-turn AND idle ≥ (clamped) TTL.
- */
-export declare function selectReapableSessions(sessions: readonly ReapableSession[], now: number, idleTtlMs: number): ReapableSession[];
-/** Injectable side-effects so the controller runs in tests without tmux/fs/real time. */
-export interface SessionReaperDeps {
-    listSessions: () => Promise<ReapableSession[]>;
-    reapSession: (sessionId: string) => Promise<void>;
-    now: () => number;
-}
-export interface SessionReaper {
-    /** Run one sweep; returns the number of sessions successfully reaped. */
-    sweepOnce: () => Promise<number>;
-    start: () => void;
-    stop: () => void;
-    readonly running: boolean;
-}
-export declare function createSessionReaper(deps: SessionReaperDeps, policy: SessionReaperPolicy): SessionReaper;

package/dist/types/cursor.d.ts

@@ -1,24 +0,0 @@
-import type { AgentEvent, AgentTool, AgentToolContext } from "@sayknow-cli/agent-core";
-import type { CursorMcpCall, CursorShellStreamCallbacks, CursorExecHandlers as ICursorExecHandlers, ToolResultMessage } from "@sayknow-cli/ai";
-interface CursorExecBridgeOptions {
-    cwd: string;
-    tools: Map<string, AgentTool>;
-    getToolContext?: () => AgentToolContext | undefined;
-    emitEvent?: (event: AgentEvent) => void;
-    createEventEmitter?: () => ((event: AgentEvent) => void) | undefined;
-}
-export declare class CursorExecHandlers implements ICursorExecHandlers {
-    #private;
-    private options;
-    constructor(options: CursorExecBridgeOptions);
-    read(args: Parameters<NonNullable<ICursorExecHandlers["read"]>>[0]): Promise<ToolResultMessage<any>>;
-    ls(args: Parameters<NonNullable<ICursorExecHandlers["ls"]>>[0]): Promise<ToolResultMessage<any>>;
-    grep(args: Parameters<NonNullable<ICursorExecHandlers["grep"]>>[0]): Promise<ToolResultMessage<any>>;
-    write(args: Parameters<NonNullable<ICursorExecHandlers["write"]>>[0]): Promise<ToolResultMessage<any>>;
-    delete(args: Parameters<NonNullable<ICursorExecHandlers["delete"]>>[0]): Promise<ToolResultMessage<any>>;
-    shell(args: Parameters<NonNullable<ICursorExecHandlers["shell"]>>[0]): Promise<ToolResultMessage<any>>;
-    shellStream(args: Parameters<NonNullable<ICursorExecHandlers["shellStream"]>>[0], callbacks: CursorShellStreamCallbacks): Promise<ToolResultMessage<any>>;
-    diagnostics(args: Parameters<NonNullable<ICursorExecHandlers["diagnostics"]>>[0]): Promise<ToolResultMessage<any>>;
-    mcp(call: CursorMcpCall): Promise<ToolResultMessage<any>>;
-}
-export {};

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

@@ -1,20 +0,0 @@
-/**
- * Static built-in daemon controller map.
- *
- * Intentionally a static map keyed by daemon kind rather than a mutable plugin
- * registry: there is exactly one kind today (`telegram`). Promote to a richer
- * registry only when a second daemon kind exists.
- */
-import type { Settings } from "../config/settings";
-import { type TelegramDaemonControlDeps } from "../notifications/telegram-daemon-control";
-import type { BuiltInDaemonController, DaemonKind } from "./control-types";
-export declare const BUILT_IN_DAEMON_KINDS: readonly ["telegram"];
-export interface BuiltInDaemonControllerDeps {
-    telegram?: TelegramDaemonControlDeps;
-}
-export declare function createBuiltInDaemonControllers(settings: Settings, deps?: BuiltInDaemonControllerDeps): Record<DaemonKind, BuiltInDaemonController>;
-/**
- * Resolve the controllers a command should act on. `--all` selects every
- * built-in kind; otherwise the explicit `kinds` (defaulting to `telegram`).
- */
-export declare function selectDaemonControllers(settings: Settings, kinds: DaemonKind[] | undefined, all: boolean, deps?: BuiltInDaemonControllerDeps): BuiltInDaemonController[];