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

package/lib/types/dsh-adapter/process-exit.js

@@ -0,0 +1,60 @@
+/**
+ * Signals and exit in this package's entry go through the TUI's exit funnel
+ * (./plugin.ts) when it is up, else the entry disposes the root, bounded. A
+ * termination signal ends the process by that signal, not `runProfile`'s 0 /
+ * 130 (the launcher reads non-zero as a crash, 0 hides it from `timeout`,
+ * tmux and service managers); a second signal forces the exit at once.
+ */
+export const TERMINATION_SIGNALS = ['SIGTERM', 'SIGHUP', 'SIGINT'];
+/** dsh `process-shutdown` PROCESS_SHUTDOWN_TIMEOUT_MS (0.2.1-rc.2): the dispose bound. */
+export const PROCESS_SHUTDOWN_TIMEOUT_MS = 5000;
+/** Last-resort bound for a funnel exit: outlasts its terminal cleanup plus the dispose bound. */
+const BACKSTOP_MS = PROCESS_SHUTDOWN_TIMEOUT_MS + 2000;
+/** How long a re-raised signal may be held by foreign listeners before they go. */
+const RERAISE_GRACE_MS = 500;
+const installed = new Map();
+/**
+ * End the process by `signal`. Only the entry's own listeners come off, so the
+ * renderer's signal-exit hook still restores the terminal; a foreign listener
+ * would keep the process alive, so after a short grace every listener goes.
+ */
+export function dieBySignal(signal) {
+    for (const [name, listener] of installed)
+        process.removeListener(name, listener);
+    installed.clear();
+    setTimeout(() => {
+        process.removeAllListeners(signal);
+        process.kill(process.pid, signal);
+    }, RERAISE_GRACE_MS);
+    process.kill(process.pid, signal);
+}
+/** Once per process. */
+export function installEntrySignals(options) {
+    let first;
+    const onSignal = (signal) => {
+        if (first !== undefined) {
+            options.log?.('signal: second signal, forcing the exit', { first, signal });
+            dieBySignal(signal);
+            return;
+        }
+        first = signal;
+        const answer = options.seam.request?.({ kind: 'signal', signal }) ?? 'refused';
+        options.log?.('signal: received', { signal, answer });
+        if (answer === 'supervising') {
+            // The replacement decides; a second signal still forces this process.
+            return;
+        }
+        setTimeout(() => {
+            options.log?.('signal: backstop reached, forcing the exit', { signal });
+            dieBySignal(signal);
+        }, answer === 'refused' ? PROCESS_SHUTDOWN_TIMEOUT_MS : BACKSTOP_MS);
+        if (answer === 'refused') {
+            void options.disposeRoot().then(() => { dieBySignal(signal); }, () => { dieBySignal(signal); });
+        }
+    };
+    for (const signal of TERMINATION_SIGNALS) {
+        const listener = () => { onSignal(signal); };
+        installed.set(signal, listener);
+        process.on(signal, listener);
+    }
+}

package/lib/types/dsh-adapter/root-dispose.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Disposing the entry's root while the profile may still be composing into it:
+ * @deepseek-ai/dsh-hmr deadlocks when disposed while its init starts config
+ * watchers, so a root dispose first lets the Loader settle, and the composition
+ * skips its audit and readiness once a dispose is waiting.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+export interface CompositionTracker {
+    /** True once a root dispose waits for the composition: stop short of the audit and readiness. */
+    readonly disposing: boolean;
+    /** Composed, failed or stopped. */
+    done(): void;
+}
+/** A root dispose waits for `settle` first. */
+export declare function trackComposition(root: Context, settle: () => Promise<unknown>): CompositionTracker;
+/** Dispose the root once a composition in progress on it has let its Loader settle. */
+export declare function disposeRootSettled(ctx: Context, dispose?: () => Promise<unknown>): Promise<unknown>;
+//# sourceMappingURL=root-dispose.d.ts.map

package/lib/types/dsh-adapter/root-dispose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-dispose.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/root-dispose.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAUlD,MAAM,WAAW,kBAAkB;IACjC,iGAAiG;IACjG,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,mCAAmC;IACnC,IAAI,IAAI,IAAI,CAAA;CACb;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAUlG;AAED,uFAAuF;AACvF,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,MAAM,OAAO,CAAC,OAAO,CAAkC,GAAG,OAAO,CAAC,OAAO,CAAC,CAWzI"}

package/lib/types/dsh-adapter/root-dispose.js

@@ -0,0 +1,28 @@
+const compositions = new WeakMap();
+/** A root dispose waits for `settle` first. */
+export function trackComposition(root, settle) {
+    const key = root.root;
+    const composition = { settle, disposing: false };
+    compositions.set(key, composition);
+    return {
+        get disposing() { return composition.disposing; },
+        done() {
+            if (compositions.get(key) === composition)
+                compositions.delete(key);
+        },
+    };
+}
+/** Dispose the root once a composition in progress on it has let its Loader settle. */
+export async function disposeRootSettled(ctx, dispose = () => ctx.root.fiber.dispose()) {
+    const composition = compositions.get(ctx.root);
+    if (composition !== undefined) {
+        composition.disposing = true;
+        try {
+            await composition.settle();
+        }
+        catch {
+            // A failed activation is the composition's to report; dispose anyway.
+        }
+    }
+    return dispose();
+}

package/lib/types/dsh-adapter/session-list-metadata.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Mirror dsh-api-session-controller's sessionListMetadata projection (0.2.0-rc.2).
+ * The web sidebar treats a missing row as nonblank, so TUI checkpoints need the
+ * same key, stateVersion, schema and fold. verify-session-list-metadata checks
+ * the installed host definition for drift.
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+export declare const SESSION_LIST_METADATA_KEY = "sessionListMetadata";
+export declare const SESSION_LIST_METADATA_STATE_VERSION = 1;
+export interface SessionListMetadataState {
+    readonly blank: boolean;
+    readonly lastPromptAt: number | null;
+}
+export declare function initSessionListMetadata(): SessionListMetadataState;
+/** Match the host fold, including reference identity when neither field changes. */
+export declare function applySessionListMetadata(state: SessionListMetadataState, event: SessionEvent): SessionListMetadataState;
+/** Register before creating the boot agent, so its first checkpoint has the key. */
+export declare function attachSessionListMetadata(ctx: Context): void;
+//# sourceMappingURL=session-list-metadata.d.ts.map

package/lib/types/dsh-adapter/session-list-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-list-metadata.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/session-list-metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG5D,eAAO,MAAM,yBAAyB,wBAAwB,CAAA;AAC9D,eAAO,MAAM,mCAAmC,IAAI,CAAA;AAEpD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;CACrC;AAOD,wBAAgB,uBAAuB,IAAI,wBAAwB,CAElE;AAED,oFAAoF;AACpF,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,wBAAwB,EAC/B,KAAK,EAAE,YAAY,GAClB,wBAAwB,CAQ1B;AAuBD,oFAAoF;AACpF,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAe5D"}

package/lib/types/dsh-adapter/session-list-metadata.js

@@ -0,0 +1,56 @@
+import { z } from 'zod';
+export const SESSION_LIST_METADATA_KEY = 'sessionListMetadata';
+export const SESSION_LIST_METADATA_STATE_VERSION = 1;
+const sessionListMetadataSchema = z.object({
+    blank: z.boolean(),
+    lastPromptAt: z.number().nullable(),
+});
+export function initSessionListMetadata() {
+    return { blank: true, lastPromptAt: null };
+}
+/** Match the host fold, including reference identity when neither field changes. */
+export function applySessionListMetadata(state, event) {
+    const blank = state.blank && event.type !== 'turn/start';
+    const lastPromptAt = event.type === 'user/message' && event.data.source.kind === 'user'
+        ? event.time
+        : state.lastPromptAt;
+    return blank === state.blank && lastPromptAt === state.lastPromptAt
+        ? state
+        : { blank, lastPromptAt };
+}
+function sessionListMetadataDefinition() {
+    const view = (state) => state;
+    return {
+        key: SESSION_LIST_METADATA_KEY,
+        stateVersion: SESSION_LIST_METADATA_STATE_VERSION,
+        stateSchema: sessionListMetadataSchema,
+        init: initSessionListMetadata,
+        apply: applySessionListMetadata,
+        wire: { viewSchema: sessionListMetadataSchema, view },
+        // rc.6 and alpha.2 registries accept register() but read these older fields.
+        // Reuse the same schema and view so registration order cannot change meaning.
+        schema: sessionListMetadataSchema,
+        viewSchema: sessionListMetadataSchema,
+        view,
+    };
+}
+/** Register before creating the boot agent, so its first checkpoint has the key. */
+export function attachSessionListMetadata(ctx) {
+    ctx.inject(['sessionProjections'], ((projectionCtx) => {
+        const registry = projectionCtx.sessionProjections;
+        if (typeof registry?.register !== 'function')
+            return;
+        try {
+            // The host binds this registration to the calling context's fiber.
+            registry.register(sessionListMetadataDefinition());
+        }
+        catch (error) {
+            try {
+                ctx.logger.debug(`dsh-tui: could not register sessionListMetadata: ${String(error)}`);
+            }
+            catch {
+                // Diagnostics must not turn a missing seam or version conflict into a startup failure.
+            }
+        }
+    }));
+}

package/lib/types/dsh-adapter/session-projection-store.d.ts

@@ -0,0 +1,66 @@
+/**
+ * One host session-projection key, folded for the session on screen.
+ *
+ * The host projection feed is process-wide and carries whole values, so a
+ * read side needs the same three pieces every time: drop other keys, narrow
+ * the wire value with a local guard (the producer package is never imported),
+ * and read one baseline snapshot when a session binds — a value is only
+ * published on change, so a resumed session would otherwise wait for its next
+ * event. The store keeps only the watched session's value: a background
+ * session must not overwrite what the screen shows.
+ *
+ * @module
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { ProjectionRegistryLike } from './activity-store.js';
+/** The session whose projection value the session on screen shows. */
+export interface WatchedSession {
+    readonly id: string;
+    /** The live session object, when there is one to read a baseline from. */
+    readonly session?: unknown;
+}
+export interface SessionProjectionStoreOptions<T> {
+    /** Projection key the value is published under. */
+    readonly key: string;
+    /** Narrow one wire value of a session; anything else is dropped, never half-rendered. */
+    narrow(value: unknown, sessionId: string): T | undefined;
+    /** Map the bound session to the session it reads (default: itself). */
+    watch?(session: unknown): WatchedSession;
+    /** Read-failure sink, reported once per attached registry (the composition root's logger). */
+    warn?(message: string): void;
+}
+export interface SessionProjectionStore<T> {
+    /** Remember the host registry; a late registry seeds the bound session. */
+    attachRegistry(registry: ProjectionRegistryLike): void;
+    /** Forget a registry that left; nothing is read from it again and the value clears. */
+    detachRegistry(registry: ProjectionRegistryLike): void;
+    /** Bind the session on screen and read its watched value once. */
+    seed(session: unknown): void;
+    /** Record one value from the change feed. */
+    update(sessionId: string, value: unknown): void;
+    /**
+     * Read the bound session's baseline again. For a change the feed does not
+     * carry: a projection definition that left (its key reads as absent) or
+     * came back.
+     */
+    reseed(): void;
+    /** The bound session's id, once a session bound. */
+    readonly boundId: string | undefined;
+    /** The watched session's id, once a session bound. */
+    readonly watchedId: string | undefined;
+    /** The watched session's current value, stable between updates. */
+    read(): T | undefined;
+    subscribe(listener: () => void): () => void;
+    noteReadFailure(error: unknown): void;
+}
+export declare function createSessionProjectionStore<T>(options: SessionProjectionStoreOptions<T>): SessionProjectionStore<T>;
+/**
+ * Wire one store to the host's projection registry once it exists. The
+ * registry and the unit that publishes the key are mounted by other plugins,
+ * so both may arrive later — or never, which leaves the store empty.
+ * @param ctx - Host context of the composition root.
+ * @param key - Projection key the store folds.
+ * @param store - Store to fill.
+ */
+export declare function attachSessionProjection(ctx: Context, key: string, store: SessionProjectionStore<unknown>): void;
+//# sourceMappingURL=session-projection-store.d.ts.map

package/lib/types/dsh-adapter/session-projection-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-projection-store.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/session-projection-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAEjE,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,6BAA6B,CAAC,CAAC;IAC9C,mDAAmD;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,yFAAyF;IACzF,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAA;IACxD,uEAAuE;IACvE,KAAK,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAAA;IACxC,8FAA8F;IAC9F,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,2EAA2E;IAC3E,cAAc,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAA;IACtD,uFAAuF;IACvF,cAAc,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAA;IACtD,kEAAkE;IAClE,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,6CAA6C;IAC7C,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;IAC/C;;;;OAIG;IACH,MAAM,IAAI,IAAI,CAAA;IACd,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IACtC,mEAAmE;IACnE,IAAI,IAAI,CAAC,GAAG,SAAS,CAAA;IACrB,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;IAC3C,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;CACtC;AASD,wBAAgB,4BAA4B,CAAC,CAAC,EAAE,OAAO,EAAE,6BAA6B,CAAC,CAAC,CAAC,GAAG,sBAAsB,CAAC,CAAC,CAAC,CAsFpH;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,GAAG,IAAI,CAmB/G"}

package/lib/types/dsh-adapter/session-projection-store.js

@@ -0,0 +1,149 @@
+/**
+ * One host session-projection key, folded for the session on screen.
+ *
+ * The host projection feed is process-wide and carries whole values, so a
+ * read side needs the same three pieces every time: drop other keys, narrow
+ * the wire value with a local guard (the producer package is never imported),
+ * and read one baseline snapshot when a session binds — a value is only
+ * published on change, so a resumed session would otherwise wait for its next
+ * event. The store keeps only the watched session's value: a background
+ * session must not overwrite what the screen shows.
+ *
+ * @module
+ */
+/** A raw value no snapshot can return: the next update always narrows. */
+const UNREAD = Symbol('unread');
+function sessionIdOf(session) {
+    return String(session.id);
+}
+export function createSessionProjectionStore(options) {
+    const listeners = new Set();
+    let registry;
+    let bound;
+    let watched;
+    let raw;
+    let value;
+    let warned = false;
+    const emit = () => {
+        for (const listener of [...listeners])
+            listener();
+    };
+    const store = {
+        attachRegistry(next) {
+            registry = next;
+            warned = false;
+            if (bound !== undefined)
+                store.seed(bound);
+        },
+        detachRegistry(left) {
+            if (registry !== left)
+                return;
+            registry = undefined;
+            raw = undefined;
+            if (value === undefined)
+                return;
+            value = undefined;
+            emit();
+        },
+        seed(session) {
+            if (session === null || session === undefined)
+                return;
+            bound = session;
+            const next = options.watch?.(session) ?? { id: sessionIdOf(session), session };
+            if (next.id !== watched?.id) {
+                raw = undefined;
+                if (value !== undefined) {
+                    value = undefined;
+                    emit();
+                }
+            }
+            watched = next;
+            if (registry === undefined || next.session === undefined)
+                return;
+            try {
+                store.update(next.id, registry.snapshot(next.session, [options.key]).values[options.key]);
+            }
+            catch (error) {
+                store.noteReadFailure(error);
+            }
+        },
+        update(sessionId, next) {
+            if (sessionId !== watched?.id)
+                return;
+            // The host reuses the value reference while its state is unchanged, so
+            // identity is the whole change test.
+            if (next === raw)
+                return;
+            raw = next;
+            const narrowed = options.narrow(next, sessionId);
+            if (narrowed === undefined && value === undefined)
+                return;
+            value = narrowed;
+            emit();
+        },
+        reseed() {
+            if (bound === undefined)
+                return;
+            // The narrow may read host state the value reference does not track
+            // (the team's service presence), so an unchanged value, an absent one
+            // included, is re-narrowed.
+            const held = raw;
+            raw = UNREAD;
+            store.seed(bound);
+            // No snapshot was read (no registry, the watched session not live, or a
+            // failed read): narrow the value already held instead.
+            if (raw === UNREAD && held !== UNREAD && watched !== undefined)
+                store.update(watched.id, held);
+        },
+        get boundId() {
+            return bound === undefined ? undefined : sessionIdOf(bound);
+        },
+        get watchedId() {
+            return watched?.id;
+        },
+        read: () => value,
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => { listeners.delete(listener); };
+        },
+        noteReadFailure(error) {
+            if (warned)
+                return;
+            warned = true;
+            const detail = error instanceof Error ? error.message : String(error);
+            options.warn?.(`dsh-tui: ${options.key} projection read failed: ${detail}`);
+        },
+    };
+    return store;
+}
+/**
+ * Wire one store to the host's projection registry once it exists. The
+ * registry and the unit that publishes the key are mounted by other plugins,
+ * so both may arrive later — or never, which leaves the store empty.
+ * @param ctx - Host context of the composition root.
+ * @param key - Projection key the store folds.
+ * @param store - Store to fill.
+ */
+export function attachSessionProjection(ctx, key, store) {
+    ctx.inject(['sessionProjections'], ((projectionCtx) => {
+        const registry = projectionCtx.sessionProjections;
+        if (registry === undefined)
+            return;
+        store.attachRegistry(registry);
+        let offFeed;
+        try {
+            offFeed = registry.onChanged((session, changed, value) => {
+                if (changed === key)
+                    store.update(sessionIdOf(session), value);
+            });
+        }
+        catch (error) {
+            store.noteReadFailure(error);
+        }
+        // On the injected fiber: a re-provided registry re-runs this callback.
+        projectionCtx.effect(() => () => {
+            offFeed?.();
+            store.detachRegistry(registry);
+        }, `dsh-tui ${key} projection feed`);
+    }));
+}

package/lib/types/dsh-adapter/session-seed.d.ts

@@ -0,0 +1,11 @@
+/** Whether an inherited cut contains no human message or started turn. */
+export declare function holdsNoConversation(events: readonly unknown[]): boolean;
+export interface PolicyFact {
+    readonly type: string;
+    readonly data: unknown;
+}
+/** Last value of each policy fact, ordered by its last occurrence in the cut. */
+export declare function latestPolicyFacts(events: readonly unknown[]): readonly PolicyFact[];
+/** Replay after creation: appending during setup prevents the fresh-session gate from arming. */
+export declare function replayPolicyFacts(session: unknown, facts: readonly PolicyFact[]): void;
+//# sourceMappingURL=session-seed.d.ts.map

package/lib/types/dsh-adapter/session-seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-seed.d.ts","sourceRoot":"","sources":["../../../src/dsh-adapter/session-seed.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAiBvE;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CACvB;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,SAAS,UAAU,EAAE,CAUnF;AAED,iGAAiG;AACjG,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI,CAGtF"}

package/lib/types/dsh-adapter/session-seed.js

@@ -0,0 +1,47 @@
+import { INITIAL_POLICY_EVENTS, isHumanSource } from './fresh-agent.js';
+/** Whether an inherited cut contains no human message or started turn. */
+export function holdsNoConversation(events) {
+    return !events.some(event => {
+        if (event === null || typeof event !== 'object' || Array.isArray(event))
+            return false;
+        const { type, data } = event;
+        if (type === 'turn/start')
+            return true;
+        if (type !== 'user/message' && type !== 'agent/inbox/spliced')
+            return false;
+        // An unreadable conversational event cannot prove an empty cut.
+        if (data === null || typeof data !== 'object' || Array.isArray(data))
+            return true;
+        const record = data;
+        if (type === 'user/message')
+            return isHumanSource(record.source);
+        if (!Array.isArray(record.inserted))
+            return true;
+        return record.inserted.some(message => {
+            if (message === null || typeof message !== 'object')
+                return false;
+            const entry = message;
+            return entry.role === 'user' && isHumanSource(entry.source);
+        });
+    });
+}
+/** Last value of each policy fact, ordered by its last occurrence in the cut. */
+export function latestPolicyFacts(events) {
+    const facts = new Map();
+    for (const event of events) {
+        if (event === null || typeof event !== 'object' || Array.isArray(event))
+            continue;
+        const { type, data } = event;
+        if (typeof type !== 'string' || !INITIAL_POLICY_EVENTS.has(type))
+            continue;
+        facts.delete(type);
+        facts.set(type, { type, data });
+    }
+    return [...facts.values()];
+}
+/** Replay after creation: appending during setup prevents the fresh-session gate from arming. */
+export function replayPolicyFacts(session, facts) {
+    const target = session;
+    for (const fact of facts)
+        target.append(fact.type, fact.data);
+}

package/lib/types/dsh-adapter/sessions/list.d.ts

@@ -46,11 +46,13 @@ export declare function enumerateSessions(source: SessionSource, signal?: AbortS
  *
  * @param source - The persistence service.
  * @param signal - Optional cancellation for the backend's own listing work.
+ * @param priorityCwd - Resolve this workspace before others for partial results;
+ *   the final listing still includes every workspace, sorted by activity.
  * @returns One summary per stored session, most recently active first. No
  *   filtering of any kind is applied — sub-agent runs and sessions with no
  *   conversation are present and labelled as such.
  */
-export declare function listSummaries(source: SessionSource, signal?: AbortSignal, onEnriched?: (summary: SessionSummary) => void, onPartial?: (summaries: readonly SessionSummary[]) => void): Promise<readonly SessionSummary[]>;
+export declare function listSummaries(source: SessionSource, signal?: AbortSignal, onEnriched?: (summary: SessionSummary) => void, onPartial?: (summaries: readonly SessionSummary[]) => void, priorityCwd?: string): Promise<readonly SessionSummary[]>;
 /**
  * Resolve one session's artifact path.
  *

package/lib/types/dsh-adapter/sessions/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/sessions/list.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAGzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAQhD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,wEAAwE;IACxE,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;IACrE,iEAAiE;IACjE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;IAC5D,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAA;CACpC;AAED,4EAA4E;AAC5E,UAAU,MAAM;IACd,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CACtC;AAaD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBtG;AAwCD;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,MAAM,CAAC,EAAE,WAAW,EACpB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,EAC9C,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,KAAK,IAAI,GACzD,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAoOpC;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAS7B"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/sessions/list.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAwB,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAGzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAShD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,wEAAwE;IACxE,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;IACrE,iEAAiE;IACjE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAA;IAC5D,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAA;CACpC;AAED,4EAA4E;AAC5E,UAAU,MAAM;IACd,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;CACtC;AAaD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgBtG;AAwCD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,MAAM,CAAC,EAAE,WAAW,EACpB,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,EAC9C,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,KAAK,IAAI,EAC1D,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAuOpC;AAOD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAS7B"}

package/lib/types/dsh-adapter/sessions/list.js

@@ -26,6 +26,7 @@ import { classify, readHeader } from './header.js';
 import { findSessionLogFile, resolveLocatedPath } from '../compat/sessionLog.js';
 import { indexFileStamp, readIndex, writeIndex } from './store.js';
 import { readLastUsed } from '../../sessionHistory.js';
+import { normalizeWorkspaceCwd } from '../../sessions/view.js';
 /** A late overlapping listing must not write an older index over a newer one. */
 const listingVersions = new WeakMap();
 /** Large append batches use bounded windows, then background title recovery. */
@@ -116,11 +117,13 @@ function locate(source, raw, sessionId) {
  *
  * @param source - The persistence service.
  * @param signal - Optional cancellation for the backend's own listing work.
+ * @param priorityCwd - Resolve this workspace before others for partial results;
+ *   the final listing still includes every workspace, sorted by activity.
  * @returns One summary per stored session, most recently active first. No
  *   filtering of any kind is applied — sub-agent runs and sessions with no
  *   conversation are present and labelled as such.
  */
-export async function listSummaries(source, signal, onEnriched, onPartial) {
+export async function listSummaries(source, signal, onEnriched, onPartial, priorityCwd) {
     const identity = source.identity ?? source;
     const version = (listingVersions.get(identity) ?? 0) + 1;
     listingVersions.set(identity, version);
@@ -144,10 +147,12 @@ export async function listSummaries(source, signal, onEnriched, onPartial) {
     const index = readIndex();
     const next = new Map();
     const lastUsed = readLastUsed();
-    // Recent conversations lead cold partial batches; backend directory order
-    // must not keep the useful rows behind thousands of old delegated runs.
+    // Resolve the current workspace first, even when other projects are newer.
+    // Activity determines processing order within each group, and final order.
+    const cwd = priorityCwd ? normalizeWorkspaceCwd(priorityCwd) : undefined;
+    const workspace = new Set(cwd === undefined ? [] : listed.filter(entry => normalizeWorkspaceCwd(entry.header.cwd ?? '') === cwd));
     const activity = (entry) => Math.max(index.get(entry.header.id)?.derived?.modifiedAt ?? 0, lastUsed[entry.header.id] ?? 0, entry.header.createdAt ?? 0);
-    listed.sort((a, b) => activity(b) - activity(a));
+    listed.sort((a, b) => Number(workspace.has(b)) - Number(workspace.has(a)) || activity(b) - activity(a));
     let changed = false;
     const records = [];
     const summaryOf = ({ header, facts, cached, derived }) => ({
@@ -302,7 +307,8 @@ export async function listSummaries(source, signal, onEnriched, onPartial) {
         recordsById.set(header.id, record);
         // Yield even for a cold index: scanning many individually bounded logs
         // must not freeze the renderer. Partial rows are never saved as a snapshot.
-        if (records.length % 32 === 0) {
+        // A small workspace must paint before we touch another project's logs.
+        if (records.length % 32 === 0 || (records.length === workspace.size && records.length < listed.length)) {
             if (listingVersions.get(identity) === version)
                 onPartial?.(records.map(summaryOf).sort(compareSummaries));
             await new Promise(resolve => setImmediate(resolve));

package/lib/types/dsh-adapter/sessions/snapshot.d.ts

@@ -1,7 +1,5 @@
 import type { SessionSource } from './list.js';
 import type { SessionSummary } from './types.js';
-/** Undefined is unknown; an empty snapshot is a successful empty listing. */
 export declare function readListingSnapshot(source: SessionSource): readonly SessionSummary[] | undefined;
-/** Capture ordering before async work, including across distinct Context proxies. */
 export declare function beginListingSnapshot(source: SessionSource): (rows: readonly SessionSummary[]) => void;
 //# sourceMappingURL=snapshot.d.ts.map

package/lib/types/dsh-adapter/sessions/snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/sessions/snapshot.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAiDhD,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,cAAc,EAAE,GAAG,SAAS,CAGhG;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,KAAK,IAAI,CAiBrG"}
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../../src/dsh-adapter/sessions/snapshot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAehD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,cAAc,EAAE,GAAG,SAAS,CAGhG;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,CAAC,IAAI,EAAE,SAAS,cAAc,EAAE,KAAK,IAAI,CAGrG"}