@wrongstack/core 0.1.0

package/dist/kernel/index.d.ts

@@ -0,0 +1,71 @@
+import { ay as Token, j as Logger, a1 as TokenCounter, V as SessionStore, m as MemoryStore, v as PermissionPolicy, c as Compactor, P as PathResolver, e as ConfigLoader, R as Renderer, h as InputReader, E as ErrorHandler, O as RetryPolicy, Y as SkillLoader, S as SecretScrubber, s as ModelsRegistry } from '../secret-scrubber-Dax_Ou_o.js';
+export { al as BindOptions, ah as Container, an as Decorator, ai as EventBus, ao as EventLogger, ap as EventMap, aj as EventName, aq as Factory, ak as Listener, ar as Middleware, as as MiddlewareHandler, at as NextFn, au as Pipeline, av as PipelineOptions } from '../secret-scrubber-Dax_Ou_o.js';
+import { S as SystemPromptBuilder } from '../system-prompt-BG3nks8P.js';
+
+declare const TOKENS: {
+    readonly Logger: Token<Logger>;
+    readonly TokenCounter: Token<TokenCounter>;
+    readonly SessionStore: Token<SessionStore>;
+    readonly MemoryStore: Token<MemoryStore>;
+    readonly PermissionPolicy: Token<PermissionPolicy>;
+    readonly Compactor: Token<Compactor>;
+    readonly PathResolver: Token<PathResolver>;
+    readonly ConfigLoader: Token<ConfigLoader>;
+    readonly Renderer: Token<Renderer>;
+    readonly InputReader: Token<InputReader>;
+    readonly ErrorHandler: Token<ErrorHandler>;
+    readonly RetryPolicy: Token<RetryPolicy>;
+    readonly SkillLoader: Token<SkillLoader>;
+    readonly SystemPromptBuilder: Token<SystemPromptBuilder>;
+    readonly SecretScrubber: Token<SecretScrubber>;
+    readonly ModelsRegistry: Token<ModelsRegistry>;
+};
+
+/**
+ * RunController centralises abort + cleanup for a single agent run. It
+ * wraps a single AbortController and exposes a registry of teardown
+ * hooks that fire (LIFO, exactly once) when the run aborts OR ends
+ * normally. Anyone holding the controller can:
+ *
+ *   - read `signal` to bail out cooperatively
+ *   - call `abort(reason?)` to abort the run
+ *   - call `onAbort(fn)` to register a cleanup hook
+ *   - call `dispose()` when the run ends normally — this fires the
+ *     hooks too, so cleanup runs regardless of outcome
+ *
+ * Hooks must be idempotent and synchronous-or-quick. Errors thrown
+ * inside hooks are caught and surfaced through `errorSink` (or the
+ * console as a last resort) so one bad hook can't block the others.
+ */
+interface RunControllerOptions {
+    /** Optional parent signal — abort propagates from parent → this. */
+    parentSignal?: AbortSignal;
+    /** Receives errors thrown by cleanup hooks. Defaults to console.warn. */
+    errorSink?: (err: unknown, where: string) => void;
+}
+declare class RunController {
+    private readonly ctrl;
+    private readonly hooks;
+    private disposed;
+    private hooksDrained;
+    private readonly errorSink;
+    constructor(opts?: RunControllerOptions);
+    get signal(): AbortSignal;
+    get aborted(): boolean;
+    abort(reason?: unknown): void;
+    /**
+     * Register a teardown hook. Returns an unsubscribe function so callers
+     * can opt out before the hook fires (e.g. when a tool finishes cleanly
+     * before abort happens).
+     */
+    onAbort(fn: () => void | Promise<void>): () => void;
+    /**
+     * Fire cleanup hooks and tear down listeners — called when the run
+     * ends *normally* so cleanup happens regardless of outcome. Subsequent
+     * aborts become no-ops.
+     */
+    dispose(): Promise<void>;
+    private runHooks;
+}
+
+export { RunController, type RunControllerOptions, TOKENS, Token };

package/dist/kernel/index.js

@@ -0,0 +1,361 @@
+// src/kernel/container.ts
+var Container = class {
+  entries = /* @__PURE__ */ new Map();
+  bind(token, factory, opts = {}) {
+    if (this.entries.has(token)) {
+      throw new Error(`Container: token "${token.description ?? "unknown"}" already bound`);
+    }
+    this.entries.set(token, {
+      factory,
+      singleton: opts.singleton ?? true,
+      decorators: [],
+      owner: opts.owner ?? "core"
+    });
+  }
+  override(token, factory, opts = {}) {
+    const existing = this.entries.get(token);
+    if (!existing) {
+      throw new Error(
+        `Container: cannot override "${token.description ?? "unknown"}" \u2014 not bound`
+      );
+    }
+    this.entries.set(token, {
+      factory,
+      singleton: opts.singleton ?? existing.singleton,
+      decorators: existing.decorators,
+      owner: opts.owner ?? existing.owner
+    });
+  }
+  decorate(token, decorator, owner = "core") {
+    const existing = this.entries.get(token);
+    if (!existing) {
+      throw new Error(
+        `Container: cannot decorate "${token.description ?? "unknown"}" \u2014 not bound`
+      );
+    }
+    existing.decorators.push(decorator);
+    existing.cache = void 0;
+    existing.owner = `${existing.owner}+${owner}`;
+  }
+  resolve(token) {
+    const entry = this.entries.get(token);
+    if (!entry) {
+      throw new Error(
+        `Container: token "${token.description ?? "unknown"}" not bound`
+      );
+    }
+    if (entry.singleton && entry.cache !== void 0) {
+      return entry.cache;
+    }
+    let value = entry.factory(this);
+    for (const d of entry.decorators) {
+      value = d(value, this);
+    }
+    if (entry.singleton) {
+      entry.cache = value;
+    }
+    return value;
+  }
+  has(token) {
+    return this.entries.has(token);
+  }
+  ownerOf(token) {
+    return this.entries.get(token)?.owner;
+  }
+  /**
+   * Remove a token's binding (along with any decorators stacked on it).
+   * Returns true if the token existed. Use this to withdraw temporary
+   * bindings installed by a short-lived run or plugin — without it, the
+   * entry persists in the map forever.
+   */
+  unbind(token) {
+    return this.entries.delete(token);
+  }
+  /**
+   * Drop every binding. Intended for tests and short-lived CLI invocations
+   * that rebuild the container from scratch. Production code should prefer
+   * `unbind` on the specific tokens it owns.
+   */
+  clear() {
+    this.entries.clear();
+  }
+  list() {
+    return Array.from(this.entries.entries()).map(([token, entry]) => ({
+      token,
+      owner: entry.owner
+    }));
+  }
+  /**
+   * Inspect a binding's full shape, including decorator count and whether
+   * a singleton value is cached. Returns null if the token is unbound.
+   * Decorator and factory function references are not exposed — only counts
+   * and metadata, to keep internal state hidden.
+   */
+  inspect(token) {
+    const entry = this.entries.get(token);
+    if (!entry) return null;
+    return {
+      owner: entry.owner,
+      singleton: entry.singleton,
+      decoratorCount: entry.decorators.length,
+      cached: entry.cache !== void 0
+    };
+  }
+};
+
+// src/kernel/pipeline.ts
+var Pipeline = class {
+  chain = [];
+  use(mw) {
+    this.ensureUnique(mw.name);
+    this.chain.push(mw);
+    return this;
+  }
+  prepend(mw) {
+    this.ensureUnique(mw.name);
+    this.chain.unshift(mw);
+    return this;
+  }
+  /**
+   * Insert middleware at an explicit index. Out-of-range indices are clamped.
+   * Use this when insertBefore/insertAfter are insufficient (e.g. to place
+   * a middleware at a known position regardless of named targets).
+   */
+  insertAt(index, mw) {
+    this.ensureUnique(mw.name);
+    const idx = Math.max(0, Math.min(index, this.chain.length));
+    this.chain.splice(idx, 0, mw);
+    return this;
+  }
+  /**
+   * Insert mw immediately before the first occurrence of target.
+   * If called multiple times with the same target, each call inserts
+   * before the target's current position — so after insertBefore('B', X)
+   * then insertBefore('B', Y), the order is Y → X → B.
+   */
+  insertBefore(target, mw, opts) {
+    this.ensureUnique(mw.name);
+    const idx = this.indexOf(target, opts?.optional);
+    if (idx === -1) return this;
+    this.chain.splice(idx, 0, mw);
+    return this;
+  }
+  /**
+   * Insert mw immediately after the first occurrence of target.
+   * If called multiple times with the same target, each call inserts
+   * after the target's current position — so after insertAfter('B', X)
+   * then insertAfter('B', Y), the order is B → X → Y.
+   */
+  insertAfter(target, mw, opts) {
+    this.ensureUnique(mw.name);
+    const idx = this.indexOf(target, opts?.optional);
+    if (idx === -1) return this;
+    this.chain.splice(idx + 1, 0, mw);
+    return this;
+  }
+  replace(target, mw, opts) {
+    if (mw.name !== target) this.ensureUnique(mw.name);
+    const idx = this.indexOf(target, opts?.optional);
+    if (idx === -1) return this;
+    this.chain[idx] = mw;
+    return this;
+  }
+  remove(name, opts) {
+    const idx = this.indexOf(name, opts?.optional);
+    if (idx === -1) return this;
+    this.chain.splice(idx, 1);
+    return this;
+  }
+  list() {
+    return this.chain.map((m) => m.name);
+  }
+  size() {
+    return this.chain.length;
+  }
+  /** Return a read-only view suitable for passing to plugins. */
+  asReadonly() {
+    const self = this;
+    return Object.freeze({
+      get size() {
+        return self.size();
+      },
+      list() {
+        return Object.freeze(self.list());
+      },
+      run(input) {
+        return self.run(input);
+      }
+    });
+  }
+  async run(input) {
+    let index = -1;
+    const chain = this.chain;
+    const dispatch = async (i, value) => {
+      if (i <= index) {
+        throw new Error(`Pipeline: next() called multiple times in "${chain[index]?.name}"`);
+      }
+      index = i;
+      const mw = chain[i];
+      if (!mw) return value;
+      return mw.handler(value, (v) => dispatch(i + 1, v));
+    };
+    return dispatch(0, input);
+  }
+  indexOf(name, optional = false) {
+    const idx = this.chain.findIndex((m) => m.name === name);
+    if (idx === -1 && !optional) {
+      throw new Error(`Pipeline: middleware "${name}" not found`);
+    }
+    return idx;
+  }
+  ensureUnique(name) {
+    if (this.chain.some((m) => m.name === name)) {
+      throw new Error(`Pipeline: middleware "${name}" already registered`);
+    }
+  }
+};
+
+// src/kernel/events.ts
+var EventBus = class {
+  listeners = /* @__PURE__ */ new Map();
+  logger;
+  setLogger(logger) {
+    this.logger = logger;
+  }
+  on(event, fn) {
+    let set = this.listeners.get(event);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      this.listeners.set(event, set);
+    }
+    set.add(fn);
+    return () => this.off(event, fn);
+  }
+  off(event, fn) {
+    this.listeners.get(event)?.delete(fn);
+  }
+  once(event, fn) {
+    const wrapper = (payload) => {
+      this.off(event, wrapper);
+      fn(payload);
+    };
+    this.on(event, wrapper);
+    return () => {
+      this.off(event, wrapper);
+    };
+  }
+  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);
+      }
+    }
+  }
+  clear() {
+    this.listeners.clear();
+  }
+};
+
+// src/kernel/tokens.ts
+var t = (name) => Symbol(name);
+var TOKENS = {
+  Logger: t("Logger"),
+  TokenCounter: t("TokenCounter"),
+  SessionStore: t("SessionStore"),
+  MemoryStore: t("MemoryStore"),
+  PermissionPolicy: t("PermissionPolicy"),
+  Compactor: t("Compactor"),
+  PathResolver: t("PathResolver"),
+  ConfigLoader: t("ConfigLoader"),
+  Renderer: t("Renderer"),
+  InputReader: t("InputReader"),
+  ErrorHandler: t("ErrorHandler"),
+  RetryPolicy: t("RetryPolicy"),
+  SkillLoader: t("SkillLoader"),
+  SystemPromptBuilder: t("SystemPromptBuilder"),
+  SecretScrubber: t("SecretScrubber"),
+  ModelsRegistry: t("ModelsRegistry")
+};
+
+// src/kernel/run-controller.ts
+var RunController = class {
+  ctrl = new AbortController();
+  hooks = [];
+  disposed = false;
+  hooksDrained = false;
+  errorSink;
+  constructor(opts = {}) {
+    this.errorSink = opts.errorSink ?? ((err, where) => {
+      console.warn(`[run] cleanup hook failed in ${where}:`, err);
+    });
+    if (opts.parentSignal) {
+      const parent = opts.parentSignal;
+      if (parent.aborted) {
+        this.ctrl.abort(parent.reason);
+      } else {
+        const onParentAbort = () => this.ctrl.abort(parent.reason);
+        parent.addEventListener("abort", onParentAbort, { once: true });
+        this.onAbort(() => parent.removeEventListener("abort", onParentAbort));
+      }
+    }
+    this.ctrl.signal.addEventListener(
+      "abort",
+      () => {
+        void this.runHooks();
+      },
+      { once: true }
+    );
+  }
+  get signal() {
+    return this.ctrl.signal;
+  }
+  get aborted() {
+    return this.ctrl.signal.aborted;
+  }
+  abort(reason) {
+    if (this.ctrl.signal.aborted) return;
+    this.ctrl.abort(reason);
+  }
+  /**
+   * Register a teardown hook. Returns an unsubscribe function so callers
+   * can opt out before the hook fires (e.g. when a tool finishes cleanly
+   * before abort happens).
+   */
+  onAbort(fn) {
+    this.hooks.push(fn);
+    return () => {
+      const idx = this.hooks.indexOf(fn);
+      if (idx !== -1) this.hooks.splice(idx, 1);
+    };
+  }
+  /**
+   * Fire cleanup hooks and tear down listeners — called when the run
+   * ends *normally* so cleanup happens regardless of outcome. Subsequent
+   * aborts become no-ops.
+   */
+  async dispose() {
+    if (this.disposed) return;
+    this.disposed = true;
+    await this.runHooks();
+  }
+  async runHooks() {
+    if (this.hooksDrained) return;
+    this.hooksDrained = true;
+    const snapshot = this.hooks.splice(0, this.hooks.length).reverse();
+    for (const hook of snapshot) {
+      try {
+        await hook();
+      } catch (err) {
+        this.errorSink(err, "RunController.dispose");
+      }
+    }
+  }
+};
+
+export { Container, EventBus, Pipeline, RunController, TOKENS };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/kernel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../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 * 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 Error(`Container: token \"${token.description ?? 'unknown'}\" already bound`);\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 Error(\n        `Container: cannot override \"${token.description ?? 'unknown'}\" — not bound`,\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 Error(\n        `Container: cannot decorate \"${token.description ?? 'unknown'}\" — not bound`,\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 Error(\n        `Container: token \"${token.description ?? 'unknown'}\" not bound`,\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\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\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() { return self.size(); },\n      list() { return Object.freeze(self.list()); },\n      run(input: T) { return self.run(input); },\n    });\n  }\n\n  async run(input: T): Promise<T> {\n    let index = -1;\n    const chain = this.chain;\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      return mw.handler(value, (v) => dispatch(i + 1, v));\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 { Usage } from '../types/provider.js';\nimport type { Context } from '../core/context.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.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   * `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    name: string;\n    durationMs: number;\n    ok: boolean;\n    input?: unknown;\n    output?: string;\n  };\n  'token.threshold': { used: number; limit: number };\n  'compaction.fired': { before: number; after: number };\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","import type { Token } from './container.js';\nimport type { Logger } from '../types/logger.js';\nimport type { TokenCounter } from '../types/token-counter.js';\nimport type { SessionStore } from '../types/session.js';\nimport type { MemoryStore } from '../types/memory.js';\nimport type { PermissionPolicy } from '../types/permission.js';\nimport type { Compactor } from '../types/compactor.js';\nimport type { PathResolver } from '../types/path-resolver.js';\nimport type { ConfigLoader } from '../types/config.js';\nimport type { Renderer } from '../types/renderer.js';\nimport type { InputReader } from '../types/input-reader.js';\nimport type { ErrorHandler } from '../types/error-handler.js';\nimport type { RetryPolicy } from '../types/retry-policy.js';\nimport type { SkillLoader } from '../types/skill.js';\nimport type { SystemPromptBuilder } from '../types/system-prompt.js';\nimport type { SecretScrubber } from '../types/secret-scrubber.js';\nimport type { ModelsRegistry } from '../types/models-registry.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  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} 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"]}