@geminilight/mindos 1.0.10 → 1.1.3

package/README_zh.md

@@ -102,7 +102,7 @@ MindOS 是你思考的地方，也是 AI Agent 行动的起点——一个你和
 | 2026-04 | **产品主包落地** — MindOS 采用 OpenCode 式核心包：`packages/mindos`（`@geminilight/mindos`）承载产品 runtime facade 与 CLI kernel 边界；Web/CLI 围绕它做适配。 |
 | 2026-04 | **OpenCode 式 workspace 扁平化** — 所有源码 workspace 已统一到 `packages/`：`packages/web`、`packages/desktop`、`packages/mobile`、`packages/mindos`，以及可选 `packages/retrieval/*` adapters。npm tarball / CLI / MCP / Web standalone / Desktop / Mobile 均已验证。 |
 | 2026-04 | **发布包清理** — 旧顶层 `app/`、`mcp/`、`desktop/`、`mobile/` 源码根已移除，发布清单精确排除测试、缓存与 nested `node_modules`。 |
-| 2026-04 | **网页剪藏插件** — 浏览器扩展，一键剪藏任意网页到 MindOS 暂存台。[安装 →](packages/browser-extension/) |
+| 2026-04 | **网页剪藏插件** — 浏览器扩展，一键剪藏任意网页到 MindOS 收集箱。[安装 →](packages/browser-extension/) |
 | 2026-04 | **PDF & 图片导入** — 拖拽 PDF 和图片到 MindOS，自动转换为可搜索的 Markdown。 |
 
 ## 🧠 人机共享心智
@@ -205,7 +205,7 @@ npx skills add https://github.com/GeminiLight/MindOS --skill mindos-zh -g -y   #
 MindOS 的知识不必从零开始——把你已有的信息导入进来：
 
 - **拖拽导入**：将文件（PDF、图片、Markdown、CSV）直接拖入 MindOS GUI，AI 自动分析并归档到对应文件夹。
-- **网页剪藏**：安装[浏览器插件](packages/browser-extension/)，一键保存任意网页到暂存台。快捷键 Ctrl+Shift+M 或右键菜单 →「Save to MindOS」。
+- **网页剪藏**：安装[浏览器插件](packages/browser-extension/)，一键保存任意网页到收集箱。快捷键 Ctrl+Shift+M 或右键菜单 →「Save to MindOS」。
 - **Agent 导入**：让任意已连接的 Agent 阅读文档并同步到你的知识库。
 
 ## ✨ 功能特性
@@ -217,7 +217,7 @@ MindOS 的知识不必从零开始——把你已有的信息导入进来：
 - **一键导入**：拖拽文件即可导入，Inline AI Organize 自动分析、分类、写入知识库，支持进度追踪和撤销。
 - **新手引导**：首次使用的分步引导体验，帮助新用户快速搭建知识库并连接第一个 Agent。
 - **插件扩展**：多种内置渲染器插件——TODO Board、CSV Views、Wiki Graph、Timeline、Workflow Editor、Agent Inspector 等。
-- **网页剪藏**：浏览器扩展，一键将任意网页保存为干净的 Markdown——存入暂存台，稍后 AI 自动整理归档。[安装 →](packages/browser-extension/)
+- **网页剪藏**：浏览器扩展，一键将任意网页保存为干净的 Markdown——存入收集箱，稍后 AI 自动整理归档。[安装 →](packages/browser-extension/)
 
 **Agent 侧**
 

package/bin/mindos-shim.cjs

@@ -1,13 +1,18 @@
 #!/usr/bin/env node
 
 const childProcess = require('node:child_process');
+const crypto = require('node:crypto');
 const fs = require('node:fs');
 const os = require('node:os');
 const path = require('node:path');
+const zlib = require('node:zlib');
 const { createRequire } = require('node:module');
 
 const PACKAGE_PREFIX = '@geminilight/mindos-';
 const LINUX_MUSL_EXAMPLE = 'linux-x64-musl';
+const DEFAULT_RUNTIME_MANIFEST_URL = 'https://github.com/GeminiLight/MindOS/releases/download/runtime-latest/latest.json';
+const MAX_MANIFEST_BYTES = 256 * 1024;
+const MAX_RUNTIME_BYTES = 512 * 1024 * 1024;
 const scriptPath = fs.realpathSync(__filename);
 const scriptDir = path.dirname(scriptPath);
 const packageRoot = path.resolve(scriptDir, '..');
@@ -131,14 +136,16 @@ function runEntrypoint(entrypoint) {
 }
 
 function findRuntimeEntrypoint() {
-  for (const packageName of platformPackageCandidates()) {
-    const packageDir = findRuntimePackageByRequire(packageName)
-      || findRuntimePackageByWalking(packageName)
-      || findRuntimePackageInSourceTree(packageName);
-    if (!packageDir) continue;
+  if (process.env.MINDOS_DISABLE_PLATFORM_PACKAGE_LOOKUP !== '1') {
+    for (const packageName of platformPackageCandidates()) {
+      const packageDir = findRuntimePackageByRequire(packageName)
+        || findRuntimePackageByWalking(packageName)
+        || findRuntimePackageInSourceTree(packageName);
+      if (!packageDir) continue;
 
-    const entrypoint = runtimeEntrypoint(packageDir);
-    if (entrypoint) return entrypoint;
+      const entrypoint = runtimeEntrypoint(packageDir);
+      if (entrypoint) return entrypoint;
+    }
   }
 
   const legacyCli = path.join(packageRoot, 'bin', 'cli.js');
@@ -147,6 +154,9 @@ function findRuntimeEntrypoint() {
     return { type: 'node', path: legacyCli };
   }
 
+  const downloaded = resolveDownloadedRuntimeEntrypoint();
+  if (downloaded) return downloaded;
+
   return null;
 }
 
@@ -162,3 +172,304 @@ if (!entrypoint) {
 }
 
 runEntrypoint(entrypoint);
+
+function resolveDownloadedRuntimeEntrypoint() {
+  if (process.env.MINDOS_DISABLE_RUNTIME_DOWNLOAD === '1') return null;
+
+  const cachedEntrypoint = findCachedRuntimeEntrypoint(productVersion());
+  if (cachedEntrypoint) return cachedEntrypoint;
+
+  let manifest;
+  try {
+    manifest = readRuntimeManifest();
+  } catch (err) {
+    const offlineCachedEntrypoint = findCachedRuntimeEntrypoint();
+    if (offlineCachedEntrypoint) return offlineCachedEntrypoint;
+    if (process.env.MINDOS_RUNTIME_MANIFEST_URL) {
+      console.error(`Failed to read MindOS runtime manifest: ${errorMessage(err)}`);
+    }
+    return null;
+  }
+
+  const version = safeRuntimeVersion(manifest.version);
+  const cacheRoot = runtimeCacheRoot();
+  const runtimeRoot = path.join(cacheRoot, version);
+  const cached = runtimeEntrypoint(runtimeRoot);
+  if (cached) return cached;
+
+  try {
+    fs.mkdirSync(cacheRoot, { recursive: true });
+    const tempRoot = path.join(cacheRoot, `.download-${version}-${process.pid}-${Date.now()}`);
+    fs.rmSync(tempRoot, { recursive: true, force: true });
+    fs.mkdirSync(tempRoot, { recursive: true });
+
+    const archive = downloadRuntimeArchive(manifest);
+    extractRuntimeArchive(archive, tempRoot);
+    const entrypoint = runtimeEntrypoint(tempRoot);
+    if (!entrypoint) {
+      throw new Error('downloaded runtime archive does not contain bin/cli.js or bin/mindos');
+    }
+
+    fs.rmSync(runtimeRoot, { recursive: true, force: true });
+    fs.renameSync(tempRoot, runtimeRoot);
+    return runtimeEntrypoint(runtimeRoot);
+  } catch (err) {
+    console.error(`Failed to install MindOS runtime fallback: ${errorMessage(err)}`);
+    return null;
+  }
+}
+
+function runtimeCacheRoot() {
+  return path.resolve(process.env.MINDOS_RUNTIME_CACHE_DIR || path.join(os.homedir(), '.mindos', 'runtime-cache'));
+}
+
+function productVersion() {
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(packageRoot, 'package.json'), 'utf-8'));
+    return typeof pkg.version === 'string' ? pkg.version : null;
+  } catch {
+    return null;
+  }
+}
+
+function findCachedRuntimeEntrypoint(version) {
+  const cacheRoot = runtimeCacheRoot();
+  let entries;
+  try {
+    entries = fs.readdirSync(cacheRoot, { withFileTypes: true });
+  } catch {
+    return null;
+  }
+
+  return entries
+    .filter((entry) => entry.isDirectory() && !entry.name.startsWith('.download-'))
+    .filter((entry) => !version || entry.name === version)
+    .map((entry) => {
+      const root = path.join(cacheRoot, entry.name);
+      const entrypoint = runtimeEntrypoint(root);
+      if (!entrypoint) return null;
+      let mtimeMs = 0;
+      try { mtimeMs = fs.statSync(root).mtimeMs; } catch {}
+      return { entrypoint, mtimeMs };
+    })
+    .filter(Boolean)
+    .sort((a, b) => b.mtimeMs - a.mtimeMs)[0]?.entrypoint || null;
+}
+
+function readRuntimeManifest() {
+  const manifestUrl = process.env.MINDOS_RUNTIME_MANIFEST_URL || DEFAULT_RUNTIME_MANIFEST_URL;
+  const body = requestBuffer(manifestUrl, { maxBytes: MAX_MANIFEST_BYTES, timeoutMs: 30_000 });
+  const manifest = JSON.parse(body.toString('utf-8'));
+  if (!manifest || typeof manifest !== 'object') throw new Error('manifest is not an object');
+  if (typeof manifest.version !== 'string') throw new Error('manifest.version must be a string');
+  if (!Array.isArray(manifest.urls) || manifest.urls.some((url) => typeof url !== 'string')) {
+    throw new Error('manifest.urls must be a string array');
+  }
+  return manifest;
+}
+
+function safeRuntimeVersion(value) {
+  if (!/^[0-9A-Za-z._-]+$/.test(value)) {
+    throw new Error(`unsafe runtime version in manifest: ${value}`);
+  }
+  return value;
+}
+
+function downloadRuntimeArchive(manifest) {
+  let lastError;
+  for (const url of manifest.urls) {
+    try {
+      const archive = requestBuffer(url, { maxBytes: MAX_RUNTIME_BYTES, timeoutMs: 120_000 });
+      if (typeof manifest.size === 'number' && manifest.size > 0 && archive.length !== manifest.size) {
+        throw new Error(`runtime archive size mismatch: got ${archive.length}, expected ${manifest.size}`);
+      }
+      if (typeof manifest.sha256 === 'string' && manifest.sha256) {
+        const actual = crypto.createHash('sha256').update(archive).digest('hex');
+        if (actual !== manifest.sha256) {
+          throw new Error(`runtime archive sha256 mismatch: got ${actual}, expected ${manifest.sha256}`);
+        }
+      }
+      return archive;
+    } catch (err) {
+      lastError = err;
+    }
+  }
+  throw lastError || new Error('manifest did not include a runtime archive URL');
+}
+
+function requestBuffer(urlString, options, redirectCount = 0) {
+  if (redirectCount > 5) throw new Error(`too many redirects while fetching ${urlString}`);
+  const url = new URL(urlString);
+  if (url.protocol === 'file:') {
+    const file = fs.readFileSync(url);
+    if (file.length > options.maxBytes) {
+      throw new Error(`file response exceeded byte limit: ${urlString}`);
+    }
+    return file;
+  }
+  if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+    throw new Error(`unsupported URL protocol: ${url.protocol}`);
+  }
+
+  const result = childProcess.spawnSync(process.execPath, [
+    '-e',
+    `
+      const http = require('node:http');
+      const https = require('node:https');
+      const url = new URL(process.argv[1]);
+      const maxBytes = Number(process.argv[2]);
+      const timeoutMs = Number(process.argv[3]);
+      const client = url.protocol === 'http:' ? http : https;
+      const req = client.get(url, { timeout: timeoutMs }, (res) => {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          process.stdout.write(JSON.stringify({ redirect: new URL(res.headers.location, url).toString() }));
+          res.resume();
+          return;
+        }
+        if (res.statusCode !== 200) {
+          console.error('HTTP ' + res.statusCode + ' while fetching ' + url);
+          res.resume();
+          process.exitCode = 2;
+          return;
+        }
+        const chunks = [];
+        let size = 0;
+        res.on('data', (chunk) => {
+          size += chunk.length;
+          if (size > maxBytes) {
+            console.error('response exceeded byte limit');
+            req.destroy();
+            process.exitCode = 3;
+            return;
+          }
+          chunks.push(chunk);
+        });
+        res.on('end', () => process.stdout.write(Buffer.concat(chunks)));
+      });
+      req.on('timeout', () => req.destroy(new Error('request timed out')));
+      req.on('error', (err) => {
+        console.error(err.message);
+        process.exitCode = process.exitCode || 1;
+      });
+    `,
+    url.toString(),
+    String(options.maxBytes),
+    String(options.timeoutMs),
+  ], {
+    encoding: 'buffer',
+    maxBuffer: options.maxBytes + 1024,
+  });
+
+  if (result.error) throw result.error;
+  if (result.status !== 0) {
+    throw new Error(result.stderr.toString('utf-8').trim() || `request failed for ${urlString}`);
+  }
+
+  try {
+    const redirect = JSON.parse(result.stdout.toString('utf-8'));
+    if (redirect && typeof redirect.redirect === 'string') {
+      return requestBuffer(redirect.redirect, options, redirectCount + 1);
+    }
+  } catch {
+    // Binary responses and normal JSON manifests are returned as-is.
+  }
+
+  return result.stdout;
+}
+
+function extractRuntimeArchive(archive, targetRoot) {
+  const tar = zlib.gunzipSync(archive);
+  let offset = 0;
+  let nextPax = {};
+
+  while (offset + 512 <= tar.length) {
+    const header = tar.subarray(offset, offset + 512);
+    offset += 512;
+    if (isZeroBlock(header)) break;
+
+    const typeflag = String.fromCharCode(header[156] || 0);
+    const size = parseOctal(header, 124, 12);
+    const rawName = nextPax.path || tarName(header);
+    nextPax = {};
+    const data = tar.subarray(offset, offset + size);
+    offset += Math.ceil(size / 512) * 512;
+
+    if (typeflag === 'x' || typeflag === 'g') {
+      nextPax = parsePax(data);
+      continue;
+    }
+
+    if (!rawName || rawName === '.' || rawName === './') continue;
+    const dest = safeArchivePath(targetRoot, rawName);
+
+    if (typeflag === '5') {
+      fs.mkdirSync(dest, { recursive: true });
+      continue;
+    }
+
+    if (typeflag === '0' || typeflag === '\0') {
+      fs.mkdirSync(path.dirname(dest), { recursive: true });
+      fs.writeFileSync(dest, data);
+      const mode = parseOctal(header, 100, 8);
+      if ((mode & 0o111) !== 0) fs.chmodSync(dest, mode & 0o777);
+    }
+  }
+}
+
+function safeArchivePath(targetRoot, archiveName) {
+  const normalized = path.normalize(archiveName.replace(/^\.\/+/, ''));
+  if (!normalized || normalized === '.' || path.isAbsolute(normalized) || normalized.startsWith('..' + path.sep) || normalized === '..') {
+    throw new Error(`unsafe runtime archive path: ${archiveName}`);
+  }
+  const dest = path.resolve(targetRoot, normalized);
+  const rootWithSep = path.resolve(targetRoot) + path.sep;
+  if (dest !== path.resolve(targetRoot) && !dest.startsWith(rootWithSep)) {
+    throw new Error(`runtime archive path escapes target root: ${archiveName}`);
+  }
+  return dest;
+}
+
+function tarName(header) {
+  const name = readNullTerminated(header, 0, 100);
+  const prefix = readNullTerminated(header, 345, 155);
+  return prefix ? `${prefix}/${name}` : name;
+}
+
+function readNullTerminated(buffer, start, length) {
+  const slice = buffer.subarray(start, start + length);
+  const end = slice.indexOf(0);
+  return slice.subarray(0, end === -1 ? slice.length : end).toString('utf-8');
+}
+
+function parseOctal(buffer, start, length) {
+  const raw = readNullTerminated(buffer, start, length).trim();
+  return raw ? Number.parseInt(raw, 8) : 0;
+}
+
+function parsePax(buffer) {
+  const text = buffer.toString('utf-8');
+  const out = {};
+  let index = 0;
+  while (index < text.length) {
+    const space = text.indexOf(' ', index);
+    if (space === -1) break;
+    const length = Number.parseInt(text.slice(index, space), 10);
+    if (!Number.isFinite(length) || length <= 0) break;
+    const record = text.slice(space + 1, index + length - 1);
+    const eq = record.indexOf('=');
+    if (eq > 0) out[record.slice(0, eq)] = record.slice(eq + 1);
+    index += length;
+  }
+  return out;
+}
+
+function isZeroBlock(buffer) {
+  for (const byte of buffer) {
+    if (byte !== 0) return false;
+  }
+  return true;
+}
+
+function errorMessage(err) {
+  return err && typeof err.message === 'string' ? err.message : String(err);
+}

package/dist/agent/prompts.d.ts

@@ -4,7 +4,7 @@
  * Product runtime owns these prompts. Web, headless mode, and future Product
  * Server ask runtime should import them from @geminilight/mindos/agent.
  */
-export declare const AGENT_SYSTEM_PROMPT = "You are MindOS \u2014 the user's local knowledge assistant.\n\nPersona: Warm yet precise, reliable, execution-oriented. Like a trusted notebook that understands you \u2014 quiet confidence, zero fluff. Be professional but never cold; be helpful but never verbose.\n\n## Self-Introduction\n\nWhen the user sends a pure greeting (\"\u4F60\u597D\", \"hi\", etc.) or asks who you are / what you can do, introduce yourself briefly:\n\n- Who: MindOS, their local knowledge assistant.\n- What: You can read files, search notes, organize material, capture decisions and preferences, and turn scattered context into reusable knowledge.\n- Tone: Natural, warm, concise. One short paragraph, then invite them to try something practical \u2014 e.g., \"\u4F60\u53EF\u4EE5\u76F4\u63A5\u8BA9\u6211\u8BFB\u6587\u4EF6\u3001\u627E\u7B14\u8BB0\u3001\u8BB0\u5F55\u51B3\u5B9A\uFF0C\u6216\u8005\u6574\u7406\u521A\u4E0A\u4F20\u7684\u6750\u6599\u3002\"\n- Do NOT use slogan-like phrasing such as \"operator of your second brain\" or repetitive identity statements.\n- If the user's message already contains a concrete task \u2014 even if it starts with a greeting \u2014 skip the self-introduction and do the task directly.\n\n## Core Directives\n\n1. **Anti-Hallucination**: Strictly separate your training data from the user's local knowledge. If asked about the user's notes/life/projects, rely EXCLUSIVELY on tool outputs. If a search yields nothing, state \"Not found in knowledge base.\" NEVER fabricate or infer missing data.\n2. **Think Before Acting**: For any non-trivial task, use a brief `<thinking>` block to outline your plan or analyze an error BEFORE calling tools.\n3. **Read Before Write**: You MUST read a file before modifying it. Prefer precise section/line edits over full overwrites. Verify edits by reading again.\n4. **Cite Sources**: Always include the exact file path when answering from local knowledge so the user can verify.\n5. **Smart Recovery**: If a tool fails (e.g. File Not Found), do NOT retry identical arguments. Use `search` or `list_files` to find the correct path first.\n6. **Token Efficiency**: Batch parallel independent tool calls in a single turn. Do not waste rounds.\n7. **Language Alignment**: Match the language of the file when writing, and match the user's language when replying.\n\n## Context Mechanics\n\n- **Auto-loaded**: Configs, instructions, and SKILL.md are already in your context. Do not search for them unless explicitly asked.\n- **Uploaded Files**: Local files attached by the user appear in the \"\u26A0\uFE0F USER-UPLOADED FILES\" section below. Use this content directly. Do NOT use tools to read/search them.\n- **Web Search**: When the user asks to search, look up, or find information online, ALWAYS use `web_search` first to discover relevant URLs. Do NOT guess URLs or use `fetch_content` directly \u2014 search first, then fetch specific results.\n- **Skills**: Available skills are listed at the end of this prompt. Use the load_skill tool to load a skill's full content when a task matches its description.\n- **MCP**: Use the mcp tool to search, describe, and call MCP tools from external servers configured in ~/.mindos/mcp.json.\n\n## Output\n\n- Reply in the user's language.\n- Use clean Markdown (tables, lists, bold).\n- End with concrete next actions if the task is incomplete.";
+export declare const AGENT_SYSTEM_PROMPT = "You are MindOS \u2014 the user's local knowledge assistant.\n\nPersona: Warm yet precise, reliable, execution-oriented. Like a trusted notebook that understands you \u2014 quiet confidence, zero fluff. Be professional but never cold; be helpful but never verbose.\n\n## Self-Introduction\n\nWhen the user sends a pure greeting (\"\u4F60\u597D\", \"hi\", etc.) or asks who you are / what you can do, introduce yourself briefly:\n\n- Who: MindOS, their local knowledge assistant.\n- What: You can read files, search notes, organize material, capture decisions and preferences, and turn scattered context into reusable knowledge.\n- Tone: Natural, warm, concise. One short paragraph, then invite them to try something practical \u2014 e.g., \"\u4F60\u53EF\u4EE5\u76F4\u63A5\u8BA9\u6211\u8BFB\u6587\u4EF6\u3001\u627E\u7B14\u8BB0\u3001\u8BB0\u5F55\u51B3\u5B9A\uFF0C\u6216\u8005\u6574\u7406\u521A\u4E0A\u4F20\u7684\u6750\u6599\u3002\"\n- Do NOT use slogan-like phrasing such as \"operator of your second brain\" or repetitive identity statements.\n- If the user's message already contains a concrete task \u2014 even if it starts with a greeting \u2014 skip the self-introduction and do the task directly.\n\n## Core Directives\n\n1. **Anti-Hallucination**: Strictly separate your training data from the user's local knowledge. If asked about the user's notes/life/projects, rely EXCLUSIVELY on tool outputs. If a search yields nothing, state \"Not found in knowledge base.\" NEVER fabricate or infer missing data.\n2. **Think Before Acting**: For any non-trivial task, use a brief `<thinking>` block to outline your plan or analyze an error BEFORE calling tools.\n3. **Read Before Write**: You MUST read a file before modifying it. Prefer precise section/line edits over full overwrites. Verify edits by reading again.\n4. **Cite Sources**: Always include the exact file path when answering from local knowledge so the user can verify.\n5. **Smart Recovery**: If a tool fails (e.g. File Not Found), do NOT retry identical arguments. Use `search` or `list_files` to find the correct path first.\n6. **Token Efficiency**: Batch parallel independent tool calls in a single turn. Do not waste rounds.\n7. **Language Alignment**: Match the language of the file when writing, and match the user's language when replying.\n\n## Delegation / Subagents\n\n- The `subagent` tool is MindOS Agent's internal delegation tool. It is separate from ACP runtimes, A2A agents, and the user's selected Codex / Claude Code chat runtime.\n- Use `subagent` when the work is complex and separable: independent code review, research, verification, multi-file audit, or comparing options. Keep trivial or tightly coupled work in the main thread.\n- If you are not sure which subagents exist, call `subagent` with `action: \"list\"` first. Use `action: \"status\"` / `action: \"resume\"` only for existing subagent runs.\n- For each delegated task, provide a bounded task, clear acceptance criteria, relevant cwd/files, and the evidence you need back. Run tasks in parallel only when they are independent.\n- Do not use subagents to bypass mode, permission, or confirmation boundaries. Chat/read-only expectations, protected files, destructive operations, and user-confirmation requirements still apply.\n\n## Structured Clarification\n\n- Use `ask_user_question` when the user's request is underspecified and the answer changes what you should do. Prefer one structured question card over a vague free-form clarification.\n- Group related questions into one `ask_user_question` call. Do not stack multiple clarification calls back-to-back.\n- Do not ask about trivial choices you can safely infer. Ask before writing files, choosing among meaningfully different implementation directions, or taking a high-risk action when user intent is unclear.\n\n## Context Mechanics\n\n- **Auto-loaded**: Configs, instructions, and SKILL.md are already in your context. Do not search for them unless explicitly asked.\n- **Uploaded Files**: Local files attached by the user appear in the \"\u26A0\uFE0F USER-UPLOADED FILES\" section below. Use this content directly. Do NOT use tools to read/search them.\n- **Web Search**: When the user asks to search, look up, or find information online, ALWAYS use `web_search` first to discover relevant URLs. Do NOT guess URLs or use `fetch_content` directly \u2014 search first, then fetch specific results.\n- **Skills**: Available skills are listed at the end of this prompt. Use the load_skill tool to load a skill's full content when a task matches its description.\n- **MCP**: Use the mcp tool to search, describe, and call MCP tools from external servers configured in ~/.mindos/mcp.json.\n\n## Output\n\n- Reply in the user's language.\n- Use clean Markdown (tables, lists, bold).\n- End with concrete next actions if the task is incomplete.";
 /**
  * Chat mode system prompt — read-only tools, no write operations.
  */

package/dist/agent/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/agent/prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,gxGAoC4B,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,kBAAkB,m2CAoB6B,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,sBAAsB,g8BAWoC,CAAC"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/agent/prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,mvJAkD4B,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,kBAAkB,m2CAoB6B,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,sBAAsB,g8BAWoC,CAAC"}

package/dist/agent/prompts.js

@@ -28,6 +28,20 @@ When the user sends a pure greeting ("你好", "hi", etc.) or asks who you are /
 6. **Token Efficiency**: Batch parallel independent tool calls in a single turn. Do not waste rounds.
 7. **Language Alignment**: Match the language of the file when writing, and match the user's language when replying.
 
+## Delegation / Subagents
+
+- The \`subagent\` tool is MindOS Agent's internal delegation tool. It is separate from ACP runtimes, A2A agents, and the user's selected Codex / Claude Code chat runtime.
+- Use \`subagent\` when the work is complex and separable: independent code review, research, verification, multi-file audit, or comparing options. Keep trivial or tightly coupled work in the main thread.
+- If you are not sure which subagents exist, call \`subagent\` with \`action: "list"\` first. Use \`action: "status"\` / \`action: "resume"\` only for existing subagent runs.
+- For each delegated task, provide a bounded task, clear acceptance criteria, relevant cwd/files, and the evidence you need back. Run tasks in parallel only when they are independent.
+- Do not use subagents to bypass mode, permission, or confirmation boundaries. Chat/read-only expectations, protected files, destructive operations, and user-confirmation requirements still apply.
+
+## Structured Clarification
+
+- Use \`ask_user_question\` when the user's request is underspecified and the answer changes what you should do. Prefer one structured question card over a vague free-form clarification.
+- Group related questions into one \`ask_user_question\` call. Do not stack multiple clarification calls back-to-back.
+- Do not ask about trivial choices you can safely infer. Ask before writing files, choosing among meaningfully different implementation directions, or taking a high-risk action when user intent is unclear.
+
 ## Context Mechanics
 
 - **Auto-loaded**: Configs, instructions, and SKILL.md are already in your context. Do not search for them unless explicitly asked.

package/dist/agent/prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/agent/prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4DAoCyB,CAAC;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;4DAoB0B,CAAC;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;uEAWiC,CAAC"}
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../src/agent/prompts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4DAkDyB,CAAC;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;4DAoB0B,CAAC;AAE7D;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;uEAWiC,CAAC"}

package/dist/agent-runtime/claude-code-cli.d.ts

@@ -0,0 +1,34 @@
+import { type MindOSSSEvent } from '../session/index.js';
+export type ClaudeCodeCliTransport = {
+    run(args: string[], options: {
+        cwd: string;
+        signal?: AbortSignal;
+    }): AsyncIterable<string>;
+    close?(): void | Promise<void>;
+};
+export type ClaudeCodeCliPermissionPrompt = {
+    toolName: string;
+    mcpConfig: string | Record<string, unknown>;
+};
+export type ClaudeCodeCliPermissionMode = 'default' | 'acceptEdits' | 'bypassPermissions' | 'plan' | 'dontAsk' | 'auto';
+export type ClaudeCodeCliClient = {
+    startTurn(input: {
+        prompt: string;
+        cwd: string;
+        sessionId?: string;
+        permissionMode?: ClaudeCodeCliPermissionMode;
+        permissionPrompt?: ClaudeCodeCliPermissionPrompt;
+        signal?: AbortSignal;
+    }): AsyncIterable<ClaudeCodeCliEvent>;
+    close?(): void | Promise<void>;
+};
+export type ClaudeCodeCliEvent = {
+    type: 'session_id';
+    sessionId: string;
+} | MindOSSSEvent;
+export declare function createClaudeCodeCliClient(transport: ClaudeCodeCliTransport): ClaudeCodeCliClient;
+export declare function createClaudeCodeCliStdioTransport(options?: {
+    command?: string;
+    env?: NodeJS.ProcessEnv;
+}): ClaudeCodeCliTransport;
+//# sourceMappingURL=claude-code-cli.d.ts.map

package/dist/agent-runtime/claude-code-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-cli.d.ts","sourceRoot":"","sources":["../../src/agent-runtime/claude-code-cli.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,sBAAsB,GAAG;IACnC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAC3F,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,SAAS,GAAG,aAAa,GAAG,mBAAmB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAExH,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,CAAC,KAAK,EAAE;QACf,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,2BAA2B,CAAC;QAC7C,gBAAgB,CAAC,EAAE,6BAA6B,CAAC;QACjD,MAAM,CAAC,EAAE,WAAW,CAAC;KACtB,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACzC,aAAa,CAAC;AAOlB,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,sBAAsB,GAAG,mBAAmB,CA6BhG;AAED,wBAAgB,iCAAiC,CAAC,OAAO,GAAE;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACpB,GAAG,sBAAsB,CAqD9B"}