@theokit/sdk 5.12.1 → 5.14.0

package/dist/index.cjs

@@ -1,18 +1,18 @@
 'use strict';
 
-var chunkHN4IKB6X_cjs = require('./chunk-HN4IKB6X.cjs');
+var chunk2XWAYCFM_cjs = require('./chunk-2XWAYCFM.cjs');
 var chunkOBA6YK2R_cjs = require('./chunk-OBA6YK2R.cjs');
 var chunkAIZ6WXSL_cjs = require('./chunk-AIZ6WXSL.cjs');
 var chunk6CXRYPG7_cjs = require('./chunk-6CXRYPG7.cjs');
-var chunk4YD2WI57_cjs = require('./chunk-4YD2WI57.cjs');
-require('./chunk-FEAWEBWN.cjs');
-var chunkZWLFHSON_cjs = require('./chunk-ZWLFHSON.cjs');
-require('./chunk-TLVI2OQK.cjs');
+var chunkR427EOZE_cjs = require('./chunk-R427EOZE.cjs');
+require('./chunk-PDOXYXWX.cjs');
+var chunkR35ZJAYT_cjs = require('./chunk-R35ZJAYT.cjs');
+require('./chunk-SETHRLQS.cjs');
 require('./chunk-VTYY7XL5.cjs');
-var chunkIO4RI5ZJ_cjs = require('./chunk-IO4RI5ZJ.cjs');
-var chunkQ6WT5535_cjs = require('./chunk-Q6WT5535.cjs');
+var chunkBZK5QL3N_cjs = require('./chunk-BZK5QL3N.cjs');
+var chunk2WY2OFSC_cjs = require('./chunk-2WY2OFSC.cjs');
 var chunkL7JPXZ2C_cjs = require('./chunk-L7JPXZ2C.cjs');
-require('./chunk-YOVZMN4P.cjs');
+require('./chunk-LXG6VL6R.cjs');
 require('./chunk-BUUUWQMB.cjs');
 require('./chunk-CWQPQTUZ.cjs');
 require('./chunk-7YUPSBDV.cjs');
@@ -22,7 +22,7 @@ require('./chunk-GHX4P3V2.cjs');
 require('./chunk-RS7YQR4X.cjs');
 var chunkSDZ4XDWS_cjs = require('./chunk-SDZ4XDWS.cjs');
 var chunk6OCJWGVD_cjs = require('./chunk-6OCJWGVD.cjs');
-var chunkLSWHDOCL_cjs = require('./chunk-LSWHDOCL.cjs');
+var chunkSNVYOX46_cjs = require('./chunk-SNVYOX46.cjs');
 require('./chunk-SXH37C7X.cjs');
 require('./chunk-YJNYDJ2T.cjs');
 require('./chunk-NP362THY.cjs');
@@ -39,7 +39,7 @@ require('./chunk-YSTXFWQE.cjs');
 require('./chunk-FRITRLZQ.cjs');
 require('./chunk-H7HD6RXO.cjs');
 require('./chunk-NINIJCHU.cjs');
-var chunk7WARNHWW_cjs = require('./chunk-7WARNHWW.cjs');
+var chunk3UMPP553_cjs = require('./chunk-3UMPP553.cjs');
 require('./chunk-SWALPLFQ.cjs');
 require('./chunk-IJ7M6GOG.cjs');
 require('./chunk-3KIUY67P.cjs');
@@ -59,13 +59,13 @@ require('./chunk-WDVG5R2Q.cjs');
 var chunkYQ3XC6C2_cjs = require('./chunk-YQ3XC6C2.cjs');
 require('./chunk-6XQLTQB6.cjs');
 var chunkKX5QXLBS_cjs = require('./chunk-KX5QXLBS.cjs');
-require('./chunk-NWWTYBD3.cjs');
+require('./chunk-4KBI37F3.cjs');
 var chunk3EE6LVWT_cjs = require('./chunk-3EE6LVWT.cjs');
-require('./chunk-LO6LIUZ6.cjs');
-var chunkS46WJTDL_cjs = require('./chunk-S46WJTDL.cjs');
+require('./chunk-R5UQL2R5.cjs');
+var chunk4TEGFMSP_cjs = require('./chunk-4TEGFMSP.cjs');
 require('./chunk-NVXXWAU7.cjs');
-require('./chunk-5A4UFBHW.cjs');
-require('./chunk-QISSETTG.cjs');
+require('./chunk-A77UMVMD.cjs');
+require('./chunk-5645PMVU.cjs');
 require('./chunk-IOFMRS6T.cjs');
 require('./chunk-EHD25JBZ.cjs');
 var chunkCEGU5AVD_cjs = require('./chunk-CEGU5AVD.cjs');
@@ -79,8 +79,8 @@ var os = require('os');
 // src/agent-factory.ts
 function createAgentFactory(common) {
   return {
-    forSession: (agentId, overrides) => chunkQ6WT5535_cjs.Agent.create(mergeAgentOptions(common, overrides, agentId)),
-    getOrCreate: (agentId, overrides) => chunkQ6WT5535_cjs.Agent.getOrCreate(agentId, mergeAgentOptions(common, overrides, agentId))
+    forSession: (agentId, overrides) => chunk2WY2OFSC_cjs.Agent.create(mergeAgentOptions(common, overrides, agentId)),
+    getOrCreate: (agentId, overrides) => chunk2WY2OFSC_cjs.Agent.getOrCreate(agentId, mergeAgentOptions(common, overrides, agentId))
   };
 }
 function mergeAgentOptions(common, overrides, agentId) {
@@ -571,8 +571,8 @@ var Provider = class _Provider {
    * `.plugins(Provider.builtins())` once, then pick a `provider/model` id. @public
    */
   static builtins() {
-    chunkS46WJTDL_cjs.registerBuiltins();
-    return chunkS46WJTDL_cjs.listProviders().map((profile) => defineProvider(profile));
+    chunk4TEGFMSP_cjs.registerBuiltins();
+    return chunk4TEGFMSP_cjs.listProviders().map((profile) => defineProvider(profile));
   }
   /**
    * The builtin serving `modelId`, or `undefined` when none does.
@@ -601,7 +601,7 @@ async function resolveBody(skill) {
   }
   const source = skill.source;
   const skillDir = path.dirname(source);
-  const body = chunk7WARNHWW_cjs.stripSkillFrontmatter(await promises.readFile(source, "utf8"));
+  const body = chunk3UMPP553_cjs.stripSkillFrontmatter(await promises.readFile(source, "utf8"));
   const instructions = body.replaceAll(SKILL_DIR_PLACEHOLDER, skillDir);
   const references = await readReferences(skillDir);
   return references === void 0 ? { instructions } : { instructions, references };
@@ -624,6 +624,14 @@ async function readReferences(skillDir) {
   }
   return Object.keys(refs).length > 0 ? refs : void 0;
 }
+function readNamed(skills, name) {
+  const skill = skills.find((s) => s.name === name);
+  if (skill === void 0) {
+    const available = skills.map((s) => s.name).join(", ");
+    return `Skill "${name}" not found. Available skills: ${available.length > 0 ? available : "(none)"}.`;
+  }
+  return renderSkill(skill);
+}
 var SkillReadInputSchema = zod.z.object({
   name: zod.z.string().min(1, "skill_read: `name` is required.")
 });
@@ -639,7 +647,9 @@ async function renderSkill(skill) {
   }
   return parts.join("\n");
 }
-function defineSkillReadTool(skills) {
+function defineSkillReadTool(source) {
+  if (typeof source === "function") return lazySkillReadTool(source);
+  const skills = source;
   const seen = /* @__PURE__ */ new Set();
   for (const skill of skills) {
     if (seen.has(skill.name)) {
@@ -660,12 +670,18 @@ function defineSkillReadTool(skills) {
     // promise: parse and the not-found answer stay exactly as synchronous as they were.
     handler: (input) => {
       const { name } = SkillReadInputSchema.parse(input);
-      const skill = skills.find((s) => s.name === name);
-      if (skill === void 0) {
-        const available = skills.map((s) => s.name).join(", ");
-        return `Skill "${name}" not found. Available skills: ${available.length > 0 ? available : "(none)"}.`;
-      }
-      return renderSkill(skill);
+      return readNamed(skills, name);
+    }
+  };
+}
+function lazySkillReadTool(source) {
+  const fixed = defineSkillReadTool([]);
+  return {
+    ...fixed,
+    handler: async (input) => {
+      const { name } = SkillReadInputSchema.parse(input);
+      const skills = await source();
+      return readNamed(skills, name);
     }
   };
 }
@@ -1284,7 +1300,7 @@ var Memory = {
       return await peer.IndexManager.open(openArgs);
     }
     const { IndexManager } = await import('./index-manager-HO456AVW.cjs');
-    openArgs.embedding = await resolveEmbedding(opts.embedding, chunkQ6WT5535_cjs.MEMORY_EMBEDDING_ADAPTERS);
+    openArgs.embedding = await resolveEmbedding(opts.embedding, chunk2WY2OFSC_cjs.MEMORY_EMBEDDING_ADAPTERS);
     return await IndexManager.open(openArgs);
   },
   /**
@@ -1295,7 +1311,7 @@ var Memory = {
    */
   async runDreamingSweep(opts) {
     const peer = await tryLoadSdkMemoryPeer();
-    const catalog = peer !== null ? peer.MEMORY_EMBEDDING_ADAPTERS : chunkQ6WT5535_cjs.MEMORY_EMBEDDING_ADAPTERS;
+    const catalog = peer !== null ? peer.MEMORY_EMBEDDING_ADAPTERS : chunk2WY2OFSC_cjs.MEMORY_EMBEDDING_ADAPTERS;
     const sweepArgs = await buildDreamingSweepArgs(opts, catalog);
     const result = peer !== null ? (
       // biome-ignore lint/suspicious/noExplicitAny: peer is dynamically loaded — structural compat ensured by sdk-memory
@@ -1906,7 +1922,7 @@ function guardSessionDestruction(sessionId, live) {
 // src/session-messages.ts
 async function readSessionMessages2(options) {
   const cwd = options.cwd ?? process.cwd();
-  const baseDir = chunkQ6WT5535_cjs.resolveSessionDir({ sessionDir: options.sessionDir });
+  const baseDir = chunk2WY2OFSC_cjs.resolveSessionDir({ sessionDir: options.sessionDir });
   return chunkMSW7LB2V_cjs.readSessionMessages(new chunk6OCJWGVD_cjs.FsSessionStore({ baseDir, cwd }), options.sessionId);
 }
 
@@ -1923,7 +1939,7 @@ function isBuiltAgent(m) {
   return typeof m.send === "function";
 }
 async function materialize(def, index) {
-  const { Agent: Agent2 } = await import('./agent-BVKIUP7F.cjs');
+  const { Agent: Agent2 } = await import('./agent-TL4K7BTG.cjs');
   return Agent2.create({
     // `AgentDefinition.model` admits the sentinel `'inherit'`, which is not a model id. Inheriting
     // here means "declare nothing and let the default apply" — forwarding the literal would create
@@ -1955,13 +1971,13 @@ function createSquad(options) {
   };
 }
 async function buildPipeline(agents, name) {
-  let builder = chunkZWLFHSON_cjs.Workflow.create({ name: name ?? "squad" });
+  let builder = chunkR35ZJAYT_cjs.Workflow.create({ name: name ?? "squad" });
   for (let i = 0; i < agents.length; i++) {
     const member = agents[i];
     if (member === void 0) continue;
     const agent = isBuiltAgent(member) ? member : await materialize(member, i);
     const opts = i > 0 ? { origin: { kind: "peer", from: `agent-${i - 1}` } } : void 0;
-    builder = builder.then(chunkZWLFHSON_cjs.agentStep(`agent-${i}`, agent, (prev) => String(prev), opts));
+    builder = builder.then(chunkR35ZJAYT_cjs.agentStep(`agent-${i}`, agent, (prev) => String(prev), opts));
   }
   return builder.commit();
 }
@@ -2065,7 +2081,7 @@ var FIXTURE_USER = {
 };
 var FIXTURE_MODELS = [
   {
-    id: chunkQ6WT5535_cjs.DEFAULT_AGENTIC_MODEL_ID,
+    id: chunk2WY2OFSC_cjs.DEFAULT_AGENTIC_MODEL_ID,
     name: "Gemini 2.0 Flash",
     displayName: "Gemini 2.0 Flash",
     parameters: [
@@ -2141,7 +2157,7 @@ async function listLocalModelsViaOpenAiCompat(baseUrl) {
   try {
     response = await fetch(url, { method: "GET" });
   } catch (fetchErr) {
-    const mapped = chunkLSWHDOCL_cjs.mapOllamaTransportError({
+    const mapped = chunkSNVYOX46_cjs.mapOllamaTransportError({
       providerId: "ollama",
       cause: fetchErr,
       endpoint: "/v1/models"
@@ -2153,8 +2169,8 @@ async function listLocalModelsViaOpenAiCompat(baseUrl) {
     );
   }
   if (!response.ok) {
-    const body = await chunkLSWHDOCL_cjs.readErrorResponseBody(response);
-    const mapped = chunkLSWHDOCL_cjs.mapOllamaHttpError({
+    const body = await chunkSNVYOX46_cjs.readErrorResponseBody(response);
+    const mapped = chunkSNVYOX46_cjs.mapOllamaHttpError({
       providerId: "ollama",
       status: response.status,
       body,
@@ -2217,9 +2233,9 @@ var Theokit = class {
       });
     },
     capabilities: (providerOrModelId) => {
-      chunkS46WJTDL_cjs.registerBuiltins();
+      chunk4TEGFMSP_cjs.registerBuiltins();
       const providerId = providerOrModelId.includes("/") ? providerOrModelId.split("/")[0] ?? providerOrModelId : providerOrModelId;
-      return chunkS46WJTDL_cjs.getCatalogCapabilities(providerId);
+      return chunk4TEGFMSP_cjs.getCatalogCapabilities(providerId);
     }
   };
   /**
@@ -2258,8 +2274,8 @@ var Theokit = class {
    */
   static inspect = {
     builtinProviders: () => {
-      chunkS46WJTDL_cjs.registerBuiltins();
-      return chunkS46WJTDL_cjs.listProviders().map((p) => ({
+      chunk4TEGFMSP_cjs.registerBuiltins();
+      return chunk4TEGFMSP_cjs.listProviders().map((p) => ({
         name: p.name,
         apiMode: p.apiMode,
         authType: p.authType,
@@ -2268,7 +2284,7 @@ var Theokit = class {
         envVars: p.envVars
       }));
     },
-    embeddingAdapters: () => Object.entries(chunkQ6WT5535_cjs.MEMORY_EMBEDDING_ADAPTERS).map(([id, adapter]) => ({
+    embeddingAdapters: () => Object.entries(chunk2WY2OFSC_cjs.MEMORY_EMBEDDING_ADAPTERS).map(([id, adapter]) => ({
       id,
       transport: adapter.transport,
       defaultModel: adapter.defaultModel
@@ -2285,9 +2301,9 @@ var Theokit = class {
   // and may be promoted onto Theokit once the agent.ts cycle is broken.
 };
 async function maybeListLocalModels(providerName) {
-  chunkS46WJTDL_cjs.registerBuiltins();
-  await chunkLSWHDOCL_cjs.discoverProviderPlugins();
-  const profile = chunkS46WJTDL_cjs.getProviderProfile(providerName);
+  chunk4TEGFMSP_cjs.registerBuiltins();
+  await chunkSNVYOX46_cjs.discoverProviderPlugins();
+  const profile = chunk4TEGFMSP_cjs.getProviderProfile(providerName);
   if (profile === void 0) return void 0;
   if (profile.authType !== "none") return void 0;
   const baseUrl = resolveLocalProviderBaseUrl(profile.name, profile.baseUrl);
@@ -2304,13 +2320,13 @@ async function executeCatalogRequest(request) {
   if (apiKey === void 0) {
     throw new chunkCEGU5AVD_cjs.AuthenticationError("Missing API key", { code: "missing_api_key" });
   }
-  if (chunkLSWHDOCL_cjs.shouldUseFixtureMode(apiKey)) {
+  if (chunkSNVYOX46_cjs.shouldUseFixtureMode(apiKey)) {
     return request.fixture;
   }
-  if (!chunkLSWHDOCL_cjs.isFixtureApiKey(apiKey) && process.env.THEOKIT_API_BASE_URL === void 0) {
+  if (!chunkSNVYOX46_cjs.isFixtureApiKey(apiKey) && process.env.THEOKIT_API_BASE_URL === void 0) {
     throw new chunkCEGU5AVD_cjs.AuthenticationError("Invalid API key", { code: "authentication_error" });
   }
-  return chunkLSWHDOCL_cjs.httpRequest(request.path, { apiKey });
+  return chunkSNVYOX46_cjs.httpRequest(request.path, { apiKey });
 }
 
 // src/tool-blast-radius.ts
@@ -2459,7 +2475,7 @@ function recordWiring(input) {
 
 Object.defineProperty(exports, "StreamObjectError", {
   enumerable: true,
-  get: function () { return chunkHN4IKB6X_cjs.StreamObjectError; }
+  get: function () { return chunk2XWAYCFM_cjs.StreamObjectError; }
 });
 Object.defineProperty(exports, "GOAL_CONTINUATION_MARKER", {
   enumerable: true,
@@ -2471,59 +2487,59 @@ Object.defineProperty(exports, "JudgeCredentialError", {
 });
 Object.defineProperty(exports, "GenerateObjectError", {
   enumerable: true,
-  get: function () { return chunk4YD2WI57_cjs.GenerateObjectError; }
+  get: function () { return chunkR427EOZE_cjs.GenerateObjectError; }
 });
 Object.defineProperty(exports, "Workflow", {
   enumerable: true,
-  get: function () { return chunkZWLFHSON_cjs.Workflow; }
+  get: function () { return chunkR35ZJAYT_cjs.Workflow; }
 });
 Object.defineProperty(exports, "agentStep", {
   enumerable: true,
-  get: function () { return chunkZWLFHSON_cjs.agentStep; }
+  get: function () { return chunkR35ZJAYT_cjs.agentStep; }
 });
 Object.defineProperty(exports, "fn", {
   enumerable: true,
-  get: function () { return chunkZWLFHSON_cjs.fn; }
+  get: function () { return chunkR35ZJAYT_cjs.fn; }
 });
 Object.defineProperty(exports, "Cron", {
   enumerable: true,
-  get: function () { return chunkIO4RI5ZJ_cjs.Cron; }
+  get: function () { return chunkBZK5QL3N_cjs.Cron; }
 });
 Object.defineProperty(exports, "Agent", {
   enumerable: true,
-  get: function () { return chunkQ6WT5535_cjs.Agent; }
+  get: function () { return chunk2WY2OFSC_cjs.Agent; }
 });
 Object.defineProperty(exports, "AgentBuilder", {
   enumerable: true,
-  get: function () { return chunkQ6WT5535_cjs.AgentBuilder; }
+  get: function () { return chunk2WY2OFSC_cjs.AgentBuilder; }
 });
 Object.defineProperty(exports, "Tool", {
   enumerable: true,
-  get: function () { return chunkQ6WT5535_cjs.Tool; }
+  get: function () { return chunk2WY2OFSC_cjs.Tool; }
 });
 Object.defineProperty(exports, "ToolError", {
   enumerable: true,
-  get: function () { return chunkQ6WT5535_cjs.ToolError; }
+  get: function () { return chunk2WY2OFSC_cjs.ToolError; }
 });
 Object.defineProperty(exports, "UsageAccumulator", {
   enumerable: true,
-  get: function () { return chunkQ6WT5535_cjs.UsageAccumulator; }
+  get: function () { return chunk2WY2OFSC_cjs.UsageAccumulator; }
 });
 Object.defineProperty(exports, "computeCost", {
   enumerable: true,
-  get: function () { return chunkQ6WT5535_cjs.computeCost; }
+  get: function () { return chunk2WY2OFSC_cjs.computeCost; }
 });
 Object.defineProperty(exports, "getPricingEntry", {
   enumerable: true,
-  get: function () { return chunkQ6WT5535_cjs.getPricingEntry; }
+  get: function () { return chunk2WY2OFSC_cjs.getPricingEntry; }
 });
 Object.defineProperty(exports, "managedSettingsPathFor", {
   enumerable: true,
-  get: function () { return chunkQ6WT5535_cjs.managedSettingsPathFor; }
+  get: function () { return chunk2WY2OFSC_cjs.managedSettingsPathFor; }
 });
 Object.defineProperty(exports, "readManagedSettings", {
   enumerable: true,
-  get: function () { return chunkQ6WT5535_cjs.readManagedSettings; }
+  get: function () { return chunk2WY2OFSC_cjs.readManagedSettings; }
 });
 Object.defineProperty(exports, "emitRunEvent", {
   enumerable: true,
@@ -2531,11 +2547,11 @@ Object.defineProperty(exports, "emitRunEvent", {
 });
 Object.defineProperty(exports, "inferApiMode", {
   enumerable: true,
-  get: function () { return chunkLSWHDOCL_cjs.inferApiMode; }
+  get: function () { return chunkSNVYOX46_cjs.inferApiMode; }
 });
 Object.defineProperty(exports, "normalizeUsage", {
   enumerable: true,
-  get: function () { return chunkLSWHDOCL_cjs.normalizeUsage; }
+  get: function () { return chunkSNVYOX46_cjs.normalizeUsage; }
 });
 Object.defineProperty(exports, "withCwdMutex", {
   enumerable: true,