@retaw106/mmc-oc 0.0.0-stage → 1.2.2

package/dist/shared/models-dev-cache.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Resolve per-model context limits from OpenCode's SDK — the single source of
+ * truth — for OpenCode sessions.
+ *
+ * `client.config.providers()` returns OpenCode's fully-resolved config: the
+ * live models.dev cache + compiled-in snapshot + opencode.json custom-provider
+ * overrides + auth-plugin caps (e.g. the Codex-OAuth gpt-5.5 400k cap). We
+ * consume ONLY that. We no longer read OpenCode's `models.json` file ourselves:
+ * a torn read mid-write produced impossible limits (a 6748 "limit" for a session
+ * that had run for hours), and a stale on-disk copy out-voted the live
+ * auth-resolved cap (922k vs the real 400k). OpenCode reads that file safely in
+ * its own process and hands us the merged answer.
+ *
+ * Layers:
+ *   1. `apiCache` (authoritative): warmed once at startup from the SDK; seeded
+ *      from a persisted last-known-good file on cold start so a restart uses the
+ *      real limit immediately (no 128k-default budget-collapse window).
+ *
+ * All cached values are bounded to a sane [20k, 3M] range on insert, so torn /
+ * unconfigured-default garbage can never be returned or persisted. The startup
+ * warm retries a couple times when OpenCode's provider service isn't ready yet.
+ *
+ * Pi does NOT use this — it resolves from its own `ctx.getModel().contextWindow`
+ * (instant at extension load), so `getSdkContextLimit()` returns `undefined`
+ * for Pi and Pi's own path is used.
+ */
+import type { ContextLimitProvenance } from "./context-limit-provenance";
+import { type WindowGeometryResult } from "./window-geometry";
+interface OpencodeClientLike {
+    config: {
+        providers: () => Promise<{
+            data?: {
+                providers?: unknown;
+            };
+        }>;
+    };
+}
+export declare const MIN_SANE_LIMIT = 20000;
+export declare const MAX_SANE_LIMIT = 3000000;
+/** True when `limit` is a plausible real prompt window — used to reject torn /
+ *  unconfigured-default garbage in BOTH harnesses (OpenCode's SDK values and
+ *  Pi's reported `contextWindow`). Exported so Pi applies the identical bound. */
+export declare function isSaneLimit(limit: number | undefined): limit is number;
+export type OutputReserveConfig = number | {
+    default: number;
+    [modelKey: string]: number;
+};
+export interface ModelLimit {
+    context?: number;
+    input?: number;
+    output?: number;
+}
+/** Resolve the user-tier output reservation for one runtime model. */
+export declare function resolveOutputReserve(providerID: string, modelID: string, config?: OutputReserveConfig | undefined): number | undefined;
+/** Set the user-tier reservation override shared by every resolved-limit consumer. */
+export declare function setOutputReserveConfig(config: OutputReserveConfig | undefined): void;
+/**
+ * Resolve the usable prompt budget from raw provider metadata.
+ *
+ * A genuinely smaller input cap is already pre-carved and wins unchanged. All
+ * other providers reserve generated tokens from the shared context window by
+ * default, except the small allowlist whose APIs document a separate output
+ * quota. `output_reserve` overrides that shared/separate decision, including 0
+ * to disable reservation. Reservation can never leave less than half the raw
+ * context window or the module's 1024-token plausibility floor.
+ */
+export declare function resolveLimit(limit: ModelLimit | undefined, providerID: string, modelID: string, reserveConfig?: OutputReserveConfig | undefined): number | undefined;
+/**
+ * Asynchronously refresh the API-layer cache from OpenCode's SDK.
+ *
+ * Call this at plugin startup and from the issue #77 regression-recovery path.
+ * OpenCode's `/config/providers` endpoint returns every provider with full
+ * model metadata — including `limit.context` — resolved through the same path
+ * OpenCode itself uses (live cache + compiled-in snapshot + opencode.json
+ * overrides + derived experimental modes + auth-plugin caps).
+ *
+ * `retries`/`retryDelayMs`: when OpenCode's provider service isn't ready at our
+ * startup, `config.providers()` can return an empty/no-providers payload. Retry
+ * a few times so the cache warms instead of leaving the session on the 128k
+ * default until the next restart. A successful load (any providers) stops early.
+ *
+ * Safe to call concurrently; only overwrites the cache on success.
+ */
+export declare function refreshModelLimitsFromApi(client: OpencodeClientLike, options?: {
+    retries?: number;
+    retryDelayMs?: number;
+}): Promise<void>;
+/**
+ * Re-warm the limit cache ONCE per process, after auth is provably live.
+ *
+ * The startup warm (index.ts) can run before the user's provider auth is
+ * loaded. When it does, an auth-conditional limit patch hasn't applied yet, so
+ * `config.providers()` returns the RAW catalog limit (e.g. OpenAI gpt-5.5 OAuth
+ * is downshifted to a 272k input cap by OpenCode's Codex auth plugin only when
+ * `ctx.auth.type === "oauth"`; before auth loads it reports the raw 922k). That
+ * too-high value gets cached AND persisted as last-known-good, survives
+ * restarts, and the existing recovery only re-resolves a too-LOW limit
+ * (overflow / `percentage > 100`), so a too-HIGH one never self-corrects: the
+ * sidebar shows huge headroom while the backend rejects at the real cap (#179).
+ *
+ * The first `message.updated` carrying usage tokens proves a request succeeded,
+ * so auth + providers are fully resolved. Re-warming there overwrites any stale
+ * pre-auth limit with the live auth-adjusted one. Idempotent and cheap: a single
+ * `config.providers()` round-trip, then a no-op for the rest of the process. The
+ * latch is set before the await so concurrent `message.updated` events don't
+ * stack duplicate warms; a failed warm resets it so a later message retries.
+ */
+export declare function refreshModelLimitsAfterAuthOnce(client: OpencodeClientLike): Promise<void>;
+/** Test-only: reset the after-auth re-warm latch between cases. */
+export declare function resetAuthRewarmLatchForTest(): void;
+/**
+ * Resolve a model's prompt limit from OpenCode's SDK (`config.providers()`),
+ * the single source of truth: it already merges models.dev + compiled-in
+ * snapshot + opencode.json overrides + auth-plugin caps (e.g. the Codex-OAuth
+ * gpt-5.5 400k cap). We deliberately do NOT read OpenCode's `models.json` file
+ * ourselves — a torn read of that file mid-write produced garbage limits, and a
+ * stale on-disk copy out-voted the live auth-resolved cap (922k vs the real
+ * 400k). OpenCode reads that file safely within its own process and exposes the
+ * merged result here.
+ *
+ * Resolution:
+ *   1. Seed `apiCache` from the persisted last-known-good file once (cold start).
+ *   2. Resolve the sane raw SDK metadata into its output-reserved usable value.
+ *   3. `undefined` when the SDK hasn't reported this model yet → the caller
+ *      defaults / retries (the startup warm retries when OpenCode isn't ready).
+ *
+ * OpenCode-only: Pi never warms `apiCache` (it resolves from its own
+ * `ctx.model.contextWindow`), so for Pi this returns `undefined` and Pi's
+ * own resolution path is used.
+ */
+export declare function getSdkWindowGeometry(providerID: string, modelID: string, detectedContextLimit?: number, options?: {
+    detectedLimitProvenance?: ContextLimitProvenance;
+    harness?: "opencode" | "pi";
+}): WindowGeometryResult | undefined;
+export declare function getSdkContextLimit(providerID: string, modelID: string, detectedContextLimit?: number, options?: {
+    reservation?: "default" | "none";
+    detectedLimitProvenance?: ContextLimitProvenance;
+}): number | undefined;
+/**
+ * Return only a provider-declared input cap. A combined context window is useful
+ * for scheduling but is not safe as a fail-closed prompt boundary.
+ */
+/** Resolve image-input support from the same models.dev metadata cache as limits. */
+export declare function modelSupportsVision(providerID: string, modelID: string): boolean;
+export declare function getSdkOutputLimit(providerID: string, modelID: string): number | undefined;
+export declare function getSdkInputLimit(providerID: string, modelID: string): number | undefined;
+/** Clear in-memory caches (for testing and the regression-recovery refetch). */
+export declare function clearModelsDevCache(): void;
+/** Inspection helpers (for logging / debugging). */
+export declare function getModelsDevCacheState(): {
+    apiLoaded: boolean;
+    apiCount: number;
+    apiAgeMs: number;
+};
+export {};
+//# sourceMappingURL=models-dev-cache.d.ts.map

package/dist/shared/models-dev-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models-dev-cache.d.ts","sourceRoot":"","sources":["../../src/shared/models-dev-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAMzE,OAAO,EAIH,KAAK,oBAAoB,EAC5B,MAAM,mBAAmB,CAAC;AAE3B,UAAU,kBAAkB;IACxB,MAAM,EAAE;QACJ,SAAS,EAAE,MAAM,OAAO,CAAC;YAAE,IAAI,CAAC,EAAE;gBAAE,SAAS,CAAC,EAAE,OAAO,CAAA;aAAE,CAAA;SAAE,CAAC,CAAC;KAChE,CAAC;CACL;AASD,eAAO,MAAM,cAAc,QAAS,CAAC;AACrC,eAAO,MAAM,cAAc,UAAY,CAAC;AAExC;;kFAEkF;AAClF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,MAAM,CAEtE;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAE3F,MAAM,WAAW,UAAU;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAsID,sEAAsE;AACtE,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,mBAAmB,GAAG,SAA+B,GAC9D,MAAM,GAAG,SAAS,CASpB;AAQD,sFAAsF;AACtF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,GAAG,IAAI,CAEpF;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CACxB,KAAK,EAAE,UAAU,GAAG,SAAS,EAC7B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,aAAa,GAAE,mBAAmB,GAAG,SAA+B,GACrE,MAAM,GAAG,SAAS,CAmCpB;AA8DD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,yBAAyB,CAC3C,MAAM,EAAE,kBAAkB,EAC1B,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACtD,OAAO,CAAC,IAAI,CAAC,CAUf;AAKD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,+BAA+B,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/F;AAED,mEAAmE;AACnE,wBAAgB,2BAA2B,IAAI,IAAI,CAElD;AA+DD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAChC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,oBAAoB,CAAC,EAAE,MAAM,EAC7B,OAAO,CAAC,EAAE;IACN,uBAAuB,CAAC,EAAE,sBAAsB,CAAC;IACjD,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAC/B,GACF,oBAAoB,GAAG,SAAS,CAsClC;AAED,wBAAgB,kBAAkB,CAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,oBAAoB,CAAC,EAAE,MAAM,EAC7B,OAAO,CAAC,EAAE;IACN,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IACjC,uBAAuB,CAAC,EAAE,sBAAsB,CAAC;CACpD,GACF,MAAM,GAAG,SAAS,CAkCpB;AAED;;;GAGG;AACH,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAShF;AAED,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGzF;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWxF;AA2BD,gFAAgF;AAChF,wBAAgB,mBAAmB,IAAI,IAAI,CAI1C;AAED,oDAAoD;AACpD,wBAAgB,sBAAsB,IAAI;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CACpB,CAMA"}

package/dist/shared/normalize-sdk-response.d.ts

@@ -0,0 +1,5 @@
+export interface NormalizeSDKResponseOptions {
+    preferResponseOnMissingData?: boolean;
+}
+export declare function normalizeSDKResponse<TData>(response: unknown, fallback: TData, options?: NormalizeSDKResponseOptions): TData;
+//# sourceMappingURL=normalize-sdk-response.d.ts.map

package/dist/shared/normalize-sdk-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-sdk-response.d.ts","sourceRoot":"","sources":["../../src/shared/normalize-sdk-response.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,2BAA2B;IACxC,2BAA2B,CAAC,EAAE,OAAO,CAAC;CACzC;AAMD,wBAAgB,oBAAoB,CAAC,KAAK,EACtC,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,KAAK,EACf,OAAO,CAAC,EAAE,2BAA2B,GACtC,KAAK,CA2BP"}

package/dist/shared/opencode-config-dir-types.d.ts

@@ -0,0 +1,14 @@
+export type OpenCodeBinaryType = "opencode" | "opencode-desktop";
+export type OpenCodeConfigDirOptions = {
+    binary: OpenCodeBinaryType;
+    version?: string | null;
+    checkExisting?: boolean;
+};
+export type OpenCodeConfigPaths = {
+    configDir: string;
+    configJson: string;
+    configJsonc: string;
+    packageJson: string;
+    omoConfig: string;
+};
+//# sourceMappingURL=opencode-config-dir-types.d.ts.map

package/dist/shared/opencode-config-dir-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-config-dir-types.d.ts","sourceRoot":"","sources":["../../src/shared/opencode-config-dir-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,kBAAkB,CAAC;AAEjE,MAAM,MAAM,wBAAwB,GAAG;IACnC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACrB,CAAC"}

package/dist/shared/opencode-config-dir.d.ts

@@ -0,0 +1,57 @@
+import type { OpenCodeConfigDirOptions, OpenCodeConfigPaths } from "./opencode-config-dir-types";
+export type { OpenCodeBinaryType, OpenCodeConfigDirOptions, OpenCodeConfigPaths, } from "./opencode-config-dir-types";
+/**
+ * OpenCode's GLOBAL config directory: `$XDG_CONFIG_HOME/opencode`, falling
+ * back to `~/.config/opencode` (on every platform, Windows included — OpenCode
+ * does not use %APPDATA%).
+ *
+ * This helper names the loader's XDG layer, not every OpenCode surface called
+ * "config". In 1.18.30, `Global.Path.config` is the pure-XDG path
+ * (`packages/core/src/global.ts:13`) and the loader merges it once at
+ * `packages/opencode/src/config/config.ts:412-413`. Its later directories loop
+ * accepts only `.opencode` paths or the exact `OPENCODE_CONFIG_DIR` value
+ * (`config.ts:437-441`), so the XDG layer is skipped there and the env path is
+ * merged last. The detector mirrors that loader order via
+ * {@link getOpenCodeConfigDirs}.
+ *
+ * Service consumers see a different value: `Global.make()` injects
+ * `Flag.OPENCODE_CONFIG_DIR ?? Path.config` as `config`
+ * (`packages/core/src/global.ts:64`), so setting the env var replaces the
+ * service's value even though the loader still merges the XDG layer.
+ */
+export declare function getOpenCodeGlobalConfigDir(): string;
+/**
+ * The single directory Magic Context WRITES its OpenCode-side config into.
+ *
+ * `OPENCODE_CONFIG_DIR` wins here on purpose: among the directories OpenCode
+ * reads it has the highest precedence, so a setting written there is the one
+ * that takes effect. Do NOT use this to decide what OpenCode RESOLVED — for
+ * that you must read every directory in {@link getOpenCodeConfigDirs}, because
+ * a value the user set in the global directory is still live when
+ * `OPENCODE_CONFIG_DIR` points somewhere that does not override it.
+ */
+export declare function getOpenCodeConfigDir(_options: OpenCodeConfigDirOptions): string;
+export declare function getOpenCodeConfigPaths(options: OpenCodeConfigDirOptions): OpenCodeConfigPaths;
+/**
+ * Every user-tier directory OpenCode reads config from, ordered from LOWEST to
+ * HIGHEST precedence — later entries override earlier ones, which is the order
+ * OpenCode merges them in.
+ *
+ * Verified against the opencode 1.18.30 binary (`ConfigPaths.directories` plus
+ * the global loader in `Config.loadInstanceState`) and confirmed on a live host
+ * with `opencode debug config`:
+ *
+ *   1. `$XDG_CONFIG_HOME/opencode` — always read, whatever the environment says
+ *   2. `~/.opencode`               — always scanned, even outside a project
+ *   3. `$OPENCODE_CONFIG_DIR`      — appended last, so it wins ties
+ *
+ * The important part is that entry 3 is an ADDITION, not a replacement. A
+ * launcher that exports `OPENCODE_CONFIG_DIR` to a directory holding only
+ * plugin scaffolding does not stop OpenCode from reading the user's real
+ * config in entry 1 — so neither may we.
+ *
+ * Project-level directories are deliberately not included: they depend on the
+ * working directory and are resolved by the caller that knows it.
+ */
+export declare function getOpenCodeConfigDirs(): string[];
+//# sourceMappingURL=opencode-config-dir.d.ts.map

package/dist/shared/opencode-config-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-config-dir.d.ts","sourceRoot":"","sources":["../../src/shared/opencode-config-dir.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEjG,YAAY,EACR,kBAAkB,EAClB,wBAAwB,EACxB,mBAAmB,GACtB,MAAM,6BAA6B,CAAC;AAcrC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAMnD;AAWD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,wBAAwB,GAAG,MAAM,CAE/E;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,wBAAwB,GAAG,mBAAmB,CAS7F;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAKhD"}

package/dist/shared/opencode-db-path.d.ts

@@ -0,0 +1,68 @@
+export type OpenCodeDbPathSource = "OPENCODE_DB" | "channel" | "default" | "discovered";
+export type OpenCodeHostGeneration = "v1" | "v2";
+export type OpenCodeStoreGeneration = OpenCodeHostGeneration | "unknown";
+export interface ResolveOpenCodeDbPathOptions {
+    dataHome?: string;
+    channel?: string;
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * Decide the host generation from the version the executable reports, never
+ * from its name (the public installer places OpenCode 2 at
+ * `~/.opencode/bin/opencode` with a tiny `opencode2` shim beside it). The raw
+ * `--version` stdout carries a program-name prefix ("opencode v2.0.12"), so the
+ * major is the first digit run, not `parseInt` of the whole string.
+ *
+ * OpenCode 2's pre-GA betas were published under the old scope as
+ * `@opencode-ai/*@0.0.0-beta-<n>` (verified: `0.0.0-beta-19234` ships the V2
+ * `host`/`promise`/`effect` contract and the `compaction` hook); at GA the line
+ * moved to `@opencode/*@2.0.x`. A major of 0 therefore does not mean 1.x: the
+ * beta and dev pre-release shapes are OpenCode 2.
+ */
+export declare function openCodeHostGenerationFromVersion(version: string | null | undefined): OpenCodeHostGeneration;
+export interface OpenCodeStoreSchemaDatabase {
+    prepare(sql: string): {
+        all(...params: unknown[]): unknown[];
+    };
+}
+export interface OpenCodeDbPathResolution {
+    path: string;
+    source: OpenCodeDbPathSource;
+    channel: string | null;
+}
+export interface OpenCodeDbReadFailure extends OpenCodeDbPathResolution {
+    message: string;
+}
+/** Match OpenCode 2's filename table and strip path separators from custom channels. */
+export declare function sourceOpenCodeDatabaseFilename(hostGeneration: OpenCodeHostGeneration, channel: string, env?: NodeJS.ProcessEnv): string;
+/**
+ * Resolve the store for one host generation. The default is the historical v1
+ * resolver, including candidate discovery and all existing diagnostic text.
+ */
+export declare function resolveOpenCodeDbPath(hostGeneration?: OpenCodeHostGeneration, options?: ResolveOpenCodeDbPathOptions): OpenCodeDbPathResolution;
+/** Whether the schema has the legacy message tables required by v1-only readers. */
+export declare function hasV1MessageTables(db: OpenCodeStoreSchemaDatabase, schema?: "main" | "oc_backfill"): boolean;
+/**
+ * Detect the persisted host schema.
+ *
+ * `session_message` does NOT identify v2: OpenCode 1.18.x ships that table beside `message`
+ * and `part` (verified against a live 1.18.30 store, pinned in this module's tests). Only the
+ * ABSENCE of the v1 message tables identifies a v2 store, so a v1 host is never mistaken for
+ * a v2 one. A store carrying neither is a host that has not written its schema yet.
+ */
+export declare function detectOpenCodeStoreGeneration(db: OpenCodeStoreSchemaDatabase, schema?: "main" | "oc_backfill"): OpenCodeStoreGeneration;
+/** Refuse before a generation-specific query can read the other host's schema. */
+export declare function assertOpenCodeStoreGeneration(db: OpenCodeStoreSchemaDatabase, expected: OpenCodeHostGeneration, path: string, schema?: "main" | "oc_backfill"): void;
+export declare function openCodeDbPathExists(resolution?: OpenCodeDbPathResolution): boolean;
+export declare function getOpenCodeDbProbeDescriptions(resolution?: OpenCodeDbPathResolution): string[];
+export declare function formatOpenCodeDbMissingBanner(resolution?: OpenCodeDbPathResolution): string;
+export declare function formatOpenCodeDbMissingStatusLine(resolution?: OpenCodeDbPathResolution): string;
+export declare function formatOpenCodeDbDoctorLine(resolution?: OpenCodeDbPathResolution): string;
+export declare function formatOpenCodeDbReadFailureStatusLine(failure: OpenCodeDbReadFailure): string;
+export declare function recordOpenCodeDbReadFailure(resolution: OpenCodeDbPathResolution, error: unknown): OpenCodeDbReadFailure;
+export declare function clearOpenCodeDbReadFailure(path?: string): void;
+export declare function getOpenCodeDbReadFailure(): OpenCodeDbReadFailure | null;
+export declare function claimOpenCodeDbDiagnosticOnce(surface: string, resolution: OpenCodeDbPathResolution): boolean;
+/** Test-only reset for process memoization and once-only diagnostics. */
+export declare function resetOpenCodeDbPathStateForTesting(): void;
+//# sourceMappingURL=opencode-db-path.d.ts.map

package/dist/shared/opencode-db-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode-db-path.d.ts","sourceRoot":"","sources":["../../src/shared/opencode-db-path.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;AACxF,MAAM,MAAM,sBAAsB,GAAG,IAAI,GAAG,IAAI,CAAC;AACjD,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,4BAA4B;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iCAAiC,CAC7C,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,sBAAsB,CAKxB;AAED,MAAM,WAAW,2BAA2B;IACxC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,GAAG,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAA;KAAE,CAAC;CAClE;AAED,MAAM,WAAW,wBAAwB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAsB,SAAQ,wBAAwB;IACnE,OAAO,EAAE,MAAM,CAAC;CACnB;AAwGD,wFAAwF;AACxF,wBAAgB,8BAA8B,CAC1C,cAAc,EAAE,sBAAsB,EACtC,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAM,CAAC,UAAwB,GACrC,MAAM,CAoBR;AAmBD;;;GAGG;AACH,wBAAgB,qBAAqB,CACjC,cAAc,GAAE,sBAA6B,EAC7C,OAAO,GAAE,4BAAiC,GAC3C,wBAAwB,CAuB1B;AAcD,oFAAoF;AACpF,wBAAgB,kBAAkB,CAC9B,EAAE,EAAE,2BAA2B,EAC/B,MAAM,GAAE,MAAM,GAAG,aAAsB,GACxC,OAAO,CAGT;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CACzC,EAAE,EAAE,2BAA2B,EAC/B,MAAM,GAAE,MAAM,GAAG,aAAsB,GACxC,uBAAuB,CAOzB;AAwBD,kFAAkF;AAClF,wBAAgB,6BAA6B,CACzC,EAAE,EAAE,2BAA2B,EAC/B,QAAQ,EAAE,sBAAsB,EAChC,IAAI,EAAE,MAAM,EACZ,MAAM,GAAE,MAAM,GAAG,aAAsB,GACxC,IAAI,CAYN;AAED,wBAAgB,oBAAoB,CAChC,UAAU,GAAE,wBAAkD,GAC/D,OAAO,CAET;AAED,wBAAgB,8BAA8B,CAC1C,UAAU,GAAE,wBAAkD,GAC/D,MAAM,EAAE,CAgBV;AAMD,wBAAgB,6BAA6B,CACzC,UAAU,GAAE,wBAAkD,GAC/D,MAAM,CAER;AAED,wBAAgB,iCAAiC,CAC7C,UAAU,GAAE,wBAAkD,GAC/D,MAAM,CAER;AAED,wBAAgB,0BAA0B,CACtC,UAAU,GAAE,wBAAkD,GAC/D,MAAM,CAER;AAED,wBAAgB,qCAAqC,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAE5F;AAED,wBAAgB,2BAA2B,CACvC,UAAU,EAAE,wBAAwB,EACpC,KAAK,EAAE,OAAO,GACf,qBAAqB,CAIvB;AAED,wBAAgB,0BAA0B,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAE9D;AAED,wBAAgB,wBAAwB,IAAI,qBAAqB,GAAG,IAAI,CAEvE;AAED,wBAAgB,6BAA6B,CACzC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,wBAAwB,GACrC,OAAO,CAKT;AAED,yEAAyE;AACzE,wBAAgB,kCAAkC,IAAI,IAAI,CAIzD"}

package/dist/shared/pi-executable.d.ts

@@ -0,0 +1,6 @@
+export type PiExecutableHarnessKind = "pi";
+/** Executable images recognized as Pi-compatible hosts. */
+export declare const PI_IMAGE_NAMES: Set<string>;
+/** Classify a process title or executable path using the shared Pi image vocabulary. */
+export declare function piHarnessKindFromExecutable(value: string | undefined): PiExecutableHarnessKind | undefined;
+//# sourceMappingURL=pi-executable.d.ts.map

package/dist/shared/pi-executable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-executable.d.ts","sourceRoot":"","sources":["../../src/shared/pi-executable.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAE3C,2DAA2D;AAC3D,eAAO,MAAM,cAAc,aAA4B,CAAC;AAExD,wFAAwF;AACxF,wBAAgB,2BAA2B,CACvC,KAAK,EAAE,MAAM,GAAG,SAAS,GAC1B,uBAAuB,GAAG,SAAS,CAWrC"}

package/dist/shared/plugin-package-version.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Version of the Magic Context package this code was loaded from.
+ *
+ * The server and the TUI each call this from their own loaded copy, and the
+ * status RPC carries the server's answer to the TUI. After an update the two
+ * can differ (OpenCode keeps running the copy it started with), and comparing
+ * the two values is how the status dialog tells the user to restart.
+ *
+ * Found by walking up from this module to the nearest `package.json` carrying
+ * the package's name, which works for the source tree, the built `dist/`
+ * bundle and an npm cache install alike. Null when no such file is readable.
+ */
+export declare function pluginPackageVersion(moduleUrl?: string): string | null;
+//# sourceMappingURL=plugin-package-version.d.ts.map

package/dist/shared/plugin-package-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-package-version.d.ts","sourceRoot":"","sources":["../../src/shared/plugin-package-version.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,GAAE,MAAwB,GAAG,MAAM,GAAG,IAAI,CA+BvF"}

package/dist/shared/project-directory-key.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Normalize Windows-formatted directory paths consistently, even on a non-Windows OS.
+ *
+ * Spelling only, no filesystem access: separators become `/`, the `\\?\` and
+ * `\\?\UNC\` long-path prefixes are dropped, a trailing separator is removed and
+ * the result is lowercased, because Windows paths are case-insensitive. A POSIX
+ * path is resolved to an absolute path, which also drops a trailing slash.
+ */
+export declare function projectDirectoryKey(directory: string): string;
+/**
+ * One spelling for a project directory, shared by everything that has to agree
+ * on it across processes (the RPC server that writes its discovery file and the
+ * TUI that looks the file up).
+ *
+ * The filesystem's own answer comes first where the directory exists:
+ * `realpathSync.native` resolves symlinks (macOS `/var` → `/private/var`),
+ * junctions, and Windows 8.3 short names (`AMMINI~1` → the long name). The
+ * result then goes through `projectDirectoryKey`, so drive-letter case,
+ * separators, `\\?\` prefixes and trailing separators cannot make two
+ * spellings of one directory differ. A directory that cannot be resolved (it
+ * no longer exists, or access is denied) falls back to its spelling alone.
+ */
+export declare function canonicalProjectDirectory(directory: string): string;
+/** Test seam: stand in for the filesystem's realpath (for example Windows 8.3 expansion). */
+export declare function __setCanonicalDirectoryRealpathForTests(realpath?: (directory: string) => string): void;
+//# sourceMappingURL=project-directory-key.d.ts.map

package/dist/shared/project-directory-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-directory-key.d.ts","sourceRoot":"","sources":["../../src/shared/project-directory-key.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAS7D;AAKD;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAQnE;AAED,6FAA6F;AAC7F,wBAAgB,uCAAuC,CACnD,QAAQ,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GACzC,IAAI,CAEN"}

package/dist/shared/prompt-context.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Resolve the newest effective prompt context (agent + model + variant) for a
+ * session by reading recent messages from the OpenCode HTTP API.
+ *
+ * WHY: a Channel 2 ceiling nudge sends a synthetic user message via
+ * `promptAsync` with `noReply:false` (it DOES trigger an assistant turn).
+ * OpenCode's `createUserMessage` resolves variant relative to the chosen
+ * agent; passing model alone makes OpenCode pick the default agent whose model
+ * check then fails, bypassing the active variant and busting the provider
+ * prefix cache the prior turn warmed. So we pass agent + model + variant
+ * explicitly, mirroring the resolution AFT/opencode-xtra use for their wake
+ * notifications.
+ *
+ * Walk newest→oldest and merge field-by-field so the newest context-bearing
+ * message wins while older messages only fill fields it did not provide. Read
+ * BOTH the flat shape (`info.providerID`) used by AssistantMessage and the
+ * nested shape (`info.model.providerID`) used by UserMessage.
+ *
+ * Bounded via `query.limit` — the legacy `/session/{id}/message` endpoint
+ * hydrates the ENTIRE session without it (30k-45k messages on large sessions).
+ */
+export interface ResolvedPromptContext {
+    agent?: string;
+    model?: {
+        providerID: string;
+        modelID: string;
+    };
+    variant?: string;
+}
+export declare function resolvePromptContext(client: unknown, sessionId: string): Promise<ResolvedPromptContext | null>;
+//# sourceMappingURL=prompt-context.d.ts.map

package/dist/shared/prompt-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-context.d.ts","sourceRoot":"","sources":["../../src/shared/prompt-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,qBAAqB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAuED,wBAAsB,oBAAoB,CACtC,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAkCvC"}

package/dist/shared/prompt-surface-a1-golden.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared accessors for the A1 prompt-surface golden.
+ *
+ * The golden (`prompt-surface-a1-golden.md`, generated by
+ * `scripts/export-agent-surface.ts`) is read by tests in BOTH packages, and its
+ * section headings are the contract between the generator and those readers.
+ * Keeping the path, the heading strings, and the offset guard here means a
+ * change to the golden's section format is a one-file edit rather than a hunt
+ * across packages.
+ *
+ * This module resolves the golden relative to ITSELF, so consumers never carry
+ * their own `../..` path arithmetic — that arithmetic differs per package and is
+ * exactly the kind of thing that rots silently when files move.
+ */
+export declare const A1_TOOL_SECTION_HEADING = "## 2. Tool surface";
+export declare const A1_HASH_BASELINE_HEADING = "## 3. System-prompt hash baseline";
+export declare function readA1GoldenDocument(): string;
+/**
+ * Locate a golden section heading, refusing to continue when it is absent.
+ *
+ * A bare `indexOf` returns -1 for a missing heading, and `slice(start, -1)`
+ * silently yields an empty (or truncated) section rather than failing: the
+ * golden then parses as ZERO tools and the consuming test passes by comparing
+ * empty to empty. Failing loudly here keeps a malformed golden from reading as a
+ * clean run.
+ */
+export declare function a1GoldenSectionOffset(document: string, heading: string): number;
+//# sourceMappingURL=prompt-surface-a1-golden.d.ts.map

package/dist/shared/prompt-surface-a1-golden.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-surface-a1-golden.d.ts","sourceRoot":"","sources":["../../src/shared/prompt-surface-a1-golden.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AAEH,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAC5D,eAAO,MAAM,wBAAwB,sCAAsC,CAAC;AAE5E,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAM/E"}

package/dist/shared/prompt-surface-runtime.d.ts

@@ -0,0 +1,62 @@
+import type { HarnessId } from "./harness";
+import { type PromptSurfaceConfig, type PromptSurfacePreset } from "./prompt-surface";
+/**
+ * The single source of truth for the mmc_* tools exposed by the prompt surface.
+ * Consumers derive their registries and light-description catalogs from this list
+ * so adding a tool cannot silently skip one prompt-surface integration point.
+ */
+export declare const ACTIVE_TOOL_IDS: readonly ["mmc_reduce", "mmc_expand", "mmc_note", "mmc_memory", "mmc_search"];
+/** @deprecated Use ACTIVE_TOOL_IDS. Kept as an alias for existing consumers. */
+export declare const PROMPT_SURFACE_TOOL_IDS: readonly ["mmc_reduce", "mmc_expand", "mmc_note", "mmc_memory", "mmc_search"];
+export type PromptSurfaceToolId = (typeof ACTIVE_TOOL_IDS)[number];
+export declare const LIGHT_TOOL_DESCRIPTIONS: {
+    readonly mmc_reduce: "Stamp an item as no longer needed for the work ahead. Not a delete: stamping QUEUES it, the item stays readable until Magic Context clears stamped items in one sweep, newest tags are protected, and a cleared item goes to the archive (recent: a [dropped §N§] placeholder; older: removed) recoverable via mmc_expand(tag=N). The question is \"does this need to stay on my desk for what comes next?\" — a file you keep editing stays, the grep that found it goes. Stamp used reads/searches/outputs, acted-on build/test output, redundant dumps, extracted pasted payloads; keep user messages, your own text, unresolved errors, raw evidence, exact wording that may matter. Look at each tag; never blanket-stamp \"1-50\". Grammar: \"3-5\", \"1,2,9\", \"1-5,8,12-15\".";
+    readonly mmc_expand: "Recover one item with tag=N (a §N§ or dropped placeholder number), not a message ordinal; text or one tool call with full input/output. message=N and start/end are whole-message ordinals from history/search, never tag numbers. Recover raw conversation behind a <session-history> heading or around a mmc_search hit: mmc_expand(start, end) returns [N] U:/A: lines (~15K-token cap; oversized ranges return the head and where to continue). verbose=true lists messages with per-part previews to pick one; message=N returns that message in full, including a tool output released with mmc_reduce. Ranges after the last compartment are your live tail, not expandable.";
+    readonly mmc_note: "Session notes are pending intentions: work you intend to return to, with findings attached (\"take a note\" always qualifies). Not active steps, an executing plan, or restart insurance; a record of how things stand (world-state, a design at a point in time) with nothing you intend to do about it — that goes stale silently; a fact worth keeping is memory, the rest is nothing. First line = title (<80 chars). write saves; read lists rows (note_ids for bodies); update changes one; dismiss retires 1–50. Dismiss a note when its work lands or is abandoned; a queue you never dismiss from stops being read.";
+    readonly mmc_memory: "Durable facts about this project, shared with every agent on it and kept for the months this work lasts; active ones are already in <project-memory> as `#id: fact`. Write one standalone fact when it must not have to be found again — a rule, an architecture fact, a constraint, a config value, a naming convention — especially what cost you turns. A pending intention with evidence is mmc_note, not memory. write (content + category); update one id (content; category optional); archive one or more ids (reason optional); merge two or more ids (content); get 1–20 ids in any status.";
+    readonly mmc_search: "Search the archive — everything that ever happened here that is not on your desk: memories not in <project-memory>, compacted conversation, notes. Phrase query as a natural-language question carrying the exact terms you expect (\"where is the opencode source code path?\", \"why did we choose SQLite over postgres?\", \"how does the historian lease work?\") — a keyword stack finds less. Sources (omit for all): memory (rules, conventions), message (compacted conversation; hits carry ordinals for mmc_expand), note (parked follow-ups). Memory ids alone (`#7234`) resolve directly. from/to restrict every source to an inclusive UTC date range.";
+};
+/**
+ * Preserve the existing full-preset hash exactly while giving other presets a
+ * distinct semantic cache identity, including during any future asset fallback.
+ */
+export declare function promptSurfaceHashMaterial(systemContent: string, preset?: PromptSurfacePreset): string;
+export interface PromptSurfaceGuidanceSelection {
+    /** The configured built-in preset. */
+    preset: PromptSurfacePreset;
+    /** Complete user-authored primary section captured when a model-key epoch starts. */
+    primaryOverride?: string;
+}
+export interface PromptSurfaceRegistrationSelection {
+    preset: PromptSurfacePreset;
+    descriptionFor: (toolId: string, fullDescription: string) => string;
+}
+export interface PromptSurfaceRuntime {
+    resolveRegistration: (config: PromptSurfaceConfig | undefined, modelKey?: string) => PromptSurfaceRegistrationSelection;
+    resolveGuidance: (config: PromptSurfaceConfig | undefined, modelKey: string | undefined) => PromptSurfaceGuidanceSelection;
+}
+export interface CreatePromptSurfaceRuntimeOptions {
+    /** Optional harness tag; retained for call-site compatibility and diagnostics. */
+    harness?: HarnessId;
+    directory?: string;
+    /** Explicit test/integration seam; production derives the USER config directory. */
+    userConfigDirectory?: string;
+    warn: (message: string) => void;
+}
+/**
+ * Create one host-registration runtime. Its warning set is shared by tool
+ * registration and every guidance epoch, so invalid overrides are reported once
+ * instead of on every model call.
+ */
+export declare function createPromptSurfaceRuntime(options: CreatePromptSurfaceRuntimeOptions): PromptSurfaceRuntime;
+export interface PromptSurfaceGuidanceEpochCache {
+    resolve: (sessionId: string, config: PromptSurfaceConfig | undefined, modelKey: string | undefined) => PromptSurfaceGuidanceSelection;
+    clear: (sessionId: string) => void;
+}
+/**
+ * Freeze preset selection and materialized override bytes for one model-key epoch.
+ * Every hook using the same runtime also shares this cache, so a file edit cannot
+ * make the system hook and Rust adapter observe different bytes within one epoch.
+ */
+export declare function createPromptSurfaceGuidanceEpochCache(runtime: PromptSurfaceRuntime): PromptSurfaceGuidanceEpochCache;
+//# sourceMappingURL=prompt-surface-runtime.d.ts.map

package/dist/shared/prompt-surface-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-surface-runtime.d.ts","sourceRoot":"","sources":["../../src/shared/prompt-surface-runtime.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,EACH,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EAE3B,MAAM,kBAAkB,CAAC;AAK1B;;;;GAIG;AACH,eAAO,MAAM,eAAe,+EAMlB,CAAC;AAEX,gFAAgF;AAChF,eAAO,MAAM,uBAAuB,+EAAkB,CAAC;AAEvD,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,eAAO,MAAM,uBAAuB;;;;;;CAM8B,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,yBAAyB,CACrC,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,mBAA4B,GACrC,MAAM,CAIR;AAID,MAAM,WAAW,8BAA8B;IAC3C,sCAAsC;IACtC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,qFAAqF;IACrF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kCAAkC;IAC/C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,KAAK,MAAM,CAAC;CACvE;AAED,MAAM,WAAW,oBAAoB;IACjC,mBAAmB,EAAE,CACjB,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,QAAQ,CAAC,EAAE,MAAM,KAChB,kCAAkC,CAAC;IACxC,eAAe,EAAE,CACb,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,KAC3B,8BAA8B,CAAC;CACvC;AAED,MAAM,WAAW,iCAAiC;IAC9C,kFAAkF;IAClF,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAWD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACtC,OAAO,EAAE,iCAAiC,GAC3C,oBAAoB,CAmGtB;AAQD,MAAM,WAAW,+BAA+B;IAC5C,OAAO,EAAE,CACL,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,KAC3B,8BAA8B,CAAC;IACpC,KAAK,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACtC;AAOD;;;;GAIG;AACH,wBAAgB,qCAAqC,CACjD,OAAO,EAAE,oBAAoB,GAC9B,+BAA+B,CAuBjC"}

package/dist/shared/prompt-surface.d.ts

@@ -0,0 +1,53 @@
+/** The built-in prompt-surface variants. */
+export type PromptSurfacePreset = "full" | "light";
+/**
+ * The configuration consumed by prompt-surface resolution. The schema adds
+ * validation and defaults; this structural type keeps the resolver usable by
+ * every host without importing a config loader.
+ */
+export interface PromptSurfaceConfig {
+    default?: PromptSurfacePreset;
+    models?: Readonly<Record<string, PromptSurfacePreset>>;
+    guidance_override_path?: string;
+    tool_descriptions?: Readonly<Record<string, string>>;
+}
+/** Stable wire identity for the config fields that can alter a served prompt surface. */
+export declare function promptSurfaceConfigIdentity(config: PromptSurfaceConfig | undefined): string;
+export type PromptSurfaceResolutionSource = "exact" | "bare" | "wildcard" | "default";
+/** Validate bare model, provider/model, and provider/* routing keys. */
+export declare function isValidPromptSurfaceModelKey(key: string): boolean;
+export type ModelKeyLookupSource = Exclude<PromptSurfaceResolutionSource, "default">;
+export interface ModelKeyCandidate {
+    key: string;
+    source: ModelKeyLookupSource;
+}
+/**
+ * Return the same progressive model-key candidates used by cache_ttl. The
+ * provider/model boundary is the first slash; the rest of the string remains
+ * the model ID, including additional slashes. Candidates are case-sensitive.
+ *
+ * Known harness provider aliases are checked canonical-first at each specificity,
+ * so one shared config works on every harness and canonical wins on collisions.
+ * Provider wildcards are checked after progressively less-specific model keys,
+ * but before the caller's default. That keeps an exact or base-model override
+ * authoritative while still allowing `provider/*` to cover otherwise-unlisted
+ * models.
+ */
+export declare function modelKeyLookupOrder(modelKey: string | undefined): ModelKeyCandidate[];
+/** Resolve one per-model value using the shared cache_ttl lookup walk. */
+export declare function resolveModelConfigValue<T>(values: Readonly<Record<string, T>> | undefined, modelKey: string | undefined): {
+    value: T;
+    source: ModelKeyLookupSource;
+} | undefined;
+/**
+ * Resolve the prompt preset for a model. Invalid or missing model keys use the
+ * configured default and are reported as a default resolution rather than a
+ * partial match.
+ */
+export declare function resolvePromptSurface(config: PromptSurfaceConfig | undefined, modelKey: string | undefined): {
+    preset: PromptSurfacePreset;
+    source: PromptSurfaceResolutionSource;
+};
+/** Resolve a cache_ttl-style value with the shared model-key walk. */
+export declare function resolveModelConfigOrDefault<T>(values: Readonly<Record<string, T>>, modelKey: string | undefined, fallback: T): T;
+//# sourceMappingURL=prompt-surface.d.ts.map

package/dist/shared/prompt-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-surface.d.ts","sourceRoot":"","sources":["../../src/shared/prompt-surface.ts"],"names":[],"mappings":"AAEA,4CAA4C;AAC5C,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC;IACvD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACxD;AAED,yFAAyF;AACzF,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,mBAAmB,GAAG,SAAS,GAAG,MAAM,CAW3F;AAED,MAAM,MAAM,6BAA6B,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;AAEtF,wEAAwE;AACxE,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAyBjE;AAED,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,6BAA6B,EAAE,SAAS,CAAC,CAAC;AAErF,MAAM,WAAW,iBAAiB;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,oBAAoB,CAAC;CAChC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,EAAE,CAoCrF;AAED,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,CAAC,EACrC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,SAAS,EAC/C,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC7B;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,MAAM,EAAE,oBAAoB,CAAA;CAAE,GAAG,SAAS,CAWxD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAChC,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC7B;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,MAAM,EAAE,6BAA6B,CAAA;CAAE,CASxE;AAED,sEAAsE;AACtE,wBAAgB,2BAA2B,CAAC,CAAC,EACzC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EACnC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,CAAC,GACZ,CAAC,CAEH"}

package/dist/shared/provider-response-completion.d.ts

@@ -0,0 +1,12 @@
+/** Failure markers take precedence over a completion timestamp or token usage. */
+export declare function providerResponseFailed(input: {
+    finish?: unknown;
+    error?: unknown;
+}): boolean;
+/** A terminal, non-failed assistant response can refresh a cache without usage. */
+export declare function isSuccessfulProviderCompletion(input: {
+    completedAt?: unknown;
+    finish?: unknown;
+    error?: unknown;
+}): boolean;
+//# sourceMappingURL=provider-response-completion.d.ts.map

package/dist/shared/provider-response-completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-response-completion.d.ts","sourceRoot":"","sources":["../../src/shared/provider-response-completion.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAM5F;AAED,mFAAmF;AACnF,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAQV"}

package/dist/shared/record-type-guard.d.ts

@@ -0,0 +1,2 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=record-type-guard.d.ts.map

package/dist/shared/record-type-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-type-guard.d.ts","sourceRoot":"","sources":["../../src/shared/record-type-guard.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE"}