@geminilight/mindos 0.5.21 → 0.5.23

package/app/components/settings/SettingsContent.tsx

@@ -0,0 +1,343 @@
+'use client';
+
+import { useEffect, useState, useCallback, useRef } from 'react';
+import { Settings, Loader2, AlertCircle, CheckCircle2, RotateCcw, Sparkles, Palette, Database, RefreshCw, Plug, X } from 'lucide-react';
+import { useLocale } from '@/lib/LocaleContext';
+import { apiFetch } from '@/lib/api';
+import type { AiSettings, AgentSettings, SettingsData, Tab } from './types';
+import { AiTab } from './AiTab';
+import { AppearanceTab } from './AppearanceTab';
+import { KnowledgeTab } from './KnowledgeTab';
+import { SyncTab } from './SyncTab';
+import { McpTab } from './McpTab';
+
+interface SettingsContentProps {
+  visible: boolean;
+  initialTab?: Tab;
+  variant: 'modal' | 'panel';
+  onClose?: () => void;
+}
+
+export default function SettingsContent({ visible, initialTab, variant, onClose }: SettingsContentProps) {
+  const [tab, setTab] = useState<Tab>('ai');
+  const [data, setData] = useState<SettingsData | null>(null);
+  const [saving, setSaving] = useState(false);
+  const [status, setStatus] = useState<'idle' | 'saved' | 'error' | 'load-error'>('idle');
+  const { t, locale, setLocale } = useLocale();
+  const saveTimer = useRef<ReturnType<typeof setTimeout>>(undefined);
+  const dataLoaded = useRef(false);
+
+  const [font, setFont] = useState('lora');
+  const [contentWidth, setContentWidth] = useState('780px');
+  const [dark, setDark] = useState(true);
+
+  const isPanel = variant === 'panel';
+
+  // Init data when becoming visible
+  const prevVisibleRef = useRef(false);
+  useEffect(() => {
+    const justOpened = isPanel
+      ? (visible && !prevVisibleRef.current)
+      : visible;
+
+    if (justOpened) {
+      apiFetch<SettingsData>('/api/settings').then(d => { setData(d); dataLoaded.current = true; }).catch(() => setStatus('load-error'));
+      setFont(localStorage.getItem('prose-font') ?? 'lora');
+      setContentWidth(localStorage.getItem('content-width') ?? '780px');
+      const stored = localStorage.getItem('theme');
+      setDark(stored ? stored === 'dark' : window.matchMedia('(prefers-color-scheme: dark)').matches);
+      setStatus('idle');
+    }
+    if (!visible) { dataLoaded.current = false; }
+    prevVisibleRef.current = visible;
+  }, [visible, isPanel]);
+
+  useEffect(() => {
+    if (visible && initialTab) setTab(initialTab);
+  }, [visible, initialTab]);
+
+  useEffect(() => {
+    const fontMap: Record<string, string> = {
+      'lora': "'Lora', Georgia, serif",
+      'ibm-plex-sans': "'IBM Plex Sans', sans-serif",
+      'geist': 'var(--font-geist-sans), sans-serif',
+      'ibm-plex-mono': "'IBM Plex Mono', monospace",
+    };
+    document.documentElement.style.setProperty('--prose-font-override', fontMap[font] ?? '');
+    localStorage.setItem('prose-font', font);
+  }, [font]);
+
+  useEffect(() => {
+    document.documentElement.style.setProperty('--content-width-override', contentWidth);
+    localStorage.setItem('content-width', contentWidth);
+  }, [contentWidth]);
+
+  // Esc to close — modal only
+  useEffect(() => {
+    if (variant !== 'modal' || !visible || !onClose) return;
+    const handler = (e: KeyboardEvent) => { if (e.key === 'Escape') onClose(); };
+    window.addEventListener('keydown', handler);
+    return () => window.removeEventListener('keydown', handler);
+  }, [variant, visible, onClose]);
+
+  const doSave = useCallback(async (d: SettingsData) => {
+    setSaving(true);
+    try {
+      await apiFetch('/api/settings', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ ai: d.ai, agent: d.agent, mindRoot: d.mindRoot, webPassword: d.webPassword, authToken: d.authToken }),
+      });
+      setStatus('saved');
+      setTimeout(() => setStatus('idle'), 2500);
+    } catch {
+      setStatus('error');
+      setTimeout(() => setStatus('idle'), 2500);
+    } finally {
+      setSaving(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    if (!data || !dataLoaded.current) return;
+    clearTimeout(saveTimer.current);
+    saveTimer.current = setTimeout(() => doSave(data), 800);
+    return () => clearTimeout(saveTimer.current);
+  }, [data, doSave]);
+
+  const updateAi = useCallback((patch: Partial<AiSettings>) => {
+    setData(d => d ? { ...d, ai: { ...d.ai, ...patch } } : d);
+  }, []);
+
+  const updateAgent = useCallback((patch: Partial<AgentSettings>) => {
+    setData(d => d ? { ...d, agent: { ...(d.agent ?? {}), ...patch } } : d);
+  }, []);
+
+  const restoreFromEnv = useCallback(async () => {
+    if (!data) return;
+    const defaults: AiSettings = {
+      provider: 'anthropic',
+      providers: { anthropic: { apiKey: '', model: '' }, openai: { apiKey: '', model: '', baseUrl: '' } },
+    };
+    setData(d => d ? { ...d, ai: defaults } : d);
+    const DEBOUNCE_DELAY = 800;
+    const SAVE_OPERATION_TIME = 500;
+    setTimeout(() => {
+      apiFetch<SettingsData>('/api/settings').then(d => { setData(d); }).catch(() => setStatus('error'));
+    }, DEBOUNCE_DELAY + SAVE_OPERATION_TIME);
+  }, [data]);
+
+  const env = data?.envOverrides ?? {};
+  const iconSize = isPanel ? 12 : 13;
+
+  const TABS: { id: Tab; label: string; icon: React.ReactNode }[] = [
+    { id: 'ai', label: t.settings.tabs.ai, icon: <Sparkles size={iconSize} /> },
+    { id: 'mcp', label: t.settings.tabs.mcp ?? 'MCP & Skills', icon: <Plug size={iconSize} /> },
+    { id: 'knowledge', label: t.settings.tabs.knowledge, icon: <Settings size={iconSize} /> },
+    { id: 'sync', label: t.settings.tabs.sync ?? 'Sync', icon: <RefreshCw size={iconSize} /> },
+    { id: 'appearance', label: t.settings.tabs.appearance, icon: <Palette size={iconSize} /> },
+  ];
+
+  const activeTabLabel = TABS.find(t2 => t2.id === tab)?.label ?? '';
+
+  /* ── Shared content & footer ── */
+  const renderContent = () => (
+    <div className={`flex-1 overflow-y-auto min-h-0 ${isPanel ? 'px-4 py-4 space-y-4' : 'px-5 py-5 space-y-5'}`}>
+      {status === 'load-error' && (tab === 'ai' || tab === 'knowledge') ? (
+        <div className="flex flex-col items-center gap-2 py-8 text-center">
+          <AlertCircle size={isPanel ? 18 : 20} className="text-destructive" />
+          <p className={`${isPanel ? 'text-xs' : 'text-sm'} text-destructive font-medium`}>Failed to load settings</p>
+          {!isPanel && <p className="text-xs text-muted-foreground">Check that the server is running and AUTH_TOKEN is configured correctly.</p>}
+        </div>
+      ) : !data && tab !== 'appearance' && tab !== 'mcp' && tab !== 'sync' ? (
+        <div className="flex justify-center py-8">
+          <Loader2 size={isPanel ? 16 : 18} className="animate-spin text-muted-foreground" />
+        </div>
+      ) : (
+        <>
+          {tab === 'ai' && data?.ai && <AiTab data={data} updateAi={updateAi} updateAgent={updateAgent} t={t} />}
+          {tab === 'appearance' && <AppearanceTab font={font} setFont={setFont} contentWidth={contentWidth} setContentWidth={setContentWidth} dark={dark} setDark={setDark} locale={locale} setLocale={setLocale} t={t} />}
+          {tab === 'knowledge' && data && <KnowledgeTab data={data} setData={setData} t={t} />}
+          {tab === 'sync' && <SyncTab t={t} />}
+          {tab === 'mcp' && <McpTab t={t} />}
+        </>
+      )}
+    </div>
+  );
+
+  const renderFooter = () => (
+    (tab === 'ai' || tab === 'knowledge') ? (
+      <div className={`${isPanel ? 'px-4 py-2' : 'px-5 py-2.5'} border-t border-border shrink-0 flex items-center justify-between`}>
+        <div className="flex items-center gap-3">
+          {tab === 'ai' && Object.values(env).some(Boolean) && (
+            <button
+              onClick={restoreFromEnv}
+              disabled={saving || !data}
+              className={`flex items-center gap-1.5 ${isPanel ? 'px-2.5 py-1 text-[11px] rounded-md' : 'px-3 py-1 text-xs rounded-lg'} border border-border text-muted-foreground hover:text-foreground hover:bg-muted disabled:opacity-40 disabled:cursor-not-allowed transition-colors`}
+            >
+              <RotateCcw size={isPanel ? 11 : 12} />
+              {t.settings.ai.restoreFromEnv}
+            </button>
+          )}
+          {tab === 'knowledge' && (
+            <a
+              href="/setup?force=1"
+              className={`flex items-center gap-1.5 ${isPanel ? 'px-2.5 py-1 text-[11px] rounded-md' : 'px-3 py-1 text-xs rounded-lg'} border border-border text-muted-foreground hover:text-foreground hover:bg-muted transition-colors`}
+            >
+              <RotateCcw size={isPanel ? 11 : 12} />
+              {t.settings.reconfigure}
+            </a>
+          )}
+        </div>
+        {!isPanel && (
+          <div className="flex items-center gap-1.5 text-xs" role="status" aria-live="polite">
+            {saving && <><Loader2 size={12} className="animate-spin text-muted-foreground" /><span className="text-muted-foreground">{t.settings.save}...</span></>}
+            {status === 'saved' && <><CheckCircle2 size={12} className="text-success" /><span className="text-success">{t.settings.saved}</span></>}
+            {status === 'error' && <><AlertCircle size={12} className="text-destructive" /><span className="text-destructive">{t.settings.saveFailed}</span></>}
+          </div>
+        )}
+      </div>
+    ) : null
+  );
+
+  /* ── Panel variant: unchanged (horizontal tabs) ── */
+  if (isPanel) {
+    return (
+      <>
+        <div className="flex items-center justify-between px-4 py-3 border-b border-border shrink-0">
+          <div className="flex items-center gap-2 text-sm font-medium text-foreground">
+            <Settings size={14} className="text-muted-foreground" />
+            <span className="text-xs font-medium text-muted-foreground uppercase tracking-wider font-display">Settings</span>
+          </div>
+          <div className="flex items-center gap-1.5">
+            <div className="flex items-center gap-1.5 text-[10px]" role="status" aria-live="polite">
+              {saving && <Loader2 size={10} className="animate-spin text-muted-foreground" />}
+              {status === 'saved' && <CheckCircle2 size={10} className="text-success" />}
+              {status === 'error' && <AlertCircle size={10} className="text-destructive" />}
+            </div>
+          </div>
+        </div>
+        <div className="flex border-b border-border px-3 shrink-0 overflow-x-auto scrollbar-none gap-0">
+          {TABS.map(tabItem => (
+            <button
+              key={tabItem.id}
+              onClick={() => setTab(tabItem.id)}
+              className={`flex items-center gap-1 px-2 py-2 text-[11px] font-medium transition-colors border-b-2 -mb-px whitespace-nowrap ${
+                tab === tabItem.id
+                  ? 'border-amber-500 text-foreground'
+                  : 'border-transparent text-muted-foreground hover:text-foreground'
+              }`}
+            >
+              {tabItem.icon}
+              {tabItem.label}
+            </button>
+          ))}
+        </div>
+        {renderContent()}
+        {renderFooter()}
+      </>
+    );
+  }
+
+  /* ── Modal variant ── */
+  return (
+    <>
+      {/* Mobile: original vertical layout */}
+      <div className="flex flex-col h-full md:hidden">
+        {/* Mobile header */}
+        <div className="flex items-center justify-between px-4 py-3 border-b border-border shrink-0">
+          <div className="flex justify-center pt-2 pb-0 absolute top-0 left-1/2 -translate-x-1/2">
+            <div className="w-8 h-1 rounded-full bg-muted-foreground/20" />
+          </div>
+          <div className="flex items-center gap-2 text-sm font-medium text-foreground">
+            <Settings size={15} className="text-muted-foreground" />
+            <span className="font-display">{t.settings.title}</span>
+          </div>
+          <div className="flex items-center gap-1.5">
+            <div className="flex items-center gap-1.5 text-[10px]" role="status" aria-live="polite">
+              {saving && <Loader2 size={12} className="animate-spin text-muted-foreground" />}
+              {status === 'saved' && <><CheckCircle2 size={12} className="text-success" /><span className="text-success">{t.settings.saved}</span></>}
+              {status === 'error' && <><AlertCircle size={12} className="text-destructive" /><span className="text-destructive">{t.settings.saveFailed}</span></>}
+            </div>
+            {onClose && (
+              <button onClick={onClose} className="p-1 rounded hover:bg-muted text-muted-foreground hover:text-foreground transition-colors">
+                <X size={15} />
+              </button>
+            )}
+          </div>
+        </div>
+        {/* Mobile horizontal tabs */}
+        <div className="flex border-b border-border px-4 shrink-0 overflow-x-auto scrollbar-none gap-0">
+          {TABS.map(tabItem => (
+            <button
+              key={tabItem.id}
+              onClick={() => setTab(tabItem.id)}
+              className={`flex items-center gap-1.5 px-3 py-2.5 text-xs font-medium transition-colors border-b-2 -mb-px whitespace-nowrap ${
+                tab === tabItem.id
+                  ? 'border-amber-500 text-foreground'
+                  : 'border-transparent text-muted-foreground hover:text-foreground'
+              }`}
+            >
+              {tabItem.icon}
+              {tabItem.label}
+            </button>
+          ))}
+        </div>
+        {renderContent()}
+        {renderFooter()}
+      </div>
+
+      {/* Desktop: left-right layout */}
+      <div className="hidden md:flex flex-row h-full min-h-0">
+        {/* Left sidebar — vertical tabs */}
+        <div className="w-[180px] shrink-0 border-r border-border flex flex-col">
+          <div className="flex items-center gap-2 px-4 py-3 border-b border-border">
+            <Settings size={15} className="text-muted-foreground" />
+            <span className="text-sm font-medium font-display text-foreground">{t.settings.title}</span>
+          </div>
+          <nav className="flex-1 overflow-y-auto py-1.5">
+            {TABS.map(tabItem => (
+              <button
+                key={tabItem.id}
+                onClick={() => setTab(tabItem.id)}
+                className={`flex items-center gap-2 w-full px-4 py-2 text-xs font-medium transition-colors relative ${
+                  tab === tabItem.id
+                    ? 'text-foreground bg-muted'
+                    : 'text-muted-foreground hover:text-foreground hover:bg-muted/50'
+                }`}
+              >
+                {tab === tabItem.id && (
+                  <div className="absolute left-0 top-1 bottom-1 w-[3px] rounded-r-full bg-amber-500" />
+                )}
+                {tabItem.icon}
+                {tabItem.label}
+              </button>
+            ))}
+          </nav>
+        </div>
+
+        {/* Right content area */}
+        <div className="flex-1 flex flex-col min-w-0 min-h-0">
+          {/* Right header: tab title + status + close */}
+          <div className="flex items-center justify-between px-5 py-3 border-b border-border shrink-0">
+            <span className="text-sm font-medium text-foreground font-display">{activeTabLabel}</span>
+            <div className="flex items-center gap-1.5">
+              <div className="flex items-center gap-1.5 text-[10px]" role="status" aria-live="polite">
+                {saving && <Loader2 size={12} className="animate-spin text-muted-foreground" />}
+                {status === 'saved' && <><CheckCircle2 size={12} className="text-success" /><span className="text-success">{t.settings.saved}</span></>}
+                {status === 'error' && <><AlertCircle size={12} className="text-destructive" /><span className="text-destructive">{t.settings.saveFailed}</span></>}
+              </div>
+              {onClose && (
+                <button onClick={onClose} className="p-1 rounded hover:bg-muted text-muted-foreground hover:text-foreground transition-colors">
+                  <X size={15} />
+                </button>
+              )}
+            </div>
+          </div>
+          {renderContent()}
+          {renderFooter()}
+        </div>
+      </div>
+    </>
+  );
+}

package/app/components/settings/types.ts

@@ -33,7 +33,7 @@ export interface SettingsData {
   envValues?: Record<string, string>;
 }
 
-export type Tab = 'ai' | 'appearance' | 'knowledge' | 'mcp' | 'plugins' | 'sync';
+export type Tab = 'ai' | 'appearance' | 'knowledge' | 'mcp' | 'sync';
 
 export const CONTENT_WIDTHS = [
   { value: '680px', label: 'Narrow (680px)' },

package/app/components/setup/index.tsx

@@ -102,20 +102,6 @@ async function installAgents(
   return updated;
 }
 
-/** Phase 3: Install skill to agents. Returns result. */
-async function installSkill(
-  template: string,
-  agentKeys: string[],
-): Promise<{ ok?: boolean; skill?: string; error?: string }> {
-  const skillName = template === 'zh' ? 'mindos-zh' : 'mindos';
-  const res = await fetch('/api/mcp/install-skill', {
-    method: 'POST',
-    headers: { 'Content-Type': 'application/json' },
-    body: JSON.stringify({ skill: skillName, agents: agentKeys }),
-  });
-  return await res.json();
-}
-
 // ─── Component ───────────────────────────────────────────────────────────────
 
 export default function SetupWizard() {
@@ -318,15 +304,8 @@ export default function SetupWizard() {
       }
     }
 
-    // Phase 3: Install skill
-    setSetupPhase('skill');
-    try {
-      const skillData = await installSkill(state.template, agentKeys);
-      setSkillInstallResult(skillData);
-    } catch (e) {
-      console.warn('[SetupWizard] skill install failed:', e);
-      setSkillInstallResult({ error: 'Failed to install skill' });
-    }
+    // Phase 3: Skill is now built into SKILL.md — no install needed.
+    // user-skill-rules.md will be created on first preference capture.
 
     setSubmitting(false);
     setCompleted(true);

package/app/hooks/useResizeDrag.ts

@@ -0,0 +1,78 @@
+'use client';
+
+import { useCallback, useRef } from 'react';
+
+export interface UseResizeDragOptions {
+  /** Current width */
+  width: number;
+  /** Min allowed width */
+  minWidth: number;
+  /** Max allowed width (absolute) */
+  maxWidth: number;
+  /** Max width as ratio of viewport */
+  maxWidthRatio: number;
+  /** 'right' = right-edge drag (mouse right → wider), 'left' = left-edge drag (mouse left → wider) */
+  direction: 'right' | 'left';
+  /** Skip if true (e.g. maximized state) */
+  disabled?: boolean;
+  /** Called on every mousemove with new width */
+  onResize: (width: number) => void;
+  /** Called on mouseup with final width */
+  onResizeEnd: (width: number) => void;
+}
+
+/**
+ * Shared drag-resize logic for panel edges.
+ * Returns a mousedown handler for the resize handle element.
+ */
+export function useResizeDrag({
+  width,
+  minWidth,
+  maxWidth,
+  maxWidthRatio,
+  direction,
+  disabled,
+  onResize,
+  onResizeEnd,
+}: UseResizeDragOptions) {
+  const dragging = useRef(false);
+  const startX = useRef(0);
+  const startWidth = useRef(0);
+  const latestWidthRef = useRef(width);
+  latestWidthRef.current = width;
+
+  const handleMouseDown = useCallback((e: React.MouseEvent) => {
+    if (disabled) return;
+    e.preventDefault();
+    dragging.current = true;
+    startX.current = e.clientX;
+    startWidth.current = width;
+
+    document.body.classList.add('select-none');
+    document.body.style.cursor = 'col-resize';
+
+    const onMouseMove = (ev: MouseEvent) => {
+      if (!dragging.current) return;
+      const delta = direction === 'right'
+        ? ev.clientX - startX.current
+        : startX.current - ev.clientX;
+      const maxW = Math.min(maxWidth, window.innerWidth * maxWidthRatio);
+      const newWidth = Math.round(Math.max(minWidth, Math.min(maxW, startWidth.current + delta)));
+      onResize(newWidth);
+    };
+
+    const onMouseUp = () => {
+      dragging.current = false;
+      document.body.classList.remove('select-none');
+      document.body.style.cursor = '';
+      onResizeEnd(latestWidthRef.current);
+      document.removeEventListener('mousemove', onMouseMove);
+      document.removeEventListener('mouseup', onMouseUp);
+    };
+
+    document.addEventListener('mousemove', onMouseMove);
+    document.addEventListener('mouseup', onMouseUp);
+  }, [width, minWidth, maxWidth, maxWidthRatio, direction, disabled, onResize, onResizeEnd]);
+
+  return handleMouseDown;
+}

package/app/instrumentation.ts

@@ -7,9 +7,14 @@ export async function register() {
       const configPath = join(homedir(), '.mindos', 'config.json');
       const config = JSON.parse(readFileSync(configPath, 'utf-8'));
       if (config.sync?.enabled && config.mindRoot) {
-        // Resolve absolute path to avoid Turbopack bundling issues
+        // Turbopack statically analyzes ALL forms of require/import — including
+        // createRequire() calls. The only way to load a runtime-computed path
+        // is to hide the require call inside a Function constructor, which is
+        // opaque to bundler static analysis.
         const syncModule = resolve(process.cwd(), '..', 'bin', 'lib', 'sync.js');
-        const { startSyncDaemon } = await import(/* webpackIgnore: true */ syncModule);
+        // eslint-disable-next-line @typescript-eslint/no-implied-eval
+        const dynamicRequire = new Function('id', 'return require(id)') as (id: string) => any;
+        const { startSyncDaemon } = dynamicRequire(syncModule);
         await startSyncDaemon(config.mindRoot);
       }
     } catch {

package/app/lib/agent/log.ts

@@ -11,6 +11,7 @@ interface AgentOpEntry {
   params: Record<string, unknown>;
   result: 'ok' | 'error';
   message?: string;
+  durationMs?: number;
 }
 
 /**

package/app/lib/agent/model.ts

@@ -22,20 +22,28 @@ export function getModelConfig(): {
   if (cfg.provider === 'openai') {
     const modelName = cfg.openaiModel;
     let model: Model<any>;
-    let apiVariant: string = 'openai-responses'; // Default to responses API
 
-    // Allow customization of API variant if using custom endpoint
-    // Check if config specifies an alternative API type (for non-standard endpoints)
+    // API variant: 'openai-completions' = /chat/completions (widest compatibility),
+    // 'openai-responses' = /responses (OpenAI native). Custom proxies (baseUrl set)
+    // almost always only support chat completions, so default to that when baseUrl is set.
+    const hasCustomBase = !!cfg.openaiBaseUrl;
+    const defaultApi = hasCustomBase ? 'openai-completions' : 'openai-responses';
     const customApiVariant = (cfg as any).openaiApiVariant; // May exist in extended config
 
     try {
-      model = piGetModel('openai', modelName as any);
+      const resolved = piGetModel('openai', modelName as any);
+      if (!resolved) throw new Error('Model not in registry');
+      model = resolved;
+      // If user has a custom baseUrl, override API to completions for compatibility
+      if (hasCustomBase && !customApiVariant) {
+        model = { ...model, api: defaultApi };
+      }
     } catch {
       // Model not in pi-ai registry — construct manually for custom/proxy endpoints
       model = {
         id: modelName,
         name: modelName,
-        api: (customApiVariant ?? apiVariant) as any,
+        api: (customApiVariant ?? defaultApi) as any,
         provider: 'openai',
         baseUrl: 'https://api.openai.com/v1',
         reasoning: false,
@@ -46,10 +54,23 @@ export function getModelConfig(): {
       };
     }
 
-    // Override baseUrl if user configured a custom endpoint
-    if (cfg.openaiBaseUrl) {
-      model = { ...model, baseUrl: cfg.openaiBaseUrl };
-      // Also allow API variant override for custom endpoints
+    // For custom proxy endpoints, set conservative compat flags.
+    // Most proxies (Azure, Bedrock relays, corporate gateways) only support
+    // a subset of OpenAI's features. These defaults prevent silent failures.
+    if (hasCustomBase) {
+      model = {
+        ...model,
+        baseUrl: cfg.openaiBaseUrl,
+        compat: {
+          ...(model as any).compat,
+          supportsStore: false,
+          supportsDeveloperRole: false,
+          supportsReasoningEffort: false,
+          supportsUsageInStreaming: false,
+          supportsStrictMode: false,
+          maxTokensField: 'max_tokens' as const,
+        },
+      };
       if (customApiVariant) {
         model = { ...model, api: customApiVariant };
       }
@@ -63,7 +84,9 @@ export function getModelConfig(): {
   let model: Model<any>;
 
   try {
-    model = piGetModel('anthropic', modelName as any);
+    const resolved = piGetModel('anthropic', modelName as any);
+    if (!resolved) throw new Error('Model not in registry');
+    model = resolved;
   } catch {
     // Unknown Anthropic model — construct manually
     model = {

package/app/lib/api.ts

@@ -8,10 +8,12 @@
 
 export class ApiError extends Error {
   status: number;
-  constructor(message: string, status: number) {
+  code?: string;
+  constructor(message: string, status: number, code?: string) {
     super(message);
     this.name = 'ApiError';
     this.status = status;
+    this.code = code;
   }
 }
 
@@ -41,11 +43,18 @@ export async function apiFetch<T>(url: string, opts: ApiFetchOptions = {}): Prom
 
     if (!res.ok) {
       let msg = `Request failed (${res.status})`;
+      let code: string | undefined;
       try {
         const body = await res.json();
-        if (body?.error) msg = body.error;
+        // Support structured { ok: false, error: { code, message } } envelope
+        if (body?.error?.code && body?.error?.message) {
+          msg = body.error.message;
+          code = body.error.code;
+        } else if (body?.error) {
+          msg = typeof body.error === 'string' ? body.error : body.error.message ?? msg;
+        }
       } catch { /* non-JSON error body */ }
-      throw new ApiError(msg, res.status);
+      throw new ApiError(msg, res.status, code);
     }
 
     return (await res.json()) as T;

package/app/lib/core/csv.ts

@@ -1,6 +1,7 @@
 import fs from 'fs';
 import path from 'path';
 import { resolveSafe } from './security';
+import { MindOSError, ErrorCodes } from '@/lib/errors';
 
 /**
  * Appends a single row to a CSV file with RFC 4180 escaping.
@@ -9,7 +10,7 @@ import { resolveSafe } from './security';
  */
 export function appendCsvRow(mindRoot: string, filePath: string, row: string[]): { newRowCount: number } {
   const resolved = resolveSafe(mindRoot, filePath);
-  if (!filePath.endsWith('.csv')) throw new Error('Only .csv files support row append');
+  if (!filePath.endsWith('.csv')) throw new MindOSError(ErrorCodes.INVALID_FILE_TYPE, 'Only .csv files support row append', { filePath });
 
   const escaped = row.map((cell) => {
     if (cell.includes(',') || cell.includes('"') || cell.includes('\n')) {