@deepseek-harness-tui/dsh-tui 0.14.1 → 0.15.0

package/lib/types/dsh-adapter/context-occupancy.d.ts

@@ -31,13 +31,31 @@
  *    bundle and therefore no token meter; the projection key is simply not
  *    registered. The store stays empty and the channel falls back to the
  *    last-request sample it has always shown (see `resolveContextOccupancy`).
+ *
+ * The SAME unit also publishes `contextBreakdown` — the heuristic composition of
+ * that total (system prompt / request-envelope tool schemas / everything else).
+ * This module reads it on the same seam and stores it beside the occupancy,
+ * because the segmented bar draws what the context is made of while its length
+ * and readout must follow the provider-anchored total: without the composition
+ * the bar had to price its own transcript text, which systematically misses the
+ * request envelope (tool schemas) and the injected context. Absence is normal
+ * here too — a meter older than the projection publishes no composition, and the
+ * bar keeps using this app's own estimates alone.
  * @module dsh-tui/dsh-adapter/context-occupancy
  */
 import type { Context } from '@deepseek-ai/cordis';
-import type { ContextOccupancy } from '../adapter/ports/channel-view.js';
+import type { ContextBreakdown, ContextOccupancy } from '../adapter/ports/channel-view.js';
 import type { ProjectionRegistryLike } from './activity-store.js';
 /** The projection key the host token meter publishes. */
 export declare const CONTEXT_PRESSURE_PROJECTION_KEY = "contextPressure";
+/** The composition key the SAME meter unit publishes (see
+ *  {@link ContextBreakdownView}); absent on harness lines whose meter predates
+ *  it, which every reader here treats as "no composition known". */
+export declare const CONTEXT_BREAKDOWN_PROJECTION_KEY = "contextBreakdown";
+/** The two keys of the one meter unit this store folds. Each maps to its own
+ *  table, so the write path is typed by key: a third key — or a typo — cannot
+ *  compile its way into an occupancy value. */
+type ContextMeterKey = typeof CONTEXT_PRESSURE_PROJECTION_KEY | typeof CONTEXT_BREAKDOWN_PROJECTION_KEY;
 /**
  * The official `contextPressure` wire value.
  *
@@ -54,6 +72,30 @@ export interface ContextPressureView {
     /** Newest recorded route capacity, when an adapter advertised one. */
     readonly contextWindow?: number;
 }
+/**
+ * The official `contextBreakdown` wire value.
+ *
+ * Structural copy of `@deepseek-ai/dsh-token-meter`'s `ContextBreakdownProjection`,
+ * the composition half of the same meter unit that publishes `contextPressure`:
+ * system prompt, the newest request envelope's TOOL SCHEMAS, and everything else
+ * on the surface. Its own doc is explicit that the three are a heuristic
+ * composition — "approximations of composition, never … a total" — because the
+ * fixed density estimator underprices CJK text and JSON schemas; the
+ * provider-anchored total stays `contextPressure`.
+ *
+ * Fields are optional here even though the host declares them required: a
+ * partially-filled wire value must degrade to "this part is unknown" instead of
+ * discarding the whole reading (the discipline {@link ContextPressureView} keeps).
+ */
+export interface ContextBreakdownView {
+    /** Heuristic tokens of the last nonempty surviving system prompt. */
+    readonly systemTokens?: number;
+    /** Heuristic tokens of the newest request envelope's tool schemas. */
+    readonly toolsTokens?: number;
+    /** Heuristic tokens of every other visible surface node (including
+     *  superseded system prompts and injected context). */
+    readonly messageTokens?: number;
+}
 /**
  * The reader the channel gets: a cached lookup plus a change feed.
  *
@@ -63,6 +105,10 @@ export interface ContextPressureView {
  */
 export interface ContextPressureSource {
     read(sessionId: string): ContextPressureView | undefined;
+    /** The same unit's composition value, when the harness publishes it. An
+     *  absent method (or an absent value) means the bar falls back to this app's
+     *  own per-content-type estimates alone. */
+    readBreakdown?(sessionId: string): ContextBreakdownView | undefined;
     subscribe(listener: () => void): () => void;
 }
 /**
@@ -88,6 +134,23 @@ export declare function asContextPressureView(value: unknown): ContextPressureVi
  * @returns the occupancy numerator, or `undefined` before any provider sample.
  */
 export declare function contextPressureUsedTokens(view: ContextPressureView): number | undefined;
+/**
+ * Narrow one `contextBreakdown` wire value: a value carrying no known field is
+ * dropped, a partially-filled one is kept so its known parts still reach the
+ * bar. Passed THROUGH (not copied) for the same identity-is-the-change-test
+ * reason as {@link asContextPressureView}.
+ * @param value - Raw projection value.
+ * @returns the value as a breakdown view, or `undefined`.
+ */
+export declare function asContextBreakdownView(value: unknown): ContextBreakdownView | undefined;
+/**
+ * Normalise the host's composition value into the port shape the footer reads,
+ * filling absent fields with 0 (a partial value must not blank the sections the
+ * host did report).
+ * @param view - The narrowed projection value, if any.
+ * @returns the composition, or `undefined` when the harness publishes none.
+ */
+export declare function resolveContextBreakdown(view: ContextBreakdownView | undefined): ContextBreakdown | undefined;
 /**
  * Resolve the ONE occupancy reading the footer, the segmented bar, the working
  * line's pressure prefix, the status commands and the context-low warning share.
@@ -117,7 +180,8 @@ export declare function resolveContextOccupancy(projected: ContextPressureView |
     readonly max?: number;
 }): ContextOccupancy | undefined;
 /**
- * The latest `contextPressure` value for the session on screen.
+ * The latest `contextPressure` (and, when published, `contextBreakdown`) value
+ * for the session on screen.
  *
  * Effectively single-current, mirroring {@link ActivityStore}: binding a
  * session names the one the UI shows, and every other id is dropped — the
@@ -131,6 +195,10 @@ export declare function resolveContextOccupancy(projected: ContextPressureView |
  */
 export declare class ContextOccupancyStore implements ContextPressureSource {
     private readonly values;
+    /** The same sessions' composition values — another key of the SAME meter
+     *  unit, folded alongside the pressure so the bar never reads a composition
+     *  from a different log position than its total. */
+    private readonly breakdowns;
     private readonly listeners;
     /** The session the UI is showing (the last {@link seed}); the only id kept. */
     private currentId;
@@ -160,11 +228,14 @@ export declare class ContextOccupancyStore implements ContextPressureSource {
     /**
      * Record one value from the projection change feed.
      * @param sessionId - Session the value belongs to.
+     * @param key - Projection key the value was published under.
      * @param value - The published wire value.
      */
-    update(sessionId: string, value: unknown): void;
+    update(sessionId: string, key: ContextMeterKey, value: unknown): void;
     /** The current value for one session, stable between updates. */
     read(sessionId: string): ContextPressureView | undefined;
+    /** The current composition for one session, when the harness publishes it. */
+    readBreakdown(sessionId: string): ContextBreakdownView | undefined;
     /** Subscribe to value changes; returns the unsubscribe function. */
     subscribe(listener: () => void): () => void;
     /**
@@ -175,6 +246,9 @@ export declare class ContextOccupancyStore implements ContextPressureSource {
     noteReadFailure(error: unknown): void;
     /** Store one already-narrowed value for the current session and emit on change. */
     private remember;
+    /** One key's map write, with the identity-is-the-change-test rule the host's
+     *  reference reuse relies on, and the emit on every real transition. */
+    private rememberIn;
     /** Drop every id that is not the current one; emit when a value went. */
     private pruneToCurrent;
     private emit;
@@ -191,7 +265,9 @@ export declare class ContextOccupancyStore implements ContextPressureSource {
  * The feed is event-driven and carries the whole value, so a change costs one
  * narrow + one map write. A long resumed session (thousands of replayed events)
  * therefore pays O(changes of this unit) and never a per-event fold; rendering
- * pays a map lookup, never a `snapshot()`.
+ * pays a map lookup, never a `snapshot()`. Both keys of the unit ride the one
+ * feed/subscription pair: a composition change repaints the bar on the same
+ * republish an occupancy change does.
  * @param ctx - Host context of the composition root.
  * @param store - Store to fill.
  */
@@ -206,4 +282,5 @@ export declare function attachContextPressureProjection(ctx: Context, store: Con
  * @returns the store the channel reads from.
  */
 export declare function createContextOccupancyStore(ctx: Context): ContextOccupancyStore;
+export {};
 //# sourceMappingURL=context-occupancy.d.ts.map

package/lib/types/dsh-adapter/context-occupancy.d.ts.map

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

package/lib/types/dsh-adapter/context-occupancy.js

@@ -31,10 +31,31 @@
  *    bundle and therefore no token meter; the projection key is simply not
  *    registered. The store stays empty and the channel falls back to the
  *    last-request sample it has always shown (see `resolveContextOccupancy`).
+ *
+ * The SAME unit also publishes `contextBreakdown` — the heuristic composition of
+ * that total (system prompt / request-envelope tool schemas / everything else).
+ * This module reads it on the same seam and stores it beside the occupancy,
+ * because the segmented bar draws what the context is made of while its length
+ * and readout must follow the provider-anchored total: without the composition
+ * the bar had to price its own transcript text, which systematically misses the
+ * request envelope (tool schemas) and the injected context. Absence is normal
+ * here too — a meter older than the projection publishes no composition, and the
+ * bar keeps using this app's own estimates alone.
  * @module dsh-tui/dsh-adapter/context-occupancy
  */
 /** The projection key the host token meter publishes. */
 export const CONTEXT_PRESSURE_PROJECTION_KEY = 'contextPressure';
+/** The composition key the SAME meter unit publishes (see
+ *  {@link ContextBreakdownView}); absent on harness lines whose meter predates
+ *  it, which every reader here treats as "no composition known". */
+export const CONTEXT_BREAKDOWN_PROJECTION_KEY = 'contextBreakdown';
+/** Narrow an arbitrary change-feed key to the two this store folds.
+ * @param key - Projection key as the feed reports it.
+ * @returns whether the key belongs to the context meter unit.
+ */
+function isContextMeterKey(key) {
+    return key === CONTEXT_PRESSURE_PROJECTION_KEY || key === CONTEXT_BREAKDOWN_PROJECTION_KEY;
+}
 function finiteNumber(value) {
     return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
 }
@@ -78,6 +99,46 @@ export function asContextPressureView(value) {
 export function contextPressureUsedTokens(view) {
     return view.projectedTokens ?? view.pressureTokens;
 }
+/**
+ * Narrow one `contextBreakdown` wire value: a value carrying no known field is
+ * dropped, a partially-filled one is kept so its known parts still reach the
+ * bar. Passed THROUGH (not copied) for the same identity-is-the-change-test
+ * reason as {@link asContextPressureView}.
+ * @param value - Raw projection value.
+ * @returns the value as a breakdown view, or `undefined`.
+ */
+export function asContextBreakdownView(value) {
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        return undefined;
+    const record = value;
+    const fields = ['systemTokens', 'toolsTokens', 'messageTokens'];
+    let known = false;
+    for (const field of fields) {
+        const raw = record[field];
+        if (raw === undefined)
+            continue;
+        if (finiteNumber(raw) === undefined)
+            return undefined;
+        known = true;
+    }
+    return known ? value : undefined;
+}
+/**
+ * Normalise the host's composition value into the port shape the footer reads,
+ * filling absent fields with 0 (a partial value must not blank the sections the
+ * host did report).
+ * @param view - The narrowed projection value, if any.
+ * @returns the composition, or `undefined` when the harness publishes none.
+ */
+export function resolveContextBreakdown(view) {
+    if (view === undefined)
+        return undefined;
+    return {
+        systemTokens: view.systemTokens ?? 0,
+        toolsTokens: view.toolsTokens ?? 0,
+        messageTokens: view.messageTokens ?? 0,
+    };
+}
 /**
  * Resolve the ONE occupancy reading the footer, the segmented bar, the working
  * line's pressure prefix, the status commands and the context-low warning share.
@@ -116,7 +177,8 @@ export function resolveContextOccupancy(projected, sample, requestWindow, backen
     };
 }
 /**
- * The latest `contextPressure` value for the session on screen.
+ * The latest `contextPressure` (and, when published, `contextBreakdown`) value
+ * for the session on screen.
  *
  * Effectively single-current, mirroring {@link ActivityStore}: binding a
  * session names the one the UI shows, and every other id is dropped — the
@@ -130,6 +192,10 @@ export function resolveContextOccupancy(projected, sample, requestWindow, backen
  */
 export class ContextOccupancyStore {
     values = new Map();
+    /** The same sessions' composition values — another key of the SAME meter
+     *  unit, folded alongside the pressure so the bar never reads a composition
+     *  from a different log position than its total. */
+    breakdowns = new Map();
     listeners = new Set();
     /** The session the UI is showing (the last {@link seed}); the only id kept. */
     currentId;
@@ -171,8 +237,12 @@ export class ContextOccupancyStore {
         if (registry === undefined)
             return;
         try {
-            const values = registry.snapshot(session, [CONTEXT_PRESSURE_PROJECTION_KEY]).values;
-            this.remember(this.currentId, asContextPressureView(values[CONTEXT_PRESSURE_PROJECTION_KEY]));
+            // Both keys in ONE snapshot: one materialization, one consistent cut.
+            // A harness whose meter predates `contextBreakdown` simply omits it.
+            const keys = [CONTEXT_PRESSURE_PROJECTION_KEY, CONTEXT_BREAKDOWN_PROJECTION_KEY];
+            const values = registry.snapshot(session, keys).values;
+            this.remember(this.currentId, CONTEXT_PRESSURE_PROJECTION_KEY, values[CONTEXT_PRESSURE_PROJECTION_KEY]);
+            this.remember(this.currentId, CONTEXT_BREAKDOWN_PROJECTION_KEY, values[CONTEXT_BREAKDOWN_PROJECTION_KEY]);
         }
         catch (error) {
             this.noteReadFailure(error);
@@ -181,15 +251,20 @@ export class ContextOccupancyStore {
     /**
      * Record one value from the projection change feed.
      * @param sessionId - Session the value belongs to.
+     * @param key - Projection key the value was published under.
      * @param value - The published wire value.
      */
-    update(sessionId, value) {
-        this.remember(sessionId, asContextPressureView(value));
+    update(sessionId, key, value) {
+        this.remember(sessionId, key, value);
     }
     /** The current value for one session, stable between updates. */
     read(sessionId) {
         return this.values.get(sessionId);
     }
+    /** The current composition for one session, when the harness publishes it. */
+    readBreakdown(sessionId) {
+        return this.breakdowns.get(sessionId);
+    }
     /** Subscribe to value changes; returns the unsubscribe function. */
     subscribe(listener) {
         this.listeners.add(listener);
@@ -208,14 +283,25 @@ export class ContextOccupancyStore {
         this.warn?.(`dsh-tui: context-pressure projection read failed: ${detail}`);
     }
     /** Store one already-narrowed value for the current session and emit on change. */
-    remember(sessionId, view) {
+    remember(sessionId, key, value) {
+        // One key, one table: a key outside this union cannot reach here (see
+        // `isContextMeterKey`), so neither table can be written by a typo.
+        if (key === CONTEXT_BREAKDOWN_PROJECTION_KEY) {
+            this.rememberIn(this.breakdowns, sessionId, asContextBreakdownView(value));
+            return;
+        }
+        this.rememberIn(this.values, sessionId, asContextPressureView(value));
+    }
+    /** One key's map write, with the identity-is-the-change-test rule the host's
+     *  reference reuse relies on, and the emit on every real transition. */
+    rememberIn(map, sessionId, view) {
         if (this.currentId !== undefined && sessionId !== this.currentId)
             return;
-        const previous = this.values.get(sessionId);
+        const previous = map.get(sessionId);
         if (view === undefined) {
             if (previous === undefined)
                 return;
-            this.values.delete(sessionId);
+            map.delete(sessionId);
             this.emit();
             return;
         }
@@ -224,7 +310,7 @@ export class ContextOccupancyStore {
         // whole change test.
         if (previous === view)
             return;
-        this.values.set(sessionId, view);
+        map.set(sessionId, view);
         this.emit();
     }
     /** Drop every id that is not the current one; emit when a value went. */
@@ -232,11 +318,13 @@ export class ContextOccupancyStore {
         if (this.currentId === undefined)
             return;
         let removed = false;
-        for (const id of [...this.values.keys()]) {
-            if (id === this.currentId)
-                continue;
-            this.values.delete(id);
-            removed = true;
+        for (const map of [this.values, this.breakdowns]) {
+            for (const id of [...map.keys()]) {
+                if (id === this.currentId)
+                    continue;
+                map.delete(id);
+                removed = true;
+            }
         }
         if (removed)
             this.emit();
@@ -258,7 +346,9 @@ export class ContextOccupancyStore {
  * The feed is event-driven and carries the whole value, so a change costs one
  * narrow + one map write. A long resumed session (thousands of replayed events)
  * therefore pays O(changes of this unit) and never a per-event fold; rendering
- * pays a map lookup, never a `snapshot()`.
+ * pays a map lookup, never a `snapshot()`. Both keys of the unit ride the one
+ * feed/subscription pair: a composition change repaints the bar on the same
+ * republish an occupancy change does.
  * @param ctx - Host context of the composition root.
  * @param store - Store to fill.
  */
@@ -271,9 +361,10 @@ export function attachContextPressureProjection(ctx, store) {
         let offFeed;
         try {
             offFeed = registry.onChanged((session, key, value) => {
-                if (key !== CONTEXT_PRESSURE_PROJECTION_KEY)
+                // Two keys of one unit: the total (occupancy) and the composition.
+                if (!isContextMeterKey(key))
                     return;
-                store.update(String(session.id), value);
+                store.update(String(session.id), key, value);
             });
         }
         catch (error) {

package/lib/types/dsh-adapter/contract.d.ts

@@ -24,7 +24,7 @@ export declare const UPSTREAM_VALIDATED_VERSIONS: readonly ["0.1.0-rc.6", "0.1.0
  */
 export declare const UPSTREAM_FRAMEWORK_MAJORS: Record<string, number>;
 /** Official packages the adapter consumes at runtime or as types. */
-export declare const UPSTREAM_BLESSED_PACKAGES: readonly ["@deepseek-ai/cordis", "@deepseek-ai/schemastery", "@deepseek-ai/dsh-invariants", "@deepseek-ai/dsh-agent", "@deepseek-ai/dsh-agent-instructions", "@deepseek-ai/dsh-agent-preset-registry", "@deepseek-ai/dsh-atomic-write", "@deepseek-ai/dsh-ptc-runtime-node", "@deepseek-ai/dsh-commands", "@deepseek-ai/dsh-cordis-host-runner", "@deepseek-ai/dsh-deepseek-account", "@deepseek-ai/dsh-host-webserver", "@deepseek-ai/dsh-llm", "@deepseek-ai/dsh-llm-pi-ai", "@deepseek-ai/dsh-persona", "@deepseek-ai/dsh-scope", "@deepseek-ai/dsh-session", "@deepseek-ai/dsh-settings", "@deepseek-ai/dsh-skill", "@deepseek-ai/dsh-storage", "@deepseek-ai/dsh-storage-domain", "@deepseek-ai/dsh-storage-json", "@deepseek-ai/dsh-workspace", "@deepseek-ai/dsh-web-app", "@deepseek-ai/dsh-system-prompt", "@deepseek-ai/dsh-terminal", "@deepseek-ai/dsh-terminal-bash", "@deepseek-ai/dsh-tool-ask-user", "@deepseek-ai/dsh-tool-bash-persistent", "@deepseek-ai/dsh-tool-cordis", "@deepseek-ai/dsh-tool-subagent", "@deepseek-ai/dsh-user-approval", "@deepseek-ai/dsh-user-questions"];
+export declare const UPSTREAM_BLESSED_PACKAGES: readonly ["@deepseek-ai/cordis", "@deepseek-ai/schemastery", "@deepseek-ai/dsh-invariants", "@deepseek-ai/dsh-agent", "@deepseek-ai/dsh-agent-instructions", "@deepseek-ai/dsh-agent-preset-registry", "@deepseek-ai/dsh-atomic-write", "@deepseek-ai/dsh-ptc-runtime-node", "@deepseek-ai/dsh-commands", "@deepseek-ai/dsh-cordis-host-runner", "@deepseek-ai/dsh-deepseek-account", "@deepseek-ai/dsh-host-webserver", "@deepseek-ai/dsh-llm", "@deepseek-ai/dsh-llm-pi-ai", "@deepseek-ai/dsh-persona", "@deepseek-ai/dsh-scope", "@deepseek-ai/dsh-session", "@deepseek-ai/dsh-settings", "@deepseek-ai/dsh-skill", "@deepseek-ai/dsh-storage", "@deepseek-ai/dsh-storage-domain", "@deepseek-ai/dsh-storage-json", "@deepseek-ai/dsh-workspace", "@deepseek-ai/dsh-web-app", "@deepseek-ai/dsh-system-prompt", "@deepseek-ai/dsh-terminal", "@deepseek-ai/dsh-terminal-bash", "@deepseek-ai/dsh-tool-ask-user", "@deepseek-ai/dsh-tool-bash-persistent", "@deepseek-ai/dsh-tool-cordis", "@deepseek-ai/dsh-tool-subagent", "@deepseek-ai/dsh-user-approval", "@deepseek-ai/dsh-user-questions", "@deepseek-ai/dsh-app-boot", "@deepseek-ai/dsh-cmdline", "@deepseek-ai/dsh-home-paths", "@deepseek-ai/dsh-http-proxy", "@deepseek-ai/dsh-launch-environment", "@deepseek-ai/dsh-plugin-manager"];
 export interface UpstreamDriftEntry {
     package: string;
     installed: string | undefined;

package/lib/types/dsh-adapter/contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/contract.ts"],"names":[],"mappings":"AAkBA,gDAAgD;AAChD,eAAO,MAAM,0BAA0B,eAAe,CAAA;AAEtD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,2BAA2B,2QAkB9B,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG5D,CAAA;AAED,qEAAqE;AACrE,eAAO,MAAM,yBAAyB,siCAkC5B,CAAA;AAEV,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;CAClB;AAYD,4EAA4E;AAC5E,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAA;AAE/D,4FAA4F;AAC5F,MAAM,MAAM,oBAAoB,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,yBAAyB,EAAE,MAAM,CAAC,CAAA;AAEvG,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,oBAAoB,GAAG,SAAS,CAKlG;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,CAAC,EAAE,oBAAoB,EAAE,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAQxF;AAkBD,sEAAsE;AACtE,eAAO,MAAM,wBAAwB,QAA6D,CAAA;AAYlG,wBAAgB,yBAAyB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAqB9E;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAE9F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAQ3D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAKnF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,iBAAiB,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAA+B,GAC5F,MAAM,EAAE,CAQV;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,iBAAiB,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAA+B,GAC5F,kBAAkB,EAAE,CAuBtB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEtE,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,iBAAiB,CAAA;IACvB,sFAAsF;IACtF,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,iBAAiB,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAA+B,GAC5F,oBAAoB,GAAG,SAAS,CA0BlC"}
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/contract.ts"],"names":[],"mappings":"AAmBA,gDAAgD;AAChD,eAAO,MAAM,0BAA0B,eAAe,CAAA;AAEtD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,2BAA2B,2QAkB9B,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAG5D,CAAA;AAED,qEAAqE;AACrE,eAAO,MAAM,yBAAyB,uuCAwC5B,CAAA;AAEV,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;CAClB;AAoBD,4EAA4E;AAC5E,MAAM,MAAM,yBAAyB,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAA;AAE/D,4FAA4F;AAC5F,MAAM,MAAM,oBAAoB,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,yBAAyB,EAAE,MAAM,CAAC,CAAA;AAEvG,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,oBAAoB,GAAG,SAAS,CAKlG;AAED,0EAA0E;AAC1E,wBAAgB,eAAe,CAAC,CAAC,EAAE,oBAAoB,EAAE,CAAC,EAAE,oBAAoB,GAAG,MAAM,CAQxF;AAkBD,sEAAsE;AACtE,eAAO,MAAM,wBAAwB,QAA6D,CAAA;AAYlG,wBAAgB,yBAAyB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAqB9E;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAE9F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAQ3D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAKnF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,iBAAiB,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAA+B,GAC5F,MAAM,EAAE,CAQV;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,iBAAiB,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAA+B,GAC5F,kBAAkB,EAAE,CAuBtB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEtE,wEAAwE;AACxE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,iBAAiB,CAAA;IACvB,sFAAsF;IACtF,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,iBAAiB,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAA+B,GAC5F,oBAAoB,GAAG,SAAS,CA0BlC"}

package/lib/types/dsh-adapter/contract.js

@@ -15,6 +15,7 @@
  */
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
+import { ADAPTER_TYPE_PACKAGES, HOST_TYPE_PACKAGES } from './host-contract.js';
 /** Primary validated upstream line (newest). */
 export const UPSTREAM_VALIDATED_VERSION = '0.2.0-rc.2';
 /**
@@ -96,6 +97,12 @@ export const UPSTREAM_BLESSED_PACKAGES = [
     '@deepseek-ai/dsh-tool-subagent',
     '@deepseek-ai/dsh-user-approval',
     '@deepseek-ai/dsh-user-questions',
+    // The packages the standalone entry's host boot takes types from
+    // (./host-contract.ts; loaded from the host by realpath).
+    ...HOST_TYPE_PACKAGES,
+    // The packages the adapter takes types from for host services it reaches
+    // through `ctx` (./host-contract.ts; the host CLI supplies them).
+    ...ADAPTER_TYPE_PACKAGES,
 ];
 // These capabilities are loaded dynamically and did not exist on every
 // supported host line. Their absence is valid at runtime, not in the CI tree.
@@ -105,6 +112,14 @@ const OPTIONAL_RUNTIME_PACKAGES = new Set([
     '@deepseek-ai/dsh-deepseek-account',
     '@deepseek-ai/dsh-host-webserver',
     '@deepseek-ai/dsh-web-app',
+    // Never resolved from this package at run time: the standalone entry loads
+    // them from the installed dsh by realpath (./host-dsh.ts), and a profile
+    // has no copy of them (peers are not auto-installed there).
+    ...HOST_TYPE_PACKAGES,
+    // Same reason, a different route: these are reached through `ctx` inside a
+    // booted profile, where the package the dsh CLI ships resolves through the
+    // loader. The consumer answers with a degradation notice when it is absent.
+    ...ADAPTER_TYPE_PACKAGES,
 ]);
 /** Parse an upstream prerelease version; undefined when unparseable. */
 export function parseUpstreamVersion(version) {

package/lib/types/dsh-adapter/entry-slot.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The hand-off between this package's entry and the runtime it mounts. On the
+ * DSH kernel the slot is also published for the profile's `dsh-tui` row in the
+ * same Cordis root: the row then runs only the DSH side through `attachDsh`
+ * (without a published slot it takes its usual path). On `globalThis` +
+ * `Symbol.for` so a row loaded from another copy of this package still meets
+ * the entry. Other kernels keep it private: the entry composes the light profile.
+ */
+/** Hooks are filled by the entry's runtime. */
+export interface EntrySlot {
+    /** The DSH kernel: the screen waits for the row's `attachDsh`. */
+    readonly dsh: boolean;
+    /** Set by the row as soon as it applies, so the entry can tell whether a
+     *  `dsh-tui` row exists once the composition settled. */
+    rowSeen: boolean;
+    /** The DSH side. The row calls it once, after the Loader settled; it never
+     *  throws (a failure lands in the mounted screen). */
+    attachDsh?: (ctx: unknown, runtimeConfig: unknown, configOwner: unknown) => Promise<void>;
+    /** DSH: the composition failed or had no `dsh-tui` row, the startup session
+     *  will never come. `logPath` is the saved startup report, if any. */
+    composeFailed?: (error: unknown, logPath?: string) => void;
+    /** The composition settled (DSH: with a `dsh-tui` row, so a startup open
+     *  that failed meanwhile is that open's failure); re-reads mount-time
+     *  resolutions of services composed after the mount. */
+    composeSucceeded?: () => void;
+    /** Resolves once the screen's first frame reached the terminal; awaited
+     *  before the composition's synchronous stretch. */
+    firstFrameFlushed?: () => Promise<void>;
+}
+/** The entry's slot, published for the `dsh-tui` row on the DSH kernel. */
+export declare function createEntrySlot(dsh: boolean): EntrySlot;
+/** The published slot, if this process's entry mounted the screen. */
+export declare function peekEntrySlot(): EntrySlot | undefined;
+/** Take the DSH-side hook once: a second row (or a recompose) finds none. */
+export declare function takeEntryAttach(): EntrySlot['attachDsh'];
+//# sourceMappingURL=entry-slot.d.ts.map

package/lib/types/dsh-adapter/entry-slot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-slot.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/entry-slot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,+CAA+C;AAC/C,MAAM,WAAW,SAAS;IACxB,kEAAkE;IAClE,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB;6DACyD;IACzD,OAAO,EAAE,OAAO,CAAA;IAChB;0DACsD;IACtD,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACzF;0EACsE;IACtE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1D;;4DAEwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC7B;wDACoD;IACpD,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACxC;AAMD,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,CAIvD;AAED,sEAAsE;AACtE,wBAAgB,aAAa,IAAI,SAAS,GAAG,SAAS,CAErD;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,IAAI,SAAS,CAAC,WAAW,CAAC,CAKxD"}

package/lib/types/dsh-adapter/entry-slot.js

@@ -0,0 +1,28 @@
+/**
+ * The hand-off between this package's entry and the runtime it mounts. On the
+ * DSH kernel the slot is also published for the profile's `dsh-tui` row in the
+ * same Cordis root: the row then runs only the DSH side through `attachDsh`
+ * (without a published slot it takes its usual path). On `globalThis` +
+ * `Symbol.for` so a row loaded from another copy of this package still meets
+ * the entry. Other kernels keep it private: the entry composes the light profile.
+ */
+const ENTRY_SLOT_KEY = Symbol.for('@deepseek-harness-tui/dsh-tui:host-entry');
+/** The entry's slot, published for the `dsh-tui` row on the DSH kernel. */
+export function createEntrySlot(dsh) {
+    const slot = { dsh, rowSeen: false };
+    if (dsh)
+        globalThis[ENTRY_SLOT_KEY] = slot;
+    return slot;
+}
+/** The published slot, if this process's entry mounted the screen. */
+export function peekEntrySlot() {
+    return globalThis[ENTRY_SLOT_KEY];
+}
+/** Take the DSH-side hook once: a second row (or a recompose) finds none. */
+export function takeEntryAttach() {
+    const slot = peekEntrySlot();
+    const attach = slot?.attachDsh;
+    if (slot !== undefined)
+        slot.attachDsh = undefined;
+    return attach;
+}

package/lib/types/dsh-adapter/fresh-agent.d.ts

@@ -0,0 +1,22 @@
+import { Context } from '@deepseek-ai/cordis';
+import type { AgentHandle, CreateAgentOptions } from '@deepseek-ai/dsh-agent';
+import type { Session, SessionEvent } from '@deepseek-ai/dsh-session';
+type AgentCreator = {
+    create(options: CreateAgentOptions): Promise<AgentHandle>;
+};
+/** Policy facts held in memory until the session has further activity. */
+export declare const INITIAL_POLICY_EVENTS: ReadonlySet<string>;
+/** Source-less legacy messages and explicit user messages count as human input. */
+export declare function isHumanSource(source: unknown): boolean;
+/** Policy commands also emit command envelopes and nonhuman inbox notices. */
+export declare function isPolicyPlaneActivity(event: SessionEvent): boolean;
+/** Initialization-only fresh session with no persistence requested yet. */
+export declare function isUnstoredFreshSession(session: Session | undefined): boolean;
+/**
+ * Startup and `/new` use an unseeded DSH session. Permission initialization
+ * alone must not publish a stored conversation; all facts still belong to
+ * the real Session, and the official JSONL writer owns their eventual storage.
+ */
+export declare function createFreshAgent(ctx: Context, agents: AgentCreator, options: CreateAgentOptions): Promise<AgentHandle>;
+export {};
+//# sourceMappingURL=fresh-agent.d.ts.map

package/lib/types/dsh-adapter/fresh-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fresh-agent.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/fresh-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAc,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AACzF,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAiB,MAAM,0BAA0B,CAAA;AAkBpF,KAAK,YAAY,GAAG;IAAE,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;CAAE,CAAA;AAyCjF,0EAA0E;AAC1E,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAAkF,CAAA;AAKxI,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAItD;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAWlE;AAID,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,CAE5E;AAuFD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC,CAsB5H"}