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

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

@@ -1,25 +1,39 @@
 import type { Agent, AgentHandle } from '@deepseek-ai/dsh-agent';
+import type { AgentSession } from '../../agent/session.js';
 import type { ChannelOwner } from './owner.js';
 export interface BindingCapture {
-    readonly agent: Agent;
+    readonly session: AgentSession;
+    /** DSH convenience: the captured session's agent; undefined off DSH. */
+    readonly agent: Agent | undefined;
     readonly generation: number;
 }
 export interface BindingCommit {
-    readonly agent: Agent;
+    readonly session: AgentSession;
+    readonly agent: Agent | undefined;
     readonly handle: AgentHandle | undefined;
     readonly generation: number;
 }
 type PreviousDisposition = 'dispose' | 'park';
 /**
- * Sole writer of the attached Agent/handle identity and binding generation.
+ * Sole writer of the attached session identity and binding generation.
  *
- * A prepared handle remains owned by this cell until its synchronous adoption
- * tail returns.  The tail is deliberately callback-shaped: it cannot leave a
- * committed identity waiting for a microtask watchdog to infer whether setup
- * completed, and a throw always revokes the transaction immediately.
+ * The cell holds an `AgentSession` of any backend and every identity rule
+ * below is decided on that session object (plus the generation, which every
+ * adoption advances). `agent`/`handle` are DSH convenience views of
+ * `capabilities.native.dsh` for the DSH specialists (`undefined` on a
+ * non-DSH session); a DSH session's lifetime is still keyed by its handle, so
+ * two wrappers of one owned agent close it once. A prepared session remains
+ * owned by this cell until its synchronous adoption tail returns. The tail
+ * is deliberately callback-shaped: it cannot leave a committed identity
+ * waiting for a microtask watchdog to infer whether setup completed, and a
+ * throw always revokes the transaction immediately.
  */
-export declare function createChannelBinding(initial: Agent, handle: AgentHandle | undefined, owner: ChannelOwner): {
-    readonly agent: Agent;
+export declare function createChannelBinding(initial: AgentSession, owner: ChannelOwner): {
+    readonly session: AgentSession;
+    /** DSH convenience: `capabilities.native.dsh.agent` of the bound session;
+     *  undefined when the bound session is not a DSH session. */
+    readonly agent: Agent | undefined;
+    /** DSH convenience: the bound session's lifetime handle, if it owns one. */
     readonly handle: AgentHandle | undefined;
     readonly generation: number;
     capture(): BindingCapture;
@@ -33,7 +47,7 @@ export declare function createChannelBinding(initial: Agent, handle: AgentHandle
      * handle is known to have stopped writing before the caller gives its
      * ledger reservation back.
      */
-    prepare(capture: BindingCapture, create: () => Promise<AgentHandle>): Promise<AgentHandle>;
+    prepare(capture: BindingCapture, create: () => Promise<AgentSession>): Promise<AgentSession>;
     /**
      * Dispose an uncommitted candidate exactly once and WAIT for the close.
      *
@@ -42,17 +56,50 @@ export declare function createChannelBinding(initial: Agent, handle: AgentHandle
      * 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>;
+    abandon(candidate: AgentSession): Promise<void>;
+    /**
+     * Close the bound session at channel release when this cell owns its
+     * lifetime: any session that is not a DSH session (a backend session no
+     * host registry disposes; for the Claude backend, its CLI child). A DSH
+     * session's lifetime belongs to its handle's owner, never to the UI
+     * release. Deferred one microtask, so release itself never awaits or
+     * throws; idempotent with every other close of the same session.
+     */
+    releaseOwned(): 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. */
-    switchTo: <T>(agent: Agent, nextHandle: AgentHandle | undefined, tail: (previous: BindingCommit, disposition: (next: PreviousDisposition) => void) => T) => T;
+    adopt: <T>(candidate: AgentSession, capture: BindingCapture, tail: (previous: BindingCommit, disposition: (next: PreviousDisposition) => void) => T) => T;
+    /** Perform one explicit synchronous already-live-session adoption transaction. */
+    switchTo: <T>(next: AgentSession, tail: (previous: BindingCommit, disposition: (next: PreviousDisposition) => void) => T) => T;
     bind(): number;
     subscribe(dispose: () => void): void;
     clearSubscriptions: (afterEach?: () => void) => unknown;
 };
 export type ChannelBinding = ReturnType<typeof createChannelBinding>;
+/** A capture taken through the DSH view: its agent is always present. */
+export interface DshBindingCapture extends BindingCapture {
+    readonly agent: Agent;
+}
+/** A commit seen through the DSH view: the replaced session's agent. */
+export interface DshBindingCommit extends BindingCommit {
+    readonly agent: Agent;
+}
+type Disposition = (next: PreviousDisposition) => void;
+/**
+ * The binding as the DSH specialists see it: `agent` (and every capture's
+ * agent) is the bound DSH agent. The specialists attach only when the bound
+ * session is a DSH session, so reading `agent` through this view on a
+ * non-DSH binding is a wiring bug and throws loudly instead of handing a
+ * specialist `undefined`.
+ */
+export type DshChannelBinding = Omit<ChannelBinding, 'agent' | 'capture' | 'adopt' | 'switchTo'> & {
+    readonly agent: Agent;
+    capture(): DshBindingCapture;
+    adopt<T>(candidate: AgentSession, capture: BindingCapture, tail: (previous: DshBindingCommit, disposition: Disposition) => T): T;
+    switchTo<T>(next: AgentSession, tail: (previous: DshBindingCommit, disposition: Disposition) => T): T;
+};
+/** Wrap a binding for the DSH specialists (a live view, not a snapshot). */
+export declare function dshChannelBinding(binding: ChannelBinding): DshChannelBinding;
 export {};
 //# sourceMappingURL=binding.d.ts.map

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

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

@@ -1,31 +1,43 @@
+/** The DSH agent a session drives, if it is a DSH session (convenience view). */
+const agentOf = (session) => session.capabilities.native.dsh?.agent;
+/** The DSH lifetime handle a session owns, if any (DSH convenience view). */
+const handleOf = (session) => session.capabilities.native.dsh?.handle;
 /**
- * Sole writer of the attached Agent/handle identity and binding generation.
+ * Sole writer of the attached session identity and binding generation.
  *
- * A prepared handle remains owned by this cell until its synchronous adoption
- * tail returns.  The tail is deliberately callback-shaped: it cannot leave a
- * committed identity waiting for a microtask watchdog to infer whether setup
- * completed, and a throw always revokes the transaction immediately.
+ * The cell holds an `AgentSession` of any backend and every identity rule
+ * below is decided on that session object (plus the generation, which every
+ * adoption advances). `agent`/`handle` are DSH convenience views of
+ * `capabilities.native.dsh` for the DSH specialists (`undefined` on a
+ * non-DSH session); a DSH session's lifetime is still keyed by its handle, so
+ * two wrappers of one owned agent close it once. A prepared session remains
+ * owned by this cell until its synchronous adoption tail returns. The tail
+ * is deliberately callback-shaped: it cannot leave a committed identity
+ * waiting for a microtask watchdog to infer whether setup completed, and a
+ * throw always revokes the transaction immediately.
  */
-export function createChannelBinding(initial, handle, owner) {
-    let currentAgent = initial;
-    let currentHandle = handle;
+export function createChannelBinding(initial, owner) {
+    let currentSession = initial;
+    let currentHandle = handleOf(initial);
     let generation = 0;
     let started = false;
     let subscriptions = [];
     let handoff;
     const pending = new Map();
     /**
-     * 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.
+     * The in-flight (or finished) close of a session this cell owns, keyed by
+     * its lifetime (the DSH handle; the session itself for a handle-less one). 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) => {
-        const started = closing.get(candidate);
+        const lifetime = handleOf(candidate) ?? candidate;
+        const started = closing.get(lifetime);
         if (started !== undefined)
             return started;
         // Kicked off SYNCHRONOUSLY: revocation is part of a synchronous transaction
@@ -38,8 +50,8 @@ export function createChannelBinding(initial, handle, owner) {
         catch {
             close = Promise.resolve();
         }
-        closing.set(candidate, close);
-        const id = String(candidate.agent.session.id);
+        closing.set(lifetime, close);
+        const id = candidate.ref.sessionId;
         closingSessions.set(id, close);
         void close.then(() => {
             if (closingSessions.get(id) === close)
@@ -53,7 +65,7 @@ export function createChannelBinding(initial, handle, owner) {
         // 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);
+        return closing.get(handleOf(candidate) ?? candidate);
     };
     const clearSubscriptions = (afterEach) => {
         const active = subscriptions.splice(0);
@@ -77,7 +89,7 @@ export function createChannelBinding(initial, handle, owner) {
         }
         return failure;
     };
-    const isCaptureCurrent = (capture) => owner.current() && capture.agent === currentAgent && capture.generation === generation;
+    const isCaptureCurrent = (capture) => owner.current() && capture.session === currentSession && 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
@@ -98,8 +110,14 @@ export function createChannelBinding(initial, handle, owner) {
         // ledger. Disposal is centralised here so no adoption tail can double-call
         // 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) {
-            startClose(dispose(previous.handle));
+        // A DSH session's lifetime is its handle (a borrowed registry agent has
+        // none and is never closed here); a non-DSH session owns its own
+        // lifetime, so the cell closes the session object it replaced.
+        const owned = previous.handle !== undefined
+            ? previous.handle !== currentHandle
+            : previous.agent === undefined && previous.session !== currentSession;
+        if (disposition === 'dispose' && owned) {
+            startClose(dispose(previous.session));
         }
     };
     owner.own(clearSubscriptions);
@@ -117,7 +135,7 @@ export function createChannelBinding(initial, handle, owner) {
         assertPrepared(candidate, capture);
         const token = Symbol('channel-binding-handoff');
         handoff = token;
-        const previous = { agent: currentAgent, handle: currentHandle, generation };
+        const previous = { session: currentSession, agent: agentOf(currentSession), handle: currentHandle, generation };
         let disposition;
         const decidePrevious = (next) => {
             if (disposition === undefined || disposition === next) {
@@ -141,13 +159,13 @@ export function createChannelBinding(initial, handle, owner) {
                 throw new Error('dsh-tui: Channel binding handoff was superseded');
             assertPrepared(candidate, capture);
             pending.delete(candidate);
-            currentAgent = candidate.agent;
-            currentHandle = candidate;
+            currentSession = candidate;
+            currentHandle = handleOf(candidate);
             generation += 1;
             const result = tail(previous, decidePrevious);
             // Tail callbacks include notifier/listener code and therefore remain a
             // synchronous reentrancy boundary even though they contain no await.
-            if (handoff !== token || !owner.current() || currentHandle !== candidate) {
+            if (handoff !== token || !owner.current() || currentSession !== candidate) {
                 throw new Error('dsh-tui: Channel binding changed during adoption');
             }
             succeeded = true;
@@ -156,7 +174,7 @@ export function createChannelBinding(initial, handle, owner) {
         catch (error) {
             // This candidate is transaction-owned, unlike the baseline live handle
             // which ordinary UI owner teardown only unsubscribes from.
-            if (currentHandle === candidate) {
+            if (currentSession === candidate) {
                 currentHandle = undefined;
             }
             startClose(dispose(candidate));
@@ -169,19 +187,20 @@ export function createChannelBinding(initial, handle, owner) {
                 handoff = undefined;
         }
     };
-    const switchTo = (agent, nextHandle, tail) => {
+    const switchTo = (next, tail) => {
         owner.assertActive();
         if (handoff !== undefined) {
             handoff = undefined;
             throw new Error('dsh-tui: Channel binding handoff is already in progress');
         }
+        const nextHandle = handleOf(next);
         const token = Symbol('channel-binding-handoff');
         handoff = token;
-        const previous = { agent: currentAgent, handle: currentHandle, generation };
+        const previous = { session: currentSession, agent: agentOf(currentSession), handle: currentHandle, generation };
         let disposition;
-        const decidePrevious = (next) => {
-            if (disposition === undefined || disposition === next) {
-                disposition = next;
+        const decidePrevious = (nextDisposition) => {
+            if (disposition === undefined || disposition === nextDisposition) {
+                disposition = nextDisposition;
                 return;
             }
             throw new Error('dsh-tui: Channel binding previous disposition changed');
@@ -196,11 +215,11 @@ export function createChannelBinding(initial, handle, owner) {
                 throw cleanupFailure;
             if (handoff !== token || !owner.current())
                 throw new Error('dsh-tui: Channel binding changed during adoption');
-            currentAgent = agent;
+            currentSession = next;
             currentHandle = nextHandle;
             generation += 1;
             const result = tail(previous, decidePrevious);
-            if (handoff !== token || !owner.current() || currentAgent !== agent || currentHandle !== nextHandle) {
+            if (handoff !== token || !owner.current() || currentSession !== next || currentHandle !== nextHandle) {
                 throw new Error('dsh-tui: Channel binding changed during adoption');
             }
             succeeded = true;
@@ -219,10 +238,14 @@ export function createChannelBinding(initial, handle, owner) {
         }
     };
     return {
-        get agent() { return currentAgent; },
+        get session() { return currentSession; },
+        /** DSH convenience: `capabilities.native.dsh.agent` of the bound session;
+         *  undefined when the bound session is not a DSH session. */
+        get agent() { return agentOf(currentSession); },
+        /** DSH convenience: the bound session's lifetime handle, if it owns one. */
         get handle() { return currentHandle; },
         get generation() { return generation; },
-        capture() { return { agent: currentAgent, generation }; },
+        capture() { return { session: currentSession, agent: agentOf(currentSession), generation }; },
         isCurrent(capture) { return isCaptureCurrent(capture); },
         /**
          * Create a candidate without giving it authority over the live binding.
@@ -262,13 +285,27 @@ export function createChannelBinding(initial, handle, owner) {
         async abandon(candidate) {
             await disposePending(candidate);
         },
+        /**
+         * Close the bound session at channel release when this cell owns its
+         * lifetime: any session that is not a DSH session (a backend session no
+         * host registry disposes; for the Claude backend, its CLI child). A DSH
+         * session's lifetime belongs to its handle's owner, never to the UI
+         * release. Deferred one microtask, so release itself never awaits or
+         * throws; idempotent with every other close of the same session.
+         */
+        releaseOwned() {
+            const session = currentSession;
+            if (agentOf(session) !== undefined)
+                return;
+            void Promise.resolve().then(() => dispose(session));
+        },
         /** 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. */
+        /** Perform one explicit synchronous already-live-session adoption transaction. */
         switchTo,
         // bindAgent is still responsible for constructing the typed subscriptions.
         // Initial activation establishes generation 1; later rebinds have already
@@ -285,3 +322,33 @@ export function createChannelBinding(initial, handle, owner) {
         clearSubscriptions,
     };
 }
+/** Wrap a binding for the DSH specialists (a live view, not a snapshot). */
+export function dshChannelBinding(binding) {
+    const require = (agent) => {
+        if (agent === undefined) {
+            const ref = binding.session.ref;
+            throw new Error(`dsh-tui: session ${ref.backendId}:${ref.sessionId} is not a DSH session`);
+        }
+        return agent;
+    };
+    return {
+        get session() { return binding.session; },
+        get agent() { return require(binding.agent); },
+        get handle() { return binding.handle; },
+        get generation() { return binding.generation; },
+        capture() {
+            const capture = binding.capture();
+            return { ...capture, agent: require(capture.agent) };
+        },
+        isCurrent: capture => binding.isCurrent(capture),
+        prepare: (capture, create) => binding.prepare(capture, create),
+        abandon: candidate => binding.abandon(candidate),
+        waitForDisposal: sessionId => binding.waitForDisposal(sessionId),
+        releaseOwned: () => binding.releaseOwned(),
+        adopt: (candidate, capture, tail) => binding.adopt(candidate, capture, (previous, disposition) => tail({ ...previous, agent: require(previous.agent) }, disposition)),
+        switchTo: (next, tail) => binding.switchTo(next, (previous, disposition) => tail({ ...previous, agent: require(previous.agent) }, disposition)),
+        bind: () => binding.bind(),
+        subscribe: dispose => binding.subscribe(dispose),
+        clearSubscriptions: afterEach => binding.clearSubscriptions(afterEach),
+    };
+}

package/lib/types/dsh-adapter/channel/command-completions.d.ts

@@ -13,6 +13,9 @@ export declare function createCommandCompletions(deps: {
         aliases?: readonly string[];
         description?: string;
     }[];
+    /** The bound backend's MCP server names when it controls them
+     *  (`/mcp reconnect|toggle`); undefined = `/mcp` takes no arguments. */
+    mcpServers?(): readonly string[] | undefined;
     model: {
         warmModelNodes(): void;
         modelNodes(): readonly CommandCompletionNode[];

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

@@ -1 +1 @@
-{"version":3,"file":"command-completions.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/command-completions.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAK1G,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,MAAM,YAAY,CAAA;IACzB,SAAS,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAA;IACjD,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,qBAAqB,EAAE,CAAA;KAAE,CAAA;IACtF,iBAAiB,IAAI,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACnG,KAAK,EAAE;QACL,cAAc,IAAI,IAAI,CAAA;QACtB,UAAU,IAAI,SAAS,qBAAqB,EAAE,CAAA;QAC9C,iBAAiB,IAAI,IAAI,CAAA;QACzB,aAAa,IAAI,SAAS;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE,EAAE,CAAA;QACpG,gBAAgB,IAAI,IAAI,CAAA;KACzB,CAAA;CACF,IAES,OAAO,MAAM,qDA+EtB"}
+{"version":3,"file":"command-completions.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/command-completions.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8C,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAK1G,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,wFAAwF;AACxF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,KAAK,EAAE,MAAM,YAAY,CAAA;IACzB,SAAS,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAA;IACjD,YAAY,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,qBAAqB,EAAE,CAAA;KAAE,CAAA;IACtF,iBAAiB,IAAI,SAAS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACnG;4EACwE;IACxE,UAAU,CAAC,IAAI,SAAS,MAAM,EAAE,GAAG,SAAS,CAAA;IAC5C,KAAK,EAAE;QACL,cAAc,IAAI,IAAI,CAAA;QACtB,UAAU,IAAI,SAAS,qBAAqB,EAAE,CAAA;QAC9C,iBAAiB,IAAI,IAAI,CAAA;QACzB,aAAa,IAAI,SAAS;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,OAAO,CAAA;SAAE,EAAE,CAAA;QACpG,gBAAgB,IAAI,IAAI,CAAA;KACzB,CAAA;CACF,IAES,OAAO,MAAM,qDAwGtB"}

package/lib/types/dsh-adapter/channel/command-completions.js

@@ -78,12 +78,41 @@ export function createCommandCompletions(deps) {
             }
             if (path.length === 1 && path[0] === 'permission') {
                 const snapshot = state.permissionPresets();
-                return snapshot.options.filter(option => isCommandCompletionToken(option.value)).map(option => ({
-                    name: option.value, description: option.description ?? option.name,
-                    ...(option.value === 'read-only' ? { descriptionKey: 'permission-preset-readonly-desc' } : option.value === 'workspace-write' ? { descriptionKey: 'permission-preset-workspace-write-desc' } : option.value === 'danger-full-access' ? { descriptionKey: 'permission-preset-full-access-desc' } : {}),
-                    ...(snapshot.current?.kind === 'preset' && snapshot.current.value === option.value ? { tag: 'current' } : {}),
+                if (snapshot.options.length > 0) {
+                    return snapshot.options.filter(option => isCommandCompletionToken(option.value)).map(option => ({
+                        name: option.value, description: option.description ?? option.name,
+                        ...(option.value === 'read-only' ? { descriptionKey: 'permission-preset-readonly-desc' } : option.value === 'workspace-write' ? { descriptionKey: 'permission-preset-workspace-write-desc' } : option.value === 'danger-full-access' ? { descriptionKey: 'permission-preset-full-access-desc' } : {}),
+                        ...(snapshot.current?.kind === 'preset' && snapshot.current.value === option.value ? { tag: 'current' } : {}),
+                    }));
+                }
+                // No preset roster (a non-DSH backend): the typed `modes` capability
+                // is the roster. DSH sessions declare no such capability, so this
+                // arm answers an empty list there and the roster above stands.
+                const modes = state.backendModes()?.snapshot();
+                if (modes === undefined)
+                    return [];
+                const currentId = modes.modes[modes.currentIndex]?.id;
+                return modes.modes.filter(mode => isCommandCompletionToken(mode.id)).map(mode => ({
+                    name: mode.id, description: mode.name,
+                    ...(mode.id === currentId ? { tag: 'current' } : {}),
                 }));
             }
+            if (path[0] === 'mcp' && state.backendMcp() !== undefined) {
+                const servers = (deps.mcpServers?.() ?? []).filter(isCommandCompletionToken);
+                if (path.length === 1)
+                    return [
+                        { name: 'reconnect', description: 'Reconnect an MCP server', descriptionKey: 'sugg-mcp-reconnect-desc' },
+                        { name: 'toggle', description: 'Turn an MCP server on or off', descriptionKey: 'sugg-mcp-toggle-desc' },
+                    ];
+                if (path.length === 2 && (path[1] === 'reconnect' || path[1] === 'toggle'))
+                    return servers.map(name => ({ name, description: 'MCP server', descriptionKey: 'sugg-mcp-server-desc' }));
+                if (path.length === 3 && path[1] === 'toggle' && servers.includes(path[2]))
+                    return [
+                        { name: 'on', description: 'Enable the server', descriptionKey: 'sugg-mcp-on-desc' },
+                        { name: 'off', description: 'Disable the server', descriptionKey: 'sugg-mcp-off-desc' },
+                    ];
+                return [];
+            }
             if (path.length === 1 && path[0] === 'panel')
                 return [
                     { name: 'toggle', description: 'Toggle the sidebar', descriptionKey: 'sugg-panel-toggle-desc' },

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

@@ -1 +1 @@
-{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAIlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAO9C,KAAK,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,CAAC,CAAA;AAChG,KAAK,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AAEpC,mFAAmF;AACnF,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE;IACJ,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC,CAAA;IACvD,KAAK,IAAI,KAAK,CAAA;IACd,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACrE,MAAM,EAAE,MAAM,CAAA;CACf;mBA0BmB,IAAI;kBAlBC,OAAO,CAAC,IAAI,CAAC;kBA4HnB,IAAI;EAQxB"}
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/channel/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAO9C,KAAK,eAAe,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,KAAK,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,CAAC,CAAA;AAChG,KAAK,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;AAEpC,mFAAmF;AACnF,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE;IACJ,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAC,CAAA;IACvD,KAAK,IAAI,KAAK,CAAA;IACd,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IACrE,MAAM,EAAE,MAAM,CAAA;CACf;mBA0BmB,IAAI;kBAlBC,OAAO,CAAC,IAAI,CAAC;kBA4HnB,IAAI;EAQxB"}

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

@@ -1,4 +1,5 @@
 import { t } from '../../i18n.js';
+import { WORKING_GATE_NOTICES } from '../../commands.js';
 import { dispatchTuiDecision, normalizeCancelDecision } from '../extension-events.js';
 import { serviceForAgent } from '../presets.js';
 /** Owns the one manual compaction transaction that must settle before a switch. */
@@ -38,7 +39,7 @@ export function createManualCompaction(ctx, state, deps) {
             return;
         }
         if (state.working) {
-            deps.notify(t('compact-while-working'), { color: 'warning' });
+            deps.notify(t(WORKING_GATE_NOTICES.compact), { color: 'warning' });
             return;
         }
         const controller = new AbortController();
@@ -71,7 +72,7 @@ export function createManualCompaction(ctx, state, deps) {
                     return;
                 }
                 if (state.working) {
-                    deps.notify(t('compact-while-working'), { color: 'warning' });
+                    deps.notify(t(WORKING_GATE_NOTICES.compact), { color: 'warning' });
                     return;
                 }
                 // The status row replaces the old 4s toast: a real compaction runs for

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

@@ -1,4 +1,5 @@
 import type { Context } from '@deepseek-ai/cordis';
+import type { LocalImageStore } from './core/local-images.js';
 import type { ChannelOwner } from './owner.js';
 import type { ChannelImageBlock, ComposerImageRef, StagedImageHandle, StagedImageInput, TranscriptImage } from './types.js';
 /** Every visible composer placeholder token, in source order. */
@@ -58,5 +59,9 @@ export interface ComposerImages {
  */
 export declare function createComposerImages(ctx: Context, owner: ChannelOwner, deps: {
     generation(): number;
+    /** The in-memory store of a session that takes images itself (a
+     *  backend with the `images` capability); undefined = the DSH
+     *  attachments service. */
+    localImages?(): LocalImageStore | undefined;
 }): ComposerImages;
 //# sourceMappingURL=composer-images.d.ts.map

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/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"}