@wrongstack/core 0.284.1 → 0.286.0

package/dist/extension/index.js.map

@@ -1 +1,7 @@
-{"version":3,"sources":["../../src/utils/expect-defined.ts","../../src/types/errors.ts","../../src/extension/registry.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/** Assert a value is neither null nor undefined. Throws if it is.\n *  Useful after optional chaining and indexed access when the\n *  control flow guarantees the value exists but TypeScript can't\n *  prove it (e.g. after a check on a related field). */\nexport function expectDefined<T>(value: T | null | undefined, label?: string): T {\n  if (value === null || value === undefined) {\n    const err = new Error(label ? `Expected ${label} to be defined` : 'Expected value to be defined');\n    err.name = 'ExpectDefinedError';\n    throw err;\n  }\n  return value;\n}\n","import { toErrorMessage } from '../utils/index.js';\n\n/**\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\n/**\n * Machine-readable error codes as frozen constants.\n *\n * Use `ERROR_CODES.X` instead of raw string literals for:\n * - IDE autocomplete and compile-time validation\n * - Safe refactoring (rename updates all usages)\n * - Plugin extensibility (extend the object to add custom codes)\n *\n * The `ErrorCode` type is derived from this object, so adding a new\n * code here automatically updates the type without extra changes.\n */\nexport const ERROR_CODES = {\n  // Provider\n  PROVIDER_RATE_LIMITED: 'PROVIDER_RATE_LIMITED',\n  PROVIDER_AUTH_FAILED: 'PROVIDER_AUTH_FAILED',\n  PROVIDER_OVERLOADED: 'PROVIDER_OVERLOADED',\n  PROVIDER_INVALID_REQUEST: 'PROVIDER_INVALID_REQUEST',\n  PROVIDER_SERVER_ERROR: 'PROVIDER_SERVER_ERROR',\n  PROVIDER_NETWORK_ERROR: 'PROVIDER_NETWORK_ERROR',\n  PROVIDER_CONTEXT_OVERFLOW: 'PROVIDER_CONTEXT_OVERFLOW',\n  // Tool\n  TOOL_NOT_FOUND: 'TOOL_NOT_FOUND',\n  TOOL_PERMISSION_DENIED: 'TOOL_PERMISSION_DENIED',\n  TOOL_EXECUTION_FAILED: 'TOOL_EXECUTION_FAILED',\n  TOOL_TIMEOUT: 'TOOL_TIMEOUT',\n  TOOL_INPUT_INVALID: 'TOOL_INPUT_INVALID',\n  // Config\n  CONFIG_INVALID: 'CONFIG_INVALID',\n  CONFIG_NOT_FOUND: 'CONFIG_NOT_FOUND',\n  CONFIG_PARSE_FAILED: 'CONFIG_PARSE_FAILED',\n  CONFIG_MIGRATION_NEEDED: 'CONFIG_MIGRATION_NEEDED',\n  // Plugin\n  PLUGIN_LOAD_FAILED: 'PLUGIN_LOAD_FAILED',\n  PLUGIN_API_MISMATCH: 'PLUGIN_API_MISMATCH',\n  PLUGIN_MISSING_DEPENDENCY: 'PLUGIN_MISSING_DEPENDENCY',\n  // Agent\n  AGENT_ITERATION_LIMIT: 'AGENT_ITERATION_LIMIT',\n  AGENT_CONTEXT_OVERFLOW: 'AGENT_CONTEXT_OVERFLOW',\n  AGENT_ABORTED: 'AGENT_ABORTED',\n  AGENT_RUN_FAILED: 'AGENT_RUN_FAILED',\n  // Session\n  SESSION_NOT_FOUND: 'SESSION_NOT_FOUND',\n  SESSION_CORRUPTED: 'SESSION_CORRUPTED',\n  SESSION_WRITE_FAILED: 'SESSION_WRITE_FAILED',\n  // Container / Registry\n  CONTAINER_TOKEN_ALREADY_BOUND: 'CONTAINER_TOKEN_ALREADY_BOUND',\n  CONTAINER_TOKEN_NOT_BOUND: 'CONTAINER_TOKEN_NOT_BOUND',\n  CONTAINER_CIRCULAR_DEPENDENCY: 'CONTAINER_CIRCULAR_DEPENDENCY',\n  REGISTRY_DUPLICATE: 'REGISTRY_DUPLICATE',\n  REGISTRY_NOT_FOUND: 'REGISTRY_NOT_FOUND',\n  REGISTRY_INVALID: 'REGISTRY_INVALID',\n  // File system\n  FS_READ_FAILED: 'FS_READ_FAILED',\n  FS_WRITE_FAILED: 'FS_WRITE_FAILED',\n  FS_MKDIR_FAILED: 'FS_MKDIR_FAILED',\n  FS_DELETE_FAILED: 'FS_DELETE_FAILED',\n  FS_ATOMIC_WRITE_FAILED: 'FS_ATOMIC_WRITE_FAILED',\n  // SDD (Spec-Driven Development)\n  SDD_VALIDATION_FAILED: 'SDD_VALIDATION_FAILED',\n  SDD_PARSE_FAILED: 'SDD_PARSE_FAILED',\n  SDD_INVALID_STATE: 'SDD_INVALID_STATE',\n  SDD_NOT_READY: 'SDD_NOT_READY',\n  // General\n  VALIDATION_ERROR: 'VALIDATION_ERROR',\n  PARSE_FAILED: 'PARSE_FAILED',\n  UNKNOWN: 'UNKNOWN',\n} as const;\n\n/**\n * Union type derived from `ERROR_CODES`. Using `typeof ERROR_CODES[keyof typeof ERROR_CODES]`\n * instead of a string literal union means TypeScript auto-updates the type whenever\n * a new code is added to `ERROR_CODES` — no need to keep two lists in sync.\n */\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\nexport type ErrorSubsystem =\n  | 'provider'\n  | 'tool'\n  | 'config'\n  | 'plugin'\n  | 'agent'\n  | 'session'\n  | 'sdd'\n  | 'container'\n  | 'fs'\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> | undefined;\n\n  constructor(opts: {\n    message: string;\n    code: ErrorCode;\n    subsystem: ErrorSubsystem;\n    severity?: ErrorSeverity | undefined;\n    recoverable?: boolean | undefined;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\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 | undefined;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\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> | undefined;\n    cause?: unknown | undefined;\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> | undefined;\n    cause?: unknown | undefined;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'plugin',\n      severity: 'error',\n      recoverable: opts.code === ERROR_CODES.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 | undefined;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'agent',\n      severity: opts.code === ERROR_CODES.AGENT_ABORTED ? 'warning' : 'error',\n      recoverable: opts.recoverable ?? opts.code === ERROR_CODES.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'> = ERROR_CODES.AGENT_RUN_FAILED,\n): WrongStackError {\n  if (err instanceof WrongStackError) return err;\n  const message = toErrorMessage(err);\n  return new AgentError({\n    message,\n    code: code === 'UNKNOWN' ? ERROR_CODES.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 | undefined;\n\n  constructor(opts: {\n    message: string;\n    code: Extract<ErrorCode, 'SESSION_NOT_FOUND' | 'SESSION_CORRUPTED' | 'SESSION_WRITE_FAILED'>;\n    sessionId?: string | undefined;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'session',\n      severity: opts.code === ERROR_CODES.SESSION_WRITE_FAILED ? 'error' : 'warning',\n      recoverable: opts.code !== ERROR_CODES.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/**\n * SDD (Spec-Driven Development) errors — spec validation, parsing, and\n * state machine violations in the AISpecBuilder, TaskFlow, and TaskTracker.\n */\nexport class SddError extends WrongStackError {\n  constructor(opts: {\n    message: string;\n    code: Extract<\n      ErrorCode,\n      'SDD_VALIDATION_FAILED' | 'SDD_PARSE_FAILED' | 'SDD_INVALID_STATE' | 'SDD_NOT_READY'\n    >;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'sdd',\n      severity: opts.code === ERROR_CODES.SDD_PARSE_FAILED ? 'warning' : 'error',\n      recoverable: opts.code === ERROR_CODES.SDD_NOT_READY,\n      context: opts.context,\n      cause: opts.cause,\n    });\n    this.name = 'SddError';\n  }\n}\n\n/**\n * File system operation errors.\n */\nexport class FsError extends WrongStackError {\n  readonly path?: string | undefined;\n\n  constructor(opts: {\n    message: string;\n    code: Extract<\n      ErrorCode,\n      'FS_READ_FAILED' | 'FS_WRITE_FAILED' | 'FS_MKDIR_FAILED' | 'FS_DELETE_FAILED' | 'FS_ATOMIC_WRITE_FAILED'\n    >;\n    path?: string | undefined;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'fs',\n      severity: 'error',\n      recoverable: opts.code !== ERROR_CODES.FS_READ_FAILED,\n      context: { path: opts.path, ...opts.context },\n      cause: opts.cause,\n    });\n    this.name = 'FsError';\n    this.path = opts.path;\n  }\n}\n\n/**\n * HTTP fetch error — thrown when a network request returns a non-OK status.\n * Carries the response status so {@link classifyToolError} can branch on it\n * (429 → transient, 404 → not_found, 401 → permission) without duck-typing\n * the error via `'response' in err`.\n *\n * P3 #18 (before-release.md): the previous `'response' in err` check caught\n * any Error with a `response` property, including custom errors, proxy\n * objects, or mocked errors in tests. `instanceof FetchError` is reliable.\n *\n * Tools and providers that make HTTP requests and need the executor to\n * classify their failures should throw `new FetchError({ status, message })`\n * instead of a bare `Error` with an ad-hoc `response` field.\n */\nexport class FetchError extends WrongStackError {\n  readonly status: number;\n\n  constructor(opts: {\n    message: string;\n    status: number;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\n  }) {\n    super({\n      message: opts.message,\n      code: ERROR_CODES.VALIDATION_ERROR,\n      subsystem: 'general',\n      severity: 'error',\n      recoverable: opts.status === 429 || opts.status >= 500,\n      context: { status: opts.status, ...opts.context },\n      cause: opts.cause,\n    });\n    this.name = 'FetchError';\n    this.status = opts.status;\n  }\n}\n\n/**\n * Tool input validation error — thrown when a tool's input fails a validation\n * check that the JSON Schema cannot express (e.g. `old_string === new_string`\n * in edit, or a cross-field invariant). Use this instead of a bare\n * `throw new Error('...validation...')` so {@link classifyToolError} can\n * match on `instanceof` rather than a locale-dependent message substring.\n *\n * P2 #6 (before-release.md): the previous `err.message.includes('validation')`\n * check misclassified any error whose message happened to contain \"validation\"\n * (e.g. a third-party \"input validation timeout\") as a VALIDATION error.\n *\n * Named `ToolValidationError` (not `ValidationError`) to avoid colliding with\n * the existing `ValidationError` interface exported by json-schema-validate.ts\n * (a validation-result shape, not an Error subclass).\n */\nexport class ToolValidationError extends WrongStackError {\n  constructor(opts: {\n    message: string;\n    /** Field path or tool name that failed validation, for diagnostics. */\n    field?: string | undefined;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\n  }) {\n    super({\n      message: opts.message,\n      code: ERROR_CODES.VALIDATION_ERROR,\n      subsystem: 'general',\n      severity: 'error',\n      recoverable: false,\n      context: { field: opts.field, ...opts.context },\n      cause: opts.cause,\n    });\n    this.name = 'ToolValidationError';\n  }\n}\n\n/**\n * Response / payload parse error — thrown when an upstream HTTP response,\n * file, or data structure is well-formed at the transport layer (HTTP 200,\n * valid JSON) but is missing required fields or has an unexpected shape.\n *\n * Distinct from `ConfigError(CONFIG_PARSE_FAILED)` (which is specifically\n * for config-file parsing) and `FetchError` (which covers HTTP non-OK\n * responses). `ParseError` fills the gap: the request succeeded but the\n * response body couldn't be interpreted.\n *\n * Common sites: OAuth token responses missing `access_token`, device-code\n * responses missing `device_code`, registry responses with unexpected\n * schemas.\n */\nexport class ParseError extends WrongStackError {\n  readonly source?: string | undefined;\n\n  constructor(opts: {\n    message: string;\n    /**\n     * What was being parsed — e.g. `'oauth-token-response'`,\n     * `'device-code-response'`. Lets consumers distinguish parse failures\n     * from different upstream APIs without parsing the message.\n     */\n    source?: string | undefined;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\n  }) {\n    super({\n      message: opts.message,\n      code: ERROR_CODES.PARSE_FAILED,\n      subsystem: 'general',\n      severity: 'error',\n      recoverable: false,\n      context: { source: opts.source, ...opts.context },\n      cause: opts.cause,\n    });\n    this.name = 'ParseError';\n    this.source = opts.source;\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\nexport function isFsError(err: unknown): err is FsError {\n  return err instanceof FsError;\n}\n\nexport function isToolValidationError(err: unknown): err is ToolValidationError {\n  return err instanceof ToolValidationError;\n}\n\nexport function isFetchError(err: unknown): err is FetchError {\n  return err instanceof FetchError;\n}\n\nexport function isParseError(err: unknown): err is ParseError {\n  return err instanceof ParseError;\n}\n\nexport function isSddError(err: unknown): err is SddError {\n  return err instanceof SddError;\n}\n","import { expectDefined } from '../utils/expect-defined.js';\n/**\n * ExtensionRegistry — manages AgentExtension registrations.\n *\n * Extensions are called in registration order at each lifecycle phase.\n * Each extension hook failure is caught and logged independently so\n * one bad extension can't take down the agent.\n */\n\nimport type { TextBlock } from '../types/blocks.js';\nimport { WrongStackError, ERROR_CODES } from '../types/errors.js';\nimport type { Logger } from '../types/logger.js';\nimport type { SystemPromptContributor } from '../types/system-prompt-contributor.js';\nimport type {\n  AfterIterationHook,\n  AfterRunHook,\n  AfterToolExecutionHook,\n  AgentExtension,\n  BeforeIterationHook,\n  BeforeRunHook,\n  BeforeToolExecutionHook,\n  OnErrorHook,\n  ProviderRunnerFn,\n} from './extension-points.js';\nexport class ExtensionRegistry {\n  private readonly extensions: AgentExtension[] = [];\n  private readonly promptContributors: SystemPromptContributor[] = [];\n  private log: Logger | undefined;\n\n  setLogger(log: Logger): void {\n    this.log = log;\n  }\n\n  /**\n   * Register a system prompt contributor. Returns an unregister function.\n   * Contributors are called on every system prompt build in registration\n   * order. Their output blocks are inserted after the core environment\n   * block, before the mode and plan blocks.\n   */\n  registerSystemPromptContributor(c: SystemPromptContributor): () => void {\n    this.promptContributors.push(c);\n    return () => {\n      const idx = this.promptContributors.indexOf(c);\n      if (idx >= 0) this.promptContributors.splice(idx, 1);\n    };\n  }\n\n  /**\n   * Build all registered system prompt contributions.\n   * Failures are caught and logged — one bad contributor doesn't\n   * break the prompt assembly.\n   */\n  async buildSystemPromptContributions(\n    ctx: Parameters<SystemPromptContributor>[0],\n  ): Promise<TextBlock[]> {\n    const blocks: TextBlock[] = [];\n    // Snapshot before iterating so mid-iteration registration doesn't cause\n    // skipped or duplicate contributor invocations during this phase.\n    const snapshot = [...this.promptContributors];\n    for (const c of snapshot) {\n      try {\n        const contributed = await c(ctx);\n        blocks.push(...contributed);\n      } catch (err) {\n        this.log?.error('SystemPromptContributor failed', err);\n      }\n    }\n    return blocks;\n  }\n\n  /**\n   * Returns the live array of contributors (readonly snapshot for\n   * passing to DefaultSystemPromptBuilder at build time).\n   */\n  listSystemPromptContributors(): readonly SystemPromptContributor[] {\n    return this.promptContributors;\n  }\n\n  /**\n   * Register an extension. Duplicate names are rejected.\n   * Returns an unregister function.\n   */\n  register(ext: AgentExtension): () => void {\n    if (this.extensions.some((e) => e.name === ext.name)) {\n      throw new WrongStackError({\n        message: `Extension \"${ext.name}\" already registered`,\n        code: ERROR_CODES.REGISTRY_DUPLICATE,\n        subsystem: 'container',\n        context: { extension: ext.name },\n      });\n    }\n    this.extensions.push(ext);\n    return () => this.unregister(ext.name);\n  }\n\n  /**\n   * Register an extension, silently replacing any previous registration\n   * with the same name. Use this when overriding a default extension.\n   */\n  registerOrReplace(ext: AgentExtension): () => void {\n    const idx = this.extensions.findIndex((e) => e.name === ext.name);\n    if (idx >= 0) this.extensions.splice(idx, 1);\n    return this.register(ext);\n  }\n\n  /**\n   * Unregister an extension by name. Returns true if found.\n   */\n  unregister(name: string): boolean {\n    const idx = this.extensions.findIndex((e) => e.name === name);\n    if (idx === -1) return false;\n    this.extensions.splice(idx, 1);\n    return true;\n  }\n\n  /**\n   * List registered extension names in order.\n   */\n  list(): readonly string[] {\n    return this.extensions.map((e) => e.name);\n  }\n\n  /**\n   * Check if an extension with the given name is registered.\n   */\n  has(name: string): boolean {\n    return this.extensions.some((e) => e.name === name);\n  }\n\n  /**\n   * Remove all registered extensions and contributors.\n   */\n  clear(): void {\n    this.extensions.length = 0;\n    this.promptContributors.length = 0;\n  }\n\n  // ── Hook runners ─────────────────────────────────────────────────\n\n  async runBeforeRun(...args: Parameters<BeforeRunHook>): Promise<void> {\n    const snapshot = [...this.extensions];\n    for (const ext of snapshot) {\n      if (!ext.beforeRun) continue;\n      try {\n        await ext.beforeRun(...args);\n      } catch (err) {\n        this.log?.error(`Extension \"${ext.name}\" beforeRun hook failed`, err);\n      }\n    }\n  }\n\n  async runAfterRun(...args: Parameters<AfterRunHook>): Promise<void> {\n    const snapshot = [...this.extensions];\n    for (const ext of snapshot) {\n      if (!ext.afterRun) continue;\n      try {\n        await ext.afterRun(...args);\n      } catch (err) {\n        this.log?.error(`Extension \"${ext.name}\" afterRun hook failed`, err);\n      }\n    }\n  }\n\n  async runBeforeIteration(...args: Parameters<BeforeIterationHook>): Promise<void> {\n    const snapshot = [...this.extensions];\n    for (const ext of snapshot) {\n      if (!ext.beforeIteration) continue;\n      try {\n        await ext.beforeIteration(...args);\n      } catch (err) {\n        this.log?.error(`Extension \"${ext.name}\" beforeIteration hook failed`, err);\n      }\n    }\n  }\n\n  async runAfterIteration(...args: Parameters<AfterIterationHook>): Promise<void> {\n    const snapshot = [...this.extensions];\n    for (const ext of snapshot) {\n      if (!ext.afterIteration) continue;\n      try {\n        await ext.afterIteration(...args);\n      } catch (err) {\n        this.log?.error(`Extension \"${ext.name}\" afterIteration hook failed`, err);\n      }\n    }\n  }\n\n  /**\n   * Run onError hooks in order. The first hook that returns a non-void\n   * result wins; subsequent hooks are skipped.\n   */\n  async runOnError(\n    ...args: Parameters<OnErrorHook>\n  ): Promise<\n    { action: 'retry'; model?: string | undefined } | { action: 'fail' } | { action: 'continue' } | void\n  > {\n    const snapshot = [...this.extensions];\n    for (const ext of snapshot) {\n      if (!ext.onError) continue;\n      try {\n        const result = await ext.onError(...args);\n        if (result) return result;\n      } catch (err) {\n        this.log?.error(`Extension \"${ext.name}\" onError hook failed`, err);\n      }\n    }\n  }\n\n  /**\n   * Build a composed provider runner. Extensions with `wrapProviderRunner`\n   * form a middleware-style chain: the innermost extension wraps the\n   * default runner, each subsequent wrapper wraps the previous.\n   */\n  wrapProviderRunner(inner: ProviderRunnerFn): ProviderRunnerFn {\n    const wrappers = this.extensions\n      .filter((e) => e.wrapProviderRunner)\n      .map((e) => ({ name: e.name, wrap: expectDefined(e.wrapProviderRunner) }));\n\n    if (wrappers.length === 0) return inner;\n\n    // Build chain from innermost to outermost\n    let composed: ProviderRunnerFn = inner;\n    for (let i = wrappers.length - 1; i >= 0; i--) {\n      const wrapper = wrappers[i];\n      if (!wrapper) continue;\n      const next = composed;\n      composed = async (ctx, req) => {\n        try {\n          return await wrapper.wrap(ctx, req, next);\n        } catch (err) {\n          this.log?.error(`Extension \"${wrapper.name}\" wrapProviderRunner failed`, err);\n          throw err;\n        }\n      };\n    }\n    return composed;\n  }\n\n  async runBeforeToolExecution(\n    ...args: Parameters<BeforeToolExecutionHook>\n  ): Promise<Parameters<BeforeToolExecutionHook>[1]> {\n    let toolUses = args[1];\n    const snapshot = [...this.extensions];\n    for (const ext of snapshot) {\n      if (!ext.beforeToolExecution) continue;\n      try {\n        toolUses = await ext.beforeToolExecution(args[0], toolUses);\n      } catch (err) {\n        this.log?.error(`Extension \"${ext.name}\" beforeToolExecution hook failed`, err);\n      }\n    }\n    return toolUses;\n  }\n\n  async runAfterToolExecution(...args: Parameters<AfterToolExecutionHook>): Promise<void> {\n    const snapshot = [...this.extensions];\n    for (const ext of snapshot) {\n      if (!ext.afterToolExecution) continue;\n      try {\n        await ext.afterToolExecution(...args);\n      } catch (err) {\n        this.log?.error(`Extension \"${ext.name}\" afterToolExecution hook failed`, err);\n      }\n    }\n  }\n}\n"]}
+{
+  "version": 3,
+  "sources": ["../../src/utils/expect-defined.ts", "../../src/types/errors.ts", "../../src/extension/registry.ts"],
+  "sourcesContent": ["/** Assert a value is neither null nor undefined. Throws if it is.\n *  Useful after optional chaining and indexed access when the\n *  control flow guarantees the value exists but TypeScript can't\n *  prove it (e.g. after a check on a related field). */\nexport function expectDefined<T>(value: T | null | undefined, label?: string): T {\n  if (value === null || value === undefined) {\n    const err = new Error(label ? `Expected ${label} to be defined` : 'Expected value to be defined');\n    err.name = 'ExpectDefinedError';\n    throw err;\n  }\n  return value;\n}\n", "import { toErrorMessage } from '../utils/index.js';\n\n/**\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// \u2500\u2500 Error codes \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * Machine-readable error codes as frozen constants.\n *\n * Use `ERROR_CODES.X` instead of raw string literals for:\n * - IDE autocomplete and compile-time validation\n * - Safe refactoring (rename updates all usages)\n * - Plugin extensibility (extend the object to add custom codes)\n *\n * The `ErrorCode` type is derived from this object, so adding a new\n * code here automatically updates the type without extra changes.\n */\nexport const ERROR_CODES = {\n  // Provider\n  PROVIDER_RATE_LIMITED: 'PROVIDER_RATE_LIMITED',\n  PROVIDER_AUTH_FAILED: 'PROVIDER_AUTH_FAILED',\n  PROVIDER_OVERLOADED: 'PROVIDER_OVERLOADED',\n  PROVIDER_INVALID_REQUEST: 'PROVIDER_INVALID_REQUEST',\n  PROVIDER_SERVER_ERROR: 'PROVIDER_SERVER_ERROR',\n  PROVIDER_NETWORK_ERROR: 'PROVIDER_NETWORK_ERROR',\n  PROVIDER_CONTEXT_OVERFLOW: 'PROVIDER_CONTEXT_OVERFLOW',\n  // Tool\n  TOOL_NOT_FOUND: 'TOOL_NOT_FOUND',\n  TOOL_PERMISSION_DENIED: 'TOOL_PERMISSION_DENIED',\n  TOOL_EXECUTION_FAILED: 'TOOL_EXECUTION_FAILED',\n  TOOL_TIMEOUT: 'TOOL_TIMEOUT',\n  TOOL_INPUT_INVALID: 'TOOL_INPUT_INVALID',\n  // Config\n  CONFIG_INVALID: 'CONFIG_INVALID',\n  CONFIG_NOT_FOUND: 'CONFIG_NOT_FOUND',\n  CONFIG_PARSE_FAILED: 'CONFIG_PARSE_FAILED',\n  CONFIG_MIGRATION_NEEDED: 'CONFIG_MIGRATION_NEEDED',\n  // Plugin\n  PLUGIN_LOAD_FAILED: 'PLUGIN_LOAD_FAILED',\n  PLUGIN_API_MISMATCH: 'PLUGIN_API_MISMATCH',\n  PLUGIN_MISSING_DEPENDENCY: 'PLUGIN_MISSING_DEPENDENCY',\n  // Agent\n  AGENT_ITERATION_LIMIT: 'AGENT_ITERATION_LIMIT',\n  AGENT_CONTEXT_OVERFLOW: 'AGENT_CONTEXT_OVERFLOW',\n  AGENT_ABORTED: 'AGENT_ABORTED',\n  AGENT_RUN_FAILED: 'AGENT_RUN_FAILED',\n  // Session\n  SESSION_NOT_FOUND: 'SESSION_NOT_FOUND',\n  SESSION_CORRUPTED: 'SESSION_CORRUPTED',\n  SESSION_WRITE_FAILED: 'SESSION_WRITE_FAILED',\n  // Container / Registry\n  CONTAINER_TOKEN_ALREADY_BOUND: 'CONTAINER_TOKEN_ALREADY_BOUND',\n  CONTAINER_TOKEN_NOT_BOUND: 'CONTAINER_TOKEN_NOT_BOUND',\n  CONTAINER_CIRCULAR_DEPENDENCY: 'CONTAINER_CIRCULAR_DEPENDENCY',\n  REGISTRY_DUPLICATE: 'REGISTRY_DUPLICATE',\n  REGISTRY_NOT_FOUND: 'REGISTRY_NOT_FOUND',\n  REGISTRY_INVALID: 'REGISTRY_INVALID',\n  // File system\n  FS_READ_FAILED: 'FS_READ_FAILED',\n  FS_WRITE_FAILED: 'FS_WRITE_FAILED',\n  FS_MKDIR_FAILED: 'FS_MKDIR_FAILED',\n  FS_DELETE_FAILED: 'FS_DELETE_FAILED',\n  FS_ATOMIC_WRITE_FAILED: 'FS_ATOMIC_WRITE_FAILED',\n  // SDD (Spec-Driven Development)\n  SDD_VALIDATION_FAILED: 'SDD_VALIDATION_FAILED',\n  SDD_PARSE_FAILED: 'SDD_PARSE_FAILED',\n  SDD_INVALID_STATE: 'SDD_INVALID_STATE',\n  SDD_NOT_READY: 'SDD_NOT_READY',\n  // General\n  VALIDATION_ERROR: 'VALIDATION_ERROR',\n  PARSE_FAILED: 'PARSE_FAILED',\n  UNKNOWN: 'UNKNOWN',\n} as const;\n\n/**\n * Union type derived from `ERROR_CODES`. Using `typeof ERROR_CODES[keyof typeof ERROR_CODES]`\n * instead of a string literal union means TypeScript auto-updates the type whenever\n * a new code is added to `ERROR_CODES` \u2014 no need to keep two lists in sync.\n */\nexport type ErrorCode = (typeof ERROR_CODES)[keyof typeof ERROR_CODES];\n\nexport type ErrorSubsystem =\n  | 'provider'\n  | 'tool'\n  | 'config'\n  | 'plugin'\n  | 'agent'\n  | 'session'\n  | 'sdd'\n  | 'container'\n  | 'fs'\n  | 'general';\nexport type ErrorSeverity = 'fatal' | 'error' | 'warning';\n\n// \u2500\u2500 Base error class \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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> | undefined;\n\n  constructor(opts: {\n    message: string;\n    code: ErrorCode;\n    subsystem: ErrorSubsystem;\n    severity?: ErrorSeverity | undefined;\n    recoverable?: boolean | undefined;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\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// \u2500\u2500 Specific error classes \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * Tool execution errors \u2014 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 | undefined;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\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> | undefined;\n    cause?: unknown | undefined;\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> | undefined;\n    cause?: unknown | undefined;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'plugin',\n      severity: 'error',\n      recoverable: opts.code === ERROR_CODES.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 \u2014 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 | undefined;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'agent',\n      severity: opts.code === ERROR_CODES.AGENT_ABORTED ? 'warning' : 'error',\n      recoverable: opts.recoverable ?? opts.code === ERROR_CODES.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'> = ERROR_CODES.AGENT_RUN_FAILED,\n): WrongStackError {\n  if (err instanceof WrongStackError) return err;\n  const message = toErrorMessage(err);\n  return new AgentError({\n    message,\n    code: code === 'UNKNOWN' ? ERROR_CODES.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 | undefined;\n\n  constructor(opts: {\n    message: string;\n    code: Extract<ErrorCode, 'SESSION_NOT_FOUND' | 'SESSION_CORRUPTED' | 'SESSION_WRITE_FAILED'>;\n    sessionId?: string | undefined;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'session',\n      severity: opts.code === ERROR_CODES.SESSION_WRITE_FAILED ? 'error' : 'warning',\n      recoverable: opts.code !== ERROR_CODES.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/**\n * SDD (Spec-Driven Development) errors \u2014 spec validation, parsing, and\n * state machine violations in the AISpecBuilder, TaskFlow, and TaskTracker.\n */\nexport class SddError extends WrongStackError {\n  constructor(opts: {\n    message: string;\n    code: Extract<\n      ErrorCode,\n      'SDD_VALIDATION_FAILED' | 'SDD_PARSE_FAILED' | 'SDD_INVALID_STATE' | 'SDD_NOT_READY'\n    >;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'sdd',\n      severity: opts.code === ERROR_CODES.SDD_PARSE_FAILED ? 'warning' : 'error',\n      recoverable: opts.code === ERROR_CODES.SDD_NOT_READY,\n      context: opts.context,\n      cause: opts.cause,\n    });\n    this.name = 'SddError';\n  }\n}\n\n/**\n * File system operation errors.\n */\nexport class FsError extends WrongStackError {\n  readonly path?: string | undefined;\n\n  constructor(opts: {\n    message: string;\n    code: Extract<\n      ErrorCode,\n      'FS_READ_FAILED' | 'FS_WRITE_FAILED' | 'FS_MKDIR_FAILED' | 'FS_DELETE_FAILED' | 'FS_ATOMIC_WRITE_FAILED'\n    >;\n    path?: string | undefined;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\n  }) {\n    super({\n      message: opts.message,\n      code: opts.code,\n      subsystem: 'fs',\n      severity: 'error',\n      recoverable: opts.code !== ERROR_CODES.FS_READ_FAILED,\n      context: { path: opts.path, ...opts.context },\n      cause: opts.cause,\n    });\n    this.name = 'FsError';\n    this.path = opts.path;\n  }\n}\n\n/**\n * HTTP fetch error \u2014 thrown when a network request returns a non-OK status.\n * Carries the response status so {@link classifyToolError} can branch on it\n * (429 \u2192 transient, 404 \u2192 not_found, 401 \u2192 permission) without duck-typing\n * the error via `'response' in err`.\n *\n * P3 #18 (before-release.md): the previous `'response' in err` check caught\n * any Error with a `response` property, including custom errors, proxy\n * objects, or mocked errors in tests. `instanceof FetchError` is reliable.\n *\n * Tools and providers that make HTTP requests and need the executor to\n * classify their failures should throw `new FetchError({ status, message })`\n * instead of a bare `Error` with an ad-hoc `response` field.\n */\nexport class FetchError extends WrongStackError {\n  readonly status: number;\n\n  constructor(opts: {\n    message: string;\n    status: number;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\n  }) {\n    super({\n      message: opts.message,\n      code: ERROR_CODES.VALIDATION_ERROR,\n      subsystem: 'general',\n      severity: 'error',\n      recoverable: opts.status === 429 || opts.status >= 500,\n      context: { status: opts.status, ...opts.context },\n      cause: opts.cause,\n    });\n    this.name = 'FetchError';\n    this.status = opts.status;\n  }\n}\n\n/**\n * Tool input validation error \u2014 thrown when a tool's input fails a validation\n * check that the JSON Schema cannot express (e.g. `old_string === new_string`\n * in edit, or a cross-field invariant). Use this instead of a bare\n * `throw new Error('...validation...')` so {@link classifyToolError} can\n * match on `instanceof` rather than a locale-dependent message substring.\n *\n * P2 #6 (before-release.md): the previous `err.message.includes('validation')`\n * check misclassified any error whose message happened to contain \"validation\"\n * (e.g. a third-party \"input validation timeout\") as a VALIDATION error.\n *\n * Named `ToolValidationError` (not `ValidationError`) to avoid colliding with\n * the existing `ValidationError` interface exported by json-schema-validate.ts\n * (a validation-result shape, not an Error subclass).\n */\nexport class ToolValidationError extends WrongStackError {\n  constructor(opts: {\n    message: string;\n    /** Field path or tool name that failed validation, for diagnostics. */\n    field?: string | undefined;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\n  }) {\n    super({\n      message: opts.message,\n      code: ERROR_CODES.VALIDATION_ERROR,\n      subsystem: 'general',\n      severity: 'error',\n      recoverable: false,\n      context: { field: opts.field, ...opts.context },\n      cause: opts.cause,\n    });\n    this.name = 'ToolValidationError';\n  }\n}\n\n/**\n * Response / payload parse error \u2014 thrown when an upstream HTTP response,\n * file, or data structure is well-formed at the transport layer (HTTP 200,\n * valid JSON) but is missing required fields or has an unexpected shape.\n *\n * Distinct from `ConfigError(CONFIG_PARSE_FAILED)` (which is specifically\n * for config-file parsing) and `FetchError` (which covers HTTP non-OK\n * responses). `ParseError` fills the gap: the request succeeded but the\n * response body couldn't be interpreted.\n *\n * Common sites: OAuth token responses missing `access_token`, device-code\n * responses missing `device_code`, registry responses with unexpected\n * schemas.\n */\nexport class ParseError extends WrongStackError {\n  readonly source?: string | undefined;\n\n  constructor(opts: {\n    message: string;\n    /**\n     * What was being parsed \u2014 e.g. `'oauth-token-response'`,\n     * `'device-code-response'`. Lets consumers distinguish parse failures\n     * from different upstream APIs without parsing the message.\n     */\n    source?: string | undefined;\n    context?: Record<string, unknown> | undefined;\n    cause?: unknown | undefined;\n  }) {\n    super({\n      message: opts.message,\n      code: ERROR_CODES.PARSE_FAILED,\n      subsystem: 'general',\n      severity: 'error',\n      recoverable: false,\n      context: { source: opts.source, ...opts.context },\n      cause: opts.cause,\n    });\n    this.name = 'ParseError';\n    this.source = opts.source;\n  }\n}\n\n// \u2500\u2500 Type guards \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\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\nexport function isFsError(err: unknown): err is FsError {\n  return err instanceof FsError;\n}\n\nexport function isToolValidationError(err: unknown): err is ToolValidationError {\n  return err instanceof ToolValidationError;\n}\n\nexport function isFetchError(err: unknown): err is FetchError {\n  return err instanceof FetchError;\n}\n\nexport function isParseError(err: unknown): err is ParseError {\n  return err instanceof ParseError;\n}\n\nexport function isSddError(err: unknown): err is SddError {\n  return err instanceof SddError;\n}\n", "import { expectDefined } from '../utils/expect-defined.js';\n/**\n * ExtensionRegistry \u2014 manages AgentExtension registrations.\n *\n * Extensions are called in registration order at each lifecycle phase.\n * Each extension hook failure is caught and logged independently so\n * one bad extension can't take down the agent.\n */\n\nimport type { TextBlock } from '../types/blocks.js';\nimport { WrongStackError, ERROR_CODES } from '../types/errors.js';\nimport type { Logger } from '../types/logger.js';\nimport type { SystemPromptContributor } from '../types/system-prompt-contributor.js';\nimport type {\n  AfterIterationHook,\n  AfterRunHook,\n  AfterToolExecutionHook,\n  AgentExtension,\n  BeforeIterationHook,\n  BeforeRunHook,\n  BeforeToolExecutionHook,\n  OnErrorHook,\n  ProviderRunnerFn,\n} from './extension-points.js';\nexport class ExtensionRegistry {\n  private readonly extensions: AgentExtension[] = [];\n  private readonly promptContributors: SystemPromptContributor[] = [];\n  private log: Logger | undefined;\n\n  setLogger(log: Logger): void {\n    this.log = log;\n  }\n\n  /**\n   * Register a system prompt contributor. Returns an unregister function.\n   * Contributors are called on every system prompt build in registration\n   * order. Their output blocks are inserted after the core environment\n   * block, before the mode and plan blocks.\n   */\n  registerSystemPromptContributor(c: SystemPromptContributor): () => void {\n    this.promptContributors.push(c);\n    return () => {\n      const idx = this.promptContributors.indexOf(c);\n      if (idx >= 0) this.promptContributors.splice(idx, 1);\n    };\n  }\n\n  /**\n   * Build all registered system prompt contributions.\n   * Failures are caught and logged \u2014 one bad contributor doesn't\n   * break the prompt assembly.\n   */\n  async buildSystemPromptContributions(\n    ctx: Parameters<SystemPromptContributor>[0],\n  ): Promise<TextBlock[]> {\n    const blocks: TextBlock[] = [];\n    // Snapshot before iterating so mid-iteration registration doesn't cause\n    // skipped or duplicate contributor invocations during this phase.\n    const snapshot = [...this.promptContributors];\n    for (const c of snapshot) {\n      try {\n        const contributed = await c(ctx);\n        blocks.push(...contributed);\n      } catch (err) {\n        this.log?.error('SystemPromptContributor failed', err);\n      }\n    }\n    return blocks;\n  }\n\n  /**\n   * Returns the live array of contributors (readonly snapshot for\n   * passing to DefaultSystemPromptBuilder at build time).\n   */\n  listSystemPromptContributors(): readonly SystemPromptContributor[] {\n    return this.promptContributors;\n  }\n\n  /**\n   * Register an extension. Duplicate names are rejected.\n   * Returns an unregister function.\n   */\n  register(ext: AgentExtension): () => void {\n    if (this.extensions.some((e) => e.name === ext.name)) {\n      throw new WrongStackError({\n        message: `Extension \"${ext.name}\" already registered`,\n        code: ERROR_CODES.REGISTRY_DUPLICATE,\n        subsystem: 'container',\n        context: { extension: ext.name },\n      });\n    }\n    this.extensions.push(ext);\n    return () => this.unregister(ext.name);\n  }\n\n  /**\n   * Register an extension, silently replacing any previous registration\n   * with the same name. Use this when overriding a default extension.\n   */\n  registerOrReplace(ext: AgentExtension): () => void {\n    const idx = this.extensions.findIndex((e) => e.name === ext.name);\n    if (idx >= 0) this.extensions.splice(idx, 1);\n    return this.register(ext);\n  }\n\n  /**\n   * Unregister an extension by name. Returns true if found.\n   */\n  unregister(name: string): boolean {\n    const idx = this.extensions.findIndex((e) => e.name === name);\n    if (idx === -1) return false;\n    this.extensions.splice(idx, 1);\n    return true;\n  }\n\n  /**\n   * List registered extension names in order.\n   */\n  list(): readonly string[] {\n    return this.extensions.map((e) => e.name);\n  }\n\n  /**\n   * Check if an extension with the given name is registered.\n   */\n  has(name: string): boolean {\n    return this.extensions.some((e) => e.name === name);\n  }\n\n  /**\n   * Remove all registered extensions and contributors.\n   */\n  clear(): void {\n    this.extensions.length = 0;\n    this.promptContributors.length = 0;\n  }\n\n  // \u2500\u2500 Hook runners \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n  async runBeforeRun(...args: Parameters<BeforeRunHook>): Promise<void> {\n    const snapshot = [...this.extensions];\n    for (const ext of snapshot) {\n      if (!ext.beforeRun) continue;\n      try {\n        await ext.beforeRun(...args);\n      } catch (err) {\n        this.log?.error(`Extension \"${ext.name}\" beforeRun hook failed`, err);\n      }\n    }\n  }\n\n  async runAfterRun(...args: Parameters<AfterRunHook>): Promise<void> {\n    const snapshot = [...this.extensions];\n    for (const ext of snapshot) {\n      if (!ext.afterRun) continue;\n      try {\n        await ext.afterRun(...args);\n      } catch (err) {\n        this.log?.error(`Extension \"${ext.name}\" afterRun hook failed`, err);\n      }\n    }\n  }\n\n  async runBeforeIteration(...args: Parameters<BeforeIterationHook>): Promise<void> {\n    const snapshot = [...this.extensions];\n    for (const ext of snapshot) {\n      if (!ext.beforeIteration) continue;\n      try {\n        await ext.beforeIteration(...args);\n      } catch (err) {\n        this.log?.error(`Extension \"${ext.name}\" beforeIteration hook failed`, err);\n      }\n    }\n  }\n\n  async runAfterIteration(...args: Parameters<AfterIterationHook>): Promise<void> {\n    const snapshot = [...this.extensions];\n    for (const ext of snapshot) {\n      if (!ext.afterIteration) continue;\n      try {\n        await ext.afterIteration(...args);\n      } catch (err) {\n        this.log?.error(`Extension \"${ext.name}\" afterIteration hook failed`, err);\n      }\n    }\n  }\n\n  /**\n   * Run onError hooks in order. The first hook that returns a non-void\n   * result wins; subsequent hooks are skipped.\n   */\n  async runOnError(\n    ...args: Parameters<OnErrorHook>\n  ): Promise<\n    { action: 'retry'; model?: string | undefined } | { action: 'fail' } | { action: 'continue' } | void\n  > {\n    const snapshot = [...this.extensions];\n    for (const ext of snapshot) {\n      if (!ext.onError) continue;\n      try {\n        const result = await ext.onError(...args);\n        if (result) return result;\n      } catch (err) {\n        this.log?.error(`Extension \"${ext.name}\" onError hook failed`, err);\n      }\n    }\n  }\n\n  /**\n   * Build a composed provider runner. Extensions with `wrapProviderRunner`\n   * form a middleware-style chain: the innermost extension wraps the\n   * default runner, each subsequent wrapper wraps the previous.\n   */\n  wrapProviderRunner(inner: ProviderRunnerFn): ProviderRunnerFn {\n    const wrappers = this.extensions\n      .filter((e) => e.wrapProviderRunner)\n      .map((e) => ({ name: e.name, wrap: expectDefined(e.wrapProviderRunner) }));\n\n    if (wrappers.length === 0) return inner;\n\n    // Build chain from innermost to outermost\n    let composed: ProviderRunnerFn = inner;\n    for (let i = wrappers.length - 1; i >= 0; i--) {\n      const wrapper = wrappers[i];\n      if (!wrapper) continue;\n      const next = composed;\n      composed = async (ctx, req) => {\n        try {\n          return await wrapper.wrap(ctx, req, next);\n        } catch (err) {\n          this.log?.error(`Extension \"${wrapper.name}\" wrapProviderRunner failed`, err);\n          throw err;\n        }\n      };\n    }\n    return composed;\n  }\n\n  async runBeforeToolExecution(\n    ...args: Parameters<BeforeToolExecutionHook>\n  ): Promise<Parameters<BeforeToolExecutionHook>[1]> {\n    let toolUses = args[1];\n    const snapshot = [...this.extensions];\n    for (const ext of snapshot) {\n      if (!ext.beforeToolExecution) continue;\n      try {\n        toolUses = await ext.beforeToolExecution(args[0], toolUses);\n      } catch (err) {\n        this.log?.error(`Extension \"${ext.name}\" beforeToolExecution hook failed`, err);\n      }\n    }\n    return toolUses;\n  }\n\n  async runAfterToolExecution(...args: Parameters<AfterToolExecutionHook>): Promise<void> {\n    const snapshot = [...this.extensions];\n    for (const ext of snapshot) {\n      if (!ext.afterToolExecution) continue;\n      try {\n        await ext.afterToolExecution(...args);\n      } catch (err) {\n        this.log?.error(`Extension \"${ext.name}\" afterToolExecution hook failed`, err);\n      }\n    }\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/extension/registry.d.ts

@@ -0,0 +1,86 @@
+/**
+ * ExtensionRegistry — manages AgentExtension registrations.
+ *
+ * Extensions are called in registration order at each lifecycle phase.
+ * Each extension hook failure is caught and logged independently so
+ * one bad extension can't take down the agent.
+ */
+import type { TextBlock } from '../types/blocks.js';
+import type { Logger } from '../types/logger.js';
+import type { SystemPromptContributor } from '../types/system-prompt-contributor.js';
+import type { AfterIterationHook, AfterRunHook, AfterToolExecutionHook, AgentExtension, BeforeIterationHook, BeforeRunHook, BeforeToolExecutionHook, OnErrorHook, ProviderRunnerFn } from './extension-points.js';
+export declare class ExtensionRegistry {
+    private readonly extensions;
+    private readonly promptContributors;
+    private log;
+    setLogger(log: Logger): void;
+    /**
+     * Register a system prompt contributor. Returns an unregister function.
+     * Contributors are called on every system prompt build in registration
+     * order. Their output blocks are inserted after the core environment
+     * block, before the mode and plan blocks.
+     */
+    registerSystemPromptContributor(c: SystemPromptContributor): () => void;
+    /**
+     * Build all registered system prompt contributions.
+     * Failures are caught and logged — one bad contributor doesn't
+     * break the prompt assembly.
+     */
+    buildSystemPromptContributions(ctx: Parameters<SystemPromptContributor>[0]): Promise<TextBlock[]>;
+    /**
+     * Returns the live array of contributors (readonly snapshot for
+     * passing to DefaultSystemPromptBuilder at build time).
+     */
+    listSystemPromptContributors(): readonly SystemPromptContributor[];
+    /**
+     * Register an extension. Duplicate names are rejected.
+     * Returns an unregister function.
+     */
+    register(ext: AgentExtension): () => void;
+    /**
+     * Register an extension, silently replacing any previous registration
+     * with the same name. Use this when overriding a default extension.
+     */
+    registerOrReplace(ext: AgentExtension): () => void;
+    /**
+     * Unregister an extension by name. Returns true if found.
+     */
+    unregister(name: string): boolean;
+    /**
+     * List registered extension names in order.
+     */
+    list(): readonly string[];
+    /**
+     * Check if an extension with the given name is registered.
+     */
+    has(name: string): boolean;
+    /**
+     * Remove all registered extensions and contributors.
+     */
+    clear(): void;
+    runBeforeRun(...args: Parameters<BeforeRunHook>): Promise<void>;
+    runAfterRun(...args: Parameters<AfterRunHook>): Promise<void>;
+    runBeforeIteration(...args: Parameters<BeforeIterationHook>): Promise<void>;
+    runAfterIteration(...args: Parameters<AfterIterationHook>): Promise<void>;
+    /**
+     * Run onError hooks in order. The first hook that returns a non-void
+     * result wins; subsequent hooks are skipped.
+     */
+    runOnError(...args: Parameters<OnErrorHook>): Promise<{
+        action: 'retry';
+        model?: string | undefined;
+    } | {
+        action: 'fail';
+    } | {
+        action: 'continue';
+    } | void>;
+    /**
+     * Build a composed provider runner. Extensions with `wrapProviderRunner`
+     * form a middleware-style chain: the innermost extension wraps the
+     * default runner, each subsequent wrapper wraps the previous.
+     */
+    wrapProviderRunner(inner: ProviderRunnerFn): ProviderRunnerFn;
+    runBeforeToolExecution(...args: Parameters<BeforeToolExecutionHook>): Promise<Parameters<BeforeToolExecutionHook>[1]>;
+    runAfterToolExecution(...args: Parameters<AfterToolExecutionHook>): Promise<void>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/extension/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/extension/registry.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,sBAAsB,EACtB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EACvB,WAAW,EACX,gBAAgB,EACjB,MAAM,uBAAuB,CAAC;AAC/B,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IACnD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAiC;IACpE,OAAO,CAAC,GAAG,CAAqB;IAEhC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3B;IAED;;;;;OAKG;IACH,+BAA+B,CAAC,CAAC,EAAE,uBAAuB,GAAG,MAAM,IAAI,CAMtE;IAED;;;;OAIG;IACG,8BAA8B,CAClC,GAAG,EAAE,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,SAAS,EAAE,CAAC,CActB;IAED;;;OAGG;IACH,4BAA4B,IAAI,SAAS,uBAAuB,EAAE,CAEjE;IAED;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,IAAI,CAWxC;IAED;;;OAGG;IACH,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,IAAI,CAIjD;IAED;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKhC;IAED;;OAEG;IACH,IAAI,IAAI,SAAS,MAAM,EAAE,CAExB;IAED;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAGZ;IAIK,YAAY,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAUpE;IAEK,WAAW,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAUlE;IAEK,kBAAkB,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,mBAAmB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhF;IAEK,iBAAiB,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAU9E;IAED;;;OAGG;IACG,UAAU,CACd,GAAG,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,GAC/B,OAAO,CACR;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,UAAU,CAAA;KAAE,GAAG,IAAI,CACrG,CAWA;IAED;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAuB5D;IAEK,sBAAsB,CAC1B,GAAG,IAAI,EAAE,UAAU,CAAC,uBAAuB,CAAC,GAC3C,OAAO,CAAC,UAAU,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,CAYjD;IAEK,qBAAqB,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,sBAAsB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAUtF;CACF"}

package/dist/fleet-notifier.d.ts

@@ -0,0 +1,28 @@
+export interface FleetNotifierOptions {
+    /** WrongStack global dir (`~/.wrongstack`) holding `webui-instances.json`. */
+    baseDir: string;
+    /** This process's project root — only WebUIs on the same project are pinged. */
+    projectRoot: string;
+    /** This process's pid, so a WebUI never pings itself. */
+    selfPid?: number | undefined;
+    /** Injectable POST for tests. Defaults to a timed `fetch`. */
+    post?: ((url: string) => Promise<void>) | undefined;
+}
+export declare class FleetNotifier {
+    private readonly baseDir;
+    private readonly projectRoot;
+    private readonly selfPid;
+    private readonly doPost;
+    private cache;
+    private timer;
+    private disposed;
+    constructor(opts: FleetNotifierOptions);
+    /** Coalesced, best-effort nudge. Safe to call on every status change. */
+    notify(): void;
+    /** Resolve same-project WebUI ping URLs (cached briefly). Exposed for tests. */
+    endpoints(): Promise<string[]>;
+    dispose(): void;
+    private flush;
+    private discover;
+}
+//# sourceMappingURL=fleet-notifier.d.ts.map

package/dist/fleet-notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-notifier.d.ts","sourceRoot":"","sources":["../src/fleet-notifier.ts"],"names":[],"mappings":"AAwDA,MAAM,WAAW,oBAAoB;IACnC,8EAA8E;IAC9E,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,8DAA8D;IAC9D,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CACrD;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiC;IAExD,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,QAAQ,CAAS;IAEzB,YAAY,IAAI,EAAE,oBAAoB,EAKrC;IAED,yEAAyE;IACzE,MAAM,IAAI,IAAI,CAQb;IAED,gFAAgF;IAC1E,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAMnC;IAED,OAAO,IAAI,IAAI,CAMd;YAEa,KAAK;YAKL,QAAQ;CAmBvB"}

package/dist/hooks/http-executor.d.ts

@@ -0,0 +1,11 @@
+import type { HookInput } from '../types/hooks.js';
+import type { Logger } from '../types/logger.js';
+import { type HookExecutionOptions, type HookExecutionResult } from './shell-executor.js';
+export interface HttpHookSpec {
+    url: string;
+    headers?: Record<string, string> | undefined;
+    timeoutMs?: number | undefined;
+}
+/** POST HookInput JSON to a native HTTP hook with deadline and cancellation. */
+export declare function runHttpHookDetailed(spec: HttpHookSpec, input: HookInput, logger?: Logger | undefined, options?: HookExecutionOptions): Promise<HookExecutionResult>;
+//# sourceMappingURL=http-executor.d.ts.map

package/dist/hooks/http-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-executor.d.ts","sourceRoot":"","sources":["../../src/hooks/http-executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EAEzB,MAAM,qBAAqB,CAAC;AAK7B,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAaD,gFAAgF;AAChF,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,SAAS,EAChB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAiE9B"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,10 @@
+export type { AnyHookOutcome, ConfiguredHook, HookEntry, HookEvent, HookFailurePolicy, HookInput, HookInvocationContext, HookMatcher, HookOutcome, HookRegistrationOptions, HttpHook, InProcessHook, PreToolUseOutcome, PreToolUseStage, ShellHook, } from '../types/hooks.js';
+export type { HttpHookSpec } from './http-executor.js';
+export { runHttpHookDetailed } from './http-executor.js';
+export { HookRegistry, hookMatcherMatches } from './registry.js';
+export type { HookRunEnv, HookRunnerOptions, PreToolUseResult, PromptResult } from './runner.js';
+export { HookRunner } from './runner.js';
+export type { HookExecutionFailure, HookExecutionFailureKind, HookExecutionOptions, HookExecutionResult, ShellHookSpec, } from './shell-executor.js';
+export { parseHookOutcome, runShellHook, runShellHookDetailed } from './shell-executor.js';
+export { countShellHooks, shellHooksEqual } from './shell-hooks-equal.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,cAAc,EACd,cAAc,EACd,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,SAAS,EACT,qBAAqB,EACrB,WAAW,EACX,WAAW,EACX,uBAAuB,EACvB,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,SAAS,GACV,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACjG,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EACV,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/hooks/registry.d.ts

@@ -0,0 +1,71 @@
+import type { ConfiguredHook, HookEntry, HookEvent, HookMatcher, HookRegistrationOptions, HttpHook, InProcessHook, ShellHook } from '../types/hooks.js';
+interface LoadConfiguredHooksOptions {
+    /** Load only trusted hooks that remain active under `--no-hooks`. */
+    policyOnly?: boolean | undefined;
+}
+/**
+ * Registry of lifecycle hooks (both in-process and shell). One instance is
+ * shared per session: the boot path loads `config.hooks` as shell entries and
+ * plugins add in-process entries via `PluginAPI.registerHook`. The
+ * `HookRunner` reads from it at each lifecycle phase.
+ */
+export declare class HookRegistry {
+    private readonly entries;
+    /** Register an in-process hook. Returns an unsubscribe function. */
+    registerInProcess(event: HookEvent, matcher: HookMatcher | undefined, hook: InProcessHook, owner?: string | undefined, options?: HookRegistrationOptions): () => void;
+    /**
+     * Register a single shell hook. The hook is owned by the runtime (no plugin
+     * name) — it survives plugin uninstalls. Returns an unsubscribe function.
+     */
+    registerShell(event: HookEvent, hook: ShellHook): () => void;
+    /** Register a native HTTP hook. */
+    registerHttp(event: HookEvent, hook: HttpHook): () => void;
+    /** Bulk-load command/HTTP hooks from a `config.hooks` map. */
+    loadShellHooks(hooks: Partial<Record<HookEvent, ConfiguredHook[]>> | undefined, options?: LoadConfiguredHooksOptions): void;
+    /**
+     * Atomically replace the shell-hook set: drop every currently-registered
+     * shell entry, then load the supplied `config.hooks` map. In-process
+     * hooks (and their plugin owners) are untouched — only shell entries
+     * are touched, because they are the only entries sourced from
+     * `config.hooks`.
+     *
+     * Designed for hot-reload via `ConfigStore.watch`: when the operator
+     * edits `config.json` and the store fires its watcher, the CLI calls
+     * this with the new `config.hooks` value. Idempotent — calling twice
+     * with the same map yields the same registry state (callers should still
+     * guard at the change-detection layer to avoid wasted work).
+     */
+    replaceShellHooks(hooks: Partial<Record<HookEvent, ConfiguredHook[]>> | undefined, options?: LoadConfiguredHooksOptions): void;
+    /** All entries registered for an event, in registration order. */
+    list(event: HookEvent): readonly HookEntry[];
+    /** True when any entry is registered for the event. */
+    has(event: HookEvent): boolean;
+    /** Every entry currently registered (across all events). */
+    all(): readonly HookEntry[];
+    /**
+     * Drop every in-process hook whose `owner` matches. Used by the plugin
+     * loader during teardown as a belt-and-braces backstop for the per-call
+     * unsubscribe functions pushed onto `pluginCleanupFns` — if a plugin
+     * `setup()` throws partway through after registering some hooks, the
+     * remaining unsubscribes may never run, and the registry would otherwise
+     * hold dangling references to a torn-down plugin's closures.
+     *
+     * Returns the number of hooks actually removed (useful for tests).
+     * Shell hooks are owned by the runtime, not a plugin, so they're never
+     * drained by owner.
+     */
+    drainByOwner(owner: string): number;
+    /** Count of in-process hooks currently registered by `owner`. */
+    countByOwner(owner: string): number;
+    /** Drop every registered hook (used in teardown / tests). */
+    clear(): void;
+    private remove;
+}
+/**
+ * Does a hook matcher apply to a tool name? `*` (or empty) matches everything;
+ * otherwise the matcher is a case-insensitive pipe-delimited list of exact
+ * tool names (`"edit|write"`). Non-tool events pass `undefined` and always match.
+ */
+export declare function hookMatcherMatches(matcher: HookMatcher, toolName: string | undefined): boolean;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/hooks/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/hooks/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,SAAS,EACT,WAAW,EACX,uBAAuB,EACvB,QAAQ,EACR,aAAa,EACb,SAAS,EACV,MAAM,mBAAmB,CAAC;AAE3B,UAAU,0BAA0B;IAClC,qEAAqE;IACrE,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClC;AAmBD;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAE3C,oEAAoE;IACpE,iBAAiB,CACf,KAAK,EAAE,SAAS,EAChB,OAAO,EAAE,WAAW,GAAG,SAAS,EAChC,IAAI,EAAE,aAAa,EACnB,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,GAAE,uBAA4B,GACpC,MAAM,IAAI,CAgBZ;IAED;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,IAAI,CAU3D;IAED,mCAAmC;IACnC,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,IAAI,CAWzD;IAED,8DAA8D;IAC9D,cAAc,CACZ,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC,GAAG,SAAS,EAC/D,OAAO,GAAE,0BAA+B,GACvC,IAAI,CAeN;IAED;;;;;;;;;;;;OAYG;IACH,iBAAiB,CACf,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC,GAAG,SAAS,EAC/D,OAAO,GAAE,0BAA+B,GACvC,IAAI,CAcN;IAED,kEAAkE;IAClE,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,SAAS,EAAE,CAE3C;IAED,uDAAuD;IACvD,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAE7B;IAED,4DAA4D;IAC5D,GAAG,IAAI,SAAS,SAAS,EAAE,CAE1B;IAED;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUlC;IAED,iEAAiE;IACjE,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMlC;IAED,6DAA6D;IAC7D,KAAK,IAAI,IAAI,CAEZ;IAED,OAAO,CAAC,MAAM;CAIf;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAS9F"}

package/dist/hooks/runner.d.ts

@@ -0,0 +1,65 @@
+import type { HookEvent } from '../types/hooks.js';
+import type { Logger } from '../types/logger.js';
+import { type HookRegistry } from './registry.js';
+/** Minimal run-state the runner reads. `Context` structurally satisfies it. */
+export interface HookRunEnv {
+    cwd: string;
+    signal?: AbortSignal | undefined;
+}
+export interface HookRunnerOptions {
+    registry: HookRegistry;
+    logger?: Logger | undefined;
+    /**
+     * When false, ordinary hooks are skipped across every transport;
+     * `policy: true` enforcement hooks still run.
+     */
+    allowNonPolicy?: boolean | undefined;
+    /** @deprecated Use `allowNonPolicy`; retained for API compatibility. */
+    allowShell?: boolean | undefined;
+    /** Resolves the active session id for the `HookInput` payload. */
+    sessionId?: (() => string) | undefined;
+}
+export interface PreToolUseResult {
+    block?: boolean | undefined;
+    reason?: string | undefined;
+    /** Present only when a hook replaced the tool input. */
+    input?: Record<string, unknown>;
+}
+export interface PromptResult {
+    block?: boolean | undefined;
+    reason?: string | undefined;
+    additionalContext?: string | undefined;
+}
+/**
+ * Drives the registered hooks at each lifecycle phase. Pure orchestration —
+ * the executor / pipeline / agent extension call the matching method and act on
+ * the returned decision. Fail-open hooks are skipped on failure; fail-closed
+ * policy hooks turn failures into explicit denials without prompting the user.
+ */
+export declare class HookRunner {
+    private readonly opts;
+    private readonly registry;
+    constructor(opts: HookRunnerOptions);
+    /** Cheap guard so callers can skip building payloads when nothing listens. */
+    has(event: HookEvent): boolean;
+    preToolUse(toolName: string, toolInput: Record<string, unknown>, env: HookRunEnv): Promise<PreToolUseResult>;
+    postToolUse(toolName: string, toolInput: unknown, result: {
+        content: string;
+        isError: boolean;
+    }, env: HookRunEnv): Promise<{
+        additionalContext?: string | undefined;
+        contextAs?: 'inline' | 'separate';
+    }>;
+    userPromptSubmit(prompt: string, env: HookRunEnv): Promise<PromptResult>;
+    sessionStart(env: HookRunEnv): Promise<{
+        additionalContext?: string | undefined;
+    }>;
+    stop(env: HookRunEnv): Promise<void>;
+    private base;
+    private matching;
+    private invoke;
+    private invokeInProcess;
+    private failureOutcome;
+    private collectContext;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/hooks/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/hooks/runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,SAAS,EAGV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjD,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,eAAe,CAAC;AAUtE,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,wEAAwE;IACxE,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,kEAAkE;IAClE,SAAS,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAsCD,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACxC;AAED;;;;;GAKG;AACH,qBAAa,UAAU;IAGT,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IAExC,YAA6B,IAAI,EAAE,iBAAiB,EAEnD;IAED,8EAA8E;IAC9E,GAAG,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAE7B;IAEK,UAAU,CACd,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,gBAAgB,CAAC,CAmD3B;IAEK,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,EAC7C,GAAG,EAAE,UAAU,GACd,OAAO,CAAC;QAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAA;KAAE,CAAC,CAuBxF;IAEK,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAgB7E;IAEK,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,CAAC,CAKvF;IAEK,IAAI,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAGzC;IAID,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,QAAQ;YAIF,MAAM;YA4CN,eAAe;IAyD7B,OAAO,CAAC,cAAc;YAcR,cAAc;CAqB7B"}

package/dist/hooks/shell-executor.d.ts

@@ -0,0 +1,33 @@
+import type { AnyHookOutcome, HookInput, HookOutcome } from '../types/hooks.js';
+import type { Logger } from '../types/logger.js';
+export interface ShellHookSpec {
+    command: string;
+    timeoutMs?: number | undefined;
+}
+export type HookExecutionFailureKind = 'aborted' | 'error' | 'exit' | 'invalid_output' | 'rejected' | 'timeout';
+export interface HookExecutionFailure {
+    kind: HookExecutionFailureKind;
+    message: string;
+}
+export interface HookExecutionResult {
+    outcome: AnyHookOutcome | null;
+    failure?: HookExecutionFailure | undefined;
+}
+export interface HookExecutionOptions {
+    signal?: AbortSignal | undefined;
+}
+/**
+ * Run a shell hook (Claude-compatible). The `HookInput` JSON is written to the
+ * command's stdin. Resolution rules, in order:
+ *   - exit code 2 → `{ decision: 'block', reason: <stderr or stdout> }`
+ *   - stdout parses as a JSON object → returned verbatim as a `HookOutcome`
+ *   - otherwise → no-op (`null`)
+ *
+ * The hook never throws into the agent loop: spawn errors and timeouts resolve
+ * to `null` and are logged. Output is capped at 64 KiB.
+ */
+export declare function runShellHook(spec: ShellHookSpec, input: HookInput, logger?: Logger | undefined): Promise<HookOutcome | null>;
+/** Detailed executor used by HookRunner to apply per-hook failure policy. */
+export declare function runShellHookDetailed(spec: ShellHookSpec, input: HookInput, logger?: Logger | undefined, options?: HookExecutionOptions): Promise<HookExecutionResult>;
+export declare function parseHookOutcome(stdout: string): AnyHookOutcome | null;
+//# sourceMappingURL=shell-executor.d.ts.map

package/dist/hooks/shell-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-executor.d.ts","sourceRoot":"","sources":["../../src/hooks/shell-executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAyGjD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAED,MAAM,MAAM,wBAAwB,GAChC,SAAS,GACT,OAAO,GACP,MAAM,GACN,gBAAgB,GAChB,UAAU,GACV,SAAS,CAAC;AAEd,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;CAC5C;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAClC;AAiCD;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,SAAS,EAChB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAC1B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAY7B;AAED,6EAA6E;AAC7E,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,SAAS,EAChB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,mBAAmB,CAAC,CAuH9B;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAmDtE"}

package/dist/hooks/shell-hooks-equal.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Helpers for comparing and counting shell-hook configurations.
+ * Used by the hot-reload path: the `ConfigStore` watcher fires on every
+ * `configStore.update` call (model, log level, anything), so we need a
+ * cheap predicate to decide whether `config.hooks` actually changed before
+ * re-running `replaceShellHooks`.
+ *
+ * Pure functions — no I/O, no logger, no side effects. Safe to import
+ * from anywhere.
+ */
+import type { ConfiguredHook, HookEvent } from '../types/hooks.js';
+export declare function shellHooksEqual(a: Partial<Record<HookEvent, ConfiguredHook[]>> | undefined, b: Partial<Record<HookEvent, ConfiguredHook[]>> | undefined): boolean;
+/** Count the total number of shell-hook entries across all events. */
+export declare function countShellHooks(hooks: Partial<Record<HookEvent, ConfiguredHook[]>> | undefined): number;
+//# sourceMappingURL=shell-hooks-equal.d.ts.map

package/dist/hooks/shell-hooks-equal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-hooks-equal.d.ts","sourceRoot":"","sources":["../../src/hooks/shell-hooks-equal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAuBnE,wBAAgB,eAAe,CAC7B,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC,GAAG,SAAS,EAC3D,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC,GAAG,SAAS,GAC1D,OAAO,CAqBT;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC,GAAG,SAAS,GAC9D,MAAM,CAOR"}

package/dist/hq/agent-bridge.d.ts

@@ -0,0 +1,27 @@
+/**
+ * AgentMonitorEventBridge — forwards local agent timeline and status events
+ * to the HQ publisher as structured HQ event envelopes, so the HQ browser
+ * dashboard sees real-time agent conversation streams.
+ */
+import type { EventBus } from '../kernel/events.js';
+import { type HqEventEnvelope } from './protocol.js';
+export type HqAgentEventPublisher = (envelope: HqEventEnvelope) => void;
+export interface AgentMonitorEventBridgeOptions {
+    /** Local EventBus emitting agent.timeline.* and agent.status_changed events. */
+    events: EventBus;
+    /** Client/project identifiers for HQ envelope authorship. */
+    clientId: string;
+    projectId: string;
+    /**
+     * Publish callback — called with each HQ event envelope. Wire this to
+     * your HQ publisher's `send()` or queue method when connected.
+     * When null (no HQ connection), events are silently dropped.
+     */
+    publish?: HqAgentEventPublisher | undefined;
+}
+/**
+ * Start forwarding agent monitoring events to HQ. Returns a disposer that
+ * unsubscribes all listeners — call on shutdown.
+ */
+export declare function startAgentMonitorEventBridge(opts: AgentMonitorEventBridgeOptions): () => void;
+//# sourceMappingURL=agent-bridge.d.ts.map

package/dist/hq/agent-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-bridge.d.ts","sourceRoot":"","sources":["../../src/hq/agent-bridge.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAgF,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAEnI,MAAM,MAAM,qBAAqB,GAAG,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;AAExE,MAAM,WAAW,8BAA8B;IAC7C,gFAAgF;IAChF,MAAM,EAAE,QAAQ,CAAC;IACjB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,8BAA8B,GAAG,MAAM,IAAI,CAyD7F"}