@deepseek-harness-tui/dsh-tui 0.8.1 → 0.8.2

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

@@ -21,6 +21,7 @@
  */
 import { Service } from '@deepseek-ai/cordis';
 import { cleanScalarText } from './sanitize.js';
+import { activationFiber, bindCallerEffect, compositionRoot, concreteService, requirePluginCaller } from './host-access.js';
 const NAMED_KEYS = {
     enter: 'return',
     return: 'return',
@@ -180,12 +181,29 @@ export function matchShortcut(combo, input, key) {
 }
 /** `ctx.tuiShortcuts` — plugin keyboard shortcut registry. */
 export class TuiShortcutRuntime extends Service {
-    shortcuts = new Map();
-    /** Handler invocation errors are surfaced through this hook — the chat
-     *  screen wires it to its notification toast. */
-    onError;
     constructor(ctx) {
         super(ctx, 'tuiShortcuts');
+        compositionRoot(ctx);
+        const runtime = this;
+        const state = {
+            shortcuts: new Map(),
+            owners: new Map(),
+            onError: undefined,
+            host: undefined,
+            logger: ctx.logger,
+        };
+        const host = Object.freeze({
+            dispatch: (input, key) => dispatchShortcut(runtime, input, key),
+            setErrorHandler: (handler) => {
+                state.onError = handler;
+                return () => {
+                    if (state.onError === handler)
+                        state.onError = undefined;
+                };
+            },
+        });
+        state.host = host;
+        hostShortcuts.set(runtime, state);
     }
     /**
      * Bind `combo` to `handler`. Invalid, modifier-less, reserved, or
@@ -201,9 +219,30 @@ export class TuiShortcutRuntime extends Service {
      * effect ledger's pluginId — omitting it records `undeclared` (C-060).
      */
     register(combo, options, identity) {
-        const parsed = parseShortcutCombo(combo);
+        let caller;
+        try {
+            caller = requirePluginCaller(this.ctx, 'tuiShortcuts.register', this);
+        }
+        catch {
+            this.ctx.logger.warn('dsh-tui: tuiShortcuts.register requires a live non-root plugin activation');
+            return () => { };
+        }
+        const state = shortcutStateFor(this);
+        const owner = activationFiber(caller);
+        if (owner === undefined) {
+            this.ctx.logger.warn('dsh-tui: tuiShortcuts.register requires a live activation');
+            return () => { };
+        }
+        let parsed;
+        try {
+            parsed = parseShortcutCombo(combo);
+        }
+        catch {
+            this.ctx.logger.warn('dsh-tui: tuiShortcuts.register rejected an uncoercible combo');
+            return () => { };
+        }
         if (parsed === undefined) {
-            this.ctx.logger.warn(`dsh-tui: tuiShortcuts.register rejected ${JSON.stringify(combo)} — need ctrl/alt plus one key (e.g. "ctrl+shift+p")`);
+            this.ctx.logger.warn('dsh-tui: tuiShortcuts.register rejected an invalid combo — need ctrl/alt plus one key (e.g. "ctrl+shift+p")');
             return () => { };
         }
         const key = comboKey(parsed);
@@ -213,11 +252,11 @@ export class TuiShortcutRuntime extends Service {
         // still checked for combos reserved WITH shift (ctrl+shift+return).
         const shiftlessKey = comboKey({ ...parsed, shift: false });
         if (RESERVED_CANONICAL.has(key) || RESERVED_CANONICAL.has(shiftlessKey)) {
-            this.ctx.logger.warn(`dsh-tui: tuiShortcuts.register rejected "${combo}" — reserved by a built-in binding`);
+            this.ctx.logger.warn(`dsh-tui: tuiShortcuts.register rejected "${parsed.raw}" — reserved by a built-in binding`);
             return () => { };
         }
-        if (this.shortcuts.has(key)) {
-            this.ctx.logger.warn(`dsh-tui: tuiShortcuts.register rejected "${combo}" — already registered`);
+        if (state.shortcuts.has(key)) {
+            this.ctx.logger.warn(`dsh-tui: tuiShortcuts.register rejected "${parsed.raw}" — already registered`);
             this.ctx.get('tuiEffectLedger')?.record({
                 operation: 'bind',
                 resource: { kind: 'shortcut', id: key },
@@ -226,43 +265,76 @@ export class TuiShortcutRuntime extends Service {
             }, identity);
             return () => { };
         }
-        const description = cleanScalarText(options?.description, 120);
-        if (typeof options?.handler !== 'function' || description === '') {
-            this.ctx.logger.warn(`dsh-tui: tuiShortcuts.register rejected "${combo}" — needs a description and a handler`);
+        let description;
+        let handler;
+        try {
+            description = cleanScalarText(options?.description, 120);
+            handler = options?.handler;
+        }
+        catch {
+            this.ctx.logger.warn(`dsh-tui: tuiShortcuts.register rejected "${parsed.raw}" — malformed options`);
+            return () => { };
+        }
+        if (typeof handler !== 'function' || description === '') {
+            this.ctx.logger.warn(`dsh-tui: tuiShortcuts.register rejected "${parsed.raw}" — needs a description and a handler`);
             return () => { };
         }
-        const entry = { combo: parsed, description, handler: options.handler };
-        this.shortcuts.set(key, entry);
+        const entry = { combo: parsed, description, handler };
+        state.shortcuts.set(key, entry);
+        state.owners.set(key, owner);
         this.ctx.get('tuiEffectLedger')?.record({ operation: 'bind', resource: { kind: 'shortcut', id: key }, result: 'applied' }, identity);
-        return () => {
-            if (this.shortcuts.get(key) !== entry)
+        const dispose = () => {
+            if (state.shortcuts.get(key) !== entry)
                 return;
-            this.shortcuts.delete(key);
+            state.shortcuts.delete(key);
+            state.owners.delete(key);
             this.ctx.get('tuiEffectLedger')?.record({ operation: 'release', resource: { kind: 'shortcut', id: key }, result: 'applied' }, identity);
         };
+        bindCallerEffect(caller, dispose);
+        return dispose;
     }
     /** Registered combos with descriptions (diagnostics / future /help). */
     list() {
-        return [...this.shortcuts.values()].map(entry => ({ combo: entry.combo.raw, description: entry.description }));
+        const caller = requirePluginCaller(this.ctx, 'tuiShortcuts.list', this);
+        const owner = activationFiber(caller);
+        if (owner === undefined)
+            return [];
+        const state = shortcutStateFor(this);
+        return [...state.shortcuts.entries()]
+            .filter(([key]) => state.owners.get(key) === owner)
+            .map(([, entry]) => ({ combo: entry.combo.raw, description: entry.description }));
     }
-    /**
-     * Match a keypress; on a hit, run the handler and return true (the UI
-     * consumes the key). Handler rejections are caught and reported through
-     * {@link onError} — never propagated into the input path.
-     */
-    dispatch(input, key) {
-        for (const entry of this.shortcuts.values()) {
-            if (!matchShortcut(entry.combo, input, key))
-                continue;
-            Promise.resolve()
-                .then(() => entry.handler())
-                .catch((error) => {
-                this.onError?.(entry.combo.raw, error);
-                this.ctx.logger.warn(`dsh-tui: shortcut "${entry.combo.raw}" handler failed: %o`, error);
-            });
-            return true;
-        }
-        return false;
+}
+const hostShortcuts = new WeakMap();
+function shortcutStateFor(runtime) {
+    const state = hostShortcuts.get(concreteService(runtime));
+    if (state === undefined)
+        throw new Error('tuiShortcuts host state is unavailable');
+    return state;
+}
+function dispatchShortcut(runtime, input, key) {
+    const state = shortcutStateFor(runtime);
+    for (const entry of state.shortcuts.values()) {
+        if (!matchShortcut(entry.combo, input, key))
+            continue;
+        Promise.resolve()
+            .then(() => entry.handler())
+            .catch((error) => {
+            state.onError?.(entry.combo.raw, error);
+            state.logger.warn(`dsh-tui: shortcut "${entry.combo.raw}" handler failed: %o`, error);
+        });
+        return true;
+    }
+    return false;
+}
+export function getHostShortcuts(runtime) {
+    if (runtime === undefined)
+        return undefined;
+    try {
+        return hostShortcuts.get(concreteService(runtime))?.host;
+    }
+    catch {
+        return undefined;
     }
 }
 export default TuiShortcutRuntime;

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

@@ -20,13 +20,16 @@ export declare class TuiStatusStore {
     private readonly entries;
     private snapshot;
     /** Set or clear (undefined/empty) one key. */
-    set(key: string, text: string | undefined, token?: number): void;
+    set(key: string, text: string | undefined, token?: number, owner?: object): void;
     /** Current contributions, first-set first (stable between changes). */
     getSnapshot(): readonly TuiStatusEntry[];
+    /** Host runtime uses this to enforce that one activation cannot rewrite or
+     * clear another activation's keyed contribution. */
+    ownerOf(key: string): object | undefined;
     /** Clear `key` only while it still holds the write tagged `token` — a
      *  stale disposer must not wipe a newer contribution (even one with
      *  identical text). Returns true when this call actually cleared. */
-    clearIf(key: string, token: number): boolean;
+    clearIf(key: string, token: number, owner?: object): boolean;
     /** Drop everything (teardown). */
     clear(): void;
     subscribe(listener: () => void): () => void;
@@ -43,11 +46,6 @@ declare module '@deepseek-ai/cordis' {
  * a status line must never take the TUI down.
  */
 export declare class TuiStatusRuntime extends Service {
-    /** The store the chat screen renders. Exposed for the host, not plugins. */
-    readonly store: TuiStatusStore;
-    /** Monotonic per-write token; a disposer only clears ITS write (see the
-     *  store's token comment for the same-value ABA this prevents). */
-    private nextToken;
     constructor(ctx: Context);
     /**
      * Set (or clear with `undefined`) the contribution for `key`. Keys are
@@ -71,5 +69,6 @@ export declare class TuiStatusRuntime extends Service {
      */
     set(key: string, text: string | number | boolean | undefined, identity?: Context): () => void;
 }
+export declare function getHostStatusStore(runtime: TuiStatusRuntime | undefined): TuiStatusStore | undefined;
 export default TuiStatusRuntime;
 //# sourceMappingURL=status.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGtD,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAQD;0EAC0E;AAC1E,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAKlD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqD;IAG7E,OAAO,CAAC,QAAQ,CAAgC;IAEhD,8CAA8C;IAC9C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,SAAI,GAAG,IAAI;IAmB3D,uEAAuE;IACvE,WAAW,IAAI,SAAS,cAAc,EAAE;IAIxC;;yEAEqE;IACrE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAQ5C,kCAAkC;IAClC,KAAK,IAAI,IAAI;IAOb,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAO3C,OAAO,CAAC,IAAI;CAGb;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,SAAS,EAAE,gBAAgB,CAAA;KAC5B;CACF;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,OAAO;IAC3C,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,iBAAuB;IAErC;uEACmE;IACnE,OAAO,CAAC,SAAS,CAAI;gBAET,GAAG,EAAE,OAAO;IAKxB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,IAAI;CAoD9F;AAED,eAAe,gBAAgB,CAAA"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKtD,iCAAiC;AACjC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AASD;0EAC0E;AAC1E,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAwB;IAKlD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoE;IAG5F,OAAO,CAAC,QAAQ,CAAgC;IAEhD,8CAA8C;IAC9C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,SAAI,EAAE,KAAK,GAAE,MAA0B,GAAG,IAAI;IAmB9F,uEAAuE;IACvE,WAAW,IAAI,SAAS,cAAc,EAAE;IAIxC;wDACoD;IACpD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIxC;;yEAEqE;IACrE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAS5D,kCAAkC;IAClC,KAAK,IAAI,IAAI;IAOb,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAO3C,OAAO,CAAC,IAAI;CAGb;AAED,OAAO,QAAQ,qBAAqB,CAAC;IACnC,UAAU,OAAO;QACf,SAAS,EAAE,gBAAgB,CAAA;KAC5B;CACF;AAED;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,OAAO;gBAC/B,GAAG,EAAE,OAAO;IAUxB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,IAAI;CAwF9F;AAgBD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAOpG;AAED,eAAe,gBAAgB,CAAA"}

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

@@ -9,11 +9,14 @@
  */
 import { Service } from '@deepseek-ai/cordis';
 import { cleanScalarText } from './sanitize.js';
+import { activationFiber, assertCallerContext, bindCallerEffect, compositionRoot, concreteService, requirePluginCaller } from './host-access.js';
+import { componentIdentityOf } from './component-identity.js';
 // Colon-separated segments are the documented namespacing convention
 // (`plugin:sub-item`); each segment stays a lowercase slug.
 const KEY_PATTERN = /^[a-z][a-z0-9_-]*(:[a-z][a-z0-9_-]*)*$/u;
 const TEXT_CELLS = 200;
 const MAX_ENTRIES = 20;
+const HOST_STATUS_OWNER = Object.freeze({ kind: 'host-status-owner' });
 /** Cordis-free keyed-text store. Render order is first-set order (Map
  *  insertion order), so a plugin's line never jumps around on updates. */
 export class TuiStatusStore {
@@ -27,7 +30,7 @@ export class TuiStatusStore {
     // emits — a fresh array per call would re-render in an infinite loop.
     snapshot = [];
     /** Set or clear (undefined/empty) one key. */
-    set(key, text, token = 0) {
+    set(key, text, token = 0, owner = HOST_STATUS_OWNER) {
         const had = this.entries.has(key);
         if (text === undefined || text === '') {
             if (!had)
@@ -42,7 +45,7 @@ export class TuiStatusStore {
                 existing.token = token;
                 return;
             }
-            this.entries.set(key, { text, token });
+            this.entries.set(key, { text, token, owner });
         }
         this.snapshot = [...this.entries].map(([entryKey, entry]) => ({ key: entryKey, text: entry.text }));
         this.emit();
@@ -51,10 +54,17 @@ export class TuiStatusStore {
     getSnapshot() {
         return this.snapshot;
     }
+    /** Host runtime uses this to enforce that one activation cannot rewrite or
+     * clear another activation's keyed contribution. */
+    ownerOf(key) {
+        return this.entries.get(key)?.owner;
+    }
     /** Clear `key` only while it still holds the write tagged `token` — a
      *  stale disposer must not wipe a newer contribution (even one with
      *  identical text). Returns true when this call actually cleared. */
-    clearIf(key, token) {
+    clearIf(key, token, owner) {
+        if (owner !== undefined && this.entries.get(key)?.owner !== owner)
+            return false;
         if (this.entries.get(key)?.token !== token)
             return false;
         this.entries.delete(key);
@@ -87,14 +97,14 @@ export class TuiStatusStore {
  * a status line must never take the TUI down.
  */
 export class TuiStatusRuntime extends Service {
-    /** The store the chat screen renders. Exposed for the host, not plugins. */
-    store = new TuiStatusStore();
-    /** Monotonic per-write token; a disposer only clears ITS write (see the
-     *  store's token comment for the same-value ABA this prevents). */
-    nextToken = 1;
     constructor(ctx) {
         super(ctx, 'tuiStatus');
-        ctx.effect(() => () => this.store.clear());
+        compositionRoot(ctx);
+        // Keep host state out of the traceable service object. A WeakMap also
+        // works with Cordis's caller-bound method proxy (unlike `#private`).
+        const state = { store: new TuiStatusStore(), nextToken: 1 };
+        hostStatusStores.set(this, state);
+        ctx.effect(() => () => state.store.clear());
     }
     /**
      * Set (or clear with `undefined`) the contribution for `key`. Keys are
@@ -118,16 +128,49 @@ export class TuiStatusRuntime extends Service {
      */
     set(key, text, identity) {
         const noop = () => { };
-        const normalized = String(key ?? '').trim().toLowerCase();
+        let caller;
+        try {
+            caller = requirePluginCaller(this.ctx, 'tuiStatus.set', this);
+        }
+        catch {
+            this.ctx.logger.warn('dsh-tui: tuiStatus.set requires a live non-root plugin activation');
+            return noop;
+        }
+        const state = statusStateFor(this);
+        const store = state.store;
+        const callerIdentity = componentIdentityOf(caller);
+        const suppliedIdentity = identity === undefined ? callerIdentity : componentIdentityOf(identity);
+        if (identity !== undefined) {
+            try {
+                assertCallerContext(caller, identity, 'tuiStatus.set');
+            }
+            catch {
+                caller.logger.warn('dsh-tui: tuiStatus.set rejected an identity belonging to another activation');
+                return noop;
+            }
+        }
+        const owner = activationFiber(caller);
+        if (owner === undefined) {
+            caller.logger.warn('dsh-tui: tuiStatus.set requires a live activation owner');
+            return noop;
+        }
+        let normalized;
+        try {
+            normalized = String(key ?? '').trim().toLowerCase();
+        }
+        catch {
+            caller.logger.warn('dsh-tui: tuiStatus.set rejected an uncoercible key');
+            return noop;
+        }
         if (!KEY_PATTERN.test(normalized)) {
-            this.ctx.logger.warn(`dsh-tui: tuiStatus.set rejected invalid key ${JSON.stringify(key)}`);
+            caller.logger.warn('dsh-tui: tuiStatus.set rejected an invalid key');
             return noop;
         }
-        if (text !== undefined && !this.store.getSnapshot().some(e => e.key === normalized)) {
+        if (text !== undefined && !store.getSnapshot().some(e => e.key === normalized)) {
             // New key beyond the cap: the line is one row of terminal — an
             // unbounded count would push the prompt off screen.
-            if (this.store.getSnapshot().length >= MAX_ENTRIES) {
-                this.ctx.logger.warn(`dsh-tui: tuiStatus.set rejected "${normalized}": ${MAX_ENTRIES} contributions already shown`);
+            if (store.getSnapshot().length >= MAX_ENTRIES) {
+                caller.logger.warn(`dsh-tui: tuiStatus.set rejected "${normalized}": ${MAX_ENTRIES} contributions already shown`);
                 return noop;
             }
         }
@@ -137,15 +180,19 @@ export class TuiStatusRuntime extends Service {
             // object would otherwise render as "[object Object]") is REFUSED with
             // a warning — it must not silently become a clear, either.
             if (typeof text !== 'string' && typeof text !== 'number' && typeof text !== 'boolean') {
-                this.ctx.logger.warn(`dsh-tui: tuiStatus.set rejected non-scalar text for "${normalized}"`);
+                caller.logger.warn(`dsh-tui: tuiStatus.set rejected non-scalar text for "${normalized}"`);
                 return noop;
             }
             cleaned = cleanScalarText(text, TEXT_CELLS);
         }
-        const token = this.nextToken++;
-        const had = this.store.getSnapshot().some(entry => entry.key === normalized);
-        this.store.set(normalized, cleaned, token);
-        const ledger = this.ctx.get('tuiEffectLedger');
+        const token = state.nextToken++;
+        const had = store.getSnapshot().some(entry => entry.key === normalized);
+        if (store.ownerOf(normalized) !== undefined && store.ownerOf(normalized) !== owner) {
+            caller.logger.warn(`dsh-tui: tuiStatus.set rejected "${normalized}" — the contribution belongs to another activation`);
+            return noop;
+        }
+        store.set(normalized, cleaned, token, owner);
+        const ledger = caller.get('tuiEffectLedger');
         if (cleaned === undefined) {
             if (had)
                 ledger?.record({ operation: 'release', resource: { kind: 'status', id: normalized }, result: 'applied' }, identity);
@@ -158,11 +205,30 @@ export class TuiStatusRuntime extends Service {
                 ...(had ? { replaces: { resourceId: normalized } } : {}),
             }, identity);
         }
-        return () => {
-            if (this.store.clearIf(normalized, token)) {
-                this.ctx.get('tuiEffectLedger')?.record({ operation: 'release', resource: { kind: 'status', id: normalized }, result: 'applied' }, identity);
+        const dispose = () => {
+            if (store.clearIf(normalized, token, owner)) {
+                caller.get('tuiEffectLedger')?.record({ operation: 'release', resource: { kind: 'status', id: normalized }, result: 'applied' }, identity);
             }
         };
+        bindCallerEffect(caller, dispose);
+        return dispose;
+    }
+}
+const hostStatusStores = new WeakMap();
+function statusStateFor(runtime) {
+    const store = hostStatusStores.get(concreteService(runtime));
+    if (store === undefined)
+        throw new Error('tuiStatus host store is unavailable');
+    return store;
+}
+export function getHostStatusStore(runtime) {
+    if (runtime === undefined)
+        return undefined;
+    try {
+        return hostStatusStores.get(concreteService(runtime))?.store;
+    }
+    catch {
+        return undefined;
     }
 }
 export default TuiStatusRuntime;

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

@@ -83,16 +83,28 @@ export interface TuiWorkspaceProvider {
     /** Provider-owned `/workspace <command>` extensions. */
     commands?: readonly TuiWorkspaceCommand[];
 }
+/** Host-only workspace controls used by the TUI front door.  Plugin-facing
+ * service methods below are intentionally scoped to their calling activation;
+ * the channel must use this facade to enumerate and route all providers. */
+export interface TuiWorkspaceHost {
+    list(currentCwd: string, signal?: AbortSignal): Promise<readonly TuiWorkspaceTarget[]>;
+    resolve(request: string, currentCwd?: string, signal?: AbortSignal): Promise<TuiWorkspaceTarget | undefined>;
+    describe(cwd: string): TuiWorkspaceTarget;
+    commandShell(cwd: string): Promise<TuiCommandShell | undefined>;
+    rename(cwd: string, title: string): Promise<TuiWorkspaceTarget>;
+    commands(): readonly Pick<TuiWorkspaceCommand, 'name' | 'aliases' | 'description'>[];
+    runCommand(name: string, input: string, cwd: string, signal?: AbortSignal): Promise<TuiWorkspaceCommandResult | undefined>;
+}
 declare module '@deepseek-ai/cordis' {
     interface Context {
         tuiWorkspaces: TuiWorkspaceRuntime;
     }
 }
 export declare const name = "dsh-tui-workspaces";
+/** Bound every provider promise so one plugin cannot park workspace flows. */
+export declare const WORKSPACE_PROVIDER_TIMEOUT_MS = 2000;
 /** Registry and local fallback shared by the TUI and workspace plugins. */
 export declare class TuiWorkspaceRuntime extends Service {
-    private readonly providers;
-    private readonly providerWaiters;
     constructor(ctx: Context);
     register(provider: TuiWorkspaceProvider): () => void;
     list(currentCwd: string, signal?: AbortSignal): Promise<readonly TuiWorkspaceTarget[]>;
@@ -103,11 +115,10 @@ export declare class TuiWorkspaceRuntime extends Service {
     rename(cwd: string, title: string): Promise<TuiWorkspaceTarget>;
     commands(): readonly Pick<TuiWorkspaceCommand, 'name' | 'aliases' | 'description'>[];
     runCommand(name: string, input: string, cwd: string, signal?: AbortSignal): Promise<TuiWorkspaceCommandResult | undefined>;
-    private workspaceRegistry;
-    private withStoredTitle;
     private notifyProviderWaiters;
-    private waitForProvider;
 }
+/** Resolve the host-only facade for channel/plugin bootstrap code. */
+export declare function getHostWorkspaceRuntime(runtime: TuiWorkspaceRuntime | undefined): TuiWorkspaceHost | undefined;
 /** Local-only fallback for direct embedders that call createChannel() without
  * mounting the optional workspace registry/provider service. */
 export declare function createLocalWorkspaceRuntime(): Pick<TuiWorkspaceRuntime, 'list' | 'resolve' | 'describe' | 'commandShell' | 'rename' | 'commands' | 'runCommand'>;

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

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