@lmctl-ai/lmctl 0.2.37 → 0.2.39

package/dist/providers/model-catalog.d.ts

@@ -1,145 +0,0 @@
-/**
- * lmprice <-> lmctl integration (approved design v2, section 1) -- the pure
- * model-catalog layer: provider adapters + catalog resolution over an
- * ALREADY-LOADED dataset snapshot (loading/refresh stays in pricing.ts).
- *
- * Identity vs billing route (design review correction #2): the same
- * normalized model id can have divergent priced offers across sources
- * (DeepSeek direct vs gateway rows differ ~2x; `:batch` variants share slugs
- * but price differently). Rows are therefore grouped by adapter-normalized
- * identity into ONE CatalogModel whose `offers` keep every source-qualified
- * row; route preference (first-party > litellm > openrouter > manual) picks
- * the winning row, never a reconciled average.
- *
- * Resolution order in resolveModel() (design section 1, exact):
- *   1. aliases.json exact hit (also probing `<provider>/<declared>`, since
- *      the table keys are harness-qualified) -- evidence states honored:
- *      established/asserted follow standard_slug -> standards[] ->
- *      catalog_record_id pin; `unresolved` or a null standard_slug is
- *      TERMINAL (`kimi-code/k3` must never fall through to guessing).
- *   2. Adapter path: normalize(declared) -> candidate ids -> match rows via
- *      candidate fields (source_model_id, every path suffix of it -- which
- *      covers LiteLLM route prefixes and the last `/`-segment -- and
- *      gateway_id where present; lowercased).
- *   3. Miss -> `unknown`.
- */
-import type { PriceRecord } from "./pricing.js";
-export type ResolutionState = {
-    kind: "priced";
-    model: CatalogModel;
-} | {
-    kind: "known-unpriced";
-    id: string;
-} | {
-    kind: "estimated";
-    model: CatalogModel;
-} | {
-    kind: "unresolved";
-    alias: string;
-} | {
-    kind: "unknown";
-    declared: string;
-} | {
-    kind: "wrong-provider";
-    declared: string;
-    otherProviders: string[];
-} | {
-    kind: "no-catalog";
-};
-export interface CatalogModel {
-    id: string;
-    normalizedId: string;
-    offers: PriceOffer[];
-    contextWindow?: number;
-}
-export interface PriceOffer {
-    route: string;
-    source: string;
-    sourceModelId: string;
-    provider: string | null;
-    pricing: PriceRecord["pricing"];
-    estimated: boolean;
-}
-/**
- * The dataset record shape the catalog layer reads. Structurally compatible
- * with pricing.ts's PriceRecord (the extra fields are optional so a slimmed
- * record still satisfies this), but grounded in lmprice's real published
- * schema (record_id / provider / mode / gateway_id / context_window).
- */
-export interface CatalogRecord {
-    record_id?: string | null;
-    source: string;
-    source_model_id: string;
-    provider?: string | null;
-    mode?: string | null;
-    gateway_id?: string | null;
-    pricing: PriceRecord["pricing"];
-    context_window?: {
-        input_tokens?: number | null;
-    } | null;
-}
-export interface CatalogDataLike {
-    records: CatalogRecord[];
-}
-export type AliasEvidence = "established" | "asserted" | "unresolved";
-export interface AliasStandard {
-    standard_slug: string;
-    display_name?: string | null;
-    vendor?: string | null;
-    catalog_record_id: string | null;
-    note?: string | null;
-}
-export interface AliasEntry {
-    alias: string;
-    standard_slug: string | null;
-    evidence: AliasEvidence;
-    source_url?: string | null;
-    note?: string | null;
-}
-export interface AliasTable {
-    schema_version: number;
-    standards: AliasStandard[];
-    aliases: AliasEntry[];
-}
-/**
- * Design section 1 sketches `matchRow(record)`; the implemented signature
- * takes the normalized candidate ids as a second argument because matching
- * is candidates-vs-row-candidate-fields, not a bare regex on the raw id
- * (review correction #3).
- */
-export interface ProviderAdapter {
-    matchRow(record: CatalogRecord, candidates: readonly string[]): boolean;
-    normalize(declared: string): string[];
-    isChatModel(record: CatalogRecord): boolean;
-    /** Family + capability membership WITHOUT a candidate check (catalog stats). */
-    coversRecord(record: CatalogRecord): boolean;
-}
-/**
- * Providers WITHOUT adapters are skipped (`no-catalog`): copilot, opencode,
- * pi, dsh, lmplayer. dsh/opencode models can still resolve via the aliases
- * table, which is consulted BEFORE the adapter check.
- */
-export declare const PROVIDER_ADAPTERS: Record<string, ProviderAdapter>;
-/**
- * Resolve one declared model string for one provider against a loaded
- * catalog snapshot + alias table. Pure; never throws; no I/O.
- */
-export declare function resolveModel(provider: string, declared: string, data: CatalogDataLike | null, aliases: AliasTable | null): ResolutionState;
-export interface OfferResolution {
-    state: ResolutionState;
-    /** The offer to price at when the state is priced/estimated, else null. */
-    offer: PriceOffer | null;
-    /**
-     * How the offer was selected: the alias table's catalog_record_id pin
-     * when resolution came through aliases, route preference
-     * (first-party > litellm > openrouter > manual, first with rates) otherwise.
-     */
-    provenance: "alias-pin" | "route-preference" | null;
-}
-export declare function resolveOfferForCost(provider: string, declared: string, data: CatalogDataLike | null, aliases: AliasTable | null): OfferResolution;
-/**
- * Count of distinct model identities a provider's adapter covers in this
- * catalog -- the "(N known)" in lint/seed's unknown-model warning. `null`
- * when the provider has no adapter.
- */
-export declare function catalogKnownModelCount(data: CatalogDataLike, provider: string): number | null;

package/dist/providers/model-suggestions.d.ts

@@ -1,4 +0,0 @@
-import { type CatalogDataLike } from './model-catalog.js';
-export declare function isAggregatorProvider(provider: string): boolean;
-export declare function catalogModelSuggestions(provider: string, catalog: CatalogDataLike): string[];
-export declare function loadModelSuggestions(provider: string): Promise<string[]>;

package/dist/providers/one-shot-timeout.d.ts

@@ -1 +0,0 @@
-export declare function getOneShotTimeoutMs(env?: NodeJS.ProcessEnv): number;

package/dist/providers/opencode-config.d.ts

@@ -1,62 +0,0 @@
-/**
- * Opencode `.opencode/opencode.json` permission writer.
- *
- * **YOLO contract via config** (`permission: "allow"`).
- *
- * Opencode's ACP mode does NOT accept the `--dangerously-skip-permissions`
- * argv flag (it's `run`-subcommand-only — empirically verified, see commit
- * log around the opencode06 incident). The only way to satisfy lmctl's
- * YOLO contract for opencode is via the `permission` key in
- * opencode.json. Per the opencode schema:
- *   - shorthand `"allow"` → `{ "*": "allow" }` (all tools)
- *   - object form        → per-tool decisions
- * We use the shorthand.
- *
- * lmctl does NOT inject a provider/model catalog here — models resolve
- * from opencode's own default catalog (models.dev + provider auth) and
- * the user's `~/.config/opencode/opencode.json`. We write only
- * `permission: "allow"`.
- */
-import type { MemberConfig } from "./config/team-config.js";
-import type { McpExecutableWarningOptions } from "../mcp/path-warning.js";
-export declare const OPENCODE_LMCTL_MCP_TIMEOUT_MS = 86400000;
-export declare function buildOpencodeMcpEntry(): Record<string, unknown>;
-/**
- * Predicate: is this `permission` value "effectively allow everything"?
- *
- * Two equivalent shapes per opencode's schema satisfy lmctl's YOLO
- * contract:
- *   - the shorthand string `"allow"`
- *   - the object form `{ "*": "allow" }` (single wildcard-allow entry)
- *
- * Anything else (`"ask"`, `"deny"`, multi-entry objects with mixed
- * rules, etc.) is a USER OVERRIDE we respect but warn about — turns
- * may hang waiting on permission prompts opencode would otherwise
- * auto-approve.
- */
-export declare function isEffectivelyAllowAll(permission: unknown): boolean;
-export interface OpencodeYoloOverrideFsOps {
-    existsSync(path: string): boolean;
-    readFileSync(path: string, encoding: BufferEncoding): string;
-}
-export declare function opencodeYoloOverrideWarnings(members: MemberConfig[], baseDir: string, fsOps?: OpencodeYoloOverrideFsOps): string[];
-/**
- * Install or upgrade `<targetDir>/.opencode/opencode.json`.
- *
- * What we write:
- *   - `permission: "allow"` — the YOLO contract for opencode.
- *
- * Merge semantics:
- *   - If the file is missing, write a fresh one with
- *     `{ permission: "allow" }`.
- *   - If the file exists, only fill in `permission` when absent;
- *     a user-supplied permission value is PRESERVED (user override
- *     wins). Existing user MCP entries are preserved untouched. When
- *     the user-set value is not effectively allow-all, emit a structured
- *     `opencode_yolo_override` warning via errorLog so the operator
- *     knows YOLO isn't in effect.
- *
- * Returns true iff the file was written, false if already up-to-date
- * or skipped due to malformed JSON.
- */
-export declare function installOpencodeConfig(targetDir: string, _options?: McpExecutableWarningOptions): boolean;

package/dist/providers/opencode.d.ts

@@ -1,40 +0,0 @@
-import type { SessionProvider, SessionSummary, SessionDetail } from "./types.js";
-type OpenCodeCompatibleProviderName = "opencode" | "lmplayer";
-interface OpenCodeProviderOptions {
-    dbPath?: string;
-    providerName?: OpenCodeCompatibleProviderName;
-    startCommand?: string;
-    /** Read-only connection `PRAGMA busy_timeout` in ms. Default 5000; lower
-     *  for tests that need to observe the retry-then-give-up path quickly. */
-    busyTimeoutMs?: number;
-}
-export declare class OpenCodeProvider implements SessionProvider {
-    readonly name: OpenCodeCompatibleProviderName;
-    private readonly startCommand;
-    private readonly dbPaths;
-    private readonly busyTimeoutMs;
-    constructor(opts?: OpenCodeProviderOptions);
-    private existingDbPaths;
-    private openDb;
-    discoverSessions(): Promise<SessionSummary[]>;
-    loadSession(sessionId: string): Promise<SessionDetail | null>;
-    private buildSessionDetail;
-    private extractText;
-    resolveSessionPath(sessionId: string): Promise<string | null>;
-    deleteSession(sessionId: string): Promise<boolean>;
-    private findSessionRow;
-}
-/**
- * Bundle-identity probe (batch bundle mode): does the opencode session store
- * hold a session with EXACTLY this id, and which directory does it belong
- * to? opencode's `session/load` response does not echo the sessionId
- * (verified on the wire, 2026-09-25), so the bundle driver verifies the
- * resume target here instead. Read-only, with the same busy_timeout
- * rationale as OpenCodeProvider.openDb.
- */
-export declare function opencodeSessionStoreEntry(sessionId: string, opts?: {
-    dbPath?: string;
-}): {
-    directory: string;
-} | null;
-export {};

package/dist/providers/parsers/acp.d.ts

@@ -1,71 +0,0 @@
-export interface AcpResult {
-    result: string;
-    sessionId: string;
-    durationMs: number;
-    stopReason: string;
-    exitCode: number | null;
-    /** Human-readable strings when this turn's provider silently dropped a
-     * declared model=/effort= (task #232) -- e.g. a `session/set_config_option`
-     * rejection the turn proceeded past anyway. Omitted when nothing was
-     * dropped. */
-    warnings?: string[];
-    /** See AcpOutputProcessorResult.sawActivity. */
-    sawActivity: boolean;
-}
-export interface AcpOutputProcessorResult {
-    result: string;
-    sessionId: string;
-    stopReason: string;
-    /** Whether THIS turn saw any real agent activity (message/thought text,
-     *  a tool call or its result, a plan) -- as opposed to pure session
-     *  bookkeeping (session_info_update, current_mode_update,
-     *  config_option_update, available_commands_update, usage_update,
-     *  user_message_chunk) or nothing at all. See ACP_MEANINGFUL_UPDATE_KINDS. */
-    sawActivity: boolean;
-}
-export interface AcpOutputProcessor {
-    setSessionId(sessionId: string): void;
-    beginTurn(): void;
-    completeTurn(promptResponse: Record<string, unknown>): AcpOutputProcessorResult;
-    /**
-     * Abandon the in-flight turn WITHOUT recording a result (bundle
-     * cancellation): stops collecting, discards the partial text, and leaves
-     * `gotResult` untouched so a late-arriving prompt response cannot be
-     * mistaken for a completed turn. The next `beginTurn()` starts clean.
-     */
-    cancelTurn(): void;
-    processMessage(message: Record<string, unknown>): boolean;
-    finalize(): AcpOutputProcessorResult | null;
-}
-export declare function isolateGeminiLatestAgentMessage(text: string): string;
-export declare function acpSessionIdFromResponse(response: Record<string, unknown>, fallback?: string): string;
-export declare function acpStopReasonFromResponse(response: Record<string, unknown>): string;
-/**
- * `sessionUpdate` kinds that represent real agent work, grounded in actual
- * production ACP traffic (checked against a full day's ~/.lmctl/debug-*.log,
- * 2026-09-29) plus the ACP spec's own "plan" kind (Zed and friends). Every
- * OTHER kind seen in that traffic -- session_info_update, current_mode_
- * update, config_option_update, available_commands_update, usage_update,
- * user_message_chunk (an echo of the user's OWN input, not agent work) -- is
- * pure session bookkeeping, and any future/unrecognized kind is treated the
- * same conservative way: NOT activity. This is a whitelist, not a blacklist,
- * on purpose -- the failure mode of missing a real silent-failure turn is
- * bad, but the failure mode of flagging a legitimate turn as broken is
- * worse (it would fire fleet-wide, for every provider, on every genuinely
- * empty-but-fine turn), so activity only counts when there is positive
- * evidence of it.
- */
-export declare const ACP_MEANINGFUL_UPDATE_KINDS: Set<string>;
-export declare function createAcpOutputProcessor(opts?: {
-    tool?: string;
-    onDelta?: (text: string) => void;
-    /**
-     * Result-text isolation for providers that replay prior turns (gemini's
-     * latest-agent-message isolation). Supplied by the provider's ACP
-     * profile (transports/acp-profiles/); when absent, falls back to the
-     * historical `tool === "gemini"` keying so direct callers that pass
-     * only a tool name keep their behavior.
-     */
-    isolateResult?: (text: string) => string;
-}): AcpOutputProcessor;
-export declare function supportsAcp(tool: string): boolean;

package/dist/providers/parsers/codex-app-server.d.ts

@@ -1,60 +0,0 @@
-export type CodexPermissionMode = "plan" | "yolo";
-export declare function codexSandboxForPermissionMode(mode: CodexPermissionMode): string;
-export declare function buildCodexThreadStartParams(opts: {
-    cwd: string;
-    permissionMode?: CodexPermissionMode;
-    model?: string;
-}): Record<string, unknown>;
-export declare function buildCodexThreadResumeParams(opts: {
-    threadId: string;
-    permissionMode?: CodexPermissionMode;
-    model?: string;
-}): Record<string, unknown>;
-export interface CodexInitializePayload extends Record<string, unknown> {
-    clientInfo: {
-        name: string;
-        title: string;
-        version: string;
-    };
-    capabilities: {
-        experimentalApi: boolean;
-    };
-}
-export declare function buildInitializePayload(version?: string): CodexInitializePayload;
-export type AgentMessagePhase = "commentary" | "final_answer";
-export interface AgentMessageItemState {
-    phase: AgentMessagePhase | undefined;
-    buffer: string;
-}
-export interface CodexAgentAccumulatorState {
-    agentItems: Map<string, AgentMessageItemState>;
-    resultText: string;
-}
-export interface CodexItemMismatchInfo {
-    itemId: string;
-    threadId?: string;
-    turnId?: string;
-    expectedFromItemText: string;
-    gotFromBuffer: string;
-}
-export declare function createCodexAgentAccumulator(): CodexAgentAccumulatorState;
-export declare function processCodexAgentNotification(notification: Record<string, unknown>, state: CodexAgentAccumulatorState, onDelta?: (text: string) => void, onItemMismatch?: (info: CodexItemMismatchInfo) => void): boolean;
-export declare function flushCodexAgentAccumulator(state: CodexAgentAccumulatorState): void;
-export type CodexErrorDisposition = {
-    willRetry: true;
-} | {
-    willRetry: false;
-    turnError: Error;
-};
-export declare function classifyCodexErrorDisposition(notification: Record<string, unknown>): CodexErrorDisposition;
-export interface CodexTurnState {
-    pendingCodexError: Error | null;
-}
-export declare function createCodexTurnState(): CodexTurnState;
-export declare function recordCodexErrorNotification(notification: Record<string, unknown>, state: CodexTurnState): CodexErrorDisposition;
-export declare function resolveCodexTurnCompletion(notification: Record<string, unknown>, state: CodexTurnState): {
-    shouldReject: true;
-    turnError: Error;
-} | {
-    shouldReject: false;
-};

package/dist/providers/parsers/stream-json.d.ts

@@ -1,57 +0,0 @@
-export interface StreamJsonResult {
-    result: string;
-    sessionId: string;
-    durationMs: number;
-    numTurns: number;
-    exitCode: number | null;
-    /** Set only by the result-grace-timeout fallback in transports/stream-json.ts
-     * (BUG-claude-cli-stalls-after-end-turn.md): the model finished responding
-     * but the CLI never emitted its own closing `result` event. Same convention
-     * as TurnResult.warnings -- informational, does not change the outcome. */
-    warnings?: string[];
-}
-export interface StreamJsonProcessor {
-    processLine(line: string): void;
-    sawResult(): boolean;
-    finalize(): {
-        result: string;
-        sessionId: string;
-        durationMs: number;
-        numTurns: number;
-        /**
-         * True when the aggregated turn produced NO usable text and at least
-         * one `result` event reported `is_error: true` — see
-         * AggregatedResultEvents.isError below for why this must not be
-         * conflated with "the model genuinely returned nothing."
-         */
-        isError: boolean;
-        errorMessage?: string;
-    } | null;
-}
-export interface AggregatedResultEvents {
-    resultTexts: string[];
-    durationMs: number;
-    numTurns: number;
-    sessionId: string;
-    /**
-     * A `result` event can report `is_error: true` with NO `result` field at
-     * all (confirmed live, 2026-09-16, against a real `claude` CLI resuming
-     * an evicted/unresolvable session id: subtype "error_during_execution",
-     * no "result" key, the actual message only in an `errors: string[]`
-     * array). Without this flag that shape reads as a genuine empty
-     * response — "status: ok, content: (empty)" — indistinguishable from a
-     * model that legitimately said nothing, when the two need completely
-     * different remedies (a member refresh vs. investigating the prompt).
-     * `errorMessage` is the joined `errors` array, or a subtype-based
-     * fallback when `errors` is absent.
-     */
-    isError: boolean;
-    errorMessage?: string;
-}
-export declare function joinResultTurns(texts: string[]): string;
-export declare function createStreamJsonProcessor(opts?: {
-    onEvent?: (event: Record<string, unknown>) => void;
-    onText?: (text: string) => void;
-}): StreamJsonProcessor;
-export declare function aggregateResultEvents(events: Array<Record<string, unknown>>): AggregatedResultEvents;
-export declare function supportsStreamJson(tool: string): boolean;

package/dist/providers/passive-readers/agy.d.ts

@@ -1,155 +0,0 @@
-/**
- * Passive (read-only, bounded, certified) reader for Antigravity CLI (`agy`)
- * sessions.
- *
- * `agy` lives under `~/.gemini/antigravity-cli` but is NOT Gemini CLI — the
- * shared parent directory is a naming coincidence, and nothing in this reader is
- * shared with a Gemini/ACP path.
- *
- * ## The two candidate sources, and why only one is used
- *
- * 1. `conversations/<session>.db` — SQLite. Tables: `trajectory_meta`, `steps`,
- *    `gen_metadata`, `executor_metadata`, `parent_references`,
- *    `trajectory_metadata_blob`, `battle_mode_infos`. **Every payload column is
- *    an opaque protobuf blob** (`google3/third_party/jetski/cortex_pb`), not
- *    JSON. One `gen_metadata` row == one model generation.
- * 2. `brain/<session>/.system_generated/logs/transcript_full.jsonl` (and the
- *    older compact `transcript.jsonl`) — readable JSONL.
- *
- * A census of every local transcript (141 files, 13 801 records) shows the JSONL
- * carries ONLY: `step_index`, `source`, `type`, `status`, `created_at`,
- * `content`, `tool_calls`, `thinking`, `exit_code`, `error`, `error_code`.
- * There is **no token field, no model field and no per-response id anywhere in
- * it**, so it cannot supply a `response_id` and cannot be the response source.
- * It is therefore not read here at all; see the owner report for why joining it
- * back to a generation is a separate, larger piece of work.
- *
- * ## What IS certified from the database
- *
- * Read with a schema-less protobuf wire walker (field numbers only — no
- * generated stubs, nothing evaluated), cross-checked across 4 sessions and 2
- * model families:
- *
- * - `gen_metadata.data` field 1 is the generation's chat-model metadata message.
- * - Inside it, field 20 is a repeated `{1:key, 2:value}` string map. It contains
- *   `request_id` (`<trajectory_id>-<n>`), which is unique per generation and is
- *   used as `response_id`. It also contains `trajectory_id`, `last_step_index`,
- *   `model_enum`, `last_execution_id` and `used_claude`/`used_non_gemini_model`
- *   flags. Cross-checked: the top-level field-4 UUID is NOT per-generation (it
- *   repeats across rows) and is deliberately not used as an id.
- * - Field 19 is the response model name string (`gemini-3.8-flash`,
- *   `gemini-pro-default` locally).
- * - `last_step_index` indexes the `steps` table, whose `step_payload` field 5
- *   sub-field 1 is a `google.protobuf.Timestamp`. That join gives a real
- *   per-generation timestamp and is verified monotonic against generation order.
- *
- * ## What is NOT certified: tokens
- *
- * ## Tokens — RESOLVED via the installed client's own embedded schema
- *
- * Field 4 of the chat-model metadata was long treated as an unnamed counter
- * block because no `.proto` was available and the standard `UsageMetadata`
- * interpretation was directly ruled out (its assumed field 3 was smaller than
- * its assumed field 2 — impossible for total-vs-candidates under that guess).
- * That block is NOT a guess anymore: the installed `agy` binary is a Go build
- * of `google.golang.org/protobuf`, which embeds each compiled `.proto` file's
- * real `FileDescriptorProto` bytes for reflection. Locating the descriptor's
- * self-declared name field (`third_party/jetski/cortex_pb/cortex.proto`,
- * tag `0x0a` immediately preceding it — distinguishing it from the many
- * `0x1a` dependency-reference copies of the same string elsewhere in the
- * binary) and parsing the schema-less-walked byte range with the real
- * `google.protobuf` library recovers the ACTUAL message: field 4 is
- * `exa.codeium_common_pb.ModelUsageStats`, not a generic `UsageMetadata`.
- * Its real fields (confirmed against 6,662 real local rows, independently
- * re-derived and cross-checked by a second reviewer against the raw binary):
- *   2 input_tokens, 3 output_tokens, 4 cache_write_tokens (never observed
- *   non-null locally — genuinely rare/unused, not unread), 5 cache_read_tokens
- *   (absent on some rows — no cache yet), 9 thinking_output_tokens,
- *   10 response_output_tokens, 1 model (enum; the string alias is already
- *   separately captured from field 19 above), 7/11/12 assorted opaque id
- *   strings (message_id/response_id/provider_assigned_message_id — these,
- *   not a "bot id"/"session id", are what the pre-schema walk was seeing).
- * `response_output_tokens + thinking_output_tokens === output_tokens` EXACTLY
- * on all 6,662/6,662 rows carrying both — proof (not inference) that
- * `output_tokens` is the total and `thinking_output_tokens` is its reasoning
- * subset. `cache_write_tokens`'s relationship (if any) to `input_uncached` is
- * deliberately left unasserted — see `agyUsage`'s own doc comment below; a
- * shared field name across providers is not evidence of shared semantics.
- * `input_tokens` is used directly as `input_uncached`, never subtracted from:
- * real rows show `input_tokens < cache_read_tokens` (e.g. 3280 vs 12145),
- * which is only possible if the two are independent additive counts, not an
- * inclusive total/subset pair — ruling out subtraction the same way the
- * original block-level guess was ruled out (an impossible relation under the
- * wrong model). Missing/invalid buckets stay NULL per-field (never a guessed
- * 0) — `cache_write_tokens` in particular is null on every locally observed
- * row precisely because it has genuinely never been populated here, not
- * because it is unread.
- *
- * `files_read` / `files_written` / `external_io` are NULL (unknown), not `[]`:
- * tool calls live in `steps.step_payload`, a different opaque message, and in
- * the un-joinable transcript. NULL correctly forces `read_bytes`/`write_bytes`
- * to NULL rather than presenting "no tools observed" as "no I/O occurred".
- */
-import type { ReadLimits, Snapshot, Source, SourceState } from "../passive-session-reader.js";
-import { type TokenValues } from "./shared.js";
-export declare const AGY_PROVIDER = "agy";
-export declare const AGY_EXTRACTION_REVISION_TAG = "agy-tokens-v1";
-/**
- * `steps.step_payload` → ISO timestamp, via field 5 (step metadata) sub-field 1
- * (`google.protobuf.Timestamp` {1:seconds, 2:nanos}). Returns null when the
- * shape is absent — never a fabricated or file-mtime-derived time.
- */
-export declare function agyStepTimestamp(stepPayload: Buffer): string | null;
-/** One generation extracted from a `gen_metadata` row. */
-export interface AgyGeneration {
-    /** Native `request_id` — `<trajectory_id>-<n>`, unique per generation. */
-    requestId: string;
-    model: string | null;
-    /** `steps.idx` this generation ended on; the timestamp join key. */
-    lastStepIndex: number | null;
-    tokens: TokenValues;
-    thinkingOutputTokens: number | null;
-}
-/**
- * Extract the certified facts from one `gen_metadata.data` blob. Returns null
- * when the row carries no `request_id` — without a native id the generation
- * cannot be addressed, and inventing one is forbidden.
- */
-export declare function parseAgyGeneration(data: Buffer): AgyGeneration | null;
-export interface AgyPassiveReaderOptions {
-    /** Defaults to `$HOME/.gemini/antigravity-cli/conversations`. */
-    agyConversationsDir?: string;
-}
-export declare class AgyPassiveReader {
-    private readonly conversationsDir;
-    private readonly sqliteBusyTimeoutMs;
-    constructor(options?: AgyPassiveReaderOptions & {
-        sqliteBusyTimeoutMs?: number;
-    });
-    /**
-     * Enumerate up to `cap` `<conversationsDir>/<session>.db` files ordered by real
-     * path. A flat listing, so there is no traversal budget to exhaust; `truncated`
-     * is always false and is returned only to match the other readers' shape.
-     *
-     * `.db-wal` / `.db-shm` companions are excluded by the exact `.db` suffix test:
-     * they are not sources, and treating one as a session would mint a bogus id.
-     */
-    discover(limits: ReadLimits, cap: number, afterPath?: string | null): Promise<{
-        sources: Source[];
-        truncated: boolean;
-    }>;
-    /**
-     * Open the conversation database read-only, after proving the path is a real,
-     * non-symlink file inside the configured conversations directory AND that its
-     * basename is the claimed session id.
-     *
-     * Returns null (→ `unavailable`) rather than throwing when the file is not a
-     * usable SQLite database. A live session's `-wal`/`-shm` companions are read
-     * through by SQLite itself; a read-only open that cannot reach them fails
-     * closed here instead of returning a half-visible snapshot.
-     */
-    private open;
-    inspect(source: Source, limits: ReadLimits): Promise<SourceState>;
-    read(source: Source, revision: string, limits: ReadLimits): Promise<Snapshot>;
-}
-export declare function createAgyPassiveReader(options?: AgyPassiveReaderOptions): AgyPassiveReader;