@theokit/sdk 4.34.2 → 4.36.0

package/dist/cron.js

@@ -1,10 +1,10 @@
-export { Cron } from './chunk-MNLBNL7T.js';
-import './chunk-JZSBSUFT.js';
+export { Cron } from './chunk-LEJXBUBD.js';
+import './chunk-EKFA76N4.js';
 import './chunk-2SFBB54R.js';
 import './chunk-HRA3CPGG.js';
 import './chunk-7BTE3RXJ.js';
 import './chunk-K2BQQ445.js';
-import './chunk-4NU7GXH2.js';
+import './chunk-OKXUMCGM.js';
 import './chunk-IX2LKBCD.js';
 import './chunk-6CLRANZA.js';
 import './chunk-EEZ7CFMM.js';
@@ -20,7 +20,7 @@ import './chunk-UJ7IQJAG.js';
 import './chunk-7AD3ZTZL.js';
 import './chunk-V4XRLPEF.js';
 import './chunk-5PZMMF4H.js';
-import './chunk-QWP3ZQ75.js';
+import './chunk-BOTK6ZUP.js';
 import './chunk-UAYYNWYJ.js';
 import './chunk-77FOZCOT.js';
 import './chunk-2XLKLVVR.js';

package/dist/eval.cjs

@@ -1,12 +1,12 @@
 'use strict';
 
 var chunkS7OEXQMI_cjs = require('./chunk-S7OEXQMI.cjs');
-var chunkP7SIIQIS_cjs = require('./chunk-P7SIIQIS.cjs');
+var chunk3XJ7CS2C_cjs = require('./chunk-3XJ7CS2C.cjs');
 require('./chunk-BV2MWEMV.cjs');
 require('./chunk-MZ5ZRORA.cjs');
 require('./chunk-G4WI3VW2.cjs');
 var chunkBUUUWQMB_cjs = require('./chunk-BUUUWQMB.cjs');
-require('./chunk-RMRBHTA3.cjs');
+require('./chunk-AIDNODHJ.cjs');
 require('./chunk-WEHUJ7ZS.cjs');
 require('./chunk-LUSXDZPV.cjs');
 require('./chunk-IT3PWBW4.cjs');
@@ -22,7 +22,7 @@ require('./chunk-YPEPCZHF.cjs');
 require('./chunk-VJ26EKGJ.cjs');
 require('./chunk-GIW4L6HY.cjs');
 require('./chunk-7S7KKUO6.cjs');
-require('./chunk-AFOLLMVQ.cjs');
+require('./chunk-YRXTIESB.cjs');
 var chunkCJVMDRQB_cjs = require('./chunk-CJVMDRQB.cjs');
 require('./chunk-JD74LN7R.cjs');
 require('./chunk-YLQQX5W2.cjs');
@@ -768,7 +768,7 @@ function makeDefaultEmbedder(opts) {
   let runtime;
   return (texts) => {
     if (runtime === void 0) {
-      runtime = chunkP7SIIQIS_cjs.openRouterMemoryEmbeddingProviderAdapter.create(embedderCreateOptions(opts));
+      runtime = chunk3XJ7CS2C_cjs.openRouterMemoryEmbeddingProviderAdapter.create(embedderCreateOptions(opts));
     }
     return runtime.then((rt) => rt.embed(texts));
   };

package/dist/eval.js

@@ -1,10 +1,10 @@
 import { shellEscapePosix, LocalSandbox } from './chunk-SKWVAQAY.js';
-import { openRouterMemoryEmbeddingProviderAdapter } from './chunk-JZSBSUFT.js';
+import { openRouterMemoryEmbeddingProviderAdapter } from './chunk-EKFA76N4.js';
 import './chunk-2SFBB54R.js';
 import './chunk-HRA3CPGG.js';
 import './chunk-7BTE3RXJ.js';
 import { getTracer } from './chunk-K2BQQ445.js';
-import './chunk-4NU7GXH2.js';
+import './chunk-OKXUMCGM.js';
 import './chunk-IX2LKBCD.js';
 import './chunk-6CLRANZA.js';
 import './chunk-EEZ7CFMM.js';
@@ -20,7 +20,7 @@ import './chunk-UJ7IQJAG.js';
 import './chunk-7AD3ZTZL.js';
 import './chunk-V4XRLPEF.js';
 import './chunk-5PZMMF4H.js';
-import './chunk-QWP3ZQ75.js';
+import './chunk-BOTK6ZUP.js';
 import { readJsonlIds, appendJsonl } from './chunk-UAYYNWYJ.js';
 export { JsonlParseError, loadJsonl } from './chunk-UAYYNWYJ.js';
 import './chunk-77FOZCOT.js';

package/dist/fs-session-store-4ALCDU3K.js

@@ -0,0 +1,10 @@
+export { FsSessionStore } from './chunk-OKXUMCGM.js';
+import './chunk-BOTK6ZUP.js';
+import './chunk-UAYYNWYJ.js';
+import './chunk-2XLKLVVR.js';
+import './chunk-Q56IYTBZ.js';
+import './chunk-S2BBRVQX.js';
+import './chunk-WLKFWQSJ.js';
+import './chunk-JTFYYKDT.js';
+//# sourceMappingURL=fs-session-store-4ALCDU3K.js.map
+//# sourceMappingURL=fs-session-store-4ALCDU3K.js.map

package/dist/{fs-session-store-Q3E5S7MC.js.map → fs-session-store-4ALCDU3K.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"fs-session-store-Q3E5S7MC.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"fs-session-store-4ALCDU3K.js"}

package/dist/{fs-session-store-2G4O63PO.cjs → fs-session-store-IQYE35HX.cjs}

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkRMRBHTA3_cjs = require('./chunk-RMRBHTA3.cjs');
-require('./chunk-AFOLLMVQ.cjs');
+var chunkAIDNODHJ_cjs = require('./chunk-AIDNODHJ.cjs');
+require('./chunk-YRXTIESB.cjs');
 require('./chunk-CJVMDRQB.cjs');
 require('./chunk-YLQQX5W2.cjs');
 require('./chunk-2DYI7MIF.cjs');
@@ -13,7 +13,7 @@ require('./chunk-BEURCLDV.cjs');
 
 Object.defineProperty(exports, "FsSessionStore", {
   enumerable: true,
-  get: function () { return chunkRMRBHTA3_cjs.FsSessionStore; }
+  get: function () { return chunkAIDNODHJ_cjs.FsSessionStore; }
 });
-//# sourceMappingURL=fs-session-store-2G4O63PO.cjs.map
-//# sourceMappingURL=fs-session-store-2G4O63PO.cjs.map
+//# sourceMappingURL=fs-session-store-IQYE35HX.cjs.map
+//# sourceMappingURL=fs-session-store-IQYE35HX.cjs.map

package/dist/{fs-session-store-2G4O63PO.cjs.map → fs-session-store-IQYE35HX.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"fs-session-store-2G4O63PO.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"fs-session-store-IQYE35HX.cjs"}

package/dist/index.cjs

@@ -8,13 +8,13 @@ require('./chunk-EPYZOCOL.cjs');
 var chunkZ2OC3UIW_cjs = require('./chunk-Z2OC3UIW.cjs');
 require('./chunk-BWT67BI4.cjs');
 require('./chunk-PNVDQL5Y.cjs');
-var chunkBOTI6ZOX_cjs = require('./chunk-BOTI6ZOX.cjs');
-var chunkP7SIIQIS_cjs = require('./chunk-P7SIIQIS.cjs');
+var chunkY66627E4_cjs = require('./chunk-Y66627E4.cjs');
+var chunk3XJ7CS2C_cjs = require('./chunk-3XJ7CS2C.cjs');
 require('./chunk-BV2MWEMV.cjs');
 var chunkMZ5ZRORA_cjs = require('./chunk-MZ5ZRORA.cjs');
 require('./chunk-G4WI3VW2.cjs');
 require('./chunk-BUUUWQMB.cjs');
-require('./chunk-RMRBHTA3.cjs');
+require('./chunk-AIDNODHJ.cjs');
 var chunkWEHUJ7ZS_cjs = require('./chunk-WEHUJ7ZS.cjs');
 require('./chunk-LUSXDZPV.cjs');
 require('./chunk-IT3PWBW4.cjs');
@@ -30,7 +30,7 @@ require('./chunk-YPEPCZHF.cjs');
 require('./chunk-VJ26EKGJ.cjs');
 require('./chunk-GIW4L6HY.cjs');
 require('./chunk-7S7KKUO6.cjs');
-require('./chunk-AFOLLMVQ.cjs');
+require('./chunk-YRXTIESB.cjs');
 require('./chunk-CJVMDRQB.cjs');
 require('./chunk-JD74LN7R.cjs');
 var chunkYLQQX5W2_cjs = require('./chunk-YLQQX5W2.cjs');
@@ -58,8 +58,8 @@ var fs = require('fs');
 // src/agent-factory.ts
 function createAgentFactory(common) {
   return {
-    forSession: (agentId, overrides) => chunkP7SIIQIS_cjs.Agent.create(mergeAgentOptions(common, overrides, agentId)),
-    getOrCreate: (agentId, overrides) => chunkP7SIIQIS_cjs.Agent.getOrCreate(agentId, mergeAgentOptions(common, overrides, agentId))
+    forSession: (agentId, overrides) => chunk3XJ7CS2C_cjs.Agent.create(mergeAgentOptions(common, overrides, agentId)),
+    getOrCreate: (agentId, overrides) => chunk3XJ7CS2C_cjs.Agent.getOrCreate(agentId, mergeAgentOptions(common, overrides, agentId))
   };
 }
 function mergeAgentOptions(common, overrides, agentId) {
@@ -1165,7 +1165,7 @@ var Memory = {
       return await peer.IndexManager.open(openArgs);
     }
     const { IndexManager } = await import('./index-manager-H7HUMW52.cjs');
-    openArgs.embedding = await resolveEmbedding(opts.embedding, chunkP7SIIQIS_cjs.MEMORY_EMBEDDING_ADAPTERS);
+    openArgs.embedding = await resolveEmbedding(opts.embedding, chunk3XJ7CS2C_cjs.MEMORY_EMBEDDING_ADAPTERS);
     return await IndexManager.open(openArgs);
   },
   /**
@@ -1176,7 +1176,7 @@ var Memory = {
    */
   async runDreamingSweep(opts) {
     const peer = await tryLoadSdkMemoryPeer();
-    const catalog = peer !== null ? peer.MEMORY_EMBEDDING_ADAPTERS : chunkP7SIIQIS_cjs.MEMORY_EMBEDDING_ADAPTERS;
+    const catalog = peer !== null ? peer.MEMORY_EMBEDDING_ADAPTERS : chunk3XJ7CS2C_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
@@ -1598,7 +1598,7 @@ function ehAgenteConstruido(m) {
   return typeof m.send === "function";
 }
 async function materializar(def, indice) {
-  const { Agent: Agent2 } = await import('./agent-IJUQN6RK.cjs');
+  const { Agent: Agent2 } = await import('./agent-P77NPBF4.cjs');
   return Agent2.create({
     // `AgentDefinition.model` admite o sentinel `'inherit'`, que não é um id de modelo. Herdar
     // aqui significa "não declare nada e deixe o default valer" — passar o literal adiante criaria
@@ -1740,7 +1740,7 @@ var FIXTURE_USER = {
 };
 var FIXTURE_MODELS = [
   {
-    id: chunkP7SIIQIS_cjs.DEFAULT_AGENTIC_MODEL_ID,
+    id: chunk3XJ7CS2C_cjs.DEFAULT_AGENTIC_MODEL_ID,
     name: "Gemini 2.0 Flash",
     displayName: "Gemini 2.0 Flash",
     parameters: [
@@ -1948,7 +1948,7 @@ var Theokit = class {
         envVars: p.envVars
       }));
     },
-    embeddingAdapters: () => Object.entries(chunkP7SIIQIS_cjs.MEMORY_EMBEDDING_ADAPTERS).map(([id, adapter]) => ({
+    embeddingAdapters: () => Object.entries(chunk3XJ7CS2C_cjs.MEMORY_EMBEDDING_ADAPTERS).map(([id, adapter]) => ({
       id,
       transport: adapter.transport,
       defaultModel: adapter.defaultModel
@@ -1980,17 +1980,17 @@ function resolveLocalProviderBaseUrl(providerName, fallback) {
   return fallback;
 }
 async function executeCatalogRequest(request) {
-  const apiKey = chunkP7SIIQIS_cjs.resolveApiKey(request.apiKey);
+  const apiKey = chunk3XJ7CS2C_cjs.resolveApiKey(request.apiKey);
   if (apiKey === void 0) {
     throw new chunkA44COQJJ_cjs.AuthenticationError("Missing API key", { code: "missing_api_key" });
   }
-  if (chunkP7SIIQIS_cjs.shouldUseFixtureMode(apiKey)) {
+  if (chunk3XJ7CS2C_cjs.shouldUseFixtureMode(apiKey)) {
     return request.fixture;
   }
-  if (!chunkP7SIIQIS_cjs.isFixtureApiKey(apiKey) && process.env.THEOKIT_API_BASE_URL === void 0) {
+  if (!chunk3XJ7CS2C_cjs.isFixtureApiKey(apiKey) && process.env.THEOKIT_API_BASE_URL === void 0) {
     throw new chunkA44COQJJ_cjs.AuthenticationError("Invalid API key", { code: "authentication_error" });
   }
-  return chunkP7SIIQIS_cjs.httpRequest(request.path, { apiKey });
+  return chunk3XJ7CS2C_cjs.httpRequest(request.path, { apiKey });
 }
 
 // src/trajectory-helpers.ts
@@ -2106,35 +2106,35 @@ Object.defineProperty(exports, "GenerateObjectError", {
 });
 Object.defineProperty(exports, "Cron", {
   enumerable: true,
-  get: function () { return chunkBOTI6ZOX_cjs.Cron; }
+  get: function () { return chunkY66627E4_cjs.Cron; }
 });
 Object.defineProperty(exports, "Agent", {
   enumerable: true,
-  get: function () { return chunkP7SIIQIS_cjs.Agent; }
+  get: function () { return chunk3XJ7CS2C_cjs.Agent; }
 });
 Object.defineProperty(exports, "AgentBuilder", {
   enumerable: true,
-  get: function () { return chunkP7SIIQIS_cjs.AgentBuilder; }
+  get: function () { return chunk3XJ7CS2C_cjs.AgentBuilder; }
 });
 Object.defineProperty(exports, "Tool", {
   enumerable: true,
-  get: function () { return chunkP7SIIQIS_cjs.Tool; }
+  get: function () { return chunk3XJ7CS2C_cjs.Tool; }
 });
 Object.defineProperty(exports, "ToolError", {
   enumerable: true,
-  get: function () { return chunkP7SIIQIS_cjs.ToolError; }
+  get: function () { return chunk3XJ7CS2C_cjs.ToolError; }
 });
 Object.defineProperty(exports, "UsageAccumulator", {
   enumerable: true,
-  get: function () { return chunkP7SIIQIS_cjs.UsageAccumulator; }
+  get: function () { return chunk3XJ7CS2C_cjs.UsageAccumulator; }
 });
 Object.defineProperty(exports, "computeCost", {
   enumerable: true,
-  get: function () { return chunkP7SIIQIS_cjs.computeCost; }
+  get: function () { return chunk3XJ7CS2C_cjs.computeCost; }
 });
 Object.defineProperty(exports, "getPricingEntry", {
   enumerable: true,
-  get: function () { return chunkP7SIIQIS_cjs.getPricingEntry; }
+  get: function () { return chunk3XJ7CS2C_cjs.getPricingEntry; }
 });
 Object.defineProperty(exports, "emitRunEvent", {
   enumerable: true,

package/dist/index.js

@@ -6,15 +6,15 @@ import './chunk-GJAGKFTR.js';
 import { Workflow, agentStep } from './chunk-BFWPZMG7.js';
 import './chunk-UVNG67DG.js';
 import './chunk-CAH3G4IS.js';
-export { Cron } from './chunk-MNLBNL7T.js';
-import { MEMORY_EMBEDDING_ADAPTERS, resolveApiKey, shouldUseFixtureMode, isFixtureApiKey, httpRequest, DEFAULT_AGENTIC_MODEL_ID, Agent } from './chunk-JZSBSUFT.js';
-export { Agent, AgentBuilder, Tool, ToolError, UsageAccumulator, computeCost, getPricingEntry } from './chunk-JZSBSUFT.js';
+export { Cron } from './chunk-LEJXBUBD.js';
+import { MEMORY_EMBEDDING_ADAPTERS, resolveApiKey, shouldUseFixtureMode, isFixtureApiKey, httpRequest, DEFAULT_AGENTIC_MODEL_ID, Agent } from './chunk-EKFA76N4.js';
+export { Agent, AgentBuilder, Tool, ToolError, UsageAccumulator, computeCost, getPricingEntry } from './chunk-EKFA76N4.js';
 import './chunk-2SFBB54R.js';
 import { configure, submit, list, get, cancel, subscribe } from './chunk-HRA3CPGG.js';
 export { emitRunEvent } from './chunk-HRA3CPGG.js';
 import './chunk-7BTE3RXJ.js';
 import './chunk-K2BQQ445.js';
-import './chunk-4NU7GXH2.js';
+import './chunk-OKXUMCGM.js';
 import { discoverProviderPlugins, mapOllamaTransportError, mapOllamaHttpError } from './chunk-IX2LKBCD.js';
 import './chunk-6CLRANZA.js';
 import './chunk-EEZ7CFMM.js';
@@ -30,7 +30,7 @@ import './chunk-UJ7IQJAG.js';
 import './chunk-7AD3ZTZL.js';
 import './chunk-V4XRLPEF.js';
 import './chunk-5PZMMF4H.js';
-import './chunk-QWP3ZQ75.js';
+import './chunk-BOTK6ZUP.js';
 import './chunk-UAYYNWYJ.js';
 import './chunk-77FOZCOT.js';
 import { withCwdMutex } from './chunk-2XLKLVVR.js';
@@ -1600,7 +1600,7 @@ function ehAgenteConstruido(m) {
   return typeof m.send === "function";
 }
 async function materializar(def, indice) {
-  const { Agent: Agent2 } = await import('./agent-F77TRYGM.js');
+  const { Agent: Agent2 } = await import('./agent-H6HL5ITH.js');
   return Agent2.create({
     // `AgentDefinition.model` admite o sentinel `'inherit'`, que não é um id de modelo. Herdar
     // aqui significa "não declare nada e deixe o default valer" — passar o literal adiante criaria

package/dist/persistence.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var chunkPNVDQL5Y_cjs = require('./chunk-PNVDQL5Y.cjs');
-var chunkAFOLLMVQ_cjs = require('./chunk-AFOLLMVQ.cjs');
+var chunkYRXTIESB_cjs = require('./chunk-YRXTIESB.cjs');
 var chunkCJVMDRQB_cjs = require('./chunk-CJVMDRQB.cjs');
 var chunkJD74LN7R_cjs = require('./chunk-JD74LN7R.cjs');
 var chunkYLQQX5W2_cjs = require('./chunk-YLQQX5W2.cjs');
@@ -83,11 +83,15 @@ Object.defineProperty(exports, "PersistenceSchema", {
 });
 Object.defineProperty(exports, "SessionBusyError", {
   enumerable: true,
-  get: function () { return chunkAFOLLMVQ_cjs.SessionBusyError; }
+  get: function () { return chunkYRXTIESB_cjs.SessionBusyError; }
 });
 Object.defineProperty(exports, "acquireSessionWriter", {
   enumerable: true,
-  get: function () { return chunkAFOLLMVQ_cjs.acquireSessionWriter; }
+  get: function () { return chunkYRXTIESB_cjs.acquireSessionWriter; }
+});
+Object.defineProperty(exports, "sessaoTemEscritor", {
+  enumerable: true,
+  get: function () { return chunkYRXTIESB_cjs.sessaoTemEscritor; }
 });
 Object.defineProperty(exports, "JsonlParseError", {
   enumerable: true,

package/dist/persistence.d.cts

@@ -22,7 +22,7 @@ export { sanitizeFts5Query } from "./internal/persistence/fts5-sanitize.js";
 export { appendJsonl, JsonlParseError, loadJsonl, readJsonlIds, } from "./internal/persistence/jsonl.js";
 export { PersistenceSchema } from "./internal/persistence/persistence-schema.js";
 export { encodeProjectDir, transcriptPath, transcriptRoot, } from "./internal/persistence/session-transcript.js";
-export { acquireSessionWriter, SessionBusyError, type SessionWriterLease, } from "./internal/persistence/session-writer.js";
+export { acquireSessionWriter, SessionBusyError, type SessionWriterLease, sessaoTemEscritor, } from "./internal/persistence/session-writer.js";
 export type { OpenSqliteResilientOptions, ResilientSqliteDb, } from "./internal/persistence/sqlite-open.js";
 export { isCorruptionError, openSqliteResilient } from "./internal/persistence/sqlite-open.js";
 export type { WalApplyResult } from "./internal/persistence/sqlite-wal.js";

package/dist/persistence.d.ts

@@ -22,7 +22,7 @@ export { sanitizeFts5Query } from "./internal/persistence/fts5-sanitize.js";
 export { appendJsonl, JsonlParseError, loadJsonl, readJsonlIds, } from "./internal/persistence/jsonl.js";
 export { PersistenceSchema } from "./internal/persistence/persistence-schema.js";
 export { encodeProjectDir, transcriptPath, transcriptRoot, } from "./internal/persistence/session-transcript.js";
-export { acquireSessionWriter, SessionBusyError, type SessionWriterLease, } from "./internal/persistence/session-writer.js";
+export { acquireSessionWriter, SessionBusyError, type SessionWriterLease, sessaoTemEscritor, } from "./internal/persistence/session-writer.js";
 export type { OpenSqliteResilientOptions, ResilientSqliteDb, } from "./internal/persistence/sqlite-open.js";
 export { isCorruptionError, openSqliteResilient } from "./internal/persistence/sqlite-open.js";
 export type { WalApplyResult } from "./internal/persistence/sqlite-wal.js";

package/dist/persistence.js

@@ -1,5 +1,5 @@
 export { PersistenceSchema } from './chunk-CAH3G4IS.js';
-export { SessionBusyError, acquireSessionWriter } from './chunk-QWP3ZQ75.js';
+export { SessionBusyError, acquireSessionWriter, sessaoTemEscritor } from './chunk-BOTK6ZUP.js';
 export { JsonlParseError, appendJsonl, loadJsonl, readJsonlIds, withFileLock } from './chunk-UAYYNWYJ.js';
 export { applyWalWithFallback, isCorruptionError, openSqliteResilient, sanitizeFts5Query } from './chunk-77FOZCOT.js';
 export { withCwdMutex } from './chunk-2XLKLVVR.js';

package/dist/subagents-loader.cjs

@@ -2,15 +2,30 @@
 
 var chunkRZQ6E5YZ_cjs = require('./chunk-RZQ6E5YZ.cjs');
 require('./chunk-LALRCFSN.cjs');
-require('./chunk-A44COQJJ.cjs');
+var chunkA44COQJJ_cjs = require('./chunk-A44COQJJ.cjs');
 require('./chunk-BEURCLDV.cjs');
 
 // src/subagents-loader.ts
-async function discoverSubagents(cwd) {
-  return chunkRZQ6E5YZ_cjs.loadSubagents(cwd, true, void 0);
+var FONTES_ACEITAS = ["project"];
+function resolverFontes(options) {
+  const declaradas = options?.settingSources;
+  if (declaradas === void 0) return FONTES_ACEITAS;
+  for (const fonte of declaradas) {
+    if (!FONTES_ACEITAS.includes(fonte)) {
+      throw new chunkA44COQJJ_cjs.ConfigurationError(
+        `Unknown subagent setting source "${String(fonte)}" (accepted: ${FONTES_ACEITAS.join(", ")})`,
+        { code: "subagent_unknown_setting_source" }
+      );
+    }
+  }
+  return declaradas;
 }
-async function loadSubagentDefinition(name, cwd) {
-  return (await discoverSubagents(cwd))[name];
+async function discoverSubagents(cwd, options) {
+  const fontes = resolverFontes(options);
+  return chunkRZQ6E5YZ_cjs.loadSubagents(cwd, fontes.includes("project"), void 0);
+}
+async function loadSubagentDefinition(name, cwd, options) {
+  return (await discoverSubagents(cwd, options))[name];
 }
 
 exports.discoverSubagents = discoverSubagents;

package/dist/subagents-loader.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/subagents-loader.ts"],"names":["loadSubagents"],"mappings":";;;;;;;;AA4BA,eAAsB,kBAAkB,GAAA,EAAuD;AAC7F,EAAA,OAAOA,+BAAA,CAAc,GAAA,EAAK,IAAA,EAAM,MAAS,CAAA;AAC3C;AAQA,eAAsB,sBAAA,CACpB,MACA,GAAA,EACsC;AACtC,EAAA,OAAA,CAAQ,MAAM,iBAAA,CAAkB,GAAG,CAAA,EAAG,IAAI,CAAA;AAC5C","file":"subagents-loader.cjs","sourcesContent":["/**\n * M81 — `.theokit/agents` discovery, exposed so a consumer can read the on-disk subagent\n * definitions with one import instead of hand-rolling a second parser.\n *\n * ## Why this file exists\n *\n * `src/skills.ts` already exposed `discoverSkills` for the sibling domain. Subagents had the same\n * loader — `internal/runtime/skills/subagents-loader.ts` — with no public door. A consumer behind\n * the layer boundary (the agent-builder never imports `@theokit/sdk*` directly) could not reach it,\n * so re-implementing was the only legal option. It re-implemented, and then wrote a test whose only\n * job was to watch the two parsers for drift. That test is the cleanest possible evidence that the\n * duplication should not exist.\n *\n * ## What crosses is the PARSED config\n *\n * The return is `AgentDefinition` — already interpreted — never the `.md` text or the frontmatter\n * shape. Exporting the file format would freeze an internal detail as public API; exporting the\n * parsed value leaves the format free to change.\n */\n\nimport { loadSubagents } from \"./internal/runtime/skills/subagents-loader.js\";\nimport type { AgentDefinition } from \"./types/agent.js\";\n\n/**\n * Discover the subagents defined under `<cwd>/.theokit/agents/*.md`.\n *\n * An absent directory yields `{}` — a project without subagents is the common case, not an error.\n */\nexport async function discoverSubagents(cwd: string): Promise<Record<string, AgentDefinition>> {\n  return loadSubagents(cwd, true, undefined);\n}\n\n/**\n * Load ONE subagent definition by name, or `undefined` when it is not defined on disk.\n *\n * A thin selector over {@link discoverSubagents} rather than a second reader: one parser is the\n * whole point of this module.\n */\nexport async function loadSubagentDefinition(\n  name: string,\n  cwd: string,\n): Promise<AgentDefinition | undefined> {\n  return (await discoverSubagents(cwd))[name];\n}\n"]}
+{"version":3,"sources":["../src/subagents-loader.ts"],"names":["ConfigurationError","loadSubagents"],"mappings":";;;;;;;;AAuCA,IAAM,cAAA,GAA4C,CAAC,SAAS,CAAA;AAgB5D,SAAS,eAAe,OAAA,EAA0E;AAChG,EAAA,MAAM,aAAa,OAAA,EAAS,cAAA;AAC5B,EAAA,IAAI,UAAA,KAAe,QAAW,OAAO,cAAA;AACrC,EAAA,KAAA,MAAW,SAAS,UAAA,EAAY;AAC9B,IAAA,IAAI,CAAC,cAAA,CAAe,QAAA,CAAS,KAAK,CAAA,EAAG;AACnC,MAAA,MAAM,IAAIA,oCAAA;AAAA,QACR,CAAA,iCAAA,EAAoC,OAAO,KAAK,CAAC,gBAAgB,cAAA,CAAe,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA,CAAA;AAAA,QAC1F,EAAE,MAAM,iCAAA;AAAkC,OAC5C;AAAA,IACF;AAAA,EACF;AACA,EAAA,OAAO,UAAA;AACT;AAOA,eAAsB,iBAAA,CACpB,KACA,OAAA,EAC0C;AAC1C,EAAA,MAAM,MAAA,GAAS,eAAe,OAAO,CAAA;AACrC,EAAA,OAAOC,gCAAc,GAAA,EAAK,MAAA,CAAO,QAAA,CAAS,SAAS,GAAG,MAAS,CAAA;AACjE;AAQA,eAAsB,sBAAA,CACpB,IAAA,EACA,GAAA,EACA,OAAA,EACsC;AACtC,EAAA,OAAA,CAAQ,MAAM,iBAAA,CAAkB,GAAA,EAAK,OAAO,GAAG,IAAI,CAAA;AACrD","file":"subagents-loader.cjs","sourcesContent":["/**\n * M81 — `.theokit/agents` discovery, exposed so a consumer can read the on-disk subagent\n * definitions with one import instead of hand-rolling a second parser.\n *\n * ## Why this file exists\n *\n * `src/skills.ts` already exposed `discoverSkills` for the sibling domain. Subagents had the same\n * loader — `internal/runtime/skills/subagents-loader.ts` — with no public door. A consumer behind\n * the layer boundary (the agent-builder never imports `@theokit/sdk*` directly) could not reach it,\n * so re-implementing was the only legal option. It re-implemented, and then wrote a test whose only\n * job was to watch the two parsers for drift. That test is the cleanest possible evidence that the\n * duplication should not exist.\n *\n * ## What crosses is the PARSED config\n *\n * The return is `AgentDefinition` — already interpreted — never the `.md` text or the frontmatter\n * shape. Exporting the file format would freeze an internal detail as public API; exporting the\n * parsed value leaves the format free to change.\n */\n\nimport { ConfigurationError } from \"./errors.js\";\nimport { loadSubagents } from \"./internal/runtime/skills/subagents-loader.js\";\nimport type { AgentDefinition } from \"./types/agent.js\";\n\n/**\n * The parsed subagent definition this module hands back.\n *\n * Re-exported here — beside the loader that produces it — so a consumer can NAME the value it\n * receives without reaching into `types/agent`, which no subpath publishes. A layer above may then\n * alias it (`AgentDefinition as SubagentDefinition`) to sidestep a name it has already spent.\n */\nexport type { AgentDefinition } from \"./types/agent.js\";\n\n/**\n * Where subagent definitions may be read from. A closed union rather than a boolean: a third\n * source can join it without breaking the signature, and the call site reads as what it means.\n */\nexport type SubagentSource = \"project\";\n\nconst FONTES_ACEITAS: readonly SubagentSource[] = [\"project\"];\n\n/** Options for {@link discoverSubagents} / {@link loadSubagentDefinition}. */\nexport interface DiscoverSubagentsOptions {\n  /**\n   * Which sources to read. Defaults to `[\"project\"]` — `<cwd>/.theokit/agents/*.md`.\n   *\n   * An empty list reads NOTHING: the directory is never opened, so a caller that has not yet\n   * established trust in `cwd` can decline the read rather than filter its result.\n   */\n  readonly settingSources?: readonly SubagentSource[];\n}\n\n// Validated at the boundary (error-handling.md § 2): the union is erased at runtime, so a JS\n// caller — or a value crossing a serialization hop — can still carry a source nobody honors.\n// Dropping it silently would read as \"no subagents found\", which is the same shape as success.\nfunction resolverFontes(options: DiscoverSubagentsOptions | undefined): readonly SubagentSource[] {\n  const declaradas = options?.settingSources;\n  if (declaradas === undefined) return FONTES_ACEITAS;\n  for (const fonte of declaradas) {\n    if (!FONTES_ACEITAS.includes(fonte)) {\n      throw new ConfigurationError(\n        `Unknown subagent setting source \"${String(fonte)}\" (accepted: ${FONTES_ACEITAS.join(\", \")})`,\n        { code: \"subagent_unknown_setting_source\" },\n      );\n    }\n  }\n  return declaradas;\n}\n\n/**\n * Discover the subagents defined under `<cwd>/.theokit/agents/*.md`.\n *\n * An absent directory yields `{}` — a project without subagents is the common case, not an error.\n */\nexport async function discoverSubagents(\n  cwd: string,\n  options?: DiscoverSubagentsOptions,\n): Promise<Record<string, AgentDefinition>> {\n  const fontes = resolverFontes(options);\n  return loadSubagents(cwd, fontes.includes(\"project\"), undefined);\n}\n\n/**\n * Load ONE subagent definition by name, or `undefined` when it is not defined on disk.\n *\n * A thin selector over {@link discoverSubagents} rather than a second reader: one parser is the\n * whole point of this module.\n */\nexport async function loadSubagentDefinition(\n  name: string,\n  cwd: string,\n  options?: DiscoverSubagentsOptions,\n): Promise<AgentDefinition | undefined> {\n  return (await discoverSubagents(cwd, options))[name];\n}\n"]}

package/dist/subagents-loader.d.cts

@@ -22,18 +22,33 @@ import 'zod';
  * parsed value leaves the format free to change.
  */
 
+/**
+ * Where subagent definitions may be read from. A closed union rather than a boolean: a third
+ * source can join it without breaking the signature, and the call site reads as what it means.
+ */
+type SubagentSource = "project";
+/** Options for {@link discoverSubagents} / {@link loadSubagentDefinition}. */
+interface DiscoverSubagentsOptions {
+    /**
+     * Which sources to read. Defaults to `["project"]` — `<cwd>/.theokit/agents/*.md`.
+     *
+     * An empty list reads NOTHING: the directory is never opened, so a caller that has not yet
+     * established trust in `cwd` can decline the read rather than filter its result.
+     */
+    readonly settingSources?: readonly SubagentSource[];
+}
 /**
  * Discover the subagents defined under `<cwd>/.theokit/agents/*.md`.
  *
  * An absent directory yields `{}` — a project without subagents is the common case, not an error.
  */
-declare function discoverSubagents(cwd: string): Promise<Record<string, AgentDefinition>>;
+declare function discoverSubagents(cwd: string, options?: DiscoverSubagentsOptions): Promise<Record<string, AgentDefinition>>;
 /**
  * Load ONE subagent definition by name, or `undefined` when it is not defined on disk.
  *
  * A thin selector over {@link discoverSubagents} rather than a second reader: one parser is the
  * whole point of this module.
  */
-declare function loadSubagentDefinition(name: string, cwd: string): Promise<AgentDefinition | undefined>;
+declare function loadSubagentDefinition(name: string, cwd: string, options?: DiscoverSubagentsOptions): Promise<AgentDefinition | undefined>;
 
-export { discoverSubagents, loadSubagentDefinition };
+export { AgentDefinition, type DiscoverSubagentsOptions, type SubagentSource, discoverSubagents, loadSubagentDefinition };

package/dist/subagents-loader.d.ts

@@ -22,18 +22,33 @@ import 'zod';
  * parsed value leaves the format free to change.
  */
 
+/**
+ * Where subagent definitions may be read from. A closed union rather than a boolean: a third
+ * source can join it without breaking the signature, and the call site reads as what it means.
+ */
+type SubagentSource = "project";
+/** Options for {@link discoverSubagents} / {@link loadSubagentDefinition}. */
+interface DiscoverSubagentsOptions {
+    /**
+     * Which sources to read. Defaults to `["project"]` — `<cwd>/.theokit/agents/*.md`.
+     *
+     * An empty list reads NOTHING: the directory is never opened, so a caller that has not yet
+     * established trust in `cwd` can decline the read rather than filter its result.
+     */
+    readonly settingSources?: readonly SubagentSource[];
+}
 /**
  * Discover the subagents defined under `<cwd>/.theokit/agents/*.md`.
  *
  * An absent directory yields `{}` — a project without subagents is the common case, not an error.
  */
-declare function discoverSubagents(cwd: string): Promise<Record<string, AgentDefinition>>;
+declare function discoverSubagents(cwd: string, options?: DiscoverSubagentsOptions): Promise<Record<string, AgentDefinition>>;
 /**
  * Load ONE subagent definition by name, or `undefined` when it is not defined on disk.
  *
  * A thin selector over {@link discoverSubagents} rather than a second reader: one parser is the
  * whole point of this module.
  */
-declare function loadSubagentDefinition(name: string, cwd: string): Promise<AgentDefinition | undefined>;
+declare function loadSubagentDefinition(name: string, cwd: string, options?: DiscoverSubagentsOptions): Promise<AgentDefinition | undefined>;
 
-export { discoverSubagents, loadSubagentDefinition };
+export { AgentDefinition, type DiscoverSubagentsOptions, type SubagentSource, discoverSubagents, loadSubagentDefinition };

package/dist/subagents-loader.js

@@ -1,14 +1,29 @@
 import { loadSubagents } from './chunk-BNIFFFH3.js';
 import './chunk-FKCC2MED.js';
-import './chunk-WLKFWQSJ.js';
+import { ConfigurationError } from './chunk-WLKFWQSJ.js';
 import './chunk-JTFYYKDT.js';
 
 // src/subagents-loader.ts
-async function discoverSubagents(cwd) {
-  return loadSubagents(cwd, true, void 0);
+var FONTES_ACEITAS = ["project"];
+function resolverFontes(options) {
+  const declaradas = options?.settingSources;
+  if (declaradas === void 0) return FONTES_ACEITAS;
+  for (const fonte of declaradas) {
+    if (!FONTES_ACEITAS.includes(fonte)) {
+      throw new ConfigurationError(
+        `Unknown subagent setting source "${String(fonte)}" (accepted: ${FONTES_ACEITAS.join(", ")})`,
+        { code: "subagent_unknown_setting_source" }
+      );
+    }
+  }
+  return declaradas;
 }
-async function loadSubagentDefinition(name, cwd) {
-  return (await discoverSubagents(cwd))[name];
+async function discoverSubagents(cwd, options) {
+  const fontes = resolverFontes(options);
+  return loadSubagents(cwd, fontes.includes("project"), void 0);
+}
+async function loadSubagentDefinition(name, cwd, options) {
+  return (await discoverSubagents(cwd, options))[name];
 }
 
 export { discoverSubagents, loadSubagentDefinition };

package/dist/subagents-loader.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/subagents-loader.ts"],"names":[],"mappings":";;;;;;AA4BA,eAAsB,kBAAkB,GAAA,EAAuD;AAC7F,EAAA,OAAO,aAAA,CAAc,GAAA,EAAK,IAAA,EAAM,MAAS,CAAA;AAC3C;AAQA,eAAsB,sBAAA,CACpB,MACA,GAAA,EACsC;AACtC,EAAA,OAAA,CAAQ,MAAM,iBAAA,CAAkB,GAAG,CAAA,EAAG,IAAI,CAAA;AAC5C","file":"subagents-loader.js","sourcesContent":["/**\n * M81 — `.theokit/agents` discovery, exposed so a consumer can read the on-disk subagent\n * definitions with one import instead of hand-rolling a second parser.\n *\n * ## Why this file exists\n *\n * `src/skills.ts` already exposed `discoverSkills` for the sibling domain. Subagents had the same\n * loader — `internal/runtime/skills/subagents-loader.ts` — with no public door. A consumer behind\n * the layer boundary (the agent-builder never imports `@theokit/sdk*` directly) could not reach it,\n * so re-implementing was the only legal option. It re-implemented, and then wrote a test whose only\n * job was to watch the two parsers for drift. That test is the cleanest possible evidence that the\n * duplication should not exist.\n *\n * ## What crosses is the PARSED config\n *\n * The return is `AgentDefinition` — already interpreted — never the `.md` text or the frontmatter\n * shape. Exporting the file format would freeze an internal detail as public API; exporting the\n * parsed value leaves the format free to change.\n */\n\nimport { loadSubagents } from \"./internal/runtime/skills/subagents-loader.js\";\nimport type { AgentDefinition } from \"./types/agent.js\";\n\n/**\n * Discover the subagents defined under `<cwd>/.theokit/agents/*.md`.\n *\n * An absent directory yields `{}` — a project without subagents is the common case, not an error.\n */\nexport async function discoverSubagents(cwd: string): Promise<Record<string, AgentDefinition>> {\n  return loadSubagents(cwd, true, undefined);\n}\n\n/**\n * Load ONE subagent definition by name, or `undefined` when it is not defined on disk.\n *\n * A thin selector over {@link discoverSubagents} rather than a second reader: one parser is the\n * whole point of this module.\n */\nexport async function loadSubagentDefinition(\n  name: string,\n  cwd: string,\n): Promise<AgentDefinition | undefined> {\n  return (await discoverSubagents(cwd))[name];\n}\n"]}
+{"version":3,"sources":["../src/subagents-loader.ts"],"names":[],"mappings":";;;;;;AAuCA,IAAM,cAAA,GAA4C,CAAC,SAAS,CAAA;AAgB5D,SAAS,eAAe,OAAA,EAA0E;AAChG,EAAA,MAAM,aAAa,OAAA,EAAS,cAAA;AAC5B,EAAA,IAAI,UAAA,KAAe,QAAW,OAAO,cAAA;AACrC,EAAA,KAAA,MAAW,SAAS,UAAA,EAAY;AAC9B,IAAA,IAAI,CAAC,cAAA,CAAe,QAAA,CAAS,KAAK,CAAA,EAAG;AACnC,MAAA,MAAM,IAAI,kBAAA;AAAA,QACR,CAAA,iCAAA,EAAoC,OAAO,KAAK,CAAC,gBAAgB,cAAA,CAAe,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA,CAAA;AAAA,QAC1F,EAAE,MAAM,iCAAA;AAAkC,OAC5C;AAAA,IACF;AAAA,EACF;AACA,EAAA,OAAO,UAAA;AACT;AAOA,eAAsB,iBAAA,CACpB,KACA,OAAA,EAC0C;AAC1C,EAAA,MAAM,MAAA,GAAS,eAAe,OAAO,CAAA;AACrC,EAAA,OAAO,cAAc,GAAA,EAAK,MAAA,CAAO,QAAA,CAAS,SAAS,GAAG,MAAS,CAAA;AACjE;AAQA,eAAsB,sBAAA,CACpB,IAAA,EACA,GAAA,EACA,OAAA,EACsC;AACtC,EAAA,OAAA,CAAQ,MAAM,iBAAA,CAAkB,GAAA,EAAK,OAAO,GAAG,IAAI,CAAA;AACrD","file":"subagents-loader.js","sourcesContent":["/**\n * M81 — `.theokit/agents` discovery, exposed so a consumer can read the on-disk subagent\n * definitions with one import instead of hand-rolling a second parser.\n *\n * ## Why this file exists\n *\n * `src/skills.ts` already exposed `discoverSkills` for the sibling domain. Subagents had the same\n * loader — `internal/runtime/skills/subagents-loader.ts` — with no public door. A consumer behind\n * the layer boundary (the agent-builder never imports `@theokit/sdk*` directly) could not reach it,\n * so re-implementing was the only legal option. It re-implemented, and then wrote a test whose only\n * job was to watch the two parsers for drift. That test is the cleanest possible evidence that the\n * duplication should not exist.\n *\n * ## What crosses is the PARSED config\n *\n * The return is `AgentDefinition` — already interpreted — never the `.md` text or the frontmatter\n * shape. Exporting the file format would freeze an internal detail as public API; exporting the\n * parsed value leaves the format free to change.\n */\n\nimport { ConfigurationError } from \"./errors.js\";\nimport { loadSubagents } from \"./internal/runtime/skills/subagents-loader.js\";\nimport type { AgentDefinition } from \"./types/agent.js\";\n\n/**\n * The parsed subagent definition this module hands back.\n *\n * Re-exported here — beside the loader that produces it — so a consumer can NAME the value it\n * receives without reaching into `types/agent`, which no subpath publishes. A layer above may then\n * alias it (`AgentDefinition as SubagentDefinition`) to sidestep a name it has already spent.\n */\nexport type { AgentDefinition } from \"./types/agent.js\";\n\n/**\n * Where subagent definitions may be read from. A closed union rather than a boolean: a third\n * source can join it without breaking the signature, and the call site reads as what it means.\n */\nexport type SubagentSource = \"project\";\n\nconst FONTES_ACEITAS: readonly SubagentSource[] = [\"project\"];\n\n/** Options for {@link discoverSubagents} / {@link loadSubagentDefinition}. */\nexport interface DiscoverSubagentsOptions {\n  /**\n   * Which sources to read. Defaults to `[\"project\"]` — `<cwd>/.theokit/agents/*.md`.\n   *\n   * An empty list reads NOTHING: the directory is never opened, so a caller that has not yet\n   * established trust in `cwd` can decline the read rather than filter its result.\n   */\n  readonly settingSources?: readonly SubagentSource[];\n}\n\n// Validated at the boundary (error-handling.md § 2): the union is erased at runtime, so a JS\n// caller — or a value crossing a serialization hop — can still carry a source nobody honors.\n// Dropping it silently would read as \"no subagents found\", which is the same shape as success.\nfunction resolverFontes(options: DiscoverSubagentsOptions | undefined): readonly SubagentSource[] {\n  const declaradas = options?.settingSources;\n  if (declaradas === undefined) return FONTES_ACEITAS;\n  for (const fonte of declaradas) {\n    if (!FONTES_ACEITAS.includes(fonte)) {\n      throw new ConfigurationError(\n        `Unknown subagent setting source \"${String(fonte)}\" (accepted: ${FONTES_ACEITAS.join(\", \")})`,\n        { code: \"subagent_unknown_setting_source\" },\n      );\n    }\n  }\n  return declaradas;\n}\n\n/**\n * Discover the subagents defined under `<cwd>/.theokit/agents/*.md`.\n *\n * An absent directory yields `{}` — a project without subagents is the common case, not an error.\n */\nexport async function discoverSubagents(\n  cwd: string,\n  options?: DiscoverSubagentsOptions,\n): Promise<Record<string, AgentDefinition>> {\n  const fontes = resolverFontes(options);\n  return loadSubagents(cwd, fontes.includes(\"project\"), undefined);\n}\n\n/**\n * Load ONE subagent definition by name, or `undefined` when it is not defined on disk.\n *\n * A thin selector over {@link discoverSubagents} rather than a second reader: one parser is the\n * whole point of this module.\n */\nexport async function loadSubagentDefinition(\n  name: string,\n  cwd: string,\n  options?: DiscoverSubagentsOptions,\n): Promise<AgentDefinition | undefined> {\n  return (await discoverSubagents(cwd, options))[name];\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "4.34.2",
+  "version": "4.36.0",
   "description": "TypeScript SDK for the Theo agent harness — same surface, local or cloud.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/usetheodev/theokit-sdk#readme",
@@ -329,17 +329,6 @@
     "**/agent.js",
     "**/agent.cjs"
   ],
-  "scripts": {
-    "build": "tsup && cp src/internal/providers/provider-catalog.json dist/provider-catalog.json && node scripts/copy-docs.mjs",
-    "test": "vitest run --no-file-parallelism",
-    "test:watch": "vitest",
-    "eval": "vitest run --no-file-parallelism tests/eval/suites",
-    "test:contract": "vitest run --no-file-parallelism tests/theokit-consumer-contract.test.ts",
-    "prepublishOnly": "pnpm build && pnpm test:contract",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "docs:json": "typedoc --options typedoc.json"
-  },
   "peerDependencies": {
     "@lancedb/lancedb": "^0.30.0",
     "@types/ws": ">=8.0.0",
@@ -407,5 +396,15 @@
     "typedoc": "^0.28.19",
     "ws": "^8.18.0",
     "zod": "^4.0.0"
+  },
+  "scripts": {
+    "build": "tsup && cp src/internal/providers/provider-catalog.json dist/provider-catalog.json && node scripts/copy-docs.mjs",
+    "test": "vitest run --no-file-parallelism",
+    "test:watch": "vitest",
+    "eval": "vitest run --no-file-parallelism tests/eval/suites",
+    "test:contract": "vitest run --no-file-parallelism tests/theokit-consumer-contract.test.ts",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "docs:json": "typedoc --options typedoc.json"
   }
-}
+}