@wrongstack/core 0.2.0 → 0.3.1

package/dist/infrastructure/index.d.ts

@@ -1,10 +1,10 @@
 export { D as DefaultLogger, a as DefaultLoggerOptions } from '../logger-BH6AE0W9.js';
-export { D as DefaultPathResolver, a as DefaultTokenCounter } from '../path-resolver-Crkt8wTQ.js';
-export { C as ContextManagerAction, a as ContextManagerInput, b as ContextManagerResult, c as ContextManagerToolOptions, d as allServers, e as awsServer, f as blockServer, g as braveSearchServer, h as context7Server, i as contextManagerTool, j as createContextManagerTool, k as everArtServer, l as filesystemServer, m as githubServer, n as googleMapsServer, s as sentinelServer, o as slackServer } from '../mcp-servers-BA1Ofmfj.js';
+export { D as DefaultPathResolver, a as DefaultTokenCounter } from '../path-resolver-Cl_q0u-R.js';
+export { C as ContextManagerAction, a as ContextManagerInput, b as ContextManagerResult, c as ContextManagerToolOptions, d as allServers, e as awsServer, f as blockServer, g as braveSearchServer, h as context7Server, i as contextManagerTool, j as createContextManagerTool, k as everArtServer, l as filesystemServer, m as githubServer, n as googleMapsServer, s as sentinelServer, o as slackServer } from '../mcp-servers-DR35ojJZ.js';
 import '../logger-BMQgxvdy.js';
-import '../events-B6Q03pTu.js';
-import '../context-u0bryklF.js';
+import '../events-CNB9PALO.js';
+import '../context-IovtuTf8.js';
 import '../models-registry-Y2xbog0E.js';
 import '../path-resolver-CPRj4bFY.js';
-import '../compactor-DSl2FK7a.js';
-import '../config-DXrqb41m.js';
+import '../compactor-BUU6Zm_3.js';
+import '../config-CKLYPkCi.js';

package/dist/kernel/index.d.ts

@@ -1,18 +1,19 @@
-import { T as Token, R as Renderer } from '../renderer-0A2ZEtca.js';
-export { B as BindOptions, C as Container, D as Decorator, F as Factory, M as Middleware, a as MiddlewareHandler, N as NextFn, P as Pipeline, b as PipelineOptions } from '../renderer-0A2ZEtca.js';
-export { E as EventBus, b as EventLogger, c as EventMap, a as EventName, L as Listener } from '../events-B6Q03pTu.js';
-import { C as Compactor } from '../compactor-DSl2FK7a.js';
-import { a as ConfigLoader, b as ConfigStore } from '../config-DXrqb41m.js';
-import { E as ErrorHandler, c as RetryPolicy, a as SkillLoader } from '../skill-Bx8jxznf.js';
+import { T as Token, R as Renderer, S as SystemPromptBuilder } from '../system-prompt-Dk1qm8ey.js';
+export { a as BindOptions, C as Container, D as Decorator, F as Factory, b as Middleware, c as MiddlewareHandler, N as NextFn, P as Pipeline, d as PipelineOptions } from '../system-prompt-Dk1qm8ey.js';
+export { E as EventBus, b as EventLogger, c as EventMap, a as EventName, L as Listener } from '../events-CNB9PALO.js';
+import { C as Compactor } from '../compactor-BUU6Zm_3.js';
+import { a as ConfigLoader, b as ConfigStore } from '../config-CKLYPkCi.js';
+import { E as ErrorHandler, R as RetryPolicy, a as SkillLoader } from '../skill-C_7znCIC.js';
 import { I as InputReader } from '../input-reader-E-ffP2ee.js';
 import { L as Logger } from '../logger-BMQgxvdy.js';
 import { b as MemoryStore } from '../memory-CEXuo7sz.js';
 import { c as ModeStore } from '../mode-CV077NjV.js';
 import { M as ModelsRegistry } from '../models-registry-Y2xbog0E.js';
 import { P as PathResolver } from '../path-resolver-CPRj4bFY.js';
-import { a as PermissionPolicy, S as SecretScrubber } from '../secret-scrubber-3TLUkiCV.js';
-import { a1 as TokenCounter, o as SessionStore } from '../context-u0bryklF.js';
-import { S as SystemPromptBuilder } from '../system-prompt-CG9jU5-5.js';
+import { a as PermissionPolicy, S as SecretScrubber } from '../secret-scrubber-CgG2tV2B.js';
+import { P as ProviderRunner } from '../provider-runner-BXuADQqQ.js';
+import { a1 as TokenCounter, o as SessionStore } from '../context-IovtuTf8.js';
+import '../observability-BhnVLBLS.js';
 
 declare const TOKENS: {
     readonly Logger: Token<Logger>;
@@ -33,6 +34,8 @@ declare const TOKENS: {
     readonly SecretScrubber: Token<SecretScrubber>;
     readonly ModelsRegistry: Token<ModelsRegistry>;
     readonly ModeStore: Token<ModeStore>;
+    /** Replaces the entire provider call layer — retry, streaming, tracing. */
+    readonly ProviderRunner: Token<ProviderRunner>;
 };
 
 /**

package/dist/kernel/index.js

@@ -284,6 +284,7 @@ var Pipeline = class {
 // src/kernel/events.ts
 var EventBus = class {
   listeners = /* @__PURE__ */ new Map();
+  wildcards = [];
   logger;
   setLogger(logger) {
     this.logger = logger;
@@ -310,24 +311,73 @@ var EventBus = class {
       this.off(event, wrapper);
     };
   }
+  /**
+   * Subscribe to all events whose name matches a glob-style prefix.
+   * `'tool.*'` matches `tool.started`, `tool.executed`, `tool.progress`, etc.
+   * `'*'` matches every event.
+   *
+   * The handler receives `(eventName, payload)` with the event name as a
+   * string and the payload as `unknown`. Use for logging, debugging, or
+   * metrics collection across a family of events.
+   *
+   * Returns an unsubscribe function.
+   */
+  onPattern(pattern, fn) {
+    const match = makePatternMatcher(pattern);
+    const entry = { match, fn };
+    this.wildcards.push(entry);
+    return () => {
+      const idx = this.wildcards.indexOf(entry);
+      if (idx >= 0) this.wildcards.splice(idx, 1);
+    };
+  }
+  /**
+   * Subscribe to all events whose name matches a RegExp.
+   * More flexible than `onPattern` — use when you need regex features
+   * (alternation, character classes, capture groups).
+   *
+   * Returns an unsubscribe function.
+   */
+  onRegex(regex, fn) {
+    const entry = { match: (e) => regex.test(e), fn };
+    this.wildcards.push(entry);
+    return () => {
+      const idx = this.wildcards.indexOf(entry);
+      if (idx >= 0) this.wildcards.splice(idx, 1);
+    };
+  }
   emit(event, payload) {
     const set = this.listeners.get(event);
-    if (!set) return;
-    for (const fn of set) {
-      try {
-        fn(payload);
-      } catch (err) {
-        this.logger?.error(`EventBus listener for "${event}" threw`, err);
+    if (set) {
+      for (const fn of set) {
+        try {
+          fn(payload);
+        } catch (err) {
+          this.logger?.error(`EventBus listener for "${event}" threw`, err);
+        }
+      }
+    }
+    if (this.wildcards.length > 0) {
+      const name = event;
+      for (const { match, fn } of this.wildcards) {
+        if (!match(name)) continue;
+        try {
+          fn(name, payload);
+        } catch (err) {
+          this.logger?.error(`EventBus wildcard listener for "${name}" threw`, err);
+        }
       }
     }
   }
   clear() {
     this.listeners.clear();
+    this.wildcards.length = 0;
   }
   /**
    * V2-D: introspection helper. Pass an `event` to count handlers for a
    * single key, or omit to get the total across every event. Used by the
    * leak-detection smoke test to flag handler accumulation across runs.
+   * Does NOT include wildcard listeners.
    */
   listenerCount(event) {
     if (event !== void 0) return this.listeners.get(event)?.size ?? 0;
@@ -335,7 +385,21 @@ var EventBus = class {
     for (const set of this.listeners.values()) total += set.size;
     return total;
   }
+  /**
+   * Number of wildcard listeners currently registered.
+   */
+  wildcardCount() {
+    return this.wildcards.length;
+  }
 };
+function makePatternMatcher(pattern) {
+  if (pattern === "*") return () => true;
+  if (pattern.endsWith(".*")) {
+    const prefix = pattern.slice(0, -2);
+    return (e) => e.startsWith(`${prefix}.`);
+  }
+  return (e) => e === pattern;
+}
 
 // src/kernel/tokens.ts
 var t = (name) => Symbol(name);
@@ -357,7 +421,9 @@ var TOKENS = {
   SystemPromptBuilder: t("SystemPromptBuilder"),
   SecretScrubber: t("SecretScrubber"),
   ModelsRegistry: t("ModelsRegistry"),
-  ModeStore: t("ModeStore")
+  ModeStore: t("ModeStore"),
+  /** Replaces the entire provider call layer — retry, streaming, tracing. */
+  ProviderRunner: t("ProviderRunner")
 };
 
 // src/kernel/run-controller.ts

package/dist/kernel/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/errors.ts","../../src/kernel/container.ts","../../src/kernel/pipeline.ts","../../src/kernel/events.ts","../../src/kernel/tokens.ts","../../src/kernel/run-controller.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * WrongStack error hierarchy.\n *\n * Every error thrown by the framework is a `WrongStackError` with a\n * machine-readable `code`, a `subsystem` tag, and a `severity` level.\n * This lets consumers (CLI, TUI, plugins, tests) branch on structured\n * data instead of parsing error messages.\n */\n\n// ── Error codes ──────────────────────────────────────────────────────\n\nexport type ErrorCode =\n  // Provider\n  | 'PROVIDER_RATE_LIMITED'\n  | 'PROVIDER_AUTH_FAILED'\n  | 'PROVIDER_OVERLOADED'\n  | 'PROVIDER_INVALID_REQUEST'\n  | 'PROVIDER_SERVER_ERROR'\n  | 'PROVIDER_NETWORK_ERROR'\n  | 'PROVIDER_CONTEXT_OVERFLOW'\n  // Tool\n  | 'TOOL_NOT_FOUND'\n  | 'TOOL_PERMISSION_DENIED'\n  | 'TOOL_EXECUTION_FAILED'\n  | 'TOOL_TIMEOUT'\n  | 'TOOL_INPUT_INVALID'\n  // Config\n  | 'CONFIG_INVALID'\n  | 'CONFIG_NOT_FOUND'\n  | 'CONFIG_PARSE_FAILED'\n  | 'CONFIG_MIGRATION_NEEDED'\n  // Plugin\n  | 'PLUGIN_LOAD_FAILED'\n  | 'PLUGIN_API_MISMATCH'\n  | 'PLUGIN_MISSING_DEPENDENCY'\n  // Agent\n  | 'AGENT_ITERATION_LIMIT'\n  | 'AGENT_CONTEXT_OVERFLOW'\n  | 'AGENT_ABORTED'\n  | 'AGENT_RUN_FAILED'\n  // Session\n  | 'SESSION_NOT_FOUND'\n  | 'SESSION_CORRUPTED'\n  | 'SESSION_WRITE_FAILED'\n  // Container / Registry\n  | 'CONTAINER_TOKEN_ALREADY_BOUND'\n  | 'CONTAINER_TOKEN_NOT_BOUND'\n  | 'REGISTRY_DUPLICATE'\n  | 'REGISTRY_NOT_FOUND'\n  // General\n  | 'UNKNOWN';\n\nexport type ErrorSubsystem =\n  | 'provider'\n  | 'tool'\n  | 'config'\n  | 'plugin'\n  | 'agent'\n  | 'session'\n  | 'container'\n  | 'general';\nexport type ErrorSeverity = 'fatal' | 'error' | 'warning';\n\n// ── Base error class ─────────────────────────────────────────────────\n\nexport class WrongStackError extends Error {\n  readonly code: ErrorCode;\n  readonly subsystem: ErrorSubsystem;\n  readonly severity: ErrorSeverity;\n  readonly recoverable: boolean;\n  readonly context?: Record<string, unknown>;\n\n  constructor(opts: {\n    message: string;\n    code: ErrorCode;\n    subsystem: ErrorSubsystem;\n    severity?: ErrorSeverity;\n    recoverable?: boolean;\n    context?: Record<string, unknown>;\n    cause?: unknown;\n  }) {\n    super(opts.message, { cause: opts.cause });\n    this.name = 'WrongStackError';\n    this.code = opts.code;\n    this.subsystem = opts.subsystem;\n    this.severity = opts.severity ?? 'error';\n    this.recoverable = opts.recoverable ?? false;\n    this.context = opts.context;\n  }\n\n  /**\n   * Render a one-line user-facing description.\n   * Subclasses should override for domain-specific formatting.\n   */\n  describe(): string {\n    const ctx = this.context ? ` ${formatContext(this.context)}` : '';\n    return `${this.code}: ${this.message}${ctx}`;\n  }\n}\n\nfunction formatContext(ctx: Record<string, unknown>): string {\n  const parts = Object.entries(ctx)\n    .filter(([, v]) => v !== undefined)\n    .slice(0, 3)\n    .map(([k, v]) => `${k}=${String(v)}`);\n  return parts.length > 0 ? `[${parts.join(' ')}]` : '';\n}\n\n// ── Specific error classes ───────────────────────────────────────────\n\n/**\n * Tool execution errors — thrown by ToolExecutor and individual tools.\n */\nexport class ToolError extends WrongStackError {\n  readonly toolName: string;\n\n  constructor(opts: {\n    message: string;\n    code: Extract<\n      ErrorCode,\n      | 'TOOL_NOT_FOUND'\n      | 'TOOL_PERMISSION_DENIED'\n      | 'TOOL_EXECUTION_FAILED'\n      | 'TOOL_TIMEOUT'\n      | 'TOOL_INPUT_INVALID'\n    >;\n    toolName: string;\n    recoverable?: boolean;\n    context?: Record<string, unknown>;\n    cause?: unknown;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'tool',\n      recoverable: opts.recoverable,\n      context: { tool: opts.toolName, ...opts.context },\n      cause: opts.cause,\n    });\n    this.name = 'ToolError';\n    this.toolName = opts.toolName;\n  }\n}\n\n/**\n * Config loading / validation errors.\n */\nexport class ConfigError extends WrongStackError {\n  constructor(opts: {\n    message: string;\n    code: Extract<\n      ErrorCode,\n      'CONFIG_INVALID' | 'CONFIG_NOT_FOUND' | 'CONFIG_PARSE_FAILED' | 'CONFIG_MIGRATION_NEEDED'\n    >;\n    context?: Record<string, unknown>;\n    cause?: unknown;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'config',\n      severity: 'fatal',\n      recoverable: false,\n      context: opts.context,\n      cause: opts.cause,\n    });\n    this.name = 'ConfigError';\n  }\n}\n\n/**\n * Plugin loading / lifecycle errors.\n */\nexport class PluginError extends WrongStackError {\n  readonly pluginName: string;\n\n  constructor(opts: {\n    message: string;\n    code: Extract<\n      ErrorCode,\n      'PLUGIN_LOAD_FAILED' | 'PLUGIN_API_MISMATCH' | 'PLUGIN_MISSING_DEPENDENCY'\n    >;\n    pluginName: string;\n    context?: Record<string, unknown>;\n    cause?: unknown;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'plugin',\n      severity: 'error',\n      recoverable: opts.code === 'PLUGIN_MISSING_DEPENDENCY',\n      context: { plugin: opts.pluginName, ...opts.context },\n      cause: opts.cause,\n    });\n    this.name = 'PluginError';\n    this.pluginName = opts.pluginName;\n  }\n}\n\n/**\n * Agent runtime errors — thrown by Agent.run when a non-WrongStackError\n * escapes the inner loop, so callers always see a structured error.\n */\nexport class AgentError extends WrongStackError {\n  constructor(opts: {\n    message: string;\n    code: Extract<\n      ErrorCode,\n      'AGENT_ITERATION_LIMIT' | 'AGENT_CONTEXT_OVERFLOW' | 'AGENT_ABORTED' | 'AGENT_RUN_FAILED'\n    >;\n    recoverable?: boolean;\n    context?: Record<string, unknown>;\n    cause?: unknown;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'agent',\n      severity: opts.code === 'AGENT_ABORTED' ? 'warning' : 'error',\n      recoverable: opts.recoverable ?? opts.code === 'AGENT_ITERATION_LIMIT',\n      context: opts.context,\n      cause: opts.cause,\n    });\n    this.name = 'AgentError';\n  }\n}\n\n/**\n * Wrap an arbitrary thrown value into a `WrongStackError` so the caller\n * always gets a structured error. Pass-throughs WrongStackError instances\n * unchanged; raw `Error`s and primitives get an `AGENT_RUN_FAILED` wrapper\n * with the original preserved as `cause`.\n */\nexport function toWrongStackError(\n  err: unknown,\n  code: Extract<ErrorCode, 'AGENT_RUN_FAILED' | 'AGENT_ABORTED' | 'UNKNOWN'> = 'AGENT_RUN_FAILED',\n): WrongStackError {\n  if (err instanceof WrongStackError) return err;\n  const message = err instanceof Error ? err.message : String(err);\n  return new AgentError({\n    message,\n    code: code === 'UNKNOWN' ? 'AGENT_RUN_FAILED' : code,\n    cause: err,\n  });\n}\n\n/**\n * Session storage errors.\n */\nexport class SessionError extends WrongStackError {\n  readonly sessionId?: string;\n\n  constructor(opts: {\n    message: string;\n    code: Extract<ErrorCode, 'SESSION_NOT_FOUND' | 'SESSION_CORRUPTED' | 'SESSION_WRITE_FAILED'>;\n    sessionId?: string;\n    context?: Record<string, unknown>;\n    cause?: unknown;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'session',\n      severity: opts.code === 'SESSION_WRITE_FAILED' ? 'error' : 'warning',\n      recoverable: opts.code !== 'SESSION_CORRUPTED',\n      context: { sessionId: opts.sessionId, ...opts.context },\n      cause: opts.cause,\n    });\n    this.name = 'SessionError';\n    this.sessionId = opts.sessionId;\n  }\n}\n\n// ── Type guards ──────────────────────────────────────────────────────\n\nexport function isWrongStackError(err: unknown): err is WrongStackError {\n  return err instanceof WrongStackError;\n}\n\nexport function isToolError(err: unknown): err is ToolError {\n  return err instanceof ToolError;\n}\n\nexport function isConfigError(err: unknown): err is ConfigError {\n  return err instanceof ConfigError;\n}\n\nexport function isPluginError(err: unknown): err is PluginError {\n  return err instanceof PluginError;\n}\n\nexport function isSessionError(err: unknown): err is SessionError {\n  return err instanceof SessionError;\n}\n\nexport function isAgentError(err: unknown): err is AgentError {\n  return err instanceof AgentError;\n}\n","import { WrongStackError } from '../types/errors.js';\n\n/**\n * Container — dependency injection with explicit bind / override / decorate.\n *\n * Invariants:\n *   bind()     — throws if token already bound\n *   override() — throws if nothing to replace\n *   decorate() — stacks; cached value cleared on register\n */\n\nexport type Token<T> = symbol & { readonly __type?: T };\nexport type Factory<T> = (c: Container) => T;\nexport type Decorator<T> = (inner: T, c: Container) => T;\n\ninterface Entry<T = unknown> {\n  factory: Factory<T>;\n  singleton: boolean;\n  decorators: Decorator<T>[];\n  cache?: T;\n  owner: string;\n}\n\nexport interface BindOptions {\n  singleton?: boolean;\n  owner?: string;\n}\n\nexport class Container {\n  private readonly entries = new Map<symbol, Entry>();\n\n  bind<T>(token: Token<T>, factory: Factory<T>, opts: BindOptions = {}): void {\n    if (this.entries.has(token)) {\n      throw new WrongStackError({\n        message: `Container: token \"${token.description ?? 'unknown'}\" already bound`,\n        code: 'CONTAINER_TOKEN_ALREADY_BOUND',\n        subsystem: 'container',\n        context: { token: token.description },\n      });\n    }\n    this.entries.set(token, {\n      factory: factory as Factory<unknown>,\n      singleton: opts.singleton ?? true,\n      decorators: [],\n      owner: opts.owner ?? 'core',\n    });\n  }\n\n  override<T>(token: Token<T>, factory: Factory<T>, opts: BindOptions = {}): void {\n    const existing = this.entries.get(token);\n    if (!existing) {\n      throw new WrongStackError({\n        message: `Container: cannot override \"${token.description ?? 'unknown'}\" — not bound`,\n        code: 'CONTAINER_TOKEN_NOT_BOUND',\n        subsystem: 'container',\n        context: { token: token.description },\n      });\n    }\n    this.entries.set(token, {\n      factory: factory as Factory<unknown>,\n      singleton: opts.singleton ?? existing.singleton,\n      decorators: existing.decorators,\n      owner: opts.owner ?? existing.owner,\n    });\n  }\n\n  decorate<T>(token: Token<T>, decorator: Decorator<T>, owner = 'core'): void {\n    const existing = this.entries.get(token);\n    if (!existing) {\n      throw new WrongStackError({\n        message: `Container: cannot decorate \"${token.description ?? 'unknown'}\" — not bound`,\n        code: 'CONTAINER_TOKEN_NOT_BOUND',\n        subsystem: 'container',\n        context: { token: token.description },\n      });\n    }\n    existing.decorators.push(decorator as Decorator<unknown>);\n    existing.cache = undefined;\n    existing.owner = `${existing.owner}+${owner}`;\n  }\n\n  resolve<T>(token: Token<T>): T {\n    const entry = this.entries.get(token);\n    if (!entry) {\n      throw new WrongStackError({\n        message: `Container: token \"${token.description ?? 'unknown'}\" not bound`,\n        code: 'CONTAINER_TOKEN_NOT_BOUND',\n        subsystem: 'container',\n        context: { token: token.description },\n      });\n    }\n    if (entry.singleton && entry.cache !== undefined) {\n      return entry.cache as T;\n    }\n    let value: unknown = entry.factory(this);\n    for (const d of entry.decorators) {\n      value = d(value, this);\n    }\n    if (entry.singleton) {\n      entry.cache = value;\n    }\n    return value as T;\n  }\n\n  has<T>(token: Token<T>): boolean {\n    return this.entries.has(token);\n  }\n\n  ownerOf<T>(token: Token<T>): string | undefined {\n    return this.entries.get(token)?.owner;\n  }\n\n  /**\n   * Remove a token's binding (along with any decorators stacked on it).\n   * Returns true if the token existed. Use this to withdraw temporary\n   * bindings installed by a short-lived run or plugin — without it, the\n   * entry persists in the map forever.\n   */\n  unbind<T>(token: Token<T>): boolean {\n    return this.entries.delete(token);\n  }\n\n  /**\n   * Drop every binding. Intended for tests and short-lived CLI invocations\n   * that rebuild the container from scratch. Production code should prefer\n   * `unbind` on the specific tokens it owns.\n   */\n  clear(): void {\n    this.entries.clear();\n  }\n\n  list(): Array<{ token: symbol; owner: string }> {\n    return Array.from(this.entries.entries()).map(([token, entry]) => ({\n      token,\n      owner: entry.owner,\n    }));\n  }\n\n  /**\n   * Inspect a binding's full shape, including decorator count and whether\n   * a singleton value is cached. Returns null if the token is unbound.\n   * Decorator and factory function references are not exposed — only counts\n   * and metadata, to keep internal state hidden.\n   */\n  inspect<T>(token: Token<T>): {\n    owner: string;\n    singleton: boolean;\n    decoratorCount: number;\n    cached: boolean;\n  } | null {\n    const entry = this.entries.get(token);\n    if (!entry) return null;\n    return {\n      owner: entry.owner,\n      singleton: entry.singleton,\n      decoratorCount: entry.decorators.length,\n      cached: entry.cache !== undefined,\n    };\n  }\n}\n","/**\n * Pipeline — Koa-style middleware chain with named middleware\n * and position-aware insertion. Generic over input type T.\n */\n\nexport type NextFn<T> = (value: T) => Promise<T>;\nexport type MiddlewareHandler<T> = (value: T, next: NextFn<T>) => Promise<T>;\n\n/**\n * Called when a middleware crashes (throws or rejects). Used by the\n * Pipeline's error boundary to log the offender without aborting the run.\n *\n * Return `'rethrow'` to propagate the error (default for core middleware),\n * or `'swallow'` to skip past the crashing middleware and continue with the\n * value the previous one produced. Plugin middleware should usually be\n * swallowed so one bad plugin can't kill an agent run.\n */\nexport type PipelineErrorPolicy = 'rethrow' | 'swallow';\n\nexport interface PipelineErrorEvent {\n  middleware: string;\n  owner?: string;\n  err: unknown;\n}\n\nexport type PipelineErrorHandler = (\n  ev: PipelineErrorEvent,\n) => PipelineErrorPolicy | Promise<PipelineErrorPolicy>;\n\nexport interface Middleware<T> {\n  name: string;\n  handler: MiddlewareHandler<T>;\n  owner?: string;\n}\n\nexport interface PipelineOptions {\n  /** When true and the target middleware is not found, operations silently no-op instead of throwing. */\n  optional?: boolean;\n}\n\n/**\n * Read-only view of a pipeline. Returned to consumers (plugins, hooks)\n * so they can inspect but not mutate the chain.\n */\nexport interface ReadonlyPipeline<T> {\n  readonly size: number;\n  list(): readonly string[];\n  run(input: T): Promise<T>;\n}\n\nexport class Pipeline<T> {\n  private readonly chain: Middleware<T>[] = [];\n  private errorHandler?: PipelineErrorHandler;\n\n  /**\n   * Install an error boundary. When a middleware throws or rejects, the\n   * handler is called and decides whether to swallow (continue with the\n   * pre-handler value) or rethrow. Without a handler, errors propagate.\n   *\n   * Wire one per pipeline at boot — the host CLI typically installs a\n   * single boundary that logs to the operational log and emits a\n   * `pipeline.error` event for /diag.\n   */\n  setErrorHandler(handler: PipelineErrorHandler | undefined): this {\n    this.errorHandler = handler;\n    return this;\n  }\n\n  use(mw: Middleware<T> | Middleware<unknown>): this {\n    this.ensureUnique(mw.name);\n    this.chain.push(mw as Middleware<T>);\n    return this;\n  }\n\n  prepend(mw: Middleware<T>): this {\n    this.ensureUnique(mw.name);\n    this.chain.unshift(mw);\n    return this;\n  }\n\n  /**\n   * Insert middleware at an explicit index. Out-of-range indices are clamped.\n   * Use this when insertBefore/insertAfter are insufficient (e.g. to place\n   * a middleware at a known position regardless of named targets).\n   */\n  insertAt(index: number, mw: Middleware<T>): this {\n    this.ensureUnique(mw.name);\n    const idx = Math.max(0, Math.min(index, this.chain.length));\n    this.chain.splice(idx, 0, mw);\n    return this;\n  }\n\n  /**\n   * Insert mw immediately before the first occurrence of target.\n   * If called multiple times with the same target, each call inserts\n   * before the target's current position — so after insertBefore('B', X)\n   * then insertBefore('B', Y), the order is Y → X → B.\n   */\n  insertBefore(target: string, mw: Middleware<T>, opts?: PipelineOptions): this {\n    this.ensureUnique(mw.name);\n    const idx = this.indexOf(target, opts?.optional);\n    if (idx === -1) return this;\n    this.chain.splice(idx, 0, mw);\n    return this;\n  }\n\n  /**\n   * Insert mw immediately after the first occurrence of target.\n   * If called multiple times with the same target, each call inserts\n   * after the target's current position — so after insertAfter('B', X)\n   * then insertAfter('B', Y), the order is B → X → Y.\n   */\n  insertAfter(target: string, mw: Middleware<T>, opts?: PipelineOptions): this {\n    this.ensureUnique(mw.name);\n    const idx = this.indexOf(target, opts?.optional);\n    if (idx === -1) return this;\n    this.chain.splice(idx + 1, 0, mw);\n    return this;\n  }\n\n  replace(target: string, mw: Middleware<T>, opts?: PipelineOptions): this {\n    if (mw.name !== target) this.ensureUnique(mw.name);\n    const idx = this.indexOf(target, opts?.optional);\n    if (idx === -1) return this;\n    this.chain[idx] = mw;\n    return this;\n  }\n\n  remove(name: string, opts?: PipelineOptions): this {\n    const idx = this.indexOf(name, opts?.optional);\n    if (idx === -1) return this;\n    this.chain.splice(idx, 1);\n    return this;\n  }\n\n  list(): readonly string[] {\n    return this.chain.map((m) => m.name);\n  }\n\n  size(): number {\n    return this.chain.length;\n  }\n\n  /** Return a read-only view suitable for passing to plugins. */\n  asReadonly(): ReadonlyPipeline<T> {\n    // The returned object's methods close over `this`, so it always sees the live chain.\n    // `list()` returns a frozen snapshot to prevent external mutation of the chain.\n    const self = this;\n    return Object.freeze({\n      get size() {\n        return self.size();\n      },\n      list() {\n        return Object.freeze(self.list());\n      },\n      run(input: T) {\n        return self.run(input);\n      },\n    });\n  }\n\n  async run(input: T): Promise<T> {\n    let index = -1;\n    const chain = this.chain;\n    const errorHandler = this.errorHandler;\n\n    const dispatch = async (i: number, value: T): Promise<T> => {\n      if (i <= index) {\n        throw new Error(`Pipeline: next() called multiple times in \"${chain[index]?.name}\"`);\n      }\n      index = i;\n      const mw = chain[i];\n      if (!mw) return value;\n      try {\n        return await mw.handler(value, (v) => dispatch(i + 1, v));\n      } catch (err) {\n        if (!errorHandler) throw err;\n        const policy = await errorHandler({ middleware: mw.name, owner: mw.owner, err });\n        if (policy === 'rethrow') throw err;\n        // Swallow: continue with the value that was about to flow into this\n        // middleware. Subsequent middleware after the crashed one is skipped\n        // — error boundary is \"skip the broken layer\", not \"skip the rest\".\n        return value;\n      }\n    };\n\n    return dispatch(0, input);\n  }\n\n  private indexOf(name: string, optional = false): number {\n    const idx = this.chain.findIndex((m) => m.name === name);\n    if (idx === -1 && !optional) {\n      throw new Error(`Pipeline: middleware \"${name}\" not found`);\n    }\n    return idx;\n  }\n\n  private ensureUnique(name: string): void {\n    if (this.chain.some((m) => m.name === name)) {\n      throw new Error(`Pipeline: middleware \"${name}\" already registered`);\n    }\n  }\n}\n","/**\n * EventBus — observe-only typed event bus.\n * Subscribers cannot modify or cancel. Subscriber exceptions are caught.\n */\n\nimport type { Context } from '../core/context.js';\nimport type { Usage } from '../types/provider.js';\nimport type { Tool, ToolProgressEvent } from '../types/tool.js';\n\nexport interface EventMap {\n  'session.started': { id: string };\n  'session.ended': { id: string; usage: Usage };\n  'session.damaged': { sessionId: string; detail: string };\n  'iteration.started': { ctx: Context; index: number };\n  'iteration.completed': { ctx: Context; index: number };\n  /**\n   * Fired when the agent hits its iteration limit. Listeners (CLI/TUI) can\n   * call `grant(extra)` to allow more iterations, or `deny()` to stop.\n   * If no listener responds within 30s the run ends with 'max_iterations'.\n   */\n  'iteration.limit_reached': {\n    currentIterations: number;\n    currentLimit: number;\n    grant: (extraIterations: number) => void;\n    deny: () => void;\n  };\n  'provider.response': { ctx: Context; usage: Usage; stopReason: string };\n  'provider.text_delta': { ctx: Context; text: string };\n  'provider.thinking_delta': { ctx: Context; text: string };\n  'provider.tool_use_start': { ctx: Context; id: string; name: string };\n  'provider.tool_use_stop': { ctx: Context; id: string };\n  /**\n   * Fired before each retry of a failed provider call. `attempt` is 1-based\n   * (the first retry is attempt 1, etc.). `description` is the human-readable\n   * one-liner from `ProviderError.describe()` — render this in the CLI/TUI\n   * instead of grepping logger output for the raw JSON body.\n   */\n  'provider.retry': {\n    providerId: string;\n    attempt: number;\n    delayMs: number;\n    status: number;\n    description: string;\n  };\n  /**\n   * Fired once when a provider call ultimately fails (retries exhausted, or\n   * non-retryable error). Same shape as `provider.retry` minus the delay.\n   */\n  'provider.error': {\n    providerId: string;\n    status: number;\n    description: string;\n    retryable: boolean;\n  };\n  'tool.started': { name: string; id: string; input?: unknown };\n  /**\n   * Fired for each ToolProgressEvent yielded by `Tool.executeStream`. UIs\n   * subscribe to render incremental progress (streaming bash output, file\n   * tree counts, etc.) without the tool having to know about the UI.\n   */\n  'tool.progress': { name: string; id: string; event: ToolProgressEvent };\n  /**\n   * Fired when a tool call needs user confirmation and no confirmHandler\n   * is registered on the executor. The TUI renders a confirmation dialog\n   * from this event. Resolution is driven by calling the resolve function\n   * passed in the payload with a decision string ('yes' | 'no' | 'always' | 'deny').\n   */\n  'tool.confirm_needed': {\n    tool: Tool;\n    input: unknown;\n    toolUseId: string;\n    suggestedPattern: string;\n    resolve: (decision: 'yes' | 'no' | 'always' | 'deny') => void;\n  };\n  /**\n   * `output` is a truncated preview of the tool's serialized result text\n   * (capped at ~400 chars by the emitter). UIs render this inline in the\n   * tool history line without re-fetching from the session log.\n   */\n  'tool.executed': {\n    /**\n     * The tool_use id (e.g. \"toolu_…\") issued by the provider for this call.\n     * Pairs with `tool.started.id` so subscribers can correlate start/finish\n     * even when the model fires multiple tools in parallel with identical\n     * inputs. Optional only for legacy emit sites — new code should always\n     * set it.\n     */\n    id?: string;\n    name: string;\n    durationMs: number;\n    ok: boolean;\n    input?: unknown;\n    output?: string;\n    /**\n     * Full UTF-8 byte length of the serialized tool result that the model\n     * actually sees (post-cap, post-scrub). The `output` preview is capped\n     * at ~400 chars for transport; this number lets UIs surface what the\n     * model is really paying tokens for. Optional only for legacy emit\n     * sites that may not yet populate it.\n     */\n    outputBytes?: number;\n    /**\n     * Estimated token count for the full result body the model sees.\n     * Computed from `outputBytes` with the standard ~3.5 chars/token\n     * heuristic. Cheap to show in the TUI; not authoritative — the real\n     * provider count lives in `provider.response.usage`. */\n    outputTokens?: number;\n    /**\n     * For tools whose output has a clear \"line\" notion (file reads with\n     * numbered prefixes, grep hits, bash stdout), the agent counts the\n     * actual lines the model received and forwards it here. Undefined\n     * for tools without a meaningful line count. */\n    outputLines?: number;\n  };\n  'token.threshold': { used: number; limit: number };\n  'compaction.fired': { before: number; after: number };\n  /**\n   * Fired when the auto-compaction middleware's compactor.compact() call\n   * throws. Compaction is best-effort by design so we don't crash the agent\n   * loop, but a persistent failure (misconfigured summarizer model, network\n   * outage) means the next iteration may hit context overflow. Observability\n   * layers / dashboards subscribe to this to surface the silent regression.\n   */\n  'compaction.failed': {\n    err: Error;\n    aggressive: boolean;\n    level: 'warn' | 'soft' | 'hard';\n    tokens: number;\n    maxContext: number;\n    load: number;\n    fatal: boolean;\n  };\n  /**\n   * Subagent lifecycle events. Emitted by `MultiAgentHost` so the TUI can\n   * surface what's happening in the fleet without needing director-mode\n   * (which renders the live FleetPanel). These complement the FleetBus\n   * (director-only) by giving the TUI a uniform feed for both `/spawn`\n   * and director-orchestrated work.\n   */\n  'subagent.spawned': {\n    subagentId: string;\n    taskId: string;\n    name?: string;\n    provider?: string;\n    model?: string;\n    description?: string;\n    /**\n     * Absolute path to the per-subagent JSONL transcript on disk, when\n     * one was created. Undefined when the subagent shares the parent\n     * session writer (in-memory or single-file configurations).\n     * Surfaced so the TUI (FleetPanel) and `/fleet log` can show the\n     * user *where* to look without computing it from the run id.\n     */\n    transcriptPath?: string;\n  };\n  'subagent.task_started': {\n    subagentId: string;\n    taskId: string;\n    description?: string;\n  };\n  /**\n   * Per-tool-call event re-emitted from a subagent's own EventBus\n   * onto the host EventBus, so the TUI / non-director surfaces can\n   * render \"AGENT#1 ● bash 250ms\" without having to subscribe to\n   * the director-only FleetBus. Fired AFTER the tool completes\n   * (paired with `tool.executed`). Includes the subagent id so\n   * multiple parallel subagents are distinguishable.\n   */\n  'subagent.tool_executed': {\n    subagentId: string;\n    taskId?: string;\n    name: string;\n    durationMs: number;\n    ok: boolean;\n    input?: unknown;\n    outputBytes?: number;\n  };\n  'subagent.task_completed': {\n    subagentId: string;\n    taskId: string;\n    status: 'success' | 'failed' | 'timeout' | 'stopped';\n    iterations: number;\n    toolCalls: number;\n    durationMs: number;\n    /**\n     * Structured failure envelope when `status !== 'success'`. Carries\n     * `kind` (one of `SubagentErrorKind`), `message`, `retryable`, and\n     * optional `backoffMs`. UIs branch on `kind` to render the right\n     * chip (rate_limit vs auth vs tool_failed). The type is imported\n     * lazily as a structural object to avoid a coordination → kernel\n     * cycle in the dependency graph.\n     */\n    error?: {\n      kind: string;\n      message: string;\n      retryable: boolean;\n      backoffMs?: number;\n      cause?: { name: string; message: string; stack?: string };\n    };\n  };\n  'mcp.server.connected': { name: string; toolCount: number };\n  'mcp.server.reconnected': { name: string; toolCount: number };\n  'mcp.server.disconnected': { name: string; reason: string };\n  'token.cost_estimate_unavailable': { model: string };\n  error: { err: Error; phase: string };\n}\n\nexport type EventName = keyof EventMap;\nexport type Listener<E extends EventName> = (payload: EventMap[E]) => void;\n\nexport interface EventLogger {\n  error(msg: string, ctx?: unknown): void;\n}\n\nexport class EventBus {\n  private readonly listeners = new Map<EventName, Set<Listener<EventName>>>();\n  private logger?: EventLogger;\n\n  setLogger(logger: EventLogger): void {\n    this.logger = logger;\n  }\n\n  on<E extends EventName>(event: E, fn: Listener<E>): () => void {\n    let set = this.listeners.get(event);\n    if (!set) {\n      set = new Set();\n      this.listeners.set(event, set);\n    }\n    set.add(fn as Listener<EventName>);\n    return () => this.off(event, fn);\n  }\n\n  off<E extends EventName>(event: E, fn: Listener<E>): void {\n    this.listeners.get(event)?.delete(fn as Listener<EventName>);\n  }\n\n  once<E extends EventName>(event: E, fn: Listener<E>): () => void {\n    const wrapper: Listener<E> = (payload) => {\n      this.off(event, wrapper as Listener<EventName>);\n      (fn as Listener<E>)(payload);\n    };\n    this.on(event, wrapper as Listener<E>);\n    return () => {\n      this.off(event, wrapper as Listener<EventName>);\n    };\n  }\n\n  emit<E extends EventName>(event: E, payload: EventMap[E]): void {\n    const set = this.listeners.get(event);\n    if (!set) return;\n    for (const fn of set) {\n      try {\n        (fn as Listener<E>)(payload);\n      } catch (err) {\n        this.logger?.error(`EventBus listener for \"${event}\" threw`, err);\n      }\n    }\n  }\n\n  clear(): void {\n    this.listeners.clear();\n  }\n\n  /**\n   * V2-D: introspection helper. Pass an `event` to count handlers for a\n   * single key, or omit to get the total across every event. Used by the\n   * leak-detection smoke test to flag handler accumulation across runs.\n   */\n  listenerCount(event?: EventName): number {\n    if (event !== undefined) return this.listeners.get(event)?.size ?? 0;\n    let total = 0;\n    for (const set of this.listeners.values()) total += set.size;\n    return total;\n  }\n}\n","import type { Compactor } from '../types/compactor.js';\nimport type { ConfigLoader, ConfigStore } from '../types/config.js';\nimport type { ErrorHandler } from '../types/error-handler.js';\nimport type { InputReader } from '../types/input-reader.js';\nimport type { Logger } from '../types/logger.js';\nimport type { MemoryStore } from '../types/memory.js';\nimport type { ModeStore } from '../types/mode.js';\nimport type { ModelsRegistry } from '../types/models-registry.js';\nimport type { PathResolver } from '../types/path-resolver.js';\nimport type { PermissionPolicy } from '../types/permission.js';\nimport type { Renderer } from '../types/renderer.js';\nimport type { RetryPolicy } from '../types/retry-policy.js';\nimport type { SecretScrubber } from '../types/secret-scrubber.js';\nimport type { SessionStore } from '../types/session.js';\nimport type { SkillLoader } from '../types/skill.js';\nimport type { SystemPromptBuilder } from '../types/system-prompt.js';\nimport type { TokenCounter } from '../types/token-counter.js';\nimport type { Token } from './container.js';\n\nconst t = <T>(name: string): Token<T> => Symbol(name) as Token<T>;\n\nexport const TOKENS = {\n  Logger: t<Logger>('Logger'),\n  TokenCounter: t<TokenCounter>('TokenCounter'),\n  SessionStore: t<SessionStore>('SessionStore'),\n  MemoryStore: t<MemoryStore>('MemoryStore'),\n  PermissionPolicy: t<PermissionPolicy>('PermissionPolicy'),\n  Compactor: t<Compactor>('Compactor'),\n  PathResolver: t<PathResolver>('PathResolver'),\n  ConfigLoader: t<ConfigLoader>('ConfigLoader'),\n  ConfigStore: t<ConfigStore>('ConfigStore'),\n  Renderer: t<Renderer>('Renderer'),\n  InputReader: t<InputReader>('InputReader'),\n  ErrorHandler: t<ErrorHandler>('ErrorHandler'),\n  RetryPolicy: t<RetryPolicy>('RetryPolicy'),\n  SkillLoader: t<SkillLoader>('SkillLoader'),\n  SystemPromptBuilder: t<SystemPromptBuilder>('SystemPromptBuilder'),\n  SecretScrubber: t<SecretScrubber>('SecretScrubber'),\n  ModelsRegistry: t<ModelsRegistry>('ModelsRegistry'),\n  ModeStore: t<ModeStore>('ModeStore'),\n} as const;\n","/**\n * RunController centralises abort + cleanup for a single agent run. It\n * wraps a single AbortController and exposes a registry of teardown\n * hooks that fire (LIFO, exactly once) when the run aborts OR ends\n * normally. Anyone holding the controller can:\n *\n *   - read `signal` to bail out cooperatively\n *   - call `abort(reason?)` to abort the run\n *   - call `onAbort(fn)` to register a cleanup hook\n *   - call `dispose()` when the run ends normally — this fires the\n *     hooks too, so cleanup runs regardless of outcome\n *\n * Hooks must be idempotent and synchronous-or-quick. Errors thrown\n * inside hooks are caught and surfaced through `errorSink` (or the\n * console as a last resort) so one bad hook can't block the others.\n */\nexport interface RunControllerOptions {\n  /** Optional parent signal — abort propagates from parent → this. */\n  parentSignal?: AbortSignal;\n  /** Receives errors thrown by cleanup hooks. Defaults to console.warn. */\n  errorSink?: (err: unknown, where: string) => void;\n}\n\nexport class RunController {\n  private readonly ctrl = new AbortController();\n  private readonly hooks: Array<() => void | Promise<void>> = [];\n  private disposed = false;\n  private hooksDrained = false;\n  private readonly errorSink: (err: unknown, where: string) => void;\n\n  constructor(opts: RunControllerOptions = {}) {\n    this.errorSink =\n      opts.errorSink ??\n      ((err, where) => {\n        console.warn(`[run] cleanup hook failed in ${where}:`, err);\n      });\n    if (opts.parentSignal) {\n      const parent = opts.parentSignal;\n      if (parent.aborted) {\n        this.ctrl.abort(parent.reason);\n      } else {\n        const onParentAbort = () => this.ctrl.abort(parent.reason);\n        parent.addEventListener('abort', onParentAbort, { once: true });\n        // When this run finishes normally, stop listening on the parent.\n        this.onAbort(() => parent.removeEventListener('abort', onParentAbort));\n      }\n    }\n    this.ctrl.signal.addEventListener(\n      'abort',\n      () => {\n        void this.runHooks();\n      },\n      { once: true },\n    );\n  }\n\n  get signal(): AbortSignal {\n    return this.ctrl.signal;\n  }\n\n  get aborted(): boolean {\n    return this.ctrl.signal.aborted;\n  }\n\n  abort(reason?: unknown): void {\n    if (this.ctrl.signal.aborted) return;\n    this.ctrl.abort(reason);\n  }\n\n  /**\n   * Register a teardown hook. Returns an unsubscribe function so callers\n   * can opt out before the hook fires (e.g. when a tool finishes cleanly\n   * before abort happens).\n   */\n  onAbort(fn: () => void | Promise<void>): () => void {\n    this.hooks.push(fn);\n    return () => {\n      const idx = this.hooks.indexOf(fn);\n      if (idx !== -1) this.hooks.splice(idx, 1);\n    };\n  }\n\n  /**\n   * Fire cleanup hooks and tear down listeners — called when the run\n   * ends *normally* so cleanup happens regardless of outcome. Subsequent\n   * aborts become no-ops.\n   */\n  async dispose(): Promise<void> {\n    if (this.disposed) return;\n    this.disposed = true;\n    await this.runHooks();\n  }\n\n  private async runHooks(): Promise<void> {\n    if (this.hooksDrained) return;\n    this.hooksDrained = true;\n    // Snapshot + clear so hooks added during cleanup don't re-fire.\n    const snapshot = this.hooks.splice(0, this.hooks.length).reverse();\n    for (const hook of snapshot) {\n      try {\n        await hook();\n      } catch (err) {\n        this.errorSink(err, 'RunController.dispose');\n      }\n    }\n  }\n}\n"]}
+{"version":3,"sources":["../../src/types/errors.ts","../../src/kernel/container.ts","../../src/kernel/pipeline.ts","../../src/kernel/events.ts","../../src/kernel/tokens.ts","../../src/kernel/run-controller.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * WrongStack error hierarchy.\n *\n * Every error thrown by the framework is a `WrongStackError` with a\n * machine-readable `code`, a `subsystem` tag, and a `severity` level.\n * This lets consumers (CLI, TUI, plugins, tests) branch on structured\n * data instead of parsing error messages.\n */\n\n// ── Error codes ──────────────────────────────────────────────────────\n\nexport type ErrorCode =\n  // Provider\n  | 'PROVIDER_RATE_LIMITED'\n  | 'PROVIDER_AUTH_FAILED'\n  | 'PROVIDER_OVERLOADED'\n  | 'PROVIDER_INVALID_REQUEST'\n  | 'PROVIDER_SERVER_ERROR'\n  | 'PROVIDER_NETWORK_ERROR'\n  | 'PROVIDER_CONTEXT_OVERFLOW'\n  // Tool\n  | 'TOOL_NOT_FOUND'\n  | 'TOOL_PERMISSION_DENIED'\n  | 'TOOL_EXECUTION_FAILED'\n  | 'TOOL_TIMEOUT'\n  | 'TOOL_INPUT_INVALID'\n  // Config\n  | 'CONFIG_INVALID'\n  | 'CONFIG_NOT_FOUND'\n  | 'CONFIG_PARSE_FAILED'\n  | 'CONFIG_MIGRATION_NEEDED'\n  // Plugin\n  | 'PLUGIN_LOAD_FAILED'\n  | 'PLUGIN_API_MISMATCH'\n  | 'PLUGIN_MISSING_DEPENDENCY'\n  // Agent\n  | 'AGENT_ITERATION_LIMIT'\n  | 'AGENT_CONTEXT_OVERFLOW'\n  | 'AGENT_ABORTED'\n  | 'AGENT_RUN_FAILED'\n  // Session\n  | 'SESSION_NOT_FOUND'\n  | 'SESSION_CORRUPTED'\n  | 'SESSION_WRITE_FAILED'\n  // Container / Registry\n  | 'CONTAINER_TOKEN_ALREADY_BOUND'\n  | 'CONTAINER_TOKEN_NOT_BOUND'\n  | 'REGISTRY_DUPLICATE'\n  | 'REGISTRY_NOT_FOUND'\n  // General\n  | 'UNKNOWN';\n\nexport type ErrorSubsystem =\n  | 'provider'\n  | 'tool'\n  | 'config'\n  | 'plugin'\n  | 'agent'\n  | 'session'\n  | 'container'\n  | 'general';\nexport type ErrorSeverity = 'fatal' | 'error' | 'warning';\n\n// ── Base error class ─────────────────────────────────────────────────\n\nexport class WrongStackError extends Error {\n  readonly code: ErrorCode;\n  readonly subsystem: ErrorSubsystem;\n  readonly severity: ErrorSeverity;\n  readonly recoverable: boolean;\n  readonly context?: Record<string, unknown>;\n\n  constructor(opts: {\n    message: string;\n    code: ErrorCode;\n    subsystem: ErrorSubsystem;\n    severity?: ErrorSeverity;\n    recoverable?: boolean;\n    context?: Record<string, unknown>;\n    cause?: unknown;\n  }) {\n    super(opts.message, { cause: opts.cause });\n    this.name = 'WrongStackError';\n    this.code = opts.code;\n    this.subsystem = opts.subsystem;\n    this.severity = opts.severity ?? 'error';\n    this.recoverable = opts.recoverable ?? false;\n    this.context = opts.context;\n  }\n\n  /**\n   * Render a one-line user-facing description.\n   * Subclasses should override for domain-specific formatting.\n   */\n  describe(): string {\n    const ctx = this.context ? ` ${formatContext(this.context)}` : '';\n    return `${this.code}: ${this.message}${ctx}`;\n  }\n}\n\nfunction formatContext(ctx: Record<string, unknown>): string {\n  const parts = Object.entries(ctx)\n    .filter(([, v]) => v !== undefined)\n    .slice(0, 3)\n    .map(([k, v]) => `${k}=${String(v)}`);\n  return parts.length > 0 ? `[${parts.join(' ')}]` : '';\n}\n\n// ── Specific error classes ───────────────────────────────────────────\n\n/**\n * Tool execution errors — thrown by ToolExecutor and individual tools.\n */\nexport class ToolError extends WrongStackError {\n  readonly toolName: string;\n\n  constructor(opts: {\n    message: string;\n    code: Extract<\n      ErrorCode,\n      | 'TOOL_NOT_FOUND'\n      | 'TOOL_PERMISSION_DENIED'\n      | 'TOOL_EXECUTION_FAILED'\n      | 'TOOL_TIMEOUT'\n      | 'TOOL_INPUT_INVALID'\n    >;\n    toolName: string;\n    recoverable?: boolean;\n    context?: Record<string, unknown>;\n    cause?: unknown;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'tool',\n      recoverable: opts.recoverable,\n      context: { tool: opts.toolName, ...opts.context },\n      cause: opts.cause,\n    });\n    this.name = 'ToolError';\n    this.toolName = opts.toolName;\n  }\n}\n\n/**\n * Config loading / validation errors.\n */\nexport class ConfigError extends WrongStackError {\n  constructor(opts: {\n    message: string;\n    code: Extract<\n      ErrorCode,\n      'CONFIG_INVALID' | 'CONFIG_NOT_FOUND' | 'CONFIG_PARSE_FAILED' | 'CONFIG_MIGRATION_NEEDED'\n    >;\n    context?: Record<string, unknown>;\n    cause?: unknown;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'config',\n      severity: 'fatal',\n      recoverable: false,\n      context: opts.context,\n      cause: opts.cause,\n    });\n    this.name = 'ConfigError';\n  }\n}\n\n/**\n * Plugin loading / lifecycle errors.\n */\nexport class PluginError extends WrongStackError {\n  readonly pluginName: string;\n\n  constructor(opts: {\n    message: string;\n    code: Extract<\n      ErrorCode,\n      'PLUGIN_LOAD_FAILED' | 'PLUGIN_API_MISMATCH' | 'PLUGIN_MISSING_DEPENDENCY'\n    >;\n    pluginName: string;\n    context?: Record<string, unknown>;\n    cause?: unknown;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'plugin',\n      severity: 'error',\n      recoverable: opts.code === 'PLUGIN_MISSING_DEPENDENCY',\n      context: { plugin: opts.pluginName, ...opts.context },\n      cause: opts.cause,\n    });\n    this.name = 'PluginError';\n    this.pluginName = opts.pluginName;\n  }\n}\n\n/**\n * Agent runtime errors — thrown by Agent.run when a non-WrongStackError\n * escapes the inner loop, so callers always see a structured error.\n */\nexport class AgentError extends WrongStackError {\n  constructor(opts: {\n    message: string;\n    code: Extract<\n      ErrorCode,\n      'AGENT_ITERATION_LIMIT' | 'AGENT_CONTEXT_OVERFLOW' | 'AGENT_ABORTED' | 'AGENT_RUN_FAILED'\n    >;\n    recoverable?: boolean;\n    context?: Record<string, unknown>;\n    cause?: unknown;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'agent',\n      severity: opts.code === 'AGENT_ABORTED' ? 'warning' : 'error',\n      recoverable: opts.recoverable ?? opts.code === 'AGENT_ITERATION_LIMIT',\n      context: opts.context,\n      cause: opts.cause,\n    });\n    this.name = 'AgentError';\n  }\n}\n\n/**\n * Wrap an arbitrary thrown value into a `WrongStackError` so the caller\n * always gets a structured error. Pass-throughs WrongStackError instances\n * unchanged; raw `Error`s and primitives get an `AGENT_RUN_FAILED` wrapper\n * with the original preserved as `cause`.\n */\nexport function toWrongStackError(\n  err: unknown,\n  code: Extract<ErrorCode, 'AGENT_RUN_FAILED' | 'AGENT_ABORTED' | 'UNKNOWN'> = 'AGENT_RUN_FAILED',\n): WrongStackError {\n  if (err instanceof WrongStackError) return err;\n  const message = err instanceof Error ? err.message : String(err);\n  return new AgentError({\n    message,\n    code: code === 'UNKNOWN' ? 'AGENT_RUN_FAILED' : code,\n    cause: err,\n  });\n}\n\n/**\n * Session storage errors.\n */\nexport class SessionError extends WrongStackError {\n  readonly sessionId?: string;\n\n  constructor(opts: {\n    message: string;\n    code: Extract<ErrorCode, 'SESSION_NOT_FOUND' | 'SESSION_CORRUPTED' | 'SESSION_WRITE_FAILED'>;\n    sessionId?: string;\n    context?: Record<string, unknown>;\n    cause?: unknown;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'session',\n      severity: opts.code === 'SESSION_WRITE_FAILED' ? 'error' : 'warning',\n      recoverable: opts.code !== 'SESSION_CORRUPTED',\n      context: { sessionId: opts.sessionId, ...opts.context },\n      cause: opts.cause,\n    });\n    this.name = 'SessionError';\n    this.sessionId = opts.sessionId;\n  }\n}\n\n// ── Type guards ──────────────────────────────────────────────────────\n\nexport function isWrongStackError(err: unknown): err is WrongStackError {\n  return err instanceof WrongStackError;\n}\n\nexport function isToolError(err: unknown): err is ToolError {\n  return err instanceof ToolError;\n}\n\nexport function isConfigError(err: unknown): err is ConfigError {\n  return err instanceof ConfigError;\n}\n\nexport function isPluginError(err: unknown): err is PluginError {\n  return err instanceof PluginError;\n}\n\nexport function isSessionError(err: unknown): err is SessionError {\n  return err instanceof SessionError;\n}\n\nexport function isAgentError(err: unknown): err is AgentError {\n  return err instanceof AgentError;\n}\n","import { WrongStackError } from '../types/errors.js';\n\n/**\n * Container — dependency injection with explicit bind / override / decorate.\n *\n * Invariants:\n *   bind()     — throws if token already bound\n *   override() — throws if nothing to replace\n *   decorate() — stacks; cached value cleared on register\n */\n\nexport type Token<T> = symbol & { readonly __type?: T };\nexport type Factory<T> = (c: Container) => T;\nexport type Decorator<T> = (inner: T, c: Container) => T;\n\ninterface Entry<T = unknown> {\n  factory: Factory<T>;\n  singleton: boolean;\n  decorators: Decorator<T>[];\n  cache?: T;\n  owner: string;\n}\n\nexport interface BindOptions {\n  singleton?: boolean;\n  owner?: string;\n}\n\nexport class Container {\n  private readonly entries = new Map<symbol, Entry>();\n\n  bind<T>(token: Token<T>, factory: Factory<T>, opts: BindOptions = {}): void {\n    if (this.entries.has(token)) {\n      throw new WrongStackError({\n        message: `Container: token \"${token.description ?? 'unknown'}\" already bound`,\n        code: 'CONTAINER_TOKEN_ALREADY_BOUND',\n        subsystem: 'container',\n        context: { token: token.description },\n      });\n    }\n    this.entries.set(token, {\n      factory: factory as Factory<unknown>,\n      singleton: opts.singleton ?? true,\n      decorators: [],\n      owner: opts.owner ?? 'core',\n    });\n  }\n\n  override<T>(token: Token<T>, factory: Factory<T>, opts: BindOptions = {}): void {\n    const existing = this.entries.get(token);\n    if (!existing) {\n      throw new WrongStackError({\n        message: `Container: cannot override \"${token.description ?? 'unknown'}\" — not bound`,\n        code: 'CONTAINER_TOKEN_NOT_BOUND',\n        subsystem: 'container',\n        context: { token: token.description },\n      });\n    }\n    this.entries.set(token, {\n      factory: factory as Factory<unknown>,\n      singleton: opts.singleton ?? existing.singleton,\n      decorators: existing.decorators,\n      owner: opts.owner ?? existing.owner,\n    });\n  }\n\n  decorate<T>(token: Token<T>, decorator: Decorator<T>, owner = 'core'): void {\n    const existing = this.entries.get(token);\n    if (!existing) {\n      throw new WrongStackError({\n        message: `Container: cannot decorate \"${token.description ?? 'unknown'}\" — not bound`,\n        code: 'CONTAINER_TOKEN_NOT_BOUND',\n        subsystem: 'container',\n        context: { token: token.description },\n      });\n    }\n    existing.decorators.push(decorator as Decorator<unknown>);\n    existing.cache = undefined;\n    existing.owner = `${existing.owner}+${owner}`;\n  }\n\n  resolve<T>(token: Token<T>): T {\n    const entry = this.entries.get(token);\n    if (!entry) {\n      throw new WrongStackError({\n        message: `Container: token \"${token.description ?? 'unknown'}\" not bound`,\n        code: 'CONTAINER_TOKEN_NOT_BOUND',\n        subsystem: 'container',\n        context: { token: token.description },\n      });\n    }\n    if (entry.singleton && entry.cache !== undefined) {\n      return entry.cache as T;\n    }\n    let value: unknown = entry.factory(this);\n    for (const d of entry.decorators) {\n      value = d(value, this);\n    }\n    if (entry.singleton) {\n      entry.cache = value;\n    }\n    return value as T;\n  }\n\n  has<T>(token: Token<T>): boolean {\n    return this.entries.has(token);\n  }\n\n  ownerOf<T>(token: Token<T>): string | undefined {\n    return this.entries.get(token)?.owner;\n  }\n\n  /**\n   * Remove a token's binding (along with any decorators stacked on it).\n   * Returns true if the token existed. Use this to withdraw temporary\n   * bindings installed by a short-lived run or plugin — without it, the\n   * entry persists in the map forever.\n   */\n  unbind<T>(token: Token<T>): boolean {\n    return this.entries.delete(token);\n  }\n\n  /**\n   * Drop every binding. Intended for tests and short-lived CLI invocations\n   * that rebuild the container from scratch. Production code should prefer\n   * `unbind` on the specific tokens it owns.\n   */\n  clear(): void {\n    this.entries.clear();\n  }\n\n  list(): Array<{ token: symbol; owner: string }> {\n    return Array.from(this.entries.entries()).map(([token, entry]) => ({\n      token,\n      owner: entry.owner,\n    }));\n  }\n\n  /**\n   * Inspect a binding's full shape, including decorator count and whether\n   * a singleton value is cached. Returns null if the token is unbound.\n   * Decorator and factory function references are not exposed — only counts\n   * and metadata, to keep internal state hidden.\n   */\n  inspect<T>(token: Token<T>): {\n    owner: string;\n    singleton: boolean;\n    decoratorCount: number;\n    cached: boolean;\n  } | null {\n    const entry = this.entries.get(token);\n    if (!entry) return null;\n    return {\n      owner: entry.owner,\n      singleton: entry.singleton,\n      decoratorCount: entry.decorators.length,\n      cached: entry.cache !== undefined,\n    };\n  }\n}\n","/**\n * Pipeline — Koa-style middleware chain with named middleware\n * and position-aware insertion. Generic over input type T.\n */\n\nexport type NextFn<T> = (value: T) => Promise<T>;\nexport type MiddlewareHandler<T> = (value: T, next: NextFn<T>) => Promise<T>;\n\n/**\n * Called when a middleware crashes (throws or rejects). Used by the\n * Pipeline's error boundary to log the offender without aborting the run.\n *\n * Return `'rethrow'` to propagate the error (default for core middleware),\n * or `'swallow'` to skip past the crashing middleware and continue with the\n * value the previous one produced. Plugin middleware should usually be\n * swallowed so one bad plugin can't kill an agent run.\n */\nexport type PipelineErrorPolicy = 'rethrow' | 'swallow';\n\nexport interface PipelineErrorEvent {\n  middleware: string;\n  owner?: string;\n  err: unknown;\n}\n\nexport type PipelineErrorHandler = (\n  ev: PipelineErrorEvent,\n) => PipelineErrorPolicy | Promise<PipelineErrorPolicy>;\n\nexport interface Middleware<T> {\n  name: string;\n  handler: MiddlewareHandler<T>;\n  owner?: string;\n}\n\nexport interface PipelineOptions {\n  /** When true and the target middleware is not found, operations silently no-op instead of throwing. */\n  optional?: boolean;\n}\n\n/**\n * Read-only view of a pipeline. Returned to consumers (plugins, hooks)\n * so they can inspect but not mutate the chain.\n */\nexport interface ReadonlyPipeline<T> {\n  readonly size: number;\n  list(): readonly string[];\n  run(input: T): Promise<T>;\n}\n\nexport class Pipeline<T> {\n  private readonly chain: Middleware<T>[] = [];\n  private errorHandler?: PipelineErrorHandler;\n\n  /**\n   * Install an error boundary. When a middleware throws or rejects, the\n   * handler is called and decides whether to swallow (continue with the\n   * pre-handler value) or rethrow. Without a handler, errors propagate.\n   *\n   * Wire one per pipeline at boot — the host CLI typically installs a\n   * single boundary that logs to the operational log and emits a\n   * `pipeline.error` event for /diag.\n   */\n  setErrorHandler(handler: PipelineErrorHandler | undefined): this {\n    this.errorHandler = handler;\n    return this;\n  }\n\n  use(mw: Middleware<T> | Middleware<unknown>): this {\n    this.ensureUnique(mw.name);\n    this.chain.push(mw as Middleware<T>);\n    return this;\n  }\n\n  prepend(mw: Middleware<T>): this {\n    this.ensureUnique(mw.name);\n    this.chain.unshift(mw);\n    return this;\n  }\n\n  /**\n   * Insert middleware at an explicit index. Out-of-range indices are clamped.\n   * Use this when insertBefore/insertAfter are insufficient (e.g. to place\n   * a middleware at a known position regardless of named targets).\n   */\n  insertAt(index: number, mw: Middleware<T>): this {\n    this.ensureUnique(mw.name);\n    const idx = Math.max(0, Math.min(index, this.chain.length));\n    this.chain.splice(idx, 0, mw);\n    return this;\n  }\n\n  /**\n   * Insert mw immediately before the first occurrence of target.\n   * If called multiple times with the same target, each call inserts\n   * before the target's current position — so after insertBefore('B', X)\n   * then insertBefore('B', Y), the order is Y → X → B.\n   */\n  insertBefore(target: string, mw: Middleware<T>, opts?: PipelineOptions): this {\n    this.ensureUnique(mw.name);\n    const idx = this.indexOf(target, opts?.optional);\n    if (idx === -1) return this;\n    this.chain.splice(idx, 0, mw);\n    return this;\n  }\n\n  /**\n   * Insert mw immediately after the first occurrence of target.\n   * If called multiple times with the same target, each call inserts\n   * after the target's current position — so after insertAfter('B', X)\n   * then insertAfter('B', Y), the order is B → X → Y.\n   */\n  insertAfter(target: string, mw: Middleware<T>, opts?: PipelineOptions): this {\n    this.ensureUnique(mw.name);\n    const idx = this.indexOf(target, opts?.optional);\n    if (idx === -1) return this;\n    this.chain.splice(idx + 1, 0, mw);\n    return this;\n  }\n\n  replace(target: string, mw: Middleware<T>, opts?: PipelineOptions): this {\n    if (mw.name !== target) this.ensureUnique(mw.name);\n    const idx = this.indexOf(target, opts?.optional);\n    if (idx === -1) return this;\n    this.chain[idx] = mw;\n    return this;\n  }\n\n  remove(name: string, opts?: PipelineOptions): this {\n    const idx = this.indexOf(name, opts?.optional);\n    if (idx === -1) return this;\n    this.chain.splice(idx, 1);\n    return this;\n  }\n\n  list(): readonly string[] {\n    return this.chain.map((m) => m.name);\n  }\n\n  size(): number {\n    return this.chain.length;\n  }\n\n  /** Return a read-only view suitable for passing to plugins. */\n  asReadonly(): ReadonlyPipeline<T> {\n    // The returned object's methods close over `this`, so it always sees the live chain.\n    // `list()` returns a frozen snapshot to prevent external mutation of the chain.\n    const self = this;\n    return Object.freeze({\n      get size() {\n        return self.size();\n      },\n      list() {\n        return Object.freeze(self.list());\n      },\n      run(input: T) {\n        return self.run(input);\n      },\n    });\n  }\n\n  async run(input: T): Promise<T> {\n    let index = -1;\n    const chain = this.chain;\n    const errorHandler = this.errorHandler;\n\n    const dispatch = async (i: number, value: T): Promise<T> => {\n      if (i <= index) {\n        throw new Error(`Pipeline: next() called multiple times in \"${chain[index]?.name}\"`);\n      }\n      index = i;\n      const mw = chain[i];\n      if (!mw) return value;\n      try {\n        return await mw.handler(value, (v) => dispatch(i + 1, v));\n      } catch (err) {\n        if (!errorHandler) throw err;\n        const policy = await errorHandler({ middleware: mw.name, owner: mw.owner, err });\n        if (policy === 'rethrow') throw err;\n        // Swallow: continue with the value that was about to flow into this\n        // middleware. Subsequent middleware after the crashed one is skipped\n        // — error boundary is \"skip the broken layer\", not \"skip the rest\".\n        return value;\n      }\n    };\n\n    return dispatch(0, input);\n  }\n\n  private indexOf(name: string, optional = false): number {\n    const idx = this.chain.findIndex((m) => m.name === name);\n    if (idx === -1 && !optional) {\n      throw new Error(`Pipeline: middleware \"${name}\" not found`);\n    }\n    return idx;\n  }\n\n  private ensureUnique(name: string): void {\n    if (this.chain.some((m) => m.name === name)) {\n      throw new Error(`Pipeline: middleware \"${name}\" already registered`);\n    }\n  }\n}\n","/**\n * EventBus — observe-only typed event bus.\n * Subscribers cannot modify or cancel. Subscriber exceptions are caught.\n */\n\nimport type { Context } from '../core/context.js';\nimport type { Usage } from '../types/provider.js';\nimport type { Tool, ToolProgressEvent } from '../types/tool.js';\n\nexport interface EventMap {\n  'session.started': { id: string };\n  'session.ended': { id: string; usage: Usage };\n  'session.damaged': { sessionId: string; detail: string };\n  'iteration.started': { ctx: Context; index: number };\n  'iteration.completed': { ctx: Context; index: number };\n  /**\n   * Fired when the agent hits its iteration limit. Listeners (CLI/TUI) can\n   * call `grant(extra)` to allow more iterations, or `deny()` to stop.\n   * If no listener responds within 30s the run ends with 'max_iterations'.\n   */\n  'iteration.limit_reached': {\n    currentIterations: number;\n    currentLimit: number;\n    grant: (extraIterations: number) => void;\n    deny: () => void;\n  };\n  'provider.response': { ctx: Context; usage: Usage; stopReason: string };\n  'provider.text_delta': { ctx: Context; text: string };\n  'provider.thinking_delta': { ctx: Context; text: string };\n  'provider.tool_use_start': { ctx: Context; id: string; name: string };\n  'provider.tool_use_stop': { ctx: Context; id: string };\n  /**\n   * Fired before each retry of a failed provider call. `attempt` is 1-based\n   * (the first retry is attempt 1, etc.). `description` is the human-readable\n   * one-liner from `ProviderError.describe()` — render this in the CLI/TUI\n   * instead of grepping logger output for the raw JSON body.\n   */\n  'provider.retry': {\n    providerId: string;\n    attempt: number;\n    delayMs: number;\n    status: number;\n    description: string;\n  };\n  /**\n   * Fired once when a provider call ultimately fails (retries exhausted, or\n   * non-retryable error). Same shape as `provider.retry` minus the delay.\n   */\n  'provider.error': {\n    providerId: string;\n    status: number;\n    description: string;\n    retryable: boolean;\n  };\n  'tool.started': { name: string; id: string; input?: unknown };\n  /**\n   * Fired for each ToolProgressEvent yielded by `Tool.executeStream`. UIs\n   * subscribe to render incremental progress (streaming bash output, file\n   * tree counts, etc.) without the tool having to know about the UI.\n   */\n  'tool.progress': { name: string; id: string; event: ToolProgressEvent };\n  /**\n   * Fired when a tool call needs user confirmation and no confirmHandler\n   * is registered on the executor. The TUI renders a confirmation dialog\n   * from this event. Resolution is driven by calling the resolve function\n   * passed in the payload with a decision string ('yes' | 'no' | 'always' | 'deny').\n   */\n  'tool.confirm_needed': {\n    tool: Tool;\n    input: unknown;\n    toolUseId: string;\n    suggestedPattern: string;\n    resolve: (decision: 'yes' | 'no' | 'always' | 'deny') => void;\n  };\n  /**\n   * `output` is a truncated preview of the tool's serialized result text\n   * (capped at ~400 chars by the emitter). UIs render this inline in the\n   * tool history line without re-fetching from the session log.\n   */\n  'tool.executed': {\n    /**\n     * The tool_use id (e.g. \"toolu_…\") issued by the provider for this call.\n     * Pairs with `tool.started.id` so subscribers can correlate start/finish\n     * even when the model fires multiple tools in parallel with identical\n     * inputs. Optional only for legacy emit sites — new code should always\n     * set it.\n     */\n    id?: string;\n    name: string;\n    durationMs: number;\n    ok: boolean;\n    input?: unknown;\n    output?: string;\n    /**\n     * Full UTF-8 byte length of the serialized tool result that the model\n     * actually sees (post-cap, post-scrub). The `output` preview is capped\n     * at ~400 chars for transport; this number lets UIs surface what the\n     * model is really paying tokens for. Optional only for legacy emit\n     * sites that may not yet populate it.\n     */\n    outputBytes?: number;\n    /**\n     * Estimated token count for the full result body the model sees.\n     * Computed from `outputBytes` with the standard ~3.5 chars/token\n     * heuristic. Cheap to show in the TUI; not authoritative — the real\n     * provider count lives in `provider.response.usage`. */\n    outputTokens?: number;\n    /**\n     * For tools whose output has a clear \"line\" notion (file reads with\n     * numbered prefixes, grep hits, bash stdout), the agent counts the\n     * actual lines the model received and forwards it here. Undefined\n     * for tools without a meaningful line count. */\n    outputLines?: number;\n  };\n  'token.threshold': { used: number; limit: number };\n  'compaction.fired': { before: number; after: number };\n  /**\n   * Fired when the auto-compaction middleware's compactor.compact() call\n   * throws. Compaction is best-effort by design so we don't crash the agent\n   * loop, but a persistent failure (misconfigured summarizer model, network\n   * outage) means the next iteration may hit context overflow. Observability\n   * layers / dashboards subscribe to this to surface the silent regression.\n   */\n  'compaction.failed': {\n    err: Error;\n    aggressive: boolean;\n    level: 'warn' | 'soft' | 'hard';\n    tokens: number;\n    maxContext: number;\n    load: number;\n    fatal: boolean;\n  };\n  /**\n   * Subagent lifecycle events. Emitted by `MultiAgentHost` so the TUI can\n   * surface what's happening in the fleet without needing director-mode\n   * (which renders the live FleetPanel). These complement the FleetBus\n   * (director-only) by giving the TUI a uniform feed for both `/spawn`\n   * and director-orchestrated work.\n   */\n  'subagent.spawned': {\n    subagentId: string;\n    taskId: string;\n    name?: string;\n    provider?: string;\n    model?: string;\n    description?: string;\n    /**\n     * Absolute path to the per-subagent JSONL transcript on disk, when\n     * one was created. Undefined when the subagent shares the parent\n     * session writer (in-memory or single-file configurations).\n     * Surfaced so the TUI (FleetPanel) and `/fleet log` can show the\n     * user *where* to look without computing it from the run id.\n     */\n    transcriptPath?: string;\n  };\n  'subagent.task_started': {\n    subagentId: string;\n    taskId: string;\n    description?: string;\n  };\n  /**\n   * Per-tool-call event re-emitted from a subagent's own EventBus\n   * onto the host EventBus, so the TUI / non-director surfaces can\n   * render \"AGENT#1 ● bash 250ms\" without having to subscribe to\n   * the director-only FleetBus. Fired AFTER the tool completes\n   * (paired with `tool.executed`). Includes the subagent id so\n   * multiple parallel subagents are distinguishable.\n   */\n  'subagent.tool_executed': {\n    subagentId: string;\n    taskId?: string;\n    name: string;\n    durationMs: number;\n    ok: boolean;\n    input?: unknown;\n    outputBytes?: number;\n  };\n  'subagent.task_completed': {\n    subagentId: string;\n    taskId: string;\n    status: 'success' | 'failed' | 'timeout' | 'stopped';\n    iterations: number;\n    toolCalls: number;\n    durationMs: number;\n    /**\n     * Structured failure envelope when `status !== 'success'`. Carries\n     * `kind` (one of `SubagentErrorKind`), `message`, `retryable`, and\n     * optional `backoffMs`. UIs branch on `kind` to render the right\n     * chip (rate_limit vs auth vs tool_failed). The type is imported\n     * lazily as a structural object to avoid a coordination → kernel\n     * cycle in the dependency graph.\n     */\n    error?: {\n      kind: string;\n      message: string;\n      retryable: boolean;\n      backoffMs?: number;\n      cause?: { name: string; message: string; stack?: string };\n    };\n  };\n  'mcp.server.connected': { name: string; toolCount: number };\n  'mcp.server.reconnected': { name: string; toolCount: number };\n  'mcp.server.disconnected': { name: string; reason: string };\n  'token.cost_estimate_unavailable': { model: string };\n  error: { err: Error; phase: string };\n}\n\nexport type EventName = keyof EventMap;\nexport type Listener<E extends EventName> = (payload: EventMap[E]) => void;\n\nexport interface EventLogger {\n  error(msg: string, ctx?: unknown): void;\n}\n\nexport class EventBus {\n  private readonly listeners = new Map<EventName, Set<Listener<EventName>>>();\n  private readonly wildcards: Array<{\n    match: (event: string) => boolean;\n    fn: (event: string, payload: unknown) => void;\n  }> = [];\n  private logger?: EventLogger;\n\n  setLogger(logger: EventLogger): void {\n    this.logger = logger;\n  }\n\n  on<E extends EventName>(event: E, fn: Listener<E>): () => void {\n    let set = this.listeners.get(event);\n    if (!set) {\n      set = new Set();\n      this.listeners.set(event, set);\n    }\n    set.add(fn as Listener<EventName>);\n    return () => this.off(event, fn);\n  }\n\n  off<E extends EventName>(event: E, fn: Listener<E>): void {\n    this.listeners.get(event)?.delete(fn as Listener<EventName>);\n  }\n\n  once<E extends EventName>(event: E, fn: Listener<E>): () => void {\n    const wrapper: Listener<E> = (payload) => {\n      this.off(event, wrapper as Listener<EventName>);\n      (fn as Listener<E>)(payload);\n    };\n    this.on(event, wrapper as Listener<E>);\n    return () => {\n      this.off(event, wrapper as Listener<EventName>);\n    };\n  }\n\n  /**\n   * Subscribe to all events whose name matches a glob-style prefix.\n   * `'tool.*'` matches `tool.started`, `tool.executed`, `tool.progress`, etc.\n   * `'*'` matches every event.\n   *\n   * The handler receives `(eventName, payload)` with the event name as a\n   * string and the payload as `unknown`. Use for logging, debugging, or\n   * metrics collection across a family of events.\n   *\n   * Returns an unsubscribe function.\n   */\n  onPattern(pattern: string, fn: (event: string, payload: unknown) => void): () => void {\n    const match = makePatternMatcher(pattern);\n    const entry = { match, fn };\n    this.wildcards.push(entry);\n    return () => {\n      const idx = this.wildcards.indexOf(entry);\n      if (idx >= 0) this.wildcards.splice(idx, 1);\n    };\n  }\n\n  /**\n   * Subscribe to all events whose name matches a RegExp.\n   * More flexible than `onPattern` — use when you need regex features\n   * (alternation, character classes, capture groups).\n   *\n   * Returns an unsubscribe function.\n   */\n  onRegex(regex: RegExp, fn: (event: string, payload: unknown) => void): () => void {\n    const entry = { match: (e: string) => regex.test(e), fn };\n    this.wildcards.push(entry);\n    return () => {\n      const idx = this.wildcards.indexOf(entry);\n      if (idx >= 0) this.wildcards.splice(idx, 1);\n    };\n  }\n\n  emit<E extends EventName>(event: E, payload: EventMap[E]): void {\n    const set = this.listeners.get(event);\n    if (set) {\n      for (const fn of set) {\n        try {\n          (fn as Listener<E>)(payload);\n        } catch (err) {\n          this.logger?.error(`EventBus listener for \"${event}\" threw`, err);\n        }\n      }\n    }\n    // Wildcard listeners\n    if (this.wildcards.length > 0) {\n      const name = event as string;\n      for (const { match, fn } of this.wildcards) {\n        if (!match(name)) continue;\n        try {\n          fn(name, payload);\n        } catch (err) {\n          this.logger?.error(`EventBus wildcard listener for \"${name}\" threw`, err);\n        }\n      }\n    }\n  }\n\n  clear(): void {\n    this.listeners.clear();\n    this.wildcards.length = 0;\n  }\n\n  /**\n   * V2-D: introspection helper. Pass an `event` to count handlers for a\n   * single key, or omit to get the total across every event. Used by the\n   * leak-detection smoke test to flag handler accumulation across runs.\n   * Does NOT include wildcard listeners.\n   */\n  listenerCount(event?: EventName): number {\n    if (event !== undefined) return this.listeners.get(event)?.size ?? 0;\n    let total = 0;\n    for (const set of this.listeners.values()) total += set.size;\n    return total;\n  }\n\n  /**\n   * Number of wildcard listeners currently registered.\n   */\n  wildcardCount(): number {\n    return this.wildcards.length;\n  }\n}\n\n/**\n * Convert a glob-style pattern to a matcher function.\n * Only supports `*` at the end of a prefix — `'tool.*'` becomes\n * \"starts with tool.\". `'*'` matches everything.\n */\nfunction makePatternMatcher(pattern: string): (event: string) => boolean {\n  if (pattern === '*') return () => true;\n  if (pattern.endsWith('.*')) {\n    const prefix = pattern.slice(0, -2);\n    return (e: string) => e.startsWith(`${prefix}.`);\n  }\n  // Exact match fallback\n  return (e: string) => e === pattern;\n}\n","import type { Compactor } from '../types/compactor.js';\nimport type { ConfigLoader, ConfigStore } from '../types/config.js';\nimport type { ErrorHandler } from '../types/error-handler.js';\nimport type { InputReader } from '../types/input-reader.js';\nimport type { Logger } from '../types/logger.js';\nimport type { MemoryStore } from '../types/memory.js';\nimport type { ModeStore } from '../types/mode.js';\nimport type { ModelsRegistry } from '../types/models-registry.js';\nimport type { PathResolver } from '../types/path-resolver.js';\nimport type { PermissionPolicy } from '../types/permission.js';\nimport type { ProviderRunner } from '../types/provider-runner.js';\nimport type { Renderer } from '../types/renderer.js';\nimport type { RetryPolicy } from '../types/retry-policy.js';\nimport type { SecretScrubber } from '../types/secret-scrubber.js';\nimport type { SessionStore } from '../types/session.js';\nimport type { SkillLoader } from '../types/skill.js';\nimport type { SystemPromptBuilder } from '../types/system-prompt.js';\nimport type { TokenCounter } from '../types/token-counter.js';\nimport type { Token } from './container.js';\n\nconst t = <T>(name: string): Token<T> => Symbol(name) as Token<T>;\n\nexport const TOKENS = {\n  Logger: t<Logger>('Logger'),\n  TokenCounter: t<TokenCounter>('TokenCounter'),\n  SessionStore: t<SessionStore>('SessionStore'),\n  MemoryStore: t<MemoryStore>('MemoryStore'),\n  PermissionPolicy: t<PermissionPolicy>('PermissionPolicy'),\n  Compactor: t<Compactor>('Compactor'),\n  PathResolver: t<PathResolver>('PathResolver'),\n  ConfigLoader: t<ConfigLoader>('ConfigLoader'),\n  ConfigStore: t<ConfigStore>('ConfigStore'),\n  Renderer: t<Renderer>('Renderer'),\n  InputReader: t<InputReader>('InputReader'),\n  ErrorHandler: t<ErrorHandler>('ErrorHandler'),\n  RetryPolicy: t<RetryPolicy>('RetryPolicy'),\n  SkillLoader: t<SkillLoader>('SkillLoader'),\n  SystemPromptBuilder: t<SystemPromptBuilder>('SystemPromptBuilder'),\n  SecretScrubber: t<SecretScrubber>('SecretScrubber'),\n  ModelsRegistry: t<ModelsRegistry>('ModelsRegistry'),\n  ModeStore: t<ModeStore>('ModeStore'),\n  /** Replaces the entire provider call layer — retry, streaming, tracing. */\n  ProviderRunner: t<ProviderRunner>('ProviderRunner'),\n} as const;\n","/**\n * RunController centralises abort + cleanup for a single agent run. It\n * wraps a single AbortController and exposes a registry of teardown\n * hooks that fire (LIFO, exactly once) when the run aborts OR ends\n * normally. Anyone holding the controller can:\n *\n *   - read `signal` to bail out cooperatively\n *   - call `abort(reason?)` to abort the run\n *   - call `onAbort(fn)` to register a cleanup hook\n *   - call `dispose()` when the run ends normally — this fires the\n *     hooks too, so cleanup runs regardless of outcome\n *\n * Hooks must be idempotent and synchronous-or-quick. Errors thrown\n * inside hooks are caught and surfaced through `errorSink` (or the\n * console as a last resort) so one bad hook can't block the others.\n */\nexport interface RunControllerOptions {\n  /** Optional parent signal — abort propagates from parent → this. */\n  parentSignal?: AbortSignal;\n  /** Receives errors thrown by cleanup hooks. Defaults to console.warn. */\n  errorSink?: (err: unknown, where: string) => void;\n}\n\nexport class RunController {\n  private readonly ctrl = new AbortController();\n  private readonly hooks: Array<() => void | Promise<void>> = [];\n  private disposed = false;\n  private hooksDrained = false;\n  private readonly errorSink: (err: unknown, where: string) => void;\n\n  constructor(opts: RunControllerOptions = {}) {\n    this.errorSink =\n      opts.errorSink ??\n      ((err, where) => {\n        console.warn(`[run] cleanup hook failed in ${where}:`, err);\n      });\n    if (opts.parentSignal) {\n      const parent = opts.parentSignal;\n      if (parent.aborted) {\n        this.ctrl.abort(parent.reason);\n      } else {\n        const onParentAbort = () => this.ctrl.abort(parent.reason);\n        parent.addEventListener('abort', onParentAbort, { once: true });\n        // When this run finishes normally, stop listening on the parent.\n        this.onAbort(() => parent.removeEventListener('abort', onParentAbort));\n      }\n    }\n    this.ctrl.signal.addEventListener(\n      'abort',\n      () => {\n        void this.runHooks();\n      },\n      { once: true },\n    );\n  }\n\n  get signal(): AbortSignal {\n    return this.ctrl.signal;\n  }\n\n  get aborted(): boolean {\n    return this.ctrl.signal.aborted;\n  }\n\n  abort(reason?: unknown): void {\n    if (this.ctrl.signal.aborted) return;\n    this.ctrl.abort(reason);\n  }\n\n  /**\n   * Register a teardown hook. Returns an unsubscribe function so callers\n   * can opt out before the hook fires (e.g. when a tool finishes cleanly\n   * before abort happens).\n   */\n  onAbort(fn: () => void | Promise<void>): () => void {\n    this.hooks.push(fn);\n    return () => {\n      const idx = this.hooks.indexOf(fn);\n      if (idx !== -1) this.hooks.splice(idx, 1);\n    };\n  }\n\n  /**\n   * Fire cleanup hooks and tear down listeners — called when the run\n   * ends *normally* so cleanup happens regardless of outcome. Subsequent\n   * aborts become no-ops.\n   */\n  async dispose(): Promise<void> {\n    if (this.disposed) return;\n    this.disposed = true;\n    await this.runHooks();\n  }\n\n  private async runHooks(): Promise<void> {\n    if (this.hooksDrained) return;\n    this.hooksDrained = true;\n    // Snapshot + clear so hooks added during cleanup don't re-fire.\n    const snapshot = this.hooks.splice(0, this.hooks.length).reverse();\n    for (const hook of snapshot) {\n      try {\n        await hook();\n      } catch (err) {\n        this.errorSink(err, 'RunController.dispose');\n      }\n    }\n  }\n}\n"]}

package/dist/{mcp-servers-BA1Ofmfj.d.ts → mcp-servers-DR35ojJZ.d.ts}

@@ -1,6 +1,6 @@
-import { C as Compactor } from './compactor-DSl2FK7a.js';
-import { M as Message, u as Tool } from './context-u0bryklF.js';
-import { M as MCPServerConfig } from './config-DXrqb41m.js';
+import { C as Compactor } from './compactor-BUU6Zm_3.js';
+import { M as Message, u as Tool } from './context-IovtuTf8.js';
+import { M as MCPServerConfig } from './config-CKLYPkCi.js';
 
 type ContextManagerAction = 'check' | 'summary' | 'prune' | 'add_note' | 'compact';
 interface ContextManagerInput {

package/dist/models/index.d.ts

@@ -1,7 +1,7 @@
 export { D as DefaultModelsRegistry, a as DefaultModelsRegistryOptions, c as classifyFamily } from '../models-registry-DqzwpBQy.js';
 import { c as ModeStore, a as ModeConfig, M as Mode } from '../mode-CV077NjV.js';
-import { g as Provider, M as Message } from '../context-u0bryklF.js';
-import { M as MessageSelector, S as SelectorResult } from '../selector-BRqzvugb.js';
+import { g as Provider, M as Message } from '../context-IovtuTf8.js';
+import { M as MessageSelector, S as SelectorResult } from '../selector-wT2fv9Fg.js';
 import '../models-registry-Y2xbog0E.js';
 
 declare class DefaultModeStore implements ModeStore {

package/dist/models/index.js

@@ -32,7 +32,7 @@ async function atomicWrite(targetPath, content, opts = {}) {
     if (mode !== void 0) {
       await fs.chmod(tmp, mode);
     }
-    await fs.rename(tmp, targetPath);
+    await renameWithRetry(tmp, targetPath);
   } catch (err) {
     try {
       await fs.unlink(tmp);
@@ -41,6 +41,29 @@ async function atomicWrite(targetPath, content, opts = {}) {
     throw err;
   }
 }
+var TRANSIENT_RENAME_CODES = /* @__PURE__ */ new Set(["EPERM", "EBUSY", "EACCES", "ENOTEMPTY"]);
+async function renameWithRetry(from, to) {
+  if (process.platform !== "win32") {
+    await fs.rename(from, to);
+    return;
+  }
+  const delays = [10, 25, 60, 120, 250];
+  let lastErr;
+  for (let i = 0; i <= delays.length; i++) {
+    try {
+      await fs.rename(from, to);
+      return;
+    } catch (err) {
+      lastErr = err;
+      const code = err?.code;
+      if (!code || !TRANSIENT_RENAME_CODES.has(code) || i === delays.length) {
+        throw err;
+      }
+      await new Promise((resolve2) => setTimeout(resolve2, delays[i]));
+    }
+  }
+  throw lastErr;
+}
 
 // src/models/models-registry.ts
 var DEFAULT_URL = "https://models.dev/api.json";