@morlay/dsh-context-assembler 0.0.1 → 0.0.3

package/dist/agent-instructions-CIgUVIeo.mjs

@@ -1,237 +0,0 @@
-import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
-import z from "@deepseek-ai/schemastery";
-import { createHash } from "node:crypto";
-import { dirname, join, relative, resolve } from "node:path";
-import { readFile, stat } from "node:fs/promises";
-import { homedir } from "node:os";
-import { Config } from "@deepseek-ai/dsh-agent-instructions";
-//#region src/agent-instructions/files.ts
-/** 从 cwd 逐级向上找项目根（含标记目录的那一级）。 */
-async function projectRoot(cwd, marker = ".git") {
-	let current = resolve(cwd);
-	for (;;) {
-		if (await stat(join(current, marker)).then(() => true, () => false)) return current;
-		const parent = dirname(current);
-		if (parent === current) return void 0;
-		current = parent;
-	}
-}
-function abbreviateHome(path) {
-	const home = homedir();
-	return path.startsWith(`${home}/`) ? `~${path.slice(home.length)}` : path;
-}
-/**
-* 工作区指令链：用户全局 `$DSH_HOME/AGENTS.md`，再从项目根到 cwd 的每一级目录取
-* 基础文件与本地 overlay。顺序由宽泛到具体——具体的在后面，与"更具体的优先"一致。
-*/
-async function instructionChain(cwd, options) {
-	const files = [];
-	const global = join(options.dshHome, "AGENTS.md");
-	if (await isFile(global)) files.push({
-		root: options.dshHome,
-		display: abbreviateHome(global),
-		path: global
-	});
-	const root = await projectRoot(cwd) ?? resolve(cwd);
-	const levels = [];
-	let current = resolve(cwd);
-	for (;;) {
-		levels.unshift(current);
-		if (current === root) break;
-		const parent = dirname(current);
-		if (parent === current) break;
-		current = parent;
-	}
-	for (const level of levels) for (const name of [...options.instructionFileCandidates, ...options.localInstructionFileCandidates]) {
-		const path = join(level, name);
-		if (await isFile(path)) files.push({
-			root,
-			display: relativeDisplay(root, path),
-			path
-		});
-	}
-	return files;
-}
-function relativeDisplay(root, path) {
-	const rel = path.slice(root.length + 1);
-	return rel.length === 0 ? path : rel;
-}
-async function isFile(path) {
-	return (await stat(path).then((value) => value, () => void 0))?.isFile() === true;
-}
-/** 读一个指令文件；按 `mtimeMs:size` 缓存，未变就不重读。 */
-async function readInstruction(file, cache, maxBytes) {
-	const info = await stat(file.path).then((value) => value, () => void 0);
-	if (info?.isFile() !== true) {
-		cache.delete(file.path);
-		return "";
-	}
-	const stamp = `${String(info.mtimeMs)}:${String(info.size)}`;
-	const cached = cache.get(file.path);
-	if (cached?.stamp === stamp) return cached.text;
-	const text = budget(await readFile(file.path, "utf8").catch(() => ""), file.display, maxBytes);
-	cache.set(file.path, {
-		stamp,
-		text
-	});
-	return text;
-}
-/** 单文件超出预算时截断并留一行可见提示（不静默丢内容）。 */
-function budget(text, display, maxBytes) {
-	if (Buffer.byteLength(text, "utf8") <= maxBytes) return text.trimEnd();
-	const kept = Buffer.from(text, "utf8").subarray(0, maxBytes).toString("utf8");
-	const lastBreak = kept.lastIndexOf("\n");
-	return `${(lastBreak > 0 ? kept.slice(0, lastBreak) : kept).trimEnd()}\n\n(Workspace instruction budget ${String(maxBytes)} bytes: ${display} is truncated.)`;
-}
-/** 上游那行的身份基线：与 `packages/bundle/base/cordis.patch.yml` 的 `agent-instructions` 行 config 同源。 */
-const UPSTREAM_BASELINE_CONFIG = { maxBytes: 65536 };
-/** schema 调用会把缺省项补齐，所以这里拿到的是上游 schema 的实际默认值。 */
-function resolveBaselineConfig() {
-	return Config({ ...UPSTREAM_BASELINE_CONFIG });
-}
-/** 上游 `findProjectRoot` 的语义：向上找第一个带标记的目录，找不到就用 cwd。 */
-async function projectRootOf(cwd, markers) {
-	let current = resolve(cwd);
-	for (;;) {
-		for (const marker of markers) if (await exists(join(current, marker))) return current;
-		const parent = dirname(current);
-		if (parent === current) return resolve(cwd);
-		current = parent;
-	}
-}
-async function exists(path) {
-	try {
-		await stat(path);
-		return true;
-	} catch {
-		return false;
-	}
-}
-/** 一个会话的 baseline 身份；cwd 或项目根变了就是另一份身份（上游语义）。 */
-async function baselineIdentity(cwd) {
-	const config = resolveBaselineConfig();
-	const projectRoot = await projectRootOf(cwd, config.projectRootMarkers);
-	return JSON.stringify({
-		projectRoot: relative(cwd, projectRoot),
-		projectRootMarkers: config.projectRootMarkers,
-		maxBytes: config.maxBytes,
-		maxSourceBytes: config.maxSourceBytes,
-		instructionFileCandidates: config.instructionFileCandidates,
-		localInstructionFileCandidates: config.localInstructionFileCandidates
-	});
-}
-//#endregion
-//#region src/agent-instructions/preset-owner.ts
-/** 上游那一行的模块名：与 `presets/*.patch.yml` 里写的一字不差。 */
-const UPSTREAM_MODULE = "@deepseek-ai/dsh-agent-instructions";
-/** 会话 → 它当前的 preset。preset 变了（空白窗口里换 preset）就整份重算。 */
-const decided = /* @__PURE__ */ new WeakMap();
-/**
-* 该会话的 preset 自己提供了工作区指令这一面吗。
-* @param ctx - 能解析到注册表的上下文（能力自己的 apply ctx）。
-* @param agent - 要判的会话。
-* @returns 行清单里有上游那一行且它是启用的。
-*/
-function presetOwnsInstructions(ctx, agent) {
-	const registry = registryOf(ctx);
-	if (registry === void 0) return Promise.resolve(false);
-	const preset = registry.composedPreset(agent.ctx);
-	if (preset === void 0) return Promise.resolve(false);
-	const cached = decided.get(agent);
-	if (cached?.preset === preset) return cached.owns;
-	const owns = registry.compositionInventory().then((inventory) => inventory.some((composition) => composition.id === preset && composition.rows.some((row) => row.moduleName === UPSTREAM_MODULE && row.enabled === true))).catch(() => false);
-	decided.set(agent, {
-		preset,
-		owns
-	});
-	return owns;
-}
-/** 注册表可能压根没装（没有 preset 的部署形态）；`ctx.get` 在不提供时读到 undefined。 */
-function registryOf(ctx) {
-	try {
-		return ctx.get("agentPresets");
-	} catch {
-		return;
-	}
-}
-//#endregion
-//#region src/agent-instructions/index.ts
-var agent_instructions_exports = /* @__PURE__ */ __exportAll({
-	Config: () => Config$1,
-	apply: () => apply,
-	inject: () => inject,
-	name: () => name
-});
-const name = "context-agent-instructions";
-const inject = ["agents", "contextAssembler"];
-const Config$1 = z.object({
-	instructionFileCandidates: z.array(z.string()).default(["AGENTS.md"]),
-	localInstructionFileCandidates: z.array(z.string()).default(["AGENTS.local.md"]),
-	maxBytes: z.number().default(65536),
-	dshHome: z.string().default(process.env["DSH_HOME"] ?? "")
-});
-/** 一个会话的指令链：路径集合与它所属的 cwd。 */
-const chains = /* @__PURE__ */ new WeakMap();
-/**
-* 工作区指令：一条文件一个规则块（id 为 `agent-instructions:<根标识>:<文件>`），文件变化时正文变、按 id 覆盖。
-*
-* 与上游 `agent-instructions` 的差别：不做 read/write/edit 的 touch 跟踪（本部署的 `AGENTS.md`
-* 几乎不变），只在每步按 `mtime:size` 对账；一份文件一条 id，于是变化只重发变了的那一份。
-*/
-function apply(ctx, config) {
-	const options = {
-		instructionFileCandidates: config.instructionFileCandidates ?? ["AGENTS.md"],
-		localInstructionFileCandidates: config.localInstructionFileCandidates ?? ["AGENTS.local.md"],
-		dshHome: config.dshHome === void 0 || config.dshHome === "" ? defaultDshHome() : config.dshHome
-	};
-	const maxBytes = config.maxBytes ?? 65536;
-	const cache = /* @__PURE__ */ new Map();
-	const install = async (agent) => {
-		if (chains.has(agent)) return;
-		const cwd = agent.session.header.cwd === void 0 ? process.cwd() : agent.session.header.cwd;
-		const chain = {
-			cwd,
-			files: await instructionChain(cwd, options)
-		};
-		chains.set(agent, chain);
-		const identity = await baselineIdentity(cwd);
-		for (const file of chain.files) ctx.contextAssembler.registerRule({
-			id: `agent-instructions:${rootTag(file.root)}:${file.display}`,
-			source: () => ({
-				kind: "agent-instructions",
-				form: "instructions",
-				baseline: true,
-				baselineIdentity: identity,
-				changes: []
-			}),
-			text: async (target) => {
-				if (await presetOwnsInstructions(ctx, target)) return "";
-				const current = chains.get(target);
-				if (current === void 0 || !current.files.some((entry) => entry.path === file.path)) return "";
-				return readInstruction(file, cache, maxBytes);
-			}
-		});
-	};
-	ctx.on("agent/created", ({ agent }) => {
-		install(agent).catch((error) => {
-			ctx.logger.warn(`context-agent-instructions: ${String(error)}`);
-		});
-	});
-	for (const agent of ctx.agents.list()) install(agent).catch((error) => {
-		ctx.logger.warn(`context-agent-instructions: ${String(error)}`);
-	});
-}
-function defaultDshHome() {
-	const home = process.env["HOME"] ?? "~";
-	return resolve(process.env["DSH_HOME"] ?? `${home}/.dsh`);
-}
-/**
-* 规则块 id 里的根标识：规则声明是**全局按 id 覆盖**的，而 `display` 只是根内相对路径——
-* 同进程里两个项目根都有 `AGENTS.md` 时，不带根标识的 id 会互相顶掉（后注册者覆盖前者，
-* 前者此后读到空正文）。8 位摘要够唯一，又不把绝对路径塞进提示词 id。
-*/
-function rootTag(root) {
-	return createHash("sha256").update(root).digest("hex").slice(0, 8);
-}
-//#endregion
-export { name as a, inject as i, agent_instructions_exports as n, apply as r, Config$1 as t };

package/dist/agent-instructions.d.mts

@@ -1,27 +0,0 @@
-import z from "@deepseek-ai/schemastery";
-import { Context } from "@deepseek-ai/cordis";
-declare namespace index_d_exports {
-  export { Config, apply, inject, name };
-}
-declare const name = "context-agent-instructions";
-declare const inject: string[];
-interface Config {
-  /** 每级目录的基础指令文件名。 */
-  instructionFileCandidates?: string[];
-  /** 基础文件之后加载的本地 overlay 名。 */
-  localInstructionFileCandidates?: string[];
-  /** 单个指令文件的渲染上限（字节）。 */
-  maxBytes?: number;
-  /** 用户全局指令所在目录（默认 `$DSH_HOME` 或 `~/.dsh`）。 */
-  dshHome?: string;
-}
-declare const Config: z<Config>;
-/**
- * 工作区指令：一条文件一个规则块（id 为 `agent-instructions:<根标识>:<文件>`），文件变化时正文变、按 id 覆盖。
- *
- * 与上游 `agent-instructions` 的差别：不做 read/write/edit 的 touch 跟踪（本部署的 `AGENTS.md`
- * 几乎不变），只在每步按 `mtime:size` 对账；一份文件一条 id，于是变化只重发变了的那一份。
- */
-declare function apply(ctx: Context, config: Config): void;
-//#endregion
-export { Config, apply, inject, name, index_d_exports as t };

package/dist/agent-instructions.mjs

@@ -1,2 +0,0 @@
-import { a as name, i as inject, r as apply, t as Config } from "./agent-instructions-CIgUVIeo.mjs";
-export { Config, apply, inject, name };

package/dist/assembler-CDMIBAi8.mjs

@@ -1,421 +0,0 @@
-import { t as __exportAll } from "./rolldown-runtime-D7D4PA-g.mjs";
-import z from "@deepseek-ai/schemastery";
-import { Service } from "@deepseek-ai/cordis";
-import { createUserMessage } from "@deepseek-ai/dsh-llm";
-import { PERSONA_PREFIX_SECTION, PERSONA_SUFFIX_SECTION } from "@deepseek-ai/dsh-system-prompt";
-//#region src/assembler/reminder.ts
-const REMINDER_OPEN = "<system-reminder";
-const REMINDER_CLOSE = "</system-reminder>";
-/**
-* 覆盖规则在系统提示词里声明一次（见 [`rules.ts`](./rules.ts)），所以每条 reminder 只带 id 与正文，
-* 不再重复解释"最新一条覆盖更早的"。
-*/
-const RULES_SECTION = "assembler:rules";
-/**
-* 这条消息是不是通道注入的条目——判据是 source 里的幂等键，而不是 kind：接管上游那两面的条目
-* 接管工作区指令那一面的条目用上游 kind（`agent-instructions`），幂等必须照样认。
-*/
-function promptEntryIdOf(source) {
-	const id = source.id;
-	return typeof id === "string" ? id : void 0;
-}
-function escapeFrameBody(body) {
-	return body.replaceAll(REMINDER_CLOSE, "<\\/system-reminder>");
-}
-function escapeAttr(value) {
-	return value.replaceAll("&", "&amp;").replaceAll("\"", "&quot;").replaceAll("<", "&lt;");
-}
-function renderReminder(id, body) {
-	return `${REMINDER_OPEN} id="${escapeAttr(id)}">\n${escapeFrameBody(body)}\n${REMINDER_CLOSE}`;
-}
-/**
-* 虚拟 skill（运行时注册、没有资源目录）的正文形态：只有 `<skill_instructions>`，
-* 不渲染上游 `renderSkillContent` 的 `<skill_resources>`（那段对虚拟 skill 是噪音）。
-*/
-function renderVirtualSkill(name, content) {
-	return [
-		`<skill_content name="${escapeAttr(name)}">`,
-		"<skill_instructions>",
-		content,
-		"</skill_instructions>",
-		"</skill_content>"
-	].join("\n");
-}
-/** surface 上最近一条该 id 的 reminder 原文（含信封）；没有则 undefined。 */
-function latestReminderText(agent, id) {
-	for (const seq of agent.session.surface.nodes.toReversed()) {
-		const event = agent.session.eventAt(seq);
-		if (event?.type !== "user/message") continue;
-		if (promptEntryIdOf(event.data.source) !== id) continue;
-		const [block] = event.data.content;
-		return event.data.content.length === 1 && block?.type === "text" ? block.text : "";
-	}
-}
-/**
-* 注入一条提醒：`text` 是已渲染好的完整正文（规则块或内容块），`key` 是它的幂等键。
-* `source` 声明这条消息对外的身份——工作区指令那一面用上游 kind，我们自己的条目留默认。
-*/
-function reminderMessage(key, text, source) {
-	return createUserMessage({
-		content: [{
-			type: "text",
-			text
-		}],
-		source: {
-			...source ?? {
-				kind: "context-assembler",
-				form: "instructions"
-			},
-			id: key
-		}
-	});
-}
-//#endregion
-//#region src/assembler/channel.ts
-/**
-* 注入通道：调用方声明「什么内容、怎么到达模型」，这里负责到达方式。
-*
-* - `on-demand`：注册成模型可用 skill（进 skill 目录，正文按需加载）；
-* - `auto`：正文自动注入 reminder（注册成 skill 但标 `modelInvocable: false`，因为已经常驻）；
-* - `replaceSection` / `suppressSection`：装配结果上的文本改写与丢弃。
-*
-* 覆盖语义（同 id 最新取代更早）由系统提示词里的声明说明一次，见 [`rules.ts`](./rules.ts)。
-*/
-var ContextAssembler = class extends Service {
-	host;
-	declarations = /* @__PURE__ */ new Map();
-	rules = /* @__PURE__ */ new Map();
-	overrides = /* @__PURE__ */ new Map();
-	suppressed = /* @__PURE__ */ new Set();
-	skills = /* @__PURE__ */ new Map();
-	states = /* @__PURE__ */ new WeakMap();
-	/**
-	* 不要 instruction 类注入的会话（模式说了 `instructions: false`）：常驻正文、规则块与降级 section 都不进。
-	* 按需 skill 不受它管（那是模型自己加载），引用材料也不经通道。
-	*/
-	withoutInstructions = /* @__PURE__ */ new WeakSet();
-	/** 本会话的模式收窄（白名单）：投影层的过滤不碰注册表，注册表上看不出"谁能用"。 */
-	toolScopes = /* @__PURE__ */ new WeakMap();
-	/** `host` 是构造期那个根 ctx：`skills` 的访问权限挂在插件的 inject 声明上，不能依赖访问者 ctx。 */
-	constructor(host) {
-		super(host, "contextAssembler");
-		this.host = host;
-	}
-	registerSkill(declaration) {
-		this.declarations.set(declaration.name, declaration);
-		this.refreshSkills();
-		return () => {
-			if (this.declarations.get(declaration.name) !== declaration) return;
-			this.declarations.delete(declaration.name);
-			this.refreshSkills();
-		};
-	}
-	registerRule(declaration) {
-		this.rules.set(declaration.id, declaration);
-		return () => {
-			if (this.rules.get(declaration.id) === declaration) this.rules.delete(declaration.id);
-		};
-	}
-	replaceSection(name, text) {
-		this.overrides.set(name, text);
-		return () => {
-			if (this.overrides.get(name) === text) this.overrides.delete(name);
-		};
-	}
-	suppressSection(name) {
-		this.suppressed.add(name);
-		return () => {
-			this.suppressed.delete(name);
-		};
-	}
-	isSuppressed(name) {
-		return this.suppressed.has(name);
-	}
-	/** 装配结果上该 section 要换成的文本；undefined 表示原样保留。 */
-	replacement(name, agent) {
-		const override = this.overrides.get(name);
-		return override === void 0 || agent === void 0 ? void 0 : override(agent);
-	}
-	/**
-	* 本步要注入的条目：键 → 已渲染好的正文（规则块或内容块）。
-	* `sections` 来自本步装配，`rules` 与 `auto` skill 正文在这里现算。
-	*/
-	/** 这个会话要不要 instruction 类注入（模式说了 `instructions: false` 就是不要，见 {@link withoutInstructions}）。 */
-	setInstructions(agent, on) {
-		if (on) this.withoutInstructions.delete(agent);
-		else this.withoutInstructions.add(agent);
-	}
-	/**
-	* 本会话的**工具收窄**（模式白名单）：投影层只过滤装配结果、不碰工具注册表，所以"谁能用"这件事
-	* 必须在通道上登记，技能目录与组正文才收得住。与 {@link setInstructions} 同形——谓词由模式那一行给
-	* （`context-scope`），通道自己不碰 `tools` 服务。
-	*/
-	restrictTools(agent, allowed) {
-		this.toolScopes.set(agent, allowed);
-	}
-	/**
-	* 本会话的工具可见性：调用方给出的注册表可见性 × 已登记的模式收窄。技能目录与组正文共用它，
-	* 免得同一套判据在几处各写一遍。
-	*/
-	visibleTools(agent, registered) {
-		const allowed = this.toolScopes.get(agent);
-		return allowed === void 0 ? registered : (tool) => registered(tool) && allowed(tool);
-	}
-	/**
-	* 该会话看不到的 skill 名：声明了 `requires` 而依赖的工具一个都不可见。
-	*
-	* 目录由 `context-skill-catalog` 渲染，它把工具可见性作为谓词传进来（通道不碰 tools 服务）。
-	*/
-	hiddenSkills(visible) {
-		const hidden = /* @__PURE__ */ new Set();
-		for (const [name, declaration] of this.declarations) {
-			const requires = declaration.requires;
-			if (requires === void 0 || requires.length === 0) continue;
-			if (!requires.some(visible)) hidden.add(name);
-		}
-		return hidden;
-	}
-	/**
-	* 该 skill 按会话修剪后的正文：注册表只能存一份（技能注册是装配期一次、全局可见），所以按需加载
-	* 路径（接管的 `skill` 工具）要用这里重新算一次，才和 `auto` 正文一样跟着工具走。
-	*/
-	contentFor(name, agent) {
-		return this.declarations.get(name)?.content(agent);
-	}
-	/** 一个 skill 在这个会话能不能被用到：声明了 `requires` 时至少一个工具在模式收窄内。 */
-	reachable(declaration, scope) {
-		const requires = declaration.requires;
-		if (requires === void 0 || requires.length === 0) return true;
-		if (scope === void 0) return true;
-		return requires.some((tool) => scope(tool));
-	}
-	async collect(agent) {
-		const entries = /* @__PURE__ */ new Map();
-		const scope = this.toolScopes.get(agent);
-		const instructionsOff = this.withoutInstructions.has(agent);
-		if (!instructionsOff) for (const declaration of this.declarations.values()) {
-			if ((declaration.injection ?? "on-demand") !== "auto") continue;
-			if (!this.reachable(declaration, scope)) continue;
-			const body = declaration.content(agent);
-			if (body.length > 0) entries.set(declaration.name, { text: renderVirtualSkill(declaration.name, body) });
-		}
-		for (const declaration of this.rules.values()) {
-			if (instructionsOff) break;
-			const text = await withTimeout(declaration.text(agent), CONTENT_TIMEOUT_MS);
-			if (text.length > 0) entries.set(declaration.id, {
-				text: renderReminder(declaration.id, text),
-				...declaration.source === void 0 ? {} : { source: declaration.source(agent) }
-			});
-		}
-		if (!instructionsOff) for (const [id, text] of this.sectionsOf(agent)) entries.set(id, { text: renderReminder(id, text) });
-		return entries;
-	}
-	sectionsOf(agent) {
-		return this.states.get(agent)?.sections ?? /* @__PURE__ */ new Map();
-	}
-	/**
-	* 每步装配调一次：记下本步降级出来的 section 文本，供下一步注入。
-	*/
-	sync(agent, input) {
-		this.stateOf(agent).sections = input.sections;
-	}
-	/** skill 注册（装配期一次，全局可见）：正文没变的不重注册。 */
-	refreshSkills(agent) {
-		for (const [name, declaration] of this.declarations) {
-			const content = declaration.content(agent);
-			const modelInvocable = (declaration.injection ?? "on-demand") === "on-demand";
-			const digest = `${modelInvocable ? "model" : "auto"}\u0000${declaration.description}\u0000${content}`;
-			const current = this.skills.get(name);
-			if (current?.digest === digest) continue;
-			current?.dispose();
-			const dispose = this.host.skills.register({
-				name,
-				description: declaration.description,
-				content,
-				source: "runtime",
-				invocation: {
-					modelInvocable,
-					userInvocable: true
-				}
-			});
-			this.skills.set(name, {
-				digest,
-				dispose
-			});
-		}
-		for (const [name, registered] of this.skills) {
-			if (this.declarations.has(name)) continue;
-			registered.dispose();
-			this.skills.delete(name);
-		}
-	}
-	stateOf(agent) {
-		const existing = this.states.get(agent);
-		if (existing !== void 0) return existing;
-		const state = { sections: /* @__PURE__ */ new Map() };
-		this.states.set(agent, state);
-		return state;
-	}
-};
-/** 一条注入内容的取用上限：超过就按"没有内容"处理，不阻塞这一轮请求。 */
-const CONTENT_TIMEOUT_MS = 2e3;
-async function withTimeout(work, ms) {
-	if (typeof work === "string") return work;
-	const settled = Promise.resolve(work).catch(() => "");
-	let timer;
-	const expiry = new Promise((resolve) => {
-		timer = setTimeout(() => {
-			resolve("");
-		}, ms);
-	});
-	try {
-		return await Promise.race([settled, expiry]);
-	} finally {
-		if (timer !== void 0) clearTimeout(timer);
-	}
-}
-//#endregion
-//#region src/assembler/defaults.ts
-/**
-* 留在系统提示词里的 section：部署级 persona（子 agent 在 agent 作用域注册的同名 persona 也命中）
-* 与覆盖规则声明（[`rules.ts`](./rules.ts)）。
-*/
-const DEFAULT_KEEP = [
-	PERSONA_PREFIX_SECTION,
-	PERSONA_SUFFIX_SECTION,
-	RULES_SECTION
-];
-/**
-* 不进提示词的 section。三类：
-*
-* 1. **harness 自带的开场白与平台运维说明**：`harness:identity`（"You are an AI agent powered by
-*    DeepSeek Harness."——身份由各模式的 persona 给，这句话在本部署里是噪音，且是英文）、
-*    `harness:source`（讲 dev server / HMR / 本地 checkout 位置）；
-* 2. 本部署不装配的工具的用法说明：`tool:lsp` / `tool:pty` / `tool:session-query` / `tool:cordis` /
-*    `tool:ralph`；
-* 3. `app:web-surface`（平台外壳说明）。
-*
-* 其余工具说明由各组的 `drops` 摘掉、要点由 toolkit 的 `guidance` 出口写进组正文，不在这一份里。
-*/
-const DEFAULT_SUPPRESS = [
-	"harness:identity",
-	"harness:source",
-	"app:web-surface",
-	"tool:lsp",
-	"tool:pty",
-	"tool:session-query",
-	"tool:cordis",
-	"tool:ralph"
-];
-/**
-* 改写成中文的两段上游说明（内容忠实原意）：`@` 引用路径的语义、输出里的文件链接规范。
-*
-* 这两段注册在 agent 层（`context:file-reference`）与 host 层（`ui:deliverable-file-references`），
-* 注册层不归我们——所以在装配结果上换文本（不移除：内容要保留）。
-*/
-const DEFAULT_REPLACE = {
-	"context:file-reference": "以 @ 开头的词是用户显式引用的工作区路径，相对于工作区根。结尾带斜杠表示目录：需要时列目录内容。其余是文件：需要内容时用 read 工具读取，不要在读取前声称自己已经看过。用 @\"...\" 括住含空格的路径。",
-	"ui:deliverable-file-references": "成功创建或修改文件后，在最终回复里点明主要产物。除命令、配置表达式与代码块之外，每处提到已存在的文件都要链到它的完整路径（相对工作目录或绝对路径）；已知行号时在目标后加 `#L24` 或 `#L24-L30`。链接文本用文件名或清晰别名，只加够区分的父目录，不要把完整路径放进标签；默认只用文件名，需要精确位置时在标签后接 `:24` 或 `:24–30`（不带 `#` 或 `L`）。"
-};
-//#endregion
-//#region src/assembler/rules.ts
-/**
-* 覆盖规则的声明文本：写进**系统提示词**（不在 reminder 里重复），所以每条 reminder 只带 id 与正文。
-*
-* 为什么放系统提示词而不是首条 reminder：它是固定文本（不随会话变，不付缓存代价），而且放在这里
-* 才是系统级规则该在的位置——首条 reminder 自身会被压缩、被覆盖，权威性更低。
-*/
-const RULES_TEXT = ["带 id 的 system-reminder 块是本系统提示词的一部分，持续有效：同 id 只有最新一条生效并取代更早的，不同 id 互不影响。", "skill_content 是要遵循的技能说明（随提示送来的与你后来加载的一样），file_content 是本步引用的文件内容。"].join("");
-//#endregion
-//#region src/assembler/index.ts
-var assembler_exports = /* @__PURE__ */ __exportAll({
-	Config: () => Config,
-	ContextAssembler: () => ContextAssembler,
-	DEFAULT_KEEP: () => DEFAULT_KEEP,
-	DEFAULT_REPLACE: () => DEFAULT_REPLACE,
-	DEFAULT_SUPPRESS: () => DEFAULT_SUPPRESS,
-	apply: () => apply,
-	inject: () => inject,
-	name: () => name,
-	renderVirtualSkill: () => renderVirtualSkill
-});
-const name = "context-assembler";
-/** 规则声明的位置：紧跟部署 persona（order 0），在任何降级内容之前。 */
-const RULES_ORDER = 1;
-const inject = ["systemPrompt", "skills"];
-const Config = z.object({
-	keep: z.array(z.string()).default([...DEFAULT_KEEP]),
-	suppress: z.array(z.string()).default([...DEFAULT_SUPPRESS]),
-	replace: z.dict(z.string()).default({ ...DEFAULT_REPLACE })
-});
-/**
-* 提示词注入的唯一通道：system prompt 里只留 `keep`，其余内容按声明的方式到达模型——
-* 降级为紧随用户消息的 reminder、或直接丢弃（写进按需 skill 正文是调用方自己的事）。
-*/
-function apply(ctx, config) {
-	const channel = new ContextAssembler(ctx);
-	const keep = new Set(config.keep ?? DEFAULT_KEEP);
-	for (const name of config.suppress ?? DEFAULT_SUPPRESS) channel.suppressSection(name);
-	for (const [name, text] of Object.entries(config.replace ?? DEFAULT_REPLACE)) channel.replaceSection(name, () => text);
-	ctx.systemPrompt.section({
-		name: RULES_SECTION,
-		order: RULES_ORDER,
-		text: RULES_TEXT
-	});
-	ctx.on("system-prompt/assemble", async (_assembly, context, next) => {
-		const result = await next();
-		const agent = context.agent;
-		const demoted = /* @__PURE__ */ new Map();
-		const sections = [];
-		let changed = false;
-		for (const section of result.sections) {
-			if (channel.isSuppressed(section.name)) {
-				changed = true;
-				continue;
-			}
-			const text = channel.replacement(section.name, agent) ?? section.text;
-			if (text !== section.text) changed = true;
-			if (keep.has(section.name) || text.length === 0) {
-				sections.push(text === section.text ? section : {
-					...section,
-					text
-				});
-				continue;
-			}
-			changed = true;
-			demoted.set(sectionId(section.name), text);
-		}
-		if (agent !== void 0) channel.sync(agent, { sections: demoted });
-		return changed ? {
-			...result,
-			sections
-		} : result;
-	});
-	ctx.on("agent/pre-step", async ({ agent, messages }, next) => {
-		const decision = await next();
-		if (decision.kind === "reject" || decision.messages.length === 0) return decision;
-		const pending = await pendingEntries(agent, channel);
-		if (pending.length === 0) return decision;
-		const claimedEnd = decision.messages.findLastIndex((message) => messages.includes(message));
-		return {
-			...decision,
-			messages: decision.messages.toSpliced(claimedEnd + 1, 0, ...pending.map(([key, entry]) => reminderMessage(key, entry.text, entry.source)))
-		};
-	});
-	ctx.on("agent/request-error", async ({ agent, signal }, next) => {
-		const action = await next();
-		if (action?.kind !== "retry" || signal.aborted) return action;
-		for (const [key, entry] of await pendingEntries(agent, channel)) agent.session.append("user/message", reminderMessage(key, entry.text, entry.source), { surfaceOp: "append" });
-		return action;
-	}, { prepend: true });
-}
-/** 降级 section 的条目 id：一条 section 一个 id，于是同一次变化只重发那一条。 */
-function sectionId(name) {
-	return `section:${name}`;
-}
-/** 本步要注入的条目：键相同且文本未变就不注入，按键字典序（顺序不随注册顺序抖动）。 */
-async function pendingEntries(agent, channel) {
-	return [...await channel.collect(agent)].filter(([key, entry]) => latestReminderText(agent, key) !== entry.text).toSorted(([left], [right]) => left < right ? -1 : left > right ? 1 : 0);
-}
-//#endregion
-export { name as a, DEFAULT_SUPPRESS as c, inject as i, ContextAssembler as l, apply as n, DEFAULT_KEEP as o, assembler_exports as r, DEFAULT_REPLACE as s, Config as t, renderVirtualSkill as u };