@lmctl-ai/lmctl 0.2.37 → 0.2.39

package/dist/providers/hermes.d.ts

@@ -1,90 +0,0 @@
-/**
- * Hermes Agent ("hermes") session provider.
- *
- * Hermes persists every conversation in ONE SQLite store,
- * `<HERMES_HOME>/state.db` (default `~/.hermes`), whose `sessions` table
- * carries a `source` discriminator (`cli` / gateway platforms / `acp`).
- * The ACP server (`hermes acp`) writes `source='acp'` rows, and its own
- * resume path refuses anything else (`acp_adapter/session.py:341`:
- * `row.get("source") != "acp"` ⇒ no restore). This reader mirrors that
- * contract exactly: ACP-source rows only.
- *
- * Shape facts this reader depends on, each verified against a real store
- * and against `acp_adapter/session.py`:
- *
- *  1. An ACP session only becomes a row once it has history
- *     (`_persist()` returns early on empty history), so a session that
- *     was created but never prompted does not exist for discovery.
- *  2. Assistant rows keep tool calls in a JSON `tool_calls` column
- *     (`[{id, call_id, function:{name, arguments}}]`) while results land
- *     on separate `role='tool'` rows keyed by `tool_call_id`. Emitting
- *     both keeps tool-call/result pairing intact for session inspection.
- *  3. A resume replays the `active = 1` set only
- *     (`get_messages_as_conversation` defaults to `include_inactive=False`),
- *     so the transcript here does too: compaction archives pre-summary
- *     turns and a rewind flags taken-back rows `active = 0`, and neither
- *     belongs in the conversation a resumed member sees.
- *
- * Schema contract: every column both queries name exists in Hermes's real
- * `SCHEMA_SQL` (`hermes_state_common.py`) — asserted against a store a real
- * `SessionDB` produced, not a hand-written fixture
- * (`tests/providers/hermes-real-schema.test.ts`).
- *
- * Token accounting: the `sessions` row carries aggregate counters only
- * (input/output/cache-read/cache-write/reasoning), which is the same
- * "partial" standard as codex/gemini/qwen.
- */
-import type { SessionProvider, SessionSummary, SessionDetail } from "./types.js";
-export interface HermesProviderOptions {
-    /**
-     * Explicit effective HERMES_HOME. Defaults to `$HERMES_HOME`, then
-     * `~/.hermes`. A PROFILE is a different home (`<root>/profiles/<name>`
-     * — see `hermes_constants.get_default_hermes_root`), so a caller
-     * selecting a profile passes that profile's home path here; there is no
-     * separate profile knob and `HERMES_PROFILE` is only the profile's
-     * display NAME, never a path segment.
-     */
-    hermesHome?: string;
-    /** Read-only connection `PRAGMA busy_timeout` in ms. Default 5000. */
-    busyTimeoutMs?: number;
-    /** Max sessions returned by discovery. Default 200. */
-    discoverLimit?: number;
-}
-/**
- * Resolve HERMES_HOME the way `hermes_constants.get_hermes_home()` does:
- * an explicit override, then the `HERMES_HOME` env var, then the platform
- * default `~/.hermes`.
- */
-export declare function resolveHermesHome(opts?: {
-    hermesHome?: string;
-}): string;
-/** `<HERMES_HOME>/state.db` — the one store every Hermes session lives in. */
-export declare function resolveHermesStateDbPath(opts?: HermesProviderOptions): string;
-export declare class HermesProvider implements SessionProvider {
-    readonly name: "hermes";
-    private readonly dbPath;
-    private readonly busyTimeoutMs;
-    private readonly discoverLimit;
-    constructor(opts?: HermesProviderOptions);
-    /** Exposed for diagnostics (`lmctl ls --provider hermes` shows nothing
-     *  when this path does not exist, which is the common first-run state). */
-    get stateDbPath(): string;
-    private openDb;
-    private selectSessionRow;
-    discoverSessions(): Promise<SessionSummary[]>;
-    /**
-     * Read the live (`active = 1`) transcript rows for a session.
-     *
-     * Same set a Hermes resume replays: `active = 0` rows are turns a rewind
-     * took back, and the pre-compaction turns an archive flagged
-     * `active = 0, compacted = 1` were replaced by the summary in the
-     * conversation the member sees. A store old enough to predate the column
-     * has no archived rows either, so the fallback is faithful, not lenient.
-     */
-    private activeMessageRows;
-    /** Read only the preview endpoints, not every transcript body. */
-    private previewTexts;
-    loadSession(sessionId: string): Promise<SessionDetail | null>;
-    resolveSessionPath(sessionId: string): Promise<string | null>;
-    deleteSession(_sessionId: string): Promise<boolean>;
-}

package/dist/providers/index.d.ts

@@ -1,423 +0,0 @@
-/**
- * Public API surface for the lmctl provider library.
- *
- * Phase A0.4 introduces this facade so A1's engine switch (gated by
- * `LMCTL_USE_LIBRARY_PROVIDER=1`) can `import { chat, seed,
- * listSessions, countTokens } from "../providers/index.js"` and rely on
- * a stable surface even as the internal file layout under
- * `src/providers/` evolves.
- *
- * The four exported functions are thin wrappers around the existing
- * adapter / registry plumbing copied in by A0.1. They do not introduce
- * new behavior; if `chat()` rejects, the rejection comes from the
- * underlying transport (claude / codex / gemini), not from this layer.
- *
- * @module providers
- */
-import type { ProgressEvent, TurnOptions } from "./adapter.js";
-import type { ProviderName, SessionSummary, SessionTokenUsage } from "./types.js";
-import { ProviderRegistry } from "./registry.js";
-import type { BundleSession, BundleSessionOpenOptions } from "./bundle.js";
-/**
- * Test-only escape hatch: drop the cached default registry. Calls to
- * `chat()` / `seed()` / `listSessions()` / `countTokens()` made without
- * an explicit `registry:` field will rebuild on next use.
- */
-export declare function _resetDefaultRegistryForTests(): void;
-/**
- * Options for a single chat turn against an existing native provider session.
- */
-export interface ChatOptions {
-    /** Which provider drives the turn. */
-    provider: ProviderName;
-    /** Native session id to resume. */
-    sessionId: string;
-    /** Working directory the provider CLI runs in for this turn. */
-    cwd: string;
-    /** The user prompt sent on this turn. */
-    prompt: string;
-    /** Optional model override; format is provider-specific (e.g. `claude-sonnet-4-6`). */
-    model?: string;
-    /** Optional effort / variant override; used by OpenCode ACP. Kimi has no genuine per-turn effort override, so this is unsupported (and warned on) for kimi members. */
-    effort?: string;
-    /**
-     * Idle timeout in ms. Default: 8 hours. `0` disables the timer; when
-     * the timer fires the turn resolves with `status: "stalled"` rather
-     * than killing the child — see the underlying `TurnResult` doc.
-     */
-    timeoutMs?: number;
-    /** Abort signal for cancellation (caller rejects immediately on abort). */
-    signal?: AbortSignal;
-    /** Streaming delta callback — every text chunk the provider emits. */
-    onDelta?: (text: string) => void;
-    /** Classified progress events (tool_use / tool_result / thinking / …). */
-    onProgress?: (event: ProgressEvent) => void;
-    /** Environment overrides for the spawned provider process. */
-    env?: NodeJS.ProcessEnv;
-    /** Override the spawned provider binary path (troubleshooting dev builds). */
-    progPath?: string;
-    /**
-     * Teamfile alias of the member being spawned.
-     */
-    alias?: string;
-    /** Role-based Lead signal from teamfile resolution. */
-    isLead?: boolean;
-    /**
-     * Defer end-of-turn shutdown while the session still has outstanding
-     * dispatched work of its own. See `TurnOptions.holdOpen`.
-     */
-    holdOpen?: TurnOptions["holdOpen"];
-    /**
-     * Permission mode for the turn — `"yolo"` (default) or `"plan"`.
-     * Plumbed straight through to the adapter's TurnOptions so the
-     * transport rewrites argv / JSON-RPC params per the table in
-     * `src/providers/yolo-contract.ts`. Default `"yolo"` preserves
-     * the historical contract.
-     */
-    permissionMode?: import("./yolo-contract.js").PermissionMode;
-    /**
-     * Fail closed on resume: when `true`, a provider that cannot load the
-     * requested `sessionId` MUST error instead of silently creating a NEW
-     * session. Currently only meaningful for ACP-transport providers
-     * (opencode/kimi/gemini/copilot) — that's the only transport that reads it
-     * (see `acp.ts` `session/load` handling); every other provider silently
-     * IGNORES it (it is a request for stricter behavior a provider MAY not
-     * support, never an error). Omitted/`false` preserves the historical
-     * fallback-with-warning behavior. Batch opts in so successive prompts keep
-     * their conversation; ordinary chat preserves its existing behavior.
-     * Other callers (e.g. a Hermes ACP adapter) may also opt in explicitly.
-     *
-     * Caveat: a member configured with a custom one-shot `agent=` command routes
-     * through `runOneShotAgent`, which bypasses the ACP transport entirely — the
-     * flag has no effect there (consistent with "a provider MAY not support it").
-     */
-    requireResume?: boolean;
-    /**
-     * Caller-held bundle session (batch bundle mode): when set, this
-     * turn goes through the already-open provider process instead of
-     * spawning a new one. Spawn-time options (model, effort, env, holdOpen)
-     * were fixed at open. See src/providers/bundle.ts for the contract.
-     */
-    bundleSession?: import("./bundle.js").BundleSession;
-    /**
-     * Provider-adapter registry. If omitted, a default built from
-     * `createAllAdapters()` is reused across calls. Pass an explicit
-     * registry when you need custom provider home directories
-     * (testing) or a non-default adapter set.
-     */
-    registry?: ProviderRegistry;
-}
-/**
- * Result of a single chat turn.
- *
- * `text` is the final assistant response (with multi-turn aggregation
- * applied for stream-json — see `joinResultTurns`). `status` is `"ok"`
- * on normal completion, or `"stalled"` when the idle timer fired (the
- * child remains alive; caller decides what to do).
- *
- * Per-turn token usage is NOT returned here — providers persist it to
- * their on-disk session files. Read it with `countTokens()` after.
- */
-export interface ChatResult {
-    text: string;
-    sessionId: string;
-    durationMs: number;
-    stopReason?: string;
-    numTurns?: number;
-    status?: "ok" | "stalled" | "empty";
-    stalledAfterMs?: number;
-    /** Human-readable strings when this turn's provider silently dropped a
-     * declared model=/effort= (task #232). Omitted when nothing was dropped. */
-    warnings?: string[];
-}
-/**
- * Run one chat turn against an existing native session.
- *
- * Delegates to `ProviderAdapter.sendTurn` for the named provider.
- *
- * @param opts - chat call options; see {@link ChatOptions}
- * @param opts.provider - which provider adapter drives the turn
- *   (for example `"claude"`, `"codex"`, `"gemini"`, or `"agy"`)
- * @param opts.sessionId - native session id to resume
- * @param opts.cwd - working directory the provider CLI runs in
- * @param opts.prompt - user message sent on this turn
- * @param opts.model - optional provider-specific model override
- * @param opts.timeoutMs - idle timeout in ms (default 8h; 0 disables)
- * @param opts.signal - abort signal; on abort the caller rejects with
- *   `Error("Aborted")` while the child gets a graceful-shutdown ladder
- * @param opts.onDelta - streaming text-chunk callback
- * @param opts.onProgress - classified ProgressEvent callback
- * @param opts.env - environment overrides for the spawned child
- * @param opts.progPath - override the spawned binary path (dev builds)
- * @param opts.alias - teamfile alias of the spawning member
- *   (Lead-only flows gate on case-insensitive `"lead"`)
- * @param opts.registry - DI for the ProviderRegistry; omit to use the
- *   lazily-built default
- * @returns A {@link ChatResult} with the assembled assistant text plus
- *   session bookkeeping (durationMs, stopReason, numTurns, status).
- * @throws `Error` (plain) when `opts.provider` is not registered in
- *   the supplied (or default) registry — message matches
- *   `/not registered/`. {@link TransportConnectionError} if the
- *   provider binary cannot be spawned (ENOENT).
- *   {@link TransportProcessError} if it exits non-zero before a final
- *   result event. {@link TransportJsonError} on malformed wire frames.
- *   {@link TransportRpcError} on JSON-RPC errors from codex / gemini
- *   app-server. `Error("Aborted")` (plain) on `opts.signal` abort.
- * @example
- * ```ts
- * import { chat } from "../providers/index.js";
- *
- * const result = await chat({
- *   provider: "claude",
- *   sessionId: "ses-abc",
- *   cwd: "/repo",
- *   prompt: "summarize the diff",
- *   model: "claude-sonnet-4-6",
- *   onDelta: (chunk) => process.stdout.write(chunk),
- * });
- * console.log(result.text);
- * ```
- */
-export declare function chat(opts: ChatOptions): Promise<ChatResult>;
-/**
- * Options for opening a bundle session — one provider process serving many
- * prompts (batch bundle mode). The lifecycle contract is in
- * `src/providers/bundle.ts`.
- */
-export interface OpenBundleSessionOptions extends BundleSessionOpenOptions {
-    /** Which provider drives the bundle. */
-    provider: ProviderName;
-    /** Adapter registry override. See {@link ChatOptions.registry}. */
-    registry?: ProviderRegistry;
-}
-/**
- * Providers whose adapter implements `openSession` — the bundle-SUPPORTED
- * set for this version (Landing C1: the ACP providers). Distinct from
- * `BUNDLE_CAPABLE_PROVIDERS` in bundle.ts, which is the by-design matrix
- * including the transports a follow-up landing will implement.
- */
-export declare function bundleSupportedProviders(registry?: ProviderRegistry): string[];
-/**
- * Open a bundle session for `opts.provider`. Throws when the provider's
- * adapter has no `openSession` (not bundle-supported in this version).
- */
-export declare function openBundleSession(opts: OpenBundleSessionOptions): Promise<BundleSession>;
-/**
- * Options for bootstrapping a new provider session.
- */
-export interface SeedOptions {
-    /** Provider whose CLI will be spawned to create the session. */
-    provider: ProviderName;
-    /** Working directory where the session-bound subprocess will run. */
-    cwd: string;
-    /** Optional initial-turn model override. */
-    model?: string;
-    /** Optional initial-turn effort / variant override. */
-    effort?: string;
-    /** Optional initial seed prompt; defaults to the standard seed ACK prompt. */
-    prompt?: string;
-    /** Adapter registry override. See {@link ChatOptions.registry}. */
-    registry?: ProviderRegistry;
-}
-/**
- * Result of `seed()`. On success, the on-disk session has been written
- * and is discoverable via `listSessions()`. On failure, `error` carries
- * the human-readable cause; the caller typically falls back to the
- * adapter's `manualSeedHint()`.
- *
- * A0.5 extension (added during A2.1): `sessionId` carries the native
- * session id of the freshly-created session when discovery can match
- * a single new entry against the pre-seed snapshot. Callers that need
- * the id (the engine's `seedMember` does) read it directly; older
- * callers that only checked `success` keep working unchanged.
- *
- * `sessionId` may be omitted (undefined) when:
- *   - `success: false`
- *   - discovery couldn't isolate a single new session (parallel seed
- *     races; corrupt session file; provider that doesn't persist
- *     immediately). Callers must defensively fall back to
- *     `listSessions()` + their own diff logic in that case.
- */
-export interface SeedResult {
-    success: boolean;
-    error?: string;
-    /** Non-fatal provider diagnostics that callers should surface to the operator. */
-    warnings?: string[];
-    /** Native session id of the freshly-created session. See doc above. */
-    sessionId?: string;
-}
-/**
- * Bootstrap a new native session for the given provider in `cwd`.
- *
- * Delegates to `ProviderAdapter.seed`. The provider spawns its own
- * one-shot seed turn (via the SEED_INITIAL_PROMPT shared across
- * adapters) and the session file lands in the provider's home
- * directory. `listSessions()` will then find it.
- *
- * @param opts - seed call options; see {@link SeedOptions}
- * @param opts.provider - provider whose CLI is spawned
- *   (for example `"claude"`, `"codex"`, `"gemini"`, or `"agy"`)
- * @param opts.cwd - working directory the session is bound to
- * @param opts.model - optional initial-turn model override
- * @param opts.registry - DI for the ProviderRegistry; omit to use the
- *   lazily-built default
- * @returns {@link SeedResult} — `{success: true, sessionId?}` on
- *   success (with the new session id when discovery can isolate one),
- *   `{success: false, error}` on failure (error is human-readable
- *   and surfaces the adapter / transport reason).
- * @throws `Error` (plain) when `opts.provider` is not registered in
- *   the supplied (or default) registry — message matches
- *   `/not registered/`. Otherwise the adapter swallows underlying
- *   transport / spawn errors into `SeedResult.error` rather than
- *   rejecting; an unexpected throw indicates a bug at this layer.
- * @example
- * ```ts
- * import { seed } from "../providers/index.js";
- *
- * const { success, error, sessionId } = await seed({
- *   provider: "claude",
- *   cwd: "/repo/teams/backend",
- * });
- * if (!success) throw new Error(`seed failed: ${error}`);
- * await persist(sessionId);  // engine writes the new id to teamfile
- * ```
- */
-export declare function seed(opts: SeedOptions): Promise<SeedResult>;
-/**
- * Options for enumerating on-disk provider sessions.
- */
-export interface ListSessionsOptions {
-    /** Restrict to one provider. Omit to list across all registered providers. */
-    provider?: ProviderName;
-    /** Filter by canonical workspace path (matches `SessionSummary.cwd`). */
-    workspace?: string;
-    /** Cap the result count after sorting by `modifiedAt` descending. */
-    limit?: number;
-    /** Only sessions modified at-or-after this date. */
-    from?: Date;
-    /** Only sessions modified at-or-before this date. */
-    to?: Date;
-    /** Adapter registry override. See {@link ChatOptions.registry}. */
-    registry?: ProviderRegistry;
-}
-/**
- * Enumerate native provider sessions on disk.
- *
- * Walks the registered providers' session directories
- * (`~/.claude/projects/`, `~/.codex/sessions/`, `~/.gemini/tmp/.../chats/`, ...)
- * via the existing `ProviderRegistry.listAll` plumbing.
- *
- * @param opts - listing options; see {@link ListSessionsOptions}.
- *   All fields are optional; omit `opts` entirely to list across every
- *   registered provider with no filtering.
- * @param opts.provider - restrict to one provider; omit for all
- * @param opts.workspace - filter by canonical workspace path (matched
- *   against `SessionSummary.cwd` via `canonicalPath`)
- * @param opts.limit - cap the result count after newest-first sort
- * @param opts.from - lower bound on `modifiedAt` (inclusive)
- * @param opts.to - upper bound on `modifiedAt` (inclusive)
- * @param opts.registry - DI for the ProviderRegistry; omit to use the
- *   lazily-built default
- * @returns Array of {@link SessionSummary} entries, sorted newest-first.
- * @throws Adapter `discover()` calls catch and log most filesystem
- *   errors internally (a corrupt session JSONL doesn't fail the whole
- *   listing). Unexpected throws bubble up.
- * @example
- * ```ts
- * import { listSessions } from "../providers/index.js";
- *
- * const recent = await listSessions({
- *   provider: "claude",
- *   workspace: "/repo",
- *   limit: 5,
- * });
- * for (const s of recent) console.log(s.sessionId, s.modifiedAt);
- * ```
- */
-export declare function listSessions(opts?: ListSessionsOptions): Promise<SessionSummary[]>;
-/** Delete one native session from a known provider. */
-export declare function deleteSession(provider: ProviderName, sessionId: string, registry?: ProviderRegistry): Promise<boolean>;
-/**
- * Options for `countTokens()`.
- */
-export interface CountTokensOptions {
-    /** Session id to look up. */
-    sessionId: string;
-    /**
-     * Restrict the lookup to one provider. If omitted, the registry
-     * probes every provider in registration order and returns the first
-     * match (same semantics as `lmctl info <sessionid>`).
-     */
-    provider?: ProviderName;
-    /** Adapter registry override. See {@link ChatOptions.registry}. */
-    registry?: ProviderRegistry;
-}
-/**
- * Aggregate token usage for a single session.
- *
- * `input`, `output`, etc. mirror `SessionSummary.total*Tokens` —
- * cumulative counts across every turn the session has produced. `total`
- * is the sum the provider reports (when available); when only the
- * per-bucket fields are populated, callers can compute `input +
- * cachedInput + cacheWriteInput + output + reasoningOutput`.
- */
-export interface TokenCount {
-    /** Provider that owns the session. */
-    provider: ProviderName;
-    /** Echoed sessionId for round-trip identification. */
-    sessionId: string;
-    /** Cumulative uncached input tokens. */
-    input: number;
-    /** Cumulative cache-hit input tokens. */
-    cachedInput: number;
-    /** Cumulative cache-write input tokens (claude only today). */
-    cacheWriteInput: number;
-    /** Cumulative output tokens. */
-    output: number;
-    /** Cumulative reasoning (a.k.a. "thoughts") output tokens. */
-    reasoningOutput: number;
-    /**
-     * Cumulative grand total = sum of the five per-bucket fields above.
-     * This is NOT the last-turn total — see `lastTurn.totalTokens`.
-     */
-    total: number;
-    /** Raw last-turn usage snapshot when the session file recorded it. */
-    lastTurn?: SessionTokenUsage;
-}
-/**
- * Aggregate token usage for a single session.
- *
- * Loads the session via the registered adapter, then extracts the
- * `total*Tokens` fields the discovery / load pass already computed.
- * Returns zeros for any field the provider did not report — callers
- * MUST treat 0 as "not measured" rather than "free." `total` is the
- * SUM of the five per-bucket fields; for a last-turn snapshot read
- * `lastTurn.totalTokens` instead.
- *
- * @param opts - lookup options; see {@link CountTokensOptions}
- * @param opts.sessionId - native session id (UUID-like)
- * @param opts.provider - restrict to one provider; omit to probe every
- *   registered provider in registration order
- * @param opts.registry - DI for the ProviderRegistry; omit to use the
- *   lazily-built default
- * @returns {@link TokenCount} populated from the session's persisted
- *   token buckets.
- * @throws `Error("session <sessionId> not found")` when no registered
- *   provider can resolve the id (message matches `/not found/`).
- * @example
- * ```ts
- * import { countTokens } from "../providers/index.js";
- *
- * const usage = await countTokens({ sessionId: "ses-abc" });
- * console.log(`${usage.input} in / ${usage.output} out`);
- * ```
- */
-export declare function countTokens(opts: CountTokensOptions): Promise<TokenCount>;
-export type { ProviderAdapter } from "./adapter.js";
-export type { ProgressEvent, TurnOptions, TurnResult, } from "./adapter.js";
-export type { ProviderName, SessionSummary, SessionDetail, SessionTokenUsage, ConversationMessage, MessageRole, } from "./types.js";
-export { ProviderRegistry, createAdapterRegistry } from "./registry.js";
-export { createAllAdapters } from "./adapters/index.js";
-export type { BundleSession, BundleSessionOpenOptions, BundleTurnOptions, BundleTurnResult, } from "./bundle.js";
-export { BUNDLE_CAPABLE_PROVIDERS, BUNDLE_NEVER_CAPABLE_PROVIDERS, } from "./bundle.js";
-export { TransportError, TransportConnectionError, TransportProcessError, TransportJsonError, TransportRpcError, } from "./transport-errors.js";

package/dist/providers/kimi.d.ts

@@ -1,37 +0,0 @@
-/**
- * Kimi Code session provider.
- *
- * Kimi persists an append-only session index plus one self-contained directory
- * per session:
- *   $KIMI_CODE_HOME/session_index.jsonl
- *   $KIMI_CODE_HOME/sessions/<workspace>/<session>/state.json
- *   $KIMI_CODE_HOME/sessions/<workspace>/<session>/agents/main/wire.jsonl
- */
-import type { SessionDetail, SessionProvider, SessionSummary } from "./types.js";
-interface KimiProviderOptions {
-    kimiHome?: string;
-}
-export declare class KimiProvider implements SessionProvider {
-    name: "kimi";
-    private readonly homeDir;
-    private readonly sessionsDir;
-    constructor(opts?: KimiProviderOptions);
-    discoverSessions(): Promise<SessionSummary[]>;
-    loadSession(sessionId: string): Promise<SessionDetail | null>;
-    resolveSessionPath(sessionId: string): Promise<string | null>;
-    deleteSession(sessionId: string): Promise<boolean>;
-    getWatchPaths(): {
-        directory: string;
-        filePattern: RegExp;
-    }[];
-    private indexPath;
-    private sessionFiles;
-    private readIndex;
-    private filesFor;
-    private validSessionDir;
-    private findSession;
-    private readState;
-    private summary;
-    private parseWire;
-}
-export {};