minimal-agent 0.10.0 → 0.12.0

package/src/cli/wizards/providerWizard.tsx

@@ -0,0 +1,266 @@
+import { Box, Text, useInput } from 'ink';
+import React, { useState } from 'react';
+
+import { testModelConnection } from '../../config/configDiagnostics.js';
+import type { ApiFormat, ModelConfig } from '../../config/configFile.js';
+import { defaultMaxTokens } from '../../config/configFile.js';
+import { configService } from '../../config/configService.js';
+import { CONFIG_LIMITS, normalizeLimited } from '../../config/numericLimits.js';
+import { type FieldDef, FieldForm } from './fieldForm.js';
+import {
+  PRESETS,
+  findPresetIndex,
+  resolveContextWindow,
+} from './providerPresets.js';
+
+export type ExistingProvider = Pick<
+  ModelConfig,
+  | 'id'
+  | 'apiFormat'
+  | 'displayName'
+  | 'baseURL'
+  | 'apiKey'
+  | 'model'
+  | 'contextWindow'
+  | 'maxTokens'
+  | 'supportsVision'
+  | 'promptCache'
+>;
+
+interface Props {
+  existing?: ExistingProvider | null;
+  setAsBase?: boolean;
+  quick?: boolean;
+  onDone: () => void;
+  onCancel: () => void;
+}
+
+const numberValue = (value: unknown, fallback: number) => {
+  const parsed = Number(String(value ?? '').trim());
+  return Number.isFinite(parsed) ? parsed : fallback;
+};
+
+export function ProviderWizard({
+  existing,
+  setAsBase = true,
+  quick = false,
+  onDone,
+  onCancel,
+}: Props): JSX.Element {
+  const [phase, setPhase] = useState<'preset' | 'quick-choice' | 'fields'>(
+    'preset',
+  );
+  const [advanced, setAdvanced] = useState(false);
+  const [presetIndex, setPresetIndex] = useState(() => {
+    if (existing) {
+      const byUrl = PRESETS.findIndex(
+        (item) => item.baseURL === existing.baseURL,
+      );
+      if (byUrl >= 0) return byUrl;
+    }
+    return findPresetIndex(existing?.displayName);
+  });
+  const preset = PRESETS[presetIndex]!;
+
+  useInput((input, key) => {
+    if (phase === 'quick-choice') {
+      if (key.escape) setPhase('preset');
+      else if (key.upArrow || key.downArrow) setAdvanced((value) => !value);
+      else if (key.return) setPhase('fields');
+      return;
+    }
+    if (phase !== 'preset') return;
+    if (key.escape || (key.ctrl && input === 'c')) onCancel();
+    else if (key.upArrow)
+      setPresetIndex((index) => (index - 1 + PRESETS.length) % PRESETS.length);
+    else if (key.downArrow)
+      setPresetIndex((index) => (index + 1) % PRESETS.length);
+    else if (key.return) setPhase(quick ? 'quick-choice' : 'fields');
+  });
+
+  if (phase === 'preset')
+    return (
+      <Box flexDirection="column" paddingX={1}>
+        <Text color="cyan" bold>
+          {quick
+            ? '首次运行 · 配置基座模型'
+            : existing
+              ? '编辑模型'
+              : '添加模型'}
+        </Text>
+        <Text color="gray">↑↓ 选择服务商 · Enter 继续 · ESC 返回</Text>
+        <Box flexDirection="column" marginTop={1}>
+          {PRESETS.map((item, index) => (
+            <Text
+              key={item.name}
+              color={index === presetIndex ? 'cyan' : undefined}
+            >
+              {index === presetIndex ? '> ' : '  '}
+              {item.label}
+            </Text>
+          ))}
+        </Box>
+      </Box>
+    );
+
+  if (phase === 'quick-choice')
+    return (
+      <Box flexDirection="column" paddingX={1}>
+        <Text color="cyan" bold>
+          选择配置深度
+        </Text>
+        <Text color="gray">
+          快速配置使用服务商推荐的窗口、输出上限和缓存策略。
+        </Text>
+        <Box flexDirection="column" marginTop={1}>
+          <Text color={!advanced ? 'cyan' : undefined}>
+            {!advanced ? '> ' : '  '}快速配置（推荐）
+          </Text>
+          <Text color={advanced ? 'cyan' : undefined}>
+            {advanced ? '> ' : '  '}高级配置
+          </Text>
+        </Box>
+      </Box>
+    );
+
+  const defaultModel = existing?.model ?? preset.models[0] ?? '';
+  const defaultContext =
+    existing?.contextWindow ?? resolveContextWindow(preset, defaultModel);
+  const fields: FieldDef[] = [
+    {
+      key: 'baseURL',
+      label: 'API 完整端点地址',
+      type: 'text',
+      default: existing?.baseURL ?? preset.baseURL,
+    },
+    {
+      key: 'apiKey',
+      label: 'API Key',
+      type: 'password',
+      default: existing?.apiKey ?? '',
+      optional: !!existing,
+      hint: existing
+        ? '留空保持原凭据；清除凭据请在模型操作菜单执行'
+        : undefined,
+    },
+    {
+      key: 'model',
+      label: '模型 ID',
+      type: 'text',
+      default: defaultModel,
+      hint: preset.models.length
+        ? `常用：${preset.models.join('、')}`
+        : undefined,
+    },
+  ];
+  if (!quick || advanced)
+    fields.push(
+      {
+        key: 'displayName',
+        label: '显示名称',
+        type: 'text',
+        default: existing?.displayName ?? preset.label,
+        optional: true,
+      },
+      {
+        key: 'contextWindow',
+        label: '上下文窗口（Token）',
+        type: 'text',
+        default: String(defaultContext),
+      },
+      {
+        key: 'maxTokens',
+        label: '单次输出上限（留空使用推荐值）',
+        type: 'text',
+        default: existing?.maxTokens ? String(existing.maxTokens) : '',
+        optional: true,
+      },
+      {
+        key: 'promptCache',
+        label: 'Prompt Cache 模式',
+        type: 'select',
+        options: ['auto', 'session-key', 'disabled'],
+        default:
+          existing?.promptCache?.mode ?? preset.promptCacheMode ?? 'auto',
+      },
+    );
+
+  return (
+    <FieldForm
+      title={
+        quick
+          ? '快速模型配置'
+          : existing
+            ? '编辑模型 · 完整设置'
+            : '添加模型 · 完整设置'
+      }
+      fields={fields}
+      onSubmit={async (values) => {
+        const baseURL = String(values.baseURL ?? '').trim();
+        const apiKey = String(values.apiKey ?? existing?.apiKey ?? '').trim();
+        const model = String(values.model ?? '').trim();
+        if (!baseURL || !apiKey || !model)
+          throw new Error('Base URL、API Key 和模型 ID 均不能为空');
+        const contextWindow = normalizeLimited(
+          quick && !advanced
+            ? resolveContextWindow(preset, model)
+            : numberValue(values.contextWindow, defaultContext),
+          CONFIG_LIMITS.modelContextWindow,
+          defaultContext,
+        );
+        const rawMax =
+          quick && !advanced ? '' : String(values.maxTokens ?? '').trim();
+        const maxTokens = rawMax
+          ? normalizeLimited(
+              numberValue(rawMax, defaultMaxTokens(contextWindow)),
+              CONFIG_LIMITS.modelMaxTokens,
+              defaultMaxTokens(contextWindow),
+            )
+          : undefined;
+        const apiFormat: ApiFormat = existing?.apiFormat ?? 'openai';
+        const draft = {
+          apiFormat,
+          displayName:
+            quick && !advanced
+              ? preset.label
+              : String(values.displayName ?? '').trim() || undefined,
+          baseURL,
+          apiKey,
+          model,
+          contextWindow,
+          ...(maxTokens ? { maxTokens } : {}),
+          supportsVision: existing?.supportsVision !== false,
+          promptCache: {
+            mode:
+              quick && !advanced
+                ? (preset.promptCacheMode ?? 'auto')
+                : (values.promptCache as 'auto' | 'session-key' | 'disabled'),
+          },
+        };
+        const diagnostic = await testModelConnection(draft);
+        if (!diagnostic.ok) throw new Error(diagnostic.message);
+        if (existing) {
+          await configService.savePatch({
+            models: [{ op: 'update', id: existing.id, patch: draft }],
+            ...(setAsBase ? { baseModelId: existing.id } : {}),
+          });
+        } else {
+          const before = new Set(
+            (await configService.models()).map((entry) => entry.id),
+          );
+          const saved = await configService.savePatch({
+            models: [{ op: 'add', model: { ...draft, enabled: true } }],
+          });
+          const id = saved.config?.models.find(
+            (entry) => !before.has(entry.id),
+          )?.id;
+          if (!id) throw new Error('模型已保存，但无法确认模型 ID');
+          if (setAsBase && saved.config?.baseModelId !== id)
+            await configService.savePatch({ baseModelId: id });
+        }
+        onDone();
+      }}
+      onCancel={() => setPhase('preset')}
+    />
+  );
+}

package/src/cli/wizards/searchWizard.tsx

@@ -0,0 +1,47 @@
+/**
+ * ============================================================
+ *  src/cli/wizards/searchWizard.tsx —— 搜索引擎子向导
+ * ------------------------------------------------------------
+ *  单字段（Tavily API Key），基于通用 FieldForm。
+ * ============================================================
+ */
+
+import React from 'react';
+
+import { configService } from '../../config/configService.js';
+import { FieldForm } from './fieldForm.js';
+
+interface Props {
+  /** 已配置时预填，未配置传 null/undefined。 */
+  existing?: { apiKey: string } | null;
+  onDone: () => void;
+  onCancel: () => void;
+}
+
+export function SearchWizard({ existing, onDone, onCancel }: Props): JSX.Element {
+  return (
+    <FieldForm
+      title="配置搜索引擎（Tavily WebSearch）"
+      fields={[
+        {
+          key: 'apiKey',
+          label: 'Tavily API Key',
+          type: 'password',
+          default: existing?.apiKey ?? '',
+          optional: true,
+          hint: '留空 = 保持现有值不变。免费申请：https://tavily.com/',
+        },
+      ]}
+      onSubmit={async (values) => {
+        const apiKey = String(values.apiKey ?? '').trim();
+        if (!apiKey) {
+          onDone();
+          return;
+        }
+        await configService.savePatch({ tools: { webSearch: { apiKey } } });
+        onDone();
+      }}
+      onCancel={onCancel}
+    />
+  );
+}

package/src/cli/wizards/ttsWizard.js

@@ -22,13 +22,14 @@ export function TtsWizard({ existing, onDone, onCancel }) {
         ], onSubmit: async (values) => {
             const apiKey = String(values.apiKey ?? '').trim();
             const groupId = String(values.groupId ?? '').trim();
-            // 全空 = 用户只是走进来看了一眼，安静回菜单（与搜索/OpenRouter 向导一致）；
-            // 只填一项则交给 savePatch 的"缺一即抛错"校验如实报错。
+            // 全空 = 用户只是走进来看了一眼，安静回菜单；只填一项进入安全草稿桶。
             if (!apiKey && !groupId) {
                 onDone();
                 return;
             }
-            await configService.savePatch({ tools: { textToSpeech: { apiKey, groupId } } });
+            await configService.autosave('tools', {
+                tools: { textToSpeech: { apiKey, groupId } },
+            });
             onDone();
         }, onCancel: onCancel }));
 }

package/src/cli/wizards/ttsWizard.tsx

@@ -0,0 +1,61 @@
+/**
+ * ============================================================
+ *  src/cli/wizards/ttsWizard.tsx —— 语音合成子向导
+ * ------------------------------------------------------------
+ *  对应 ToolConfigs.textToSpeech（GenerateSpeech 工具，MiniMax T2A）。
+ *  apiKey + groupId 两个字段，基于通用 FieldForm。两者是否齐全的校验
+ *  直接复用 configService.savePatch 内部的 applyConfigPatch 校验
+ *  （缺一个会抛错，被 FieldForm 的 onSubmit 捕获展示，不在此重复校验）。
+ * ============================================================
+ */
+
+import React from 'react';
+
+import { configService } from '../../config/configService.js';
+import { FieldForm } from './fieldForm.js';
+
+interface Props {
+  existing?: { apiKey: string; groupId: string } | null;
+  onDone: () => void;
+  onCancel: () => void;
+}
+
+export function TtsWizard({ existing, onDone, onCancel }: Props): JSX.Element {
+  return (
+    <FieldForm
+      title="配置语音合成（GenerateSpeech 工具·MiniMax T2A）"
+      fields={[
+        {
+          key: 'apiKey',
+          label: 'MiniMax API Key',
+          type: 'password',
+          default: existing?.apiKey ?? '',
+          optional: true,
+          hint: '留空 = 保持现有值不变',
+        },
+        {
+          key: 'groupId',
+          label: 'MiniMax Group ID',
+          type: 'text',
+          default: existing?.groupId ?? '',
+          optional: true,
+          hint: '留空 = 保持现有值不变',
+        },
+      ]}
+      onSubmit={async (values) => {
+        const apiKey = String(values.apiKey ?? '').trim();
+        const groupId = String(values.groupId ?? '').trim();
+        // 全空 = 用户只是走进来看了一眼，安静回菜单；只填一项进入安全草稿桶。
+        if (!apiKey && !groupId) {
+          onDone();
+          return;
+        }
+        await configService.autosave('tools', {
+          tools: { textToSpeech: { apiKey, groupId } },
+        });
+        onDone();
+      }}
+      onCancel={onCancel}
+    />
+  );
+}

package/src/config/configDefaults.js

@@ -0,0 +1,25 @@
+/**
+ * 浏览器与 Node/Bun 都可安全加载的纯配置默认值。
+ * 不得在此模块引入 node:*、文件系统或运行时路径逻辑。
+ */
+export const DEFAULT_SUBAGENTS_CONFIG = {
+    enabled: true,
+    maxCallsPerTurn: 6,
+    maxConcurrent: 3,
+    defaultWriteIsolation: 'none',
+    timeoutMs: 1_800_000,
+    exploreMaxTurns: 50,
+    generalMaxTurns: 100,
+};
+export const DEFAULT_BROWSER_CONFIG = {
+    enabled: true,
+    profileId: 'default',
+    developerMode: false,
+    allowedCdpOrigins: [],
+};
+export const DEFAULT_COMPUTER_USE_CONFIG = {
+    enabled: true,
+    imagePolicy: 'single-adaptive',
+    maxImagePixels: 1_600_000,
+    observationFrames: 1,
+};

package/src/config/configDefaults.ts

@@ -0,0 +1,33 @@
+import type {
+  BrowserConfig,
+  ComputerUseConfig,
+  SubagentsConfig,
+} from './configFile.js';
+
+/**
+ * 浏览器与 Node/Bun 都可安全加载的纯配置默认值。
+ * 不得在此模块引入 node:*、文件系统或运行时路径逻辑。
+ */
+export const DEFAULT_SUBAGENTS_CONFIG: SubagentsConfig = {
+  enabled: true,
+  maxCallsPerTurn: 6,
+  maxConcurrent: 3,
+  defaultWriteIsolation: 'none',
+  timeoutMs: 1_800_000,
+  exploreMaxTurns: 50,
+  generalMaxTurns: 100,
+};
+
+export const DEFAULT_BROWSER_CONFIG: BrowserConfig = {
+  enabled: true,
+  profileId: 'default',
+  developerMode: false,
+  allowedCdpOrigins: [],
+};
+
+export const DEFAULT_COMPUTER_USE_CONFIG: ComputerUseConfig = {
+  enabled: true,
+  imagePolicy: 'single-adaptive',
+  maxImagePixels: 1_600_000,
+  observationFrames: 1,
+};

package/src/config/configDiagnostics.js

@@ -0,0 +1,117 @@
+import { configService } from './configService.js';
+function providerFromModel(model) {
+    return {
+        name: model.displayName ?? model.model,
+        apiFormat: model.apiFormat,
+        baseURL: model.baseURL,
+        apiKey: model.apiKey,
+        model: model.model,
+        contextWindow: model.contextWindow,
+        ...(model.maxTokens ? { maxTokens: model.maxTokens } : {}),
+        supportsVision: model.supportsVision !== false,
+        promptCache: model.promptCache ?? { mode: 'auto' },
+    };
+}
+export async function testModelConnection(model, timeoutMs = 15_000) {
+    if (!model.baseURL.trim() || !model.apiKey.trim() || !model.model.trim()) {
+        return {
+            ok: false,
+            code: 'missing-config',
+            message: '缺少 Base URL、模型 ID 或 API Key',
+        };
+    }
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const { chat } = await import('../llm/client.js');
+        let received = false;
+        for await (const event of chat({
+            provider: providerFromModel(model),
+            messages: [{ role: 'user', content: '请只回复 OK' }],
+            tools: [],
+            signal: controller.signal,
+        })) {
+            if (event.type === 'text_delta' && event.delta.trim())
+                received = true;
+        }
+        return received
+            ? { ok: true, code: 'ok', message: '连接正常' }
+            : {
+                ok: false,
+                code: 'invalid-response',
+                message: '服务已响应，但没有返回文本',
+            };
+    }
+    catch (error) {
+        return error.name === 'AbortError'
+            ? { ok: false, code: 'timeout', message: '连接超时' }
+            : {
+                ok: false,
+                code: 'network',
+                message: '连接失败，请检查地址、模型名称和凭据',
+            };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function testConfiguredModel(modelId, service = configService) {
+    const model = await service.model(modelId);
+    return model
+        ? testModelConnection(model)
+        : { ok: false, code: 'missing-config', message: '模型不存在或已被删除' };
+}
+export async function testAdvisorConnection(service = configService) {
+    const advisor = await service.advisor();
+    if (!advisor)
+        return {
+            ok: false,
+            code: 'missing-config',
+            message: '尚未完整配置顾问模型',
+        };
+    const result = await testConfiguredModel(advisor.modelId, service);
+    return {
+        ...result,
+        message: result.ok ? '顾问模型连接正常' : result.message,
+    };
+}
+export async function testToolConnection(tool, service = configService) {
+    const config = await service.tool(tool);
+    if (!config)
+        return { ok: false, code: 'missing-config', message: '尚未完整配置' };
+    if (tool !== 'webSearch')
+        return {
+            ok: true,
+            code: 'ok',
+            message: '配置完整，将在下一次工具调用时使用',
+        };
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 10_000);
+    try {
+        const response = await fetch('https://api.tavily.com/search', {
+            method: 'POST',
+            signal: controller.signal,
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                api_key: config.apiKey,
+                query: 'KakadeAI connection test',
+                max_results: 1,
+            }),
+        });
+        return response.ok
+            ? { ok: true, code: 'ok', message: 'Tavily 连接正常' }
+            : {
+                ok: false,
+                code: 'network',
+                message: `Tavily 返回 HTTP ${response.status}`,
+            };
+    }
+    catch (error) {
+        return error.name === 'AbortError'
+            ? { ok: false, code: 'timeout', message: '连接超时' }
+            : { ok: false, code: 'network', message: '连接失败，请检查网络和凭据' };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}