minimal-agent 0.10.0 → 0.12.0

package/src/cli/configMenu.tsx

@@ -0,0 +1,521 @@
+import { Box, Text, useInput } from 'ink';
+import React, { useCallback, useEffect, useState } from 'react';
+
+import {
+  testAdvisorConnection,
+  testConfiguredModel,
+  testToolConnection,
+} from '../config/configDiagnostics.js';
+import type { MinimalAgentConfig, ModelConfig } from '../config/configFile.js';
+import { configService } from '../config/configService.js';
+import type { Provider } from '../types.js';
+import { AgentRuntimeWizard } from './wizards/agentRuntimeWizard.js';
+import { BrowserWizard } from './wizards/browserWizard.js';
+import { ContextAdvisorWizard } from './wizards/contextAdvisorWizard.js';
+import { ImageWizard } from './wizards/imageWizard.js';
+import { OpenRouterWizard } from './wizards/openRouterWizard.js';
+import { ProviderWizard } from './wizards/providerWizard.js';
+import { SearchWizard } from './wizards/searchWizard.js';
+import { TtsWizard } from './wizards/ttsWizard.js';
+
+type Screen =
+  | 'main'
+  | 'model-context'
+  | 'models'
+  | 'model-actions'
+  | 'delete-model'
+  | 'provider'
+  | 'context-advisor'
+  | 'tools'
+  | 'agent-runtime'
+  | 'search'
+  | 'image'
+  | 'openrouter'
+  | 'tts'
+  | 'browser';
+
+interface Props {
+  mode?: 'first-run' | 'reconfigure';
+  onDone: (provider?: Provider) => void;
+}
+
+const MAIN = ['模型与上下文', '工具与代理', '浏览器', '完成并返回聊天'];
+const MODEL_CONTEXT = ['模型管理', '压缩与顾问', '测试顾问连接', '返回'];
+const TOOLS = [
+  '电脑操作与子代理',
+  'Tavily 搜索',
+  '图片生成',
+  'OpenRouter',
+  'MiniMax 语音',
+  '返回',
+];
+const MODEL_ACTIONS = [
+  '编辑完整设置',
+  '测试连接',
+  '设为基座模型',
+  '启用/停用',
+  '清除 API Key',
+  '删除模型',
+  '返回',
+];
+
+function MenuList({
+  title,
+  items,
+  index,
+  hint,
+}: {
+  title: string;
+  items: string[];
+  index: number;
+  hint?: string;
+}): JSX.Element {
+  return (
+    <Box flexDirection="column" paddingX={1}>
+      <Text color="cyan" bold>
+        {title}
+      </Text>
+      <Text color="gray">{hint ?? '↑↓ 选择 · Enter 确认 · ESC 返回'}</Text>
+      <Box flexDirection="column" marginTop={1}>
+        {items.map((item, i) => (
+          <Text key={item} color={i === index ? 'cyan' : undefined}>
+            {i === index ? '> ' : '  '}
+            {item}
+          </Text>
+        ))}
+      </Box>
+    </Box>
+  );
+}
+
+export function ConfigMenu({ onDone }: Props): JSX.Element {
+  const [screen, setScreen] = useState<Screen>('main');
+  const [config, setConfig] = useState<MinimalAgentConfig | null>(null);
+  const [readOnly, setReadOnly] = useState(false);
+  const [index, setIndex] = useState(0);
+  const [editingModelId, setEditingModelId] = useState<string | null>(null);
+  const [message, setMessage] = useState<string | null>(null);
+  const [busy, setBusy] = useState(false);
+
+  const refresh = useCallback(async () => {
+    const snapshot = await configService.reload();
+    setConfig(snapshot.config);
+    setReadOnly(snapshot.readOnly);
+  }, []);
+  useEffect(() => {
+    void refresh();
+  }, [refresh]);
+  const navigate = (next: Screen) => {
+    setIndex(0);
+    setMessage(null);
+    setScreen(next);
+  };
+  const mutate = useCallback(
+    async (
+      operation: () => Promise<unknown>,
+      success: string,
+    ): Promise<boolean> => {
+      setBusy(true);
+      setMessage(null);
+      try {
+        await operation();
+        await refresh();
+        setMessage(success);
+        return true;
+      } catch (error) {
+        setMessage((error as Error).message || '操作失败');
+        return false;
+      } finally {
+        setBusy(false);
+      }
+    },
+    [refresh],
+  );
+
+  useInput((input, key) => {
+    if (
+      busy ||
+      [
+        'provider',
+        'context-advisor',
+        'agent-runtime',
+        'search',
+        'image',
+        'openrouter',
+        'tts',
+        'browser',
+      ].includes(screen)
+    )
+      return;
+    const back = () => {
+      if (screen === 'main') onDone();
+      else if (screen === 'model-context') navigate('main');
+      else if (screen === 'models') navigate('model-context');
+      else if (screen === 'model-actions' || screen === 'delete-model')
+        navigate('models');
+      else if (screen === 'tools') navigate('main');
+    };
+    if (key.escape || (key.ctrl && input === 'c')) {
+      back();
+      return;
+    }
+    const length =
+      screen === 'main'
+        ? MAIN.length
+        : screen === 'model-context'
+          ? MODEL_CONTEXT.length
+          : screen === 'tools'
+            ? TOOLS.length
+            : screen === 'model-actions'
+              ? MODEL_ACTIONS.length
+              : screen === 'models'
+                ? (config?.models.length ?? 0) + 1
+                : 1;
+    if (key.upArrow) {
+      setIndex((value) => (value - 1 + length) % length);
+      return;
+    }
+    if (key.downArrow) {
+      setIndex((value) => (value + 1) % length);
+      return;
+    }
+    if (screen === 'delete-model') {
+      if (key.return && editingModelId)
+        void mutate(
+          () =>
+            configService.savePatch({
+              models: [{ op: 'remove', id: editingModelId }],
+            }),
+          '模型已删除',
+        ).then((ok) => {
+          if (ok) navigate('models');
+        });
+      return;
+    }
+    if (
+      screen === 'tools' &&
+      (input === 'd' || input === 't') &&
+      index >= 1 &&
+      index <= 4
+    ) {
+      const tool = (
+        ['webSearch', 'imageGeneration', 'openRouter', 'textToSpeech'] as const
+      )[index - 1]!;
+      if (input === 'd')
+        void mutate(
+          () => configService.savePatch({ tools: { [tool]: { clear: true } } }),
+          '配置已清除',
+        );
+      else
+        void mutate(async () => {
+          const result = await testToolConnection(tool);
+          if (!result.ok) throw new Error(result.message);
+        }, '连接检查通过');
+      return;
+    }
+    if (!key.return) return;
+    if (screen === 'main') {
+      if (index === 0) navigate('model-context');
+      else if (index === 1) navigate('tools');
+      else if (index === 2) navigate('browser');
+      else onDone();
+    } else if (screen === 'model-context') {
+      if (index === 0) navigate('models');
+      else if (index === 1) navigate('context-advisor');
+      else if (index === 2)
+        void mutate(async () => {
+          const result = await testAdvisorConnection();
+          if (!result.ok) throw new Error(result.message);
+        }, '顾问连接正常');
+      else navigate('main');
+    } else if (screen === 'tools') {
+      const targets: Screen[] = [
+        'agent-runtime',
+        'search',
+        'image',
+        'openrouter',
+        'tts',
+        'main',
+      ];
+      navigate(targets[index]!);
+    } else if (screen === 'models') {
+      if (index === (config?.models.length ?? 0)) {
+        setEditingModelId(null);
+        navigate('provider');
+      } else {
+        setEditingModelId(config?.models[index]?.id ?? null);
+        navigate('model-actions');
+      }
+    } else if (screen === 'model-actions' && editingModelId) {
+      const model = config?.models.find((entry) => entry.id === editingModelId);
+      if (!model) return;
+      if (index === 0) navigate('provider');
+      else if (index === 1)
+        void mutate(async () => {
+          const result = await testConfiguredModel(model.id);
+          if (!result.ok) throw new Error(result.message);
+        }, '模型连接正常');
+      else if (index === 2)
+        void mutate(
+          () => configService.savePatch({ baseModelId: model.id }),
+          '已设为基座模型',
+        );
+      else if (index === 3)
+        void mutate(
+          () =>
+            configService.savePatch({
+              models: [
+                {
+                  op: 'update',
+                  id: model.id,
+                  patch: { enabled: !model.enabled },
+                },
+              ],
+            }),
+          model.enabled ? '模型已停用' : '模型已启用',
+        );
+      else if (index === 4)
+        void mutate(
+          () =>
+            configService.savePatch({
+              models: [
+                { op: 'update', id: model.id, patch: { clearApiKey: true } },
+              ],
+            }),
+          'API Key 已清除',
+        );
+      else if (index === 5) navigate('delete-model');
+      else navigate('models');
+    }
+  });
+
+  if (!config)
+    return (
+      <Box paddingX={1}>
+        <Text color="gray">正在读取配置...</Text>
+      </Box>
+    );
+  if (readOnly)
+    return (
+      <Box flexDirection="column" paddingX={1}>
+        <Text color="yellow" bold>
+          当前为环境变量只读配置
+        </Text>
+        <Text>请修改环境变量后重新启动；/config 不会写入本机 JSON。</Text>
+        <Text color="gray">按 ESC 返回聊天</Text>
+      </Box>
+    );
+  const back = () => {
+    navigate(
+      screen === 'provider'
+        ? 'models'
+        : screen === 'context-advisor'
+          ? 'model-context'
+          : screen === 'browser' || screen === 'tools'
+            ? 'main'
+            : screen === 'agent-runtime' ||
+                screen === 'search' ||
+                screen === 'image' ||
+                screen === 'openrouter' ||
+                screen === 'tts'
+              ? 'tools'
+              : 'main',
+    );
+    void refresh();
+  };
+  const editing = editingModelId
+    ? config.models.find((model) => model.id === editingModelId)
+    : undefined;
+  const usableModels = config.models.filter(
+    (model) => model.enabled && model.apiKey,
+  ).length;
+  const configuredTools = Object.values(config.tools).filter(Boolean).length;
+  const draftTools = Object.keys(config.drafts?.tools ?? {}).length;
+  const mainItems = [
+    `模型与上下文（${usableModels}/${config.models.length} 个模型可用）`,
+    `工具与代理（${configuredTools}/4 项已配置${draftTools ? ` · ${draftTools} 项草稿` : ''}）`,
+    `浏览器（${config.browser?.enabled !== false ? '已启用' : '已关闭'}）`,
+    '完成并返回聊天',
+  ];
+  const toolState = (key: keyof typeof config.tools) =>
+    config.drafts?.tools?.[key]
+      ? '草稿'
+      : config.tools[key]
+        ? '已配置'
+        : '未配置';
+  const toolItems = [
+    `电脑操作与子代理（${config.computerUse?.enabled !== false ? '电脑已开' : '电脑已关'} · ${config.subagents.enabled ? '代理已开' : '代理已关'}）`,
+    `Tavily 搜索（${toolState('webSearch')}）`,
+    `图片生成（${toolState('imageGeneration')}）`,
+    `OpenRouter（${toolState('openRouter')}）`,
+    `MiniMax 语音（${toolState('textToSpeech')}）`,
+    '返回',
+  ];
+  if (screen === 'provider')
+    return (
+      <ProviderWizard
+        existing={editing}
+        setAsBase={!config.baseModelId}
+        onDone={back}
+        onCancel={back}
+      />
+    );
+  if (screen === 'context-advisor')
+    return (
+      <ContextAdvisorWizard
+        compactRatio={config.compactRatio}
+        advisor={config.advisor}
+        models={config.models}
+        onDone={back}
+        onCancel={back}
+      />
+    );
+  if (screen === 'agent-runtime')
+    return (
+      <AgentRuntimeWizard
+        subagents={config.subagents}
+        computerUse={config.computerUse!}
+        onDone={back}
+        onCancel={back}
+      />
+    );
+  if (screen === 'browser')
+    return (
+      <BrowserWizard existing={config.browser!} onDone={back} onCancel={back} />
+    );
+  if (screen === 'search')
+    return (
+      <SearchWizard
+        existing={config.tools.webSearch}
+        onDone={back}
+        onCancel={back}
+      />
+    );
+  if (screen === 'image')
+    return (
+      <ImageWizard
+        existing={config.tools.imageGeneration}
+        onDone={back}
+        onCancel={back}
+      />
+    );
+  if (screen === 'openrouter')
+    return (
+      <OpenRouterWizard
+        existing={config.tools.openRouter}
+        onDone={back}
+        onCancel={back}
+      />
+    );
+  if (screen === 'tts')
+    return (
+      <TtsWizard
+        existing={config.tools.textToSpeech}
+        onDone={back}
+        onCancel={back}
+      />
+    );
+  if (screen === 'main')
+    return (
+      <MenuList
+        title="minimal-agent · 配置中心"
+        items={mainItems}
+        index={index}
+      />
+    );
+  if (screen === 'model-context')
+    return (
+      <Box flexDirection="column">
+        <MenuList title="模型与上下文" items={MODEL_CONTEXT} index={index} />
+        {message && (
+          <Text color={message.includes('正常') ? 'green' : 'red'}>
+            {message}
+          </Text>
+        )}
+      </Box>
+    );
+  if (screen === 'tools')
+    return (
+      <Box flexDirection="column">
+        <MenuList
+          title="工具与代理"
+          items={toolItems}
+          index={index}
+          hint="↑↓ 选择 · Enter 配置 · T 测试 · D 清除 · ESC 返回"
+        />
+        {message && (
+          <Text
+            color={
+              message.includes('通过') || message.includes('清除')
+                ? 'green'
+                : 'red'
+            }
+          >
+            {message}
+          </Text>
+        )}
+      </Box>
+    );
+  if (screen === 'models')
+    return (
+      <Box flexDirection="column" paddingX={1}>
+        <Text color="cyan" bold>
+          模型管理
+        </Text>
+        <Text color="gray">★ 基座 · ↑↓ 选择 · Enter 操作 · ESC 返回</Text>
+        <Box flexDirection="column" marginTop={1}>
+          {config.models.map((model, i) => (
+            <Text key={model.id} color={index === i ? 'cyan' : undefined}>
+              {index === i ? '> ' : '  '}
+              {model.id === config.baseModelId ? '★ ' : '  '}
+              {model.displayName ?? model.model}{' '}
+              <Text color="gray">
+                ({model.apiFormat}/{model.model}
+                {!model.enabled
+                  ? ' · 已停用'
+                  : !model.apiKey
+                    ? ' · 无密钥'
+                    : ''}
+                )
+              </Text>
+            </Text>
+          ))}
+          <Text color={index === config.models.length ? 'cyan' : undefined}>
+            {index === config.models.length ? '> ' : '  '}＋ 添加模型
+          </Text>
+        </Box>
+        {message && <Text color="yellow">{message}</Text>}
+      </Box>
+    );
+  if (screen === 'delete-model')
+    return (
+      <Box flexDirection="column" paddingX={1}>
+        <Text color="red" bold>
+          确认删除模型
+        </Text>
+        <Text>
+          将删除“{editing?.displayName ?? editing?.model}”。该操作不可撤销。
+        </Text>
+        <Text color="gray">Enter 确认删除 · ESC 取消</Text>
+      </Box>
+    );
+  return (
+    <Box flexDirection="column">
+      <MenuList
+        title={editing?.displayName ?? editing?.model ?? '模型操作'}
+        items={MODEL_ACTIONS}
+        index={index}
+      />
+      {busy && <Text color="yellow">正在处理...</Text>}
+      {message && (
+        <Text
+          color={
+            message.includes('正常') || message.includes('已') ? 'green' : 'red'
+          }
+        >
+          {message}
+        </Text>
+      )}
+    </Box>
+  );
+}

package/src/cli/memoryAccess.js

@@ -0,0 +1,45 @@
+/**
+ * ============================================================
+ *  src/cli/memoryAccess.ts —— CLI 入口的「本机记忆权限」判定（单一出处）
+ * ------------------------------------------------------------
+ *  **为什么单独一个模块**：这是一条信任边界，不该以内联三元的形式散落在 print.ts 和
+ *  streamJson.ts 各写一份。分层约定是——
+ *
+ *    内核（loop.ts）  ：默认 `denied`，永不自己推断，只认宿主显式声明；
+ *    宿主（本模块）    ：把「这次调用算不算本机主人」这个**产品判断**收敛在一处；
+ *    入口（print/streamJson）：只负责把结论透传，不再自证身份。
+ *
+ *  在此之前两个入口都硬编码 `access:'local-owner'`，与 types.ts::memoryAccess 写下的
+ *  不变量（「远程、社交和子 Agent 必须为 denied」）直接冲突。
+ *
+ *  **判定规则**：本机非交互 `-p` 入口默认 read-only；显式 local-owner/read-write
+ *  才允许修改。远程或不可信宿主必须显式传 denied。
+ * ============================================================
+ */
+import { normalizeArgs } from './args.js';
+const FLAG = '--memory-access';
+/**
+ * 从 argv 里取显式声明。声明存在但缺值或值非法时抛出可操作错误，不能静默降级：
+ * 对权限参数而言，拼写错误与明确拒绝不是同一件事。
+ *
+ * `--memory-access=x` 与 `--memory-access x` 两种写法等价——`=` 形式由 `normalizeArgs`
+ * 统一展开（本函数一度自己认过一次 `=`，那是只保住这一个标志的补丁：`--cwd=` /
+ * `--session=` 照样静默失败，所以已下沉到 args.ts 的解析层）。
+ */
+function explicitAccess(args) {
+    const normalized = normalizeArgs(args);
+    for (let index = 0; index < normalized.length; index += 1) {
+        if (normalized[index] !== FLAG)
+            continue;
+        const value = normalized[index + 1];
+        if (value === 'local-owner' || value === 'read-write')
+            return 'read-write';
+        if (value === 'read-only' || value === 'denied')
+            return value;
+        throw new Error(`${FLAG} 只接受 local-owner、read-write、read-only 或 denied，收到：${value && !value.startsWith('-') ? value : '缺少值'}`);
+    }
+    return undefined;
+}
+export function resolveMemoryAccess(_outputFormat, args) {
+    return explicitAccess(args) ?? 'read-only';
+}

package/src/cli/memoryAccess.ts

@@ -0,0 +1,53 @@
+/**
+ * ============================================================
+ *  src/cli/memoryAccess.ts —— CLI 入口的「本机记忆权限」判定（单一出处）
+ * ------------------------------------------------------------
+ *  **为什么单独一个模块**：这是一条信任边界，不该以内联三元的形式散落在 print.ts 和
+ *  streamJson.ts 各写一份。分层约定是——
+ *
+ *    内核（loop.ts）  ：默认 `denied`，永不自己推断，只认宿主显式声明；
+ *    宿主（本模块）    ：把「这次调用算不算本机主人」这个**产品判断**收敛在一处；
+ *    入口（print/streamJson）：只负责把结论透传，不再自证身份。
+ *
+ *  在此之前两个入口都硬编码 `access:'local-owner'`，与 types.ts::memoryAccess 写下的
+ *  不变量（「远程、社交和子 Agent 必须为 denied」）直接冲突。
+ *
+ *  **判定规则**：本机非交互 `-p` 入口默认 read-only；显式 local-owner/read-write
+ *  才允许修改。远程或不可信宿主必须显式传 denied。
+ * ============================================================
+ */
+
+import { normalizeArgs } from './args.js';
+
+export type MemoryAccess = 'read-write' | 'read-only' | 'denied';
+
+const FLAG = '--memory-access';
+
+/**
+ * 从 argv 里取显式声明。声明存在但缺值或值非法时抛出可操作错误，不能静默降级：
+ * 对权限参数而言，拼写错误与明确拒绝不是同一件事。
+ *
+ * `--memory-access=x` 与 `--memory-access x` 两种写法等价——`=` 形式由 `normalizeArgs`
+ * 统一展开（本函数一度自己认过一次 `=`，那是只保住这一个标志的补丁：`--cwd=` /
+ * `--session=` 照样静默失败，所以已下沉到 args.ts 的解析层）。
+ */
+function explicitAccess(args: string[]): MemoryAccess | undefined {
+  const normalized = normalizeArgs(args);
+  for (let index = 0; index < normalized.length; index += 1) {
+    if (normalized[index] !== FLAG) continue;
+    const value = normalized[index + 1];
+    if (value === 'local-owner' || value === 'read-write') return 'read-write';
+    if (value === 'read-only' || value === 'denied') return value;
+    throw new Error(
+      `${FLAG} 只接受 local-owner、read-write、read-only 或 denied，收到：${value && !value.startsWith('-') ? value : '缺少值'}`,
+    );
+  }
+  return undefined;
+}
+
+export function resolveMemoryAccess(
+  _outputFormat: 'text' | 'json' | 'stream-json',
+  args: string[],
+): MemoryAccess {
+  return explicitAccess(args) ?? 'read-only';
+}