@theokit/sdk 2.20.0 → 2.21.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theokit/sdk",
-  "version": "2.20.0",
+  "version": "2.21.0",
   "description": "TypeScript SDK for the Theo agent harness — same surface, local or cloud.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/usetheo/theokit-sdk#readme",
@@ -228,26 +228,6 @@
         "default": "./dist/internal/persistence/index.cjs"
       }
     },
-    "./internal/plugins": {
-      "import": {
-        "types": "./dist/internal/plugins/index.d.ts",
-        "default": "./dist/internal/plugins/index.js"
-      },
-      "require": {
-        "types": "./dist/internal/plugins/index.d.cts",
-        "default": "./dist/internal/plugins/index.cjs"
-      }
-    },
-    "./internal/observability": {
-      "import": {
-        "types": "./dist/internal/observability/index.d.ts",
-        "default": "./dist/internal/observability/index.js"
-      },
-      "require": {
-        "types": "./dist/internal/observability/index.d.cts",
-        "default": "./dist/internal/observability/index.cjs"
-      }
-    },
     "./internal/security": {
       "import": {
         "types": "./dist/internal/security/index.d.ts",
@@ -308,15 +288,6 @@
     "**/agent.js",
     "**/agent.cjs"
   ],
-  "scripts": {
-    "build": "tsup && cp src/internal/providers/provider-catalog.json dist/provider-catalog.json",
-    "test": "vitest run --no-file-parallelism",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist",
-    "docs:json": "typedoc --options typedoc.json",
-    "docs:drift": "tsx scripts/check-docs-drift.ts"
-  },
   "peerDependencies": {
     "@lancedb/lancedb": "^0.30.0",
     "@types/ws": ">=8.0.0",
@@ -374,8 +345,6 @@
   "devDependencies": {
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/sdk-trace-base": "^1.30.1",
-    "@theokit/sdk-handoff": "workspace:*",
-    "@theokit/sdk-memory": "workspace:*",
     "@types/better-sqlite3": "^7.6.13",
     "@types/proper-lockfile": "^4.1.4",
     "@types/ws": "^8.18.0",
@@ -385,6 +354,17 @@
     "sqlite-vec": "^0.1.9",
     "typedoc": "^0.28.19",
     "ws": "^8.18.0",
-    "zod": "^4.0.0"
+    "zod": "^4.0.0",
+    "@theokit/sdk-handoff": "0.1.0",
+    "@theokit/sdk-memory": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsup && cp src/internal/providers/provider-catalog.json dist/provider-catalog.json",
+    "test": "vitest run --no-file-parallelism",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "docs:json": "typedoc --options typedoc.json",
+    "docs:drift": "tsx scripts/check-docs-drift.ts"
   }
-}
+}

package/dist/internal/observability/context.d.cts

@@ -1,23 +0,0 @@
-/**
- * ObservabilityContext — public type for structured observability
- * across agent runtime, memory, and tool dispatch (T10.2, ADR D449).
- *
- * Consumers use this type to thread tracing/logging context through
- * custom tools and plugins.
- *
- * @public
- */
-export interface ObservabilityContext {
-    /** Current trace ID (W3C Trace Context format). */
-    traceId: string;
-    /** Current span ID. */
-    spanId: string;
-    /** Parent span ID (undefined for root spans). */
-    parentSpanId?: string;
-    /** Structured log emitter. */
-    log: (level: "debug" | "info" | "warn" | "error", message: string, attrs?: Record<string, unknown>) => void;
-    /** Record a counter metric. */
-    counter: (name: string, value?: number, attrs?: Record<string, unknown>) => void;
-    /** Record a histogram metric. */
-    histogram: (name: string, value: number, attrs?: Record<string, unknown>) => void;
-}

package/dist/internal/observability/context.d.ts

@@ -1,23 +0,0 @@
-/**
- * ObservabilityContext — public type for structured observability
- * across agent runtime, memory, and tool dispatch (T10.2, ADR D449).
- *
- * Consumers use this type to thread tracing/logging context through
- * custom tools and plugins.
- *
- * @public
- */
-export interface ObservabilityContext {
-    /** Current trace ID (W3C Trace Context format). */
-    traceId: string;
-    /** Current span ID. */
-    spanId: string;
-    /** Parent span ID (undefined for root spans). */
-    parentSpanId?: string;
-    /** Structured log emitter. */
-    log: (level: "debug" | "info" | "warn" | "error", message: string, attrs?: Record<string, unknown>) => void;
-    /** Record a counter metric. */
-    counter: (name: string, value?: number, attrs?: Record<string, unknown>) => void;
-    /** Record a histogram metric. */
-    histogram: (name: string, value: number, attrs?: Record<string, unknown>) => void;
-}

package/dist/internal/observability/index.cjs

@@ -1,38 +0,0 @@
-'use strict';
-
-var module$1 = require('module');
-
-var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
-// src/internal/observability/tracer-loader.ts
-var noopSpan = {
-  setAttribute: () => noopSpan,
-  end: () => void 0
-};
-var tracerCache = /* @__PURE__ */ new Map();
-function getTracer(name, version = "1.0.0") {
-  const cached = tracerCache.get(name);
-  if (cached !== void 0) return cached.tracer ?? void 0;
-  try {
-    const r = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)));
-    const otel = r("@opentelemetry/api");
-    if (otel.trace?.getTracer === void 0) {
-      tracerCache.set(name, { tracer: null });
-      return void 0;
-    }
-    const tracer = otel.trace.getTracer(name, version);
-    tracerCache.set(name, { tracer });
-    return tracer;
-  } catch {
-    tracerCache.set(name, { tracer: null });
-    return void 0;
-  }
-}
-function resetTracerCacheForTests() {
-  tracerCache.clear();
-}
-
-exports.getTracer = getTracer;
-exports.noopSpan = noopSpan;
-exports.resetTracerCacheForTests = resetTracerCacheForTests;
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map

package/dist/internal/observability/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/internal/observability/tracer-loader.ts"],"names":["createRequire"],"mappings":";;;;;;AAgBO,IAAM,QAAA,GAAqB;AAAA,EAChC,cAAc,MAAM,QAAA;AAAA,EACpB,KAAK,MAAM;AACb;AAaA,IAAM,WAAA,uBAAkB,GAAA,EAAwB;AAEzC,SAAS,SAAA,CAAU,IAAA,EAAc,OAAA,GAAU,OAAA,EAAiC;AACjF,EAAA,MAAM,MAAA,GAAS,WAAA,CAAY,GAAA,CAAI,IAAI,CAAA;AACnC,EAAA,IAAI,MAAA,KAAW,MAAA,EAAW,OAAO,MAAA,CAAO,MAAA,IAAU,MAAA;AAClD,EAAA,IAAI;AACF,IAAA,MAAM,CAAA,GAAIA,sBAAA,CAAc,2PAAe,CAAA;AACvC,IAAA,MAAM,IAAA,GAAO,EAAE,oBAAoB,CAAA;AAGnC,IAAA,IAAI,IAAA,CAAK,KAAA,EAAO,SAAA,KAAc,KAAA,CAAA,EAAW;AACvC,MAAA,WAAA,CAAY,GAAA,CAAI,IAAA,EAAM,EAAE,MAAA,EAAQ,MAAM,CAAA;AACtC,MAAA,OAAO,KAAA,CAAA;AAAA,IACT;AACA,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,SAAA,CAAU,MAAM,OAAO,CAAA;AACjD,IAAA,WAAA,CAAY,GAAA,CAAI,IAAA,EAAM,EAAE,MAAA,EAAQ,CAAA;AAChC,IAAA,OAAO,MAAA;AAAA,EACT,CAAA,CAAA,MAAQ;AACN,IAAA,WAAA,CAAY,GAAA,CAAI,IAAA,EAAM,EAAE,MAAA,EAAQ,MAAM,CAAA;AACtC,IAAA,OAAO,MAAA;AAAA,EACT;AACF;AAEO,SAAS,wBAAA,GAAiC;AAC/C,EAAA,WAAA,CAAY,KAAA,EAAM;AACpB","file":"index.cjs","sourcesContent":["/**\n * Shared OTel tracer loader (extracted to eliminate cross-module clones —\n * was previously inlined in cache/, workflow/, eval/, handoff/ telemetry\n * modules). Lazy-loads `@opentelemetry/api` via `createRequire`; users\n * without OTel installed pay zero cost.\n *\n * @internal\n */\n\nimport { createRequire } from \"node:module\";\n\nexport interface SpanLike {\n  setAttribute(key: string, value: string | number | boolean): SpanLike;\n  end(): void;\n}\n\nexport const noopSpan: SpanLike = {\n  setAttribute: () => noopSpan,\n  end: () => undefined,\n};\n\nexport interface TracerLike {\n  startSpan(\n    name: string,\n    options?: { attributes?: Record<string, string | number | boolean> },\n  ): SpanLike;\n}\n\ninterface CacheEntry {\n  tracer: TracerLike | null;\n}\n\nconst tracerCache = new Map<string, CacheEntry>();\n\nexport function getTracer(name: string, version = \"1.0.0\"): TracerLike | undefined {\n  const cached = tracerCache.get(name);\n  if (cached !== undefined) return cached.tracer ?? undefined;\n  try {\n    const r = createRequire(import.meta.url);\n    const otel = r(\"@opentelemetry/api\") as {\n      trace?: { getTracer: (n: string, v?: string) => TracerLike };\n    };\n    if (otel.trace?.getTracer === undefined) {\n      tracerCache.set(name, { tracer: null });\n      return undefined;\n    }\n    const tracer = otel.trace.getTracer(name, version);\n    tracerCache.set(name, { tracer });\n    return tracer;\n  } catch {\n    tracerCache.set(name, { tracer: null });\n    return undefined;\n  }\n}\n\nexport function resetTracerCacheForTests(): void {\n  tracerCache.clear();\n}\n"]}

package/dist/internal/observability/index.d.cts

@@ -1,8 +0,0 @@
-/**
- * Barrel for observability primitives shared across subsystems
- * (cache, memory, etc.) — exposed via `@theokit/sdk/internal/observability`
- * sub-path (SDK 2.0 Phase 3 prep).
- *
- * @internal — semver-exempt; surface may change in patch releases.
- */
-export * from "./tracer-loader.js";

package/dist/internal/observability/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * Barrel for observability primitives shared across subsystems
- * (cache, memory, etc.) — exposed via `@theokit/sdk/internal/observability`
- * sub-path (SDK 2.0 Phase 3 prep).
- *
- * @internal — semver-exempt; surface may change in patch releases.
- */
-export * from "./tracer-loader.js";

package/dist/internal/observability/index.js

@@ -1,33 +0,0 @@
-import { createRequire } from 'module';
-
-// src/internal/observability/tracer-loader.ts
-var noopSpan = {
-  setAttribute: () => noopSpan,
-  end: () => void 0
-};
-var tracerCache = /* @__PURE__ */ new Map();
-function getTracer(name, version = "1.0.0") {
-  const cached = tracerCache.get(name);
-  if (cached !== void 0) return cached.tracer ?? void 0;
-  try {
-    const r = createRequire(import.meta.url);
-    const otel = r("@opentelemetry/api");
-    if (otel.trace?.getTracer === void 0) {
-      tracerCache.set(name, { tracer: null });
-      return void 0;
-    }
-    const tracer = otel.trace.getTracer(name, version);
-    tracerCache.set(name, { tracer });
-    return tracer;
-  } catch {
-    tracerCache.set(name, { tracer: null });
-    return void 0;
-  }
-}
-function resetTracerCacheForTests() {
-  tracerCache.clear();
-}
-
-export { getTracer, noopSpan, resetTracerCacheForTests };
-//# sourceMappingURL=index.js.map
-//# sourceMappingURL=index.js.map

package/dist/internal/observability/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/internal/observability/tracer-loader.ts"],"names":[],"mappings":";;;AAgBO,IAAM,QAAA,GAAqB;AAAA,EAChC,cAAc,MAAM,QAAA;AAAA,EACpB,KAAK,MAAM;AACb;AAaA,IAAM,WAAA,uBAAkB,GAAA,EAAwB;AAEzC,SAAS,SAAA,CAAU,IAAA,EAAc,OAAA,GAAU,OAAA,EAAiC;AACjF,EAAA,MAAM,MAAA,GAAS,WAAA,CAAY,GAAA,CAAI,IAAI,CAAA;AACnC,EAAA,IAAI,MAAA,KAAW,MAAA,EAAW,OAAO,MAAA,CAAO,MAAA,IAAU,MAAA;AAClD,EAAA,IAAI;AACF,IAAA,MAAM,CAAA,GAAI,aAAA,CAAc,MAAA,CAAA,IAAA,CAAY,GAAG,CAAA;AACvC,IAAA,MAAM,IAAA,GAAO,EAAE,oBAAoB,CAAA;AAGnC,IAAA,IAAI,IAAA,CAAK,KAAA,EAAO,SAAA,KAAc,KAAA,CAAA,EAAW;AACvC,MAAA,WAAA,CAAY,GAAA,CAAI,IAAA,EAAM,EAAE,MAAA,EAAQ,MAAM,CAAA;AACtC,MAAA,OAAO,KAAA,CAAA;AAAA,IACT;AACA,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,SAAA,CAAU,MAAM,OAAO,CAAA;AACjD,IAAA,WAAA,CAAY,GAAA,CAAI,IAAA,EAAM,EAAE,MAAA,EAAQ,CAAA;AAChC,IAAA,OAAO,MAAA;AAAA,EACT,CAAA,CAAA,MAAQ;AACN,IAAA,WAAA,CAAY,GAAA,CAAI,IAAA,EAAM,EAAE,MAAA,EAAQ,MAAM,CAAA;AACtC,IAAA,OAAO,MAAA;AAAA,EACT;AACF;AAEO,SAAS,wBAAA,GAAiC;AAC/C,EAAA,WAAA,CAAY,KAAA,EAAM;AACpB","file":"index.js","sourcesContent":["/**\n * Shared OTel tracer loader (extracted to eliminate cross-module clones —\n * was previously inlined in cache/, workflow/, eval/, handoff/ telemetry\n * modules). Lazy-loads `@opentelemetry/api` via `createRequire`; users\n * without OTel installed pay zero cost.\n *\n * @internal\n */\n\nimport { createRequire } from \"node:module\";\n\nexport interface SpanLike {\n  setAttribute(key: string, value: string | number | boolean): SpanLike;\n  end(): void;\n}\n\nexport const noopSpan: SpanLike = {\n  setAttribute: () => noopSpan,\n  end: () => undefined,\n};\n\nexport interface TracerLike {\n  startSpan(\n    name: string,\n    options?: { attributes?: Record<string, string | number | boolean> },\n  ): SpanLike;\n}\n\ninterface CacheEntry {\n  tracer: TracerLike | null;\n}\n\nconst tracerCache = new Map<string, CacheEntry>();\n\nexport function getTracer(name: string, version = \"1.0.0\"): TracerLike | undefined {\n  const cached = tracerCache.get(name);\n  if (cached !== undefined) return cached.tracer ?? undefined;\n  try {\n    const r = createRequire(import.meta.url);\n    const otel = r(\"@opentelemetry/api\") as {\n      trace?: { getTracer: (n: string, v?: string) => TracerLike };\n    };\n    if (otel.trace?.getTracer === undefined) {\n      tracerCache.set(name, { tracer: null });\n      return undefined;\n    }\n    const tracer = otel.trace.getTracer(name, version);\n    tracerCache.set(name, { tracer });\n    return tracer;\n  } catch {\n    tracerCache.set(name, { tracer: null });\n    return undefined;\n  }\n}\n\nexport function resetTracerCacheForTests(): void {\n  tracerCache.clear();\n}\n"]}

package/dist/internal/plugins/index.cjs

@@ -1,363 +0,0 @@
-'use strict';
-
-// src/internal/plugins/context.ts
-function createPluginContext() {
-  const registrations = {
-    tools: [],
-    commands: [],
-    hooks: /* @__PURE__ */ new Map(),
-    injected: []
-  };
-  const impl = {
-    registerTool(tool) {
-      registrations.tools.push(tool);
-    },
-    registerCommand(name, handler, opts = {}) {
-      const entry = { name, handler };
-      if (opts.description !== void 0) entry.description = opts.description;
-      registrations.commands.push(entry);
-    },
-    on(hook, handler) {
-      if (typeof handler !== "function") {
-        process.stderr.write(`[theokit-sdk] ignoring non-function handler for hook "${hook}"
-`);
-        return;
-      }
-      const existing = registrations.hooks.get(hook) ?? [];
-      existing.push(handler);
-      registrations.hooks.set(hook, existing);
-    },
-    injectMessage(content, role = "user") {
-      registrations.injected.push({ content, role });
-    }
-  };
-  const ctx = shouldSeal() ? sealContext(impl) : impl;
-  return { ctx, registrations };
-}
-function shouldSeal() {
-  return process.env.NODE_ENV !== "production";
-}
-function sealContext(impl) {
-  return new Proxy(impl, {
-    set(_target, prop) {
-      throw new Error(
-        `[theokit-sdk] PluginContext is sealed \u2014 cannot set ${String(prop)}. Plugins must use registerTool, registerCommand, on, or injectMessage.`
-      );
-    },
-    deleteProperty(_target, prop) {
-      throw new Error(`[theokit-sdk] PluginContext is sealed \u2014 cannot delete ${String(prop)}.`);
-    }
-  });
-}
-
-// src/internal/plugins/lifecycle.ts
-async function runFireAndForgetHooks(handlers, ctx) {
-  for (const h of handlers) {
-    try {
-      await h(ctx);
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
-      process.stderr.write(`[theokit-sdk] plugin hook threw (continuing): ${msg}
-`);
-    }
-  }
-}
-async function runTransformHooks(handlers, initial) {
-  let current = initial;
-  for (const h of handlers) {
-    try {
-      const next = await h(current);
-      if (next !== void 0) current = next;
-    } catch (err) {
-      const msg = err instanceof Error ? err.message : String(err);
-      process.stderr.write(`[theokit-sdk] plugin transform hook threw (continuing): ${msg}
-`);
-    }
-  }
-  return current;
-}
-
-// src/errors.ts
-var TheokitAgentError = class extends Error {
-  name = "TheokitAgentError";
-  isRetryable;
-  code;
-  protoErrorCode;
-  metadata;
-  constructor(message, options = {}) {
-    super(message, options.cause !== void 0 ? { cause: options.cause } : void 0);
-    this.isRetryable = options.isRetryable ?? false;
-    if (options.code !== void 0) this.code = options.code;
-    if (options.protoErrorCode !== void 0) this.protoErrorCode = options.protoErrorCode;
-    if (options.metadata !== void 0) this.metadata = options.metadata;
-  }
-};
-var ConfigurationError = class extends TheokitAgentError {
-  name = "ConfigurationError";
-  constructor(message, options = {}) {
-    super(message, { ...options, isRetryable: false });
-  }
-};
-
-// src/internal/plugins/manager.ts
-var PluginManager = class {
-  #aggregated = {
-    tools: [],
-    commands: [],
-    hooks: /* @__PURE__ */ new Map(),
-    injected: [],
-    providerProfiles: [],
-    memoryProviders: []
-  };
-  #initialized = false;
-  // #68 — registrations of plugins added post-init via `register()`, keyed by
-  // plugin name so a re-register REPLACES (not appends) the prior hooks.
-  #byName = /* @__PURE__ */ new Map();
-  async initialize(plugins) {
-    if (this.#initialized) {
-      throw new Error("PluginManager.initialize called twice \u2014 register only once per process");
-    }
-    this.#initialized = true;
-    const seen = /* @__PURE__ */ new Set();
-    for (const plugin of plugins) {
-      if (seen.has(plugin.name)) {
-        process.stderr.write(
-          `[theokit-sdk] duplicate plugin name "${plugin.name}" \u2014 both will register independently
-`
-        );
-      }
-      seen.add(plugin.name);
-      await this.#dispatchPlugin(plugin);
-    }
-  }
-  /**
-   * #68 — register a single `general` plugin AFTER `initialize()` has run.
-   *
-   * The bulk `initialize()` is single-shot (one call per process); late
-   * registration is a distinct, named operation used by adapters that install
-   * a plugin per-session/per-request (e.g. the ACP permission veto, which is
-   * installed once the permission mode + connection are known — after the
-   * agent's own plugins were already initialized).
-   *
-   * Idempotent by plugin NAME: re-registering a plugin with the same name
-   * REPLACES its prior hooks/tools instead of appending duplicates (the ACP
-   * permission plugin is re-installed on every prompt).
-   *
-   * Only `general` plugins may be registered late — model-provider / memory
-   * plugins are resolved during the bulk init and cannot be added afterwards.
-   */
-  async register(plugin) {
-    if (plugin.kind !== "general") {
-      throw new ConfigurationError(
-        `late register supports general plugins only (got "${plugin.kind}" for "${plugin.name}")`,
-        { code: "plugin_late_register_kind" }
-      );
-    }
-    const prior = this.#byName.get(plugin.name);
-    if (prior !== void 0) this.#unmerge(prior);
-    const { ctx, registrations } = createPluginContext();
-    await plugin.register(ctx);
-    this.#byName.set(plugin.name, registrations);
-    this.#merge(registrations);
-  }
-  get aggregated() {
-    return this.#aggregated;
-  }
-  /**
-   * Run all `pre_tool_call` hooks; first decision with `block: true` wins.
-   * D101: veto pattern — return `{ block: true, message }` makes the loop
-   * surface a tool_result with `isError: false, content: message` so the
-   * LLM can self-correct.
-   */
-  async runPreToolCallHooks(ctx) {
-    const handlers = this.#aggregated.hooks.get("pre_tool_call") ?? [];
-    for (const h of handlers) {
-      const decision = await h(ctx);
-      if (decision !== void 0 && decision.block === true) {
-        return decision;
-      }
-    }
-    return void 0;
-  }
-  /** Aggregated handlers for a given hook (read-only view). @internal */
-  hooksFor(name) {
-    return this.#aggregated.hooks.get(name) ?? [];
-  }
-  /**
-   * Run all `pre_user_send` hooks; concatenate non-empty `recalledContext`
-   * outputs with `\n\n` and cap total length at `maxRecallContextBytes`
-   * (EC-A). Per-handler failures are caught + logged to stderr (EC-8) so a
-   * single broken adapter never blocks the LLM call (graceful degrade).
-   *
-   * Returns the assembled context (or undefined if empty after cap).
-   *
-   * @internal
-   */
-  // biome-ignore lint/complexity/noExcessiveCognitiveComplexity: per-handler try/catch + EC-A cap + EC-8 isolation are 3 concerns that share state (parts buffer); splitting fragments the single-pass aggregation.
-  async runPreUserSendHooks(ctx, maxRecallContextBytes) {
-    const handlers = this.#aggregated.hooks.get("pre_user_send") ?? [];
-    if (handlers.length === 0) return void 0;
-    const parts = [];
-    for (const h of handlers) {
-      try {
-        const result = await h(ctx);
-        if (result?.recalledContext && result.recalledContext.length > 0) {
-          parts.push(result.recalledContext);
-        }
-      } catch (err) {
-        process.stderr.write(
-          `[theokit-sdk] pre_user_send hook failed: ${err instanceof Error ? err.message : String(err)}
-`
-        );
-      }
-    }
-    if (parts.length === 0) return void 0;
-    let combined = parts.join("\n\n");
-    if (combined.length > maxRecallContextBytes) {
-      combined = `${combined.slice(0, maxRecallContextBytes)}
-\u2026[truncated]`;
-    }
-    return combined;
-  }
-  /**
-   * Run all `post_assistant_reply` hooks. Fire-and-forget: errors are
-   * surfaced to stderr (EC-O) so a slow/broken sync never blocks the
-   * caller's `wait()`. Returns a Promise that callers may optionally
-   * await for tests; production code typically `void`s it.
-   *
-   * @internal
-   */
-  async runPostAssistantReplyHooks(ctx) {
-    const handlers = this.#aggregated.hooks.get("post_assistant_reply") ?? [];
-    for (const h of handlers) {
-      try {
-        await h(ctx);
-      } catch (err) {
-        process.stderr.write(
-          `[theokit-sdk] post_assistant_reply hook failed: ${err instanceof Error ? err.message : String(err)}
-`
-        );
-      }
-    }
-  }
-  // #65 — the previously-dead hooks, now wired. Fire-and-forget hooks run
-  // in order (per-handler errors logged, never thrown); transform hooks fold
-  // over the payload (a handler returning a value replaces it).
-  /** @internal */
-  async #runFireAndForget(name, ctx) {
-    for (const h of this.#aggregated.hooks.get(name) ?? []) {
-      try {
-        await h(ctx);
-      } catch (err) {
-        process.stderr.write(
-          `[theokit-sdk] ${name} hook failed: ${err instanceof Error ? err.message : String(err)}
-`
-        );
-      }
-    }
-  }
-  /** @internal — fold: each handler may return a replacement payload; a throw keeps the prior value. */
-  async #runTransform(name, payload, ctx) {
-    let current = payload;
-    for (const h of this.#aggregated.hooks.get(name) ?? []) {
-      try {
-        const out = await h(current, ctx);
-        if (out !== void 0) current = out;
-      } catch (err) {
-        process.stderr.write(
-          `[theokit-sdk] ${name} hook failed: ${err instanceof Error ? err.message : String(err)}
-`
-        );
-      }
-    }
-    return current;
-  }
-  /** #65 — fired after a tool call completes. @internal */
-  runPostToolCallHooks(ctx) {
-    return this.#runFireAndForget("post_tool_call", ctx);
-  }
-  /** #65 — fired before / after each LLM turn. @internal */
-  runPreLlmCallHooks(ctx) {
-    return this.#runFireAndForget("pre_llm_call", ctx);
-  }
-  runPostLlmCallHooks(ctx) {
-    return this.#runFireAndForget("post_llm_call", ctx);
-  }
-  /** #65 — fired at run start / end. @internal */
-  runOnSessionStartHooks(ctx) {
-    return this.#runFireAndForget("on_session_start", ctx);
-  }
-  runOnSessionEndHooks(ctx) {
-    return this.#runFireAndForget("on_session_end", ctx);
-  }
-  /** #65/#57 — transform tool results before they reach the LLM (the #57 seam). @internal */
-  runTransformToolResultHooks(results, ctx) {
-    return this.#runTransform("transform_tool_result", results, ctx);
-  }
-  /** #65 — transform the LLM output text before it is consumed. @internal */
-  runTransformLlmOutputHooks(output, ctx) {
-    return this.#runTransform("transform_llm_output", output, ctx);
-  }
-  async #dispatchPlugin(plugin) {
-    if (plugin.kind === "general") {
-      const { ctx, registrations } = createPluginContext();
-      await plugin.register(ctx);
-      this.#merge(registrations);
-    } else if (plugin.kind === "model-provider") {
-      this.#aggregated.providerProfiles.push({
-        pluginName: plugin.name,
-        profile: plugin.profile
-      });
-    } else if (plugin.kind === "memory") {
-      this.#aggregated.memoryProviders.push({
-        pluginName: plugin.name,
-        createProvider: plugin.createProvider
-      });
-    }
-  }
-  #merge(r) {
-    this.#aggregated.tools.push(...r.tools);
-    this.#aggregated.commands.push(...r.commands);
-    for (const [hook, handlers] of r.hooks.entries()) {
-      const existing = this.#aggregated.hooks.get(hook) ?? [];
-      existing.push(...handlers);
-      this.#aggregated.hooks.set(hook, existing);
-    }
-    this.#aggregated.injected.push(...r.injected);
-  }
-  /**
-   * #68 — inverse of #merge: remove a prior registration's contributions from
-   * the aggregated view by object identity. Used by `register()` to replace a
-   * same-named plugin's hooks/tools instead of accumulating duplicates.
-   */
-  #unmerge(r) {
-    removeAll(this.#aggregated.tools, r.tools);
-    removeAll(this.#aggregated.commands, r.commands);
-    removeAll(this.#aggregated.injected, r.injected);
-    for (const [hook, handlers] of r.hooks.entries()) {
-      const existing = this.#aggregated.hooks.get(hook);
-      if (existing === void 0) continue;
-      removeAll(existing, handlers);
-      if (existing.length === 0) this.#aggregated.hooks.delete(hook);
-    }
-  }
-};
-function removeAll(arr, toRemove) {
-  for (const item of toRemove) {
-    const idx = arr.indexOf(item);
-    if (idx !== -1) arr.splice(idx, 1);
-  }
-}
-
-// src/internal/plugins/types.ts
-function definePlugin(p) {
-  return p;
-}
-
-exports.PluginManager = PluginManager;
-exports.createPluginContext = createPluginContext;
-exports.definePlugin = definePlugin;
-exports.runFireAndForgetHooks = runFireAndForgetHooks;
-exports.runTransformHooks = runTransformHooks;
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map