dsh-output-styles 0.2.0

package/lib/types/invariant.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Package-owned invariant companion for `dsh-output-styles`.
+ *
+ * Two post-commit diagnostic checks over the events this plugin's write path
+ * produces (both target events are committed before dispatch, so a violation
+ * is reported — via the host registry's `fail` — rather than vetoed):
+ *
+ * 1. Every `output_style`/`selection` durable write carries this plugin's own
+ *    source marker and a legal style name; when the library is known,
+ *    the name must be a library member.
+ * 2. A successful `/style <name>` command has a matching selection record on
+ *    its session by the time its `command/done` settles, and `/style off`
+ *    leaves no record. The standalone companion (no library/domain handle)
+ *    skips this check.
+ *
+ * The main plugin registers a facts-bearing installer from its own context;
+ * the `./invariant` export is the standalone companion usable through a
+ * separate profile row.
+ * @module dsh-output-styles/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { SessionId } from '@deepseek-ai/dsh-session';
+/** Full npm package name owning the reported failures. */
+export declare const PACKAGE_NAME = "dsh-output-styles";
+/** A package-attributed invariant failure reported by the host registry. */
+export type InvariantFailure = (message: string) => never;
+/** Facts the installer needs beyond the event stream. */
+export interface InvariantFacts {
+    /** Library style names, or undefined when the companion has no library handle. */
+    knownStyles(): ReadonlySet<string> | undefined;
+    /** One session's durable selection record; absent disables the pairing check. */
+    selectionFor?(sessionId: SessionId): {
+        style: string;
+    } | undefined;
+}
+/** Installer callback accepted by the host's invariant registry. */
+export type InvariantInstaller = (ctx: Context, fail: InvariantFailure) => void | Promise<void>;
+/** Minimal runtime contract used by the companion without a source checkout. */
+export interface InvariantRegistry {
+    register(packageName: string, installer: InvariantInstaller): () => void;
+}
+/** Cordis companion plugin name. */
+export declare const name = "dsh-output-styles-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Build the installer over a facts source. The standalone companion and the
+ * main plugin share this body; only the facts differ.
+ * @param facts - library and domain access for the checks.
+ * @returns the installer the host registry activates in its child context.
+ */
+export declare function installInvariant(facts: InvariantFacts): InvariantInstaller;
+/**
+ * Register the standalone companion with envelope-only facts.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../../src/invariant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAyB,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAOhF,0DAA0D;AAC1D,eAAO,MAAM,YAAY,sBAAsB,CAAA;AAE/C,4EAA4E;AAC5E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,KAAK,CAAA;AAEzD,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,kFAAkF;IAClF,WAAW,IAAI,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAA;IAC9C,iFAAiF;IACjF,YAAY,CAAC,CAAC,SAAS,EAAE,SAAS,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CACnE;AAED,oEAAoE;AACpE,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAE/F,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAAA;CACzE;AAED,oCAAoC;AACpC,eAAO,MAAM,IAAI,gCAAgC,CAAA;AACjD,2EAA2E;AAC3E,eAAO,MAAM,MAAM,UAAiB,CAAA;AAapC;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,kBAAkB,CA8C1E;AAkBD;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,OAAO,KAAG,OAAO,CAAC,MAAM,IAAI,CAC+C,CAAA"}

package/lib/types/runtime.d.ts

@@ -0,0 +1,144 @@
+/**
+ * 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
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Session, SessionId } from '@deepseek-ai/dsh-session';
+import type { Domain } from '@deepseek-ai/dsh-storage-domain';
+import { type Config } from './config.ts';
+import { type OutputStyle } from './style-library.ts';
+import { OUTPUT_STYLE_DOMAIN, type StyleSelection } from './types.ts';
+/** Bundled style-library directory (package `styles/`), the lowest-priority `stylesDir` entry. */
+export declare const DEFAULT_STYLES_DIR: string;
+/** Prompt-section name; a fixed registry key a scoped composition could shadow. */
+export declare const STYLE_SECTION_NAME = "output-style:selection";
+/**
+ * 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.
+ */
+export declare class OutputStyleRuntime {
+    private readonly domain;
+    private library;
+    private forcedStyle;
+    private readonly selection;
+    private readonly defaultStyle;
+    private readonly maxStyleChars;
+    private readonly truncationMarker;
+    private projectDefault;
+    /** Style library in deterministic directory/file order. */
+    get styles(): ReadonlyMap<string, OutputStyle>;
+    /**
+     * @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: Domain<typeof OUTPUT_STYLE_DOMAIN>, styles: ReadonlyMap<string, OutputStyle>, options: {
+        readonly defaultStyle: string;
+        readonly maxStyleChars: number;
+        readonly truncationMarker: string;
+    });
+    /** Every switchable style name, in library order. */
+    get names(): readonly string[];
+    /** The forced style's name, or undefined when the library declares none. */
+    get forcedName(): string | undefined;
+    /**
+     * 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: ReadonlyMap<string, OutputStyle>): void;
+    /**
+     * 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: () => string): void;
+    /**
+     * Resolve one style by name.
+     * @param name - style name.
+     * @returns the style, or undefined when the library has none.
+     */
+    get(name: string): OutputStyle | undefined;
+    /**
+     * 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: SessionId): StyleSelection | undefined;
+    /**
+     * 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: SessionId): OutputStyle | undefined;
+    /**
+     * 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: SessionId): string;
+    /**
+     * 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: SessionId): string;
+    /**
+     * 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: SessionId): string;
+    /**
+     * 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: string): string;
+    /**
+     * 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.
+     */
+    select(session: Session, name: string): Promise<void>;
+    /**
+     * Remove a session's selection, restoring the configured default.
+     * @param session - the session whose selection is removed.
+     * @returns resolution after durability.
+     */
+    turnOff(session: Session): Promise<void>;
+    /**
+     * Close the opened domain (the plugin fiber's async disposer).
+     * @returns resolution after the backend unit is released.
+     */
+    close(): Promise<void>;
+}
+/**
+ * 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.
+ */
+export declare function apply(ctx: Context, config: Config): Promise<void>;
+//# sourceMappingURL=runtime.d.ts.map

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

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

package/lib/types/style-command.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Strict parsing of the `/style` command input and the pure projection fold
+ * over its logged lifecycle events.
+ *
+ * The handler and the session-projection unit share {@link parseStyleInput}:
+ * the projection folds exactly the inputs the handler accepts, so the
+ * displayed selection can never diverge from what the command did.
+ * @module dsh-output-styles/style-command
+ */
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+/** Command name registered on `ctx.commands`; also the log's `command/run` name. */
+export declare const STYLE_COMMAND = "style";
+/** One strict parse of a `/style` input line. */
+export type StyleInput = {
+    kind: 'none';
+} | {
+    kind: 'off';
+} | {
+    kind: 'switch';
+    name: string;
+};
+/**
+ * Parse the text after `/style` into one switch decision. The empty string
+ * is `none` — the handler treats it as the listing form, and the projection
+ * fold ignores it. Anything else is a switch: `off` restores the default,
+ * and every other input is one style name taken verbatim (style names may
+ * contain spaces, so the whole remainder is the candidate). Unknown names
+ * are rejected by the handler against the library, and the fold commits only
+ * what the handler reports as successful, so both sides agree on what
+ * actually switched.
+ * @param rawInput - verbatim text after the command name.
+ * @returns the decision; non-empty inputs other than `off` name a style.
+ */
+export declare function parseStyleInput(rawInput: string): StyleInput;
+/** Projection-fold state: the last settled selection plus the in-flight switch. */
+export interface StyleFoldState {
+    /** Accepted switch target that settled successfully, or null when the session's style was turned off. */
+    current: string | null;
+    /**
+     * One `/style` run that entered its handler but has not settled yet: its
+     * `command/run` claimed this slot and only its paired `command/done`
+     * resolves it. A failed or aborted run drops the target without touching
+     * `current`, so the folded state always mirrors what the write path actually
+     * committed.
+     */
+    pending: {
+        commandId: string;
+        target: {
+            name: string;
+        } | {
+            off: true;
+        };
+    } | null;
+}
+/** State for the empty log. */
+export declare const EMPTY_STYLE_STATE: StyleFoldState;
+/**
+ * One-event transition of the `style` projection unit. Only a successful
+ * `/style` command settles into `current`: `command/run` parks the target as
+ * `pending` and its paired `command/done` commits it on `kind: 'success'` or
+ * drops it otherwise. Every other event returns the same reference (the
+ * registry's change gate).
+ * @param state - the folded state before `event`.
+ * @param event - one committed session event.
+ * @returns the next state; the same reference when the event leaves it unchanged.
+ */
+export declare function applyStyleEvent(state: StyleFoldState, event: SessionEvent): StyleFoldState;
+//# sourceMappingURL=style-command.d.ts.map

package/lib/types/style-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-command.d.ts","sourceRoot":"","sources":["../../src/style-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAI5D,oFAAoF;AACpF,eAAO,MAAM,aAAa,UAAU,CAAA;AAEpC,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,GACf;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpC;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAK5D;AAED,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B,yGAAyG;IACzG,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB;;;;;;OAMG;IACH,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,GAAG;YAAE,GAAG,EAAE,IAAI,CAAA;SAAE,CAAA;KAAE,GAAG,IAAI,CAAA;CAChF;AAED,+BAA+B;AAC/B,eAAO,MAAM,iBAAiB,EAAE,cAAiD,CAAA;AAEjF;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,GAAG,cAAc,CAmB1F"}

package/lib/types/style-library.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Style-library loading: one style per `*.md` file (frontmatter + body),
+ * with optional Claude Code `outputStyles` JSON compatibility (single entry
+ * or an array of entries per file).
+ *
+ * A style file that does not parse is skipped with a warning; the plugin
+ * stays loadable. Structural ambiguity — a duplicate style name, a style
+ * named `off`, or two styles declaring `force` — fails the load because it
+ * would silently change which body gets injected.
+ * @module dsh-output-styles/style-library
+ */
+/** Character set for style names: letters, digits, spaces, and hyphens only. */
+export declare const STYLE_NAME_RE: RegExp;
+/**
+ * Whether a name is a legal style name and switch target: at least one
+ * letter or digit, only letters/digits/spaces/hyphens, and no leading or
+ * trailing space. Spaces are the only whitespace allowed, so a name is
+ * always a single switchable line the model can echo back. `off` passes this
+ * check but is a reserved target rejected by the library.
+ * @param name - candidate style name.
+ * @returns whether the name is legal.
+ */
+export declare function isValidStyleName(name: string): boolean;
+/** One loaded style: library metadata plus the raw injectable body. */
+export interface OutputStyle {
+    /** Switch target accepted by `/style`; letters, digits, spaces, and hyphens. */
+    readonly name: string;
+    /** One user-facing sentence on what the style does. */
+    readonly description: string;
+    /** Optional guidance on when the style is useful; shown in listings. */
+    readonly whenToUse?: string;
+    /** The raw directive injected into the system prompt, before truncation. */
+    readonly body: string;
+    /** Library file this style came from, relative to the style directory. */
+    readonly file: string;
+    /** Source format (`md` frontmatter or `json` compatibility entry). */
+    readonly format: 'md' | 'json';
+    /**
+     * Keep the harness prompt (identity, persona, tool guidance) when this
+     * style is active (Claude Code `keep-coding-instructions`). When false,
+     * the style replaces the whole system prompt; default false, matching
+     * Claude Code.
+     */
+    readonly keepCodingInstructions: boolean;
+    /** Apply this style unconditionally, overriding any session selection. */
+    readonly force: boolean;
+}
+/** Report a style file the loader skipped or a tolerated oddity. */
+type Warn = (message: string) => void;
+/**
+ * Load the style library from one or more directories. Later directories
+ * override earlier ones on a same-named style (the Claude Code
+ * "closest-to-the-working-directory wins" rule); duplicates within one
+ * directory still fail the load. Deterministic order: directories in the
+ * given order, files within a directory sorted by code unit.
+ * @param stylesDirs - absolute directories, lowest priority first.
+ * @param options.compatJson - whether `*.json` entries are loaded.
+ * @param warn - warning sink (skipped files, unknown frontmatter keys).
+ * @returns the library keyed by style name, in directory/file order.
+ * @throws when a directory is unreadable, a style is named `off`, two files
+ *   in one directory declare the same name, or two styles declare `force`.
+ */
+export declare function loadStyleLibrary(stylesDirs: readonly string[], options: {
+    readonly compatJson: boolean;
+}, warn: Warn): ReadonlyMap<string, OutputStyle>;
+/**
+ * Apply the style-body budget: bodies at most `maxChars` code points pass
+ * through; longer bodies are cut at the budget and closed with `marker` (the
+ * marker itself is not counted against the budget). The cut is code-point
+ * safe, so a multi-unit emoji is never split in half.
+ * @param body - the raw style body.
+ * @param maxChars - budget in code points; at least 1.
+ * @param marker - text appended at the truncation point.
+ * @returns the body as it will be injected.
+ */
+export declare function truncateStyle(body: string, maxChars: number, marker: string): string;
+export {};
+//# sourceMappingURL=style-library.d.ts.map

package/lib/types/style-library.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style-library.d.ts","sourceRoot":"","sources":["../../src/style-library.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,gFAAgF;AAChF,eAAO,MAAM,aAAa,QAAuB,CAAA;AAEjD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAItD;AAED,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM,CAAA;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAA;IACxC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAED,oEAAoE;AACpE,KAAK,IAAI,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;AAErC;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,OAAO,EAAE;IAAE,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAAE,EACzC,IAAI,EAAE,IAAI,GACT,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAclC;AA8OD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIpF"}

package/lib/types/types.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Durable domain vocabulary and type-table merges owned by this package.
+ *
+ * The selection domain is the single source of the per-session style choice;
+ * its record schema doubles as the durable validation boundary. The `style`
+ * projection key is declared here (its one home) and re-exported from the
+ * package root so consumers receive the `SessionProjectionMap` merge.
+ * @module dsh-output-styles/types
+ */
+import type { SessionId } from '@deepseek-ai/dsh-session';
+import { z as zod } from 'zod';
+/** The reserved switch target that removes a session's selection. */
+export declare const OFF = "off";
+/**
+ * Provenance marker stored with every selection record. It states who wrote
+ * the record, so a session's style choice can be attributed to this plugin
+ * when the log is rebuilt or audited.
+ */
+export declare const STYLE_SOURCE: {
+    readonly kind: "plugin";
+    readonly plugin: "dsh-output-styles";
+};
+/** One durable per-session selection record. */
+export declare const styleSelectionSchema: zod.ZodObject<{
+    style: zod.ZodString;
+    source: zod.ZodObject<{
+        kind: zod.ZodLiteral<"plugin">;
+        plugin: zod.ZodString;
+    }, zod.core.$strip>;
+}, zod.core.$strip>;
+/** Durable per-session selection record value. */
+export interface StyleSelection extends zod.infer<typeof styleSelectionSchema> {
+}
+/**
+ * The plugin's storage domain: one `selection` record per session, keyed by
+ * the session id. Versioned independently from the session log format.
+ */
+export declare const OUTPUT_STYLE_DOMAIN: {
+    name: string;
+    version: number;
+    tables: {
+        selection: import("@deepseek-ai/dsh-storage-domain").DomainTableSpec<SessionId, StyleSelection>;
+    };
+};
+/** One option a client renders for the `style` projection. */
+export interface StyleOption {
+    /** Switch target accepted by `/style`. */
+    value: string;
+    /** Human-readable style name; the style's own name when no label exists. */
+    name: string;
+    /** One user-facing sentence on what the style does. */
+    description: string;
+    /** Optional guidance on when the style is useful; shown in pickers and listings. */
+    whenToUse?: string | undefined;
+}
+/** Whole wire value of the `style` session projection. */
+export interface StyleSelectionView {
+    /** Every switchable style, in library order. */
+    options: StyleOption[];
+    /** Current selection, or null when the session has none. */
+    currentValue: string | null;
+}
+/** Validates the `style` projection's wire payload before it leaves the host. */
+export declare const styleSelectionViewSchema: zod.ZodObject<{
+    options: zod.ZodArray<zod.ZodObject<{
+        value: zod.ZodString;
+        name: zod.ZodString;
+        description: zod.ZodString;
+        whenToUse: zod.ZodOptional<zod.ZodString>;
+    }, zod.core.$strip>>;
+    currentValue: zod.ZodNullable<zod.ZodString>;
+}, zod.core.$strip>;
+declare module '@deepseek-ai/dsh-session-projection/types' {
+    interface SessionProjectionMap {
+        style: StyleSelectionView;
+    }
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACzD,OAAO,EAAE,CAAC,IAAI,GAAG,EAAE,MAAM,KAAK,CAAA;AAG9B,qEAAqE;AACrE,eAAO,MAAM,GAAG,QAAQ,CAAA;AAExB;;;;GAIG;AACH,eAAO,MAAM,YAAY;;;CAA2D,CAAA;AAEpF,gDAAgD;AAChD,eAAO,MAAM,oBAAoB;;;;;;mBAQ/B,CAAA;AAEF,kDAAkD;AAClD,MAAM,WAAW,cAAe,SAAQ,GAAG,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC;CAAG;AAEjF;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;CAM9B,CAAA;AAEF,8DAA8D;AAC9D,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAA;IACb,4EAA4E;IAC5E,IAAI,EAAE,MAAM,CAAA;IACZ,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAA;IACnB,oFAAoF;IACpF,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC/B;AAED,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,iFAAiF;AACjF,eAAO,MAAM,wBAAwB;;;;;;;;mBAQnC,CAAA;AAEF,OAAO,QAAQ,2CAA2C,CAAC;IACzD,UAAU,oBAAoB;QAC5B,KAAK,EAAE,kBAAkB,CAAA;KAC1B;CACF"}

package/package.json

@@ -0,0 +1,138 @@
+{
+  "name": "dsh-output-styles",
+  "version": "0.2.0",
+  "description": "Claude Code outputStyles-equivalent runtime output-style switching for DeepSeek Harness",
+  "type": "module",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PerryLink/dsh-output-styles.git"
+  },
+  "homepage": "https://github.com/PerryLink/dsh-output-styles#readme",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('lib',{recursive:true,force:true})\" && tsc -p tsconfig.json --noEmitOnError --pretty false && tsdown && tsdown -c tsdown.client.config.ts",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmitOnError --pretty false && tsc -p tsconfig.vitest.json --pretty false",
+    "verify:self-contained": "node scripts/verify-self-contained.mjs",
+    "prepare": "node scripts/prepare.mjs"
+  },
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/invariant-*.js",
+    "lib/client.js",
+    "lib/client-*.js",
+    "lib/types/**/*.d.ts",
+    "lib/types/**/*.d.ts.map",
+    "src",
+    "styles",
+    "cordis.patch.yml",
+    "LICENSE",
+    "README.md",
+    "README.zh.md",
+    "README.ja.md",
+    "README.ko.md",
+    "README.es.md",
+    "docs"
+  ],
+  "keywords": [
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "output-style",
+    "output-styles",
+    "claude-code"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-storage": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-storage-domain": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-storage-json": "0.1.0-rc.6",
+    "yaml": "^2.8.0",
+    "zod": "^4.4.3"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/schemastery": "^3.18.1",
+    "@deepseek-ai/dsh-session": ">=0.1.0-rc.6 <0.2.0",
+    "@deepseek-ai/dsh-session-projection": ">=0.1.0-rc.6 <0.2.0",
+    "@deepseek-ai/dsh-storage-domain": ">=0.1.0-rc.6 <0.2.0",
+    "@deepseek-ai/dsh-settings": ">=0.1.0-rc.6 <0.2.0"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-settings": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-api-remotes": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-runtime": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-commands": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-input-trigger": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-locale": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "4.0.1",
+    "@deepseek-ai/dsh-agent": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-api-remotes": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-attachment": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-brand": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-locale": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-commands": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-input-trigger": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-commands": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-llm": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-scope": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session-persistence": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-session-projection": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-settings": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-storage": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-storage-domain": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-storage-json": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-system-prompt": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-timeout": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-typert-protocol": "0.1.0-rc.6",
+    "@deepseek-ai/schemastery": "3.18.1",
+    "@types/node": "^22.20.0",
+    "tsdown": "^0.22.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  }
+}