@stigmer/runner 0.1.0-dev.20261017020314.g644422724c27

package/dist/shared/model-pricing-data.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Model pricing data — fetched from the model registry API and cached.
+ *
+ * On first access, fetches the full model registry, filters to models
+ * with pricing info, and caches the result. Falls back to conservative
+ * default pricing if the API is unreachable.
+ */
+export interface ModelPricing {
+    readonly model: string;
+    readonly displayName: string;
+    readonly costTier: string;
+    readonly inputPricePerMillion: number;
+    readonly outputPricePerMillion: number;
+    readonly cacheWritePricePerMillion: number;
+    readonly cacheReadPricePerMillion: number;
+}
+export declare const DEFAULT_PRICING: ModelPricing;
+export declare function getPricingTable(): Promise<readonly ModelPricing[]>;
+/** Exposed for testing — resets the in-memory cache. */
+export declare function _resetPricingCache(): void;

package/dist/shared/model-pricing-data.js

@@ -0,0 +1,82 @@
+/**
+ * Model pricing data — fetched from the model registry API and cached.
+ *
+ * On first access, fetches the full model registry, filters to models
+ * with pricing info, and caches the result. Falls back to conservative
+ * default pricing if the API is unreachable.
+ */
+import { resolveModelRegistryUrl, buildRegistryHeaders, REGISTRY_RETRY_POLICY, } from "./registry-endpoint.js";
+import { fetchWithRetry } from "./http-retry.js";
+const CACHE_TTL_MS = 3_600_000;
+// Failed fetches are cached much shorter than successes (the model-registry.ts
+// policy): a transient failure must not pin DEFAULT_PRICING — wrong rates for
+// cost tracking — for a full hour.
+const FAILURE_CACHE_TTL_MS = 60_000;
+export const DEFAULT_PRICING = {
+    model: "unknown",
+    displayName: "Unknown",
+    costTier: "standard",
+    inputPricePerMillion: 1.25,
+    outputPricePerMillion: 6.00,
+    cacheWritePricePerMillion: 1.25,
+    cacheReadPricePerMillion: 0.25,
+};
+let cache = null;
+let inflightFetch = null;
+function parsePricingTable(json) {
+    if (!json || typeof json !== "object")
+        return [];
+    const models = json.models;
+    if (!Array.isArray(models))
+        return [];
+    return models
+        .filter((m) => m.pricing != null)
+        .map((m) => ({
+        model: m.id,
+        displayName: m.displayName,
+        costTier: m.costTier ?? "standard",
+        inputPricePerMillion: m.pricing.inputPricePerMillion,
+        outputPricePerMillion: m.pricing.outputPricePerMillion,
+        cacheWritePricePerMillion: m.pricing.cacheWritePricePerMillion,
+        cacheReadPricePerMillion: m.pricing.cacheReadPricePerMillion,
+    }));
+}
+async function fetchFromApi() {
+    const res = await fetchWithRetry(resolveModelRegistryUrl(), { headers: buildRegistryHeaders() }, REGISTRY_RETRY_POLICY);
+    if (!res.ok)
+        throw new Error(`Model registry fetch failed: ${res.status}`);
+    const data = await res.json();
+    const table = parsePricingTable(data);
+    if (table.length === 0) {
+        throw new Error("Model registry returned no models with pricing");
+    }
+    return table;
+}
+export async function getPricingTable() {
+    if (cache && Date.now() < cache.expiresAt) {
+        return cache.data;
+    }
+    if (inflightFetch)
+        return inflightFetch;
+    inflightFetch = fetchFromApi()
+        .then((data) => {
+        cache = { data, expiresAt: Date.now() + CACHE_TTL_MS };
+        return data;
+    })
+        .catch((err) => {
+        console.warn(`Failed to fetch model registry, using default pricing: ${err}`);
+        const fallback = [DEFAULT_PRICING];
+        cache = { data: fallback, expiresAt: Date.now() + FAILURE_CACHE_TTL_MS };
+        return fallback;
+    })
+        .finally(() => {
+        inflightFetch = null;
+    });
+    return inflightFetch;
+}
+/** Exposed for testing — resets the in-memory cache. */
+export function _resetPricingCache() {
+    cache = null;
+    inflightFetch = null;
+}
+//# sourceMappingURL=model-pricing-data.js.map

package/dist/shared/model-pricing-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-pricing-data.js","sourceRoot":"","sources":["../../src/shared/model-pricing-data.ts"],"names":[],"mappings":"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"}

package/dist/shared/model-pricing.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Model pricing lookup and cost computation.
+ */
+import type { ModelPricing } from "./model-pricing-data.js";
+export type { ModelPricing };
+/**
+ * Ensure the pricing map has been populated from the API cache.
+ * Call once at startup or before the first pricing lookup.
+ */
+export declare function ensureLoaded(): Promise<void>;
+export declare function resolveModelId(requestedModel: string): string;
+export declare function getModelPricing(model: string): ModelPricing;
+/**
+ * Compute USD cost for a single turn using disjoint token buckets.
+ */
+export declare function computeTurnCost(pricing: ModelPricing, inputTokens: number, outputTokens: number, cacheWriteTokens: number, cacheReadTokens: number): number;

package/dist/shared/model-pricing.js

@@ -0,0 +1,46 @@
+/**
+ * Model pricing lookup and cost computation.
+ */
+import { getPricingTable, DEFAULT_PRICING } from "./model-pricing-data.js";
+let pricingByModel = null;
+let initPromise = null;
+/**
+ * Ensure the pricing map has been populated from the API cache.
+ * Call once at startup or before the first pricing lookup.
+ */
+export async function ensureLoaded() {
+    if (initPromise)
+        return initPromise;
+    initPromise = getPricingTable().then((table) => {
+        pricingByModel = new Map(table.map((entry) => [entry.model, entry]));
+    });
+    return initPromise;
+}
+function getMap() {
+    if (!pricingByModel) {
+        console.warn("Model pricing accessed before ensureLoaded() — returning empty map");
+        return new Map();
+    }
+    return pricingByModel;
+}
+export function resolveModelId(requestedModel) {
+    if (!requestedModel || requestedModel === "default")
+        return "default";
+    if (getMap().has(requestedModel))
+        return requestedModel;
+    console.warn(`Model "${requestedModel}" not in pricing registry (${getMap().size} models), falling back to "default"`);
+    return "default";
+}
+export function getModelPricing(model) {
+    return getMap().get(model) ?? { ...DEFAULT_PRICING, model };
+}
+/**
+ * Compute USD cost for a single turn using disjoint token buckets.
+ */
+export function computeTurnCost(pricing, inputTokens, outputTokens, cacheWriteTokens, cacheReadTokens) {
+    return (inputTokens * pricing.inputPricePerMillion
+        + outputTokens * pricing.outputPricePerMillion
+        + cacheWriteTokens * pricing.cacheWritePricePerMillion
+        + cacheReadTokens * pricing.cacheReadPricePerMillion) / 1_000_000;
+}
+//# sourceMappingURL=model-pricing.js.map

package/dist/shared/model-pricing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-pricing.js","sourceRoot":"","sources":["../../src/shared/model-pricing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAK3E,IAAI,cAAc,GAAqC,IAAI,CAAC;AAC5D,IAAI,WAAW,GAAyB,IAAI,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,WAAW;QAAE,OAAO,WAAW,CAAC;IAEpC,WAAW,GAAG,eAAe,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QAC7C,cAAc,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,SAAS,MAAM;IACb,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,oEAAoE,CAAC,CAAC;QACnF,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,cAAsB;IACnD,IAAI,CAAC,cAAc,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACtE,IAAI,MAAM,EAAE,CAAC,GAAG,CAAC,cAAc,CAAC;QAAE,OAAO,cAAc,CAAC;IACxD,OAAO,CAAC,IAAI,CACV,UAAU,cAAc,8BAA8B,MAAM,EAAE,CAAC,IAAI,qCAAqC,CACzG,CAAC;IACF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,OAAO,MAAM,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,eAAe,EAAE,KAAK,EAAE,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAqB,EACrB,WAAmB,EACnB,YAAoB,EACpB,gBAAwB,EACxB,eAAuB;IAEvB,OAAO,CACL,WAAW,GAAG,OAAO,CAAC,oBAAoB;UACxC,YAAY,GAAG,OAAO,CAAC,qBAAqB;UAC5C,gBAAgB,GAAG,OAAO,CAAC,yBAAyB;UACpD,eAAe,GAAG,OAAO,CAAC,wBAAwB,CACrD,GAAG,SAAS,CAAC;AAChB,CAAC"}

package/dist/shared/model-registry.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Model registry — provider lookup, economy-tier model derivation, and
+ * model capability resolution.
+ *
+ * Fetches the model registry from the runner's control plane (see
+ * registry-endpoint.ts for endpoint resolution — same endpoint as
+ * model-pricing-data.ts) and uses `costTier` + `harness` fields to
+ * dynamically resolve economy-tier models for extraction/summarization,
+ * plus `capabilities` catalog metadata for per-model capability lookups
+ * (getModelVisionCapability) and the request facts a native row states
+ * (getNativeRequestProfile).
+ */
+/**
+ * How a model reasons, as its registry row declares it (the proto's
+ * `ModelCapabilities`):
+ *
+ * - `shape` is `"adaptive"` when the row declares `adaptiveThinking` (depth
+ *   adapts; Anthropic `{type: "adaptive"}`), `"budget"` when it declares only
+ *   `thinking` (a fixed token budget; `{type: "enabled", budget_tokens}`),
+ *   and `"none"` otherwise. Adaptive wins where a row declares both: it is
+ *   the current form, and the budget form is deprecated on models that take
+ *   both.
+ * - `required` is the row's `thinkingRequired`, tri-state: `true` for a
+ *   model that always thinks and refuses to be told not to, `false` for one
+ *   that accepts an explicit `{type: "disabled"}`, `undefined` for a row that
+ *   was never assessed. The absence matters: a runner that read it as
+ *   `false` would send `disabled` to a model that refuses it.
+ */
+export interface NativeThinkingProfile {
+    readonly shape: "budget" | "adaptive" | "none";
+    readonly required: boolean | undefined;
+}
+/**
+ * The request facts a native-harness model's registry row states, read by
+ * the native execution turn when it builds its model client. One home for
+ * what the provider needs to be told about a model (the runner never names
+ * models in code); a field is `undefined` when the row does not state it.
+ */
+export interface NativeRequestProfile {
+    readonly maxOutputTokens: number | undefined;
+    readonly thinking: NativeThinkingProfile;
+}
+/**
+ * Whether one engine's registry section lists a model by its id: a model a
+ * subagent's run defaults or a plugin agent's file names runs only then
+ * (an alias such as `sonnet` is no id and never matches). False when the
+ * registry is empty (its fetch failed), so the subagent runs the turn's
+ * model rather than one nobody checked.
+ */
+export declare function isModelListedFor(modelId: string, harness: "native" | "cursor"): Promise<boolean>;
+/**
+ * Derive the recommended economy-tier model for summarization/classification
+ * tasks, given a primary model name. Thin alias over getEconomyModel — the
+ * registry (costTier=economy, harness=native, same provider preferred) drives
+ * the choice; no model names are hardcoded here. See getEconomyModel for the
+ * resolution order.
+ */
+export declare function getSummarizationModel(primaryModel: string): Promise<string>;
+/**
+ * Resolve the economy-tier model for a given primary model by querying
+ * the registry for costTier=economy + same provider + harness=native.
+ *
+ * Resolution order:
+ * 1. Find the primary model's provider in the registry
+ * 2. Find an economy-tier native model from that provider
+ * 3. Cross-provider fallback: any economy-tier native model
+ * 4. Last resort: return the primary model itself
+ */
+export declare function getEconomyModel(primaryModel: string): Promise<string>;
+export declare function getDefaultModel(): Promise<string>;
+/**
+ * Resolve a Stigmer registry model ID to the provider's API model identifier.
+ *
+ * The registry maintains two identifiers per model:
+ *   - `id`: Stigmer canonical ID (e.g., "claude-haiku-4.5")
+ *   - `apiModelId`: Provider API identifier (e.g., "claude-haiku-4-5-20251001")
+ *
+ * This function performs the translation that the proto documentation promises:
+ * "Model reference resolved via the Stigmer model registry."
+ *
+ * Graceful degradation:
+ *   - Registry unavailable → returns the original string unchanged
+ *   - Model not found in registry → returns the original string unchanged
+ *   - Model found but has no apiModelId → returns the registry `id` unchanged
+ */
+export declare function resolveToApiModelId(registryId: string): Promise<string>;
+/**
+ * Look up a model's vision capability from the registry's `capabilities`
+ * catalog metadata. Returns the tri-state the vision policy expects
+ * (attachment-vision.ts): `false` only when the registry explicitly says the
+ * model cannot see images; `undefined` whenever the answer is unknown —
+ * capability never assessed, model not in the registry, registry
+ * unreachable, or no concrete model name (the Cursor harness's ""/"default"
+ * Auto pool). Callers gate on the explicit `false` only, so every unknown
+ * degrades to today's behavior instead of blocking images.
+ *
+ * Matches by registry `id` OR `apiModelId`: getDefaultModel() hands the
+ * deep-agent harness the provider API id, while status.runConfig.modelName
+ * carries the registry id, so both forms arrive here.
+ */
+export declare function getModelVisionCapability(modelName: string): Promise<boolean | undefined>;
+/**
+ * The native-harness row's request facts for a model, matched by registry
+ * `id` or `apiModelId` (the turn's resolved settings carry the former, the
+ * registry default the latter) and filtered to `harness: native`: ids such
+ * as `claude-sonnet-5` exist on both harnesses, and only the native row
+ * describes the native request. `undefined` when the registry is
+ * unreachable, the name is empty or Auto, or no native row matches — the
+ * caller then sends what it sent before.
+ */
+export declare function getNativeRequestProfile(modelName: string): Promise<NativeRequestProfile | undefined>;
+/** Exposed for testing — resets the in-memory cache. */
+export declare function _resetRegistryCache(): void;

package/dist/shared/model-registry.js

@@ -0,0 +1,250 @@
+/**
+ * Model registry — provider lookup, economy-tier model derivation, and
+ * model capability resolution.
+ *
+ * Fetches the model registry from the runner's control plane (see
+ * registry-endpoint.ts for endpoint resolution — same endpoint as
+ * model-pricing-data.ts) and uses `costTier` + `harness` fields to
+ * dynamically resolve economy-tier models for extraction/summarization,
+ * plus `capabilities` catalog metadata for per-model capability lookups
+ * (getModelVisionCapability) and the request facts a native row states
+ * (getNativeRequestProfile).
+ */
+import { resolveModelRegistryUrl, buildRegistryHeaders, REGISTRY_RETRY_POLICY, } from "./registry-endpoint.js";
+import { fetchWithRetry } from "./http-retry.js";
+const CACHE_TTL_MS = 3_600_000;
+// Failed fetches are cached much shorter than successes: a transient failure
+// must not poison id -> apiModelId resolution (and thereby fail every model
+// call with LLM_MODEL_NOT_FOUND) for a full hour.
+const FAILURE_CACHE_TTL_MS = 60_000;
+let cache = null;
+let inflightFetch = null;
+function parseRegistry(json) {
+    if (!json || typeof json !== "object")
+        return [];
+    const models = json.models;
+    if (!Array.isArray(models))
+        return [];
+    return models
+        .filter((m) => typeof m.id === "string" && typeof m.provider === "string")
+        .map((m) => ({
+        id: m.id,
+        apiModelId: typeof m.apiModelId === "string" ? m.apiModelId : undefined,
+        provider: m.provider,
+        costTier: m.costTier ?? "standard",
+        harness: m.harness ?? "native",
+        featured: !!m.featured,
+        visionCapability: parseVisionCapability(m.capabilities),
+        maxOutputTokens: parsePositiveInteger(m.maxOutputTokens),
+        thinking: parseThinkingProfile(m.capabilities),
+    }));
+}
+function parsePositiveInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : undefined;
+}
+/**
+ * The row's thinking form. A missing or malformed `capabilities` block
+ * declares no shape and leaves `required` unknown, the same tri-state
+ * posture as {@link parseVisionCapability}.
+ */
+function parseThinkingProfile(capabilities) {
+    if (!capabilities || typeof capabilities !== "object")
+        return { shape: "none", required: undefined };
+    const flags = capabilities;
+    const shape = flags.adaptiveThinking === true ? "adaptive" : flags.thinking === true ? "budget" : "none";
+    const required = typeof flags.thinkingRequired === "boolean" ? flags.thinkingRequired : undefined;
+    return { shape, required };
+}
+/**
+ * Extract `capabilities.vision` preserving the tri-state: a missing or
+ * malformed `capabilities` block stays `undefined` (never coerced to false).
+ */
+function parseVisionCapability(capabilities) {
+    if (!capabilities || typeof capabilities !== "object")
+        return undefined;
+    const vision = capabilities.vision;
+    return typeof vision === "boolean" ? vision : undefined;
+}
+async function fetchRegistry() {
+    const url = resolveModelRegistryUrl();
+    const res = await fetchWithRetry(url, { headers: buildRegistryHeaders() }, REGISTRY_RETRY_POLICY);
+    if (!res.ok)
+        throw new Error(`Model registry fetch failed: ${res.status}`);
+    const data = await res.json();
+    return parseRegistry(data);
+}
+async function getRegistry() {
+    if (cache && Date.now() < cache.expiresAt) {
+        return cache.models;
+    }
+    if (inflightFetch)
+        return inflightFetch;
+    inflightFetch = fetchRegistry()
+        .then((models) => {
+        cache = { models, expiresAt: Date.now() + CACHE_TTL_MS };
+        return models;
+    })
+        .catch((err) => {
+        console.warn(`Failed to fetch model registry from ${resolveModelRegistryUrl()}: ${err}. ` +
+            `Model id resolution degrades to pass-through until the next attempt ` +
+            `(${FAILURE_CACHE_TTL_MS / 1000}s). Check that the control plane is ` +
+            `reachable and, for cloud endpoints, that STIGMER_TOKEN is set.`);
+        cache = { models: [], expiresAt: Date.now() + FAILURE_CACHE_TTL_MS };
+        return [];
+    })
+        .finally(() => {
+        inflightFetch = null;
+    });
+    return inflightFetch;
+}
+/**
+ * Whether one engine's registry section lists a model by its id: a model a
+ * subagent's run defaults or a plugin agent's file names runs only then
+ * (an alias such as `sonnet` is no id and never matches). False when the
+ * registry is empty (its fetch failed), so the subagent runs the turn's
+ * model rather than one nobody checked.
+ */
+export async function isModelListedFor(modelId, harness) {
+    const registry = await getRegistry();
+    return registry.some((m) => m.harness === harness && m.id === modelId);
+}
+/**
+ * Derive the recommended economy-tier model for summarization/classification
+ * tasks, given a primary model name. Thin alias over getEconomyModel — the
+ * registry (costTier=economy, harness=native, same provider preferred) drives
+ * the choice; no model names are hardcoded here. See getEconomyModel for the
+ * resolution order.
+ */
+export async function getSummarizationModel(primaryModel) {
+    return getEconomyModel(primaryModel);
+}
+/**
+ * Resolve the economy-tier model for a given primary model by querying
+ * the registry for costTier=economy + same provider + harness=native.
+ *
+ * Resolution order:
+ * 1. Find the primary model's provider in the registry
+ * 2. Find an economy-tier native model from that provider
+ * 3. Cross-provider fallback: any economy-tier native model
+ * 4. Last resort: return the primary model itself
+ */
+export async function getEconomyModel(primaryModel) {
+    const registry = await getRegistry();
+    if (registry.length === 0) {
+        // Registry unavailable: keep the caller's chosen model rather than
+        // switching to a hardcoded economy model on a possibly-unconfigured
+        // provider. Summarization degrades gracefully to the primary model.
+        console.warn(`Model registry empty — falling back to primary model "${primaryModel}" for economy tier`);
+        return primaryModel;
+    }
+    const primary = registry.find((m) => m.id === primaryModel);
+    const targetProvider = primary?.provider ?? "anthropic";
+    const sameProviderEconomy = registry.find((m) => m.provider === targetProvider && m.costTier === "economy" && m.harness === "native");
+    if (sameProviderEconomy)
+        return sameProviderEconomy.id;
+    const anyEconomy = registry.find((m) => m.costTier === "economy" && m.harness === "native");
+    if (anyEconomy)
+        return anyEconomy.id;
+    if (!primary) {
+        console.warn(`Model "${primaryModel}" not found in registry and no economy fallback available`);
+    }
+    return primaryModel;
+}
+/**
+ * Resolve the default agent execution model from the registry.
+ *
+ * Used when no settings layer named a model (an empty status.runConfig.modelName).
+ * Returns the provider's API model identifier (e.g., "claude-sonnet-4-6"),
+ * not the Stigmer registry ID (e.g., "claude-sonnet-4.6").
+ *
+ * Resolution order:
+ * 1. Featured + standard + native (platform's curated default)
+ * 2. Any standard + native model
+ * 3. Hardcoded fallback (registry unavailable)
+ */
+const FALLBACK_DEFAULT_MODEL = "claude-sonnet-4-6";
+export async function getDefaultModel() {
+    const registry = await getRegistry();
+    if (registry.length === 0) {
+        console.warn(`Model registry empty — using fallback default model "${FALLBACK_DEFAULT_MODEL}"`);
+        return FALLBACK_DEFAULT_MODEL;
+    }
+    const featuredStandard = registry.find((m) => m.featured && m.costTier === "standard" && m.harness === "native");
+    if (featuredStandard)
+        return featuredStandard.apiModelId ?? featuredStandard.id;
+    const anyStandard = registry.find((m) => m.costTier === "standard" && m.harness === "native");
+    if (anyStandard)
+        return anyStandard.apiModelId ?? anyStandard.id;
+    return FALLBACK_DEFAULT_MODEL;
+}
+/**
+ * Resolve a Stigmer registry model ID to the provider's API model identifier.
+ *
+ * The registry maintains two identifiers per model:
+ *   - `id`: Stigmer canonical ID (e.g., "claude-haiku-4.5")
+ *   - `apiModelId`: Provider API identifier (e.g., "claude-haiku-4-5-20251001")
+ *
+ * This function performs the translation that the proto documentation promises:
+ * "Model reference resolved via the Stigmer model registry."
+ *
+ * Graceful degradation:
+ *   - Registry unavailable → returns the original string unchanged
+ *   - Model not found in registry → returns the original string unchanged
+ *   - Model found but has no apiModelId → returns the registry `id` unchanged
+ */
+export async function resolveToApiModelId(registryId) {
+    if (!registryId)
+        return registryId;
+    const registry = await getRegistry();
+    if (registry.length === 0)
+        return registryId;
+    const entry = registry.find((m) => m.id === registryId);
+    if (!entry)
+        return registryId;
+    return entry.apiModelId ?? registryId;
+}
+/**
+ * Look up a model's vision capability from the registry's `capabilities`
+ * catalog metadata. Returns the tri-state the vision policy expects
+ * (attachment-vision.ts): `false` only when the registry explicitly says the
+ * model cannot see images; `undefined` whenever the answer is unknown —
+ * capability never assessed, model not in the registry, registry
+ * unreachable, or no concrete model name (the Cursor harness's ""/"default"
+ * Auto pool). Callers gate on the explicit `false` only, so every unknown
+ * degrades to today's behavior instead of blocking images.
+ *
+ * Matches by registry `id` OR `apiModelId`: getDefaultModel() hands the
+ * deep-agent harness the provider API id, while status.runConfig.modelName
+ * carries the registry id, so both forms arrive here.
+ */
+export async function getModelVisionCapability(modelName) {
+    if (!modelName || modelName === "default")
+        return undefined;
+    const registry = await getRegistry();
+    const entry = registry.find((m) => m.id === modelName || m.apiModelId === modelName);
+    return entry?.visionCapability;
+}
+/**
+ * The native-harness row's request facts for a model, matched by registry
+ * `id` or `apiModelId` (the turn's resolved settings carry the former, the
+ * registry default the latter) and filtered to `harness: native`: ids such
+ * as `claude-sonnet-5` exist on both harnesses, and only the native row
+ * describes the native request. `undefined` when the registry is
+ * unreachable, the name is empty or Auto, or no native row matches — the
+ * caller then sends what it sent before.
+ */
+export async function getNativeRequestProfile(modelName) {
+    if (!modelName || modelName === "default")
+        return undefined;
+    const registry = await getRegistry();
+    const entry = registry.find((m) => m.harness === "native" && (m.id === modelName || m.apiModelId === modelName));
+    if (!entry)
+        return undefined;
+    return { maxOutputTokens: entry.maxOutputTokens, thinking: entry.thinking };
+}
+/** Exposed for testing — resets the in-memory cache. */
+export function _resetRegistryCache() {
+    cache = null;
+    inflightFetch = null;
+}
+//# sourceMappingURL=model-registry.js.map

package/dist/shared/model-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-registry.js","sourceRoot":"","sources":["../../src/shared/model-registry.ts"],"names":[],"mappings":"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"}

package/dist/shared/persist-decision.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Streaming persist decision for a harness turn.
+ *
+ * Harness-agnostic, and both adapters' stream loops read it
+ * (`execute-cursor/turn-stream.ts`, `execute-deep-agent/turn-stream.ts`; the
+ * native orchestrator's own copy of the rule retired with it in #1096):
+ * `shouldPersist = transcriptDirty || scheduler.shouldSendUpdate(eventCount)`.
+ * Both harnesses thus share one cadence model — a discrete state change
+ * flushes immediately, high-frequency token deltas ride a bounded time
+ * cadence.
+ *
+ * One flag, the transcript builder's `dirty` (since #1097). Until then the
+ * decision took three Cursor-named flags — the delta enricher's, the todo
+ * tracker's and the accumulator's — of which two were constant `false` on
+ * both loops once the one builder folded every discrete change; a shape
+ * that named writers which no longer existed.
+ *
+ * Extracted as a single pure function so the stream loop and its unit tests
+ * exercise the same implementation and cannot drift.
+ */
+import type { StreamingUpdateScheduler } from "./streaming-scheduler.js";
+/**
+ * Decide whether to persist the streaming status after a stream event.
+ *
+ * - `transcriptDirty`: a discrete, user-visible change landed on the
+ *   transcript since the last persist (a row started or settled, a sub-agent
+ *   delegated, a todo written, an artifact registered) and must reach the
+ *   live stream now, so short turns are never starved.
+ * - scheduler: the shared StreamingUpdateScheduler carries assistant text and
+ *   model thinking on a bounded time cadence (500ms floor / 5s keepalive),
+ *   avoiding a per-token persist storm.
+ *
+ * After a persist, the caller calls `scheduler.markUpdateSent(eventCount)` so
+ * the cadence resets, and clears the builder's flag as it requests the write.
+ *
+ * @param nowMs Injectable clock forwarded to the scheduler, for tests.
+ */
+export declare function shouldPersistStreamingStatus(transcriptDirty: boolean, scheduler: StreamingUpdateScheduler, eventCount: number, nowMs?: number): boolean;

package/dist/shared/persist-decision.js

@@ -0,0 +1,40 @@
+/**
+ * Streaming persist decision for a harness turn.
+ *
+ * Harness-agnostic, and both adapters' stream loops read it
+ * (`execute-cursor/turn-stream.ts`, `execute-deep-agent/turn-stream.ts`; the
+ * native orchestrator's own copy of the rule retired with it in #1096):
+ * `shouldPersist = transcriptDirty || scheduler.shouldSendUpdate(eventCount)`.
+ * Both harnesses thus share one cadence model — a discrete state change
+ * flushes immediately, high-frequency token deltas ride a bounded time
+ * cadence.
+ *
+ * One flag, the transcript builder's `dirty` (since #1097). Until then the
+ * decision took three Cursor-named flags — the delta enricher's, the todo
+ * tracker's and the accumulator's — of which two were constant `false` on
+ * both loops once the one builder folded every discrete change; a shape
+ * that named writers which no longer existed.
+ *
+ * Extracted as a single pure function so the stream loop and its unit tests
+ * exercise the same implementation and cannot drift.
+ */
+/**
+ * Decide whether to persist the streaming status after a stream event.
+ *
+ * - `transcriptDirty`: a discrete, user-visible change landed on the
+ *   transcript since the last persist (a row started or settled, a sub-agent
+ *   delegated, a todo written, an artifact registered) and must reach the
+ *   live stream now, so short turns are never starved.
+ * - scheduler: the shared StreamingUpdateScheduler carries assistant text and
+ *   model thinking on a bounded time cadence (500ms floor / 5s keepalive),
+ *   avoiding a per-token persist storm.
+ *
+ * After a persist, the caller calls `scheduler.markUpdateSent(eventCount)` so
+ * the cadence resets, and clears the builder's flag as it requests the write.
+ *
+ * @param nowMs Injectable clock forwarded to the scheduler, for tests.
+ */
+export function shouldPersistStreamingStatus(transcriptDirty, scheduler, eventCount, nowMs) {
+    return transcriptDirty || scheduler.shouldSendUpdate(eventCount, nowMs);
+}
+//# sourceMappingURL=persist-decision.js.map

package/dist/shared/persist-decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist-decision.js","sourceRoot":"","sources":["../../src/shared/persist-decision.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,4BAA4B,CAC1C,eAAwB,EACxB,SAAmC,EACnC,UAAkB,EAClB,KAAc;IAEd,OAAO,eAAe,IAAI,SAAS,CAAC,gBAAgB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AAC1E,CAAC"}