@shgroup/dsh-serenity-hooks 1.34.2 → 1.35.0

package/lib/autopilot-trajectory.d.ts

@@ -1,230 +0,0 @@
-/**
- * autopilot-trajectory.ts — Autopilot Trajectory（自动巡航轨迹，正式版 v1.27.4）
- *
- * 前身：autotrajectory（v1.26.12~17 实验验证机制）。用户拍板正式化：
- * 命名 = Autopilot Trajectory（autotrajectory 是技术代号——"auto" 弱前缀 + "trajectory"
- * 内部术语；Autopilot 契合宁静号 Ship 隐喻：设定目标 → 自主巡航 → 驾驶舱可见 → 人类可接管，
- * 加 Trajectory 明确对象）。成熟度分级：L1 时钟唤起 → L2 焦点+偏见 → **L3 质量反馈环（下一轮）**。
- *
- * 依据：serenity-acc-specs/docs/self-sustaining-trajectory-hypothesis.md（v0.1 实验提案；
- * S142 2026-08-30 用户提出猜想 + 三项裁决：① 时钟驱动 ② 先验偏见自生+随机（随机充分引入）
- * ③ 人类=反馈来源（不直接参与））。
- *
- * 形态（用户拍板 v0.5 + 正式化 v1.27.4）：
- *   · **前台运行**：时钟唤起 = 向活跃会话注入唤起消息（agent.steer，v1.22.5 自动继续同款
- *     通道）→ 模型自动继续 → 用户全程可见、随时可介入（人类反馈天然并入——同会话）。
- *   · **偏见内容提供者 = CCC 根目录下脚本**（biasProvider；缺省 autopilot-bias.ts，
- *     旧默认 autotrajectory-bias.ts 回退——pangu 等已配置 CCC 兼容）：tool 直接运行取
- *     stdout 作为偏见内容；脚本缺失 → **报错要求实现**（偏见内容归 CCC）。
- *   · **会话标志 = 目录名后缀 --auto**：AGENT_SESSIONS/<date>--<desc>--auto/ → 自主形态。
- *   · **轨迹焦点 topPrompt = CCC 定义**：每次唤起最先注入的顶层提示词（稳定焦点锚定防漂移）。
- *   · **唤起窗口避开北京时间 8~18 点**（用量峰谷省钱）——avoidWakeHours 可覆盖。
- *   · **多 CCC 独立（v1.27.4，用户"4个CCC能各自有autotrajectory吗"）**：配置层本就 CCC 级
- *     （enabled/intervalHours/session/biasProvider/topPrompt/窗口）；正式版时钟遍历所有
- *     live+enabled CCC 各自评估唤起（collectAutopilotCccs），running 守卫 per-CCC + 全局
- *     串行化（防模型并发挤兑）。
- *   · **默认关**：serenity.json autopilotTrajectory.enabled=false → 定时器不启动，零资源占用。
- */
-import type { Context } from 'cordis';
-import type { AutopilotTrajectorySettings } from './ccc.js';
-import { type WakeRecord } from './autopilot-core.js';
-import { type ClockRuntime } from './clock-runtime.js';
-import type { WakeChainFacts } from './autopilot-chain.js';
-/**
- * 判据原语（`readAutopilotSettings` / `beijingHour` / `inAllowedWakeWindow` /
- * `isAutopilotSession` / `resolveTargetMd` / `judgeWake` / `shouldWake` /
- * `readSelfGeneratedMotivation` / `fetchBiasContent` / 常量）**已提取至
- * `autopilot-core.ts`**（S142 §12.13 ⑥ C6a）——本文件是它们的**组合方之一**
- * （tick + 面板 + agent 定位），不再自持判据副本。
- * 提取理由与"三处消费方共用一份判据"的约束见该文件头部注释。
- */
-/** 审计历史 ring 上限（每 CCC 保留最近 N 条唤起记录） */
-export declare const AUDIT_HISTORY_MAX = 50;
-/** 唤起消息（四段式：轨迹焦点[CCC 定义，稳定] / 身份锚定 / 先验偏见[自生动机+偏见内容] / 任务）——注入前台会话，用户可见 */
-export declare function buildWakeMessage(opts: {
-    sessionName: string;
-    mdPath: string;
-    intervalHours: number;
-    topPrompt: string | null;
-    motivation: string | null;
-    biasContent: string | null;
-}): string;
-/** 唤起结果（tick 日志 / 面板显示 / 审计记录共用） */
-interface WakeResult {
-    ok: boolean;
-    detail: string;
-}
-/** 追加审计记录（ring 截断） */
-export declare function recordWake(root: string, rec: WakeRecord): void;
-/** 读审计历史（root 的最近记录；无 → []） */
-export declare function wakeHistoryFor(root: string): WakeRecord[];
-/** 测试辅助：清空审计（生产零调用） */
-export declare function resetWakeHistory(): void;
-/**
- * 执行一次唤起（时钟 tick 与面板「立即唤起」共用）：
- * - force=false（时钟）：完整校验——enabled / 目标命中 / --auto 标志 / 窗口 / 间隔 / 偏见脚本
- * - force=true（手动调试，用户在场）：跳过窗口/间隔，仍校验 enabled / 目标命中 / --auto / 偏见脚本
- *   （v1.27.12 移除每日唤起预算——force 无预算可跳，时钟也不受限）
- * 成功 → 注入前台会话（agent.steer，用户可见）；返回结果供调用方（tick 打日志 / 面板显示 / 审计）。
- */
-export declare function performAutopilotWake(ctx: Context, root: string, settings: AutopilotTrajectorySettings, opts?: {
-    force?: boolean;
-}): Promise<WakeResult>;
-/**
- * **周期自唤醒全局闸**（v1.34 更名收窄，原 `autopilotEnabled`）：关 = 定时器不武装 + tick 不唤起。
- *
- * 语义边界（用户 2026-09-15 裁决 S-1）：**只管周期自唤醒** —— 一次性唤醒（`container_trajectory wake-later`）
- * 归 `wakeSchedulerEnabled`，两者**互不连带**（旧实现共用一闸是缺陷，见 wake-scheduler 注释）。
- *
- * 读取顺序（迁移期，不回写）：`autopilotWakeEnabled`（新键）→ `autopilotEnabled`（旧键）→ false。
- * 用 `??` 而非 `||` 的理由：**新键显式 false 必须能覆盖旧键 true**（否则"关不掉"）。
- * 抽成模块级函数是为了让 {@link autopilotClockState}（诊断）与 tick 读**同一判据**。
- *
- * v1.34.1（⑥ C6a）：**导出**——CCC 工具面（`container_admin autopilot status`）与条件链
- * （{@link autopilotRuntimeFacts}）必须读**这一份**闸值。旧独立脚本读不到它 ⇒ 闸关着也印
- * 「✅ 唤起条件全部满足」（8 项分歧之首，见 SESSION §12.13 与现状稿 §4.4）。
- */
-export declare function autopilotGloballyEnabled(): boolean;
-/**
- * autopilot **进程态**类型（诊断用，模块级 = 进程级）。
- *
- * C6b（P2）：字段由 {@link ClockRuntime}（**工厂那份**）提供，**字段名与语义一个字未改**。
- * 与 {@link wakeSchedulerState} 的差别只有一项：本钟**没有** `lastTickLog`（结果进下方
- * `wakeHistory` 审计 ring，不走 tick 日志）——故 `ClockRuntime.lastTickLog` 在工厂里是可选的。
- */
-export type AutopilotClockRuntime = ClockRuntime;
-declare const clock: import("./clock-runtime.js").Clock;
-/**
- * autopilot **进程态**快照（只读；`enabled` = 全局闸**当前**值）。
- * ⚠️ 与 {@link wakeSchedulerState} 同规格，但**本钟无 `lastTickLog`**（见 {@link ClockOptions.logFrom}）。
- */
-export declare function autopilotClockState(): ReturnType<typeof clock.snapshot>;
-/** 测试用：复位进程态（含 per-CCC 重入守卫，避免用例间串味） */
-export declare function __resetAutopilotClockStateForTest(): void;
-/** 该 CCC 是否有唤起轮正在进行中（tick 的 per-CCC 防重入判据；诊断读同一份） */
-export declare function autopilotWakeInFlight(root: string): boolean;
-/**
- * 装配（index.ts apply 调用）。时钟唤起（v1.26.14 修复 + v1.27.4 多 CCC 独立）：
- *
- * v1.26.14 根因：旧实现启动时一次性解析 root——web 进程启动时 live 会话往往为空 → 定时器不启动。
- * 修复：① 每次 tick 动态解析 root+settings ② 监听 session/created 启动定时器 ③ 优先实验 CCC。
- *
- * **v1.27.4 多 CCC 独立（用户"4个CCC能各自有autotrajectory吗"）**：
- * - 单定时器保留（TICK_MS 5min），每次 tick **遍历所有 live+enabled CCC**（collectAutopilotCccs）
- *   各自评估 shouldWake + 各自唤起——每 CCC 的 interval/session/bias/topPrompt/窗口独立
- * - `running` 守卫 **per-CCC**（不同 CCC 唤起互不阻塞）
- * - **全局串行化**（wakeChain：同 tick 多 CCC 到点 → 依次唤起，防模型并发挤兑）
- *
- * 零资源占用语义保留：无 enabled CCC → tick 内直接 return（定时器存在但每 5min 一次空检查，
- * unref 不阻塞进程退出）。
- */
-export declare function registerAutopilot(ctx: Context): void;
-/**
- * 面板状态（GET /serenity/trajectory 数据源；纯逻辑，可单测）——
- * WebUI 设置面板「Autopilot Trajectory」只读区块展示的完整状态：配置摘要 + 目标会话
- * 命中/标志/空闲时长 + 当前窗口/可唤起判定 + 审计（最近唤起）。
- * 不运行偏见脚本（只报脚本是否就绪——运行验证走 trajectory random）。
- */
-interface AutopilotTrajectoryStatus {
-    /** 是否配置了 trajectory.autopilot 段（.opencode/serenity.json；旧键 autopilotTrajectory / autotrajectory 回退） */
-    configured: boolean;
-    /** 总开关（缺省 false——未开零资源占用） */
-    enabled: boolean;
-    /** 无人类活动 N 小时后自动唤起（缺省 12） */
-    intervalHours: number;
-    /** 偏见内容提供者脚本（相对 CCC 根；缺省 autopilot-bias.ts） */
-    biasProvider: string;
-    /** 顶层提示词（每次唤起最先注入的稳定指令；未配置 → null） */
-    topPrompt: string | null;
-    /** 目标会话（S###/目录名；未配置 = 不唤起） */
-    session: string | null;
-    /** 避开唤起的高峰时段（北京时间） */
-    avoidWakeHours: {
-        start: number;
-        end: number;
-    };
-    /** 目标会话状态（未配置/未命中 → null） */
-    target: {
-        /** 目录名（含 --auto 后缀时为自主形态） */
-        dirName: string;
-        /** 目录名是否带 --auto 标志 */
-        autoFlag: boolean;
-        /** 距上次轨迹活动（小时） */
-        idleHours: number;
-        /** 当前时刻是否满足唤起条件（标志+间隔+窗口，未运行中；v1.27.12 移除每日预算） */
-        wakeable: boolean;
-    } | null;
-    /** 当前北京时间小时 */
-    beijingHour: number;
-    /** 当前是否在唤起窗口内（避开高峰之外） */
-    windowAllowed: boolean;
-    /** 审计：最近唤起记录（最多 10 条展示；正式版 v1.27.4） */
-    recentWakes: WakeRecord[];
-}
-export declare function getAutopilotStatus(root: string): AutopilotTrajectoryStatus;
-/** live 会话条目（诊断/面板解析用；标题从 events 读） */
-interface LiveSessionEntry {
-    id: string;
-    cwd: string | null;
-    cccRoot: string | null;
-    title: string | null;
-}
-/**
- * live 会话清单（诊断/面板解析用；标题从 events 读）——**只枚举 live 会话本身**。
- *
- * C2：CCC 枚举（"本机有哪些 CCC"）**不在这里**，归 `ccc-roots.listCccs`（并集）。
- * 本函数保留的是它**独有**的那部分：逐条 live 会话 + cwd 归属 + 标题 + id
- * （诊断页需要"哪个会话属于哪个 CCC"，那是会话维度、不是 CCC 维度）。
- * @param ctx 插件上下文
- * @returns 逐条 live 会话（`cccRoot` = 该会话 cwd 的 CCC 归属，无 → null）
- */
-export declare function listLiveSessions(ctx: Context): LiveSessionEntry[];
-/**
- * 收集所有「配置了 Autopilot Trajectory 的 live CCC」——**v1.27.4 多 CCC 独立**：
- * 返回 enabled 的 CCC 列表（时钟 tick 遍历目标）；无 enabled → []。
- * （原 resolveAutoTrajectoryCcc 单目标语义被 collect 取代——面板/诊断用 enableOnly=false 取全量）
- */
-export declare function collectAutopilotCccs(ctx: Context, opts?: {
-    includeDisabled?: boolean;
-}): string[];
-/**
- * 进程内诊断（trajectory diag-live 数据源；用户"排查访问不到 pangu 写个 msm"）——
- * 输出当前实例 live 会话清单（id/cwd/ccc/标题）+ 每个配置了 Autopilot 的 CCC
- * 状态（配置摘要/目标命中/可唤起）+ 目标 agent 定位结果。脚本 diag 看不到运行时，
- * 本函数在插件进程内运行（能读 sessions/agents）。
- */
-export interface DiagLiveReport {
-    processCwd: string;
-    processCcc: string | null;
-    liveSessions: LiveSessionEntry[];
-    autopilotCccs: Array<{
-        root: string;
-        enabled: boolean;
-        session: string | null;
-        target: AutopilotTrajectoryStatus['target'];
-        agentResolved: boolean;
-        agentDiagnosis: string | null;
-    }>;
-    panelResolved: string | null;
-}
-export declare function diagLive(ctx: Context): DiagLiveReport;
-/**
- * **条件链的运行态事实**（⑥ C6a 的核心出口）——把只有插件进程能看到的判据交给
- * 条件链（{@link buildWakeChain} 的输入）：全局闸 / 重入守卫 / live 运行态。
- *
- * 为什么必须有（这是 C6 的动机本身）：旧独立脚本只能读文件 ⇒ 结构性地看不到这三样，
- * 于是逐条件报告**必然**与实际唤起行为分歧（8 项，见 `acc-component-relations-current-state.md` §4.4）。
- * 搬进进程内之后，`container_admin autopilot status` 与 `acc-diag` ④ 段读的就是**同一份事实**。
- *
- * `ctx` 可传 `null`（**不是**"三项全不可知"）：全局闸（`readSimpleSettings`）与重入守卫
- * （模块级 `runningByRoot`）**都不需要 ctx**，无 ctx 时也应读出真值——只有 live 运行态
- * （live 会话 / agent 可解析）依赖 ctx，那才是真正的"不可知"。
- * 这条区分由 `autopilot-ops.test.ts` 的全局闸可见性用例逼出来（首版把三者一起降级为不可知，
- * 使"闸关"在无 ctx 路径下隐形——正是本轮要消灭的那类假报告）。
- *
- * @param ctx 插件上下文（读 live 会话 + agent）；null = 无进程上下文（live 标不可知）
- * @param root 目标 CCC 根
- * @returns 条件链事实（`live` 为 null 表示"live 运行态不可知"）
- */
-export declare function autopilotRuntimeFacts(ctx: Context | null, root: string): WakeChainFacts;
-export {};

package/lib/trajectory-bound-Cax1p9ut.js

@@ -1,190 +0,0 @@
-import { r as cccRootForCwd } from "./ccc-roots-Bd_SjEs7.js";
-import { c as getLastActiveSessionInfo, p as sessionEvents, s as getActiveSessionInfo } from "./trajectory-ops-mrXK0H0I.js";
-import { dirname, join } from "node:path";
-import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
-//#region src/trajectory-bound.ts
-/**
-* trajectory-bound.ts — SESSION 绑定持久化（CCC 内 `AGENT_SESSIONS/.bindings.json`）
-*
-* 目标（S142 用户拍板，方案 v1.0）：让「dsh 会话（载体）↔ SESSION（宁静号轨迹）」
-* 的绑定坚固——LLM 不能因智力因素（幻觉/理解偏差）在过程中或 container_trajectory rebuild 后
-* 自行更换 SESSION。
-*
-* 存储形态（v1.30.6 起，S142 review F-01）：绑定**不再写入 dsh 会话日志**。
-* 原因（宿主契约实证）：dsp 的自定义事件 `serenity/bound` 既不在宿主的
-* `KNOWN_SESSION_EVENT_TYPES`（生成静态集，明确说明 out-of-repo 插件事件不在其中），
-* 而 `Session.append` 构造事件时只写 `{type,seq,time,data,surfaceOp?,sourceEventSeqs?}`
-* ——**没有写入 envelope `ignorable` 标记的通道**；宿主的 `assertEventsSupported`
-* （session-persistence/coordinator.ts:1248-1252，调用点含恢复/HMR 路径）会拒绝任何
-* "未知且非 ignorable" 的事件 → 含该事件的会话在冷加载时可能抛
-* `SessionFormatUnsupportedError`。v1.29.1~v1.30.5 的设计文档虽写明要带
-* `ignorable: true`（docs/session-binding-hardening-research.md:53），但类型层声明
-* 不等于持久层标记，实际从未落盘。
-*
-* 现形态：每 CCC 一个 JSON 文件 `AGENT_SESSIONS/.bindings.json`（原子写：tmp + rename），
-* 以 dsh 会话 id 为键，latest-wins 覆盖。**向后兼容**：读取时若文件中无该会话记录，
-* 仍回落到扫描会话日志中的旧 `serenity/bound` 事件（老会话的绑定不丢）。
-*
-* 编码无关（U4）：绑定锚 = **完整 AGENT_SESSIONS 目录名**（磁盘唯一存在），
-* sessionId（S###/apaas-xxx/自定义）仅是派生展示字段——绝不假设 S 前缀。
-*/
-/** 旧形态事件类型（v1.29.1~v1.30.5 写入会话日志；v1.30.6 起只读不写——兼容存量绑定） */
-const SESSION_BOUND_EVENT = "serenity/bound";
-/** 绑定文件相对 CCC 根的路径 */
-const BINDINGS_REL_PATH = "AGENT_SESSIONS/.bindings.json";
-const BINDINGS_VERSION = 1;
-function sessionHeader(session) {
-	const header = session?.header;
-	if (!header || typeof header !== "object") return null;
-	return header;
-}
-/** 绑定文件绝对路径（由会话 cwd 上溯 .serenity 定位 CCC 根）；无法定位返回 null */
-function bindingsPathFor(session) {
-	const header = sessionHeader(session);
-	if (typeof header?.cwd !== "string") return null;
-	const root = cccRootForCwd(header.cwd);
-	if (!root) return null;
-	return join(root, BINDINGS_REL_PATH);
-}
-function readBindingsFile(path) {
-	if (!existsSync(path)) return {
-		version: BINDINGS_VERSION,
-		sessions: {}
-	};
-	try {
-		const sessions = JSON.parse(readFileSync(path, "utf-8")).sessions;
-		if (!sessions || typeof sessions !== "object") return {
-			version: BINDINGS_VERSION,
-			sessions: {}
-		};
-		return {
-			version: BINDINGS_VERSION,
-			sessions
-		};
-	} catch {
-		return {
-			version: BINDINGS_VERSION,
-			sessions: {}
-		};
-	}
-}
-/** 原子写：同目录 tmp + rename（避免半写文件被后续读取） */
-function writeBindingsFile(path, data) {
-	mkdirSync(dirname(path), { recursive: true });
-	const tmp = `${path}.tmp`;
-	writeFileSync(tmp, `${JSON.stringify(data, null, 2)}\n`, "utf-8");
-	renameSync(tmp, path);
-}
-/** 记录形状校验（容忍手改/旧数据） */
-function asBoundRecord(value) {
-	const r = value;
-	if (!r || typeof r.dirName !== "string" || typeof r.mdPath !== "string") return null;
-	return r;
-}
-/** 旧形态：从会话日志扫最后一条 `serenity/bound`（兼容 v1.30.5 及更早写入的绑定） */
-function readLegacyBoundFromEvents(session) {
-	const events = sessionEvents(session);
-	for (let i = events.length - 1; i >= 0; i--) {
-		const ev = events[i];
-		if (!ev || ev.type !== SESSION_BOUND_EVENT) continue;
-		const rec = asBoundRecord(ev.data);
-		if (rec) return rec;
-	}
-	return null;
-}
-/**
-* 读取会话当前绑定（权威，latest-wins）：文件记录优先，无则回落旧事件形态。
-* 无绑定返回 null。
-*/
-function readLastBound(session) {
-	const path = bindingsPathFor(session);
-	const id = sessionHeader(session)?.id;
-	if (path && typeof id === "string") {
-		const rec = asBoundRecord(readBindingsFile(path).sessions[id]);
-		if (rec) return rec;
-	}
-	return readLegacyBoundFromEvents(session);
-}
-/** 目录名 → 轨迹标签（`--S###--` 命中取 `S###`；未命中原样返回——编码无关 U4） */
-function trajectoryLabel(dirName) {
-	const m = dirName.match(/--S(\d{3,})--/);
-	return m ? `S${m[1]}` : dirName;
-}
-/**
-* **调用方自身**所属 trajectory 的标签（审计字段 `createdBy` 的唯一正解）。
-*
-* 三级来源，逐级回退（R↓：为什么不用单一来源）：
-*  1. `readLastBound(session)` —— **持久 bound**，权威（重启存活、不受别的会话激活污染）
-*  2. `getActiveSessionInfo(scope)` —— 本 dsh 会话的**内存**激活（按 scope 隔离）
-*  3. `getLastActiveSessionInfo()` —— **全局**最近激活指针（无绑定的会话兼容回退）
-*
-* ⚠️ 为何单列成本函数（S142 §30.12.1 实测缺陷）：唤醒注册表的 `createdBy` 原先直接取第 3 级
-* 全局指针，而它记录的是"**进程内最近一次被激活的 trajectory**"——多会话并发时必然张冠李戴
-* （实测：S142 登记唤醒被写成 `by=S060`）。`createdBy` 是 D60「以可审计替代入口栅」的**唯一凭证**，
-* 失真即替代控制失效 ⇒ 必须以"调用方自己是谁"为准，全局指针只作最后兜底。
-*
-* @param session 调用方 dsh 会话对象（需 `header.id` + `header.cwd`）
-* @param scope 调用方 dsh 会话 id（取不到传空串）
-* @returns 轨迹标签（`S###` 或完整目录名）；三级全落空 → 空串（渲染为 `?`）
-*/
-function resolveSessionTrajectoryLabel(session, scope) {
-	const bound = session ? readLastBound(session) : null;
-	if (bound?.dirName) return trajectoryLabel(bound.dirName);
-	const scoped = scope !== "" ? getActiveSessionInfo(scope) : null;
-	if (scoped) return scoped.sessionId;
-	return getLastActiveSessionInfo()?.sessionId ?? "";
-}
-/**
-* 反向查：绑定到某 trajectory 目录名的 dsh 会话 id（**按绑定时间倒序，最新在前**）。
-*
-* 用途（wake-scheduler 冷唤醒）：.bindings.json 以 **sessionId 为键**，而唤醒条目的
-* target 是**目录名**——需要值侧扫描做反向索引。冷会话被唤醒时必须先知道"哪个 dsh
-* 会话承载这条轨迹"，这是唯一的权威来源（标题只作回退，见 v1.29.2 R2）。
-*
-* @param root CCC 根
-* @param dirName AGENT_SESSIONS 目录名（完整名，如 `2026-09-01--S151--x--auto`）
-* @returns 会话 id 列表（最新绑定在前）；无绑定 → `[]`
-*/
-function listBoundSessionIds(root, dirName) {
-	const file = readBindingsFile(join(root, BINDINGS_REL_PATH));
-	const hits = [];
-	for (const [id, raw] of Object.entries(file.sessions)) {
-		const rec = asBoundRecord(raw);
-		if (!rec || rec.dirName !== dirName) continue;
-		hits.push({
-			id,
-			at: typeof rec.at === "number" ? rec.at : 0
-		});
-	}
-	return hits.sort((a, b) => b.at - a.at).map((h) => h.id);
-}
-/**
-* 写入绑定（latest-wins 覆盖该会话记录）。
-*
-* 绑定持久化尽力而为：无法定位 CCC 根 / 无会话 id / 写盘失败 → 返回 false，不阻断主流程。
-* @param session 目标 dsh 会话（需 `header.id` + `header.cwd` 可定位 CCC 根）
-* @param action 绑定动作
-* @param rec 绑定记录（dirName + mdPath 必填；sessionId 可选展示码）
-*/
-function appendBound(session, action, rec) {
-	const path = bindingsPathFor(session);
-	const id = sessionHeader(session)?.id;
-	if (!path || typeof id !== "string") return false;
-	try {
-		const file = readBindingsFile(path);
-		file.sessions[id] = {
-			dirName: rec.dirName,
-			mdPath: rec.mdPath,
-			...rec.sessionId ? { sessionId: rec.sessionId } : {},
-			action,
-			at: Date.now(),
-			...rec.note ? { note: rec.note } : {}
-		};
-		writeBindingsFile(path, file);
-		return true;
-	} catch {
-		return false;
-	}
-}
-//#endregion
-export { resolveSessionTrajectoryLabel as i, listBoundSessionIds as n, readLastBound as r, appendBound as t };