minimal-agent 0.10.0 → 0.12.0

package/src/prompts/skillList.js

@@ -8,47 +8,57 @@
  *       → 不加载完整 SKILL.md（省 token，按需加载）
  *    2. LLM 决定使用某个 skill 时，用 Read 工具读取对应 SKILL.md
  *       → 类似 lazy loading：知道存在 → 需要时才加载详情
- *    3. 格式简洁：每个 skill 固定 2-3 行信息
+ *    3. 格式简洁：每个 skill 固定一行目录项
  *    4. 仅依赖 frontmatter 的 name / description 字段，
  *       不依赖 triggers（并非所有 skill 都声明触发词）。
  * ============================================================
  */
 import { readFile, readdir } from 'node:fs/promises';
 import { join } from 'node:path';
+import { parse } from 'yaml';
 import { getResourceSearchPaths } from '../utils/resourcePaths.js';
-function stripQuotes(s) {
-    const trimmed = s.trim();
-    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
-        (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
-        return trimmed.slice(1, -1);
-    }
-    return trimmed;
-}
 function parseFrontmatter(content, sourceDir) {
     const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
     if (!match)
         return null;
-    const frontmatter = match[1];
-    const nameMatch = frontmatter.match(/^name:\s*(.+)$/m);
-    const descMatch = frontmatter.match(/^description:\s*(.+)$/m);
-    const typeMatch = frontmatter.match(/^type:\s*(.+)$/m);
-    if (!nameMatch || !descMatch)
+    try {
+        const frontmatter = parse(match[1]);
+        if (!frontmatter || typeof frontmatter.name !== 'string' || typeof frontmatter.description !== 'string') {
+            return null;
+        }
+        const metadata = frontmatter.metadata && typeof frontmatter.metadata === 'object'
+            ? frontmatter.metadata
+            : null;
+        const requiresTools = Array.isArray(metadata?.requiresTools)
+            ? metadata.requiresTools.filter((item) => typeof item === 'string')
+            : [];
+        return {
+            name: frontmatter.name.trim(),
+            description: frontmatter.description.trim().replace(/\s+/g, ' '),
+            type: typeof frontmatter.type === 'string' ? frontmatter.type.trim() : undefined,
+            ...(requiresTools.length > 0 ? { requiresTools } : {}),
+            sourceDir,
+        };
+    }
+    catch {
         return null;
-    return {
-        name: stripQuotes(nameMatch[1]),
-        description: stripQuotes(descMatch[1]),
-        type: typeMatch ? stripQuotes(typeMatch[1]) : undefined,
-        sourceDir,
-    };
+    }
 }
-export async function getSkillList() {
+export async function getSkillList(workingDir, availableTools) {
     const skills = [];
     const seenNames = new Set();
     // 双源扫描：cwd 优先 + packageRoot fallback；按数组顺序处理，已注册 name 跳过
-    const searchPaths = getResourceSearchPaths('skills', import.meta.url);
+    const searchPaths = getResourceSearchPaths('skills', import.meta.url, workingDir);
     for (const root of searchPaths) {
         try {
             const entries = await readdir(root, { withFileTypes: true });
+            // ★ 提示词缓存前提：本函数的输出必须**逐字节可复现**。
+            //   readdir 的返回顺序由文件系统决定（APFS/ext4/NTFS 各不相同，同一目录在增删
+            //   文件后也可能重排），不排序的话同一份 skills 目录会生成字节不同的 system
+            //   prompt —— 前缀一变，provider 的自动前缀缓存全部失配。
+            //   按目录名排序把顺序钉死；对已有行为的唯一影响是同源内的呈现次序变为字典序，
+            //   双源覆盖语义（cwd 优先、同名跳过）由外层 searchPaths 顺序决定，不受影响。
+            entries.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
             for (const entry of entries) {
                 if (!entry.isDirectory())
                     continue;
@@ -57,7 +67,10 @@ export async function getSkillList() {
                 try {
                     const content = await readFile(skillPath, 'utf8');
                     const meta = parseFrontmatter(content, sourceDir);
-                    if (meta && !seenNames.has(meta.name)) {
+                    const toolsAvailable = !meta?.requiresTools?.length
+                        || availableTools === undefined
+                        || meta.requiresTools.every((name) => availableTools.has(name));
+                    if (meta && toolsAvailable && !seenNames.has(meta.name)) {
                         seenNames.add(meta.name);
                         skills.push(meta);
                     }
@@ -74,15 +87,14 @@ export async function getSkillList() {
 /**
  * 生成 skill 列表提示词。
  *
- * 输出格式（每个 skill 一张 2-3 行卡片）:
- *   ## skill-name
- *   - **功能**: 一句话描述这个 skill 做什么
- *   - **技能目录**: 绝对路径（`技能目录` 字段名是跨模块契约，
+ * 输出格式（每个 skill 一行）:
+ *   - **skill-name**: 功能描述；**技能目录**: 绝对路径
+ *   `技能目录` 字段名是跨模块契约，
  *     workflow-runner 的 foundation/isolation 测试锁定，勿改）
  *
  * 关键设计决策：
  *   - 不加载 SKILL.md 全文（节省 ~1500+ tokens/skill）
- *   - 只输出 name + description（每个 skill ~30 tokens）
+ *   - 只输出 name + description + 按需读取路径
  *   - 不依赖 triggers 字段（并非所有 skill 都声明触发词）
  *   - LLM 根据 description 语义匹配决定是否使用（不是斜杠激活）
  */
@@ -90,22 +102,71 @@ export function formatSkillHint(skills) {
     if (skills.length === 0) {
         return '';
     }
-    const lines = [];
-    // ---- 标题段（含使用流程，不再单列 code block 重复一遍） ----
-    lines.push('# 可用技能');
-    lines.push('');
-    lines.push('以下技能来自双源扫描（用户项目目录 + minimal-agent 包目录，同名时项目优先）。**当用户需求与某个技能的功能描述匹配时，你应该主动使用它**；用户输入 `@skill(name)` 表示显式指定该技能。');
-    lines.push('使用流程：先用 Read 读取该技能卡片 `**技能目录**` 路径下的 `SKILL.md` 了解完整流程，再按其执行；技能脚本（scripts/）与 SKILL.md 同目录，用绝对路径执行。');
-    lines.push('');
-    // ---- 每个技能的卡片 ----
-    for (const skill of skills) {
-        lines.push(`## ${skill.name}`);
-        lines.push(`- **功能**: ${skill.description}`);
-        if (skill.type)
-            lines.push(`- **类型**: ${skill.type}`);
-        lines.push(`- **技能目录**: \`${skill.sourceDir}\``);
-        lines.push('');
+    const header = [
+        '# Skills',
+        '需求匹配或用户显式写 `@skill(name)` 时，先 Read 对应 SKILL.md，再按其中流程执行。项目 Skill 同名时覆盖内置 Skill。',
+    ];
+    const catalogBudget = MAX_HINT_CHARS - header.join('\n').length - 1;
+    return [...header, ...renderSkillCatalog(skills, catalogBudget)].join('\n');
+}
+const MAX_DESCRIPTION = 180;
+const MAX_HINT_CHARS = 8_000;
+const MAX_OMITTED_NAMES = 8;
+function skillLine(skill, withDescription) {
+    const type = skill.type ? ` [${skill.type}]` : '';
+    const description = withDescription ? ` — ${skill.description.slice(0, MAX_DESCRIPTION)}` : '';
+    return `- ${skill.name}${type}${description} — **技能目录**: \`${skill.sourceDir}\``;
+}
+/**
+ * 预算内的确定性降级阶梯。**先丢描述、再丢条目**——这个顺序是有理由的：
+ * 本目录的全部意义是「让模型知道某个 skill **存在**，需要时再 Read 全文」，
+ * 一个只有名字和路径的条目仍然完成了这个使命，而整条丢弃则让该 skill 彻底隐身。
+ * 旧实现直接从超限处截断并写「其余已省略」，装了很多 skill 的用户会有一批技能
+ * 对模型永久不可见，且看不出丢了哪些。
+ *
+ * 三级：① 全量（名称+描述+目录）② 全量但去掉描述 ③ 去描述后仍超限则截断，
+ * 并**如实报出被丢弃的条数与有限名称预览**（不静默截断，也不让提示本身突破预算）。
+ */
+function omittedNotice(skills, withPreview = true) {
+    const preview = withPreview
+        ? skills.slice(0, MAX_OMITTED_NAMES).map((skill) => skill.name).join('、')
+        : '';
+    return `- （另有 ${skills.length} 个 Skill 未列出${preview ? `，例如：${preview}` : ''}。）`;
+}
+function renderSkillCatalog(skills, budget) {
+    const full = skills.map((skill) => skillLine(skill, true));
+    if (full.join('\n').length <= budget)
+        return full;
+    const compact = skills.map((skill) => skillLine(skill, false));
+    const notice = '- （Skill 数量较多，此处只列名称与目录；需要时 Read 对应 SKILL.md 获取完整说明。）';
+    if ([notice, ...compact].join('\n').length <= budget)
+        return [notice, ...compact];
+    const kept = [];
+    for (let index = 0; index < compact.length; index += 1) {
+        const remaining = skills.slice(index + 1);
+        const candidate = [
+            notice,
+            ...kept,
+            compact[index],
+            ...(remaining.length > 0 ? [omittedNotice(remaining)] : []),
+        ].join('\n');
+        if (candidate.length > budget)
+            break;
+        kept.push(compact[index]);
+    }
+    const dropped = skills.slice(kept.length);
+    let result = [
+        notice,
+        ...kept,
+        ...(dropped.length > 0 ? [omittedNotice(dropped)] : []),
+    ];
+    if (result.join('\n').length > budget && dropped.length > 0) {
+        result = [notice, ...kept, omittedNotice(dropped, false)];
+    }
+    while (result.join('\n').length > budget && kept.length > 0) {
+        kept.pop();
+        const remaining = skills.slice(kept.length);
+        result = [notice, ...kept, omittedNotice(remaining, false)];
     }
-    lines.push('> 💡 技能是工具的组合拳。单个工具是基础操作；技能是针对特定场景的标准化工作流。');
-    return lines.join('\n');
+    return result;
 }

package/src/prompts/skillList.ts

@@ -0,0 +1,198 @@
+/**
+ * ============================================================
+ *  src/prompts/skillList.ts —— Skill 列表生成
+ * ------------------------------------------------------------
+ *  设计原则：
+ *    1. System Prompt 里只注入 frontmatter 元数据轻量列表
+ *       → 让 LLM 知道"有哪些技能可用 + 功能是什么"
+ *       → 不加载完整 SKILL.md（省 token，按需加载）
+ *    2. LLM 决定使用某个 skill 时，用 Read 工具读取对应 SKILL.md
+ *       → 类似 lazy loading：知道存在 → 需要时才加载详情
+ *    3. 格式简洁：每个 skill 固定一行目录项
+ *    4. 仅依赖 frontmatter 的 name / description 字段，
+ *       不依赖 triggers（并非所有 skill 都声明触发词）。
+ * ============================================================
+ */
+
+import { readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parse } from 'yaml';
+
+import { getResourceSearchPaths } from '../utils/resourcePaths.js';
+
+export interface SkillMeta {
+  name: string;
+  description: string;
+  type?: string;
+  /** Hide a Skill when its required model-visible tools are unavailable. */
+  requiresTools?: string[];
+  /** Skill 所在目录的绝对路径（cwd 来源 vs packageRoot 来源都用绝对路径） */
+  sourceDir: string;
+}
+
+function parseFrontmatter(content: string, sourceDir: string): SkillMeta | null {
+  const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
+  if (!match) return null;
+
+  try {
+    const frontmatter = parse(match[1]) as Record<string, unknown> | null;
+    if (!frontmatter || typeof frontmatter.name !== 'string' || typeof frontmatter.description !== 'string') {
+      return null;
+    }
+    const metadata = frontmatter.metadata && typeof frontmatter.metadata === 'object'
+      ? frontmatter.metadata as Record<string, unknown>
+      : null;
+    const requiresTools = Array.isArray(metadata?.requiresTools)
+      ? metadata.requiresTools.filter((item): item is string => typeof item === 'string')
+      : [];
+    return {
+      name: frontmatter.name.trim(),
+      description: frontmatter.description.trim().replace(/\s+/g, ' '),
+      type: typeof frontmatter.type === 'string' ? frontmatter.type.trim() : undefined,
+      ...(requiresTools.length > 0 ? { requiresTools } : {}),
+      sourceDir,
+    };
+  } catch {
+    return null;
+  }
+}
+
+export async function getSkillList(
+  workingDir?: string,
+  availableTools?: ReadonlySet<string>,
+): Promise<SkillMeta[]> {
+  const skills: SkillMeta[] = [];
+  const seenNames = new Set<string>();
+
+  // 双源扫描：cwd 优先 + packageRoot fallback；按数组顺序处理，已注册 name 跳过
+  const searchPaths = getResourceSearchPaths('skills', import.meta.url, workingDir);
+
+  for (const root of searchPaths) {
+    try {
+      const entries = await readdir(root, { withFileTypes: true });
+      // ★ 提示词缓存前提：本函数的输出必须**逐字节可复现**。
+      //   readdir 的返回顺序由文件系统决定（APFS/ext4/NTFS 各不相同，同一目录在增删
+      //   文件后也可能重排），不排序的话同一份 skills 目录会生成字节不同的 system
+      //   prompt —— 前缀一变，provider 的自动前缀缓存全部失配。
+      //   按目录名排序把顺序钉死；对已有行为的唯一影响是同源内的呈现次序变为字典序，
+      //   双源覆盖语义（cwd 优先、同名跳过）由外层 searchPaths 顺序决定，不受影响。
+      entries.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+
+        const sourceDir = join(root, entry.name);
+        const skillPath = join(sourceDir, 'SKILL.md');
+
+        try {
+          const content = await readFile(skillPath, 'utf8');
+          const meta = parseFrontmatter(content, sourceDir);
+
+          const toolsAvailable = !meta?.requiresTools?.length
+            || availableTools === undefined
+            || meta.requiresTools.every((name) => availableTools.has(name));
+          if (meta && toolsAvailable && !seenNames.has(meta.name)) {
+            seenNames.add(meta.name);
+            skills.push(meta);
+          }
+        } catch {
+        }
+      }
+    } catch {
+    }
+  }
+
+  return skills;
+}
+
+/**
+ * 生成 skill 列表提示词。
+ *
+ * 输出格式（每个 skill 一行）:
+ *   - **skill-name**: 功能描述；**技能目录**: 绝对路径
+ *   `技能目录` 字段名是跨模块契约，
+ *     workflow-runner 的 foundation/isolation 测试锁定，勿改）
+ *
+ * 关键设计决策：
+ *   - 不加载 SKILL.md 全文（节省 ~1500+ tokens/skill）
+ *   - 只输出 name + description + 按需读取路径
+ *   - 不依赖 triggers 字段（并非所有 skill 都声明触发词）
+ *   - LLM 根据 description 语义匹配决定是否使用（不是斜杠激活）
+ */
+export function formatSkillHint(skills: SkillMeta[]): string {
+  if (skills.length === 0) {
+    return '';
+  }
+
+  const header = [
+    '# Skills',
+    '需求匹配或用户显式写 `@skill(name)` 时，先 Read 对应 SKILL.md，再按其中流程执行。项目 Skill 同名时覆盖内置 Skill。',
+  ];
+  const catalogBudget = MAX_HINT_CHARS - header.join('\n').length - 1;
+  return [...header, ...renderSkillCatalog(skills, catalogBudget)].join('\n');
+}
+
+const MAX_DESCRIPTION = 180;
+const MAX_HINT_CHARS = 8_000;
+const MAX_OMITTED_NAMES = 8;
+
+function skillLine(skill: SkillMeta, withDescription: boolean): string {
+  const type = skill.type ? ` [${skill.type}]` : '';
+  const description = withDescription ? ` — ${skill.description.slice(0, MAX_DESCRIPTION)}` : '';
+  return `- ${skill.name}${type}${description} — **技能目录**: \`${skill.sourceDir}\``;
+}
+
+/**
+ * 预算内的确定性降级阶梯。**先丢描述、再丢条目**——这个顺序是有理由的：
+ * 本目录的全部意义是「让模型知道某个 skill **存在**，需要时再 Read 全文」，
+ * 一个只有名字和路径的条目仍然完成了这个使命，而整条丢弃则让该 skill 彻底隐身。
+ * 旧实现直接从超限处截断并写「其余已省略」，装了很多 skill 的用户会有一批技能
+ * 对模型永久不可见，且看不出丢了哪些。
+ *
+ * 三级：① 全量（名称+描述+目录）② 全量但去掉描述 ③ 去描述后仍超限则截断，
+ * 并**如实报出被丢弃的条数与有限名称预览**（不静默截断，也不让提示本身突破预算）。
+ */
+function omittedNotice(skills: SkillMeta[], withPreview = true): string {
+  const preview = withPreview
+    ? skills.slice(0, MAX_OMITTED_NAMES).map((skill) => skill.name).join('、')
+    : '';
+  return `- （另有 ${skills.length} 个 Skill 未列出${preview ? `，例如：${preview}` : ''}。）`;
+}
+
+function renderSkillCatalog(skills: SkillMeta[], budget: number): string[] {
+  const full = skills.map((skill) => skillLine(skill, true));
+  if (full.join('\n').length <= budget) return full;
+
+  const compact = skills.map((skill) => skillLine(skill, false));
+  const notice = '- （Skill 数量较多，此处只列名称与目录；需要时 Read 对应 SKILL.md 获取完整说明。）';
+  if ([notice, ...compact].join('\n').length <= budget) return [notice, ...compact];
+
+  const kept: string[] = [];
+  for (let index = 0; index < compact.length; index += 1) {
+    const remaining = skills.slice(index + 1);
+    const candidate = [
+      notice,
+      ...kept,
+      compact[index]!,
+      ...(remaining.length > 0 ? [omittedNotice(remaining)] : []),
+    ].join('\n');
+    if (candidate.length > budget) break;
+    kept.push(compact[index]!);
+  }
+
+  const dropped = skills.slice(kept.length);
+  let result = [
+    notice,
+    ...kept,
+    ...(dropped.length > 0 ? [omittedNotice(dropped)] : []),
+  ];
+  if (result.join('\n').length > budget && dropped.length > 0) {
+    result = [notice, ...kept, omittedNotice(dropped, false)];
+  }
+  while (result.join('\n').length > budget && kept.length > 0) {
+    kept.pop();
+    const remaining = skills.slice(kept.length);
+    result = [notice, ...kept, omittedNotice(remaining, false)];
+  }
+  return result;
+}

package/src/prompts/system.js

@@ -7,19 +7,44 @@
  *  本文件保留为向后兼容的委托壳，现有调用方无需改动。
  *
  *  新代码请直接使用：
- *    - assembleBasePrompt()     → 完整 5 层基础内核
+ *    - assembleBasePrompt()     → 按 Profile 和实际工具组装基础内核
  * ============================================================
  */
-import { assembleBasePrompt } from './promptAssembly.js';
+import { assembleBasePrompt, assemblePromptEnvelope, assembleStablePrompt, } from './promptAssembly.js';
+export { buildTransientBundle, buildTransientContext, buildTransientLayer, buildTransientPromptBundle } from './promptAssembly.js';
+/**
+ * 只取**稳定层**作为 system 消息内容 —— 提示词缓存的主入口。
+ *
+ * `buildFullSystemPrompt` 是历史兼容名称，目前同样只返回稳定层。宿主应当：
+ *   1. 用本函数拿 base 建 history[0]（每会话一次）
+ *   2. 每回合另调 buildTransientContext() 拿易变层，经 RunQueryOptions.transientContext 下传
+ *      （loop 会把它附加到本轮用户消息的模型副本，不污染历史）
+ */
+export async function buildBaseSystemPrompt(cwd, tools, profile = 'main') {
+    return assembleStablePrompt({
+        cwd,
+        tools,
+        profile,
+    });
+}
 /**
  * @deprecated 新代码请直接用 assembleBasePrompt()
  */
-export async function getSystemPrompt(cwd, tools) {
-    return assembleBasePrompt({ cwd, tools });
+export async function getSystemPrompt(cwd, tools, profile = 'main') {
+    return assembleBasePrompt({ cwd, tools, profile });
 }
 /**
  * @deprecated 新代码请直接用 assembleBasePrompt({ includeProjectInstructions: true })
  */
-export async function buildFullSystemPrompt(cwd, tools) {
-    return assembleBasePrompt({ cwd, tools, includeProjectInstructions: true });
+export async function buildFullSystemPrompt(cwd, tools, profile = 'main') {
+    return assembleBasePrompt({ cwd, tools, profile, includeProjectInstructions: true });
+}
+export async function buildSystemPromptEnvelope(cwd, tools, runtime, profile = 'main') {
+    return assemblePromptEnvelope({
+        cwd,
+        tools,
+        profile,
+        includeProjectInstructions: true,
+        runtime,
+    });
 }

package/src/prompts/system.ts

@@ -0,0 +1,81 @@
+/**
+ * ============================================================
+ *  src/prompts/system.ts —— 系统提示词（向后兼容壳）
+ * ------------------------------------------------------------
+ *
+ *  所有提示词组装逻辑已迁移到 promptAssembly.ts。
+ *  本文件保留为向后兼容的委托壳，现有调用方无需改动。
+ *
+ *  新代码请直接使用：
+ *    - assembleBasePrompt()     → 按 Profile 和实际工具组装基础内核
+ * ============================================================
+ */
+
+import type { Tool } from '../types.js';
+import {
+  assembleBasePrompt,
+  assemblePromptEnvelope,
+  assembleStablePrompt,
+  type PromptEnvelope,
+  type PromptProfile,
+  type PromptRuntimeContext,
+} from './promptAssembly.js';
+
+export { buildTransientBundle, buildTransientContext, buildTransientLayer, buildTransientPromptBundle } from './promptAssembly.js';
+
+/**
+ * 只取**稳定层**作为 system 消息内容 —— 提示词缓存的主入口。
+ *
+ * `buildFullSystemPrompt` 是历史兼容名称，目前同样只返回稳定层。宿主应当：
+ *   1. 用本函数拿 base 建 history[0]（每会话一次）
+ *   2. 每回合另调 buildTransientContext() 拿易变层，经 RunQueryOptions.transientContext 下传
+ *      （loop 会把它附加到本轮用户消息的模型副本，不污染历史）
+ */
+export async function buildBaseSystemPrompt(
+  cwd: string,
+  tools: Tool[],
+  profile: PromptProfile = 'main',
+): Promise<string> {
+  return assembleStablePrompt({
+    cwd,
+    tools,
+    profile,
+  });
+}
+
+/**
+ * @deprecated 新代码请直接用 assembleBasePrompt()
+ */
+export async function getSystemPrompt(
+  cwd: string,
+  tools: Tool[],
+  profile: PromptProfile = 'main',
+): Promise<string> {
+  return assembleBasePrompt({ cwd, tools, profile });
+}
+
+/**
+ * @deprecated 新代码请直接用 assembleBasePrompt({ includeProjectInstructions: true })
+ */
+export async function buildFullSystemPrompt(
+  cwd: string,
+  tools: Tool[],
+  profile: PromptProfile = 'main',
+): Promise<string> {
+  return assembleBasePrompt({ cwd, tools, profile, includeProjectInstructions: true });
+}
+
+export async function buildSystemPromptEnvelope(
+  cwd: string,
+  tools: Tool[],
+  runtime: Partial<PromptRuntimeContext>,
+  profile: PromptProfile = 'main',
+): Promise<PromptEnvelope> {
+  return assemblePromptEnvelope({
+    cwd,
+    tools,
+    profile,
+    includeProjectInstructions: true,
+    runtime,
+  });
+}

package/src/runtime/agentRuntimeContext.js

@@ -0,0 +1,53 @@
+import { isMemoryToolName } from '../tools/capabilities.js';
+export function normalizeMemoryAccess(access) {
+    return access === 'local-owner' ? 'read-write' : access ?? 'denied';
+}
+/** Only a local owner can receive memory access; untrusted hosts are always denied. */
+export function createAgentRuntimeContext(input) {
+    const owner = input.owner ?? 'untrusted';
+    const memoryAccess = owner === 'local-owner'
+        ? normalizeMemoryAccess(input.memoryAccess)
+        : 'denied';
+    return Object.freeze({
+        ...input,
+        owner,
+        memoryAccess,
+    });
+}
+export function filterToolsForRuntime(tools, runtime, resolvedAvailability) {
+    return tools.filter((tool) => (resolvedAvailability?.get(tool)?.available
+        ?? tool.resolveAvailability?.(runtime).available
+        ?? true)
+        && (memoryToolAllowed(tool.name, runtime.memoryAccess))
+        && (tool.name !== 'WebBrowser' || webBrowserAllowed(runtime))
+        && (tool.name !== 'ComputerUse' || runtime.computer !== undefined));
+}
+/** WebBrowser is the Desktop main Agent's visible, human-supervised automation surface. */
+export function webBrowserAllowed(runtime) {
+    return runtime.surface === 'desktop'
+        && runtime.profile === 'main'
+        && runtime.browser?.supervised === true;
+}
+const READ_ONLY_MEMORY_TOOLS = new Set([
+    'RecallMemory',
+    'ListMemories',
+    'ReviewMemories',
+    'SearchConversations',
+]);
+export function memoryToolAllowed(name, access) {
+    if (!isMemoryToolName(name))
+        return true;
+    if (access === 'read-write')
+        return true;
+    return access === 'read-only' && READ_ONLY_MEMORY_TOOLS.has(name);
+}
+export function isMemoryTool(name) {
+    return isMemoryToolName(name);
+}
+export function memoryContextFromRuntime(runtime) {
+    return {
+        access: runtime.memoryAccess,
+        ...(runtime.workspaceId ? { workspaceId: runtime.workspaceId } : {}),
+        ...(runtime.sessionId ? { sessionId: runtime.sessionId } : {}),
+    };
+}