@wrongstack/tools 0.284.0 → 0.285.0

package/dist/index.d.ts

@@ -1,14 +1,18 @@
-export { D as DangerAssessment, a as DangerLevel, c as configureDangerBypass, b as configureExecPolicy, d as detectDanger, e as execTool, g as getDangerBypass, f as getExecAllowlist, i as isExecCommandAllowed, r as resetDangerBypass, h as resetExecPolicy } from './exec-2OKoT6tk.js';
+export { type DangerAssessment, type DangerLevel, detectDanger } from './_danger-detect.js';
+export { type EnsureSessionShellOptions, ensureSessionShell, normalizeShell, type ResolveSessionShellDeps, resolveSessionShell, } from './_session-shell.js';
+export type { BashShell } from './_shell-pick.js';
 export { auditTool } from './audit.js';
 export { bashTool } from './bash.js';
 export { batchToolUseTool } from './batch-tool-use.js';
-export { OPTIONAL_TOOLS, TIER1_TOOLS, TIER2_TOOLS, TIER3_TOOLS, builtinTools } from './builtin.js';
-export { CircuitBreaker, CircuitBreakerConfig, CircuitBreakerSnapshot } from './circuit-breaker.js';
-export { C as CircuitOpenError, e as CircuitSnapshot, f as CircuitState, h as IndexCircuitBreaker, i as IndexTimeoutError, k as cancelPendingReindexes, l as codebaseIndexStats, m as codebaseIndexTool, n as codebaseSearchTool, o as codebaseStatsTool, p as enqueueReindex, q as getIndexState, r as indexCircuitBreaker, s as isIndexReady, t as isIndexableFile, u as isIndexing, v as onIndexStateChange, w as resetIndexCircuitBreaker, x as runStartupIndex, y as searchCodebaseIndex, z as shutdownCodebaseIndexHost } from './background-indexer-BeDBxfSh.js';
-import { Tool, SerializedTaskGraph, SkillLoader } from '@wrongstack/core';
+export { builtinTools, OPTIONAL_TOOLS, TIER1_TOOLS, TIER2_TOOLS, TIER3_TOOLS } from './builtin.js';
+export { CircuitBreaker, type CircuitBreakerConfig, type CircuitBreakerSnapshot, } from './circuit-breaker.js';
+export type { CircuitSnapshot, CircuitState } from './codebase-index/index.js';
+export { CircuitOpenError, cancelPendingReindexes, codebaseIndexStats, codebaseIndexTool, codebaseSearchTool, codebaseStatsTool, enqueueReindex, getIndexState, IndexCircuitBreaker, IndexTimeoutError, indexCircuitBreaker, isIndexableFile, isIndexing, isIndexReady, onIndexStateChange, resetIndexCircuitBreaker, runStartupIndex, searchCodebaseIndex, shutdownCodebaseIndexHost, } from './codebase-index/index.js';
+export { designTool } from './design.js';
 export { diffTool } from './diff.js';
 export { documentTool } from './document.js';
 export { editTool } from './edit.js';
+export { configureDangerBypass, configureExecPolicy, execTool, getDangerBypass, getExecAllowlist, isExecCommandAllowed, resetDangerBypass, resetExecPolicy, } from './exec.js';
 export { fetchTool } from './fetch.js';
 export { formatTool } from './format.js';
 export { gitTool } from './git.js';
@@ -16,7 +20,8 @@ export { globTool } from './glob.js';
 export { grepTool } from './grep.js';
 export { installTool } from './install.js';
 export { jsonTool } from './json.js';
-import { AssignKanbanTaskInput, KanbanTaskPriority, KanbanTaskStatus, KanbanAgentRunStatus, KanbanBoard, KanbanBoardSummary, KanbanTask, KanbanSearchResult, KanbanEvent, KanbanQueueHealth, KanbanOrchestrationSnapshot } from '@wrongstack/kanban';
+export { kanbanTool } from './kanban.js';
+export * from './languages/index.js';
 export { lintTool } from './lint.js';
 export { logsTool } from './logs.js';
 export { forgetTool, relatedMemoryTool, rememberTool, searchMemoryTool } from './memory.js';
@@ -24,733 +29,23 @@ export { createModeTool } from './mode.js';
 export { outdatedTool } from './outdated.js';
 export { builtinToolsPack } from './pack.js';
 export { patchTool } from './patch.js';
-import { ProcessRegistryImpl } from './process-registry.js';
-export { BreakerCountdown, KillOpts, RegistryStats, TrackedProcess, _resetProcessRegistry, getProcessRegistry } from './process-registry.js';
+export { planTool } from './plan.js';
+export { getProcessGuardian, type ProcessGuardianConfig, startProcessGuardian, stopProcessGuardian, } from './process-guardian.js';
+export { _resetProcessRegistry, type BreakerCountdown, getProcessRegistry, type KillOpts, type ProcessRegistryImpl, type RegistryStats, type TrackedProcess, } from './process-registry.js';
+export { getPersistentProcessRegistry, type PersistentProcessEntry, type PersistentRegistryData, resetPersistentProcessRegistry, } from './process-registry-persistent.js';
+export { createGlobalPsSlashCommand, formatGlobalStatus, formatInstanceList, formatInstanceSummary, type GlobalProcessStatus, getInstanceCount, type InstanceInfo, type InstanceListOptions, listInstances, } from './ps-slash.js';
 export { readTool } from './read.js';
 export { replaceTool } from './replace.js';
 export { scaffoldTool } from './scaffold.js';
 export { searchTool } from './search.js';
+export { makeSkillTool } from './skill.js';
 export { testTool } from './test.js';
 export { todoTool } from './todo.js';
 export { toolHelpTool } from './tool-help.js';
+export { FALLBACK_ICON, getToolIcon, TOOL_ICON_CONFIG, TOOL_ICON_MAP, type ToolIconConfig, type ToolIconId, } from './tool-icon-map.js';
 export { toolSearchTool } from './tool-search.js';
 export { toolUseTool } from './tool-use.js';
 export { treeTool } from './tree.js';
 export { typecheckTool } from './typecheck.js';
 export { writeTool } from './write.js';
-import 'node:child_process';
-
-/**
- * Shell picker for the `bash` tool on Windows.
- *
- * Historically the bash tool always fell back to `cmd.exe` on Windows — a
- * reasonable default for the small set of POSIX-style commands the tool was
- * built around (`echo`, `dir`, `cd`, `set`, etc.). That breaks when the
- * caller emits PowerShell-style commands (e.g. Codex on Windows routinely
- * emits `Get-Content`, `Get-ChildItem`, `Set-Location`, …), which `cmd.exe`
- * rejects with "'Get-Content' is not recognized as an internal or external
- * command, operable program or batch file." This module decides — purely from
- * the command string and a few well-known env vars — which shell should run
- * the command. It returns a tagged value; bash.ts does the actual spawn.
- *
- * The picker never spawns anything itself, so it is safe to unit-test in
- * isolation. Shell *resolution* (finding the actual binary on PATH) lives in
- * `_win32-resolve.ts` and runs at spawn time.
- * @see {@link ../../docs/configuration.md#windows-shell-selection-wrongstackshell} for user-facing documentation of the WRONGSTACK_SHELL env var and auto-detection behavior.
- *
- * Selection precedence (Windows only):
- *   1. `WRONGSTACK_SHELL` env var, if it names a known shell (cmd | powershell
- *      | pwsh). This is the override for users who want a fixed shell.
- *   2. Auto-detect: if the command "looks like" PowerShell — i.e. uses cmdlet
- *      verb-noun syntax, $-variables, subexpressions, here-strings, etc. —
- *      route to PowerShell. Prefers `pwsh` (PowerShell 7+) and falls back to
- *      `powershell` (Windows PowerShell 5.1) at spawn time.
- *   3. Default: `cmd.exe` (preserves legacy behavior).
- *
- * On non-Windows the picker is a no-op — bash.ts already routes through
- * `/bin/bash -c`. We return `'cmd'` as a sentinel value that means "the
- * platform default"; bash.ts maps it to the right binary.
- *
- * See docs/configuration.md § "Windows shell selection (WRONGSTACK_SHELL)" for
- * user-facing documentation of the env var and auto-detection behaviour.
- */
-type BashShell = 'cmd' | 'powershell' | 'pwsh';
-
-/**
- * Session-shell resolution for Windows.
- *
- * `pickShell` (`_shell-pick.ts`) decides the shell *per command* — it inspects
- * each command string and routes PowerShell-looking work to PowerShell, else
- * `cmd.exe`. That keeps individual commands working, but it means the shell the
- * model is *told* about (the system-prompt Environment block) and the shell that
- * actually runs a given command can disagree, and a plain command like
- * `git status` silently lands in `cmd.exe` while `Get-ChildItem` lands in
- * PowerShell. The model has no stable target to write syntax for.
- *
- * This module resolves ONE shell for the whole session and pins it via the
- * `WRONGSTACK_SHELL` env var. Because `WRONGSTACK_SHELL` is already the top
- * precedence in `pickShell`, pinning it makes every command route to the same
- * shell with zero changes to `bash.ts` — and the system-prompt builder can read
- * the same env var to tell the model exactly which shell + syntax to use.
- *
- * Resolution (Windows only — POSIX has no fixed session shell here; `bash.ts`
- * routes through `/bin/bash -c` and honours an explicit `WRONGSTACK_SHELL` as a
- * binary path):
- *   1. A valid user-set `WRONGSTACK_SHELL` (cmd | powershell | pwsh) wins and is
- *      left untouched.
- *   2. Otherwise prefer `pwsh` (PowerShell 7+) when `pwsh.exe` is on PATH.
- *   3. Otherwise `powershell` (Windows PowerShell 5.1).
- *   4. Otherwise `cmd` (only when no PowerShell is installed — effectively never
- *      on a real Windows box).
- *
- * @see {@link ../../docs/configuration.md#windows-shell-selection-wrongstackshell}
- */
-
-/**
- * Map a raw `WRONGSTACK_SHELL` value (which may carry a `.exe` suffix or odd
- * casing) to a canonical {@link BashShell}, or `undefined` when it is unset /
- * not a known shell. Mirrors the override parsing in `pickShell`.
- */
-declare function normalizeShell(value: string | undefined): BashShell | undefined;
-interface ResolveSessionShellDeps {
-    /**
-     * Returns true when `bin` (e.g. `'pwsh.exe'`) resolves on PATH. Injectable so
-     * the resolver is unit-testable off-Windows; defaults to `resolveWin32Command`
-     * (which itself short-circuits to "not found" when `process.platform` is not
-     * win32).
-     */
-    hasBinary?: ((bin: string) => boolean) | undefined;
-}
-/**
- * Pure decision: which single shell should the session use on `platform`?
- * Returns `undefined` on non-win32 (no fixed session shell). Does not mutate
- * anything.
- */
-declare function resolveSessionShell(platform: NodeJS.Platform, env: {
-    get(key: string): string | undefined;
-}, deps?: ResolveSessionShellDeps): BashShell | undefined;
-interface EnsureSessionShellOptions {
-    /** Env to read/mutate. Defaults to `process.env`. */
-    env?: NodeJS.ProcessEnv | undefined;
-    /** Platform override (tests). Defaults to `process.platform`. */
-    platform?: NodeJS.Platform | undefined;
-    /** Binary-presence probe (tests). Forwarded to {@link resolveSessionShell}. */
-    hasBinary?: ((bin: string) => boolean) | undefined;
-}
-/**
- * Resolve the session shell and pin it into `WRONGSTACK_SHELL` so the bash tool
- * and the system-prompt builder agree on one stable value. Idempotent:
- *
- *   - non-win32 → no-op, returns `undefined`.
- *   - a valid user-set `WRONGSTACK_SHELL` → returned as-is, env left untouched.
- *   - otherwise → resolves, writes the canonical value into the env, returns it.
- *
- * Call this once at process boot, before the system-prompt builder is built.
- */
-declare function ensureSessionShell(opts?: EnsureSessionShellOptions): BashShell | undefined;
-
-type Overrides = Record<string, string>;
-interface DesignInput {
-    action?: 'list' | 'use' | 'foundations' | 'set' | 'materialize' | 'verify' | undefined;
-    kit?: string | undefined;
-    stack?: string | undefined;
-    /** action "set" / "use": token overrides, e.g. { primary: "oklch(...)", "dark.bg": "#111" }. */
-    set?: Overrides | undefined;
-    /** action "materialize": output path (project-relative); defaults per stack. */
-    out?: string | undefined;
-    /** action "materialize": overwrite an existing file. */
-    force?: boolean | undefined;
-    /** action "verify": explicit files to scan (project-relative). Defaults to a UI-file walk. */
-    files?: string[] | undefined;
-}
-interface DesignOutput {
-    action: string;
-    kit?: string | undefined;
-    stack?: string | undefined;
-    output: string;
-    /** action "materialize": where the theme file was (or would be) written. */
-    path?: string | undefined;
-    /** action "verify": adherence score 0..1 and violation count. */
-    score?: number | undefined;
-    violations?: number | undefined;
-}
-/**
- * Design Studio tool — progressive disclosure + token enforcement.
- *
- * `list`/`use`/`foundations` browse and pin kits. `set` records structured color
- * overrides (these win over kit tokens). `materialize` writes the active kit's
- * (override-applied) tokens to a real, stack-appropriate theme file so the
- * palette becomes the codebase's source of truth — not just a prompt hint.
- * `verify` scans UI files for off-palette drift.
- */
-declare const designTool: Tool<DesignInput, DesignOutput>;
-
-type KanbanAction = 'list_boards' | 'get_board' | 'create_board' | 'duplicate_board' | 'update_board' | 'delete_board' | 'generate_board' | 'export_markdown' | 'export_task_graph' | 'sync_task_graph' | 'search_tasks' | 'ready_tasks' | 'snapshot' | 'add_column' | 'update_column' | 'delete_column' | 'add_task' | 'split_task' | 'merge_tasks' | 'copy_task' | 'transfer_task' | 'get_task' | 'update_task' | 'move_task' | 'delete_task' | 'set_chain' | 'get_chain' | 'claim_task' | 'release_task' | 'assign_task' | 'mark_assignment' | 'heartbeat_assignment' | 'recover_stale' | 'events' | 'queue_health' | 'add_dependency' | 'add_goal_metric' | 'update_goal_metric' | 'add_check' | 'update_check' | 'add_note' | 'add_link';
-interface KanbanToolInput extends Omit<AssignKanbanTaskInput, 'status'> {
-    action: KanbanAction;
-    boardId?: string | undefined;
-    taskId?: string | undefined;
-    columnId?: string | undefined;
-    targetBoardId?: string | undefined;
-    taskIds?: string[] | undefined;
-    chainId?: string | undefined;
-    title?: string | undefined;
-    description?: string | undefined;
-    tags?: string[] | undefined;
-    labels?: string[] | undefined;
-    priority?: KanbanTaskPriority | undefined;
-    status?: KanbanTaskStatus | undefined;
-    order?: number | undefined;
-    targetColumnId?: string | undefined;
-    moveTasksToColumnId?: string | undefined;
-    query?: string | undefined;
-    limit?: number | undefined;
-    dependencyTaskId?: string | undefined;
-    enforceDependencies?: boolean | undefined;
-    childTitles?: string[] | undefined;
-    inheritAssignment?: boolean | undefined;
-    inheritLabels?: boolean | undefined;
-    inheritSuccessCriteria?: boolean | undefined;
-    inheritGoalMetrics?: boolean | undefined;
-    inheritDependencies?: boolean | undefined;
-    chainChildren?: boolean | undefined;
-    rewireDependents?: boolean | undefined;
-    closeSourceTasks?: boolean | undefined;
-    metricId?: string | undefined;
-    metricName?: string | undefined;
-    metricTarget?: string | number | undefined;
-    metricCurrent?: string | number | undefined;
-    metricUnit?: string | undefined;
-    metricStatus?: 'pending' | 'met' | 'missed' | 'waived' | undefined;
-    metricNotes?: string | undefined;
-    checkId?: string | undefined;
-    checkDescription?: string | undefined;
-    checkStatus?: 'pending' | 'passed' | 'failed' | 'skipped' | undefined;
-    note?: string | undefined;
-    author?: string | undefined;
-    url?: string | undefined;
-    linkTitle?: string | undefined;
-    linkType?: 'issue' | 'pr' | 'doc' | 'commit' | 'design' | 'file' | 'url' | 'other' | undefined;
-    context?: string | undefined;
-    columns?: string[] | undefined;
-    generatedBy?: string | undefined;
-    includeTasks?: boolean | undefined;
-    includeCompletedTasks?: boolean | undefined;
-    preserveAssignment?: boolean | undefined;
-    preserveDependencies?: boolean | undefined;
-    leaseId?: string | undefined;
-    claimedAt?: string | undefined;
-    heartbeatAt?: string | undefined;
-    leaseExpiresAt?: string | undefined;
-    attempt?: number | undefined;
-    maxAttempts?: number | undefined;
-    costCeilingUsd?: number | undefined;
-    retryPolicy?: 'off' | 'incremental' | 'exponential' | undefined;
-    lastFailureKind?: string | undefined;
-    subagentId?: string | undefined;
-    runTaskId?: string | undefined;
-    lastResult?: string | undefined;
-    error?: string | undefined;
-    assignmentStatus?: KanbanAgentRunStatus | undefined;
-    releaseStatus?: 'pending' | 'ready' | 'blocked' | undefined;
-    releaseReason?: string | undefined;
-    clearAssignee?: boolean | undefined;
-    recoveryMode?: 'auto' | 'release' | 'retry' | 'fail' | undefined;
-    recoveryNow?: string | undefined;
-    recoveryPolicyFailOnCostCeiling?: boolean | undefined;
-    recoveryPolicyReleaseOnFailureKinds?: string[] | undefined;
-    recoveryPolicyReleaseOnHeartbeatDue?: boolean | undefined;
-    recoveryPolicyRetryPolicyOverride?: 'off' | 'incremental' | 'exponential' | undefined;
-    taskGraph?: unknown;
-    graphId?: string | undefined;
-    specId?: string | undefined;
-    sourceSystem?: string | undefined;
-    phaseId?: string | undefined;
-    preserveOriginTaskIds?: boolean | undefined;
-    includeArchived?: boolean | undefined;
-    archiveMissingTasks?: boolean | undefined;
-    preserveManualDependencies?: boolean | undefined;
-}
-interface KanbanToolOutput {
-    ok: boolean;
-    message: string;
-    board?: KanbanBoard | undefined;
-    boards?: KanbanBoardSummary[] | undefined;
-    task?: KanbanTask | undefined;
-    tasks?: KanbanSearchResult[] | undefined;
-    recoveredTasks?: KanbanTask[] | undefined;
-    events?: KanbanEvent[] | undefined;
-    queueHealth?: KanbanQueueHealth | undefined;
-    children?: KanbanTask[] | undefined;
-    chain?: KanbanTask[] | undefined;
-    snapshot?: KanbanOrchestrationSnapshot | undefined;
-    taskGraph?: SerializedTaskGraph | undefined;
-    markdown?: string | undefined;
-}
-declare const kanbanTool: Tool<KanbanToolInput, KanbanToolOutput>;
-
-/**
- * `planTool` — the LLM-callable counterpart to the `/plan` slash command.
- *
- * Plans capture strategic, multi-step approaches that survive across
- * session resumes (unlike todos, which are tactical and per-turn).
- * Storage path comes from `ctx.meta['plan.path']` — the CLI seeds this
- * during startup so the tool always knows where to read/write.
- *
- * One tool, multiple actions, JSON in/out. The action discriminates the
- * operation so the LLM can do show / add / start / done / remove / promote /
- * derive / template_use / clear via a single tool registration instead of
- * bloating the surface with nine near-identical tools.
- */
-interface PlanInput {
-    action: 'show' | 'add' | 'start' | 'done' | 'remove' | 'promote' | 'template_use' | 'clear' | 'taskify';
-    /** Required for add. */
-    title?: string | undefined;
-    /** Optional detail line for add. */
-    details?: string | undefined;
-    /** Required for start/done/remove/promote — accepts plan item id OR 1-based index OR title substring. */
-    target?: string | undefined;
-    /** Optional subtasks for promote. If omitted, a single todo is created from the plan item title. */
-    subtasks?: string[] | undefined;
-    /** Required for template_use — the template name (e.g. "new-feature", "bug-fix"). */
-    template?: string | undefined;
-    /**
-     * Storage scope. Default (unset): uses the session-scoped path — isolated to this
-     * session, survives resume within the same session.
-     * `scope: 'project'`: uses a shared project-level path, visible to all sessions
-     * for this project. Useful for a shared roadmap that outlasts any single session.
-     */
-    scope?: 'session' | 'project';
-}
-interface PlanOutput {
-    ok: boolean;
-    message: string;
-    /** Formatted plan after the operation. Same string the user sees from `/plan show`. */
-    plan: string;
-    /** Total item count after the operation. */
-    count: number;
-    /** Number of items not in 'done' status. */
-    open: number;
-    /** When promote/derive succeed, the generated todo items so the caller can inspect them. */
-    todos?: Array<{
-        id: string;
-        content: string;
-        status: string;
-        activeForm?: string | undefined;
-        promotedFromPlan?: string | undefined;
-    }>;
-}
-declare const planTool: Tool<PlanInput, PlanOutput>;
-
-/**
- * Process Guardian — Protects WrongStack processes from being killed via
- * bash/kill commands. Runs as a watchdog that:
- *
- * 1. Registers the main process and all children with persistent registry
- * 2. Monitors for kill attempts against protected PIDs
- * 3. Provides recovery mechanisms when killed processes are detected
- * 4. Coordinates protection across multiple WrongStack instances
- *
- * This is NOT a security mechanism against intentional root-level kills.
- * A user with sudo/root can still kill any process. This is a guardrail
- * to prevent accidental kills from the WrongStack agent itself.
- */
-interface ProcessGuardianConfig {
-    /** Interval for heartbeat in ms */
-    heartbeatIntervalMs?: number;
-    /** Enable automatic process resurrection */
-    autoResurrect?: boolean;
-    /** Maximum resurrection attempts */
-    maxResurrectionAttempts?: number;
-    /** Custom protection patterns */
-    protectedPatterns?: string[];
-    /**
-     * How many SIGTERM signals to tolerate before exiting.
-     * The first N-1 are ignored to protect against accidental `kill` from the
-     * AI agent; the Nth triggers graceful shutdown via `stop()` + `process.exit(0)`.
-     * Default 3 — balances AI guardrail vs container orchestration (Docker,
-     * systemd repeat SIGTERM up to StopTimeout ~10s, then SIGKILL).
-     * Set to 0 to always exit on the first SIGTERM, or Infinity to never exit.
-     */
-    sigtermThreshold?: number;
-}
-/**
- * Process Guardian watches over WrongStack processes and prevents accidental kills.
- */
-declare class ProcessGuardian {
-    private readonly registry;
-    private readonly config;
-    private readonly protectedProcesses;
-    private heartbeatTimer;
-    private isRunning;
-    private instanceId;
-    private sigtermCount;
-    constructor(config?: ProcessGuardianConfig);
-    /**
-     * Start the guardian - begins monitoring and registration.
-     */
-    start(): void;
-    /**
-     * Stop the guardian gracefully.
-     */
-    stop(): void;
-    /**
-     * Register a process with the guardian.
-     */
-    registerProcess(pid: number, name: string): void;
-    /**
-     * Unregister a process (e.g., when it exits normally).
-     */
-    unregisterProcess(pid: number): void;
-    /**
-     * Register all child processes that already exist.
-     */
-    private registerExistingChildren;
-    /**
-     * Sync protected processes with the base ProcessRegistry.
-     */
-    private syncWithProcessRegistry;
-    /**
-     * Heartbeat - updates timestamps and checks for anomalies.
-     */
-    private heartbeat;
-    /**
-     * Set up process-level event handlers.
-     */
-    private setupProcessHandlers;
-    /**
-     * Check if a PID is protected by this guardian.
-     */
-    isProtected(pid: number): boolean;
-    /**
-     * Get all PIDs protected by this guardian.
-     */
-    getProtectedPids(): number[];
-    /**
-     * Get status information for monitoring.
-     */
-    getStatus(): {
-        instanceId: string;
-        mainPid: number;
-        protectedCount: number;
-        platform: string;
-        hostname: string;
-        uptime: number;
-    };
-}
-declare function getProcessGuardian(): ProcessGuardian;
-declare function startProcessGuardian(config?: ProcessGuardianConfig): ProcessGuardian;
-declare function stopProcessGuardian(): void;
-
-/**
- * PersistentProcessRegistry — filesystem-backed process registry that survives
- * process restarts and coordinates protection across multiple WrongStack instances
- * running in different terminals.
- *
- * Key features:
- * - PIDs stored in ~/.wrongstack/process-registry.json
- * - File locking for cross-instance coordination
- * - Heartbeat mechanism to detect stale entries
- * - Protection whitelist that blocks kill commands targeting WrongStack processes
- * - Multi-instance awareness: all instances share the same protection state
- */
-
-interface PersistentProcessEntry {
-    pid: number;
-    name: string;
-    command: string;
-    startedAt: number;
-    lastHeartbeat: number;
-    sessionId?: string;
-    instanceId: string;
-    /** Hostname where this process is running */
-    hostname: string;
-    protected: boolean;
-    /** How this process was spawned: 'fork' (child_process.fork), 'spawn' (child_process.spawn), 'main' (the main WrongStack process itself) */
-    spawnMode: 'fork' | 'spawn' | 'main';
-    /** Parent PID if spawned via fork/spawn */
-    parentPid?: number;
-    /** OS platform where this entry was created */
-    platform: string;
-}
-interface PersistentRegistryData {
-    version: 1;
-    instances: Map<string, PersistentProcessEntry>;
-    protectedPatterns: string[];
-    lastCleanup: number;
-}
-/**
- * PersistentProcessRegistry wraps the in-memory ProcessRegistryImpl and
- * synchronizes entries to a filesystem-backed store for cross-instance coordination.
- */
-declare class PersistentProcessRegistry {
-    private readonly instanceId;
-    private readonly registryPath;
-    private readonly lockPath;
-    private readonly baseRegistry;
-    private heartbeatInterval;
-    private isShuttingDown;
-    constructor(baseRegistry?: ProcessRegistryImpl);
-    private ensureDirectory;
-    /**
-     * Start the heartbeat and periodic cleanup tasks.
-     */
-    start(): void;
-    /**
-     * Stop the heartbeat and clean up.
-     */
-    stop(): void;
-    /**
-     * Register the main WrongStack process as protected.
-     */
-    registerMainProcess(): void;
-    /**
-     * Register a spawned child process with the persistent registry.
-     */
-    registerChildProcess(pid: number, name: string, command: string, sessionId?: string, spawnMode?: 'spawn' | 'fork'): void;
-    /**
-     * Update or add an entry in the persistent registry.
-     */
-    private updatePersistentEntry;
-    /**
-     * Unregister a process from the persistent registry.
-     */
-    unregister(pid: number): Promise<void>;
-    /**
-     * Send heartbeat to mark all this instance's processes as alive.
-     */
-    private heartbeat;
-    /**
-     * Sync this instance's processes to the persistent registry.
-     */
-    private syncToPersistent;
-    /**
-     * Remove entries for processes that are no longer running.
-     */
-    private cleanupStaleEntries;
-    /**
-     * Check if a PID belongs to a WrongStack process and should be protected.
-     */
-    isProtectedPid(pid: number): Promise<boolean>;
-    /**
-     * Get all protected PIDs from all WrongStack instances.
-     */
-    getAllProtectedPids(): Promise<number[]>;
-    /**
-     * Get complete status of all tracked processes across all instances.
-     */
-    getGlobalStatus(): Promise<{
-        instances: Map<string, PersistentProcessEntry[]>;
-        totalProcesses: number;
-        protectedCount: number;
-        staleCount: number;
-    }>;
-    /**
-     * Get the instance ID for this process.
-     */
-    getInstanceId(): string;
-    /**
-     * Check if a kill command should be blocked.
-     * Returns true if the kill should be blocked (target is a WrongStack process).
-     */
-    shouldBlockKill(pid: number): Promise<boolean>;
-    /**
-     * Add a pattern-based protection rule.
-     * Processes whose command matches any protected pattern are protected.
-     */
-    addProtectedPattern(pattern: string): Promise<void>;
-}
-declare function getPersistentProcessRegistry(): PersistentProcessRegistry;
-declare function resetPersistentProcessRegistry(): void;
-
-/**
- * Global Process Registry - Cross-Instance Process Tracking
- *
- * Provides functionality to list all WrongStack instances running on the system,
- * track their processes, and display detailed status information.
- */
-
-/**
- * Represents a WrongStack instance's aggregated information.
- */
-interface InstanceInfo {
-    instanceId: string;
-    hostname: string;
-    mainPid: number;
-    startedAt: number;
-    lastActivity: number;
-    status: 'active' | 'idle' | 'stale';
-    processCount: number;
-    processes: PersistentProcessEntry[];
-    sessionIds: Set<string>;
-}
-/**
- * Counts of instances by status.
- */
-interface InstanceCounts {
-    total: number;
-    active: number;
-    idle: number;
-    stale: number;
-    byHostname: Map<string, number>;
-}
-/**
- * Global process status encompassing all instances.
- */
-interface GlobalProcessStatus {
-    localInstance: {
-        instanceId: string;
-        mainPid: number;
-        protectedCount: number;
-        platform: string;
-        hostname: string;
-        uptime: number;
-    };
-    allInstances: Array<{
-        instanceId: string;
-        hostname: string;
-        mainPid: number;
-        processes: PersistentProcessEntry[];
-        startedAt: number;
-        lastActivity: number;
-    }>;
-    summary: {
-        totalProcesses: number;
-        protectedCount: number;
-        staleCount: number;
-        instanceCount: number;
-        activeInstanceCount: number;
-    };
-    timestamp: number;
-}
-/**
- * Options for filtering instance listings.
- */
-interface InstanceListOptions {
-    /** Include stale instances in the list */
-    includeStale?: boolean;
-    /** Filter by hostname pattern (supports glob patterns) */
-    hostname?: string;
-    /** Filter by instance status */
-    status?: 'active' | 'idle' | 'stale' | 'all';
-}
-/**
- * Get list of all known instances (from persistent registry).
- */
-declare function listInstances(options?: InstanceListOptions): Promise<InstanceInfo[]>;
-/**
- * Get counts of instances by status.
- */
-declare function getInstanceCount(): Promise<InstanceCounts>;
-/**
- * Format the global status as a human-readable string for display.
- */
-declare function formatGlobalStatus(): Promise<string>;
-/**
- * Format a clean instance list suitable for display.
- */
-declare function formatInstanceList(options?: InstanceListOptions): Promise<string>;
-/**
- * Format instance details as a compact summary string.
- */
-declare function formatInstanceSummary(): Promise<string>;
-/**
- * Create the global /ps slash command.
- */
-declare function createGlobalPsSlashCommand(): {
-    name: "ps";
-    description: string;
-    handler(input: string): Promise<{
-        message: string;
-    }>;
-};
-
-interface SkillToolInput {
-    name: string;
-    /** Optional relative path of a bundled resource to load (e.g. `references/REF.md`, `scripts/extract.py`, `assets/template.html`). Omit to list resources. */
-    resource?: string | undefined;
-}
-interface SkillResource {
-    /** Path relative to the skill directory (e.g. `scripts/extract.py`). */
-    path: string;
-    bytes: number;
-}
-interface LoadedResource {
-    rel: string;
-    absPath: string;
-    content: string;
-    bytes: number;
-    truncated: boolean;
-}
-interface SkillToolOutput {
-    name: string;
-    description: string;
-    /** Frontmatter-stripped SKILL.md body (capped). */
-    body: string;
-    /** All bundled resource files (recursive), when no specific resource was requested. */
-    resources: SkillResource[];
-    /** Absolute directory of the skill — run scripts via bash using paths under here. */
-    dir: string;
-    /** When `resource` was requested: the loaded file. */
-    loadedResource?: LoadedResource | undefined;
-}
-/**
- * Skill tool — the agentskills.io progressive-disclosure primitive.
- *
- * - `skill({ name })` → SKILL.md body + a recursive listing of every bundled
- *   resource file (scripts/ references/ assets/ templates/ … any subdir).
- * - `skill({ name, resource })` → the content of that one resource file.
- *
- * Use this (not the `read` tool) to load skill resources: it works for foreign
- * skills that live outside the project root (e.g. `~/.claude/skills/…`), which
- * a project-root-restricted `read` tool may refuse. Scripts are returned with
- * their absolute path so the agent can run them via `bash`.
- */
-declare function makeSkillTool(skillLoader: SkillLoader): Tool<SkillToolInput, SkillToolOutput>;
-
-/**
- * Shared tool icon mapping for all WrongStack UIs (WebUI, TUI, REPL).
- *
- * Each UI renders icons using its own library:
- * - WebUI: lucide-react
- * - TUI: ink icons or text characters
- * - REPL: unicode characters or ASCII art
- *
- * This module exports the canonical tool → icon-name mapping.
- * Add new tools here, never hardcode icon names in UI components.
- */
-/**
- * Icon identifiers — each UI maps these to its own icon library.
- * Using a common set of identifiers ensures consistency across all surfaces.
- */
-type ToolIconId = 'file' | 'edit' | 'search' | 'folder' | 'terminal' | 'web' | 'git' | 'tree' | 'code' | 'test' | 'package' | 'document' | 'scaffold' | 'todo' | 'plan' | 'task' | 'meta' | 'index' | 'json' | 'diff' | 'logs' | 'settings' | 'brain' | 'fallback';
-/**
- * Canonical mapping of WrongStack tool names to icon identifiers.
- * Coverage: all 37 built-in tools + common aliases.
- */
-declare const TOOL_ICON_MAP: Record<string, ToolIconId>;
-/**
- * Get the icon identifier for a tool name.
- * Returns 'fallback' for unknown tools.
- */
-declare function getToolIcon(toolName: string): ToolIconId;
-/**
- * Icon configuration including color for rendering.
- */
-interface ToolIconConfig {
-    icon: ToolIconId;
-    /** CSS color string, e.g. '#6366f1' or 'var(--tool-file)' */
-    color: string;
-}
-/**
- * Icon configurations — icon id -> { icon, color }.
- * Each UI applies its own icon library (lucide-react, ink, unicode, etc.)
- * but uses these canonical color values.
- */
-declare const TOOL_ICON_CONFIG: Record<ToolIconId, ToolIconConfig>;
-/**
- * Default fallback icon for unknown tools.
- */
-declare const FALLBACK_ICON: ToolIconId;
-
-export { type BashShell, type EnsureSessionShellOptions, FALLBACK_ICON, type GlobalProcessStatus, type InstanceInfo, type InstanceListOptions, type PersistentProcessEntry, type PersistentRegistryData, type ProcessGuardianConfig, ProcessRegistryImpl, type ResolveSessionShellDeps, TOOL_ICON_CONFIG, TOOL_ICON_MAP, type ToolIconConfig, type ToolIconId, createGlobalPsSlashCommand, designTool, ensureSessionShell, formatGlobalStatus, formatInstanceList, formatInstanceSummary, getInstanceCount, getPersistentProcessRegistry, getProcessGuardian, getToolIcon, kanbanTool, listInstances, makeSkillTool, normalizeShell, planTool, resetPersistentProcessRegistry, resolveSessionShell, startProcessGuardian, stopProcessGuardian };
+//# sourceMappingURL=index.d.ts.map