@lmctl-ai/lmctl 0.2.38 → 0.2.40

package/dist/cli/mcp-install.d.ts

@@ -1,23 +0,0 @@
-import type { CliIo } from './common.js';
-import type { TeamConfig } from '../providers/config/team-config.js';
-interface McpInstallFileOps {
-    existsSync(path: string): boolean;
-    mkdirSync(path: string, opts: {
-        recursive: true;
-    }): unknown;
-    readFileSync(path: string, encoding: 'utf8'): string;
-    writeFileSync(path: string, data: string, encoding: 'utf8'): unknown;
-    renameSync(oldPath: string, newPath: string): unknown;
-    unlinkSync(path: string): unknown;
-}
-export type CopilotMcpServerConfig = Record<string, unknown>;
-export declare function _setMcpInstallTestHooksForTests(input: {
-    homeDir?: string;
-    fileOps?: Partial<McpInstallFileOps>;
-} | null): void;
-export declare function cleanupStaleMcpForTeam(io: CliIo, config: TeamConfig, teamfilePath: string): void;
-export declare function copilotMcpConfigPath(homeDir?: string): string;
-export declare function mergeCopilotMcpServers(path: string, desiredServers: Record<string, CopilotMcpServerConfig>): {
-    changed: boolean;
-};
-export {};

package/dist/cli/mcp.d.ts

@@ -1,2 +0,0 @@
-import type { CliIo } from './common.js';
-export declare function runMcp(args: string[], io?: CliIo, stdin?: NodeJS.ReadableStream): Promise<number>;

package/dist/cli/model.d.ts

@@ -1,21 +0,0 @@
-import { type CliIo } from './common.js';
-import { type CatalogSnapshot } from '../providers/pricing.js';
-export declare const MODEL_PROVIDERS: readonly ["codex", "agy", "claude", "kimi"];
-type ModelProvider = string;
-interface ModelList {
-    available: boolean;
-    models: string[];
-    reason?: string;
-}
-interface ModelDeps {
-    loadSnapshot?: () => Promise<CatalogSnapshot>;
-    selections?: Array<{
-        provider: string;
-        models?: string[];
-    }>;
-    loadModels?: (provider: ModelProvider, snapshot: CatalogSnapshot) => ModelList | Promise<ModelList>;
-}
-/** Shared inventory for deterministic target matching; never sends a prompt. */
-export declare function knownModelNames(provider: string): Promise<string[]>;
-export declare function runModel(args: string[], io: CliIo, deps?: ModelDeps): Promise<number>;
-export {};

package/dist/cli/paths.d.ts

@@ -1,50 +0,0 @@
-/**
- * ~/.lmctl root directory (or override via `LMCTL_HOME`).
- *
- * `LMCTL_HOME` is the absolute path TO `.lmctl` (i.e. the directory that
- * contains `state.db`) — not the parent. Used by tests to redirect the entire
- * state tree.
- *
- * Without an override we use `os.homedir()` + `.lmctl`. Note: on POSIX, libuv
- * resolves `homedir` from /etc/passwd rather than `$HOME`, which is why we
- * expose a dedicated env override instead of relying on `$HOME` for test
- * isolation.
- */
-export declare function lmctlNextHome(): string;
-/** The default DB path: ~/.lmctl/state.db (under `LMCTL_HOME`). */
-export declare function defaultDbPath(): string;
-/**
- * Single source of truth for the state.db path.
- *
- * Priority order (highest first):
- *   1. dbFlag arg (passed via top-level `--db PATH` flag)
- *   2. process.env.LMCTL_DB
- *   3. ~/.lmctl/state.db (under `LMCTL_HOME`)
- *
- * Parent directories are created on first DB open by migrate().
- */
-export declare function resolveDbPath(dbFlag?: string): string;
-/**
- * One-line human rendering of the resolved state location, shared by
- * `lmctl status`'s footer and the stale-SELF-marker error so both name the DB
- * the same way. When the path came from an explicit `--db`/`LMCTL_DB` override,
- * the label says so.
- */
-export declare function describeStateLocation(dbPath: string): string;
-/**
- * Detect whether `dbPath` lives on a WSL `/mnt/c` Windows-mounted volume.
- * WSL Windows-mount IO is ~5-10x slower than the native ext4 home volume,
- * which surfaces as flaky locks + slow migrations. We emit a one-line
- * stderr hint at startup so operators can move the DB if they hit it.
- *
- * Exposed for tests; production callers should use `warnIfSlowDbPath`.
- */
-export declare function isSlowWslMount(dbPath: string, plat?: NodeJS.Platform): boolean;
-/**
- * Print a one-line stderr warning if `dbPath` is on `/mnt/c`. No-op on
- * non-Linux platforms and on non-`/mnt/c` paths. Idempotent — safe to call
- * once at startup.
- */
-export declare function warnIfSlowDbPath(dbPath: string, stderr?: {
-    write: (chunk: string) => unknown;
-}, plat?: NodeJS.Platform): void;

package/dist/cli/plan-wizard.d.ts

@@ -1,42 +0,0 @@
-/**
- * Interactive fallback for `lmctl plan`: a plain node:readline wizard (no new
- * dependencies). Every question here has a flag equivalent on `runPlan`; this
- * module only runs when config flags are absent and stdin is a TTY (or
- * `--wizard` forced it). It returns the final teamfile text plus where to
- * write it — plan.ts owns the actual write/lint/seed pipeline so the flags
- * path and the wizard path behave identically after this point.
- */
-import { loadModelSuggestions } from '../providers/model-suggestions.js';
-import type { CliIo } from './common.js';
-import { type MemberSpec } from './teamfile-template.js';
-export interface PlanWizardInitial {
-    provider?: string;
-    model?: string;
-    pattern?: string;
-    members?: MemberSpec[];
-    seed?: boolean;
-    /** Explicit --output destination; skips the directory/name questions. */
-    output?: string;
-}
-export interface PlanWizardResult {
-    destPath: string;
-    text: string;
-    seed: boolean;
-}
-export interface PlanWizardOptions {
-    io: CliIo;
-    /** Line source for readline — real stdin in the CLI, a scripted stream in tests. */
-    input: NodeJS.ReadableStream;
-    cwd: string;
-    /** Preselected directory (positional arg); defaults to cwd. */
-    directory?: string;
-    initial?: PlanWizardInitial;
-    initConfigPath?: string;
-    loadModels?: typeof loadModelSuggestions;
-    /** Test seam — defaults to spawning $EDITOR synchronously on the temp file. */
-    editFile?: (path: string) => void;
-    env?: NodeJS.ProcessEnv;
-}
-export declare function runPlanWizard(opts: PlanWizardOptions): Promise<PlanWizardResult | null>;
-/** Members for reporting after a wizard run — re-parse so `$EDITOR` changes are reflected. */
-export declare function wizardMembers(text: string): MemberSpec[];

package/dist/cli/plan.d.ts

@@ -1,20 +0,0 @@
-import type { loadModelSuggestions } from '../providers/model-suggestions.js';
-import type { CliIo } from './common.js';
-/** Test seams — fetch for --from URLs, model suggestions + editor for the wizard. */
-export interface PlanDeps {
-    fetchFn?: typeof fetch;
-    loadModels?: typeof loadModelSuggestions;
-    editFile?: (path: string) => void;
-    /** Overrides stdin TTY detection (wizard auto-trigger). */
-    stdinIsTTY?: boolean;
-    /** Test seam: defaults to ~/.lmctl/init.toml (getDefaultInitConfigPath()). */
-    initConfigPath?: string;
-}
-export declare function runPlan(args: string[], io?: CliIo, deps?: PlanDeps): Promise<number>;
-/** Reads a `--from`-style source: a local file, a directory holding exactly
- * one .lmctl file, or an https:// URL (https-only, redirect-pinned).
- * Exported for reuse by quickrun/hello, which fetch the same kinds of
- * sources (a teamfile template, or a per-provider example) via the same
- * rules -- no local http://, https-only redirects, one candidate file per
- * directory. */
-export declare function readPlanSource(source: string, fetchFn: typeof fetch, cwd: string): Promise<string>;

package/dist/cli/queue-delivery.d.ts

@@ -1,122 +0,0 @@
-import { chat as libraryChat, type ProgressEvent } from '../providers/index.js';
-import type { BundleSession } from '../providers/bundle.js';
-import type { CliIo } from './common.js';
-import type { PermissionMode } from '../providers/yolo-contract.js';
-/**
- * Hold-open predicate for the receiver's provider turn
- * (BUG-chat-client-death-interrupts-receiver-live-session).
- *
- * The stream-json transport closes the provider child's stdin on the first
- * result event, which makes headless claude exit immediately — orphaning any
- * `run_in_background` dispatches the receiver fired during its turn. The
- * durable "this session still has outstanding dispatched work" signal is an
- * `agent_inflight` row whose SENDER is the receiver's own identity, held by
- * a live pid: every `lmctl prompt` the receiver dispatched acquires exactly
- * such a lease (its sender attribution comes from LMCTL_SELF_SESSIONID in
- * the provider spawn env) and releases it when the dispatched turn
- * finalizes.
- *
- * Predicate scope, deliberately narrow:
- *   - DIRECT children only (rows where sender = the session being run),
- *     never the transitive subtree. This is sufficient by recursion, not an
- *     approximation (operator-confirmed 2026-07-26): a direct child that
- *     dispatched further work applies this same holdOpen check before ITS
- *     stdin closes, so it holds its own lease — the one we watch — until
- *     its children are done. The same fix at every level yields full
- *     subtree coverage through one-hop checks; walking deeper would be
- *     redundant, not more correct.
- *   - live local pid required (`isProcessAlive`): dead-pid and null-pid rows
- *     are orphans for the reclaim machinery, not outstanding work — waiting
- *     on a corpse would hold the turn open for nothing. agent_inflight has
- *     no host column; like the busy check, liveness is judged against the
- *     local host (pre-existing remote-holder ambiguity, unchanged here).
- *   - the lease for THIS delivery (receiver == the session being run) is
- *     excluded — without that guard a self-addressed chat would wait on its
- *     own lease until max-hold.
- *
- * Bounding (the "stuck row" question): the real bound is per-poll liveness —
- * a holder that dies or gets reclaimed drops out on the next poll. maxHoldMs
- * (= the agent_inflight TTL, 8h default) is last-resort insurance against a
- * live-but-wedged holder; anything SHORTER would re-introduce the original
- * bug by killing legitimately long dispatched work, and the adapter's idle
- * timer (same 8h default, resolves 'stalled') backstops independently.
- */
-export declare function buildDispatchHoldOpen(io: CliIo, receiver: LaneIdentity, env: NodeJS.ProcessEnv): NonNullable<Parameters<typeof libraryChat>[0]['holdOpen']>;
-export interface LaneIdentity {
-    teamfile: string;
-    alias: string;
-}
-export interface LaneDeliveryTarget extends LaneIdentity {
-    provider: string;
-    sessionId: string;
-    cwd: string;
-    model?: string;
-    effort?: string;
-    isLead?: boolean;
-}
-export interface DeliverLaneInput {
-    sender: LaneIdentity;
-    receiver: LaneDeliveryTarget;
-    newMessage: string;
-    newMessageFrom?: string;
-    io: CliIo;
-    permissionMode: PermissionMode;
-    env: NodeJS.ProcessEnv;
-    idleTimeoutMs?: number;
-    /** Multi-turn callers must never fall back to a fresh provider session. */
-    requireResume?: boolean;
-    /**
-     * Caller-held bundle provider session (batch bundle mode): the turn
-     * goes through the already-open provider process. When set, the
-     * `holdOpen` below is still built but ignored by the transport — the
-     * bundle's persistence IS the hold, and its close() runs the check once.
-     */
-    bundleSession?: BundleSession;
-    onDelta?: (chunk: string) => void;
-    onProgress?: (event: ProgressEvent) => void;
-    onPromptBuilt?: (prompt: string) => void | Promise<void>;
-}
-export type DeliverLaneResult = {
-    status: 'ok';
-    receipt: string;
-    prompt: string;
-    wroteDelta: boolean;
-    durationMs?: number;
-    /** Task #232: human-readable strings when the provider silently
-     * dropped a declared model=/effort=. Omitted when nothing was dropped. */
-    warnings?: string[];
-} | {
-    status: 'stalled';
-    receipt: string;
-    prompt: string;
-    wroteDelta: boolean;
-    durationMs?: number;
-    stalledAfterMs?: number;
-    warnings?: string[];
-} | {
-    /**
-     * Real incident, 2026-09-29: kimi's ACP layer reported a clean
-     * completion (no RPC error) with zero text and zero observed
-     * activity for a turn that in fact hit a 403 quota-exhausted
-     * failure -- "status=ok" is not allowed to mean this. ACP
-     * transports only (see transport-wrappers.ts's emptyTurnStatus);
-     * never set for stream-json/codex-app-server providers.
-     */
-    status: 'empty';
-    receipt: string;
-    prompt: string;
-    wroteDelta: boolean;
-    durationMs?: number;
-    warnings?: string[];
-} | {
-    status: 'error';
-    receipt: string;
-    prompt: string;
-    wroteDelta: boolean;
-    durationMs?: number;
-    error: string;
-};
-export declare function deliverLane(input: DeliverLaneInput): Promise<DeliverLaneResult>;
-export declare function renderQueuedChatPrompt(newPrompt: string, options?: {
-    newMessageFrom?: string;
-}): string;

package/dist/cli/quickrun.d.ts

@@ -1,14 +0,0 @@
-import { type CliIo } from './common.js';
-import { runTerminal } from './terminal.js';
-import { runScriptEngine } from '../script/adapter.js';
-export interface QuickrunDeps {
-    fetchFn?: typeof fetch;
-    cwd?: string;
-    /** Test seam: defaults to ~/.lmctl/init.toml (getDefaultInitConfigPath()). */
-    initConfigPath?: string;
-    /** Test seam: defaults to the real runTerminal (a live provider TUI). */
-    openTerminal?: typeof runTerminal;
-    runScript?: typeof runScriptEngine;
-}
-/** Names resolve dynamically; the CLI has no compiled-in sample allowlist. */
-export declare function runQuickrun(args: string[], io?: CliIo, deps?: QuickrunDeps): Promise<number>;

package/dist/cli/ratelimit.d.ts

@@ -1,2 +0,0 @@
-import { type CliIo } from './common.js';
-export declare function runRatelimit(args: string[], io: CliIo): Promise<number>;

package/dist/cli/remote-fetch.d.ts

@@ -1,7 +0,0 @@
-export declare function isHttpsUrl(value: string): boolean;
-export declare function isUrlLike(value: string): boolean;
-export declare function httpsOnlyError(value: string, noun: string): string | null;
-export declare function fetchHttpsBytes(url: string, options: {
-    description: string;
-    timeoutMs?: number;
-}): Promise<Buffer>;

package/dist/cli/run-queries.d.ts

@@ -1,82 +0,0 @@
-/**
- * DAL-pure run/attention/escalation read queries shared by the surviving
- * stateless commands (`prompt --run`, `ls --runs`, the MCP mediation core).
- *
- * Relocated verbatim from src/serve/data.ts when the daemon/HTTP surface
- * (`serve`/`api`) moved to lmbee — these helpers import only db types and
- * perform no I/O beyond `dal.query`.
- */
-import type { AttentionRow, Dal, RunRow } from '../db/index.js';
-export declare function listRuns(dal: Dal, opts?: {
-    limit?: number;
-}): RunRow[];
-export declare function listAttentions(dal: Dal, opts?: {
-    unacked?: boolean;
-}): AttentionRow[];
-export interface EscalationRow {
-    attention_id: number;
-    /**
-     * Discriminator for the operator response contract. Interactive rows resume
-     * an `interactive_session`; workflow escalations are session-free DEF-1
-     * decisions and accept only a declared outcome token or `@abort`.
-     */
-    kind: string;
-    /**
-     * Attention severity tier. Historical attention values were error/warn/info-ish.
-     *
-     * project_issue #37 item 5: `"attn"` is the value used for the new
-     * `interactive_waiting_operator` (operator-pause) escalations. It is an
-     * intentional new tier — these are NOT errors and NOT warnings; they are
-     * operator-attention requests with no provenance baggage. UI/tooling that
-     * filters or color-codes by severity should branch on "attn" alongside the
-     * pre-existing error/warn/info-ish values.
-     */
-    severity: string | null;
-    created_at: string;
-    project_id: number | null;
-    project: string | null;
-    run_id: number | null;
-    workflow_name: string | null;
-    step_id: number | null;
-    state_name: string | null;
-    prompt: string | null;
-    /** Most recent interactive_session row status; null when no session linked. */
-    session_status: string | null;
-    /**
-     * ISO timestamp when the attention was acknowledged; null when still pending.
-     * Surfaced so operators using `escalations list --all` can distinguish acked
-     * from unacked history.  project_issue #45.
-     */
-    acknowledged_at: string | null;
-    node_path: string[] | null;
-    expected_response: {
-        kind: string;
-        choices: string[] | null;
-    } | null;
-    transcript_tail: string[] | null;
-    paused_at: string | null;
-    created_run_inputs: Record<string, unknown> | null;
-    workflow_version_id: number | null;
-    /**
-     * Session-free workflow-escalation context copied from attention.payload.
-     * `workflow_escalation` has no interactive_session row, so the JOIN columns
-     * above are intentionally null for prompt/step details; SDKs and CLI clients
-     * must use these nullable fields to render the human prompt.
-     */
-    workflow_step: {
-        id: string;
-        name: string | null;
-        type: string | null;
-    } | null;
-    escalation_tier: string | null;
-    escalation_token: string | null;
-    escalation_reason: string | null;
-    declared_outcomes: string[] | null;
-    agent_output: string | null;
-}
-export declare function listEscalations(dal: Dal, opts?: {
-    project?: string;
-    all?: boolean;
-    since?: string;
-}): EscalationRow[];
-export declare function getEscalation(dal: Dal, attention_id: number): EscalationRow | null;

package/dist/cli/running.d.ts

@@ -1,5 +0,0 @@
-import { type CliIo } from './common.js';
-/** Test-only seam: cap the number of `--watch` ticks so tests can exercise
- *  the loop without hanging on the SIGINT/SIGTERM shutdown. */
-export declare function _setRunningWatchMaxTicksForTests(maxTicks: number | null): void;
-export declare function runRunning(args: string[], io: CliIo): Promise<number>;

package/dist/cli/save-script.d.ts

@@ -1,41 +0,0 @@
-import type { CliIo } from './common.js';
-export interface SaveScriptRequest {
-    destPath: string;
-    /** Resolved script name, e.g. "plan" (default) or "plan-minimal" (--script). */
-    slug: string;
-    /** File extension lmctl.com serves for this command's family, e.g. ".lms" or ".txt". */
-    extension: string;
-    force: boolean;
-}
-export interface ExtractSaveScriptResult {
-    rest: string[];
-    request?: SaveScriptRequest;
-    error?: string;
-}
-/**
- * Strips --save-script <file>, --script <slug>, and (unless the command
- * already owns --force itself, e.g. `plan`) a bare --force from args.
- * --script only makes sense paired with --save-script.
- */
-export declare function extractSaveScriptFlags(args: string[], command: string, opts?: {
-    ownsForce?: boolean;
-    extension?: string;
-}): ExtractSaveScriptResult;
-/**
- * Fetches https://lmctl.com/lmscript/commands/<slug><extension> and writes
- * it to request.destPath. Verifies the full response BEFORE writing
- * anything -- a failed fetch, a 404, or an HTML page (offline/misconfigured
- * host fallback) never reaches the destination file, half-written or
- * otherwise.
- */
-export declare function performSaveScript(io: CliIo, request: SaveScriptRequest, fetchFn?: typeof fetch): Promise<number>;
-/**
- * Wraps a command's own run function with --save-script handling: strips
- * the flags, runs the command UNCHANGED with the remaining args, and -- only
- * if the command itself succeeded -- fetches and writes the script as an
- * additive side effect. A failed command is left alone; nothing is fetched.
- */
-export declare function runWithSaveScript(io: CliIo, command: string, args: string[], runCommand: (rest: string[]) => Promise<number>, opts?: {
-    ownsForce?: boolean;
-    extension?: string;
-}): Promise<number>;

package/dist/cli/script.d.ts

@@ -1,6 +0,0 @@
-import { type CliIo } from './common.js';
-import { type FunctionDoc, type LMScript, type ScriptModule } from '../script/adapter.js';
-export declare function formatFunctionDoc(doc: FunctionDoc): string;
-export declare function formatModuleOverview(engine: LMScript, module: ScriptModule): string;
-export declare function formatCategoryOverview(engine: LMScript): string;
-export declare function runScript(args: string[], io?: CliIo): Promise<number>;

package/dist/cli/seed-flight.d.ts

@@ -1,2 +0,0 @@
-export declare function seedInProgress(teamfile: string, alias: string): boolean;
-export declare function beginSeedFlight(teamfile: string, alias: string): () => void;

package/dist/cli/self-identity.d.ts

@@ -1,25 +0,0 @@
-import type { Dal } from '../db/index.js';
-export type SelfIdentityInference = {
-    ok: true;
-    identity: string;
-} | {
-    ok: false;
-    reason: 'unset' | 'not-found';
-};
-export type ResolvedSelfIdentity = {
-    ok: true;
-    identity: string;
-    source: 'session';
-} | {
-    ok: false;
-    reason: 'unset' | 'not-found';
-};
-export declare function manualInvocationMessage(command: string): string;
-export declare function unmatchedSelfSessionMessage(command: string): string;
-export declare function removedFromOptionMessage(command: string): string;
-export declare function extractSelfIdentityArg(args: string[], command: string): {
-    args: string[];
-    error?: string;
-};
-export declare function resolveSelfIdentity(env: NodeJS.ProcessEnv, dal: Pick<Dal, 'getRootTeam' | 'listRootTeams'>): ResolvedSelfIdentity;
-export declare function inferSelfIdentityFromEnv(env: NodeJS.ProcessEnv, dal: Pick<Dal, 'getRootTeam' | 'listRootTeams'>): SelfIdentityInference;

package/dist/cli/session-idle.d.ts

@@ -1,118 +0,0 @@
-/**
- * Session-idle availability override for delivery decisions.
- *
- * Operator (2026-07-22): *"also check the last update of session (from
- * sessionid), if it is been idle for 10 minute, then it is available (this
- * does not change terminal pid)."*
- *
- * THRESHOLD: 60 minutes, NOT the 10 initially requested. Do not "fix" this
- * back to 10 without re-running the numbers below.
- *
- * A misfire is not benign: the reclaim force-steals a lease from a LIVE holder
- * and starts a second turn on the same sessionid — the concurrent-resume abort
- * `b85c5a1` exists to prevent. So the threshold has to clear real turn
- * durations. Measured over completed chat turns, SPLIT BY OUTCOME — the split
- * is the whole point, an unsplit number is misleading in both directions:
- *
- *   SELECT status, COUNT(*), SUM(CASE WHEN m>60 THEN 1 END), MAX(m)
- *   FROM (SELECT status, (julianday(ended_at)-julianday(started_at))*1440 AS m
- *         FROM tracked_invocation WHERE ended_at IS NOT NULL AND kind='chat')
- *   GROUP BY status;
- *
- *   status='done'   n=2056   >60min: 0     longest: 51.8 min
- *   status='error'  n=1054   >60min: 191   longest: 2709 min (~45h)
- *   status='busy'   n=727    >60min: 0
- *
- * NO SUCCESSFULLY-COMPLETED CHAT TURN HAS EVER EXCEEDED 60 MINUTES. The longest
- * was 51.8 min, so 60min sits ~16% above the worst observed healthy turn. Every
- * one of the 191 turns past 60min ended in `error` — hung, aborted, abandoned:
- * exactly the population this feature exists to reclaim.
- *
- * Beware the unsplit figure: "5.0% of all turns exceed 60min" is arithmetically
- * true and materially misleading, because it counts already-failed turns as if
- * they were healthy ones at risk of a wrongful steal. Exposure among healthy
- * turns is zero in the observed record. (Turn DURATION is also only an upper
- * bound — the trigger needs a >60min GAP BETWEEN WRITES, and a turn making tool
- * calls keeps `modifiedAt` fresh.) 60min also still beats the 8h inflight TTL
- * by ~8x, which is the actual complaint being solved.
- *
- * Re-run the query rather than trusting these figures; if you retune, split by
- * status or the number will mislead you.
- * See `backlog/DESIGN-session-idle-availability-scope.md`.
- *
- * THE PROBLEM. An `in-flight` lease taken by `lmctl prompt`/relay delivery keeps
- * a receiver unreachable until the holder releases it or the 8h TTL expires.
- * A hung turn therefore blocks that receiver for hours. Holder-pid liveness
- * alone cannot detect this: the process is alive, it is just not progressing.
- *
- * THE SIGNAL. `SessionDetail.modifiedAt` — the provider's own session file
- * mtime, i.e. real conversation activity. Deliberately NOT the chat/terminal
- * heartbeat (`tracked_invocation.last_heartbeat_at`), which a timer in the
- * holder process refreshes every 30s whether the turn is working OR wedged.
- * The heartbeat distinguishes process-alive (already covered by the pid
- * check), not stuck-vs-working, so it cannot detect a hung turn at all.
- *
- * FAILS CLOSED, ALWAYS. Every failure path returns `false` = "not idle, keep
- * treating as busy". A false "available" lets two deliveries resume the same
- * held session and collide; a false "busy" only means the message waits
- * longer. Those costs are not symmetric, so the ambiguous cases (session not
- * found, ambiguous provider, read error, unresolvable member) all resolve to
- * busy. Same lesson as the reboot/pid-reuse work: never fail open on a
- * liveness question.
- *
- * SCOPE. This is an ADDITIVE override consulted only at the synchronous
- * chat delivery decision point (`chat-exec`) and only for the `in-flight`
- * busy reason. `terminal-held` is NEVER overridden at any idle duration — see
- * `isInflightButSessionIdle` below for why. It does not touch
- * `getReceiverBusyState`, the terminal lock, or any pid.
- */
-import type { Dal } from '../db/index.js';
-/**
- * Threshold override, matching the existing staleness-window convention in
- * this codebase (`LMCTL_INFLIGHT_TTL_MS`, `LMCTL_TERMINAL_LOCK_STALE_MS`):
- * ignore unset/blank/non-finite/non-positive values and fall back to the
- * 60-minute default.
- */
-export declare function sessionIdleTimeoutMsFromEnv(env?: NodeJS.ProcessEnv): number;
-/**
- * Has this receiver's underlying provider session been quiet for at least
- * `thresholdMs`?
- *
- * `true` ONLY when the session was found and its last activity is at or past
- * the threshold. Anything else — including every error — is `false`.
- */
-export declare function isReceiverIdleTimedOut(dal: Pick<Dal, 'getRootTeam' | 'listRootTeams'>, teamfile: string, alias: string, thresholdMs?: number): Promise<boolean>;
-/**
- * How long has this receiver's session been quiet, in ms? `null` when that
- * cannot be established for ANY reason — the fail-closed signal, and also what
- * the reclaim log reports so a steal can be judged after the fact.
- */
-export declare function sessionIdleMs(dal: Pick<Dal, 'getRootTeam' | 'listRootTeams'>, teamfile: string, alias: string): Promise<number | null>;
-/**
- * The delivery-side question, in one call: given the busy state we already
- * computed synchronously, may we deliver anyway because the session is idle?
- *
- * SCOPE — `in-flight` ONLY. Operator (2026-07-22): *"terminal-held is alway
- * regarded as busy, no matter how long idle is. session idle is only for
- * non-terminal session, that is through lmctl prompt."*
- *
- * `terminal-held` is NEVER overridden, at any idle duration. That case is a
- * human's interactive terminal — including a live codex/opencode TUI with a
- * persistent process attached — and declaring it available on a timestamp
- * would reintroduce exactly the concurrent-resume collision `b85c5a1`
- * ("Protect held sessions from stale lease steals") was written to prevent.
- * A quiet terminal is someone thinking, not an absent holder.
- *
- * `in-flight`, by contrast, is a lease taken by `lmctl prompt`/relay delivery:
- * bounded, ephemeral, non-interactive work. A live pid there with no session
- * file activity for the full window is most plausibly a hung turn, so it
- * is a reasonable reclaim target — the same spirit as the existing dead-pid
- * reclaim, adding long-idle-with-live-pid as a second trigger on the
- * chat-invoked path only.
- *
- * See `backlog/DESIGN-session-idle-availability-scope.md`.
- */
-export declare function isInflightButSessionIdle(dal: Pick<Dal, 'getRootTeam' | 'listRootTeams'>, busy: {
-    busy: boolean;
-    reason?: string;
-}, teamfile: string, alias: string, thresholdMs?: number): Promise<boolean>;

package/dist/cli/status.d.ts

@@ -1,22 +0,0 @@
-import { type CliIo } from './common.js';
-/**
- * Path to the rolling intent log written by `status` (and, in future, by
- * other verbs that want a breadcrumb trail). Plain JSONL — one event per
- * line — so a troubleshooting bundle can ship it verbatim. Override via
- * `LMCTL_INTENT_LOG` for tests / non-default homes.
- */
-export declare function resolveIntentLogPath(): string;
-/**
- * Append a single intent record to the rolling log. Failures are
- * swallowed — the log is best-effort breadcrumbs, never load-bearing.
- */
-export declare function appendIntent(record: {
-    verb: string;
-    args: ReadonlyArray<string>;
-    cwd?: string;
-    ts?: string;
-}): void;
-export declare function runStatus(args: string[], io: CliIo): Promise<number>;
-export declare function formatDuration(ms: number): string;
-export declare function formatAge(iso: string): string;
-export declare function shortIdentity(identity: string): string;

package/dist/cli/tail.d.ts

@@ -1,18 +0,0 @@
-import type { ConversationMessage } from '../providers/types.js';
-import { type CliIo } from './common.js';
-export declare function runTail(args: string[], io?: CliIo): Promise<number>;
-/** Plain renderer (no chalk/ANSI per design R3). Indents continuation
- *  lines so multi-line messages remain visually grouped. */
-export declare function renderMessage(msg: ConversationMessage): string;
-export declare function applyMaxBytes(output: string, maxBytes: number): string;
-/**
- * Same grammar as status.ts's parseStatusSince parser: a relative
- * duration (<n>s|m|h|d) or an absolute ISO8601
- * timestamp. Unlike status's version, `undefined` here means "no filter"
- * (tail's existing default is unchanged), not a default window.
- */
-export declare function parseTailSince(value: string | undefined): {
-    date: Date | undefined;
-} | {
-    error: string;
-};