@wrongstack/core 0.306.3 → 0.307.0

package/dist/types/index.js

@@ -12,146 +12,385 @@ function isImageBlock(b) {
   return b.type === "image";
 }
 
-// src/types/tool.ts
-var ToolErrorCategory = /* @__PURE__ */ ((ToolErrorCategory2) => {
-  ToolErrorCategory2["TRANSIENT"] = "transient";
-  ToolErrorCategory2["NOT_FOUND"] = "not_found";
-  ToolErrorCategory2["PERMISSION"] = "permission";
-  ToolErrorCategory2["VALIDATION"] = "validation";
-  ToolErrorCategory2["FATAL"] = "fatal";
-  return ToolErrorCategory2;
-})(ToolErrorCategory || {});
-
-// src/types/tool-executor.ts
-var GOVERNED_TOOL_EXECUTOR_META_KEY = "toolExecutor.executeGoverned";
-
-// src/types/tool-markers.ts
-var MALFORMED_ARG_MARKERS = ["__raw", "__raw_arguments", "_raw"];
-
-// src/utils/string.ts
-function truncate(s, max) {
-  return s.length <= max ? s : `${s.slice(0, max - 1)}\u2026`;
+// src/types/config/fleet-chat.ts
+var FLEET_CHAT_VERBOSITY_VALUES = ["off", "full"];
+function resolveFleetChatVerbosity(autonomy) {
+  const explicit = autonomy?.fleetChatVerbosity;
+  if (explicit && FLEET_CHAT_VERBOSITY_VALUES.includes(explicit)) {
+    return explicit;
+  }
+  return "off";
 }
 
-// src/utils/error.ts
-function toErrorMessage(err) {
-  return err instanceof Error ? err.message : String(err);
+// src/types/config/runtime.ts
+function normalizeTokenSavingTier(val) {
+  if (val === void 0) return "off";
+  if (typeof val === "boolean") return val ? "medium" : "off";
+  if (val === "auto") return "medium";
+  const validTiers = /* @__PURE__ */ new Set([
+    "off",
+    "minimal",
+    "light",
+    "medium",
+    "aggressive"
+  ]);
+  return validTiers.has(val) ? val : "off";
 }
-
-// src/types/errors.ts
-var ERROR_CODES = {
-  // Provider
-  PROVIDER_RATE_LIMITED: "PROVIDER_RATE_LIMITED",
-  PROVIDER_AUTH_FAILED: "PROVIDER_AUTH_FAILED",
-  PROVIDER_OVERLOADED: "PROVIDER_OVERLOADED",
-  PROVIDER_INVALID_REQUEST: "PROVIDER_INVALID_REQUEST",
-  PROVIDER_SERVER_ERROR: "PROVIDER_SERVER_ERROR",
-  PROVIDER_NETWORK_ERROR: "PROVIDER_NETWORK_ERROR",
-  PROVIDER_CONTEXT_OVERFLOW: "PROVIDER_CONTEXT_OVERFLOW",
-  // Tool
-  TOOL_NOT_FOUND: "TOOL_NOT_FOUND",
-  TOOL_PERMISSION_DENIED: "TOOL_PERMISSION_DENIED",
-  TOOL_EXECUTION_FAILED: "TOOL_EXECUTION_FAILED",
-  TOOL_TIMEOUT: "TOOL_TIMEOUT",
-  TOOL_INPUT_INVALID: "TOOL_INPUT_INVALID",
-  // Config
-  CONFIG_INVALID: "CONFIG_INVALID",
-  CONFIG_NOT_FOUND: "CONFIG_NOT_FOUND",
-  CONFIG_PARSE_FAILED: "CONFIG_PARSE_FAILED",
-  CONFIG_MIGRATION_NEEDED: "CONFIG_MIGRATION_NEEDED",
-  // Plugin
-  PLUGIN_LOAD_FAILED: "PLUGIN_LOAD_FAILED",
-  PLUGIN_API_MISMATCH: "PLUGIN_API_MISMATCH",
-  PLUGIN_MISSING_DEPENDENCY: "PLUGIN_MISSING_DEPENDENCY",
-  // Agent
-  AGENT_ITERATION_LIMIT: "AGENT_ITERATION_LIMIT",
-  AGENT_CONTEXT_OVERFLOW: "AGENT_CONTEXT_OVERFLOW",
-  AGENT_ABORTED: "AGENT_ABORTED",
-  AGENT_RUN_FAILED: "AGENT_RUN_FAILED",
-  // Session
-  SESSION_NOT_FOUND: "SESSION_NOT_FOUND",
-  SESSION_CORRUPTED: "SESSION_CORRUPTED",
-  SESSION_WRITE_FAILED: "SESSION_WRITE_FAILED",
-  // Container / Registry
-  CONTAINER_TOKEN_ALREADY_BOUND: "CONTAINER_TOKEN_ALREADY_BOUND",
-  CONTAINER_TOKEN_NOT_BOUND: "CONTAINER_TOKEN_NOT_BOUND",
-  CONTAINER_CIRCULAR_DEPENDENCY: "CONTAINER_CIRCULAR_DEPENDENCY",
-  REGISTRY_DUPLICATE: "REGISTRY_DUPLICATE",
-  REGISTRY_NOT_FOUND: "REGISTRY_NOT_FOUND",
-  REGISTRY_INVALID: "REGISTRY_INVALID",
-  // File system
-  FS_READ_FAILED: "FS_READ_FAILED",
-  FS_WRITE_FAILED: "FS_WRITE_FAILED",
-  FS_MKDIR_FAILED: "FS_MKDIR_FAILED",
-  FS_DELETE_FAILED: "FS_DELETE_FAILED",
-  FS_ATOMIC_WRITE_FAILED: "FS_ATOMIC_WRITE_FAILED",
-  // SDD (Spec-Driven Development)
-  SDD_VALIDATION_FAILED: "SDD_VALIDATION_FAILED",
-  SDD_PARSE_FAILED: "SDD_PARSE_FAILED",
-  SDD_INVALID_STATE: "SDD_INVALID_STATE",
-  SDD_NOT_READY: "SDD_NOT_READY",
-  // General
-  VALIDATION_ERROR: "VALIDATION_ERROR",
-  PARSE_FAILED: "PARSE_FAILED",
-  UNKNOWN: "UNKNOWN"
-};
-var WrongStackError = class extends Error {
-  code;
-  subsystem;
-  severity;
-  recoverable;
-  context;
-  constructor(opts) {
-    super(opts.message, { cause: opts.cause });
-    this.name = "WrongStackError";
-    this.code = opts.code;
-    this.subsystem = opts.subsystem;
-    this.severity = opts.severity ?? "error";
-    this.recoverable = opts.recoverable ?? false;
-    this.context = opts.context;
+function resolveTokenSavingTier(val, maxContext) {
+  if (val === "auto") {
+    if (typeof maxContext !== "number" || !Number.isFinite(maxContext) || maxContext <= 0) {
+      return "off";
+    }
+    if (maxContext < 32e3) return "medium";
+    if (maxContext < 128e3) return "light";
+    return "minimal";
   }
-  /**
-   * Render a one-line user-facing description.
-   * Subclasses should override for domain-specific formatting.
-   */
-  describe() {
-    const ctx = this.context ? ` ${formatContext(this.context)}` : "";
-    return `${this.code}: ${this.message}${ctx}`;
+  return normalizeTokenSavingTier(val);
+}
+var DEFAULT_TUI_THINKING_WORD = "thinking";
+var MAX_TUI_THINKING_WORD_LENGTH = 16;
+function normalizeTuiThinkingWord(value) {
+  if (typeof value !== "string") return DEFAULT_TUI_THINKING_WORD;
+  const word = value.trim();
+  if (word.length === 0 || word.length > MAX_TUI_THINKING_WORD_LENGTH) {
+    return DEFAULT_TUI_THINKING_WORD;
   }
-};
-function formatContext(ctx) {
-  const parts = Object.entries(ctx).filter(([, v]) => v !== void 0).slice(0, 3).map(([k, v]) => `${k}=${String(v)}`);
-  return parts.length > 0 ? `[${parts.join(" ")}]` : "";
+  if (!/^[\p{L}\p{N}_-]+$/u.test(word)) return DEFAULT_TUI_THINKING_WORD;
+  return word;
 }
-var ToolError = class extends WrongStackError {
-  toolName;
-  constructor(opts) {
-    super({
-      message: opts.message,
-      code: opts.code,
-      subsystem: "tool",
-      recoverable: opts.recoverable,
-      context: { tool: opts.toolName, ...opts.context },
-      cause: opts.cause
-    });
-    this.name = "ToolError";
-    this.toolName = opts.toolName;
+
+// src/types/config/ui.ts
+var THEME_PRESET_IDS = [
+  "catppuccin",
+  "tokyo-night",
+  "nord",
+  "cyberpunk",
+  "dracula",
+  "gruvbox-dark",
+  "solarized-dark",
+  "one-dark",
+  "monokai",
+  "rose-pine",
+  "kanagawa",
+  "ayu-dark",
+  "everforest",
+  "night-owl",
+  "synthwave",
+  "github-dark",
+  "material-ocean",
+  "nightfox",
+  "oxocarbon",
+  "catppuccin-macchiato",
+  "catppuccin-frappe",
+  "gruvbox-material",
+  "tokyo-night-storm",
+  "rose-pine-moon",
+  "zenburn",
+  "palenight",
+  "horizon",
+  "sonokai",
+  "edge-dark",
+  "moonfly",
+  "melange",
+  "poimandres",
+  "vitesse-dark",
+  "aura",
+  "dark-plus"
+];
+
+// src/utils/expect-defined.ts
+function expectDefined(value, label) {
+  if (value === null || value === void 0) {
+    const err = new Error(label ? `Expected ${label} to be defined` : "Expected value to be defined");
+    err.name = "ExpectDefinedError";
+    throw err;
   }
-};
-var ConfigError = class extends WrongStackError {
-  constructor(opts) {
-    super({
-      message: opts.message,
-      code: opts.code,
-      subsystem: "config",
-      severity: "fatal",
-      recoverable: false,
-      context: opts.context,
-      cause: opts.cause
-    });
-    this.name = "ConfigError";
+  return value;
+}
+
+// src/types/context-window.ts
+var DEFAULT_CONTEXT_WINDOW_MODE_ID = "balanced";
+var DEPRECATED_CONTEXT_WINDOW_MODE_ALIASES = Object.freeze({
+  archival: "balanced"
+});
+var CONTEXT_WINDOW_MODES = Object.freeze([
+  {
+    id: "balanced",
+    name: "Balanced",
+    description: "Default rolling compaction: recent work stays verbatim, old tool output is trimmed.",
+    thresholds: { warn: 0.55, soft: 0.7, hard: 0.85 },
+    aggressiveOn: "soft",
+    preserveK: 8,
+    eliseThreshold: 1200,
+    targetLoad: 0.65
+  },
+  {
+    id: "frugal",
+    name: "Frugal",
+    description: "Token-saver mode: compacts early and keeps a tight verbatim tail.",
+    thresholds: { warn: 0.4, soft: 0.55, hard: 0.7 },
+    aggressiveOn: "warn",
+    preserveK: 4,
+    eliseThreshold: 500,
+    targetLoad: 0.45
+  },
+  {
+    id: "deep",
+    name: "Deep",
+    description: "Long-reasoning mode: delays compaction and keeps more recent turns intact.",
+    thresholds: { warn: 0.72, soft: 0.86, hard: 0.96 },
+    aggressiveOn: "hard",
+    preserveK: 18,
+    eliseThreshold: 5e3,
+    targetLoad: 0.82
   }
-};
+]);
+function listContextWindowModes() {
+  return CONTEXT_WINDOW_MODES.map((m) => ({ ...m, thresholds: { ...m.thresholds } }));
+}
+function normalizeContextWindowModeId(id) {
+  if (!id) return null;
+  if (isContextWindowModeId(id)) return id;
+  return DEPRECATED_CONTEXT_WINDOW_MODE_ALIASES[id] ?? null;
+}
+function isDeprecatedContextWindowModeId(id) {
+  return Object.hasOwn(DEPRECATED_CONTEXT_WINDOW_MODE_ALIASES, id);
+}
+function isContextWindowModeSelectionId(id) {
+  return isContextWindowModeId(id) || isDeprecatedContextWindowModeId(id);
+}
+function getContextWindowMode(id) {
+  const normalized = normalizeContextWindowModeId(id);
+  if (!normalized) return null;
+  const mode = CONTEXT_WINDOW_MODES.find((m) => m.id === normalized);
+  return mode ? { ...mode, thresholds: { ...mode.thresholds } } : null;
+}
+function isContextWindowModeId(id) {
+  return CONTEXT_WINDOW_MODES.some((m) => m.id === id);
+}
+function resolveContextWindowPolicy(config = {}, overrideMode) {
+  const requested = overrideMode ?? config.mode ?? DEFAULT_CONTEXT_WINDOW_MODE_ID;
+  const mode = getContextWindowMode(requested) ?? expectDefined(getContextWindowMode(DEFAULT_CONTEXT_WINDOW_MODE_ID));
+  return {
+    ...mode,
+    thresholds: {
+      warn: config.warnThreshold ?? mode.thresholds.warn,
+      soft: config.softThreshold ?? mode.thresholds.soft,
+      hard: config.hardThreshold ?? mode.thresholds.hard
+    },
+    preserveK: config.preserveK ?? mode.preserveK,
+    eliseThreshold: config.eliseThreshold ?? mode.eliseThreshold,
+    targetLoad: config.targetLoad ?? mode.targetLoad
+  };
+}
+function formatContextWindowModeList(activeId) {
+  const active = normalizeContextWindowModeId(activeId);
+  return CONTEXT_WINDOW_MODES.map((m) => {
+    const marker = m.id === active ? "*" : " ";
+    return `${marker} ${m.id.padEnd(9)} ${m.name} - ${m.description}`;
+  }).join("\n");
+}
+
+// src/types/default-config.ts
+var DEFAULT_TOOLS_CONFIG = Object.freeze({
+  defaultExecutionStrategy: "smart",
+  maxIterations: 100,
+  iterationTimeoutMs: 3e5,
+  maxToolTimeoutMs: 3e5,
+  sessionTimeoutMs: 18e5,
+  perIterationOutputCapBytes: 1e5,
+  descriptionMode: Object.freeze({}),
+  disabledTools: Object.freeze([]),
+  // Extension requires an explicit host/user policy. Without that boundary a
+  // nominal maxIterations cap can grow forever in autonomous sessions.
+  autoExtendLimit: false,
+  restrictToProjectRoot: true,
+  // Off by default: the board is a record of the work, not a permit for it.
+  // See ToolsConfig.kanbanGovernance for what turning it on costs and gates.
+  kanbanGovernance: false,
+  loopDetection: Object.freeze({
+    mode: "steer-then-cut",
+    steerThreshold: 3,
+    cutThreshold: 5,
+    windowSize: 12,
+    callRepeatThreshold: 4
+  })
+});
+var DEFAULT_CONTEXT_CONFIG = Object.freeze({
+  warnThreshold: 0.55,
+  softThreshold: 0.7,
+  hardThreshold: 0.85,
+  targetLoad: 0.65,
+  preserveK: 8,
+  eliseThreshold: 1200
+});
+var DEFAULT_AUTONOMY_CONFIG = Object.freeze({
+  autoProceedDelayMs: 45e3
+});
+var DEFAULT_CIRCUIT_BREAKER_CONFIG = Object.freeze({
+  enabled: false,
+  autoKillResetMs: 6e4
+});
+var DEFAULT_SESSION_LOGGING_CONFIG = Object.freeze({
+  auditLevel: "standard",
+  sampling: {
+    toolProgress: {
+      sampleRate: 8
+    }
+  }
+});
+var DEFAULT_SESSION_PRUNE_DAYS = 30;
+
+// src/types/design-kit.ts
+var DESIGN_STACKS = ["web", "react-native", "flutter", "swiftui", "compose"];
+function isDesignStack(v) {
+  return DESIGN_STACKS.includes(v);
+}
+var KNOWN_TOKEN_GROUPS = {
+  /** Corner radii. */
+  radius: ["radius-none", "radius-sm", "radius-md", "radius-lg", "radius-xl", "radius-full"],
+  /** Spacing scale (4/8px rhythm). */
+  space: ["space-1", "space-2", "space-3", "space-4", "space-6", "space-8", "space-12"],
+  /** Type sizes. */
+  text: ["text-xs", "text-sm", "text-base", "text-lg", "text-xl", "text-2xl", "text-3xl"],
+  /** Line-heights (unitless). */
+  leading: ["leading-tight", "leading-normal", "leading-relaxed"],
+  /** Font weights (unitless). */
+  weight: ["weight-normal", "weight-medium", "weight-semibold", "weight-bold"],
+  /** Letter-spacing. */
+  tracking: ["tracking-tight", "tracking-normal", "tracking-wide"],
+  /** Elevation / shadow ramp. */
+  shadow: ["shadow-1", "shadow-2", "shadow-3", "shadow-4"],
+  /** Border widths. */
+  border: ["border-hairline", "border-thin", "border-thick"],
+  /** Motion durations. */
+  duration: ["duration-fast", "duration-base", "duration-slow"],
+  /** Motion easings. */
+  ease: ["ease-standard", "ease-emphasized"],
+  /** Font families. */
+  font: ["font-sans", "font-mono", "font-display"]
+};
+var KNOWN_TOKEN_NAMES = Object.values(KNOWN_TOKEN_GROUPS).flat();
+
+// src/utils/error.ts
+function toErrorMessage(err) {
+  return err instanceof Error ? err.message : String(err);
+}
+
+// src/types/errors.ts
+var ERROR_CODES = {
+  // Provider
+  PROVIDER_RATE_LIMITED: "PROVIDER_RATE_LIMITED",
+  PROVIDER_AUTH_FAILED: "PROVIDER_AUTH_FAILED",
+  PROVIDER_OVERLOADED: "PROVIDER_OVERLOADED",
+  PROVIDER_INVALID_REQUEST: "PROVIDER_INVALID_REQUEST",
+  PROVIDER_SERVER_ERROR: "PROVIDER_SERVER_ERROR",
+  PROVIDER_NETWORK_ERROR: "PROVIDER_NETWORK_ERROR",
+  PROVIDER_CONTEXT_OVERFLOW: "PROVIDER_CONTEXT_OVERFLOW",
+  // Tool
+  TOOL_NOT_FOUND: "TOOL_NOT_FOUND",
+  TOOL_PERMISSION_DENIED: "TOOL_PERMISSION_DENIED",
+  TOOL_EXECUTION_FAILED: "TOOL_EXECUTION_FAILED",
+  TOOL_TIMEOUT: "TOOL_TIMEOUT",
+  TOOL_INPUT_INVALID: "TOOL_INPUT_INVALID",
+  // Config
+  CONFIG_INVALID: "CONFIG_INVALID",
+  CONFIG_NOT_FOUND: "CONFIG_NOT_FOUND",
+  CONFIG_PARSE_FAILED: "CONFIG_PARSE_FAILED",
+  CONFIG_MIGRATION_NEEDED: "CONFIG_MIGRATION_NEEDED",
+  // Plugin
+  PLUGIN_LOAD_FAILED: "PLUGIN_LOAD_FAILED",
+  PLUGIN_API_MISMATCH: "PLUGIN_API_MISMATCH",
+  PLUGIN_MISSING_DEPENDENCY: "PLUGIN_MISSING_DEPENDENCY",
+  // Agent
+  AGENT_ITERATION_LIMIT: "AGENT_ITERATION_LIMIT",
+  AGENT_CONTEXT_OVERFLOW: "AGENT_CONTEXT_OVERFLOW",
+  AGENT_ABORTED: "AGENT_ABORTED",
+  AGENT_RUN_FAILED: "AGENT_RUN_FAILED",
+  // Session
+  SESSION_NOT_FOUND: "SESSION_NOT_FOUND",
+  SESSION_CORRUPTED: "SESSION_CORRUPTED",
+  SESSION_WRITE_FAILED: "SESSION_WRITE_FAILED",
+  // Container / Registry
+  CONTAINER_TOKEN_ALREADY_BOUND: "CONTAINER_TOKEN_ALREADY_BOUND",
+  CONTAINER_TOKEN_NOT_BOUND: "CONTAINER_TOKEN_NOT_BOUND",
+  CONTAINER_CIRCULAR_DEPENDENCY: "CONTAINER_CIRCULAR_DEPENDENCY",
+  REGISTRY_DUPLICATE: "REGISTRY_DUPLICATE",
+  REGISTRY_NOT_FOUND: "REGISTRY_NOT_FOUND",
+  REGISTRY_INVALID: "REGISTRY_INVALID",
+  // File system
+  FS_READ_FAILED: "FS_READ_FAILED",
+  FS_WRITE_FAILED: "FS_WRITE_FAILED",
+  FS_MKDIR_FAILED: "FS_MKDIR_FAILED",
+  FS_DELETE_FAILED: "FS_DELETE_FAILED",
+  FS_ATOMIC_WRITE_FAILED: "FS_ATOMIC_WRITE_FAILED",
+  // SDD (Spec-Driven Development)
+  SDD_VALIDATION_FAILED: "SDD_VALIDATION_FAILED",
+  SDD_PARSE_FAILED: "SDD_PARSE_FAILED",
+  SDD_INVALID_STATE: "SDD_INVALID_STATE",
+  SDD_NOT_READY: "SDD_NOT_READY",
+  // General
+  VALIDATION_ERROR: "VALIDATION_ERROR",
+  PARSE_FAILED: "PARSE_FAILED",
+  UNKNOWN: "UNKNOWN"
+};
+var WrongStackError = class extends Error {
+  code;
+  subsystem;
+  severity;
+  recoverable;
+  context;
+  constructor(opts) {
+    super(opts.message, { cause: opts.cause });
+    this.name = "WrongStackError";
+    this.code = opts.code;
+    this.subsystem = opts.subsystem;
+    this.severity = opts.severity ?? "error";
+    this.recoverable = opts.recoverable ?? false;
+    this.context = opts.context;
+  }
+  /**
+   * Render a one-line user-facing description.
+   * Subclasses should override for domain-specific formatting.
+   */
+  describe() {
+    const ctx = this.context ? ` ${formatContext(this.context)}` : "";
+    return `${this.code}: ${this.message}${ctx}`;
+  }
+};
+function formatContext(ctx) {
+  const parts = Object.entries(ctx).filter(([, v]) => v !== void 0).slice(0, 3).map(([k, v]) => `${k}=${String(v)}`);
+  return parts.length > 0 ? `[${parts.join(" ")}]` : "";
+}
+var ToolError = class extends WrongStackError {
+  toolName;
+  constructor(opts) {
+    super({
+      message: opts.message,
+      code: opts.code,
+      subsystem: "tool",
+      recoverable: opts.recoverable,
+      context: { tool: opts.toolName, ...opts.context },
+      cause: opts.cause
+    });
+    this.name = "ToolError";
+    this.toolName = opts.toolName;
+  }
+};
+var ConfigError = class extends WrongStackError {
+  constructor(opts) {
+    super({
+      message: opts.message,
+      code: opts.code,
+      subsystem: "config",
+      severity: "fatal",
+      recoverable: false,
+      context: opts.context,
+      cause: opts.cause
+    });
+    this.name = "ConfigError";
+  }
+};
 var PluginError = class extends WrongStackError {
   pluginName;
   constructor(opts) {
@@ -317,499 +556,229 @@ function isSddError(err) {
   return err instanceof SddError;
 }
 
-// src/types/quota-regex.ts
-var QUOTA_EXHAUSTED_RE = /(?:insufficient|exhausted|depleted|exceeded|no|not enough)[-_\s]*(?:quota|credit|balance)|(?:quota|credit|balance)(?:\s+(?:has|have))?(?:\s+been)?[-_\s]*(?:exhausted|depleted|exceeded|insufficient)|billing[_\s-]*(?:hard[_\s-]*)?limit|payment required|spending limit|plan limit|usage[-_\s]*limit[-_\s]*(?:reached|exceeded)/i;
-
-// src/types/provider.ts
-function effectiveInputTokens(usage) {
-  return usage.input + (usage.cacheRead ?? 0) + (usage.cacheWrite ?? 0);
-}
-var CONTEXT_OVERFLOW_RE = /context.length|context.window|maximum context|max.*tokens?.*exceeded|(?:prompt|request|input|messages?).{0,12}too (?:large|long)|exceeds the context|\btokens\b.*exceed|too many tokens|reduce the length|resulted in \d+ tokens|context_length_exceeded/i;
-var CONTENT_FILTER_RE = /content.(filter|policy|moderation)|safety (system|filter)/i;
-var RATE_LIMIT_EXCEEDED_RE = /rate[-_\s]*limit[-_\s]*exceeded/i;
-function classifyProviderError(status, body, message) {
-  const type = body?.type;
-  const text = [message, body?.message, type, body?.raw].filter(Boolean).join("\n");
-  if (status === 0) return "network";
-  if (status === 408) return "timeout";
-  if (status === 599) return "stream_hang";
-  if (status === 402 || QUOTA_EXHAUSTED_RE.test(text)) return "quota_exhausted";
-  if (status === 429 && body?.message && body.type !== "rate_limit_exceeded" && RATE_LIMIT_EXCEEDED_RE.test(body.message)) {
-    return "quota_exhausted";
-  }
-  if (type === "rate_limit_error" || status === 429) return "rate_limit";
-  if (type === "overloaded_error" || status === 529) return "overloaded";
-  if (status >= 500) return "server";
-  if (type === "authentication_error" || type === "permission_error" || status === 401 || status === 403) {
-    return "auth";
-  }
-  if (type === "content_filter" || CONTENT_FILTER_RE.test(text)) return "content_filter";
-  if (status === 413 || status >= 400 && CONTEXT_OVERFLOW_RE.test(text)) {
-    return "context_overflow";
-  }
-  if (status >= 400) return "invalid_request";
-  return "unknown";
-}
-var MAX_RESET_HINT_MS = 7 * 24 * 60 * 60 * 1e3;
-function isRetryableKind(kind) {
-  return RETRYABLE_BY_KIND[kind];
-}
-var RETRYABLE_BY_KIND = {
-  rate_limit: true,
-  quota_exhausted: false,
-  overloaded: true,
-  server: true,
-  timeout: true,
-  network: true,
-  stream_hang: true,
-  auth: false,
-  context_overflow: false,
-  content_filter: false,
-  invalid_request: false,
-  unknown: false
+// src/types/memory.ts
+var MEMORY_TYPE_LABELS = {
+  fact: "Fact",
+  decision: "Decision",
+  convention: "Convention",
+  preference: "Preference",
+  reference: "Reference",
+  anti_pattern: "Anti-pattern"
 };
-function isFallbackWorthy(kind) {
-  return FALLBACK_WORTHY_BY_KIND[kind];
+function defineMemoryCapability(id) {
+  return Object.freeze({
+    id,
+    /** Identity function that makes the brand a real runtime value so
+     *  `defineMemoryCapability<A>('x')` and `defineMemoryCapability<B>('x')`
+     *  produce structurally distinct objects. Capability lookup is still
+     *  keyed by `id` only — the brand prevents accidental cross-type casts
+     *  at the type level. */
+    __memoryCapabilityType: (v) => v
+  });
 }
-var FALLBACK_WORTHY_BY_KIND = {
-  rate_limit: true,
-  quota_exhausted: true,
-  overloaded: true,
-  server: true,
-  timeout: true,
-  network: true,
-  stream_hang: true,
-  auth: false,
-  context_overflow: false,
-  content_filter: false,
-  invalid_request: false,
-  unknown: false
-};
-var ProviderError = class extends WrongStackError {
-  status;
-  retryable;
-  providerId;
-  /** Canonical failure classification — see {@link ProviderErrorKind}. */
-  kind;
-  body;
-  /**
-   * Duck-type guard: checks whether an unknown value *looks like* a
-   * ProviderError by probing for its structural properties.  Use this
-   * anywhere the constructor identity might cross a package boundary
-   * (e.g. `@wrongstack/providers` creates the error, but the runner in
-   * `@wrongstack/core` checks it). A plain `instanceof ProviderError`
-   * can fail when npm hoists duplicate copies of `@wrongstack/core`,
-   * each with its own class identity.
-   *
-   * The check tests for the four invariant properties defined in the
-   * constructor: `name === 'ProviderError'`, `status` (number),
-   * `retryable` (boolean), and `kind` (string). This tolerates both
-   * true `ProviderError` instances and cross-boundary copies.
-   */
-  static isProviderError(err) {
-    if (!err || typeof err !== "object") return false;
-    const e = err;
-    const name = e.name;
-    if (typeof name !== "string" || !name.endsWith("Error")) return false;
-    return typeof e.status === "number" && typeof e.retryable === "boolean" && typeof e.kind === "string" && typeof e.describe === "function";
-  }
-  constructor(message, status, retryable, providerId, opts = {}) {
-    const kind = opts.kind ?? classifyProviderError(status, opts.body, message);
-    super({
-      message,
-      code: kindToCode(kind),
-      subsystem: "provider",
-      severity: status >= 500 ? "error" : "warning",
-      recoverable: retryable,
-      context: { providerId, status },
-      cause: opts.cause
-    });
-    this.name = "ProviderError";
-    this.status = status;
-    this.retryable = retryable;
-    this.providerId = providerId;
-    this.kind = kind;
-    this.body = opts.body;
-  }
-  /**
-   * Render a one-line, user-facing description. Designed for the CLI/TUI
-   * status line and the agent's retry warning. Avoids dumping raw JSON
-   * (which is what users see today when a 529 lands and the log message
-   * includes the full `{"type":"error",...}` body).
-   *
-   * Examples:
-   *   "minimax-coding-plan overloaded (529): High traffic detected. Upgrade for highspeed model. [req 06534785201de9c0…]"
-   *   "openai rate limited (429): Retry after 12s"
-   *   "anthropic invalid request (400): messages.0.role must be one of 'user'|'assistant'"
-   *   "groq HTTP 500 (server error)"
-   */
-  describe() {
-    const kind = describeStatus(this.status, this.body?.type);
-    const head = `${this.providerId} ${kind}`;
-    const detail = this.body?.message?.trim();
-    const reqId = this.body?.requestId ? ` [req ${this.body.requestId.slice(0, 16)}${this.body.requestId.length > 16 ? "\u2026" : ""}]` : "";
-    if (detail && detail.length > 0) {
-      return `${head}: ${truncate(detail, 240)}${reqId}`;
+
+// src/types/mode-prompts.ts
+import { readFileSync, statSync } from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+function modePrompt(id) {
+  for (const dir of modePromptDirCandidates()) {
+    try {
+      return readFileSync(path.join(dir, `${id}.md`), "utf8").trimEnd();
+    } catch {
     }
-    return `${head}${reqId}`;
   }
-};
-function isContextOverflowShaped(err) {
-  if (!(err instanceof ProviderError) && !ProviderError.isProviderError(err)) return false;
-  const providerErr = err;
-  if (providerErr.kind === "context_overflow" || providerErr.status === 413) return true;
-  if (providerErr.status < 400) return false;
-  const text = [providerErr.message, providerErr.body?.message, providerErr.body?.type, providerErr.body?.raw].filter(Boolean).join("\n");
-  return CONTEXT_OVERFLOW_RE.test(text);
-}
-function describeStatus(status, type) {
-  if (status === 0) return "network error";
-  if (status === 599) return `stream hang (${status})`;
-  if (type === "overloaded_error" || status === 529) return `overloaded (${status})`;
-  if (type === "rate_limit_error" || status === 429) return `rate limited (${status})`;
-  if (type === "authentication_error" || status === 401) return `auth failed (${status})`;
-  if (type === "permission_error" || status === 403) return `forbidden (${status})`;
-  if (type === "not_found_error" || status === 404) return `not found (${status})`;
-  if (type === "content_filter") return `content filtered (${status})`;
-  if (type === "invalid_request_error" || status === 400) return `invalid request (${status})`;
-  if (status === 408) return `timeout (${status})`;
-  if (status >= 500 && status < 600) return `HTTP ${status} (server error)`;
-  if (type) return `${type} (${status})`;
-  return `HTTP ${status}`;
+  return "";
 }
-var StreamHangError = class extends ProviderError {
-  /** Name of the provider that hung, e.g. "zai", "anthropic". */
-  hungProviderId;
-  /** Model that was being called when the hang occurred. */
-  hungModel;
-  /** How long (ms) we waited for the next chunk before declaring a hang. */
-  hangTimeoutMs;
-  /** How many bytes were received before the hang. */
-  bytesReceived;
-  /** Elapsed time (ms) from the start of the stream until the hang. */
-  elapsedMs;
-  constructor(opts) {
-    super(
-      `Stream hang: ${opts.providerId}/${opts.model} \u2014 no data for ${opts.hangTimeoutMs}ms after ${opts.bytesReceived} bytes (${opts.elapsedMs}ms elapsed)`,
-      599,
-      true,
-      // always retryable
-      opts.providerId,
-      {
-        body: {
-          message: `Stream stalled after ${opts.elapsedMs}ms, ${opts.bytesReceived} bytes received`
-        },
-        cause: opts.cause
-      }
-    );
-    this.name = "StreamHangError";
-    this.hungProviderId = opts.providerId;
-    this.hungModel = opts.model;
-    this.hangTimeoutMs = opts.hangTimeoutMs;
-    this.bytesReceived = opts.bytesReceived;
-    this.elapsedMs = opts.elapsedMs;
-  }
-};
-var KIND_TO_CODE = {
-  network: ERROR_CODES.PROVIDER_NETWORK_ERROR,
-  timeout: ERROR_CODES.PROVIDER_NETWORK_ERROR,
-  rate_limit: ERROR_CODES.PROVIDER_RATE_LIMITED,
-  quota_exhausted: ERROR_CODES.PROVIDER_RATE_LIMITED,
-  auth: ERROR_CODES.PROVIDER_AUTH_FAILED,
-  overloaded: ERROR_CODES.PROVIDER_OVERLOADED,
-  context_overflow: ERROR_CODES.PROVIDER_CONTEXT_OVERFLOW,
-  server: ERROR_CODES.PROVIDER_SERVER_ERROR,
-  stream_hang: ERROR_CODES.PROVIDER_SERVER_ERROR,
-  content_filter: ERROR_CODES.PROVIDER_INVALID_REQUEST,
-  invalid_request: ERROR_CODES.PROVIDER_INVALID_REQUEST,
-  unknown: ERROR_CODES.PROVIDER_INVALID_REQUEST
-};
-function kindToCode(kind) {
-  return KIND_TO_CODE[kind];
+function modePromptDirCandidates() {
+  const here = path.dirname(fileURLToPath(import.meta.url));
+  const candidates = [
+    path.resolve(here, "../../instructions/modes"),
+    path.resolve(here, "../instructions/modes"),
+    path.resolve(here, "instructions/modes")
+  ];
+  return candidates.sort((a, b) => Number(!isDirectory(a)) - Number(!isDirectory(b)));
 }
-
-// src/types/config/fleet-chat.ts
-var FLEET_CHAT_VERBOSITY_VALUES = ["off", "full"];
-function resolveFleetChatVerbosity(autonomy) {
-  const explicit = autonomy?.fleetChatVerbosity;
-  if (explicit && FLEET_CHAT_VERBOSITY_VALUES.includes(explicit)) {
-    return explicit;
+function isDirectory(candidate) {
+  try {
+    return statSync(candidate).isDirectory();
+  } catch {
+    return false;
   }
-  return "off";
 }
 
-// src/types/config/runtime.ts
-function normalizeTokenSavingTier(val) {
-  if (val === void 0) return "off";
-  if (typeof val === "boolean") return val ? "medium" : "off";
-  if (val === "auto") return "medium";
-  const validTiers = /* @__PURE__ */ new Set([
-    "off",
-    "minimal",
-    "light",
-    "medium",
-    "aggressive"
-  ]);
-  return validTiers.has(val) ? val : "off";
-}
-function resolveTokenSavingTier(val, maxContext) {
-  if (val === "auto") {
-    if (typeof maxContext !== "number" || !Number.isFinite(maxContext) || maxContext <= 0) {
-      return "off";
-    }
-    if (maxContext < 32e3) return "medium";
-    if (maxContext < 128e3) return "light";
-    return "minimal";
-  }
-  return normalizeTokenSavingTier(val);
-}
-var DEFAULT_TUI_THINKING_WORD = "thinking";
-var MAX_TUI_THINKING_WORD_LENGTH = 16;
-function normalizeTuiThinkingWord(value) {
-  if (typeof value !== "string") return DEFAULT_TUI_THINKING_WORD;
-  const word = value.trim();
-  if (word.length === 0 || word.length > MAX_TUI_THINKING_WORD_LENGTH) {
-    return DEFAULT_TUI_THINKING_WORD;
-  }
-  if (!/^[\p{L}\p{N}_-]+$/u.test(word)) return DEFAULT_TUI_THINKING_WORD;
-  return word;
-}
-
-// src/types/config/ui.ts
-var THEME_PRESET_IDS = [
-  "catppuccin",
-  "tokyo-night",
-  "nord",
-  "cyberpunk",
-  "dracula",
-  "gruvbox-dark",
-  "solarized-dark",
-  "one-dark",
-  "monokai",
-  "rose-pine",
-  "kanagawa",
-  "ayu-dark",
-  "everforest",
-  "night-owl",
-  "synthwave",
-  "github-dark",
-  "material-ocean",
-  "nightfox",
-  "oxocarbon",
-  "catppuccin-macchiato",
-  "catppuccin-frappe",
-  "gruvbox-material",
-  "tokyo-night-storm",
-  "rose-pine-moon",
-  "zenburn",
-  "palenight",
-  "horizon",
-  "sonokai",
-  "edge-dark",
-  "moonfly",
-  "melange",
-  "poimandres",
-  "vitesse-dark",
-  "aura",
-  "dark-plus"
-];
-
-// src/types/session-markers.ts
-var SESSION_MARKER_EVENT_TYPES = /* @__PURE__ */ new Set([
-  "mode_changed",
-  "compaction",
-  "checkpoint",
-  "skill_activated",
-  "skill_deactivated",
-  "agent_spawned",
-  "agent_stopped",
-  "agent_error",
-  "error",
-  "provider_retry",
-  "provider_error",
-  "message_truncated"
-]);
-var CHAT_MARKER_SOURCES = new Set(
-  [...SESSION_MARKER_EVENT_TYPES].filter((type) => type !== "checkpoint")
-);
-function sessionEventToMarker(ev) {
-  switch (ev.type) {
-    case "compaction": {
-      const before = (ev.before / 1e3).toFixed(0);
-      const after = (ev.after / 1e3).toFixed(0);
-      const level = ev.level ? ` (${ev.level})` : "";
-      const reductions = ev.reductions && ev.reductions.length > 0 ? ` [${ev.reductions.map((r) => `${r.phase}: \u2212${r.saved}`).join(", ")}]` : "";
-      return {
-        ts: ev.ts,
-        source: ev.type,
-        level: "info",
-        text: `\u27F2 context compacted${level}: ${before}K \u2192 ${after}K tokens${reductions}`
-      };
-    }
-    case "error":
-      return {
-        ts: ev.ts,
-        source: ev.type,
-        level: "error",
-        text: ev.phase ? `[${ev.phase}] ${ev.message}` : ev.message
-      };
-    case "provider_retry": {
-      const secs = (ev.delayMs / 1e3).toFixed(ev.delayMs >= 1e3 ? 1 : 2);
-      return {
-        ts: ev.ts,
-        source: ev.type,
-        level: "warn",
-        text: ev.status ? `\u27F3 retry ${ev.attempt} (HTTP ${ev.status}) after ${secs}s \u2014 ${ev.description}` : `\u27F3 retry ${ev.attempt} after ${secs}s \u2014 ${ev.description}`
-      };
-    }
-    case "provider_error":
-      return {
-        ts: ev.ts,
-        source: ev.type,
-        level: "error",
-        text: ev.status ? `provider error (HTTP ${ev.status}, ${ev.retryable ? "retryable" : "fatal"}): ${ev.description}` : `provider error (${ev.retryable ? "retryable" : "fatal"}): ${ev.description}`
-      };
-    case "checkpoint":
-      return {
-        ts: ev.ts,
-        source: ev.type,
-        level: "info",
-        text: `\u2713 checkpoint #${ev.promptIndex}: "${ev.promptPreview.slice(0, 60)}"`
-      };
-    case "agent_spawned":
-      return {
-        ts: ev.ts,
-        source: ev.type,
-        level: "info",
-        text: `spawned as ${ev.role}`,
-        agentId: ev.agentId
-      };
-    case "agent_stopped":
-      return {
-        ts: ev.ts,
-        source: ev.type,
-        level: "info",
-        text: "stopped",
-        agentId: ev.agentId
-      };
-    case "agent_error":
-      return {
-        ts: ev.ts,
-        source: ev.type,
-        level: "error",
-        text: `error: ${ev.error.slice(0, 80)}`,
-        agentId: ev.agentId
-      };
-    case "mode_changed":
-      return {
-        ts: ev.ts,
-        source: ev.type,
-        level: "info",
-        text: `mode: ${ev.from} \u2192 ${ev.to}`
-      };
-    case "skill_activated":
-      return {
-        ts: ev.ts,
-        source: ev.type,
-        level: "info",
-        text: `skill activated: ${ev.skillName}`
-      };
-    case "skill_deactivated":
-      return {
-        ts: ev.ts,
-        source: ev.type,
-        level: "info",
-        text: `skill deactivated: ${ev.skillName}`
-      };
-    case "message_truncated":
-      return {
-        ts: ev.ts,
-        source: ev.type,
-        level: "warn",
-        text: ev.after < ev.before ? `message truncated: ${ev.before} \u2192 ${ev.after} tokens` : `message truncated at ${ev.after} tokens`
-      };
-    default:
-      return null;
-  }
-}
-function projectSessionMarkers(events, sources = SESSION_MARKER_EVENT_TYPES) {
-  const markers = [];
-  for (const ev of events) {
-    if (!sources.has(ev.type)) continue;
-    const marker = sessionEventToMarker(ev);
-    if (marker) markers.push(marker);
-  }
-  return markers;
-}
-
-// src/types/default-config.ts
-var DEFAULT_TOOLS_CONFIG = Object.freeze({
-  defaultExecutionStrategy: "smart",
-  maxIterations: 100,
-  iterationTimeoutMs: 3e5,
-  maxToolTimeoutMs: 3e5,
-  sessionTimeoutMs: 18e5,
-  perIterationOutputCapBytes: 1e5,
-  descriptionMode: Object.freeze({}),
-  disabledTools: Object.freeze([]),
-  autoExtendLimit: true,
-  restrictToProjectRoot: true,
-  // Off by default: the board is a record of the work, not a permit for it.
-  // See ToolsConfig.kanbanGovernance for what turning it on costs and gates.
-  kanbanGovernance: false,
-  loopDetection: Object.freeze({
-    mode: "steer-then-cut",
-    steerThreshold: 3,
-    cutThreshold: 5,
-    windowSize: 12,
-    callRepeatThreshold: 4
-  })
-});
-var DEFAULT_CONTEXT_CONFIG = Object.freeze({
-  warnThreshold: 0.55,
-  softThreshold: 0.7,
-  hardThreshold: 0.85,
-  targetLoad: 0.65,
-  preserveK: 8,
-  eliseThreshold: 1200
-});
-var DEFAULT_AUTONOMY_CONFIG = Object.freeze({
-  autoProceedDelayMs: 45e3
-});
-var DEFAULT_CIRCUIT_BREAKER_CONFIG = Object.freeze({
-  enabled: false,
-  autoKillResetMs: 6e4
-});
-var DEFAULT_SESSION_LOGGING_CONFIG = Object.freeze({
-  auditLevel: "standard",
-  sampling: {
-    toolProgress: {
-      sampleRate: 8
-    }
+// src/types/mode.ts
+var DEFAULT_MODES = [
+  {
+    id: "default",
+    name: "Default",
+    description: "Balanced general-purpose mode; use when no special token/coverage trade-off is needed",
+    prompt: "",
+    tags: ["general", "balanced"]
+  },
+  {
+    id: "brief",
+    name: "Brief",
+    description: "Ultra-compact responses for low-context, high-speed work",
+    prompt: modePrompt("brief"),
+    tags: ["lite", "fast", "concise", "token-saving"],
+    toolPreferences: ["read", "edit", "bash"],
+    suggestedSkills: []
+  },
+  {
+    id: "review-lite",
+    name: "Review Lite",
+    description: "Token-saving code review: changed files only, top correctness/security risks",
+    prompt: modePrompt("review-lite"),
+    tags: ["lite", "review", "quality", "token-saving"],
+    toolPreferences: ["git", "diff", "read", "grep"],
+    suggestedSkills: ["bug-hunter", "typescript-strict"]
+  },
+  {
+    id: "audit-lite",
+    name: "Audit Lite",
+    description: "Token-saving security triage for a small diff or named file",
+    prompt: modePrompt("audit-lite"),
+    tags: ["lite", "security", "audit", "token-saving"],
+    toolPreferences: ["grep", "read", "git"],
+    suggestedSkills: ["security-scanner"]
+  },
+  {
+    id: "plan-lite",
+    name: "Plan Lite",
+    description: "Token-saving planning: 3-6 actionable steps, minimal design debate",
+    prompt: modePrompt("plan-lite"),
+    tags: ["lite", "planning", "architecture", "token-saving"],
+    toolPreferences: ["tree", "glob", "read", "grep"],
+    suggestedSkills: ["refactor-planner"]
+  },
+  {
+    id: "debug-lite",
+    name: "Debug Lite",
+    description: "Token-saving bug triage: one hypothesis, nearest evidence, narrow check",
+    prompt: modePrompt("debug-lite"),
+    tags: ["lite", "debug", "triage", "token-saving"],
+    toolPreferences: ["read", "grep", "test", "logs"],
+    suggestedSkills: ["bug-hunter"]
+  },
+  {
+    id: "test-lite",
+    name: "Test Lite",
+    description: "Token-saving tests: one focused regression or narrow verification target",
+    prompt: modePrompt("test-lite"),
+    tags: ["lite", "testing", "qa", "token-saving"],
+    toolPreferences: ["test", "read", "grep"],
+    suggestedSkills: ["testing"]
+  },
+  {
+    id: "refactor-lite",
+    name: "Refactor Lite",
+    description: "Token-saving cleanup: small scoped behavior-preserving changes",
+    prompt: modePrompt("refactor-lite"),
+    tags: ["lite", "refactor", "token-saving"],
+    toolPreferences: ["read", "edit", "test"],
+    suggestedSkills: ["typescript-strict"]
+  },
+  {
+    id: "research-lite",
+    name: "Research Lite",
+    description: "Token-saving web research: one search, one authoritative fetch, short answer",
+    prompt: modePrompt("research-lite"),
+    tags: ["lite", "research", "web", "token-saving"],
+    toolPreferences: ["search", "fetch"],
+    suggestedSkills: ["research-web"]
+  },
+  {
+    id: "code-reviewer",
+    name: "Review Deep",
+    description: "Comprehensive code review across contracts, edge cases, lifecycle, errors, concurrency",
+    prompt: modePrompt("code-reviewer"),
+    tags: ["deep", "review", "quality", "security"],
+    toolPreferences: ["read", "grep", "git", "diff", "test"],
+    suggestedSkills: ["bug-hunter", "security-scanner", "typescript-strict", "testing"]
+  },
+  {
+    id: "code-auditor",
+    name: "Audit Deep",
+    description: "Comprehensive security audit with category coverage and exploitability notes",
+    prompt: modePrompt("code-auditor"),
+    tags: ["deep", "security", "audit", "compliance"],
+    toolPreferences: ["grep", "read", "audit", "bash"],
+    suggestedSkills: ["security-scanner", "bug-hunter", "audit-log"]
+  },
+  {
+    id: "architect",
+    name: "Architecture Deep",
+    description: "Comprehensive architecture and cross-module contract analysis",
+    prompt: modePrompt("architect"),
+    tags: ["deep", "architecture", "design", "scalability"],
+    toolPreferences: ["read", "glob", "tree", "diff"],
+    suggestedSkills: ["api-design", "refactor-planner", "node-modern", "docker-deploy"]
+  },
+  {
+    id: "debugger",
+    name: "Debug Deep",
+    description: "Comprehensive root-cause analysis with traces, logs, assumptions, and verification",
+    prompt: modePrompt("debugger"),
+    tags: ["deep", "debug", "investigation", "error-resolution"],
+    toolPreferences: ["read", "grep", "bash", "logs", "test"],
+    suggestedSkills: ["bug-hunter", "audit-log", "observability"]
+  },
+  {
+    id: "tester",
+    name: "Test Deep",
+    description: "Comprehensive QA mode for coverage, boundaries, isolation, and integration gaps",
+    prompt: modePrompt("tester"),
+    tags: ["deep", "testing", "qa", "quality"],
+    toolPreferences: ["read", "grep", "test", "bash"],
+    suggestedSkills: ["testing", "bug-hunter", "typescript-strict"]
+  },
+  {
+    id: "devops",
+    name: "DevOps Deep",
+    description: "Comprehensive infrastructure, deployment, observability, and operations review",
+    prompt: modePrompt("devops"),
+    tags: ["deep", "devops", "infrastructure", "operations"],
+    toolPreferences: ["read", "bash", "grep", "logs", "git"],
+    suggestedSkills: ["docker-deploy", "observability", "security-scanner"]
+  },
+  {
+    id: "refactorer",
+    name: "Refactor Deep",
+    description: "Comprehensive modernization/refactor mode with contracts and verification discipline",
+    prompt: modePrompt("refactorer"),
+    tags: ["deep", "refactor", "modernization", "improvement"],
+    toolPreferences: ["read", "edit", "test", "git", "grep"],
+    suggestedSkills: ["refactor-planner", "typescript-strict", "node-modern", "testing"]
+  },
+  {
+    id: "ui-design",
+    name: "UI Design Deep",
+    description: "Comprehensive design-first frontend/mobile UI work with kit, tokens, and accessibility",
+    prompt: modePrompt("ui-design"),
+    tags: ["deep", "ui", "frontend", "mobile", "design"],
+    toolPreferences: ["design", "write", "edit", "read", "scaffold"],
+    suggestedSkills: ["react-modern"]
+  },
+  {
+    id: "teach",
+    name: "Teach Deep",
+    description: "Mentor mode with explanations, mental models, trade-offs, and takeaways",
+    prompt: modePrompt("teach"),
+    tags: ["deep", "teaching", "mentor", "learning"],
+    toolPreferences: ["read", "edit", "explain"],
+    suggestedSkills: ["prompt-engineering", "skill-creator", "node-modern", "typescript-strict"]
+  },
+  {
+    id: "research-web",
+    name: "Research Deep",
+    description: "Comprehensive current-data research with cross-checking and reusable findings",
+    prompt: modePrompt("research-web"),
+    tags: ["deep", "research", "web", "current-data", "up-to-date"],
+    toolPreferences: ["search", "fetch", "context_manager"],
+    suggestedSkills: ["research-web", "tech-stack", "node-modern", "security-scanner", "react-modern"]
   }
-});
-var DEFAULT_SESSION_PRUNE_DAYS = 30;
-
-// src/types/memory.ts
-var MEMORY_TYPE_LABELS = {
-  fact: "Fact",
-  decision: "Decision",
-  convention: "Convention",
-  preference: "Preference",
-  reference: "Reference",
-  anti_pattern: "Anti-pattern"
-};
-function defineMemoryCapability(id) {
-  return Object.freeze({
-    id,
-    /** Identity function that makes the brand a real runtime value so
-     *  `defineMemoryCapability<A>('x')` and `defineMemoryCapability<B>('x')`
-     *  produce structurally distinct objects. Capability lookup is still
-     *  keyed by `id` only — the brand prevents accidental cross-type casts
-     *  at the type level. */
-    __memoryCapabilityType: (v) => v
-  });
-}
+];
 
 // src/types/prompt.ts
 var BUILTIN_PROMPT_CATEGORIES = [
@@ -931,336 +900,365 @@ function diffRegistry(local, manifest) {
   return diff;
 }
 
-// src/types/design-kit.ts
-var DESIGN_STACKS = ["web", "react-native", "flutter", "swiftui", "compose"];
-function isDesignStack(v) {
-  return DESIGN_STACKS.includes(v);
+// src/utils/string.ts
+function truncate(s, max) {
+  return s.length <= max ? s : `${s.slice(0, max - 1)}\u2026`;
 }
-var KNOWN_TOKEN_GROUPS = {
-  /** Corner radii. */
-  radius: ["radius-none", "radius-sm", "radius-md", "radius-lg", "radius-xl", "radius-full"],
-  /** Spacing scale (4/8px rhythm). */
-  space: ["space-1", "space-2", "space-3", "space-4", "space-6", "space-8", "space-12"],
-  /** Type sizes. */
-  text: ["text-xs", "text-sm", "text-base", "text-lg", "text-xl", "text-2xl", "text-3xl"],
-  /** Line-heights (unitless). */
-  leading: ["leading-tight", "leading-normal", "leading-relaxed"],
-  /** Font weights (unitless). */
-  weight: ["weight-normal", "weight-medium", "weight-semibold", "weight-bold"],
-  /** Letter-spacing. */
-  tracking: ["tracking-tight", "tracking-normal", "tracking-wide"],
-  /** Elevation / shadow ramp. */
-  shadow: ["shadow-1", "shadow-2", "shadow-3", "shadow-4"],
-  /** Border widths. */
-  border: ["border-hairline", "border-thin", "border-thick"],
-  /** Motion durations. */
-  duration: ["duration-fast", "duration-base", "duration-slow"],
-  /** Motion easings. */
-  ease: ["ease-standard", "ease-emphasized"],
-  /** Font families. */
-  font: ["font-sans", "font-mono", "font-display"]
-};
-var KNOWN_TOKEN_NAMES = Object.values(KNOWN_TOKEN_GROUPS).flat();
 
-// src/types/system-prompt.ts
-function flattenSystemPromptRegions(regions) {
-  return [...regions.core, ...regions.session, ...regions.volatile];
-}
+// src/types/quota-regex.ts
+var QUOTA_EXHAUSTED_RE = /(?:insufficient|exhausted|depleted|exceeded|no|not enough)[-_\s]*(?:quota|credit|balance)|(?:quota|credit|balance)(?:\s+(?:has|have))?(?:\s+been)?[-_\s]*(?:exhausted|depleted|exceeded|insufficient)|billing[_\s-]*(?:hard[_\s-]*)?limit|payment required|spending limit|plan limit|usage[-_\s]*limit[-_\s]*(?:reached|exceeded)/i;
 
-// src/types/mode-prompts.ts
-import { readFileSync, statSync } from "node:fs";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
-function modePrompt(id) {
-  for (const dir of modePromptDirCandidates()) {
-    try {
-      return readFileSync(path.join(dir, `${id}.md`), "utf8").trimEnd();
-    } catch {
+// src/types/provider.ts
+function effectiveInputTokens(usage) {
+  return usage.input + (usage.cacheRead ?? 0) + (usage.cacheWrite ?? 0);
+}
+var CONTEXT_OVERFLOW_RE = /context.length|context.window|maximum context|max.*tokens?.*exceeded|(?:prompt|request|input|messages?).{0,12}too (?:large|long)|exceeds the context|\btokens\b.*exceed|too many tokens|reduce the length|resulted in \d+ tokens|context_length_exceeded/i;
+var CONTENT_FILTER_RE = /content.(filter|policy|moderation)|safety (system|filter)/i;
+var RATE_LIMIT_EXCEEDED_RE = /rate[-_\s]*limit[-_\s]*exceeded/i;
+function classifyProviderError(status, body, message) {
+  const type = body?.type;
+  const text = [message, body?.message, type, body?.raw].filter(Boolean).join("\n");
+  if (status === 0) return "network";
+  if (status === 408) return "timeout";
+  if (status === 599) return "stream_hang";
+  if (status === 402 || QUOTA_EXHAUSTED_RE.test(text)) return "quota_exhausted";
+  if (status === 429 && body?.message && body.type !== "rate_limit_exceeded" && RATE_LIMIT_EXCEEDED_RE.test(body.message)) {
+    return "quota_exhausted";
+  }
+  if (type === "rate_limit_error" || status === 429) return "rate_limit";
+  if (type === "overloaded_error" || status === 529) return "overloaded";
+  if (status >= 500) return "server";
+  if (type === "authentication_error" || type === "permission_error" || status === 401 || status === 403) {
+    return "auth";
+  }
+  if (type === "content_filter" || CONTENT_FILTER_RE.test(text)) return "content_filter";
+  if (status === 413 || status >= 400 && CONTEXT_OVERFLOW_RE.test(text)) {
+    return "context_overflow";
+  }
+  if (status >= 400) return "invalid_request";
+  return "unknown";
+}
+var MAX_RESET_HINT_MS = 7 * 24 * 60 * 60 * 1e3;
+function isRetryableKind(kind) {
+  return RETRYABLE_BY_KIND[kind];
+}
+var RETRYABLE_BY_KIND = {
+  rate_limit: true,
+  quota_exhausted: false,
+  overloaded: true,
+  server: true,
+  timeout: true,
+  network: true,
+  stream_hang: true,
+  auth: false,
+  context_overflow: false,
+  content_filter: false,
+  invalid_request: false,
+  unknown: false
+};
+function isFallbackWorthy(kind) {
+  return FALLBACK_WORTHY_BY_KIND[kind];
+}
+var FALLBACK_WORTHY_BY_KIND = {
+  rate_limit: true,
+  quota_exhausted: true,
+  overloaded: true,
+  server: true,
+  timeout: true,
+  network: true,
+  stream_hang: true,
+  auth: false,
+  context_overflow: false,
+  content_filter: false,
+  invalid_request: false,
+  unknown: false
+};
+var ProviderError = class extends WrongStackError {
+  status;
+  retryable;
+  providerId;
+  /** Canonical failure classification — see {@link ProviderErrorKind}. */
+  kind;
+  body;
+  /**
+   * Duck-type guard: checks whether an unknown value *looks like* a
+   * ProviderError by probing for its structural properties.  Use this
+   * anywhere the constructor identity might cross a package boundary
+   * (e.g. `@wrongstack/providers` creates the error, but the runner in
+   * `@wrongstack/core` checks it). A plain `instanceof ProviderError`
+   * can fail when npm hoists duplicate copies of `@wrongstack/core`,
+   * each with its own class identity.
+   *
+   * The check tests for the four invariant properties defined in the
+   * constructor: `name === 'ProviderError'`, `status` (number),
+   * `retryable` (boolean), and `kind` (string). This tolerates both
+   * true `ProviderError` instances and cross-boundary copies.
+   */
+  static isProviderError(err) {
+    if (!err || typeof err !== "object") return false;
+    const e = err;
+    const name = e.name;
+    if (typeof name !== "string" || !name.endsWith("Error")) return false;
+    return typeof e.status === "number" && typeof e.retryable === "boolean" && typeof e.kind === "string" && typeof e.describe === "function";
+  }
+  constructor(message, status, retryable, providerId, opts = {}) {
+    const kind = opts.kind ?? classifyProviderError(status, opts.body, message);
+    super({
+      message,
+      code: kindToCode(kind),
+      subsystem: "provider",
+      severity: status >= 500 ? "error" : "warning",
+      recoverable: retryable,
+      context: { providerId, status },
+      cause: opts.cause
+    });
+    this.name = "ProviderError";
+    this.status = status;
+    this.retryable = retryable;
+    this.providerId = providerId;
+    this.kind = kind;
+    this.body = opts.body;
+  }
+  /**
+   * Render a one-line, user-facing description. Designed for the CLI/TUI
+   * status line and the agent's retry warning. Avoids dumping raw JSON
+   * (which is what users see today when a 529 lands and the log message
+   * includes the full `{"type":"error",...}` body).
+   *
+   * Examples:
+   *   "minimax-coding-plan overloaded (529): High traffic detected. Upgrade for highspeed model. [req 06534785201de9c0…]"
+   *   "openai rate limited (429): Retry after 12s"
+   *   "anthropic invalid request (400): messages.0.role must be one of 'user'|'assistant'"
+   *   "groq HTTP 500 (server error)"
+   */
+  describe() {
+    const kind = describeStatus(this.status, this.body?.type);
+    const head = `${this.providerId} ${kind}`;
+    const detail = this.body?.message?.trim();
+    const reqId = this.body?.requestId ? ` [req ${this.body.requestId.slice(0, 16)}${this.body.requestId.length > 16 ? "\u2026" : ""}]` : "";
+    if (detail && detail.length > 0) {
+      return `${head}: ${truncate(detail, 240)}${reqId}`;
     }
+    return `${head}${reqId}`;
   }
-  return "";
-}
-function modePromptDirCandidates() {
-  const here = path.dirname(fileURLToPath(import.meta.url));
-  const candidates = [
-    path.resolve(here, "../../instructions/modes"),
-    path.resolve(here, "../instructions/modes"),
-    path.resolve(here, "instructions/modes")
-  ];
-  return candidates.sort((a, b) => Number(!isDirectory(a)) - Number(!isDirectory(b)));
+};
+function isContextOverflowShaped(err) {
+  if (!(err instanceof ProviderError) && !ProviderError.isProviderError(err)) return false;
+  const providerErr = err;
+  if (providerErr.kind === "context_overflow" || providerErr.status === 413) return true;
+  if (providerErr.status < 400) return false;
+  const text = [providerErr.message, providerErr.body?.message, providerErr.body?.type, providerErr.body?.raw].filter(Boolean).join("\n");
+  return CONTEXT_OVERFLOW_RE.test(text);
 }
-function isDirectory(candidate) {
-  try {
-    return statSync(candidate).isDirectory();
-  } catch {
-    return false;
-  }
+function describeStatus(status, type) {
+  if (status === 0) return "network error";
+  if (status === 599) return `stream hang (${status})`;
+  if (type === "overloaded_error" || status === 529) return `overloaded (${status})`;
+  if (type === "rate_limit_error" || status === 429) return `rate limited (${status})`;
+  if (type === "authentication_error" || status === 401) return `auth failed (${status})`;
+  if (type === "permission_error" || status === 403) return `forbidden (${status})`;
+  if (type === "not_found_error" || status === 404) return `not found (${status})`;
+  if (type === "content_filter") return `content filtered (${status})`;
+  if (type === "invalid_request_error" || status === 400) return `invalid request (${status})`;
+  if (status === 408) return `timeout (${status})`;
+  if (status >= 500 && status < 600) return `HTTP ${status} (server error)`;
+  if (type) return `${type} (${status})`;
+  return `HTTP ${status}`;
 }
-
-// src/types/mode.ts
-var DEFAULT_MODES = [
-  {
-    id: "default",
-    name: "Default",
-    description: "Balanced general-purpose mode; use when no special token/coverage trade-off is needed",
-    prompt: "",
-    tags: ["general", "balanced"]
-  },
-  {
-    id: "brief",
-    name: "Brief",
-    description: "Ultra-compact responses for low-context, high-speed work",
-    prompt: modePrompt("brief"),
-    tags: ["lite", "fast", "concise", "token-saving"],
-    toolPreferences: ["read", "edit", "bash"],
-    suggestedSkills: []
-  },
-  {
-    id: "review-lite",
-    name: "Review Lite",
-    description: "Token-saving code review: changed files only, top correctness/security risks",
-    prompt: modePrompt("review-lite"),
-    tags: ["lite", "review", "quality", "token-saving"],
-    toolPreferences: ["git", "diff", "read", "grep"],
-    suggestedSkills: ["bug-hunter", "typescript-strict"]
-  },
-  {
-    id: "audit-lite",
-    name: "Audit Lite",
-    description: "Token-saving security triage for a small diff or named file",
-    prompt: modePrompt("audit-lite"),
-    tags: ["lite", "security", "audit", "token-saving"],
-    toolPreferences: ["grep", "read", "git"],
-    suggestedSkills: ["security-scanner"]
-  },
-  {
-    id: "plan-lite",
-    name: "Plan Lite",
-    description: "Token-saving planning: 3-6 actionable steps, minimal design debate",
-    prompt: modePrompt("plan-lite"),
-    tags: ["lite", "planning", "architecture", "token-saving"],
-    toolPreferences: ["tree", "glob", "read", "grep"],
-    suggestedSkills: ["refactor-planner"]
-  },
-  {
-    id: "debug-lite",
-    name: "Debug Lite",
-    description: "Token-saving bug triage: one hypothesis, nearest evidence, narrow check",
-    prompt: modePrompt("debug-lite"),
-    tags: ["lite", "debug", "triage", "token-saving"],
-    toolPreferences: ["read", "grep", "test", "logs"],
-    suggestedSkills: ["bug-hunter"]
-  },
-  {
-    id: "test-lite",
-    name: "Test Lite",
-    description: "Token-saving tests: one focused regression or narrow verification target",
-    prompt: modePrompt("test-lite"),
-    tags: ["lite", "testing", "qa", "token-saving"],
-    toolPreferences: ["test", "read", "grep"],
-    suggestedSkills: ["testing"]
-  },
-  {
-    id: "refactor-lite",
-    name: "Refactor Lite",
-    description: "Token-saving cleanup: small scoped behavior-preserving changes",
-    prompt: modePrompt("refactor-lite"),
-    tags: ["lite", "refactor", "token-saving"],
-    toolPreferences: ["read", "edit", "test"],
-    suggestedSkills: ["typescript-strict"]
-  },
-  {
-    id: "research-lite",
-    name: "Research Lite",
-    description: "Token-saving web research: one search, one authoritative fetch, short answer",
-    prompt: modePrompt("research-lite"),
-    tags: ["lite", "research", "web", "token-saving"],
-    toolPreferences: ["search", "fetch"],
-    suggestedSkills: ["research-web"]
-  },
-  {
-    id: "code-reviewer",
-    name: "Review Deep",
-    description: "Comprehensive code review across contracts, edge cases, lifecycle, errors, concurrency",
-    prompt: modePrompt("code-reviewer"),
-    tags: ["deep", "review", "quality", "security"],
-    toolPreferences: ["read", "grep", "git", "diff", "test"],
-    suggestedSkills: ["bug-hunter", "security-scanner", "typescript-strict", "testing"]
-  },
-  {
-    id: "code-auditor",
-    name: "Audit Deep",
-    description: "Comprehensive security audit with category coverage and exploitability notes",
-    prompt: modePrompt("code-auditor"),
-    tags: ["deep", "security", "audit", "compliance"],
-    toolPreferences: ["grep", "read", "audit", "bash"],
-    suggestedSkills: ["security-scanner", "bug-hunter", "audit-log"]
-  },
-  {
-    id: "architect",
-    name: "Architecture Deep",
-    description: "Comprehensive architecture and cross-module contract analysis",
-    prompt: modePrompt("architect"),
-    tags: ["deep", "architecture", "design", "scalability"],
-    toolPreferences: ["read", "glob", "tree", "diff"],
-    suggestedSkills: ["api-design", "refactor-planner", "node-modern", "docker-deploy"]
-  },
-  {
-    id: "debugger",
-    name: "Debug Deep",
-    description: "Comprehensive root-cause analysis with traces, logs, assumptions, and verification",
-    prompt: modePrompt("debugger"),
-    tags: ["deep", "debug", "investigation", "error-resolution"],
-    toolPreferences: ["read", "grep", "bash", "logs", "test"],
-    suggestedSkills: ["bug-hunter", "audit-log", "observability"]
-  },
-  {
-    id: "tester",
-    name: "Test Deep",
-    description: "Comprehensive QA mode for coverage, boundaries, isolation, and integration gaps",
-    prompt: modePrompt("tester"),
-    tags: ["deep", "testing", "qa", "quality"],
-    toolPreferences: ["read", "grep", "test", "bash"],
-    suggestedSkills: ["testing", "bug-hunter", "typescript-strict"]
-  },
-  {
-    id: "devops",
-    name: "DevOps Deep",
-    description: "Comprehensive infrastructure, deployment, observability, and operations review",
-    prompt: modePrompt("devops"),
-    tags: ["deep", "devops", "infrastructure", "operations"],
-    toolPreferences: ["read", "bash", "grep", "logs", "git"],
-    suggestedSkills: ["docker-deploy", "observability", "security-scanner"]
-  },
-  {
-    id: "refactorer",
-    name: "Refactor Deep",
-    description: "Comprehensive modernization/refactor mode with contracts and verification discipline",
-    prompt: modePrompt("refactorer"),
-    tags: ["deep", "refactor", "modernization", "improvement"],
-    toolPreferences: ["read", "edit", "test", "git", "grep"],
-    suggestedSkills: ["refactor-planner", "typescript-strict", "node-modern", "testing"]
-  },
-  {
-    id: "ui-design",
-    name: "UI Design Deep",
-    description: "Comprehensive design-first frontend/mobile UI work with kit, tokens, and accessibility",
-    prompt: modePrompt("ui-design"),
-    tags: ["deep", "ui", "frontend", "mobile", "design"],
-    toolPreferences: ["design", "write", "edit", "read", "scaffold"],
-    suggestedSkills: ["react-modern"]
-  },
-  {
-    id: "teach",
-    name: "Teach Deep",
-    description: "Mentor mode with explanations, mental models, trade-offs, and takeaways",
-    prompt: modePrompt("teach"),
-    tags: ["deep", "teaching", "mentor", "learning"],
-    toolPreferences: ["read", "edit", "explain"],
-    suggestedSkills: ["prompt-engineering", "skill-creator", "node-modern", "typescript-strict"]
-  },
-  {
-    id: "research-web",
-    name: "Research Deep",
-    description: "Comprehensive current-data research with cross-checking and reusable findings",
-    prompt: modePrompt("research-web"),
-    tags: ["deep", "research", "web", "current-data", "up-to-date"],
-    toolPreferences: ["search", "fetch", "context_manager"],
-    suggestedSkills: ["research-web", "tech-stack", "node-modern", "security-scanner", "react-modern"]
-  }
-];
-
-// src/utils/expect-defined.ts
-function expectDefined(value, label) {
-  if (value === null || value === void 0) {
-    const err = new Error(label ? `Expected ${label} to be defined` : "Expected value to be defined");
-    err.name = "ExpectDefinedError";
-    throw err;
+var StreamHangError = class extends ProviderError {
+  /** Name of the provider that hung, e.g. "zai", "anthropic". */
+  hungProviderId;
+  /** Model that was being called when the hang occurred. */
+  hungModel;
+  /** How long (ms) we waited for the next chunk before declaring a hang. */
+  hangTimeoutMs;
+  /** How many bytes were received before the hang. */
+  bytesReceived;
+  /** Elapsed time (ms) from the start of the stream until the hang. */
+  elapsedMs;
+  constructor(opts) {
+    super(
+      `Stream hang: ${opts.providerId}/${opts.model} \u2014 no data for ${opts.hangTimeoutMs}ms after ${opts.bytesReceived} bytes (${opts.elapsedMs}ms elapsed)`,
+      599,
+      true,
+      // always retryable
+      opts.providerId,
+      {
+        body: {
+          message: `Stream stalled after ${opts.elapsedMs}ms, ${opts.bytesReceived} bytes received`
+        },
+        cause: opts.cause
+      }
+    );
+    this.name = "StreamHangError";
+    this.hungProviderId = opts.providerId;
+    this.hungModel = opts.model;
+    this.hangTimeoutMs = opts.hangTimeoutMs;
+    this.bytesReceived = opts.bytesReceived;
+    this.elapsedMs = opts.elapsedMs;
   }
-  return value;
+};
+var KIND_TO_CODE = {
+  network: ERROR_CODES.PROVIDER_NETWORK_ERROR,
+  timeout: ERROR_CODES.PROVIDER_NETWORK_ERROR,
+  rate_limit: ERROR_CODES.PROVIDER_RATE_LIMITED,
+  quota_exhausted: ERROR_CODES.PROVIDER_RATE_LIMITED,
+  auth: ERROR_CODES.PROVIDER_AUTH_FAILED,
+  overloaded: ERROR_CODES.PROVIDER_OVERLOADED,
+  context_overflow: ERROR_CODES.PROVIDER_CONTEXT_OVERFLOW,
+  server: ERROR_CODES.PROVIDER_SERVER_ERROR,
+  stream_hang: ERROR_CODES.PROVIDER_SERVER_ERROR,
+  content_filter: ERROR_CODES.PROVIDER_INVALID_REQUEST,
+  invalid_request: ERROR_CODES.PROVIDER_INVALID_REQUEST,
+  unknown: ERROR_CODES.PROVIDER_INVALID_REQUEST
+};
+function kindToCode(kind) {
+  return KIND_TO_CODE[kind];
 }
 
-// src/types/context-window.ts
-var DEFAULT_CONTEXT_WINDOW_MODE_ID = "balanced";
-var DEPRECATED_CONTEXT_WINDOW_MODE_ALIASES = Object.freeze({
-  archival: "balanced"
-});
-var CONTEXT_WINDOW_MODES = Object.freeze([
-  {
-    id: "balanced",
-    name: "Balanced",
-    description: "Default rolling compaction: recent work stays verbatim, old tool output is trimmed.",
-    thresholds: { warn: 0.55, soft: 0.7, hard: 0.85 },
-    aggressiveOn: "soft",
-    preserveK: 8,
-    eliseThreshold: 1200,
-    targetLoad: 0.65
-  },
-  {
-    id: "frugal",
-    name: "Frugal",
-    description: "Token-saver mode: compacts early and keeps a tight verbatim tail.",
-    thresholds: { warn: 0.4, soft: 0.55, hard: 0.7 },
-    aggressiveOn: "warn",
-    preserveK: 4,
-    eliseThreshold: 500,
-    targetLoad: 0.45
-  },
-  {
-    id: "deep",
-    name: "Deep",
-    description: "Long-reasoning mode: delays compaction and keeps more recent turns intact.",
-    thresholds: { warn: 0.72, soft: 0.86, hard: 0.96 },
-    aggressiveOn: "hard",
-    preserveK: 18,
-    eliseThreshold: 5e3,
-    targetLoad: 0.82
-  }
+// src/types/session-markers.ts
+var SESSION_MARKER_EVENT_TYPES = /* @__PURE__ */ new Set([
+  "mode_changed",
+  "compaction",
+  "checkpoint",
+  "skill_activated",
+  "skill_deactivated",
+  "agent_spawned",
+  "agent_stopped",
+  "agent_error",
+  "error",
+  "provider_retry",
+  "provider_error",
+  "message_truncated"
 ]);
-function listContextWindowModes() {
-  return CONTEXT_WINDOW_MODES.map((m) => ({ ...m, thresholds: { ...m.thresholds } }));
-}
-function normalizeContextWindowModeId(id) {
-  if (!id) return null;
-  if (isContextWindowModeId(id)) return id;
-  return DEPRECATED_CONTEXT_WINDOW_MODE_ALIASES[id] ?? null;
-}
-function isDeprecatedContextWindowModeId(id) {
-  return Object.hasOwn(DEPRECATED_CONTEXT_WINDOW_MODE_ALIASES, id);
-}
-function isContextWindowModeSelectionId(id) {
-  return isContextWindowModeId(id) || isDeprecatedContextWindowModeId(id);
-}
-function getContextWindowMode(id) {
-  const normalized = normalizeContextWindowModeId(id);
-  if (!normalized) return null;
-  const mode = CONTEXT_WINDOW_MODES.find((m) => m.id === normalized);
-  return mode ? { ...mode, thresholds: { ...mode.thresholds } } : null;
-}
-function isContextWindowModeId(id) {
-  return CONTEXT_WINDOW_MODES.some((m) => m.id === id);
+var CHAT_MARKER_SOURCES = new Set(
+  [...SESSION_MARKER_EVENT_TYPES].filter((type) => type !== "checkpoint")
+);
+function sessionEventToMarker(ev) {
+  switch (ev.type) {
+    case "compaction": {
+      const before = (ev.before / 1e3).toFixed(0);
+      const after = (ev.after / 1e3).toFixed(0);
+      const level = ev.level ? ` (${ev.level})` : "";
+      const reductions = ev.reductions && ev.reductions.length > 0 ? ` [${ev.reductions.map((r) => `${r.phase}: \u2212${r.saved}`).join(", ")}]` : "";
+      return {
+        ts: ev.ts,
+        source: ev.type,
+        level: "info",
+        text: `\u27F2 context compacted${level}: ${before}K \u2192 ${after}K tokens${reductions}`
+      };
+    }
+    case "error":
+      return {
+        ts: ev.ts,
+        source: ev.type,
+        level: "error",
+        text: ev.phase ? `[${ev.phase}] ${ev.message}` : ev.message
+      };
+    case "provider_retry": {
+      const secs = (ev.delayMs / 1e3).toFixed(ev.delayMs >= 1e3 ? 1 : 2);
+      return {
+        ts: ev.ts,
+        source: ev.type,
+        level: "warn",
+        text: ev.status ? `\u27F3 retry ${ev.attempt} (HTTP ${ev.status}) after ${secs}s \u2014 ${ev.description}` : `\u27F3 retry ${ev.attempt} after ${secs}s \u2014 ${ev.description}`
+      };
+    }
+    case "provider_error":
+      return {
+        ts: ev.ts,
+        source: ev.type,
+        level: "error",
+        text: ev.status ? `provider error (HTTP ${ev.status}, ${ev.retryable ? "retryable" : "fatal"}): ${ev.description}` : `provider error (${ev.retryable ? "retryable" : "fatal"}): ${ev.description}`
+      };
+    case "checkpoint":
+      return {
+        ts: ev.ts,
+        source: ev.type,
+        level: "info",
+        text: `\u2713 checkpoint #${ev.promptIndex}: "${ev.promptPreview.slice(0, 60)}"`
+      };
+    case "agent_spawned":
+      return {
+        ts: ev.ts,
+        source: ev.type,
+        level: "info",
+        text: `spawned as ${ev.role}`,
+        agentId: ev.agentId
+      };
+    case "agent_stopped":
+      return {
+        ts: ev.ts,
+        source: ev.type,
+        level: "info",
+        text: "stopped",
+        agentId: ev.agentId
+      };
+    case "agent_error":
+      return {
+        ts: ev.ts,
+        source: ev.type,
+        level: "error",
+        text: `error: ${ev.error.slice(0, 80)}`,
+        agentId: ev.agentId
+      };
+    case "mode_changed":
+      return {
+        ts: ev.ts,
+        source: ev.type,
+        level: "info",
+        text: `mode: ${ev.from} \u2192 ${ev.to}`
+      };
+    case "skill_activated":
+      return {
+        ts: ev.ts,
+        source: ev.type,
+        level: "info",
+        text: `skill activated: ${ev.skillName}`
+      };
+    case "skill_deactivated":
+      return {
+        ts: ev.ts,
+        source: ev.type,
+        level: "info",
+        text: `skill deactivated: ${ev.skillName}`
+      };
+    case "message_truncated":
+      return {
+        ts: ev.ts,
+        source: ev.type,
+        level: "warn",
+        text: ev.after < ev.before ? `message truncated: ${ev.before} \u2192 ${ev.after} tokens` : `message truncated at ${ev.after} tokens`
+      };
+    default:
+      return null;
+  }
 }
-function resolveContextWindowPolicy(config = {}, overrideMode) {
-  const requested = overrideMode ?? config.mode ?? DEFAULT_CONTEXT_WINDOW_MODE_ID;
-  const mode = getContextWindowMode(requested) ?? expectDefined(getContextWindowMode(DEFAULT_CONTEXT_WINDOW_MODE_ID));
-  return {
-    ...mode,
-    thresholds: {
-      warn: config.warnThreshold ?? mode.thresholds.warn,
-      soft: config.softThreshold ?? mode.thresholds.soft,
-      hard: config.hardThreshold ?? mode.thresholds.hard
-    },
-    preserveK: config.preserveK ?? mode.preserveK,
-    eliseThreshold: config.eliseThreshold ?? mode.eliseThreshold,
-    targetLoad: config.targetLoad ?? mode.targetLoad
-  };
+function projectSessionMarkers(events, sources = SESSION_MARKER_EVENT_TYPES) {
+  const markers = [];
+  for (const ev of events) {
+    if (!sources.has(ev.type)) continue;
+    const marker = sessionEventToMarker(ev);
+    if (marker) markers.push(marker);
+  }
+  return markers;
 }
-function formatContextWindowModeList(activeId) {
-  const active = normalizeContextWindowModeId(activeId);
-  return CONTEXT_WINDOW_MODES.map((m) => {
-    const marker = m.id === active ? "*" : " ";
-    return `${marker} ${m.id.padEnd(9)} ${m.name} - ${m.description}`;
-  }).join("\n");
+var SYSTEM_INJECTION_PREFIXES = [
+  "[MAILBOX]",
+  "[MAILBOX BTW]",
+  "[BY THE WAY \u2014",
+  "[QUEUED MESSAGES \u2014",
+  "[FLEET PULSE]",
+  "[loop-detector]",
+  "[SESSION RESUME FILE VALIDATION]",
+  "[SESSION RESUME INTERRUPTED WORK]"
+];
+function isSystemInjectedMessage(text) {
+  const trimmed = text.trimStart();
+  for (const prefix of SYSTEM_INJECTION_PREFIXES) {
+    if (trimmed.startsWith(prefix)) return true;
+  }
+  return false;
 }
 
 // src/types/spec.ts
@@ -1288,6 +1286,27 @@ var DEFAULT_SPEC_TEMPLATE = {
     }
   ]
 };
+
+// src/types/system-prompt.ts
+function flattenSystemPromptRegions(regions) {
+  return [...regions.core, ...regions.session, ...regions.volatile];
+}
+
+// src/types/tool.ts
+var ToolErrorCategory = /* @__PURE__ */ ((ToolErrorCategory2) => {
+  ToolErrorCategory2["TRANSIENT"] = "transient";
+  ToolErrorCategory2["NOT_FOUND"] = "not_found";
+  ToolErrorCategory2["PERMISSION"] = "permission";
+  ToolErrorCategory2["VALIDATION"] = "validation";
+  ToolErrorCategory2["FATAL"] = "fatal";
+  return ToolErrorCategory2;
+})(ToolErrorCategory || {});
+
+// src/types/tool-executor.ts
+var GOVERNED_TOOL_EXECUTOR_META_KEY = "toolExecutor.executeGoverned";
+
+// src/types/tool-markers.ts
+var MALFORMED_ARG_MARKERS = ["__raw", "__raw_arguments", "_raw"];
 export {
   AgentError,
   BUILTIN_PROMPT_CATEGORIES,
@@ -1321,6 +1340,7 @@ export {
   PluginError,
   ProviderError,
   SESSION_MARKER_EVENT_TYPES,
+  SYSTEM_INJECTION_PREFIXES,
   SddError,
   SessionError,
   StreamHangError,
@@ -1353,6 +1373,7 @@ export {
   isRetryableKind,
   isSddError,
   isSessionError,
+  isSystemInjectedMessage,
   isTextBlock,
   isToolError,
   isToolResultBlock,