@deepseek-harness-tui/dsh-tui 0.10.2 → 0.11.0

package/lib/types/dsh-adapter/bundled-presets.js

@@ -0,0 +1,80 @@
+import { readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { parse } from 'yaml';
+import { packagedPresetRoot } from './packaged-presets.js';
+function declarativePresets(ctx) {
+    const service = ctx.get('agentPresets');
+    return service !== null && typeof service === 'object'
+        && 'register' in service && typeof service.register === 'function'
+        ? service
+        : undefined;
+}
+/** Preserve the Loader's expressions; only the owning plugin may evaluate them. */
+function readPresetPatch(path) {
+    const patches = parse(readFileSync(path, 'utf8'), {
+        customTags: [{ tag: 'tag:yaml.org,2002:js', resolve: (value) => ({ __jsExpr: value }) }],
+    });
+    if (Array.isArray(patches) && patches.length === 1) {
+        const row = patches[0]?.insert?.[0];
+        if (row?.name === '@deepseek-ai/dsh-agent-preset'
+            && typeof row.config?.id === 'string' && Array.isArray(row.config.plugins)) {
+            return row.config;
+        }
+    }
+    throw new Error(`dsh-tui: invalid upstream preset declaration: ${path}`);
+}
+/**
+ * 0.1.7 removed directory discovery. Consume the official bundle definitions
+ * through its registry, without copying or reimplementing their tool sets.
+ * Web/profile declarations own their seats even while still activating.
+ * Returns false on the legacy directory-backed roster or while absent. An
+ * absent service is watched through Cordis so a late registry is not missed.
+ */
+export async function registerBundledPresets(ctx) {
+    if (ctx.get('agentPresets') === undefined) {
+        ctx.inject(['agentPresets'], async (ready) => {
+            await registerBundledPresets(ready);
+        });
+        return false;
+    }
+    if (declarativePresets(ctx) === undefined)
+        return false;
+    const declared = new Set();
+    const loader = ctx.get('loader');
+    for (const entry of loader?.entries() ?? []) {
+        if (entry.disabled || entry.options.name !== '@deepseek-ai/dsh-agent-preset')
+            continue;
+        const config = entry.options.config;
+        if (config !== null && typeof config === 'object' && 'id' in config && typeof config.id === 'string') {
+            declared.add(config.id);
+        }
+    }
+    const require = createRequire(ctx.baseUrl ?? import.meta.url);
+    for (const id of ['standard', 'ptc', 'minimal', 'cordis']) {
+        if (declared.has(id))
+            continue;
+        const path = require.resolve(`@deepseek-ai/dsh-web-app/presets/${id}.patch.yml`);
+        const owner = ctx.extend({ baseUrl: pathToFileURL(path).href });
+        const dispose = await declarativePresets(owner).register(readPresetPatch(path));
+        ctx.effect(() => dispose);
+    }
+    if (!declared.has('liangshen')) {
+        const root = join(packagedPresetRoot(), 'liangshen');
+        const metadata = parse(readFileSync(join(root, 'preset.yml'), 'utf8'));
+        const dispose = await declarativePresets(ctx).register({
+            id: 'liangshen',
+            name: metadata.name,
+            description: metadata.description,
+            order: metadata.order,
+            plugins: [{
+                    id: 'liangshen-plugins',
+                    name: '@deepseek-ai/cordis-plugin-include',
+                    config: { path: pathToFileURL(join(root, 'agent.cordis.yml')).href },
+                }],
+        });
+        ctx.effect(() => dispose);
+    }
+    return true;
+}

package/lib/types/dsh-adapter/channel/action-readiness.d.ts

@@ -4,7 +4,7 @@ import type { ChannelState } from './types.js';
  * specialist has been constructed.  Construction-time callers fail closed
  * rather than receiving a plausible no-op while the Channel is incomplete.
  */
-export type ChannelActionDelegates = Pick<ChannelState, 'commandCompletions' | 'loadOlder' | 'rewindTo' | 'rewindToNode' | 'forkSession' | 'resumeTo' | 'newSession' | 'listWorkspaces' | 'resolveWorkspace' | 'switchWorkspace' | 'renameWorkspace' | 'workspaceCommands' | 'runWorkspaceCommand' | 'switchModel' | 'listEfforts' | 'setEffort' | 'setDefaultEffort' | 'cycleMode' | 'runPermissionPreset' | 'clear' | 'setActivityFrames' | 'listPresets' | 'switchPreset' | 'listModels' | 'listProviders' | 'invalidateModelCompletion' | 'listSkills' | 'describeCredential' | 'balanceInfo' | 'sideQuestion' | 'listFileCandidates' | 'listFiles' | 'listSessions' | 'previewSession' | 'bindApprovalStore' | 'agentViewRows' | 'subscribeAgentView' | 'dispatchBackgroundAgent' | 'stopBackgroundAgent' | 'attachToAgent' | 'peekAgentSession' | 'replyToAgent' | 'backgroundCurrent' | 'setResumeTarget' | 'renameSession' | 'setSessionColor' | 'recapRecent' | 'deleteSession' | 'renameSessionTo' | 'compact' | 'runExternalCommand' | 'runExternalCommandOutcome' | 'pushLocal' | 'mcpStatus' | 'exportSession' | 'initWorkspace' | 'doctorInfo' | 'pluginsInfo' | 'listSubagents'> & {
+export type ChannelActionDelegates = Pick<ChannelState, 'commandCompletions' | 'loadOlder' | 'rewindTo' | 'rewindToNode' | 'forkSession' | 'resumeTo' | 'newSession' | 'listWorkspaces' | 'listWorkspaceRegistry' | 'removeWorkspace' | 'renameWorkspaceAt' | 'resolveWorkspace' | 'switchWorkspace' | 'renameWorkspace' | 'workspaceCommands' | 'runWorkspaceCommand' | 'switchModel' | 'listEfforts' | 'setEffort' | 'setDefaultEffort' | 'cycleMode' | 'runPermissionPreset' | 'clear' | 'setActivityFrames' | 'listPresets' | 'switchPreset' | 'listModels' | 'listProviders' | 'invalidateModelCompletion' | 'listSkills' | 'describeCredential' | 'balanceInfo' | 'sideQuestion' | 'listFileCandidates' | 'listFiles' | 'listSessions' | 'previewSession' | 'bindApprovalStore' | 'agentViewRows' | 'subscribeAgentView' | 'dispatchBackgroundAgent' | 'stopBackgroundAgent' | 'attachToAgent' | 'peekAgentSession' | 'replyToAgent' | 'backgroundCurrent' | 'setResumeTarget' | 'renameSession' | 'setSessionColor' | 'recapRecent' | 'deleteSession' | 'renameSessionTo' | 'compact' | 'runExternalCommand' | 'runExternalCommandOutcome' | 'pushLocal' | 'mcpStatus' | 'exportSession' | 'initWorkspace' | 'doctorInfo' | 'pluginsInfo' | 'listSubagents'> & {
     runLocalCommand(command: string, includeInContext: boolean): Promise<void>;
 };
 type ChannelActionMethodName = Exclude<keyof ChannelActionDelegates, 'runLocalCommand'>;

package/lib/types/dsh-adapter/channel/action-readiness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-readiness.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/action-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,YAAY,EAClD,oBAAoB,GACpB,WAAW,GACX,UAAU,GACV,cAAc,GACd,aAAa,GACb,UAAU,GACV,YAAY,GACZ,gBAAgB,GAChB,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,qBAAqB,GACrB,aAAa,GACb,aAAa,GACb,WAAW,GACX,kBAAkB,GAClB,WAAW,GACX,qBAAqB,GACrB,OAAO,GACP,mBAAmB,GACnB,aAAa,GACb,cAAc,GACd,YAAY,GACZ,eAAe,GACf,2BAA2B,GAC3B,YAAY,GACZ,oBAAoB,GACpB,aAAa,GACb,cAAc,GACd,oBAAoB,GACpB,WAAW,GACX,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,GACf,oBAAoB,GACpB,yBAAyB,GACzB,qBAAqB,GACrB,eAAe,GACf,kBAAkB,GAClB,cAAc,GACd,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,GACf,iBAAiB,GACjB,aAAa,GACb,eAAe,GACf,iBAAiB,GACjB,SAAS,GACT,oBAAoB,GACpB,2BAA2B,GAC3B,WAAW,GACX,WAAW,GACX,eAAe,GACf,eAAe,GACf,YAAY,GACZ,aAAa,GACb,eAAe,CAClB,GAAG;IACF,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3E,CAAA;AAED,KAAK,uBAAuB,GAAG,OAAO,CAAC,MAAM,sBAAsB,EAAE,iBAAiB,CAAC,CAAA;AACvF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAA;AAE9E;4EAC4E;AAC5E,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,sBAAsB,GAC5C,oBAAoB,CAiEtB;AAED,wBAAgB,4BAA4B;kBAG1B,sBAAsB,GAAG,IAAI;uBAIxB,sBAAsB;EAK5C"}
+{"version":3,"file":"action-readiness.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/action-readiness.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,YAAY,EAClD,oBAAoB,GACpB,WAAW,GACX,UAAU,GACV,cAAc,GACd,aAAa,GACb,UAAU,GACV,YAAY,GACZ,gBAAgB,GAChB,uBAAuB,GACvB,iBAAiB,GACjB,mBAAmB,GACnB,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,GACjB,mBAAmB,GACnB,qBAAqB,GACrB,aAAa,GACb,aAAa,GACb,WAAW,GACX,kBAAkB,GAClB,WAAW,GACX,qBAAqB,GACrB,OAAO,GACP,mBAAmB,GACnB,aAAa,GACb,cAAc,GACd,YAAY,GACZ,eAAe,GACf,2BAA2B,GAC3B,YAAY,GACZ,oBAAoB,GACpB,aAAa,GACb,cAAc,GACd,oBAAoB,GACpB,WAAW,GACX,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,GACf,oBAAoB,GACpB,yBAAyB,GACzB,qBAAqB,GACrB,eAAe,GACf,kBAAkB,GAClB,cAAc,GACd,mBAAmB,GACnB,iBAAiB,GACjB,eAAe,GACf,iBAAiB,GACjB,aAAa,GACb,eAAe,GACf,iBAAiB,GACjB,SAAS,GACT,oBAAoB,GACpB,2BAA2B,GAC3B,WAAW,GACX,WAAW,GACX,eAAe,GACf,eAAe,GACf,YAAY,GACZ,aAAa,GACb,eAAe,CAClB,GAAG;IACF,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3E,CAAA;AAED,KAAK,uBAAuB,GAAG,OAAO,CAAC,MAAM,sBAAsB,EAAE,iBAAiB,CAAC,CAAA;AACvF,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAA;AAE9E;4EAC4E;AAC5E,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,MAAM,sBAAsB,GAC5C,oBAAoB,CAoEtB;AAED,wBAAgB,4BAA4B;kBAG1B,sBAAsB,GAAG,IAAI;uBAIxB,sBAAsB;EAK5C"}

package/lib/types/dsh-adapter/channel/action-readiness.js

@@ -10,6 +10,9 @@ export function createChannelActionMethods(getReadyActions) {
         resumeTo: sessionId => getReadyActions().resumeTo(sessionId),
         newSession: () => getReadyActions().newSession(),
         listWorkspaces: () => getReadyActions().listWorkspaces(),
+        listWorkspaceRegistry: () => getReadyActions().listWorkspaceRegistry(),
+        removeWorkspace: path => getReadyActions().removeWorkspace(path),
+        renameWorkspaceAt: (path, title) => getReadyActions().renameWorkspaceAt(path, title),
         resolveWorkspace: uri => getReadyActions().resolveWorkspace(uri),
         // Preserve ChannelUi's promise rejection contract after release: a caller
         // which already received this async method must observe a rejected promise,

package/lib/types/dsh-adapter/channel/agent-view-projection.d.ts

@@ -18,7 +18,7 @@ type ApprovalStore = {
 /** Owns detached background handles and the agent-view projection. */
 export declare function createAgentViewProjection(ctx: Context, deps: {
     owner: Pick<ChannelOwner, 'current' | 'assertActive' | 'own'>;
-    binding: Pick<Binding, 'agent' | 'capture' | 'isCurrent' | 'prepare' | 'abandon'>;
+    binding: Pick<Binding, 'agent' | 'capture' | 'isCurrent' | 'prepare' | 'abandon' | 'waitForDisposal'>;
     cwd(): string;
     configuredPreset?: string;
     configuredProvider?: string;

package/lib/types/dsh-adapter/channel/agent-view-projection.d.ts.map

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

package/lib/types/dsh-adapter/channel/agent-view-projection.js

@@ -9,6 +9,7 @@ import { t } from '../../i18n.js';
 import { AGENT_VIEW_STATUS_ORDER, agentViewLivePreview, agentViewStatusOf, foldAgentViewEvents, oneLine, sessionTitleFallback, } from '../agent-view.js';
 import { snapshotLiveSessionEvents } from '../compat/liveSession.js';
 import { composePreset } from '../presets.js';
+import { reserveNewSession } from '../../sessionMounts.js';
 import { locateSession, previewSession } from '../sessions/index.js';
 import { attachSessionToWorkspace } from '../workspace.js';
 import { logForDebugging } from '../../utils/debug.js';
@@ -75,7 +76,7 @@ export function createAgentViewProjection(ctx, deps) {
         // These process-wide roster observations still belong to this channel
         // owner. Revoke them so a retained Context cannot wake a dead projection.
         disposeStatus = ctx.on('agent/status', () => schedule());
-        disposeCreated = ctx.on('agent/created', () => notify());
+        disposeCreated = ctx.on('agent/created', () => { notify(); });
         disposeDisposed = ctx.on('agent/disposed', ({ agent }) => {
             folds.delete(String(agent.id ?? ''));
             backgroundHandles.delete(String(agent.id ?? ''));
@@ -133,6 +134,10 @@ export function createAgentViewProjection(ctx, deps) {
             return { ok: false, reason: 'unavailable' };
         }
         const sessionId = SessionId(randomUUID());
+        // Announce the id before the factory: the background session's log is
+        // created here, and the publisher only learns the id from the registry on
+        // its next beat.
+        const { reservation } = await reserveNewSession(String(sessionId));
         let detached;
         try {
             deps.owner.assertActive();
@@ -149,12 +154,14 @@ export function createAgentViewProjection(ctx, deps) {
             }));
         }
         catch (error) {
+            reservation.abandon();
             const message = error instanceof Error ? error.message : String(error);
             deps.notify(t('agentview-dispatch-failed', { err: message }), { color: 'error', timeoutMs: 8000 });
             return { ok: false, reason: 'failed', error: message };
         }
         if (!deps.owner.current()) {
             await detached.release();
+            reservation.abandon();
             return { ok: false, reason: 'failed', error: 'Channel lifetime ended' };
         }
         try {
@@ -163,10 +170,14 @@ export function createAgentViewProjection(ctx, deps) {
         catch { /* optional ledger */ }
         if (!deps.owner.current()) {
             await detached.release();
+            reservation.abandon();
             return { ok: false, reason: 'failed', error: 'Channel lifetime ended' };
         }
         detached.transfer();
         backgroundHandles.set(String(sessionId), detached.handle);
+        // The session is this process's background handle from here on, so the
+        // reservation has done its job: the registry is the authority now.
+        reservation.settle();
         touchAgentViewSession(String(sessionId));
         touchSession(sessionId);
         // transfer intentionally moves disposal to the background ledger; check
@@ -209,13 +220,19 @@ export function createAgentViewProjection(ctx, deps) {
     const attach = async (sessionId) => {
         if (sessionId === String(deps.binding.agent.session.id))
             return { ok: true };
+        const capture = deps.binding.capture();
+        // A retiring Agent can remain in the registry until its JSONL writer has
+        // drained. Read the live target only after that close, just like /resume.
+        await deps.binding.waitForDisposal(sessionId);
+        if (!deps.binding.isCurrent(capture))
+            return { ok: false, reason: 'cancelled' };
         // Capture the exact live target before the async host decision. If the
         // registry replaces it while parked, never silently adopt that arbitrary
         // replacement; a later user action can make a fresh, explicit choice.
         const live = agents()?.get(SessionId(sessionId));
         if (await deps.sessionSwitchVetoed('agent-view', sessionId))
             return { ok: false, reason: 'cancelled' };
-        if (live !== undefined && agents()?.get(SessionId(sessionId)) !== live)
+        if (!deps.binding.isCurrent(capture) || agents()?.get(SessionId(sessionId)) !== live)
             return { ok: false, reason: 'cancelled' };
         return live === undefined ? deps.resumeInto(sessionId, 'agent-view', true) : deps.adoptLive(live);
     };

package/lib/types/dsh-adapter/channel/background-action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"background-action.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/background-action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,wBAAwB,CAAA;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAUlD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEhE,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEtD;iFACiF;AACjF,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,IAAI,CAAC,YAAY,EACtB,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,GAAG,eAAe,GAChE,cAAc,GAAG,iBAAiB,GAAG,MAAM,GAAG,QAAQ,CAAC,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,EACxG,OAAO,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC9H,IAAI,EAAE;IACJ,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAA;IACpC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,CAAA;IACjF,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IAC3C,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACzB,cAAc,IAAI,IAAI,CAAA;IACtB,cAAc,IAAI,IAAI,CAAA;IACtB,SAAS,IAAI,IAAI,CAAA;IACjB,mBAAmB,IAAI,IAAI,CAAA;IAC3B,SAAS,IAAI,IAAI,CAAA;IACjB,eAAe,IAAI,IAAI,CAAA;IACvB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,iBAAiB,IAAI,IAAI,CAAA;IACzB,qBAAqB,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7F,4EAA4E;IAC5E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAA;IAC5F,eAAe,IAAI,IAAI,CAAA;CACxB,GACA,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAwEjC"}
+{"version":3,"file":"background-action.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/background-action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAsB,MAAM,wBAAwB,CAAA;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAYlD,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEhE,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEtD;iFACiF;AACjF,wBAAgB,6BAA6B,CAC3C,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,IAAI,CAAC,YAAY,EACtB,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,eAAe,GAAG,eAAe,GAChE,cAAc,GAAG,iBAAiB,GAAG,MAAM,GAAG,QAAQ,CAAC,GAAG,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,EACxG,OAAO,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAC9H,IAAI,EAAE;IACJ,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAA;IACpC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC,CAAA;IACjF,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IAC3C,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IACzB,cAAc,IAAI,IAAI,CAAA;IACtB,cAAc,IAAI,IAAI,CAAA;IACtB,SAAS,IAAI,IAAI,CAAA;IACjB,mBAAmB,IAAI,IAAI,CAAA;IAC3B,SAAS,IAAI,IAAI,CAAA;IACjB,eAAe,IAAI,IAAI,CAAA;IACvB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACrC,iBAAiB,IAAI,IAAI,CAAA;IACzB,qBAAqB,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7F,4EAA4E;IAC5E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAA;IAC5F,eAAe,IAAI,IAAI,CAAA;CACxB,GACA,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAwFjC"}

package/lib/types/dsh-adapter/channel/background-action.js

@@ -5,6 +5,8 @@ import { readModelPref } from '../../modelPrefs.js';
 import { readPresetPref } from '../../presetPrefs.js';
 import { clearResumeTarget, touchAgentViewSession, touchSession } from '../../sessionHistory.js';
 import { t } from '../../i18n.js';
+import { reserveMount } from '../../sessionMounts.js';
+import { mountFailureText } from '../../sessions/resumeFailure.js';
 import { composePreset } from '../presets.js';
 import { attachSessionToWorkspace } from '../workspace.js';
 import { resetSessionProjection } from './session-reset.js';
@@ -19,6 +21,13 @@ export function createBackgroundCurrentAction(ctx, state, options, deps) {
             return { ok: false, reason: 'unavailable' };
         }
         const sessionId = SessionId(randomUUID());
+        // Reserve before the factory: from the moment `agents.create` returns this
+        // process holds the only write handle on a log the publisher has not named
+        // yet, and a peer listing sessions in that gap would be told it is free.
+        const reserved = await reserveMount(sessionId);
+        if (!reserved.ok && reserved.reason !== 'occupied')
+            deps.notify(mountFailureText(reserved), { color: 'warning', timeoutMs: 8000 });
+        const reservation = reserved.ok ? reserved.reservation : { settle: () => { }, abandon: () => { } };
         try {
             const composed = await composePreset(ctx, options.configuredPreset ?? readPresetPref());
             const route = await validateModelRoute(ctx.get('llm'), resolveModelRoute({ provider: options.configuredProvider, model: options.configuredModel }, readModelPref(), { provider: options.provider, model: options.model }), { provider: options.provider, model: options.model });
@@ -30,6 +39,7 @@ export function createBackgroundCurrentAction(ctx, state, options, deps) {
             }));
             if (!deps.binding.isCurrent(adoption)) {
                 await deps.binding.abandon(handle);
+                reservation.abandon();
                 return { ok: false, reason: 'failed', error: 'Channel lifetime ended' };
             }
             try {
@@ -45,39 +55,52 @@ export function createBackgroundCurrentAction(ctx, state, options, deps) {
             // agent; the prepared candidate is abandoned instead.
             if (!deps.binding.isCurrent(adoption)) {
                 await deps.binding.abandon(handle);
+                reservation.abandon();
                 return { ok: false, reason: 'failed', error: 'Channel lifetime ended' };
             }
-            return deps.binding.adopt(handle, adoption, (previous, disposePrevious) => {
-                const previousSessionId = String(previous.agent.session.id);
-                if (previous.handle !== undefined) {
-                    deps.backgroundHandles.set(previousSessionId, previous.handle);
-                    disposePrevious('park');
-                }
-                resetSessionProjection(state, deps.rowIds, deps.resetProjector, deps.resetSubagents, deps.resetJobs);
-                state.status = handle.agent.status;
-                state.agentId = handle.agent.id;
-                state.loadedContext = undefined;
-                state.contextWindow = undefined;
-                state.effortLevels = undefined;
-                state.reasoningEffort = undefined;
-                deps.refreshEffortLevels();
-                // Reset the input FIFO and pending-decision indicators BEFORE the first
-                // emit (main's bind → clear → refresh order).
-                deps.clearStagedImages();
-                deps.bindAgent();
-                deps.refreshCommands();
-                void deps.refreshLoadedContext();
-                void deps.refreshSkillCommands();
-                clearResumeTarget();
-                touchSession(handle.agent.id);
-                touchAgentViewSession(previousSessionId);
-                touchAgentViewSession(String(handle.agent.id));
-                deps.notifySessionSwitched('background', String(handle.agent.id), previousSessionId);
-                deps.notifyAgentView();
-                return { ok: true, backgroundedSessionId: previousSessionId };
-            });
+            let committed = false;
+            try {
+                const result = deps.binding.adopt(handle, adoption, (previous, disposePrevious) => {
+                    const previousSessionId = String(previous.agent.session.id);
+                    if (previous.handle !== undefined) {
+                        deps.backgroundHandles.set(previousSessionId, previous.handle);
+                        disposePrevious('park');
+                    }
+                    resetSessionProjection(state, deps.rowIds, deps.resetProjector, deps.resetSubagents, deps.resetJobs);
+                    state.status = handle.agent.status;
+                    state.agentId = handle.agent.id;
+                    state.loadedContext = undefined;
+                    state.contextWindow = undefined;
+                    state.effortLevels = undefined;
+                    state.reasoningEffort = undefined;
+                    deps.refreshEffortLevels();
+                    // Reset the input FIFO and pending-decision indicators BEFORE the first
+                    // emit (main's bind → clear → refresh order).
+                    deps.clearStagedImages();
+                    deps.bindAgent();
+                    deps.refreshCommands();
+                    void deps.refreshLoadedContext();
+                    void deps.refreshSkillCommands();
+                    clearResumeTarget();
+                    touchSession(handle.agent.id);
+                    touchAgentViewSession(previousSessionId);
+                    touchAgentViewSession(String(handle.agent.id));
+                    deps.notifySessionSwitched('background', String(handle.agent.id), previousSessionId);
+                    deps.notifyAgentView();
+                    return { ok: true, backgroundedSessionId: previousSessionId };
+                });
+                committed = true;
+                return result;
+            }
+            finally {
+                if (committed)
+                    reservation.settle();
+                else
+                    reservation.abandon();
+            }
         }
         catch (error) {
+            reservation.abandon();
             const message = error instanceof Error ? error.message : String(error);
             deps.notify(t('agentview-dispatch-failed', { err: message }), { color: 'error', timeoutMs: 8000 });
             return { ok: false, reason: 'failed', error: message };

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

@@ -24,10 +24,27 @@ export declare function createChannelBinding(initial: Agent, handle: AgentHandle
     readonly generation: number;
     capture(): BindingCapture;
     isCurrent(capture: BindingCapture): boolean;
-    /** Create a candidate without giving it authority over the live binding. */
+    /**
+     * Create a candidate without giving it authority over the live binding.
+     *
+     * When the capture went stale the candidate is closed and the rejection
+     * WAITS for that close. The caller's `abandon(handle)` can no longer see the
+     * handle — it was never in `pending` — so waiting here is the only way the
+     * handle is known to have stopped writing before the caller gives its
+     * ledger reservation back.
+     */
     prepare(capture: BindingCapture, create: () => Promise<AgentHandle>): Promise<AgentHandle>;
-    /** Dispose an uncommitted candidate exactly once. Live handles are inert. */
+    /**
+     * Dispose an uncommitted candidate exactly once and WAIT for the close.
+     *
+     * Waiting is the point: callers use this on the path where they are about
+     * to give a cross-process ledger reservation back, and that reservation may
+     * only be released once the handle has actually stopped writing. A live
+     * handle that this cell never owned is inert here.
+     */
     abandon(candidate: AgentHandle): Promise<void>;
+    /** A registry may retain an agent while its async handle close drains. */
+    waitForDisposal(sessionId: string): Promise<void>;
     /** Perform one explicit synchronous prepared-handle adoption transaction. */
     adopt: <T>(candidate: AgentHandle, capture: BindingCapture, tail: (previous: BindingCommit, disposition: (next: PreviousDisposition) => void) => T) => T;
     /** Perform one explicit synchronous already-live-agent adoption transaction. */

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

@@ -1 +1 @@
-{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,KAAK,mBAAmB,GAAG,SAAS,GAAG,MAAM,CAAA;AAE7C;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,KAAK,EAAE,YAAY;;;;eAiK1F,cAAc;uBACN,cAAc;IAEjC,4EAA4E;qBACrD,cAAc,UAAU,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAkBhG,6EAA6E;uBACpD,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpD,6EAA6E;YAvIhE,CAAC,aACH,WAAW,WACb,cAAc,QACjB,CAAC,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,KAAK,CAAC,KACrF,CAAC;IAqIF,gFAAgF;eA5EhE,CAAC,SACV,KAAK,cACA,WAAW,GAAG,SAAS,QAC7B,CAAC,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,KAAK,CAAC,KACrF,CAAC;;uBAsFiB,MAAM,IAAI;qCAvLS,MAAM,IAAI,KAAG,OAAO;EA0L7D;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA"}
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/binding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,KAAK,mBAAmB,GAAG,SAAS,GAAG,MAAM,CAAA;AAE7C;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,KAAK,EAAE,YAAY;;;;eAsM1F,cAAc;uBACN,cAAc;IAEjC;;;;;;;;OAQG;qBACoB,cAAc,UAAU,MAAM,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAkBhG;;;;;;;OAOG;uBACsB,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,0EAA0E;+BACzC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,6EAA6E;YA7JhE,CAAC,aACH,WAAW,WACb,cAAc,QACjB,CAAC,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,KAAK,CAAC,KACrF,CAAC;IA2JF,gFAAgF;eAlGhE,CAAC,SACV,KAAK,cACA,WAAW,GAAG,SAAS,QAC7B,CAAC,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,KAAK,CAAC,KACrF,CAAC;;uBA4GiB,MAAM,IAAI;qCAvNS,MAAM,IAAI,KAAG,OAAO;EA0N7D;AAED,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA"}

package/lib/types/dsh-adapter/channel/binding.js

@@ -14,17 +14,46 @@ export function createChannelBinding(initial, handle, owner) {
     let subscriptions = [];
     let handoff;
     const pending = new Map();
-    const disposed = new WeakSet();
+    /**
+     * The in-flight (or finished) close of a handle this cell owns, keyed by the
+     * handle. A Promise rather than a "has it started" flag, because the callers
+     * that matter need to know when the handle has actually STOPPED writing: a
+     * ledger reservation is only safe to give back after that, and a second
+     * `dispose()` must not start a parallel close.
+     */
+    const closing = new WeakMap();
+    const closingSessions = new Map();
+    /** Close `candidate` exactly once; the result resolves however it ends. */
     const dispose = (candidate) => {
-        if (disposed.has(candidate))
-            return;
-        disposed.add(candidate);
-        void candidate.dispose().catch(() => undefined);
+        const started = closing.get(candidate);
+        if (started !== undefined)
+            return started;
+        // Kicked off SYNCHRONOUSLY: revocation is part of a synchronous transaction
+        // boundary, and a caller that abandons a candidate may check it right away.
+        // Only the waiting is deferred, never the call.
+        let close;
+        try {
+            close = Promise.resolve(candidate.dispose()).catch(() => undefined);
+        }
+        catch {
+            close = Promise.resolve();
+        }
+        closing.set(candidate, close);
+        const id = String(candidate.agent.session.id);
+        closingSessions.set(id, close);
+        void close.then(() => {
+            if (closingSessions.get(id) === close)
+                closingSessions.delete(id);
+        });
+        return close;
     };
     const disposePending = (candidate) => {
-        if (!pending.delete(candidate))
-            return;
-        dispose(candidate);
+        if (pending.delete(candidate))
+            return dispose(candidate);
+        // Already un-pended (a revocation path took it out from under the caller):
+        // hand back the close that is already running, so a caller that HAS to
+        // wait — one about to give a ledger reservation back — still can.
+        return closing.get(candidate);
     };
     const clearSubscriptions = (afterEach) => {
         const active = subscriptions.splice(0);
@@ -49,23 +78,33 @@ export function createChannelBinding(initial, handle, owner) {
         return failure;
     };
     const isCaptureCurrent = (capture) => owner.current() && capture.agent === currentAgent && capture.generation === generation;
+    /**
+     * Start a close without waiting for it. The callers below are synchronous
+     * transaction boundaries — they must not turn into awaits — but the close
+     * itself stays observable through {@link dispose}, so a caller that DOES have
+     * to wait (an `abandon` handing a ledger reservation back) still can.
+     */
+    const startClose = (close) => {
+        void close;
+    };
     const assertPrepared = (candidate, capture) => {
         if (pending.get(candidate) !== capture || !isCaptureCurrent(capture)) {
-            disposePending(candidate);
+            startClose(disposePending(candidate));
             throw new Error('dsh-tui: Channel binding changed before adoption');
         }
     };
     const settlePrevious = (previous, disposition) => {
         // Parking deliberately transfers ownership to the caller's background
         // ledger. Disposal is centralised here so no adoption tail can double-call
-        // an old handle while its transaction is being revoked.
+        // an old handle while its transaction is being revoked. Neither path waits:
+        // an ordinary session switch must not block on the handle it just left.
         if (disposition === 'dispose' && previous.handle !== undefined && previous.handle !== currentHandle) {
-            dispose(previous.handle);
+            startClose(dispose(previous.handle));
         }
     };
     owner.own(clearSubscriptions);
     owner.own(() => { for (const candidate of [...pending.keys()])
-        disposePending(candidate); });
+        startClose(disposePending(candidate)); });
     const adopt = (candidate, capture, tail) => {
         if (handoff !== undefined) {
             // Mark the outer transaction superseded as well as rejecting this one;
@@ -120,7 +159,7 @@ export function createChannelBinding(initial, handle, owner) {
             if (currentHandle === candidate) {
                 currentHandle = undefined;
             }
-            dispose(candidate);
+            startClose(dispose(candidate));
             owner.dispose();
             throw error;
         }
@@ -185,27 +224,48 @@ export function createChannelBinding(initial, handle, owner) {
         get generation() { return generation; },
         capture() { return { agent: currentAgent, generation }; },
         isCurrent(capture) { return isCaptureCurrent(capture); },
-        /** Create a candidate without giving it authority over the live binding. */
+        /**
+         * Create a candidate without giving it authority over the live binding.
+         *
+         * When the capture went stale the candidate is closed and the rejection
+         * WAITS for that close. The caller's `abandon(handle)` can no longer see the
+         * handle — it was never in `pending` — so waiting here is the only way the
+         * handle is known to have stopped writing before the caller gives its
+         * ledger reservation back.
+         */
         async prepare(capture, create) {
             owner.assertActive();
             if (!isCaptureCurrent(capture))
                 throw new Error('dsh-tui: Channel binding changed before preparation');
             const candidate = await create();
             if (!isCaptureCurrent(capture)) {
-                dispose(candidate);
+                await dispose(candidate);
                 throw new Error('dsh-tui: Channel binding changed during preparation');
             }
             pending.set(candidate, capture);
             // Owner disposal may synchronously occur through embedding hooks while
             // ownership is registered; verify the pending entry itself as well.
             if (!isCaptureCurrent(capture) || pending.get(candidate) !== capture) {
-                disposePending(candidate);
+                await disposePending(candidate);
                 throw new Error('dsh-tui: Channel binding changed during preparation');
             }
             return candidate;
         },
-        /** Dispose an uncommitted candidate exactly once. Live handles are inert. */
-        async abandon(candidate) { disposePending(candidate); },
+        /**
+         * Dispose an uncommitted candidate exactly once and WAIT for the close.
+         *
+         * Waiting is the point: callers use this on the path where they are about
+         * to give a cross-process ledger reservation back, and that reservation may
+         * only be released once the handle has actually stopped writing. A live
+         * handle that this cell never owned is inert here.
+         */
+        async abandon(candidate) {
+            await disposePending(candidate);
+        },
+        /** A registry may retain an agent while its async handle close drains. */
+        async waitForDisposal(sessionId) {
+            await closingSessions.get(sessionId);
+        },
         /** Perform one explicit synchronous prepared-handle adoption transaction. */
         adopt,
         /** Perform one explicit synchronous already-live-agent adoption transaction. */

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

@@ -19,6 +19,11 @@ export declare function firstStaleComposerToken(text: string, ordered: ReadonlyM
 export interface ComposerImageLimits {
     readonly maxImageBytes: number;
     readonly maxImagesPerMessage: number;
+    /** Per-side intrinsic pixel cap mirrored from the upstream store so the
+     *  ingress gate can resample before staging (issue #938). */
+    readonly maxImageDimension: number;
+    /** Total-pixel cap ditto. */
+    readonly maxImagePixels: number;
 }
 /** The composer's staged-image capability store plus its draft-binding rules. */
 export interface ComposerImages {

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;AAIlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,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;CACrC;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;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE;IAAE,UAAU,IAAI,MAAM,CAAA;CAAE,GAC7B,cAAc,CAsKhB"}
+{"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"}