dsh-super-code 0.3.4 → 0.3.6

package/docs/UsageGuide.md

@@ -24,6 +24,57 @@ The default guidance calls for parallel reads when useful, ordered writes, tests
 
 Batching reduces round trips between the model and tools. It does not guarantee that every operation runs faster or change model, permission, or memory settings.
 
+## 运行预算 · Runtime Budgets
+
+打开设置中的“Super Code 模式”（部分版本位于“插件”→“插件配置”）。顶部“预设状态”用于查看和安装预设；“上下文配置”用于调整预算。插件默认已使用此前 Pro 测试中的旧预算，无需手动填写。界面使用百分数和秒；括号内仍显示当前宿主的默认值，便于与输入框中的实际配置比较。
+
+Open “Super Code” in Settings (under “Plugins” → “Plugin configuration” in some versions). “Preset status” shows and installs the preset; “Context settings” contains the budgets. The plugin already uses the older Pro-test budgets without manual setup. The form uses percentages and seconds; parentheses still show the current host defaults for comparison with the effective values in the inputs.
+
+| 类型 / Type | 配置 / Settings | 生效范围 / Applies to |
+|---|---|---|
+| 通用预算 / Common budgets | 压缩比例、摘要上限、PTC 时限及重试次数 / Compression ratios, summary limit, PTC deadlines, and retries | 默认仅 Super Code；打开“同时应用到官方预设”后，也用于标准、PTC、极简、创造模式 / Super Code by default; also Standard, PTC, Minimal, and Create when “Also apply to official presets” is enabled |
+| Super Code 专属预算 / Super Code budgets | 活跃任务记录上限、任务记忆上下文容量 / Active task record limit and task-memory context capacity | 始终仅 Super Code / Always Super Code only |
+
+官方预设开关默认关闭，不影响自定义预设；开启后也只修改通用预算，不改变官方预设的工具和提示词。修改保存后对新建 Agent 生效，运行中的 Agent 保留原配置。切换顶部标签不会丢失尚未保存的输入。
+
+The official-preset switch is off by default and leaves custom presets untouched. When enabled, it changes only common budgets, preserving official tools and prompts. Saved changes apply to new Agents; running Agents keep their configuration. Switching tabs retains unsaved input.
+
+留空沿用插件默认预算；“恢复默认”会清除界面的覆盖，回到插件加载配置，未配置的字段使用旧预算。用户已保存的配置优先生效。保存失败时保留输入，若提示预算已在别处修改，先重新读取再调整。
+
+Leave fields blank to inherit plugin defaults. “Reset to defaults” clears UI overrides and restores the plugin configuration, using the older budgets for unconfigured fields. Saved user values take precedence. Failed saves retain your input. If budgets changed elsewhere, reload before editing again.
+
+也可以通过插件的 `budgets` 配置调整通用预算；将 `applyToOfficialPresets` 设为 `true` 可同时应用到上述四种官方预设。保存预算不会重启 Agent。
+
+You can also set common budgets in the plugin's `budgets` configuration. Set `applyToOfficialPresets: true` to include the four official presets above. Saving budgets does not restart Agents.
+
+旧宿主未提供 `ptcRuntime` 时，“批量工具执行”的时限输入框会禁用；压缩预算和任务记忆容量仍可设置。
+
+On older hosts without `ptcRuntime`, batch-tool deadline inputs are disabled; compression and task-memory budgets remain configurable.
+
+下面是插件已默认使用的旧预算，无需再将它手动添加到 `name: dsh-super-code` 的加载配置中。需要自定义时，可以在界面或加载项的 `config.budgets` 中修改对应字段。
+
+The plugin already uses these older budgets by default; there is no need to add them manually to the `dsh-super-code` entry. Customize individual fields in the UI or the entry's `config.budgets` when needed.
+
+```yaml
+budgets:
+  pressureBasis: window
+  thresholdRatio: 0.8
+  retainRatio: 0.16
+  summaryMaxTokens: 8192
+  compactionRetries: 1
+  maxOverflowRetries: 1
+  ptcTimeoutMs: 600000
+  ptcMaxTimeoutMs: 600000
+```
+
+`pressureBasis: window` 为插件默认，按完整上下文窗口计算；选择 `host` 则按当前宿主策略计算。`retainRatio` 必须小于 `thresholdRatio`。PTC 两项的单位是毫秒，包含工具等待时间；显式更短的调用期限仍然生效，上限不会超过宿主允许值。PTC 时间覆盖需要提供 `ptcRuntime` 的新版宿主；旧版的 CPU 忙碌计时与新版总耗时计时不能等同。这些配置不改变执行后端、权限或取消行为。
+
+`pressureBasis: window` is the plugin default and uses the full context window; choose `host` to follow the current host budget policy. `retainRatio` must be lower than `thresholdRatio`. PTC values are milliseconds, including tool waits; explicit shorter call deadlines still apply, and the host ceiling remains authoritative. PTC overrides require a newer host with `ptcRuntime`. The old busy-CPU timer and the new elapsed timer are different. These settings preserve the host execution backend, permissions, and cancellation.
+
+Super Code 专属的 `maxTasks`（默认 32）和 `maxContextBytes`（默认 32,768），分别控制会话中活跃任务记录数量和任务记忆上下文的字节预算。增加预算会占用更多上下文；通常保持默认即可。
+
+Super Code also has `maxTasks` (default 32) and `maxContextBytes` (default 32,768), which bound the active task records and task-memory context bytes per conversation. Larger budgets use more context; the defaults are usually sufficient.
+
 ## 找不到预设 · Can't Find the Preset?
 
 先确认插件已启用，并按[兼容矩阵](Compatibility.md)核对宿主版本与实际依赖。插件按宿主提供的预设机制选择以下两条路径。

package/lib/dsh/budget-settings.d.ts

@@ -0,0 +1,51 @@
+/** Persist UI overrides through Harness settings; Agents take creation-time snapshots. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { SettingsScope } from '@deepseek-ai/dsh-settings';
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import type { Configuration } from './budgets.js';
+interface SettingsWriter {
+    readonly writable: boolean;
+    describe(options: {
+        redactSecrets: boolean;
+    }): {
+        ns: string;
+        revision: number;
+    }[];
+    replace(namespace: string, config: object, revision: number): Promise<void>;
+}
+export interface BudgetSettingsSnapshot {
+    readonly configuration: Configuration;
+    readonly revision: number;
+    readonly writable: boolean;
+    readonly ptcMaxTimeoutMs: number | false;
+    readonly defaults: Configuration;
+}
+export type BudgetSettingsResult = {
+    readonly ok: true;
+    readonly snapshot: BudgetSettingsSnapshot;
+} | {
+    readonly ok: false;
+    readonly error: 'invalid' | 'conflict' | 'read-only' | 'ptc-unavailable' | 'ptc-ceiling' | 'save-failed';
+};
+export declare class BudgetSettings {
+    private readonly settings;
+    private readonly scope;
+    private readonly ptcCeiling;
+    private readonly key;
+    private readonly defaults;
+    constructor(settings: SettingsWriter, scope: Pick<SettingsScope<Configuration>, 'get'>, ptcCeiling: () => number | false, key?: string, defaults?: () => Configuration);
+    read(): BudgetSettingsSnapshot;
+    save(content: string, expected: string): Promise<BudgetSettingsResult>;
+    reset(expected: string): Promise<BudgetSettingsResult>;
+    private replace;
+}
+export declare class SuperCodeBudgets extends TypertRemoteService {
+    private readonly settings;
+    constructor(ctx: Context, settings: BudgetSettings);
+    readConfig(): BudgetSettingsSnapshot;
+    saveConfig(content: string, expected: string): Promise<BudgetSettingsResult>;
+    resetConfig(expected: string): Promise<BudgetSettingsResult>;
+}
+export declare function applyBudgetSettings(ctx: Context, config: Configuration): void;
+export {};
+//# sourceMappingURL=budget-settings.d.ts.map

package/lib/dsh/budget-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-settings.d.ts","sourceRoot":"","sources":["../../src/dsh/budget-settings.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,EAAU,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAE9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAKjD,UAAU,cAAc;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE;QAAE,aAAa,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACjF,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5E;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,KAAK,CAAA;IACxC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;CACjC;AACD,MAAM,MAAM,oBAAoB,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAA;CAAE,GAC/F;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,iBAAiB,GAAG,aAAa,GAAG,aAAa,CAAA;CAAE,CAAA;AAgBpI,qBAAa,cAAc;IACb,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAAkB,OAAO,CAAC,QAAQ,CAAC,KAAK;IAC3E,OAAO,CAAC,QAAQ,CAAC,UAAU;IAAwB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAFE,QAAQ,EAAE,cAAc,EAAmB,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,KAAK,CAAC,EACrG,UAAU,EAAE,MAAM,MAAM,GAAG,KAAK,EAAmB,GAAG,GAAE,MAAkB,EAC1E,QAAQ,GAAE,MAAM,aAA0B;IAE7D,IAAI,IAAI,sBAAsB;IAOxB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAgBtE,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;YAE9C,OAAO;CAUtB;AAED,qBAAa,gBAAiB,SAAQ,mBAAmB;IAC7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAvC,GAAG,EAAE,OAAO,EAAmB,QAAQ,EAAE,cAAc;IAEnE,UAAU,IAAI,sBAAsB;IAEpC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAE5E,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAC7D;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CA8C7E"}

package/lib/dsh/budget-settings.js

@@ -0,0 +1,188 @@
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+import { Remote, TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import { settingsConfigurationSchema, configurationValues, validateConfiguration } from './budgets.js';
+import { BasicCompactionEngine } from '@deepseek-ai/dsh-compaction-basic';
+const namespace = 'super-code-budgets';
+/** Keep the evaluated budgets independent of changes to the host's defaults. */
+function withLegacyBudgets(config, ptcCeiling) {
+    const maxTimeout = ptcCeiling === false ? false : Math.min(ptcCeiling, config.budgets?.ptcMaxTimeoutMs ?? Math.max(600000, config.budgets?.ptcTimeoutMs ?? 0));
+    return {
+        applyToOfficialPresets: false, maxTasks: 32, maxContextBytes: 32768, ...config,
+        budgets: { pressureBasis: 'window', thresholdRatio: 0.8, retainRatio: 0.16,
+            summaryMaxTokens: 8192, compactionRetries: 1, maxOverflowRetries: 1,
+            ...(maxTimeout === false ? {} : { ptcTimeoutMs: Math.min(600000, maxTimeout), ptcMaxTimeoutMs: maxTimeout }),
+            ...config.budgets,
+        },
+    };
+}
+export class BudgetSettings {
+    settings;
+    scope;
+    ptcCeiling;
+    key;
+    defaults;
+    constructor(settings, scope, ptcCeiling, key = namespace, defaults = () => ({})) {
+        this.settings = settings;
+        this.scope = scope;
+        this.ptcCeiling = ptcCeiling;
+        this.key = key;
+        this.defaults = defaults;
+    }
+    read() {
+        const descriptor = this.settings.describe({ redactSecrets: true }).find(row => row.ns === this.key);
+        if (!descriptor)
+            throw new Error('Super Code budget settings are unavailable');
+        return { configuration: structuredClone(this.scope.get()), revision: descriptor.revision,
+            writable: this.settings.writable, ptcMaxTimeoutMs: this.ptcCeiling(), defaults: structuredClone(this.defaults()) };
+    }
+    async save(content, expected) {
+        if (!this.settings.writable)
+            return { ok: false, error: 'read-only' };
+        let config;
+        try {
+            if (content.length > 4096)
+                throw new Error('Configuration is too large');
+            config = validateConfiguration(JSON.parse(content));
+        }
+        catch {
+            return { ok: false, error: 'invalid' };
+        }
+        const budgets = config.budgets;
+        if (budgets?.ptcTimeoutMs !== undefined || budgets?.ptcMaxTimeoutMs !== undefined) {
+            const ceiling = this.ptcCeiling();
+            if (ceiling === false)
+                return { ok: false, error: 'ptc-unavailable' };
+            if ((budgets.ptcTimeoutMs ?? 0) > ceiling || (budgets.ptcMaxTimeoutMs ?? 0) > ceiling)
+                return { ok: false, error: 'ptc-ceiling' };
+        }
+        return this.replace(config, expected);
+    }
+    async reset(expected) { return this.replace({}, expected); }
+    async replace(config, expected) {
+        if (!this.settings.writable)
+            return { ok: false, error: 'read-only' };
+        if (!/^(0|[1-9]\d*)$/.test(expected) || !Number.isSafeInteger(Number(expected)))
+            return { ok: false, error: 'invalid' };
+        try {
+            await this.settings.replace(this.key, config, Number(expected));
+            return { ok: true, snapshot: this.read() };
+        }
+        catch (error) {
+            return { ok: false, error: error.code === 'SETTINGS_CONFLICT' ? 'conflict' : 'save-failed' };
+        }
+    }
+}
+let SuperCodeBudgets = (() => {
+    let _classSuper = TypertRemoteService;
+    let _instanceExtraInitializers = [];
+    let _readConfig_decorators;
+    let _saveConfig_decorators;
+    let _resetConfig_decorators;
+    return class SuperCodeBudgets extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _readConfig_decorators = [Remote];
+            _saveConfig_decorators = [Remote];
+            _resetConfig_decorators = [Remote];
+            __esDecorate(this, null, _readConfig_decorators, { kind: "method", name: "readConfig", static: false, private: false, access: { has: obj => "readConfig" in obj, get: obj => obj.readConfig }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _saveConfig_decorators, { kind: "method", name: "saveConfig", static: false, private: false, access: { has: obj => "saveConfig" in obj, get: obj => obj.saveConfig }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(this, null, _resetConfig_decorators, { kind: "method", name: "resetConfig", static: false, private: false, access: { has: obj => "resetConfig" in obj, get: obj => obj.resetConfig }, metadata: _metadata }, null, _instanceExtraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        settings = __runInitializers(this, _instanceExtraInitializers);
+        constructor(ctx, settings) {
+            super(ctx, 'superCodeBudgets');
+            this.settings = settings;
+        }
+        readConfig() { return this.settings.read(); }
+        saveConfig(content, expected) { return this.settings.save(content, expected); }
+        resetConfig(expected) { return this.settings.reset(expected); }
+    };
+})();
+export { SuperCodeBudgets };
+export function applyBudgetSettings(ctx, config) {
+    const base = configurationValues(config);
+    const hostDefaults = new BasicCompactionEngine(ctx.isolate('compaction'), { auto: false }).config;
+    const snapshots = new WeakMap();
+    let timeout = false;
+    let read = () => configurationValues(config);
+    const source = {
+        get: () => withLegacyBudgets(read(), timeout ? timeout.maxMs : false),
+        forAgent(agent) {
+            let snapshot = snapshots.get(agent);
+            if (!snapshot) {
+                snapshot = structuredClone(source.get());
+                snapshots.set(agent, snapshot);
+            }
+            return structuredClone(snapshot);
+        },
+    };
+    ctx.provide('superCodeConfiguration', source);
+    ctx.inject(['ptcRuntime'], ready => {
+        const runtime = ready.get('ptcRuntime');
+        timeout = runtime.timeout ?? false;
+        ready.effect(() => () => { timeout = false; });
+    });
+    // Recent hosts retain a preset generation across Agents; plugin apply is not an Agent boundary.
+    ctx.on('agent/created', ({ agent }) => { source.forAgent(agent); });
+    ctx.inject(['settings'], owner => {
+        const settings = owner.settings;
+        let key = namespace;
+        if (typeof settings.register === 'function') {
+            const scope = settings.register(namespace, settingsConfigurationSchema, { base, validate: validateConfiguration });
+            read = () => structuredClone(scope.get());
+            owner.effect(() => () => { read = () => structuredClone(base); });
+        }
+        else {
+            // SettingsForms edits this Loader entry's volatile values without remounting Agents.
+            const forms = settings;
+            const entryId = ctx.fiber.entry?.options.id;
+            if (!entryId)
+                throw new Error('Super Code budgets require a profile plugin entry');
+            key = entryId;
+            owner.effect(() => forms.configure({ auto: false }, ctx.fiber));
+        }
+        new SuperCodeBudgets(owner, new BudgetSettings(settings, source, () => timeout ? timeout.maxMs : false, key, () => ({
+            applyToOfficialPresets: false, maxTasks: 32, maxContextBytes: 32768,
+            budgets: { pressureBasis: 'host', thresholdRatio: hostDefaults.thresholdRatio, retainRatio: hostDefaults.retainRatio,
+                summaryMaxTokens: hostDefaults.maxTokens, compactionRetries: hostDefaults.compactionRetries,
+                maxOverflowRetries: hostDefaults.maxOverflowRetries,
+                ...(timeout ? { ptcTimeoutMs: timeout.defaultMs, ptcMaxTimeoutMs: timeout.maxMs } : {}),
+            },
+        })));
+    });
+}
+//# sourceMappingURL=budget-settings.js.map

package/lib/dsh/budget-settings.js.map

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

package/lib/dsh/budgets.d.ts

@@ -0,0 +1,34 @@
+/** Optional policy overrides. Missing values remain owned by the host. */
+import z from '@deepseek-ai/schemastery';
+import type { Context } from '@deepseek-ai/cordis';
+declare global {
+    namespace Schemastery {
+        interface Meta<T = any> {
+            volatile?: boolean;
+        }
+    }
+}
+export interface Budgets {
+    readonly pressureBasis?: 'host' | 'window';
+    readonly thresholdRatio?: number;
+    readonly retainRatio?: number;
+    readonly summaryMaxTokens?: number;
+    readonly compactionRetries?: number;
+    readonly maxOverflowRetries?: number;
+    readonly ptcTimeoutMs?: number;
+    readonly ptcMaxTimeoutMs?: number;
+}
+export interface Configuration {
+    readonly applyToOfficialPresets?: boolean;
+    readonly budgets?: Budgets;
+    readonly maxTasks?: number;
+    readonly maxContextBytes?: number;
+}
+export declare const budgetSchema: z<Budgets>;
+export declare const settingsConfigurationSchema: z<Configuration>;
+export declare const configurationSchema: z<Configuration>;
+export declare function validateConfiguration(config: Configuration): Configuration;
+/** Newer Loader schemas expose volatile fields as references; older hosts return plain values. */
+export declare function configurationValues(config: Configuration): Configuration;
+export declare function configurationOf(ctx: Context, agent?: object): Configuration;
+//# sourceMappingURL=budgets.d.ts.map

package/lib/dsh/budgets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budgets.d.ts","sourceRoot":"","sources":["../../src/dsh/budgets.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAIlD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,WAAW,CAAC;QACpB,UAAU,IAAI,CAAC,CAAC,GAAG,GAAG;YAAI,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE;KAC/C;CACF;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IAC1C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAA;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAClC;AAED,eAAO,MAAM,YAAY,EAAE,CAAC,CAAC,OAAO,CASlC,CAAA;AAGF,eAAO,MAAM,2BAA2B,EAAE,CAAC,CAAC,aAAa,CAKvD,CAAA;AAEF,eAAO,MAAM,mBAAmB,EAAE,CAAC,CAAC,aAAa,CAK/C,CAAA;AAuBF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAE1E;AAED,kGAAkG;AAClG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAMxE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,CAG3E"}

package/lib/dsh/budgets.js

@@ -0,0 +1,65 @@
+/** Optional policy overrides. Missing values remain owned by the host. */
+import z from '@deepseek-ai/schemastery';
+import { z as json } from 'zod';
+export const budgetSchema = z.object({
+    pressureBasis: z.union(['host', 'window']).description('Compression budget basis: host policy or full context window.'),
+    thresholdRatio: z.number().min(0.01).max(1).description('Context fraction at which compression starts.'),
+    retainRatio: z.number().min(0).max(1).description('Recent context fraction retained verbatim.'),
+    summaryMaxTokens: z.number().step(1).min(1).description('Maximum summary output tokens.'),
+    compactionRetries: z.number().step(1).min(0).max(10),
+    maxOverflowRetries: z.number().step(1).min(0).max(10),
+    ptcTimeoutMs: z.number().step(1).min(1).description('Default PTC elapsed deadline, including tool waits, in milliseconds.'),
+    ptcMaxTimeoutMs: z.number().step(1).min(1).description('PTC elapsed ceiling; the host ceiling remains authoritative.'),
+});
+// SettingsProvider resolves plain data; volatile references belong only to Loader entries.
+export const settingsConfigurationSchema = z.object({
+    applyToOfficialPresets: z.boolean().description('Apply common runtime budgets to Standard, PTC, Minimal and Create presets (default: off).'),
+    budgets: budgetSchema.description('Optional runtime budgets; leave blank to follow the host.'),
+    maxTasks: z.number().step(1).min(1).max(128),
+    maxContextBytes: z.number().step(1).min(1024).max(262144),
+});
+export const configurationSchema = z.object({
+    applyToOfficialPresets: settingsConfigurationSchema.dict.applyToOfficialPresets.extra('volatile', true),
+    budgets: settingsConfigurationSchema.dict.budgets.extra('volatile', true),
+    maxTasks: settingsConfigurationSchema.dict.maxTasks.extra('volatile', true),
+    maxContextBytes: settingsConfigurationSchema.dict.maxContextBytes.extra('volatile', true),
+});
+const validConfiguration = json.object({
+    applyToOfficialPresets: json.boolean().optional(),
+    budgets: json.object({
+        pressureBasis: json.enum(['host', 'window']).optional(),
+        thresholdRatio: json.number().min(0.01).max(1).optional(),
+        retainRatio: json.number().min(0).max(1).optional(),
+        summaryMaxTokens: json.number().int().positive().safe().optional(),
+        compactionRetries: json.number().int().min(0).max(10).optional(),
+        maxOverflowRetries: json.number().int().min(0).max(10).optional(),
+        ptcTimeoutMs: json.number().int().positive().safe().optional(),
+        ptcMaxTimeoutMs: json.number().int().positive().safe().optional(),
+    }).strict().optional(),
+    maxTasks: json.number().int().min(1).max(128).optional(),
+    maxContextBytes: json.number().int().min(1024).max(262144).optional(),
+}).strict().superRefine((config, ctx) => {
+    const b = config.budgets;
+    if (!b)
+        return;
+    if ((b.retainRatio ?? 0.16) >= (b.thresholdRatio ?? 0.8))
+        ctx.addIssue({ code: 'custom', message: 'Retention must be below the compression threshold.' });
+    if (b.ptcTimeoutMs !== undefined && b.ptcMaxTimeoutMs !== undefined && b.ptcTimeoutMs > b.ptcMaxTimeoutMs)
+        ctx.addIssue({ code: 'custom', message: 'PTC default deadline exceeds its ceiling.' });
+});
+export function validateConfiguration(config) {
+    return validConfiguration.parse(config);
+}
+/** Newer Loader schemas expose volatile fields as references; older hosts return plain values. */
+export function configurationValues(config) {
+    return validateConfiguration(Object.fromEntries(Object.entries(config).flatMap(([key, value]) => {
+        const reference = value;
+        const selected = typeof reference?.get === 'function' ? reference.get() : value;
+        return selected === undefined ? [] : [[key, selected]];
+    })));
+}
+export function configurationOf(ctx, agent) {
+    const source = ctx.get('superCodeConfiguration');
+    return source ? agent && source.forAgent ? source.forAgent(agent) : source.get() : {};
+}
+//# sourceMappingURL=budgets.js.map

package/lib/dsh/budgets.js.map

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

package/lib/dsh/compaction.d.ts

@@ -0,0 +1,40 @@
+/** Change pressure policy while retaining the host's compaction transaction. */
+import type { Context } from '@deepseek-ai/cordis';
+import { BasicCompactionEngine } from '@deepseek-ai/dsh-compaction-basic';
+import { CompactionEngine } from '@deepseek-ai/dsh-compaction';
+import type { CompactionResult, CompactionTrigger } from '@deepseek-ai/dsh-compaction';
+import type { Agent } from '@deepseek-ai/dsh-agent';
+import type { Session, SessionSeq } from '@deepseek-ai/dsh-session';
+import type { TokenMeasurement } from '@deepseek-ai/dsh-token-meter';
+import type { CommandId } from '@deepseek-ai/dsh-commands/brand';
+import { budgetSchema } from './budgets.js';
+import type { Budgets } from './budgets.js';
+export declare const name = "super-code-compaction";
+export declare const inject: readonly string[];
+export declare const Config: typeof budgetSchema;
+/** Preserve the system head and extend the retained tail to a balanced tool boundary. */
+export declare function compactableRange(session: Session, measurement: TokenMeasurement, retainTokens: number): {
+    start: SessionSeq;
+    end: SessionSeq;
+} | {
+    kind: 'none';
+};
+export declare class BudgetCompactionEngine extends BasicCompactionEngine {
+    private readonly budgets;
+    constructor(ctx: Context, budgets?: Budgets);
+    compactIfNeeded(agent: Agent, trigger: CompactionTrigger, signal: AbortSignal): Promise<CompactionResult | null>;
+}
+/** Share the window policy with an official engine without replacing its transaction or listeners. */
+export declare function compactByWindow(engine: BasicCompactionEngine, budgets: Budgets, agent: Agent, signal: AbortSignal): Promise<CompactionResult | null>;
+/** Retained preset generations share this router, while each Agent owns its host engine. */
+export declare class AgentBudgetCompaction extends CompactionEngine {
+    private readonly overrides;
+    private readonly engines;
+    constructor(ctx: Context, overrides?: Budgets);
+    forAgent(agent: Agent): Promise<BudgetCompactionEngine>;
+    compactIfNeeded(agent: Agent, trigger: CompactionTrigger, signal: AbortSignal): Promise<CompactionResult | null>;
+    compactRegion(start: SessionSeq, end: SessionSeq, agent: Agent, signal?: AbortSignal): Promise<CompactionResult>;
+    compactNow(agent: Agent, signal: AbortSignal, sourceCommandId?: CommandId): Promise<CompactionResult | null>;
+}
+export declare function apply(ctx: Context, config?: Budgets): void;
+//# sourceMappingURL=compaction.d.ts.map

package/lib/dsh/compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../src/dsh/compaction.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AACzE,OAAO,EAAE,gBAAgB,EAA6B,MAAM,6BAA6B,CAAA;AAEzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AACtF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAChE,OAAO,EAAE,YAAY,EAA0C,MAAM,cAAc,CAAA;AACnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAE3C,eAAO,MAAM,IAAI,0BAA0B,CAAA;AAC3C,eAAO,MAAM,MAAM,EAAE,SAAS,MAAM,EAAsC,CAAA;AAC1E,eAAO,MAAM,MAAM,EAAE,OAAO,YAA2B,CAAA;AAEvD,yFAAyF;AACzF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAajK;AAED,qBAAa,sBAAuB,SAAQ,qBAAqB;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAtC,GAAG,EAAE,OAAO,EAAmB,OAAO,GAAE,OAAY;IAWjD,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;CAIhI;AAED,sGAAsG;AACtG,wBAAsB,eAAe,CAAC,MAAM,EAAE,qBAAqB,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAyB1J;AAED,4FAA4F;AAC5F,qBAAa,qBAAsB,SAAQ,gBAAgB;IAG/B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAFpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8G;gBAE1H,GAAG,EAAE,OAAO,EAAmB,SAAS,GAAE,OAAY;IAwBlE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAqBxC,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAIhH,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIhH,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;CAG5H;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,GAAE,OAAY,GAAG,IAAI,CAE9D"}

package/lib/dsh/compaction.js

@@ -0,0 +1,146 @@
+import { BasicCompactionEngine } from '@deepseek-ai/dsh-compaction-basic';
+import { CompactionEngine, toolPairingBalancedBefore } from '@deepseek-ai/dsh-compaction';
+import { createScope } from '@deepseek-ai/dsh-scope';
+import { budgetSchema, configurationOf, validateConfiguration } from './budgets.js';
+export const name = 'super-code-compaction';
+export const inject = ['llm', 'tokenMeter', 'sessions'];
+export const Config = budgetSchema;
+/** Preserve the system head and extend the retained tail to a balanced tool boundary. */
+export function compactableRange(session, measurement, retainTokens) {
+    const nodes = session.surface.nodes;
+    if (!nodes.length)
+        return { kind: 'none' };
+    if (nodes.length !== measurement.nodes.length || nodes.some((seq, index) => seq !== measurement.nodes[index]?.seq))
+        throw new Error('Compression measurement does not match the current surface');
+    const first = session.eventAt(nodes[0])?.type === 'system/message' ? 1 : 0;
+    let tokens = 0, keep = nodes.length;
+    for (let index = nodes.length - 1; index >= 0; index--) {
+        tokens += measurement.nodes[index].tokens;
+        keep = index;
+        if (tokens >= retainTokens)
+            break;
+    }
+    while (keep > first && !toolPairingBalancedBefore(session, nodes[keep]))
+        keep--;
+    return keep <= first ? { kind: 'none' } : { start: nodes[first], end: nodes[keep - 1] };
+}
+export class BudgetCompactionEngine extends BasicCompactionEngine {
+    budgets;
+    constructor(ctx, budgets = {}) {
+        validateConfiguration({ budgets });
+        super(ctx, {
+            thresholdRatio: budgets.thresholdRatio,
+            retainRatio: budgets.retainRatio,
+            maxTokens: budgets.summaryMaxTokens,
+            compactionRetries: budgets.compactionRetries,
+            maxOverflowRetries: budgets.maxOverflowRetries,
+        });
+        this.budgets = budgets;
+    }
+    async compactIfNeeded(agent, trigger, signal) {
+        if (this.budgets.pressureBasis !== 'window' || trigger !== 'pressure')
+            return super.compactIfNeeded(agent, trigger, signal);
+        return compactByWindow(this, this.budgets, agent, signal);
+    }
+}
+/** Share the window policy with an official engine without replacing its transaction or listeners. */
+export async function compactByWindow(engine, budgets, agent, signal) {
+    const ctx = engine['ctx'];
+    signal.throwIfAborted();
+    const config = agent.session.requestHeader()?.config;
+    if (!config?.provider || !config.model)
+        return null;
+    const info = await ctx.llm.resolveModelInfo(config.provider, config.model, signal);
+    const window = info.context?.contextWindow;
+    if (!Number.isSafeInteger(window) || !window || window < 1)
+        throw new Error('Compression requires the routed model context window');
+    const threshold = Math.floor(window * (budgets.thresholdRatio ?? engine.config.thresholdRatio));
+    const retain = Math.floor(window * (budgets.retainRatio ?? engine.config.retainRatio ?? 0.16));
+    let measurement = ctx.tokenMeter.measure(agent.session);
+    if (measurement.totalTokens < threshold)
+        return null;
+    const pruner = ctx.get('toolResultPruner');
+    if (pruner) {
+        pruner.pruneSession(agent.session);
+        measurement = ctx.tokenMeter.measure(agent.session);
+    }
+    if (measurement.totalTokens < threshold)
+        return null;
+    let result = null;
+    for (let attempt = 0; attempt <= (budgets.compactionRetries ?? engine.config.compactionRetries); attempt++) {
+        signal.throwIfAborted();
+        const range = compactableRange(agent.session, measurement, retain);
+        if ('kind' in range)
+            return result;
+        result = await engine.compactRegion(range.start, range.end, agent, signal);
+        measurement = ctx.tokenMeter.measure(agent.session);
+        if (measurement.totalTokens < threshold)
+            return result;
+    }
+    throw new Error('Compression remains above the configured window threshold after its retry budget');
+}
+/** Retained preset generations share this router, while each Agent owns its host engine. */
+export class AgentBudgetCompaction extends CompactionEngine {
+    overrides;
+    engines = new WeakMap();
+    constructor(ctx, overrides = {}) {
+        super(ctx);
+        this.overrides = overrides;
+        validateConfiguration({ budgets: overrides });
+        ctx.on('agent/created', async ({ agent }) => { await this.forAgent(agent); });
+        ctx.on('agent/disposed', async ({ agent }) => {
+            const entry = this.engines.get(agent);
+            this.engines.delete(agent);
+            await entry?.dispose();
+        });
+        // Older creation events do not await listeners; finish setup before the first pressure check.
+        ctx.on('agent/pre-step', async ({ agent, signal }, next) => {
+            const ready = this.engines.get(agent)?.ready;
+            const engine = await this.forAgent(agent);
+            if (!ready && !signal.aborted) {
+                try {
+                    await engine.compactIfNeeded(agent, 'pressure', signal);
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    ctx.logger.warn(`step compaction failed: ${message}; continuing the turn`);
+                }
+            }
+            return next();
+        });
+    }
+    forAgent(agent) {
+        let entry = this.engines.get(agent);
+        if (!entry) {
+            const scope = createScope(this.ctx, agent);
+            const budgets = { ...configurationOf(this.ctx, agent).budgets, ...this.overrides };
+            const fiber = scope.ctx.isolate('compaction').plugin({ inject, apply(owner) { new BudgetCompactionEngine(owner, budgets); } });
+            const created = {
+                ready: false, dispose: scope.dispose,
+                engine: fiber.await().then(() => {
+                    const engine = fiber.ctx.get('compaction');
+                    if (!engine)
+                        throw new Error('Agent compression engine did not become available');
+                    created.ready = true;
+                    return engine;
+                }).catch(async (error) => { await scope.dispose(); throw error; }),
+            };
+            entry = created;
+            this.engines.set(agent, entry);
+        }
+        return entry.engine;
+    }
+    async compactIfNeeded(agent, trigger, signal) {
+        return (await this.forAgent(agent)).compactIfNeeded(agent, trigger, signal);
+    }
+    async compactRegion(start, end, agent, signal) {
+        return (await this.forAgent(agent)).compactRegion(start, end, agent, signal);
+    }
+    async compactNow(agent, signal, sourceCommandId) {
+        return (await this.forAgent(agent)).compactNow(agent, signal, sourceCommandId);
+    }
+}
+export function apply(ctx, config = {}) {
+    new AgentBudgetCompaction(ctx, config);
+}
+//# sourceMappingURL=compaction.js.map