@stackmemoryai/stackmemory 0.5.57 → 0.5.59

package/dist/src/core/models/model-router.js

@@ -0,0 +1,340 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+import { writeFileSecure, ensureSecureDir } from "../../hooks/secure-fs.js";
+import {
+  ModelRouterConfigSchema,
+  parseConfigSafe
+} from "../../hooks/schemas.js";
+const CONFIG_PATH = join(homedir(), ".stackmemory", "model-router.json");
+const DEFAULT_CONFIG = {
+  enabled: false,
+  defaultProvider: "anthropic",
+  taskRouting: {},
+  fallback: {
+    enabled: true,
+    // Fallback enabled by default
+    provider: "qwen",
+    onRateLimit: true,
+    onError: true,
+    onTimeout: true,
+    maxRetries: 2,
+    retryDelayMs: 1e3
+  },
+  providers: {
+    anthropic: {
+      provider: "anthropic",
+      model: "claude-sonnet-4-20250514",
+      apiKeyEnv: "ANTHROPIC_API_KEY"
+    },
+    qwen: {
+      provider: "qwen",
+      model: "qwen3-max-2025-01-23",
+      baseUrl: "https://dashscope.aliyuncs.com/compatible-mode/v1",
+      apiKeyEnv: "DASHSCOPE_API_KEY",
+      params: {
+        enable_thinking: true,
+        thinking_budget: 1e4
+      }
+    }
+  },
+  thinkingMode: {
+    enabled: true,
+    budget: 1e4,
+    temperature: 0.6,
+    topP: 0.95
+  }
+};
+function loadModelRouterConfig() {
+  try {
+    if (existsSync(CONFIG_PATH)) {
+      const data = JSON.parse(readFileSync(CONFIG_PATH, "utf8"));
+      return parseConfigSafe(
+        ModelRouterConfigSchema,
+        { ...DEFAULT_CONFIG, ...data },
+        DEFAULT_CONFIG,
+        "model-router"
+      );
+    }
+  } catch {
+  }
+  return { ...DEFAULT_CONFIG };
+}
+function saveModelRouterConfig(config) {
+  try {
+    ensureSecureDir(join(homedir(), ".stackmemory"));
+    writeFileSecure(CONFIG_PATH, JSON.stringify(config, null, 2));
+  } catch {
+  }
+}
+function getModelForTask(taskType) {
+  const config = loadModelRouterConfig();
+  if (!config.enabled) {
+    return null;
+  }
+  const routedProvider = config.taskRouting[taskType];
+  const provider = routedProvider || config.defaultProvider;
+  return config.providers[provider] || null;
+}
+function buildModelEnv(modelConfig) {
+  const env = {};
+  const apiKey = process.env[modelConfig.apiKeyEnv];
+  if (!apiKey) {
+    console.warn(`[model-router] API key not found: ${modelConfig.apiKeyEnv}`);
+    return env;
+  }
+  env["ANTHROPIC_MODEL"] = modelConfig.model;
+  env["ANTHROPIC_SMALL_FAST_MODEL"] = modelConfig.model;
+  env["ANTHROPIC_AUTH_TOKEN"] = apiKey;
+  if (modelConfig.baseUrl) {
+    env["ANTHROPIC_BASE_URL"] = modelConfig.baseUrl;
+  }
+  return env;
+}
+function isPlanningContext(input) {
+  const planPatterns = [
+    /\bplan\b/i,
+    /\barchitect/i,
+    /\bdesign\b/i,
+    /\bstrateg/i,
+    /\bimplement.*approach/i,
+    /\bhow.*should.*we/i,
+    /\bthink.*through/i,
+    /\breason.*about/i,
+    /\banalyze.*options/i,
+    /\btrade-?offs?/i
+  ];
+  return planPatterns.some((pattern) => pattern.test(input));
+}
+function requiresDeepThinking(input) {
+  const thinkPatterns = [
+    /\bcomplex/i,
+    /\bdifficult/i,
+    /\btricky/i,
+    /\bcareful/i,
+    /\bstep.*by.*step/i,
+    /\bthink.*hard/i,
+    /\bultrathink/i,
+    /\b--think/i,
+    /\b--think-hard/i
+  ];
+  return thinkPatterns.some((pattern) => pattern.test(input));
+}
+class ModelRouter {
+  config;
+  currentProvider;
+  inFallbackMode = false;
+  fallbackReason;
+  constructor() {
+    this.config = loadModelRouterConfig();
+    this.currentProvider = this.config.defaultProvider;
+  }
+  /**
+   * Route a task to the appropriate model
+   */
+  route(taskType, input) {
+    if (!this.config.enabled) {
+      return { provider: "anthropic", env: {}, switched: false };
+    }
+    let detectedType = taskType;
+    if (input && taskType === "default") {
+      if (isPlanningContext(input)) {
+        detectedType = "plan";
+      } else if (requiresDeepThinking(input)) {
+        detectedType = "think";
+      }
+    }
+    const modelConfig = getModelForTask(detectedType);
+    if (!modelConfig) {
+      return { provider: "anthropic", env: {}, switched: false };
+    }
+    const switched = modelConfig.provider !== this.currentProvider;
+    this.currentProvider = modelConfig.provider;
+    return {
+      provider: modelConfig.provider,
+      env: buildModelEnv(modelConfig),
+      switched
+    };
+  }
+  /**
+   * Get current provider
+   */
+  getCurrentProvider() {
+    return this.currentProvider;
+  }
+  /**
+   * Force switch to a specific provider
+   */
+  switchTo(provider) {
+    const modelConfig = this.config.providers[provider];
+    if (!modelConfig) {
+      console.warn(`[model-router] Provider not configured: ${provider}`);
+      return {};
+    }
+    this.currentProvider = provider;
+    return buildModelEnv(modelConfig);
+  }
+  /**
+   * Reset to default provider
+   */
+  reset() {
+    this.currentProvider = this.config.defaultProvider;
+    this.inFallbackMode = false;
+    this.fallbackReason = void 0;
+  }
+  /**
+   * Check if fallback is enabled and configured
+   */
+  isFallbackEnabled() {
+    if (!this.config.fallback?.enabled) return false;
+    const fallbackProvider = this.config.providers[this.config.fallback.provider];
+    if (!fallbackProvider) return false;
+    const apiKey = process.env[fallbackProvider.apiKeyEnv];
+    return !!apiKey;
+  }
+  /**
+   * Check if error should trigger fallback
+   */
+  shouldFallback(error) {
+    if (!this.isFallbackEnabled()) return false;
+    if (this.inFallbackMode) return false;
+    const fallback = this.config.fallback;
+    if (fallback.onRateLimit && error.status === 429) {
+      return true;
+    }
+    if (fallback.onError && error.status && error.status >= 500) {
+      return true;
+    }
+    if (fallback.onTimeout) {
+      const isTimeout = error.code === "ETIMEDOUT" || error.code === "ESOCKETTIMEDOUT" || error.message?.toLowerCase().includes("timeout");
+      if (isTimeout) return true;
+    }
+    if (error.message?.toLowerCase().includes("overloaded")) {
+      return true;
+    }
+    return false;
+  }
+  /**
+   * Activate fallback mode
+   */
+  activateFallback(reason) {
+    if (!this.isFallbackEnabled()) {
+      console.warn("[model-router] Fallback not available");
+      return {};
+    }
+    const fallbackProvider = this.config.fallback.provider;
+    const modelConfig = this.config.providers[fallbackProvider];
+    if (!modelConfig) {
+      console.warn(
+        `[model-router] Fallback provider not configured: ${fallbackProvider}`
+      );
+      return {};
+    }
+    this.inFallbackMode = true;
+    this.fallbackReason = reason;
+    this.currentProvider = fallbackProvider;
+    console.log(
+      `[model-router] Fallback activated: ${reason} -> ${fallbackProvider}`
+    );
+    return buildModelEnv(modelConfig);
+  }
+  /**
+   * Get fallback configuration
+   */
+  getFallbackConfig() {
+    return this.config.fallback;
+  }
+  /**
+   * Check if currently in fallback mode
+   */
+  isInFallbackMode() {
+    return this.inFallbackMode;
+  }
+  /**
+   * Get reason for fallback
+   */
+  getFallbackReason() {
+    return this.fallbackReason;
+  }
+  /**
+   * Get fallback environment variables (for pre-configuring)
+   */
+  getFallbackEnv() {
+    if (!this.isFallbackEnabled()) return {};
+    const fallbackProvider = this.config.fallback.provider;
+    const modelConfig = this.config.providers[fallbackProvider];
+    if (!modelConfig) return {};
+    return buildModelEnv(modelConfig);
+  }
+}
+let routerInstance = null;
+function getModelRouter() {
+  if (!routerInstance) {
+    routerInstance = new ModelRouter();
+  }
+  return routerInstance;
+}
+function getPlanModeEnv() {
+  const router = getModelRouter();
+  const result = router.route("plan");
+  return result.env;
+}
+function getThinkingModeEnv() {
+  const router = getModelRouter();
+  const result = router.route("think");
+  return result.env;
+}
+function isFallbackAvailable() {
+  const router = getModelRouter();
+  return router.isFallbackEnabled();
+}
+function getFallbackStatus() {
+  const router = getModelRouter();
+  const config = loadModelRouterConfig();
+  if (!config.fallback?.enabled) {
+    return {
+      enabled: false,
+      provider: null,
+      hasApiKey: false,
+      inFallback: false
+    };
+  }
+  const fallbackProvider = config.providers[config.fallback.provider];
+  const hasApiKey = fallbackProvider ? !!process.env[fallbackProvider.apiKeyEnv] : false;
+  return {
+    enabled: true,
+    provider: config.fallback.provider,
+    hasApiKey,
+    inFallback: router.isInFallbackMode(),
+    reason: router.getFallbackReason()
+  };
+}
+function triggerFallback(reason = "manual") {
+  const router = getModelRouter();
+  return router.activateFallback(reason);
+}
+function resetFallback() {
+  const router = getModelRouter();
+  router.reset();
+}
+export {
+  ModelRouter,
+  buildModelEnv,
+  getFallbackStatus,
+  getModelForTask,
+  getModelRouter,
+  getPlanModeEnv,
+  getThinkingModeEnv,
+  isFallbackAvailable,
+  isPlanningContext,
+  loadModelRouterConfig,
+  requiresDeepThinking,
+  resetFallback,
+  saveModelRouterConfig,
+  triggerFallback
+};
+//# sourceMappingURL=model-router.js.map

package/dist/src/core/models/model-router.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/models/model-router.ts"],
+  "sourcesContent": ["/**\n * Model Router - Switch between Claude and alternative models\n * Supports routing plan/thinking tasks to specialized models like Qwen3-Max-Thinking\n */\n\nimport { existsSync, readFileSync } from 'fs';\nimport { join } from 'path';\nimport { homedir } from 'os';\nimport { writeFileSecure, ensureSecureDir } from '../../hooks/secure-fs.js';\nimport {\n  ModelRouterConfigSchema,\n  parseConfigSafe,\n} from '../../hooks/schemas.js';\n\nexport type ModelProvider =\n  | 'anthropic'\n  | 'qwen'\n  | 'openai'\n  | 'ollama'\n  | 'custom';\nexport type TaskType = 'default' | 'plan' | 'think' | 'code' | 'review';\n\nexport interface ModelConfig {\n  provider: ModelProvider;\n  model: string;\n  baseUrl?: string;\n  apiKeyEnv: string; // Environment variable name for API key\n  headers?: Record<string, string>;\n  params?: Record<string, unknown>; // Provider-specific params\n}\n\nexport interface ModelRouterConfig {\n  enabled: boolean;\n  defaultProvider: ModelProvider;\n\n  // Route specific task types to different models\n  taskRouting: {\n    plan?: ModelProvider; // Planning/architecture tasks\n    think?: ModelProvider; // Deep thinking/reasoning\n    code?: ModelProvider; // Code generation\n    review?: ModelProvider; // Code review\n  };\n\n  // Fallback configuration\n  fallback: {\n    enabled: boolean;\n    provider: ModelProvider; // Fallback provider (default: qwen)\n    onRateLimit: boolean; // Fallback on 429 errors\n    onError: boolean; // Fallback on 5xx errors\n    onTimeout: boolean; // Fallback on timeout\n    maxRetries: number; // Retries before fallback\n    retryDelayMs: number; // Delay between retries\n  };\n\n  // Provider configurations\n  providers: {\n    anthropic?: ModelConfig;\n    qwen?: ModelConfig;\n    openai?: ModelConfig;\n    ollama?: ModelConfig;\n    custom?: ModelConfig;\n  };\n\n  // Thinking mode settings\n  thinkingMode: {\n    enabled: boolean;\n    budget?: number; // Max thinking tokens\n    temperature?: number; // Recommended: 0.6 for thinking\n    topP?: number; // Recommended: 0.95 for thinking\n  };\n}\n\nconst CONFIG_PATH = join(homedir(), '.stackmemory', 'model-router.json');\n\nconst DEFAULT_CONFIG: ModelRouterConfig = {\n  enabled: false,\n  defaultProvider: 'anthropic',\n  taskRouting: {},\n  fallback: {\n    enabled: true, // Fallback enabled by default\n    provider: 'qwen',\n    onRateLimit: true,\n    onError: true,\n    onTimeout: true,\n    maxRetries: 2,\n    retryDelayMs: 1000,\n  },\n  providers: {\n    anthropic: {\n      provider: 'anthropic',\n      model: 'claude-sonnet-4-20250514',\n      apiKeyEnv: 'ANTHROPIC_API_KEY',\n    },\n    qwen: {\n      provider: 'qwen',\n      model: 'qwen3-max-2025-01-23',\n      baseUrl: 'https://dashscope.aliyuncs.com/compatible-mode/v1',\n      apiKeyEnv: 'DASHSCOPE_API_KEY',\n      params: {\n        enable_thinking: true,\n        thinking_budget: 10000,\n      },\n    },\n  },\n  thinkingMode: {\n    enabled: true,\n    budget: 10000,\n    temperature: 0.6,\n    topP: 0.95,\n  },\n};\n\n/**\n * Load model router configuration with Zod validation\n */\nexport function loadModelRouterConfig(): ModelRouterConfig {\n  try {\n    if (existsSync(CONFIG_PATH)) {\n      const data = JSON.parse(readFileSync(CONFIG_PATH, 'utf8'));\n      return parseConfigSafe(\n        ModelRouterConfigSchema,\n        { ...DEFAULT_CONFIG, ...data },\n        DEFAULT_CONFIG,\n        'model-router'\n      );\n    }\n  } catch {\n    // Use defaults\n  }\n  return { ...DEFAULT_CONFIG };\n}\n\n/**\n * Save model router configuration\n */\nexport function saveModelRouterConfig(config: ModelRouterConfig): void {\n  try {\n    ensureSecureDir(join(homedir(), '.stackmemory'));\n    writeFileSecure(CONFIG_PATH, JSON.stringify(config, null, 2));\n  } catch {\n    // Silently fail\n  }\n}\n\n/**\n * Get model config for a specific task type\n */\nexport function getModelForTask(taskType: TaskType): ModelConfig | null {\n  const config = loadModelRouterConfig();\n\n  if (!config.enabled) {\n    return null; // Use default Claude\n  }\n\n  // Check task-specific routing\n  const routedProvider =\n    config.taskRouting[taskType as keyof typeof config.taskRouting];\n  const provider = routedProvider || config.defaultProvider;\n\n  return config.providers[provider] || null;\n}\n\n/**\n * Build environment variables for alternative model\n */\nexport function buildModelEnv(\n  modelConfig: ModelConfig\n): Record<string, string> {\n  const env: Record<string, string> = {};\n\n  // Get API key from environment\n  const apiKey = process.env[modelConfig.apiKeyEnv];\n  if (!apiKey) {\n    console.warn(`[model-router] API key not found: ${modelConfig.apiKeyEnv}`);\n    return env;\n  }\n\n  // Set Anthropic-compatible env vars (Claude Code reads these)\n  env['ANTHROPIC_MODEL'] = modelConfig.model;\n  env['ANTHROPIC_SMALL_FAST_MODEL'] = modelConfig.model;\n  env['ANTHROPIC_AUTH_TOKEN'] = apiKey;\n\n  if (modelConfig.baseUrl) {\n    env['ANTHROPIC_BASE_URL'] = modelConfig.baseUrl;\n  }\n\n  return env;\n}\n\n/**\n * Detect if current context is a planning task\n */\nexport function isPlanningContext(input: string): boolean {\n  const planPatterns = [\n    /\\bplan\\b/i,\n    /\\barchitect/i,\n    /\\bdesign\\b/i,\n    /\\bstrateg/i,\n    /\\bimplement.*approach/i,\n    /\\bhow.*should.*we/i,\n    /\\bthink.*through/i,\n    /\\breason.*about/i,\n    /\\banalyze.*options/i,\n    /\\btrade-?offs?/i,\n  ];\n\n  return planPatterns.some((pattern) => pattern.test(input));\n}\n\n/**\n * Detect if task requires deep thinking\n */\nexport function requiresDeepThinking(input: string): boolean {\n  const thinkPatterns = [\n    /\\bcomplex/i,\n    /\\bdifficult/i,\n    /\\btricky/i,\n    /\\bcareful/i,\n    /\\bstep.*by.*step/i,\n    /\\bthink.*hard/i,\n    /\\bultrathink/i,\n    /\\b--think/i,\n    /\\b--think-hard/i,\n  ];\n\n  return thinkPatterns.some((pattern) => pattern.test(input));\n}\n\n/**\n * Error types that trigger fallback\n */\nexport type FallbackTrigger = 'rate_limit' | 'error' | 'timeout' | 'manual';\n\n/**\n * Model Router class for managing model switching\n */\nexport class ModelRouter {\n  private config: ModelRouterConfig;\n  private currentProvider: ModelProvider;\n  private inFallbackMode: boolean = false;\n  private fallbackReason?: FallbackTrigger;\n\n  constructor() {\n    this.config = loadModelRouterConfig();\n    this.currentProvider = this.config.defaultProvider;\n  }\n\n  /**\n   * Route a task to the appropriate model\n   */\n  route(\n    taskType: TaskType,\n    input?: string\n  ): {\n    provider: ModelProvider;\n    env: Record<string, string>;\n    switched: boolean;\n  } {\n    if (!this.config.enabled) {\n      return { provider: 'anthropic', env: {}, switched: false };\n    }\n\n    // Auto-detect task type if input provided\n    let detectedType = taskType;\n    if (input && taskType === 'default') {\n      if (isPlanningContext(input)) {\n        detectedType = 'plan';\n      } else if (requiresDeepThinking(input)) {\n        detectedType = 'think';\n      }\n    }\n\n    const modelConfig = getModelForTask(detectedType);\n    if (!modelConfig) {\n      return { provider: 'anthropic', env: {}, switched: false };\n    }\n\n    const switched = modelConfig.provider !== this.currentProvider;\n    this.currentProvider = modelConfig.provider;\n\n    return {\n      provider: modelConfig.provider,\n      env: buildModelEnv(modelConfig),\n      switched,\n    };\n  }\n\n  /**\n   * Get current provider\n   */\n  getCurrentProvider(): ModelProvider {\n    return this.currentProvider;\n  }\n\n  /**\n   * Force switch to a specific provider\n   */\n  switchTo(provider: ModelProvider): Record<string, string> {\n    const modelConfig = this.config.providers[provider];\n    if (!modelConfig) {\n      console.warn(`[model-router] Provider not configured: ${provider}`);\n      return {};\n    }\n\n    this.currentProvider = provider;\n    return buildModelEnv(modelConfig);\n  }\n\n  /**\n   * Reset to default provider\n   */\n  reset(): void {\n    this.currentProvider = this.config.defaultProvider;\n    this.inFallbackMode = false;\n    this.fallbackReason = undefined;\n  }\n\n  /**\n   * Check if fallback is enabled and configured\n   */\n  isFallbackEnabled(): boolean {\n    if (!this.config.fallback?.enabled) return false;\n\n    const fallbackProvider =\n      this.config.providers[this.config.fallback.provider];\n    if (!fallbackProvider) return false;\n\n    // Check if fallback provider has API key\n    const apiKey = process.env[fallbackProvider.apiKeyEnv];\n    return !!apiKey;\n  }\n\n  /**\n   * Check if error should trigger fallback\n   */\n  shouldFallback(error: {\n    status?: number;\n    code?: string;\n    message?: string;\n  }): boolean {\n    if (!this.isFallbackEnabled()) return false;\n    if (this.inFallbackMode) return false; // Already in fallback\n\n    const fallback = this.config.fallback;\n\n    // Rate limit (429)\n    if (fallback.onRateLimit && error.status === 429) {\n      return true;\n    }\n\n    // Server errors (5xx)\n    if (fallback.onError && error.status && error.status >= 500) {\n      return true;\n    }\n\n    // Timeout\n    if (fallback.onTimeout) {\n      const isTimeout =\n        error.code === 'ETIMEDOUT' ||\n        error.code === 'ESOCKETTIMEDOUT' ||\n        error.message?.toLowerCase().includes('timeout');\n      if (isTimeout) return true;\n    }\n\n    // Overloaded\n    if (error.message?.toLowerCase().includes('overloaded')) {\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Activate fallback mode\n   */\n  activateFallback(reason: FallbackTrigger): Record<string, string> {\n    if (!this.isFallbackEnabled()) {\n      console.warn('[model-router] Fallback not available');\n      return {};\n    }\n\n    const fallbackProvider = this.config.fallback.provider;\n    const modelConfig = this.config.providers[fallbackProvider];\n\n    if (!modelConfig) {\n      console.warn(\n        `[model-router] Fallback provider not configured: ${fallbackProvider}`\n      );\n      return {};\n    }\n\n    this.inFallbackMode = true;\n    this.fallbackReason = reason;\n    this.currentProvider = fallbackProvider;\n\n    console.log(\n      `[model-router] Fallback activated: ${reason} -> ${fallbackProvider}`\n    );\n\n    return buildModelEnv(modelConfig);\n  }\n\n  /**\n   * Get fallback configuration\n   */\n  getFallbackConfig(): ModelRouterConfig['fallback'] {\n    return this.config.fallback;\n  }\n\n  /**\n   * Check if currently in fallback mode\n   */\n  isInFallbackMode(): boolean {\n    return this.inFallbackMode;\n  }\n\n  /**\n   * Get reason for fallback\n   */\n  getFallbackReason(): FallbackTrigger | undefined {\n    return this.fallbackReason;\n  }\n\n  /**\n   * Get fallback environment variables (for pre-configuring)\n   */\n  getFallbackEnv(): Record<string, string> {\n    if (!this.isFallbackEnabled()) return {};\n\n    const fallbackProvider = this.config.fallback.provider;\n    const modelConfig = this.config.providers[fallbackProvider];\n\n    if (!modelConfig) return {};\n\n    return buildModelEnv(modelConfig);\n  }\n}\n\n// Singleton instance\nlet routerInstance: ModelRouter | null = null;\n\nexport function getModelRouter(): ModelRouter {\n  if (!routerInstance) {\n    routerInstance = new ModelRouter();\n  }\n  return routerInstance;\n}\n\n/**\n * Quick helper to get env vars for plan mode\n */\nexport function getPlanModeEnv(): Record<string, string> {\n  const router = getModelRouter();\n  const result = router.route('plan');\n  return result.env;\n}\n\n/**\n * Quick helper to get env vars for thinking mode\n */\nexport function getThinkingModeEnv(): Record<string, string> {\n  const router = getModelRouter();\n  const result = router.route('think');\n  return result.env;\n}\n\n/**\n * Check if fallback is available\n */\nexport function isFallbackAvailable(): boolean {\n  const router = getModelRouter();\n  return router.isFallbackEnabled();\n}\n\n/**\n * Get fallback status for display\n */\nexport function getFallbackStatus(): {\n  enabled: boolean;\n  provider: ModelProvider | null;\n  hasApiKey: boolean;\n  inFallback: boolean;\n  reason?: FallbackTrigger;\n} {\n  const router = getModelRouter();\n  const config = loadModelRouterConfig();\n\n  if (!config.fallback?.enabled) {\n    return {\n      enabled: false,\n      provider: null,\n      hasApiKey: false,\n      inFallback: false,\n    };\n  }\n\n  const fallbackProvider = config.providers[config.fallback.provider];\n  const hasApiKey = fallbackProvider\n    ? !!process.env[fallbackProvider.apiKeyEnv]\n    : false;\n\n  return {\n    enabled: true,\n    provider: config.fallback.provider,\n    hasApiKey,\n    inFallback: router.isInFallbackMode(),\n    reason: router.getFallbackReason(),\n  };\n}\n\n/**\n * Trigger fallback manually (for testing or forced switch)\n */\nexport function triggerFallback(\n  reason: FallbackTrigger = 'manual'\n): Record<string, string> {\n  const router = getModelRouter();\n  return router.activateFallback(reason);\n}\n\n/**\n * Reset fallback state\n */\nexport function resetFallback(): void {\n  const router = getModelRouter();\n  router.reset();\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/src/core/monitoring/error-handler.js

@@ -0,0 +1,49 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import {
+  ErrorCode,
+  StackMemoryError,
+  DatabaseError,
+  FrameError,
+  TaskError,
+  IntegrationError,
+  MCPError,
+  ValidationError,
+  ProjectError,
+  SystemError,
+  ErrorHandler,
+  getUserFriendlyMessage,
+  isRetryableError,
+  getErrorMessage,
+  wrapError,
+  isStackMemoryError,
+  createErrorHandler,
+  validateInput,
+  validateEmail,
+  validatePath
+} from "../errors/index.js";
+export {
+  DatabaseError,
+  ErrorCode,
+  ErrorHandler,
+  FrameError,
+  IntegrationError,
+  MCPError,
+  ProjectError,
+  StackMemoryError,
+  SystemError,
+  TaskError,
+  ValidationError,
+  createErrorHandler,
+  getErrorMessage,
+  getUserFriendlyMessage,
+  isRetryableError,
+  isStackMemoryError,
+  validateEmail,
+  validateInput,
+  validatePath,
+  wrapError
+};
+//# sourceMappingURL=error-handler.js.map

package/dist/src/core/monitoring/error-handler.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/monitoring/error-handler.ts"],
+  "sourcesContent": ["/**\n * Error handling re-exports for backwards compatibility\n *\n * All error handling is now consolidated in src/core/errors/index.ts\n * This module re-exports for code that imports from monitoring/error-handler\n */\n\nexport {\n  // Error codes\n  ErrorCode,\n\n  // Error classes\n  StackMemoryError,\n  DatabaseError,\n  FrameError,\n  TaskError,\n  IntegrationError,\n  MCPError,\n  ValidationError,\n  ProjectError,\n  SystemError,\n\n  // Error handler\n  ErrorHandler,\n\n  // Utilities\n  getUserFriendlyMessage,\n  isRetryableError,\n  getErrorMessage,\n  wrapError,\n  isStackMemoryError,\n  createErrorHandler,\n\n  // Validators\n  validateInput,\n  validateEmail,\n  validatePath,\n\n  // Types\n  type ErrorContext,\n  type StackMemoryErrorOptions,\n} from '../errors/index.js';\n"],
+  "mappings": ";;;;AAOA;AAAA,EAEE;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAGA;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,OAKK;",
+  "names": []
+}

package/dist/src/core/monitoring/logger.js

@@ -0,0 +1,202 @@
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __pathDirname } from 'path';
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __pathDirname(__filename);
+import * as fs from "fs";
+import * as path from "path";
+const SENSITIVE_PATTERNS = [
+  /\b(api[_-]?key|apikey)\s*[:=]\s*['"]?[\w-]+['"]?/gi,
+  /\b(secret|password|token|credential|auth)\s*[:=]\s*['"]?[\w-]+['"]?/gi,
+  /\b(lin_api_[\w]+)/gi,
+  /\b(lin_oauth_[\w]+)/gi,
+  /\b(sk-[\w]+)/gi,
+  /\b(npm_[\w]+)/gi,
+  /\b(ghp_[\w]+)/gi,
+  /\b(ghs_[\w]+)/gi,
+  /Bearer\s+[\w.-]+/gi,
+  /Basic\s+[\w=]+/gi,
+  /postgres(ql)?:\/\/[^@\s]+:[^@\s]+@/gi
+];
+const SENSITIVE_FIELD_NAMES = [
+  "password",
+  "token",
+  "apikey",
+  "api_key",
+  "secret",
+  "credential",
+  "authorization",
+  "auth",
+  "accesstoken",
+  "access_token",
+  "refreshtoken",
+  "refresh_token"
+];
+function redactString(input) {
+  let result = input;
+  for (const pattern of SENSITIVE_PATTERNS) {
+    pattern.lastIndex = 0;
+    result = result.replace(pattern, "[REDACTED]");
+  }
+  return result;
+}
+function sanitizeForLogging(obj) {
+  if (obj === null || obj === void 0) {
+    return obj;
+  }
+  if (typeof obj === "string") {
+    return redactString(obj);
+  }
+  if (Array.isArray(obj)) {
+    return obj.map(sanitizeForLogging);
+  }
+  if (typeof obj === "object") {
+    const sanitized = {};
+    for (const [key, value] of Object.entries(obj)) {
+      if (SENSITIVE_FIELD_NAMES.some((sf) => key.toLowerCase().includes(sf))) {
+        sanitized[key] = "[REDACTED]";
+      } else {
+        sanitized[key] = sanitizeForLogging(value);
+      }
+    }
+    return sanitized;
+  }
+  return obj;
+}
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2[LogLevel2["ERROR"] = 0] = "ERROR";
+  LogLevel2[LogLevel2["WARN"] = 1] = "WARN";
+  LogLevel2[LogLevel2["INFO"] = 2] = "INFO";
+  LogLevel2[LogLevel2["DEBUG"] = 3] = "DEBUG";
+  return LogLevel2;
+})(LogLevel || {});
+class Logger {
+  static instance;
+  logLevel = 2 /* INFO */;
+  logFile;
+  fileLoggingDisabledNotified = false;
+  constructor() {
+    const envLevel = process.env["STACKMEMORY_LOG_LEVEL"]?.toUpperCase();
+    switch (envLevel) {
+      case "ERROR":
+        this.logLevel = 0 /* ERROR */;
+        break;
+      case "WARN":
+        this.logLevel = 1 /* WARN */;
+        break;
+      case "DEBUG":
+        this.logLevel = 3 /* DEBUG */;
+        break;
+      default:
+        this.logLevel = 2 /* INFO */;
+    }
+    if (this.logLevel === 3 /* DEBUG */ || process.env["STACKMEMORY_LOG_FILE"]) {
+      this.logFile = process.env["STACKMEMORY_LOG_FILE"] || path.join(
+        process.env["HOME"] || ".",
+        ".stackmemory",
+        "logs",
+        "cli.log"
+      );
+      this.ensureLogDirectory();
+    }
+  }
+  static getInstance() {
+    if (!Logger.instance) {
+      Logger.instance = new Logger();
+    }
+    return Logger.instance;
+  }
+  ensureLogDirectory() {
+    if (!this.logFile) return;
+    const logDir = path.dirname(this.logFile);
+    try {
+      if (!fs.existsSync(logDir)) {
+        fs.mkdirSync(logDir, { recursive: true });
+      }
+    } catch (err) {
+      this.logFile = void 0;
+      if (!this.fileLoggingDisabledNotified) {
+        this.fileLoggingDisabledNotified = true;
+        const msg = "[Logger] File logging disabled (failed to create log directory). Falling back to console only.";
+        console.warn(msg);
+      }
+    }
+  }
+  writeLog(entry) {
+    const sanitizedEntry = {
+      ...entry,
+      message: redactString(entry.message),
+      context: entry.context ? sanitizeForLogging(entry.context) : void 0
+    };
+    const logLine = JSON.stringify(sanitizedEntry) + "\n";
+    if (this.logFile) {
+      try {
+        fs.appendFileSync(this.logFile, logLine);
+      } catch (err) {
+        this.logFile = void 0;
+        if (!this.fileLoggingDisabledNotified) {
+          this.fileLoggingDisabledNotified = true;
+          const msg = "[Logger] File logging disabled (write failed). Falling back to console only.";
+          console.warn(msg);
+        }
+      }
+    }
+    if (entry.level <= this.logLevel) {
+      const levelNames = ["ERROR", "WARN", "INFO", "DEBUG"];
+      const levelName = levelNames[entry.level] || "UNKNOWN";
+      const consoleMessage = `[${entry.timestamp}] ${levelName}: ${entry.message}`;
+      if (entry.level === 0 /* ERROR */) {
+        console.error(consoleMessage);
+        if (entry.error) {
+          console.error(entry.error.stack);
+        }
+      } else if (entry.level === 1 /* WARN */) {
+        console.warn(consoleMessage);
+      } else {
+        console.log(consoleMessage);
+      }
+    }
+  }
+  error(message, errorOrContext, context) {
+    const isError = errorOrContext instanceof Error;
+    this.writeLog({
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      level: 0 /* ERROR */,
+      message,
+      context: isError ? context : errorOrContext,
+      error: isError ? errorOrContext : void 0
+    });
+  }
+  warn(message, errorOrContext) {
+    const isError = errorOrContext instanceof Error;
+    this.writeLog({
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      level: 1 /* WARN */,
+      message,
+      context: isError ? void 0 : errorOrContext,
+      error: isError ? errorOrContext : void 0
+    });
+  }
+  info(message, context) {
+    this.writeLog({
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      level: 2 /* INFO */,
+      message,
+      context
+    });
+  }
+  debug(message, context) {
+    this.writeLog({
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      level: 3 /* DEBUG */,
+      message,
+      context
+    });
+  }
+}
+const logger = Logger.getInstance();
+export {
+  LogLevel,
+  Logger,
+  logger
+};
+//# sourceMappingURL=logger.js.map

package/dist/src/core/monitoring/logger.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/core/monitoring/logger.ts"],
+  "sourcesContent": ["/**\n * Structured logging utility for StackMemory CLI\n * Includes automatic sensitive data redaction for security\n */\n\nimport * as fs from 'fs';\nimport * as path from 'path';\n\n/**\n * Sensitive data patterns that should be redacted from logs\n */\nconst SENSITIVE_PATTERNS = [\n  /\\b(api[_-]?key|apikey)\\s*[:=]\\s*['\"]?[\\w-]+['\"]?/gi,\n  /\\b(secret|password|token|credential|auth)\\s*[:=]\\s*['\"]?[\\w-]+['\"]?/gi,\n  /\\b(lin_api_[\\w]+)/gi,\n  /\\b(lin_oauth_[\\w]+)/gi,\n  /\\b(sk-[\\w]+)/gi,\n  /\\b(npm_[\\w]+)/gi,\n  /\\b(ghp_[\\w]+)/gi,\n  /\\b(ghs_[\\w]+)/gi,\n  /Bearer\\s+[\\w.-]+/gi,\n  /Basic\\s+[\\w=]+/gi,\n  /postgres(ql)?:\\/\\/[^@\\s]+:[^@\\s]+@/gi,\n];\n\nconst SENSITIVE_FIELD_NAMES = [\n  'password',\n  'token',\n  'apikey',\n  'api_key',\n  'secret',\n  'credential',\n  'authorization',\n  'auth',\n  'accesstoken',\n  'access_token',\n  'refreshtoken',\n  'refresh_token',\n];\n\n/**\n * Redact sensitive data from a string\n */\nfunction redactString(input: string): string {\n  let result = input;\n  for (const pattern of SENSITIVE_PATTERNS) {\n    pattern.lastIndex = 0;\n    result = result.replace(pattern, '[REDACTED]');\n  }\n  return result;\n}\n\n/**\n * Recursively sanitize an object for logging\n */\nfunction sanitizeForLogging(obj: unknown): unknown {\n  if (obj === null || obj === undefined) {\n    return obj;\n  }\n\n  if (typeof obj === 'string') {\n    return redactString(obj);\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map(sanitizeForLogging);\n  }\n\n  if (typeof obj === 'object') {\n    const sanitized: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(obj)) {\n      if (SENSITIVE_FIELD_NAMES.some((sf) => key.toLowerCase().includes(sf))) {\n        sanitized[key] = '[REDACTED]';\n      } else {\n        sanitized[key] = sanitizeForLogging(value);\n      }\n    }\n    return sanitized;\n  }\n\n  return obj;\n}\n\nexport enum LogLevel {\n  ERROR = 0,\n  WARN = 1,\n  INFO = 2,\n  DEBUG = 3,\n}\n\ninterface LogEntry {\n  timestamp: string;\n  level: LogLevel;\n  message: string;\n  context?: Record<string, unknown>;\n  error?: Error;\n}\n\nexport class Logger {\n  private static instance: Logger;\n  private logLevel: LogLevel = LogLevel.INFO;\n  private logFile?: string;\n  private fileLoggingDisabledNotified = false;\n\n  private constructor() {\n    // Set log level from environment\n    const envLevel = process.env['STACKMEMORY_LOG_LEVEL']?.toUpperCase();\n    switch (envLevel) {\n      case 'ERROR':\n        this.logLevel = LogLevel.ERROR;\n        break;\n      case 'WARN':\n        this.logLevel = LogLevel.WARN;\n        break;\n      case 'DEBUG':\n        this.logLevel = LogLevel.DEBUG;\n        break;\n      default:\n        this.logLevel = LogLevel.INFO;\n    }\n\n    // Set up log file if in debug mode or if specified\n    if (\n      this.logLevel === LogLevel.DEBUG ||\n      process.env['STACKMEMORY_LOG_FILE']\n    ) {\n      this.logFile =\n        process.env['STACKMEMORY_LOG_FILE'] ||\n        path.join(\n          process.env['HOME'] || '.',\n          '.stackmemory',\n          'logs',\n          'cli.log'\n        );\n      this.ensureLogDirectory();\n    }\n  }\n\n  static getInstance(): Logger {\n    if (!Logger.instance) {\n      Logger.instance = new Logger();\n    }\n    return Logger.instance;\n  }\n\n  private ensureLogDirectory(): void {\n    if (!this.logFile) return;\n    const logDir = path.dirname(this.logFile);\n    try {\n      if (!fs.existsSync(logDir)) {\n        fs.mkdirSync(logDir, { recursive: true });\n      }\n    } catch (err: unknown) {\n      // Disable file logging if we cannot create the directory (e.g., ENOSPC)\n      this.logFile = undefined;\n      if (!this.fileLoggingDisabledNotified) {\n        this.fileLoggingDisabledNotified = true;\n        // Emit a single warning to console so we don't spam output\n        const msg =\n          '[Logger] File logging disabled (failed to create log directory). Falling back to console only.';\n        // Use console directly to avoid recursion\n\n        console.warn(msg);\n      }\n    }\n  }\n\n  private writeLog(entry: LogEntry): void {\n    // Sanitize context and message to prevent logging sensitive data\n    const sanitizedEntry: LogEntry = {\n      ...entry,\n      message: redactString(entry.message),\n      context: entry.context\n        ? (sanitizeForLogging(entry.context) as Record<string, unknown>)\n        : undefined,\n    };\n    const logLine = JSON.stringify(sanitizedEntry) + '\\n';\n\n    // Always write to file if configured\n    if (this.logFile) {\n      try {\n        fs.appendFileSync(this.logFile, logLine);\n      } catch (err: unknown) {\n        // Disable file logging on error (e.g., ENOSPC) to avoid repeated failures\n        this.logFile = undefined;\n        if (!this.fileLoggingDisabledNotified) {\n          this.fileLoggingDisabledNotified = true;\n          const msg =\n            '[Logger] File logging disabled (write failed). Falling back to console only.';\n\n          console.warn(msg);\n        }\n      }\n    }\n\n    // Console output based on level\n    if (entry.level <= this.logLevel) {\n      const levelNames = ['ERROR', 'WARN', 'INFO', 'DEBUG'];\n      const levelName = levelNames[entry.level] || 'UNKNOWN';\n\n      const consoleMessage = `[${entry.timestamp}] ${levelName}: ${entry.message}`;\n\n      if (entry.level === LogLevel.ERROR) {\n        console.error(consoleMessage);\n        if (entry.error) {\n          console.error(entry.error.stack);\n        }\n      } else if (entry.level === LogLevel.WARN) {\n        console.warn(consoleMessage);\n      } else {\n        console.log(consoleMessage);\n      }\n    }\n  }\n\n  error(\n    message: string,\n    errorOrContext?: Error | Record<string, unknown>,\n    context?: Record<string, unknown>\n  ): void {\n    const isError = errorOrContext instanceof Error;\n    this.writeLog({\n      timestamp: new Date().toISOString(),\n      level: LogLevel.ERROR,\n      message,\n      context: isError ? context : (errorOrContext as Record<string, unknown>),\n      error: isError ? errorOrContext : undefined,\n    });\n  }\n\n  warn(\n    message: string,\n    errorOrContext?: Error | Record<string, unknown>\n  ): void {\n    const isError = errorOrContext instanceof Error;\n    this.writeLog({\n      timestamp: new Date().toISOString(),\n      level: LogLevel.WARN,\n      message,\n      context: isError\n        ? undefined\n        : (errorOrContext as Record<string, unknown>),\n      error: isError ? errorOrContext : undefined,\n    });\n  }\n\n  info(message: string, context?: Record<string, unknown>): void {\n    this.writeLog({\n      timestamp: new Date().toISOString(),\n      level: LogLevel.INFO,\n      message,\n      context,\n    });\n  }\n\n  debug(message: string, context?: Record<string, unknown>): void {\n    this.writeLog({\n      timestamp: new Date().toISOString(),\n      level: LogLevel.DEBUG,\n      message,\n      context,\n    });\n  }\n}\n\n// Export singleton instance\nexport const logger = Logger.getInstance();\n"],
+  "mappings": "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",
+  "names": ["LogLevel"]
+}