@epoch-agent/core 0.25.0 → 0.27.0

package/dist/index.d.ts

@@ -2111,6 +2111,59 @@ interface MemoryManager$1 {
     flushToDisk(): Promise<void>;
     close(): void;
 }
+/**
+ * 从别处（云同步）落一条记忆进来：**带着它原来的 id 和时间戳**（{@link MemoryManager.importEntry}）。
+ *
+ * 不带位置：位置是这台机器上文件里的顺序，`reloadFromDisk` 会照文件重编，跨机器同步它只会来回改。
+ */
+interface MemoryImportRecord {
+    id: string;
+    target: MemoryTarget;
+    content: string;
+    /** epoch 毫秒 */
+    createdAt: number;
+    /** epoch 毫秒 */
+    updatedAt: number;
+}
+type MemoryImportResult = {
+    ok: true;
+    action: 'inserted' | 'updated' | 'unchanged';
+    blocked: boolean;
+}
+/** 同一个库里已经有一条**内容一模一样**、id 不同的 —— 文件里两条同内容会在下次加载时并成一条 */
+ | {
+    ok: false;
+    reason: 'duplicate-content';
+    existingId: string;
+}
+/** `expectUpdatedAt` 对不上：落之前本机这条被改过 */
+ | {
+    ok: false;
+    reason: 'conflict';
+}
+/** 内容过不了「写进文件再读回来还是它」（空、超长、中间夹着 `§` 开头的行） */
+ | {
+    ok: false;
+    reason: 'invalid';
+    detail: string;
+};
+/** 一条记忆被删了（{@link MemoryManagerOptions.onRemoved}）。 */
+interface MemoryRemoval {
+    id: string;
+    target: MemoryTarget;
+    /** `remove` = 工具 / 用户删的；`file-edit` = 有人手改 MEMORY.md / USER.md 把它去掉了 */
+    cause: 'remove' | 'file-edit';
+}
+interface MemoryManagerOptions {
+    /**
+     * 删掉一条记忆之后。宿主（云同步）靠它知道「这条是被删的，不是还没同步过来」。
+     *
+     * ⚠️ **文件整个不见了**（被删、读不到）导致的清空**不报**：那多半是事故不是用户的意思，
+     * 报出去就是让每一台机器都跟着把这个库清空。
+     * ⚠️ 回调里抛什么都吞掉（删除已经发生了），契约同 runtime 的 `onSessionDeleted`。
+     */
+    onRemoved?: (removal: MemoryRemoval) => void;
+}
 
 /**
  * Provider 层的 SPI 类型 —— 「一次模型请求进什么、出什么」。
@@ -7747,6 +7800,71 @@ declare function inventoryTotal(inv: PluginInventory): number;
  */
 declare function scanPluginDir(dir: string, pluginName: string): PluginInventory;
 
+/**
+ * 「这个插件是干什么的」—— 安装前那一屏上**给人读的那一半**（2026-10-09）。
+ *
+ * [inventory.ts](./inventory.ts) 答的是「装下去这台机器上会多出什么」，只数数、
+ * 不读正文；这里答的是另一个问题：**这些东西各自是干什么用的**。材料全是作者
+ * 已经写在包里的散文：
+ *
+ * - 根下的 `README.md`（docs/PLUGINS.md「模型怎么回答『这个插件能干嘛』」那一节
+ *   本来就请作者写它 —— 模型读得到，而装之前的人一直读不到）；
+ * - 每条命令 / 身份 / 技能 frontmatter 里的那句 `description`。
+ *
+ * ## 为什么不并进 `scanPluginDir`
+ *
+ * 那份盘点有一条承重的不变式：总数必须等于 `LoadedPlugin.counts` 六格之和
+ * （`inventoryTotal` 上那段），而它刻意「这一层不读 frontmatter」。
+ * 说明文字和那个数毫无关系，塞进去只会让那份盘点多一种失败形态
+ * （一句写坏的 YAML 让盘点多一条 issue）。所以这里**各读各的、失败一律静默**：
+ * 一条读不出说明的命令仍然是一条命令，盘点那边照样列它的名字。
+ *
+ * ## 名字的口径**逐字同** inventory
+ *
+ * 三类的键都是**已加前缀**的那个名字，推导方式和 `scanCommands` / `scanRoles` /
+ * `scanSkills` 一模一样 —— 界面拿盘点里的名字来这儿查说明，两边推导方式一分叉，
+ * 查不到的那几条就只剩光秃秃一个名字，而且没有任何一处会报错。
+ * 由 `plugin-about.test.ts` 里那条「每个名字都在盘点里」钉着。
+ *
+ * ## 不进预览摘要（token）
+ *
+ * 判据同 runtime `plugin-install.ts` 文件头那条「不哈希文件内容」：token 防的是
+ * 「界面显示的和真装的是两份**扩展物**」，而一句说明改了，装下去的东西一样都没变。
+ */
+/**
+ * README 读进来的上限（字符）。
+ *
+ * 32k 字符够一份写得很长的 README（`feishu-kit` 那份约 3k）。卡它是因为这一份会
+ * 原样走网线、在浏览器里过一遍 markdown 管线 —— 一个把 changelog 全塞进 README
+ * 的包不该让那一屏卡住。超了就截断并如实说（`truncated`），不静默。
+ */
+declare const ABOUT_README_MAX_CHARS = 32000;
+/**
+ * 一句说明的上限（字符）。frontmatter 里那句是给模型挑工具用的，有人写成三行；
+ * 那一屏上它是一行列表的说明格，过长就截，带省略号。
+ */
+declare const ABOUT_DESC_MAX_CHARS = 280;
+/** 一个扩展物和它那句说明 */
+interface PluginDoc {
+    /** 已加前缀的名字，口径同 {@link PluginInventory} 那几格 */
+    name: string;
+    /** 压成一行、去首尾空白、超长截断过的说明。**空串的不收** */
+    description: string;
+}
+interface PluginAbout {
+    /** 根下的 README（大小写不敏感）。没有 / 读不出 / 是空的 → 缺席 */
+    readme?: {
+        text: string;
+        truncated: boolean;
+    };
+    /** 只收**写了说明**的那几条，按名字排序 */
+    commands: PluginDoc[];
+    roles: PluginDoc[];
+    skills: PluginDoc[];
+}
+/** 读一个插件目录里给人看的那几段散文。**任何一格读不出都只是缺席，不抛、不报** */
+declare function readPluginAbout(dir: string, pluginName: string): PluginAbout;
+
 /**
  * 插件安装记录 —— `~/.epoch/plugins.json` 的读写（方案 32）。
  *
@@ -8072,6 +8190,14 @@ interface InstallPreview {
     manifest: PluginManifest;
     source: ResolvedSource;
     inventory: PluginInventory;
+    /**
+     * 给人读的那一半：README + 每条扩展物的那句说明（2026-10-09，判据在 about.ts 文件头）。
+     *
+     * ⚠️ **可选，而且只有根有** —— 依赖那几段只列名字（`InstallDependency` 上没有这一格）：
+     * 那一屏要回答的是「我装的这个插件是干什么的」，依赖是它的实现细节。
+     * 缺席 = 构造这份预览的那条路没读（老的调用方、用例里手写的预览），界面照旧只画名字。
+     */
+    about?: PluginAbout;
     /**
      * 已经装过的同名插件；有值时这次安装会被拒（验收 #8）。
      *
@@ -12811,6 +12937,7 @@ declare function loadKeybindings({ path, defaults }: LoadKeybindingsOptions): Lo
  */
 
 declare class MemoryManager {
+    private readonly options;
     private db;
     private config;
     private memDir;
@@ -12912,7 +13039,7 @@ declare class MemoryManager {
      *   压根不存在，于是 `MemoryConfig` 这个类型有、却没有任何人给得出非默认值 ——
      *   用户抱怨的「设置里改不了」就是这一格。
      */
-    constructor(dbPath?: string, memDir?: string, config?: Partial<MemoryConfig>);
+    constructor(dbPath?: string, memDir?: string, config?: Partial<MemoryConfig>, options?: MemoryManagerOptions);
     initialize(_sessionId: string): Promise<string>;
     prefetch(userQuery: string): Promise<string>;
     sync(_userMessage: string, _assistantResponse: string): Promise<void>;
@@ -13054,6 +13181,40 @@ declare class MemoryManager {
      * 在调用方那里长得一模一样，模型会以为腾出了地方然后继续撞墙。
      */
     remove(target: MemoryTarget, oldText: string): Promise<boolean>;
+    /**
+     * 从别处落一条记忆进来，**带着它原来的 id 和时间戳**（云同步，2026-10-09）。
+     *
+     * ## 为什么要它
+     *
+     * {@link add} 每次都发一个新 UUID、时间戳取现在。云同步拿它落别的电脑的记忆的话，
+     * 这台上那条就成了一条新 id 的记录，下一轮又被当成新记忆推上去 —— 两台电脑来回复制。
+     *
+     * ## 规矩
+     *
+     * - 内容先过「写进文件再读回来还是它」（{@link fileSafe}）：过不了就 `invalid`，不替调用方改 ——
+     *   改了的话 id 对上了、内容对不上，下一次 reload 照内容重新认，id 又变了；
+     * - 同一个库里有**另一个 id**、内容一模一样 → `duplicate-content`（回那条的 id）。文件里两条
+     *   同内容会在下次加载时被去重成一条，两个 id 留下一个，另一个就像被删了；
+     * - `expectUpdatedAt` 给了而本机那条的 `updatedAt` 对不上 → `conflict`（落之前本机被改过）；
+     * - 注入检测**照常打标记、不拒**（同从文件加载那一侧），配额**不拦**：这是别处已经写成了的
+     *   一条，拒掉它只会让两台机器永远对不齐；
+     * - 不报 {@link MemoryManagerOptions.onRemoved}、不动快照（同 {@link add}）。
+     */
+    importEntry(rec: MemoryImportRecord, opts?: {
+        expectUpdatedAt?: number;
+    }): Promise<MemoryImportResult>;
+    /**
+     * 按 id 删一条（云同步落「别处删了」那一下）。`notify: false` 时不报 {@link MemoryManagerOptions.onRemoved}
+     * —— 这一删本来就是从别处同步来的，再报回去就是在云上再写一遍同一块墓碑。
+     *
+     * `expectUpdatedAt` 给了而对不上 → 不删（落之前本机改过它，删除和本机改动谁赢不该由这里定）。
+     */
+    removeById(id: string, opts?: {
+        notify?: boolean;
+        expectUpdatedAt?: number;
+    }): Promise<boolean>;
+    /** 回调里抛什么都吞掉 —— 删除已经发生了（{@link MemoryManagerOptions.onRemoved}）。 */
+    private notifyRemoved;
     /**
      * 按「全文」或「索引里的短 id」定位一条记忆。
      *
@@ -14155,6 +14316,39 @@ interface ImportSessionInput {
     meta: ImportSessionMeta;
     /** 按时间正序。空数组合法（一段还没说话的会话也是会话） */
     messages: ImportMessage[];
+    /**
+     * 这段会话的待办（2026-10-09，云同步导入会话时一起带过来）。**id 一律重发**：待办 id 是 6 位
+     * 短 hex、全库一张表，沿用来源的号迟早撞上本机已有的；结果里 {@link ImportSessionResult} 的
+     * `todoIds` 按下标对齐给回新号。
+     */
+    todos?: ImportTodo[];
+    /**
+     * 这段会话的目标（同上）。**只有一个**：一段会话在库里只存一个目标（`GoalStore.put` 先删后插）。
+     * id 同样重发。
+     */
+    goal?: ImportGoal;
+}
+/** 导进来的一条待办。时刻是 ISO 字符串（`todos` 表那两列就是这么存的）。 */
+interface ImportTodo {
+    content: string;
+    status: 'pending' | 'in_progress' | 'completed' | 'cancelled';
+    reason?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** 导进来的目标。不变式照 `GoalStore`：`blocked` 要有码、`complete` 要有依据。 */
+interface ImportGoal {
+    objective: string;
+    phase: 'active' | 'paused' | 'blocked' | 'complete';
+    blockCode?: string;
+    blockMsg?: string;
+    maxRounds: number;
+    roundsUsed: number;
+    completeEvidence?: string;
+    /** epoch 毫秒 */
+    createdAt: number;
+    /** epoch 毫秒 */
+    updatedAt: number;
 }
 /**
  * 导入的结果。
@@ -14176,6 +14370,10 @@ type ImportSessionResult = {
     idMap: Record<number, number>;
     /** 父指针被丢掉了的话，这里是被丢掉的那个 id。见 `ImportSessionMeta.parentId` */
     droppedParentId?: string;
+    /** 带了待办时：本机给的新 id，下标与 `ImportSessionInput.todos` 对齐 */
+    todoIds?: string[];
+    /** 带了目标时：本机给的新 id */
+    goalId?: string;
 } | {
     ok: false;
     id: string;
@@ -16615,6 +16813,37 @@ interface ScheduleIssue {
  * 和 `ScheduleDefinition` 的差别全在「谁来定」：`id` / 时间戳 / `os*` 那几样
  * 由 store 和注册器写，调用方给不了也不该给。
  */
+/**
+ * 从别处（云同步）落一条定时任务进来：**带着它原来的 id 和时间戳**（{@link ScheduleStore.importDefinition}）。
+ *
+ * 只有「用户的意图」那几格，没有本机那几格：`os_*`（注册信息）、`lastRunAt` / `lastStatus`（运行痕迹）
+ * 和 `enabled`（这台要不要跑）都是**这台机器自己的**，更新时原样留着；新建时一律不启用、不注册 ——
+ * 同步的是任务的定义，要不要在这台跑由这台的用户点头。
+ */
+interface ScheduleImportInput {
+    id: string;
+    name: string;
+    prompt: string;
+    model?: string;
+    role?: string;
+    skills?: readonly string[];
+    mcpServers?: readonly string[];
+    permission: PermissionLevel;
+    allowTools: readonly string[];
+    allowOperations: readonly OperationType[];
+    allowRules: readonly string[];
+    maxTurns: number;
+    maxBudgetUsd: number;
+    timeoutMs: number;
+    showInSessionList?: boolean;
+    trigger: ScheduleTrigger;
+    startDate?: string;
+    endDate?: string;
+    /** epoch 毫秒 */
+    createdAt: number;
+    /** epoch 毫秒 */
+    updatedAt: number;
+}
 interface CreateScheduleInput {
     name: string;
     prompt: string;
@@ -16836,6 +17065,21 @@ declare class ScheduleStore {
     create(input: CreateScheduleInput & {
         workDir: string;
     }): ScheduleDefinition;
+    /**
+     * 落一条**别处来的**任务，带着它原来的 id 和时间戳（云同步，2026-10-09）。判据在 {@link ScheduleImportInput} 上。
+     *
+     * - 库里没有这个 id → 新建：**不启用、不注册**（`osBackend: 'host'`、`osTaskId: ''`）。
+     *   `workDir` 由调用方算好（这台机器上的目录，不是原来那台的）；
+     * - 库里有 → 只改「用户的意图」那几格；`enabled`、`workDir`、`os_*`、`last_*` 原样留着 ——
+     *   这台机器上用户启没启用、绑了哪个目录、注册成了什么样，都不该被另一台机器改掉。
+     */
+    importDefinition(input: ScheduleImportInput & {
+        workDir: string;
+    }): {
+        action: 'inserted' | 'updated';
+        schedule: ScheduleDefinition;
+    };
+    private insertRow;
     get(id: string): ScheduleDefinition | undefined;
     /**
      * 按 id 前缀找（`epoch schedule show sch_1a2b`）。
@@ -19237,6 +19481,15 @@ declare function scanSkillDirs(dirs: readonly SkillDirSpec[]): SkillScanOutcome;
  * `lstatSync`：不是普通文件也不是目录，就跳过并说一句。
  */
 
+/**
+ * `SKILL.md` 之外，一个技能目录里允许存在的四个子目录。
+ *
+ * **真源在这里，`SkillSystem.writeFile` 从这儿取** —— 文件头那条 ⚠️ 说的就是
+ * 为什么它不能有第二份。
+ */
+declare const SKILL_ASSET_DIRS: readonly ["references", "templates", "scripts", "assets"];
+/** 技能正文的文件名，两层布局里的那个叶子 */
+declare const SKILL_FILE = "SKILL.md";
 /** 导入源的四种形态 */
 type SkillImportForm = 'markdown' | 'skill-dir' | 'tree' | 'archive';
 
@@ -19378,6 +19631,14 @@ interface SkillImportOptions {
      * 让一段比这次响应活得久的文本跟着某一次请求的语言走，是这个方案明确禁止的事。
      */
     lang?: Lang;
+    /**
+     * 同名的**用户级**技能要不要换成这一份（2026-10-09，云同步要用）。不给 = 不换（照旧跳过）。
+     *
+     * 换法是「旧的挪进 `<skillsDir>/.trash-<uuid>/` → 新的 `rename` 到位 → 删掉回收目录」，三步同一个
+     * 文件系统；新的没到位就把旧的挪回来。所以任何时刻磁盘上都有**一份完整的**技能，不会出现
+     * 「先删、再装、装失败了就一份都没有」那个窗口。⚠️ 项目级 / 插件 / 宿主那几档照旧不碰。
+     */
+    replace?: boolean;
 }
 /** 「将导入什么」。**一个字节都不写**（staging 用完就删） */
 declare function previewSkillImport(source: string, opts: SkillImportOptions): Promise<SkillImportResult<{
@@ -20850,4 +21111,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, AppearanceStore, type AppendMessageInput, ApprovalCache, type ApprovalDecision, 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 InstallDependency, 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, type MemoryNotice, 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 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 StoredAppearance, 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, approvalEntryFor, approvalRootFor, 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, grantedPathsFor, 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 };
+export { ABOUT_DESC_MAX_CHARS, ABOUT_README_MAX_CHARS, 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, AppearanceStore, type AppendMessageInput, ApprovalCache, type ApprovalDecision, 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 ImportGoal, type ImportMessage, type ImportNode, type ImportPartsResult, type ImportSessionInput, type ImportSessionMeta, type ImportSessionResult, type ImportSkipReason, type ImportTodo, ImportTrustStore, type InstallDependency, 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, type MemoryImportRecord, type MemoryImportResult, MemoryManager, type MemoryManagerOptions, type MemoryNotice, type MemoryRemoval, 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 PluginAbout, type PluginArtifacts, type PluginAuthor, PluginAuthorSchema, type PluginCommandDir, type PluginCounts, type PluginDoc, 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 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_ASSET_DIRS, SKILL_CREATE_TOOL, SKILL_EDIT_TOOL, SKILL_FILE, 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 ScheduleImportInput, 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 StoredAppearance, 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, approvalEntryFor, approvalRootFor, 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, grantedPathsFor, 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, readPluginAbout, 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 };

package/dist/index.js

@@ -274,7 +274,7 @@ function createLaunchdBackend(opts = {}) {
         mkdirSync(input.logDir, { recursive: true });
         writeFileSync(path, renderPlist(label, input), "utf-8");
       } catch (err) {
-        return { ok: false, detail: `plist-write-failed: ${describe9(err)}` };
+        return { ok: false, detail: `plist-write-failed: ${describe10(err)}` };
       }
       await run("launchctl", ["bootout", `${guiDomain()}/${label}`]);
       const toggle = await backend.setEnabled(label, input.enabled);
@@ -290,7 +290,7 @@ function createLaunchdBackend(opts = {}) {
       try {
         rmSync(plistPath(label), { force: true });
       } catch (err) {
-        return { ok: false, detail: `plist-remove-failed: ${describe9(err)}` };
+        return { ok: false, detail: `plist-remove-failed: ${describe10(err)}` };
       }
       return { ok: true };
     },
@@ -447,7 +447,7 @@ function detailOf2(what, res) {
   const msg = (res.stderr || res.stdout).trim();
   return `${what} exit ${res.code}${msg ? `: ${msg}` : ""}`;
 }
-function describe9(err) {
+function describe10(err) {
   return err instanceof Error ? err.message : String(err);
 }
 var LAUNCHD_LABEL_PREFIX;
@@ -7083,6 +7083,92 @@ function firstLine3(err) {
   const message = err instanceof Error ? err.message : String(err);
   return message.split("\n")[0] ?? message;
 }
+var ABOUT_README_MAX_CHARS = 32e3;
+var ABOUT_DESC_MAX_CHARS = 280;
+function readPluginAbout(dir, pluginName) {
+  const readme = readReadme(dir);
+  return {
+    ...readme ? { readme } : {},
+    commands: aboutCommands(dir, pluginName),
+    roles: aboutRoles(dir, pluginName),
+    skills: aboutSkills(dir, pluginName)
+  };
+}
+function readReadme(dir) {
+  let names;
+  try {
+    names = readdirSync(dir);
+  } catch {
+    return void 0;
+  }
+  const hit = names.find((n) => /^readme\.md$/i.test(n));
+  if (hit === void 0) return void 0;
+  const text = readText(join(dir, hit))?.trim();
+  if (!text) return void 0;
+  return text.length > ABOUT_README_MAX_CHARS ? { text: text.slice(0, ABOUT_README_MAX_CHARS), truncated: true } : { text, truncated: false };
+}
+function aboutCommands(dir, plugin) {
+  const found = discoverMarkdown(join(dir, PLUGIN_LAYOUT.commands));
+  return collect2(
+    found.files.map((f) => ({
+      name: `${plugin}:${commandNameFromRelPath(f.relPath)}`,
+      path: f.path
+    }))
+  );
+}
+function aboutRoles(dir, plugin) {
+  const root = join(dir, PLUGIN_LAYOUT.agents);
+  return collect2(
+    listNames(root, "file").filter((f) => f.endsWith(".md")).map((f) => ({
+      name: `${plugin}:${f.replace(/\.md$/i, "").toLowerCase()}`,
+      path: join(root, f)
+    }))
+  );
+}
+function aboutSkills(dir, plugin) {
+  const root = join(dir, PLUGIN_LAYOUT.skills);
+  const out = [];
+  for (const category of listNames(root, "dir")) {
+    for (const name of listNames(join(root, category), "dir")) {
+      out.push({ name: `${plugin}:${name}`, path: join(root, category, name, "SKILL.md") });
+    }
+  }
+  return collect2(out);
+}
+function collect2(files) {
+  const out = [];
+  for (const f of files) {
+    const description = describe4(f.path);
+    if (description) out.push({ name: f.name, description });
+  }
+  return out.sort((a, b) => a.name.localeCompare(b.name));
+}
+function describe4(path) {
+  const raw = readText(path);
+  if (raw === void 0) return "";
+  const parsed = parseFrontmatter(raw);
+  if ("error" in parsed) return "";
+  const value = parsed.data?.description;
+  if (typeof value !== "string") return "";
+  const line = value.replace(/\s+/g, " ").trim();
+  return line.length > ABOUT_DESC_MAX_CHARS ? `${line.slice(0, ABOUT_DESC_MAX_CHARS - 1).trimEnd()}\u2026` : line;
+}
+function readText(path) {
+  if (!existsSync(path)) return void 0;
+  try {
+    return readFileSync(path, "utf-8");
+  } catch {
+    return void 0;
+  }
+}
+function listNames(dir, kind) {
+  if (!existsSync(dir)) return [];
+  try {
+    return readdirSync(dir, { withFileTypes: true }).filter((e) => kind === "file" ? e.isFile() : !e.isFile() && !e.name.startsWith(".")).map((e) => e.name);
+  } catch {
+    return [];
+  }
+}
 var MARKETPLACE_FILE = "epoch-marketplace.json";
 var NAME_PATTERN = PLUGIN_NAME_PATTERN;
 var EntryCategoryInput = z.union([z.string().min(1), z.array(z.string().min(1))]).optional().catch(void 0);
@@ -7525,6 +7611,7 @@ ${detail}` }) };
     manifest,
     source: resolved,
     inventory: scanPluginDir(readDir, manifest.name),
+    about: readPluginAbout(readDir, manifest.name),
     ...conflict ? { conflict } : {},
     ...versionUnmet ? { versionUnmet } : {},
     ...closure.report.length > 0 ? { dependencies: closure.report } : {}
@@ -9390,7 +9477,7 @@ function decideTrust(dir) {
   return ambient ? ambient.decide(dir) : noGate();
 }
 var FILE_VERSION = 1;
-function describe4(err) {
+function describe5(err) {
   return err instanceof Error ? err.message : String(err);
 }
 var ImportTrustStore = class {
@@ -9432,7 +9519,7 @@ var ImportTrustStore = class {
       raw = readFileSync(this.filePath, "utf-8");
     } catch (err) {
       this.loadErrors.push(
-        t("import_trust.read_failed", { path: this.filePath, reason: describe4(err) })
+        t("import_trust.read_failed", { path: this.filePath, reason: describe5(err) })
       );
       return;
     }
@@ -9441,7 +9528,7 @@ var ImportTrustStore = class {
       parsed = JSON.parse(raw);
     } catch (err) {
       this.loadErrors.push(
-        t("import_trust.bad_json", { path: this.filePath, reason: describe4(err) })
+        t("import_trust.bad_json", { path: this.filePath, reason: describe5(err) })
       );
       return;
     }
@@ -9499,7 +9586,7 @@ var ImportTrustStore = class {
     } catch (err) {
       rmSync(tmp, { force: true });
       throw new Error(
-        t("import_trust.write_failed", { path: this.filePath, reason: describe4(err) })
+        t("import_trust.write_failed", { path: this.filePath, reason: describe5(err) })
       );
     }
   }
@@ -13068,12 +13155,12 @@ function finishLayer(source, read, execTrusted, issues) {
       status: gated ? "gated" : "loaded",
       lists: checked.lists,
       scalars: {},
-      detail: describe5(layer, gated, checked.lists)
+      detail: describe6(layer, gated, checked.lists)
     },
     file: { ...file, permissions: checked.lists }
   };
 }
-function describe5(layer, gated, lists) {
+function describe6(layer, gated, lists) {
   const label = layerLabel(layer);
   if (gated) {
     const deny = lists.deny?.length ?? 0;
@@ -15562,6 +15649,27 @@ var MemoryDB = class {
     const rows = this.db.prepare("SELECT content FROM memory_entries WHERE target = ? ORDER BY position ASC").all(target);
     return rows.map((r) => r.content);
   }
+  getById(id) {
+    const row = this.db.prepare("SELECT * FROM memory_entries WHERE id = ?").get(id);
+    return row ? this.rowToEntry(row) : void 0;
+  }
+  updateById(entry) {
+    const existing = this.db.prepare("SELECT rowid FROM memory_entries WHERE id = ?").get(entry.id);
+    if (!existing) return;
+    this.db.prepare(
+      "UPDATE memory_entries SET target = @target, content = @content, char_length = @charLength, created_at = @createdAt, updated_at = @updatedAt, blocked = @blocked WHERE rowid = @rowid"
+    ).run({
+      target: entry.target,
+      content: entry.content,
+      charLength: entry.content.length,
+      createdAt: entry.createdAt.getTime(),
+      updatedAt: entry.updatedAt.getTime(),
+      blocked: entry.blocked ? 1 : 0,
+      rowid: existing.rowid
+    });
+    this.unsyncFts(existing.rowid);
+    this.writeFts(existing.rowid, entry.content);
+  }
   findByContent(target, content) {
     const row = this.db.prepare("SELECT * FROM memory_entries WHERE target = ? AND content = ?").get(target, content);
     return row ? this.rowToEntry(row) : void 0;
@@ -15677,6 +15785,15 @@ var MEM_DIR = join(homedir(), ".epoch", "memories");
 var ENTRY_DELIMITER = "\n\xA7 ";
 var MAX_ENTRY_CHARS = 4e3;
 var MAX_CONSOLIDATION_FAILURES_PER_TURN = 3;
+function fileSafe(content) {
+  if (content.trim() === "") return "empty";
+  if (content !== content.trim()) return "leading or trailing whitespace";
+  if (content.split("\n").slice(1).some((line) => line.startsWith("\xA7")))
+    return "a line starts with \xA7";
+  if (countCodePoints(content) > MAX_ENTRY_CHARS)
+    return `longer than ${String(MAX_ENTRY_CHARS)} characters`;
+  return null;
+}
 var QUOTA_WARN_PCT = 90;
 var SHORT_ID_HEX = 6;
 var INDEX_SUMMARY_CHARS = 80;
@@ -15700,6 +15817,17 @@ function stripUndefined(obj) {
   return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== void 0));
 }
 var MemoryManager = class {
+  constructor(dbPath, memDir, config, options = {}) {
+    this.options = options;
+    const dp = dbPath ?? DB_PATH;
+    const md = memDir ?? MEM_DIR;
+    this.memDir = md;
+    mkdirSync(dirname(dp), { recursive: true });
+    mkdirSync(this.memDir, { recursive: true });
+    this.db = new MemoryDB(dp);
+    this.config = { ...defaultMemoryConfig(), ...stripUndefined(config) };
+  }
+  options;
   db;
   config;
   memDir;
@@ -15712,15 +15840,6 @@ var MemoryManager = class {
   notices = [];
   notifiedBlocked = false;
   notifiedQuota = false;
-  constructor(dbPath, memDir, config) {
-    const dp = dbPath ?? DB_PATH;
-    const md = memDir ?? MEM_DIR;
-    this.memDir = md;
-    mkdirSync(dirname(dp), { recursive: true });
-    mkdirSync(this.memDir, { recursive: true });
-    this.db = new MemoryDB(dp);
-    this.config = { ...defaultMemoryConfig(), ...stripUndefined(config) };
-  }
   async initialize(_sessionId) {
     this.initialized = true;
     await this.reloadFromDisk();
@@ -15742,11 +15861,12 @@ var MemoryManager = class {
     let blockedCount = 0;
     for (const target of ["memory", "user"]) {
       const file = target === "memory" ? "MEMORY.md" : "USER.md";
-      const fromDisk = this.readFile(join(this.memDir, file));
+      const path = join(this.memDir, file);
+      const fromDisk = this.readFile(path);
       const deduped = [...new Set(fromDisk)];
       const classified = deduped.map((c) => this.classifyEntry(c));
       blockedCount += classified.filter((e) => e.blocked).length;
-      this.syncTarget(target, classified);
+      this.syncTarget(target, classified, existsSync(path));
     }
     this.assignIds();
     this.snapshot = this.renderIndexBlock();
@@ -15811,11 +15931,13 @@ var MemoryManager = class {
       }
     }
   }
-  syncTarget(target, desired) {
+  syncTarget(target, desired, notify = true) {
     const existing = new Map(this.db.getAll(target).map((e) => [e.content, e]));
     const desiredSet = new Set(desired.map((d) => d.content));
     for (const [content, entry] of existing) {
-      if (!desiredSet.has(content)) this.db.removeById(entry.id);
+      if (desiredSet.has(content)) continue;
+      this.db.removeById(entry.id);
+      if (notify) this.notifyRemoved({ id: entry.id, target, cause: "file-edit" });
     }
     for (const [i, item] of desired.entries()) {
       const prev = existing.get(item.content);
@@ -15969,10 +16091,69 @@ var MemoryManager = class {
     const existing = this.locate(target, oldText);
     if (!existing) return false;
     this.db.remove(target, existing.content);
+    this.notifyRemoved({ id: existing.id, target, cause: "remove" });
     this.consolidationFailures = 0;
     await this.flushToDisk();
     return true;
   }
+  async importEntry(rec, opts = {}) {
+    const invalid = fileSafe(rec.content);
+    if (invalid !== null) return { ok: false, reason: "invalid", detail: invalid };
+    const blocked = injectionLabelOf(rec.content) !== void 0;
+    const prev = this.db.getById(rec.id);
+    if (prev && opts.expectUpdatedAt !== void 0 && prev.updatedAt.getTime() !== opts.expectUpdatedAt) {
+      return { ok: false, reason: "conflict" };
+    }
+    const twin = this.db.findByContent(rec.target, rec.content);
+    if (twin && twin.id !== rec.id)
+      return { ok: false, reason: "duplicate-content", existingId: twin.id };
+    if (prev) {
+      if (prev.target === rec.target && prev.content === rec.content && prev.createdAt.getTime() === rec.createdAt && prev.updatedAt.getTime() === rec.updatedAt) {
+        return { ok: true, action: "unchanged", blocked: prev.blocked };
+      }
+      this.db.updateById({
+        id: rec.id,
+        target: rec.target,
+        content: rec.content,
+        createdAt: new Date(rec.createdAt),
+        updatedAt: new Date(rec.updatedAt),
+        blocked
+      });
+      await this.flushToDisk();
+      return { ok: true, action: "updated", blocked };
+    }
+    this.db.insert({
+      id: rec.id,
+      target: rec.target,
+      content: rec.content,
+      position: this.db.nextPos(rec.target),
+      charLength: rec.content.length,
+      accessCount: 0,
+      lastAccessedAt: new Date(rec.updatedAt),
+      createdAt: new Date(rec.createdAt),
+      updatedAt: new Date(rec.updatedAt),
+      blocked
+    });
+    await this.flushToDisk();
+    return { ok: true, action: "inserted", blocked };
+  }
+  async removeById(id, opts = {}) {
+    const prev = this.db.getById(id);
+    if (!prev) return false;
+    if (opts.expectUpdatedAt !== void 0 && prev.updatedAt.getTime() !== opts.expectUpdatedAt) {
+      return false;
+    }
+    this.db.removeById(id);
+    if (opts.notify !== false) this.notifyRemoved({ id, target: prev.target, cause: "remove" });
+    await this.flushToDisk();
+    return true;
+  }
+  notifyRemoved(removal) {
+    try {
+      this.options.onRemoved?.(removal);
+    } catch {
+    }
+  }
   locate(target, ref) {
     const key = ref.trim();
     const byId = this.ids.get(key);
@@ -16978,6 +17159,9 @@ var SessionDB = class {
     const run = this.db.transaction((sessionId) => {
       this.db.prepare("UPDATE sessions SET parent_id = NULL WHERE parent_id = ?").run(sessionId);
       this.db.prepare("DELETE FROM goals WHERE session_id = ?").run(sessionId);
+      if (this.hasTable("todos")) {
+        this.db.prepare("DELETE FROM todos WHERE session_id = ?").run(sessionId);
+      }
       this.db.prepare("DELETE FROM messages WHERE session_id = ?").run(sessionId);
       return this.db.prepare("DELETE FROM sessions WHERE id = ?").run(sessionId).changes;
     });
@@ -16989,15 +17173,57 @@ var SessionDB = class {
   unarchiveSession(id) {
     this.db.prepare("UPDATE sessions SET archived = 0 WHERE id = ?").run(id);
   }
-  importSession(meta, messages) {
+  importSession(meta, messages, extras = {}) {
+    if ((extras.todos?.length ?? 0) > 0) this.ensureTodoTable();
     const run = this.db.transaction(
       (m, list) => {
         this.insertSession(m);
-        return list.map((msg) => this.insertMessage({ ...msg, sessionId: m.id }));
+        const ids = list.map((msg) => this.insertMessage({ ...msg, sessionId: m.id }));
+        if ((extras.todos?.length ?? 0) > 0) {
+          const todo = this.db.prepare(
+            "INSERT INTO todos (id, session_id, content, status, reason, created_at, updated_at) VALUES (@id, @sessionId, @content, @status, @reason, @createdAt, @updatedAt)"
+          );
+          for (const t81 of extras.todos ?? []) {
+            todo.run({ ...t81, sessionId: m.id, reason: t81.reason || null });
+          }
+        }
+        const g = extras.goal;
+        if (g) {
+          this.db.prepare(
+            `INSERT INTO goals (
+                 id, session_id, objective, phase, block_code, block_msg,
+                 max_rounds, rounds_used, complete_evidence, created_at, updated_at
+               ) VALUES (
+                 @id, @sessionId, @objective, @phase, @blockCode, @blockMsg,
+                 @maxRounds, @roundsUsed, @completeEvidence, @createdAt, @updatedAt
+               )`
+          ).run({
+            ...g,
+            sessionId: m.id,
+            blockCode: g.blockCode ?? null,
+            blockMsg: g.blockMsg ?? null,
+            completeEvidence: g.completeEvidence ?? null
+          });
+        }
+        return ids;
       }
     );
     return run(meta, messages);
   }
+  freshTodoId() {
+    const taken = this.hasTable("todos") ? (id) => this.db.prepare("SELECT 1 FROM todos WHERE id = ?").get(id) !== void 0 : () => false;
+    for (; ; ) {
+      const id = randomBytes(3).toString("hex");
+      if (!taken(id)) return id;
+    }
+  }
+  hasTable(name) {
+    return this.db.prepare("SELECT 1 FROM sqlite_master WHERE type = 'table' AND name = ?").get(name) !== void 0;
+  }
+  ensureTodoTable() {
+    if (this.hasTable("todos")) return;
+    new TrackerDB(this.path).close();
+  }
   insertMessage(msg) {
     const info = this.db.prepare(
       `
@@ -17604,7 +17830,29 @@ var SessionReferences = class {
 // src/session/manager.ts
 var AUTO_VACUUM_MIN_FREELIST_RATIO = 0.25;
 var IMPORT_ROLES = /* @__PURE__ */ new Set(["system", "user", "assistant", "tool"]);
+var TODO_STATUSES = /* @__PURE__ */ new Set(["pending", "in_progress", "completed", "cancelled"]);
+function validateImportExtras(input) {
+  for (const [i, t81] of (input.todos ?? []).entries()) {
+    if (typeof t81.content !== "string" || t81.content === "") return `todos[${i}].content`;
+    if (!TODO_STATUSES.has(t81.status)) return `todos[${i}].status`;
+    if (typeof t81.createdAt !== "string" || typeof t81.updatedAt !== "string") return `todos[${i}].at`;
+  }
+  const g = input.goal;
+  if (g === void 0) return void 0;
+  if (typeof g.objective !== "string" || g.objective.trim() === "") return "goal.objective";
+  if (g.objective.length > MAX_OBJECTIVE_CHARS) return "goal.objective";
+  if (!isGoalPhase(g.phase)) return "goal.phase";
+  if (g.phase === "blocked" && !g.blockCode) return "goal.blockCode";
+  if (g.phase === "complete" && !g.completeEvidence) return "goal.completeEvidence";
+  if (!Number.isInteger(g.maxRounds) || g.maxRounds < 1 || g.maxRounds > MAX_GOAL_MAX_ROUNDS)
+    return "goal.maxRounds";
+  if (!Number.isInteger(g.roundsUsed) || g.roundsUsed < 0) return "goal.roundsUsed";
+  if (!Number.isFinite(g.createdAt) || !Number.isFinite(g.updatedAt)) return "goal.at";
+  return void 0;
+}
 function validateImport(input) {
+  const extras = validateImportExtras(input);
+  if (extras) return extras;
   const { meta, messages } = input;
   if (typeof meta.id !== "string" || meta.id.length === 0) return "meta.id";
   if (!Number.isFinite(meta.startedAt)) return "meta.startedAt";
@@ -17776,10 +18024,13 @@ var SessionManager = class {
       converted.push({ ...rest, parts: result.parts });
     }
     const droppedParentId = meta.parentId !== void 0 && !this.db.hasSession(meta.parentId) ? meta.parentId : void 0;
+    const todos = (input.todos ?? []).map((t81) => ({ ...t81, id: this.db.freshTodoId() }));
+    const goal = input.goal === void 0 ? void 0 : { ...input.goal, id: `goal_${randomUUID().replace(/-/g, "")}` };
     try {
       const newIds = this.db.importSession(
         buildImportedMeta(meta, droppedParentId === void 0),
-        converted
+        converted,
+        { todos, ...goal ? { goal } : {} }
       );
       const idMap = {};
       messages.forEach((msg, i) => {
@@ -17790,7 +18041,9 @@ var SessionManager = class {
         id,
         messageCount: newIds.length,
         idMap,
-        ...droppedParentId === void 0 ? {} : { droppedParentId }
+        ...droppedParentId === void 0 ? {} : { droppedParentId },
+        ...input.todos === void 0 ? {} : { todoIds: todos.map((t81) => t81.id) },
+        ...goal === void 0 ? {} : { goalId: goal.id }
       };
     } catch (err) {
       return {
@@ -18372,7 +18625,7 @@ function inspect(input, resolved, root, accepted) {
 }
 var MAX_RECENT_WORKSPACES = 20;
 var FILE_VERSION2 = 1;
-function describe6(err) {
+function describe7(err) {
   return err instanceof Error ? err.message : String(err);
 }
 var RecentWorkspaces = class {
@@ -18412,7 +18665,7 @@ var RecentWorkspaces = class {
       parsed = JSON.parse(readFileSync(this.filePath, "utf-8"));
     } catch (err) {
       this.loadErrors.push(
-        (lang) => t("workspace.recent_unreadable", { path: this.filePath, reason: describe6(err) }, lang)
+        (lang) => t("workspace.recent_unreadable", { path: this.filePath, reason: describe7(err) }, lang)
       );
       return;
     }
@@ -18465,7 +18718,7 @@ var RecentWorkspaces = class {
     } catch (err) {
       rmSync(tmp, { force: true });
       this.writeErrors.push(
-        (lang) => t("workspace.recent_write_failed", { path: this.filePath, reason: describe6(err) }, lang)
+        (lang) => t("workspace.recent_write_failed", { path: this.filePath, reason: describe7(err) }, lang)
       );
     }
   }
@@ -18477,7 +18730,7 @@ function isRecentWorkspace(value) {
 }
 var MAX_LAST_OPEN_SESSIONS = 20;
 var FILE_VERSION3 = 1;
-function describe7(err) {
+function describe8(err) {
   return err instanceof Error ? err.message : String(err);
 }
 var LastOpenSessions = class {
@@ -18516,7 +18769,7 @@ var LastOpenSessions = class {
       parsed = JSON.parse(readFileSync(this.filePath, "utf-8"));
     } catch (err) {
       this.loadErrors.push(
-        (lang) => t("last_session.unreadable", { path: this.filePath, reason: describe7(err) }, lang)
+        (lang) => t("last_session.unreadable", { path: this.filePath, reason: describe8(err) }, lang)
       );
       return;
     }
@@ -18543,7 +18796,7 @@ var LastOpenSessions = class {
     } catch (err) {
       rmSync(tmp, { force: true });
       this.writeErrors.push(
-        (lang) => t("last_session.write_failed", { path: this.filePath, reason: describe7(err) }, lang)
+        (lang) => t("last_session.write_failed", { path: this.filePath, reason: describe8(err) }, lang)
       );
     }
   }
@@ -18554,7 +18807,7 @@ function isLastOpenSession(value) {
   return typeof v["root"] === "string" && v["root"].length > 0 && typeof v["sessionId"] === "string" && v["sessionId"].length > 0 && typeof v["at"] === "number";
 }
 var FILE_VERSION4 = 1;
-function describe8(err) {
+function describe9(err) {
   return err instanceof Error ? err.message : String(err);
 }
 var AppearanceStore = class {
@@ -18587,7 +18840,7 @@ var AppearanceStore = class {
       parsed = JSON.parse(readFileSync(this.filePath, "utf-8"));
     } catch (err) {
       this.loadErrors.push(
-        (lang) => t("appearance.unreadable", { path: this.filePath, reason: describe8(err) }, lang)
+        (lang) => t("appearance.unreadable", { path: this.filePath, reason: describe9(err) }, lang)
       );
       return;
     }
@@ -18614,7 +18867,7 @@ var AppearanceStore = class {
     } catch (err) {
       rmSync(tmp, { force: true });
       this.writeErrors.push(
-        (lang) => t("appearance.write_failed", { path: this.filePath, reason: describe8(err) }, lang)
+        (lang) => t("appearance.write_failed", { path: this.filePath, reason: describe9(err) }, lang)
       );
     }
   }
@@ -19472,6 +19725,60 @@ var ScheduleStore = class {
       osTaskId: "",
       osCommand: []
     };
+    this.insertRow(def);
+    return def;
+  }
+  importDefinition(input) {
+    const synced = {
+      name: input.name,
+      prompt: input.prompt,
+      ...input.model !== void 0 ? { model: input.model } : {},
+      ...input.role !== void 0 ? { role: input.role } : {},
+      ...input.skills !== void 0 ? { skills: [...input.skills] } : {},
+      ...input.mcpServers !== void 0 ? { mcpServers: [...input.mcpServers] } : {},
+      permission: input.permission,
+      allowTools: [...input.allowTools],
+      allowOperations: [...input.allowOperations],
+      allowRules: [...input.allowRules],
+      maxTurns: input.maxTurns,
+      maxBudgetUsd: input.maxBudgetUsd,
+      timeoutMs: input.timeoutMs,
+      ...input.showInSessionList === true ? { showInSessionList: true } : {},
+      trigger: input.trigger,
+      ...input.startDate !== void 0 ? { startDate: input.startDate } : {},
+      ...input.endDate !== void 0 ? { endDate: input.endDate } : {},
+      createdAt: input.createdAt,
+      updatedAt: input.updatedAt
+    };
+    const current = this.get(input.id);
+    if (current) {
+      const {
+        model: _m,
+        role: _r,
+        skills: _s,
+        mcpServers: _mc,
+        showInSessionList: _sh,
+        startDate: _sd,
+        endDate: _ed,
+        ...kept
+      } = current;
+      const next = { ...kept, ...synced };
+      this.writeRow(next);
+      return { action: "updated", schedule: next };
+    }
+    const def = {
+      id: input.id,
+      ...synced,
+      enabled: false,
+      workDir: input.workDir,
+      osBackend: "host",
+      osTaskId: "",
+      osCommand: []
+    };
+    this.insertRow(def);
+    return { action: "inserted", schedule: def };
+  }
+  insertRow(def) {
     this.db.prepare(
       `INSERT INTO schedules (
            id, name, enabled, created_at, updated_at, prompt, work_dir, model, role,
@@ -19489,7 +19796,6 @@ var ScheduleStore = class {
            @last_run_at, @last_status
          )`
     ).run(toRow(def));
-    return def;
   }
   get(id) {
     const row = this.db.prepare("SELECT * FROM schedules WHERE id = ?").get(id);
@@ -21133,7 +21439,7 @@ function loadLexiconDir(dir, source) {
       });
       continue;
     }
-    collect2(content, file, spec, source, out);
+    collect3(content, file, spec, source, out);
   }
   return out;
 }
@@ -21146,7 +21452,7 @@ function classify(file) {
   }
   return CATEGORY_SET.has(base) ? { kind: "terms", category: base } : null;
 }
-function collect2(content, file, spec, source, out) {
+function collect3(content, file, spec, source, out) {
   const lines = content.split("\n");
   for (let i = 0; i < lines.length; i++) {
     const line = (lines[i] ?? "").trim();
@@ -21409,7 +21715,7 @@ var HookManager = class {
             return { blocked: true, reason: result.rejectReason || t("hook_load.rejected") };
           }
         } catch (err) {
-          this.log("warn", `[HookManager] ${type} \u7684 command hook \u6267\u884C\u5F02\u5E38: ${describe10(err)}`, {
+          this.log("warn", `[HookManager] ${type} \u7684 command hook \u6267\u884C\u5F02\u5E38: ${describe11(err)}`, {
             hookType: type,
             command: config.command
           });
@@ -21427,7 +21733,7 @@ var HookManager = class {
           (_, reject2) => setTimeout(() => reject2(new Error("Hook timeout")), HOOK_TIMEOUT_MS)
         )
       ]).catch((err) => {
-        this.log("warn", `[HookManager] ${type} (${reg.plugin}) \u5931\u8D25: ${describe10(err)}`, {
+        this.log("warn", `[HookManager] ${type} (${reg.plugin}) \u5931\u8D25: ${describe11(err)}`, {
           hookType: type,
           plugin: reg.plugin
         });
@@ -21439,7 +21745,7 @@ var HookManager = class {
         if (!matchesHook(entry.matcher, event)) continue;
         for (const config of entry.configs) {
           runCommandHook(config, event, ctx.workDir).then((result) => reportIfNeverRan(this.log, type, config, result)).catch((err) => {
-            this.log("warn", `[HookManager] ${type} \u7684 command hook \u5F02\u6B65\u5F02\u5E38: ${describe10(err)}`, {
+            this.log("warn", `[HookManager] ${type} \u7684 command hook \u5F02\u6B65\u5F02\u5E38: ${describe11(err)}`, {
               hookType: type,
               command: config.command
             });
@@ -21460,7 +21766,7 @@ var HookManager = class {
         ]);
         if (result !== null && result !== void 0) return result;
       } catch (err) {
-        this.log("warn", `[HookManager] ${type} (${reg.plugin}) \u5931\u8D25: ${describe10(err)}`, {
+        this.log("warn", `[HookManager] ${type} (${reg.plugin}) \u5931\u8D25: ${describe11(err)}`, {
           hookType: type,
           plugin: reg.plugin
         });
@@ -21481,7 +21787,7 @@ var HookManager = class {
         ]);
         if (result) results.push(result);
       } catch (err) {
-        this.log("warn", `[HookManager] ${type} (${reg.plugin}) \u5931\u8D25: ${describe10(err)}`, {
+        this.log("warn", `[HookManager] ${type} (${reg.plugin}) \u5931\u8D25: ${describe11(err)}`, {
           hookType: type,
           plugin: reg.plugin
         });
@@ -21498,7 +21804,7 @@ var HookManager = class {
             const verdict = verdictOf2(result);
             if (verdict) results.push(verdict);
           } catch (err) {
-            this.log("warn", `[HookManager] ${type} \u7684 command hook \u6267\u884C\u5F02\u5E38: ${describe10(err)}`, {
+            this.log("warn", `[HookManager] ${type} \u7684 command hook \u6267\u884C\u5F02\u5E38: ${describe11(err)}`, {
               hookType: type,
               command: config.command
             });
@@ -21514,7 +21820,7 @@ var HookManager = class {
     return [...list].sort((a, b) => a.priority - b.priority);
   }
 };
-function describe10(err) {
+function describe11(err) {
   return err instanceof Error ? err.message : String(err);
 }
 function verdictOf2(result) {
@@ -22803,7 +23109,10 @@ async function importSkills(source, opts) {
         detail: t("skill.import_stale", void 0, opts.lang)
       };
     }
-    return { ok: true, ...commit3(preview3, staged, opts.skillsDir, opts.lang) };
+    return {
+      ok: true,
+      ...commit3(preview3, staged, opts.skillsDir, opts.lang, opts.replace === true)
+    };
   });
 }
 async function withStaged(source, opts, fn) {
@@ -22837,7 +23146,7 @@ async function withStaged(source, opts, fn) {
       shape = existsSync(join(unpacked, SKILL_FILE)) ? "skill-dir" : "tree";
     }
     const staged = stageImport(root, staging, shape, opts.lang);
-    const preview3 = describe11(source, form, staged.skills, staged.issues, opts.existing, opts.lang);
+    const preview3 = describe12(source, form, staged.skills, staged.issues, opts.existing, opts.lang);
     if (preview3.skills.length === 0) {
       const detail = t("skill.import_empty", { path: source }, opts.lang);
       return { ok: false, reason: "empty", detail, issues: preview3.issues };
@@ -22848,7 +23157,7 @@ async function withStaged(source, opts, fn) {
     rmSync(unpacked, { recursive: true, force: true });
   }
 }
-function describe11(source, form, staged, issues, existing, lang) {
+function describe12(source, form, staged, issues, existing, lang) {
   const byName = new Map(existing.map((s) => [s.name, s.scope]));
   const entries2 = [];
   const taken = /* @__PURE__ */ new Set();
@@ -22890,6 +23199,35 @@ function renameStaged(skill, name) {
   skill.name = name;
   skill.dir = next;
 }
+function findUserSkillDir(skillsDir, name) {
+  if (!existsSync(skillsDir)) return void 0;
+  for (const category of readdirSync(skillsDir, { withFileTypes: true })) {
+    if (!category.isDirectory() || category.name.startsWith(".")) continue;
+    const dir = join(skillsDir, category.name, name);
+    if (existsSync(join(dir, SKILL_FILE))) return dir;
+  }
+  return void 0;
+}
+function swapInto(from, old, dest, skillsDir) {
+  const trash = join(skillsDir, `.trash-${randomUUID()}`);
+  try {
+    mkdirSync(trash, { recursive: true });
+    renameSync(old, join(trash, "old"));
+  } catch (err) {
+    rmSync(trash, { recursive: true, force: true });
+    return err instanceof Error ? err.message : String(err);
+  }
+  try {
+    mkdirSync(dirname(dest), { recursive: true });
+    renameSync(from, dest);
+  } catch (err) {
+    renameSync(join(trash, "old"), old);
+    rmSync(trash, { recursive: true, force: true });
+    return err instanceof Error ? err.message : String(err);
+  }
+  rmSync(trash, { recursive: true, force: true });
+  return null;
+}
 function conflictOf(name, existing) {
   const scope = existing.get(name);
   if (scope === void 0) return {};
@@ -22922,12 +23260,26 @@ function digest(entries2, staged) {
   }
   return hash.digest("hex").slice(0, 32);
 }
-function commit3(preview3, staged, skillsDir, lang) {
+function commit3(preview3, staged, skillsDir, lang, replace = false) {
   const byName = new Map(staged.map((s) => [s.name, s.dir]));
   const imported = [];
   const skipped = [];
   for (const entry of preview3.skills) {
     const label = `${entry.category}/${entry.name}`;
+    if (replace && entry.conflict?.scope === "user") {
+      const from2 = byName.get(entry.name);
+      const old = findUserSkillDir(skillsDir, entry.name);
+      if (from2 !== void 0 && old !== void 0) {
+        const swapped = swapInto(from2, old, join(skillsDir, entry.category, entry.name), skillsDir);
+        if (swapped === null) imported.push(entry.name);
+        else
+          skipped.push({
+            path: label,
+            message: t("skill.import_write_failed", { reason: swapped }, lang)
+          });
+        continue;
+      }
+    }
     if (entry.conflict?.verdict === "refuse") {
       skipped.push({
         path: label,
@@ -23700,7 +24052,7 @@ ${extra}` : withGoal;
 var FILE_VERSION5 = 1;
 var LEVELS = ["trusted", "untrusted"];
 var SCOPES = ["directory", "directory-tree"];
-function describe12(err) {
+function describe13(err) {
   return err instanceof Error ? err.message : String(err);
 }
 function covers(base, target, scope) {
@@ -23774,7 +24126,7 @@ var TrustManager = class {
       raw = readFileSync(this.filePath, "utf-8");
     } catch (err) {
       this.loadErrors.push(
-        t("trust_gate.record_read_failed", { path: this.filePath, reason: describe12(err) })
+        t("trust_gate.record_read_failed", { path: this.filePath, reason: describe13(err) })
       );
       return;
     }
@@ -23783,7 +24135,7 @@ var TrustManager = class {
       parsed = JSON.parse(raw);
     } catch (err) {
       this.loadErrors.push(
-        t("trust_gate.record_bad_json", { path: this.filePath, reason: describe12(err) })
+        t("trust_gate.record_bad_json", { path: this.filePath, reason: describe13(err) })
       );
       return;
     }
@@ -23832,7 +24184,7 @@ var TrustManager = class {
     } catch (err) {
       rmSync(tmp, { force: true });
       throw new Error(
-        t("trust_gate.record_write_failed", { path: this.filePath, reason: describe12(err) })
+        t("trust_gate.record_write_failed", { path: this.filePath, reason: describe13(err) })
       );
     }
   }
@@ -24221,4 +24573,4 @@ function trunc(stdout, stderr) {
  *    `--tree` 的命令帮助里，让用户自己知道 `--tree` 意味着什么。
  */
 
-export { AGENT_ROLE_DIAG_MODULE, ARTIFACT_MAX_TOTAL_BYTES, ARTIFACT_RETENTION_DEFAULTS, ATTACHMENT_MAX_TOTAL_BYTES, ATTACHMENT_RETENTION_DEFAULTS, AgentLoop, AppearanceStore, ApprovalCache, BLOCKED_TOOLS, BudgetGuard, BudgetStore, CHECKPOINT_MAX_TOTAL_BYTES, CLAUDE_EVENT_NAMES, CLAUDE_TOOL_NAMES, CODE_MODE_LIMITS, CODE_MODE_SDK_TAG, CONFIG_KEYS, CURRENT_CONFIG_VERSION, CheckpointManager, CheckpointStore, CodeSandbox, ComplianceEngine, ContextCompressor, DEFAULT_COMPLIANCE_ACTIONS, DEFAULT_COMPLIANCE_SETTINGS, DEFAULT_COMPRESSION_THRESHOLD, DEFAULT_GOAL_MAX_ROUNDS, DEFAULT_MAX_HOLD_CHARS, DelegateManager, EMPTY_RULES, EPOCH_DISK_LEDGER, EpochConfigSchema, FTS_TABLES, FTS_TRIGGERS, GOAL_BLOCK_CODES, GoalService, GoalStore, HEADLESS_AUDIT_CODES, HookManager, INSTRUCTION_BUDGET_CHARS, INSTRUCTION_FILES, ImageLoadError, ImportTrustStore, LAUNCHD_LABEL_PREFIX, LOCK_HEARTBEAT_MS, LOCK_STALE_MS, LastOpenSessions, 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, ManagedPolicyError, ManagedSettingsSchema, MemoryManager, ModelFailureTracker, NOMINAL_TOTAL_BYTES, NO_REVEALED_TOOLS, 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, PermissionManager, PlanModeState, PluginAuthorSchema, PluginStore, PolicyRuleSchema, ProviderError, ProviderRouter, RECORDING_KEEP_RUNS, RECORDING_MAX_BYTES, ROLE_FRONTMATTER_SCHEMA, RUN_CODE_TOOL, RecentWorkspaces, 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, ScheduleRecorder, ScheduleRegistrar, ScheduleStore, SessionManager, SessionQueries, SessionReferences, SettingsFileError, SettingsFileSchema, SkillLearner, SkillSystem, TOOL_SEARCH_TOOL, TaskNoticeTracker, ToolRegistry, TrackerDB, TrustManager, Workspace, acquireScheduleLock, addMarketplace, addUsage, admitArtifact, admitArtifacts, affectedPaths, approvalEntryFor, approvalRootFor, 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, grantedPathsFor, 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, runCommand2 as 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 { ABOUT_DESC_MAX_CHARS, ABOUT_README_MAX_CHARS, AGENT_ROLE_DIAG_MODULE, ARTIFACT_MAX_TOTAL_BYTES, ARTIFACT_RETENTION_DEFAULTS, ATTACHMENT_MAX_TOTAL_BYTES, ATTACHMENT_RETENTION_DEFAULTS, AgentLoop, AppearanceStore, ApprovalCache, BLOCKED_TOOLS, BudgetGuard, BudgetStore, CHECKPOINT_MAX_TOTAL_BYTES, CLAUDE_EVENT_NAMES, CLAUDE_TOOL_NAMES, CODE_MODE_LIMITS, CODE_MODE_SDK_TAG, CONFIG_KEYS, CURRENT_CONFIG_VERSION, CheckpointManager, CheckpointStore, CodeSandbox, ComplianceEngine, ContextCompressor, DEFAULT_COMPLIANCE_ACTIONS, DEFAULT_COMPLIANCE_SETTINGS, DEFAULT_COMPRESSION_THRESHOLD, DEFAULT_GOAL_MAX_ROUNDS, DEFAULT_MAX_HOLD_CHARS, DelegateManager, EMPTY_RULES, EPOCH_DISK_LEDGER, EpochConfigSchema, FTS_TABLES, FTS_TRIGGERS, GOAL_BLOCK_CODES, GoalService, GoalStore, HEADLESS_AUDIT_CODES, HookManager, INSTRUCTION_BUDGET_CHARS, INSTRUCTION_FILES, ImageLoadError, ImportTrustStore, LAUNCHD_LABEL_PREFIX, LOCK_HEARTBEAT_MS, LOCK_STALE_MS, LastOpenSessions, 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, ManagedPolicyError, ManagedSettingsSchema, MemoryManager, ModelFailureTracker, NOMINAL_TOTAL_BYTES, NO_REVEALED_TOOLS, 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, PermissionManager, PlanModeState, PluginAuthorSchema, PluginStore, PolicyRuleSchema, ProviderError, ProviderRouter, RECORDING_KEEP_RUNS, RECORDING_MAX_BYTES, ROLE_FRONTMATTER_SCHEMA, RUN_CODE_TOOL, RecentWorkspaces, 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_ASSET_DIRS, SKILL_CREATE_TOOL, SKILL_EDIT_TOOL, SKILL_FILE, SKILL_PATCH_TOOL, SKILL_VIEW_TOOL, SKILL_WRITE_FILE_TOOL, SLASH_COMMANDS_DIAG_MODULE, ScheduleRecorder, ScheduleRegistrar, ScheduleStore, SessionManager, SessionQueries, SessionReferences, SettingsFileError, SettingsFileSchema, SkillLearner, SkillSystem, TOOL_SEARCH_TOOL, TaskNoticeTracker, ToolRegistry, TrackerDB, TrustManager, Workspace, acquireScheduleLock, addMarketplace, addUsage, admitArtifact, admitArtifacts, affectedPaths, approvalEntryFor, approvalRootFor, 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, grantedPathsFor, 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, readPluginAbout, 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, runCommand2 as 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epoch-agent/core",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "private": false,
   "description": "epoch-agent 核心引擎：ReAct 循环、Provider 路由、工具调度、记忆管理",
   "repository": {
@@ -27,8 +27,8 @@
     "gpt-tokenizer": "^3.4.0",
     "js-yaml": "^5.2.3",
     "zod": "^4.4.3",
-    "@epoch-agent/infra": "0.25.0",
-    "@epoch-agent/protocol": "0.25.0"
+    "@epoch-agent/infra": "0.27.0",
+    "@epoch-agent/protocol": "0.27.0"
   },
   "devDependencies": {
     "@ai-sdk/alibaba": "^2.0.59",