@treeseed/dsh-chapters 0.1.16 → 0.1.18

package/lib/preset.d.ts

@@ -0,0 +1,186 @@
+/**
+ * The `chapters` agent preset row — our implementation of the host's own
+ * `@deepseek-ai/dsh-agent-preset` declaration row, mounted from the bundle patch
+ * (`cordis.patch.yml`, row id `preset-chapters`), so the preset is a visible Loader entry
+ * exactly like `preset-standard` / `preset-ptc` rather than something a plugin does aside.
+ *
+ * WHY OUR ROW AND NOT THE HOST PACKAGE DIRECTLY
+ * --------------------------------------------
+ * A preset can be unusable in two ways and both are total: one unresolvable child row makes
+ * the WHOLE preset `broken` (`mountPreset` throws on any failed row → `record.broken` →
+ * `retain()` refuses with `agent-preset/invalid`), which is the same user-visible failure as
+ * a missing preset — every chapters session stops composing while its durable log sits there
+ * intact. Measured on the stable release with a composition copy-anchored to the alpha:
+ * `@deepseek-ai/dsh-tool-schedule` is not published at 0.2.0-rc.2 at all, and the boot said
+ * `preset "chapters" is DECLARED BUT BROKEN — tool-schedule … never started`.
+ *
+ * So this row does what the host's does, plus drop-what-will-not-load. It also refuses to
+ * brick a host predating the mechanism: a `@deepseek-ai/dsh-agent-preset` row is
+ * unresolvable before 0.1.7-alpha.1, and ONE unresolvable row aborts a legacy plugin tree
+ * (`plugin tree failed to load: … Cannot find package`), while a row naming our own package
+ * resolves wherever our package runs. The support floor is 0.2.0, so that is now
+ * belt-and-braces rather than the reason — and it is why the row plugin is ours.
+ *
+ * WHAT IS COPIED FROM THE HOST'S PLUGIN, LINE FOR LINE
+ * ---------------------------------------------------
+ *  - `static inject = ['agentPresets']` — the registry's shape, never a version test.
+ *  - `static [EntryGroup.key] = true` — "preserve child expressions until their own plugins
+ *    activate". Without it the Loader interpolates `!!js` against the HOST context, and
+ *    `disabled: !!js process.platform === 'win32'` stops belonging to the child row that
+ *    owns it.
+ *  - `[Service.init]` `yield`s the registry's disposer, so Cordis owns the registration's
+ *    lifetime. That also disposes of the trap the first draft fell into: calling
+ *    `ctx.effect(disposer)` from `apply()` fires when the apply FIBER finishes, which
+ *    un-registered the preset the instant it had been registered (measured on 0.2.0-rc.2:
+ *    `register()` reported success while the roster came back without `chapters`).
+ *
+ * @module dsh-chapters/src/preset
+ */
+import { Service } from '@deepseek-ai/cordis';
+import { EntryGroup } from '@deepseek-ai/cordis-plugin-loader';
+import z from '@deepseek-ai/schemastery';
+/** One mounted plugin row of a preset composition (the Loader's own shape). A group row
+ *  carries its children in `config`; an ordinary row carries a config map. */
+export interface PresetRow {
+    id: string;
+    name: string;
+    config?: Record<string, unknown> | PresetRow[];
+    disabled?: boolean;
+    group?: boolean;
+    isolate?: Record<string, boolean>;
+}
+/** The preset definition, in the shape `AgentPresetRegistry.register()` accepts — the host
+ *  plugin's own Config: id, name?, description?, order, plugins. */
+export interface PresetDefinition {
+    id: string;
+    name?: string;
+    description?: string;
+    order?: number;
+    plugins: PresetRow[];
+}
+/** The preset identity. `config.id` is DURABLE STATE: every continuation child's log
+ *  records it as `agent-preset/selected`, so renaming it orphans those sessions. */
+export declare const CHAPTERS_PRESET_ID = "chapters";
+/**
+ * Drop rows whose module cannot be imported, keeping the group structure intact.
+ *
+ * The probe is asked with the row's FULL specifier, so a package that still exists but no
+ * longer exports the subpath a row names (`…/tools`, `…/list-agents`) is caught too — those
+ * renames are what eat presets between host versions.
+ *
+ * @param rows the composition, groups included.
+ * @param resolvable asked with each row's module specifier. MUST NOT throw.
+ * @returns the composition to register, and every drop NAMED — a silent drop is how a
+ *          preset loses a tool nobody notices.
+ */
+export declare function pruneUnresolvableRows(rows: PresetRow[], resolvable: (specifier: string) => boolean): {
+    kept: PresetRow[];
+    dropped: string[];
+};
+/** What registering a preset can end up as. Every arm has its own log line and its own
+ *  remedy, because the silent case is the one that cost a human hours. */
+export type RegisterOutcome = {
+    state: 'registered';
+} | {
+    state: 'pruned';
+    dropped: string[];
+} | {
+    state: 'already-declared';
+} | {
+    state: 'unsupported';
+} | {
+    state: 'failed';
+    reason: string;
+};
+/** The narrow surface of `ctx.get('agentPresets')` this row uses. */
+export interface PresetRegistryLike {
+    register?: (definition: PresetDefinition) => Promise<() => Promise<void>>;
+    list?: () => Promise<unknown>;
+    /** `compositionInventory()` in `@deepseek-ai/dsh-agent-preset-registry`: every declared
+     *  preset with its mounted rows and their Loader states. */
+    compositionInventory?: () => Promise<unknown>;
+}
+/**
+ * Register a declared preset, dropping rows this host cannot import.
+ *
+ * Split out of the plugin class so every arm is unit-testable without a host: the caller
+ * hands in the registry surface and a resolver.
+ *
+ * @returns the outcome AND the disposer the registry hands back — the caller must keep it
+ *          alive for the row's lifetime, which is what yielding it from `[Service.init]`
+ *          does; nothing else has the right lifetime (see the module header).
+ */
+export declare function registerPrunedPreset(presets: PresetRegistryLike | undefined, definition: PresetDefinition, resolvable: (specifier: string) => boolean): Promise<{
+    outcome: RegisterOutcome;
+    disposer?: () => Promise<void>;
+}>;
+/** One mounted row of a live preset composition, as the host's inventory reports it.
+ *  `fiberState` is the Loader's state for that row; an enabled row that is not `active`
+ *  cannot serve a session, and the roster's `broken` flag reports that only for the whole
+ *  mount — which is why the witness asks for the rows as well. */
+export interface InventoryRow {
+    entryId?: string;
+    moduleName?: string;
+    enabled?: boolean;
+    fiberState?: string;
+}
+/** One preset's entry in a `compositionInventory()` response. */
+export interface InventoryEntry {
+    id?: string;
+    broken?: string;
+    rows?: InventoryRow[];
+}
+/** Find one preset in an inventory response, tolerating a missing or odd shape. */
+export declare function inventoryEntry(raw: unknown, presetId: string): InventoryEntry | undefined;
+/** Enabled rows of one preset that are not active. A row `pending` a host service can still
+ *  activate later, so this is reported apart from `broken` and never as a refusal. */
+export declare function unusableRows(entry: InventoryEntry | undefined): string[];
+/**
+ * Whether a module specifier can be imported from THIS package's resolution family.
+ *
+ * Two limits are the host's, not ours to paper over: a RELATIVE specifier resolves without
+ * touching the filesystem (so a file-URL row would always be reported resolvable — the
+ * composition uses package specifiers only, and the drift test pins that), and a name that
+ * resolves is not yet a name that ACTIVATES, which is what the roster line reports as
+ * `DECLARED BUT BROKEN`. Never throws: an unresolvable specifier is the answer.
+ */
+export declare function resolvableFromThisPackage(specifier: string): boolean;
+/** The narrow slice of the Cordis context this row needs. */
+interface RowCtx {
+    agentPresets: PresetRegistryLike;
+    logger?: {
+        info?: (m: string) => void;
+        warn?: (m: string) => void;
+    };
+}
+/**
+ * The declaration row. `config` IS the preset definition, exactly as the host's
+ * `AgentPreset` plugin consumes it, so a profile patch can override `preset-chapters`
+ * wholesale or `disabled: true` it — the two things a runtime registration done in
+ * `apply()` cannot offer, and the reason this is a row.
+ */
+export default class ChaptersPresetRow {
+    static inject: readonly ["agentPresets"];
+    /** Preserve child `!!js` expressions until their own plugins activate. */
+    static [EntryGroup.key]: boolean;
+    static Config: z<Schemastery.ObjectS<{
+        id: z<string, string>;
+        name: z<string, string>;
+        description: z<string, string>;
+        order: z<number, number>;
+        plugins: z<any[], any[]>;
+    }>, Schemastery.ObjectT<{
+        id: z<string, string>;
+        name: z<string, string>;
+        description: z<string, string>;
+        order: z<number, number>;
+        plugins: z<any[], any[]>;
+    }>>;
+    ctx: RowCtx;
+    config: PresetDefinition;
+    constructor(ctx: RowCtx, config: PresetDefinition);
+    /** Registers, then yields the disposer so Cordis owns the registration's lifetime — the
+     *  host's own row plugin does exactly this (`yield await this.ctx.agentPresets.register(…)`). */
+    [Service.init](): AsyncGenerator<() => Promise<void>, void>;
+}
+export {};

package/lib/preset.js

@@ -0,0 +1,212 @@
+/**
+ * The `chapters` agent preset row — our implementation of the host's own
+ * `@deepseek-ai/dsh-agent-preset` declaration row, mounted from the bundle patch
+ * (`cordis.patch.yml`, row id `preset-chapters`), so the preset is a visible Loader entry
+ * exactly like `preset-standard` / `preset-ptc` rather than something a plugin does aside.
+ *
+ * WHY OUR ROW AND NOT THE HOST PACKAGE DIRECTLY
+ * --------------------------------------------
+ * A preset can be unusable in two ways and both are total: one unresolvable child row makes
+ * the WHOLE preset `broken` (`mountPreset` throws on any failed row → `record.broken` →
+ * `retain()` refuses with `agent-preset/invalid`), which is the same user-visible failure as
+ * a missing preset — every chapters session stops composing while its durable log sits there
+ * intact. Measured on the stable release with a composition copy-anchored to the alpha:
+ * `@deepseek-ai/dsh-tool-schedule` is not published at 0.2.0-rc.2 at all, and the boot said
+ * `preset "chapters" is DECLARED BUT BROKEN — tool-schedule … never started`.
+ *
+ * So this row does what the host's does, plus drop-what-will-not-load. It also refuses to
+ * brick a host predating the mechanism: a `@deepseek-ai/dsh-agent-preset` row is
+ * unresolvable before 0.1.7-alpha.1, and ONE unresolvable row aborts a legacy plugin tree
+ * (`plugin tree failed to load: … Cannot find package`), while a row naming our own package
+ * resolves wherever our package runs. The support floor is 0.2.0, so that is now
+ * belt-and-braces rather than the reason — and it is why the row plugin is ours.
+ *
+ * WHAT IS COPIED FROM THE HOST'S PLUGIN, LINE FOR LINE
+ * ---------------------------------------------------
+ *  - `static inject = ['agentPresets']` — the registry's shape, never a version test.
+ *  - `static [EntryGroup.key] = true` — "preserve child expressions until their own plugins
+ *    activate". Without it the Loader interpolates `!!js` against the HOST context, and
+ *    `disabled: !!js process.platform === 'win32'` stops belonging to the child row that
+ *    owns it.
+ *  - `[Service.init]` `yield`s the registry's disposer, so Cordis owns the registration's
+ *    lifetime. That also disposes of the trap the first draft fell into: calling
+ *    `ctx.effect(disposer)` from `apply()` fires when the apply FIBER finishes, which
+ *    un-registered the preset the instant it had been registered (measured on 0.2.0-rc.2:
+ *    `register()` reported success while the roster came back without `chapters`).
+ *
+ * @module dsh-chapters/src/preset
+ */
+import { Service } from '@deepseek-ai/cordis';
+import { EntryGroup } from '@deepseek-ai/cordis-plugin-loader';
+import z from '@deepseek-ai/schemastery';
+/** The preset identity. `config.id` is DURABLE STATE: every continuation child's log
+ *  records it as `agent-preset/selected`, so renaming it orphans those sessions. */
+export const CHAPTERS_PRESET_ID = 'chapters';
+/** Whether a row's module must be probed at all. `cordis:` rows are pseudo-modules the
+ *  Loader always provides; our own package is by definition present — its realm row is the
+ *  whole point of the preset, and pruning it would quietly delete the feature. */
+function needsProbe(row) {
+    return !row.name.startsWith('cordis:') && !row.name.startsWith('@treeseed/dsh-chapters');
+}
+/**
+ * Drop rows whose module cannot be imported, keeping the group structure intact.
+ *
+ * The probe is asked with the row's FULL specifier, so a package that still exists but no
+ * longer exports the subpath a row names (`…/tools`, `…/list-agents`) is caught too — those
+ * renames are what eat presets between host versions.
+ *
+ * @param rows the composition, groups included.
+ * @param resolvable asked with each row's module specifier. MUST NOT throw.
+ * @returns the composition to register, and every drop NAMED — a silent drop is how a
+ *          preset loses a tool nobody notices.
+ */
+export function pruneUnresolvableRows(rows, resolvable) {
+    const dropped = [];
+    const keep = (row) => {
+        if (!needsProbe(row))
+            return true;
+        if (resolvable(row.name))
+            return true;
+        dropped.push(`${row.id} (${row.name})`);
+        return false;
+    };
+    const visit = (list) => list.flatMap((row) => {
+        if (row.group !== true || !Array.isArray(row.config))
+            return keep(row) ? [row] : [];
+        const children = row.config.filter(keep);
+        if (children.length === 0) {
+            dropped.push(`${row.id} (group emptied)`);
+            return [];
+        }
+        return [{ ...row, config: children }];
+    });
+    return { kept: visit(rows), dropped };
+}
+/**
+ * Register a declared preset, dropping rows this host cannot import.
+ *
+ * Split out of the plugin class so every arm is unit-testable without a host: the caller
+ * hands in the registry surface and a resolver.
+ *
+ * @returns the outcome AND the disposer the registry hands back — the caller must keep it
+ *          alive for the row's lifetime, which is what yielding it from `[Service.init]`
+ *          does; nothing else has the right lifetime (see the module header).
+ */
+export async function registerPrunedPreset(presets, definition, resolvable) {
+    if (typeof presets?.register !== 'function')
+        return { outcome: { state: 'unsupported' } };
+    const { kept, dropped } = pruneUnresolvableRows(definition.plugins, resolvable);
+    const pruned = { ...definition, plugins: kept };
+    let disposer;
+    try {
+        disposer = await presets.register(pruned);
+    }
+    catch (error) {
+        const reason = String(error?.message ?? error);
+        // A duplicate is not our failure: someone declared `chapters` themselves — a profile
+        // patch override is a legitimate choice. Their row wins; ours must not throw, because a
+        // row that fails to activate takes the preset with it, and the roster line with it.
+        if (/duplicate agent preset/i.test(reason))
+            return { outcome: { state: 'already-declared' } };
+        return { outcome: { state: 'failed', reason } };
+    }
+    return {
+        outcome: dropped.length > 0 ? { state: 'pruned', dropped } : { state: 'registered' },
+        disposer,
+    };
+}
+/** Find one preset in an inventory response, tolerating a missing or odd shape. */
+export function inventoryEntry(raw, presetId) {
+    return Array.isArray(raw) ? raw.find((entry) => entry?.id === presetId) : undefined;
+}
+/** Enabled rows of one preset that are not active. A row `pending` a host service can still
+ *  activate later, so this is reported apart from `broken` and never as a refusal. */
+export function unusableRows(entry) {
+    if (!Array.isArray(entry?.rows))
+        return [];
+    return entry.rows
+        .filter((row) => row.enabled !== false && typeof row.fiberState === 'string' && row.fiberState !== 'active')
+        .map((row) => `${row.entryId ?? '?'} (${row.moduleName ?? '?'}) ${row.fiberState}`);
+}
+/**
+ * Whether a module specifier can be imported from THIS package's resolution family.
+ *
+ * Two limits are the host's, not ours to paper over: a RELATIVE specifier resolves without
+ * touching the filesystem (so a file-URL row would always be reported resolvable — the
+ * composition uses package specifiers only, and the drift test pins that), and a name that
+ * resolves is not yet a name that ACTIVATES, which is what the roster line reports as
+ * `DECLARED BUT BROKEN`. Never throws: an unresolvable specifier is the answer.
+ */
+export function resolvableFromThisPackage(specifier) {
+    if (specifier.startsWith('.') || specifier.startsWith('/') || specifier.startsWith('file:'))
+        return true;
+    try {
+        import.meta.resolve(specifier);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The declaration row. `config` IS the preset definition, exactly as the host's
+ * `AgentPreset` plugin consumes it, so a profile patch can override `preset-chapters`
+ * wholesale or `disabled: true` it — the two things a runtime registration done in
+ * `apply()` cannot offer, and the reason this is a row.
+ */
+export default class ChaptersPresetRow {
+    static inject = ['agentPresets'];
+    /** Preserve child `!!js` expressions until their own plugins activate. */
+    static [EntryGroup.key] = true;
+    static Config = z.object({
+        id: z.string().required(),
+        name: z.string(),
+        description: z.string(),
+        order: z.number(),
+        plugins: z.array(z.any()).required(),
+    });
+    ctx;
+    config;
+    constructor(ctx, config) {
+        this.ctx = ctx;
+        this.config = config;
+    }
+    /** Registers, then yields the disposer so Cordis owns the registration's lifetime — the
+     *  host's own row plugin does exactly this (`yield await this.ctx.agentPresets.register(…)`). */
+    async *[Service.init]() {
+        const { outcome, disposer } = await registerPrunedPreset(this.ctx.agentPresets, this.config, resolvableFromThisPackage);
+        const log = (message, warn) => {
+            // `ctx.logger` alone is invisible to a headless `dsh web` (r19), so the loud arms go
+            // to stderr as well — a health line nobody reads is how the silent case survived.
+            if (warn) {
+                this.ctx.logger?.warn?.(message);
+                console.error(message);
+            }
+            else
+                this.ctx.logger?.info?.(message);
+        };
+        if (outcome.state === 'unsupported') {
+            // Pre-0.1.7 hosts have no register(). They are below the support floor, but saying so
+            // beats aborting their plugin tree over a row they cannot read.
+            log(`dsh-chapters: this host cannot register preset declaration rows (before 0.2.0) — the "${CHAPTERS_PRESET_ID}" preset cannot exist here; the chapters tools still work`, true);
+            return;
+        }
+        if (outcome.state === 'already-declared') {
+            log(`dsh-chapters: preset "${this.config.id}" is also declared by another row — that one is kept, this bundle's copy stands down`, false);
+            return;
+        }
+        if (outcome.state === 'failed') {
+            log(`dsh-chapters: UNHEALTHY — registering the "${this.config.id}" preset was refused: ${outcome.reason} — every session choosing it will fail to compose`, true);
+            return;
+        }
+        if (outcome.state === 'pruned') {
+            log(`dsh-chapters: preset "${this.config.id}" registered — dropped ${outcome.dropped.length} row(s) this host cannot import: ${outcome.dropped.join(', ')} (one unresolvable row would make the whole preset broken, so they are gone rather than mounted)`, false);
+        }
+        else {
+            log(`dsh-chapters: preset "${this.config.id}" registered as a declaration row`, false);
+        }
+        if (disposer !== undefined)
+            yield disposer;
+    }
+}
+//# sourceMappingURL=preset.js.map

package/lib/preset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.js","sourceRoot":"","sources":["../src/preset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAC9D,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAuBxC;oFACoF;AACpF,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAA;AAE5C;;kFAEkF;AAClF,SAAS,UAAU,CAAC,GAAc;IAChC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAA;AAC1F,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAiB,EACjB,UAA0C;IAE1C,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,MAAM,IAAI,GAAG,CAAC,GAAc,EAAW,EAAE;QACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAA;QACjC,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA;QACrC,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,IAAI,GAAG,CAAC,CAAA;QACvC,OAAO,KAAK,CAAA;IACd,CAAC,CAAA;IACD,MAAM,KAAK,GAAG,CAAC,IAAiB,EAAe,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAe,EAAE;QAClF,IAAI,GAAG,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QACnF,MAAM,QAAQ,GAAI,GAAG,CAAC,MAAsB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACzD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,kBAAkB,CAAC,CAAA;YACzC,OAAO,EAAE,CAAA;QACX,CAAC;QACD,OAAO,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IACF,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAA;AACvC,CAAC;AAoBD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAuC,EACvC,UAA4B,EAC5B,UAA0C;IAE1C,IAAI,OAAO,OAAO,EAAE,QAAQ,KAAK,UAAU;QAAE,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,EAAE,CAAA;IACzF,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,qBAAqB,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;IAC/E,MAAM,MAAM,GAAG,EAAE,GAAG,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC/C,IAAI,QAA6B,CAAA;IACjC,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,MAAM,CAAE,KAAe,EAAE,OAAO,IAAI,KAAK,CAAC,CAAA;QACzD,qFAAqF;QACrF,wFAAwF;QACxF,oFAAoF;QACpF,IAAI,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,EAAE,CAAA;QAC7F,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAA;IACjD,CAAC;IACD,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE;QACpF,QAAQ;KACT,CAAA;AACH,CAAC;AAoBD,mFAAmF;AACnF,MAAM,UAAU,cAAc,CAAC,GAAY,EAAE,QAAgB;IAC3D,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,GAAwB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAC3G,CAAC;AAED;sFACsF;AACtF,MAAM,UAAU,YAAY,CAAC,KAAiC;IAC5D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;QAAE,OAAO,EAAE,CAAA;IAC1C,OAAQ,KAAK,CAAC,IAAuB;SAClC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,KAAK,KAAK,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,IAAI,GAAG,CAAC,UAAU,KAAK,QAAQ,CAAC;SAC3G,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,KAAK,GAAG,CAAC,UAAU,IAAI,GAAG,KAAK,GAAG,CAAC,UAAU,EAAE,CAAC,CAAA;AACvF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACzD,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAA;IACxG,IAAI,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QAC9B,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;AACH,CAAC;AAQD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,OAAO,iBAAiB;IACpC,MAAM,CAAC,MAAM,GAAG,CAAC,cAAc,CAAU,CAAA;IAEzC,0EAA0E;IAC1E,MAAM,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;IAE9B,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACvB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;KACrC,CAAC,CAAA;IAEF,GAAG,CAAQ;IACX,MAAM,CAAkB;IAExB,YAAY,GAAW,EAAE,MAAwB;QAC/C,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;QACd,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED;qGACiG;IACjG,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;QACnB,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,MAAM,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAA;QACvH,MAAM,GAAG,GAAG,CAAC,OAAe,EAAE,IAAa,EAAQ,EAAE;YACnD,qFAAqF;YACrF,kFAAkF;YAClF,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,CAAA;gBAChC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACxB,CAAC;;gBAAM,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,CAAA;QACzC,CAAC,CAAA;QACD,IAAI,OAAO,CAAC,KAAK,KAAK,aAAa,EAAE,CAAC;YACpC,sFAAsF;YACtF,gEAAgE;YAChE,GAAG,CAAC,yFAAyF,kBAAkB,2DAA2D,EAAE,IAAI,CAAC,CAAA;YACjL,OAAM;QACR,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,KAAK,kBAAkB,EAAE,CAAC;YACzC,GAAG,CAAC,yBAAyB,IAAI,CAAC,MAAM,CAAC,EAAE,sFAAsF,EAAE,KAAK,CAAC,CAAA;YACzI,OAAM;QACR,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/B,GAAG,CAAC,8CAA8C,IAAI,CAAC,MAAM,CAAC,EAAE,yBAAyB,OAAO,CAAC,MAAM,mDAAmD,EAAE,IAAI,CAAC,CAAA;YACjK,OAAM;QACR,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/B,GAAG,CAAC,yBAAyB,IAAI,CAAC,MAAM,CAAC,EAAE,0BAA0B,OAAO,CAAC,OAAO,CAAC,MAAM,oCAAoC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,kGAAkG,EAAE,KAAK,CAAC,CAAA;QACrQ,CAAC;aAAM,CAAC;YACN,GAAG,CAAC,yBAAyB,IAAI,CAAC,MAAM,CAAC,EAAE,mCAAmC,EAAE,KAAK,CAAC,CAAA;QACxF,CAAC;QACD,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,QAAQ,CAAA;IAC5C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/dsh-chapters",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "dsh plugin: verbatim chapter archive + zero-token index for small-context models",
   "type": "module",
   "license": "Apache-2.0",
@@ -13,7 +13,7 @@
     "./cordis.patch.yml": "./cordis.patch.yml",
     "./package.json": "./package.json",
     "./engine": "./lib/engine.js",
-    "./presets/*": "./presets/*",
+    "./preset": "./lib/preset.js",
     "./tools": "./lib/tools.js",
     "./store": "./lib/store.js",
     "./registry": "./lib/registry.js",
@@ -21,7 +21,6 @@
   },
   "files": [
     "lib",
-    "presets",
     "cordis.patch.yml",
     "docs",
     "README.md"
@@ -66,7 +65,8 @@
     "@deepseek-ai/dsh-home-paths": "*",
     "@deepseek-ai/dsh-storage-domain": "*",
     "@deepseek-ai/dsh-tools": "*",
-    "@deepseek-ai/schemastery": "*"
+    "@deepseek-ai/schemastery": "*",
+    "@deepseek-ai/cordis-plugin-loader": "*"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/cordis": {
@@ -89,6 +89,9 @@
     },
     "@deepseek-ai/dsh-home-paths": {
       "optional": true
+    },
+    "@deepseek-ai/cordis-plugin-loader": {
+      "optional": true
     }
   },
   "devDependencies": {
@@ -113,7 +116,8 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "tsdown": "^0.22.2",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.4"
   },
   "dependencies": {
     "isomorphic-git": "^1.42.2",