@theokit/sdk 4.16.3 → 4.16.5

package/dist/index.js

@@ -3,7 +3,7 @@ import { createRequire } from 'module';
 import { randomUUID, createHash, randomBytes } from 'crypto';
 import { mkdir, readFile, stat, open, rename, unlink, readdir, statfs, access } from 'fs/promises';
 import { join, dirname, relative, resolve, sep, isAbsolute } from 'path';
-import { readFileSync, existsSync, rmSync, mkdirSync, renameSync, realpathSync, lstatSync, readlinkSync, readdirSync, statSync, chmodSync, openSync, writeFileSync, fsyncSync, closeSync, unlinkSync } from 'fs';
+import { existsSync, rmSync, mkdirSync, renameSync, readFileSync, realpathSync, lstatSync, readlinkSync, readdirSync, statSync, chmodSync, openSync, writeFileSync, fsyncSync, closeSync, unlinkSync } from 'fs';
 import { homedir } from 'os';
 import { fileURLToPath, pathToFileURL } from 'url';
 import { AsyncLocalStorage } from 'async_hooks';
@@ -1757,140 +1757,6 @@ var init_session_summary_writer = __esm({
     MAX_TURN_CHARS = 2e3;
   }
 });
-
-// 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"() {
@@ -1971,19 +1837,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(key2, create) {
   const g = globalThis;
   const sym = Symbol.for(key2);
@@ -1997,16 +1850,6 @@ function getCatalogModelInfo(key2) {
 function isPatchedModelKey(key2) {
   return patchedModelKeys.has(key2);
 }
-function patchModelInfo(key2, model) {
-  ensureModelIndexLoaded();
-  const existing = modelInfoIndex.get(key2);
-  modelInfoIndex.set(key2, existing === void 0 ? model : { ...existing, ...model });
-  patchedModelKeys.add(key2);
-}
-function listModelInfoKeys() {
-  ensureModelIndexLoaded();
-  return [...modelInfoIndex.keys()];
-}
 function ensureModelIndexLoaded() {
   if (indexState.loaded) return;
   indexState.loaded = true;
@@ -2040,11 +1883,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;
@@ -2055,12 +1893,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);
@@ -2089,7 +1921,7 @@ function getCatalogCapabilities(providerId) {
   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;
@@ -2130,6 +1962,15 @@ var init_catalog_loader = __esm({
   }
 });
 
+// src/compaction.ts
+function estimateTokens(text) {
+  return Math.ceil(text.length / 4);
+}
+var init_compaction = __esm({
+  "src/compaction.ts"() {
+  }
+});
+
 // src/internal/providers/builtin/anthropic.ts
 var ANTHROPIC;
 var init_anthropic = __esm({
@@ -5774,12 +5615,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);
@@ -5877,9 +5712,6 @@ function warnNoAuthApiKeysIgnoredOnce(provider) {
 `
   );
 }
-function _resetNoAuthApiKeyWarnings() {
-  warnedNoAuthApiKeys.clear();
-}
 function sentinelForNoAuth(profile) {
   return profile.authType === "none" ? profile.name : void 0;
 }
@@ -5910,9 +5742,6 @@ function warnUnknownProvidersInApiKeys(apiKeys) {
     }
   }
 }
-function _resetCredentialPoolWarnings() {
-  warnedProviders.clear();
-}
 function resolveApiKey2(envVars) {
   for (const v of envVars) {
     const value = process.env[v];
@@ -6016,41 +5845,318 @@ var init_router = __esm({
   }
 });
 
-// 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/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/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 key2 = transcriptKey(loc.cwd, loc.agentId);
+  const chained = (pendingWrites.get(key2) ?? Promise.resolve()).then(async () => {
+    try {
+      await persistTurn(store, loc, sessionId, turn);
+      const count = (recordCounts.get(key2) ?? 0) + 1;
+      recordCounts.set(key2, 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(
+    key2,
+    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 key2 = transcriptKey(loc.cwd, agentId);
+  if (hydratedKeys.has(key2)) return;
+  hydratedKeys.add(key2);
+  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 key2 = transcriptKey(cwd, agentId);
+  const prior = pendingWrites.get(key2) ?? Promise.resolve();
+  const result = prior.then(fn);
+  pendingWrites.set(
+    key2,
+    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();
   }
 });
 
@@ -6092,7 +6198,14 @@ async function compactSessionTranscript(opts) {
     const m = compressible[i];
     if (m === void 0 || m.role !== "user" || isCompactSummary(m.content)) continue;
     const cost = estimateTokens(m.content);
-    if (budget + cost > COMPACT_USER_MESSAGE_MAX_TOKENS) break;
+    if (budget + cost > COMPACT_USER_MESSAGE_MAX_TOKENS) {
+      const remaining = COMPACT_USER_MESSAGE_MAX_TOKENS - budget;
+      if (remaining > 50) {
+        preserved.unshift(`${m.content.slice(0, remaining * 4)}
+[...truncated for compaction...]`);
+      }
+      break;
+    }
     budget += cost;
     preserved.unshift(m.content);
   }
@@ -6108,30 +6221,29 @@ ${summaryBody}`;
   transcript.appendUserTurn(summary);
   const delta = transcript.records().slice(prior.length);
   await opts.store.appendRecords(opts.loc.agentId, delta);
+  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 provider = 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] } } : {}
       });
@@ -6151,7 +6263,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;
   };
 }
@@ -6185,6 +6297,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;
@@ -13015,147 +13133,8 @@ function parseDecisionFromStdout(stdout) {
 // src/internal/runtime/lifecycle/post-run-lifecycle.ts
 init_run_events();
 init_session_summary_writer();
-
-// src/internal/session/agent-session-store.ts
-init_session_transcript();
-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));
-}
-
-// src/internal/session/agent-session.ts
-var sessions = /* @__PURE__ */ new Map();
-var hydratedKeys = /* @__PURE__ */ new Set();
-var pendingWrites = /* @__PURE__ */ new Map();
-var recordCounts = /* @__PURE__ */ new Map();
-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 key2 = transcriptKey(loc.cwd, loc.agentId);
-  const chained = (pendingWrites.get(key2) ?? Promise.resolve()).then(async () => {
-    try {
-      await persistTurn(store, loc, sessionId, turn);
-      const count = (recordCounts.get(key2) ?? 0) + 1;
-      recordCounts.set(key2, 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(
-    key2,
-    chained.then(
-      () => void 0,
-      () => void 0
-    )
-  );
-}
-async function hydrateSession(agentId, loc) {
-  const key2 = transcriptKey(loc.cwd, agentId);
-  if (hydratedKeys.has(key2)) return;
-  hydratedKeys.add(key2);
-  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);
-}
+init_catalog_loader();
+init_compact_session();
 
 // src/internal/runtime/memory/memory-path-selector.ts
 var PORT_MEMORY_PATH_ENV_VAR = "THEOKIT_PORT_MEMORY_PATH";
@@ -13204,9 +13183,21 @@ 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");
+    const warned3 = g[sym] ??= /* @__PURE__ */ new Set();
+    if (!warned3.has(model)) {
+      warned3.add(model);
+      process.stderr.write(
+        `[theokit-sdk] auto-compaction disabled: model "${model}" has no context-window entry in the catalog
+`
+      );
+    }
+  }
+  const lastRequestUsage = result.usage?.requests?.at(-1)?.totalTokens;
+  const usageForTrigger = lastRequestUsage ?? result.usage?.totalTokens;
   persistTurnToTranscript(
     sessionStore,
     { cwd: workspaceCwd, agentId, model },
@@ -13215,9 +13206,9 @@ async function runPostRunLifecycle(inputs) {
       userText,
       conversation,
       autoCompact: {
-        usageTotal: result.usage?.totalTokens,
+        usageTotal: usageForTrigger,
         contextWindow,
-        summarize: buildDefaultSummarizer2({
+        summarize: buildDefaultSummarizer({
           agentModel: model,
           ...inputs.apiKey !== void 0 ? { apiKey: inputs.apiKey } : {}
         })
@@ -21212,6 +21203,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 {
@@ -21514,7 +21506,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 });
-    return compactSessionTranscript2({
+    return enqueueSessionWrite(cwd, agentId, () => compactSessionTranscript2({
       store,
       loc: { cwd, agentId, model },
       sessionId: agentId,
@@ -21523,7 +21515,7 @@ var Agent = class _Agent {
         agentModel: model,
         ...reg.options.apiKey !== void 0 ? { apiKey: reg.options.apiKey } : {}
       })
-    });
+    }));
   }
   /**
    * Permanently delete a cloud agent.