@steerable/agent-shell 0.6.47 → 0.6.49

package/dist/local-backend/portable-service.js

@@ -0,0 +1,469 @@
+/**
+ * 对话包 / 配置包的读写。路由只负责在产品开关打开时把请求转进来。
+ */
+import { readdir, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { normalizeToolPolicy } from './agent-capability.js';
+import { PORTABLE_CHAT_KIND, PORTABLE_CHATS_KIND, PORTABLE_CONFIG_KIND, PORTABLE_MESSAGE_LIMIT, PORTABLE_SCHEMA_VERSION, isClientSectionId, llmSectionFromSettings, mcpSectionFromServer, previewPortable, readChatDocument, readConfigDocument, readPortableProject, rewriteAttachmentRefs, selectedServerSections, webSearchSectionFromSettings, } from './portable-bundle.js';
+import { isProductLlmLocked } from '../host-tools-runtime.js';
+import { ensureProjectHome } from '../project-home.js';
+import { getUserDataDir } from '../runtime.js';
+import { chatAttachmentsDirPath, isValidChatAttachmentsKey, saveAttachmentFiles, } from '../attachments.js';
+import { sanitizeCompatOverrides, sanitizeLlmProvider, sanitizePresetsChoice, sanitizeVendorId, } from '../storage/llm-settings.js';
+const ATTACHMENT_FILE_BYTES = 8 * 1024 * 1024;
+const ATTACHMENT_TOTAL_BYTES = 32 * 1024 * 1024;
+function fail(status, detail) {
+    return { status, data: { detail, error: detail } };
+}
+function exportedAt() {
+    return new Date().toISOString();
+}
+async function listUserSkillNames() {
+    const dir = path.join(getUserDataDir(), 'skills');
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name)
+            .sort((a, b) => a.localeCompare(b));
+    }
+    catch {
+        return [];
+    }
+}
+export async function exportConfigDocument(store, mcp, includeSecrets) {
+    const sections = {};
+    const llm = await store.getLlmSettings();
+    if (llm) {
+        sections.llm = llmSectionFromSettings(llm, includeSecrets);
+    }
+    const webSearch = await store.getWebSearchSettings();
+    if (webSearch)
+        sections.webSearch = webSearchSectionFromSettings(webSearch, includeSecrets);
+    const telemetry = await store.getTelemetrySettings();
+    if (telemetry) {
+        sections.telemetry = {
+            endpoint: telemetry.endpoint,
+            privacyMode: telemetry.privacyMode,
+            serviceName: telemetry.serviceName,
+        };
+    }
+    const insights = await store.getInsightsSettings();
+    if (insights) {
+        sections.insights = {
+            shareBehavior: insights.shareBehavior,
+            shareConversation: insights.shareConversation,
+            shareProfile: insights.shareProfile,
+            promptedAt: typeof insights.promptedAt === 'string' ? insights.promptedAt : undefined,
+            apiBase: insights.apiBase,
+            profile: { ...insights.profile },
+        };
+    }
+    if (mcp) {
+        const servers = mcp.list();
+        if (servers.length > 0) {
+            sections.mcp = servers.map((server) => mcpSectionFromServer(server, includeSecrets));
+        }
+    }
+    const agents = (await store.listChatAgents(true)).filter((agent) => !agent.isBuiltin);
+    if (agents.length > 0) {
+        sections.agents = agents.map((agent) => ({
+            name: agent.name,
+            slug: agent.slug,
+            icon: agent.icon,
+            color: agent.color,
+            description: agent.description,
+            rolePrompt: agent.rolePrompt,
+            forbiddenPrompt: agent.forbiddenPrompt,
+            skillIds: [...agent.skillIds],
+            toolPolicy: agent.toolPolicy,
+            allowExternalSkills: agent.allowExternalSkills,
+            loadAllSkills: agent.loadAllSkills,
+            isArchived: agent.isArchived,
+            sortOrder: agent.sortOrder,
+        }));
+    }
+    const skillNames = await listUserSkillNames();
+    if (skillNames.length > 0)
+        sections.skills = { names: skillNames };
+    return {
+        kind: PORTABLE_CONFIG_KIND,
+        schemaVersion: PORTABLE_SCHEMA_VERSION,
+        exportedAt: exportedAt(),
+        includeSecrets,
+        sections,
+    };
+}
+async function readChatAttachments(chatId) {
+    if (!isValidChatAttachmentsKey(chatId))
+        return [];
+    const dir = chatAttachmentsDirPath(chatId);
+    let names = [];
+    try {
+        const entries = await readdir(dir, { withFileTypes: true });
+        names = entries.filter((entry) => entry.isFile()).map((entry) => entry.name);
+    }
+    catch {
+        return [];
+    }
+    const attachments = [];
+    let total = 0;
+    for (const name of names) {
+        const full = path.join(dir, name);
+        try {
+            const bytes = await readFile(full);
+            if (bytes.byteLength > ATTACHMENT_FILE_BYTES || total + bytes.byteLength > ATTACHMENT_TOTAL_BYTES) {
+                attachments.push({ name, size: bytes.byteLength, omitted: true });
+                continue;
+            }
+            total += bytes.byteLength;
+            attachments.push({ name, size: bytes.byteLength, data: bytes.toString('base64') });
+        }
+        catch {
+            attachments.push({ name, size: 0, omitted: true });
+        }
+    }
+    return attachments;
+}
+export async function exportChatDocument(store, chatId, projects = null) {
+    const chat = await store.getChat(chatId);
+    if (!chat)
+        return null;
+    const newestFirst = await store.listMessages(chatId, PORTABLE_MESSAGE_LIMIT);
+    const messages = newestFirst.slice().reverse().map((message) => ({
+        role: message.role,
+        content: message.content,
+        messageMetadata: message.messageMetadata,
+        createdAt: message.createdAt,
+    }));
+    return {
+        kind: PORTABLE_CHAT_KIND,
+        schemaVersion: PORTABLE_SCHEMA_VERSION,
+        exportedAt: exportedAt(),
+        chat: {
+            title: chat.title,
+            agentId: chat.agentId,
+            isPinned: chat.isPinned,
+            systemPrompt: chat.systemPrompt,
+            pinnedRefs: chat.pinnedRefs,
+        },
+        ...(linkedProject(projects, chat.projectId) ?? {}),
+        messages,
+        truncated: newestFirst.length >= PORTABLE_MESSAGE_LIMIT,
+        attachments: await readChatAttachments(chatId),
+    };
+}
+async function applyLlm(store, section) {
+    if (isProductLlmLocked())
+        return '本产品的模型由部署配置固定';
+    const current = await store.getLlmSettings();
+    const next = {
+        provider: sanitizeLlmProvider(section.provider),
+        vendorId: sanitizeVendorId(section.vendorId),
+        model: section.model?.trim() || current?.model || 'deepseek-chat',
+        baseUrl: section.baseUrl,
+        apiKey: section.apiKeyIncluded ? section.apiKey : current?.apiKey,
+        temperature: section.temperature,
+        systemPrompt: section.systemPrompt,
+        maxTotalTokens: section.maxTotalTokens,
+        compat: sanitizeCompatOverrides(section.compat),
+        presets: sanitizePresetsChoice(section.presets),
+        execTimeoutSeconds: typeof section.execTimeoutSeconds === 'number' && section.execTimeoutSeconds > 0
+            ? Math.floor(section.execTimeoutSeconds)
+            : undefined,
+    };
+    await store.setLlmSettings(next);
+    return null;
+}
+async function applyMcp(mcp, servers) {
+    if (!mcp)
+        return 'MCP 注册表不可用';
+    for (const server of servers) {
+        const name = server.name?.trim();
+        const command = server.command?.trim();
+        if (!name || !command)
+            continue;
+        const input = {
+            name,
+            command,
+            args: Array.isArray(server.args) ? server.args.map((arg) => String(arg)) : [],
+            cwd: server.cwd,
+            enabled: server.enabled !== false,
+            ...(server.envIncluded && server.env ? { env: server.env } : {}),
+        };
+        const existing = mcp.list().find((item) => item.name.toLowerCase() === name.toLowerCase());
+        if (existing)
+            mcp.update(existing.id, input);
+        else
+            mcp.create({ ...input, env: input.env ?? {} });
+    }
+    return null;
+}
+async function applyAgents(store, incoming) {
+    const notes = [];
+    const current = await store.listChatAgents(true);
+    for (const agent of incoming) {
+        const name = agent.name?.trim();
+        if (!name)
+            continue;
+        if (current.some((item) => item.isBuiltin && item.name === name)) {
+            notes.push(`跳过与内置智能体同名的「${name}」`);
+            continue;
+        }
+        const fields = {
+            slug: agent.slug ?? null,
+            icon: agent.icon ?? null,
+            color: agent.color ?? null,
+            description: agent.description ?? null,
+            rolePrompt: agent.rolePrompt ?? null,
+            forbiddenPrompt: agent.forbiddenPrompt ?? null,
+            skillIds: Array.isArray(agent.skillIds) ? agent.skillIds.map((id) => String(id)) : [],
+            toolPolicy: normalizeToolPolicy(agent.toolPolicy),
+            allowExternalSkills: agent.allowExternalSkills !== false,
+            loadAllSkills: agent.loadAllSkills === true,
+            isArchived: agent.isArchived === true,
+            sortOrder: typeof agent.sortOrder === 'number' ? agent.sortOrder : 0,
+            isBuiltin: false,
+        };
+        const found = current.find((item) => !item.isBuiltin && item.name === name);
+        if (found) {
+            await store.updateChatAgent(found.id, fields);
+        }
+        else {
+            const created = await store.createChatAgent({ name, ...fields });
+            current.push(created);
+        }
+    }
+    return notes;
+}
+async function applySkills(names) {
+    const present = new Set(await listUserSkillNames());
+    return names.filter((name) => typeof name === 'string' && name && !present.has(name));
+}
+export async function importConfigDocument(store, mcp, raw, selected) {
+    const doc = readConfigDocument(raw);
+    if ('error' in doc)
+        return fail(400, doc.error);
+    const ids = selectedServerSections(doc.sections, selected);
+    const applied = [];
+    const skipped = [];
+    const notes = [];
+    let missingSkills = [];
+    for (const id of ids) {
+        if (id === 'llm' && doc.sections.llm) {
+            const reason = await applyLlm(store, doc.sections.llm);
+            if (reason)
+                skipped.push({ id, reason });
+            else
+                applied.push(id);
+        }
+        else if (id === 'webSearch' && doc.sections.webSearch) {
+            const current = await store.getWebSearchSettings();
+            const section = doc.sections.webSearch;
+            await store.setWebSearchSettings({
+                provider: section.provider === 'ddg' ? 'ddg' : 'tavily',
+                apiKey: section.apiKeyIncluded ? section.apiKey : current?.apiKey,
+            });
+            applied.push(id);
+        }
+        else if (id === 'telemetry' && doc.sections.telemetry) {
+            const telemetry = doc.sections.telemetry;
+            await store.setTelemetrySettings({
+                endpoint: telemetry.endpoint,
+                privacyMode: telemetry.privacyMode === 'full' ? 'full' : 'metadata',
+                serviceName: telemetry.serviceName,
+            });
+            applied.push(id);
+        }
+        else if (id === 'insights' && doc.sections.insights) {
+            await store.setInsightsSettings(doc.sections.insights);
+            applied.push(id);
+        }
+        else if (id === 'mcp' && doc.sections.mcp) {
+            const reason = await applyMcp(mcp, doc.sections.mcp);
+            if (reason)
+                skipped.push({ id, reason });
+            else
+                applied.push(id);
+        }
+        else if (id === 'agents' && doc.sections.agents) {
+            notes.push(...(await applyAgents(store, doc.sections.agents)));
+            applied.push(id);
+        }
+        else if (id === 'skills' && doc.sections.skills) {
+            missingSkills = await applySkills(doc.sections.skills.names ?? []);
+            applied.push(id);
+        }
+    }
+    const clientSections = (selected ?? []).filter(isClientSectionId);
+    return {
+        status: 200,
+        data: { applied, skipped, notes, missingSkills, clientSections },
+    };
+}
+function linkedProject(projects, projectId) {
+    if (!projects || !projectId)
+        return null;
+    const project = projects.get(projectId);
+    if (!project)
+        return null;
+    return {
+        project: {
+            name: project.name,
+            folderPath: project.folderPath,
+            sourceFolders: project.sourceFolders ?? [],
+            trusted: project.trusted === true,
+        },
+    };
+}
+/**
+ * 同名项目沿用本机已有记录，不改它的目录。没有同名项目时按导出的路径登记，
+ * 路径不存在就建一个空目录。源文件夹和其他目录里的文件都不复制。
+ */
+function bindImportedProject(projects, raw) {
+    if (!projects)
+        return null;
+    const project = readPortableProject(raw);
+    if (!project)
+        return null;
+    const existing = projects.get(project.name);
+    if (existing)
+        return existing.id;
+    ensureProjectHome(project.folderPath);
+    const created = projects.create({
+        name: project.name,
+        folderPath: project.folderPath,
+        sourceFolders: project.sourceFolders,
+    });
+    if (project.trusted)
+        projects.setTrusted(created.id, true);
+    return created.id;
+}
+async function importChatDocument(store, raw, projects) {
+    const doc = readChatDocument(raw);
+    if ('error' in doc)
+        return { response: fail(400, doc.error) };
+    const created = await store.createChat(doc.chat.title.trim(), doc.chat.agentId, bindImportedProject(projects, doc.project));
+    const pinnedRefs = Array.isArray(doc.chat.pinnedRefs) ? doc.chat.pinnedRefs : null;
+    await store.updateChat(created.id, {
+        isPinned: doc.chat.isPinned === true,
+        systemPrompt: typeof doc.chat.systemPrompt === 'string' ? doc.chat.systemPrompt : null,
+        pinnedRefs,
+    });
+    const pathByName = new Map();
+    const files = (doc.attachments ?? []).filter((file) => file && typeof file.data === 'string' && !file.omitted);
+    if (files.length > 0) {
+        const saved = await saveAttachmentFiles(created.id, files.map((file) => ({ name: file.name, data: file.data })));
+        for (const file of saved.files) {
+            if (file.path)
+                pathByName.set(file.name, file.path);
+        }
+    }
+    const messages = doc.messages.slice(0, PORTABLE_MESSAGE_LIMIT);
+    for (const message of messages) {
+        let content = message.content;
+        let metadata = message.messageMetadata;
+        for (const [name, nextPath] of pathByName) {
+            content = rewriteAttachmentRefs(content, name, nextPath);
+            if (metadata)
+                metadata = rewriteAttachmentRefs(metadata, name, nextPath);
+        }
+        await store.addMessage(created.id, message.role, content, metadata);
+    }
+    const written = {
+        chatId: created.id,
+        title: created.title,
+        messageCount: messages.length,
+    };
+    return {
+        written,
+        response: {
+            status: 200,
+            data: { ...written, attachmentsSaved: pathByName.size },
+        },
+    };
+}
+async function importSubmittedChats(store, raw, projects) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw) || raw.kind !== PORTABLE_CHATS_KIND) {
+        return (await importChatDocument(store, raw, projects)).response;
+    }
+    const preview = previewPortable(raw);
+    if ('error' in preview)
+        return fail(400, preview.error);
+    const bundle = raw;
+    if (!Array.isArray(bundle.chats))
+        return fail(400, '对话包里没有对话');
+    const docs = [];
+    for (const item of bundle.chats) {
+        const doc = readChatDocument(item);
+        if ('error' in doc)
+            return fail(400, doc.error);
+        docs.push(doc);
+    }
+    const imported = [];
+    for (const doc of docs) {
+        const result = await importChatDocument(store, doc, projects);
+        if (!result.written)
+            return result.response;
+        imported.push(result.written);
+    }
+    const messageCount = imported.reduce((sum, item) => sum + item.messageCount, 0);
+    return {
+        status: 200,
+        data: {
+            chatId: imported[0]?.chatId ?? '',
+            title: imported.length === 1 ? (imported[0]?.title ?? '') : `${imported.length} 条对话`,
+            messageCount,
+            chatCount: imported.length,
+        },
+    };
+}
+function readBodyDocument(body) {
+    if (!body || typeof body !== 'object' || Array.isArray(body))
+        return null;
+    const record = body;
+    if (!('document' in record))
+        return null;
+    const sections = Array.isArray(record.sections)
+        ? record.sections.filter((item) => typeof item === 'string')
+        : undefined;
+    return { document: record.document, sections };
+}
+export async function handlePortableRequest(input) {
+    const { method, pathname, store, mcp } = input;
+    if (method === 'GET' && pathname === '/api/v2/portable/config') {
+        return {
+            status: 200,
+            data: await exportConfigDocument(store, mcp, input.includeSecrets),
+        };
+    }
+    if (method === 'POST' && pathname === '/api/v2/portable/preview') {
+        const wrapped = readBodyDocument(input.body);
+        if (!wrapped)
+            return fail(400, '缺少 document');
+        const preview = previewPortable(wrapped.document);
+        if ('error' in preview)
+            return fail(400, preview.error);
+        return { status: 200, data: preview };
+    }
+    if (method === 'POST' && pathname === '/api/v2/portable/config') {
+        const wrapped = readBodyDocument(input.body);
+        if (!wrapped)
+            return fail(400, '缺少 document');
+        return importConfigDocument(store, mcp, wrapped.document, wrapped.sections);
+    }
+    if (method === 'POST' && pathname === '/api/v2/portable/chats') {
+        const wrapped = readBodyDocument(input.body);
+        if (!wrapped)
+            return fail(400, '缺少 document');
+        return importSubmittedChats(store, wrapped.document, input.projects);
+    }
+    const chatMatch = pathname.match(/^\/api\/v2\/chats\/([^/]+)\/portable$/);
+    if (chatMatch && method === 'GET') {
+        const doc = await exportChatDocument(store, decodeURIComponent(chatMatch[1]), input.projects);
+        if (!doc)
+            return fail(404, 'Chat not found');
+        return { status: 200, data: doc };
+    }
+    return fail(404, 'Not found');
+}

package/dist/local-backend/router.js

@@ -37,6 +37,8 @@ import { formatHistoryForSummary, truncateMiddle, } from './context-compactor.js
 import { planRegenerateTruncate, resolveRegenerateContext, resolveRegenerateForkOrdinal, } from './regenerate-helper.js';
 import { resolveBranchActivation } from './branch-helper.js';
 import { detectInterruptedTurn } from './interrupted-helper.js';
+import { handlePortableRequest } from './portable-service.js';
+import { isPortableProduct } from '../product-config.js';
 import { dropCurrentUserMessage } from './history-helper.js';
 import { parseImageAttachments, processImageAttachments } from '../image-attachment.js';
 import { chatAttachmentsDirPath } from '../attachments.js';
@@ -226,6 +228,24 @@ export class LocalBackendRouter {
             }
             return { status: 200, data: buildLocalApiUser() };
         }
+        if (pathname === '/api/v2/portable/config' ||
+            pathname === '/api/v2/portable/preview' ||
+            pathname === '/api/v2/portable/chats' ||
+            /^\/api\/v2\/chats\/[^/]+\/portable$/.test(pathname)) {
+            if (!isPortableProduct())
+                return this.notFound('Not found');
+            return handlePortableRequest({
+                method,
+                pathname,
+                includeSecrets: url.searchParams.get('includeSecrets') === '1',
+                body: request.body,
+                store: this.store,
+                mcp: this.toolRouter.mcpRegistry ?? null,
+                projects: getResolvedHostTools().projects.capability
+                    ? (this.toolRouter.projectRegistry ?? null)
+                    : null,
+            });
+        }
         // Desktop Agent —— 在本地模式下虚拟一个永远在线的 agent，所有 exec 直接走 ToolRouter
         if (method === 'GET' && pathname === '/api/v2/agents') {
             const agent = buildLocalAgent();

package/dist/local-backend/skills/85-local-exec/SKILL.md

@@ -19,6 +19,7 @@ match: any
 | 写入 / 修改文件 | `local_write_file`（`path` + `content`） |
 | 打开文件 / URL | `local_open_path` |
 | 调用已注册脚本 | `local_list_scripts` → `local_run_script` |
+| 声明本轮交付给用户的最终文件 | `present_files`（`files: [{ path, description? }]`，最多 4 个） |
 
 ## 规则
 
@@ -26,6 +27,7 @@ match: any
 - 命令可能改文件、装包、删数据时（destructive 类操作），**先**简单告诉用户你要执行什么，**再**发 tool_call；不要中间停手等用户确认（用户已经请求了）。
 - `local_exec_shell` 返回包含 `stdout` / `stderr` / `exitCode`。非 0 退出码视为失败：把 stderr 摘要给用户，并建议下一步。
 - 路径不存在 / 权限不足时，把 fs 错误原文告诉用户，**不要**反复重试同一个路径。
+- **交付文件要声明**：用户要的产出（表格、PPT、文档、报告、图片、导出包）写好后，在最终回复前调用 `present_files` 声明它们，脚本/命令生成的也一样。辅助脚本、临时文件、只为自查渲染效果导出的预览图、中间导出副本**不要**声明——它们会自动列在「已编辑文件」里。
 
 
 - **超时 ≠ 失败，严禁原样重跑启动命令**：返回里出现 `timedOut: true` 时，只是 shell 等待被掐断——如果命令是启动 GUI / 长时间运行的程序（如 Qt 界面软件），该程序**很可能仍在运行**，用户可能正在里面操作。此时**不要**再次执行同一条启动命令（会把程序重复启动多次）。正确做法：先确认进程是否在运行（如 `Get-Process`）；确实需要长时间等待时传更大的 `timeout` 参数；启动 GUI 程序时优先用不阻塞的方式（PowerShell `Start-Process "app.exe"`），启动成功即视为完成，不要等它退出。

package/dist/local-backend/skills/86-proactive-coding/SKILL.md

@@ -47,5 +47,5 @@ match: any
 
 - **没跑过的代码不要说"运行结果如下"。** 只有看到 `local_run_snippet` 的真实返回（`exitCode: 0` + `stdout`）才能汇报结果；非 0 退出码就读 `stderr` 改代码重跑（最多迭代 2-3 次，还不行就如实说明卡点）。
 - 脚本里读写用户文件时，路径用用户提供的真实路径或项目内相对路径；不要编造路径。
-- 脚本产生的**交付物**（报表、转换后的文件）要落到用户能找到的地方（项目目录或用户指定路径），并在回复里给出完整路径——scratch 目录是临时区，不是交付位置。
+- 脚本产生的**交付物**（报表、转换后的文件）要落到用户能找到的地方（项目目录或用户指定路径），并在回复里给出完整路径，最终回复前用 `present_files` 声明——scratch 目录是临时区，不是交付位置。
 - 代码保持简单直接：能 20 行解决就不要写 100 行；不要引入与任务无关的"工程化"。

package/dist/local-backend/turn-files.d.ts

@@ -36,13 +36,33 @@ export interface TurnFile {
     kind: 'created' | 'modified';
     /** 字节数（展示用）。 */
     size: number;
+    /** 新增行数（展示用，如 +110）。 */
+    additions?: number;
+    /** 删除行数（展示用，如 -0）。 */
+    deletions?: number;
+    /** 类别：deliverable = present_files 声明的最终交付文件；intermediate = 其余本轮写过的文件。 */
+    category?: 'deliverable' | 'intermediate';
+    /** present_files 给出的一行说明（交付卡片副标题）。 */
+    description?: string;
 }
 /** 扫描入参里只需要工具行动的这几个字段（与 router 的 executedActions 行结构对齐）。 */
 export interface TurnFileAction {
     tool?: unknown;
     arguments?: unknown;
+    result?: unknown;
     success?: unknown;
 }
+/** 交付物扩展名（最终产物，如电子表格、幻灯片、文档、图片、音视频、独立页面、压缩包）。 */
+export declare const DELIVERABLE_EXTENSIONS: Set<string>;
+/** 是否为临时文件 / 办公软件锁定文件（如 ~$ 开头的文件名），产物列表中一律排除。 */
+export declare function isIgnoredFileName(name: string): boolean;
+/** 判定文件是最终交付文件还是中间修改文件。 */
+export declare function classifyFileCategory(filePath: string): 'deliverable' | 'intermediate';
+/** 从统一 diff 文本中统计增删行数。 */
+export declare function parseDiffStats(diffText: string): {
+    additions: number;
+    deletions: number;
+};
 /**
  * 收集本轮产物文件。`sinceMs` 是回合开始的 epoch ms；`projectRoot` 用于把
  * 写工具的相对路径参数解析成绝对路径（与 local-executor 的项目根解析一致）。