dsh-output-styles 0.4.3 → 0.6.0

package/lib/index.js

@@ -38,7 +38,8 @@ const Config = z.object({
 		style: z.string().min(1),
 		priority: z.number().required(false)
 	})).default([]),
-	enableExport: z.boolean().default(true)
+	enableExport: z.boolean().default(true),
+	respectCoreOutputStyles: z.boolean().default(true)
 });
 /**
 * Resolve the same defaults for direct callers that bypass the Cordis Loader,
@@ -75,7 +76,59 @@ function resolveConfig(config, defaultStylesDir) {
 			...rule,
 			priority: rule.priority ?? 0
 		})),
-		enableExport: config.enableExport ?? true
+		enableExport: config.enableExport ?? true,
+		respectCoreOutputStyles: config.respectCoreOutputStyles ?? true
+	};
+}
+//#endregion
+//#region lib/types/coexist.js
+/**
+* Coexistence with a core `outputStyles` capability.
+*
+* If DeepSeek Harness ever ships a first-party `outputStyles` feature, this
+* plugin's system-prompt injection would duplicate it. The coexistence policy
+* detects the core capability through its reserved service seam and, when it
+* is present, degrades to the incremental surface this plugin uniquely adds —
+* runtime hot-switch, per-session/per-tool rules, and `/export` — while
+* leaving prompt injection entirely to the core.
+*
+* Detection is a service probe, not a name guess: a core implementation
+* publishes the `outputStyles` service; when that seam is absent the plugin
+* runs standalone (injecting the style section itself).
+* @module dsh-output-styles/coexist
+*/
+/** The reserved service name a core `outputStyles` capability publishes. */
+const CORE_OUTPUT_STYLES_SERVICE = "outputStyles";
+/**
+* Probe whether a core `outputStyles` capability is composed.
+* @param ctx - the plugin-scoped context.
+* @returns true when the core `outputStyles` service seam is present.
+*/
+function detectCoreOutputStyles(ctx) {
+	return ctx.get(CORE_OUTPUT_STYLES_SERVICE) !== void 0;
+}
+/** The incremental surfaces that survive coexistence in either mode. */
+const RETAINED = [
+	"hot-switch",
+	"rules",
+	"export"
+];
+/**
+* Compute the coexistence report for one composition. Respecting the core is
+* the default (`respectCore` true); a deployment can force standalone mode by
+* setting `respectCoreOutputStyles: false`.
+* @param ctx - the plugin-scoped context.
+* @param respectCore - whether to honor a detected core capability (default true).
+* @returns the coexistence report.
+*/
+function coexistenceReport(ctx, respectCore = true) {
+	const coreActive = respectCore && detectCoreOutputStyles(ctx);
+	return {
+		coreActive,
+		mode: coreActive ? "degraded" : "standalone",
+		promptInjection: coreActive ? "disabled" : "enabled",
+		retained: [...RETAINED],
+		disabled: coreActive ? ["system-prompt injection"] : []
 	};
 }
 //#endregion
@@ -619,6 +672,8 @@ 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 coreActive = resolved.respectCoreOutputStyles && detectCoreOutputStyles(ctx);
+	if (coreActive) ctx.logger.info("dsh-output-styles: core outputStyles detected — degrading to hot-switch + rules + export (no prompt injection)");
 	const styles = loadStyleLibrary(resolved.stylesDirs, { compatJson: resolved.compatJson }, (message) => {
 		ctx.logger.warn(`dsh-output-styles: ${message}`);
 	});
@@ -673,31 +728,33 @@ async function apply(ctx, config) {
 			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) => {
+	if (!coreActive) {
+		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 "";
+			if (agent === void 0) return out;
 			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)
-			}]
-		};
-	});
+			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,
@@ -794,12 +851,12 @@ async function apply(ctx, config) {
 		commandCtx.commands.register({
 			name: "export",
 			description: "Export this session as Markdown or HTML (renderer-aware)",
-			input: { hint: "[markdown|html] [--renderer=<id>]" },
-			handler: async ({ agent, rawInput }) => {
+			input: { hint: "[markdown|html] [--renderer=<id>] [--save <path>]" },
+			handler: async ({ agent, rawInput, signal }) => {
 				const input = parseExportInput(rawInput);
 				if (input.kind === "error") return {
 					kind: "error",
-					text: "usage: /export [markdown|html] [--renderer=<id>]"
+					text: "usage: /export [markdown|html] [--renderer=<id>] [--save <path>]"
 				};
 				const lines = conversationLines(agent.session.events);
 				const rules = input.renderer === void 0 ? [...effectiveRules] : [{
@@ -807,28 +864,57 @@ async function apply(ctx, config) {
 					style: input.renderer,
 					priority: 0
 				}];
+				const document = renderExport(renderers, lines, input.format, rules);
+				if (input.save === void 0) return {
+					kind: "success",
+					text: document.text
+				};
+				const saved = await saveExportFile(ctx.get("fs"), ctx.get("approval"), agent, input.save, sanitizeText(document.text), signal);
+				if (saved.kind === "error") return {
+					kind: "error",
+					text: saved.text
+				};
 				return {
 					kind: "success",
-					text: renderExport(renderers, lines, input.format, rules).text
+					text: `saved ${input.format} export to ${saved.path}`
 				};
 			}
 		});
 	});
 }
-/** Parse `/export [markdown|html] [--renderer=<id>]` from the raw command input. */
+/** Parse `/export [markdown|html] [--renderer=<id>] [--save <path>]` from the raw command input. */
 function parseExportInput(rawInput) {
 	const raw = String(rawInput ?? "").trim();
 	const parts = raw === "" ? [] : raw.split(/\s+/);
 	let format = "markdown";
 	let renderer;
-	for (const part of parts) {
-		if (part === "markdown" || part === "html") {
-			format = part;
+	let save;
+	for (let index = 0; index < parts.length; index += 1) {
+		const part = parts[index];
+		if (part === void 0) continue;
+		if (part === "markdown" || part === "md") {
+			format = "markdown";
+			continue;
+		}
+		if (part === "html") {
+			format = "html";
+			continue;
+		}
+		const rendererMatch = /^--renderer=([a-z0-9][a-z0-9-]*)$/.exec(part);
+		if (rendererMatch !== null) {
+			renderer = rendererMatch[1];
 			continue;
 		}
-		const match = /^--renderer=([a-z0-9][a-z0-9-]*)$/.exec(part);
-		if (match !== null) {
-			renderer = match[1];
+		const saveInline = /^--save=(.+)$/.exec(part);
+		if (saveInline !== null) {
+			save = saveInline[1];
+			continue;
+		}
+		if (part === "--save") {
+			const next = parts[index + 1];
+			if (next === void 0 || next === "") return { kind: "error" };
+			save = next;
+			index += 1;
 			continue;
 		}
 		return { kind: "error" };
@@ -836,7 +922,69 @@ function parseExportInput(rawInput) {
 	return {
 		kind: "ok",
 		format,
-		...renderer === void 0 ? {} : { renderer }
+		...renderer === void 0 ? {} : { renderer },
+		...save === void 0 ? {} : { save }
+	};
+}
+/**
+* Write one rendered export document to a workspace path after user approval.
+* Fail-closed: a missing approval service, a rejected/cancelled/unavailable
+* decision, or a throwing approval channel all deny the write; a missing fs
+* service fails loudly with a structured error. The caller already sanitized
+* `content` before this write.
+* @param fs - the fs service (`ctx.get('fs')`), or undefined when none is composed.
+* @param approval - the approval service (`ctx.get('approval')`), or undefined when none is composed.
+* @param agent - the agent whose session the export belongs to (routes the approval).
+* @param path - the workspace path to write.
+* @param content - the sanitized document text.
+* @param signal - the command's abort signal, forwarded to approval and resolve.
+* @returns the written path, or a structured failure.
+*/
+async function saveExportFile(fs, approval, agent, path, content, signal) {
+	if (approval === void 0) return {
+		kind: "error",
+		code: "approval-unavailable",
+		text: "dsh-output-styles: /export --save requires an approval service (compose @deepseek-ai/dsh-user-approval); nothing was written"
+	};
+	let outcome;
+	try {
+		outcome = await approval.request({
+			agent,
+			toolName: "export",
+			reason: `write the exported document to ${path}`,
+			...signal === void 0 ? {} : { signal }
+		});
+	} catch {
+		outcome = "unavailable";
+	}
+	switch (outcome) {
+		case "allowed-once": break;
+		case "rejected": return {
+			kind: "error",
+			code: "approval-denied",
+			text: "dsh-output-styles: /export --save was rejected; nothing was written"
+		};
+		case "cancelled": return {
+			kind: "error",
+			code: "approval-cancelled",
+			text: "dsh-output-styles: /export --save was cancelled; nothing was written"
+		};
+		default: return {
+			kind: "error",
+			code: "approval-unavailable",
+			text: "dsh-output-styles: /export --save approval is unavailable; nothing was written"
+		};
+	}
+	if (fs === void 0) return {
+		kind: "error",
+		code: "fs-unavailable",
+		text: "dsh-output-styles: /export --save requires an fs service (compose @deepseek-ai/dsh-fs); nothing was written"
+	};
+	const target = await fs.resolve(path, signal === void 0 ? void 0 : { signal });
+	await fs.writeText(target, content);
+	return {
+		kind: "written",
+		path
 	};
 }
 //#endregion
@@ -860,4 +1008,4 @@ const name = "dsh-output-styles";
 */
 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, styleFoldStateSchema, styleSelectionSchema, styleSelectionViewSchema, truncateStyle };
+export { CORE_OUTPUT_STYLES_SERVICE, 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, coexistenceReport, detectCoreOutputStyles, inject, installInvariant, isValidStyleName, loadStyleLibrary, name, parseStyleInput, resolveConfig, styleFoldStateSchema, styleSelectionSchema, styleSelectionViewSchema, truncateStyle };

package/lib/types/coexist.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Coexistence with a core `outputStyles` capability.
+ *
+ * If DeepSeek Harness ever ships a first-party `outputStyles` feature, this
+ * plugin's system-prompt injection would duplicate it. The coexistence policy
+ * detects the core capability through its reserved service seam and, when it
+ * is present, degrades to the incremental surface this plugin uniquely adds —
+ * runtime hot-switch, per-session/per-tool rules, and `/export` — while
+ * leaving prompt injection entirely to the core.
+ *
+ * Detection is a service probe, not a name guess: a core implementation
+ * publishes the `outputStyles` service; when that seam is absent the plugin
+ * runs standalone (injecting the style section itself).
+ * @module dsh-output-styles/coexist
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** The reserved service name a core `outputStyles` capability publishes. */
+export declare const CORE_OUTPUT_STYLES_SERVICE = "outputStyles";
+/**
+ * Probe whether a core `outputStyles` capability is composed.
+ * @param ctx - the plugin-scoped context.
+ * @returns true when the core `outputStyles` service seam is present.
+ */
+export declare function detectCoreOutputStyles(ctx: Context): boolean;
+/** The coexistence mode: standalone owns injection; degraded leaves it to core. */
+export type CoexistenceMode = 'standalone' | 'degraded';
+/** A runnable coexistence check: what this plugin contributes under the current composition. */
+export interface CoexistenceReport {
+    /** Whether a core `outputStyles` capability was detected. */
+    readonly coreActive: boolean;
+    /** The effective coexistence mode. */
+    readonly mode: CoexistenceMode;
+    /** Whether this plugin injects the style system-prompt section. */
+    readonly promptInjection: 'enabled' | 'disabled';
+    /** The incremental surfaces this plugin always retains. */
+    readonly retained: readonly string[];
+    /** What this plugin disabled to avoid duplicating the core. */
+    readonly disabled: readonly string[];
+}
+/**
+ * Compute the coexistence report for one composition. Respecting the core is
+ * the default (`respectCore` true); a deployment can force standalone mode by
+ * setting `respectCoreOutputStyles: false`.
+ * @param ctx - the plugin-scoped context.
+ * @param respectCore - whether to honor a detected core capability (default true).
+ * @returns the coexistence report.
+ */
+export declare function coexistenceReport(ctx: Context, respectCore?: boolean): CoexistenceReport;
+//# sourceMappingURL=coexist.d.ts.map

package/lib/types/coexist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coexist.d.ts","sourceRoot":"","sources":["../../src/coexist.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAElD,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B,iBAAiB,CAAA;AAExD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAE5D;AAED,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,UAAU,CAAA;AAEvD,gGAAgG;AAChG,MAAM,WAAW,iBAAiB;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,eAAe,EAAE,SAAS,GAAG,UAAU,CAAA;IAChD,2DAA2D;IAC3D,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,+DAA+D;IAC/D,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC;AAKD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,UAAO,GAAG,iBAAiB,CASrF"}

package/lib/types/config.d.ts

@@ -59,6 +59,13 @@ export interface Config {
     rules?: StyleRuleConfig[];
     /** Register the `/export` command (Markdown/HTML session-export, renderer-aware). */
     enableExport?: boolean;
+    /**
+     * Honor a detected core `outputStyles` capability: when true (default) and
+     * the core service is composed, this plugin skips its own system-prompt
+     * injection (hot-switch / rules / export stay active). Set false to always
+     * inject regardless.
+     */
+    respectCoreOutputStyles?: boolean;
 }
 /** Configuration after defaults have been resolved. */
 export interface ResolvedConfig {
@@ -90,6 +97,8 @@ export interface ResolvedConfig {
     }>;
     /** Whether the `/export` command registers. */
     enableExport: boolean;
+    /** Whether a detected core `outputStyles` capability disables prompt injection. */
+    respectCoreOutputStyles: boolean;
 }
 /** Loader-visible configuration schema and defaults. */
 export declare const Config: z<Config>;

package/lib/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAGxC,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,KAAK,EAAE;QACL,6CAA6C;QAC7C,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,oCAAoC;QACpC,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAA;QAC1C,uEAAuE;QACvE,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,yFAAyF;IACzF,KAAK,EAAE,MAAM,CAAA;IACb,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,gEAAgE;AAChE,MAAM,WAAW,MAAM;IACrB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC7B,gGAAgG;IAChG,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6GAA6G;IAC7G,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,4GAA4G;IAC5G,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,sGAAsG;IACtG,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,wEAAwE;IACxE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,0GAA0G;IAC1G,KAAK,CAAC,EAAE,eAAe,EAAE,CAAA;IACzB,qFAAqF;IACrF,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,sGAAsG;IACtG,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAA;IACrB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAA;IACpB,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAA;IACnB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,CAAA;IACxB,4DAA4D;IAC5D,eAAe,EAAE,OAAO,CAAA;IACxB,yDAAyD;IACzD,WAAW,EAAE,OAAO,CAAA;IACpB,kEAAkE;IAClE,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACzI,+CAA+C;IAC/C,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,wDAAwD;AACxD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAmB3B,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,cAAc,CAqCtF"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAGxC,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,KAAK,EAAE;QACL,6CAA6C;QAC7C,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,oCAAoC;QACpC,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAA;QAC1C,uEAAuE;QACvE,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,yFAAyF;IACzF,KAAK,EAAE,MAAM,CAAA;IACb,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,gEAAgE;AAChE,MAAM,WAAW,MAAM;IACrB;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC7B,gGAAgG;IAChG,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6GAA6G;IAC7G,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,4GAA4G;IAC5G,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,sGAAsG;IACtG,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,wEAAwE;IACxE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,0GAA0G;IAC1G,KAAK,CAAC,EAAE,eAAe,EAAE,CAAA;IACzB,qFAAqF;IACrF,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAA;CAClC;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,sGAAsG;IACtG,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAA;IACrB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAA;IACpB,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAA;IACnB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,CAAA;IACxB,4DAA4D;IAC5D,eAAe,EAAE,OAAO,CAAA;IACxB,yDAAyD;IACzD,WAAW,EAAE,OAAO,CAAA;IACpB,kEAAkE;IAClE,KAAK,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACzI,+CAA+C;IAC/C,YAAY,EAAE,OAAO,CAAA;IACrB,mFAAmF;IACnF,uBAAuB,EAAE,OAAO,CAAA;CACjC;AAED,wDAAwD;AACxD,eAAO,MAAM,MAAM,EAAE,CAAC,CAAC,MAAM,CAoB3B,CAAA;AAEF;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,cAAc,CAsCtF"}

package/lib/types/index.d.ts

@@ -18,6 +18,8 @@ export declare const name = "dsh-output-styles";
 export declare const inject: string[];
 export { Config, resolveConfig } from './config.js';
 export type { ResolvedConfig } from './config.js';
+export { CORE_OUTPUT_STYLES_SERVICE, coexistenceReport, detectCoreOutputStyles } from './coexist.js';
+export type { CoexistenceMode, CoexistenceReport } from './coexist.js';
 export { apply, DEFAULT_STYLES_DIR, OutputStyleRuntime, STYLE_SECTION_NAME } from './runtime.js';
 export { applyStyleEvent, EMPTY_STYLE_STATE, parseStyleInput, STYLE_COMMAND, } from './style-command.js';
 export type { StyleFoldState, StyleInput } from './style-command.js';

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6DAA6D;AAC7D,eAAO,MAAM,IAAI,sBAAsB,CAAA;AAEvC;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,UAAoC,CAAA;AAEvD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAChG,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,aAAa,GACd,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EACL,GAAG,EACH,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACjF,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC/D,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAG3F,mBAAmB,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6DAA6D;AAC7D,eAAO,MAAM,IAAI,sBAAsB,CAAA;AAEvC;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,UAAoC,CAAA;AAEvD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AACjD,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AACpG,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AACtE,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAChG,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,aAAa,GACd,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpE,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,aAAa,GACd,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EACL,GAAG,EACH,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACjF,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC/D,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAG3F,mBAAmB,YAAY,CAAA"}

package/lib/types/runtime.d.ts

@@ -146,10 +146,56 @@ type ExportInput = {
     kind: 'ok';
     format: 'markdown' | 'html';
     renderer?: string;
+    save?: string;
 } | {
     kind: 'error';
 };
-/** Parse `/export [markdown|html] [--renderer=<id>]` from the raw command input. */
+/** Parse `/export [markdown|html] [--renderer=<id>] [--save <path>]` from the raw command input. */
 export declare function parseExportInput(rawInput: unknown): ExportInput;
+/** Approval outcome vocabulary, structural (mirrors the approval seam without importing it). */
+type ApprovalOutcome = 'allowed-once' | 'rejected' | 'cancelled' | 'unavailable';
+/** Structural slice of the DSH filesystem service the save path uses. */
+export interface ExportFileSystem {
+    resolve(path: string, opts?: {
+        cwd?: string;
+        signal?: AbortSignal;
+    }): Promise<unknown>;
+    writeText(target: unknown, content: string): Promise<unknown>;
+}
+/** Structural slice of the DSH approval service the save path uses. */
+export interface ExportApproval {
+    request(request: {
+        agent: unknown;
+        toolName: string;
+        reason: string;
+        signal?: AbortSignal;
+    }): Promise<ApprovalOutcome>;
+}
+/** Error codes of the `/export --save` path; each is a stable machine-readable label. */
+export type ExportSaveErrorCode = 'fs-unavailable' | 'approval-unavailable' | 'approval-denied' | 'approval-cancelled';
+/** Result of a `/export --save` attempt: the written path or a structured failure. */
+export type ExportSaveResult = {
+    readonly kind: 'written';
+    readonly path: string;
+} | {
+    readonly kind: 'error';
+    readonly code: ExportSaveErrorCode;
+    readonly text: string;
+};
+/**
+ * Write one rendered export document to a workspace path after user approval.
+ * Fail-closed: a missing approval service, a rejected/cancelled/unavailable
+ * decision, or a throwing approval channel all deny the write; a missing fs
+ * service fails loudly with a structured error. The caller already sanitized
+ * `content` before this write.
+ * @param fs - the fs service (`ctx.get('fs')`), or undefined when none is composed.
+ * @param approval - the approval service (`ctx.get('approval')`), or undefined when none is composed.
+ * @param agent - the agent whose session the export belongs to (routes the approval).
+ * @param path - the workspace path to write.
+ * @param content - the sanitized document text.
+ * @param signal - the command's abort signal, forwarded to approval and resolve.
+ * @returns the written path, or a structured failure.
+ */
+export declare function saveExportFile(fs: ExportFileSystem | undefined, approval: ExportApproval | undefined, agent: unknown, path: string, content: string, signal?: AbortSignal): Promise<ExportSaveResult>;
 export {};
 //# sourceMappingURL=runtime.d.ts.map

package/lib/types/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-output-styles",
-  "version": "0.4.3",
+  "version": "0.6.0",
   "description": "Claude Code outputStyles-equivalent runtime output-style switching for DeepSeek Harness",
   "type": "module",
   "sideEffects": false,
@@ -17,6 +17,7 @@
   "publishConfig": {
     "access": "public"
   },
+  "packageManager": "pnpm@11.7.0",
   "engines": {
     "node": "^22.19.0 || >=24.0.0"
   },
@@ -99,6 +100,7 @@
     },
     "permissions": [
       "fs:read",
+      "fs:write",
       "fs:watch",
       "storage:read",
       "storage:write",
@@ -131,13 +133,21 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-fs": ">=0.1.0-rc.8 <0.2.0",
     "@deepseek-ai/dsh-session": ">=0.1.0-rc.8 <0.2.0",
     "@deepseek-ai/dsh-session-projection": ">=0.1.1-rc.2 <0.2.0",
     "@deepseek-ai/dsh-settings": ">=0.1.0-rc.8 <0.2.0",
     "@deepseek-ai/dsh-storage-domain": ">=0.1.0-rc.8 <0.2.0",
+    "@deepseek-ai/dsh-user-approval": ">=0.1.0-rc.8 <0.2.0",
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-fs": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-user-approval": {
+      "optional": true
+    },
     "@deepseek-ai/dsh-settings": {
       "optional": true
     },

package/src/coexist.ts

@@ -0,0 +1,68 @@
+/**
+ * Coexistence with a core `outputStyles` capability.
+ *
+ * If DeepSeek Harness ever ships a first-party `outputStyles` feature, this
+ * plugin's system-prompt injection would duplicate it. The coexistence policy
+ * detects the core capability through its reserved service seam and, when it
+ * is present, degrades to the incremental surface this plugin uniquely adds —
+ * runtime hot-switch, per-session/per-tool rules, and `/export` — while
+ * leaving prompt injection entirely to the core.
+ *
+ * Detection is a service probe, not a name guess: a core implementation
+ * publishes the `outputStyles` service; when that seam is absent the plugin
+ * runs standalone (injecting the style section itself).
+ * @module dsh-output-styles/coexist
+ */
+
+import type { Context } from '@deepseek-ai/cordis'
+
+/** The reserved service name a core `outputStyles` capability publishes. */
+export const CORE_OUTPUT_STYLES_SERVICE = 'outputStyles'
+
+/**
+ * Probe whether a core `outputStyles` capability is composed.
+ * @param ctx - the plugin-scoped context.
+ * @returns true when the core `outputStyles` service seam is present.
+ */
+export function detectCoreOutputStyles(ctx: Context): boolean {
+  return ctx.get(CORE_OUTPUT_STYLES_SERVICE) !== undefined
+}
+
+/** The coexistence mode: standalone owns injection; degraded leaves it to core. */
+export type CoexistenceMode = 'standalone' | 'degraded'
+
+/** A runnable coexistence check: what this plugin contributes under the current composition. */
+export interface CoexistenceReport {
+  /** Whether a core `outputStyles` capability was detected. */
+  readonly coreActive: boolean
+  /** The effective coexistence mode. */
+  readonly mode: CoexistenceMode
+  /** Whether this plugin injects the style system-prompt section. */
+  readonly promptInjection: 'enabled' | 'disabled'
+  /** The incremental surfaces this plugin always retains. */
+  readonly retained: readonly string[]
+  /** What this plugin disabled to avoid duplicating the core. */
+  readonly disabled: readonly string[]
+}
+
+/** The incremental surfaces that survive coexistence in either mode. */
+const RETAINED = ['hot-switch', 'rules', 'export'] as const
+
+/**
+ * Compute the coexistence report for one composition. Respecting the core is
+ * the default (`respectCore` true); a deployment can force standalone mode by
+ * setting `respectCoreOutputStyles: false`.
+ * @param ctx - the plugin-scoped context.
+ * @param respectCore - whether to honor a detected core capability (default true).
+ * @returns the coexistence report.
+ */
+export function coexistenceReport(ctx: Context, respectCore = true): CoexistenceReport {
+  const coreActive = respectCore && detectCoreOutputStyles(ctx)
+  return {
+    coreActive,
+    mode: coreActive ? 'degraded' : 'standalone',
+    promptInjection: coreActive ? 'disabled' : 'enabled',
+    retained: [...RETAINED],
+    disabled: coreActive ? ['system-prompt injection'] : [],
+  }
+}

package/src/config.ts

@@ -63,6 +63,13 @@ export interface Config {
   rules?: StyleRuleConfig[]
   /** Register the `/export` command (Markdown/HTML session-export, renderer-aware). */
   enableExport?: boolean
+  /**
+   * Honor a detected core `outputStyles` capability: when true (default) and
+   * the core service is composed, this plugin skips its own system-prompt
+   * injection (hot-switch / rules / export stay active). Set false to always
+   * inject regardless.
+   */
+  respectCoreOutputStyles?: boolean
 }
 
 /** Configuration after defaults have been resolved. */
@@ -87,6 +94,8 @@ export interface ResolvedConfig {
   rules: Array<{ match: { tool?: string; contentType?: 'text' | 'markdown' | 'html'; session?: string }; style: string; priority: number }>
   /** Whether the `/export` command registers. */
   enableExport: boolean
+  /** Whether a detected core `outputStyles` capability disables prompt injection. */
+  respectCoreOutputStyles: boolean
 }
 
 /** Loader-visible configuration schema and defaults. */
@@ -109,6 +118,7 @@ export const Config: z<Config> = z.object({
     priority: z.number().required(false),
   })).default([]),
   enableExport: z.boolean().default(true),
+  respectCoreOutputStyles: z.boolean().default(true),
 })
 
 /**
@@ -155,5 +165,6 @@ export function resolveConfig(config: Config, defaultStylesDir: string): Resolve
     watchStyles: config.watchStyles ?? true,
     rules: (config.rules ?? []).map(rule => ({ ...rule, priority: rule.priority ?? 0 })),
     enableExport: config.enableExport ?? true,
+    respectCoreOutputStyles: config.respectCoreOutputStyles ?? true,
   }
 }

package/src/index.ts

@@ -21,6 +21,8 @@ export const inject = ['systemPrompt', 'storageDomain']
 
 export { Config, resolveConfig } from './config.ts'
 export type { ResolvedConfig } from './config.ts'
+export { CORE_OUTPUT_STYLES_SERVICE, coexistenceReport, detectCoreOutputStyles } from './coexist.ts'
+export type { CoexistenceMode, CoexistenceReport } from './coexist.ts'
 export { apply, DEFAULT_STYLES_DIR, OutputStyleRuntime, STYLE_SECTION_NAME } from './runtime.ts'
 export {
   applyStyleEvent,