@within-7/minto 0.2.0 → 0.3.3

package/dist/utils/CircuitBreaker.js

@@ -0,0 +1,242 @@
+class CircuitOpenError extends Error {
+  constructor(remainingCooldown, serverName) {
+    const message = serverName ? `Circuit breaker for "${serverName}" is open. Retry in ${Math.ceil(remainingCooldown / 1e3)}s` : `Circuit breaker is open. Retry in ${Math.ceil(remainingCooldown / 1e3)}s`;
+    super(message);
+    this.remainingCooldown = remainingCooldown;
+    this.name = "CircuitOpenError";
+  }
+}
+class CircuitBreaker {
+  state = "closed";
+  failureCount = 0;
+  successCount = 0;
+  lastFailureTime = null;
+  config;
+  listeners = /* @__PURE__ */ new Set();
+  name;
+  totalRequests = 0;
+  totalFailures = 0;
+  constructor(name = "default", config) {
+    this.name = name;
+    this.config = {
+      failureThreshold: config?.failureThreshold ?? 5,
+      successThreshold: config?.successThreshold ?? 2,
+      openTimeout: config?.openTimeout ?? 3e4,
+      halfOpenTimeout: config?.halfOpenTimeout ?? 3e4
+    };
+  }
+  /**
+   * Execute an operation through the circuit breaker
+   * @throws {CircuitOpenError} If circuit is open
+   * @throws {Error} If operation fails
+   */
+  async execute(operation) {
+    this.totalRequests++;
+    if (this.state === "open") {
+      const cooldownRemaining = this.getRemainingCooldown();
+      if (cooldownRemaining <= 0) {
+        this.transition("half-open");
+      } else {
+        const error = new CircuitOpenError(cooldownRemaining, this.name);
+        this.notifyListeners("failure", { error });
+        throw error;
+      }
+    }
+    try {
+      const result = await operation();
+      this.onSuccess();
+      return result;
+    } catch (error) {
+      this.onFailure(error instanceof Error ? error : new Error(String(error)));
+      throw error;
+    }
+  }
+  /**
+   * Execute with timeout protection
+   * @throws {CircuitOpenError} If circuit is open
+   * @throws {Error} If operation times out or fails
+   */
+  async executeWithTimeout(operation, timeoutMs) {
+    const timeout = timeoutMs ?? this.config.halfOpenTimeout;
+    if (!timeout) {
+      return this.execute(operation);
+    }
+    return Promise.race([
+      this.execute(operation),
+      new Promise(
+        (_, reject) => setTimeout(
+          () => reject(new Error(`Operation timeout after ${timeout}ms`)),
+          timeout
+        )
+      )
+    ]);
+  }
+  /**
+   * Get current circuit state
+   */
+  getState() {
+    return this.state;
+  }
+  /**
+   * Get detailed statistics
+   */
+  getStats() {
+    return {
+      state: this.state,
+      failureCount: this.failureCount,
+      successCount: this.successCount,
+      lastFailureTime: this.lastFailureTime,
+      totalRequests: this.totalRequests,
+      totalFailures: this.totalFailures
+    };
+  }
+  /**
+   * Get remaining cooldown time in milliseconds
+   */
+  getRemainingCooldown() {
+    if (!this.lastFailureTime) {
+      return 0;
+    }
+    return Math.max(
+      0,
+      this.config.openTimeout - (Date.now() - this.lastFailureTime)
+    );
+  }
+  /**
+   * Register a listener for state changes and events
+   */
+  on(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+  /**
+   * Reset the circuit breaker to CLOSED state
+   */
+  reset() {
+    const previousState = this.state;
+    this.state = "closed";
+    this.failureCount = 0;
+    this.successCount = 0;
+    this.lastFailureTime = null;
+    this.totalRequests = 0;
+    this.totalFailures = 0;
+    this.notifyListeners("state-change", {
+      state: this.state,
+      previousState
+    });
+  }
+  /**
+   * Manually open the circuit (for testing or explicit fault injection)
+   */
+  forceOpen() {
+    this.transition("open");
+  }
+  /**
+   * Manually close the circuit (for recovery testing)
+   */
+  forceClosed() {
+    this.transition("closed");
+  }
+  /**
+   * Manually transition to half-open state (for testing)
+   */
+  forceHalfOpen() {
+    this.transition("half-open");
+  }
+  // Private methods
+  transition(newState) {
+    if (newState === this.state) {
+      return;
+    }
+    const previousState = this.state;
+    this.state = newState;
+    if (newState === "closed") {
+      this.failureCount = 0;
+      this.successCount = 0;
+    } else if (newState === "half-open") {
+      this.successCount = 0;
+      this.failureCount = 0;
+    }
+    this.notifyListeners("state-change", {
+      state: newState,
+      previousState
+    });
+  }
+  onSuccess() {
+    if (this.state === "half-open") {
+      this.successCount++;
+      if (this.successCount >= this.config.successThreshold) {
+        this.transition("closed");
+      }
+    } else if (this.state === "closed") {
+      this.failureCount = 0;
+    }
+    this.notifyListeners("success", {});
+  }
+  onFailure(error) {
+    this.failureCount++;
+    this.totalFailures++;
+    this.lastFailureTime = Date.now();
+    if (this.state === "closed") {
+      if (this.failureCount >= this.config.failureThreshold) {
+        this.transition("open");
+      }
+    } else if (this.state === "half-open") {
+      this.transition("open");
+    }
+    this.notifyListeners("failure", { error });
+  }
+  notifyListeners(event, details) {
+    for (const listener of this.listeners) {
+      try {
+        listener(event, details);
+      } catch {
+      }
+    }
+  }
+}
+class CircuitBreakerRegistry {
+  breakers = /* @__PURE__ */ new Map();
+  defaultConfig;
+  constructor(defaultConfig) {
+    this.defaultConfig = defaultConfig;
+  }
+  /**
+   * Get or create a circuit breaker by name
+   */
+  getOrCreate(name, config) {
+    if (!this.breakers.has(name)) {
+      const mergedConfig = { ...this.defaultConfig, ...config };
+      this.breakers.set(name, new CircuitBreaker(name, mergedConfig));
+    }
+    return this.breakers.get(name);
+  }
+  /**
+   * Get all registered circuit breakers
+   */
+  getAll() {
+    return new Map(this.breakers);
+  }
+  /**
+   * Reset all circuit breakers
+   */
+  resetAll() {
+    for (const breaker of this.breakers.values()) {
+      breaker.reset();
+    }
+  }
+  /**
+   * Clear all circuit breakers
+   */
+  clear() {
+    this.breakers.clear();
+  }
+}
+export {
+  CircuitBreaker,
+  CircuitBreakerRegistry,
+  CircuitOpenError
+};
+//# sourceMappingURL=CircuitBreaker.js.map

package/dist/utils/CircuitBreaker.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/CircuitBreaker.ts"],
+  "sourcesContent": ["/**\n * Circuit Breaker pattern implementation for handling failing services gracefully\n *\n * States:\n * - CLOSED: Service is healthy, requests pass through normally\n * - OPEN: Service is unhealthy, requests fail immediately\n * - HALF_OPEN: Testing if service has recovered, limited requests allowed\n *\n * Transitions:\n * - CLOSED \u2192 OPEN: When failure count exceeds threshold\n * - OPEN \u2192 HALF_OPEN: After cooldown timeout\n * - HALF_OPEN \u2192 CLOSED: When success count exceeds threshold\n * - HALF_OPEN \u2192 OPEN: When a request fails\n */\n\nexport interface CircuitBreakerConfig {\n  /** Number of failures that trigger opening the circuit (default: 5) */\n  failureThreshold: number\n  /** Number of successful requests needed to close circuit from HALF_OPEN (default: 2) */\n  successThreshold: number\n  /** Time in ms before transitioning from OPEN to HALF_OPEN (default: 30000) */\n  openTimeout: number\n  /** Optional timeout in ms for operations (default: none) */\n  halfOpenTimeout?: number\n}\n\nexport class CircuitOpenError extends Error {\n  constructor(\n    public readonly remainingCooldown: number,\n    serverName?: string,\n  ) {\n    const message = serverName\n      ? `Circuit breaker for \"${serverName}\" is open. Retry in ${Math.ceil(remainingCooldown / 1000)}s`\n      : `Circuit breaker is open. Retry in ${Math.ceil(remainingCooldown / 1000)}s`\n    super(message)\n    this.name = 'CircuitOpenError'\n  }\n}\n\nexport type CircuitBreakerState = 'closed' | 'open' | 'half-open'\n\nexport interface CircuitBreakerStats {\n  state: CircuitBreakerState\n  failureCount: number\n  successCount: number\n  lastFailureTime: number | null\n  totalRequests: number\n  totalFailures: number\n}\n\nexport type CircuitBreakerListener = (\n  event: 'state-change' | 'failure' | 'success',\n  details: {\n    state?: CircuitBreakerState\n    previousState?: CircuitBreakerState\n    error?: Error\n  },\n) => void\n\n/**\n * Circuit Breaker implementation for fault tolerance\n *\n * Prevents cascading failures by failing fast when a service is unhealthy,\n * while automatically attempting recovery when the service potentially recovers.\n */\nexport class CircuitBreaker<T = unknown> {\n  private state: CircuitBreakerState = 'closed'\n  private failureCount: number = 0\n  private successCount: number = 0\n  private lastFailureTime: number | null = null\n  private readonly config: Required<CircuitBreakerConfig>\n  private readonly listeners: Set<CircuitBreakerListener> = new Set()\n  private readonly name: string\n  private totalRequests: number = 0\n  private totalFailures: number = 0\n\n  constructor(\n    name: string = 'default',\n    config?: Partial<CircuitBreakerConfig>,\n  ) {\n    this.name = name\n    this.config = {\n      failureThreshold: config?.failureThreshold ?? 5,\n      successThreshold: config?.successThreshold ?? 2,\n      openTimeout: config?.openTimeout ?? 30000,\n      halfOpenTimeout: config?.halfOpenTimeout ?? 30000,\n    }\n  }\n\n  /**\n   * Execute an operation through the circuit breaker\n   * @throws {CircuitOpenError} If circuit is open\n   * @throws {Error} If operation fails\n   */\n  async execute<R>(operation: () => Promise<R>): Promise<R> {\n    this.totalRequests++\n\n    // Check if we need to transition from OPEN to HALF_OPEN\n    if (this.state === 'open') {\n      const cooldownRemaining = this.getRemainingCooldown()\n      if (cooldownRemaining <= 0) {\n        this.transition('half-open')\n      } else {\n        const error = new CircuitOpenError(cooldownRemaining, this.name)\n        this.notifyListeners('failure', { error })\n        throw error\n      }\n    }\n\n    // Execute the operation\n    try {\n      const result = await operation()\n      this.onSuccess()\n      return result\n    } catch (error) {\n      this.onFailure(error instanceof Error ? error : new Error(String(error)))\n      throw error\n    }\n  }\n\n  /**\n   * Execute with timeout protection\n   * @throws {CircuitOpenError} If circuit is open\n   * @throws {Error} If operation times out or fails\n   */\n  async executeWithTimeout<R>(\n    operation: () => Promise<R>,\n    timeoutMs?: number,\n  ): Promise<R> {\n    const timeout = timeoutMs ?? this.config.halfOpenTimeout\n    if (!timeout) {\n      return this.execute(operation)\n    }\n\n    return Promise.race([\n      this.execute(operation),\n      new Promise<R>((_, reject) =>\n        setTimeout(\n          () => reject(new Error(`Operation timeout after ${timeout}ms`)),\n          timeout,\n        ),\n      ),\n    ])\n  }\n\n  /**\n   * Get current circuit state\n   */\n  getState(): CircuitBreakerState {\n    return this.state\n  }\n\n  /**\n   * Get detailed statistics\n   */\n  getStats(): CircuitBreakerStats {\n    return {\n      state: this.state,\n      failureCount: this.failureCount,\n      successCount: this.successCount,\n      lastFailureTime: this.lastFailureTime,\n      totalRequests: this.totalRequests,\n      totalFailures: this.totalFailures,\n    }\n  }\n\n  /**\n   * Get remaining cooldown time in milliseconds\n   */\n  getRemainingCooldown(): number {\n    if (!this.lastFailureTime) {\n      return 0\n    }\n    return Math.max(\n      0,\n      this.config.openTimeout - (Date.now() - this.lastFailureTime),\n    )\n  }\n\n  /**\n   * Register a listener for state changes and events\n   */\n  on(listener: CircuitBreakerListener): () => void {\n    this.listeners.add(listener)\n    return () => {\n      this.listeners.delete(listener)\n    }\n  }\n\n  /**\n   * Reset the circuit breaker to CLOSED state\n   */\n  reset(): void {\n    const previousState = this.state\n    this.state = 'closed'\n    this.failureCount = 0\n    this.successCount = 0\n    this.lastFailureTime = null\n    this.totalRequests = 0\n    this.totalFailures = 0\n\n    this.notifyListeners('state-change', {\n      state: this.state,\n      previousState,\n    })\n  }\n\n  /**\n   * Manually open the circuit (for testing or explicit fault injection)\n   */\n  forceOpen(): void {\n    this.transition('open')\n  }\n\n  /**\n   * Manually close the circuit (for recovery testing)\n   */\n  forceClosed(): void {\n    this.transition('closed')\n  }\n\n  /**\n   * Manually transition to half-open state (for testing)\n   */\n  forceHalfOpen(): void {\n    this.transition('half-open')\n  }\n\n  // Private methods\n\n  private transition(newState: CircuitBreakerState): void {\n    if (newState === this.state) {\n      return\n    }\n\n    const previousState = this.state\n    this.state = newState\n\n    // Reset counters on state transition\n    if (newState === 'closed') {\n      this.failureCount = 0\n      this.successCount = 0\n    } else if (newState === 'half-open') {\n      this.successCount = 0\n      this.failureCount = 0\n    }\n\n    this.notifyListeners('state-change', {\n      state: newState,\n      previousState,\n    })\n  }\n\n  private onSuccess(): void {\n    if (this.state === 'half-open') {\n      this.successCount++\n      if (this.successCount >= this.config.successThreshold) {\n        this.transition('closed')\n      }\n    } else if (this.state === 'closed') {\n      this.failureCount = 0\n    }\n\n    this.notifyListeners('success', {})\n  }\n\n  private onFailure(error: Error): void {\n    this.failureCount++\n    this.totalFailures++\n    this.lastFailureTime = Date.now()\n\n    if (this.state === 'closed') {\n      if (this.failureCount >= this.config.failureThreshold) {\n        this.transition('open')\n      }\n    } else if (this.state === 'half-open') {\n      // Any failure in half-open state goes back to open\n      this.transition('open')\n    }\n\n    this.notifyListeners('failure', { error })\n  }\n\n  private notifyListeners(\n    event: 'state-change' | 'failure' | 'success',\n    details: {\n      state?: CircuitBreakerState\n      previousState?: CircuitBreakerState\n      error?: Error\n    },\n  ): void {\n    for (const listener of this.listeners) {\n      try {\n        listener(event, details)\n      } catch {\n        // Ignore listener errors to prevent them from affecting the circuit\n      }\n    }\n  }\n}\n\n/**\n * Create a simple factory for managing multiple circuit breakers\n */\nexport class CircuitBreakerRegistry {\n  private readonly breakers = new Map<string, CircuitBreaker>()\n  private readonly defaultConfig?: Partial<CircuitBreakerConfig>\n\n  constructor(defaultConfig?: Partial<CircuitBreakerConfig>) {\n    this.defaultConfig = defaultConfig\n  }\n\n  /**\n   * Get or create a circuit breaker by name\n   */\n  getOrCreate(\n    name: string,\n    config?: Partial<CircuitBreakerConfig>,\n  ): CircuitBreaker {\n    if (!this.breakers.has(name)) {\n      const mergedConfig = { ...this.defaultConfig, ...config }\n      this.breakers.set(name, new CircuitBreaker(name, mergedConfig))\n    }\n    return this.breakers.get(name)!\n  }\n\n  /**\n   * Get all registered circuit breakers\n   */\n  getAll(): Map<string, CircuitBreaker> {\n    return new Map(this.breakers)\n  }\n\n  /**\n   * Reset all circuit breakers\n   */\n  resetAll(): void {\n    for (const breaker of this.breakers.values()) {\n      breaker.reset()\n    }\n  }\n\n  /**\n   * Clear all circuit breakers\n   */\n  clear(): void {\n    this.breakers.clear()\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/utils/ask.js

@@ -10,6 +10,7 @@ import { createUserMessage } from "./messages.js";
 async function ask({
   commands,
   safeMode,
+  safetyMode = "yolo",
   hasPermissionsToUseTool,
   messageLogName,
   prompt,
@@ -36,6 +37,7 @@ async function ask({
         tools,
         verbose,
         safeMode,
+        safetyMode,
         forkNumber: 0,
         messageLogName: "unused",
         maxThinkingTokens: 0

package/dist/utils/ask.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/utils/ask.tsx"],
-  "sourcesContent": ["import { last } from 'lodash-es'\nimport { Command } from '@commands'\nimport { getSystemPrompt } from '@constants/prompts'\nimport { getContext } from '@context'\nimport { getTotalCost } from '@costTracker'\nimport { Message, query } from '@query'\nimport { CanUseToolFn } from '@hooks/useCanUseTool'\nimport { Tool } from '@tool'\nimport { getModelManager } from '@utils/model'\nimport { setCwd } from './state'\nimport { getMessagesPath, overwriteLog } from './log'\nimport { createUserMessage } from './messages'\n\ntype Props = {\n  commands: Command[]\n  safeMode?: boolean\n  hasPermissionsToUseTool: CanUseToolFn\n  messageLogName: string\n  prompt: string\n  cwd: string\n  tools: Tool[]\n  verbose?: boolean\n}\n\n// Sends a single prompt to the Anthropic Messages API and returns the response.\n// Assumes that claude is being used non-interactively -- will not\n// ask the user for permissions or further input.\nexport async function ask({\n  commands,\n  safeMode,\n  hasPermissionsToUseTool,\n  messageLogName,\n  prompt,\n  cwd,\n  tools,\n  verbose = false,\n}: Props): Promise<{\n  resultText: string\n  totalCost: number\n  messageHistoryFile: string\n}> {\n  await setCwd(cwd)\n  const message = createUserMessage(prompt)\n  const messages: Message[] = [message]\n\n  const [systemPrompt, context, model] = await Promise.all([\n    getSystemPrompt(),\n    getContext(),\n    getModelManager().getModelName('main'),\n  ])\n\n  for await (const m of query(\n    messages,\n    systemPrompt,\n    context,\n    hasPermissionsToUseTool,\n    {\n      options: {\n        commands,\n        tools,\n        verbose,\n        safeMode,\n        forkNumber: 0,\n        messageLogName: 'unused',\n        maxThinkingTokens: 0,\n      },\n      abortController: new AbortController(),\n      messageId: undefined,\n      readFileTimestamps: {},\n      setToolJSX: () => {}, // No-op function for non-interactive use\n    },\n  )) {\n    messages.push(m)\n  }\n\n  const result = last(messages)\n  if (!result || result.type !== 'assistant') {\n    throw new Error('Expected content to be an assistant message')\n  }\n  if (result.message.content[0]?.type !== 'text') {\n    throw new Error(\n      `Expected first content item to be text, but got ${JSON.stringify(\n        result.message.content[0],\n        null,\n        2,\n      )}`,\n    )\n  }\n\n  // Write log that can be retrieved with `claude log`\n  const messageHistoryFile = getMessagesPath(messageLogName, 0, 0)\n  overwriteLog(messageHistoryFile, messages)\n\n  return {\n    resultText: result.message.content[0].text,\n    totalCost: getTotalCost(),\n    messageHistoryFile,\n  }\n}\n"],
-  "mappings": "AAAA,SAAS,YAAY;AAErB,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAC3B,SAAS,oBAAoB;AAC7B,SAAkB,aAAa;AAG/B,SAAS,uBAAuB;AAChC,SAAS,cAAc;AACvB,SAAS,iBAAiB,oBAAoB;AAC9C,SAAS,yBAAyB;AAgBlC,eAAsB,IAAI;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,UAAU;AACZ,GAIG;AACD,QAAM,OAAO,GAAG;AAChB,QAAM,UAAU,kBAAkB,MAAM;AACxC,QAAM,WAAsB,CAAC,OAAO;AAEpC,QAAM,CAAC,cAAc,SAAS,KAAK,IAAI,MAAM,QAAQ,IAAI;AAAA,IACvD,gBAAgB;AAAA,IAChB,WAAW;AAAA,IACX,gBAAgB,EAAE,aAAa,MAAM;AAAA,EACvC,CAAC;AAED,mBAAiB,KAAK;AAAA,IACpB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,MACE,SAAS;AAAA,QACP;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,YAAY;AAAA,QACZ,gBAAgB;AAAA,QAChB,mBAAmB;AAAA,MACrB;AAAA,MACA,iBAAiB,IAAI,gBAAgB;AAAA,MACrC,WAAW;AAAA,MACX,oBAAoB,CAAC;AAAA,MACrB,YAAY,MAAM;AAAA,MAAC;AAAA;AAAA,IACrB;AAAA,EACF,GAAG;AACD,aAAS,KAAK,CAAC;AAAA,EACjB;AAEA,QAAM,SAAS,KAAK,QAAQ;AAC5B,MAAI,CAAC,UAAU,OAAO,SAAS,aAAa;AAC1C,UAAM,IAAI,MAAM,6CAA6C;AAAA,EAC/D;AACA,MAAI,OAAO,QAAQ,QAAQ,CAAC,GAAG,SAAS,QAAQ;AAC9C,UAAM,IAAI;AAAA,MACR,mDAAmD,KAAK;AAAA,QACtD,OAAO,QAAQ,QAAQ,CAAC;AAAA,QACxB;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAGA,QAAM,qBAAqB,gBAAgB,gBAAgB,GAAG,CAAC;AAC/D,eAAa,oBAAoB,QAAQ;AAEzC,SAAO;AAAA,IACL,YAAY,OAAO,QAAQ,QAAQ,CAAC,EAAE;AAAA,IACtC,WAAW,aAAa;AAAA,IACxB;AAAA,EACF;AACF;",
+  "sourcesContent": ["import { last } from 'lodash-es'\nimport { Command } from '@commands'\nimport { getSystemPrompt } from '@constants/prompts'\nimport { getContext } from '@context'\nimport { getTotalCost } from '@costTracker'\nimport { Message, query } from '@query'\nimport { CanUseToolFn } from '@hooks/useCanUseTool'\nimport { Tool } from '@tool'\nimport { getModelManager } from '@utils/model'\nimport { setCwd } from './state'\nimport { getMessagesPath, overwriteLog } from './log'\nimport { createUserMessage } from './messages'\nimport type { SafetyMode } from './config'\n\ntype Props = {\n  commands: Command[]\n  /** @deprecated Use safetyMode instead */\n  safeMode?: boolean\n  /** Safety mode: 'yolo' | 'smart' | 'strict' */\n  safetyMode?: SafetyMode\n  hasPermissionsToUseTool: CanUseToolFn\n  messageLogName: string\n  prompt: string\n  cwd: string\n  tools: Tool[]\n  verbose?: boolean\n}\n\n// Sends a single prompt to the Anthropic Messages API and returns the response.\n// Assumes that claude is being used non-interactively -- will not\n// ask the user for permissions or further input.\nexport async function ask({\n  commands,\n  safeMode,\n  safetyMode = 'yolo',\n  hasPermissionsToUseTool,\n  messageLogName,\n  prompt,\n  cwd,\n  tools,\n  verbose = false,\n}: Props): Promise<{\n  resultText: string\n  totalCost: number\n  messageHistoryFile: string\n}> {\n  await setCwd(cwd)\n  const message = createUserMessage(prompt)\n  const messages: Message[] = [message]\n\n  const [systemPrompt, context, model] = await Promise.all([\n    getSystemPrompt(),\n    getContext(),\n    getModelManager().getModelName('main'),\n  ])\n\n  for await (const m of query(\n    messages,\n    systemPrompt,\n    context,\n    hasPermissionsToUseTool,\n    {\n      options: {\n        commands,\n        tools,\n        verbose,\n        safeMode,\n        safetyMode,\n        forkNumber: 0,\n        messageLogName: 'unused',\n        maxThinkingTokens: 0,\n      },\n      abortController: new AbortController(),\n      messageId: undefined,\n      readFileTimestamps: {},\n      setToolJSX: () => {}, // No-op function for non-interactive use\n    },\n  )) {\n    messages.push(m)\n  }\n\n  const result = last(messages)\n  if (!result || result.type !== 'assistant') {\n    throw new Error('Expected content to be an assistant message')\n  }\n  if (result.message.content[0]?.type !== 'text') {\n    throw new Error(\n      `Expected first content item to be text, but got ${JSON.stringify(\n        result.message.content[0],\n        null,\n        2,\n      )}`,\n    )\n  }\n\n  // Write log that can be retrieved with `claude log`\n  const messageHistoryFile = getMessagesPath(messageLogName, 0, 0)\n  overwriteLog(messageHistoryFile, messages)\n\n  return {\n    resultText: result.message.content[0].text,\n    totalCost: getTotalCost(),\n    messageHistoryFile,\n  }\n}\n"],
+  "mappings": "AAAA,SAAS,YAAY;AAErB,SAAS,uBAAuB;AAChC,SAAS,kBAAkB;AAC3B,SAAS,oBAAoB;AAC7B,SAAkB,aAAa;AAG/B,SAAS,uBAAuB;AAChC,SAAS,cAAc;AACvB,SAAS,iBAAiB,oBAAoB;AAC9C,SAAS,yBAAyB;AAoBlC,eAAsB,IAAI;AAAA,EACxB;AAAA,EACA;AAAA,EACA,aAAa;AAAA,EACb;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,UAAU;AACZ,GAIG;AACD,QAAM,OAAO,GAAG;AAChB,QAAM,UAAU,kBAAkB,MAAM;AACxC,QAAM,WAAsB,CAAC,OAAO;AAEpC,QAAM,CAAC,cAAc,SAAS,KAAK,IAAI,MAAM,QAAQ,IAAI;AAAA,IACvD,gBAAgB;AAAA,IAChB,WAAW;AAAA,IACX,gBAAgB,EAAE,aAAa,MAAM;AAAA,EACvC,CAAC;AAED,mBAAiB,KAAK;AAAA,IACpB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,MACE,SAAS;AAAA,QACP;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA,YAAY;AAAA,QACZ,gBAAgB;AAAA,QAChB,mBAAmB;AAAA,MACrB;AAAA,MACA,iBAAiB,IAAI,gBAAgB;AAAA,MACrC,WAAW;AAAA,MACX,oBAAoB,CAAC;AAAA,MACrB,YAAY,MAAM;AAAA,MAAC;AAAA;AAAA,IACrB;AAAA,EACF,GAAG;AACD,aAAS,KAAK,CAAC;AAAA,EACjB;AAEA,QAAM,SAAS,KAAK,QAAQ;AAC5B,MAAI,CAAC,UAAU,OAAO,SAAS,aAAa;AAC1C,UAAM,IAAI,MAAM,6CAA6C;AAAA,EAC/D;AACA,MAAI,OAAO,QAAQ,QAAQ,CAAC,GAAG,SAAS,QAAQ;AAC9C,UAAM,IAAI;AAAA,MACR,mDAAmD,KAAK;AAAA,QACtD,OAAO,QAAQ,QAAQ,CAAC;AAAA,QACxB;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAGA,QAAM,qBAAqB,gBAAgB,gBAAgB,GAAG,CAAC;AAC/D,eAAa,oBAAoB,QAAQ;AAEzC,SAAO;AAAA,IACL,YAAY,OAAO,QAAQ,QAAQ,CAAC,EAAE;AAAA,IACtC,WAAW,aAAa;AAAA,IACxB;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/utils/config.js

@@ -1,5 +1,5 @@
-import { existsSync, readFileSync, writeFileSync } from "fs";
-import { resolve, join } from "path";
+import { existsSync, readFileSync, writeFileSync, renameSync, rmSync } from "fs";
+import { resolve, join, dirname } from "path";
 import { cloneDeep, memoize, pick } from "lodash-es";
 import { homedir } from "os";
 import { GLOBAL_CONFIG_FILE } from "./env.js";
@@ -83,8 +83,12 @@ const DEFAULT_GLOBAL_CONFIG = {
   // Default to business consulting compression
   thinking: false,
   // Default to thinking mode off (Phase 4.2)
-  language: "en"
+  language: "en",
   // Default to English
+  safeMode: false,
+  // Deprecated: use safetyMode instead
+  safetyMode: "yolo"
+  // Default to YOLO mode for non-technical users (zero interruption)
 };
 const GLOBAL_CONFIG_KEYS = [
   "autoUpdaterStatus",
@@ -99,7 +103,8 @@ const GLOBAL_CONFIG_KEYS = [
   "shiftEnterKeyBindingInstalled",
   "maxTokens",
   "compressionMode",
-  "language"
+  "language",
+  "safetyMode"
 ];
 function isGlobalConfigKey(key) {
   return GLOBAL_CONFIG_KEYS.includes(key);
@@ -194,6 +199,23 @@ function getCustomApiKeyStatus(truncatedApiKey) {
   }
   return "new";
 }
+function atomicWriteFileSync(filePath, content) {
+  const dir = dirname(filePath);
+  const tempPath = join(
+    dir,
+    `.${Date.now()}-${Math.random().toString(36).slice(2)}.tmp`
+  );
+  try {
+    writeFileSync(tempPath, content, "utf-8");
+    renameSync(tempPath, filePath);
+  } catch (error) {
+    try {
+      rmSync(tempPath, { force: true });
+    } catch {
+    }
+    throw error;
+  }
+}
 function saveConfig(file, config, defaultConfig) {
   const filteredConfig = Object.fromEntries(
     Object.entries(config).filter(
@@ -201,7 +223,7 @@ function saveConfig(file, config, defaultConfig) {
     )
   );
   try {
-    writeFileSync(file, JSON.stringify(filteredConfig, null, 2), "utf-8");
+    atomicWriteFileSync(file, JSON.stringify(filteredConfig, null, 2));
   } catch (error) {
     const err = error;
     if (err?.code === "EACCES" || err?.code === "EPERM" || err?.code === "EROFS") {
@@ -554,6 +576,25 @@ function setModelPointer(pointer, modelName) {
     reloadModelManager();
   });
 }
+async function resolveApiKey(profile) {
+  if (!profile.apiKey) {
+    return null;
+  }
+  if (profile.apiKey.startsWith("encrypted:")) {
+    const modelName = profile.apiKey.slice("encrypted:".length);
+    try {
+      const { getApiKey } = await import("./credentials/index.js");
+      return getApiKey(modelName);
+    } catch (error) {
+      const errorMsg = error instanceof Error ? error.message : String(error);
+      console.warn(
+        `Failed to resolve encrypted API key for ${modelName}: ${errorMsg}`
+      );
+      return null;
+    }
+  }
+  return profile.apiKey;
+}
 function isGPT5ModelName(modelName) {
   if (!modelName || typeof modelName !== "string") return false;
   const lowerName = modelName.toLowerCase();
@@ -711,6 +752,7 @@ export {
   listConfigForCLI,
   normalizeApiKeyForConfig,
   removeMcprcServerForTesting,
+  resolveApiKey,
   saveCurrentProjectConfig,
   saveGlobalConfig,
   setAllPointersToModel,