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

package/lib/types/channel/permissions.d.ts

@@ -0,0 +1,155 @@
+/**
+ * The shared permission prompt surface: one view shape the approval panel
+ * renders for every backend, the small interface Chat drives it through, and
+ * `PermissionStore`, the FIFO store a non-DSH session's `permission.request`
+ * events park in.
+ *
+ * Queue semantics mirror the DSH `ApprovalStore`: parallel tool calls can
+ * raise several prompts before any answer, so they drain first in, first out
+ * with exactly one on the panel. A prompt settles exactly once:
+ *  - `decide` — the user picked an option on the panel (allow once / allow
+ *    always / reject, the reject optionally carrying the user's reason);
+ *  - `withdraw` — the backend took the prompt back (its own cancellation:
+ *    interrupt, turn end, process exit) → `cancelled`;
+ *  - `withdrawSession` / `settleAll` — the session left the binding or the
+ *    host tears down → `cancelled`.
+ * Only a user decision reaches the backend: a withdrawn prompt was already
+ * answered on the backend side, so answering it again would be a second,
+ * conflicting verdict.
+ *
+ * Backend-neutral: no vendor types, no DSH imports (`verify:boundary`).
+ */
+import type { PermissionDecision } from '../agent/capabilities.js';
+import type { PermissionOptionView, PermissionOutcome, PermissionRequestView } from '../agent/events.js';
+/** What the approval panel renders for the active prompt. */
+export interface PermissionPanelSnapshot {
+    /** Stable key so the panel remounts (fresh focus state) per prompt. */
+    readonly key: string;
+    /** The tool (or its short display name) the prompt gates. */
+    readonly toolName: string;
+    /**
+     * The asking session's id. A prompt from a session other than the attached
+     * one (a DSH background session in the agent view) is labelled as such.
+     */
+    readonly agentId: string;
+    /** Full prompt sentence, when the backend renders one. */
+    readonly title?: string;
+    /** One-line rendering of the gated action (command, file, URL). */
+    readonly command?: string;
+    /** Why the backend asks. */
+    readonly reason?: string;
+    /** What granting would allow. */
+    readonly description?: string;
+    /** The path outside the allowed directories that triggered the ask. */
+    readonly blockedPath?: string;
+    /** The asking subagent (a delegated agent inside the attached session). */
+    readonly subagentId?: string;
+    /** DSH source badge: the ask is not anchored to a live tool call. */
+    readonly external?: true;
+    /** The choices, in the backend's order; absent = allow once / reject. */
+    readonly options?: readonly PermissionOptionView[];
+    /** Reject first, and no single keystroke approves. */
+    readonly defaultToNo?: boolean;
+    /** No persistent "don't ask again" choice may be shown. */
+    readonly suppressAlwaysAllow?: boolean;
+    /** A user ask rule forced this prompt (no "don't ask again" either). */
+    readonly matchedAskRule?: boolean;
+    /** Typing on the panel composes a reason sent back with a rejection. */
+    readonly feedback?: boolean;
+}
+/** The panel's outcome vocabulary (the DSH protocol's two plus allow-always). */
+export type PermissionPanelOutcome = 'allowed-once' | 'allowed-always' | 'rejected';
+/** The option the user picked, with the reason typed for a rejection. */
+export interface PermissionPanelDecision {
+    readonly optionId: string;
+    readonly kind: PermissionOptionView['kind'];
+    readonly feedback?: string;
+    /**
+     * The snapshot key of the panel that decided. A store ignores a decision
+     * whose key is not its active prompt's: a keystroke a just-withdrawn panel
+     * still handled must never answer the prompt that replaced it.
+     */
+    readonly key?: string;
+}
+/**
+ * The store interface the approval panel host (Chat, the session
+ * supervisor) drives: the DSH `ApprovalStore` and `PermissionStore` both
+ * implement it, so one panel renders either.
+ */
+export interface PermissionPanelSource {
+    subscribe(listener: () => void): () => void;
+    getSnapshot(): PermissionPanelSnapshot | null;
+    /** Settle the active prompt with the user's choice. */
+    decide(outcome: PermissionPanelOutcome, decision?: PermissionPanelDecision): void;
+}
+/** The two choices every prompt without backend options offers. */
+export declare const DEFAULT_PERMISSION_OPTIONS: readonly PermissionOptionView[];
+/** The panel outcome of an option kind. */
+export declare function panelOutcomeOf(kind: PermissionOptionView['kind']): PermissionPanelOutcome;
+/**
+ * The options a panel may show for one prompt, in display order: an
+ * allow-always option is dropped when the prompt forbids it (suppressed, or
+ * forced by an ask rule; backends already omit it, so this is a second
+ * guard), and `defaultToNo` moves the rejections to the front.
+ */
+export declare function visiblePermissionOptions(snapshot: Pick<PermissionPanelSnapshot, 'options' | 'defaultToNo' | 'suppressAlwaysAllow' | 'matchedAskRule'>): readonly PermissionOptionView[];
+/** One parked prompt: the backend's view plus how its settlement is reported. */
+export interface PermissionAsk {
+    /** The session that raised it (`AgentSessionRef.sessionId`). */
+    readonly sessionId: string;
+    readonly request: PermissionRequestView;
+    /**
+     * Called exactly once. `decision` is present only for a user decision
+     * (allow-once / allow-always / rejected); `cancelled` carries none.
+     */
+    settle(outcome: PermissionOutcome, decision?: PermissionDecision): void;
+}
+/**
+ * FIFO permission store for backend sessions (the shared half of the
+ * approval flow). Chat renders `getSnapshot()` through the approval panel;
+ * the channel parks and withdraws as the session's events arrive.
+ */
+export declare class PermissionStore implements PermissionPanelSource {
+    private readonly queue;
+    private active;
+    private readonly listeners;
+    private seq;
+    /** Stable reference between mutations (useSyncExternalStore contract). */
+    private snapshotCache;
+    subscribe(listener: () => void): () => void;
+    getSnapshot(): PermissionPanelSnapshot | null;
+    /** Every parked prompt (active first), in the backend's own shape. */
+    pending(): readonly PermissionRequestView[];
+    /** Session ids with a parked prompt, deduplicated, in park order. */
+    pendingAgentIds(): readonly string[];
+    /** The first parked prompt's summary for one session. */
+    pendingAgentDetail(sessionId: string): {
+        readonly toolName: string;
+        readonly reason?: string;
+        readonly command?: string;
+    } | undefined;
+    /** Park one prompt; it surfaces once every earlier prompt settled. A
+     *  duplicate (same session and request id) is refused as cancelled. */
+    park(ask: PermissionAsk): void;
+    /**
+     * The user decided on the active prompt. The outcome's option comes from
+     * `decision` when given (it names which allow-always option and carries a
+     * rejection's reason); a bare outcome picks the first option of its kind.
+     */
+    decide(outcome: PermissionPanelOutcome, decision?: PermissionPanelDecision): void;
+    /** The backend withdrew one prompt (its own cancellation). */
+    withdraw(sessionId: string, requestId: string): boolean;
+    /** A session left the binding: withdraw every prompt it parked. */
+    withdrawSession(sessionId: string): void;
+    /** Withdraw everything (host teardown). */
+    settleAll(): void;
+    private all;
+    private find;
+    private remove;
+    /** A settle callback that throws must not wedge the queue. */
+    private settle;
+    private startNext;
+    private rebuild;
+    private emit;
+}
+//# sourceMappingURL=permissions.d.ts.map

package/lib/types/channel/permissions.d.ts.map

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

package/lib/types/channel/permissions.js

@@ -0,0 +1,188 @@
+/** The two choices every prompt without backend options offers. */
+export const DEFAULT_PERMISSION_OPTIONS = Object.freeze([
+    Object.freeze({ id: 'allow-once', kind: 'allow-once' }),
+    Object.freeze({ id: 'reject', kind: 'reject' }),
+]);
+/** The panel outcome of an option kind. */
+export function panelOutcomeOf(kind) {
+    return kind === 'allow-once' ? 'allowed-once' : kind === 'allow-always' ? 'allowed-always' : 'rejected';
+}
+/**
+ * The options a panel may show for one prompt, in display order: an
+ * allow-always option is dropped when the prompt forbids it (suppressed, or
+ * forced by an ask rule; backends already omit it, so this is a second
+ * guard), and `defaultToNo` moves the rejections to the front.
+ */
+export function visiblePermissionOptions(snapshot) {
+    const all = snapshot.options ?? DEFAULT_PERMISSION_OPTIONS;
+    const allowed = snapshot.suppressAlwaysAllow === true || snapshot.matchedAskRule === true
+        ? all.filter(option => option.kind !== 'allow-always')
+        : all;
+    if (snapshot.defaultToNo !== true)
+        return allowed;
+    return [...allowed.filter(option => option.kind === 'reject'), ...allowed.filter(option => option.kind !== 'reject')];
+}
+/** Composite identity: request ids are only unique within one session. */
+const idOf = (sessionId, requestId) => `${sessionId}\u0000${requestId}`;
+/**
+ * FIFO permission store for backend sessions (the shared half of the
+ * approval flow). Chat renders `getSnapshot()` through the approval panel;
+ * the channel parks and withdraws as the session's events arrive.
+ */
+export class PermissionStore {
+    queue = [];
+    active;
+    listeners = new Set();
+    seq = 0;
+    /** Stable reference between mutations (useSyncExternalStore contract). */
+    snapshotCache = null;
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => { this.listeners.delete(listener); };
+    }
+    getSnapshot() {
+        return this.snapshotCache;
+    }
+    /** Every parked prompt (active first), in the backend's own shape. */
+    pending() {
+        return this.all().map(parked => parked.ask.request);
+    }
+    /** Session ids with a parked prompt, deduplicated, in park order. */
+    pendingAgentIds() {
+        return [...new Set(this.all().map(parked => parked.ask.sessionId))];
+    }
+    /** The first parked prompt's summary for one session. */
+    pendingAgentDetail(sessionId) {
+        const parked = this.all().find(entry => entry.ask.sessionId === sessionId);
+        if (parked === undefined)
+            return undefined;
+        const { toolName, reason, command } = parked.ask.request;
+        return { toolName, ...(reason === undefined ? {} : { reason }), ...(command === undefined ? {} : { command }) };
+    }
+    /** Park one prompt; it surfaces once every earlier prompt settled. A
+     *  duplicate (same session and request id) is refused as cancelled. */
+    park(ask) {
+        const id = idOf(ask.sessionId, ask.request.requestId);
+        if (this.find(id) !== undefined) {
+            ask.settle('cancelled');
+            return;
+        }
+        this.queue.push({ key: String(++this.seq), ask });
+        this.startNext();
+    }
+    /**
+     * The user decided on the active prompt. The outcome's option comes from
+     * `decision` when given (it names which allow-always option and carries a
+     * rejection's reason); a bare outcome picks the first option of its kind.
+     */
+    decide(outcome, decision) {
+        const parked = this.active;
+        if (parked === undefined)
+            return;
+        if (decision?.key !== undefined && decision.key !== parked.key)
+            return;
+        const kind = decision?.kind ?? (outcome === 'allowed-once' ? 'allow-once' : outcome === 'allowed-always' ? 'allow-always' : 'reject');
+        const options = parked.ask.request.options;
+        // A choice the prompt never offered is refused (fail closed): only the
+        // rejection is always available.
+        const offered = kind === 'reject' || options.some(option => option.kind === kind && (decision === undefined || option.id === decision.optionId));
+        const verdict = !offered || kind === 'reject'
+            ? { kind: 'reject', ...(decision?.feedback === undefined || decision.feedback.trim() === '' ? {} : { message: decision.feedback.trim() }) }
+            : kind === 'allow-always'
+                ? { kind: 'allow-always', ...(decision === undefined ? {} : { optionId: decision.optionId }) }
+                : { kind: 'allow-once' };
+        this.active = undefined;
+        this.rebuild();
+        this.settle(parked, verdict.kind === 'allow-once' ? 'allow-once' : verdict.kind === 'allow-always' ? 'allow-always' : 'rejected', verdict);
+        this.startNext();
+        this.emit();
+    }
+    /** The backend withdrew one prompt (its own cancellation). */
+    withdraw(sessionId, requestId) {
+        const parked = this.find(idOf(sessionId, requestId));
+        if (parked === undefined)
+            return false;
+        this.remove(parked);
+        this.settle(parked, 'cancelled');
+        return true;
+    }
+    /** A session left the binding: withdraw every prompt it parked. */
+    withdrawSession(sessionId) {
+        for (const parked of this.all().filter(entry => entry.ask.sessionId === sessionId)) {
+            this.remove(parked);
+            this.settle(parked, 'cancelled');
+        }
+    }
+    /** Withdraw everything (host teardown). */
+    settleAll() {
+        const parked = this.all();
+        this.active = undefined;
+        this.queue.length = 0;
+        this.rebuild();
+        for (const entry of parked)
+            this.settle(entry, 'cancelled');
+        this.emit();
+    }
+    all() {
+        return [...(this.active === undefined ? [] : [this.active]), ...this.queue];
+    }
+    find(id) {
+        return this.all().find(entry => idOf(entry.ask.sessionId, entry.ask.request.requestId) === id);
+    }
+    remove(parked) {
+        if (this.active === parked) {
+            this.active = undefined;
+            this.rebuild();
+            this.startNext();
+            this.emit();
+            return;
+        }
+        const at = this.queue.indexOf(parked);
+        if (at >= 0)
+            this.queue.splice(at, 1);
+    }
+    /** A settle callback that throws must not wedge the queue. */
+    settle(parked, outcome, decision) {
+        try {
+            parked.ask.settle(outcome, decision);
+        }
+        catch {
+            // The panel already moved on; the owner reports its own failure.
+        }
+    }
+    startNext() {
+        if (this.active !== undefined || this.queue.length === 0)
+            return;
+        this.active = this.queue.shift();
+        this.rebuild();
+        this.emit();
+    }
+    rebuild() {
+        const parked = this.active;
+        if (parked === undefined) {
+            this.snapshotCache = null;
+            return;
+        }
+        const request = parked.ask.request;
+        this.snapshotCache = {
+            key: parked.key,
+            toolName: request.displayName ?? request.toolName,
+            agentId: parked.ask.sessionId,
+            options: request.options,
+            ...(request.title === undefined ? {} : { title: request.title }),
+            ...(request.command === undefined ? {} : { command: request.command }),
+            ...(request.reason === undefined ? {} : { reason: request.reason }),
+            ...(request.description === undefined ? {} : { description: request.description }),
+            ...(request.blockedPath === undefined ? {} : { blockedPath: request.blockedPath }),
+            ...(request.agentId === undefined ? {} : { subagentId: request.agentId }),
+            ...(request.defaultToNo === true ? { defaultToNo: true } : {}),
+            ...(request.suppressAlwaysAllow === true ? { suppressAlwaysAllow: true } : {}),
+            ...(request.matchedAskRule === undefined ? {} : { matchedAskRule: true }),
+            ...(request.feedback === true ? { feedback: true } : {}),
+        };
+    }
+    emit() {
+        for (const listener of [...this.listeners])
+            listener();
+    }
+}

package/lib/types/channel/projection.d.ts

@@ -0,0 +1,110 @@
+/**
+ * The shared reducer (docs/agent-backend-design.md): Agent Domain events in,
+ * `ChannelState` mutations out, for every backend and for durable replay and
+ * the live stream alike. Decoding a backend's native events is not done here:
+ * a translator (`src/dsh-adapter/backend/translate.ts` for DSH) produces the
+ * `AgentEvent`s; this module only folds them.
+ *
+ * The DSH projection goldens (`scripts/fixtures/dsh/*.golden.json`) pin its
+ * behaviour: attempt start/discard/revive, `seq` idempotency, legacy
+ * overlapping-prefix delta merge, thinking preview/full folding, TPS
+ * turn/step accounting, token/cost bucketing, compaction context reset,
+ * goal/todo/preset/title/colour, question/subagent card suppression and the
+ * plugin renderer seam. The order of wall-clock reads is part of that
+ * contract (the goldens pin `startedAt`/`durationMs` with a stepping clock).
+ */
+import type { ChannelUi } from '../adapter/ports/channel-ui.js';
+import type { ChatRow, SelectionAttachment, TodoPanelItem } from '../adapter/ports/channel-view.js';
+import type { AgentEvent, AgentEventMeta, ContentBlockView } from '../agent/events.js';
+import { type PricingWindow } from './usage.js';
+type Mutable<T> = {
+    -readonly [K in keyof T]: T[K];
+};
+/** The channel state slice the projector writes. */
+export interface ProjectionState extends Mutable<Pick<ChannelUi, 'thinkingFold' | 'activeToolCount' | 'spinnerMode' | 'goal' | 'contextSegments' | 'tokens' | 'mainCost' | 'model' | 'lastUsage' | 'turnUsage' | 'lastUserText' | 'responseChars' | 'tps' | 'cancelPending' | 'working' | 'compaction' | 'turnStart' | 'contextWindow' | 'reasoningEffort' | 'sessionTitle' | 'agentPreset' | 'sessionColor' | 'costReport'>> {
+    rows: ChatRow[];
+    tpsSamples: {
+        tps: number;
+        at: number;
+    }[];
+    todos: TodoPanelItem[];
+}
+/** Plugin custom-entry renderer (tuiRenderers seam), structurally. */
+export interface ProjectionRenderer {
+    render(type: string, data: unknown): {
+        readonly title?: string;
+        readonly lines: readonly unknown[];
+    } | undefined;
+}
+/** Everything the projector needs from its channel. */
+export interface ChannelProjectionDeps {
+    rowIds: {
+        value: number;
+    };
+    /** Display name of the bound backend; absent keeps the legacy DSH wording. */
+    backendLabel?: () => string | undefined;
+    resetContextWarning(): void;
+    checkContextWarning(): void;
+    notify: ChannelUi['notify'];
+    /** Background-job registry feed (DSH `jobs` service mirror). */
+    jobs: {
+        onOutputSeen(id: string, text: string, at?: number): void;
+        onStarted(id: string, command: string): void;
+    };
+    /**
+     * The backend-neutral subagent / background-task projection
+     * (`./activity.ts`): every `subagent.*` / `task.*` / `tasks.snapshot` event
+     * and every child-lane event (`parentCallId` set) is handed to it in stream
+     * order, so its transcript cards land where the delegation happened. Child-
+     * lane events never reach the main transcript. Absent (a DSH composition,
+     * whose specialists own these facts) = nothing is forwarded.
+     */
+    activity?: {
+        apply(event: AgentEvent, replaying: boolean): void;
+    };
+    /**
+     * The core's trajectory fold: every event in stream order, child-lane
+     * ones included (their subagent lifecycle still maps onto the parent's
+     * ledger), feeds the neutral raw-event source behind `traceEvents()`.
+     * Absent (a DSH composition, whose raw history is the source) = nothing
+     * is forwarded.
+     */
+    trajectory?: {
+        observe(event: AgentEvent, replaying: boolean): void;
+    };
+    inputConvergence: {
+        cancelInFlight: boolean;
+    };
+    renderer?: ProjectionRenderer;
+    /** What a submitted message's IDE selection attached (keyed by the message
+     *  id the durable event carries), for the user row's indicator line. */
+    selectionAttached(messageId: string): SelectionAttachment | undefined;
+    /**
+     * Rate window a usage at `time` bills under. Injected by the backend that
+     * owns the pricing policy (DSH: the DeepSeek peak hours); absent → every
+     * usage lands in the `idle` bucket.
+     */
+    pricingWindow?: (time: number) => PricingWindow;
+}
+/** Joined, trimmed text of every `text` block (what a bubble or card body shows). */
+export declare function textOfBlocks(blocks: readonly ContentBlockView[] | undefined): string;
+/** Create the shared projector over one channel state. */
+export declare function createChannelProjection(state: ProjectionState, deps: ChannelProjectionDeps): {
+    apply: (events: readonly AgentEvent[], meta: AgentEventMeta) => void;
+    reset: () => void;
+    settleStreaming: () => void;
+    updateSpinnerMode: () => void;
+    contextUsage: () => {
+        readonly type: "context.usage";
+        readonly used: number;
+        readonly max?: number;
+        readonly categories?: readonly {
+            readonly name: string;
+            readonly tokens: number;
+            readonly kind: string;
+        }[];
+    } | undefined;
+};
+export type ChannelProjection = ReturnType<typeof createChannelProjection>;
+export {};
+//# sourceMappingURL=projection.d.ts.map

package/lib/types/channel/projection.d.ts.map

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