@deepseek-harness-tui/dsh-tui 0.12.0 → 0.14.0

package/lib/types/dsh-adapter/channel/composer-images.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"composer-images.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/composer-images.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAMlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAEhB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAA;AAEnB,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,QAAqB,CAAA;AAEtD;6EAC6E;AAC7E,eAAO,MAAM,0BAA0B,QAAsB,CAAA;AAE7D,eAAO,MAAM,sBAAsB,GAAI,WAAW,MAAM,KAAG,MACe,CAAA;AAE1E;;;2EAG2E;AAC3E,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,gBAAgB,EAAE,EACjC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,GAC7B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAehB;AAED;;4EAE4E;AAC5E,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,MAAM,GAAG,SAAS,CAKpB;AAOD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC;iEAC6D;IAC7D,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,6BAA6B;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B;sEACkE;IAClE,qBAAqB,IAAI,MAAM,CAAA;IAC/B;yEACqE;IACrE,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACpD;iFAC6E;IAC7E,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC3F,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;IACxC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAA;IACzD,iBAAiB,IAAI,mBAAmB,GAAG,SAAS,CAAA;IACpD;0EACsE;IACtE,iBAAiB,IAAI,IAAI,CAAA;IACzB,6EAA6E;IAC7E,QAAQ,IAAI,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAA;IAChE;4DACwD;IACxD,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,gBAAgB,EAAE,CAAA;IACtG,wEAAwE;IACxE,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,gBAAgB,EAAE,CAAA;CACnG;AA0BD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE;IAAE,UAAU,IAAI,MAAM,CAAA;CAAE,GAC7B,cAAc,CAyPhB"}
+{"version":3,"file":"composer-images.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/composer-images.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAMlD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAEhB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAA;AAEnB,iEAAiE;AACjE,eAAO,MAAM,oBAAoB,QAAqB,CAAA;AAEtD;6EAC6E;AAC7E,eAAO,MAAM,0BAA0B,QAAsB,CAAA;AAE7D,eAAO,MAAM,sBAAsB,GAAI,WAAW,MAAM,KAAG,MACe,CAAA;AAE1E;;;2EAG2E;AAC3E,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,SAAS,gBAAgB,EAAE,EACjC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,GAC7B,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAehB;AAED;;4EAE4E;AAC5E,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,MAAM,GAAG,SAAS,CAKpB;AAOD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAA;IACpC;iEAC6D;IAC7D,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,6BAA6B;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC;AAED,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B;sEACkE;IAClE,qBAAqB,IAAI,MAAM,CAAA;IAC/B;yEACqE;IACrE,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACpD;iFAC6E;IAC7E,kBAAkB,CAAC,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC3F,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;IACxC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAA;IACzD,iBAAiB,IAAI,mBAAmB,GAAG,SAAS,CAAA;IACpD;0EACsE;IACtE,iBAAiB,IAAI,IAAI,CAAA;IACzB,6EAA6E;IAC7E,QAAQ,IAAI,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAA;IAChE;4DACwD;IACxD,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,gBAAgB,EAAE,CAAA;IACtG,wEAAwE;IACxE,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,gBAAgB,EAAE,CAAA;CACnG;AA0BD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE;IACJ,UAAU,IAAI,MAAM,CAAA;IACpB;;+BAE2B;IAC3B,WAAW,CAAC,IAAI,eAAe,GAAG,SAAS,CAAA;CAC5C,GACA,cAAc,CA0PhB"}

package/lib/types/dsh-adapter/channel/composer-images.js

@@ -134,7 +134,8 @@ export function createComposerImages(ctx, owner, deps) {
     };
     const persistComposerImage = async (input, generation) => {
         syncSession();
-        const attachments = mentionAttachments(ctx);
+        const local = deps.localImages?.();
+        const attachments = local ?? mentionAttachments(ctx);
         if (attachments === undefined)
             throw new Error('image attachments are unavailable in this profile');
         if (generation !== stagedImageEpoch) {
@@ -223,7 +224,7 @@ export function createComposerImages(ctx, owner, deps) {
         stagedImages.set(stageId, attachment);
         if (path !== undefined)
             rememberImagePath(String(attachment.attachmentId), path);
-        const view = transcriptImageFromAttachment(attachment, () => ctx.get('attachments'));
+        const view = local !== undefined ? local.facade(attachment) : transcriptImageFromAttachment(attachment, () => ctx.get('attachments'));
         if (view !== undefined)
             stagedImageViews.set(stageId, view);
         while (stagedImages.size > STAGED_IMAGE_LIMIT) {
@@ -286,7 +287,7 @@ export function createComposerImages(ctx, owner, deps) {
         },
         stagedImageLimits() {
             syncSession();
-            const limits = mentionAttachments(ctx)?.imageLimits;
+            const limits = (deps.localImages?.() ?? mentionAttachments(ctx))?.imageLimits;
             if (limits === undefined)
                 return undefined;
             return {

package/lib/types/dsh-adapter/channel/context-bookkeeping.d.ts

@@ -1,18 +1,10 @@
+import type { ContextOccupancy } from '../../adapter/ports/channel-view.js';
 import type { ComposerImageRef, PendingMessage } from './types.js';
 /** Small mutable cells for Channel-local warning and pending-message state. */
 export declare function createContextBookkeeping(state: () => {
-    contextWindow: number | undefined;
-    tokens: {
-        input: number;
-    };
-    /** Last turn's billed token shape; the honest numerator for the
-     * context-low warning (input alone misses cached reads/writes, which
-     * resumed sessions replay back at full size). */
-    lastUsage: {
-        input: number;
-        cacheRead: number;
-        cacheWrite: number;
-    } | undefined;
+    /** The channel's single occupancy reading (projection first, sample
+     *  fallback) — the honest numerator for the context-low warning. */
+    contextOccupancy: ContextOccupancy | undefined;
     pending: PendingMessage[];
     emit(): void;
 }, notify: (text: string, options: {

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

@@ -1 +1 @@
-{"version":3,"file":"context-bookkeeping.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/context-bookkeeping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAElE,+EAA+E;AAC/E,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM;IACX,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACzB;;qDAEiD;IACjD,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;IAC/E,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,IAAI,IAAI,IAAI,CAAA;CACb,EACD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,EACnF,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,EAC3C,mBAAmB,EAAE,MAAM;;;;+BAyBK,IAAI;+BAtBJ,IAAI;4BAWL;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAA;KAAE,aAAa,cAAc,CAAC,WAAW,CAAC,KAAG,IAAI;gCAK7G,MAAM,KAAG,IAAI;EAQjD"}
+{"version":3,"file":"context-bookkeeping.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/context-bookkeeping.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAElE,+EAA+E;AAC/E,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM;IACX;wEACoE;IACpE,gBAAgB,EAAE,gBAAgB,GAAG,SAAS,CAAA;IAC9C,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,IAAI,IAAI,IAAI,CAAA;CACb,EACD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KAAK,OAAO,EACnF,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,EAC3C,mBAAmB,EAAE,MAAM;;;;+BA6BK,IAAI;+BA1BJ,IAAI;4BAeL;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAA;KAAE,aAAa,cAAc,CAAC,WAAW,CAAC,KAAG,IAAI;gCAK7G,MAAM,KAAG,IAAI;EAQjD"}

package/lib/types/dsh-adapter/channel/context-bookkeeping.js

@@ -3,14 +3,19 @@ export function createContextBookkeeping(state, notify, lowContextText, warningB
     const warning = { value: false };
     const checkContextWarning = () => {
         const channel = state();
-        if (warning.value || channel.contextWindow === undefined || channel.lastUsage === undefined)
+        const occupancy = channel.contextOccupancy;
+        // No window (no route capacity) is the only reason to stay silent: the
+        // numerator is now the projected occupancy, which exists as soon as a
+        // meter (any normal deployment) or one settled request knows anything.
+        if (warning.value || occupancy === undefined || occupancy.contextWindow === undefined)
             return;
-        const used = channel.lastUsage.input + channel.lastUsage.cacheRead + channel.lastUsage.cacheWrite;
-        const remaining = channel.contextWindow - used;
+        if (occupancy.contextWindow <= 0)
+            return;
+        const remaining = occupancy.contextWindow - occupancy.usedTokens;
         if (remaining >= warningBufferTokens)
             return;
         warning.value = true;
-        notify(lowContextText(Math.max(0, Math.round((remaining / channel.contextWindow) * 100))), {
+        notify(lowContextText(Math.max(0, Math.round((remaining / occupancy.contextWindow) * 100))), {
             color: 'warning', timeoutMs: 8000,
         });
     };

package/lib/types/dsh-adapter/channel/core/actions.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The channel's single action install. Every `ChannelUi` action resolves
+ * through these layers, later ones overriding earlier ones:
+ *
+ *   1. unavailable: `capability-unavailable-backend` plus the contract's
+ *      failure value (`createUnavailableActionDelegates`);
+ *   2. a typed session capability, looked up on the bound session at every
+ *      call since a `/new` may land on a session with other capabilities. A
+ *      rejecting capability is reported and returns the action's failure
+ *      value instead of an unhandled rejection;
+ *   3. the backend-neutral core actions (local rows, shell, files,
+ *      completions, `/doctor`, `/export`, `/new`);
+ *   4. the extension's delegates (the DSH extensions).
+ *
+ * The readiness cell installs the merged table once, after every layer
+ * exists, so no construction-time placeholder is ever callable.
+ */
+import type { AgentSession } from '../../../agent/session.js';
+import { type ChannelActionDelegates, type createChannelActionReadiness } from '../action-readiness.js';
+import type { ChannelOwner } from '../owner.js';
+import type { ChannelState } from '../types.js';
+export declare function createCapabilityDelegates(deps: {
+    owner: Pick<ChannelOwner, 'current'>;
+    session(): AgentSession;
+    state: () => Pick<ChannelState, 'provider' | 'backendCapabilities'>;
+    notify: ChannelState['notify'];
+    unavailable(name: string): void;
+    unavailableLines(name: string): string[];
+    guarded<T>(name: string, fallback: T, run: () => Promise<T>): Promise<T>;
+}): Partial<ChannelActionDelegates>;
+/** Merge the layers and install them once. */
+export declare function installChannelActions(readiness: ReturnType<typeof createChannelActionReadiness>, layers: {
+    unavailable(name: string): void;
+    unavailableLines(name: string): string[];
+    capability: Partial<ChannelActionDelegates>;
+    core: Partial<ChannelActionDelegates>;
+    extension: Partial<ChannelActionDelegates> | undefined;
+}): void;
+//# sourceMappingURL=actions.d.ts.map

package/lib/types/dsh-adapter/channel/core/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../../../src/dsh-adapter/channel/core/actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAG7D,OAAO,EAAoC,KAAK,sBAAsB,EAAE,KAAK,4BAA4B,EAAE,MAAM,wBAAwB,CAAA;AACzI,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAA;IACpC,OAAO,IAAI,YAAY,CAAA;IACvB,KAAK,EAAE,MAAM,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,qBAAqB,CAAC,CAAA;IACnE,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAA;IAC9B,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACxC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CACzE,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA0GlC;AAED,8CAA8C;AAC9C,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,UAAU,CAAC,OAAO,4BAA4B,CAAC,EAC1D,MAAM,EAAE;IACN,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACxC,UAAU,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAA;IAC3C,IAAI,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAA;IACrC,SAAS,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,SAAS,CAAA;CACvD,GACA,IAAI,CAON"}

package/lib/types/dsh-adapter/channel/core/actions.js

@@ -0,0 +1,152 @@
+import { conversationRecapPrompt, parseRecapResponse, sideQuestionPrompt } from '../../../channel/side-prompts.js';
+import { t } from '../../../i18n.js';
+import { createUnavailableActionDelegates } from '../action-readiness.js';
+export function createCapabilityDelegates(deps) {
+    const { notify, unavailable, guarded } = deps;
+    const caps = () => deps.session().capabilities;
+    return {
+        compact: () => {
+            const compact = caps().compact;
+            if (compact === undefined) {
+                unavailable('compact');
+                return;
+            }
+            void compact.run().catch((error) => {
+                notify(t('compact-failed', { err: error instanceof Error ? error.message : String(error) }), { color: 'error' });
+            });
+        },
+        cycleMode: () => guarded('mode', undefined, async () => {
+            const modes = caps().modes;
+            if (modes === undefined) {
+                unavailable('mode');
+                return;
+            }
+            // The reflex key walks the backend's declared cycle surface when it is
+            // narrower than the roster (Claude keeps `bypassPermissions`
+            // picker-only); a backend that declares none cycles the full list.
+            const list = modes.cycle?.() ?? modes.list();
+            if (list.length === 0)
+                return;
+            const index = list.findIndex(mode => mode.id === modes.current());
+            await modes.set(list[(index + 1) % list.length].id);
+        }),
+        listModels: () => guarded('model', [], async () => {
+            const models = caps().models;
+            if (models === undefined) {
+                unavailable('model');
+                return [];
+            }
+            // One provider: the backend itself (the picker drills straight into
+            // its models; `/model <id>` needs no provider segment).
+            const provider = deps.state().provider;
+            return (await models.list()).map(model => ({ provider: model.provider ?? provider, id: model.id, name: model.label, ...(model.description === undefined ? {} : { description: model.description }) }));
+        }),
+        switchModel: (provider, model) => guarded('model', false, async () => {
+            const models = caps().models;
+            if (models === undefined) {
+                unavailable('model');
+                return false;
+            }
+            const state = deps.state();
+            const own = provider === '' || provider === state.backendCapabilities.backendLabel || provider === state.provider;
+            const outcome = await models.set({ ...(own ? {} : { provider }), model });
+            if (outcome.kind === 'refused')
+                notify(outcome.reason, { color: 'warning' });
+            return outcome.kind === 'switched';
+        }),
+        listEfforts: () => {
+            const effort = caps().effort;
+            if (effort === undefined) {
+                unavailable('effort');
+                return Promise.resolve({ efforts: [], defaultEffort: undefined });
+            }
+            const levels = effort.levels();
+            // The slider relies on this call to explain why it cannot open (Chat
+            // returns silently for <= 1 tiers), so a route with zero or one effort
+            // tier gets the same warning the DSH extension shows.
+            if (levels.length === 0)
+                notify(t('effort-unsupported'), { color: 'warning' });
+            else if (levels.length === 1)
+                notify(t('effort-single-tier', { name: levels[0].label }), { color: 'warning' });
+            // levelsFallback is passed on when the backend marks the ladder as the
+            // CLI-standard fallback (the model row declares no tiers of its own), so
+            // the slider can say so instead of presenting them as the model's tiers.
+            return Promise.resolve({ efforts: levels.map(level => ({ id: level.id, name: level.label })), defaultEffort: effort.current(), ...(effort.levelsFallback === true ? { levelsFallback: true } : {}) });
+        },
+        setEffort: id => guarded('effort', false, async () => {
+            const effort = caps().effort;
+            if (effort === undefined || !effort.levels().some(level => level.id === id)) {
+                unavailable('effort');
+                return false;
+            }
+            await effort.set(id);
+            return true;
+        }),
+        // `/btw`: the backend's side call with the shared side-question contract.
+        sideQuestion: async (question, options) => {
+            const side = caps().sideQuery;
+            if (side === undefined) {
+                unavailable('btw');
+                return { answer: null, error: deps.unavailableLines('btw').join(' ') };
+            }
+            try {
+                return { ...await side.ask(sideQuestionPrompt(question), options) };
+            }
+            catch (error) {
+                return { answer: null, error: error instanceof Error ? error.message : String(error) };
+            }
+        },
+        // `/recap`: the same side call over the conversation itself, read back
+        // as a one-line summary plus a proposed title.
+        recapRecent: async (options) => {
+            const side = caps().sideQuery;
+            if (side === undefined) {
+                unavailable('recap');
+                return { summary: null, error: deps.unavailableLines('recap').join(' ') };
+            }
+            try {
+                const outcome = await side.ask(conversationRecapPrompt(), options);
+                if (outcome.answer === null)
+                    return { summary: null, ...(outcome.error === undefined ? {} : { error: outcome.error }) };
+                const parsed = parseRecapResponse(outcome.answer);
+                return { summary: parsed.summary, ...(parsed.title === undefined ? {} : { title: parsed.title }) };
+            }
+            catch (error) {
+                return { summary: null, error: error instanceof Error ? error.message : String(error) };
+            }
+        },
+        renameSession: title => {
+            const rename = caps().rename;
+            if (rename === undefined) {
+                unavailable('rename');
+                return;
+            }
+            void rename.rename(title).catch((error) => {
+                if (deps.owner.current())
+                    notify(t('rename-failed', { err: error instanceof Error ? error.message : String(error) }), { color: 'error', timeoutMs: 8000 });
+            });
+        },
+        setSessionColor: color => {
+            const accent = caps().color;
+            if (accent === undefined) {
+                unavailable('color');
+                return;
+            }
+            try {
+                accent.set(color);
+            }
+            catch (error) {
+                notify(t('capability-failed', { name: 'color', err: error instanceof Error ? error.message : String(error) }), { color: 'error', timeoutMs: 8000 });
+            }
+        },
+    };
+}
+/** Merge the layers and install them once. */
+export function installChannelActions(readiness, layers) {
+    readiness.install({
+        ...createUnavailableActionDelegates(layers.unavailable, layers.unavailableLines),
+        ...layers.capability,
+        ...layers.core,
+        ...layers.extension,
+    });
+}

package/lib/types/dsh-adapter/channel/core/binding-feed.d.ts

@@ -0,0 +1,145 @@
+/**
+ * A channel's transcript feed, for any backend: the shared projector, the
+ * session-batch router that is its only writer, and the bind that follows
+ * the bound session.
+ *
+ * `bind(seed?)` advances the binding generation, resets input convergence,
+ * links the session's prompts to the stores Chat renders, and subscribes the
+ * router to the captured session. By default it also paints the session's
+ * durable history and seeds the session-level facts from the session's
+ * capabilities. The history is the `seed` the caller read before the
+ * adoption (a resume reads `history()` ahead of the synchronous adopt). It
+ * is painted synchronously before the subscription, so no live event can
+ * land ahead of it. Without a seed the history is read once,
+ * asynchronously, and dropped if live rows painted first. An extension that
+ * owns those facts and replays its seed synchronously itself (DSH) sets
+ * `ownsSessionFacts`, and adds its raw per-binding listeners through
+ * `onBind`.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { AgentEvent, AgentEventMeta, AgentEventOf } from '../../../agent/events.js';
+import type { AgentSession } from '../../../agent/session.js';
+import { type ChannelProjection, type ChannelProjectionDeps } from '../../../channel/projection.js';
+import type { BindingCapture, ChannelBinding } from '../binding.js';
+import type { InputConvergence } from '../input-actions.js';
+import type { ChannelOwner } from '../owner.js';
+import type { ChannelLaunchOptions } from '../state.js';
+import type { ChannelState } from '../types.js';
+import type { SessionControls } from './session-controls.js';
+/** What one bind hands an extension's per-binding listeners. */
+export interface BindingScope {
+    readonly capture: BindingCapture;
+    /** Owner live and the binding still the captured one (ABA-safe). */
+    current(): boolean;
+    /** Own a listener for this binding period (released on the next adoption). */
+    register<T extends () => void>(dispose: T): T;
+}
+/** Extension points of the feed (all optional; see the module comment). */
+export interface BindingFeedHooks {
+    /** Right after the generation advances (DSH: owner-level child listeners). */
+    onGeneration?(): void;
+    /** After input convergence resets, before the session subscription. */
+    onBind?(scope: BindingScope): void;
+    /** After the bind returned (outside its rollback). */
+    afterBind?(): void;
+    /** The extension maintains the session-level facts and replays its seed
+     *  synchronously: no history repaint, no capability observer. */
+    readonly ownsSessionFacts?: boolean;
+    /** Forget the bound session's translator state with the projector's. */
+    resetTranslation?(): void;
+}
+/**
+ * The one session-batch writer path, shared by every channel composition:
+ * binding-generation fence over the whole batch, session status and
+ * pending-queue bookkeeping, compaction-progress gating, then the shared
+ * projector and the renderer wake the backend asked for.
+ */
+export declare function createSessionBatchRouter(deps: {
+    state: ChannelState;
+    projector: ChannelProjection;
+    inputConvergence: InputConvergence;
+    /** Drop channel-side context attached to a discarded input (DSH pre-step
+     *  attachments); absent where nothing is ever attached. */
+    retireAttachment?(messageId: string): void;
+    /** The backend reset the conversation in place (`session.reset`, live):
+     *  the events before it in the batch are projected first, those after it
+     *  land on the cleared view. Absent = the event is projected (ignored). */
+    onReset?(event: AgentEventOf<'session.reset'>): void;
+    warn(message: string): void;
+}): {
+    route: (batch: readonly AgentEvent[], meta: AgentEventMeta, current: () => boolean) => void;
+    reconcileRetiredProjection: (status: "idle" | "disposed") => void;
+    turnStarts: () => number;
+};
+/**
+ * The bind that follows the bound session: shared by the channel feed below
+ * and the DSH binding-events owner (which direct regressions drive alone).
+ */
+export declare function createSessionBinder(deps: {
+    owner: ChannelOwner;
+    binding: Pick<ChannelBinding, 'bind' | 'capture' | 'isCurrent' | 'subscribe'>;
+    state: Pick<ChannelState, 'agentBindingGeneration' | 'status'>;
+    inputConvergence: InputConvergence;
+    route(batch: readonly AgentEvent[], meta: AgentEventMeta, current: () => boolean): void;
+    hooks(): BindingFeedHooks;
+    /** Forget the core's trajectory fold before the seed replay paints (a
+     * session swap starts an empty raw-event log, exactly like the rows). */
+    resetTrajectory?(): void;
+    /** The stores a session's prompts park in (`ChannelLaunchOptions.interaction`). */
+    interaction?: ChannelLaunchOptions['interaction'];
+    /** The session-level facts kept unless the extension owns them. */
+    facts?: {
+        observe(batch: readonly AgentEvent[], session: AgentSession, current: () => boolean): void;
+        /** Paint the history read ahead of the bind (before the subscription). */
+        replay(history: readonly AgentEvent[]): void;
+        /** After the subscription: `replayed` = the history was already painted. */
+        seed(capture: BindingCapture, current: () => boolean, replayed: boolean): void;
+    };
+}): {
+    bind: (seed?: readonly AgentEvent[]) => void;
+};
+export declare function createBindingFeed(ctx: Context, deps: {
+    owner: ChannelOwner;
+    binding: ChannelBinding;
+    state: ChannelState;
+    options: Pick<ChannelLaunchOptions, 'interaction'>;
+    inputConvergence: InputConvergence;
+    /** The projector's channel-side dependencies; `jobs` and `pricingWindow`
+     *  stay writable until the channel starts (`configureProjection`). */
+    projection: Omit<ChannelProjectionDeps, 'inputConvergence'>;
+    retireAttachment(messageId: string): void;
+    controls: SessionControls;
+    hooks(): BindingFeedHooks;
+    /** A live `session.reset` (see createSessionBatchRouter). */
+    onReset?(event: AgentEventOf<'session.reset'>): void;
+    /** Passed to the binder: resets the core trajectory fold per bind. */
+    resetTrajectory?(): void;
+}): {
+    projector: {
+        apply: (events: readonly AgentEvent[], meta: AgentEventMeta) => void;
+        reset: () => void;
+        settleStreaming: () => void;
+        updateSpinnerMode: () => void;
+        contextUsage: () => {
+            readonly type: "context.usage";
+            readonly used: number;
+            readonly max?: number;
+            readonly categories?: readonly {
+                readonly name: string;
+                readonly tokens: number;
+                readonly kind: string;
+            }[];
+        } | undefined;
+    };
+    router: {
+        route: (batch: readonly AgentEvent[], meta: AgentEventMeta, current: () => boolean) => void;
+        reconcileRetiredProjection: (status: "idle" | "disposed") => void;
+        turnStarts: () => number;
+    };
+    bind: (seed?: readonly AgentEvent[]) => void;
+    resetProjection: () => void;
+    /** Install the backend's job-registry feed and pricing policy (before start). */
+    configureProjection(update: Partial<Pick<ChannelProjectionDeps, "jobs" | "pricingWindow">>): void;
+};
+export type BindingFeed = ReturnType<typeof createBindingFeed>;
+//# sourceMappingURL=binding-feed.d.ts.map

package/lib/types/dsh-adapter/channel/core/binding-feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-feed.d.ts","sourceRoot":"","sources":["../../../../../src/dsh-adapter/channel/core/binding-feed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAE7D,OAAO,EAA2B,KAAK,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AAE5H,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAE5D,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAA;IAChC,oEAAoE;IACpE,OAAO,IAAI,OAAO,CAAA;IAClB,8EAA8E;IAC9E,QAAQ,CAAC,CAAC,SAAS,MAAM,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAA;CAC9C;AAED,2EAA2E;AAC3E,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,YAAY,CAAC,IAAI,IAAI,CAAA;IACrB,uEAAuE;IACvE,MAAM,CAAC,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;IAClC,sDAAsD;IACtD,SAAS,CAAC,IAAI,IAAI,CAAA;IAClB;qEACiE;IACjE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IACnC,wEAAwE;IACxE,gBAAgB,CAAC,IAAI,IAAI,CAAA;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,YAAY,CAAA;IACnB,SAAS,EAAE,iBAAiB,CAAA;IAC5B,gBAAgB,EAAE,gBAAgB,CAAA;IAClC;+DAC2D;IAC3D,gBAAgB,CAAC,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1C;;+EAE2E;IAC3E,OAAO,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,eAAe,CAAC,GAAG,IAAI,CAAA;IACpD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;mBAmDuB,SAAS,UAAU,EAAE,QAAQ,cAAc,WAAW,MAAM,OAAO,KAAG,IAAI;yCAlDpD,MAAM,GAAG,UAAU,KAAG,IAAI;sBA8GV,MAAM;EACnE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,KAAK,EAAE,YAAY,CAAA;IACnB,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC,CAAA;IAC7E,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,wBAAwB,GAAG,QAAQ,CAAC,CAAA;IAC9D,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,KAAK,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI,CAAA;IACvF,KAAK,IAAI,gBAAgB,CAAA;IACzB;6EACyE;IACzE,eAAe,CAAC,IAAI,IAAI,CAAA;IACxB,mFAAmF;IACnF,WAAW,CAAC,EAAE,oBAAoB,CAAC,aAAa,CAAC,CAAA;IACjD,mEAAmE;IACnE,KAAK,CAAC,EAAE;QACN,OAAO,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,OAAO,GAAG,IAAI,CAAA;QAC1F,0EAA0E;QAC1E,MAAM,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI,CAAA;QAC5C,4EAA4E;QAC5E,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,OAAO,EAAE,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAA;KAC/E,CAAA;CACF;kBAWsB,SAAS,UAAU,EAAE,KAAG,IAAI;EAgDlD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;IACpD,KAAK,EAAE,YAAY,CAAA;IACnB,OAAO,EAAE,cAAc,CAAA;IACvB,KAAK,EAAE,YAAY,CAAA;IACnB,OAAO,EAAE,IAAI,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAA;IAClD,gBAAgB,EAAE,gBAAgB,CAAA;IAClC;0EACsE;IACtE,UAAU,EAAE,IAAI,CAAC,qBAAqB,EAAE,kBAAkB,CAAC,CAAA;IAC3D,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACzC,QAAQ,EAAE,eAAe,CAAA;IACzB,KAAK,IAAI,gBAAgB,CAAA;IACzB,6DAA6D;IAC7D,OAAO,CAAC,CAAC,KAAK,EAAE,YAAY,CAAC,eAAe,CAAC,GAAG,IAAI,CAAA;IACpD,sEAAsE;IACtE,eAAe,CAAC,IAAI,IAAI,CAAA;CACzB;;;;;;;;;;;;;;;;;;uBApKuB,SAAS,UAAU,EAAE,QAAQ,cAAc,WAAW,MAAM,OAAO,KAAG,IAAI;6CAlDpD,MAAM,GAAG,UAAU,KAAG,IAAI;0BA8GV,MAAM;;kBAsC7C,SAAS,UAAU,EAAE,KAAG,IAAI;2BAsFrB,IAAI;IAkE9B,iFAAiF;gCACrD,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,MAAM,GAAG,eAAe,CAAC,CAAC,GAAG,IAAI;EAKpG;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA"}