@epoch-agent/core 0.14.0 → 0.15.0

package/dist/index.d.ts

@@ -1983,7 +1983,7 @@ declare function createScheduleDraftTool(deps: ScheduleDraftDeps): EpochTool;
  *
  * 方案 48 §七 挂着「归档会话搜不到符不符合用户预期」，而 PR-1 之后的落地被记成了
  * **一处不对称**（`session_search` 过滤 `archived`，`session_messages_search`
- * 给了 id 就搜得到）。逐处核过八个入口之后的结论是：**那不是不对称，
+ * 给了 id 就搜得到）。逐处核过九个入口之后的结论是：**那不是不对称，
  * 是同一条规则的两侧。**
  *
  * | 入口                              | 提问方式                 | 归档会话                  | 落点                                     |
@@ -1992,12 +1992,13 @@ declare function createScheduleDraftTool(deps: ScheduleDraftDeps): EpochTool;
  * | `session_messages_search`         | 必须给 sessionId         | **搜得到**                | `query.ts` `searchMessages`              |
  * | `session_messages_read`           | 给 sessionId + messageId | **读得到**                | `query.ts` `readMessages`                |
  * | `session_trace`                   | 必须给 sessionId         | **列得出，标 `archived`** | `trace.ts`（判据在那个文件头）           |
+ * | `session_list`（开给模型）        | 不指名                   | **不列**，可显式要        | `query.ts` `listSessions`                |
  * | `@:` 补全面板（方案 53）          | 边打边列，不指名         | **不列**                  | `reference.ts` `listSessionCandidates`   |
  * | `@:` 完整 sessionId               | 指名道姓                 | **引用得到**              | `reference.ts` `resolveSessionReference` |
  * | `@:` id 前缀 / 标题子串           | 模糊搜                   | **引用不到**              | `reference.ts` `uniqueOf`                |
  * | TUI / CLI 的会话列表（给人）      | 不指名                   | **不列**，可显式要        | `db.ts` `listSessions`                   |
  *
- * 八处合起来是一句话：
+ * 九处合起来是一句话：
  *
  * > **归档 = 从列表和模糊搜里收起来，不是不许读。**
  * > 手上没有那段会话的 id 就碰不到它；明确给了 id 就是明确指名，照旧读得到。
@@ -2017,15 +2018,29 @@ declare function createScheduleDraftTool(deps: ScheduleDraftDeps): EpochTool;
  *    等于把标题一个字一个字探出来。**归档走的是同一条线、同一个理由**，
  *    两个方案（48 / 53）因此不需要各判一次
  *
- * ⚠️ 于是模型仍然有一条路走到归档会话：`session_trace` 会把它列在血缘链上并标
- * `archived`，拿着那个 id 就能进去搜 / 读。**这是刻意的** ——「它在不在链上」
- * 和「能不能进去看」是两个问题（判据全文在 `trace.ts` 文件头）。反过来说，
- * 一个**没有**血缘关系、又不在链上的归档会话，模型没有办法凭检索发现它。
+ * ⚠️ 于是模型有两条路走到归档会话，**两条都是刻意的**：
+ *
+ * - `session_trace` 会把它列在血缘链上并标 `archived`，拿着那个 id 就能进去搜 / 读
+ *   ——「它在不在链上」和「能不能进去看」是两个问题（判据全文在 `trace.ts` 文件头）
+ * - `session_list` 传 `archived: 'only'` / `'all'` 就列得出来。**这一档是显式要的**
+ *   （默认那一档不列），和人那一侧 `db.ts listSessions` 的 `archived` 开关逐字同形
+ *
+ * ### ⚠️ 2026-09-20：「模型发现不了归档会话」这条性质没有了
+ *
+ * `session_list` 之前这里写的是「一个**没有**血缘关系、又不在链上的归档会话，模型
+ * 没有办法凭检索发现它」。那句话现在**不成立**了 —— 传一个 `archived` 就列得出来。
+ *
+ * 这不是把上面那条规则改松了，是那条规则本来就没管这件事：它说的是「模糊搜够不着」，
+ * 而 `session_list` 不是模糊搜，它是**指名要归档那一档**（同一个工具的默认档照旧
+ * 不列）。真正变的是**那条性质从此不该再被人当成安全保证引用** —— 它当初是
+ * 「没人给模型开列表工具」的副产物，不是任何一处刻意守的东西。要那条保证的话，
+ * 唯一的实现方式是让归档参与 `resolveSessionVisibility`，而那就是「归档 = 不许读」，
+ * 上面三条理由逐条反对它。
  *
  * ### 这条判据只有这一个家
  *
- * 别在四个工具的描述、八处 SQL 的行内注释里各抄一遍 —— 那种抄写不会变红，
- * 只会在有人改了一处之后变成七句错的话。上面那张表由
+ * 别在五个工具的描述、九处 SQL 的行内注释里各抄一遍 —— 那种抄写不会变红，
+ * 只会在有人改了一处之后变成八句错的话。上面那张表由
  * `core/__tests__/session-archived-scope.test.ts` **两层**钉住：行为层逐个入口
  * 断两个方向（归档的搜不到 / 给了 id 就搜得到），结构层扫源码，
  * 保证**新加的查询必须先在那份表里登记立场**。
@@ -2337,6 +2352,59 @@ interface ReadMessagesOutput {
     /** 这段会话一共多少条。让模型知道自己这个窗口在整段里占多少 */
     total: number;
 }
+/**
+ * 归档那一档怎么列。**三个值，不是布尔**。
+ *
+ * 人那一侧（`SessionDB.listSessions`）用的是 `boolean | 'any'`，而那个形状有两个
+ * 毛病落到模型这一侧会变成真缺陷：`true` 的意思是「**只**列归档的」（不是「也列」），
+ * 而 JSON Schema 表达不了 `boolean | 'any'` —— 写成 `type: 'boolean'` 就永远够不着
+ * 第三档。所以这一层换成显式三值，映射在 {@link SessionQueries.listSessions} 里。
+ */
+type ArchivedScope = 'exclude' | 'only' | 'all';
+/**
+ * 列表里的一段会话。**比 `SessionMeta` 窄得多**，那是刻意的。
+ *
+ * `SessionMeta` 有 25 个字段（token 分项、gitBranch、rewindCount…），而这个工具
+ * 回答的是「我都有哪些会话、哪段值得进去看」。多给的每一个字段都要占工具输出的
+ * 字符预算，而模型在这一步一个都用不上。
+ *
+ * ⚠️ **`preview` 不在这里，而且不许加**：`manager.ts` 那条「`tags` / `preview`
+ * 恒空」说的是全仓没有任何一处会写这两列。加进来等于每段会话多一个恒空字段，
+ * 然后模型据此以为「这段会话没内容」。
+ */
+interface SessionListEntry {
+    sessionId: string;
+    /** 用户改过名就是那个名，否则是自动标题（首条消息前 50 字） */
+    title: string;
+    cwd?: string | undefined;
+    /**
+     * 最后活动时间（毫秒）。取 `COALESCE(updated_at, started_at)` 而不是裸列 ——
+     * 读侧的 `rowToMeta` 就是这么兜的，裸取会让一行 `updated_at` 是 NULL 的会话
+     * 排到 1970 年去。
+     */
+    updatedAt: number;
+    messageCount: number;
+    archived: boolean;
+    /** 这段会话是不是「你自己」。渲染那一侧要标出来 */
+    isCurrent: boolean;
+}
+interface SessionListInput extends Omit<SessionVisibilityInput, 'db'> {
+    /** 回几段。调用方负责夹紧上下限 */
+    limit: number;
+    /** 默认 `'exclude'`（不列归档的），判据见 `authorization.ts` 那张表 */
+    archived?: ArchivedScope;
+}
+interface SessionListOutput {
+    sessions: SessionListEntry[];
+    /**
+     * 这个范围里**一共**多少段（不受 `limit` 影响）。
+     *
+     * 少了它，一份被 `limit` 截过的列表和一份本来就这么短的列表长得一模一样，
+     * 而模型会据此下结论（「我一共就这 10 段会话」）。同 `session_trace` 的
+     * `truncated` 那条判据。
+     */
+    total: number;
+}
 /**
  * 会话检索。**这一层只查库，不管权限级别、不管工具协议** —— 那些在工具那一侧。
  */
@@ -2389,6 +2457,31 @@ declare class SessionQueries {
      * 库连接和授权判定接上去 —— 让工具那一侧只认识 `SessionQueries` 一个门面。
      */
     trace(input: TraceInput): SessionTrace;
+    /**
+     * 列出可读范围内的会话 —— **这一族里唯一不要检索词的那个**。
+     *
+     * ## 为什么不复用 `SessionDB.listSessions`
+     *
+     * 同文件头那条「这一层为什么不长在 db.ts 里」：那一份服务的是人，**没有授权层**
+     * （人本来就有权看自己机器上全部会话），它只认 `cwd` 不认血缘链。把 `visClause`
+     * 塞进 `ListSessionsInput` 等于把鉴权概念漏进人那一侧的 API，而那个接口还开给了
+     * 增量备份、TUI、REST 三个调用方 —— 它们谁都不该被迫理解「血缘」。
+     *
+     * 于是这里是第二份 SQL，但**判定只有一份**（`resolveSessionVisibility`），
+     * 那才是会走散的那一半。
+     *
+     * ## 排序固定「最后活动倒序」
+     *
+     * 不开 `sortKey`、不开游标：模型问的是「我最近在干什么」，而翻页是人那一侧的
+     * 需求（那边有游标、有四个排序键）。少一个参数就少一条模型会猜错的路。
+     *
+     * ## 归档：默认不列，显式要才给
+     *
+     * 和人那一侧逐字同形。判据**一个字都不在这儿**，在
+     * [authorization.ts](./authorization.js) 文件头那张入口表上 —— 这里只是那张表的
+     * 一个落点，别在这儿再写一遍理由（那种抄写不会变红，只会变成一句错的话）。
+     */
+    listSessions(input: SessionListInput): SessionListOutput;
     /**
      * 正文命中。`archived = 0` 与人那一侧保持一致 —— 归档是「用户把它收起来了」，
      * 模型不该从收起来的地方翻东西出来。
@@ -2513,7 +2606,7 @@ declare function createSessionMessagesSearchTool(deps: SessionSearchDeps): Epoch
  * 对外这一族就叫「会话检索」（[docs/TOOLS.md](../../../../../docs/TOOLS.md)
  * 的「翻历史会话」那一节）。
  *
- * 这四个名字的真源是 `session/query.ts` 的 `SESSION_QUERY_TOOLS`，
+ * 这五个名字的真源是 `session/query.ts` 的 `SESSION_QUERY_TOOLS`，
  * `__tests__/session-query-sites.test.ts` 对着它比这里的返回值。
  */
 declare function createSessionSearchTools(deps: SessionSearchDeps): EpochTool[];
@@ -5632,6 +5725,9 @@ declare function updatePlugin(name: string, opts: InstallOptions): Promise<Insta
  *   "name": "acme",
  *   "owner": { "name": "Acme Inc." },
  *   "display": { "fields": ["status", "downloads", "author"] },
+ *   "categories": [
+ *     { "id": "dev", "label": "开发", "children": [{ "id": "lint", "label": "静态检查" }] }
+ *   ],
  *   "plugins": [
  *     {
  *       "name": "toolkit",
@@ -5660,6 +5756,17 @@ declare function updatePlugin(name: string, opts: InstallOptions): Promise<Insta
  * ⚠️ **整格不写 = 照旧「填了就画」** —— 存量目录一个字都不用改，
  * 判据在 `DisplaySchema.fields` 上那张三行的表。
  *
+ * ## 顶上那格 `categories`：**市场自己声明分类的层级**（2026-09-21）
+ *
+ * 在它之前分类只有一层 —— `category` 是一个自由字符串，界面把出现过的那些一字排开。
+ * 一份分得细的目录（「办公 → 表格 / 文档 / 幻灯」）表达不出那个「→」。
+ *
+ * 这一格是一棵树，而**条目那一侧引用的仍旧是裸 id**（`category: "sheet"`），
+ * 不是路径。于是存量目录补一棵树**不用动任何一条插件**，判据全文和另一条理由
+ * （「分类名里本来就能有 `/`」）在 {@link CategoryNodeSchema} 上。
+ * ⚠️ **整格不写 = 没有层级**，界面退回 2026-09-17 那一档（每个出现过的分类各一行），
+ * 而一棵**写坏的**树同样退回那一档 —— 判据在 {@link CategoriesSchema} 上。
+ *
  * ## ⚠️ 「没有上传接口」这句话 2026-09-08 改了半句
  *
  * 原话是「没有服务端、没有账号、**没有上传接口**、没有审核」。改的是第三句 ——
@@ -5750,6 +5857,33 @@ type MarketplaceDisplayField = (typeof MARKETPLACE_DISPLAY_FIELDS)[number];
 declare const DisplaySchema: z.ZodObject<{
     fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
+/**
+ * 分类树里的一个节点（2026-09-21）。
+ *
+ * ## ⚠️ 条目那一侧引用的是**裸 id**，不是一条 `办公/表格` 那样的路径
+ *
+ * 也就是说 {@link EntrySchema} 的 `category` **一个字都没改** —— 它今天是什么形状
+ * 明天还是什么形状，变的只是「那串字符现在可以被这棵树放进层级里」。两条判据：
+ *
+ * 1. **存量目录加一棵树不用动任何一条插件。** 一份写着 `category: "dev"` 的目录，
+ *    只要在顶上补一个 `{ "id": "dev", "label": "开发" }`，那一批条目当场归位。
+ *    换成路径引用的话，加一层层级 = 把每一条 `category` 都重写一遍；
+ * 2. **不必再定义「分类名里出现 `/` 怎么办」。** 分类是自由字符串（那一格从落地起
+ *    就是 `z.string().min(1)`），一份目录里真的能有一条 `category: "a/b"`，
+ *    而路径引用会把它和「a 下面的 b」撞成同一个东西，且类型上一点问题都没有。
+ *
+ * 代价是 **id 必须全树唯一** —— 由 {@link CategoriesSchema} 那道 `superRefine` 管。
+ *
+ * ⚠️ `label` 可缺省，缺省就是 `id` 本身（补齐那一下在网线那一层做，判据在
+ * protocol 的 `WirePluginCategory.label` 上：界面要的是结论，不是「缺了自己兜着」）。
+ * ⚠️ **`label` 不翻译**，口径逐字同 `plug_cat_*` 那三句文案上的 ⚠️：一份中文目录里
+ * 那个词本来就是中文，翻了的话用户搜到的和看到的对不上。
+ */
+interface MarketplaceCategoryInput {
+    id: string;
+    label?: string;
+    children?: MarketplaceCategoryInput[];
+}
 declare const CatalogSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
@@ -5760,6 +5894,7 @@ declare const CatalogSchema: z.ZodObject<{
     display: z.ZodOptional<z.ZodObject<{
         fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
+    categories: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodType<MarketplaceCategoryInput, unknown, z.core.$ZodTypeInternals<MarketplaceCategoryInput, unknown>>>>>;
     plugins: z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         description: z.ZodOptional<z.ZodString>;
@@ -5805,6 +5940,7 @@ declare const RecordSchema: z.ZodObject<{
         display: z.ZodOptional<z.ZodObject<{
             fields: z.ZodOptional<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>;
+        categories: z.ZodCatch<z.ZodOptional<z.ZodArray<z.ZodType<MarketplaceCategoryInput, unknown, z.core.$ZodTypeInternals<MarketplaceCategoryInput, unknown>>>>>;
         plugins: z.ZodArray<z.ZodObject<{
             name: z.ZodString;
             description: z.ZodOptional<z.ZodString>;
@@ -5839,6 +5975,8 @@ declare const RecordSchema: z.ZodObject<{
 }, z.core.$strip>;
 type MarketplaceEntry = z.infer<typeof EntrySchema>;
 type MarketplaceCatalog = z.infer<typeof CatalogSchema>;
+/** 分类树里的一个节点（2026-09-21）。判据在 {@link CategoryNodeSchema} 上 */
+type MarketplaceCategory = MarketplaceCategoryInput;
 type MarketplaceRecord = z.infer<typeof RecordSchema>;
 /** 这一条在市场那一侧的档口，见 `EntrySchema.status` 上那张四行的表 */
 type MarketplaceStatus = NonNullable<MarketplaceEntry['status']>;
@@ -5863,6 +6001,29 @@ type MarketplaceDisplay = z.infer<typeof DisplaySchema>;
  * 那张表上。
  */
 declare function projectEntryForDisplay(entry: MarketplaceEntry, display: MarketplaceDisplay | undefined): MarketplaceEntry;
+/**
+ * 这个市场允许印这一格吗（2026-09-21 从 {@link projectEntryForDisplay} 里提出来的）。
+ *
+ * ## 为什么要提出来：**分类树不是条目上的一格，但它吃同一条规矩**
+ *
+ * `display.fields` 里没有 `category` 的时候，上面那个函数会把每一条的 `category`
+ * 抹掉 —— 而 2026-09-21 新加的那棵 `categories` 树挂在**目录顶上**，不经过它。
+ * 于是会出现一个自相矛盾的界面：一棵画出来的分类树，每一枝都是 0，
+ * 全部插件挤在「未分类」里 —— **一棵永远匹配不到任何东西的导航树**。
+ *
+ * 那一档在这一格之前是**画都不画**的（可筛的桶只剩「未分类」一个，
+ * 少于 2 就整个不画），所以这是一次真实的倒退，不是一个新场景。
+ *
+ * ⚠️ **提的是「许不许」这条判断，不是又做一遍投影**：文件头那条
+ * 「一个问题只该有一个答案」原样成立 —— 名单和语义（`undefined` = 全画、
+ * `[]` = 一格都不画、认不得的名字不起作用）仍旧只有这一处定义，
+ * 两个出口（条目那一侧、市场行那一侧）读的是同一个函数。
+ *
+ * ⚠️ **只认 {@link MARKETPLACE_DISPLAY_FIELDS} 里那几个名字**：`fields` 的值域是
+ * `string[]`（判据在 `DisplaySchema.fields` 上：写成 enum 的话，一份用了未来版本
+ * 格子名的目录会让整份清单退回 fallback），所以认不得的名字落进来也不起作用。
+ */
+declare function displayAllows(display: MarketplaceDisplay | undefined, field: MarketplaceDisplayField): boolean;
 interface MarketplaceOptions {
     /** `marketplacesPath(homeDir)` */
     statePath: string;
@@ -11860,7 +12021,7 @@ declare function isSettingWriteLayer(value: string): value is SettingWriteLayer;
  * 安全中心指两件事（「新会话从哪一档起」vs「这个会话此刻哪一档」），
  * 而那正是决定 20 ④ 拆开的那个歧义 —— 记住上一次那一档没有把这个歧义请回来。
  */
-declare const SETTING_WRITE_KEYS: readonly ["model", "maxTurns", "models.utility", "fallback.model", "contextLength", "maxOutputTokens", "compression.enabled", "compression.threshold", "memory.memoryCharLimit", "memory.userCharLimit", "memory.indexCharLimit", "budget.maxCostUsd", "budget.maxTokens", "budget.warnAtPercent", "budget.onUnknownPricing", "sessions.autoPrune", "sessions.retentionDays", "sessions.vacuumAfterPrune", "automation.keepRuns", "automation.maxRecordingMb", "permission"];
+declare const SETTING_WRITE_KEYS: readonly ["model", "maxTurns", "models.utility", "fallback.model", "contextLength", "maxOutputTokens", "compression.enabled", "compression.threshold", "memory.memoryCharLimit", "memory.userCharLimit", "memory.indexCharLimit", "budget.maxCostUsd", "budget.maxTokens", "budget.warnAtPercent", "budget.onUnknownPricing", "sessions.autoPrune", "sessions.retentionDays", "sessions.vacuumAfterPrune", "automation.keepRuns", "automation.maxRecordingMb", "sessionSearch.allWorkspaces", "permission"];
 type SettingWriteKey = (typeof SETTING_WRITE_KEYS)[number];
 /** 这个键写得进去吗。名单就是 {@link SETTING_WRITE_KEYS} 本身，别在别处抄一份字面量 */
 declare function isWritableSettingKey(value: string): value is SettingWriteKey;
@@ -13058,6 +13219,41 @@ interface RestorePartsOptions {
 }
 /** 落盘部件 → 内存部件。文件没了就退化成占位文本，不抛 */
 declare function restoreParts(parts: readonly PersistedPart[], opts: RestorePartsOptions): EpochContentPart[];
+/** {@link importParts} 的结果。带 base64 的部件会让整条走不通，所以不是「尽力而为」 */
+type ImportPartsResult = {
+    ok: true;
+    parts: PersistedPart[];
+}
+/** `detail` 是**机器可读**的定位串（`image:base64` 之类），不是给人看的文案 */
+ | {
+    ok: false;
+    detail: string;
+};
+/**
+ * 内存部件 → 落盘部件，**给导入用**：`restoreParts(..., {inlineImages:false})` 的真逆。
+ *
+ * ## 为什么不能直接用 `persistParts()`
+ *
+ * 因为那两个函数在图片上**不是一对逆运算**，而类型系统看不出来（两边都是
+ * `string`）。`restoreParts` 在 `inlineImages:false` 这一支吐的是**绝对路径**
+ * （上面第 243 行），而 `persistParts` 见到一个不带 `https?:` 的字符串就当它是
+ * **base64**（第 174 行）—— 把读出来的路径原样喂回去，`Buffer.from(路径,'base64')`
+ * 会把那串路径当乱码解出来几十个字节写进 artifact 目录，得到一张坏图，
+ * 而且**全程不抛**。所以搬运必须走这条单独的路。
+ *
+ * ## 见到 base64 一律拒，不是「尽力落盘」
+ *
+ * 落盘要写文件，而导入是在一个事务里搬一整段会话 —— 半路去写磁盘意味着事务
+ * 回滚之后 artifact 目录里留着一堆没人引用的文件。更根本的是：带 base64 的部件
+ * 说明上游拿错了形态（该给 `loadMessages()` 的输出，给成了喂模型那一份），
+ * 这时候闷头把它写下来只会让错误更晚才暴露。
+ *
+ * ⚠️ 路径判定用 `isAbsolute()`，**跟着本机平台走**。跨系统搬（macOS 的
+ * `/Users/…` 导进 Windows）时路径判定过得去，但那个文件在本机并不存在 ——
+ * 这一层不去 `stat` 它：图片丢了是 `restoreParts` 早就处理好的一档
+ * （退化成「图片已不可用」占位），而为了它多一次磁盘往返不值。
+ */
+declare function importParts(parts: readonly EpochContentPart[]): ImportPartsResult;
 /**
  * 剥掉 artifact 的 `data`，只留 `path` 引用。
  *
@@ -13399,9 +13595,32 @@ interface ListSessionsInput {
      */
     sortKey?: 'startedAt' | 'updatedAt' | 'messageCount' | 'title';
     direction?: 'asc' | 'desc';
-    archived?: boolean;
+    /**
+     * **三态，不是二态** —— `undefined` 和 `false` 是同一个意思（只列没归档的），
+     * 所以在 `'any'` 之前，「归档的和没归档的一起列」这句话**没有任何写法能表达**。
+     * 判据在 `SessionDB.listSessions` 的 `archived` 分支上：`!== undefined` 才拼
+     * `AND archived = @archived`，`undefined` 走的 `else` 拼的是 `AND archived = 0`。
+     *
+     * | 值 | 列哪些 |
+     * | --- | --- |
+     * | `undefined` / `false` | 只列没归档的 |
+     * | `true` | **只**列归档的 |
+     * | `'any'` | 两边都列 |
+     *
+     * 要「一次列全」的是增量备份这类调用方：它问的是「这台机器上现在有哪些会话」，
+     * 归没归档是会话自己的一个属性，漏掉归档的那批等于备份缺行。
+     */
+    archived?: boolean | 'any';
     pinnedOnly?: boolean;
     cwd?: string;
+    /**
+     * 只列 `updatedAt` **严格晚于**这个时刻的（ms 时间戳）。给增量拉取用。
+     *
+     * ⚠️ 严格 `>` 意味着**同毫秒的行会漏** —— 把上一趟拿到的最大 `updatedAt` 原样
+     * 当下一趟的水位线，会漏掉和它同一毫秒落下的那些行。调用方要自己往回退一点
+     * 再传进来（我们这边的同步层退 2s），代价只是重复拉几行、而那是幂等的。
+     */
+    updatedSince?: number;
 }
 interface ListSessionsOutput {
     sessions: SessionMeta[];
@@ -13443,6 +13662,115 @@ interface SessionStats {
     totalCostUsd: number;
     avgMessagesPerSession: number;
 }
+/**
+ * 导入一条消息。
+ *
+ * **和 {@link AppendMessageInput} 差在 `id` / `timestamp` 由调用方给** —— 这正是
+ * 「导入」和「追加」的分界：追加是此刻发生的事，时刻由库说了算；导入是搬运已经
+ * 发生过的事，时刻由来源说了算，库把它逐字收下。
+ *
+ * ⚠️ `parts` 收的是 **{@link EpochContentPart}，不是 `PersistedPart`** —— 因为
+ * 导入的上游是 `SessionStore.loadMessages()` 读出来的内存形态。两者的图片格式
+ * 不通：读侧吐的是绝对路径字符串，而 `persistParts()` 会把任何不带协议头的
+ * 字符串当 base64 写进磁盘。转换走 `importParts()`，判据写在那个函数上。
+ */
+interface ImportMessage extends Omit<AppendMessageInput, 'parts'> {
+    /**
+     * 这条消息在**来源库**里的 id。
+     *
+     * ⚠️ **本机不会用这个号。** `messages.id` 是 `INTEGER PRIMARY KEY AUTOINCREMENT`，
+     * 全库共享一条序列，两台机器的号段必然撞，所以导入一律重新发号。传它进来是为了
+     * 拿回 {@link ImportSessionResult.idMap} —— 调用方那边（同步水位线、去重表）
+     * 记的是来源的号，得有个东西把两边接上。
+     *
+     * **{@link timestamp} 和这一批的先后次序一个都不动**：会话读回来是按
+     * `(timestamp, id)` 排的，次序才是语义，号只是句柄。
+     */
+    id: number;
+    /** 这条消息原本发生的时刻（ms）。**逐字落库**，不拿挂钟顶替 */
+    timestamp: number;
+    /** 多模态部件的**内存**形态（图片是绝对路径或 http(s) URL，**不许是 base64**） */
+    parts?: EpochContentPart[];
+}
+/**
+ * 导入一段会话的元数据。
+ *
+ * 时刻一律用 ms 数字而不是 `Date`：这些值是跨进程/跨机器搬过来的，
+ * 路上只会是数字，在这一层收 `Date` 等于逼每个调用方先 `new Date()` 再被
+ * 实现 `.getTime()` 回去。
+ */
+interface ImportSessionMeta {
+    /** 由调用方指定，**不是**库发的。已经存在时导入会被拒，见 `ImportSessionResult` */
+    id: string;
+    title: string;
+    model: string;
+    startedAt: number;
+    /** 最后活动时刻。语义逐字见 {@link SessionMeta.updatedAt}（动 = 产生内容或花掉钱） */
+    updatedAt: number;
+    endedAt?: number;
+    endReason?: string;
+    source?: string;
+    cwd?: string;
+    workspaceState?: SessionMeta['workspaceState'];
+    workspaceRoot?: string;
+    gitBranch?: string;
+    gitRepoRoot?: string;
+    /**
+     * ⚠️ **这里没有 `systemPrompt`**，和 {@link CreateSessionInput} 不一样。
+     * 那边的 `systemPrompt` 不是一列，是一条 `role: 'system'` 的消息
+     * （`SessionManager.create()` 收到它就 `appendMessage`），所以搬运时它**已经在
+     * {@link ImportSessionInput.messages} 里**了 —— 再开一格就会导进去两份。
+     */
+    displayName?: string;
+    pinned?: boolean;
+    archived?: boolean;
+    /**
+     * 父会话。**本机没有这一行时会被静默丢掉**，不是报错 —— `sessions.parent_id`
+     * 是真外键（`REFERENCES sessions(id)`，且 `foreign_keys = ON`），留着会让整条
+     * 导入事务失败。丢了父指针的会话本身是完整的，为一个装饰性的指针把整段会话
+     * 挡在门外不划算。丢没丢由 {@link ImportSessionResult.droppedParentId} 报出来。
+     */
+    parentId?: string;
+}
+interface ImportSessionInput {
+    meta: ImportSessionMeta;
+    /** 按时间正序。空数组合法（一段还没说话的会话也是会话） */
+    messages: ImportMessage[];
+}
+/**
+ * 导入的结果。
+ *
+ * **失败不抛，用 `ok: false` 回**：导入是批量搬运，调用方要的是「这一批里哪几段
+ * 没进去、为什么」，而不是第一段出问题就整批断掉。
+ *
+ * `reason` 是**机器可读的标识符**，不是给人看的文案 —— 文案归调用方那层的 i18n。
+ */
+type ImportSessionResult = {
+    ok: true;
+    id: string;
+    /** 真写进去几条消息 */
+    messageCount: number;
+    /**
+     * `来源 id -> 本机 id`。消息 id **一律重发**（理由见 {@link ImportMessage.id}），
+     * 所以这一格总是在，空会话时是个空对象。
+     */
+    idMap: Record<number, number>;
+    /** 父指针被丢掉了的话，这里是被丢掉的那个 id。见 `ImportSessionMeta.parentId` */
+    droppedParentId?: string;
+} | {
+    ok: false;
+    id: string;
+    /**
+     * | 值 | 意思 |
+     * | --- | --- |
+     * | `exists` | 本机已经有这个 id 了。**不合并、不覆盖** —— 两边都是用户的数据，这一层没有判断谁新谁旧的依据 |
+     * | `invalid` | 入参自己不成立（空 id、时刻不是有限数、`parts` 里带 base64 …） |
+     * | `failed` | 写库时抛了。事务已回滚，库里没有半段会话 |
+     */
+    reason: 'exists' | 'invalid' | 'failed';
+    /** 机器可读的补充定位（字段名 / 消息 id 之类），**不是文案** */
+    detail?: string;
+};
 interface SessionManager$1 {
     create(input?: CreateSessionInput): Session;
     get(id: string): Session | undefined;
@@ -13468,6 +13796,27 @@ interface SessionManager$1 {
     /** 退出时给本进程碰过的会话统一打结束标记。返回打了几段，**从不抛** */
     endTouchedSessions(reason?: string): number;
     list(input?: ListSessionsInput): ListSessionsOutput;
+    /**
+     * 把别处的一整段会话原样搬进本机库（2026-09-20，给跨机同步用）。
+     *
+     * 和 `create()` + N 次 `appendMessage()` 的差别，三条都是刻意的：
+     *
+     * 1. **不跑智能体、不切当前会话、不发任何事件** —— 它是一次纯写库
+     * 2. **id 和每条消息的 `timestamp` 由调用方给**，库不拿挂钟顶替
+     * 3. **撞 id 就拒**（`reason: 'exists'`），不悄悄合并也不覆盖 ——
+     *    两边都是用户的数据，这一层没有判断谁该赢的依据
+     *
+     * 整段会话 + 全部消息在**一个事务**里落地：要么整段进去，要么一行都不留。
+     *
+     * **不搬**两样东西，都是因为搬过来就是撒谎：
+     * - `estimatedCostUsd` —— 它靠 `priced_call_count` 区分「零」和「不知道」，
+     *   搬一个数过来会把「这台机器从没给它算过钱」变成「算过，是这个数」
+     * - 压缩状态（`summary` 和消息的 `active`/`compacted` 标记）—— 落库的消息
+     *   一律 `active=1, compacted=0`，只搬摘要不搬标记会让同一段内容喂给模型两遍
+     *
+     * 这两条不是缺口，是这一版的口径；要改得连着各自的伴生列一起改。
+     */
+    importSession(input: ImportSessionInput): ImportSessionResult;
     search(input: SearchInput): SearchOutput;
     /** @returns 这条消息的 DB id（按步增量落盘要它，见实现处） */
     appendMessage(sessionId: string, msg: AppendMessageInput): number;
@@ -13612,6 +13961,12 @@ declare class SessionManager implements SessionManager$1 {
      */
     getLatestByCwd(cwd: string): Session | undefined;
     list(input?: ListSessionsInput): ListSessionsOutput;
+    /**
+     * 把别处的一整段会话搬进本机库。语义、口径、以及两样**刻意不搬**的东西
+     * （花费和压缩状态）逐字见 {@link ISessionManager.importSession} —— 这里只记
+     * 实现上的三处判断。
+     */
+    importSession(input: ImportSessionInput): ImportSessionResult;
     updateMeta(id: string, patch: Partial<SessionMeta>): void;
     archive(id: string): void;
     unarchive(id: string): void;
@@ -13691,6 +14046,43 @@ declare class SessionManager implements SessionManager$1 {
         vacuumed: boolean;
         error?: string;
     };
+    /**
+     * attachment 的保留期兜底（2026-09-21）。**从不抛**，同 {@link maybeAutoPrune}。
+     *
+     * ## 它补的是一条「写了却执行不到」的保留期
+     *
+     * `ATTACHMENT_RETENTION_DEFAULTS` 写着 7 天 / 512MB，而在这之前，全仓**唯一**
+     * 调到 `pruneAttachments` 的地方是附件上传那个 HTTP handler
+     * （`server/src/attachments.ts`）。于是那条保留期挂在一个用户可能再也不做的
+     * 动作上：**传过一次、之后不再传，那批附件就永远留着**。
+     *
+     * 实测（2026-09-21）：一个 9 月 11 日的会话目录，1.0G / 52 个文件，10 天后
+     * 还在盘上 —— 两条线都破了，就因为那之后没人再传过附件。
+     *
+     * ## ⚠️ 为什么不挂在启动上
+     *
+     * 那条路被否过，理由在 `runtime/src/build.ts` 的 `buildAttachmentControl` 上：
+     * 一个开着不关的 `epoch web` 永远不清。但被选中的那条有一个对称的洞（上面
+     * 那段），而「不再传附件」比「不重启」常见得多。所以这一条挂在**开新会话**
+     * 那一刻（`SessionStore.ensure()`）：不传附件照样开新会话，开着不关也照样
+     * 开新会话，两个洞同时堵上。
+     *
+     * 上传那条路上的 prune **保留**，不替换：它便宜，而且在频繁上传时比一天
+     * 一次及时。这一条是兜底。
+     *
+     * ## ⚠️ `root` 由调用方给
+     *
+     * 同 {@link deleteSession} 那条：**core 不认识家目录布局**，`attachmentsDir()`
+     * 是 infra 的事。这一层只负责「节流 + 调清理」。
+     *
+     * @param root        attachments 根目录（不带 sessionId 的那一层）
+     * @param keepSession 当前会话，永不清
+     * @returns 删掉的会话目录数；被节流挡下或失败时 0
+     */
+    maybePruneAttachments(root: string, keepSession: string, opts?: {
+        minIntervalMs?: number;
+        now?: () => number;
+    }): number;
     /**
      * 真删一段会话（方案 30 §2.2）。**不可撤销**，调用方要先跟用户确认过。
      *
@@ -13881,6 +14273,48 @@ declare function buildFtsMatchQuery(safeQuery: string): string;
  */
 declare function buildTrigramMatchQuery(safeQuery: string): string;
 
+/**
+ * 落盘失败的**分档**（2026-09-21）。
+ *
+ * ## 为什么需要它
+ *
+ * `SessionStore` 那一排 `catch` 把所有写失败都吞成同一个 `false`，而用户侧只有
+ * 一句固定文案：「磁盘满了、或者会话库正被另一个程序占着」。那句话是**猜的** ——
+ * 代码从来没有看过错误码。代价在 2026-09-21 那次排查上付清了：真实原因是
+ * `SQLITE_CONSTRAINT_PRIMARYKEY`（消息 id 撞号，判据在 `SessionDB.insertMessage`
+ * 上），而照着文案去查磁盘和文件锁，`df` / `lsof` 全是干净的，方向整个是错的。
+ *
+ * ## ⚠️ 这和 `SessionDB.hasSession` 上那条「别按错误码分档」不冲突
+ *
+ * 那一条针对的是**「这行在不在」**：它有真源可问（`SELECT 1`），去猜驱动怎么
+ * 编码约束冲突是舍近求远。这里问的是**「为什么写不进去」**，没有任何一处可以
+ * 事后问出来 —— 驱动给的那个码就是唯一的证据。两者的判据正相反。
+ *
+ * 分档只用来**选一句话说给用户**和**决定值不值得重试**，不参与任何数据判断；
+ * 认不出来的一律落 `unknown`，原始错误照旧原样进日志。
+ */
+/**
+ * 写不进去的原因，按**用户能做什么**分，不按驱动的错误码分。
+ *
+ * - `disk-full`：腾空间，能当场好
+ * - `locked`：别的进程占着，**多半是暂时的** —— 唯一值得重试的一档
+ * - `io-error`：库所在的位置本身写不稳 —— 云同步目录 / 网络盘 / 被实时扫描
+ * - `read-only`：权限 / 只读挂载，要人去改
+ * - `corrupt`：库坏了，要恢复或重建
+ * - `unknown`：认不出来。**包括 `SQLITE_CONSTRAINT`** —— 那不是环境问题而是
+ *   我们自己的 bug（id 撞号那一档就长这样），文案里会把原始错误码带出来
+ */
+type PersistFailureKind = 'disk-full' | 'locked' | 'io-error' | 'read-only' | 'corrupt' | 'unknown';
+/**
+ * 认码分档。前缀匹配 —— SQLite 的扩展码是 `SQLITE_BUSY_SNAPSHOT` 这种
+ * 「基础码_细分」的形状，按前缀收就不用把细分码一个个列出来。
+ */
+declare function classifyPersistFailure(cause: unknown): PersistFailureKind;
+/** 值不值得再试一次。判据（以及为什么只有这一档）在 `SessionStore.retrying` 上 */
+declare function isTransientPersistFailure(kind: PersistFailureKind): boolean;
+/** 原始错误码，进不了分档时原样带给用户。认不出来时空串 */
+declare function persistFailureCode(cause: unknown): string;
+
 /**
  * 把 `<current_goal>` 接到发出去那份 system prompt 的末尾（方案 52 PR-2）。
  *
@@ -19683,4 +20117,4 @@ declare function resolveCodeModeWorker(baseDir: string, exists?: typeof existsSy
  */
 declare function codeModeWorkerPath(): string | undefined;
 
-export { AGENT_ROLE_DIAG_MODULE, ARTIFACT_MAX_TOTAL_BYTES, ARTIFACT_RETENTION_DEFAULTS, ATTACHMENT_MAX_TOTAL_BYTES, ATTACHMENT_RETENTION_DEFAULTS, type AcquireResult, type AgentConfig, AgentLoop, type AgentProvider, type AgentSite, type AgentSiteRef, type AppendMessageInput, ApprovalCache, type ApprovalDecision, type ApprovalScope, type ArtifactOpenRefusal, type ArtifactRetention, type AskQuestionDeps, type AttachmentRetention, BLOCKED_TOOLS, type BackendOptions, type BackendOutcome, type BackgroundTaskSource, type BaseOrigin, type BaseSlot, type BeginTurnInput, type BreakdownInput, BudgetGuard, type BudgetGuardOptions, type BudgetInfo, type BudgetLevel, type BudgetOptions, type BudgetStatus, BudgetStore, type BudgetStoreOptions, type BuildFireArgvInput, type BuildIndexOptions, CHECKPOINT_MAX_TOTAL_BYTES, CLAUDE_EVENT_NAMES, CLAUDE_TOOL_NAMES, CODE_MODE_LIMITS, CODE_MODE_SDK_TAG, CONFIG_KEYS, CURRENT_CONFIG_VERSION, type CachedApproval, type CachedDecision, type CheckpointCapture, type CheckpointFile, CheckpointManager, type CheckpointManagerOptions, type CheckpointManifest, CheckpointStore, type CheckpointStoreOptions, type CheckpointSummary, type ClaudeHooksParseOptions, type CodeModeLimits, type CodeRequest, type CodeResult, CodeSandbox, type CommandHookConfig, type CommandHookResult, type CommandLoadOutcome, type CommandLoadSummary, type CommandResult, type CommandRunner, type CompactionResult, type CompiledRules, type ComplianceDirSpec, type ComplianceDirsSummary, ComplianceEngine, type ComplianceEngineInput, type ComplianceGate, type ComplianceHit, type ComplianceRule, type ComplianceRuleSource, type ComplianceSettings, type ComplianceVerdict, type CompressConfig, type CompressResult, type ConfigMigration, type ConfigOrigins, ContextCompressor, type ContextEngine, type CreateScheduleInput, type CreateSessionInput, DEFAULT_COMPLIANCE_ACTIONS, DEFAULT_COMPLIANCE_SETTINGS, DEFAULT_COMPRESSION_THRESHOLD, DEFAULT_GOAL_MAX_ROUNDS, DEFAULT_MAX_HOLD_CHARS, type DelegateArgs, type DelegateConfig, DelegateManager, type DelegateTaskResult, type DiagnoseOptions, type DiscoverOutcome, type DiscoveredFile, type DoctorReport, type DraftParse, EMPTY_RULES, EPOCH_DISK_LEDGER, EpochConfigSchema, type ExpandOptions, type ExtractOutcome, FTS_TABLES, FTS_TRIGGERS, type FallbackEvent, type FileSlots, type FileSourceKind, type ForkInput, type FrontmatterParse, type FrontmatterSplit, type FtsHealth, type FtsReclaim, type FtsSpace, type FtsTableHealth, GOAL_BLOCK_CODES, type GateAxis, type GateVerdict, type GenerateInput, type GenerateOutput, type Goal, type GoalBlockReason, type GoalClear, type GoalPhase, type GoalPromptView, type GoalRefusal, type GoalRoundResult, GoalService, GoalStore, type GoalToolDeps, type GoalWrite, HEADLESS_AUDIT_CODES, type HeadlessPolicy, type HookConfigEntry, HookManager, type HookManagerOptions, type HookMatcher, type HookSourceKind, type HookSourceStatus, type HookSourcesOptions, type HookSourcesSummary, type HooksParseOutcome, type MemoryManager$1 as IMemoryManager, INSTRUCTION_BUDGET_CHARS, INSTRUCTION_FILES, type SessionManager$1 as ISessionManager, type SkillSystem$1 as ISkillSystem, ImageLoadError, type ImageSize, type ImportDecision, type ImportGate, type ImportNode, type ImportSkipReason, ImportTrustStore, type InstallOptions, type InstallOutcome, type InstallPreview, type InstructionScan, type InstructionSource, type IsolationReason, type IsolationReport, type JsonSchemaDocument, LAUNCHD_LABEL_PREFIX, LOCK_HEARTBEAT_MS, LOCK_STALE_MS, type LastOpenSession, LastOpenSessions, type LayerOutcome, type LayerScalars, type LayerStatus, type LearningContext, type LearningResult, type LearningSkipReason, type LexiconLoadOutcome, type LifecycleOutcome, type ListCandidatesInput, type ListSessionsInput, type ListSessionsOutput, type LoadCommandsOptions, type LoadConfigOptions, type LoadKeybindingsOptions, type LoadKeybindingsResult, type LoadRolesOptions, type LoadedPlugin, type LockHolder, MARKETPLACE_DISPLAY_FIELDS, MARKETPLACE_FILE, MAX_AUDIT_ENTRIES, MAX_COMMAND_DEPTH, MAX_GOAL_MAX_ROUNDS, MAX_IMPORT_DEPTH, MAX_LAST_OPEN_SESSIONS, MAX_OBJECTIVE_CHARS, MAX_REASON_CHARS, MAX_RECENT_WORKSPACES, MODEL_GIVE_UP_THRESHOLD, MULTIMODAL_DEFAULTS, type ManagedPolicy, ManagedPolicyError, type ManagedSettings, ManagedSettingsSchema, type MarketplaceCatalog, type MarketplaceDisplay, type MarketplaceDisplayField, type MarketplaceEntry, type MarketplaceOutcome, type MarketplaceRecord, type MarketplaceStatus, type MemoryConfig, type MemoryEntry, MemoryManager, MemoryReviewer, type MemorySearchResult, type MemoryTarget, type MemoryWriteResult, type MentionPart, type MentionResolution, type Message, type MessageHit, type MessageRecord, type MessageSurface, type ModelCapability, ModelFailureTracker, type ModelMetaEntry, type ModelPricing, type MultimodalPolicy, NOMINAL_TOTAL_BYTES, NO_REVEALED_TOOLS, type NonInteractiveProbe, type OsTaskSnapshot, type OutputGuard, PACK_EXCLUDES, PACK_MAX_BYTES, PACK_MAX_FILES, PERMISSION_AUDIT_CODES, PLUGIN_LAYOUT, PLUGIN_MANIFEST_FILE, PLUGIN_MANIFEST_KEYS, PLUGIN_NAME_PATTERN, PLUGIN_ROOT_ENV, PLUGIN_ROOT_TOKEN, PLUGIN_VISIBILITY, POLICY_DECISIONS, PROBE_VERSION, PROJECT_AGENTS_SUBDIR, PROVIDER_NO_CREDENTIAL, type PackFile, type PackLimits, type PackOutcome, type PackPlan, type PackPlanOutcome, type PermissionAuditCode, type PermissionAuditEntry, type PermissionAuditOutcome, type PermissionAuditScope, type PermissionAuditSnapshot, PermissionManager, type PersistedBudget, type PersistedPart, type PlanApprovalFn, type PlanEnterResult, type PlanModeDeps, PlanModeState, type PlanSettlement, type PluginArtifacts, type PluginAuthor, PluginAuthorSchema, type PluginCommandDir, type PluginCounts, type PluginHookFile, type PluginInventory, type PluginLoadOptions, type PluginManifest, type PluginPathRef, type PluginRecord, type PluginSettingsFile, type PluginSourceType, type PluginStateReadOutcome, PluginStore, type PluginVisibility, type PolicyDirSpec, type PolicyDirsSummary, type PolicyLoadOutcome, type PolicyRule, PolicyRuleSchema, type PricingAt, type PricingOverride, type ProjectContext, type ProjectExtensionInventory, ProviderError, ProviderRouter, type ProviderStreamChunk, type ProviderToolCall$1 as ProviderToolCall, type ProviderWarning, type PruneResult, type QuestionAskFn, RECORDING_KEEP_RUNS, RECORDING_MAX_BYTES, ROLE_FRONTMATTER_SCHEMA, RUN_CODE_TOOL, type ReadMessagesInput, type ReadMessagesOutput, type RecentWorkspace, RecentWorkspaces, type RecordRunInput, type RecorderOptions, type RecoveryAction, type RegisterInput, type RegisterOutcome, type RegistrarOptions, type RegistrationPatch, type RepairOutcome, type ResolveMentionsOptions, type ResolveReferenceInput, type ResolveSettingsOptions, type ResolvedCompression, type ResolvedReference, type ResolvedSource, type ResponseFormat, type RestorePartsOptions, type ReviewIssue, type RewindAction, type RewindDrift, type RewindFilePlan, type RewindOptions, type RewindOutcome, type RewindPreview, type RoleCreateFailure, type RoleCreateInput, type RoleCreateOptions, type RoleCreateOutcome, type RoleLoadOutcome, type RoleLoadSummary, type RoleMergeNotice, type RoleMergeResult, type RoleRemoveFailure, type RoleRemoveOptions, type RoleRemoveOutcome, type RoleScope, type RuleMatch, type RuleSuggestion, type RuleVerdict, type RunCodeFailure, type RunCodeInput, type RunCodeOutcome, type RunCodeToolDeps, type RunEstimateInput, type RunInput, type RunResult, type RunningSchedule, SANDBOX_COVERS, SANDBOX_EXCLUDES, SCALAR_KEYS, SCHEDULE_DEFAULTS, SCHEDULE_DEFAULT_ALLOWLIST, SCHEDULE_FORM_BUDGET_USD, SCHEDULE_ISSUE_CODES, SCHTASKS_FOLDER, SESSION_MESSAGES_READ_TOOL, SESSION_MESSAGES_SEARCH_TOOL, SESSION_QUERY_TOOLS, SESSION_SEARCH_TOOL, SESSION_TRACE_TOOL, SETTINGS_LAYER_ORDER, SETTING_WRITE_KEYS, SETTING_WRITE_LAYERS, SKILL_CREATE_TOOL, SKILL_EDIT_TOOL, SKILL_PATCH_TOOL, SKILL_VIEW_TOOL, SKILL_WRITE_FILE_TOOL, SLASH_COMMANDS_DIAG_MODULE, type ScalarKey, type ScanInstructionsOptions, type ScheduleArgvRefusal, type ScheduleArgvResult, type ScheduleArgvWarning, type ScheduleBackend, type ScheduleCliEntry, type ScheduleDraftDeps, type ScheduleDrift, type ScheduleDriftKind, type ScheduleInstallForm, type ScheduleIssue, type ScheduleIssueCode, type ScheduleLock, ScheduleRecorder, ScheduleRegistrar, ScheduleStore, type ScheduleValidation, type SchemaExport, type SearchHit, type SearchInput, type SearchMessagesInput, type SearchMessagesOutput, type SearchOutput, type SearchSessionsInput, type SelectionDeps, type SelfConnector, type SelfIndexInput, type SelfSettings, type Session, type SessionCandidate, type SessionHit, SessionManager, type SessionMentionDeps, type SessionMeta, SessionQueries, SessionReferences, type SessionSearchDeps, type SessionStats, type SessionSurface, type SessionTrace, type SessionVisibility, type SessionVisibilityInput, type SettingApply, type SettingApplyFacts, type SettingChain, type SettingFutile, type SettingLayer, type SettingStep, type SettingValue, type SettingValueKind, type SettingWriteFailure, type SettingWriteKey, type SettingWriteLayer, type SettingWriteOutcome, type SettingWriteRequest, type SettingWriteTarget, type SettingWriteTargetsOptions, type SettingsFile, SettingsFileError, SettingsFileSchema, type SettingsLayer, type SettingsResolution, type ShadowFinding, type ShadowKind, type Skill, type SkillDirSource, type SkillDirSpec, type SkillDirsSummary, type SkillImportConflict, type SkillImportDone, type SkillImportEntry, type SkillImportFailure, type SkillImportForm, type SkillImportOptions, type SkillImportPreview, type SkillImportResult, type SkillIndexEntry, type SkillIndexOptions, type SkillIndexResidency, type SkillIndexStats, SkillLearner, type SkillLearningProvider, type SkillMeta, type SkillStats, SkillSystem, type SkillSystemOptions, type SkillViewDeps, type SkillWriteDeps, type SteerSource, type SubAgentRunner, type SubTask, type SubToolCaller, type SummarizeOutput, type SurfaceMessage, type SystemPromptParams, type SystemPromptSegments, TOOL_SEARCH_TOOL, TaskNoticeTracker, type TodoItem, type ToolCall, type ToolConflict, type ToolGate, type ToolNameFidelity, type ToolNameLookup, ToolRegistry, type ToolRevealState, type ToolScope, type ToolSearchDeps, type ToolTableCost, type TraceInput, type TraceNode, TrackerDB, type TrustDecision, type TrustGate, type TrustGateOptions, TrustManager, type TurnRecord, type TurnTiming, type UpdateScheduleInput, type UtilityModelInfo, type ValidateScheduleInput, type VersionCheck, Workspace, type WorkspaceFiles, type WorkspaceIssue, type WorkspaceIssueKind, acquireScheduleLock, addMarketplace, addUsage, admitArtifact, admitArtifacts, affectedPaths, artifactLaunchArgv, artifactOpenRefusal, assertLevelAllowed, blockedRoleTools, buildContextBreakdown, buildFireArgv, buildFtsMatchQuery, buildSchemaExports, buildSystemPrompt, buildTrigramMatchQuery, builtinRoles, checkEpochVersion, checkFtsHealth, checkShadowing, classifyProviderError, clearModelCache, coalesceRecording, codeModeWorkerPath, commandNameFromRelPath, compileRuleLists, compressionOptions, computeCost, computeCostMicros, computeExecHash, countRules, createAllowAllGate, createAllowAllImportGate, createAskQuestionTool, createCodeExecTool, createDelegateTool, createDenyAllGate, createDenyAllImportGate, createGoalTool, createImportGate, createMemoryTool, createPlanModeTools, createRoleFile, createRoleScope, createRunCodeTool, createScheduleDraftTool, createSessionMessagesReadTool, createSessionMessagesSearchTool, createSessionSearchTool, createSessionSearchTools, createSessionTraceTool, createSkillViewTool, createSkillWriteTools, createTodoTool, createToolRevealState, createToolScope, createToolSearchTool, createTrustGate, currentEpochVersion, decideImport, decideTrust, defaultConfig, defaultModelOf, describeArtifactRefusal, describeBackgroundTask, describeHeadlessPolicy, describeIsolation, describeJsonError, diagnoseSchedules, discoverMarkdown, discoverModels, discoverProject, displayCurrency, draftCommandLine, draftWidening, escapeRuleContent, estimateImageTokens, estimateRunTokens, estimateTokens, evaluateSelection, expandCommand, expandImports, explainSetting, extractArchive, findInstructionFiles, findProjectInstructions, findRole, formatBytes, formatSkillIndex, formatUsd, gateForTool, getCapability, getConfigIssues, getConfigOrigins, getImportGate, getTrustGate, hasDedicatedExecContent, hasExecTierContent, hasPromptCaching, hasProviderCredentials, hasReadTierContent, imageFromBase64, imageFromPath, imagePartTokens, importSkills, installPlugin, instructionDirs, instructionNotices, intervalSlots, inventoryProjectExtensions, inventoryTotal, isBlockCode, isCodeModeDeferred, isEmptyRules, isGoalPhase, isNonInteractive, isReadOnlySubCall, isSettingWriteLayer, isValidPluginName, isWithinWindow, isWritableSettingKey, labelSlug, layerRank, listRunningSchedules, listSessionCandidates, listWorkspaceFiles, loadCommandDefinitions, loadCommandFile, loadCommands, loadConfig, loadHookSources, loadKeybindings, loadLexiconDir, loadLexiconFiles, loadPlugins, loadPolicyFiles, loadPolicyRules, loadRoleDefinitions, loadRoleDir, loadedImports, localDateString, managedSwitchNotes, mapClaudeToolName, mapEpochToolName, mapOperationType, matchPreauthorization, matchRuleLists, matchesHook, mentionsPluginRoot, mergeHeadlessPolicy, mergeRoles, mergeSchedulePatch, microsToUsd, modelListCandidates, needsAllowlist, nextFallbackModel, nextRunAt, noConfigOrigins, noManagedPolicy, noPlugins, openArtifact, originOf, packFileName, packPlugin, parseClaudeSettingsHooks, parseClock, parseDate, parseFrontmatter, parseHooksConfig, parseHooksConfigVerbose, parseImportLine, parseModelList, parseRoleDefinition, parseScheduleDraft, parseSkillFrontmatter, parseTrigger, pendingImageTokens, persistParts, persistToolResults, persistedUsage, planPack, previewSkillImport, pricingFor, projectEntryForDisplay, pruneArtifacts, pruneAttachments, pruneRecordings, pruneSchedules, readImageSize, readMarketplaces, readPluginManifest, readPluginRecords, readProviderKeyEnv, readRecording, readSessionSurface, reclaimFtsSpace, redactLine, refreshOpenRouterMetadata, removeMarketplace, removeRecordings, removeRoleFile, removeSessionArtifacts, removeSessionAttachments, renderImportTree, renderProjectContext, renderSdkDeclaration, renderSelfIndex, repairSchedules, resolveArtifactRetention, resolveCodeModeWorker, resolveComplianceDirs, resolveEntrySource, resolveInWorkspace, resolveMarketplaceRef, resolveMentions, resolveMultimodalPolicy, resolvePolicyDirs, resolvePricingAt, resolveProjectRoot, resolveScheduleBackend, resolveSessionReference, resolveSessionVisibility, resolveSettings, resolveSkillDirs, resolveSource, resolveTar, resolveWorkspace, restoreParts, revealScopedProvider, roleScopedProvider, roleSourceLabel, ruleCovers, ruleFromString, ruleToString, runCode, runCommand, sanitizeArgNames, sanitizeCommand, sanitizeFtsQuery, sanitizePath, sanitizeToolOutput, scanInstructions, scanPluginDir, scanSkillDirs, searchMarketplaces, setDisplayCurrency, setImportGate, setPluginEnabled, setTrustGate, settingValueChoices, settingValueKind, settingWriteApply, settingWriteLayers, settingWriteTargets, skillIndexDescription, skillIndexResidency, skillIndexStats, sniffMediaType, splitFrontmatter, staticToolProvider, stripArtifactData, substitutePluginRoot, suggestRuleFromApproval, systemOpenArgv, systemPromptSegments, toPosix, toolDefinitionTokens, toolMatches, toolTableTokens, totalTokens, traceSession, triggerPeriodMs, unescapeRuleContent, uninstallPlugin, unknownRoleSkills, unknownRoleTools, unloadedInstructionFiles, updateMarketplace, updatePlugin, usdToMicros, validateSchedule, validateTrigger, validateWindow, withGoalCompression, withGoalPrompt, workspaceDisplayPath, writeSettingValue };
+export { AGENT_ROLE_DIAG_MODULE, ARTIFACT_MAX_TOTAL_BYTES, ARTIFACT_RETENTION_DEFAULTS, ATTACHMENT_MAX_TOTAL_BYTES, ATTACHMENT_RETENTION_DEFAULTS, type AcquireResult, type AgentConfig, AgentLoop, type AgentProvider, type AgentSite, type AgentSiteRef, type AppendMessageInput, ApprovalCache, type ApprovalDecision, type ApprovalScope, type ArtifactOpenRefusal, type ArtifactRetention, type AskQuestionDeps, type AttachmentRetention, BLOCKED_TOOLS, type BackendOptions, type BackendOutcome, type BackgroundTaskSource, type BaseOrigin, type BaseSlot, type BeginTurnInput, type BreakdownInput, BudgetGuard, type BudgetGuardOptions, type BudgetInfo, type BudgetLevel, type BudgetOptions, type BudgetStatus, BudgetStore, type BudgetStoreOptions, type BuildFireArgvInput, type BuildIndexOptions, CHECKPOINT_MAX_TOTAL_BYTES, CLAUDE_EVENT_NAMES, CLAUDE_TOOL_NAMES, CODE_MODE_LIMITS, CODE_MODE_SDK_TAG, CONFIG_KEYS, CURRENT_CONFIG_VERSION, type CachedApproval, type CachedDecision, type CheckpointCapture, type CheckpointFile, CheckpointManager, type CheckpointManagerOptions, type CheckpointManifest, CheckpointStore, type CheckpointStoreOptions, type CheckpointSummary, type ClaudeHooksParseOptions, type CodeModeLimits, type CodeRequest, type CodeResult, CodeSandbox, type CommandHookConfig, type CommandHookResult, type CommandLoadOutcome, type CommandLoadSummary, type CommandResult, type CommandRunner, type CompactionResult, type CompiledRules, type ComplianceDirSpec, type ComplianceDirsSummary, ComplianceEngine, type ComplianceEngineInput, type ComplianceGate, type ComplianceHit, type ComplianceRule, type ComplianceRuleSource, type ComplianceSettings, type ComplianceVerdict, type CompressConfig, type CompressResult, type ConfigMigration, type ConfigOrigins, ContextCompressor, type ContextEngine, type CreateScheduleInput, type CreateSessionInput, DEFAULT_COMPLIANCE_ACTIONS, DEFAULT_COMPLIANCE_SETTINGS, DEFAULT_COMPRESSION_THRESHOLD, DEFAULT_GOAL_MAX_ROUNDS, DEFAULT_MAX_HOLD_CHARS, type DelegateArgs, type DelegateConfig, DelegateManager, type DelegateTaskResult, type DiagnoseOptions, type DiscoverOutcome, type DiscoveredFile, type DoctorReport, type DraftParse, EMPTY_RULES, EPOCH_DISK_LEDGER, EpochConfigSchema, type ExpandOptions, type ExtractOutcome, FTS_TABLES, FTS_TRIGGERS, type FallbackEvent, type FileSlots, type FileSourceKind, type ForkInput, type FrontmatterParse, type FrontmatterSplit, type FtsHealth, type FtsReclaim, type FtsSpace, type FtsTableHealth, GOAL_BLOCK_CODES, type GateAxis, type GateVerdict, type GenerateInput, type GenerateOutput, type Goal, type GoalBlockReason, type GoalClear, type GoalPhase, type GoalPromptView, type GoalRefusal, type GoalRoundResult, GoalService, GoalStore, type GoalToolDeps, type GoalWrite, HEADLESS_AUDIT_CODES, type HeadlessPolicy, type HookConfigEntry, HookManager, type HookManagerOptions, type HookMatcher, type HookSourceKind, type HookSourceStatus, type HookSourcesOptions, type HookSourcesSummary, type HooksParseOutcome, type MemoryManager$1 as IMemoryManager, INSTRUCTION_BUDGET_CHARS, INSTRUCTION_FILES, type SessionManager$1 as ISessionManager, type SkillSystem$1 as ISkillSystem, ImageLoadError, type ImageSize, type ImportDecision, type ImportGate, type ImportMessage, type ImportNode, type ImportPartsResult, type ImportSessionInput, type ImportSessionMeta, type ImportSessionResult, type ImportSkipReason, ImportTrustStore, type InstallOptions, type InstallOutcome, type InstallPreview, type InstructionScan, type InstructionSource, type IsolationReason, type IsolationReport, type JsonSchemaDocument, LAUNCHD_LABEL_PREFIX, LOCK_HEARTBEAT_MS, LOCK_STALE_MS, type LastOpenSession, LastOpenSessions, type LayerOutcome, type LayerScalars, type LayerStatus, type LearningContext, type LearningResult, type LearningSkipReason, type LexiconLoadOutcome, type LifecycleOutcome, type ListCandidatesInput, type ListSessionsInput, type ListSessionsOutput, type LoadCommandsOptions, type LoadConfigOptions, type LoadKeybindingsOptions, type LoadKeybindingsResult, type LoadRolesOptions, type LoadedPlugin, type LockHolder, MARKETPLACE_DISPLAY_FIELDS, MARKETPLACE_FILE, MAX_AUDIT_ENTRIES, MAX_COMMAND_DEPTH, MAX_GOAL_MAX_ROUNDS, MAX_IMPORT_DEPTH, MAX_LAST_OPEN_SESSIONS, MAX_OBJECTIVE_CHARS, MAX_REASON_CHARS, MAX_RECENT_WORKSPACES, MODEL_GIVE_UP_THRESHOLD, MULTIMODAL_DEFAULTS, type ManagedPolicy, ManagedPolicyError, type ManagedSettings, ManagedSettingsSchema, type MarketplaceCatalog, type MarketplaceCategory, type MarketplaceDisplay, type MarketplaceDisplayField, type MarketplaceEntry, type MarketplaceOutcome, type MarketplaceRecord, type MarketplaceStatus, type MemoryConfig, type MemoryEntry, MemoryManager, MemoryReviewer, type MemorySearchResult, type MemoryTarget, type MemoryWriteResult, type MentionPart, type MentionResolution, type Message, type MessageHit, type MessageRecord, type MessageSurface, type ModelCapability, ModelFailureTracker, type ModelMetaEntry, type ModelPricing, type MultimodalPolicy, NOMINAL_TOTAL_BYTES, NO_REVEALED_TOOLS, type NonInteractiveProbe, type OsTaskSnapshot, type OutputGuard, PACK_EXCLUDES, PACK_MAX_BYTES, PACK_MAX_FILES, PERMISSION_AUDIT_CODES, PLUGIN_LAYOUT, PLUGIN_MANIFEST_FILE, PLUGIN_MANIFEST_KEYS, PLUGIN_NAME_PATTERN, PLUGIN_ROOT_ENV, PLUGIN_ROOT_TOKEN, PLUGIN_VISIBILITY, POLICY_DECISIONS, PROBE_VERSION, PROJECT_AGENTS_SUBDIR, PROVIDER_NO_CREDENTIAL, type PackFile, type PackLimits, type PackOutcome, type PackPlan, type PackPlanOutcome, type PermissionAuditCode, type PermissionAuditEntry, type PermissionAuditOutcome, type PermissionAuditScope, type PermissionAuditSnapshot, PermissionManager, type PersistFailureKind, type PersistedBudget, type PersistedPart, type PlanApprovalFn, type PlanEnterResult, type PlanModeDeps, PlanModeState, type PlanSettlement, type PluginArtifacts, type PluginAuthor, PluginAuthorSchema, type PluginCommandDir, type PluginCounts, type PluginHookFile, type PluginInventory, type PluginLoadOptions, type PluginManifest, type PluginPathRef, type PluginRecord, type PluginSettingsFile, type PluginSourceType, type PluginStateReadOutcome, PluginStore, type PluginVisibility, type PolicyDirSpec, type PolicyDirsSummary, type PolicyLoadOutcome, type PolicyRule, PolicyRuleSchema, type PricingAt, type PricingOverride, type ProjectContext, type ProjectExtensionInventory, ProviderError, ProviderRouter, type ProviderStreamChunk, type ProviderToolCall$1 as ProviderToolCall, type ProviderWarning, type PruneResult, type QuestionAskFn, RECORDING_KEEP_RUNS, RECORDING_MAX_BYTES, ROLE_FRONTMATTER_SCHEMA, RUN_CODE_TOOL, type ReadMessagesInput, type ReadMessagesOutput, type RecentWorkspace, RecentWorkspaces, type RecordRunInput, type RecorderOptions, type RecoveryAction, type RegisterInput, type RegisterOutcome, type RegistrarOptions, type RegistrationPatch, type RepairOutcome, type ResolveMentionsOptions, type ResolveReferenceInput, type ResolveSettingsOptions, type ResolvedCompression, type ResolvedReference, type ResolvedSource, type ResponseFormat, type RestorePartsOptions, type ReviewIssue, type RewindAction, type RewindDrift, type RewindFilePlan, type RewindOptions, type RewindOutcome, type RewindPreview, type RoleCreateFailure, type RoleCreateInput, type RoleCreateOptions, type RoleCreateOutcome, type RoleLoadOutcome, type RoleLoadSummary, type RoleMergeNotice, type RoleMergeResult, type RoleRemoveFailure, type RoleRemoveOptions, type RoleRemoveOutcome, type RoleScope, type RuleMatch, type RuleSuggestion, type RuleVerdict, type RunCodeFailure, type RunCodeInput, type RunCodeOutcome, type RunCodeToolDeps, type RunEstimateInput, type RunInput, type RunResult, type RunningSchedule, SANDBOX_COVERS, SANDBOX_EXCLUDES, SCALAR_KEYS, SCHEDULE_DEFAULTS, SCHEDULE_DEFAULT_ALLOWLIST, SCHEDULE_FORM_BUDGET_USD, SCHEDULE_ISSUE_CODES, SCHTASKS_FOLDER, SESSION_MESSAGES_READ_TOOL, SESSION_MESSAGES_SEARCH_TOOL, SESSION_QUERY_TOOLS, SESSION_SEARCH_TOOL, SESSION_TRACE_TOOL, SETTINGS_LAYER_ORDER, SETTING_WRITE_KEYS, SETTING_WRITE_LAYERS, SKILL_CREATE_TOOL, SKILL_EDIT_TOOL, SKILL_PATCH_TOOL, SKILL_VIEW_TOOL, SKILL_WRITE_FILE_TOOL, SLASH_COMMANDS_DIAG_MODULE, type ScalarKey, type ScanInstructionsOptions, type ScheduleArgvRefusal, type ScheduleArgvResult, type ScheduleArgvWarning, type ScheduleBackend, type ScheduleCliEntry, type ScheduleDraftDeps, type ScheduleDrift, type ScheduleDriftKind, type ScheduleInstallForm, type ScheduleIssue, type ScheduleIssueCode, type ScheduleLock, ScheduleRecorder, ScheduleRegistrar, ScheduleStore, type ScheduleValidation, type SchemaExport, type SearchHit, type SearchInput, type SearchMessagesInput, type SearchMessagesOutput, type SearchOutput, type SearchSessionsInput, type SelectionDeps, type SelfConnector, type SelfIndexInput, type SelfSettings, type Session, type SessionCandidate, type SessionHit, SessionManager, type SessionMentionDeps, type SessionMeta, SessionQueries, SessionReferences, type SessionSearchDeps, type SessionStats, type SessionSurface, type SessionTrace, type SessionVisibility, type SessionVisibilityInput, type SettingApply, type SettingApplyFacts, type SettingChain, type SettingFutile, type SettingLayer, type SettingStep, type SettingValue, type SettingValueKind, type SettingWriteFailure, type SettingWriteKey, type SettingWriteLayer, type SettingWriteOutcome, type SettingWriteRequest, type SettingWriteTarget, type SettingWriteTargetsOptions, type SettingsFile, SettingsFileError, SettingsFileSchema, type SettingsLayer, type SettingsResolution, type ShadowFinding, type ShadowKind, type Skill, type SkillDirSource, type SkillDirSpec, type SkillDirsSummary, type SkillImportConflict, type SkillImportDone, type SkillImportEntry, type SkillImportFailure, type SkillImportForm, type SkillImportOptions, type SkillImportPreview, type SkillImportResult, type SkillIndexEntry, type SkillIndexOptions, type SkillIndexResidency, type SkillIndexStats, SkillLearner, type SkillLearningProvider, type SkillMeta, type SkillStats, SkillSystem, type SkillSystemOptions, type SkillViewDeps, type SkillWriteDeps, type SteerSource, type SubAgentRunner, type SubTask, type SubToolCaller, type SummarizeOutput, type SurfaceMessage, type SystemPromptParams, type SystemPromptSegments, TOOL_SEARCH_TOOL, TaskNoticeTracker, type TodoItem, type ToolCall, type ToolConflict, type ToolGate, type ToolNameFidelity, type ToolNameLookup, ToolRegistry, type ToolRevealState, type ToolScope, type ToolSearchDeps, type ToolTableCost, type TraceInput, type TraceNode, TrackerDB, type TrustDecision, type TrustGate, type TrustGateOptions, TrustManager, type TurnRecord, type TurnTiming, type UpdateScheduleInput, type UtilityModelInfo, type ValidateScheduleInput, type VersionCheck, Workspace, type WorkspaceFiles, type WorkspaceIssue, type WorkspaceIssueKind, acquireScheduleLock, addMarketplace, addUsage, admitArtifact, admitArtifacts, affectedPaths, artifactLaunchArgv, artifactOpenRefusal, assertLevelAllowed, blockedRoleTools, buildContextBreakdown, buildFireArgv, buildFtsMatchQuery, buildSchemaExports, buildSystemPrompt, buildTrigramMatchQuery, builtinRoles, checkEpochVersion, checkFtsHealth, checkShadowing, classifyPersistFailure, classifyProviderError, clearModelCache, coalesceRecording, codeModeWorkerPath, commandNameFromRelPath, compileRuleLists, compressionOptions, computeCost, computeCostMicros, computeExecHash, countRules, createAllowAllGate, createAllowAllImportGate, createAskQuestionTool, createCodeExecTool, createDelegateTool, createDenyAllGate, createDenyAllImportGate, createGoalTool, createImportGate, createMemoryTool, createPlanModeTools, createRoleFile, createRoleScope, createRunCodeTool, createScheduleDraftTool, createSessionMessagesReadTool, createSessionMessagesSearchTool, createSessionSearchTool, createSessionSearchTools, createSessionTraceTool, createSkillViewTool, createSkillWriteTools, createTodoTool, createToolRevealState, createToolScope, createToolSearchTool, createTrustGate, currentEpochVersion, decideImport, decideTrust, defaultConfig, defaultModelOf, describeArtifactRefusal, describeBackgroundTask, describeHeadlessPolicy, describeIsolation, describeJsonError, diagnoseSchedules, discoverMarkdown, discoverModels, discoverProject, displayAllows, displayCurrency, draftCommandLine, draftWidening, escapeRuleContent, estimateImageTokens, estimateRunTokens, estimateTokens, evaluateSelection, expandCommand, expandImports, explainSetting, extractArchive, findInstructionFiles, findProjectInstructions, findRole, formatBytes, formatSkillIndex, formatUsd, gateForTool, getCapability, getConfigIssues, getConfigOrigins, getImportGate, getTrustGate, hasDedicatedExecContent, hasExecTierContent, hasPromptCaching, hasProviderCredentials, hasReadTierContent, imageFromBase64, imageFromPath, imagePartTokens, importParts, importSkills, installPlugin, instructionDirs, instructionNotices, intervalSlots, inventoryProjectExtensions, inventoryTotal, isBlockCode, isCodeModeDeferred, isEmptyRules, isGoalPhase, isNonInteractive, isReadOnlySubCall, isSettingWriteLayer, isTransientPersistFailure, isValidPluginName, isWithinWindow, isWritableSettingKey, labelSlug, layerRank, listRunningSchedules, listSessionCandidates, listWorkspaceFiles, loadCommandDefinitions, loadCommandFile, loadCommands, loadConfig, loadHookSources, loadKeybindings, loadLexiconDir, loadLexiconFiles, loadPlugins, loadPolicyFiles, loadPolicyRules, loadRoleDefinitions, loadRoleDir, loadedImports, localDateString, managedSwitchNotes, mapClaudeToolName, mapEpochToolName, mapOperationType, matchPreauthorization, matchRuleLists, matchesHook, mentionsPluginRoot, mergeHeadlessPolicy, mergeRoles, mergeSchedulePatch, microsToUsd, modelListCandidates, needsAllowlist, nextFallbackModel, nextRunAt, noConfigOrigins, noManagedPolicy, noPlugins, openArtifact, originOf, packFileName, packPlugin, parseClaudeSettingsHooks, parseClock, parseDate, parseFrontmatter, parseHooksConfig, parseHooksConfigVerbose, parseImportLine, parseModelList, parseRoleDefinition, parseScheduleDraft, parseSkillFrontmatter, parseTrigger, pendingImageTokens, persistFailureCode, persistParts, persistToolResults, persistedUsage, planPack, previewSkillImport, pricingFor, projectEntryForDisplay, pruneArtifacts, pruneAttachments, pruneRecordings, pruneSchedules, readImageSize, readMarketplaces, readPluginManifest, readPluginRecords, readProviderKeyEnv, readRecording, readSessionSurface, reclaimFtsSpace, redactLine, refreshOpenRouterMetadata, removeMarketplace, removeRecordings, removeRoleFile, removeSessionArtifacts, removeSessionAttachments, renderImportTree, renderProjectContext, renderSdkDeclaration, renderSelfIndex, repairSchedules, resolveArtifactRetention, resolveCodeModeWorker, resolveComplianceDirs, resolveEntrySource, resolveInWorkspace, resolveMarketplaceRef, resolveMentions, resolveMultimodalPolicy, resolvePolicyDirs, resolvePricingAt, resolveProjectRoot, resolveScheduleBackend, resolveSessionReference, resolveSessionVisibility, resolveSettings, resolveSkillDirs, resolveSource, resolveTar, resolveWorkspace, restoreParts, revealScopedProvider, roleScopedProvider, roleSourceLabel, ruleCovers, ruleFromString, ruleToString, runCode, runCommand, sanitizeArgNames, sanitizeCommand, sanitizeFtsQuery, sanitizePath, sanitizeToolOutput, scanInstructions, scanPluginDir, scanSkillDirs, searchMarketplaces, setDisplayCurrency, setImportGate, setPluginEnabled, setTrustGate, settingValueChoices, settingValueKind, settingWriteApply, settingWriteLayers, settingWriteTargets, skillIndexDescription, skillIndexResidency, skillIndexStats, sniffMediaType, splitFrontmatter, staticToolProvider, stripArtifactData, substitutePluginRoot, suggestRuleFromApproval, systemOpenArgv, systemPromptSegments, toPosix, toolDefinitionTokens, toolMatches, toolTableTokens, totalTokens, traceSession, triggerPeriodMs, unescapeRuleContent, uninstallPlugin, unknownRoleSkills, unknownRoleTools, unloadedInstructionFiles, updateMarketplace, updatePlugin, usdToMicros, validateSchedule, validateTrigger, validateWindow, withGoalCompression, withGoalPrompt, workspaceDisplayPath, writeSettingValue };