@lmctl-ai/lmctl 0.2.37 → 0.2.39

package/dist/cli/managed.d.ts

@@ -1,62 +0,0 @@
-/**
- * P3 (briefs/lmctl0-verbs-native-port-design.md §2.4 / §2.5) — managed
- * mode shared helpers. Consumed by terminal/chat/tail/info/ls when the
- * P0 classifier returns `{mode:'managed'}`. The §2.4 precedence is
- * kind-keyed (verbatim from the design):
- *
- *   • workflow_escalation     → attention payload is context-only; resolve
- *                              the agent via the latest `agent_call`
- *                              session_event for the RUN (never via
- *                              interactive_session; never via a
- *                              payload.step_id == session_event.step_id
- *                              join — see Dal.latestAgentCall doc-comment).
- *   • interactive_waiting_op  → interactive_session is authoritative for
- *                              the paused step + resumeInteractive.
- *                              Agent identity still via latestAgentCall.
- *   • running (no attention)  → latestAgentCall only.
- *   • none resolves           → clear error (no DAL write).
- *
- * All helpers are read-only; spawn nothing. They take `Dal` so callers
- * can inject a memory DAL in tests.
- */
-import type { Dal } from '../db/index.js';
-export interface ManagedAgent {
-    /** Resolved provider for the agent session. */
-    provider: string;
-    /** Native session id (the provider's id). */
-    sessionid: string;
-    /** Working directory for the provider TUI. */
-    sessiondir: string;
-    /** Team-member alias the run's latest agent_call drove. */
-    alias: string;
-    /** Optional model override. */
-    model?: string;
-}
-/**
- * Resolve a run-id to its agent provider session (§2.4 precedence). Uses
- * `Dal.latestAgentCall` — RUN-keyed, ORDER BY id DESC — and falls back to
- * the single-member team rule (§2.5) when no agent_call has been written
- * yet. NEVER joins `session_event` by `payload.step_id`, NEVER consults
- * `interactive_session`.
- *
- * `aliasOverride` (optional) — if provided, looks up that specific member
- * (skipping latestAgentCall). Used by callers that surface `--alias A`
- * alongside `--run <id>` per the §3 grammar / §2.5 disambiguation.
- *
- * Returns `{ok:<ManagedAgent>}` on success or `{err:<message>}` on any
- * resolution failure (caller surfaces as a clear user-error).
- */
-export declare function resolveManagedAgent(dal: Dal, run_id: number, aliasOverride?: string): {
-    ok: ManagedAgent;
-} | {
-    err: string;
-};
-/**
- * Find the run's pending operator-answerable attention (if any).
- * Returns the unacked `requires_user=1` attention row's `{kind, attention_id}`
- * or null. Read-only.
- */
-export declare function pendingOperatorAttention(dal: Dal, run_id: number): {
-    kind: string;
-    attention_id: number;
-} | null;

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;