dsh-output-styles 0.2.0

package/docs/VERIFICATION.zh.md

@@ -0,0 +1,93 @@
+# 验证记录（dsh-output-styles）
+
+> 本文档记录交付验证的实测命令与输出。运行环境：Windows + Node 22 + pnpm 11；宿主为已安装的 `@deepseek-ai/dsh` CLI `0.1.0-rc.6`（`dsh --version` 输出 `0.1.0-rc.6`）。版本：0.2.0。
+
+## 1. 单元与集成测试
+
+```text
+$ pnpm test
+ ✓ tests/config.spec.ts (9 tests)
+ ✓ tests/style-command.spec.ts (10 tests)
+ ✓ tests/invariant.spec.ts (9 tests)
+ ✓ tests/style-library.spec.ts (24 tests)
+ ✓ tests/commands-projections.spec.ts (7 tests)
+ ✓ tests/runtime.spec.ts (23 tests)
+ ✓ tests/client.spec.ts (6 tests)
+ Test Files  7 passed (7)
+      Tests  87 passed (87)
+```
+
+覆盖：风格解析（md/json 单对象与数组集合、坏文件/坏条目跳过、重名/保留字/双 force 抛错、`name` 缺省继承文件名、多词名、`keep-coding-instructions`/`force` 字段）、`/style` 分派（无参带描述列表/整段文本切换/off/未知名）、码点安全截断与预算、多目录分层（后者覆盖前者、`includeBuiltins`）、fs.watch 热加载（新文件生效、破坏 defaultStyle 时保留旧库）、settings 项目默认（回落、会话选择优先、非法名拒写）、`keep-coding-instructions: false` 整段替换系统提示、force 覆盖、会话隔离、HMR 配置热更新、`style` 投影按 command/done 成功折叠（checkpoint v2 往返、失败命令不改变状态）、不变量检查、Web 客户端选择器（装饰注册、投影选项、整行提交、Remote 失败浮出）。
+
+集成用例用 npm 发布的 `@deepseek-ai/dsh-*@0.1.0-rc.6` 真实宿主/客户端服务组装（sessions / systemPrompt / commands / storage / storage-json / storage-domain / sessionProjections / settings；客户端 commandUi / sessions / remote / locale 为结构型测试替身）。
+
+`pnpm run typecheck`（两个 tsc 工程）、`pnpm run build`（宿主 + 客户端两个 bundle）、`pnpm run verify:self-contained`（44 个文本文件）均通过。
+
+## 2. 打包与 bundle 补丁层装载（0.2.0 新能力）
+
+```text
+$ pnpm pack
+Tarball Contents（节选）: package.json, LICENSE, lib/index.js, lib/invariant.js, lib/invariant-*.js,
+lib/client.js, lib/types/**/*.d.ts, src/**, styles/{concise,explanatory,formal,step-by-step}.md,
+cordis.patch.yml, README.md, README.zh.md, README.ja.md, README.ko.md, README.es.md, docs/
+
+$ env:DSH_HOME = <临时目录>
+$ dsh plugin --profile scratch add ./dsh-output-styles-0.2.0.tgz
+Packages: +9 ... Done in 3.1s        ← 不再出现 "declares no dsh.bundle" 警告
+
+$ dsh --profile scratch --dump-config
+# == dsh-output-styles
+- id: storage
+  name: '@deepseek-ai/dsh-storage'
+- id: storage-json
+  name: '@deepseek-ai/dsh-storage-json'
+- id: storage-domain
+  name: '@deepseek-ai/dsh-storage-domain'
+- id: output-styles
+  name: dsh-output-styles
+```
+
+包清单 `dsh.bundle.patch = ./cordis.patch.yml` 生效：一条 `plugin add` 即把 storage 三行 + 插件行作为补丁层组合进 profile（按 id 插入替换同 id 行，对 web profile 幂等）。0.1.0 时代的「纯依赖安装、需手写行」摩擦消除。
+
+## 3. `--dump-config` 行生效
+
+上一步的输出即证明：四行全部出现在生效组合中，schema 默认 config 正常展开（`stylesDir: []`、`includeBuiltins: true`、`watchStyles: true`），启动无 FAILED。
+
+## 4. headless 实测（模型可见注入与回复风格变化）
+
+0.1.0 交付时的真实 API 实测（deepseek-v4-pro）记录保留如下；0.2.0 的模型可见注入路径（`systemPrompt.section` + `system-prompt/assemble` waterfall）改动已由第 1 节的组装级集成测试覆盖，`keep-coding-instructions: false` 的整段替换断言即经真实 rc.6 `SystemPrompt.assemble` 输出验证。真实 API 复测需 `DEEPSEEK_API_KEY`，本机无 key 时按既有策略手动执行：
+
+```text
+$ dsh --profile styles-verify "请只用一句话介绍你自己，不要客套。"
+（无风格）我是 DeepSeek Harness 中的 AI 编码代理，运行于 deepseek-v4-pro 模型之上，负责在插件化代理框架内执行代码编写、文件操作、命令运行与多步骤任务编排。
+
+$ （cordis.patch.yml 中 output-styles 行改为 defaultStyle: concise，HMR 生效）
+$ dsh --profile styles-verify "请只用一句话介绍你自己，不要客套。"
+（concise）我是运行在 DeepSeek Harness 插件化平台上、基于 deepseek-v4-pro 模型的 AI 编码代理，能直接读写文件、执行命令并检索代码来完成工程任务。
+```
+
+会话日志取证（经宿主真实持久化包 `dsh-session-persistence-jsonl` 解码读回，`scripts/verify-session-log.mjs`，0.2.0 起按任意风格名匹配 `# Output style: <name>` 并报告宿主身份是否共存）：
+
+```text
+== session session-3d490e6d-…（concise 运行，170 events）==
+request/header logged before dispatch: true
+style heading in logged system prompt: true
+active style name in logged prompt: concise
+style body in logged system prompt: true
+harness identity alongside style: true
+```
+
+即：模型可见的风格正文在派发前完整写入 `request/header`（模型可见 ⟺ 已记录），有风格会话与无风格会话可区分；风格名由 `command/run`（`/style` 命令生命周期）与 `output_style` 域记录（含 `{ kind: 'plugin', plugin: 'dsh-output-styles' }` 来源标记）重建。`keep-coding-instructions: false` 的会话则 `harness identity alongside style: false`。
+
+## 5. Web UI 入口
+
+- **命令入口**：宿主 `/style` 命令经真实 rc.6 命令注册表注册（集成测试断言 `ctx.commands.list(agent)` 含 `{ name: 'style', input: { hint: '<style | off>' } }`）——这正是 Web UI 经 BFF 读取的同一注册表。
+- **选择器（0.2.0 新能力）**：`dsh-output-styles/client` 客户端行用 `commandUi.decorate` 把 `/style` 裸调用装饰成投影驱动的 popupSelect（`off` 行 + 每风格一行、当前行高亮、中英双语）；客户端入口测试断言选项构建、`/style <整段名字>`/`/style off` 整行提交与 Remote 失败浮出。实测装载：向 profile 添加 `- id: output-styles-client / name: 'dsh-output-styles/client'` 行后经 Loader 解析，随 web bundle 的客户端运行时激活。
+- **会话投影**：`style`（`{ options, currentValue, options[].whenToUse }`）供 Web UI 读取，经 `sessionProjections.snapshot`/`checkpoint` 往返验证（stateVersion 2）。
+- **项目默认**：settings 命名空间 `output-style`（`{ style }`）注册在 settings seam 上，无 settings 服务时待激活、不影响主功能（集成测试覆盖两种组合）。
+
+## 6. 已知边界
+
+- 真实 API 复测（第 4 节）需要 `DEEPSEEK_API_KEY`；无 key 时组装级集成测试是模型可见路径的回归保障，真实 API 手动复测步骤不变。
+- 风格不作用于子代理会话（与 Claude Code 语义一致，README「与 Claude Code 的差异」表明确记录）。
+- settings 提供方未配置时项目默认回落 `defaultStyle`；settings 值在风格热加载后变为悬空名时静默降级为无风格（与悬空会话选择同策略）。

package/lib/client.js

@@ -0,0 +1,83 @@
+//#region src/client/locales.ts
+/** Simplified Chinese dictionary (the key-set source of truth). */
+const zh = {
+	"option.off": "关闭（默认）",
+	"option.offDetail": "恢复项目默认输出风格"
+};
+/** English dictionary, checked complete against the zh key set. */
+const en = {
+	"option.off": "Off (default)",
+	"option.offDetail": "Restore the project default output style"
+};
+//#endregion
+//#region src/client/index.ts
+/** Client plugin name; keep stable after publishing. */
+const name = "dsh-output-styles-client";
+/** Required client services: the command surface, the sessions face, the command Remote, and locale. */
+const inject = [
+	"commandUi",
+	"locale",
+	"remote",
+	"sessions"
+];
+/** Dictionary namespace owned by this plugin. */
+const NS = "style";
+/** The picker row that restores the project default; stable, never a style name. */
+const OFF_ID = "off";
+/** Flatten the projection into picker rows: the off row first, then one row per style. */
+function optionsOf(view, t) {
+	const rows = [{
+		id: OFF_ID,
+		label: t("option.off"),
+		detail: t("option.offDetail"),
+		active: view.currentValue === null
+	}];
+	for (const option of view.options) rows.push({
+		id: option.value,
+		label: option.name,
+		detail: option.whenToUse !== void 0 ? `${option.description} · ${option.whenToUse}` : option.description,
+		active: view.currentValue === option.value
+	});
+	return rows;
+}
+/**
+* Client plugin body: register the `style` dictionaries and decorate the
+* host `/style` command's bare invocation with the projection-backed picker.
+* @param ctx - client root context.
+*/
+function apply(ctx) {
+	ctx.effect(() => ctx.locale.register(NS, {
+		zh,
+		en
+	}), "dsh-output-styles: style dictionaries");
+	const t = ctx.locale.bind(NS);
+	ctx.inject([
+		"commandUi",
+		"remote",
+		"sessions"
+	], (scope) => {
+		const commandUi = scope.get("commandUi");
+		const sessions = scope.get("sessions");
+		const remote = scope.remote;
+		scope.effect(() => commandUi.decorate({
+			name: "style",
+			available: () => true,
+			ui: {
+				kind: "popupSelect",
+				options: async (session) => {
+					const view = sessions.binding(session.sessionId)?.session.projections.faceOf("style").getSnapshot();
+					if (view === void 0) return [];
+					return optionsOf(view, t);
+				},
+				onSelect: async (option, session) => {
+					const line = option.id === OFF_ID ? "/style off" : `/style ${option.id}`;
+					const result = await remote.commands.execute(session.sessionId, line);
+					if (!result.ok) throw new Error(`command.execute failed: ${result.error.code}: ${result.error.message}`);
+					if (result.value === void 0) throw new Error(`unknown or malformed command: ${line}`);
+				}
+			}
+		}), "dsh-output-styles: /style picker");
+	});
+}
+//#endregion
+export { apply, inject, name };

package/lib/index.js

@@ -0,0 +1,415 @@
+import { _ as styleSelectionSchema, c as loadStyleLibrary, d as STYLE_COMMAND, f as applyStyleEvent, g as STYLE_SOURCE, h as OUTPUT_STYLE_DOMAIN, i as installInvariant, l as truncateStyle, m as OFF, o as STYLE_NAME_RE, p as parseStyleInput, s as isValidStyleName, t as PACKAGE_NAME, u as EMPTY_STYLE_STATE, v as styleSelectionViewSchema } from "./invariant-LV6hQX5s.js";
+import z from "@deepseek-ai/schemastery";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { watch } from "node:fs";
+import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
+//#region src/config.ts
+/**
+* Serializable configuration, schema, and direct-call defaults.
+*
+* Every tunable lives here: a deployment changes behavior through
+* `cordis.yml`, never by editing source. The schema is validated by the
+* harness Loader while the plugin loads; invalid configuration fails the
+* load with an actionable error.
+* @module dsh-output-styles/config
+*/
+/** Loader-visible configuration schema and defaults. */
+const Config = z.object({
+	stylesDir: z.union([z.string(), z.array(z.string())]).default([]),
+	maxStyleChars: z.number().min(1).default(4e3),
+	defaultStyle: z.string().default(""),
+	compatJson: z.boolean().default(true),
+	sectionOrder: z.number().default(90),
+	truncationMarker: z.string().default("\n\n[style truncated]"),
+	includeBuiltins: z.boolean().default(true),
+	watchStyles: z.boolean().default(true)
+});
+/**
+* Resolve the same defaults for direct callers that bypass the Cordis Loader,
+* and fail loud on values the schema cannot express (a non-finite section
+* order).
+* @param config - Partial serialized configuration.
+* @param defaultStylesDir - Absolute bundled directory used when built-ins are included.
+* @returns Configuration with every default applied.
+*/
+function resolveConfig(config, defaultStylesDir) {
+	const maxStyleChars = config.maxStyleChars ?? 4e3;
+	if (!Number.isFinite(maxStyleChars) || maxStyleChars < 1) throw new Error(`dsh-output-styles: maxStyleChars must be a finite number ≥ 1, got ${String(config.maxStyleChars)}`);
+	const sectionOrder = config.sectionOrder ?? 90;
+	if (!Number.isFinite(sectionOrder)) throw new Error(`dsh-output-styles: sectionOrder must be a finite number, got ${String(config.sectionOrder)}`);
+	const includeBuiltins = config.includeBuiltins ?? true;
+	const customDirs = (Array.isArray(config.stylesDir) ? config.stylesDir : config.stylesDir === void 0 || config.stylesDir === "" ? [] : [config.stylesDir]).map((dir) => resolve(dir));
+	return {
+		stylesDirs: includeBuiltins ? [defaultStylesDir, ...customDirs] : customDirs,
+		maxStyleChars,
+		defaultStyle: config.defaultStyle ?? "",
+		compatJson: config.compatJson ?? true,
+		sectionOrder,
+		truncationMarker: config.truncationMarker ?? "\n\n[style truncated]",
+		includeBuiltins,
+		watchStyles: config.watchStyles ?? true
+	};
+}
+//#endregion
+//#region src/runtime.ts
+/**
+* Runtime boundary and Cordis activation: style resolution over the durable
+* selection domain, the model-visible system-prompt section, the `/style`
+* command, the `style` session projection, and the invariant registration.
+*
+* Every registration is an effect — Cordis undoes all of them on unload, so
+* configuration hot-reload replaces the whole plugin without residue.
+* @module dsh-output-styles/runtime
+*/
+/** Bundled style-library directory (package `styles/`), the lowest-priority `stylesDir` entry. */
+const DEFAULT_STYLES_DIR = fileURLToPath(new URL("../styles/", import.meta.url));
+/** Prompt-section name; a fixed registry key a scoped composition could shadow. */
+const STYLE_SECTION_NAME = "output-style:selection";
+/** Settings namespace owning the project-level default (`outputStyle`). */
+const SETTINGS_NS = settingsNamespace("output-style");
+/** Coalescing delay for style-file change events; an internal implementation constant, not a deployment knob. */
+const WATCH_DEBOUNCE_MS = 250;
+/**
+* Resolved style behavior for one session. A forced style (frontmatter
+* `force: true`) wins over everything; otherwise the session's own durable
+* selection wins, sessions that never selected one fall back to the project
+* default (settings `outputStyle`, then the configured default style), and
+* `''` means no style at all.
+*/
+var OutputStyleRuntime = class {
+	domain;
+	library;
+	forcedStyle;
+	selection;
+	defaultStyle;
+	maxStyleChars;
+	truncationMarker;
+	projectDefault;
+	/** Style library in deterministic directory/file order. */
+	get styles() {
+		return this.library;
+	}
+	/**
+	* @param domain - the opened `output_style` domain; the caller owns `close()`.
+	* @param styles - the loaded style library (at most one `force` style).
+	* @param options - resolved style budget and default.
+	*/
+	constructor(domain, styles, options) {
+		this.domain = domain;
+		this.library = styles;
+		this.selection = domain.table("selection");
+		this.defaultStyle = options.defaultStyle;
+		this.maxStyleChars = options.maxStyleChars;
+		this.truncationMarker = options.truncationMarker;
+		this.forcedStyle = [...styles.values()].find((style) => style.force);
+		this.projectDefault = () => this.defaultStyle;
+	}
+	/** Every switchable style name, in library order. */
+	get names() {
+		return [...this.library.keys()];
+	}
+	/** The forced style's name, or undefined when the library declares none. */
+	get forcedName() {
+		return this.forcedStyle?.name;
+	}
+	/**
+	* Atomically swap the style library (style-file hot reload). The forced
+	* style is recomputed; the caller already validated the new library.
+	* @param styles - the replacement library.
+	*/
+	reload(styles) {
+		this.library = styles;
+		this.forcedStyle = [...styles.values()].find((style) => style.force);
+	}
+	/**
+	* Point the project-default resolution at a live source (the settings
+	* scope while one is attached, the composition entry otherwise).
+	* @param get - thunk returning the project default style name (`''` = none).
+	*/
+	setProjectDefault(get) {
+		this.projectDefault = get;
+	}
+	/**
+	* Resolve one style by name.
+	* @param name - style name.
+	* @returns the style, or undefined when the library has none.
+	*/
+	get(name) {
+		return this.library.get(name);
+	}
+	/**
+	* The session's durable selection record.
+	* @param sessionId - the session the selection belongs to.
+	* @returns the record, or undefined when the session never selected one.
+	*/
+	selectionFor(sessionId) {
+		return this.selection.get(sessionId);
+	}
+	/**
+	* The style in force for a session: a forced library style, else the
+	* session's own selection, else the project default, else none. A stale
+	* selection or project default (its style left the library) also degrades
+	* to none.
+	* @param sessionId - the session the style is resolved for.
+	* @returns the effective style, or undefined when no style applies.
+	*/
+	effectiveStyle(sessionId) {
+		if (this.forcedStyle !== void 0) return this.forcedStyle;
+		const record = this.selectionFor(sessionId);
+		const name = record !== void 0 ? record.style : this.projectDefault();
+		return name === "" ? void 0 : this.library.get(name);
+	}
+	/**
+	* The effective style name, or `''` when no style applies.
+	* @param sessionId - the session the style is resolved for.
+	* @returns the style name, or `''`.
+	*/
+	currentName(sessionId) {
+		return this.effectiveStyle(sessionId)?.name ?? "";
+	}
+	/**
+	* The model-visible style directive for a session: a header naming the
+	* style plus its body under the configured budget. The exact text is what
+	* the harness logs in `request/header` before dispatch.
+	* @param sessionId - the session the directive is built for.
+	* @returns the directive, or `''` when no style applies.
+	*/
+	promptText(sessionId) {
+		const style = this.effectiveStyle(sessionId);
+		if (style === void 0) return "";
+		const body = truncateStyle(style.body, this.maxStyleChars, this.truncationMarker);
+		return `# Output style: ${style.name}\n\nUse the following output style for every response in this conversation:\n\n${body}`;
+	}
+	/**
+	* The `/style` no-argument listing: the current selection followed by one
+	* line per style (`name — description`, with `whenToUse` appended when set).
+	* @param sessionId - the session the listing describes.
+	* @returns the multi-line command result text.
+	*/
+	listLine(sessionId) {
+		const current = this.currentName(sessionId);
+		const lines = [current === "" ? "output style off" : `current output style: ${current}`];
+		for (const style of this.styles.values()) {
+			const whenToUse = style.whenToUse === void 0 ? "" : ` (${style.whenToUse})`;
+			lines.push(`${style.name} — ${style.description}${whenToUse}`);
+		}
+		return lines.join("\n");
+	}
+	/**
+	* The unknown-name error line, shared by the command handler and the direct
+	* {@link OutputStyleRuntime.select} write path.
+	* @param name - the rejected switch target.
+	* @returns the error text listing every switchable name.
+	*/
+	unknownStyleLine(name) {
+		return `unknown output style "${name}" (available: ${this.names.join(", ")})`;
+	}
+	/**
+	* Durably select a style for a session. The write resolves only after the
+	* backend acknowledged it, so a settled command implies a stored record.
+	* @param session - the session the selection belongs to.
+	* @param name - library style name; unknown names throw.
+	* @returns resolution after durability.
+	*/
+	async select(session, name) {
+		if (this.styles.get(name) === void 0) throw new Error(`dsh-output-styles: ${this.unknownStyleLine(name)}`);
+		await this.selection.put(session.id, {
+			style: name,
+			source: STYLE_SOURCE
+		});
+	}
+	/**
+	* Remove a session's selection, restoring the configured default.
+	* @param session - the session whose selection is removed.
+	* @returns resolution after durability.
+	*/
+	async turnOff(session) {
+		await this.selection.delete(session.id);
+	}
+	/**
+	* Close the opened domain (the plugin fiber's async disposer).
+	* @returns resolution after the backend unit is released.
+	*/
+	async close() {
+		await this.domain.close();
+	}
+};
+/** Build the `style` projection's wire value for one folded state. */
+function viewStyleSelection(runtime, state) {
+	const currentValue = state.current !== null && runtime.styles.has(state.current) ? state.current : null;
+	return {
+		options: [...runtime.styles.entries()].map(([value, style]) => ({
+			value,
+			name: style.name,
+			description: style.description,
+			...style.whenToUse === void 0 ? {} : { whenToUse: style.whenToUse }
+		})),
+		currentValue
+	};
+}
+/**
+* Apply the plugin to its Cordis context.
+*
+* Declares `storageDomain` via `inject` (ready before `apply`; a composition
+* without a routed kv backend keeps the plugin pending). Bad style files are
+* skipped with warnings; a duplicate or reserved style name, an unreadable
+* style directory, or a `defaultStyle` naming no style fails the load.
+* @param ctx - scoped plugin context; registrations must be owned by its effects.
+* @param config - configuration resolved by Cordis from the exported schema.
+*/
+async function apply(ctx, config) {
+	const storageDomain = ctx.get("storageDomain");
+	if (storageDomain === void 0) throw new Error("dsh-output-styles: the \"storageDomain\" service declared by inject is unavailable — mount the storage facility (see README) or declare the inject");
+	const resolved = resolveConfig(config, DEFAULT_STYLES_DIR);
+	const styles = loadStyleLibrary(resolved.stylesDirs, { compatJson: resolved.compatJson }, (message) => {
+		ctx.logger.warn(`dsh-output-styles: ${message}`);
+	});
+	if (resolved.defaultStyle !== "" && !styles.has(resolved.defaultStyle)) throw new Error(`dsh-output-styles: defaultStyle "${resolved.defaultStyle}" names no style in ${resolved.stylesDirs.join(", ")} (available: ${[...styles.keys()].join(", ") || "none"})`);
+	const domain = await storageDomain.open(OUTPUT_STYLE_DOMAIN);
+	ctx.effect(() => () => domain.close());
+	const runtime = new OutputStyleRuntime(domain, styles, resolved);
+	if (resolved.watchStyles) {
+		let timer;
+		const reload = () => {
+			try {
+				const next = loadStyleLibrary(resolved.stylesDirs, { compatJson: resolved.compatJson }, (message) => {
+					ctx.logger.warn(`dsh-output-styles: ${message}`);
+				});
+				if (resolved.defaultStyle !== "" && !next.has(resolved.defaultStyle)) {
+					ctx.logger.warn(`dsh-output-styles: style file change removed defaultStyle "${resolved.defaultStyle}"; keeping the previous library`);
+					return;
+				}
+				runtime.reload(next);
+			} catch (error) {
+				ctx.logger.warn(`dsh-output-styles: style file change not applied: ${error instanceof Error ? error.message : String(error)}`);
+			}
+		};
+		const schedule = () => {
+			if (timer !== void 0) return;
+			timer = setTimeout(() => {
+				timer = void 0;
+				reload();
+			}, WATCH_DEBOUNCE_MS);
+		};
+		ctx.effect(() => {
+			const watchers = [];
+			for (const dir of resolved.stylesDirs) try {
+				watchers.push(watch(dir, { persistent: false }, () => {
+					schedule();
+				}));
+			} catch (error) {
+				ctx.logger.warn(`dsh-output-styles: cannot watch style directory ${dir}: ${error instanceof Error ? error.message : String(error)}`);
+			}
+			return () => {
+				if (timer !== void 0) clearTimeout(timer);
+				for (const watcher of watchers) watcher.close();
+			};
+		});
+	}
+	installSettingsSection(ctx, SETTINGS_NS, z.object({ style: z.string().default("") }), { style: resolved.defaultStyle }, {
+		setSource: (current) => {
+			runtime.setProjectDefault(() => current().style);
+		},
+		onChange: () => {},
+		validate: (value) => {
+			if (value.style !== "" && !runtime.styles.has(value.style)) throw new Error(`dsh-output-styles: settings outputStyle "${value.style}" names no style (available: ${[...runtime.styles.keys()].join(", ") || "none"})`);
+		}
+	});
+	ctx.systemPrompt.section({
+		name: STYLE_SECTION_NAME,
+		order: resolved.sectionOrder,
+		text: (context) => {
+			const agent = context.agent;
+			if (agent === void 0) return "";
+			const style = runtime.effectiveStyle(agent.session.id);
+			if (style === void 0 || !style.keepCodingInstructions) return "";
+			return runtime.promptText(agent.session.id);
+		}
+	});
+	ctx.on("system-prompt/assemble", async (_assembly, context, next) => {
+		const out = await next();
+		const agent = context.agent;
+		if (agent === void 0) return out;
+		const style = runtime.effectiveStyle(agent.session.id);
+		if (style === void 0 || style.keepCodingInstructions) return out;
+		return {
+			...out,
+			sections: [{
+				name: STYLE_SECTION_NAME,
+				text: runtime.promptText(agent.session.id)
+			}]
+		};
+	});
+	ctx.inject(["commands"], (commandCtx) => {
+		commandCtx.commands.register({
+			name: STYLE_COMMAND,
+			description: "Switch the model output style for this session",
+			input: { hint: "<style | off>" },
+			handler: async ({ agent, rawInput }) => {
+				const input = parseStyleInput(rawInput);
+				if (input.kind === "none") return {
+					kind: "success",
+					text: runtime.listLine(agent.session.id)
+				};
+				if (input.kind === "off") {
+					await runtime.turnOff(agent.session);
+					const forced = runtime.forcedName;
+					return {
+						kind: "success",
+						text: forced === void 0 ? "output style off" : `output style off (style "${forced}" remains in force)`
+					};
+				}
+				if (runtime.get(input.name) === void 0) return {
+					kind: "error",
+					text: runtime.unknownStyleLine(input.name)
+				};
+				await runtime.select(agent.session, input.name);
+				return {
+					kind: "success",
+					text: `switched to ${input.name}`
+				};
+			}
+		});
+	});
+	ctx.inject(["sessionProjections"], (projectionCtx) => {
+		projectionCtx.sessionProjections.register({
+			key: "style",
+			schema: styleSelectionViewSchema,
+			init: () => EMPTY_STYLE_STATE,
+			apply: applyStyleEvent,
+			view: (state) => viewStyleSelection(runtime, state),
+			stateVersion: 2
+		});
+	});
+	ctx.inject(["invariants"], (invariantCtx) => {
+		const registry = invariantCtx.get("invariants");
+		if (registry === void 0) return;
+		registry.register(PACKAGE_NAME, installInvariant({
+			knownStyles: () => new Set(runtime.names),
+			selectionFor: (sessionId) => runtime.selectionFor(sessionId)
+		}));
+	});
+}
+//#endregion
+//#region src/index.ts
+/**
+* `dsh-output-styles`: Claude Code `outputStyles`-equivalent runtime output
+* styles for DeepSeek Harness. The plugin registers a model-visible system
+* prompt section that injects the current session's style body, a `/style`
+* slash command that switches it, per-session persistence over the
+* `output_style` storage domain, and the `style` session projection.
+* @module dsh-output-styles
+*/
+/** Cordis plugin name; keep this stable after publishing. */
+const name = "dsh-output-styles";
+/**
+* Services that must exist before the plugin applies: the prompt-assembly
+* registry for the injected section, and the storage domain facility for
+* per-session persistence. A composition without a routed kv backend keeps
+* the plugin pending until the storage rows appear (Cordis dependency
+* semantics), instead of racing a parallel mount.
+*/
+const inject = ["systemPrompt", "storageDomain"];
+//#endregion
+export { Config, DEFAULT_STYLES_DIR, EMPTY_STYLE_STATE, OFF, OUTPUT_STYLE_DOMAIN, OutputStyleRuntime, PACKAGE_NAME, STYLE_COMMAND, STYLE_NAME_RE, STYLE_SECTION_NAME, STYLE_SOURCE, apply, applyStyleEvent, inject, installInvariant, isValidStyleName, loadStyleLibrary, name, parseStyleInput, resolveConfig, styleSelectionSchema, styleSelectionViewSchema, truncateStyle };