@intentface/latch-core 0.9.1

package/dist/memory.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Memory seam.
+ *
+ * An agent that declares `memory` (see `AgentConfig.memory`) gets persistent
+ * cross-session memory when the runtime is composed with a `MemoryProvider`
+ * (`RuntimeConfig.memory`). Core knows nothing about where memories live — the
+ * provider (e.g. `@intentface/latch-memory`) owns storage, retrieval, and the
+ * background extraction/consolidation jobs. Core's only job is the per-turn
+ * wiring: append the provider's compiled-index block to the agent's
+ * instructions and merge its scope-bound tools into the toolset.
+ */
+/**
+ * Who one memory store is about — and who can see it.
+ *
+ * - `agent-user`: one store per (agent, user). The default fit for personal
+ *   agents (a coach's memory of *you*).
+ * - `agent-org`: one store per (agent, org) — all org users share it.
+ * - `user`: one store per user, shared across every agent that declares the
+ *   same scope AND the same `connection` (a different connection silently
+ *   splits the store — validate at the surface, not here).
+ *
+ * Search and consolidation never cross a scope boundary.
+ */
+export type MemoryScope = "agent-user" | "agent-org" | "user";
+/** An agent's memory declaration (`AgentConfig.memory`). */
+export interface MemoryConfig {
+    scope: MemoryScope;
+    /**
+     * The connection (runtime connection-registry name, e.g. `"loredex"`) whose
+     * workspace holds this agent's memory files. The provider opens it itself,
+     * per operation — memory does not require the agent to also list it in
+     * `connections` (though agents typically do).
+     */
+    connection: string;
+    /**
+     * Additional memory levels the background sweep extracts each idle chat
+     * into, beyond (and always implicitly including) `scope`. All levels share
+     * `connection`. The in-chat `memory_save` tool still writes only to `scope`;
+     * extra levels are populated by background extraction and injected/searched
+     * read-side. Readers must treat this as a set that contains `scope` (see the
+     * provider's normalization) — surfaces normalize on save.
+     */
+    extractTo?: MemoryScope[];
+    /**
+     * Markdown index-schema outlines per agent-held level: top-level `##`
+     * section headings (with optional description bullets) that steer what the
+     * background extractor captures and how the consolidator organizes that
+     * level's MEMORY.md. Advisory — the index format itself is unchanged.
+     * The cross-agent `user` level's schema is NOT configured here: it lives as
+     * a shared workspace file (see `USER_SCHEMA_PATH` in the memory package).
+     */
+    schemas?: Partial<Record<"agent-user" | "agent-org", string>>;
+    /** Background extraction tuning (used by the provider's job sweep, not core). */
+    extraction?: {
+        /** Chat idle time before a transcript is eligible for extraction (default 60). */
+        idleMinutes?: number;
+    };
+    /** Background consolidation tuning (used by the provider's job sweep, not core). */
+    consolidation?: {
+        /** Minimum time between consolidations of one scope (default 6). */
+        cooldownHours?: number;
+    };
+}
+/**
+ * The runtime's memory seam (`RuntimeConfig.memory`). Both methods are called
+ * once per turn, only for agents that declare `memory`.
+ */
+export interface MemoryProvider<P> {
+    /**
+     * The always-loaded system block for this scope: the compiled memory index
+     * plus standing usage instructions, or `undefined` when the store is empty
+     * or unreachable. MUST resolve fast (provider-side cache) and MUST NOT
+     * throw — a memory failure degrades to a turn without memory, never a dead
+     * turn (the runtime also guards with a `.catch`).
+     */
+    instructionsFor(args: {
+        principal: P;
+        agent: string;
+        memory: MemoryConfig;
+    }): Promise<string | undefined>;
+    /**
+     * The scope-bound memory tools for this turn (e.g. `memory_search`,
+     * `memory_save`). Returned synchronously — tool `execute` opens connections
+     * lazily. Merged as capability tools, so an agent's `enabledTools`
+     * restriction never hides them.
+     */
+    toolsFor(args: {
+        principal: P;
+        agent: string;
+        memory: MemoryConfig;
+    }): Record<string, unknown>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC;AAE9D,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,WAAW,EAAE,CAAC;IAC1B;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,GAAG,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9D,iFAAiF;IACjF,UAAU,CAAC,EAAE;QACX,kFAAkF;QAClF,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,oFAAoF;IACpF,aAAa,CAAC,EAAE;QACd,oEAAoE;QACpE,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B;;;;;;OAMG;IACH,eAAe,CAAC,IAAI,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,YAAY,CAAC;KACtB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE;QACb,SAAS,EAAE,CAAC,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,YAAY,CAAC;KACtB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7B"}

package/dist/memory.js

@@ -0,0 +1,13 @@
+/**
+ * Memory seam.
+ *
+ * An agent that declares `memory` (see `AgentConfig.memory`) gets persistent
+ * cross-session memory when the runtime is composed with a `MemoryProvider`
+ * (`RuntimeConfig.memory`). Core knows nothing about where memories live — the
+ * provider (e.g. `@intentface/latch-memory`) owns storage, retrieval, and the
+ * background extraction/consolidation jobs. Core's only job is the per-turn
+ * wiring: append the provider's compiled-index block to the agent's
+ * instructions and merge its scope-bound tools into the toolset.
+ */
+export {};
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/message.d.ts

@@ -0,0 +1,46 @@
+import type { UIMessage, UITools, UIDataTypes } from "ai";
+/**
+ * The message model.
+ *
+ * `AppMessage` is the canonical stored unit and the source of truth for a
+ * conversation. It is just a *typed* AI SDK `UIMessage` — so all the stock
+ * stream/persistence helpers (`toUIMessageStream`, `convertToModelMessages`,
+ * `useChat`) work unchanged.
+ *
+ * Two ideas ride on the message instead of in extra tables:
+ *  - the two axes (`visibility`, `sendToModel`) decide who sees a message —
+ *    the model, the end user, both, or neither;
+ *  - the execution facts (usage/cost/model/finishReason) live in `metadata`,
+ *    so there is no separate "steps" table and no duplication.
+ */
+/** Who sees a message on the client projection. */
+export type Visibility = "user" | "internal" | "redacted";
+/** Per-message metadata stamped onto an `AppMessage`. */
+export interface AppMetadata {
+    /** Client-projection axis: shown to the user, internal-only, or redacted. */
+    visibility?: Visibility;
+    /** Model-projection axis: whether `toModelMessages` includes it. */
+    sendToModel?: boolean;
+    /** Resolved model id for this message (e.g. "anthropic/claude-sonnet-4-6"). */
+    model?: string;
+    /** Token usage attributed to producing this message (incl. cached-prompt split). */
+    usage?: {
+        inputTokens?: number;
+        outputTokens?: number;
+        cacheReadTokens?: number;
+        cacheWriteTokens?: number;
+    };
+    /** Computed cost in the account's currency unit. */
+    cost?: number;
+    /** Finish reason from the producing step. */
+    finishReason?: string;
+    /** Server-side creation timestamp (unix ms). */
+    createdAt?: number;
+    /** Set when the message text is a transcription of a recorded voice message. */
+    voice?: {
+        durationMs: number;
+    };
+}
+/** The stored conversation unit — a `UIMessage` typed with our metadata. */
+export type AppMessage<TOOLS extends UITools = UITools> = UIMessage<AppMetadata, UIDataTypes, TOOLS>;
+//# sourceMappingURL=message.d.ts.map

package/dist/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAE1D;;;;;;;;;;;;;GAaG;AAEH,mDAAmD;AACnD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,CAAC;AAE1D,yDAAyD;AACzD,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,oEAAoE;IACpE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,KAAK,CAAC,EAAE;QACN,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,KAAK,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AAED,4EAA4E;AAC5E,MAAM,MAAM,UAAU,CAAC,KAAK,SAAS,OAAO,GAAG,OAAO,IAAI,SAAS,CACjE,WAAW,EACX,WAAW,EACX,KAAK,CACN,CAAC"}

package/dist/message.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=message.js.map

package/dist/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../src/message.ts"],"names":[],"mappings":""}

package/dist/models/catalog.d.ts

@@ -0,0 +1,56 @@
+import type { LanguageModel } from "ai";
+import type { Pricing } from "../pricing.js";
+import { type ProviderId } from "./provider.js";
+/**
+ * The model catalog, sourced from models.dev (the public model registry). A
+ * provider's models are included when its SDK is installed AND its API key is
+ * set (models.dev tells us the key env var) — so a picker shows exactly what
+ * this deployment can run, across providers, auto-updating as models ship.
+ * Each model's `cost` (USD/1M) feeds the pricing seam. Fetched once per process
+ * per option set; static fallback if offline.
+ *
+ * Provider SDKs are OPTIONAL peers of core and loaded lazily, per provider,
+ * only when that provider is usable here — a host with one API key never
+ * loads the other two SDKs, and core itself stays free of static provider
+ * imports.
+ */
+export interface ModelInfo {
+    id: string;
+    label: string;
+    provider: string;
+    /** Whether the model supports reasoning/thinking (gates the effort knob). */
+    reasoning?: boolean;
+    /** Max output tokens (models.dev `limit.output`) — bounds the thinking budget. */
+    maxOutput?: number;
+}
+export interface ModelCatalog {
+    models: ModelInfo[];
+    pricing: Pricing;
+    /** Resolve a model id → provider model (unknown id → the default model). */
+    modelFor: (id: string) => LanguageModel;
+    /**
+     * The provider's NATIVE web tools for a model id (server-side search/fetch),
+     * keyed consistently (`web_search` / `web_fetch`) so prompts stay
+     * provider-agnostic. `{}` when the provider has none or isn't loaded.
+     */
+    providerTools: (id: string) => Record<string, unknown>;
+    /** The id `modelFor` falls back to. */
+    defaultModel: string;
+}
+export interface ModelCatalogOptions {
+    /** Providers to consider (default: all three). Inclusion still requires the SDK + key env. */
+    providers?: readonly ProviderId[];
+    /** The model unknown ids resolve to (default: claude-sonnet-4-6). */
+    defaultModel?: string;
+    /** models.dev endpoint override (tests / mirrors). */
+    url?: string;
+    /** Fetch override (tests). */
+    fetch?: typeof fetch;
+}
+/**
+ * Load (and memoize per option set) the model catalog from models.dev, across
+ * runnable providers. Rejects — never returns a half-usable catalog — when an
+ * explicit `defaultModel` names a provider that isn't runnable here.
+ */
+export declare function loadModelCatalog(options?: ModelCatalogOptions): Promise<ModelCatalog>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/models/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/models/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAExC,OAAO,KAAK,EAAc,OAAO,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAgC,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,4EAA4E;IAC5E,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,aAAa,CAAC;IACxC;;;;OAIG;IACH,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvD,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,8FAA8F;IAC9F,SAAS,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IAClC,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAyKD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,CAsFzF"}

package/dist/models/catalog.js

@@ -0,0 +1,211 @@
+import { staticPricing } from "../pricing.js";
+import { PROVIDER_IDS, providerFromId } from "./provider.js";
+/**
+ * Lazy SDK loaders — the ONLY place a provider package is named. Each import
+ * resolves against the host's node_modules (optional peer), so a missing SDK
+ * is a per-provider "not available here", never a load-time failure of core.
+ */
+const LOADERS = {
+    anthropic: async () => {
+        const { anthropic } = await import("@ai-sdk/anthropic");
+        return {
+            model: (id) => anthropic(id),
+            webTools: () => ({
+                web_search: anthropic.tools.webSearch_20260209(),
+                web_fetch: anthropic.tools.webFetch_20260209(),
+            }),
+        };
+    },
+    openai: async () => {
+        const { openai } = await import("@ai-sdk/openai");
+        return { model: (id) => openai(id), webTools: () => ({ web_search: openai.tools.webSearch() }) };
+    },
+    google: async () => {
+        const { google } = await import("@ai-sdk/google");
+        return {
+            model: (id) => google(id),
+            webTools: () => ({
+                web_search: google.tools.googleSearch({}),
+                web_fetch: google.tools.urlContext({}),
+            }),
+        };
+    },
+};
+const DEFAULT_MODEL = "claude-sonnet-4-6";
+const MODELS_DEV_URL = "https://models.dev/api.json";
+/** Each provider's well-known key env var — models.dev tells us online; this is the offline copy. */
+const KEY_ENV = {
+    anthropic: "ANTHROPIC_API_KEY",
+    openai: "OPENAI_API_KEY",
+    google: "GOOGLE_GENERATIVE_AI_API_KEY",
+};
+/** Load the SDKs for `providers` that are installed; missing ones are skipped (warned once). */
+async function loadFactories(providers) {
+    const loaded = new Map();
+    await Promise.all(providers.map(async (p) => {
+        try {
+            loaded.set(p, await LOADERS[p]());
+        }
+        catch (e) {
+            console.warn(`[latch-core/models] provider "${p}" unavailable (install @ai-sdk/${p} to use it):`, e instanceof Error ? e.message : e);
+        }
+    }));
+    return loaded;
+}
+/**
+ * The implicit default: the canonical Sonnet when Anthropic is runnable here,
+ * else the first listed model of a provider that is — so an OpenAI- or
+ * Google-only host never gets a default its SDK can't build.
+ */
+function pickDefaultModel(factories, models) {
+    if (factories.has("anthropic"))
+        return DEFAULT_MODEL;
+    return models.find((m) => factories.has(m.provider))?.id ?? DEFAULT_MODEL;
+}
+function buildResolvers(factories, idToProvider, defaultModel) {
+    const defaultProvider = providerFromId(defaultModel) ?? "anthropic";
+    const providerOfId = (id) => idToProvider.get(id) ?? providerFromId(id);
+    return {
+        modelFor: (id) => {
+            const provider = providerOfId(id);
+            const f = (provider && factories.get(provider)) || factories.get(defaultProvider);
+            if (!f) {
+                throw new Error(`[latch-core/models] no provider SDK loaded for "${id}" (or the default "${defaultModel}") — install @ai-sdk/${provider ?? defaultProvider} and set its API key`);
+            }
+            // A known provider resolves the requested id; an unknown id falls back to the default model.
+            return provider && factories.has(provider) ? f.model(id) : f.model(defaultModel);
+        },
+        providerTools: (id) => {
+            // Unknown ids default to the default model's provider (historically Anthropic's tools).
+            const provider = providerOfId(id) ?? defaultProvider;
+            return factories.get(provider)?.webTools() ?? {};
+        },
+    };
+}
+/**
+ * Offline fallback: one known-good model per provider, restricted (like the
+ * online path) to providers that are keyed AND installed. Same eligibility
+ * rule, so an unconfigured SDK never yields a model that can't run.
+ */
+function fallbackCatalog(factories, defaultModel) {
+    const all = [
+        { id: "claude-sonnet-4-6", label: "Claude Sonnet 4.6", provider: "anthropic", reasoning: true, maxOutput: 64000 },
+        { id: "gpt-4o", label: "GPT-4o", provider: "openai", reasoning: false, maxOutput: 16384 },
+        { id: "gemini-2.5-pro", label: "Gemini 2.5 Pro", provider: "google", reasoning: true, maxOutput: 65536 },
+    ];
+    const models = all.filter((m) => factories.has(m.provider));
+    const chosenDefault = defaultModel ?? pickDefaultModel(factories, models);
+    return {
+        models,
+        pricing: staticPricing({
+            "claude-sonnet-4-6": { inputPer1M: 3, outputPer1M: 15 },
+            "gpt-4o": { inputPer1M: 2.5, outputPer1M: 10 },
+            "gemini-2.5-pro": { inputPer1M: 1.25, outputPer1M: 10 },
+        }),
+        ...buildResolvers(factories, new Map(models.map((m) => [m.id, m.provider])), chosenDefault),
+        defaultModel: chosenDefault,
+    };
+}
+/** Providers whose key env is set (offline eligibility rule). */
+const keyedProviders = (providers) => providers.filter((p) => !!process.env[KEY_ENV[p]]);
+// Memo per (fetch implementation, option set): an injected fetch (tests,
+// mirrors) gets its own cache, so it can never serve a catalog to callers
+// using a different one.
+const caches = new WeakMap();
+const cacheFor = (fetchImpl) => {
+    let m = caches.get(fetchImpl);
+    if (!m)
+        caches.set(fetchImpl, (m = new Map()));
+    return m;
+};
+/**
+ * Load (and memoize per option set) the model catalog from models.dev, across
+ * runnable providers. Rejects — never returns a half-usable catalog — when an
+ * explicit `defaultModel` names a provider that isn't runnable here.
+ */
+export function loadModelCatalog(options = {}) {
+    const providers = options.providers ?? PROVIDER_IDS;
+    const url = options.url ?? MODELS_DEV_URL;
+    const doFetch = options.fetch ?? fetch;
+    const cache = cacheFor(doFetch);
+    const key = JSON.stringify([providers, options.defaultModel ?? null, url]);
+    const hit = cache.get(key);
+    if (hit)
+        return hit;
+    const loading = (async () => {
+        let factories;
+        let catalog;
+        try {
+            const res = await doFetch(url, { redirect: "error" });
+            if (!res.ok)
+                throw new Error(`HTTP ${res.status}`);
+            const all = (await res.json());
+            // Usable = listed by models.dev AND keyed. Then load those SDKs (only).
+            const keyed = providers.filter((p) => {
+                const md = all[p];
+                return !!md?.models && (md.env ?? []).some((e) => !!process.env[e]);
+            });
+            factories = await loadFactories(keyed);
+            const list = [];
+            const rates = {};
+            const idToProvider = new Map();
+            for (const provider of keyed) {
+                if (!factories.has(provider))
+                    continue; // keyed but SDK not installed
+                for (const [id, m] of Object.entries(all[provider].models)) {
+                    list.push({ id, label: m.name ?? id, provider, reasoning: m.reasoning, maxOutput: m.limit?.output });
+                    idToProvider.set(id, provider);
+                    if (m.cost?.input != null && m.cost?.output != null) {
+                        rates[id] = {
+                            inputPer1M: m.cost.input,
+                            outputPer1M: m.cost.output,
+                            ...(m.cost.cache_read != null ? { cacheReadPer1M: m.cost.cache_read } : {}),
+                            ...(m.cost.cache_write != null ? { cacheWritePer1M: m.cost.cache_write } : {}),
+                        };
+                        // Long-context tier (higher rates above a context size).
+                        const ct = (m.cost.tiers ?? []).find((t) => t.tier?.type === "context" && t.tier?.size && t.input != null && t.output != null);
+                        if (ct?.tier?.size) {
+                            rates[id].tier = {
+                                thresholdTokens: ct.tier.size,
+                                inputPer1M: ct.input,
+                                outputPer1M: ct.output,
+                                ...(ct.cache_read != null ? { cacheReadPer1M: ct.cache_read } : {}),
+                                ...(ct.cache_write != null ? { cacheWritePer1M: ct.cache_write } : {}),
+                            };
+                        }
+                    }
+                }
+            }
+            if (list.length === 0)
+                throw new Error("no runnable providers (no API keys, or SDKs not installed?)");
+            list.sort((a, b) => a.label.localeCompare(b.label));
+            const defaultModel = options.defaultModel ?? pickDefaultModel(factories, list);
+            catalog = {
+                models: list,
+                pricing: staticPricing(rates),
+                ...buildResolvers(factories, idToProvider, defaultModel),
+                defaultModel,
+            };
+        }
+        catch (e) {
+            console.warn("models.dev unavailable, using fallback list:", e instanceof Error ? e.message : e);
+            // Offline: the same eligibility rule (keyed + installed) over the
+            // fallback list's providers, from the well-known key env names.
+            factories ??= await loadFactories(keyedProviders(providers));
+            catalog = fallbackCatalog(factories, options.defaultModel);
+        }
+        // An explicit default that this deployment can't build is a configuration
+        // error — say so now, not on the first turn that falls back to it.
+        const dp = providerFromId(catalog.defaultModel) ?? providerOfListed(catalog.models, catalog.defaultModel);
+        if (!dp || !factories.has(dp)) {
+            cache.delete(key);
+            throw new Error(`[latch-core/models] default model "${catalog.defaultModel}" is not runnable here — ` +
+                `its provider${dp ? ` (@ai-sdk/${dp})` : ""} is not installed or has no API key set`);
+        }
+        return catalog;
+    })();
+    cache.set(key, loading);
+    return loading;
+}
+const providerOfListed = (models, id) => models.find((m) => m.id === id)?.provider;
+//# sourceMappingURL=catalog.js.map

package/dist/models/catalog.js.map

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

package/dist/models/defaults.d.ts

@@ -0,0 +1,23 @@
+import type { RuntimeConfig } from "../runtime.js";
+import type { ModelCatalog } from "./catalog.js";
+export interface ProviderDefaultsOptions<P> {
+    /**
+     * Per-principal cache-key suffix for memory-enabled agents (their system
+     * prompt is per-principal, so an OpenAI cache key shared across principals
+     * would route badly). Typically the storage owner key.
+     */
+    principalKey?: (principal: P) => string;
+    /**
+     * Prompt caching on (default true). `false` turns caching off
+     * (`resolvePromptCaching: () => undefined`) — the control arm of an A/B.
+     */
+    promptCaching?: boolean;
+}
+/**
+ * The provider-specific `RuntimeConfig` hooks, derived from one catalog:
+ * `pricing`, `resolveProviderTools`, `resolveReasoningOptions`,
+ * `resolvePromptCaching`. Spread into `createRuntime({...})`; override any one
+ * by listing it after the spread. This is what every host used to hand-write.
+ */
+export declare function providerDefaults<P, RC = unknown>(catalog: ModelCatalog, options?: ProviderDefaultsOptions<P>): Pick<RuntimeConfig<P, RC>, "pricing" | "resolveProviderTools" | "resolveReasoningOptions" | "resolvePromptCaching">;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/models/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/models/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIjD,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,MAAM,CAAC;IACxC;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,EAC9C,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,uBAAuB,CAAC,CAAC,CAAM,GACvC,IAAI,CACL,aAAa,CAAC,CAAC,EAAE,EAAE,CAAC,EACpB,SAAS,GAAG,sBAAsB,GAAG,yBAAyB,GAAG,sBAAsB,CACxF,CAUA"}

package/dist/models/defaults.js

@@ -0,0 +1,19 @@
+import { makeResolveReasoningOptions } from "./reasoning.js";
+import { makeResolvePromptCaching } from "./prompt-caching.js";
+/**
+ * The provider-specific `RuntimeConfig` hooks, derived from one catalog:
+ * `pricing`, `resolveProviderTools`, `resolveReasoningOptions`,
+ * `resolvePromptCaching`. Spread into `createRuntime({...})`; override any one
+ * by listing it after the spread. This is what every host used to hand-write.
+ */
+export function providerDefaults(catalog, options = {}) {
+    return {
+        pricing: catalog.pricing,
+        resolveProviderTools: catalog.providerTools,
+        resolveReasoningOptions: makeResolveReasoningOptions(catalog.models),
+        resolvePromptCaching: options.promptCaching === false
+            ? () => undefined
+            : makeResolvePromptCaching(catalog.models, options.principalKey),
+    };
+}
+//# sourceMappingURL=defaults.js.map

package/dist/models/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/models/defaults.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAgB/D;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAqB,EACrB,UAAsC,EAAE;IAKxC,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,oBAAoB,EAAE,OAAO,CAAC,aAAa;QAC3C,uBAAuB,EAAE,2BAA2B,CAAC,OAAO,CAAC,MAAM,CAAC;QACpE,oBAAoB,EAClB,OAAO,CAAC,aAAa,KAAK,KAAK;YAC7B,CAAC,CAAC,GAAG,EAAE,CAAC,SAAS;YACjB,CAAC,CAAC,wBAAwB,CAAI,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC;KACxE,CAAC;AACJ,CAAC"}

package/dist/models/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @intentface/latch-core/models
+ *
+ * The model side of a Latch host, so no host hand-writes it: a models.dev-backed
+ * catalog (ids, labels, pricing, reasoning capability, max output), provider
+ * inference from a model id, and the `RuntimeConfig` hooks that depend on the
+ * provider — reasoning effort, native web tools, prompt caching.
+ *
+ * A separate subpath because it is the one part of core that touches provider
+ * SDKs — `@ai-sdk/anthropic|openai|google` are OPTIONAL peers, imported lazily
+ * per provider only when that provider is usable (SDK installed + key set).
+ * Importing the core root pulls in none of them.
+ */
+export { loadModelCatalog } from "./catalog.js";
+export type { ModelCatalog, ModelCatalogOptions, ModelInfo } from "./catalog.js";
+export { providerOf, providerFromId, PROVIDER_IDS } from "./provider.js";
+export type { ProviderId } from "./provider.js";
+export { makeResolveReasoningOptions } from "./reasoning.js";
+export type { ReasoningEffort, ReasoningResolution } from "./reasoning.js";
+export { makeResolvePromptCaching } from "./prompt-caching.js";
+export { providerDefaults } from "./defaults.js";
+export type { ProviderDefaultsOptions } from "./defaults.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC"}

package/dist/models/index.js

@@ -0,0 +1,19 @@
+/**
+ * @intentface/latch-core/models
+ *
+ * The model side of a Latch host, so no host hand-writes it: a models.dev-backed
+ * catalog (ids, labels, pricing, reasoning capability, max output), provider
+ * inference from a model id, and the `RuntimeConfig` hooks that depend on the
+ * provider — reasoning effort, native web tools, prompt caching.
+ *
+ * A separate subpath because it is the one part of core that touches provider
+ * SDKs — `@ai-sdk/anthropic|openai|google` are OPTIONAL peers, imported lazily
+ * per provider only when that provider is usable (SDK installed + key set).
+ * Importing the core root pulls in none of them.
+ */
+export { loadModelCatalog } from "./catalog.js";
+export { providerOf, providerFromId, PROVIDER_IDS } from "./provider.js";
+export { makeResolveReasoningOptions } from "./reasoning.js";
+export { makeResolvePromptCaching } from "./prompt-caching.js";
+export { providerDefaults } from "./defaults.js";
+//# sourceMappingURL=index.js.map

package/dist/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAE7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/models/prompt-caching.d.ts

@@ -0,0 +1,19 @@
+import { type PromptCachingPlan } from "../prompt-caching.js";
+/**
+ * Build the `RuntimeConfig.resolvePromptCaching` hook over the model catalog —
+ * core applies the plan; this side knows which provider a model id belongs to.
+ * Anthropic models get explicit cache breakpoints; OpenAI models get a cache
+ * routing key (`prompt_cache_key` — OpenAI caches automatically, the key only
+ * improves shard routing); other providers get nothing. `principalKey` scopes
+ * the OpenAI key per principal for memory-enabled agents, whose system prompt
+ * is per-principal (omit it and memory-scoped turns share the agent key).
+ */
+export declare function makeResolvePromptCaching<P>(models: ReadonlyArray<{
+    id: string;
+    provider: string;
+}>, principalKey?: (principal: P) => string): (modelId: string, args: {
+    agent: string;
+    memoryScoped: boolean;
+    principal: P;
+}) => PromptCachingPlan | undefined;
+//# sourceMappingURL=prompt-caching.d.ts.map

package/dist/models/prompt-caching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-caching.d.ts","sourceRoot":"","sources":["../../src/models/prompt-caching.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGpF;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EACxC,MAAM,EAAE,aAAa,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,EACvD,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,MAAM,IAGrC,SAAS,MAAM,EACf,MAAM;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,CAAC,CAAA;CAAE,KAC3D,iBAAiB,GAAG,SAAS,CAKjC"}

package/dist/models/prompt-caching.js

@@ -0,0 +1,18 @@
+import { promptCachingPlanFor } from "../prompt-caching.js";
+import { providerOf } from "./provider.js";
+/**
+ * Build the `RuntimeConfig.resolvePromptCaching` hook over the model catalog —
+ * core applies the plan; this side knows which provider a model id belongs to.
+ * Anthropic models get explicit cache breakpoints; OpenAI models get a cache
+ * routing key (`prompt_cache_key` — OpenAI caches automatically, the key only
+ * improves shard routing); other providers get nothing. `principalKey` scopes
+ * the OpenAI key per principal for memory-enabled agents, whose system prompt
+ * is per-principal (omit it and memory-scoped turns share the agent key).
+ */
+export function makeResolvePromptCaching(models, principalKey) {
+    return (modelId, args) => promptCachingPlanFor(providerOf(modelId, models), {
+        agent: args.agent,
+        ...(args.memoryScoped && principalKey ? { cacheKeySuffix: principalKey(args.principal) } : {}),
+    });
+}
+//# sourceMappingURL=prompt-caching.js.map

package/dist/models/prompt-caching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-caching.js","sourceRoot":"","sources":["../../src/models/prompt-caching.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAA0B,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAuD,EACvD,YAAuC;IAEvC,OAAO,CACL,OAAe,EACf,IAA4D,EAC7B,EAAE,CACjC,oBAAoB,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE;QAChD,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/F,CAAC,CAAC;AACP,CAAC"}

package/dist/models/provider.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Which first-party provider a model id belongs to. ONE place for the id-prefix
+ * heuristic that used to live in three files (catalog fallback, provider tools,
+ * prompt caching) — a catalog entry wins when one is available; the prefixes
+ * cover models not in the catalog (offline fallback list, custom ids).
+ */
+export type ProviderId = "anthropic" | "openai" | "google";
+export declare const PROVIDER_IDS: readonly ProviderId[];
+/** Provider by id prefix alone: claude → anthropic; gpt/o-series → openai; gemini/gemma → google. */
+export declare function providerFromId(modelId: string): ProviderId | undefined;
+/**
+ * Provider for a model id: the catalog's answer when the id is listed, else the
+ * id-prefix heuristic. `catalog` is any list of `{ id, provider }`.
+ */
+export declare function providerOf(modelId: string, catalog?: ReadonlyArray<{
+    id: string;
+    provider: string;
+}>): ProviderId | undefined;
+//# sourceMappingURL=provider.d.ts.map