@theokit/sdk 4.53.0 → 4.54.0

package/dist/subagents-loader-AZIXJ7D3.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+var chunkHJBMA5MB_cjs = require('./chunk-HJBMA5MB.cjs');
+require('./chunk-IWBGCBR6.cjs');
+require('./chunk-K3FW2XZD.cjs');
+require('./chunk-JTB5Q42C.cjs');
+require('./chunk-NUKRL3I6.cjs');
+
+
+
+Object.defineProperty(exports, "loadSubagents", {
+  enumerable: true,
+  get: function () { return chunkHJBMA5MB_cjs.loadSubagents; }
+});
+//# sourceMappingURL=subagents-loader-AZIXJ7D3.cjs.map
+//# sourceMappingURL=subagents-loader-AZIXJ7D3.cjs.map

package/dist/{subagents-loader-3CXBQWWY.cjs.map → subagents-loader-AZIXJ7D3.cjs.map}

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

package/dist/subagents-loader-J54ESLDV.js

@@ -0,0 +1,7 @@
+export { loadSubagents } from './chunk-2QKTVKH3.js';
+import './chunk-AG5JPQIY.js';
+import './chunk-IDCKSLYH.js';
+import './chunk-T7XEKOVW.js';
+import './chunk-T7O6K6PX.js';
+//# sourceMappingURL=subagents-loader-J54ESLDV.js.map
+//# sourceMappingURL=subagents-loader-J54ESLDV.js.map

package/dist/{subagents-loader-WN2SB6PV.js.map → subagents-loader-J54ESLDV.js.map}

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

package/dist/subagents-loader.cjs

@@ -1,9 +1,10 @@
 'use strict';
 
-var chunkRTLUZKDL_cjs = require('./chunk-RTLUZKDL.cjs');
-require('./chunk-44IISBRZ.cjs');
-var chunk2YGIBOUH_cjs = require('./chunk-2YGIBOUH.cjs');
-require('./chunk-SXSPMRSV.cjs');
+var chunkHJBMA5MB_cjs = require('./chunk-HJBMA5MB.cjs');
+require('./chunk-IWBGCBR6.cjs');
+var chunkK3FW2XZD_cjs = require('./chunk-K3FW2XZD.cjs');
+require('./chunk-JTB5Q42C.cjs');
+require('./chunk-NUKRL3I6.cjs');
 
 // src/subagents-loader.ts
 var ACCEPTED_SOURCES = ["project"];
@@ -12,7 +13,7 @@ function resolveSources(options) {
   if (declared === void 0) return ACCEPTED_SOURCES;
   for (const source of declared) {
     if (!ACCEPTED_SOURCES.includes(source)) {
-      throw new chunk2YGIBOUH_cjs.ConfigurationError(
+      throw new chunkK3FW2XZD_cjs.ConfigurationError(
         `Unknown subagent setting source "${String(source)}" (accepted: ${ACCEPTED_SOURCES.join(", ")})`,
         { code: "subagent_unknown_setting_source" }
       );
@@ -22,7 +23,7 @@ function resolveSources(options) {
 }
 async function discoverSubagents(cwd, options) {
   const sources = resolveSources(options);
-  return chunkRTLUZKDL_cjs.loadSubagents(cwd, sources.includes("project"), void 0);
+  return chunkHJBMA5MB_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,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"]}
+{"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,6 @@
-import { a as AgentDefinition } from './agent-Zta1kvGH.cjs';
-import './run-C8FBAC8o.cjs';
+import { a as AgentDefinition } from './agent-CIUgz7cN.cjs';
+import './sdk-agent-DEoKhA8a.cjs';
+import './run-BYSHf58D.cjs';
 import 'zod';
 
 /**

package/dist/subagents-loader.d.ts

@@ -1,5 +1,6 @@
-import { a as AgentDefinition } from './agent-BiCINq25.js';
-import './run-C8FBAC8o.js';
+import { a as AgentDefinition } from './agent-DSec-E0c.js';
+import './sdk-agent-D8qJVkuV.js';
+import './run-BYSHf58D.js';
 import 'zod';
 
 /**

package/dist/subagents-loader.js

@@ -1,7 +1,8 @@
-import { loadSubagents } from './chunk-XGYI2KQH.js';
-import './chunk-5XXUYU3M.js';
-import { ConfigurationError } from './chunk-HI4ZW62S.js';
-import './chunk-4X3SBHPK.js';
+import { loadSubagents } from './chunk-2QKTVKH3.js';
+import './chunk-AG5JPQIY.js';
+import { ConfigurationError } from './chunk-IDCKSLYH.js';
+import './chunk-T7XEKOVW.js';
+import './chunk-T7O6K6PX.js';
 
 // src/subagents-loader.ts
 var ACCEPTED_SOURCES = ["project"];

package/dist/subagents-loader.js.map

@@ -1 +1 @@
-{"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"]}
+{"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/define-subscription.d.cts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — `defineSubscription` DSL (G8 public API).
+ * `defineSubscription` DSL (G8 public API) — `@theokit/sdk`.
  *
  * Per ADR D426 (AsyncGenerator handler + Zod input/output schemas).
  *

package/dist/subscription/define-subscription.d.ts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — `defineSubscription` DSL (G8 public API).
+ * `defineSubscription` DSL (G8 public API) — `@theokit/sdk`.
  *
  * Per ADR D426 (AsyncGenerator handler + Zod input/output schemas).
  *

package/dist/subscription/index.cjs

@@ -1,7 +1,8 @@
 'use strict';
 
-var chunk2YGIBOUH_cjs = require('../chunk-2YGIBOUH.cjs');
-require('../chunk-SXSPMRSV.cjs');
+var chunkK3FW2XZD_cjs = require('../chunk-K3FW2XZD.cjs');
+require('../chunk-JTB5Q42C.cjs');
+require('../chunk-NUKRL3I6.cjs');
 
 // src/subscription/define-subscription.ts
 function defineSubscription(opts) {
@@ -138,7 +139,7 @@ function tracked(id, payload) {
   }
   return [id, payload];
 }
-var SubscriptionError = class extends chunk2YGIBOUH_cjs.TheokitAgentError {
+var SubscriptionError = class extends chunkK3FW2XZD_cjs.TheokitAgentError {
   name = "SubscriptionError";
   constructor(message, options = {}) {
     super(message, { ...options, isRetryable: false });
@@ -217,7 +218,8 @@ async function* subscribe(name, input, opts) {
 }
 async function* openSse(name, input, opts) {
   const url = `${stripTrailingSlash(opts.baseUrl)}/api/subscriptions/${encodeURIComponent(name)}?input=${encodeURIComponent(JSON.stringify(input))}`;
-  const res = await fetch(url, {
+  const fetchFn = opts.fetch ?? globalThis.fetch;
+  const res = await fetchFn(url, {
     method: "GET",
     headers: {
       accept: "text/event-stream",
@@ -251,10 +253,10 @@ async function* openSse(name, input, opts) {
 async function* openWs(name, input, opts) {
   const baseUrl = stripTrailingSlash(opts.baseUrl);
   const wsUrl = baseUrl.replace(/^http:/, "ws:").replace(/^https:/, "wss:").concat("/api/ws");
-  const WS = globalThis.WebSocket;
+  const WS = opts.WebSocket ?? globalThis.WebSocket;
   if (WS === void 0) {
     throw new SubscriptionError(
-      "Theokit.subscribe(transport='ws'): no global WebSocket available. Use Node >=22 or install 'ws' as a runtime dep + assign to globalThis.WebSocket.",
+      "Theokit.subscribe(transport='ws'): no global WebSocket available. Use Node >=22 or install 'ws' as a runtime dep + assign to globalThis.WebSocket, or pass opts.WebSocket.",
       { code: "ws_global_missing" }
     );
   }
@@ -330,10 +332,11 @@ async function* openWs(name, input, opts) {
     }
   }
 }
-async function selectTransport(pref, _name, _opts) {
+async function selectTransport(pref, _name, opts) {
   if (pref === "ws") return "ws";
   if (pref === "sse") return "sse";
-  if (typeof globalThis.WebSocket === "function") {
+  const WS = opts.WebSocket ?? globalThis.WebSocket;
+  if (typeof WS === "function") {
     return "ws";
   }
   return "sse";
@@ -357,13 +360,23 @@ function safeJsonParse(s) {
 }
 async function* streamToAsyncIterable(stream) {
   const reader = stream.getReader();
+  let finishedNaturally = false;
   try {
     while (true) {
       const { done, value } = await reader.read();
-      if (done) return;
+      if (done) {
+        finishedNaturally = true;
+        return;
+      }
       if (value !== void 0) yield value;
     }
   } finally {
+    if (!finishedNaturally) {
+      try {
+        await reader.cancel();
+      } catch {
+      }
+    }
     reader.releaseLock();
   }
 }

package/dist/subscription/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/subscription/define-subscription.ts","../../src/subscription/internal/sse-parser.ts","../../src/subscription/types.ts","../../src/subscription/theokit-subscribe.ts"],"names":["TheokitAgentError"],"mappings":";;;;;;AAoEO,SAAS,mBACd,IAAA,EACyC;AACzC,EAAA,IAAI,IAAA,KAAS,IAAA,IAAQ,OAAO,IAAA,KAAS,QAAA,EAAU;AAC7C,IAAA,MAAM,IAAI,UAAU,gDAAgD,CAAA;AAAA,EACtE;AACA,EAAA,IAAI,KAAK,KAAA,KAAU,MAAA,IAAa,OAAO,IAAA,CAAK,KAAA,CAAM,cAAc,UAAA,EAAY;AAC1E,IAAA,MAAM,IAAI,UAAU,kEAAkE,CAAA;AAAA,EACxF;AACA,EAAA,IAAI,KAAK,MAAA,KAAW,MAAA,IAAa,OAAO,IAAA,CAAK,MAAA,CAAO,cAAc,UAAA,EAAY;AAC5E,IAAA,MAAM,IAAI,UAAU,mEAAmE,CAAA;AAAA,EACzF;AACA,EAAA,IAAI,OAAO,IAAA,CAAK,OAAA,KAAY,UAAA,EAAY;AACtC,IAAA,MAAM,IAAI,UAAU,sEAAsE,CAAA;AAAA,EAC5F;AACA,EAAA,OAAO;AAAA,IACL,GAAI,KAAK,IAAA,KAAS,MAAA,GAAY,EAAE,IAAA,EAAM,IAAA,CAAK,IAAA,EAAK,GAAI,EAAC;AAAA,IACrD,OAAO,IAAA,CAAK,KAAA;AAAA,IACZ,QAAQ,IAAA,CAAK,MAAA;AAAA,IACb,SAAS,IAAA,CAAK;AAAA,GAChB;AACF;AAGO,IAAM,eAAN,MAAmB;AAAA,EAChB,WAAA,GAAc;AAAA,EAAC;AAAA,EACvB,OAAO,OACL,IAAA,EACyC;AACzC,IAAA,OAAO,mBAAmB,IAAI,CAAA;AAAA,EAChC;AACF;;;AClFA,IAAM,OAAA,GAAU,IAAI,WAAA,CAAY,OAAO,CAAA;AAgBvC,gBAAuB,YACrB,MAAA,EACqC;AACrC,EAAA,IAAI,MAAA,GAAS,EAAA;AACb,EAAA,IAAI,SAAA;AACJ,EAAA,IAAI,YAAsB,EAAC;AAC3B,EAAA,IAAI,EAAA;AACJ,EAAA,IAAI,KAAA;AACJ,EAAA,IAAI,eAAyB,EAAC;AAC9B,EAAA,IAAI,QAAA,GAAW,KAAA;AAGf,EAAA,MAAM,WAAW,MAAsB;AACrC,IAAA,IAAI,CAAC,QAAA,EAAU;AAEb,MAAA,SAAA,GAAY,MAAA;AACZ,MAAA,SAAA,GAAY,EAAC;AACb,MAAA,EAAA,GAAK,MAAA;AACL,MAAA,KAAA,GAAQ,MAAA;AACR,MAAA,YAAA,GAAe,EAAC;AAChB,MAAA,OAAO,IAAA;AAAA,IACT;AACA,IAAA,MAAM,QAAiB,EAAC;AACxB,IAAA,IAAI,SAAA,KAAc,MAAA,EAAY,KAAA,CAA6B,KAAA,GAAQ,SAAA;AACnE,IAAA,IAAI,SAAA,CAAU,SAAS,CAAA,EAAI,MAA4B,IAAA,GAAO,SAAA,CAAU,KAAK,IAAI,CAAA;AACjF,IAAA,IAAI,EAAA,KAAO,MAAA,EAAY,KAAA,CAA0B,EAAA,GAAK,EAAA;AACtD,IAAA,IAAI,KAAA,KAAU,MAAA,EAAY,KAAA,CAA6B,KAAA,GAAQ,KAAA;AAC/D,IAAA,IAAI,YAAA,CAAa,SAAS,CAAA,EAAI,MAA+B,OAAA,GAAU,YAAA,CAAa,KAAK,IAAI,CAAA;AAC7F,IAAA,SAAA,GAAY,MAAA;AACZ,IAAA,SAAA,GAAY,EAAC;AACb,IAAA,EAAA,GAAK,MAAA;AACL,IAAA,KAAA,GAAQ,MAAA;AACR,IAAA,YAAA,GAAe,EAAC;AAChB,IAAA,QAAA,GAAW,KAAA;AACX,IAAA,OAAO,KAAA;AAAA,EACT,CAAA;AAGA,EAAA,MAAM,UAAA,GAAa,CAAC,IAAA,KAAiC;AACnD,IAAA,IAAI,SAAS,EAAA,EAAI;AACf,MAAA,OAAO,QAAA,EAAS;AAAA,IAClB;AACA,IAAA,IAAI,IAAA,CAAK,UAAA,CAAW,GAAG,CAAA,EAAG;AAExB,MAAA,YAAA,CAAa,IAAA,CAAK,KAAK,KAAA,CAAM,CAAC,EAAE,OAAA,CAAQ,IAAA,EAAM,EAAE,CAAC,CAAA;AACjD,MAAA,QAAA,GAAW,IAAA;AACX,MAAA,OAAO,IAAA;AAAA,IACT;AACA,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,OAAA,CAAQ,GAAG,CAAA;AACjC,IAAA,IAAI,KAAA;AACJ,IAAA,IAAI,KAAA;AACJ,IAAA,IAAI,aAAa,EAAA,EAAI;AACnB,MAAA,KAAA,GAAQ,IAAA;AACR,MAAA,KAAA,GAAQ,EAAA;AAAA,IACV,CAAA,MAAO;AACL,MAAA,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,CAAA,EAAG,QAAQ,CAAA;AAC9B,MAAA,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,QAAA,GAAW,CAAC,CAAA;AAE/B,MAAA,IAAI,MAAM,UAAA,CAAW,GAAG,GAAG,KAAA,GAAQ,KAAA,CAAM,MAAM,CAAC,CAAA;AAAA,IAClD;AACA,IAAA,QAAQ,KAAA;AAAO,MACb,KAAK,OAAA;AACH,QAAA,SAAA,GAAY,KAAA;AACZ,QAAA,QAAA,GAAW,IAAA;AACX,QAAA;AAAA,MACF,KAAK,MAAA;AACH,QAAA,SAAA,CAAU,KAAK,KAAK,CAAA;AACpB,QAAA,QAAA,GAAW,IAAA;AACX,QAAA;AAAA,MACF,KAAK,IAAA;AAEH,QAAA,IAAI,CAAC,KAAA,CAAM,QAAA,CAAS,IAAI,CAAA,EAAG;AACzB,UAAA,EAAA,GAAK,KAAA;AACL,UAAA,QAAA,GAAW,IAAA;AAAA,QACb;AACA,QAAA;AAAA,MACF,KAAK,OAAA;AACH,QAAA,IAAI,OAAA,CAAQ,IAAA,CAAK,KAAK,CAAA,EAAG;AACvB,UAAA,KAAA,GAAQ,MAAA,CAAO,QAAA,CAAS,KAAA,EAAO,EAAE,CAAA;AACjC,UAAA,QAAA,GAAW,IAAA;AAAA,QACb;AACA,QAAA;AAGA;AAEJ,IAAA,OAAO,IAAA;AAAA,EACT,CAAA;AAEA,EAAA,WAAA,MAAiB,SAAS,MAAA,EAAQ;AAEhC,IAAA,MAAA,IAAU,OAAA,CAAQ,MAAA,CAAO,KAAA,EAAO,EAAE,MAAA,EAAQ,MAAM,CAAA,CAAE,OAAA,CAAQ,UAAA,EAAY,IAAI,CAAA;AAC1E,IAAA,IAAI,GAAA;AAEJ,IAAA,OAAA,CAAQ,GAAA,GAAM,MAAA,CAAO,OAAA,CAAQ,IAAI,OAAO,EAAA,EAAI;AAC1C,MAAA,MAAM,IAAA,GAAO,MAAA,CAAO,KAAA,CAAM,CAAA,EAAG,GAAG,CAAA;AAChC,MAAA,MAAA,GAAS,MAAA,CAAO,KAAA,CAAM,GAAA,GAAM,CAAC,CAAA;AAC7B,MAAA,MAAM,KAAA,GAAQ,WAAW,IAAI,CAAA;AAC7B,MAAA,IAAI,KAAA,KAAU,MAAM,MAAM,KAAA;AAAA,IAC5B;AAAA,EACF;AAEA,EAAA,MAAA,IAAU,QAAQ,MAAA,EAAO;AACzB,EAAA,IAAI,MAAA,CAAO,SAAS,CAAA,EAAG;AACrB,IAAA,MAAM,KAAA,GAAQ,WAAW,MAAM,CAAA;AAC/B,IAAA,IAAI,KAAA,KAAU,MAAM,MAAM,KAAA;AAAA,EAC5B;AAEA,EAAA,MAAM,OAAO,QAAA,EAAS;AACtB,EAAA,IAAI,IAAA,KAAS,MAAM,MAAM,IAAA;AAC3B;;;AC5DO,SAAS,kBAAkB,KAAA,EAAmD;AACnF,EAAA,OAAO,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,IAAK,KAAA,CAAM,WAAW,CAAA,IAAK,OAAO,KAAA,CAAM,CAAC,CAAA,KAAM,QAAA;AAC3E;AAQO,SAAS,OAAA,CAAW,IAAY,OAAA,EAAgC;AACrE,EAAA,IAAI,OAAO,EAAA,KAAO,QAAA,IAAY,EAAA,CAAG,WAAW,CAAA,EAAG;AAC7C,IAAA,MAAM,IAAI,UAAU,0CAA0C,CAAA;AAAA,EAChE;AACA,EAAA,OAAO,CAAC,IAAI,OAAO,CAAA;AACrB;AAQO,IAAM,iBAAA,GAAN,cAAgCA,mCAAA,CAAkB;AAAA,EACrC,IAAA,GAAe,mBAAA;AAAA,EAEjC,WAAA,CAAY,OAAA,EAAiB,OAAA,GAA8C,EAAC,EAAG;AAC7E,IAAA,KAAA,CAAM,SAAS,EAAE,GAAG,OAAA,EAAS,WAAA,EAAa,OAAO,CAAA;AAAA,EACnD;AACF;AAOO,IAAM,sBAAA,GAAN,cAAqC,iBAAA,CAAkB;AAAA,EAC1C,IAAA,GAAe,wBAAA;AAAA,EAExB,MAAA;AAAA,EAET,WAAA,CAAY,SAAiB,OAAA,EAA+C;AAC1E,IAAA,KAAA,CAAM,SAAS,EAAE,IAAA,EAAM,8BAA8B,KAAA,EAAO,OAAA,CAAQ,OAAO,CAAA;AAC3E,IAAA,IAAA,CAAK,SAAS,OAAA,CAAQ,MAAA;AAAA,EACxB;AACF;AAQO,IAAM,2BAAA,GAAN,cAA0C,iBAAA,CAAkB;AAAA,EAC/C,IAAA,GAAe,6BAAA;AAAA,EAExB,SAAA;AAAA,EACA,WAAA;AAAA,EAET,WAAA,CACE,OAAA,EACA,OAAA,GAAyE,EAAC,EAC1E;AACA,IAAA,KAAA,CAAM,SAAS,EAAE,IAAA,EAAM,6BAA6B,KAAA,EAAO,OAAA,CAAQ,OAAO,CAAA;AAC1E,IAAA,IAAI,OAAA,CAAQ,SAAA,KAAc,MAAA,EAAW,IAAA,CAAK,YAAY,OAAA,CAAQ,SAAA;AAC9D,IAAA,IAAI,OAAA,CAAQ,WAAA,KAAgB,MAAA,EAAW,IAAA,CAAK,cAAc,OAAA,CAAQ,WAAA;AAAA,EACpE;AACF;;;AC7GA,IAAM,YAAA,GAAe,CAAC,OAAA,KAAoB,IAAA,CAAK,IAAI,GAAA,EAAQ,GAAA,GAAO,KAAK,OAAO,CAAA;AAW9E,gBAAuB,SAAA,CACrB,IAAA,EACA,KAAA,EACA,IAAA,EACqC;AACrC,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,IAAA,CAAK,WAAW,CAAA,EAAG;AACjD,IAAA,MAAM,IAAI,kBAAkB,oDAAA,EAAsD;AAAA,MAChF,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AACA,EAAA,IAAI,IAAA,KAAS,QAAQ,OAAO,IAAA,KAAS,YAAY,OAAO,IAAA,CAAK,YAAY,QAAA,EAAU;AACjF,IAAA,MAAM,IAAI,kBAAkB,6CAAA,EAA+C;AAAA,MACzE,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AACA,EAAA,MAAM,SAAA,GAAY,KAAK,SAAA,IAAa,MAAA;AACpC,EAAA,MAAM,aAAA,GAAgB,KAAK,oBAAA,IAAwB,EAAA;AACnD,EAAA,MAAM,KAAA,GAAQ,KAAK,YAAA,IAAgB,YAAA;AAEnC,EAAA,IAAI,WAAA;AACJ,EAAA,IAAI,OAAA,GAAU,CAAA;AAEd,EAAA,OAAO,IAAA,EAAM;AACX,IAAA,IAAI,IAAA,CAAK,QAAQ,OAAA,EAAS;AAC1B,IAAA,IAAI;AACF,MAAA,MAAM,eAAA,GAAkB,gBAAA,CAAiB,KAAA,EAAO,WAAW,CAAA;AAC3D,MAAA,MAAM,MAAA,GAAS,MAAM,eAAA,CAAgB,SAAA,EAAW,MAAM,IAAI,CAAA;AAC1D,MAAA,IAAI,WAAW,IAAA,EAAM;AACnB,QAAA,WAAA,MAAiB,GAAA,IAAO,MAAA,CAAgB,IAAA,EAAM,eAAA,EAAiB,IAAI,CAAA,EAAG;AACpE,UAAA,IAAI,GAAA,CAAI,WAAA,KAAgB,KAAA,CAAA,EAAW,WAAA,GAAc,GAAA,CAAI,WAAA;AACrD,UAAA,OAAA,GAAU,CAAA;AACV,UAAA,MAAM,GAAA,CAAI,KAAA;AAAA,QACZ;AAAA,MACF,CAAA,MAAO;AACL,QAAA,WAAA,MAAiB,GAAA,IAAO,OAAA,CAAiB,IAAA,EAAM,eAAA,EAAiB,IAAI,CAAA,EAAG;AACrE,UAAA,IAAI,GAAA,CAAI,WAAA,KAAgB,KAAA,CAAA,EAAW,WAAA,GAAc,GAAA,CAAI,WAAA;AACrD,UAAA,OAAA,GAAU,CAAA;AACV,UAAA,MAAM,GAAA,CAAI,KAAA;AAAA,QACZ;AAAA,MACF;AAEA,MAAA;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,IAAI,IAAA,CAAK,QAAQ,OAAA,EAAS;AAC1B,MAAA,IAAI,aAAA,KAAkB,CAAA,IAAK,OAAA,IAAW,aAAA,EAAe;AACnD,QAAA,IAAI,KAAA,YAAiB,mBAAmB,MAAM,KAAA;AAC9C,QAAA,MAAM,IAAI,2BAAA;AAAA,UACR,iBAAiB,IAAI,CAAA,mCAAA,CAAA;AAAA,UACrB,EAAE,KAAA;AAAM,SACV;AAAA,MACF;AACA,MAAA,MAAM,KAAA,GAAQ,MAAM,OAAO,CAAA;AAC3B,MAAA,OAAA,EAAA;AACA,MAAA,MAAM,KAAA,CAAM,KAAA,EAAO,IAAA,CAAK,MAAM,CAAA;AAAA,IAChC;AAAA,EACF;AACF;AAQA,gBAAgB,OAAA,CACd,IAAA,EACA,KAAA,EACA,IAAA,EAC4B;AAC5B,EAAA,MAAM,MAAM,CAAA,EAAG,kBAAA,CAAmB,IAAA,CAAK,OAAO,CAAC,CAAA,mBAAA,EAAsB,kBAAA,CAAmB,IAAI,CAAC,UAAU,kBAAA,CAAmB,IAAA,CAAK,SAAA,CAAU,KAAK,CAAC,CAAC,CAAA,CAAA;AAChJ,EAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,IAC3B,MAAA,EAAQ,KAAA;AAAA,IACR,OAAA,EAAS;AAAA,MACP,MAAA,EAAQ,mBAAA;AAAA,MACR,GAAI,IAAA,CAAK,OAAA,IAAW;AAAC,KACvB;AAAA,IACA,GAAI,KAAK,MAAA,KAAW,MAAA,GAAY,EAAE,MAAA,EAAQ,IAAA,CAAK,MAAA,EAAO,GAAI;AAAC,GAC5D,CAAA;AACD,EAAA,IAAI,CAAC,GAAA,CAAI,EAAA,IAAM,GAAA,CAAI,SAAS,IAAA,EAAM;AAChC,IAAA,MAAM,IAAI,kBAAkB,CAAA,2BAAA,EAA8B,GAAA,CAAI,MAAM,CAAA,CAAA,EAAI,GAAA,CAAI,UAAU,CAAA,CAAA,EAAI;AAAA,MACxF,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AACA,EAAA,MAAM,MAAA,GAAS,WAAA,CAAY,qBAAA,CAAsB,GAAA,CAAI,IAAI,CAAC,CAAA;AAC1D,EAAA,WAAA,MAAiB,MAAM,MAAA,EAAQ;AAC7B,IAAA,IAAI,EAAA,CAAG,UAAU,KAAA,EAAO;AACxB,IAAA,IAAI,EAAA,CAAG,UAAU,OAAA,EAAS;AACxB,MAAA,MAAM,IAAI,iBAAA,CAAkB,CAAA,0BAAA,EAA6B,EAAA,CAAG,IAAA,IAAQ,WAAW,CAAA,CAAA,EAAI;AAAA,QACjF,IAAA,EAAM;AAAA,OACP,CAAA;AAAA,IACH;AACA,IAAA,IAAI,EAAA,CAAG,UAAU,WAAA,EAAa;AAC9B,IAAA,IAAI,EAAA,CAAG,SAAS,MAAA,EAAW;AAC3B,IAAA,MAAM,WAAA,GAAc,aAAA,CAAiB,EAAA,CAAG,IAAI,CAAA;AAC5C,IAAA,IAAI,gBAAgB,MAAA,EAAW;AAC/B,IAAA,MAAM;AAAA,MACJ,KAAA,EAAO,WAAA;AAAA,MACP,GAAI,GAAG,EAAA,KAAO,MAAA,GAAY,EAAE,WAAA,EAAa,EAAA,CAAG,EAAA,EAAG,GAAI;AAAC,KACtD;AAAA,EACF;AACF;AAGA,gBAAgB,MAAA,CACd,IAAA,EACA,KAAA,EACA,IAAA,EAC4B;AAC5B,EAAA,MAAM,OAAA,GAAU,kBAAA,CAAmB,IAAA,CAAK,OAAO,CAAA;AAC/C,EAAA,MAAM,KAAA,GAAQ,OAAA,CACX,OAAA,CAAQ,QAAA,EAAU,KAAK,CAAA,CACvB,OAAA,CAAQ,SAAA,EAAW,MAAM,CAAA,CACzB,MAAA,CAAO,SAAS,CAAA;AAEnB,EAAA,MAAM,KAAM,UAAA,CAAgD,SAAA;AAC5D,EAAA,IAAI,OAAO,MAAA,EAAW;AACpB,IAAA,MAAM,IAAI,iBAAA;AAAA,MACR,oJAAA;AAAA,MACA,EAAE,MAAM,mBAAA;AAAoB,KAC9B;AAAA,EACF;AACA,EAAA,MAAM,EAAA,GAAK,IAAI,EAAA,CAAG,KAAK,CAAA;AAGvB,EAAA,MAAM,WAAwB,EAAC;AAE/B,EAAA,IAAI,MAAA,GAAyC,IAAA;AAC7C,EAAA,IAAI,MAAA,GAAS,KAAA;AACb,EAAA,IAAI,UAAA;AAEJ,EAAA,EAAA,CAAG,gBAAA,CAAiB,SAAA,EAAW,CAAC,EAAA,KAAqB;AACnD,IAAA,MAAM,OAAO,OAAO,EAAA,CAAG,IAAA,KAAS,QAAA,GAAW,GAAG,IAAA,GAAO,EAAA;AACrD,IAAA,MAAM,KAAA,GAAQ,cAAyB,IAAI,CAAA;AAC3C,IAAA,IAAI,UAAU,MAAA,EAAW;AACvB,MAAA,QAAA,CAAS,KAAK,KAAK,CAAA;AACnB,MAAA,IAAI,WAAW,IAAA,EAAM;AACnB,QAAA,MAAA,EAAO;AACP,QAAA,MAAA,GAAS,IAAA;AAAA,MACX;AAAA,IACF;AAAA,EACF,CAAC,CAAA;AACD,EAAA,EAAA,CAAG,gBAAA,CAAiB,SAAS,MAAM;AACjC,IAAA,MAAA,GAAS,IAAA;AACT,IAAA,IAAI,WAAW,IAAA,EAAM;AACnB,MAAA,MAAA,EAAO;AACP,MAAA,MAAA,GAAS,IAAA;AAAA,IACX;AAAA,EACF,CAAC,CAAA;AACD,EAAA,EAAA,CAAG,gBAAA,CAAiB,SAAS,MAAM;AACjC,IAAA,MAAA,GAAS,IAAA;AACT,IAAA,UAAA,GAAa,IAAI,MAAM,iBAAiB,CAAA;AACxC,IAAA,IAAI,WAAW,IAAA,EAAM;AACnB,MAAA,MAAA,EAAO;AACP,MAAA,MAAA,GAAS,IAAA;AAAA,IACX;AAAA,EACF,CAAC,CAAA;AAED,EAAA,MAAM,IAAI,OAAA,CAAc,CAAC,OAAA,EAAS,MAAA,KAAW;AAC3C,IAAA,EAAA,CAAG,gBAAA,CAAiB,QAAQ,MAAM,OAAA,IAAW,EAAE,IAAA,EAAM,MAAM,CAAA;AAC3D,IAAA,EAAA,CAAG,gBAAA,CAAiB,OAAA,EAAS,MAAM,MAAA,CAAO,IAAI,KAAA,CAAM,mBAAmB,CAAC,CAAA,EAAG,EAAE,IAAA,EAAM,IAAA,EAAM,CAAA;AAAA,EAC3F,CAAC,CAAA;AAGD,EAAA,EAAA,CAAG,IAAA,CAAK,KAAK,SAAA,CAAU,EAAE,MAAM,WAAA,EAAa,IAAA,EAAM,KAAA,EAAO,CAAC,CAAA;AAE1D,EAAA,IAAI,IAAA,CAAK,WAAW,MAAA,EAAW;AAC7B,IAAA,IAAA,CAAK,MAAA,CAAO,gBAAA,CAAiB,OAAA,EAAS,MAAM,EAAA,CAAG,OAAM,EAAG,EAAE,IAAA,EAAM,IAAA,EAAM,CAAA;AAAA,EACxE;AAEA,EAAA,IAAI;AACF,IAAA,OAAO,IAAA,EAAM;AACX,MAAA,IAAI,QAAA,CAAS,WAAW,CAAA,EAAG;AACzB,QAAA,IAAI,MAAA,EAAQ;AACV,UAAA,IAAI,UAAA,KAAe,QAAW,MAAM,UAAA;AACpC,UAAA;AAAA,QACF;AACA,QAAA,MAAM,IAAI,OAAA,CAAc,CAAC,OAAA,KAAY;AACnC,UAAA,MAAA,GAAS,OAAA;AAAA,QACX,CAAC,CAAA;AACD,QAAA;AAAA,MACF;AACA,MAAA,MAAM,KAAA,GAAQ,SAAS,KAAA,EAAM;AAC7B,MAAA,IAAI,KAAA,CAAM,SAAS,KAAA,EAAO;AAC1B,MAAA,IAAI,KAAA,CAAM,SAAS,OAAA,EAAS;AAC1B,QAAA,MAAM,IAAI,iBAAA;AAAA,UACR,CAAA,yBAAA,EAA4B,KAAA,CAAM,KAAA,EAAO,OAAA,IAAW,WAAW,CAAA,CAAA;AAAA,UAC/D,EAAE,MAAM,iBAAA;AAAkB,SAC5B;AAAA,MACF;AACA,MAAA,MAAM,QAAQ,KAAA,CAAM,IAAA;AACpB,MAAA,MAAM;AAAA,QACJ,KAAA;AAAA,QACA,GAAI,MAAM,EAAA,KAAO,KAAA,CAAA,GAAY,EAAE,WAAA,EAAa,KAAA,CAAM,EAAA,EAAG,GAAI;AAAC,OAC5D;AAAA,IACF;AAAA,EACF,CAAA,SAAE;AACA,IAAA,IAAI;AACF,MAAA,EAAA,CAAG,KAAA,EAAM;AAAA,IACX,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AACF;AAEA,eAAe,eAAA,CACb,IAAA,EACA,KAAA,EACA,KAAA,EACuB;AACvB,EAAA,IAAI,IAAA,KAAS,MAAM,OAAO,IAAA;AAC1B,EAAA,IAAI,IAAA,KAAS,OAAO,OAAO,KAAA;AAE3B,EAAA,IAAI,OAAQ,UAAA,CAAuC,SAAA,KAAc,UAAA,EAAY;AAC3E,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,OAAO,KAAA;AACT;AAEA,SAAS,gBAAA,CAAiB,OAAgB,WAAA,EAA0C;AAClF,EAAA,IAAI,WAAA,KAAgB,QAAW,OAAO,KAAA;AACtC,EAAA,IAAI,KAAA,KAAU,QAAQ,OAAO,KAAA,KAAU,YAAY,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,EAAG;AAEvE,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,EAAE,GAAI,KAAA,EAAkB,WAAA,EAAY;AAC7C;AAEA,SAAS,mBAAmB,CAAA,EAAmB;AAC7C,EAAA,OAAO,CAAA,CAAE,SAAS,GAAG,CAAA,GAAI,EAAE,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,GAAI,CAAA;AAC5C;AAEA,SAAS,cAAiB,CAAA,EAA0B;AAClD,EAAA,IAAI;AACF,IAAA,OAAO,IAAA,CAAK,MAAM,CAAC,CAAA;AAAA,EACrB,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,MAAA;AAAA,EACT;AACF;AAEA,gBAAgB,sBACd,MAAA,EAC2B;AAC3B,EAAA,MAAM,MAAA,GAAS,OAAO,SAAA,EAAU;AAChC,EAAA,IAAI;AACF,IAAA,OAAO,IAAA,EAAM;AACX,MAAA,MAAM,EAAE,IAAA,EAAM,KAAA,EAAM,GAAI,MAAM,OAAO,IAAA,EAAK;AAC1C,MAAA,IAAI,IAAA,EAAM;AACV,MAAA,IAAI,KAAA,KAAU,QAAW,MAAM,KAAA;AAAA,IACjC;AAAA,EACF,CAAA,SAAE;AACA,IAAA,MAAA,CAAO,WAAA,EAAY;AAAA,EACrB;AACF;AAEA,SAAS,KAAA,CAAM,IAAY,MAAA,EAAqC;AAC9D,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,OAAA,EAAS,MAAA,KAAW;AACtC,IAAA,IAAI,QAAQ,OAAA,EAAS;AACnB,MAAA,MAAA,CAAO,IAAI,KAAA,CAAM,SAAS,CAAC,CAAA;AAC3B,MAAA;AAAA,IACF;AACA,IAAA,MAAM,CAAA,GAAI,WAAW,MAAM;AACzB,MAAA,MAAA,EAAQ,mBAAA,CAAoB,SAAS,OAAO,CAAA;AAC5C,MAAA,OAAA,EAAQ;AAAA,IACV,GAAG,EAAE,CAAA;AACL,IAAA,MAAM,UAAU,MAAM;AACpB,MAAA,YAAA,CAAa,CAAC,CAAA;AACd,MAAA,MAAA,CAAO,IAAI,KAAA,CAAM,SAAS,CAAC,CAAA;AAAA,IAC7B,CAAA;AACA,IAAA,MAAA,EAAQ,iBAAiB,OAAA,EAAS,OAAA,EAAS,EAAE,IAAA,EAAM,MAAM,CAAA;AAAA,EAC3D,CAAC,CAAA;AACH","file":"index.cjs","sourcesContent":["/**\n * @theokit/sdk — `defineSubscription` DSL (G8 public API).\n *\n * Per ADR D426 (AsyncGenerator handler + Zod input/output schemas).\n *\n * @public\n */\n\nimport type { SubscriptionCtx, SubscriptionDescriptor, TrackedEnvelope, ZodLike } from \"./types.js\";\n\n/**\n * Options accepted by {@link defineSubscription}.\n *\n * @public\n */\nexport interface DefineSubscriptionOptions<TInput, TOutput> {\n  /** Optional explicit name. Falls back to filename derivation by the scanner. */\n  name?: string;\n  /** Zod schema validating subscription input. Required (typed RPC contract). */\n  input: ZodLike<TInput>;\n  /** Zod schema describing each output frame. Informational; not enforced per-frame. */\n  output: ZodLike<TOutput>;\n  /**\n   * Handler that produces the subscription stream.\n   *\n   * Receives the validated input + {@link SubscriptionCtx}. Yielding a value\n   * emits a plain output frame. Yielding a `tracked(id, payload)` envelope\n   * additionally advertises a resume token to the client so reconnects can\n   * resume from that point.\n   */\n  handler: (\n    input: TInput,\n    ctx: SubscriptionCtx,\n  ) => AsyncGenerator<TOutput | TrackedEnvelope<TOutput>, void, void>;\n}\n\n/**\n * Define a typed subscription. Pair with `Theokit.subscribe(name, input)`\n * on the client side.\n *\n * Per ADR D426 — handler is `AsyncGenerator<TOutput | TrackedEnvelope<TOutput>>`.\n * The runtime validates input via `opts.input.safeParse` BEFORE invoking the\n * handler; failure throws {@link import('./types.js').SubscriptionInputError}.\n *\n * @example\n * ```ts\n * import { Subscription } from \"@theokit/sdk/subscription\";\n * import { z } from \"zod\";\n *\n * export default Subscription.create({\n *   input: z.object({ topic: z.string() }),\n *   output: z.object({ message: z.string(), ts: z.number() }),\n *   async *handler(input, ctx) {\n *     let cursor = ctx.lastEventId ?? \"0\";\n *     while (!ctx.signal.aborted) {\n *       const msgs = await fetchMessagesSince(input.topic, cursor);\n *       for (const m of msgs) {\n *         cursor = m.id;\n *         yield ctx.tracked(m.id, { message: m.body, ts: m.ts });\n *       }\n *       await sleep(1000);\n *     }\n *   },\n * });\n * ```\n *\n * @public\n */\nexport function defineSubscription<TInput, TOutput>(\n  opts: DefineSubscriptionOptions<TInput, TOutput>,\n): SubscriptionDescriptor<TInput, TOutput> {\n  if (opts === null || typeof opts !== \"object\") {\n    throw new TypeError(\"defineSubscription: options object is required\");\n  }\n  if (opts.input === undefined || typeof opts.input.safeParse !== \"function\") {\n    throw new TypeError(\"defineSubscription: opts.input must be a Zod schema (or ZodLike)\");\n  }\n  if (opts.output === undefined || typeof opts.output.safeParse !== \"function\") {\n    throw new TypeError(\"defineSubscription: opts.output must be a Zod schema (or ZodLike)\");\n  }\n  if (typeof opts.handler !== \"function\") {\n    throw new TypeError(\"defineSubscription: opts.handler must be an async generator function\");\n  }\n  return {\n    ...(opts.name !== undefined ? { name: opts.name } : {}),\n    input: opts.input,\n    output: opts.output,\n    handler: opts.handler,\n  };\n}\n\n/** SE36 — `Subscription.create` replaces `defineSubscription` (ADR 0015). @public */\nexport class Subscription {\n  private constructor() {}\n  static create<TInput, TOutput>(\n    opts: DefineSubscriptionOptions<TInput, TOutput>,\n  ): SubscriptionDescriptor<TInput, TOutput> {\n    return defineSubscription(opts);\n  }\n}\n","/**\n * @theokit/sdk — W3C SSE parser (G8 internal).\n *\n * Per ADR D428. Reads from `ReadableStream<Uint8Array>` or async iterable of\n * UTF-8 chunks; yields parsed {@link SSEvent} objects per W3C SSE spec.\n *\n * Independent of `internal/llm/sse.ts:parseSseStream` (LLM-specific a peer vendor AI\n * Data Stream v1; locked by D38). This parser handles the `id:` field needed\n * for tracked envelopes (G8 resume mechanism), which the LLM parser ignores.\n *\n * Reference: https://html.spec.whatwg.org/multipage/server-sent-events.html\n *\n * @internal\n */\n\nimport type { SSEvent } from \"./sse-encoder.js\";\n\nconst decoder = new TextDecoder(\"utf-8\");\n\n/**\n * Parse an async iterable of UTF-8 byte chunks into a stream of SSE events.\n *\n * Implements the W3C event stream parser:\n * - Lines are split by `\\n`, `\\r\\n`, or `\\r`\n * - Events are dispatched on blank line (no `:` and no field name)\n * - Fields: `event`, `data` (multi-line concat with `\\n`), `id`, `retry`\n * - Lines starting with `:` are comments (ignored, except dispatched as `comment`)\n * - Unknown fields silently ignored per spec\n *\n * Empty events (no fields) are NOT dispatched per spec.\n *\n * @internal\n */\nexport async function* parseSseW3C(\n  source: AsyncIterable<Uint8Array>,\n): AsyncGenerator<SSEvent, void, void> {\n  let buffer = \"\";\n  let eventName: string | undefined;\n  let dataLines: string[] = [];\n  let id: string | undefined;\n  let retry: number | undefined;\n  let commentLines: string[] = [];\n  let hasField = false;\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: dispatch builds SSEvent from per-field state per W3C spec — refactor candidate\n  const dispatch = (): SSEvent | null => {\n    if (!hasField) {\n      // Blank line with no preceding fields → reset state, no dispatch (per spec § 9.2.6)\n      eventName = undefined;\n      dataLines = [];\n      id = undefined;\n      retry = undefined;\n      commentLines = [];\n      return null;\n    }\n    const chunk: SSEvent = {};\n    if (eventName !== undefined) (chunk as { event?: string }).event = eventName;\n    if (dataLines.length > 0) (chunk as { data?: string }).data = dataLines.join(\"\\n\");\n    if (id !== undefined) (chunk as { id?: string }).id = id;\n    if (retry !== undefined) (chunk as { retry?: number }).retry = retry;\n    if (commentLines.length > 0) (chunk as { comment?: string }).comment = commentLines.join(\"\\n\");\n    eventName = undefined;\n    dataLines = [];\n    id = undefined;\n    retry = undefined;\n    commentLines = [];\n    hasField = false;\n    return chunk;\n  };\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: handleLine dispatches across all SSE field kinds per W3C spec — refactor candidate\n  const handleLine = (line: string): SSEvent | null => {\n    if (line === \"\") {\n      return dispatch();\n    }\n    if (line.startsWith(\":\")) {\n      // Comment line — per spec ignored, but we surface it for keepalive visibility.\n      commentLines.push(line.slice(1).replace(/^ /, \"\"));\n      hasField = true;\n      return null;\n    }\n    const colonIdx = line.indexOf(\":\");\n    let field: string;\n    let value: string;\n    if (colonIdx === -1) {\n      field = line;\n      value = \"\";\n    } else {\n      field = line.slice(0, colonIdx);\n      value = line.slice(colonIdx + 1);\n      // Strip ONE leading space if present (per spec § 9.2.6)\n      if (value.startsWith(\" \")) value = value.slice(1);\n    }\n    switch (field) {\n      case \"event\":\n        eventName = value;\n        hasField = true;\n        break;\n      case \"data\":\n        dataLines.push(value);\n        hasField = true;\n        break;\n      case \"id\":\n        // Per spec: id with NULL is ignored\n        if (!value.includes(\"\\0\")) {\n          id = value;\n          hasField = true;\n        }\n        break;\n      case \"retry\":\n        if (/^\\d+$/.test(value)) {\n          retry = Number.parseInt(value, 10);\n          hasField = true;\n        }\n        break;\n      default:\n        // Unknown field — ignored per spec\n        break;\n    }\n    return null;\n  };\n\n  for await (const bytes of source) {\n    // Normalize CRLF / CR to LF then split\n    buffer += decoder.decode(bytes, { stream: true }).replace(/\\r\\n|\\r/g, \"\\n\");\n    let idx: number;\n    // biome-ignore lint/suspicious/noAssignInExpressions: idiomatic while-assignment loop for buffered line parsing\n    while ((idx = buffer.indexOf(\"\\n\")) !== -1) {\n      const line = buffer.slice(0, idx);\n      buffer = buffer.slice(idx + 1);\n      const event = handleLine(line);\n      if (event !== null) yield event;\n    }\n  }\n  // Flush remaining buffer as a final line (no trailing newline case)\n  buffer += decoder.decode();\n  if (buffer.length > 0) {\n    const event = handleLine(buffer);\n    if (event !== null) yield event;\n  }\n  // Final dispatch in case last event lacked terminating blank line\n  const tail = dispatch();\n  if (tail !== null) yield tail;\n}\n","/**\n * @theokit/sdk — Subscription type contract (G8 v1.7.0).\n *\n * Per ADRs D423 (resume token opaque), D424 (transport selection),\n * D426 (defineSubscription DSL shape).\n *\n * @public\n */\n\nimport { TheokitAgentError } from \"../errors.js\";\n\n/**\n * Transport selection for subscriptions.\n *\n * - `'ws'`: WebSocket (bidirectional). Required for inbound client→server frames.\n *   v1.7 ships Node-canonical `ws` adapter; CF/Bun/Deno deferred to v1.8.x per ADR D425.\n * - `'sse'`: W3C Server-Sent Events (server→client only). Browser-native EventSource.\n * - `'auto'`: Prefer WS, fall back SSE on upgrade failure. Default.\n *\n * @public\n */\nexport type SubscriptionTransport = \"ws\" | \"sse\" | \"auto\";\n\n/**\n * Context passed to a subscription `handler` on each invocation.\n *\n * @public\n */\nexport interface SubscriptionCtx {\n  /**\n   * Opaque resume token forwarded by the client when reconnecting.\n   * Handler defines its own semantics (monotonic int, ULID, timestamp,\n   * encrypted cursor). SDK passes through unchanged. Per ADR D423.\n   */\n  readonly lastEventId?: string;\n\n  /**\n   * AbortSignal that fires when the subscription is cancelled\n   * (client disconnect, consumer abort, server shutdown).\n   * Handler MUST honor `signal.aborted` in long-running loops.\n   */\n  readonly signal: AbortSignal;\n\n  /**\n   * Stable identifier for the underlying transport connection.\n   * Different from the subscription name — one connection may host\n   * many subscriptions. Useful for logging / per-connection state.\n   */\n  readonly connectionId: string;\n\n  /**\n   * Force-close the underlying transport with optional WS close code + reason.\n   * Used by consumer code (e.g., auth middleware revoking a session) to\n   * terminate a subscription that should not continue.\n   */\n  disconnect(code?: number, reason?: string): void;\n\n  /**\n   * Helper to mint a tracked envelope `[id, payload]`.\n   * Yielding tracked envelopes lets the client advance `lastEventId`\n   * so reconnects can resume from that point.\n   */\n  tracked<TPayload>(id: string, payload: TPayload): TrackedEnvelope<TPayload>;\n}\n\n/**\n * Tracked envelope: `[id, payload]` tuple yielded by subscription handlers\n * to advertise the resume token associated with the payload.\n *\n * The encoder writes the `id` as an SSE `id:` field or WS payload metadata\n * so the client can echo it back on reconnect (`input.lastEventId`).\n *\n * Per ADR D423.\n *\n * @public\n */\nexport type TrackedEnvelope<T> = readonly [id: string, payload: T];\n\n/**\n * Type guard for {@link TrackedEnvelope}.\n *\n * @public\n */\nexport function isTrackedEnvelope(value: unknown): value is TrackedEnvelope<unknown> {\n  return Array.isArray(value) && value.length === 2 && typeof value[0] === \"string\";\n}\n\n/**\n * Mint a tracked envelope. Equivalent to `[id, payload] as const`,\n * exported as a function so consumers don't repeat the tuple cast.\n *\n * @public\n */\nexport function tracked<T>(id: string, payload: T): TrackedEnvelope<T> {\n  if (typeof id !== \"string\" || id.length === 0) {\n    throw new TypeError(\"tracked(): id must be a non-empty string\");\n  }\n  return [id, payload] as const;\n}\n\n/**\n * Base error for the subscription subsystem. Extends {@link TheokitAgentError}\n * so existing `instanceof TheokitAgentError` branches keep working.\n *\n * @public\n */\nexport class SubscriptionError extends TheokitAgentError {\n  override readonly name: string = \"SubscriptionError\";\n\n  constructor(message: string, options: { code?: string; cause?: unknown } = {}) {\n    super(message, { ...options, isRetryable: false });\n  }\n}\n\n/**\n * Thrown when subscription input fails Zod schema validation.\n *\n * @public\n */\nexport class SubscriptionInputError extends SubscriptionError {\n  override readonly name: string = \"SubscriptionInputError\";\n\n  readonly issues: unknown;\n\n  constructor(message: string, options: { issues: unknown; cause?: unknown }) {\n    super(message, { code: \"subscription_input_invalid\", cause: options.cause });\n    this.issues = options.issues;\n  }\n}\n\n/**\n * Thrown when a subscription transport disconnects unexpectedly\n * AND the client did not opt out of reconnect.\n *\n * @public\n */\nexport class SubscriptionDisconnectError extends SubscriptionError {\n  override readonly name: string = \"SubscriptionDisconnectError\";\n\n  readonly closeCode?: number;\n  readonly closeReason?: string;\n\n  constructor(\n    message: string,\n    options: { closeCode?: number; closeReason?: string; cause?: unknown } = {},\n  ) {\n    super(message, { code: \"subscription_disconnected\", cause: options.cause });\n    if (options.closeCode !== undefined) this.closeCode = options.closeCode;\n    if (options.closeReason !== undefined) this.closeReason = options.closeReason;\n  }\n}\n\n/**\n * Descriptor returned by {@link Subscription.create}. Carries the typed\n * input/output Zod schemas + handler factory.\n *\n * @public\n */\nexport interface SubscriptionDescriptor<TInput = unknown, TOutput = unknown> {\n  /** Optional explicit name; the runtime may also derive name from file path. */\n  readonly name?: string;\n  /** Zod schema for the subscription input. Validated at dispatch boundary. */\n  readonly input: ZodLike<TInput>;\n  /** Zod schema for each output frame (informational; not enforced per-frame). */\n  readonly output: ZodLike<TOutput>;\n  /** Async handler that yields output frames (or tracked envelopes). */\n  readonly handler: (\n    input: TInput,\n    ctx: SubscriptionCtx,\n  ) => AsyncGenerator<TOutput | TrackedEnvelope<TOutput>, void, void>;\n}\n\n/**\n * Minimal structural Zod type used to avoid hard peer-dep import.\n * Mirrors the surface used by other SDK modules (e.g., `define-tool.ts`).\n *\n * @internal\n */\nexport interface ZodLike<T> {\n  safeParse(value: unknown): { success: true; data: T } | { success: false; error: unknown };\n  parse(value: unknown): T;\n}\n","/**\n * @theokit/sdk — `Theokit.subscribe` client (G8 public API).\n *\n * Per ADR D427 (Theokit.subscribe namespace) + D424 (transport selection)\n * + D423 (lastEventId opaque propagation).\n *\n * Returns an AsyncGenerator that yields server-sent values. Transparent\n * reconnect with exponential backoff. Propagates `lastEventId` from the last\n * received tracked envelope on each reconnect attempt.\n *\n * @public\n */\n\nimport { parseSseW3C } from \"./internal/sse-parser.js\";\nimport type { WireFrame } from \"./internal/subscription-runtime.js\";\nimport {\n  SubscriptionDisconnectError,\n  SubscriptionError,\n  type SubscriptionTransport,\n} from \"./types.js\";\n\n/**\n * Options accepted by `Theokit.subscribe(name, input, opts?)`.\n *\n * @public\n */\nexport interface SubscribeOptions {\n  /** Base URL of the server (e.g., `\"http://localhost:3000\"`). Required. */\n  baseUrl: string;\n  /** Preferred transport. Default `\"auto\"` (WS preferred, SSE fallback). */\n  transport?: SubscriptionTransport;\n  /** Max reconnect attempts (default 10). 0 disables reconnect. */\n  maxReconnectAttempts?: number;\n  /** Backoff strategy. Default exponential `min(30_000, 1000 * 2^attempt)` ms. */\n  retryDelayMs?: (attempt: number) => number;\n  /** Caller-supplied abort signal. Cancels the subscription entirely. */\n  signal?: AbortSignal;\n  /** Additional fetch-style headers (e.g., `Authorization`). */\n  headers?: Record<string, string>;\n}\n\nconst defaultRetry = (attempt: number) => Math.min(30_000, 1000 * 2 ** attempt);\n\n/**\n * Subscribe to a typed subscription. Yields values produced by the server\n * handler. On disconnect with reconnect enabled, transparently re-establishes\n * the connection and forwards `lastEventId` from the last received tracked\n * envelope so the server handler can resume.\n *\n * @public\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: G8 subscribe orchestrates reconnect + transport switch + resume — refactor candidate tracked in subscription/theokit-subscribe.ts:52 followup\nexport async function* subscribe<TInput, TOutput>(\n  name: string,\n  input: TInput,\n  opts: SubscribeOptions,\n): AsyncGenerator<TOutput, void, void> {\n  if (typeof name !== \"string\" || name.length === 0) {\n    throw new SubscriptionError(\"Theokit.subscribe: name must be a non-empty string\", {\n      code: \"subscribe_name_invalid\",\n    });\n  }\n  if (opts === null || typeof opts !== \"object\" || typeof opts.baseUrl !== \"string\") {\n    throw new SubscriptionError(\"Theokit.subscribe: opts.baseUrl is required\", {\n      code: \"subscribe_baseUrl_missing\",\n    });\n  }\n  const transport = opts.transport ?? \"auto\";\n  const maxReconnects = opts.maxReconnectAttempts ?? 10;\n  const retry = opts.retryDelayMs ?? defaultRetry;\n\n  let lastEventId: string | undefined;\n  let attempt = 0;\n\n  while (true) {\n    if (opts.signal?.aborted) return;\n    try {\n      const inputWithCursor = mergeLastEventId(input, lastEventId);\n      const chosen = await selectTransport(transport, name, opts);\n      if (chosen === \"ws\") {\n        for await (const out of openWs<TOutput>(name, inputWithCursor, opts)) {\n          if (out.lastEventId !== undefined) lastEventId = out.lastEventId;\n          attempt = 0; // reset backoff on successful frame\n          yield out.value;\n        }\n      } else {\n        for await (const out of openSse<TOutput>(name, inputWithCursor, opts)) {\n          if (out.lastEventId !== undefined) lastEventId = out.lastEventId;\n          attempt = 0;\n          yield out.value;\n        }\n      }\n      // Clean end-of-stream — no reconnect.\n      return;\n    } catch (cause) {\n      if (opts.signal?.aborted) return;\n      if (maxReconnects === 0 || attempt >= maxReconnects) {\n        if (cause instanceof SubscriptionError) throw cause;\n        throw new SubscriptionDisconnectError(\n          `subscription \"${name}\" disconnected; reconnect exhausted`,\n          { cause },\n        );\n      }\n      const delay = retry(attempt);\n      attempt++;\n      await sleep(delay, opts.signal);\n    }\n  }\n}\n\ninterface FrameOut<T> {\n  readonly value: T;\n  readonly lastEventId?: string;\n}\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: openSse parses framed SSE stream with abort/error/retry branches — refactor candidate\nasync function* openSse<T>(\n  name: string,\n  input: unknown,\n  opts: SubscribeOptions,\n): AsyncIterable<FrameOut<T>> {\n  const url = `${stripTrailingSlash(opts.baseUrl)}/api/subscriptions/${encodeURIComponent(name)}?input=${encodeURIComponent(JSON.stringify(input))}`;\n  const res = await fetch(url, {\n    method: \"GET\",\n    headers: {\n      accept: \"text/event-stream\",\n      ...(opts.headers ?? {}),\n    },\n    ...(opts.signal !== undefined ? { signal: opts.signal } : {}),\n  });\n  if (!res.ok || res.body === null) {\n    throw new SubscriptionError(`SSE subscribe failed: HTTP ${res.status} ${res.statusText}`, {\n      code: \"sse_http_error\",\n    });\n  }\n  const events = parseSseW3C(streamToAsyncIterable(res.body));\n  for await (const ev of events) {\n    if (ev.event === \"end\") return;\n    if (ev.event === \"error\") {\n      throw new SubscriptionError(`SSE server emitted error: ${ev.data ?? \"(no body)\"}`, {\n        code: \"sse_server_error\",\n      });\n    }\n    if (ev.event === \"connected\") continue;\n    if (ev.data === undefined) continue;\n    const parsedValue = safeJsonParse<T>(ev.data);\n    if (parsedValue === undefined) continue;\n    yield {\n      value: parsedValue,\n      ...(ev.id !== undefined ? { lastEventId: ev.id } : {}),\n    };\n  }\n}\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: openWs orchestrates WS lifecycle + envelope decode + cleanup — refactor candidate\nasync function* openWs<T>(\n  name: string,\n  input: unknown,\n  opts: SubscribeOptions,\n): AsyncIterable<FrameOut<T>> {\n  const baseUrl = stripTrailingSlash(opts.baseUrl);\n  const wsUrl = baseUrl\n    .replace(/^http:/, \"ws:\")\n    .replace(/^https:/, \"wss:\")\n    .concat(\"/api/ws\");\n\n  const WS = (globalThis as { WebSocket?: typeof WebSocket }).WebSocket;\n  if (WS === undefined) {\n    throw new SubscriptionError(\n      \"Theokit.subscribe(transport='ws'): no global WebSocket available. Use Node >=22 or install 'ws' as a runtime dep + assign to globalThis.WebSocket.\",\n      { code: \"ws_global_missing\" },\n    );\n  }\n  const ws = new WS(wsUrl);\n\n  // Set up async iterator-like state.\n  const incoming: WireFrame[] = [];\n  // biome-ignore lint/suspicious/noConfusingVoidType: idiomatic event-callback signature; refactoring to undefined would mask the no-value semantics\n  let waiter: ((value: void) => void) | null = null;\n  let closed = false;\n  let closeError: Error | undefined;\n\n  ws.addEventListener(\"message\", (ev: MessageEvent) => {\n    const data = typeof ev.data === \"string\" ? ev.data : \"\";\n    const frame = safeJsonParse<WireFrame>(data);\n    if (frame !== undefined) {\n      incoming.push(frame);\n      if (waiter !== null) {\n        waiter();\n        waiter = null;\n      }\n    }\n  });\n  ws.addEventListener(\"close\", () => {\n    closed = true;\n    if (waiter !== null) {\n      waiter();\n      waiter = null;\n    }\n  });\n  ws.addEventListener(\"error\", () => {\n    closed = true;\n    closeError = new Error(\"WebSocket error\");\n    if (waiter !== null) {\n      waiter();\n      waiter = null;\n    }\n  });\n\n  await new Promise<void>((resolve, reject) => {\n    ws.addEventListener(\"open\", () => resolve(), { once: true });\n    ws.addEventListener(\"error\", () => reject(new Error(\"WS connect failed\")), { once: true });\n  });\n\n  // Send subscribe request after handshake.\n  ws.send(JSON.stringify({ kind: \"subscribe\", name, input }));\n\n  if (opts.signal !== undefined) {\n    opts.signal.addEventListener(\"abort\", () => ws.close(), { once: true });\n  }\n\n  try {\n    while (true) {\n      if (incoming.length === 0) {\n        if (closed) {\n          if (closeError !== undefined) throw closeError;\n          return;\n        }\n        await new Promise<void>((resolve) => {\n          waiter = resolve;\n        });\n        continue;\n      }\n      const frame = incoming.shift() as WireFrame;\n      if (frame.type === \"end\") return;\n      if (frame.type === \"error\") {\n        throw new SubscriptionError(\n          `WS server emitted error: ${frame.error?.message ?? \"(unknown)\"}`,\n          { code: \"ws_server_error\" },\n        );\n      }\n      const value = frame.data as T;\n      yield {\n        value,\n        ...(frame.id !== undefined ? { lastEventId: frame.id } : {}),\n      };\n    }\n  } finally {\n    try {\n      ws.close();\n    } catch {\n      /* ignore */\n    }\n  }\n}\n\nasync function selectTransport(\n  pref: SubscriptionTransport,\n  _name: string,\n  _opts: SubscribeOptions,\n): Promise<\"ws\" | \"sse\"> {\n  if (pref === \"ws\") return \"ws\";\n  if (pref === \"sse\") return \"sse\";\n  // auto — prefer WS if available, else SSE.\n  if (typeof (globalThis as { WebSocket?: unknown }).WebSocket === \"function\") {\n    return \"ws\";\n  }\n  return \"sse\";\n}\n\nfunction mergeLastEventId(input: unknown, lastEventId: string | undefined): unknown {\n  if (lastEventId === undefined) return input;\n  if (input === null || typeof input !== \"object\" || Array.isArray(input)) {\n    // Cannot merge into primitive — return as-is.\n    return input;\n  }\n  return { ...(input as object), lastEventId };\n}\n\nfunction stripTrailingSlash(s: string): string {\n  return s.endsWith(\"/\") ? s.slice(0, -1) : s;\n}\n\nfunction safeJsonParse<T>(s: string): T | undefined {\n  try {\n    return JSON.parse(s) as T;\n  } catch {\n    return undefined;\n  }\n}\n\nasync function* streamToAsyncIterable(\n  stream: ReadableStream<Uint8Array>,\n): AsyncIterable<Uint8Array> {\n  const reader = stream.getReader();\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) return;\n      if (value !== undefined) yield value;\n    }\n  } finally {\n    reader.releaseLock();\n  }\n}\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new Error(\"aborted\"));\n      return;\n    }\n    const t = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n    const onAbort = () => {\n      clearTimeout(t);\n      reject(new Error(\"aborted\"));\n    };\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n"]}
+{"version":3,"sources":["../../src/subscription/define-subscription.ts","../../src/subscription/internal/sse-parser.ts","../../src/subscription/types.ts","../../src/subscription/theokit-subscribe.ts"],"names":["TheokitAgentError"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * `defineSubscription` DSL (G8 public API) — `@theokit/sdk`.\n *\n * Per ADR D426 (AsyncGenerator handler + Zod input/output schemas).\n *\n * @public\n */\n\nimport type { SubscriptionCtx, SubscriptionDescriptor, TrackedEnvelope, ZodLike } from \"./types.js\";\n\n/**\n * Options accepted by {@link defineSubscription}.\n *\n * @public\n */\nexport interface DefineSubscriptionOptions<TInput, TOutput> {\n  /** Optional explicit name. Falls back to filename derivation by the scanner. */\n  name?: string;\n  /** Zod schema validating subscription input. Required (typed RPC contract). */\n  input: ZodLike<TInput>;\n  /** Zod schema describing each output frame. Informational; not enforced per-frame. */\n  output: ZodLike<TOutput>;\n  /**\n   * Handler that produces the subscription stream.\n   *\n   * Receives the validated input + {@link SubscriptionCtx}. Yielding a value\n   * emits a plain output frame. Yielding a `tracked(id, payload)` envelope\n   * additionally advertises a resume token to the client so reconnects can\n   * resume from that point.\n   */\n  handler: (\n    input: TInput,\n    ctx: SubscriptionCtx,\n  ) => AsyncGenerator<TOutput | TrackedEnvelope<TOutput>, void, void>;\n}\n\n/**\n * Define a typed subscription. Pair with `Theokit.subscribe(name, input)`\n * on the client side.\n *\n * Per ADR D426 — handler is `AsyncGenerator<TOutput | TrackedEnvelope<TOutput>>`.\n * The runtime validates input via `opts.input.safeParse` BEFORE invoking the\n * handler; failure throws {@link import('./types.js').SubscriptionInputError}.\n *\n * @example\n * ```ts\n * import { Subscription } from \"@theokit/sdk/subscription\";\n * import { z } from \"zod\";\n *\n * export default Subscription.create({\n *   input: z.object({ topic: z.string() }),\n *   output: z.object({ message: z.string(), ts: z.number() }),\n *   async *handler(input, ctx) {\n *     let cursor = ctx.lastEventId ?? \"0\";\n *     while (!ctx.signal.aborted) {\n *       const msgs = await fetchMessagesSince(input.topic, cursor);\n *       for (const m of msgs) {\n *         cursor = m.id;\n *         yield ctx.tracked(m.id, { message: m.body, ts: m.ts });\n *       }\n *       await sleep(1000);\n *     }\n *   },\n * });\n * ```\n *\n * @public\n */\nexport function defineSubscription<TInput, TOutput>(\n  opts: DefineSubscriptionOptions<TInput, TOutput>,\n): SubscriptionDescriptor<TInput, TOutput> {\n  if (opts === null || typeof opts !== \"object\") {\n    throw new TypeError(\"defineSubscription: options object is required\");\n  }\n  if (opts.input === undefined || typeof opts.input.safeParse !== \"function\") {\n    throw new TypeError(\"defineSubscription: opts.input must be a Zod schema (or ZodLike)\");\n  }\n  if (opts.output === undefined || typeof opts.output.safeParse !== \"function\") {\n    throw new TypeError(\"defineSubscription: opts.output must be a Zod schema (or ZodLike)\");\n  }\n  if (typeof opts.handler !== \"function\") {\n    throw new TypeError(\"defineSubscription: opts.handler must be an async generator function\");\n  }\n  return {\n    ...(opts.name !== undefined ? { name: opts.name } : {}),\n    input: opts.input,\n    output: opts.output,\n    handler: opts.handler,\n  };\n}\n\n/** SE36 — `Subscription.create` replaces `defineSubscription` (ADR 0015). @public */\nexport class Subscription {\n  private constructor() {}\n  static create<TInput, TOutput>(\n    opts: DefineSubscriptionOptions<TInput, TOutput>,\n  ): SubscriptionDescriptor<TInput, TOutput> {\n    return defineSubscription(opts);\n  }\n}\n","/**\n * W3C SSE parser (G8 internal) — `@theokit/sdk`.\n *\n * Per ADR D428. Reads from `ReadableStream<Uint8Array>` or async iterable of\n * UTF-8 chunks; yields parsed {@link SSEvent} objects per W3C SSE spec.\n *\n * Independent of `internal/llm/sse.ts:parseSseStream` (LLM-specific a peer vendor AI\n * Data Stream v1; locked by D38). This parser handles the `id:` field needed\n * for tracked envelopes (G8 resume mechanism), which the LLM parser ignores.\n *\n * Reference: https://html.spec.whatwg.org/multipage/server-sent-events.html\n *\n * @internal\n */\n\nimport type { SSEvent } from \"./sse-encoder.js\";\n\nconst decoder = new TextDecoder(\"utf-8\");\n\n/**\n * Parse an async iterable of UTF-8 byte chunks into a stream of SSE events.\n *\n * Implements the W3C event stream parser:\n * - Lines are split by `\\n`, `\\r\\n`, or `\\r`\n * - Events are dispatched on blank line (no `:` and no field name)\n * - Fields: `event`, `data` (multi-line concat with `\\n`), `id`, `retry`\n * - Lines starting with `:` are comments (ignored, except dispatched as `comment`)\n * - Unknown fields silently ignored per spec\n *\n * Empty events (no fields) are NOT dispatched per spec.\n *\n * @internal\n */\nexport async function* parseSseW3C(\n  source: AsyncIterable<Uint8Array>,\n): AsyncGenerator<SSEvent, void, void> {\n  let buffer = \"\";\n  let eventName: string | undefined;\n  let dataLines: string[] = [];\n  let id: string | undefined;\n  let retry: number | undefined;\n  let commentLines: string[] = [];\n  let hasField = false;\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: dispatch builds SSEvent from per-field state per W3C spec — refactor candidate\n  const dispatch = (): SSEvent | null => {\n    if (!hasField) {\n      // Blank line with no preceding fields → reset state, no dispatch (per spec § 9.2.6)\n      eventName = undefined;\n      dataLines = [];\n      id = undefined;\n      retry = undefined;\n      commentLines = [];\n      return null;\n    }\n    const chunk: SSEvent = {};\n    if (eventName !== undefined) (chunk as { event?: string }).event = eventName;\n    if (dataLines.length > 0) (chunk as { data?: string }).data = dataLines.join(\"\\n\");\n    if (id !== undefined) (chunk as { id?: string }).id = id;\n    if (retry !== undefined) (chunk as { retry?: number }).retry = retry;\n    if (commentLines.length > 0) (chunk as { comment?: string }).comment = commentLines.join(\"\\n\");\n    eventName = undefined;\n    dataLines = [];\n    id = undefined;\n    retry = undefined;\n    commentLines = [];\n    hasField = false;\n    return chunk;\n  };\n\n  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: handleLine dispatches across all SSE field kinds per W3C spec — refactor candidate\n  const handleLine = (line: string): SSEvent | null => {\n    if (line === \"\") {\n      return dispatch();\n    }\n    if (line.startsWith(\":\")) {\n      // Comment line — per spec ignored, but we surface it for keepalive visibility.\n      commentLines.push(line.slice(1).replace(/^ /, \"\"));\n      hasField = true;\n      return null;\n    }\n    const colonIdx = line.indexOf(\":\");\n    let field: string;\n    let value: string;\n    if (colonIdx === -1) {\n      field = line;\n      value = \"\";\n    } else {\n      field = line.slice(0, colonIdx);\n      value = line.slice(colonIdx + 1);\n      // Strip ONE leading space if present (per spec § 9.2.6)\n      if (value.startsWith(\" \")) value = value.slice(1);\n    }\n    switch (field) {\n      case \"event\":\n        eventName = value;\n        hasField = true;\n        break;\n      case \"data\":\n        dataLines.push(value);\n        hasField = true;\n        break;\n      case \"id\":\n        // Per spec: id with NULL is ignored\n        if (!value.includes(\"\\0\")) {\n          id = value;\n          hasField = true;\n        }\n        break;\n      case \"retry\":\n        if (/^\\d+$/.test(value)) {\n          retry = Number.parseInt(value, 10);\n          hasField = true;\n        }\n        break;\n      default:\n        // Unknown field — ignored per spec\n        break;\n    }\n    return null;\n  };\n\n  for await (const bytes of source) {\n    // Normalize CRLF / CR to LF then split\n    buffer += decoder.decode(bytes, { stream: true }).replace(/\\r\\n|\\r/g, \"\\n\");\n    let idx: number;\n    // biome-ignore lint/suspicious/noAssignInExpressions: idiomatic while-assignment loop for buffered line parsing\n    while ((idx = buffer.indexOf(\"\\n\")) !== -1) {\n      const line = buffer.slice(0, idx);\n      buffer = buffer.slice(idx + 1);\n      const event = handleLine(line);\n      if (event !== null) yield event;\n    }\n  }\n  // Flush remaining buffer as a final line (no trailing newline case)\n  buffer += decoder.decode();\n  if (buffer.length > 0) {\n    const event = handleLine(buffer);\n    if (event !== null) yield event;\n  }\n  // Final dispatch in case last event lacked terminating blank line\n  const tail = dispatch();\n  if (tail !== null) yield tail;\n}\n","/**\n * Subscription type contract (G8 v1.7.0) — `@theokit/sdk`.\n *\n * Per ADRs D423 (resume token opaque), D424 (transport selection),\n * D426 (defineSubscription DSL shape).\n *\n * @public\n */\n\nimport { TheokitAgentError } from \"../errors.js\";\n\n/**\n * Transport selection for subscriptions.\n *\n * - `'ws'`: WebSocket (bidirectional). Required for inbound client→server frames.\n *   v1.7 ships Node-canonical `ws` adapter; CF/Bun/Deno deferred to v1.8.x per ADR D425.\n * - `'sse'`: W3C Server-Sent Events (server→client only). Browser-native EventSource.\n * - `'auto'`: Prefer WS, fall back SSE on upgrade failure. Default.\n *\n * @public\n */\nexport type SubscriptionTransport = \"ws\" | \"sse\" | \"auto\";\n\n/**\n * Context passed to a subscription `handler` on each invocation.\n *\n * @public\n */\nexport interface SubscriptionCtx {\n  /**\n   * Opaque resume token forwarded by the client when reconnecting.\n   * Handler defines its own semantics (monotonic int, ULID, timestamp,\n   * encrypted cursor). SDK passes through unchanged. Per ADR D423.\n   */\n  readonly lastEventId?: string;\n\n  /**\n   * AbortSignal that fires when the subscription is cancelled\n   * (client disconnect, consumer abort, server shutdown).\n   * Handler MUST honor `signal.aborted` in long-running loops.\n   */\n  readonly signal: AbortSignal;\n\n  /**\n   * Stable identifier for the underlying transport connection.\n   * Different from the subscription name — one connection may host\n   * many subscriptions. Useful for logging / per-connection state.\n   */\n  readonly connectionId: string;\n\n  /**\n   * Force-close the underlying transport with optional WS close code + reason.\n   * Used by consumer code (e.g., auth middleware revoking a session) to\n   * terminate a subscription that should not continue.\n   */\n  disconnect(code?: number, reason?: string): void;\n\n  /**\n   * Helper to mint a tracked envelope `[id, payload]`.\n   * Yielding tracked envelopes lets the client advance `lastEventId`\n   * so reconnects can resume from that point.\n   */\n  tracked<TPayload>(id: string, payload: TPayload): TrackedEnvelope<TPayload>;\n}\n\n/**\n * Tracked envelope: `[id, payload]` tuple yielded by subscription handlers\n * to advertise the resume token associated with the payload.\n *\n * The encoder writes the `id` as an SSE `id:` field or WS payload metadata\n * so the client can echo it back on reconnect (`input.lastEventId`).\n *\n * Per ADR D423.\n *\n * @public\n */\nexport type TrackedEnvelope<T> = readonly [id: string, payload: T];\n\n/**\n * Type guard for {@link TrackedEnvelope}.\n *\n * @public\n */\nexport function isTrackedEnvelope(value: unknown): value is TrackedEnvelope<unknown> {\n  return Array.isArray(value) && value.length === 2 && typeof value[0] === \"string\";\n}\n\n/**\n * Mint a tracked envelope. Equivalent to `[id, payload] as const`,\n * exported as a function so consumers don't repeat the tuple cast.\n *\n * @public\n */\nexport function tracked<T>(id: string, payload: T): TrackedEnvelope<T> {\n  if (typeof id !== \"string\" || id.length === 0) {\n    throw new TypeError(\"tracked(): id must be a non-empty string\");\n  }\n  return [id, payload] as const;\n}\n\n/**\n * Base error for the subscription subsystem. Extends {@link TheokitAgentError}\n * so existing `instanceof TheokitAgentError` branches keep working.\n *\n * @public\n */\nexport class SubscriptionError extends TheokitAgentError {\n  override readonly name: string = \"SubscriptionError\";\n\n  constructor(message: string, options: { code?: string; cause?: unknown } = {}) {\n    super(message, { ...options, isRetryable: false });\n  }\n}\n\n/**\n * Thrown when subscription input fails Zod schema validation.\n *\n * @public\n */\nexport class SubscriptionInputError extends SubscriptionError {\n  override readonly name: string = \"SubscriptionInputError\";\n\n  readonly issues: unknown;\n\n  constructor(message: string, options: { issues: unknown; cause?: unknown }) {\n    super(message, { code: \"subscription_input_invalid\", cause: options.cause });\n    this.issues = options.issues;\n  }\n}\n\n/**\n * Thrown when a subscription transport disconnects unexpectedly\n * AND the client did not opt out of reconnect.\n *\n * @public\n */\nexport class SubscriptionDisconnectError extends SubscriptionError {\n  override readonly name: string = \"SubscriptionDisconnectError\";\n\n  readonly closeCode?: number;\n  readonly closeReason?: string;\n\n  constructor(\n    message: string,\n    options: { closeCode?: number; closeReason?: string; cause?: unknown } = {},\n  ) {\n    super(message, { code: \"subscription_disconnected\", cause: options.cause });\n    if (options.closeCode !== undefined) this.closeCode = options.closeCode;\n    if (options.closeReason !== undefined) this.closeReason = options.closeReason;\n  }\n}\n\n/**\n * Descriptor returned by {@link Subscription.create}. Carries the typed\n * input/output Zod schemas + handler factory.\n *\n * @public\n */\nexport interface SubscriptionDescriptor<TInput = unknown, TOutput = unknown> {\n  /** Optional explicit name; the runtime may also derive name from file path. */\n  readonly name?: string;\n  /** Zod schema for the subscription input. Validated at dispatch boundary. */\n  readonly input: ZodLike<TInput>;\n  /** Zod schema for each output frame (informational; not enforced per-frame). */\n  readonly output: ZodLike<TOutput>;\n  /** Async handler that yields output frames (or tracked envelopes). */\n  readonly handler: (\n    input: TInput,\n    ctx: SubscriptionCtx,\n  ) => AsyncGenerator<TOutput | TrackedEnvelope<TOutput>, void, void>;\n}\n\n/**\n * Minimal structural Zod type used to avoid hard peer-dep import.\n * Mirrors the surface used by other SDK modules (e.g., `define-tool.ts`).\n *\n * Emitted rather than erased: it appears in the signature of `defineSubscription`, which\n * `@theokit/sdk/subscription` publishes, so a consumer's type-aware lint has to be able to\n * resolve it.\n */\nexport interface ZodLike<T> {\n  safeParse(value: unknown): { success: true; data: T } | { success: false; error: unknown };\n  parse(value: unknown): T;\n}\n","/**\n * `Theokit.subscribe` client (G8 public API) — `@theokit/sdk`.\n *\n * Per ADR D427 (Theokit.subscribe namespace) + D424 (transport selection)\n * + D423 (lastEventId opaque propagation).\n *\n * Returns an AsyncGenerator that yields server-sent values. Transparent\n * reconnect with exponential backoff. Propagates `lastEventId` from the last\n * received tracked envelope on each reconnect attempt.\n *\n * @public\n */\n\nimport { parseSseW3C } from \"./internal/sse-parser.js\";\nimport type { WireFrame } from \"./internal/subscription-runtime.js\";\nimport {\n  SubscriptionDisconnectError,\n  SubscriptionError,\n  type SubscriptionTransport,\n} from \"./types.js\";\n\n/**\n * Options accepted by `Theokit.subscribe(name, input, opts?)`.\n *\n * @public\n */\nexport interface SubscribeOptions {\n  /** Base URL of the server (e.g., `\"http://localhost:3000\"`). Required. */\n  baseUrl: string;\n  /** Preferred transport. Default `\"auto\"` (WS preferred, SSE fallback). */\n  transport?: SubscriptionTransport;\n  /** Max reconnect attempts (default 10). 0 disables reconnect. */\n  maxReconnectAttempts?: number;\n  /** Backoff strategy. Default exponential `min(30_000, 1000 * 2^attempt)` ms. */\n  retryDelayMs?: (attempt: number) => number;\n  /** Caller-supplied abort signal. Cancels the subscription entirely. */\n  signal?: AbortSignal;\n  /** Additional fetch-style headers (e.g., `Authorization`). */\n  headers?: Record<string, string>;\n  /**\n   * Override the SSE transport's `fetch`. Defaults to `globalThis.fetch`.\n   * Lets a consumer supply a proxying agent or instrumented fetch without\n   * mutating the runtime global.\n   */\n  fetch?: typeof globalThis.fetch;\n  /**\n   * Override the WS transport's `WebSocket` constructor. Defaults to\n   * `globalThis.WebSocket`. Lets a consumer polyfill WS on a runtime that\n   * lacks it, or supply an instrumented implementation, without mutating\n   * the runtime global.\n   */\n  WebSocket?: typeof WebSocket;\n}\n\nconst defaultRetry = (attempt: number) => Math.min(30_000, 1000 * 2 ** attempt);\n\n/**\n * Subscribe to a typed subscription. Yields values produced by the server\n * handler. On disconnect with reconnect enabled, transparently re-establishes\n * the connection and forwards `lastEventId` from the last received tracked\n * envelope so the server handler can resume.\n *\n * @public\n */\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: G8 subscribe orchestrates reconnect + transport switch + resume — refactor candidate tracked in subscription/theokit-subscribe.ts:52 followup\nexport async function* subscribe<TInput, TOutput>(\n  name: string,\n  input: TInput,\n  opts: SubscribeOptions,\n): AsyncGenerator<TOutput, void, void> {\n  if (typeof name !== \"string\" || name.length === 0) {\n    throw new SubscriptionError(\"Theokit.subscribe: name must be a non-empty string\", {\n      code: \"subscribe_name_invalid\",\n    });\n  }\n  if (opts === null || typeof opts !== \"object\" || typeof opts.baseUrl !== \"string\") {\n    throw new SubscriptionError(\"Theokit.subscribe: opts.baseUrl is required\", {\n      code: \"subscribe_baseUrl_missing\",\n    });\n  }\n  const transport = opts.transport ?? \"auto\";\n  const maxReconnects = opts.maxReconnectAttempts ?? 10;\n  const retry = opts.retryDelayMs ?? defaultRetry;\n\n  let lastEventId: string | undefined;\n  let attempt = 0;\n\n  while (true) {\n    if (opts.signal?.aborted) return;\n    try {\n      const inputWithCursor = mergeLastEventId(input, lastEventId);\n      const chosen = await selectTransport(transport, name, opts);\n      if (chosen === \"ws\") {\n        for await (const out of openWs<TOutput>(name, inputWithCursor, opts)) {\n          if (out.lastEventId !== undefined) lastEventId = out.lastEventId;\n          attempt = 0; // reset backoff on successful frame\n          yield out.value;\n        }\n      } else {\n        for await (const out of openSse<TOutput>(name, inputWithCursor, opts)) {\n          if (out.lastEventId !== undefined) lastEventId = out.lastEventId;\n          attempt = 0;\n          yield out.value;\n        }\n      }\n      // Clean end-of-stream — no reconnect.\n      return;\n    } catch (cause) {\n      if (opts.signal?.aborted) return;\n      if (maxReconnects === 0 || attempt >= maxReconnects) {\n        if (cause instanceof SubscriptionError) throw cause;\n        throw new SubscriptionDisconnectError(\n          `subscription \"${name}\" disconnected; reconnect exhausted`,\n          { cause },\n        );\n      }\n      const delay = retry(attempt);\n      attempt++;\n      await sleep(delay, opts.signal);\n    }\n  }\n}\n\ninterface FrameOut<T> {\n  readonly value: T;\n  readonly lastEventId?: string;\n}\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: openSse parses framed SSE stream with abort/error/retry branches — refactor candidate\nasync function* openSse<T>(\n  name: string,\n  input: unknown,\n  opts: SubscribeOptions,\n): AsyncIterable<FrameOut<T>> {\n  const url = `${stripTrailingSlash(opts.baseUrl)}/api/subscriptions/${encodeURIComponent(name)}?input=${encodeURIComponent(JSON.stringify(input))}`;\n  const fetchFn = opts.fetch ?? globalThis.fetch;\n  const res = await fetchFn(url, {\n    method: \"GET\",\n    headers: {\n      accept: \"text/event-stream\",\n      ...(opts.headers ?? {}),\n    },\n    ...(opts.signal !== undefined ? { signal: opts.signal } : {}),\n  });\n  if (!res.ok || res.body === null) {\n    throw new SubscriptionError(`SSE subscribe failed: HTTP ${res.status} ${res.statusText}`, {\n      code: \"sse_http_error\",\n    });\n  }\n  const events = parseSseW3C(streamToAsyncIterable(res.body));\n  for await (const ev of events) {\n    if (ev.event === \"end\") return;\n    if (ev.event === \"error\") {\n      throw new SubscriptionError(`SSE server emitted error: ${ev.data ?? \"(no body)\"}`, {\n        code: \"sse_server_error\",\n      });\n    }\n    if (ev.event === \"connected\") continue;\n    if (ev.data === undefined) continue;\n    const parsedValue = safeJsonParse<T>(ev.data);\n    if (parsedValue === undefined) continue;\n    yield {\n      value: parsedValue,\n      ...(ev.id !== undefined ? { lastEventId: ev.id } : {}),\n    };\n  }\n}\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: openWs orchestrates WS lifecycle + envelope decode + cleanup — refactor candidate\nasync function* openWs<T>(\n  name: string,\n  input: unknown,\n  opts: SubscribeOptions,\n): AsyncIterable<FrameOut<T>> {\n  const baseUrl = stripTrailingSlash(opts.baseUrl);\n  const wsUrl = baseUrl\n    .replace(/^http:/, \"ws:\")\n    .replace(/^https:/, \"wss:\")\n    .concat(\"/api/ws\");\n\n  const WS = opts.WebSocket ?? (globalThis as { WebSocket?: typeof WebSocket }).WebSocket;\n  if (WS === undefined) {\n    throw new SubscriptionError(\n      \"Theokit.subscribe(transport='ws'): no global WebSocket available. Use Node >=22 or install 'ws' as a runtime dep + assign to globalThis.WebSocket, or pass opts.WebSocket.\",\n      { code: \"ws_global_missing\" },\n    );\n  }\n  const ws = new WS(wsUrl);\n\n  // Set up async iterator-like state.\n  const incoming: WireFrame[] = [];\n  // biome-ignore lint/suspicious/noConfusingVoidType: idiomatic event-callback signature; refactoring to undefined would mask the no-value semantics\n  let waiter: ((value: void) => void) | null = null;\n  let closed = false;\n  let closeError: Error | undefined;\n\n  ws.addEventListener(\"message\", (ev: MessageEvent) => {\n    const data = typeof ev.data === \"string\" ? ev.data : \"\";\n    const frame = safeJsonParse<WireFrame>(data);\n    if (frame !== undefined) {\n      incoming.push(frame);\n      if (waiter !== null) {\n        waiter();\n        waiter = null;\n      }\n    }\n  });\n  ws.addEventListener(\"close\", () => {\n    closed = true;\n    if (waiter !== null) {\n      waiter();\n      waiter = null;\n    }\n  });\n  ws.addEventListener(\"error\", () => {\n    closed = true;\n    closeError = new Error(\"WebSocket error\");\n    if (waiter !== null) {\n      waiter();\n      waiter = null;\n    }\n  });\n\n  await new Promise<void>((resolve, reject) => {\n    ws.addEventListener(\"open\", () => resolve(), { once: true });\n    ws.addEventListener(\"error\", () => reject(new Error(\"WS connect failed\")), { once: true });\n  });\n\n  // Send subscribe request after handshake.\n  ws.send(JSON.stringify({ kind: \"subscribe\", name, input }));\n\n  if (opts.signal !== undefined) {\n    opts.signal.addEventListener(\"abort\", () => ws.close(), { once: true });\n  }\n\n  try {\n    while (true) {\n      if (incoming.length === 0) {\n        if (closed) {\n          if (closeError !== undefined) throw closeError;\n          return;\n        }\n        await new Promise<void>((resolve) => {\n          waiter = resolve;\n        });\n        continue;\n      }\n      const frame = incoming.shift() as WireFrame;\n      if (frame.type === \"end\") return;\n      if (frame.type === \"error\") {\n        throw new SubscriptionError(\n          `WS server emitted error: ${frame.error?.message ?? \"(unknown)\"}`,\n          { code: \"ws_server_error\" },\n        );\n      }\n      const value = frame.data as T;\n      yield {\n        value,\n        ...(frame.id !== undefined ? { lastEventId: frame.id } : {}),\n      };\n    }\n  } finally {\n    try {\n      ws.close();\n    } catch {\n      /* ignore */\n    }\n  }\n}\n\nasync function selectTransport(\n  pref: SubscriptionTransport,\n  _name: string,\n  opts: SubscribeOptions,\n): Promise<\"ws\" | \"sse\"> {\n  if (pref === \"ws\") return \"ws\";\n  if (pref === \"sse\") return \"sse\";\n  // auto — prefer WS if available (injected or global), else SSE.\n  const WS = opts.WebSocket ?? (globalThis as { WebSocket?: unknown }).WebSocket;\n  if (typeof WS === \"function\") {\n    return \"ws\";\n  }\n  return \"sse\";\n}\n\nfunction mergeLastEventId(input: unknown, lastEventId: string | undefined): unknown {\n  if (lastEventId === undefined) return input;\n  if (input === null || typeof input !== \"object\" || Array.isArray(input)) {\n    // Cannot merge into primitive — return as-is.\n    return input;\n  }\n  return { ...(input as object), lastEventId };\n}\n\nfunction stripTrailingSlash(s: string): string {\n  return s.endsWith(\"/\") ? s.slice(0, -1) : s;\n}\n\nfunction safeJsonParse<T>(s: string): T | undefined {\n  try {\n    return JSON.parse(s) as T;\n  } catch {\n    return undefined;\n  }\n}\n\nasync function* streamToAsyncIterable(\n  stream: ReadableStream<Uint8Array>,\n): AsyncIterable<Uint8Array> {\n  const reader = stream.getReader();\n  let finishedNaturally = false;\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) {\n        finishedNaturally = true;\n        return;\n      }\n      if (value !== undefined) yield value;\n    }\n  } finally {\n    // B-131: `releaseLock()` alone detaches the reader WITHOUT canceling the stream (WHATWG\n    // Streams spec) — the underlying `fetch` response body, and its socket, stays open until\n    // something else cancels it or reads it to completion. A consumer that breaks out of the\n    // subscription mid-stream (the ordinary shape: `for await ... break`) used to leave that\n    // connection dangling. `cancel()` is a no-op once the stream is already closed, so it is safe\n    // to call unconditionally on the early-exit path; skip it on natural completion, where the\n    // stream is already done and canceling only risks surfacing a spurious rejection.\n    if (!finishedNaturally) {\n      try {\n        await reader.cancel();\n      } catch {\n        /* best-effort cleanup — the caller's own error (if any) already takes precedence */\n      }\n    }\n    reader.releaseLock();\n  }\n}\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) {\n      reject(new Error(\"aborted\"));\n      return;\n    }\n    const t = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n    const onAbort = () => {\n      clearTimeout(t);\n      reject(new Error(\"aborted\"));\n    };\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n"]}

package/dist/subscription/index.d.cts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — Subscription public barrel (G8 v1.7.0).
+ * Subscription public barrel (G8 v1.7.0) — `@theokit/sdk`.
  *
  * Per ADRs D422-D429 (Form 4 Hybrid + DSL + transport + resume).
  *

package/dist/subscription/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @theokit/sdk — Subscription public barrel (G8 v1.7.0).
+ * Subscription public barrel (G8 v1.7.0) — `@theokit/sdk`.
  *
  * Per ADRs D422-D429 (Form 4 Hybrid + DSL + transport + resume).
  *

package/dist/subscription/index.js

@@ -1,5 +1,6 @@
-import { TheokitAgentError } from '../chunk-HI4ZW62S.js';
-import '../chunk-4X3SBHPK.js';
+import { TheokitAgentError } from '../chunk-IDCKSLYH.js';
+import '../chunk-T7XEKOVW.js';
+import '../chunk-T7O6K6PX.js';
 
 // src/subscription/define-subscription.ts
 function defineSubscription(opts) {
@@ -215,7 +216,8 @@ async function* subscribe(name, input, opts) {
 }
 async function* openSse(name, input, opts) {
   const url = `${stripTrailingSlash(opts.baseUrl)}/api/subscriptions/${encodeURIComponent(name)}?input=${encodeURIComponent(JSON.stringify(input))}`;
-  const res = await fetch(url, {
+  const fetchFn = opts.fetch ?? globalThis.fetch;
+  const res = await fetchFn(url, {
     method: "GET",
     headers: {
       accept: "text/event-stream",
@@ -249,10 +251,10 @@ async function* openSse(name, input, opts) {
 async function* openWs(name, input, opts) {
   const baseUrl = stripTrailingSlash(opts.baseUrl);
   const wsUrl = baseUrl.replace(/^http:/, "ws:").replace(/^https:/, "wss:").concat("/api/ws");
-  const WS = globalThis.WebSocket;
+  const WS = opts.WebSocket ?? globalThis.WebSocket;
   if (WS === void 0) {
     throw new SubscriptionError(
-      "Theokit.subscribe(transport='ws'): no global WebSocket available. Use Node >=22 or install 'ws' as a runtime dep + assign to globalThis.WebSocket.",
+      "Theokit.subscribe(transport='ws'): no global WebSocket available. Use Node >=22 or install 'ws' as a runtime dep + assign to globalThis.WebSocket, or pass opts.WebSocket.",
       { code: "ws_global_missing" }
     );
   }
@@ -328,10 +330,11 @@ async function* openWs(name, input, opts) {
     }
   }
 }
-async function selectTransport(pref, _name, _opts) {
+async function selectTransport(pref, _name, opts) {
   if (pref === "ws") return "ws";
   if (pref === "sse") return "sse";
-  if (typeof globalThis.WebSocket === "function") {
+  const WS = opts.WebSocket ?? globalThis.WebSocket;
+  if (typeof WS === "function") {
     return "ws";
   }
   return "sse";
@@ -355,13 +358,23 @@ function safeJsonParse(s) {
 }
 async function* streamToAsyncIterable(stream) {
   const reader = stream.getReader();
+  let finishedNaturally = false;
   try {
     while (true) {
       const { done, value } = await reader.read();
-      if (done) return;
+      if (done) {
+        finishedNaturally = true;
+        return;
+      }
       if (value !== void 0) yield value;
     }
   } finally {
+    if (!finishedNaturally) {
+      try {
+        await reader.cancel();
+      } catch {
+      }
+    }
     reader.releaseLock();
   }
 }