@theokit/sdk 4.35.0 → 4.37.0

package/dist/skills.cjs

@@ -1,20 +1,20 @@
 'use strict';
 
-var chunkDHLZIMP6_cjs = require('./chunk-DHLZIMP6.cjs');
-require('./chunk-KIO7QFIV.cjs');
-require('./chunk-LALRCFSN.cjs');
-require('./chunk-A44COQJJ.cjs');
-require('./chunk-BEURCLDV.cjs');
+var chunkQUFSDDNU_cjs = require('./chunk-QUFSDDNU.cjs');
+require('./chunk-YBFDBOUN.cjs');
+require('./chunk-7DXLNNKH.cjs');
+require('./chunk-MHCKWQR3.cjs');
+require('./chunk-LTCOPATU.cjs');
 
 
 
 Object.defineProperty(exports, "buildSkillsBlock", {
   enumerable: true,
-  get: function () { return chunkDHLZIMP6_cjs.buildSkillsBlock; }
+  get: function () { return chunkQUFSDDNU_cjs.buildSkillsBlock; }
 });
 Object.defineProperty(exports, "discoverSkills", {
   enumerable: true,
-  get: function () { return chunkDHLZIMP6_cjs.discoverSkills; }
+  get: function () { return chunkQUFSDDNU_cjs.discoverSkills; }
 });
 //# sourceMappingURL=skills.cjs.map
 //# sourceMappingURL=skills.cjs.map

package/dist/skills.js

@@ -1,7 +1,7 @@
-export { buildSkillsBlock, discoverSkills } from './chunk-5IB2UKSN.js';
-import './chunk-POQT2OIF.js';
-import './chunk-FKCC2MED.js';
-import './chunk-WLKFWQSJ.js';
-import './chunk-JTFYYKDT.js';
+export { buildSkillsBlock, discoverSkills } from './chunk-2WFB5ZOX.js';
+import './chunk-WDGCZDRG.js';
+import './chunk-UQPDFW4E.js';
+import './chunk-CD73YHEH.js';
+import './chunk-TAPQWDW2.js';
 //# sourceMappingURL=skills.js.map
 //# sourceMappingURL=skills.js.map

package/dist/stream-object-OFM66VUT.js

@@ -0,0 +1,7 @@
+export { StreamObjectError, streamObjectImpl } from './chunk-QFMXXUUT.js';
+import './chunk-ZJN6NTHE.js';
+import './chunk-4VPXM6UU.js';
+import './chunk-CD73YHEH.js';
+import './chunk-TAPQWDW2.js';
+//# sourceMappingURL=stream-object-OFM66VUT.js.map
+//# sourceMappingURL=stream-object-OFM66VUT.js.map

package/dist/{stream-object-WUQSSRY2.js.map → stream-object-OFM66VUT.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"stream-object-WUQSSRY2.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"stream-object-OFM66VUT.js"}

package/dist/stream-object-Y7YCX3BI.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+var chunkNQ4AC2U4_cjs = require('./chunk-NQ4AC2U4.cjs');
+require('./chunk-3ILFUXNE.cjs');
+require('./chunk-WJVHMTKB.cjs');
+require('./chunk-MHCKWQR3.cjs');
+require('./chunk-LTCOPATU.cjs');
+
+
+
+Object.defineProperty(exports, "StreamObjectError", {
+  enumerable: true,
+  get: function () { return chunkNQ4AC2U4_cjs.StreamObjectError; }
+});
+Object.defineProperty(exports, "streamObjectImpl", {
+  enumerable: true,
+  get: function () { return chunkNQ4AC2U4_cjs.streamObjectImpl; }
+});
+//# sourceMappingURL=stream-object-Y7YCX3BI.cjs.map
+//# sourceMappingURL=stream-object-Y7YCX3BI.cjs.map

package/dist/{stream-object-QEQJJDTI.cjs.map → stream-object-Y7YCX3BI.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"stream-object-QEQJJDTI.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"stream-object-Y7YCX3BI.cjs"}

package/dist/subagents-loader.cjs

@@ -1,16 +1,31 @@
 'use strict';
 
-var chunkRZQ6E5YZ_cjs = require('./chunk-RZQ6E5YZ.cjs');
-require('./chunk-LALRCFSN.cjs');
-require('./chunk-A44COQJJ.cjs');
-require('./chunk-BEURCLDV.cjs');
+var chunkGM7QDQ24_cjs = require('./chunk-GM7QDQ24.cjs');
+require('./chunk-7DXLNNKH.cjs');
+var chunkMHCKWQR3_cjs = require('./chunk-MHCKWQR3.cjs');
+require('./chunk-LTCOPATU.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 chunkMHCKWQR3_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 chunkGM7QDQ24_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 './chunk-JTFYYKDT.js';
+import { loadSubagents } from './chunk-YCXMSDSP.js';
+import './chunk-UQPDFW4E.js';
+import { ConfigurationError } from './chunk-CD73YHEH.js';
+import './chunk-TAPQWDW2.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/dist/subscription/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkA44COQJJ_cjs = require('../chunk-A44COQJJ.cjs');
-require('../chunk-BEURCLDV.cjs');
+var chunkMHCKWQR3_cjs = require('../chunk-MHCKWQR3.cjs');
+require('../chunk-LTCOPATU.cjs');
 
 // src/subscription/define-subscription.ts
 function defineSubscription(opts) {
@@ -138,7 +138,7 @@ function tracked(id, payload) {
   }
   return [id, payload];
 }
-var SubscriptionError = class extends chunkA44COQJJ_cjs.TheokitAgentError {
+var SubscriptionError = class extends chunkMHCKWQR3_cjs.TheokitAgentError {
   name = "SubscriptionError";
   constructor(message, options = {}) {
     super(message, { ...options, isRetryable: false });

package/dist/subscription/index.js

@@ -1,5 +1,5 @@
-import { TheokitAgentError } from '../chunk-WLKFWQSJ.js';
-import '../chunk-JTFYYKDT.js';
+import { TheokitAgentError } from '../chunk-CD73YHEH.js';
+import '../chunk-TAPQWDW2.js';
 
 // src/subscription/define-subscription.ts
 function defineSubscription(opts) {

package/dist/task-store.cjs

@@ -1,23 +1,23 @@
 'use strict';
 
-var chunkANIZEWTU_cjs = require('./chunk-ANIZEWTU.cjs');
-require('./chunk-TIZ4TS5V.cjs');
-require('./chunk-A44COQJJ.cjs');
-require('./chunk-BEURCLDV.cjs');
+var chunkW4QN5CMG_cjs = require('./chunk-W4QN5CMG.cjs');
+require('./chunk-ICYBIC6N.cjs');
+require('./chunk-MHCKWQR3.cjs');
+require('./chunk-LTCOPATU.cjs');
 
 
 
 Object.defineProperty(exports, "InMemoryTaskStore", {
   enumerable: true,
-  get: function () { return chunkANIZEWTU_cjs.InMemoryTaskStore; }
+  get: function () { return chunkW4QN5CMG_cjs.InMemoryTaskStore; }
 });
 Object.defineProperty(exports, "JsonFileTaskStore", {
   enumerable: true,
-  get: function () { return chunkANIZEWTU_cjs.JsonFileTaskStore; }
+  get: function () { return chunkW4QN5CMG_cjs.JsonFileTaskStore; }
 });
 Object.defineProperty(exports, "getTaskStoreFor", {
   enumerable: true,
-  get: function () { return chunkANIZEWTU_cjs.getTaskStoreFor; }
+  get: function () { return chunkW4QN5CMG_cjs.getTaskStoreFor; }
 });
 //# sourceMappingURL=task-store.cjs.map
 //# sourceMappingURL=task-store.cjs.map

package/dist/task-store.js

@@ -1,6 +1,6 @@
-export { InMemoryTaskStore, JsonFileTaskStore, getTaskStoreFor } from './chunk-BXV2QUIC.js';
-import './chunk-S2BBRVQX.js';
-import './chunk-WLKFWQSJ.js';
-import './chunk-JTFYYKDT.js';
+export { InMemoryTaskStore, JsonFileTaskStore, getTaskStoreFor } from './chunk-CSZRJ4RE.js';
+import './chunk-56OXYUZE.js';
+import './chunk-CD73YHEH.js';
+import './chunk-TAPQWDW2.js';
 //# sourceMappingURL=task-store.js.map
 //# sourceMappingURL=task-store.js.map

package/dist/workflow.cjs

@@ -1,99 +1,99 @@
 'use strict';
 
-var chunkZ2OC3UIW_cjs = require('./chunk-Z2OC3UIW.cjs');
-var chunkBWT67BI4_cjs = require('./chunk-BWT67BI4.cjs');
+var chunkBJMKQOY2_cjs = require('./chunk-BJMKQOY2.cjs');
+var chunkXAYVHS2B_cjs = require('./chunk-XAYVHS2B.cjs');
 require('./chunk-PNVDQL5Y.cjs');
 require('./chunk-WJVHMTKB.cjs');
-require('./chunk-TIZ4TS5V.cjs');
-require('./chunk-KIO7QFIV.cjs');
-require('./chunk-A44COQJJ.cjs');
-require('./chunk-BEURCLDV.cjs');
+require('./chunk-ICYBIC6N.cjs');
+require('./chunk-YBFDBOUN.cjs');
+require('./chunk-MHCKWQR3.cjs');
+require('./chunk-LTCOPATU.cjs');
 
 
 
 Object.defineProperty(exports, "Workflow", {
   enumerable: true,
-  get: function () { return chunkZ2OC3UIW_cjs.Workflow; }
+  get: function () { return chunkBJMKQOY2_cjs.Workflow; }
 });
 Object.defineProperty(exports, "WorkflowBuilder", {
   enumerable: true,
-  get: function () { return chunkZ2OC3UIW_cjs.WorkflowBuilder; }
+  get: function () { return chunkBJMKQOY2_cjs.WorkflowBuilder; }
 });
 Object.defineProperty(exports, "WorkflowToolError", {
   enumerable: true,
-  get: function () { return chunkZ2OC3UIW_cjs.WorkflowToolError; }
+  get: function () { return chunkBJMKQOY2_cjs.WorkflowToolError; }
 });
 Object.defineProperty(exports, "agentStep", {
   enumerable: true,
-  get: function () { return chunkZ2OC3UIW_cjs.agentStep; }
+  get: function () { return chunkBJMKQOY2_cjs.agentStep; }
 });
 Object.defineProperty(exports, "cloneWorkflow", {
   enumerable: true,
-  get: function () { return chunkZ2OC3UIW_cjs.cloneWorkflow; }
+  get: function () { return chunkBJMKQOY2_cjs.cloneWorkflow; }
 });
 Object.defineProperty(exports, "fn", {
   enumerable: true,
-  get: function () { return chunkZ2OC3UIW_cjs.fn; }
+  get: function () { return chunkBJMKQOY2_cjs.fn; }
 });
 Object.defineProperty(exports, "workflowAsTool", {
   enumerable: true,
-  get: function () { return chunkZ2OC3UIW_cjs.workflowAsTool; }
+  get: function () { return chunkBJMKQOY2_cjs.workflowAsTool; }
 });
 Object.defineProperty(exports, "workflowStep", {
   enumerable: true,
-  get: function () { return chunkZ2OC3UIW_cjs.workflowStep; }
+  get: function () { return chunkBJMKQOY2_cjs.workflowStep; }
 });
 Object.defineProperty(exports, "WorkflowAlreadyRunningError", {
   enumerable: true,
-  get: function () { return chunkBWT67BI4_cjs.WorkflowAlreadyRunningError; }
+  get: function () { return chunkXAYVHS2B_cjs.WorkflowAlreadyRunningError; }
 });
 Object.defineProperty(exports, "WorkflowCompensateNotImplementedError", {
   enumerable: true,
-  get: function () { return chunkBWT67BI4_cjs.WorkflowCompensateNotImplementedError; }
+  get: function () { return chunkXAYVHS2B_cjs.WorkflowCompensateNotImplementedError; }
 });
 Object.defineProperty(exports, "WorkflowDuplicateStepIdError", {
   enumerable: true,
-  get: function () { return chunkBWT67BI4_cjs.WorkflowDuplicateStepIdError; }
+  get: function () { return chunkXAYVHS2B_cjs.WorkflowDuplicateStepIdError; }
 });
 Object.defineProperty(exports, "WorkflowInputError", {
   enumerable: true,
-  get: function () { return chunkBWT67BI4_cjs.WorkflowInputError; }
+  get: function () { return chunkXAYVHS2B_cjs.WorkflowInputError; }
 });
 Object.defineProperty(exports, "WorkflowMaxIterationsExceededError", {
   enumerable: true,
-  get: function () { return chunkBWT67BI4_cjs.WorkflowMaxIterationsExceededError; }
+  get: function () { return chunkXAYVHS2B_cjs.WorkflowMaxIterationsExceededError; }
 });
 Object.defineProperty(exports, "WorkflowNestedError", {
   enumerable: true,
-  get: function () { return chunkBWT67BI4_cjs.WorkflowNestedError; }
+  get: function () { return chunkXAYVHS2B_cjs.WorkflowNestedError; }
 });
 Object.defineProperty(exports, "WorkflowNotSerializableError", {
   enumerable: true,
-  get: function () { return chunkBWT67BI4_cjs.WorkflowNotSerializableError; }
+  get: function () { return chunkXAYVHS2B_cjs.WorkflowNotSerializableError; }
 });
 Object.defineProperty(exports, "WorkflowOutputError", {
   enumerable: true,
-  get: function () { return chunkBWT67BI4_cjs.WorkflowOutputError; }
+  get: function () { return chunkXAYVHS2B_cjs.WorkflowOutputError; }
 });
 Object.defineProperty(exports, "WorkflowParallelError", {
   enumerable: true,
-  get: function () { return chunkBWT67BI4_cjs.WorkflowParallelError; }
+  get: function () { return chunkXAYVHS2B_cjs.WorkflowParallelError; }
 });
 Object.defineProperty(exports, "WorkflowResumeStepNotFoundError", {
   enumerable: true,
-  get: function () { return chunkBWT67BI4_cjs.WorkflowResumeStepNotFoundError; }
+  get: function () { return chunkXAYVHS2B_cjs.WorkflowResumeStepNotFoundError; }
 });
 Object.defineProperty(exports, "WorkflowSnapshotNotFoundError", {
   enumerable: true,
-  get: function () { return chunkBWT67BI4_cjs.WorkflowSnapshotNotFoundError; }
+  get: function () { return chunkXAYVHS2B_cjs.WorkflowSnapshotNotFoundError; }
 });
 Object.defineProperty(exports, "WorkflowStateError", {
   enumerable: true,
-  get: function () { return chunkBWT67BI4_cjs.WorkflowStateError; }
+  get: function () { return chunkXAYVHS2B_cjs.WorkflowStateError; }
 });
 Object.defineProperty(exports, "__resetSnapshotStoresForTests", {
   enumerable: true,
-  get: function () { return chunkBWT67BI4_cjs.__resetSnapshotStoresForTests; }
+  get: function () { return chunkXAYVHS2B_cjs.__resetSnapshotStoresForTests; }
 });
 //# sourceMappingURL=workflow.cjs.map
 //# sourceMappingURL=workflow.cjs.map

package/dist/workflow.js

@@ -1,10 +1,10 @@
-export { Workflow, WorkflowBuilder, WorkflowToolError, agentStep, cloneWorkflow, fn, workflowAsTool, workflowStep } from './chunk-BFWPZMG7.js';
-export { WorkflowAlreadyRunningError, WorkflowCompensateNotImplementedError, WorkflowDuplicateStepIdError, WorkflowInputError, WorkflowMaxIterationsExceededError, WorkflowNestedError, WorkflowNotSerializableError, WorkflowOutputError, WorkflowParallelError, WorkflowResumeStepNotFoundError, WorkflowSnapshotNotFoundError, WorkflowStateError, __resetSnapshotStoresForTests } from './chunk-UVNG67DG.js';
+export { Workflow, WorkflowBuilder, WorkflowToolError, agentStep, cloneWorkflow, fn, workflowAsTool, workflowStep } from './chunk-SDIBMLL5.js';
+export { WorkflowAlreadyRunningError, WorkflowCompensateNotImplementedError, WorkflowDuplicateStepIdError, WorkflowInputError, WorkflowMaxIterationsExceededError, WorkflowNestedError, WorkflowNotSerializableError, WorkflowOutputError, WorkflowParallelError, WorkflowResumeStepNotFoundError, WorkflowSnapshotNotFoundError, WorkflowStateError, __resetSnapshotStoresForTests } from './chunk-YDLNI7J6.js';
 import './chunk-CAH3G4IS.js';
 import './chunk-4VPXM6UU.js';
-import './chunk-S2BBRVQX.js';
-import './chunk-POQT2OIF.js';
-import './chunk-WLKFWQSJ.js';
-import './chunk-JTFYYKDT.js';
+import './chunk-56OXYUZE.js';
+import './chunk-WDGCZDRG.js';
+import './chunk-CD73YHEH.js';
+import './chunk-TAPQWDW2.js';
 //# sourceMappingURL=workflow.js.map
 //# sourceMappingURL=workflow.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "4.35.0",
+  "version": "4.37.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",

package/dist/agent-H6HL5ITH.js

@@ -1,42 +0,0 @@
-export { Agent } from './chunk-EKFA76N4.js';
-import './chunk-2SFBB54R.js';
-import './chunk-HRA3CPGG.js';
-import './chunk-7BTE3RXJ.js';
-import './chunk-K2BQQ445.js';
-import './chunk-OKXUMCGM.js';
-import './chunk-IX2LKBCD.js';
-import './chunk-6CLRANZA.js';
-import './chunk-EEZ7CFMM.js';
-import './chunk-XAUBQMQU.js';
-import './chunk-XIG2IE3L.js';
-import './chunk-7GFX45DD.js';
-import './chunk-XV2RBL6D.js';
-import './chunk-FD2UT76F.js';
-import './chunk-U54XCYG3.js';
-import './chunk-FV3YEMQ7.js';
-import './chunk-6X6ID4MO.js';
-import './chunk-UJ7IQJAG.js';
-import './chunk-7AD3ZTZL.js';
-import './chunk-V4XRLPEF.js';
-import './chunk-5PZMMF4H.js';
-import './chunk-BOTK6ZUP.js';
-import './chunk-UAYYNWYJ.js';
-import './chunk-77FOZCOT.js';
-import './chunk-2XLKLVVR.js';
-import './chunk-Q56IYTBZ.js';
-import './chunk-BXV2QUIC.js';
-import './chunk-4VPXM6UU.js';
-import './chunk-S2BBRVQX.js';
-import './chunk-BNIFFFH3.js';
-import './chunk-RKG6QFCJ.js';
-import './chunk-X2FR4OIT.js';
-import './chunk-KAP4GJHO.js';
-import './chunk-LU7VALW5.js';
-import './chunk-5NBUH3NO.js';
-import './chunk-5IB2UKSN.js';
-import './chunk-POQT2OIF.js';
-import './chunk-FKCC2MED.js';
-import './chunk-WLKFWQSJ.js';
-import './chunk-JTFYYKDT.js';
-//# sourceMappingURL=agent-H6HL5ITH.js.map
-//# sourceMappingURL=agent-H6HL5ITH.js.map

package/dist/agent-P77NPBF4.cjs

@@ -1,51 +0,0 @@
-'use strict';
-
-var chunk3XJ7CS2C_cjs = require('./chunk-3XJ7CS2C.cjs');
-require('./chunk-BV2MWEMV.cjs');
-require('./chunk-MZ5ZRORA.cjs');
-require('./chunk-G4WI3VW2.cjs');
-require('./chunk-BUUUWQMB.cjs');
-require('./chunk-AIDNODHJ.cjs');
-require('./chunk-WEHUJ7ZS.cjs');
-require('./chunk-LUSXDZPV.cjs');
-require('./chunk-IT3PWBW4.cjs');
-require('./chunk-JLMXKTBX.cjs');
-require('./chunk-N24XBYNX.cjs');
-require('./chunk-WPZTYOUX.cjs');
-require('./chunk-6M6A6WWW.cjs');
-require('./chunk-MUUQ2WFJ.cjs');
-require('./chunk-6JSIEDKL.cjs');
-require('./chunk-G2F67XUR.cjs');
-require('./chunk-NINIJCHU.cjs');
-require('./chunk-YPEPCZHF.cjs');
-require('./chunk-VJ26EKGJ.cjs');
-require('./chunk-GIW4L6HY.cjs');
-require('./chunk-7S7KKUO6.cjs');
-require('./chunk-YRXTIESB.cjs');
-require('./chunk-CJVMDRQB.cjs');
-require('./chunk-JD74LN7R.cjs');
-require('./chunk-YLQQX5W2.cjs');
-require('./chunk-2DYI7MIF.cjs');
-require('./chunk-ANIZEWTU.cjs');
-require('./chunk-WJVHMTKB.cjs');
-require('./chunk-TIZ4TS5V.cjs');
-require('./chunk-RZQ6E5YZ.cjs');
-require('./chunk-M2PU44HP.cjs');
-require('./chunk-VYHJZVL5.cjs');
-require('./chunk-D42XHI4O.cjs');
-require('./chunk-HFPGOTVF.cjs');
-require('./chunk-C6Y6CWYD.cjs');
-require('./chunk-DHLZIMP6.cjs');
-require('./chunk-KIO7QFIV.cjs');
-require('./chunk-LALRCFSN.cjs');
-require('./chunk-A44COQJJ.cjs');
-require('./chunk-BEURCLDV.cjs');
-
-
-
-Object.defineProperty(exports, "Agent", {
-  enumerable: true,
-  get: function () { return chunk3XJ7CS2C_cjs.Agent; }
-});
-//# sourceMappingURL=agent-P77NPBF4.cjs.map
-//# sourceMappingURL=agent-P77NPBF4.cjs.map