@tbox.cn/tboxcode-dsh-bundle 0.0.0-stage → 0.1.0-rc.1

package/lib/remote-DjawPq5z.js

@@ -0,0 +1,353 @@
+import { n as isOwnedHome, r as startRetentionScheduler } from "./retention-DNEdnIxC.js";
+import { t as createLogger } from "./logger-BGwLHZXY.js";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { RemoteError, TypertRemoteService, remoteMethods } from "@deepseek-ai/dsh-typert-protocol";
+import { setSandboxMode } from "@deepseek-ai/dsh-sandbox-policy";
+import { translateMode } from "@tbox.cn/dsh-acp-bridge-core";
+
+//#region src/remote.ts
+function requireAgent(services, agentId) {
+	const agent = services.agents.get(agentId);
+	if (agent === void 0) throw new RemoteError("tboxcode/agent-not-found", `会话 ${agentId} 无在册 agent（冷会话——prompt 路径会先 resume）`, { agentId });
+	return agent;
+}
+function handleCommandsList(services, request) {
+	const agent = requireAgent(services, request.agentId);
+	return services.commands.list(agent);
+}
+async function handleCommandsExecute(services, request, signal) {
+	const agent = requireAgent(services, request.agentId);
+	return services.commands.execute(agent, request.line, [], signal);
+}
+/** mode 通道（载体二）：translateMode（bridge-core 语义映射单源）→ 双 knob 落地。 */
+function handleMode(services, request) {
+	const agent = requireAgent(services, request.agentId);
+	const knobs = translateMode(request.mode);
+	if (knobs === void 0) throw new RemoteError("tboxcode/mode-unknown", `未知权限模式 "${request.mode}"（合法集 = bridge-core 语义映射表）`, { mode: request.mode });
+	const session = services.sessions.get(request.agentId);
+	if (session !== void 0) services.sandbox.setSandboxMode(session, knobs.sandbox);
+	services.approval.setPolicy(agent, knobs.approval);
+	return {
+		sandbox: knobs.sandbox,
+		approval: knobs.approval
+	};
+}
+/** 部署默认行（configOptions model 项 initialValue 面——未配置返回 undefined）。 */
+function handleDefaultSelection(services) {
+	const selection = services.agentDefaultModel.currentSelection();
+	const provider = typeof selection.provider === "string" ? selection.provider : void 0;
+	const model = typeof selection.model === "string" ? selection.model : void 0;
+	if (provider === void 0 || model === void 0) return {};
+	return {
+		provider,
+		model,
+		...typeof selection.reasoningEffort === "string" ? { reasoningEffort: selection.reasoningEffort } : {}
+	};
+}
+async function handleSkillsUserInvocable(services, request) {
+	const agent = requireAgent(services, request.agentId);
+	return (await services.skills.snapshot({ cwd: agent.session.header.cwd })).skills;
+}
+async function handleSessionsFlush(services, request) {
+	const session = services.sessions.get(request.sessionId);
+	if (session === void 0) throw new RemoteError("tboxcode/agent-not-found", `会话 ${request.sessionId} 不在内存（flush 须热会话）`, { sessionId: request.sessionId });
+	await services.sessions.flush(session);
+}
+/** 会话头 stat（resume cwd 匹配面——冷会话返 null 不抛；网关 persistence.stat 对位）。 */
+async function handleSessionsStat(services, request) {
+	const found = await services.persistence.stat(request.sessionId);
+	return found === void 0 ? null : { header: found.header };
+}
+/**
+* skills/change 转发流（P5-3 定案：skills/change 不在 $events allowlist——
+* 零上游变更的进程内桥接；payload-free seq 递增，消费方重取 commands.list）。
+*/
+async function* handleSkillsWatch(services, signal) {
+	let pending = 0;
+	let wake;
+	let seq = 0;
+	const stop = services.on("skills/change", () => {
+		pending++;
+		wake?.();
+	});
+	const abort = () => {
+		wake?.();
+	};
+	signal.addEventListener("abort", abort, { once: true });
+	try {
+		while (!signal.aborted) {
+			if (pending > 0) {
+				pending--;
+				yield { seq: ++seq };
+				continue;
+			}
+			await new Promise((resolve) => {
+				wake = resolve;
+			});
+		}
+	} finally {
+		stop();
+		signal.removeEventListener("abort", abort);
+	}
+}
+/**
+* agent/inbox/claimed + agent/error 转发流（P5-3 定案：journal turn/start 仅
+* {turn} 无 messageId——prompt 完成相关性与失败分支必须走进程事件；两类聚合
+* 单流，sessionId 经 agent 句柄防御性提取）。
+*/
+async function* handleAgentWatch(services, signal) {
+	const queue = [];
+	let wake;
+	const push = (item) => {
+		queue.push(item);
+		wake?.();
+	};
+	const stopClaimed = services.on("agent/inbox/claimed", (payload) => {
+		const { agent, message, turn } = payload ?? {};
+		const sessionId = typeof agent?.session?.id === "string" ? agent.session.id : typeof agent?.id === "string" ? agent.id : "";
+		if (sessionId === "") return;
+		push({
+			kind: "inboxClaimed",
+			sessionId,
+			...typeof message?.id === "string" ? { messageId: message.id } : {},
+			turn: typeof turn === "number" ? turn : 0
+		});
+	});
+	const stopError = services.on("agent/error", (payload) => {
+		const { agent, error } = payload ?? {};
+		const sessionId = typeof agent?.session?.id === "string" ? agent.session.id : typeof agent?.id === "string" ? agent.id : "";
+		if (sessionId === "") return;
+		push({
+			kind: "error",
+			sessionId,
+			error: error instanceof Error ? error.message : String(error)
+		});
+	});
+	const abort = () => {
+		wake?.();
+	};
+	signal.addEventListener("abort", abort, { once: true });
+	try {
+		while (!signal.aborted) {
+			const item = queue.shift();
+			if (item !== void 0) {
+				yield item;
+				continue;
+			}
+			await new Promise((resolve) => {
+				wake = resolve;
+			});
+		}
+	} finally {
+		stopClaimed();
+		stopError();
+		signal.removeEventListener("abort", abort);
+	}
+}
+/** 热载触发（convergence reloadNow 包装——忙时 RETRY_AFTER_TURN 拒绝语义透传）。 */
+async function handleReload(services) {
+	if (services.convergence === void 0) throw new RemoteError("tboxcode/reload-unavailable", "收敛环未挂载（reload 通道仅 config 热载形态可用）", {});
+	await services.convergence.reloadNow();
+}
+/** health（内存观测指标源——doctor --server 画像；会话/冷热分布经 api session/list 面）。 */
+function handleHealth(services) {
+	const memory = (services.memoryUsage ?? (() => process.memoryUsage()))();
+	return {
+		memory: {
+			rss: memory.rss,
+			heapUsed: memory.heapUsed,
+			heapTotal: memory.heapTotal,
+			external: memory.external
+		},
+		uptimeMs: (services.uptime ?? (() => process.uptime() * 1e3))(),
+		...services.retention?.lastResult() === void 0 ? {} : { retentionLast: services.retention?.lastResult() }
+	};
+}
+/** retention.run（手动触发——调度面之外的运维通道）。 */
+async function handleRetentionRun(services) {
+	if (services.retention === void 0) throw new RemoteError("tboxcode/retention-unavailable", "retention 调度未装载", {});
+	return services.retention.runOnce();
+}
+/**
+* 实施发现（切片 4）：本仓 oxc 工具链（vitest vite:oxc / tsdown rolldown）不降级
+* stage-3 decorator——`@Remote` 语法在构建产物原样泄漏（node 运行时 SyntaxError）。
+* 壳改用协议标记描述符直写：REMOTE_METHOD_DESCRIPTOR（'@deepseek-ai/dsh-typert-protocol/
+* remote-methods'，version:1 冻结格式——remoteMethods 的读取面）+ boot 自检
+* （remoteMethods 回读校验方法数与 exportName 集——格式漂移即 boot 红，e2e 兜底）。
+* 方法参数名由 Gateway SRC 从构建产物源码读取（纯方法声明，无语法依赖）。
+*/
+const REMOTE_METHOD_DESCRIPTOR = "@deepseek-ai/dsh-typert-protocol/remote-methods";
+function resolveSessionsRoot(ctx) {
+	const root = (ctx.get?.("sessionPersistence"))?.config?.root;
+	if (typeof root === "string" && root !== "") return root;
+	return join(process.env["DSH_HOME"] ?? join(homedir(), ".dsh"), "sessions");
+}
+const name = "tboxcode-remote";
+const inject = [
+	"agents",
+	"commands",
+	"skills",
+	"approval",
+	"agentDefaultModel",
+	"sessions",
+	"sessionPersistence",
+	"tboxcodeConvergence"
+];
+function stateOf(self) {
+	const carrier = self;
+	if (carrier._remoteState !== void 0) return carrier._remoteState;
+	const state = {
+		log: void 0,
+		retention: void 0,
+		services: void 0
+	};
+	carrier._remoteState = state;
+	return state;
+}
+/** 宿主服务行（结构行——四链恒挂；sandbox 写函数经 ctx 进程内直调）。 */
+var TboxcodeRemoteGateway = class extends TypertRemoteService {
+	static inject = inject;
+	constructor(ctx) {
+		super(ctx, "tboxcode");
+		const remoteCtx = ctx;
+		stateOf(this).log = createLogger({ domain: "tboxcode.remote" });
+		const sessionsRoot = resolveSessionsRoot(remoteCtx);
+		if (sessionsRoot !== void 0) stateOf(this).retention = startRetentionScheduler({
+			sessionsRoot,
+			knobs: isOwnedHome() ? void 0 : {
+				sessionsMaxAgeDays: 0,
+				sessionsMaxBytes: 0,
+				sessionsActiveSkipMs: 24 * 36e5,
+				llmCallsRetentionDays: 14
+			},
+			log: (message, data) => stateOf(this).log.info(message, data)
+		});
+		stateOf(this).services = {
+			agents: remoteCtx.agents,
+			commands: remoteCtx.commands,
+			skills: remoteCtx.skills,
+			approval: remoteCtx.approval,
+			agentDefaultModel: remoteCtx.agentDefaultModel,
+			sessions: remoteCtx.sessions,
+			persistence: remoteCtx.sessionPersistence ?? { stat: async () => void 0 },
+			on: (event, listener) => remoteCtx.on(event, listener),
+			sandbox: { setSandboxMode: (session, mode) => setSandboxMode(session, mode) },
+			convergence: remoteCtx.tboxcodeConvergence,
+			retention: stateOf(this).retention,
+			memoryUsage: () => process.memoryUsage(),
+			uptime: () => process.uptime() * 1e3
+		};
+	}
+	commandsList(request) {
+		return handleCommandsList(stateOf(this).services, request);
+	}
+	commandsExecute(request, signal) {
+		return handleCommandsExecute(stateOf(this).services, request, signal);
+	}
+	mode(request) {
+		const outcome = handleMode(stateOf(this).services, request);
+		stateOf(this).log.info("mode 切换", {
+			agentId: request.agentId,
+			mode: request.mode
+		});
+		return outcome;
+	}
+	defaultSelection() {
+		return handleDefaultSelection(stateOf(this).services);
+	}
+	skillsUserInvocable(request) {
+		return handleSkillsUserInvocable(stateOf(this).services, request);
+	}
+	sessionsFlush(request) {
+		return handleSessionsFlush(stateOf(this).services, request);
+	}
+	sessionsStat(request) {
+		return handleSessionsStat(stateOf(this).services, request);
+	}
+	skillsWatch(signal) {
+		return handleSkillsWatch(stateOf(this).services, signal);
+	}
+	agentWatch(signal) {
+		return handleAgentWatch(stateOf(this).services, signal);
+	}
+	reload() {
+		return handleReload(stateOf(this).services);
+	}
+	health() {
+		return handleHealth(stateOf(this).services);
+	}
+	retentionRun() {
+		return handleRetentionRun(stateOf(this).services);
+	}
+};
+const REMOTE_METHODS = [
+	{
+		method: "commandsList",
+		exportName: "commands.list"
+	},
+	{
+		method: "commandsExecute",
+		exportName: "commands.execute"
+	},
+	{
+		method: "mode",
+		exportName: "mode"
+	},
+	{
+		method: "defaultSelection",
+		exportName: "selection.default"
+	},
+	{
+		method: "skillsUserInvocable",
+		exportName: "skills.userInvocable"
+	},
+	{
+		method: "skillsWatch",
+		exportName: "skills.watch",
+		mode: "stream"
+	},
+	{
+		method: "agentWatch",
+		exportName: "agent.watch",
+		mode: "stream"
+	},
+	{
+		method: "sessionsFlush",
+		exportName: "sessions.flush"
+	},
+	{
+		method: "sessionsStat",
+		exportName: "sessions.stat"
+	},
+	{
+		method: "reload",
+		exportName: "reload"
+	},
+	{
+		method: "health",
+		exportName: "health"
+	},
+	{
+		method: "retentionRun",
+		exportName: "retention.run"
+	}
+];
+Object.defineProperty(TboxcodeRemoteGateway.prototype, REMOTE_METHOD_DESCRIPTOR, {
+	configurable: true,
+	value: Object.freeze({
+		version: 1,
+		methods: Object.freeze(REMOTE_METHODS.map(({ method, exportName, mode }) => Object.freeze({
+			method,
+			...exportName === method ? {} : { exportName },
+			...mode === void 0 ? {} : { mode },
+			invocation: Object.freeze({ kind: "direct" })
+		})))
+	})
+});
+const markers = remoteMethods(Object.create(TboxcodeRemoteGateway.prototype));
+if (markers.length !== REMOTE_METHODS.length || REMOTE_METHODS.some(({ exportName }) => !markers.some((marker) => (marker.exportName ?? marker.method) === exportName))) throw new Error("tboxcode-remote: 协议标记描述符自检失败（remoteMethods 回读与声明集失配——上游格式漂移）");
+var remote_default = TboxcodeRemoteGateway;
+
+//#endregion
+export { handleDefaultSelection as a, handleReload as c, handleSessionsStat as d, handleSkillsUserInvocable as f, remote_default as g, name as h, handleCommandsList as i, handleRetentionRun as l, inject as m, handleAgentWatch as n, handleHealth as o, handleSkillsWatch as p, handleCommandsExecute as r, handleMode as s, TboxcodeRemoteGateway as t, handleSessionsFlush as u };

package/lib/remote.d.ts

@@ -0,0 +1,4 @@
+import "./convergence-core-C1ZtU17g.js";
+import "./retention-B2V8Plpx.js";
+import { _ as handleSkillsWatch, a as TboxcodeRemoteServices, c as handleCommandsList, d as handleMode, f as handleReload, g as handleSkillsUserInvocable, h as handleSessionsStat, i as TboxcodeRemoteGateway, l as handleDefaultSelection, m as handleSessionsFlush, n as DefaultModelSelection, o as handleAgentWatch, p as handleRetentionRun, r as RemoteAgentLike, s as handleCommandsExecute, t as AgentWatchItem, u as handleHealth, v as inject, y as name } from "./remote-Ci33eojc.js";
+export { AgentWatchItem, DefaultModelSelection, RemoteAgentLike, TboxcodeRemoteGateway, TboxcodeRemoteGateway as default, TboxcodeRemoteServices, handleAgentWatch, handleCommandsExecute, handleCommandsList, handleDefaultSelection, handleHealth, handleMode, handleReload, handleRetentionRun, handleSessionsFlush, handleSessionsStat, handleSkillsUserInvocable, handleSkillsWatch, inject, name };

package/lib/remote.js

@@ -0,0 +1,5 @@
+import "./retention-DNEdnIxC.js";
+import "./logger-BGwLHZXY.js";
+import { a as handleDefaultSelection, c as handleReload, d as handleSessionsStat, f as handleSkillsUserInvocable, g as remote_default, h as name, i as handleCommandsList, l as handleRetentionRun, m as inject, n as handleAgentWatch, o as handleHealth, p as handleSkillsWatch, r as handleCommandsExecute, s as handleMode, t as TboxcodeRemoteGateway, u as handleSessionsFlush } from "./remote-DjawPq5z.js";
+
+export { TboxcodeRemoteGateway, remote_default as default, handleAgentWatch, handleCommandsExecute, handleCommandsList, handleDefaultSelection, handleHealth, handleMode, handleReload, handleRetentionRun, handleSessionsFlush, handleSessionsStat, handleSkillsUserInvocable, handleSkillsWatch, inject, name };

package/lib/retention-B2V8Plpx.d.ts

@@ -0,0 +1,58 @@
+//#region src/retention.d.ts
+interface RetentionKnobs {
+  /** sessions 钮：双阈值（天数 / 字节）；0 = 关闭。 */
+  sessionsMaxAgeDays: number;
+  sessionsMaxBytes: number;
+  /** 活跃豁免窗口（mtime 近于此值的会话目录不删——保守代理）。 */
+  sessionsActiveSkipMs: number;
+  /** llm_calls 钮：天数；0 = 关闭。 */
+  llmCallsRetentionDays: number;
+}
+declare const DEFAULT_KNOBS: RetentionKnobs;
+interface SweepResult {
+  /** 各钮清扫量（删除目录数 / 文件数）与跳过量（可观测面——doctor 画像源）。 */
+  sessionsDeleted: number;
+  sessionsSkippedActive: number;
+  llmCallsDeleted: number;
+  errors: string[];
+}
+/** 独立 home 判据：TBOXCODE_DSH_HOME 显式指向（本仓 env 域——领地隔离语义）。 */
+declare function isOwnedHome(env?: NodeJS.ProcessEnv): boolean;
+interface SessionsSweepFs {
+  readdir(dir: string): Promise<Array<{
+    name: string;
+    isDirectory(): boolean;
+  }>>;
+  stat(path: string): Promise<{
+    mtimeMs: number;
+    size: number;
+    isDirectory(): boolean;
+  }>;
+  rm(path: string, options: {
+    recursive: true;
+    force?: boolean;
+  }): Promise<void>;
+}
+/**
+ * sessions 钮清扫（双阈值 LRU）：逐会话目录计龄 + 求全量体量；超龄全删（活跃
+ * 豁免除外），未超龄但总量超 5GiB 时按最老先删至阈值内。两轮合一直接实现。
+ */
+declare function sweepSessions(sessionsRoot: string, knobs: RetentionKnobs, fs: SessionsSweepFs, now?: number): Promise<SweepResult>;
+/** llm_calls 钮清扫（复用 llm 包双路径实现——会话私有 + orphan 兜底）。 */
+declare function sweepLlmCalls(sessionsRoot: string, knobs: RetentionKnobs, cleanup: (sessionRoot: string, retentionDays: number, maxFiles?: number) => Promise<number>): Promise<SweepResult>;
+/** 调度句柄（启动即扫 + 24h 周期；dispose 停表；末次结果观测面）。 */
+interface RetentionScheduler {
+  runOnce(): Promise<SweepResult>;
+  lastResult(): SweepResult | undefined;
+  dispose(): void;
+}
+declare function startRetentionScheduler(options: {
+  sessionsRoot: string;
+  knobs?: RetentionKnobs;
+  intervalMs?: number;
+  fs?: SessionsSweepFs;
+  cleanupLlm?: (sessionRoot: string, retentionDays: number, maxFiles?: number) => Promise<number>;
+  log?: (message: string, data?: Record<string, unknown>) => void;
+}): RetentionScheduler;
+//#endregion
+export { SweepResult as a, sweepLlmCalls as c, SessionsSweepFs as i, sweepSessions as l, RetentionKnobs as n, isOwnedHome as o, RetentionScheduler as r, startRetentionScheduler as s, DEFAULT_KNOBS as t };

package/lib/retention-DNEdnIxC.js

@@ -0,0 +1,162 @@
+import { join } from "node:path";
+import { readdir, rm, stat } from "node:fs/promises";
+
+//#region src/retention.ts
+const DEFAULT_KNOBS = {
+	sessionsMaxAgeDays: 180,
+	sessionsMaxBytes: 5 * 1024 * 1024 * 1024,
+	sessionsActiveSkipMs: 24 * 36e5,
+	llmCallsRetentionDays: 14
+};
+/** 独立 home 判据：TBOXCODE_DSH_HOME 显式指向（本仓 env 域——领地隔离语义）。 */
+function isOwnedHome(env = process.env) {
+	return env["TBOXCODE_DSH_HOME"] !== void 0;
+}
+/**
+* sessions 钮清扫（双阈值 LRU）：逐会话目录计龄 + 求全量体量；超龄全删（活跃
+* 豁免除外），未超龄但总量超 5GiB 时按最老先删至阈值内。两轮合一直接实现。
+*/
+async function sweepSessions(sessionsRoot, knobs, fs, now = Date.now()) {
+	const result = {
+		sessionsDeleted: 0,
+		sessionsSkippedActive: 0,
+		llmCallsDeleted: 0,
+		errors: []
+	};
+	if (knobs.sessionsMaxAgeDays <= 0 && knobs.sessionsMaxBytes <= 0) return result;
+	const cutoff = now - knobs.sessionsMaxAgeDays * 864e5;
+	const activeCutoff = now - knobs.sessionsActiveSkipMs;
+	const entries = [];
+	const projectDirs = await safeReaddir(fs, sessionsRoot, result.errors);
+	for (const project of projectDirs) {
+		if (!project.isDirectory()) continue;
+		const sessionDirs = await safeReaddir(fs, join(sessionsRoot, project.name), result.errors);
+		for (const session of sessionDirs) {
+			if (!session.isDirectory()) continue;
+			const path = join(sessionsRoot, project.name, session.name);
+			try {
+				const info = await fs.stat(path);
+				const size = info.isDirectory() ? await directorySize(fs, path, result.errors) : info.size;
+				entries.push({
+					path,
+					mtimeMs: info.mtimeMs,
+					size,
+					active: info.mtimeMs >= activeCutoff
+				});
+			} catch (error) {
+				result.errors.push(`stat ${path}: ${error instanceof Error ? error.message : String(error)}`);
+			}
+		}
+	}
+	const overAge = entries.filter((entry) => knobs.sessionsMaxAgeDays > 0 && entry.mtimeMs < cutoff);
+	for (const entry of overAge) {
+		if (entry.active) {
+			result.sessionsSkippedActive += 1;
+			continue;
+		}
+		try {
+			await fs.rm(entry.path, {
+				recursive: true,
+				force: true
+			});
+			result.sessionsDeleted += 1;
+			entry.size = 0;
+		} catch (error) {
+			result.errors.push(`rm ${entry.path}: ${error instanceof Error ? error.message : String(error)}`);
+		}
+	}
+	if (knobs.sessionsMaxBytes > 0) {
+		const survivors = entries.filter((entry) => entry.size > 0).sort((a, b) => a.mtimeMs - b.mtimeMs);
+		let total = survivors.reduce((sum, entry) => sum + entry.size, 0);
+		for (const entry of survivors) {
+			if (total <= knobs.sessionsMaxBytes) break;
+			if (entry.active) {
+				result.sessionsSkippedActive += 1;
+				continue;
+			}
+			try {
+				await fs.rm(entry.path, {
+					recursive: true,
+					force: true
+				});
+				total -= entry.size;
+				result.sessionsDeleted += 1;
+			} catch (error) {
+				result.errors.push(`rm ${entry.path}: ${error instanceof Error ? error.message : String(error)}`);
+			}
+		}
+	}
+	return result;
+}
+async function directorySize(fs, dir, errors) {
+	let total = 0;
+	const children = await safeReaddir(fs, dir, errors);
+	for (const child of children) {
+		const path = join(dir, child.name);
+		try {
+			if (child.isDirectory()) total += await directorySize(fs, path, errors);
+			else total += (await fs.stat(path)).size;
+		} catch (error) {
+			errors.push(`stat ${path}: ${error instanceof Error ? error.message : String(error)}`);
+		}
+	}
+	return total;
+}
+async function safeReaddir(fs, dir, errors) {
+	try {
+		return await fs.readdir(dir);
+	} catch (error) {
+		if (error.code !== "ENOENT") errors.push(`readdir ${dir}: ${error instanceof Error ? error.message : String(error)}`);
+		return [];
+	}
+}
+/** llm_calls 钮清扫（复用 llm 包双路径实现——会话私有 + orphan 兜底）。 */
+async function sweepLlmCalls(sessionsRoot, knobs, cleanup) {
+	return {
+		sessionsDeleted: 0,
+		sessionsSkippedActive: 0,
+		llmCallsDeleted: knobs.llmCallsRetentionDays > 0 ? await cleanup(sessionsRoot, knobs.llmCallsRetentionDays) : 0,
+		errors: []
+	};
+}
+function startRetentionScheduler(options) {
+	const knobs = options.knobs ?? DEFAULT_KNOBS;
+	const intervalMs = options.intervalMs ?? 24 * 36e5;
+	const fs = options.fs ?? {
+		readdir: async (dir) => readdir(dir, { withFileTypes: true }),
+		stat: async (path) => stat(path),
+		rm: async (path, opts) => rm(path, opts)
+	};
+	const cleanup = options.cleanupLlm ?? (async (root, days) => {
+		const { cleanupOldLlmLogs } = await import("@tbox.cn/tboxcode-dsh-llm/call-log");
+		return cleanupOldLlmLogs(root, days);
+	});
+	const log = options.log ?? (() => {});
+	let last;
+	const timer = setInterval(() => {
+		runOnce().catch((error) => log("retention 扫描异常", { error: error instanceof Error ? error.message : String(error) }));
+	}, intervalMs);
+	const runOnce = async () => {
+		const sessions = await sweepSessions(options.sessionsRoot, knobs, fs);
+		const llmCalls = await sweepLlmCalls(options.sessionsRoot, knobs, cleanup);
+		const merged = {
+			sessionsDeleted: sessions.sessionsDeleted,
+			sessionsSkippedActive: sessions.sessionsSkippedActive,
+			llmCallsDeleted: llmCalls.llmCallsDeleted,
+			errors: [...sessions.errors, ...llmCalls.errors]
+		};
+		last = merged;
+		log("retention 扫描完成", { ...merged });
+		return merged;
+	};
+	runOnce().catch((error) => log("retention 扫描异常", { error: error instanceof Error ? error.message : String(error) }));
+	timer.unref?.();
+	return {
+		runOnce,
+		lastResult: () => last,
+		dispose: () => clearInterval(timer)
+	};
+}
+
+//#endregion
+export { sweepSessions as a, sweepLlmCalls as i, isOwnedHome as n, startRetentionScheduler as r, DEFAULT_KNOBS as t };

package/lib/retention.d.ts

@@ -0,0 +1,2 @@
+import { a as SweepResult, c as sweepLlmCalls, i as SessionsSweepFs, l as sweepSessions, n as RetentionKnobs, o as isOwnedHome, r as RetentionScheduler, s as startRetentionScheduler, t as DEFAULT_KNOBS } from "./retention-B2V8Plpx.js";
+export { DEFAULT_KNOBS, RetentionKnobs, RetentionScheduler, SessionsSweepFs, SweepResult, isOwnedHome, startRetentionScheduler, sweepLlmCalls, sweepSessions };

package/lib/retention.js

@@ -0,0 +1,3 @@
+import { a as sweepSessions, i as sweepLlmCalls, n as isOwnedHome, r as startRetentionScheduler, t as DEFAULT_KNOBS } from "./retention-DNEdnIxC.js";
+
+export { DEFAULT_KNOBS, isOwnedHome, startRetentionScheduler, sweepLlmCalls, sweepSessions };

package/package.json

@@ -1,6 +1,71 @@
 {
   "name": "@tbox.cn/tboxcode-dsh-bundle",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0-rc.1",
+  "type": "module",
+  "description": "tboxcode 组合点（host 服务行 + agent 平面 host 行 + profile 模板三件）：patch + prompts / reminders 插件 + tboxcode Remote 服务",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./prompts": {
+      "types": "./lib/prompts.d.ts",
+      "default": "./lib/prompts.js"
+    },
+    "./convergence": {
+      "types": "./lib/convergence.d.ts",
+      "default": "./lib/convergence.js"
+    },
+    "./convergence-core": {
+      "types": "./lib/convergence-core.d.ts",
+      "default": "./lib/convergence-core.js"
+    },
+    "./remote": {
+      "types": "./lib/remote.d.ts",
+      "default": "./lib/remote.js"
+    },
+    "./retention": {
+      "types": "./lib/retention.d.ts",
+      "default": "./lib/retention.js"
+    },
+    "./logger": {
+      "types": "./lib/logger.d.ts",
+      "default": "./lib/logger.js"
+    }
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "zod": "4.6.7",
+    "@tbox.cn/dsh-acp-bridge-core": "0.1.0-rc.1",
+    "@tbox.cn/tboxcode-dsh-tools": "0.1.0-rc.1",
+    "@tbox.cn/tboxcode-dsh-runtime": "0.1.0-rc.1",
+    "@tbox.cn/tboxcode-dsh-llm": "0.1.0-rc.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "4.0.5",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-sandbox-policy": "0.2.1-rc.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.5",
+    "yaml": "^2.8.0",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-sandbox-policy": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-commands": "0.2.1-rc.2"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.