@theokit/sdk 1.9.0 → 2.0.1

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { T as TheokitAgentError, B as BudgetOptions, a as BudgetHandle, b as BudgetSnapshot } from './errors-ChqOmFH1.cjs';
 export { A as AgentDisposedError, c as AgentRunError, d as AgentRunErrorCode, e as AuthenticationError, f as BudgetExceedEvent, g as BudgetExceededError, h as BudgetLimit, i as BudgetMode, j as BudgetScope, k as BudgetThresholdEvent, l as BudgetWindow, C as ConfigurationError, E as ErrorCode, m as ErrorMetadata, I as IntegrationNotConnectedError, n as InvalidTaskIdError, M as MemoryAdapterError, o as MemoryAdapterErrorCode, N as NetworkError, R as RateLimitError, p as TaskNotFoundError, U as UnknownAgentError, q as UnsupportedBudgetOperationError, r as UnsupportedRunOperationError, s as UnsupportedTaskOperationError } from './errors-ChqOmFH1.cjs';
-import { A as AgentOptions, L as LocalOptions, P as ProviderRoutingSettings, S as SystemPromptResolver, C as CloudOptions, M as MemorySettings, a as AgentDefinition, b as ContextSettings, c as PluginsSettings, d as SkillsSettings, e as SDKAgent, f as ListAgentsOptions, g as ListResult, h as SDKAgentInfo, G as GetAgentOptions, i as ListRunsOptions, j as GetRunOptions, k as AgentOperationOptions, l as ConversationStorageAdapter, m as StoredMessage, n as MemoryContext, B as BudgetTracker, o as MemoryProvider, p as MemoryId, q as SDKProvider } from './cron-Bse1MbaE.cjs';
-export { r as ActiveMemoryPassArgs, s as ActiveMemoryPassResult, t as AgentMemory, u as BudgetCheck, v as BudgetTotal, w as BudgetUsageEvent, x as CloudEnv, y as CloudRepo, z as ContextBudget, D as ContextManagerKind, E as ContextSnapshot, F as ContextSource, H as ContextSourceStatus, I as Cron, J as CronCreateOptions, K as CronGetOptions, N as CronJob, O as CronJobStatus, Q as CronListOptions, R as CronOperationOptions, T as CronRunOptions, U as CronRuntime, V as CronSchedulerStatus, W as CronStartOptions, X as GoalEvent, Y as GoalOptions, Z as GoalResult, _ as InvalidateCacheOptions, $ as MemoryAdapter, a0 as MemoryAdapterCapabilities, a1 as MemoryFact, a2 as MemoryProviderHandle, a3 as MemoryProviderInitOptions, a4 as MemoryRevision, a5 as MemoryToolSchema, a6 as MemoryTurnMessage, a7 as PersonalityPreset, a8 as ProviderCapability, a9 as ProviderRoute, aa as RecordSessionSummaryArgs, ab as ResolvedProviderRoute, ac as RunUntilIterator, ad as SDKAgentPlugins, ae as SDKAgentSkills, af as SDKArtifact, ag as SDKContextManager, ah as SDKPluginMetadata, ai as SDKProvidersManager, aj as SettingSource, ak as SystemPromptContext, al as SystemPromptMemoryFact, am as SystemPromptSkillRef, an as TelemetrySettings } from './cron-Bse1MbaE.cjs';
+import { A as AgentOptions, L as LocalOptions, P as ProviderRoutingSettings, S as SystemPromptResolver, C as CloudOptions, M as MemorySettings, a as AgentDefinition, b as ContextSettings, c as PluginsSettings, d as SkillsSettings, e as SDKAgent, f as ListAgentsOptions, g as ListResult, h as SDKAgentInfo, G as GetAgentOptions, i as ListRunsOptions, j as GetRunOptions, k as AgentOperationOptions, l as ConversationStorageAdapter, m as StoredMessage, n as MemoryContext, B as BudgetTracker, o as MemoryProvider, p as MemoryId, q as SDKProvider } from './cron-DFG9-W17.cjs';
+export { r as ActiveMemoryPassArgs, s as ActiveMemoryPassResult, t as AgentMemory, u as BudgetCheck, v as BudgetTotal, w as BudgetUsageEvent, x as CloudEnv, y as CloudRepo, z as ContextBudget, D as ContextManagerKind, E as ContextSnapshot, F as ContextSource, H as ContextSourceStatus, I as Cron, J as CronCreateOptions, K as CronGetOptions, N as CronJob, O as CronJobStatus, Q as CronListOptions, R as CronOperationOptions, T as CronRunOptions, U as CronRuntime, V as CronSchedulerStatus, W as CronStartOptions, X as GoalEvent, Y as GoalOptions, Z as GoalResult, _ as InvalidateCacheOptions, $ as MemoryAdapter, a0 as MemoryAdapterCapabilities, a1 as MemoryFact, a2 as MemoryProviderHandle, a3 as MemoryProviderInitOptions, a4 as MemoryRevision, a5 as MemoryToolSchema, a6 as MemoryTurnMessage, a7 as PersonalityPreset, a8 as ProviderCapability, a9 as ProviderRoute, aa as RecordSessionSummaryArgs, ab as ResolvedProviderRoute, ac as RunUntilIterator, ad as SDKAgentPlugins, ae as SDKAgentSkills, af as SDKArtifact, ag as SDKContextManager, ah as SDKPluginMetadata, ai as SDKProvidersManager, aj as SettingSource, ak as SystemPromptContext, al as SystemPromptMemoryFact, am as SystemPromptSkillRef, an as TelemetrySettings } from './cron-DFG9-W17.cjs';
 import { R as RunResult, M as ModelSelection, C as CustomTool, a as McpServerConfig, b as Run, S as SDKMessage } from './run-DrwUpFxZ.cjs';
 export { A as AgentConversationTurn, c as AssistantMessage, d as ConversationStep, e as ConversationTurn, f as CostBreakdown, g as CostSource, h as CostStatus, I as InteractionUpdate, i as McpAuthConfig, j as McpHttpServerConfig, k as McpOAuthConfig, l as McpStdioServerConfig, m as ModelParameterValue, P as PartialToolCallUpdate, n as RunErrorDetail, o as RunGitInfo, p as RunOperation, q as RunStatus, r as SDKAssistantMessage, s as SDKImage, t as SDKImageDimension, u as SDKObjectDelta, v as SDKRequestMessage, w as SDKStatusMessage, x as SDKSystemMessage, y as SDKTaskMessage, z as SDKThinkingMessage, B as SDKToolUseMessage, D as SDKUserMessage, E as SDKUserMessageEvent, F as SendOptions, G as ShellCommand, H as ShellConversationTurn, J as ShellOutput, K as ShellOutputDeltaUpdate, L as StepCompletedUpdate, N as StepStartedUpdate, O as SummaryCompletedUpdate, Q as SummaryStartedUpdate, T as SummaryUpdate, U as TextBlock, V as TextDeltaUpdate, W as ThinkingCompletedUpdate, X as ThinkingDeltaUpdate, Y as ThinkingMessage, Z as TokenDeltaUpdate, _ as TokenUsage, $ as ToolCall, a0 as ToolCallCompletedUpdate, a1 as ToolCallStartedUpdate, a2 as ToolResult, a3 as ToolUseBlock, a4 as TurnEndedUpdate, a5 as UserMessage, a6 as UserMessageAppendedUpdate } from './run-DrwUpFxZ.cjs';
 import * as zod from 'zod';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { T as TheokitAgentError, B as BudgetOptions, a as BudgetHandle, b as BudgetSnapshot } from './errors-DV9e0rcp.js';
 export { A as AgentDisposedError, c as AgentRunError, d as AgentRunErrorCode, e as AuthenticationError, f as BudgetExceedEvent, g as BudgetExceededError, h as BudgetLimit, i as BudgetMode, j as BudgetScope, k as BudgetThresholdEvent, l as BudgetWindow, C as ConfigurationError, E as ErrorCode, m as ErrorMetadata, I as IntegrationNotConnectedError, n as InvalidTaskIdError, M as MemoryAdapterError, o as MemoryAdapterErrorCode, N as NetworkError, R as RateLimitError, p as TaskNotFoundError, U as UnknownAgentError, q as UnsupportedBudgetOperationError, r as UnsupportedRunOperationError, s as UnsupportedTaskOperationError } from './errors-DV9e0rcp.js';
-import { A as AgentOptions, L as LocalOptions, P as ProviderRoutingSettings, S as SystemPromptResolver, C as CloudOptions, M as MemorySettings, a as AgentDefinition, b as ContextSettings, c as PluginsSettings, d as SkillsSettings, e as SDKAgent, f as ListAgentsOptions, g as ListResult, h as SDKAgentInfo, G as GetAgentOptions, i as ListRunsOptions, j as GetRunOptions, k as AgentOperationOptions, l as ConversationStorageAdapter, m as StoredMessage, n as MemoryContext, B as BudgetTracker, o as MemoryProvider, p as MemoryId, q as SDKProvider } from './cron-Ci_NUkUj.js';
-export { r as ActiveMemoryPassArgs, s as ActiveMemoryPassResult, t as AgentMemory, u as BudgetCheck, v as BudgetTotal, w as BudgetUsageEvent, x as CloudEnv, y as CloudRepo, z as ContextBudget, D as ContextManagerKind, E as ContextSnapshot, F as ContextSource, H as ContextSourceStatus, I as Cron, J as CronCreateOptions, K as CronGetOptions, N as CronJob, O as CronJobStatus, Q as CronListOptions, R as CronOperationOptions, T as CronRunOptions, U as CronRuntime, V as CronSchedulerStatus, W as CronStartOptions, X as GoalEvent, Y as GoalOptions, Z as GoalResult, _ as InvalidateCacheOptions, $ as MemoryAdapter, a0 as MemoryAdapterCapabilities, a1 as MemoryFact, a2 as MemoryProviderHandle, a3 as MemoryProviderInitOptions, a4 as MemoryRevision, a5 as MemoryToolSchema, a6 as MemoryTurnMessage, a7 as PersonalityPreset, a8 as ProviderCapability, a9 as ProviderRoute, aa as RecordSessionSummaryArgs, ab as ResolvedProviderRoute, ac as RunUntilIterator, ad as SDKAgentPlugins, ae as SDKAgentSkills, af as SDKArtifact, ag as SDKContextManager, ah as SDKPluginMetadata, ai as SDKProvidersManager, aj as SettingSource, ak as SystemPromptContext, al as SystemPromptMemoryFact, am as SystemPromptSkillRef, an as TelemetrySettings } from './cron-Ci_NUkUj.js';
+import { A as AgentOptions, L as LocalOptions, P as ProviderRoutingSettings, S as SystemPromptResolver, C as CloudOptions, M as MemorySettings, a as AgentDefinition, b as ContextSettings, c as PluginsSettings, d as SkillsSettings, e as SDKAgent, f as ListAgentsOptions, g as ListResult, h as SDKAgentInfo, G as GetAgentOptions, i as ListRunsOptions, j as GetRunOptions, k as AgentOperationOptions, l as ConversationStorageAdapter, m as StoredMessage, n as MemoryContext, B as BudgetTracker, o as MemoryProvider, p as MemoryId, q as SDKProvider } from './cron-Bj8-Aq1O.js';
+export { r as ActiveMemoryPassArgs, s as ActiveMemoryPassResult, t as AgentMemory, u as BudgetCheck, v as BudgetTotal, w as BudgetUsageEvent, x as CloudEnv, y as CloudRepo, z as ContextBudget, D as ContextManagerKind, E as ContextSnapshot, F as ContextSource, H as ContextSourceStatus, I as Cron, J as CronCreateOptions, K as CronGetOptions, N as CronJob, O as CronJobStatus, Q as CronListOptions, R as CronOperationOptions, T as CronRunOptions, U as CronRuntime, V as CronSchedulerStatus, W as CronStartOptions, X as GoalEvent, Y as GoalOptions, Z as GoalResult, _ as InvalidateCacheOptions, $ as MemoryAdapter, a0 as MemoryAdapterCapabilities, a1 as MemoryFact, a2 as MemoryProviderHandle, a3 as MemoryProviderInitOptions, a4 as MemoryRevision, a5 as MemoryToolSchema, a6 as MemoryTurnMessage, a7 as PersonalityPreset, a8 as ProviderCapability, a9 as ProviderRoute, aa as RecordSessionSummaryArgs, ab as ResolvedProviderRoute, ac as RunUntilIterator, ad as SDKAgentPlugins, ae as SDKAgentSkills, af as SDKArtifact, ag as SDKContextManager, ah as SDKPluginMetadata, ai as SDKProvidersManager, aj as SettingSource, ak as SystemPromptContext, al as SystemPromptMemoryFact, am as SystemPromptSkillRef, an as TelemetrySettings } from './cron-Bj8-Aq1O.js';
 import { R as RunResult, M as ModelSelection, C as CustomTool, a as McpServerConfig, b as Run, S as SDKMessage } from './run-DrwUpFxZ.js';
 export { A as AgentConversationTurn, c as AssistantMessage, d as ConversationStep, e as ConversationTurn, f as CostBreakdown, g as CostSource, h as CostStatus, I as InteractionUpdate, i as McpAuthConfig, j as McpHttpServerConfig, k as McpOAuthConfig, l as McpStdioServerConfig, m as ModelParameterValue, P as PartialToolCallUpdate, n as RunErrorDetail, o as RunGitInfo, p as RunOperation, q as RunStatus, r as SDKAssistantMessage, s as SDKImage, t as SDKImageDimension, u as SDKObjectDelta, v as SDKRequestMessage, w as SDKStatusMessage, x as SDKSystemMessage, y as SDKTaskMessage, z as SDKThinkingMessage, B as SDKToolUseMessage, D as SDKUserMessage, E as SDKUserMessageEvent, F as SendOptions, G as ShellCommand, H as ShellConversationTurn, J as ShellOutput, K as ShellOutputDeltaUpdate, L as StepCompletedUpdate, N as StepStartedUpdate, O as SummaryCompletedUpdate, Q as SummaryStartedUpdate, T as SummaryUpdate, U as TextBlock, V as TextDeltaUpdate, W as ThinkingCompletedUpdate, X as ThinkingDeltaUpdate, Y as ThinkingMessage, Z as TokenDeltaUpdate, _ as TokenUsage, $ as ToolCall, a0 as ToolCallCompletedUpdate, a1 as ToolCallStartedUpdate, a2 as ToolResult, a3 as ToolUseBlock, a4 as TurnEndedUpdate, a5 as UserMessage, a6 as UserMessageAppendedUpdate } from './run-DrwUpFxZ.js';
 import * as zod from 'zod';

package/dist/index.js

@@ -836,7 +836,7 @@ var init_markdown_store = __esm({
   }
 });
 
-// src/internal/runtime/yaml-frontmatter.ts
+// src/internal/runtime/context/yaml-frontmatter.ts
 function parseSimpleYaml(text) {
   const fields = {};
   for (const line of text.split(/\r?\n/)) {
@@ -860,7 +860,7 @@ function coerce(raw) {
   return raw;
 }
 var init_yaml_frontmatter = __esm({
-  "src/internal/runtime/yaml-frontmatter.ts"() {
+  "src/internal/runtime/context/yaml-frontmatter.ts"() {
   }
 });
 async function loadMarkdownEntities(opts) {
@@ -1111,7 +1111,7 @@ function checkToolWhitelist(toolName) {
 }
 var toolWhitelistStore;
 var init_async_local_storage = __esm({
-  "src/internal/runtime/async-local-storage.ts"() {
+  "src/internal/runtime/concurrency/async-local-storage.ts"() {
     toolWhitelistStore = new AsyncLocalStorage();
   }
 });
@@ -2490,7 +2490,7 @@ var init_local_agent_plugins = __esm({
   }
 });
 
-// src/internal/runtime/run-until.ts
+// src/internal/runtime/lifecycle/run-until.ts
 var run_until_exports = {};
 __export(run_until_exports, {
   composeContinuation: () => composeContinuation,
@@ -2583,7 +2583,7 @@ Your last response was:
 ${lastResponse.slice(0, 1e3)}`;
 }
 var init_run_until = __esm({
-  "src/internal/runtime/run-until.ts"() {
+  "src/internal/runtime/lifecycle/run-until.ts"() {
   }
 });
 
@@ -2694,16 +2694,16 @@ var init_judge_call = __esm({
 // src/internal/runtime/registry/agent-factory-registry.ts
 var agent_factory_registry_exports = {};
 __export(agent_factory_registry_exports, {
-  getAgentCreate: () => getAgentCreate,
-  setAgentCreate: () => setAgentCreate
+  getAgentFacade: () => getAgentFacade,
+  setAgentFacade: () => setAgentFacade
 });
-function setAgentCreate(fn) {
-  registered3 = fn;
+function setAgentFacade(facade) {
+  registered3 = facade;
 }
-function getAgentCreate() {
+function getAgentFacade() {
   if (registered3 === void 0) {
     throw new Error(
-      "internal: Agent.create not registered. The `agent.ts` module must be loaded before LocalAgent.runUntil/fork are invoked."
+      "internal: Agent facade not registered. The `agent.ts` module must be loaded before internal subsystems (LocalAgent.runUntil/fork, eval, scorers, cron) invoke it."
     );
   }
   return registered3;
@@ -2714,7 +2714,7 @@ var init_agent_factory_registry = __esm({
   }
 });
 
-// src/internal/runtime/fork-agent.ts
+// src/internal/runtime/lifecycle/fork-agent.ts
 var fork_agent_exports = {};
 __export(fork_agent_exports, {
   filterMemoryPlugins: () => filterMemoryPlugins,
@@ -2774,7 +2774,7 @@ function extractUsage(result) {
   };
 }
 var init_fork_agent = __esm({
-  "src/internal/runtime/fork-agent.ts"() {
+  "src/internal/runtime/lifecycle/fork-agent.ts"() {
     init_async_local_storage();
     init_local_agent_plugins();
   }
@@ -2797,7 +2797,7 @@ var init_task = __esm({
   }
 });
 
-// src/internal/runtime/async-semaphore.ts
+// src/internal/runtime/concurrency/async-semaphore.ts
 function createSemaphore(permits) {
   if (!Number.isInteger(permits) || permits < 1) {
     throw new ConfigurationError(
@@ -2835,7 +2835,7 @@ function createSemaphore(permits) {
   };
 }
 var init_async_semaphore = __esm({
-  "src/internal/runtime/async-semaphore.ts"() {
+  "src/internal/runtime/concurrency/async-semaphore.ts"() {
     init_errors();
   }
 });
@@ -5648,7 +5648,7 @@ init_errors();
 init_cwd_mutex();
 init_path_guard();
 
-// src/internal/runtime/default-model.ts
+// src/internal/runtime/config/default-model.ts
 var DEFAULT_AGENTIC_MODEL_ID = "google/gemini-2.0-flash-001";
 
 // src/internal/runtime/registry/agent-registry-store.ts
@@ -5969,7 +5969,7 @@ async function flushRegistrySaves(cwd) {
   }
 }
 
-// src/internal/runtime/system-prompt.ts
+// src/internal/runtime/system-prompt/system-prompt.ts
 async function resolveSystemPrompt(agent, override, ctx) {
   if (override !== void 0) return override;
   if (agent === void 0) return void 0;
@@ -8264,6 +8264,9 @@ function parseDecisionFromStdout(stdout) {
   return { decision: "allow" };
 }
 
+// src/internal/runtime/lifecycle/post-run-lifecycle.ts
+init_session_summary_writer();
+
 // src/internal/runtime/memory/memory-path-selector.ts
 var PORT_MEMORY_PATH_ENV_VAR = "THEOKIT_PORT_MEMORY_PATH";
 function shouldUsePortMemoryPath() {
@@ -8286,9 +8289,6 @@ function resolveActiveMemorySummaryForSend(legacySummary, portPathEnabled) {
   return legacySummary;
 }
 
-// src/internal/runtime/post-run-lifecycle.ts
-init_session_summary_writer();
-
 // src/internal/runtime/session/agent-session-store.ts
 init_atomic_write();
 init_security();
@@ -8547,7 +8547,7 @@ function clearSession(agentId) {
   sessions.delete(agentId);
 }
 
-// src/internal/runtime/post-run-lifecycle.ts
+// src/internal/runtime/lifecycle/post-run-lifecycle.ts
 async function runPostRunLifecycle(inputs) {
   const {
     run,
@@ -8779,7 +8779,7 @@ var liveAgentRegistry = new LiveAgentRegistry();
 // src/internal/runtime/skills/subagents-loader.ts
 init_errors();
 
-// src/internal/runtime/workspace-dir.ts
+// src/internal/runtime/config/workspace-dir.ts
 init_errors();
 async function readWorkspaceDir(root, errorCode, describe) {
   try {
@@ -9065,7 +9065,7 @@ var SystemPromptPipeline = class _SystemPromptPipeline {
   }
 };
 
-// src/internal/runtime/validate-agent-options.ts
+// src/internal/runtime/validation/validate-agent-options.ts
 init_errors();
 function validateAgentOptions(options) {
   rejectProgrammaticHooks(options);
@@ -9260,6 +9260,71 @@ function validateMemory(options) {
   }
 }
 
+// src/internal/runtime/config/providers-manager.ts
+var ProvidersManagerImpl = class {
+  constructor(model, providers, plugins) {
+    this.model = model;
+    this.providers = providers;
+    this.plugins = plugins;
+  }
+  model;
+  providers;
+  plugins;
+  routes() {
+    const resolved = [];
+    const modelProvider = providerFromModel(this.model);
+    const seen = /* @__PURE__ */ new Set();
+    if (this.providers?.routes !== void 0) {
+      for (const route of this.providers.routes) {
+        const resolvedRoute = resolveRoute(route, modelProvider, this.plugins);
+        if (!seen.has(route.capability)) {
+          seen.add(route.capability);
+          resolved.push(resolvedRoute);
+        }
+      }
+    }
+    return Promise.resolve(resolved);
+  }
+};
+function providerFromModel(model) {
+  if (model === void 0) return void 0;
+  const id = model.id;
+  if (id.includes(":")) return id.split(":")[0];
+  return void 0;
+}
+function resolveRoute(route, modelProvider, plugins) {
+  if (route.capability === "chat" && modelProvider === route.provider) {
+    const modelName = extractModelName(modelProvider, route);
+    const base = {
+      capability: route.capability,
+      provider: route.provider,
+      reason: "explicit-model-provider"
+    };
+    if (modelName !== void 0) base.model = modelName;
+    return base;
+  }
+  if (plugins?.enabled !== void 0 && plugins.enabled.length > 0) {
+    return {
+      capability: route.capability,
+      provider: route.provider,
+      reason: "first-available-plugin-provider"
+    };
+  }
+  return {
+    capability: route.capability,
+    provider: route.provider,
+    reason: "explicit-route"
+  };
+}
+function extractModelName(prefix, route) {
+  if (route.model !== void 0) return route.model;
+  return prefix === route.provider ? defaultModelForProvider(prefix) : void 0;
+}
+function defaultModelForProvider(provider) {
+  if (provider === "anthropic") return "claude-3-7-sonnet";
+  return void 0;
+}
+
 // src/internal/runtime/context/context-manager.ts
 init_errors();
 init_markdown_config_loader();
@@ -10057,71 +10122,6 @@ async function loadPluginManifestFromMarkdown(pluginsRoot, folderName) {
   return metadata;
 }
 
-// src/internal/runtime/providers-manager.ts
-var ProvidersManagerImpl = class {
-  constructor(model, providers, plugins) {
-    this.model = model;
-    this.providers = providers;
-    this.plugins = plugins;
-  }
-  model;
-  providers;
-  plugins;
-  routes() {
-    const resolved = [];
-    const modelProvider = providerFromModel(this.model);
-    const seen = /* @__PURE__ */ new Set();
-    if (this.providers?.routes !== void 0) {
-      for (const route of this.providers.routes) {
-        const resolvedRoute = resolveRoute(route, modelProvider, this.plugins);
-        if (!seen.has(route.capability)) {
-          seen.add(route.capability);
-          resolved.push(resolvedRoute);
-        }
-      }
-    }
-    return Promise.resolve(resolved);
-  }
-};
-function providerFromModel(model) {
-  if (model === void 0) return void 0;
-  const id = model.id;
-  if (id.includes(":")) return id.split(":")[0];
-  return void 0;
-}
-function resolveRoute(route, modelProvider, plugins) {
-  if (route.capability === "chat" && modelProvider === route.provider) {
-    const modelName = extractModelName(modelProvider, route);
-    const base = {
-      capability: route.capability,
-      provider: route.provider,
-      reason: "explicit-model-provider"
-    };
-    if (modelName !== void 0) base.model = modelName;
-    return base;
-  }
-  if (plugins?.enabled !== void 0 && plugins.enabled.length > 0) {
-    return {
-      capability: route.capability,
-      provider: route.provider,
-      reason: "first-available-plugin-provider"
-    };
-  }
-  return {
-    capability: route.capability,
-    provider: route.provider,
-    reason: "explicit-route"
-  };
-}
-function extractModelName(prefix, route) {
-  if (route.model !== void 0) return route.model;
-  return prefix === route.provider ? defaultModelForProvider(prefix) : void 0;
-}
-function defaultModelForProvider(provider) {
-  if (provider === "anthropic") return "claude-3-7-sonnet";
-  return void 0;
-}
-
 // src/internal/runtime/skills/skills-manager.ts
 init_errors();
 init_path_guard();
@@ -10469,7 +10469,7 @@ var IterationBudget = class {
   }
 };
 
-// src/internal/runtime/validate-response.ts
+// src/internal/runtime/validation/validate-response.ts
 function validateResponse(response) {
   const trimmed = response.content.trim();
   const toolCallsArr = Array.isArray(response.toolCalls) ? response.toolCalls : [];
@@ -10928,7 +10928,7 @@ function coerceArgsToSchema(args, schema) {
   return { value: out, changed };
 }
 
-// src/internal/runtime/shell-tool.ts
+// src/internal/runtime/tools/shell-tool.ts
 async function runShell(options) {
   if (options.sandbox === true && isObviouslyUnsafe(options.command)) {
     return {
@@ -12143,10 +12143,10 @@ function registerBuiltins() {
   registerCatalogProviders();
 }
 
-// src/internal/errors/mappers/anthropic.ts
+// src/internal/error-mappers/anthropic.ts
 init_errors();
 
-// src/internal/errors/mappers/shared.ts
+// src/internal/error-mappers/shared.ts
 init_security();
 var RAW_MAX_BYTES = 2048;
 function parseRetryAfter(headers) {
@@ -12176,7 +12176,7 @@ function buildErrorMetadata(args) {
   };
 }
 
-// src/internal/errors/mappers/anthropic.ts
+// src/internal/error-mappers/anthropic.ts
 function mapAnthropicError(args) {
   const { status, body, headers, endpoint } = args;
   const code = mapAnthropicStatusToCode(status, body);
@@ -12516,7 +12516,7 @@ function buildAnthropicBody(request) {
 // src/internal/llm/bedrock-anthropic.ts
 init_errors();
 
-// src/internal/errors/mappers/bedrock.ts
+// src/internal/error-mappers/bedrock.ts
 init_errors();
 function classifyBedrockError(args, awsType, message) {
   if (args.status === 429 || awsType.includes("Throttling") || awsType.includes("TooManyRequests")) {
@@ -12653,7 +12653,7 @@ function buildBedrockBody(request) {
 init_credential_pool();
 init_credential_pool_context();
 
-// src/internal/errors/mappers/openai-compatible.ts
+// src/internal/error-mappers/openai-compatible.ts
 init_errors();
 function mapOpenAICompatibleError(args) {
   const { providerId, status, body, headers, endpoint } = args;
@@ -12817,7 +12817,7 @@ function readOpenAiContent(body) {
   return void 0;
 }
 
-// src/internal/errors/mappers/ollama.ts
+// src/internal/error-mappers/ollama.ts
 init_errors();
 function mapOllamaTransportError(args) {
   if (args.providerId !== "ollama") return void 0;
@@ -13467,7 +13467,7 @@ function abortError2(signal) {
 // src/internal/llm/vertex-anthropic.ts
 init_errors();
 
-// src/internal/errors/mappers/vertex.ts
+// src/internal/error-mappers/vertex.ts
 init_errors();
 var VERTEX_RULES = [
   { test: (s, e) => s === 429 || e === "RESOURCE_EXHAUSTED", code: "rate_limit" },
@@ -15784,8 +15784,8 @@ function localAgentRunUntil(agent, goal, options) {
   async function* wrap() {
     const { runUntilImpl: runUntilImpl2 } = await Promise.resolve().then(() => (init_run_until(), run_until_exports));
     const { judgeCallImpl: judgeCallImpl2 } = await Promise.resolve().then(() => (init_judge_call(), judge_call_exports));
-    const { getAgentCreate: getAgentCreate2 } = await Promise.resolve().then(() => (init_agent_factory_registry(), agent_factory_registry_exports));
-    const create = getAgentCreate2();
+    const { getAgentFacade: getAgentFacade2 } = await Promise.resolve().then(() => (init_agent_factory_registry(), agent_factory_registry_exports));
+    const create = getAgentFacade2().create;
     const deps = {
       judge: async (ctx, opts) => judgeCallImpl2(ctx, opts, { create })
     };
@@ -15795,9 +15795,9 @@ function localAgentRunUntil(agent, goal, options) {
 }
 async function localAgentFork(parent, options) {
   const { forkAgentImpl: forkAgentImpl2 } = await Promise.resolve().then(() => (init_fork_agent(), fork_agent_exports));
-  const { getAgentCreate: getAgentCreate2 } = await Promise.resolve().then(() => (init_agent_factory_registry(), agent_factory_registry_exports));
+  const { getAgentFacade: getAgentFacade2 } = await Promise.resolve().then(() => (init_agent_factory_registry(), agent_factory_registry_exports));
   const { withPersonalityContext: withPersonalityContext2 } = await Promise.resolve().then(() => (init_context(), context_exports));
-  const create = getAgentCreate2();
+  const create = getAgentFacade2().create;
   return withPersonalityContext2(
     { slug: parent.personalitySlugSnapshot, isFork: true },
     () => forkAgentImpl2(parent, options, { create })
@@ -15818,7 +15818,7 @@ async function persistMemoryFactIfWritePrompt(workspaceCwd, memoryConfig, userTe
 // src/internal/runtime/local-agent/local-agent-send.ts
 init_errors();
 
-// src/internal/runtime/abort-utils.ts
+// src/internal/runtime/concurrency/abort-utils.ts
 function anySignal(signals) {
   const filtered = signals.filter((s) => s !== void 0);
   if (filtered.length === 0) {
@@ -16847,7 +16847,13 @@ async function getOrCreateUncached(agentId, options) {
     throw err;
   }
 }
-setAgentCreate((options) => Agent.create(options));
+setAgentFacade({
+  create: (options) => Agent.create(options),
+  prompt: (message, options) => Agent.prompt(message, options),
+  get: (agentId) => Agent.get(agentId),
+  resume: (agentId, options) => Agent.resume(agentId, options),
+  batch: (prompts, options) => Agent.batch(prompts, options)
+});
 
 // src/agent-factory.ts
 function createAgentFactory(common) {
@@ -17285,6 +17291,7 @@ init_errors();
 
 // src/internal/cron/run-job.ts
 init_errors();
+init_agent_factory_registry();
 async function runCronJob(job) {
   if (job.agent !== void 0) return runWithEphemeralAgent(job.agent, job.message);
   if (job.agentId !== void 0) return runWithExistingAgent(job.agentId, job.message);
@@ -17293,18 +17300,18 @@ async function runCronJob(job) {
   });
 }
 async function runWithExistingAgent(agentId, message) {
-  const info = await Agent.get(agentId).catch(() => void 0);
+  const info = await getAgentFacade().get(agentId).catch(() => void 0);
   if (info === void 0) {
     throw new UnknownAgentError(
       `Cron job references agentId "${agentId}" but no such agent is registered. The agent may have been disposed or the process restarted without persisting the agent registry.`,
       { code: "agent_not_registered" }
     );
   }
-  const agent = await Agent.resume(agentId);
+  const agent = await getAgentFacade().resume(agentId);
   return agent.send(message);
 }
 async function runWithEphemeralAgent(baseOptions, message) {
-  const agent = await Agent.create(baseOptions);
+  const agent = await getAgentFacade().create(baseOptions);
   return agent.send(message);
 }