dsh-context-compression-improved 0.1.1

package/assets/deepseek-v4-vision-exp/tokenizer_config.json

@@ -0,0 +1,34 @@
+{
+  "add_bos_token": false,
+  "add_eos_token": false,
+  "bos_token": {
+    "__type": "AddedToken",
+    "content": "<｜begin▁of▁sentence｜>",
+    "lstrip": false,
+    "normalized": true,
+    "rstrip": false,
+    "single_word": false
+  },
+  "clean_up_tokenization_spaces": false,
+  "eos_token": {
+    "__type": "AddedToken",
+    "content": "<｜end▁of▁sentence｜>",
+    "lstrip": false,
+    "normalized": true,
+    "rstrip": false,
+    "single_word": false
+  },
+  "legacy": true,
+  "model_max_length": 1048576,
+  "pad_token": {
+    "__type": "AddedToken",
+    "content": "<｜end▁of▁sentence｜>",
+    "lstrip": false,
+    "normalized": true,
+    "rstrip": false,
+    "single_word": false
+  },
+  "sp_model_kwargs": {},
+  "unk_token": null,
+  "tokenizer_class": "PreTrainedTokenizerFast"
+}

package/cordis.patch.yml

@@ -0,0 +1,19 @@
+# Standalone Profile Bundle entry. The same package may already be present in a
+# Harness distribution; its Host implementation reference-counts the preset
+# decoration so the two rows never install two compression stacks.
+- insert:
+    - id: context-compression-improved-bundle
+      name: 'dsh-context-compression-improved'
+      config:
+        presetOverlay: true
+    # The estimator catalog route rides its own row. Registering an HTTP route
+    # authorizes against the calling fiber, so only a fiber that declares
+    # `webServer` can reach it; a runtime probe cannot substitute. Keeping that
+    # declaration off the main row leaves the compression stack loadable on
+    # profiles that have no web server at all.
+    - id: context-compression-improved-estimator-catalog
+      name: 'dsh-context-compression-improved'
+      inject:
+        - webServer
+      config:
+        estimatorCatalogRoute: true

package/dsh.plugin.json

@@ -0,0 +1,16 @@
+{
+  "id": "dsh-external/dsh-context-compression-improved",
+  "version": "0.1.1",
+  "main": "./lib/index.js",
+  "description": "Auditable tool-result context-compression selector with code-skeleton gate for DeepSeek Harness",
+  "engines": {
+    "dsh": ">=0.1.1-rc.2 <0.2.0-0"
+  },
+  "contributes": {
+    "tools": [],
+    "skills": []
+  },
+  "client": {
+    "main": "./lib/client.js"
+  }
+}

package/lib/client.d.ts

@@ -0,0 +1,229 @@
+import { ClientContext, SettingsScope } from "@deepseek-ai/dsh-client-runtime/client";
+import { InjectFace, PropsLocale, PropsRuntime } from "@deepseek-ai/dsh-client-ui-slots";
+//#region src/profiles.d.ts
+/** Public context-compression choices shared by the Host schema and browser selector. */
+declare const COMPRESSION_PROFILES: readonly ["off", "native", "balanced", "cache-strict", "savings", "adaptive", "tokenpilot-inspired", "custom"];
+/** One supported context-compression profile. */
+type CompressionProfile = typeof COMPRESSION_PROFILES[number];
+/** Single canonical unit stored by a version-1 browser Custom document. */
+type CustomCompressionUnit = 'tokens' | 'context-percent';
+/** Whether Custom History may routinely rewrite an already-sent prefix. */
+type CustomPrefixPolicy = 'preserve' | 'pressure-break';
+/** Browser representation of one independently enabled Fresh or Aggregate budget. */
+interface CustomCompressionBudget {
+  enabled: boolean;
+  trigger: number;
+  target: number;
+}
+/** Legacy browser representation of the Custom History working set. */
+interface LegacyCustomHistoryPolicy {
+  enabled: boolean;
+  trigger: number;
+  keepRecentTurns: number;
+  keepRecent: number;
+  minReclaim: number;
+}
+/** Browser representation of Custom History tool-call and token-tail protection. */
+interface CustomHistoryPolicy {
+  enabled: boolean;
+  trigger: number;
+  keepRecentToolCalls: number;
+  keepRecentTokens: number;
+  minReclaim: number;
+}
+/** Browser representation of the Custom-only Experimental TailTrim gate. */
+interface CustomTailTrimPolicy {
+  enabled: boolean;
+  trigger: number;
+}
+interface CustomCompressionPolicyCommon<HistoryPolicy> {
+  unit: CustomCompressionUnit;
+  fresh: CustomCompressionBudget;
+  aggregate: CustomCompressionBudget;
+  history: HistoryPolicy;
+  prefixPolicy: CustomPrefixPolicy;
+}
+/** Legacy public Custom document; accepted and normalized before editing. */
+interface CustomCompressionPolicyV1 extends CustomCompressionPolicyCommon<LegacyCustomHistoryPolicy> {
+  version: 1;
+}
+/** Legacy Custom document with a default-disabled TailTrim stage. */
+interface CustomCompressionPolicyV2 extends CustomCompressionPolicyCommon<LegacyCustomHistoryPolicy> {
+  version: 2;
+  tailTrim: CustomTailTrimPolicy;
+}
+/** Public Custom document with tool-call working-set protection. */
+interface CustomCompressionPolicyV3 extends CustomCompressionPolicyCommon<CustomHistoryPolicy> {
+  version: 3;
+  tailTrim: CustomTailTrimPolicy;
+}
+/** Exact public Custom document accepted by the Host and browser boundary. */
+type CustomCompressionPolicy = CustomCompressionPolicyV1 | CustomCompressionPolicyV2 | CustomCompressionPolicyV3;
+/** User-tunable Auto Compact coordination preferences. */
+interface AutoCompactSettings {
+  thresholdPercent: number;
+}
+/**
+ * Orthogonal code-skeleton reducer gate, mirrored browser-safe from the
+ * runtime: independent of every profile, default off.
+ */
+interface CodeSkeletonSettings {
+  enabled: boolean;
+}
+/** Browser-safe mirror of the runtime presetOptions section. */
+interface PresetOptionsSettings {
+  readonly dedupeToolResults?: boolean;
+  readonly summaryLocator?: boolean;
+  readonly prefixStabilizer?: boolean;
+  readonly readState?: boolean;
+  readonly estimatorMode?: '' | 'host' | 'direct';
+  readonly estimatorProvider?: string;
+  readonly estimatorModel?: string;
+  readonly estimatorBaseUrl?: string;
+  readonly estimatorApiKey?: string;
+  readonly estimatorTimeoutMs?: number;
+}
+/** Durable settings section owned by this package. */
+interface ContextCompressionSettings {
+  /** Default profile captured when each Session first reaches the pruner. */
+  profile: CompressionProfile;
+  /** Complete canonical policy captured with `profile` when the runtime first observes a Session. */
+  custom: CustomCompressionPolicy;
+  /** Auto Compact trigger captured with `profile` when the runtime first observes a Session. */
+  autoCompact: AutoCompactSettings;
+  /** Code-skeleton reducer gate captured independently of `profile`. */
+  codeSkeleton: CodeSkeletonSettings;
+  /** Optional tokenpilot-inspired sub-capability overrides (presence-validated only). */
+  presetOptions?: PresetOptionsSettings;
+}
+//#endregion
+//#region src/client/preset-options.d.ts
+/** One partial edit of `presetOptions`; `undefined` clears the named field. */
+type PresetOptionsPatch = { readonly [K in keyof PresetOptionsSettings]?: PresetOptionsSettings[K] | undefined; };
+//#endregion
+//#region src/client/locales.d.ts
+/** Simplified Chinese copy for the context-compression selector. */
+declare const zh: {
+  nav: string;
+  'settings.title': string;
+  'settings.description': string;
+  label: string;
+  'status.loading': string;
+  'status.unavailable': string;
+  'status.presetUnavailable': string;
+  'status.minimalUnavailable': string;
+  'status.saveFailed': string;
+  'pricing.disclosure': string;
+  'profile.balanced': string;
+  'profile.cache-strict': string;
+  'profile.savings': string;
+  'profile.adaptive': string;
+  'profile.tokenpilot-inspired': string;
+  'estimator.title': string;
+  'estimator.description': string;
+  'estimator.mode': string;
+  'estimator.mode.off': string;
+  'estimator.followHost': string;
+  'estimator.mode.host': string;
+  'estimator.mode.direct': string;
+  'estimator.inactive': string;
+  'estimator.provider': string;
+  'estimator.provider.placeholder': string;
+  'estimator.model.placeholder': string;
+  'estimator.hostReuse': string;
+  'estimator.hostRoute': string;
+  'estimator.hostUnresolved': string;
+  'estimator.baseUrl': string;
+  'estimator.model': string;
+  'estimator.apiKey': string;
+  'estimator.apiKey.placeholder': string;
+  'estimator.apiKey.set': string;
+  'estimator.apiKey.clear': string;
+  'estimator.apiKey.overwrite': string;
+  'detail.tokenpilot-inspired': string;
+  'profile.custom': string;
+  'profile.native': string;
+  'profile.off': string;
+  'profile.current': string;
+  'detail.balanced': string;
+  'detail.cache-strict': string;
+  'detail.savings': string;
+  'detail.adaptive': string;
+  'detail.custom': string;
+  'detail.native': string;
+  'detail.off': string;
+  'autoCompact.title': string;
+  'autoCompact.description': string;
+  'autoCompact.inputLabel': string;
+  'autoCompact.sliderLabel': string;
+  'autoCompact.quick': string;
+  'autoCompact.riskLow': string;
+  'autoCompact.riskHigh': string;
+  'autoCompact.invalid': string;
+  'autoCompact.save': string;
+  'autoCompact.summaryHint': string;
+  'codeSkeleton.title': string;
+  'codeSkeleton.description': string;
+  'codeSkeleton.enabled': string;
+  'codeSkeleton.enabled.on': string;
+  'codeSkeleton.enabled.off': string;
+  'custom.title': string;
+  'custom.settingsHint': string;
+  'custom.sessionScope': string;
+  'custom.measurement': string;
+  'custom.unit': string;
+  'custom.unit.tokens': string;
+  'custom.unit.contextPercent': string;
+  'custom.enabled': string;
+  'custom.enabled.on': string;
+  'custom.enabled.off': string;
+  'custom.fresh.enabled': string;
+  'custom.fresh.trigger': string;
+  'custom.fresh.target': string;
+  'custom.aggregate.enabled': string;
+  'custom.aggregate.trigger': string;
+  'custom.aggregate.target': string;
+  'custom.history.enabled': string;
+  'custom.history.trigger': string;
+  'custom.history.keepRecentToolCalls': string;
+  'custom.history.keepRecentTokens': string;
+  'custom.history.minReclaim': string;
+  'custom.prefixPolicy': string;
+  'custom.prefixPolicy.preserve': string;
+  'custom.prefixPolicy.pressureBreak': string;
+  'custom.experimental': string;
+  'custom.tailTrim.enabled': string;
+  'custom.tailTrim.trigger': string;
+  'custom.tailTrim.warning': string;
+  'custom.save': string;
+  'custom.reset': string;
+  'custom.invalid': string;
+};
+/** Locale keys that every context-compression selector dictionary must provide. */
+type ContextCompressionLocaleKey = keyof typeof zh;
+//#endregion
+//#region src/client/CompressionProfileSelector.d.ts
+interface CompressionSelectorInjected {
+  hooks: {
+    compression: SettingsScope<ContextCompressionSettings>;
+  };
+  select: (profile: CompressionProfile) => Promise<void>;
+  saveCustom: (custom: CustomCompressionPolicy) => Promise<void>;
+  resetCustom: () => Promise<void>;
+  saveAutoCompact: (thresholdPercent: number) => Promise<void>;
+  saveCodeSkeleton: (enabled: boolean) => Promise<void>;
+  /** Patch of `presetOptions` members; an explicit `undefined` clears that field. */
+  savePresetOptions: (options: PresetOptionsPatch) => Promise<void>;
+}
+type CompressionProfileSelectorProps = PropsRuntime<'settings.section'> & PropsLocale<'context-compression'> & InjectFace<CompressionSelectorInjected>;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+  interface LocaleNamespaceMap {
+    'context-compression': ContextCompressionLocaleKey;
+  }
+}
+//#endregion
+//#region src/client/index.d.ts
+declare const inject: string[];
+declare function apply(ctx: ClientContext): void;
+//#endregion
+export { type CompressionProfile, type CompressionProfileSelectorProps, type CompressionSelectorInjected, type ContextCompressionSettings, apply, inject };