@theokit/sdk 2.0.0 → 2.0.1

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 2.0.1
+
+### Patch Changes
+
+- aac62bc: Internal architecture cleanup (arch-review Groups A–D) — no public API or behavior change.
+
+  - **Group A:** widen the internal `agent-factory-registry` inversion seam from `create()` to a full `AgentFacadePort` (`create`/`prompt`/`get`/`resume`/`batch`); route `internal/{eval,scorers,cron}` through `getAgentFacade()` instead of importing the public `Agent` facade upward. A `internal-must-not-import-facade` dependency-cruiser rule now enforces the boundary. `cron.ts`/`eval.ts` gained an `import "./agent.js"` bootstrap (kept out of tree-shaking via the `sideEffects` allowlist) so the `@theokit/sdk/cron` and `@theokit/sdk/eval` sub-path entries still register the facade at load time.
+  - **Group B:** relocated the 17 loose `internal/runtime/*.ts` modules into cohesive sub-folders (`lifecycle/`, `validation/`, `concurrency/`, `tools/`, `config/`, plus folding `system-prompt.ts`/`yaml-frontmatter.ts` into existing dirs); removed the dead `internal/runtime/mcp-tools.ts`.
+  - **Group C:** removed the cargo-cult `TheoKitContainer` (was `@public` but never exported; `run()` discarded registered tools/workflows); the `multi-agent` template now uses `Agent.create()`.
+  - **Group D:** renamed `internal/errors/` → `internal/error-mappers/` (the directory holds only provider error-mappers, no error classes).
+
+  All changes are internal-only and behavior-preserving (full suite GREEN, `madge --circular` unchanged, depcruise clean). Consumers see no API or behavior difference.
+
 ## 2.0.0
 
 ### Major Changes
@@ -32,10 +45,15 @@
 
 ### Fixed
 
+- The Agent-facade bootstrap added in Group A (`import "./agent.js"` in `cron.ts`/`eval.ts`) was tree-shaken out of the built `cron.js`/`eval.js` bundles under `package.json "sideEffects": false` + tsup `treeshake: true`. SDK-source tests passed but real **dist** consumers (e.g. `@theokit/cli` via `@theokit/sdk/eval`) hit `internal: Agent facade not registered` at runtime. Declared `agent.{ts,js,cjs}` in the `sideEffects` allowlist so the bootstrap survives bundling while the rest of the package stays tree-shakeable. Bundle size unchanged from the pre-Group-A baseline. (arch-review Group A follow-up; caught by `pnpm validate`)
 - `Agent.batch` now validates its inputs at the boundary (fail-fast). Invalid `concurrency` (not a positive integer) throws `ConfigurationError(code: "invalid_concurrency")` with a user-facing message, and an empty/non-string prompt item throws `ConfigurationError(code: "invalid_batch_item")` — both BEFORE any credential pool is built or Task is registered. Previously invalid `concurrency` surfaced only deep inside the semaphore with a leaky "permits" message AND after task registration (a dangling Task could be registered with `task: true`), and empty-string prompts flowed silently to `agent.send`. New `validateBatchInput` pre-flight; whitespace-only prompts are intentionally still accepted (non-empty strings; the validator does not judge content). (arch-review cross-validation Gap 3)
 
 ### Changed
 
+- Renamed `src/internal/errors/` → `src/internal/error-mappers/`, collapsing the redundant `mappers/` nesting (arch-review Group D). The directory held only provider error-mapper implementations (anthropic, bedrock, ollama, openai-compatible, vertex, shared) and zero error classes — those live in `src/errors.ts` — so `errors/` was a misnomer. Pure rename + import-path fixups across importers, tests (moved to `tests/internal/error-mappers/`), and `docs/error-codes.md`; no API/behavior change.
+- Removed the cargo-cult `TheoKitContainer` (`src/theokit-container.ts`, arch-review Group C). It was `@public`-annotated but never exported from `index.ts` — no consumer could import it, so removal has zero real breaking impact — and its `run()` rebuilt a fresh `Agent.create` from only `model`/`apiKey`/`systemPrompt`, silently discarding the registered `tools`/`workflows` (dead, misleading surface that contradicts ADR D431's "factory functions are canonical; no in-SDK IoC container"). The `multi-agent` template + README now coordinate specialists via `Agent.create()`. The container's e2e error-propagation test was re-expressed as genuine coverage of the REAL `AgentDisposedError` thrown by `local-agent-send.ts` (the container had faked it with a string) — a net coverage gain. Deleted `tests/theokit-container.test.ts` + `tests/e2e/container-multi-agent.e2e.test.ts` (pure container bookkeeping, no Agent-level coverage).
+- Completed the `internal/runtime/` root cleanup (arch-review Group B). The flat root previously held 18 loose modules (down from 62 after M4); relocated the remaining 17 into cohesive sub-folders — `lifecycle/` (run-until, fork-agent, post-run-lifecycle, spawn-collect, auto-summarize), `validation/` (validate-agent-options, validate-response), `concurrency/` (async-local-storage, async-semaphore, abort-utils), `tools/` (shell-tool, hitl-middleware), `config/` (default-model, workspace-dir, providers-manager) — plus folding `system-prompt.ts` into the existing `system-prompt/` dir and `yaml-frontmatter.ts` into `context/`. `internal/runtime/` root now holds zero loose `.ts`. Removed the dead `internal/runtime/mcp-tools.ts` (`buildToolList` had zero callers; survived prior gates because orphan detection excludes `internal/`). Pure `git mv` + import-path fixups (39 importer files), one dead-code deletion; no API/behavior change. Full suite GREEN (2616 pass); `madge --circular` unchanged (1 type-only cycle); depcruise clean.
+- Closed the last 3 wrong-direction imports where `internal/{eval,scorers,cron}` imported the public `Agent` facade directly (arch-review Group A). The `agent-factory-registry` inversion seam was widened from a single `create()` to a full `AgentFacadePort` (`create`/`prompt`/`get`/`resume`/`batch`); `eval/runner` (batch), `scorers/llm-judge` (prompt), and `cron/run-job` (get/resume/create) now resolve the facade via `getAgentFacade()` instead of inverting the public-api → internal dependency direction. A new `internal-must-not-import-facade` dependency-cruiser rule permanently enforces the boundary. The `cron.ts`/`eval.ts` facades gained an explicit `import "./agent.js"` bootstrap so the `@theokit/sdk/cron` and `@theokit/sdk/eval` sub-path entries still register the facade at load time (preserving the side effect the removed direct imports used to provide). Fully internal — no API/behavior change; full suite GREEN, `madge --circular` unchanged (1 intentional type-only cycle), depcruise clean.
 - Reorganized the flat 62-file `src/internal/runtime/` god folder into sub-concern folders (arch-review M4): `local-agent/` (15), `cloud/` (6), `compression/` (6), `hooks/` (4), `budget/` (3), `memory/` (4), `session/` (3), `skills/` (3) — alongside the pre-existing `registry/`, `system-prompt/`, `context/`, `fixtures/`, `plugins/`. 18 cross-cutting singletons (abort-utils, async-_, default-model, fork-agent, run-until, system-prompt, validate-_, etc.) remain at the `runtime/` root (down from 62). Pure file moves + import-path updates (44 files moved, ~100 import sites rewritten incl. 2 lint-allowlist path updates); `internal/runtime` is not an exported subpath and has no tsup entry, so the change is fully internal — no API/behavior change. Full SDK suite GREEN (2629 tests); `madge --circular` unchanged (1 intentional type-only `memory/memory-provider` cycle).
 - Broke 2 of 3 type-only dependency cycles in the public type barrel (arch-review ADR 0001). `ForkOptions`/`ForkResult` moved to a leaf `types/fork.ts`, so `types/agent.ts` no longer imports the `internal/runtime/fork-agent.ts` implementation (`fork-agent.ts` re-exports them for back-compat). Eliminates the `types/agent.ts → fork-agent.ts → {plugins/types,(self)}` cycles. No behavior/API change; `madge --circular` drops from 3 to 1 (the remaining `memory-provider` cycle is a genuine bidirectional type relationship, runtime-safe, left intentionally).
 

package/dist/a2a/index.cjs

@@ -1043,10 +1043,10 @@ var init_path_guard = __esm({
   }
 });
 
-// src/internal/runtime/default-model.ts
+// src/internal/runtime/config/default-model.ts
 var DEFAULT_AGENTIC_MODEL_ID;
 var init_default_model = __esm({
-  "src/internal/runtime/default-model.ts"() {
+  "src/internal/runtime/config/default-model.ts"() {
     DEFAULT_AGENTIC_MODEL_ID = "google/gemini-2.0-flash-001";
   }
 });
@@ -1442,7 +1442,7 @@ var init_agent_registry = __esm({
   }
 });
 
-// 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;
@@ -1460,7 +1460,7 @@ async function resolveSystemPromptForSend(agent, override, buildCtx) {
   return resolveSystemPrompt(agent, override, ctx);
 }
 var init_system_prompt = __esm({
-  "src/internal/runtime/system-prompt.ts"() {
+  "src/internal/runtime/system-prompt/system-prompt.ts"() {
   }
 });
 
@@ -3114,7 +3114,7 @@ var init_paths = __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/)) {
@@ -3138,7 +3138,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) {
@@ -4142,7 +4142,7 @@ function spawnAndCollect(options) {
   });
 }
 var init_spawn_collect = __esm({
-  "src/internal/runtime/spawn-collect.ts"() {
+  "src/internal/runtime/lifecycle/spawn-collect.ts"() {
   }
 });
 
@@ -4239,33 +4239,6 @@ var init_hooks_executor = __esm({
     };
   }
 });
-
-// src/internal/runtime/memory/memory-path-selector.ts
-function shouldUsePortMemoryPath() {
-  const env = globalThis.process?.env;
-  if (env === void 0) return false;
-  const val = env[PORT_MEMORY_PATH_ENV_VAR];
-  return val === "1" || val === "true";
-}
-function resolveMemoryProviderForLoop(consumerSupplied, defaultAdapter, portPathEnabled) {
-  if (consumerSupplied !== void 0) return consumerSupplied;
-  if (portPathEnabled) return defaultAdapter;
-  return void 0;
-}
-function resolveMemoryToolsForLoop(legacyTools, portPathEnabled) {
-  if (portPathEnabled) return void 0;
-  return legacyTools;
-}
-function resolveActiveMemorySummaryForSend(legacySummary, portPathEnabled) {
-  if (portPathEnabled) return void 0;
-  return legacySummary;
-}
-var PORT_MEMORY_PATH_ENV_VAR;
-var init_memory_path_selector = __esm({
-  "src/internal/runtime/memory/memory-path-selector.ts"() {
-    PORT_MEMORY_PATH_ENV_VAR = "THEOKIT_PORT_MEMORY_PATH";
-  }
-});
 function sessionsDir(cwd) {
   return path.join(memoryDir(cwd), "sessions");
 }
@@ -4314,6 +4287,33 @@ var init_session_summary_writer = __esm({
     MAX_TURN_CHARS = 2e3;
   }
 });
+
+// src/internal/runtime/memory/memory-path-selector.ts
+function shouldUsePortMemoryPath() {
+  const env = globalThis.process?.env;
+  if (env === void 0) return false;
+  const val = env[PORT_MEMORY_PATH_ENV_VAR];
+  return val === "1" || val === "true";
+}
+function resolveMemoryProviderForLoop(consumerSupplied, defaultAdapter, portPathEnabled) {
+  if (consumerSupplied !== void 0) return consumerSupplied;
+  if (portPathEnabled) return defaultAdapter;
+  return void 0;
+}
+function resolveMemoryToolsForLoop(legacyTools, portPathEnabled) {
+  if (portPathEnabled) return void 0;
+  return legacyTools;
+}
+function resolveActiveMemorySummaryForSend(legacySummary, portPathEnabled) {
+  if (portPathEnabled) return void 0;
+  return legacySummary;
+}
+var PORT_MEMORY_PATH_ENV_VAR;
+var init_memory_path_selector = __esm({
+  "src/internal/runtime/memory/memory-path-selector.ts"() {
+    PORT_MEMORY_PATH_ENV_VAR = "THEOKIT_PORT_MEMORY_PATH";
+  }
+});
 function sessionFilePath(cwd, agentId) {
   const safe2 = sanitizeIdentifier(agentId, { maxLen: 128 });
   return safePathJoin(cwd, ".theokit", "agents", safe2, "messages.jsonl");
@@ -4587,7 +4587,7 @@ var init_agent_session = __esm({
   }
 });
 
-// src/internal/runtime/post-run-lifecycle.ts
+// src/internal/runtime/lifecycle/post-run-lifecycle.ts
 async function runPostRunLifecycle(inputs) {
   const {
     run,
@@ -4648,7 +4648,7 @@ async function runPostRunLifecycle(inputs) {
   await flushSessionWrites();
 }
 var init_post_run_lifecycle = __esm({
-  "src/internal/runtime/post-run-lifecycle.ts"() {
+  "src/internal/runtime/lifecycle/post-run-lifecycle.ts"() {
     init_session_summary_writer();
     init_memory_path_selector();
     init_agent_session();
@@ -4840,7 +4840,7 @@ async function readWorkspaceDir(root, errorCode, describe) {
   }
 }
 var init_workspace_dir = __esm({
-  "src/internal/runtime/workspace-dir.ts"() {
+  "src/internal/runtime/config/workspace-dir.ts"() {
     init_errors();
   }
 });
@@ -5171,7 +5171,7 @@ var init_pipeline = __esm({
   }
 });
 
-// src/internal/runtime/validate-agent-options.ts
+// src/internal/runtime/validation/validate-agent-options.ts
 function validateAgentOptions(options) {
   rejectProgrammaticHooks(options);
   ensureRuntimeShape(options);
@@ -5364,12 +5364,82 @@ function validateMemory(options) {
 }
 var TOOL_NAME_PATTERN, RESERVED_TOOL_NAMES;
 var init_validate_agent_options = __esm({
-  "src/internal/runtime/validate-agent-options.ts"() {
+  "src/internal/runtime/validation/validate-agent-options.ts"() {
     init_errors();
     TOOL_NAME_PATTERN = /^[a-zA-Z][a-zA-Z0-9_-]{0,63}$/;
     RESERVED_TOOL_NAMES = /* @__PURE__ */ new Set(["shell", "memory_search", "memory_get"]);
   }
 });
+
+// src/internal/runtime/config/providers-manager.ts
+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;
+}
+var ProvidersManagerImpl;
+var init_providers_manager = __esm({
+  "src/internal/runtime/config/providers-manager.ts"() {
+    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 truncateWithMarker(content, max) {
   if (content.length <= max) {
     return { truncated: false, finalContent: content };
@@ -6135,8 +6205,8 @@ var init_plugins_manager = __esm({
     init_errors();
     init_markdown_config_loader();
     init_path_guard();
-    init_hooks_source();
     init_workspace_dir();
+    init_hooks_source();
     init_plugin_frontmatter();
     PluginsManager = class {
       constructor(cwd, enabled, settingSourcesIncludePlugins, cloud, localPaths) {
@@ -6219,76 +6289,6 @@ var init_plugins_manager = __esm({
   }
 });
 
-// src/internal/runtime/providers-manager.ts
-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;
-}
-var ProvidersManagerImpl;
-var init_providers_manager = __esm({
-  "src/internal/runtime/providers-manager.ts"() {
-    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);
-      }
-    };
-  }
-});
-
 // src/internal/runtime/skills/skill-frontmatter.ts
 function asString(v) {
   return typeof v === "string" ? v : void 0;
@@ -6495,9 +6495,9 @@ function bootstrapSubmanagers(args) {
 }
 var init_local_agent_bootstrap = __esm({
   "src/internal/runtime/local-agent/local-agent-bootstrap.ts"() {
+    init_providers_manager();
     init_context_manager();
     init_plugins_manager();
-    init_providers_manager();
     init_agent_registry();
     init_skills_manager();
   }
@@ -6671,7 +6671,7 @@ var init_budget = __esm({
   }
 });
 
-// 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 : [];
@@ -6684,7 +6684,7 @@ function validateResponse(response) {
   return { ok: true };
 }
 var init_validate_response = __esm({
-  "src/internal/runtime/validate-response.ts"() {
+  "src/internal/runtime/validation/validate-response.ts"() {
   }
 });
 
@@ -7107,7 +7107,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 async_hooks.AsyncLocalStorage();
   }
 });
@@ -7190,7 +7190,7 @@ var init_repair_middleware = __esm({
   }
 });
 
-// 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 {
@@ -7221,7 +7221,7 @@ function isObviouslyUnsafe(command) {
   return false;
 }
 var init_shell_tool = __esm({
-  "src/internal/runtime/shell-tool.ts"() {
+  "src/internal/runtime/tools/shell-tool.ts"() {
     init_spawn_collect();
   }
 });
@@ -8538,7 +8538,7 @@ var init_providers = __esm({
   }
 });
 
-// src/internal/errors/mappers/shared.ts
+// src/internal/error-mappers/shared.ts
 function parseRetryAfter(headers) {
   if (headers === void 0) return void 0;
   const raw = headers.get("retry-after");
@@ -8567,13 +8567,13 @@ function buildErrorMetadata(args) {
 }
 var RAW_MAX_BYTES;
 var init_shared = __esm({
-  "src/internal/errors/mappers/shared.ts"() {
+  "src/internal/error-mappers/shared.ts"() {
     init_security();
     RAW_MAX_BYTES = 2048;
   }
 });
 
-// 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);
@@ -8627,7 +8627,7 @@ function formatMessage(status, code) {
   return `Anthropic API error: ${code} (HTTP ${status})`;
 }
 var init_anthropic2 = __esm({
-  "src/internal/errors/mappers/anthropic.ts"() {
+  "src/internal/error-mappers/anthropic.ts"() {
     init_errors();
     init_shared();
   }
@@ -8934,7 +8934,7 @@ var init_anthropic3 = __esm({
   }
 });
 
-// src/internal/errors/mappers/bedrock.ts
+// src/internal/error-mappers/bedrock.ts
 function classifyBedrockError(args, awsType, message) {
   if (args.status === 429 || awsType.includes("Throttling") || awsType.includes("TooManyRequests")) {
     return "rate_limit";
@@ -8994,7 +8994,7 @@ function parseBody(body) {
   return {};
 }
 var init_bedrock2 = __esm({
-  "src/internal/errors/mappers/bedrock.ts"() {
+  "src/internal/error-mappers/bedrock.ts"() {
     init_errors();
     init_shared();
   }
@@ -9381,7 +9381,7 @@ var init_credential_pool_context = __esm({
   }
 });
 
-// src/internal/errors/mappers/openai-compatible.ts
+// src/internal/error-mappers/openai-compatible.ts
 function mapOpenAICompatibleError(args) {
   const { providerId, status, body, headers, endpoint } = args;
   const code = mapOpenAiStatusToCode(status, body);
@@ -9444,7 +9444,7 @@ function formatMessage2(providerId, status, code) {
   return `${providerId} API error: ${code} (HTTP ${status})`;
 }
 var init_openai_compatible = __esm({
-  "src/internal/errors/mappers/openai-compatible.ts"() {
+  "src/internal/error-mappers/openai-compatible.ts"() {
     init_errors();
     init_shared();
   }
@@ -9556,7 +9556,7 @@ var init_fault_injection = __esm({
   }
 });
 
-// src/internal/errors/mappers/ollama.ts
+// src/internal/error-mappers/ollama.ts
 function mapOllamaTransportError(args) {
   if (args.providerId !== "ollama") return void 0;
   const causeCode = extractCauseCode(args.cause);
@@ -9629,7 +9629,7 @@ function extractModelName2(errString) {
   return match?.[1];
 }
 var init_ollama2 = __esm({
-  "src/internal/errors/mappers/ollama.ts"() {
+  "src/internal/error-mappers/ollama.ts"() {
     init_errors();
     init_shared();
   }
@@ -10230,7 +10230,7 @@ var init_pool_aware_client = __esm({
   }
 });
 
-// src/internal/errors/mappers/vertex.ts
+// src/internal/error-mappers/vertex.ts
 function classifyVertexError(args, errStatus) {
   for (const rule of VERTEX_RULES) {
     if (rule.test(args.status, errStatus)) return rule.code;
@@ -10267,7 +10267,7 @@ function parseBody2(body) {
 }
 var VERTEX_RULES, VERTEX_ERROR_BUILDERS;
 var init_vertex2 = __esm({
-  "src/internal/errors/mappers/vertex.ts"() {
+  "src/internal/error-mappers/vertex.ts"() {
     init_errors();
     init_shared();
     VERTEX_RULES = [
@@ -13836,7 +13836,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,
@@ -13929,7 +13929,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"() {
   }
 });
 
@@ -14040,16 +14040,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;
@@ -14060,7 +14060,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,
@@ -14120,7 +14120,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();
   }
@@ -14131,8 +14131,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 })
     };
@@ -14142,9 +14142,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_context2(), context_exports));
-  const create = getAgentCreate2();
+  const create = getAgentFacade2().create;
   return withPersonalityContext2(
     { slug: parent.personalitySlugSnapshot, isFork: true },
     () => forkAgentImpl2(parent, options, { create })
@@ -14168,7 +14168,7 @@ var init_local_agent_runtime_extensions = __esm({
   }
 });
 
-// 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) {
@@ -14194,7 +14194,7 @@ function ponyfillAny(signals) {
   return ctrl.signal;
 }
 var init_abort_utils = __esm({
-  "src/internal/runtime/abort-utils.ts"() {
+  "src/internal/runtime/concurrency/abort-utils.ts"() {
   }
 });
 
@@ -14347,7 +14347,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(
@@ -14385,7 +14385,7 @@ function createSemaphore(permits) {
   };
 }
 var init_async_semaphore = __esm({
-  "src/internal/runtime/async-semaphore.ts"() {
+  "src/internal/runtime/concurrency/async-semaphore.ts"() {
     init_errors();
   }
 });
@@ -14952,8 +14952,8 @@ var init_local_agent = __esm({
     init_span_names();
     init_tracer();
     init_hooks_executor();
-    init_memory_path_selector();
     init_post_run_lifecycle();
+    init_memory_path_selector();
     init_agent_registry();
     init_live_agent_registry();
     init_agent_session();
@@ -16422,7 +16422,13 @@ var init_agent = __esm({
         await flushRegistrySaves();
       }
     };
-    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)
+    });
   }
 });