@theokit/sdk 4.40.0 → 4.41.0

package/dist/stream-object-3R3HZPQN.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+var chunk57KX5WTP_cjs = require('./chunk-57KX5WTP.cjs');
+require('./chunk-WIGJGFH4.cjs');
+require('./chunk-WJVHMTKB.cjs');
+require('./chunk-YULF6FPB.cjs');
+require('./chunk-ZHPET3LZ.cjs');
+
+
+
+Object.defineProperty(exports, "StreamObjectError", {
+  enumerable: true,
+  get: function () { return chunk57KX5WTP_cjs.StreamObjectError; }
+});
+Object.defineProperty(exports, "streamObjectImpl", {
+  enumerable: true,
+  get: function () { return chunk57KX5WTP_cjs.streamObjectImpl; }
+});
+//# sourceMappingURL=stream-object-3R3HZPQN.cjs.map
+//# sourceMappingURL=stream-object-3R3HZPQN.cjs.map

package/dist/{stream-object-3HEUGMQY.cjs.map → stream-object-3R3HZPQN.cjs.map}

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

package/dist/stream-object-NPJXDZXO.js

@@ -0,0 +1,7 @@
+export { StreamObjectError, streamObjectImpl } from './chunk-3KY7MHR4.js';
+import './chunk-O3IZ7JEL.js';
+import './chunk-4VPXM6UU.js';
+import './chunk-MRKSSN36.js';
+import './chunk-PBML2FHN.js';
+//# sourceMappingURL=stream-object-NPJXDZXO.js.map
+//# sourceMappingURL=stream-object-NPJXDZXO.js.map

package/dist/{stream-object-VWYW7FJ2.js.map → stream-object-NPJXDZXO.js.map}

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

package/dist/subagents-loader-5KQVYUNS.js

@@ -0,0 +1,6 @@
+export { loadSubagents } from './chunk-TJRPNBY5.js';
+import './chunk-OLLOUAUJ.js';
+import './chunk-MRKSSN36.js';
+import './chunk-PBML2FHN.js';
+//# sourceMappingURL=subagents-loader-5KQVYUNS.js.map
+//# sourceMappingURL=subagents-loader-5KQVYUNS.js.map

package/dist/{subagents-loader-QUIK6GMV.js.map → subagents-loader-5KQVYUNS.js.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"subagents-loader-QUIK6GMV.js"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"subagents-loader-5KQVYUNS.js"}

package/dist/subagents-loader-FDXPBBRA.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+var chunkX2YQP452_cjs = require('./chunk-X2YQP452.cjs');
+require('./chunk-BRHRQOJA.cjs');
+require('./chunk-YULF6FPB.cjs');
+require('./chunk-ZHPET3LZ.cjs');
+
+
+
+Object.defineProperty(exports, "loadSubagents", {
+  enumerable: true,
+  get: function () { return chunkX2YQP452_cjs.loadSubagents; }
+});
+//# sourceMappingURL=subagents-loader-FDXPBBRA.cjs.map
+//# sourceMappingURL=subagents-loader-FDXPBBRA.cjs.map

package/dist/{subagents-loader-F52ARQ62.cjs.map → subagents-loader-FDXPBBRA.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"subagents-loader-F52ARQ62.cjs"}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"subagents-loader-FDXPBBRA.cjs"}

package/dist/subagents-loader.cjs

@@ -1,28 +1,28 @@
 'use strict';
 
-var chunkLOTWA65Z_cjs = require('./chunk-LOTWA65Z.cjs');
-require('./chunk-LY4KEOOY.cjs');
-var chunkE7WWIX34_cjs = require('./chunk-E7WWIX34.cjs');
-require('./chunk-A76OFN2B.cjs');
+var chunkX2YQP452_cjs = require('./chunk-X2YQP452.cjs');
+require('./chunk-BRHRQOJA.cjs');
+var chunkYULF6FPB_cjs = require('./chunk-YULF6FPB.cjs');
+require('./chunk-ZHPET3LZ.cjs');
 
 // src/subagents-loader.ts
-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 chunkE7WWIX34_cjs.ConfigurationError(
-        `Unknown subagent setting source "${String(fonte)}" (accepted: ${FONTES_ACEITAS.join(", ")})`,
+var ACCEPTED_SOURCES = ["project"];
+function resolveSources(options) {
+  const declared = options?.settingSources;
+  if (declared === void 0) return ACCEPTED_SOURCES;
+  for (const source of declared) {
+    if (!ACCEPTED_SOURCES.includes(source)) {
+      throw new chunkYULF6FPB_cjs.ConfigurationError(
+        `Unknown subagent setting source "${String(source)}" (accepted: ${ACCEPTED_SOURCES.join(", ")})`,
         { code: "subagent_unknown_setting_source" }
       );
     }
   }
-  return declaradas;
+  return declared;
 }
 async function discoverSubagents(cwd, options) {
-  const fontes = resolverFontes(options);
-  return chunkLOTWA65Z_cjs.loadSubagents(cwd, fontes.includes("project"), void 0);
+  const sources = resolveSources(options);
+  return chunkX2YQP452_cjs.loadSubagents(cwd, sources.includes("project"), void 0);
 }
 async function loadSubagentDefinition(name, cwd, options) {
   return (await discoverSubagents(cwd, options))[name];

package/dist/subagents-loader.cjs.map

@@ -1 +1 @@
-{"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"]}
+{"version":3,"sources":["../src/subagents-loader.ts"],"names":["ConfigurationError","loadSubagents"],"mappings":";;;;;;;;AAuCA,IAAM,gBAAA,GAA8C,CAAC,SAAS,CAAA;AAgB9D,SAAS,eAAe,OAAA,EAA0E;AAChG,EAAA,MAAM,WAAW,OAAA,EAAS,cAAA;AAC1B,EAAA,IAAI,QAAA,KAAa,QAAW,OAAO,gBAAA;AACnC,EAAA,KAAA,MAAW,UAAU,QAAA,EAAU;AAC7B,IAAA,IAAI,CAAC,gBAAA,CAAiB,QAAA,CAAS,MAAM,CAAA,EAAG;AACtC,MAAA,MAAM,IAAIA,oCAAA;AAAA,QACR,CAAA,iCAAA,EAAoC,OAAO,MAAM,CAAC,gBAAgB,gBAAA,CAAiB,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA,CAAA;AAAA,QAC7F,EAAE,MAAM,iCAAA;AAAkC,OAC5C;AAAA,IACF;AAAA,EACF;AACA,EAAA,OAAO,QAAA;AACT;AAOA,eAAsB,iBAAA,CACpB,KACA,OAAA,EAC0C;AAC1C,EAAA,MAAM,OAAA,GAAU,eAAe,OAAO,CAAA;AACtC,EAAA,OAAOC,gCAAc,GAAA,EAAK,OAAA,CAAQ,QAAA,CAAS,SAAS,GAAG,MAAS,CAAA;AAClE;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 ACCEPTED_SOURCES: 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 resolveSources(options: DiscoverSubagentsOptions | undefined): readonly SubagentSource[] {\n  const declared = options?.settingSources;\n  if (declared === undefined) return ACCEPTED_SOURCES;\n  for (const source of declared) {\n    if (!ACCEPTED_SOURCES.includes(source)) {\n      throw new ConfigurationError(\n        `Unknown subagent setting source \"${String(source)}\" (accepted: ${ACCEPTED_SOURCES.join(\", \")})`,\n        { code: \"subagent_unknown_setting_source\" },\n      );\n    }\n  }\n  return declared;\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 sources = resolveSources(options);\n  return loadSubagents(cwd, sources.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

@@ -1,5 +1,5 @@
-import { a as AgentDefinition } from './agent-DxEL4fHh.cjs';
-import './run-XXnwwGOT.cjs';
+import { a as AgentDefinition } from './agent-Zta1kvGH.cjs';
+import './run-C8FBAC8o.cjs';
 import 'zod';
 
 /**

package/dist/subagents-loader.d.ts

@@ -1,5 +1,5 @@
-import { a as AgentDefinition } from './agent-BzZwYFiw.js';
-import './run-XXnwwGOT.js';
+import { a as AgentDefinition } from './agent-BiCINq25.js';
+import './run-C8FBAC8o.js';
 import 'zod';
 
 /**

package/dist/subagents-loader.js

@@ -1,26 +1,26 @@
-import { loadSubagents } from './chunk-BBMN4O6E.js';
-import './chunk-4GGXF7YM.js';
-import { ConfigurationError } from './chunk-VQ33XLC6.js';
-import './chunk-RNCN2TTP.js';
+import { loadSubagents } from './chunk-TJRPNBY5.js';
+import './chunk-OLLOUAUJ.js';
+import { ConfigurationError } from './chunk-MRKSSN36.js';
+import './chunk-PBML2FHN.js';
 
 // src/subagents-loader.ts
-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)) {
+var ACCEPTED_SOURCES = ["project"];
+function resolveSources(options) {
+  const declared = options?.settingSources;
+  if (declared === void 0) return ACCEPTED_SOURCES;
+  for (const source of declared) {
+    if (!ACCEPTED_SOURCES.includes(source)) {
       throw new ConfigurationError(
-        `Unknown subagent setting source "${String(fonte)}" (accepted: ${FONTES_ACEITAS.join(", ")})`,
+        `Unknown subagent setting source "${String(source)}" (accepted: ${ACCEPTED_SOURCES.join(", ")})`,
         { code: "subagent_unknown_setting_source" }
       );
     }
   }
-  return declaradas;
+  return declared;
 }
 async function discoverSubagents(cwd, options) {
-  const fontes = resolverFontes(options);
-  return loadSubagents(cwd, fontes.includes("project"), void 0);
+  const sources = resolveSources(options);
+  return loadSubagents(cwd, sources.includes("project"), void 0);
 }
 async function loadSubagentDefinition(name, cwd, options) {
   return (await discoverSubagents(cwd, options))[name];

package/dist/subagents-loader.js.map

@@ -1 +1 @@
-{"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"]}
+{"version":3,"sources":["../src/subagents-loader.ts"],"names":[],"mappings":";;;;;;AAuCA,IAAM,gBAAA,GAA8C,CAAC,SAAS,CAAA;AAgB9D,SAAS,eAAe,OAAA,EAA0E;AAChG,EAAA,MAAM,WAAW,OAAA,EAAS,cAAA;AAC1B,EAAA,IAAI,QAAA,KAAa,QAAW,OAAO,gBAAA;AACnC,EAAA,KAAA,MAAW,UAAU,QAAA,EAAU;AAC7B,IAAA,IAAI,CAAC,gBAAA,CAAiB,QAAA,CAAS,MAAM,CAAA,EAAG;AACtC,MAAA,MAAM,IAAI,kBAAA;AAAA,QACR,CAAA,iCAAA,EAAoC,OAAO,MAAM,CAAC,gBAAgB,gBAAA,CAAiB,IAAA,CAAK,IAAI,CAAC,CAAA,CAAA,CAAA;AAAA,QAC7F,EAAE,MAAM,iCAAA;AAAkC,OAC5C;AAAA,IACF;AAAA,EACF;AACA,EAAA,OAAO,QAAA;AACT;AAOA,eAAsB,iBAAA,CACpB,KACA,OAAA,EAC0C;AAC1C,EAAA,MAAM,OAAA,GAAU,eAAe,OAAO,CAAA;AACtC,EAAA,OAAO,cAAc,GAAA,EAAK,OAAA,CAAQ,QAAA,CAAS,SAAS,GAAG,MAAS,CAAA;AAClE;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 ACCEPTED_SOURCES: 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 resolveSources(options: DiscoverSubagentsOptions | undefined): readonly SubagentSource[] {\n  const declared = options?.settingSources;\n  if (declared === undefined) return ACCEPTED_SOURCES;\n  for (const source of declared) {\n    if (!ACCEPTED_SOURCES.includes(source)) {\n      throw new ConfigurationError(\n        `Unknown subagent setting source \"${String(source)}\" (accepted: ${ACCEPTED_SOURCES.join(\", \")})`,\n        { code: \"subagent_unknown_setting_source\" },\n      );\n    }\n  }\n  return declared;\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 sources = resolveSources(options);\n  return loadSubagents(cwd, sources.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 chunkE7WWIX34_cjs = require('../chunk-E7WWIX34.cjs');
-require('../chunk-A76OFN2B.cjs');
+var chunkYULF6FPB_cjs = require('../chunk-YULF6FPB.cjs');
+require('../chunk-ZHPET3LZ.cjs');
 
 // src/subscription/define-subscription.ts
 function defineSubscription(opts) {
@@ -138,7 +138,7 @@ function tracked(id, payload) {
   }
   return [id, payload];
 }
-var SubscriptionError = class extends chunkE7WWIX34_cjs.TheokitAgentError {
+var SubscriptionError = class extends chunkYULF6FPB_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-VQ33XLC6.js';
-import '../chunk-RNCN2TTP.js';
+import { TheokitAgentError } from '../chunk-MRKSSN36.js';
+import '../chunk-PBML2FHN.js';
 
 // src/subscription/define-subscription.ts
 function defineSubscription(opts) {

package/dist/task-store.cjs

@@ -1,23 +1,23 @@
 'use strict';
 
-var chunkH2V6CXM7_cjs = require('./chunk-H2V6CXM7.cjs');
-require('./chunk-33B2BSME.cjs');
-require('./chunk-E7WWIX34.cjs');
-require('./chunk-A76OFN2B.cjs');
+var chunkXR4LPBXH_cjs = require('./chunk-XR4LPBXH.cjs');
+require('./chunk-NETYW4V3.cjs');
+require('./chunk-YULF6FPB.cjs');
+require('./chunk-ZHPET3LZ.cjs');
 
 
 
 Object.defineProperty(exports, "InMemoryTaskStore", {
   enumerable: true,
-  get: function () { return chunkH2V6CXM7_cjs.InMemoryTaskStore; }
+  get: function () { return chunkXR4LPBXH_cjs.InMemoryTaskStore; }
 });
 Object.defineProperty(exports, "JsonFileTaskStore", {
   enumerable: true,
-  get: function () { return chunkH2V6CXM7_cjs.JsonFileTaskStore; }
+  get: function () { return chunkXR4LPBXH_cjs.JsonFileTaskStore; }
 });
 Object.defineProperty(exports, "getTaskStoreFor", {
   enumerable: true,
-  get: function () { return chunkH2V6CXM7_cjs.getTaskStoreFor; }
+  get: function () { return chunkXR4LPBXH_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-BM7VYZED.js';
-import './chunk-5XPKYDK7.js';
-import './chunk-VQ33XLC6.js';
-import './chunk-RNCN2TTP.js';
+export { InMemoryTaskStore, JsonFileTaskStore, getTaskStoreFor } from './chunk-NOM2YWFP.js';
+import './chunk-VQFSEKU5.js';
+import './chunk-MRKSSN36.js';
+import './chunk-PBML2FHN.js';
 //# sourceMappingURL=task-store.js.map
 //# sourceMappingURL=task-store.js.map

package/dist/types/run-events.d.ts

@@ -16,7 +16,26 @@
  *
  * @public
  */
-export type RunEvent = RunToolProgressEvent | RunRateLimitEvent | RunPermissionDeniedEvent | RunTaskStartedEvent | RunTaskUpdatedEvent | RunTaskCompletedEvent | RunCompactBoundaryEvent | RunCompactionFallbackEvent | RunTripwireEvent | RunCompletionCheckEvent;
+export type RunEvent = RunToolProgressEvent | RunRateLimitEvent | RunPermissionDeniedEvent | RunTaskStartedEvent | RunTaskUpdatedEvent | RunTaskCompletedEvent | RunCompactBoundaryEvent | RunCompactionFallbackEvent | RunTripwireEvent | RunCompletionCheckEvent | RunMcpServerFailedEvent;
+/**
+ * theokit#188 — an MCP server was configured but its tools could not be listed, so NONE of its
+ * tools exist for this run.
+ *
+ * The failure was always caught (`safeListTools` returns `[]` so one broken server cannot take the
+ * turn down) and always DIAGNOSED — to `diag()`, i.e. the SDK's stderr. Nothing reached the
+ * consumer, so a UI listing configured servers could show one as present while every tool it
+ * provides had silently vanished. Degrading gracefully is right; degrading INVISIBLY is not.
+ *
+ * Emitted once per failing server per run, on the same catch path that already had both the name
+ * and the reason.
+ */
+export interface RunMcpServerFailedEvent {
+    readonly type: "mcp_server_failed";
+    /** The server as named in the MCP configuration, so the consumer can match it to what it lists. */
+    readonly serverName: string;
+    /** Why listing failed — a spawn error, a handshake timeout, a protocol error. */
+    readonly message: string;
+}
 /**
  * SE24 — a guardrail processor called `abort()`; the run stops with a tripwire.
  * Delivered via {@link SendOptions.onRunEvent} (mirrors the `RunResult.tripwire`

package/dist/types/session-record.d.ts

@@ -33,7 +33,7 @@ export type TranscriptBlock = {
     is_error?: boolean;
 };
 /**
- * O corpo de mensagem de um {@link SessionRecord}.
+ * The message body of a {@link SessionRecord}.
  *
  * **It is NOT called `SessionMessage`** — that name already exists in
  * `internal/session/session-types.ts` with the shape `{role, text}`, incompatible with this one.

package/dist/types/usage.d.ts

@@ -40,7 +40,7 @@ export type CostStatus = "actual" | "estimated" | "included" | "unknown";
 export type CostSource = "openrouter_api" | "litellm_snapshot" | "user_override" | "subscription_included" | "unknown";
 /**
  * Cost breakdown attached to `RunResult.cost`. When `status === "unknown"`,
- * `amountUsd` is `undefined` — DO NOT default to 0 (mentira). UI exibe
+ * `amountUsd` is `undefined` — DO NOT default to 0 (a lie). The UI shows
  * `n/a` para unknown, `~$1.23` para estimated, `$1.23` para actual.
  */
 export interface CostBreakdown {

package/dist/workflow.cjs

@@ -1,99 +1,99 @@
 'use strict';
 
-var chunkEJNFZET4_cjs = require('./chunk-EJNFZET4.cjs');
-var chunk5COPO3H4_cjs = require('./chunk-5COPO3H4.cjs');
+var chunkJO76RWCA_cjs = require('./chunk-JO76RWCA.cjs');
+var chunkRBQYHEZD_cjs = require('./chunk-RBQYHEZD.cjs');
 require('./chunk-PNVDQL5Y.cjs');
 require('./chunk-WJVHMTKB.cjs');
-require('./chunk-33B2BSME.cjs');
-require('./chunk-ZAKTZ5B4.cjs');
-require('./chunk-E7WWIX34.cjs');
-require('./chunk-A76OFN2B.cjs');
+require('./chunk-NETYW4V3.cjs');
+require('./chunk-XA3TSBAH.cjs');
+require('./chunk-YULF6FPB.cjs');
+require('./chunk-ZHPET3LZ.cjs');
 
 
 
 Object.defineProperty(exports, "Workflow", {
   enumerable: true,
-  get: function () { return chunkEJNFZET4_cjs.Workflow; }
+  get: function () { return chunkJO76RWCA_cjs.Workflow; }
 });
 Object.defineProperty(exports, "WorkflowBuilder", {
   enumerable: true,
-  get: function () { return chunkEJNFZET4_cjs.WorkflowBuilder; }
+  get: function () { return chunkJO76RWCA_cjs.WorkflowBuilder; }
 });
 Object.defineProperty(exports, "WorkflowToolError", {
   enumerable: true,
-  get: function () { return chunkEJNFZET4_cjs.WorkflowToolError; }
+  get: function () { return chunkJO76RWCA_cjs.WorkflowToolError; }
 });
 Object.defineProperty(exports, "agentStep", {
   enumerable: true,
-  get: function () { return chunkEJNFZET4_cjs.agentStep; }
+  get: function () { return chunkJO76RWCA_cjs.agentStep; }
 });
 Object.defineProperty(exports, "cloneWorkflow", {
   enumerable: true,
-  get: function () { return chunkEJNFZET4_cjs.cloneWorkflow; }
+  get: function () { return chunkJO76RWCA_cjs.cloneWorkflow; }
 });
 Object.defineProperty(exports, "fn", {
   enumerable: true,
-  get: function () { return chunkEJNFZET4_cjs.fn; }
+  get: function () { return chunkJO76RWCA_cjs.fn; }
 });
 Object.defineProperty(exports, "workflowAsTool", {
   enumerable: true,
-  get: function () { return chunkEJNFZET4_cjs.workflowAsTool; }
+  get: function () { return chunkJO76RWCA_cjs.workflowAsTool; }
 });
 Object.defineProperty(exports, "workflowStep", {
   enumerable: true,
-  get: function () { return chunkEJNFZET4_cjs.workflowStep; }
+  get: function () { return chunkJO76RWCA_cjs.workflowStep; }
 });
 Object.defineProperty(exports, "WorkflowAlreadyRunningError", {
   enumerable: true,
-  get: function () { return chunk5COPO3H4_cjs.WorkflowAlreadyRunningError; }
+  get: function () { return chunkRBQYHEZD_cjs.WorkflowAlreadyRunningError; }
 });
 Object.defineProperty(exports, "WorkflowCompensateNotImplementedError", {
   enumerable: true,
-  get: function () { return chunk5COPO3H4_cjs.WorkflowCompensateNotImplementedError; }
+  get: function () { return chunkRBQYHEZD_cjs.WorkflowCompensateNotImplementedError; }
 });
 Object.defineProperty(exports, "WorkflowDuplicateStepIdError", {
   enumerable: true,
-  get: function () { return chunk5COPO3H4_cjs.WorkflowDuplicateStepIdError; }
+  get: function () { return chunkRBQYHEZD_cjs.WorkflowDuplicateStepIdError; }
 });
 Object.defineProperty(exports, "WorkflowInputError", {
   enumerable: true,
-  get: function () { return chunk5COPO3H4_cjs.WorkflowInputError; }
+  get: function () { return chunkRBQYHEZD_cjs.WorkflowInputError; }
 });
 Object.defineProperty(exports, "WorkflowMaxIterationsExceededError", {
   enumerable: true,
-  get: function () { return chunk5COPO3H4_cjs.WorkflowMaxIterationsExceededError; }
+  get: function () { return chunkRBQYHEZD_cjs.WorkflowMaxIterationsExceededError; }
 });
 Object.defineProperty(exports, "WorkflowNestedError", {
   enumerable: true,
-  get: function () { return chunk5COPO3H4_cjs.WorkflowNestedError; }
+  get: function () { return chunkRBQYHEZD_cjs.WorkflowNestedError; }
 });
 Object.defineProperty(exports, "WorkflowNotSerializableError", {
   enumerable: true,
-  get: function () { return chunk5COPO3H4_cjs.WorkflowNotSerializableError; }
+  get: function () { return chunkRBQYHEZD_cjs.WorkflowNotSerializableError; }
 });
 Object.defineProperty(exports, "WorkflowOutputError", {
   enumerable: true,
-  get: function () { return chunk5COPO3H4_cjs.WorkflowOutputError; }
+  get: function () { return chunkRBQYHEZD_cjs.WorkflowOutputError; }
 });
 Object.defineProperty(exports, "WorkflowParallelError", {
   enumerable: true,
-  get: function () { return chunk5COPO3H4_cjs.WorkflowParallelError; }
+  get: function () { return chunkRBQYHEZD_cjs.WorkflowParallelError; }
 });
 Object.defineProperty(exports, "WorkflowResumeStepNotFoundError", {
   enumerable: true,
-  get: function () { return chunk5COPO3H4_cjs.WorkflowResumeStepNotFoundError; }
+  get: function () { return chunkRBQYHEZD_cjs.WorkflowResumeStepNotFoundError; }
 });
 Object.defineProperty(exports, "WorkflowSnapshotNotFoundError", {
   enumerable: true,
-  get: function () { return chunk5COPO3H4_cjs.WorkflowSnapshotNotFoundError; }
+  get: function () { return chunkRBQYHEZD_cjs.WorkflowSnapshotNotFoundError; }
 });
 Object.defineProperty(exports, "WorkflowStateError", {
   enumerable: true,
-  get: function () { return chunk5COPO3H4_cjs.WorkflowStateError; }
+  get: function () { return chunkRBQYHEZD_cjs.WorkflowStateError; }
 });
 Object.defineProperty(exports, "__resetSnapshotStoresForTests", {
   enumerable: true,
-  get: function () { return chunk5COPO3H4_cjs.__resetSnapshotStoresForTests; }
+  get: function () { return chunkRBQYHEZD_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-WJOLIPEM.js';
-export { WorkflowAlreadyRunningError, WorkflowCompensateNotImplementedError, WorkflowDuplicateStepIdError, WorkflowInputError, WorkflowMaxIterationsExceededError, WorkflowNestedError, WorkflowNotSerializableError, WorkflowOutputError, WorkflowParallelError, WorkflowResumeStepNotFoundError, WorkflowSnapshotNotFoundError, WorkflowStateError, __resetSnapshotStoresForTests } from './chunk-NHXPQN44.js';
+export { Workflow, WorkflowBuilder, WorkflowToolError, agentStep, cloneWorkflow, fn, workflowAsTool, workflowStep } from './chunk-EON4YTR6.js';
+export { WorkflowAlreadyRunningError, WorkflowCompensateNotImplementedError, WorkflowDuplicateStepIdError, WorkflowInputError, WorkflowMaxIterationsExceededError, WorkflowNestedError, WorkflowNotSerializableError, WorkflowOutputError, WorkflowParallelError, WorkflowResumeStepNotFoundError, WorkflowSnapshotNotFoundError, WorkflowStateError, __resetSnapshotStoresForTests } from './chunk-HK4HRLWE.js';
 import './chunk-CAH3G4IS.js';
 import './chunk-4VPXM6UU.js';
-import './chunk-5XPKYDK7.js';
-import './chunk-IEKSEAIV.js';
-import './chunk-VQ33XLC6.js';
-import './chunk-RNCN2TTP.js';
+import './chunk-VQFSEKU5.js';
+import './chunk-6FSQ3CHQ.js';
+import './chunk-MRKSSN36.js';
+import './chunk-PBML2FHN.js';
 //# sourceMappingURL=workflow.js.map
 //# sourceMappingURL=workflow.js.map

package/docs/error-codes.md

@@ -1,3 +1,20 @@
+---
+type: Error Reference
+title: AgentRunError code reference
+description: The canonical AgentRunError.code union plus the provider-to-code mapping for OpenAI, Anthropic, Vertex, Bedrock and Ollama.
+resource: https://github.com/usetheodev/theokit-sdk/blob/main/wiki/reference/error-codes.md
+tags: [errors, providers, retry, shipped-to-npm]
+generated: { by: human:paulohenriquevn, at: 2026-08-05T00:00:00Z }
+status: stable
+sources:
+  - id: mappers
+    resource: packages/sdk/src/internal/error-mappers/
+    title: Per-provider mapping implementations — the authoritative list
+  - id: adrs
+    resource: ADRs D311-D314, D65-D68
+    title: Error-system architecture decisions
+---
+
 # `@theokit/sdk` Error Codes Reference
 
 Canonical reference for `AgentRunError.code` values + provider-to-code mapping (Production-Readiness #3, ADRs D311-D314).
@@ -155,3 +172,8 @@ The redacted body is safe to log — `redactSecrets` strips known secret pattern
 
 - `internal/error-mappers/` — per-provider mapping implementations
 - ADRs D311-D314, D65-D68 (the broader error system)
+- [Capability map](./harness-capability-map.md) — where the error classes are exported from
+
+In the wiki: [failure taxonomy](https://github.com/usetheodev/theokit-sdk/blob/main/wiki/sdk/failure-taxonomy.md) turns these codes into a
+response policy (retry vs fail-fast), and [run signals](https://github.com/usetheodev/theokit-sdk/blob/main/wiki/sdk/run-signals.md) places
+`error` among the seven ways a run can end.

package/docs/harness-capability-map.md

@@ -1,3 +1,20 @@
+---
+type: API Reference
+title: Theo Harness Capability Map
+description: Every public primitive of @theokit/sdk and @theokit/sdk-tools with its real import path and a minimal example.
+resource: https://github.com/usetheodev/theokit-sdk/blob/main/wiki/reference/harness-capability-map.md
+tags: [api, imports, discovery, shipped-to-npm]
+generated: { by: human:paulohenriquevn, at: 2026-08-05T00:00:00Z }
+status: stable
+sources:
+  - id: types
+    resource: packages/sdk/src/types/
+    title: Exported TypeScript types — the canonical public contract
+  - id: resolve-check
+    resource: scripts/check-capability-map.mjs
+    title: Committed resolve-check that verifies every import in this file
+---
+
 # Theo Harness Capability Map
 
 A single navigable index of **what the Theo harness gives you** — every public
@@ -278,5 +295,10 @@ A few GAP_AUDIT items are runtime behaviors the harness performs internally —
 ## See also
 
 - The exported TypeScript types — the canonical, exhaustive public API contract.
+- [Error codes](./error-codes.md) — the `AgentRunError.code` table and provider mapping.
 - [`packages/sdk/README.md`](https://github.com/usetheodev/theokit-sdk/blob/main/packages/sdk/README.md) — `@theokit/sdk` front door.
 - [`packages/sdk-tools/README.md`](https://github.com/usetheodev/theokit-sdk/blob/main/packages/sdk-tools/README.md) — `@theokit/sdk-tools` front door.
+
+In the wiki: [import map](https://github.com/usetheodev/theokit-sdk/blob/main/wiki/sdk/import-map.md) groups these same entries by task,
+[run signals](https://github.com/usetheodev/theokit-sdk/blob/main/wiki/sdk/run-signals.md) covers what a run reports back, and
+[failure taxonomy](https://github.com/usetheodev/theokit-sdk/blob/main/wiki/sdk/failure-taxonomy.md) says which of the codes above are worth a retry.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "4.40.0",
+  "version": "4.41.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-MSR3DHO4.js

@@ -1,46 +0,0 @@
-export { Agent } from './chunk-ZRQZOJ3N.js';
-import './chunk-2SFBB54R.js';
-import './chunk-UIPTINIF.js';
-import './chunk-K2BQQ445.js';
-import './chunk-ONVIALVV.js';
-import './chunk-XRKFWV7K.js';
-import './chunk-X627TO3A.js';
-import './chunk-MI3OKONE.js';
-import './chunk-5KOW3GLE.js';
-import './chunk-7PBAJ2WA.js';
-import './chunk-KRPEPZQY.js';
-import './chunk-C64E2EJS.js';
-import './chunk-7GFX45DD.js';
-import './chunk-RMCHJZNZ.js';
-import './chunk-HJMFPIRM.js';
-import './chunk-FUP3ZA5T.js';
-import './chunk-OXNYIMZZ.js';
-import './chunk-FD2UT76F.js';
-import './chunk-U54XCYG3.js';
-import './chunk-RP5HQVLD.js';
-import './chunk-6X6ID4MO.js';
-import './chunk-UJ7IQJAG.js';
-import './chunk-7AD3ZTZL.js';
-import './chunk-XKGOIGTJ.js';
-import './chunk-F4SQTWVR.js';
-import './chunk-LWVKI75U.js';
-import './chunk-EYUZZXHZ.js';
-import './chunk-5VKUZ26Q.js';
-import './chunk-VTDQRUAJ.js';
-import './chunk-2XLKLVVR.js';
-import './chunk-BM7VYZED.js';
-import './chunk-4VPXM6UU.js';
-import './chunk-5XPKYDK7.js';
-import './chunk-BBMN4O6E.js';
-import './chunk-XZ7PO2FM.js';
-import './chunk-X2FR4OIT.js';
-import './chunk-23HI77BZ.js';
-import './chunk-AKMPQJPX.js';
-import './chunk-5NBUH3NO.js';
-import './chunk-LYD3ALDT.js';
-import './chunk-IEKSEAIV.js';
-import './chunk-4GGXF7YM.js';
-import './chunk-VQ33XLC6.js';
-import './chunk-RNCN2TTP.js';
-//# sourceMappingURL=agent-MSR3DHO4.js.map
-//# sourceMappingURL=agent-MSR3DHO4.js.map