@theokit/sdk 4.16.4 → 4.16.5

package/dist/eval.js

@@ -1,9 +1,9 @@
 import { z, toJSONSchema } from 'zod';
 import { createRequire } from 'module';
 import { randomUUID, randomBytes, createHash } from 'crypto';
-import { mkdir, readFile, open, rename, unlink, readdir, writeFile, statfs, stat, access } from 'fs/promises';
+import { mkdir, readFile, open, rename, unlink, writeFile, statfs, readdir, stat, access } from 'fs/promises';
 import { join, dirname, resolve, sep, relative, isAbsolute } from 'path';
-import { readFileSync, existsSync, mkdirSync, appendFileSync, statSync, realpathSync, chmodSync, openSync, writeFileSync, fsyncSync, closeSync, renameSync, unlinkSync, lstatSync, readlinkSync, readdirSync } from 'fs';
+import { readFileSync, existsSync, mkdirSync, appendFileSync, realpathSync, lstatSync, readlinkSync, readdirSync, statSync, chmodSync, openSync, writeFileSync, fsyncSync, closeSync, renameSync, unlinkSync } from 'fs';
 import { homedir } from 'os';
 import { fileURLToPath, pathToFileURL } from 'url';
 import { AsyncLocalStorage } from 'async_hooks';
@@ -1601,212 +1601,6 @@ var init_run_events = __esm({
   "src/types/run-events.ts"() {
   }
 });
-
-// src/internal/session/agent-session-store.ts
-function seedTranscript(prior, opts) {
-  return SessionTranscript.fromRecords(prior, opts);
-}
-function mapAgentTurn(steps) {
-  const assistant = {};
-  const toolResults = [];
-  const toolCalls = [];
-  for (const step of steps) {
-    if (step.type === "thinkingMessage") assistant.thinking = step.message.text;
-    else if (step.type === "assistantMessage") assistant.text = step.message.text;
-    else if (step.type === "toolCall")
-      toolCalls.push({
-        id: step.message.callId,
-        name: step.message.name,
-        input: step.message.args ?? {}
-      });
-    else
-      toolResults.push({
-        toolUseId: step.message.callId,
-        content: step.message.result,
-        isError: step.message.isError
-      });
-  }
-  if (toolCalls.length > 0) assistant.toolCalls = toolCalls;
-  return { assistant, toolResults };
-}
-function hasAssistantContent(a) {
-  return a.text !== void 0 || a.thinking !== void 0 || (a.toolCalls?.length ?? 0) > 0;
-}
-function appendConversation(transcript, conversation) {
-  for (const ct of conversation) {
-    if (ct.type !== "agentConversationTurn") continue;
-    const { assistant, toolResults } = mapAgentTurn(ct.turn.steps);
-    if (hasAssistantContent(assistant)) transcript.appendAssistantTurn(assistant);
-    if (toolResults.length > 0) transcript.appendToolResults(toolResults);
-  }
-}
-async function readSessionMessages(store, agentId) {
-  const records = await store.readRecords(agentId);
-  return reconstructMessages(records).map(narrowToSessionMessage);
-}
-function partToText(p) {
-  if (p.type === "text") return p.text ?? "";
-  if (p.type === "tool_use") return `[tool call] ${p.name ?? ""}`;
-  if (p.type === "tool_result") {
-    const body = typeof p.content === "string" ? p.content : JSON.stringify(p.content);
-    return `[tool result] ${body}`;
-  }
-  return "";
-}
-function narrowToSessionMessage(m) {
-  const role = m.role === "user" ? "user" : "assistant";
-  const text = m.content.map(partToText).filter((s) => s.length > 0).join("\n");
-  return { role, text };
-}
-function deltaRecords(transcript, priorLength) {
-  return transcript.records().slice(priorLength);
-}
-async function persistTurn(store, loc, sessionId, turn) {
-  const prior = await store.readRecords(loc.agentId);
-  const transcript = seedTranscript(prior, { cwd: loc.cwd, sessionId, model: loc.model });
-  transcript.appendUserTurn(turn.userText);
-  appendConversation(transcript, turn.conversation);
-  await store.appendRecords(loc.agentId, deltaRecords(transcript, prior.length));
-}
-var init_agent_session_store = __esm({
-  "src/internal/session/agent-session-store.ts"() {
-    init_session_transcript();
-  }
-});
-
-// src/compaction.ts
-function estimateTokens(text) {
-  return Math.ceil(text.length / 4);
-}
-var init_compaction = __esm({
-  "src/compaction.ts"() {
-  }
-});
-
-// src/internal/runtime/compression/compression-summarizer.ts
-var compression_summarizer_exports = {};
-__export(compression_summarizer_exports, {
-  CompressionFailedError: () => CompressionFailedError,
-  buildCompressionPrompt: () => buildCompressionPrompt,
-  compressConversationWindow: () => compressConversationWindow
-});
-function buildCompressionPrompt(messages) {
-  const formatted = messages.map((m) => `[${m.role}]: ${m.content}`).join("\n\n");
-  return `Summarize the following ${messages.length} conversation messages into a concise summary that preserves ALL facts, decisions, user preferences, and context needed for the conversation to continue naturally. The summary will replace these messages in the context window. Be thorough but concise.
-
---- CONVERSATION TO SUMMARIZE ---
-${formatted}
---- END ---`;
-}
-async function compressConversationWindow(opts) {
-  const userPrompt = buildCompressionPrompt(opts.messages);
-  let summary;
-  try {
-    summary = await opts.callLlm(opts.model, COMPRESSION_SYSTEM, userPrompt);
-  } catch (cause) {
-    throw new CompressionFailedError(
-      `Compression LLM call failed: ${cause instanceof Error ? cause.message : String(cause)}`,
-      { cause: cause instanceof Error ? cause : void 0 }
-    );
-  }
-  if (!summary || summary.trim().length === 0) {
-    throw new CompressionFailedError(
-      "Compression LLM returned empty summary \u2014 reduction ineffective."
-    );
-  }
-  return {
-    role: "system",
-    content: `[Compressed conversation summary]: ${summary.trim()}`
-  };
-}
-var CompressionFailedError, COMPRESSION_SYSTEM;
-var init_compression_summarizer = __esm({
-  "src/internal/runtime/compression/compression-summarizer.ts"() {
-    CompressionFailedError = class extends Error {
-      name = "CompressionFailedError";
-    };
-    COMPRESSION_SYSTEM = "You are a conversation summarizer. Produce a concise factual summary. Preserve all decisions, preferences, code snippets, and action items. Do not add commentary or opinions. Output ONLY the summary text.";
-  }
-});
-
-// src/internal/runtime/compression/compression-model-registry.ts
-var compression_model_registry_exports = {};
-__export(compression_model_registry_exports, {
-  CompressionModelUnresolvedError: () => CompressionModelUnresolvedError,
-  resolveCompressionModel: () => resolveCompressionModel
-});
-function resolveCompressionModel(agentModel) {
-  const exact = EXACT_REGISTRY.get(agentModel);
-  if (exact !== void 0) return exact;
-  const wildcard = matchWildcard(agentModel);
-  if (wildcard !== null) return wildcard;
-  if (isNoAuthProvider(agentModel)) return agentModel;
-  throw new CompressionModelUnresolvedError(agentModel);
-}
-function matchWildcard(agentModel) {
-  for (const [pattern, replacement] of WILDCARD_REGISTRY) {
-    const prefix = pattern.endsWith("*") ? pattern.slice(0, -1) : pattern;
-    if (!agentModel.startsWith(prefix)) continue;
-    const suffix = agentModel.slice(prefix.length);
-    const replPrefix = replacement.endsWith("*") ? replacement.slice(0, -1) : replacement;
-    return `${replPrefix}${suffix}`;
-  }
-  return null;
-}
-function isNoAuthProvider(agentModel) {
-  const slashIdx = agentModel.indexOf("/");
-  if (slashIdx <= 0) return false;
-  return NO_AUTH_PROVIDERS.has(agentModel.slice(0, slashIdx));
-}
-var EXACT_REGISTRY, WILDCARD_REGISTRY, NO_AUTH_PROVIDERS, CompressionModelUnresolvedError;
-var init_compression_model_registry = __esm({
-  "src/internal/runtime/compression/compression-model-registry.ts"() {
-    EXACT_REGISTRY = /* @__PURE__ */ new Map([
-      // OpenAI family
-      ["openai/gpt-4o", "openai/gpt-4o-mini"],
-      ["openai/gpt-4-turbo", "openai/gpt-4o-mini"],
-      ["openai/gpt-4", "openai/gpt-4o-mini"],
-      ["openai/o1-preview", "openai/gpt-4o-mini"],
-      ["openai/o1", "openai/gpt-4o-mini"],
-      ["openai/o3", "openai/gpt-4o-mini"],
-      ["openai/o3-mini", "openai/gpt-4o-mini"],
-      // Anthropic family
-      ["anthropic/claude-opus-4", "anthropic/claude-3-5-haiku-latest"],
-      ["anthropic/claude-sonnet-4", "anthropic/claude-3-5-haiku-latest"],
-      ["anthropic/claude-3-5-sonnet", "anthropic/claude-3-5-haiku-latest"],
-      ["anthropic/claude-3-5-sonnet-latest", "anthropic/claude-3-5-haiku-latest"],
-      ["anthropic/claude-3-opus", "anthropic/claude-3-haiku"],
-      ["anthropic/claude-3-sonnet", "anthropic/claude-3-haiku"],
-      // Vertex (Gemini + Anthropic-on-Vertex)
-      ["vertex/gemini-1.5-pro", "vertex/gemini-1.5-flash"],
-      ["vertex/gemini-2.0-pro", "vertex/gemini-1.5-flash"],
-      ["vertex/claude-3-5-sonnet", "vertex/claude-3-5-haiku"],
-      ["vertex/claude-3-opus", "vertex/claude-3-haiku"],
-      // OpenRouter (preserve openrouter prefix, swap tier within same vendor)
-      ["openrouter/openai/gpt-4o", "openrouter/openai/gpt-4o-mini"],
-      ["openrouter/openai/gpt-4-turbo", "openrouter/openai/gpt-4o-mini"],
-      ["openrouter/anthropic/claude-3-5-sonnet", "openrouter/anthropic/claude-3-5-haiku"],
-      ["openrouter/anthropic/claude-opus-4", "openrouter/anthropic/claude-3-5-haiku"]
-    ]);
-    WILDCARD_REGISTRY = [
-      // Bedrock Anthropic: us.anthropic.claude-sonnet-* → us.anthropic.claude-3-haiku-*
-      ["bedrock/anthropic.claude-sonnet*", "bedrock/anthropic.claude-3-haiku*"],
-      ["bedrock/anthropic.claude-opus*", "bedrock/anthropic.claude-3-haiku*"],
-      ["bedrock/anthropic.claude-3-5-sonnet*", "bedrock/anthropic.claude-3-5-haiku*"]
-    ];
-    NO_AUTH_PROVIDERS = /* @__PURE__ */ new Set(["ollama", "lmstudio", "llamacpp"]);
-    CompressionModelUnresolvedError = class extends Error {
-      name = "CompressionModelUnresolvedError";
-      agentModel;
-      constructor(agentModel) {
-        super(
-          `Could not resolve a same-family-cheaper-tier compression model for "${agentModel}". Provide Agent.create({compression: {model: "<your-cheaper-model>"}}) OR add "${agentModel}" to the compression-model-registry (see ADR D440).`
-        );
-        this.agentModel = agentModel;
-      }
-    };
-  }
-});
 var MODALITIES, costSchema, limitSchema, modalitiesSchema, catalogModelSchema;
 var init_catalog_schema = __esm({
   "src/internal/providers/catalog-schema.ts"() {
@@ -1874,13 +1668,6 @@ function getProviderProfile(name) {
   const canonical = ALIASES.get(name) ?? name;
   return REGISTRY.get(canonical);
 }
-function listProviders() {
-  return Array.from(REGISTRY.values());
-}
-function _resetProvidersForTests() {
-  REGISTRY.clear();
-  ALIASES.clear();
-}
 var REGISTRY, ALIASES;
 var init_registry = __esm({
   "src/internal/providers/registry.ts"() {
@@ -1891,19 +1678,6 @@ var init_registry = __esm({
     ALIASES = globalSingleton("theokit-sdk.providers.aliases", () => /* @__PURE__ */ new Map());
   }
 });
-
-// src/internal/providers/catalog-loader.ts
-var catalog_loader_exports = {};
-__export(catalog_loader_exports, {
-  _resetModelInfoIndexForTests: () => _resetModelInfoIndexForTests,
-  getCatalogCapabilities: () => getCatalogCapabilities,
-  getCatalogModelInfo: () => getCatalogModelInfo,
-  isPatchedModelKey: () => isPatchedModelKey,
-  listModelInfoKeys: () => listModelInfoKeys,
-  loadProviderCatalog: () => loadProviderCatalog,
-  patchModelInfo: () => patchModelInfo,
-  registerCatalogProviders: () => registerCatalogProviders
-});
 function globalSingleton2(key, create) {
   const g = globalThis;
   const sym = Symbol.for(key);
@@ -1917,16 +1691,6 @@ function getCatalogModelInfo(key) {
 function isPatchedModelKey(key) {
   return patchedModelKeys.has(key);
 }
-function patchModelInfo(key, model) {
-  ensureModelIndexLoaded();
-  const existing = modelInfoIndex.get(key);
-  modelInfoIndex.set(key, existing === void 0 ? model : { ...existing, ...model });
-  patchedModelKeys.add(key);
-}
-function listModelInfoKeys() {
-  ensureModelIndexLoaded();
-  return [...modelInfoIndex.keys()];
-}
 function ensureModelIndexLoaded() {
   if (indexState.loaded) return;
   indexState.loaded = true;
@@ -1960,11 +1724,6 @@ function indexEntryModels(entry) {
     }
   }
 }
-function _resetModelInfoIndexForTests() {
-  modelInfoIndex.clear();
-  patchedModelKeys.clear();
-  indexState.loaded = false;
-}
 function validateEntry(raw) {
   if (typeof raw.id !== "string" || typeof raw.displayName !== "string" || typeof raw.apiMode !== "string" || typeof raw.authType !== "string" || typeof raw.baseUrl !== "string" || !Array.isArray(raw.envVars) || !Array.isArray(raw.fallbackModels) || raw.capabilities == null || typeof raw.capabilities !== "object") {
     return null;
@@ -1975,12 +1734,6 @@ function loadProviderCatalog(opts) {
   const catalogPath = join(__dirname_resolved, "provider-catalog.json");
   const rawText = readFileSync(catalogPath, "utf-8");
   let entries = JSON.parse(rawText);
-  if (opts?._testInjectMalformed) {
-    entries = [
-      ...entries,
-      { id: "malformed-provider", displayName: "Bad" }
-    ];
-  }
   const result = {};
   for (const raw of entries) {
     const validated = validateEntry(raw);
@@ -1995,21 +1748,8 @@ function loadProviderCatalog(opts) {
   }
   return result;
 }
-function getCatalogCapabilities(providerId) {
-  if (_capabilitiesCache === null) {
-    const catalog = loadProviderCatalog();
-    _capabilitiesCache = {};
-    for (const entry of Object.values(catalog)) {
-      _capabilitiesCache[entry.id] = entry.capabilities;
-      for (const alias of entry.aliases ?? []) {
-        if (_capabilitiesCache[alias] === void 0) _capabilitiesCache[alias] = entry.capabilities;
-      }
-    }
-  }
-  return _capabilitiesCache[providerId];
-}
 function registerCatalogProviders(opts) {
-  const catalog = loadProviderCatalog(opts);
+  const catalog = loadProviderCatalog();
   for (const entry of Object.values(catalog)) {
     if (getProviderProfile(entry.id) !== void 0) continue;
     if (entry.aliases?.some((a) => getProviderProfile(a) !== void 0)) continue;
@@ -2029,7 +1769,7 @@ function registerCatalogProviders(opts) {
     registerProvider(profile);
   }
 }
-var __dirname_resolved, modelInfoIndex, patchedModelKeys, indexState, _capabilitiesCache;
+var __dirname_resolved, modelInfoIndex, patchedModelKeys, indexState;
 var init_catalog_loader = __esm({
   "src/internal/providers/catalog-loader.ts"() {
     init_catalog_schema();
@@ -2046,7 +1786,15 @@ var init_catalog_loader = __esm({
     indexState = globalSingleton2("theokit-sdk.providers.model-info-loaded", () => ({
       loaded: false
     }));
-    _capabilitiesCache = null;
+  }
+});
+
+// src/compaction.ts
+function estimateTokens(text) {
+  return Math.ceil(text.length / 4);
+}
+var init_compaction = __esm({
+  "src/compaction.ts"() {
   }
 });
 
@@ -2813,9 +2561,6 @@ function registerBuiltins() {
   registerProvider(CEREBRAS);
   registerCatalogProviders();
 }
-function _resetBuiltinsRegistered() {
-  _registeredState.done = false;
-}
 var _registeredState;
 var init_builtin = __esm({
   "src/internal/providers/builtin/index.ts"() {
@@ -2942,9 +2687,6 @@ async function loadOne(dir, entryName) {
     }
   }
 }
-function _resetDiscovery() {
-  discoveryState.done = false;
-}
 var discoveryState;
 var init_discovery = __esm({
   "src/internal/providers/discovery.ts"() {
@@ -2956,25 +2698,9 @@ var init_discovery = __esm({
 });
 
 // src/internal/providers/index.ts
-var providers_exports = {};
-__export(providers_exports, {
-  ANTHROPIC: () => ANTHROPIC,
-  GEMINI: () => GEMINI,
-  OPENAI: () => OPENAI,
-  OPENROUTER: () => OPENROUTER,
-  _resetBuiltinsRegistered: () => _resetBuiltinsRegistered,
-  _resetDiscovery: () => _resetDiscovery,
-  _resetProvidersForTests: () => _resetProvidersForTests,
-  discoverProviderPlugins: () => discoverProviderPlugins,
-  getProviderProfile: () => getProviderProfile,
-  listProviders: () => listProviders,
-  registerBuiltins: () => registerBuiltins,
-  registerProvider: () => registerProvider
-});
 var init_providers = __esm({
   "src/internal/providers/index.ts"() {
     init_builtin();
-    init_discovery();
     init_registry();
   }
 });
@@ -5715,12 +5441,6 @@ var init_vertex_router = __esm({
 });
 
 // src/internal/llm/router.ts
-var router_exports = {};
-__export(router_exports, {
-  _resetCredentialPoolWarnings: () => _resetCredentialPoolWarnings,
-  _resetNoAuthApiKeyWarnings: () => _resetNoAuthApiKeyWarnings,
-  resolveProviderChain: () => resolveProviderChain
-});
 function resolveProviderChain(options) {
   registerBuiltins();
   return buildChain(options);
@@ -5818,9 +5538,6 @@ function warnNoAuthApiKeysIgnoredOnce(provider) {
 `
   );
 }
-function _resetNoAuthApiKeyWarnings() {
-  warnedNoAuthApiKeys.clear();
-}
 function sentinelForNoAuth(profile) {
   return profile.authType === "none" ? profile.name : void 0;
 }
@@ -5851,9 +5568,6 @@ function warnUnknownProvidersInApiKeys(apiKeys) {
     }
   }
 }
-function _resetCredentialPoolWarnings() {
-  warnedProviders.clear();
-}
 function resolveApiKey2(envVars) {
   for (const v of envVars) {
     const value = process.env[v];
@@ -5937,61 +5651,338 @@ function selectTransport(profile, apiKey) {
     { code: "transport_unavailable" }
   );
 }
-var warnedNoAuthApiKeys, warnedProviders;
-var init_router = __esm({
-  "src/internal/llm/router.ts"() {
-    init_errors();
-    init_providers();
-    init_anthropic3();
-    init_bedrock_anthropic();
-    init_credential_pool();
-    init_credential_pool_context();
-    init_fault_injection();
-    init_ollama_native();
-    init_openai2();
-    init_pool_aware_client();
-    init_responses();
-    init_vertex_router();
-    warnedNoAuthApiKeys = /* @__PURE__ */ new Set();
-    warnedProviders = /* @__PURE__ */ new Set();
+var warnedNoAuthApiKeys, warnedProviders;
+var init_router = __esm({
+  "src/internal/llm/router.ts"() {
+    init_errors();
+    init_providers();
+    init_anthropic3();
+    init_bedrock_anthropic();
+    init_credential_pool();
+    init_credential_pool_context();
+    init_fault_injection();
+    init_ollama_native();
+    init_openai2();
+    init_pool_aware_client();
+    init_responses();
+    init_vertex_router();
+    warnedNoAuthApiKeys = /* @__PURE__ */ new Set();
+    warnedProviders = /* @__PURE__ */ new Set();
+  }
+});
+
+// src/internal/local-agent/real-local-run-provider.ts
+function inferProviderFromApiKey(apiKey) {
+  if (apiKey === void 0 || apiKey.length === 0) return void 0;
+  const byPrefix = [
+    { provider: "openrouter", prefix: "sk-or-" },
+    { provider: "anthropic", prefix: "sk-ant-" },
+    { provider: "openai", prefix: "sk-" }
+  ];
+  for (const { provider, prefix } of byPrefix) {
+    if (apiKey.startsWith(prefix) && getProviderProfile(provider) !== void 0) {
+      return provider;
+    }
+  }
+  return void 0;
+}
+function detectPrimaryProvider() {
+  if (process.env.ANTHROPIC_API_KEY !== void 0 && process.env.ANTHROPIC_API_KEY.length > 0) {
+    return "anthropic";
+  }
+  if (process.env.OPENAI_API_KEY !== void 0 && process.env.OPENAI_API_KEY.length > 0) {
+    return "openai";
+  }
+  if (process.env.OPENROUTER_API_KEY !== void 0 && process.env.OPENROUTER_API_KEY.length > 0) {
+    return "openrouter";
+  }
+  return "openai";
+}
+var init_real_local_run_provider = __esm({
+  "src/internal/local-agent/real-local-run-provider.ts"() {
+    init_providers();
+  }
+});
+
+// src/internal/runtime/compression/compression-model-registry.ts
+function resolveCompressionModel(agentModel) {
+  const exact = EXACT_REGISTRY.get(agentModel);
+  if (exact !== void 0) return exact;
+  const wildcard = matchWildcard(agentModel);
+  if (wildcard !== null) return wildcard;
+  if (isNoAuthProvider(agentModel)) return agentModel;
+  throw new CompressionModelUnresolvedError(agentModel);
+}
+function matchWildcard(agentModel) {
+  for (const [pattern, replacement] of WILDCARD_REGISTRY) {
+    const prefix = pattern.endsWith("*") ? pattern.slice(0, -1) : pattern;
+    if (!agentModel.startsWith(prefix)) continue;
+    const suffix = agentModel.slice(prefix.length);
+    const replPrefix = replacement.endsWith("*") ? replacement.slice(0, -1) : replacement;
+    return `${replPrefix}${suffix}`;
+  }
+  return null;
+}
+function isNoAuthProvider(agentModel) {
+  const slashIdx = agentModel.indexOf("/");
+  if (slashIdx <= 0) return false;
+  return NO_AUTH_PROVIDERS.has(agentModel.slice(0, slashIdx));
+}
+var EXACT_REGISTRY, WILDCARD_REGISTRY, NO_AUTH_PROVIDERS, CompressionModelUnresolvedError;
+var init_compression_model_registry = __esm({
+  "src/internal/runtime/compression/compression-model-registry.ts"() {
+    EXACT_REGISTRY = /* @__PURE__ */ new Map([
+      // OpenAI family
+      ["openai/gpt-4o", "openai/gpt-4o-mini"],
+      ["openai/gpt-4-turbo", "openai/gpt-4o-mini"],
+      ["openai/gpt-4", "openai/gpt-4o-mini"],
+      ["openai/o1-preview", "openai/gpt-4o-mini"],
+      ["openai/o1", "openai/gpt-4o-mini"],
+      ["openai/o3", "openai/gpt-4o-mini"],
+      ["openai/o3-mini", "openai/gpt-4o-mini"],
+      // Anthropic family
+      ["anthropic/claude-opus-4", "anthropic/claude-3-5-haiku-latest"],
+      ["anthropic/claude-sonnet-4", "anthropic/claude-3-5-haiku-latest"],
+      ["anthropic/claude-3-5-sonnet", "anthropic/claude-3-5-haiku-latest"],
+      ["anthropic/claude-3-5-sonnet-latest", "anthropic/claude-3-5-haiku-latest"],
+      ["anthropic/claude-3-opus", "anthropic/claude-3-haiku"],
+      ["anthropic/claude-3-sonnet", "anthropic/claude-3-haiku"],
+      // Vertex (Gemini + Anthropic-on-Vertex)
+      ["vertex/gemini-1.5-pro", "vertex/gemini-1.5-flash"],
+      ["vertex/gemini-2.0-pro", "vertex/gemini-1.5-flash"],
+      ["vertex/claude-3-5-sonnet", "vertex/claude-3-5-haiku"],
+      ["vertex/claude-3-opus", "vertex/claude-3-haiku"],
+      // OpenRouter (preserve openrouter prefix, swap tier within same vendor)
+      ["openrouter/openai/gpt-4o", "openrouter/openai/gpt-4o-mini"],
+      ["openrouter/openai/gpt-4-turbo", "openrouter/openai/gpt-4o-mini"],
+      ["openrouter/anthropic/claude-3-5-sonnet", "openrouter/anthropic/claude-3-5-haiku"],
+      ["openrouter/anthropic/claude-opus-4", "openrouter/anthropic/claude-3-5-haiku"]
+    ]);
+    WILDCARD_REGISTRY = [
+      // Bedrock Anthropic: us.anthropic.claude-sonnet-* → us.anthropic.claude-3-haiku-*
+      ["bedrock/anthropic.claude-sonnet*", "bedrock/anthropic.claude-3-haiku*"],
+      ["bedrock/anthropic.claude-opus*", "bedrock/anthropic.claude-3-haiku*"],
+      ["bedrock/anthropic.claude-3-5-sonnet*", "bedrock/anthropic.claude-3-5-haiku*"]
+    ];
+    NO_AUTH_PROVIDERS = /* @__PURE__ */ new Set(["ollama", "lmstudio", "llamacpp"]);
+    CompressionModelUnresolvedError = class extends Error {
+      name = "CompressionModelUnresolvedError";
+      agentModel;
+      constructor(agentModel) {
+        super(
+          `Could not resolve a same-family-cheaper-tier compression model for "${agentModel}". Provide Agent.create({compression: {model: "<your-cheaper-model>"}}) OR add "${agentModel}" to the compression-model-registry (see ADR D440).`
+        );
+        this.agentModel = agentModel;
+      }
+    };
+  }
+});
+
+// src/internal/runtime/compression/compression-summarizer.ts
+function buildCompressionPrompt(messages) {
+  const formatted = messages.map((m) => `[${m.role}]: ${m.content}`).join("\n\n");
+  return `Summarize the following ${messages.length} conversation messages into a concise summary that preserves ALL facts, decisions, user preferences, and context needed for the conversation to continue naturally. The summary will replace these messages in the context window. Be thorough but concise.
+
+--- CONVERSATION TO SUMMARIZE ---
+${formatted}
+--- END ---`;
+}
+async function compressConversationWindow(opts) {
+  const userPrompt = buildCompressionPrompt(opts.messages);
+  let summary;
+  try {
+    summary = await opts.callLlm(opts.model, COMPRESSION_SYSTEM, userPrompt);
+  } catch (cause) {
+    throw new CompressionFailedError(
+      `Compression LLM call failed: ${cause instanceof Error ? cause.message : String(cause)}`,
+      { cause: cause instanceof Error ? cause : void 0 }
+    );
+  }
+  if (!summary || summary.trim().length === 0) {
+    throw new CompressionFailedError(
+      "Compression LLM returned empty summary \u2014 reduction ineffective."
+    );
+  }
+  return {
+    role: "system",
+    content: `[Compressed conversation summary]: ${summary.trim()}`
+  };
+}
+var CompressionFailedError, COMPRESSION_SYSTEM;
+var init_compression_summarizer = __esm({
+  "src/internal/runtime/compression/compression-summarizer.ts"() {
+    CompressionFailedError = class extends Error {
+      name = "CompressionFailedError";
+    };
+    COMPRESSION_SYSTEM = "You are a conversation summarizer. Produce a concise factual summary. Preserve all decisions, preferences, code snippets, and action items. Do not add commentary or opinions. Output ONLY the summary text.";
+  }
+});
+
+// src/internal/session/agent-session-store.ts
+function seedTranscript(prior, opts) {
+  return SessionTranscript.fromRecords(prior, opts);
+}
+function mapAgentTurn(steps) {
+  const assistant = {};
+  const toolResults = [];
+  const toolCalls = [];
+  for (const step of steps) {
+    if (step.type === "thinkingMessage") assistant.thinking = step.message.text;
+    else if (step.type === "assistantMessage") assistant.text = step.message.text;
+    else if (step.type === "toolCall")
+      toolCalls.push({
+        id: step.message.callId,
+        name: step.message.name,
+        input: step.message.args ?? {}
+      });
+    else
+      toolResults.push({
+        toolUseId: step.message.callId,
+        content: step.message.result,
+        isError: step.message.isError
+      });
+  }
+  if (toolCalls.length > 0) assistant.toolCalls = toolCalls;
+  return { assistant, toolResults };
+}
+function hasAssistantContent(a) {
+  return a.text !== void 0 || a.thinking !== void 0 || (a.toolCalls?.length ?? 0) > 0;
+}
+function appendConversation(transcript, conversation) {
+  for (const ct of conversation) {
+    if (ct.type !== "agentConversationTurn") continue;
+    const { assistant, toolResults } = mapAgentTurn(ct.turn.steps);
+    if (hasAssistantContent(assistant)) transcript.appendAssistantTurn(assistant);
+    if (toolResults.length > 0) transcript.appendToolResults(toolResults);
+  }
+}
+async function readSessionMessages(store, agentId) {
+  const records = await store.readRecords(agentId);
+  return reconstructMessages(records).map(narrowToSessionMessage);
+}
+function partToText(p) {
+  if (p.type === "text") return p.text ?? "";
+  if (p.type === "tool_use") return `[tool call] ${p.name ?? ""}`;
+  if (p.type === "tool_result") {
+    const body = typeof p.content === "string" ? p.content : JSON.stringify(p.content);
+    return `[tool result] ${body}`;
+  }
+  return "";
+}
+function narrowToSessionMessage(m) {
+  const role = m.role === "user" ? "user" : "assistant";
+  const text = m.content.map(partToText).filter((s) => s.length > 0).join("\n");
+  return { role, text };
+}
+function deltaRecords(transcript, priorLength) {
+  return transcript.records().slice(priorLength);
+}
+async function persistTurn(store, loc, sessionId, turn) {
+  const prior = await store.readRecords(loc.agentId);
+  const transcript = seedTranscript(prior, { cwd: loc.cwd, sessionId, model: loc.model });
+  transcript.appendUserTurn(turn.userText);
+  appendConversation(transcript, turn.conversation);
+  await store.appendRecords(loc.agentId, deltaRecords(transcript, prior.length));
+}
+var init_agent_session_store = __esm({
+  "src/internal/session/agent-session-store.ts"() {
+    init_session_transcript();
   }
 });
 
-// src/internal/local-agent/real-local-run-provider.ts
-var real_local_run_provider_exports = {};
-__export(real_local_run_provider_exports, {
-  detectPrimaryProvider: () => detectPrimaryProvider,
-  inferProviderFromApiKey: () => inferProviderFromApiKey
-});
-function inferProviderFromApiKey(apiKey) {
-  if (apiKey === void 0 || apiKey.length === 0) return void 0;
-  const byPrefix = [
-    { provider: "openrouter", prefix: "sk-or-" },
-    { provider: "anthropic", prefix: "sk-ant-" },
-    { provider: "openai", prefix: "sk-" }
-  ];
-  for (const { provider, prefix } of byPrefix) {
-    if (apiKey.startsWith(prefix) && getProviderProfile(provider) !== void 0) {
-      return provider;
+// src/internal/session/agent-session.ts
+function transcriptKey(cwd, agentId) {
+  return `${cwd}::${agentId}`;
+}
+function appendSessionMessage(agentId, message) {
+  const existing = sessions.get(agentId) ?? [];
+  existing.push(message);
+  sessions.set(agentId, existing);
+}
+function getSessionMessages(agentId) {
+  return sessions.get(agentId) ?? [];
+}
+function persistTurnToTranscript(store, loc, sessionId, turn, onCompact) {
+  const key = transcriptKey(loc.cwd, loc.agentId);
+  const chained = (pendingWrites.get(key) ?? Promise.resolve()).then(async () => {
+    try {
+      await persistTurn(store, loc, sessionId, turn);
+      const count = (recordCounts.get(key) ?? 0) + 1;
+      recordCounts.set(key, count);
+      if (turn.autoCompact !== void 0) {
+        const { autoCompactIfNeeded: autoCompactIfNeeded2 } = await Promise.resolve().then(() => (init_compact_session(), compact_session_exports));
+        const fired = await autoCompactIfNeeded2({
+          store,
+          loc,
+          sessionId,
+          usageTotal: turn.autoCompact.usageTotal,
+          contextWindow: turn.autoCompact.contextWindow,
+          turnCount: count,
+          summarize: turn.autoCompact.summarize
+        });
+        if (fired) onCompact?.();
+      }
+    } catch (cause) {
+      const msg = cause instanceof Error ? cause.message : String(cause);
+      process.stderr.write(
+        `[theokit-sdk] session transcript write failed (${loc.agentId}): ${msg}
+`
+      );
     }
-  }
-  return void 0;
+  });
+  pendingWrites.set(
+    key,
+    chained.then(
+      () => void 0,
+      () => void 0
+    )
+  );
 }
-function detectPrimaryProvider() {
-  if (process.env.ANTHROPIC_API_KEY !== void 0 && process.env.ANTHROPIC_API_KEY.length > 0) {
-    return "anthropic";
-  }
-  if (process.env.OPENAI_API_KEY !== void 0 && process.env.OPENAI_API_KEY.length > 0) {
-    return "openai";
+async function hydrateSession(agentId, loc) {
+  const key = transcriptKey(loc.cwd, agentId);
+  if (hydratedKeys.has(key)) return;
+  hydratedKeys.add(key);
+  const persisted = await readSessionMessages(loc.store, agentId);
+  if (persisted.length === 0) return;
+  if (!sessions.has(agentId) || sessions.get(agentId)?.length === 0) {
+    sessions.set(agentId, persisted);
   }
-  if (process.env.OPENROUTER_API_KEY !== void 0 && process.env.OPENROUTER_API_KEY.length > 0) {
-    return "openrouter";
+}
+async function flushSessionWrites() {
+  while (pendingWrites.size > 0) {
+    const all = Array.from(pendingWrites.values());
+    pendingWrites.clear();
+    await Promise.all(all);
   }
-  return "openai";
 }
-var init_real_local_run_provider = __esm({
-  "src/internal/local-agent/real-local-run-provider.ts"() {
-    init_providers();
+function clearSession(agentId) {
+  sessions.delete(agentId);
+}
+function invalidateSessionCache(cwd, agentId) {
+  sessions.delete(agentId);
+  hydratedKeys.delete(transcriptKey(cwd, agentId));
+}
+function enqueueSessionWrite(cwd, agentId, fn) {
+  const key = transcriptKey(cwd, agentId);
+  const prior = pendingWrites.get(key) ?? Promise.resolve();
+  const result = prior.then(fn);
+  pendingWrites.set(
+    key,
+    result.then(
+      () => void 0,
+      () => void 0
+    )
+  );
+  return result;
+}
+var sessions, hydratedKeys, pendingWrites, recordCounts;
+var init_agent_session = __esm({
+  "src/internal/session/agent-session.ts"() {
+    init_agent_session_store();
+    sessions = /* @__PURE__ */ new Map();
+    hydratedKeys = /* @__PURE__ */ new Set();
+    pendingWrites = /* @__PURE__ */ new Map();
+    recordCounts = /* @__PURE__ */ new Map();
   }
 });
 
@@ -6056,35 +6047,29 @@ ${summaryBody}`;
   transcript.appendUserTurn(summary);
   const delta = transcript.records().slice(prior.length);
   await opts.store.appendRecords(opts.loc.agentId, delta);
-  const { invalidateSessionCache: invalidateSessionCache2 } = await Promise.resolve().then(() => (init_agent_session(), agent_session_exports));
-  invalidateSessionCache2(opts.loc.cwd, opts.loc.agentId);
+  invalidateSessionCache(opts.loc.cwd, opts.loc.agentId);
   const postTokens = estimateTokens([...preserved, summary].join("\n"));
   return { preTokens, postTokens };
 }
 function buildDefaultSummarizer(opts) {
   return async (messages) => {
-    const { compressConversationWindow: compressConversationWindow2 } = await Promise.resolve().then(() => (init_compression_summarizer(), compression_summarizer_exports));
-    const { resolveCompressionModel: resolveCompressionModel2 } = await Promise.resolve().then(() => (init_compression_model_registry(), compression_model_registry_exports));
-    const { resolveProviderChain: resolveProviderChain2 } = await Promise.resolve().then(() => (init_router(), router_exports));
-    const { inferProviderFromApiKey: inferProviderFromApiKey2, detectPrimaryProvider: detectPrimaryProvider2 } = await Promise.resolve().then(() => (init_real_local_run_provider(), real_local_run_provider_exports));
-    const keyProvider = inferProviderFromApiKey2(opts.apiKey);
+    const keyProvider = inferProviderFromApiKey(opts.apiKey);
     const modelPrefix = opts.agentModel.includes("/") ? opts.agentModel.slice(0, opts.agentModel.indexOf("/")) : void 0;
-    const { registerBuiltins: registerBuiltins2, getProviderProfile: getProviderProfile2 } = await Promise.resolve().then(() => (init_providers(), providers_exports));
-    registerBuiltins2();
-    const prefixProfile = modelPrefix !== void 0 ? getProviderProfile2(modelPrefix) : void 0;
-    const provider = prefixProfile !== void 0 ? modelPrefix : keyProvider ?? detectPrimaryProvider2();
+    registerBuiltins();
+    const prefixProfile = modelPrefix !== void 0 ? getProviderProfile(modelPrefix) : void 0;
+    const provider = prefixProfile !== void 0 ? modelPrefix : keyProvider ?? detectPrimaryProvider();
     let model;
     if (provider !== modelPrefix) {
       model = opts.agentModel;
     } else {
       try {
-        model = resolveCompressionModel2(opts.agentModel);
+        model = resolveCompressionModel(opts.agentModel);
       } catch {
         model = opts.agentModel;
       }
     }
     const callLlm = async (m, system, user) => {
-      const chain = resolveProviderChain2({
+      const chain = resolveProviderChain({
         primary: provider,
         ...opts.apiKey !== void 0 ? { apiKeys: { [provider]: [opts.apiKey] } } : {}
       });
@@ -6104,7 +6089,7 @@ function buildDefaultSummarizer(opts) {
       }
       return text;
     };
-    const summary = await compressConversationWindow2({ messages: [...messages], model, callLlm });
+    const summary = await compressConversationWindow({ messages: [...messages], model, callLlm });
     return summary.content;
   };
 }
@@ -6138,6 +6123,12 @@ var COMPACT_SUMMARY_MARKER, COMPACT_USER_MESSAGE_MAX_TOKENS, autoCompactAttempts
 var init_compact_session = __esm({
   "src/internal/session/compact-session.ts"() {
     init_compaction();
+    init_router();
+    init_real_local_run_provider();
+    init_providers();
+    init_compression_model_registry();
+    init_compression_summarizer();
+    init_agent_session();
     init_session_transcript();
     COMPACT_SUMMARY_MARKER = "[[theokit:compact-summary]]";
     COMPACT_USER_MESSAGE_MAX_TOKENS = 2e4;
@@ -6149,122 +6140,6 @@ var init_compact_session = __esm({
     })();
   }
 });
-
-// src/internal/session/agent-session.ts
-var agent_session_exports = {};
-__export(agent_session_exports, {
-  appendSessionMessage: () => appendSessionMessage,
-  clearAllSessions: () => clearAllSessions,
-  clearSession: () => clearSession,
-  enqueueSessionWrite: () => enqueueSessionWrite,
-  flushSessionWrites: () => flushSessionWrites,
-  getSessionMessages: () => getSessionMessages,
-  hydrateSession: () => hydrateSession,
-  invalidateSessionCache: () => invalidateSessionCache,
-  persistTurnToTranscript: () => persistTurnToTranscript
-});
-function transcriptKey(cwd, agentId) {
-  return `${cwd}::${agentId}`;
-}
-function appendSessionMessage(agentId, message) {
-  const existing = sessions.get(agentId) ?? [];
-  existing.push(message);
-  sessions.set(agentId, existing);
-}
-function getSessionMessages(agentId) {
-  return sessions.get(agentId) ?? [];
-}
-function persistTurnToTranscript(store, loc, sessionId, turn, onCompact) {
-  const key = transcriptKey(loc.cwd, loc.agentId);
-  const chained = (pendingWrites.get(key) ?? Promise.resolve()).then(async () => {
-    try {
-      await persistTurn(store, loc, sessionId, turn);
-      const count = (recordCounts.get(key) ?? 0) + 1;
-      recordCounts.set(key, count);
-      if (turn.autoCompact !== void 0) {
-        const { autoCompactIfNeeded: autoCompactIfNeeded2 } = await Promise.resolve().then(() => (init_compact_session(), compact_session_exports));
-        const fired = await autoCompactIfNeeded2({
-          store,
-          loc,
-          sessionId,
-          usageTotal: turn.autoCompact.usageTotal,
-          contextWindow: turn.autoCompact.contextWindow,
-          turnCount: count,
-          summarize: turn.autoCompact.summarize
-        });
-        if (fired) onCompact?.();
-      }
-    } catch (cause) {
-      const msg = cause instanceof Error ? cause.message : String(cause);
-      process.stderr.write(
-        `[theokit-sdk] session transcript write failed (${loc.agentId}): ${msg}
-`
-      );
-    }
-  });
-  pendingWrites.set(
-    key,
-    chained.then(
-      () => void 0,
-      () => void 0
-    )
-  );
-}
-async function hydrateSession(agentId, loc) {
-  const key = transcriptKey(loc.cwd, agentId);
-  if (hydratedKeys.has(key)) return;
-  hydratedKeys.add(key);
-  const persisted = await readSessionMessages(loc.store, agentId);
-  if (persisted.length === 0) return;
-  if (!sessions.has(agentId) || sessions.get(agentId)?.length === 0) {
-    sessions.set(agentId, persisted);
-  }
-}
-async function flushSessionWrites() {
-  while (pendingWrites.size > 0) {
-    const all = Array.from(pendingWrites.values());
-    pendingWrites.clear();
-    await Promise.all(all);
-  }
-}
-function clearSession(agentId) {
-  sessions.delete(agentId);
-}
-function invalidateSessionCache(cwd, agentId) {
-  sessions.delete(agentId);
-  hydratedKeys.delete(transcriptKey(cwd, agentId));
-}
-function enqueueSessionWrite(cwd, agentId, fn) {
-  const key = transcriptKey(cwd, agentId);
-  const prior = pendingWrites.get(key) ?? Promise.resolve();
-  const result = prior.then(fn);
-  pendingWrites.set(
-    key,
-    result.then(
-      () => void 0,
-      () => void 0
-    )
-  );
-  return result;
-}
-function clearAllSessions() {
-  sessions.clear();
-  hydratedKeys.clear();
-  recordCounts.clear();
-  const g = globalThis;
-  const sym = /* @__PURE__ */ Symbol.for("theokit-sdk.session.auto-compact-attempts");
-  g[sym]?.clear();
-}
-var sessions, hydratedKeys, pendingWrites, recordCounts;
-var init_agent_session = __esm({
-  "src/internal/session/agent-session.ts"() {
-    init_agent_session_store();
-    sessions = /* @__PURE__ */ new Map();
-    hydratedKeys = /* @__PURE__ */ new Set();
-    pendingWrites = /* @__PURE__ */ new Map();
-    recordCounts = /* @__PURE__ */ new Map();
-  }
-});
 async function withToolWhitelist(whitelist, fn) {
   return toolWhitelistStore.run(whitelist, fn);
 }
@@ -10640,6 +10515,10 @@ async function writeSessionSummary(input) {
   await replaceFileAtomic(path, body);
 }
 
+// src/internal/runtime/lifecycle/post-run-lifecycle.ts
+init_catalog_loader();
+init_compact_session();
+
 // src/internal/runtime/memory/memory-path-selector.ts
 var PORT_MEMORY_PATH_ENV_VAR = "THEOKIT_PORT_MEMORY_PATH";
 function shouldUsePortMemoryPath() {
@@ -10687,9 +10566,7 @@ async function runPostRunLifecycle(inputs) {
     appendSessionMessage(agentId, { role: "assistant", text: result.result });
   }
   const conversation = await safeConversation(run);
-  const { getCatalogModelInfo: getCatalogModelInfo2 } = await Promise.resolve().then(() => (init_catalog_loader(), catalog_loader_exports));
-  const { buildDefaultSummarizer: buildDefaultSummarizer2 } = await Promise.resolve().then(() => (init_compact_session(), compact_session_exports));
-  const contextWindow = getCatalogModelInfo2(model)?.limit?.context;
+  const contextWindow = getCatalogModelInfo(model)?.limit?.context;
   if (contextWindow === void 0) {
     const g = globalThis;
     const sym = /* @__PURE__ */ Symbol.for("theokit-sdk.compact.no-cw-warned");
@@ -10714,7 +10591,7 @@ async function runPostRunLifecycle(inputs) {
       autoCompact: {
         usageTotal: usageForTrigger,
         contextWindow,
-        summarize: buildDefaultSummarizer2({
+        summarize: buildDefaultSummarizer({
           agentModel: model,
           ...inputs.apiKey !== void 0 ? { apiKey: inputs.apiKey } : {}
         })
@@ -19694,6 +19571,7 @@ async function getRegisteredAgentOrThrow(agentId) {
 // src/agent.ts
 init_errors();
 init_discovery();
+init_agent_session();
 init_agent_factory_registry();
 var streamObjectImport;
 var Agent = class _Agent {
@@ -19996,8 +19874,7 @@ var Agent = class _Agent {
     const { defaultBaseDir: defaultBaseDir2, expandTilde: expandTilde2 } = await Promise.resolve().then(() => (init_session_transcript(), session_transcript_exports));
     const baseDir = reg.options.local?.baseDir !== void 0 ? expandTilde2(reg.options.local.baseDir) : defaultBaseDir2();
     const store = new FsSessionStore2({ baseDir, cwd });
-    const { enqueueSessionWrite: enqueueSessionWrite2 } = await Promise.resolve().then(() => (init_agent_session(), agent_session_exports));
-    return enqueueSessionWrite2(cwd, agentId, () => compactSessionTranscript2({
+    return enqueueSessionWrite(cwd, agentId, () => compactSessionTranscript2({
       store,
       loc: { cwd, agentId, model },
       sessionId: agentId,