skyloom 1.13.5 → 1.13.7

package/src/tools/model_tool.ts

@@ -0,0 +1,74 @@
+/**
+ * Model self-service tools — let an agent inspect and switch its own LLM.
+ *
+ * Registered per-agent (same pattern as delegate_to), so the closure knows
+ * which agent is asking. The runtime config object is shared by reference
+ * with LLMClient, so a switch takes effect on the very next LLM call and is
+ * persisted to ~/.skyloom/config.yaml.
+ */
+
+import type { ToolDefinition } from '../core/tool';
+import { listProviders, modelsFor, providerLabel } from '../core/catalog';
+import { setAgentModel, clearAgentModel, describeAgentLLM } from '../core/model_config';
+
+export function createModelTools(agentName: string, runtimeConfig: any): ToolDefinition[] {
+  const listModels: ToolDefinition = {
+    name: 'list_models',
+    description:
+      'List every model available in the catalog (grouped by provider) plus your current model. ' +
+      'Call this before set_my_model to pick a valid id.',
+    parameters: [],
+    handler: async () => {
+      const me = describeAgentLLM(runtimeConfig, agentName);
+      const lines: string[] = [
+        `Current: ${me.model} (${me.source === 'agent' ? 'per-agent override' : 'unified default'})`,
+        '',
+      ];
+      for (const p of listProviders()) {
+        const models = modelsFor(p);
+        if (!models.length) continue;
+        lines.push(`${providerLabel(p)}: ${models.map(m => m.id).join(', ')}`);
+      }
+      return lines.join('\n');
+    },
+  };
+
+  const setMyModel: ToolDefinition = {
+    name: 'set_my_model',
+    description:
+      'Switch the LLM model YOU run on, effective from your next reply and persisted to config. ' +
+      'Use when the user asks you to change/upgrade/downgrade your model. ' +
+      "Pass model='default' to drop your override and follow the unified default again. " +
+      'Call list_models first if unsure of valid ids.',
+    parameters: [
+      {
+        name: 'model',
+        type: 'string',
+        description: "Catalog model id (e.g. 'deepseek-chat'), or 'default' to clear the override",
+        required: true,
+      },
+    ],
+    handler: async (kwargs: Record<string, any>) => {
+      const modelId = String(kwargs.model || '').trim();
+      if (!modelId) return '✗ model is required';
+
+      const before = describeAgentLLM(runtimeConfig, agentName);
+      if (modelId === 'default' || modelId === 'unified') {
+        clearAgentModel(runtimeConfig, agentName);
+        const after = describeAgentLLM(runtimeConfig, agentName);
+        return `✓ ${agentName} 已回到统一配置: ${before.model} → ${after.model} (default)`;
+      }
+
+      const r = setAgentModel(runtimeConfig, agentName, modelId);
+      if (!r.ok) {
+        return `✗ '${modelId}' 不在模型目录中。${r.suggestions.length ? '可选: ' + r.suggestions.join(', ') : '先调 list_models 查看可用模型。'}`;
+      }
+      const keyNote = describeAgentLLM(runtimeConfig, agentName).keySource === 'missing'
+        ? `\n⚠ 该 provider (${r.provider}) 尚无可用 API key — 提醒用户运行 /apikey set ${r.provider} <key>`
+        : '';
+      return `✓ ${agentName} 的模型已切换: ${before.model} → ${modelId}${r.provider ? ` (${r.provider})` : ''}，下一次回复即生效${keyNote}`;
+    },
+  };
+
+  return [listModels, setMyModel];
+}

package/src/tools/todo.ts

@@ -0,0 +1,76 @@
+/**
+ * todo_write — agents externalize multi-step task state (Claude Code 式).
+ *
+ * The agent maintains a checklist in working memory: plan it up front, mark
+ * items active/done as it works. The list survives compaction (working
+ * memory, not chat history), the CLI renders it live, and the tool's return
+ * value keeps the current state visible to the model itself.
+ *
+ * Whole-list replace semantics: every call passes the complete list. That
+ * keeps the tool idempotent and trivially recoverable after a bad call.
+ */
+
+import type { ToolDefinition } from '../core/tool';
+
+export type TodoStatus = 'pending' | 'active' | 'done';
+export interface TodoItem {
+  text: string;
+  status: TodoStatus;
+}
+
+const MAX_ITEMS = 20;
+const STATUSES = new Set<string>(['pending', 'active', 'done']);
+
+export const TODO_WORKING_KEY = 'todos';
+
+/** Parse + validate the items argument (JSON array). */
+export function parseTodoItems(raw: any): { items: TodoItem[] | null; error: string } {
+  let parsed: any = raw;
+  if (typeof raw === 'string') {
+    try { parsed = JSON.parse(raw); } catch { return { items: null, error: 'items 必须是合法 JSON 数组' }; }
+  }
+  if (!Array.isArray(parsed)) return { items: null, error: 'items 必须是数组' };
+  if (parsed.length > MAX_ITEMS) return { items: null, error: `最多 ${MAX_ITEMS} 项 — 合并粒度` };
+  const items: TodoItem[] = [];
+  for (const it of parsed) {
+    const text = typeof it === 'string' ? it : String(it?.text ?? '').trim();
+    const status = typeof it === 'object' && it !== null && STATUSES.has(String(it.status)) ? String(it.status) : 'pending';
+    if (!text) return { items: null, error: '存在空的任务项' };
+    items.push({ text: text.slice(0, 120), status: status as TodoStatus });
+  }
+  return { items, error: '' };
+}
+
+export function renderTodoList(items: TodoItem[]): string {
+  const done = items.filter(i => i.status === 'done').length;
+  const lines = items.map(i => {
+    const mark = i.status === 'done' ? '✓' : i.status === 'active' ? '◐' : '·';
+    return `${mark} ${i.text}`;
+  });
+  return `任务清单 ${done}/${items.length}\n${lines.join('\n')}`;
+}
+
+export function createTodoTool(agent: { memory: { setWorking(k: string, v: any): void } }): ToolDefinition {
+  return {
+    name: 'todo_write',
+    description:
+      'Maintain your task checklist for multi-step work. Call it FIRST to plan (all pending), ' +
+      'then again whenever an item starts (active) or finishes (done) — pass the COMPLETE list each time. ' +
+      'items is a JSON array: [{"text":"...","status":"pending|active|done"}, ...]. ' +
+      'Use for any task with 3+ steps; skip for trivial one-shot answers.',
+    parameters: [
+      {
+        name: 'items',
+        type: 'string',
+        description: 'The complete checklist as a JSON array of {text, status} (status: pending/active/done)',
+        required: true,
+      },
+    ],
+    handler: async (kwargs: Record<string, any>) => {
+      const { items, error } = parseTodoItems(kwargs.items);
+      if (!items) return `✗ ${error}`;
+      agent.memory.setWorking(TODO_WORKING_KEY, items);
+      return `✓ ${renderTodoList(items)}`;
+    },
+  };
+}

package/src/web/tts.ts

@@ -1,93 +1,93 @@
-/**
- * Text-to-Speech integration using Volcano Engine (Doubao) TTS API.
- * Uses POST to https://openspeech.bytedance.com/api/v3/tts/unidirectional.
- */
-
-const HTTP_ENDPOINT = 'https://openspeech.bytedance.com/api/v3/tts/unidirectional';
-
-export interface VoiceOption {
-  key: string;
-  name: string;
-  desc: string;
-  voiceType: string;
-}
-
-export const VOICE_CATALOG: VoiceOption[] = [
-  { key: 'xiaohe', name: '小河', desc: '温柔自然女声', voiceType: 'zh_female_xiaohe_uranus_bigtts' },
-  { key: 'qingxinnvsheng', name: '清新女声', desc: '清澈自然女声', voiceType: 'zh_female_qingxinnvsheng_uranus_bigtts' },
-  { key: 'cancan', name: '灿灿', desc: '活力甜美少女音', voiceType: 'zh_female_cancan_uranus_bigtts' },
-  { key: 'sajiaoxuemei', name: '撒娇雪梅', desc: '甜美撒娇少女音', voiceType: 'zh_female_sajiaoxuemei_uranus_bigtts' },
-  { key: 'meilinvyou', name: '魅力女游', desc: '温柔魅力女声', voiceType: 'zh_female_meilinvyou_uranus_bigtts' },
-  { key: 'xiaoshan', name: '小杉', desc: '温暖磁性男声', voiceType: 'zh_male_xiaoshan_uranus_bigtts' },
-];
-
-export interface TTSOptions {
-  text: string;
-  voice?: string;
-  speed?: number;
-  pitch?: number;
-  apiKey?: string;
-}
-
-export interface TTSResult {
-  success: boolean;
-  audioBase64?: string;
-  format?: string;
-  error?: string;
-}
-
-/**
- * Convert text to speech using Volcano Engine TTS API.
- */
-export async function textToSpeech(options: TTSOptions): Promise<TTSResult> {
-  const { text, voice = 'zh_female_xiaohe_uranus_bigtts', speed = 1.0, pitch = 1.0 } = options;
-
-  if (!text || !text.trim()) {
-    return { success: false, error: 'Text is required' };
-  }
-
-  const apiKey = options.apiKey || process.env.VOLC_ACCESS_TOKEN;
-  if (!apiKey) {
-    return { success: false, error: 'API key not configured. Set VOLC_ACCESS_TOKEN or pass apiKey.' };
-  }
-
-  const payload = {
-    app: { appid: process.env.VOLC_APP_ID || '' },
-    user: { uid: 'skyloom' },
-    request: {
-      reqid: Math.random().toString(36).slice(2, 14),
-      text,
-      text_type: 'plain',
-      operation: 'query',
-      frontend_type: 'unitTson',
-      voice: { voice_type: voice, speed_rate: speed, pitch_rate: pitch },
-      audio: { audio_type: 'mp3' },
-    },
-  };
-
-  try {
-    const response = await fetch(HTTP_ENDPOINT, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'Authorization': `Bearer ${apiKey}`,
-      },
-      body: JSON.stringify(payload),
-    });
-
-    const data: any = await response.json();
-    if (data.code !== 3000) {
-      return { success: false, error: `API error: ${data.code} - ${data.message || 'unknown'}` };
-    }
-    return { success: true, audioBase64: data.data, format: 'mp3' };
-  } catch (e: any) {
-    return { success: false, error: `TTS request failed: ${e.message || e}` };
-  }
-}
-
-/**
- * List available TTS voices.
- */
-export function listVoices(): VoiceOption[] {
-  return [...VOICE_CATALOG];
-}
+/**
+ * Text-to-Speech integration using Volcano Engine (Doubao) TTS API.
+ * Uses POST to https://openspeech.bytedance.com/api/v3/tts/unidirectional.
+ */
+
+const HTTP_ENDPOINT = 'https://openspeech.bytedance.com/api/v3/tts/unidirectional';
+
+export interface VoiceOption {
+  key: string;
+  name: string;
+  desc: string;
+  voiceType: string;
+}
+
+export const VOICE_CATALOG: VoiceOption[] = [
+  { key: 'xiaohe', name: '小河', desc: '温柔自然女声', voiceType: 'zh_female_xiaohe_uranus_bigtts' },
+  { key: 'qingxinnvsheng', name: '清新女声', desc: '清澈自然女声', voiceType: 'zh_female_qingxinnvsheng_uranus_bigtts' },
+  { key: 'cancan', name: '灿灿', desc: '活力甜美少女音', voiceType: 'zh_female_cancan_uranus_bigtts' },
+  { key: 'sajiaoxuemei', name: '撒娇雪梅', desc: '甜美撒娇少女音', voiceType: 'zh_female_sajiaoxuemei_uranus_bigtts' },
+  { key: 'meilinvyou', name: '魅力女游', desc: '温柔魅力女声', voiceType: 'zh_female_meilinvyou_uranus_bigtts' },
+  { key: 'xiaoshan', name: '小杉', desc: '温暖磁性男声', voiceType: 'zh_male_xiaoshan_uranus_bigtts' },
+];
+
+export interface TTSOptions {
+  text: string;
+  voice?: string;
+  speed?: number;
+  pitch?: number;
+  apiKey?: string;
+}
+
+export interface TTSResult {
+  success: boolean;
+  audioBase64?: string;
+  format?: string;
+  error?: string;
+}
+
+/**
+ * Convert text to speech using Volcano Engine TTS API.
+ */
+export async function textToSpeech(options: TTSOptions): Promise<TTSResult> {
+  const { text, voice = 'zh_female_xiaohe_uranus_bigtts', speed = 1.0, pitch = 1.0 } = options;
+
+  if (!text || !text.trim()) {
+    return { success: false, error: 'Text is required' };
+  }
+
+  const apiKey = options.apiKey || process.env.VOLC_ACCESS_TOKEN;
+  if (!apiKey) {
+    return { success: false, error: 'API key not configured. Set VOLC_ACCESS_TOKEN or pass apiKey.' };
+  }
+
+  const payload = {
+    app: { appid: process.env.VOLC_APP_ID || '' },
+    user: { uid: 'skyloom' },
+    request: {
+      reqid: Math.random().toString(36).slice(2, 14),
+      text,
+      text_type: 'plain',
+      operation: 'query',
+      frontend_type: 'unitTson',
+      voice: { voice_type: voice, speed_rate: speed, pitch_rate: pitch },
+      audio: { audio_type: 'mp3' },
+    },
+  };
+
+  try {
+    const response = await fetch(HTTP_ENDPOINT, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${apiKey}`,
+      },
+      body: JSON.stringify(payload),
+    });
+
+    const data: any = await response.json();
+    if (data.code !== 3000) {
+      return { success: false, error: `API error: ${data.code} - ${data.message || 'unknown'}` };
+    }
+    return { success: true, audioBase64: data.data, format: 'mp3' };
+  } catch (e: any) {
+    return { success: false, error: `TTS request failed: ${e.message || e}` };
+  }
+}
+
+/**
+ * List available TTS voices.
+ */
+export function listVoices(): VoiceOption[] {
+  return [...VOICE_CATALOG];
+}