@wingsbutterfly/dsh-rtk 0.1.0

package/lib/config.d.ts

@@ -0,0 +1,243 @@
+import z from '@deepseek-ai/schemastery';
+/**
+ * How bash commands are handled.
+ *
+ * - `rewrite` — a command with an RTK equivalent is replaced before it runs.
+ * - `suggest` — the command runs unchanged; the rewrite is only reported.
+ */
+export type RtkMode = 'rewrite' | 'suggest';
+/** Source-code filtering strength applied to `read` output. */
+export type SourceCodeFilteringLevel = 'none' | 'minimal' | 'aggressive';
+/** Line-based truncation for `read` output. */
+export interface SmartTruncateConfig {
+    enabled: boolean;
+    maxLines: number;
+}
+/** Final character-budget enforcement applied to every compacted text. */
+export interface TruncateConfig {
+    enabled: boolean;
+    maxChars: number;
+}
+/** Lossy compaction for `read` output; off by default so code reads stay exact. */
+export interface ReadCompactionConfig {
+    enabled: boolean;
+}
+/** The output-compaction pipeline's switches. */
+export interface OutputCompactionConfig {
+    enabled: boolean;
+    stripAnsi: boolean;
+    readCompaction: ReadCompactionConfig;
+    sourceCodeFilteringEnabled: boolean;
+    preserveExactSkillReads: boolean;
+    sourceCodeFiltering: SourceCodeFilteringLevel;
+    aggregateTestOutput: boolean;
+    filterBuildOutput: boolean;
+    compactGitOutput: boolean;
+    aggregateLinterOutput: boolean;
+    groupSearchOutput: boolean;
+    trackSavings: boolean;
+    /**
+     * Yield oversized results to the harness's own spill policy when it is
+     * mounted, instead of hard-truncating them first.
+     */
+    deferToHarnessSpill: boolean;
+    smartTruncate: SmartTruncateConfig;
+    truncate: TruncateConfig;
+}
+/** The plugin's fully-resolved configuration. */
+export interface RtkConfig {
+    enabled: boolean;
+    mode: RtkMode;
+    guardWhenRtkMissing: boolean;
+    showRewriteNotifications: boolean;
+    /** Whether a session is told once that rewriting is off because rtk is absent. */
+    notifyWhenRtkMissing: boolean;
+    /** Executable used for both `--version` probes and `rtk rewrite`. */
+    rtkExecutable: string;
+    /** Deadline for one `rtk rewrite` call. */
+    rewriteTimeoutMs: number;
+    /** Tools whose results pass through the compaction pipeline. */
+    compactedTools: string[];
+    outputCompaction: OutputCompactionConfig;
+}
+/** Defaults for every field; also the fallback when a layer omits one. */
+export declare const DEFAULT_CONFIG: RtkConfig;
+/** Bounds published in the configuration catalog and enforced during normalization. */
+export declare const BOUNDS: {
+    readonly maxLines: {
+        readonly min: 40;
+        readonly max: 4000;
+    };
+    readonly maxChars: {
+        readonly min: 1000;
+        readonly max: 200000;
+    };
+};
+/**
+ * The composition-facing configuration schema.
+ *
+ * Exported as both a value (the schemastery schema the loader validates and
+ * fills defaults with) and, through declaration merging, the resolved type.
+ * No explicit annotation is attached: `z.object` already infers the pair, and
+ * a hand-written one would have to restate every nested field.
+ */
+export declare const Config: z<Schemastery.ObjectS<{
+    enabled: z<boolean, boolean>;
+    mode: z<"rewrite" | "suggest", "rewrite" | "suggest">;
+    guardWhenRtkMissing: z<boolean, boolean>;
+    showRewriteNotifications: z<boolean, boolean>;
+    notifyWhenRtkMissing: z<boolean, boolean>;
+    rtkExecutable: z<string, string>;
+    rewriteTimeoutMs: z<number, number>;
+    compactedTools: z<string[], string[]>;
+    outputCompaction: z<Schemastery.ObjectS<{
+        enabled: z<boolean, boolean>;
+        stripAnsi: z<boolean, boolean>;
+        readCompaction: z<Schemastery.ObjectS<{
+            enabled: z<boolean, boolean>;
+        }>, Schemastery.ObjectT<{
+            enabled: z<boolean, boolean>;
+        }>>;
+        sourceCodeFilteringEnabled: z<boolean, boolean>;
+        preserveExactSkillReads: z<boolean, boolean>;
+        sourceCodeFiltering: z<"none" | "minimal" | "aggressive", "none" | "minimal" | "aggressive">;
+        aggregateTestOutput: z<boolean, boolean>;
+        filterBuildOutput: z<boolean, boolean>;
+        compactGitOutput: z<boolean, boolean>;
+        aggregateLinterOutput: z<boolean, boolean>;
+        groupSearchOutput: z<boolean, boolean>;
+        trackSavings: z<boolean, boolean>;
+        deferToHarnessSpill: z<boolean, boolean>;
+        smartTruncate: z<Schemastery.ObjectS<{
+            enabled: z<boolean, boolean>;
+            maxLines: z<number, number>;
+        }>, Schemastery.ObjectT<{
+            enabled: z<boolean, boolean>;
+            maxLines: z<number, number>;
+        }>>;
+        truncate: z<Schemastery.ObjectS<{
+            enabled: z<boolean, boolean>;
+            maxChars: z<number, number>;
+        }>, Schemastery.ObjectT<{
+            enabled: z<boolean, boolean>;
+            maxChars: z<number, number>;
+        }>>;
+    }>, Schemastery.ObjectT<{
+        enabled: z<boolean, boolean>;
+        stripAnsi: z<boolean, boolean>;
+        readCompaction: z<Schemastery.ObjectS<{
+            enabled: z<boolean, boolean>;
+        }>, Schemastery.ObjectT<{
+            enabled: z<boolean, boolean>;
+        }>>;
+        sourceCodeFilteringEnabled: z<boolean, boolean>;
+        preserveExactSkillReads: z<boolean, boolean>;
+        sourceCodeFiltering: z<"none" | "minimal" | "aggressive", "none" | "minimal" | "aggressive">;
+        aggregateTestOutput: z<boolean, boolean>;
+        filterBuildOutput: z<boolean, boolean>;
+        compactGitOutput: z<boolean, boolean>;
+        aggregateLinterOutput: z<boolean, boolean>;
+        groupSearchOutput: z<boolean, boolean>;
+        trackSavings: z<boolean, boolean>;
+        deferToHarnessSpill: z<boolean, boolean>;
+        smartTruncate: z<Schemastery.ObjectS<{
+            enabled: z<boolean, boolean>;
+            maxLines: z<number, number>;
+        }>, Schemastery.ObjectT<{
+            enabled: z<boolean, boolean>;
+            maxLines: z<number, number>;
+        }>>;
+        truncate: z<Schemastery.ObjectS<{
+            enabled: z<boolean, boolean>;
+            maxChars: z<number, number>;
+        }>, Schemastery.ObjectT<{
+            enabled: z<boolean, boolean>;
+            maxChars: z<number, number>;
+        }>>;
+    }>>;
+}>, Schemastery.ObjectT<{
+    enabled: z<boolean, boolean>;
+    mode: z<"rewrite" | "suggest", "rewrite" | "suggest">;
+    guardWhenRtkMissing: z<boolean, boolean>;
+    showRewriteNotifications: z<boolean, boolean>;
+    notifyWhenRtkMissing: z<boolean, boolean>;
+    rtkExecutable: z<string, string>;
+    rewriteTimeoutMs: z<number, number>;
+    compactedTools: z<string[], string[]>;
+    outputCompaction: z<Schemastery.ObjectS<{
+        enabled: z<boolean, boolean>;
+        stripAnsi: z<boolean, boolean>;
+        readCompaction: z<Schemastery.ObjectS<{
+            enabled: z<boolean, boolean>;
+        }>, Schemastery.ObjectT<{
+            enabled: z<boolean, boolean>;
+        }>>;
+        sourceCodeFilteringEnabled: z<boolean, boolean>;
+        preserveExactSkillReads: z<boolean, boolean>;
+        sourceCodeFiltering: z<"none" | "minimal" | "aggressive", "none" | "minimal" | "aggressive">;
+        aggregateTestOutput: z<boolean, boolean>;
+        filterBuildOutput: z<boolean, boolean>;
+        compactGitOutput: z<boolean, boolean>;
+        aggregateLinterOutput: z<boolean, boolean>;
+        groupSearchOutput: z<boolean, boolean>;
+        trackSavings: z<boolean, boolean>;
+        deferToHarnessSpill: z<boolean, boolean>;
+        smartTruncate: z<Schemastery.ObjectS<{
+            enabled: z<boolean, boolean>;
+            maxLines: z<number, number>;
+        }>, Schemastery.ObjectT<{
+            enabled: z<boolean, boolean>;
+            maxLines: z<number, number>;
+        }>>;
+        truncate: z<Schemastery.ObjectS<{
+            enabled: z<boolean, boolean>;
+            maxChars: z<number, number>;
+        }>, Schemastery.ObjectT<{
+            enabled: z<boolean, boolean>;
+            maxChars: z<number, number>;
+        }>>;
+    }>, Schemastery.ObjectT<{
+        enabled: z<boolean, boolean>;
+        stripAnsi: z<boolean, boolean>;
+        readCompaction: z<Schemastery.ObjectS<{
+            enabled: z<boolean, boolean>;
+        }>, Schemastery.ObjectT<{
+            enabled: z<boolean, boolean>;
+        }>>;
+        sourceCodeFilteringEnabled: z<boolean, boolean>;
+        preserveExactSkillReads: z<boolean, boolean>;
+        sourceCodeFiltering: z<"none" | "minimal" | "aggressive", "none" | "minimal" | "aggressive">;
+        aggregateTestOutput: z<boolean, boolean>;
+        filterBuildOutput: z<boolean, boolean>;
+        compactGitOutput: z<boolean, boolean>;
+        aggregateLinterOutput: z<boolean, boolean>;
+        groupSearchOutput: z<boolean, boolean>;
+        trackSavings: z<boolean, boolean>;
+        deferToHarnessSpill: z<boolean, boolean>;
+        smartTruncate: z<Schemastery.ObjectS<{
+            enabled: z<boolean, boolean>;
+            maxLines: z<number, number>;
+        }>, Schemastery.ObjectT<{
+            enabled: z<boolean, boolean>;
+            maxLines: z<number, number>;
+        }>>;
+        truncate: z<Schemastery.ObjectS<{
+            enabled: z<boolean, boolean>;
+            maxChars: z<number, number>;
+        }>, Schemastery.ObjectT<{
+            enabled: z<boolean, boolean>;
+            maxChars: z<number, number>;
+        }>>;
+    }>>;
+}>>;
+/**
+ * Normalize arbitrary configuration into a complete {@link RtkConfig}.
+ *
+ * The loader already validates the composition's `config:` block, but this
+ * entry is also reachable from tests, from `apply()` called directly, and from
+ * a runtime patch, so every field is re-derived rather than trusted. Numbers
+ * are clamped to {@link BOUNDS} so a hand-edited value cannot disable the
+ * pipeline's safeguards by accident.
+ */
+export declare function normalizeConfig(raw: unknown): RtkConfig;
+//# sourceMappingURL=config.d.ts.map

package/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAExC;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG,SAAS,GAAG,SAAS,CAAA;AAE3C,+DAA+D;AAC/D,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,SAAS,GAAG,YAAY,CAAA;AAExE,+CAA+C;AAC/C,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,0EAA0E;AAC1E,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,mFAAmF;AACnF,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,iDAAiD;AACjD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,OAAO,CAAA;IAClB,cAAc,EAAE,oBAAoB,CAAA;IACpC,0BAA0B,EAAE,OAAO,CAAA;IACnC,uBAAuB,EAAE,OAAO,CAAA;IAChC,mBAAmB,EAAE,wBAAwB,CAAA;IAC7C,mBAAmB,EAAE,OAAO,CAAA;IAC5B,iBAAiB,EAAE,OAAO,CAAA;IAC1B,gBAAgB,EAAE,OAAO,CAAA;IACzB,qBAAqB,EAAE,OAAO,CAAA;IAC9B,iBAAiB,EAAE,OAAO,CAAA;IAC1B,YAAY,EAAE,OAAO,CAAA;IACrB;;;OAGG;IACH,mBAAmB,EAAE,OAAO,CAAA;IAC5B,aAAa,EAAE,mBAAmB,CAAA;IAClC,QAAQ,EAAE,cAAc,CAAA;CACzB;AAED,iDAAiD;AACjD,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,OAAO,CAAA;IACb,mBAAmB,EAAE,OAAO,CAAA;IAC5B,wBAAwB,EAAE,OAAO,CAAA;IACjC,kFAAkF;IAClF,oBAAoB,EAAE,OAAO,CAAA;IAC7B,qEAAqE;IACrE,aAAa,EAAE,MAAM,CAAA;IACrB,2CAA2C;IAC3C,gBAAgB,EAAE,MAAM,CAAA;IACxB,gEAAgE;IAChE,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,gBAAgB,EAAE,sBAAsB,CAAA;CACzC;AAED,0EAA0E;AAC1E,eAAO,MAAM,cAAc,EAAE,SAsC5B,CAAA;AAID,uFAAuF;AACvF,eAAO,MAAM,MAAM;;;;;;;;;CAGT,CAAA;AAEV;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDjB,CAAA;AAyBF;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAkDvD"}

package/lib/config.js

@@ -0,0 +1,183 @@
+import z from '@deepseek-ai/schemastery';
+/** Defaults for every field; also the fallback when a layer omits one. */
+export const DEFAULT_CONFIG = {
+    enabled: true,
+    mode: 'rewrite',
+    guardWhenRtkMissing: true,
+    // Deliberately off, unlike pi-rtk-optimizer's equivalent flag. There the
+    // notice is a TUI toast; here it is appended to the tool result, so it would
+    // sit in the model's context on every rewritten call. The saving is the
+    // point of the plugin, and `/rtk stats` already reports what happened.
+    showRewriteNotifications: false,
+    // On: a missing binary is the one condition that silently costs the user the
+    // whole feature. The notice is emitted once per session, so its cost is
+    // bounded even though it is on by default.
+    notifyWhenRtkMissing: true,
+    rtkExecutable: 'rtk',
+    rewriteTimeoutMs: 3000,
+    compactedTools: ['bash', 'read', 'grep'],
+    outputCompaction: {
+        enabled: true,
+        stripAnsi: true,
+        readCompaction: { enabled: false },
+        sourceCodeFilteringEnabled: false,
+        preserveExactSkillReads: false,
+        sourceCodeFiltering: 'none',
+        aggregateTestOutput: true,
+        filterBuildOutput: true,
+        compactGitOutput: true,
+        aggregateLinterOutput: true,
+        groupSearchOutput: true,
+        trackSavings: true,
+        // The harness spill policy truncates recoverably (full output on disk,
+        // head/tail preview inline); this plugin's hard truncation does not. It
+        // also runs first, so at 12 000 characters it fires far below spill's
+        // threshold and spill never sees a large result. Deferring is the default;
+        // `false` keeps this plugin's own bound even when spill is mounted.
+        deferToHarnessSpill: true,
+        smartTruncate: { enabled: false, maxLines: 220 },
+        truncate: { enabled: true, maxChars: 12000 },
+    },
+};
+const SOURCE_CODE_FILTERING_LEVELS = ['none', 'minimal', 'aggressive'];
+/** Bounds published in the configuration catalog and enforced during normalization. */
+export const BOUNDS = {
+    maxLines: { min: 40, max: 4000 },
+    maxChars: { min: 1000, max: 200000 },
+};
+/**
+ * The composition-facing configuration schema.
+ *
+ * Exported as both a value (the schemastery schema the loader validates and
+ * fills defaults with) and, through declaration merging, the resolved type.
+ * No explicit annotation is attached: `z.object` already infers the pair, and
+ * a hand-written one would have to restate every nested field.
+ */
+export const Config = z.object({
+    enabled: z.boolean().default(DEFAULT_CONFIG.enabled).description('Master switch for command rewriting and output compaction.'),
+    mode: z
+        .union([z.const('rewrite'), z.const('suggest')])
+        .default(DEFAULT_CONFIG.mode)
+        .description('`rewrite` replaces a supported command; `suggest` only reports the equivalent.'),
+    guardWhenRtkMissing: z
+        .boolean()
+        .default(DEFAULT_CONFIG.guardWhenRtkMissing)
+        .description('Run the original command unchanged when the rtk executable is unavailable.'),
+    showRewriteNotifications: z
+        .boolean()
+        .default(DEFAULT_CONFIG.showRewriteNotifications)
+        .description('Record rewrite decisions so they are visible in the session log.'),
+    notifyWhenRtkMissing: z
+        .boolean()
+        .default(DEFAULT_CONFIG.notifyWhenRtkMissing)
+        .description('Tell each session once that command rewriting is off because rtk is not installed.'),
+    rtkExecutable: z.string().default(DEFAULT_CONFIG.rtkExecutable).description('Executable name or path for rtk.'),
+    rewriteTimeoutMs: z.natural().default(DEFAULT_CONFIG.rewriteTimeoutMs).description('Deadline in milliseconds for one `rtk rewrite` call.'),
+    compactedTools: z
+        .array(z.string())
+        .default([...DEFAULT_CONFIG.compactedTools])
+        .description('Tool names whose text results pass through the compaction pipeline.'),
+    outputCompaction: z
+        .object({
+        enabled: z.boolean().default(true),
+        stripAnsi: z.boolean().default(true),
+        readCompaction: z.object({ enabled: z.boolean().default(false) }),
+        sourceCodeFilteringEnabled: z.boolean().default(false),
+        preserveExactSkillReads: z.boolean().default(false),
+        sourceCodeFiltering: z
+            .union([z.const('none'), z.const('minimal'), z.const('aggressive')])
+            .default(DEFAULT_CONFIG.outputCompaction.sourceCodeFiltering),
+        aggregateTestOutput: z.boolean().default(true),
+        filterBuildOutput: z.boolean().default(true),
+        compactGitOutput: z.boolean().default(true),
+        aggregateLinterOutput: z.boolean().default(true),
+        groupSearchOutput: z.boolean().default(true),
+        trackSavings: z.boolean().default(true),
+        deferToHarnessSpill: z.boolean().default(true),
+        smartTruncate: z.object({
+            enabled: z.boolean().default(false),
+            maxLines: z.natural().default(DEFAULT_CONFIG.outputCompaction.smartTruncate.maxLines),
+        }),
+        truncate: z.object({
+            enabled: z.boolean().default(true),
+            maxChars: z.natural().default(DEFAULT_CONFIG.outputCompaction.truncate.maxChars),
+        }),
+    })
+        .default(DEFAULT_CONFIG.outputCompaction),
+});
+function asRecord(value) {
+    return typeof value === 'object' && value !== null ? value : {};
+}
+function pickBoolean(value, fallback) {
+    return typeof value === 'boolean' ? value : fallback;
+}
+function pickNumber(value, fallback, min, max) {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return fallback;
+    return Math.min(max, Math.max(min, Math.floor(value)));
+}
+function pickString(value, fallback) {
+    return typeof value === 'string' && value.trim() ? value : fallback;
+}
+function pickStringList(value, fallback) {
+    if (!Array.isArray(value))
+        return [...fallback];
+    const names = value.filter((entry) => typeof entry === 'string' && entry.trim().length > 0);
+    return names.length > 0 ? names : [...fallback];
+}
+/**
+ * Normalize arbitrary configuration into a complete {@link RtkConfig}.
+ *
+ * The loader already validates the composition's `config:` block, but this
+ * entry is also reachable from tests, from `apply()` called directly, and from
+ * a runtime patch, so every field is re-derived rather than trusted. Numbers
+ * are clamped to {@link BOUNDS} so a hand-edited value cannot disable the
+ * pipeline's safeguards by accident.
+ */
+export function normalizeConfig(raw) {
+    const root = asRecord(raw);
+    const compaction = asRecord(root.outputCompaction);
+    const readCompaction = asRecord(compaction.readCompaction);
+    const smartTruncate = asRecord(compaction.smartTruncate);
+    const truncate = asRecord(compaction.truncate);
+    const mode = root.mode === 'suggest' ? 'suggest' : 'rewrite';
+    const filtering = SOURCE_CODE_FILTERING_LEVELS.includes(compaction.sourceCodeFiltering)
+        ? compaction.sourceCodeFiltering
+        : DEFAULT_CONFIG.outputCompaction.sourceCodeFiltering;
+    return {
+        enabled: pickBoolean(root.enabled, DEFAULT_CONFIG.enabled),
+        mode,
+        guardWhenRtkMissing: pickBoolean(root.guardWhenRtkMissing, DEFAULT_CONFIG.guardWhenRtkMissing),
+        showRewriteNotifications: pickBoolean(root.showRewriteNotifications, DEFAULT_CONFIG.showRewriteNotifications),
+        notifyWhenRtkMissing: pickBoolean(root.notifyWhenRtkMissing, DEFAULT_CONFIG.notifyWhenRtkMissing),
+        rtkExecutable: pickString(root.rtkExecutable, DEFAULT_CONFIG.rtkExecutable),
+        rewriteTimeoutMs: pickNumber(root.rewriteTimeoutMs, DEFAULT_CONFIG.rewriteTimeoutMs, 100, 60000),
+        compactedTools: pickStringList(root.compactedTools, DEFAULT_CONFIG.compactedTools),
+        outputCompaction: {
+            enabled: pickBoolean(compaction.enabled, DEFAULT_CONFIG.outputCompaction.enabled),
+            stripAnsi: pickBoolean(compaction.stripAnsi, DEFAULT_CONFIG.outputCompaction.stripAnsi),
+            readCompaction: {
+                enabled: pickBoolean(readCompaction.enabled, DEFAULT_CONFIG.outputCompaction.readCompaction.enabled),
+            },
+            sourceCodeFilteringEnabled: pickBoolean(compaction.sourceCodeFilteringEnabled, DEFAULT_CONFIG.outputCompaction.sourceCodeFilteringEnabled),
+            preserveExactSkillReads: pickBoolean(compaction.preserveExactSkillReads, DEFAULT_CONFIG.outputCompaction.preserveExactSkillReads),
+            sourceCodeFiltering: filtering,
+            aggregateTestOutput: pickBoolean(compaction.aggregateTestOutput, DEFAULT_CONFIG.outputCompaction.aggregateTestOutput),
+            filterBuildOutput: pickBoolean(compaction.filterBuildOutput, DEFAULT_CONFIG.outputCompaction.filterBuildOutput),
+            compactGitOutput: pickBoolean(compaction.compactGitOutput, DEFAULT_CONFIG.outputCompaction.compactGitOutput),
+            aggregateLinterOutput: pickBoolean(compaction.aggregateLinterOutput, DEFAULT_CONFIG.outputCompaction.aggregateLinterOutput),
+            groupSearchOutput: pickBoolean(compaction.groupSearchOutput, DEFAULT_CONFIG.outputCompaction.groupSearchOutput),
+            trackSavings: pickBoolean(compaction.trackSavings, DEFAULT_CONFIG.outputCompaction.trackSavings),
+            deferToHarnessSpill: pickBoolean(compaction.deferToHarnessSpill, DEFAULT_CONFIG.outputCompaction.deferToHarnessSpill),
+            smartTruncate: {
+                enabled: pickBoolean(smartTruncate.enabled, DEFAULT_CONFIG.outputCompaction.smartTruncate.enabled),
+                maxLines: pickNumber(smartTruncate.maxLines, DEFAULT_CONFIG.outputCompaction.smartTruncate.maxLines, BOUNDS.maxLines.min, BOUNDS.maxLines.max),
+            },
+            truncate: {
+                enabled: pickBoolean(truncate.enabled, DEFAULT_CONFIG.outputCompaction.truncate.enabled),
+                maxChars: pickNumber(truncate.maxChars, DEFAULT_CONFIG.outputCompaction.truncate.maxChars, BOUNDS.maxChars.min, BOUNDS.maxChars.max),
+            },
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/lib/config.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,46 @@
+import type { Context } from '@deepseek-ai/cordis';
+import { Config, type RtkConfig } from './config.js';
+import { READ_COMPACTION_BANNER_PREFIX } from './compact/index.js';
+/** Cordis plugin name used by loader diagnostics. */
+export declare const name = "rtk";
+/**
+ * The tool runtime is a hard dependency: both halves of this plugin are
+ * `tools/*` listeners, and without the registry there is nothing to rewrite or
+ * compact.
+ *
+ * `settings` is declared too, and not because the plugin cannot run without it
+ * — it can, entirely from the composition's `config:` block. It is declared
+ * because the provider registers *asynchronously*: it reads the settings
+ * document first, so a plain `ctx.get('settings')` during `apply` can find
+ * nothing and the namespace silently never registers. Observed exactly that in
+ * production (`/rtk` reported "settings service unavailable" while a sibling
+ * `ctx.get('spillStore')` succeeded). Declaring it makes Cordis park this
+ * plugin until the provider appears, then activate it.
+ *
+ * `commands` and `systemPrompt` stay optional `ctx.get` lookups: they are
+ * registered early enough to be present, and a composition without them should
+ * still get the optimization.
+ */
+export declare const inject: string[];
+export { Config };
+/**
+ * Register RTK command rewriting and tool-output compaction.
+ *
+ * Both halves hang off the tool pipeline rather than wrapping a tool:
+ *
+ * - **Rewriting** rides `tools/execute`. The harness deliberately keeps
+ *   `tools/pre-execute` from mutating arguments (they are logged and presented
+ *   before dispatch), so the around-dispatch stage is the only seam where the
+ *   command that actually runs can differ from the one that was recorded. The
+ *   replacement is scoped to the call: the original arguments are restored as
+ *   soon as dispatch returns, so later pipeline stages and the session log see
+ *   what the model asked for.
+ * - **Compaction** rides `tools/post-execute`, which is the stage that may
+ *   replace result content.
+ *
+ * @param ctx - the agent-scoped context this row was mounted into.
+ * @param rawConfig - the row's `config:` block, already schema-validated.
+ */
+export declare function apply(ctx: Context, rawConfig: RtkConfig): void;
+export { READ_COMPACTION_BANNER_PREFIX };
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAOlD,OAAO,EAAE,MAAM,EAAmB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,EAAE,6BAA6B,EAAqB,MAAM,oBAAoB,CAAA;AAQrF,qDAAqD;AACrD,eAAO,MAAM,IAAI,QAAQ,CAAA;AAEzB;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,MAAM,UAAwB,CAAA;AAE3C,OAAO,EAAE,MAAM,EAAE,CAAA;AAwCjB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CA4S9D;AA8BD,OAAO,EAAE,6BAA6B,EAAE,CAAA"}