@deepseek-ai/dsh-client-ui-conversation 0.0.1-rc.1

package/lib/types/client/input/hub.d.ts

@@ -0,0 +1,88 @@
+/**
+ * InputHub: the InputService implementation (`ctx.conversation.input`) — one
+ * SessionInputShell per session, created inside the sessions provide
+ * materialization (the 'input' standard-kit entry IS the
+ * creation trigger) and torn down by the scope disposer (instance-and-scope
+ * share one lifecycle). The hub registers the three scoped input-mutation
+ * listeners on each session's actx (the sole consumer side of the ui-slash
+ * bail events) and owns the default-sink choreography: every session is a
+ * real host entity, so the sink is one unconditional prompt path.
+ */
+import type { ClientContext, SessionBinding, SessionId } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SlashController } from '@deepseek-ai/dsh-client-ui-slash/client';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-locale/client';
+import type { ComposerKeyboard, InputService, SessionInput } from './contract.ts';
+import { SessionInputShell } from './facade.ts';
+/** Session-addressed input facade registry (InputService face + composer-layer extras). */
+export declare class InputHub implements InputService {
+    private readonly rootCtx;
+    private readonly t;
+    private readonly shells;
+    /**
+     * @param ctx - client root context (services resolved lazily per call — boot order stays free).
+     * @param t - conversation-namespace translate thunk (reads the active locale at call time).
+     */
+    constructor(rootCtx: ClientContext, t: TranslateNS<'conversation'>);
+    /**
+     * Resolve the facade for one session-scope ctx (InputService face).
+     * @param actx - session-scope context.
+     * @returns the resident per-session facade.
+     */
+    for(actx: ClientContext): SessionInput;
+    /**
+     * Resident shell for one session binding — the provide-channel entry
+     * (called during scope materialization, BEFORE the scope record is
+     * queryable, hence binding-fed and hence the thunked slash/popup deps).
+     * Wires the scoped event listeners + teardown into the session scope.
+     * @param binding - session assembly handle.
+     * @returns the shell.
+     */
+    shellFor(binding: SessionBinding): SessionInputShell;
+    /**
+     * Resident shell by session id (service-face path; the provide channel has
+     * normally created it already — this covers direct id-addressed access).
+     * @param id - session id.
+     * @returns the shell.
+     */
+    shell(id: SessionId): SessionInputShell;
+    /**
+     * The InputBar-exclusive keyboard command face: the shell
+     * satisfies it structurally; package-internal — handed through the
+     * composer-bar entry's inject, never across a plugin boundary.
+     * @param id - session id.
+     * @returns the shell as the keyboard face.
+     */
+    keyboard(id: SessionId): ComposerKeyboard;
+    /**
+     * Resolve the optional slash controller for composer chrome that launches
+     * the shared candidate menu without typing a trigger.
+     * @param id - session id.
+     * @returns the resident controller, or undefined when ui-slash is absent.
+     */
+    slash(id: SessionId): SlashController | undefined;
+    /**
+     * Default sink: optimistic clear + prompt. The session is always a real
+     * host entity (materialized when its workspace was picked), so there is
+     * exactly one path; a failed first prompt is an ordinary prompt failure
+     * (error strip via promptError, draft restored only while untouched).
+     */
+    private sink;
+    /**
+     * Steer every still-pending queued message into the running turn, in FIFO
+     * order — the same strict-steer operation as the queue dock's per-row
+     * button. A turn closing mid-way (`steer-unavailable`) or a row already
+     * claimed by the agent (`queue-item-not-found`) converges silently, while a
+     * genuine failure surfaces as one composer notice. Repeated triggers
+     * (e.g. two rapid empty-draft chords) rely on that `queue-item-not-found`
+     * convergence: the snapshot may still list a row the host already steered,
+     * and the duplicate strict steer is a silent no-op.
+     * @param session - the addressed host session.
+     * @param shell - the resident shell (notice outlet).
+     */
+    private steerQueue;
+    private controller;
+    private popup;
+    private sessions;
+    private conversation;
+}
+//# sourceMappingURL=hub.d.ts.map

package/lib/types/client/input/machine.d.ts

@@ -0,0 +1,114 @@
+import type { InputEffect, InputEvent, InputMachineOptions, InputState } from './contract.ts';
+/** The object-replacement character backing every chip occurrence in the draft. */
+export declare const PLACEHOLDER = "\uFFFC";
+/**
+ * Expand the draft's placeholders into their occurrences' clipboard text
+ * (the persistence mirror and clipboard both write this
+ * projection — U+FFFC never leaves the machine). Table order is offset
+ * order, so one linear walk pairs placeholders with entries.
+ * @param state - published input state.
+ * @returns the plain-text projection of the draft.
+ */
+export declare function projectClipboard(state: Pick<InputState, 'draft' | 'occurrences'>): string;
+/**
+ * Pure input machine, one instance per session (per-session isolation is by
+ * construction). The machine constructs one AbortController per SubmitAttempt
+ * at enter time and aborts it itself on release; the shell never aborts, it
+ * only observes attempt.signal on its adjudicate/submit promises. Stale
+ * attempts (any adjudicated / adjudication-failed / submit-settled whose seq
+ * is not the in-flight one) are dropped: same state, zero effects.
+ */
+export declare class InputMachine {
+    private draft;
+    private draftRev;
+    private phase;
+    private claim;
+    private occurrences;
+    private occurrenceSeq;
+    private seq;
+    private inflight;
+    private log;
+    private redoStack;
+    /** Open single-char typing run: the next contiguous char within the window coalesces. */
+    private typingRun;
+    private paste;
+    private pasteSeq;
+    private readonly mergeWindowMs;
+    private readonly now;
+    constructor(options?: InputMachineOptions);
+    /** Read-only snapshot of the machine state (queue always empty at this tier). */
+    get state(): InputState;
+    /**
+     * Feed one event through the machine.
+     * @param ev - Input event; the single write path for all input state.
+     * @returns Effects for the shell to execute in order; empty on no-ops, locks, and dropped stale events.
+     */
+    dispatch(ev: InputEvent): readonly InputEffect[];
+    /** Adopt a new draft: bump the revision (the span-CAS invalidation point). */
+    private adopt;
+    /** Push one undo unit (before-state), trim the ring, and cut the redo chain. */
+    private pushTxn;
+    /**
+     * Reconcile the occurrence table with one edit (old-draft coordinates):
+     * entries past the range shift by the length delta; entries whose
+     * placeholder sits inside the replaced range go away whole (a
+     * deletion/replacement intersecting a placeholder acts on the whole chip).
+     */
+    private reconcile;
+    /** Claimed integrity watch: any mutation that breaks the token prefix releases the claim. */
+    private watchClaim;
+    /** Mint one occurrence at a draft offset. */
+    private mint;
+    /** Splice minted entries into the offset-sorted table. */
+    private withMinted;
+    private onDraftChanged;
+    /** Span CAS: revision equality (content identity follows) plus bounds sanity. */
+    private casOk;
+    private onBeginCommand;
+    private onInsertRef;
+    /**
+     * Shared chip-insertion transaction: replace [span) with one placeholder
+     * occurrence (insert-ref and paste-upgrade both land here). A separating
+     * space follows the chip unless one is already next.
+     * @returns the inserted length (placeholder plus optional gap).
+     */
+    private replaceSpanWithChip;
+    /**
+     * Guarded token deletion after business success (popup settle / menu-pick
+     * execute). No effect signals success: the caller reads the draftRev
+     * advance off the published state (same currency as the other bail verbs).
+     */
+    private onConsumeToken;
+    /**
+     * Owner-resolution style bits: exactly the listed occurrences render
+     * invalid. Not a transaction — the draft, revision, and undo log are
+     * untouched (invalidation never deletes or rewrites chips).
+     */
+    private onSetInvalid;
+    private onUndo;
+    private onRedo;
+    /**
+     * Paste as one transaction: the text (U+FFFC-sanitized) replaces the
+     * selection; hot-snapshot sync matches componentize inside the SAME
+     * transaction (one undo returns to pre-paste); a match attempt opens for
+     * the async remainder while the phase still accepts reference mutations.
+     */
+    private onPasteBegin;
+    /**
+     * Async match landed: upgrade one pasted token to a chip as an INDEPENDENT
+     * transaction (undo #1 → the token text, undo #2 → pre-paste). The attempt
+     * stays current — later tokens re-CAS against the advanced draftRev.
+     */
+    private onPasteUpgrade;
+    /** Mint the next SubmitAttempt and take the in-flight slot. */
+    private beginAttempt;
+    private onEnter;
+    private onAdjudicated;
+    private onAdjudicationFailed;
+    private onSubmitSettled;
+    /** Ordinary send accepted: clear as a commit (no undo unit; sent content
+     *  must not be resurrectable — same discipline as submit-settled success). */
+    private onSendCommitted;
+    private onRelease;
+}
+//# sourceMappingURL=machine.d.ts.map

package/lib/types/client/input/submission-policy.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Composer submission policy. It owns the live busy-Enter
+ * preference and resolves keyboard gestures into queue/steer delivery modes;
+ * Host and Agent keep the actual delivery-window authority.
+ */
+import { type SettingsScope, type SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client';
+import type { BusyEnterBehavior, ComposerSubmitGesture, InputSubmitMode } from '../contract/composer-submission.ts';
+import type { ConversationSettings } from '../../submission-settings.ts';
+export { DEFAULT_BUSY_ENTER_BEHAVIOR } from '../../submission-settings.ts';
+/**
+ * Busy-Enter policy used by both the composer inject face and its Settings row.
+ * Direct `steer` is intentionally best-effort: AgentLoop turns a closed-window
+ * submission into the next waking Queue item.
+ */
+export declare class ComposerSubmissionPolicy {
+    /** Reactive preference source for the Settings row. */
+    readonly busyEnter: SnapshotStore<BusyEnterBehavior>;
+    private readonly host;
+    /**
+     * @param host - durable preference scope owned by the providing plugin;
+     * absent compositions stay process-local. The adoption subscription shares
+     * the scope's plugin lifetime — a disposed scope never publishes again, so
+     * the policy needs no release hook.
+     */
+    constructor(host?: SettingsScope<ConversationSettings>);
+    /**
+     * Resolve one keyboard gesture without changing state.
+     * @param running - whether the addressed agent currently reports busy.
+     * @param gesture - plain Enter or the Cmd/Ctrl-accelerated chord.
+     * @param steeringAvailable - whether this session transport supports steering.
+     * @returns Queue outside steer-capable busy state; otherwise the preferred mode or its opposite.
+     */
+    resolve(running: boolean, gesture: ComposerSubmitGesture, steeringAvailable: boolean): InputSubmitMode;
+    /**
+     * Change the plain-Enter behavior used during busy state; the live value
+     * publishes before the durable write starts.
+     * @param behavior - Queue or Steer.
+     */
+    setBusyEnter(behavior: BusyEnterBehavior): void;
+    /**
+     * Adopt the scope's accepted durable behavior without writing it back.
+     * @param host - the constructor-narrowed scope driving this adoption.
+     */
+    private adopt;
+}
+//# sourceMappingURL=submission-policy.d.ts.map

package/lib/types/client/locales.d.ts

@@ -0,0 +1,312 @@
+/** `conversation` namespace dictionaries. */
+/** Dictionary namespace owned by this plugin. */
+export declare const NS = "conversation";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'view.chat': string;
+    'hint.plan': string;
+    'hint.goal': string;
+    'hint.goal.active': string;
+    'placeholder.plan': string;
+    'placeholder.default': string;
+    'placeholder.unavailable': string;
+    'placeholder.parentOffline': string;
+    'placeholder.hero': string;
+    'placeholder.workspace': string;
+    'input.commands': string;
+    'input.stop': string;
+    'input.send': string;
+    'placeholder.steerQueue': string;
+    'input.accessMode': string;
+    'image.dropHint': string;
+    'image.pending': string;
+    'image.openOriginal': string;
+    'image.openOriginalLabel': string;
+    'image.remove': string;
+    'image.original': string;
+    'image.label': string;
+    'image.loadFailed': string;
+    'image.loading': string;
+    'image.preview': string;
+    'image.closePreview': string;
+    'image.serviceUnavailable': string;
+    'image.unsupportedType': string;
+    'image.unknownType': string;
+    'context.aria': string;
+    'context.used': string;
+    'context.system': string;
+    'context.tools': string;
+    'context.messages': string;
+    'stats.counts': string;
+    'stats.llm': string;
+    'stats.toolCall': string;
+    'stats.ttftAverage': string;
+    'stats.tokensPerSecond': string;
+    'stats.cacheHit': string;
+    'stats.tokens': string;
+    'settings.enter.title': string;
+    'settings.enter.description': string;
+    'settings.enter.queue': string;
+    'settings.enter.steer': string;
+    'access.confirm.title': string;
+    'access.confirm.description': string;
+    'access.confirm.acknowledge': string;
+    'access.confirm.cancel': string;
+    'access.confirm.enable': string;
+    'hero.headline': string;
+    'hero.preview': string;
+    'hero.chooseWorkspace': string;
+    'session.hierarchy': string;
+    'details.title': string;
+    'details.close': string;
+    'details.empty': string;
+    'details.notInWindow': string;
+    'details.input': string;
+    'details.output': string;
+    'details.running': string;
+    'todo.title': string;
+    'todo.progress.done': string;
+    'todo.progress.active': string;
+    'todo.progress.pending': string;
+    'todo.rowTitle': string;
+    'todo.completed': string;
+    'chat.loadingHistory': string;
+    'chat.loadError': string;
+    'chat.loadOlder': string;
+    'chat.toBottom': string;
+    'message.extraBlock': string;
+    'message.contextInjection': string;
+    'message.contextRecall': string;
+    'message.context.instructions.loaded': string;
+    'message.context.instructions.added': string;
+    'message.context.instructions.updated': string;
+    'message.context.instructions.removed': string;
+    'message.context.catalog.replaced': string;
+    'message.context.catalog.more': string;
+    'message.context.snapshot.supersedes': string;
+    'message.context.relay.from': string;
+    'message.context.recall.counts': string;
+    'message.context.recall.truncated': string;
+    'message.compaction': string;
+    'message.compaction.running': string;
+    'message.compaction.completed': string;
+    'message.compaction.expand': string;
+    'message.compaction.unavailable': string;
+    'message.unknownSurface': string;
+    'message.unknownBlock': string;
+    'message.stopped': string;
+    'message.branch': string;
+    'message.branchUnavailable': string;
+    'message.retry.active': string;
+    'message.retry.cancelled': string;
+    'message.retry.started': string;
+    'message.retry.scheduled': string;
+    'message.retry.status': string;
+    'message.retry.delay': string;
+    'message.retry.failure': string;
+    'message.turnError': string;
+    'message.ranFor': string;
+    'message.ttft': string;
+    'message.tokensPerSecond': string;
+    'duration.seconds': string;
+    'duration.minutes': string;
+    'command.running': string;
+    'command.failed': string;
+    'command.done': string;
+    'command.title': string;
+    'approval.waiting': string;
+    'approval.detail.aria': string;
+    'approval.escalation': string;
+    'approval.reject': string;
+    'approval.allowOnce': string;
+    'ask.rowTitle': string;
+    'ask.waiting': string;
+    'ask.cancelled': string;
+    'ask.interrupted': string;
+    'ask.answered': string;
+    'bash.running': string;
+    'bash.failed': string;
+    'bash.stopped': string;
+    'row.running': string;
+    'row.failed': string;
+    'row.stopped': string;
+    'queue.count': string;
+    'queue.edit': string;
+    'queue.edit.unsupported': string;
+    'queue.save': string;
+    'queue.cancelEdit': string;
+    'queue.remove': string;
+    'queue.steer': string;
+    'queue.steer.unavailable': string;
+    'queue.editFailed': string;
+    'queue.removeFailed': string;
+    'queue.steerFailed': string;
+    'terminal.signal': string;
+    'terminal.exitCode': string;
+    'terminal.running': string;
+    'terminal.failed': string;
+    'terminal.done': string;
+    'terminal.noOutput': string;
+    'terminal.collapseAria': string;
+    'terminal.expandAria': string;
+    'terminal.expandRest': string;
+    'json.truncated': string;
+    'clock.md': string;
+    'clock.ymd': string;
+};
+/** The conversation namespace key union. */
+export type ConversationKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'view.chat': string;
+    'hint.plan': string;
+    'hint.goal': string;
+    'hint.goal.active': string;
+    'placeholder.plan': string;
+    'placeholder.default': string;
+    'placeholder.unavailable': string;
+    'placeholder.parentOffline': string;
+    'placeholder.hero': string;
+    'placeholder.workspace': string;
+    'input.commands': string;
+    'input.stop': string;
+    'input.send': string;
+    'placeholder.steerQueue': string;
+    'input.accessMode': string;
+    'image.dropHint': string;
+    'image.pending': string;
+    'image.openOriginal': string;
+    'image.openOriginalLabel': string;
+    'image.remove': string;
+    'image.original': string;
+    'image.label': string;
+    'image.loadFailed': string;
+    'image.loading': string;
+    'image.preview': string;
+    'image.closePreview': string;
+    'image.serviceUnavailable': string;
+    'image.unsupportedType': string;
+    'image.unknownType': string;
+    'context.aria': string;
+    'context.used': string;
+    'context.system': string;
+    'context.tools': string;
+    'context.messages': string;
+    'stats.counts': string;
+    'stats.llm': string;
+    'stats.toolCall': string;
+    'stats.ttftAverage': string;
+    'stats.tokensPerSecond': string;
+    'stats.cacheHit': string;
+    'stats.tokens': string;
+    'settings.enter.title': string;
+    'settings.enter.description': string;
+    'settings.enter.queue': string;
+    'settings.enter.steer': string;
+    'access.confirm.title': string;
+    'access.confirm.description': string;
+    'access.confirm.acknowledge': string;
+    'access.confirm.cancel': string;
+    'access.confirm.enable': string;
+    'hero.headline': string;
+    'hero.preview': string;
+    'hero.chooseWorkspace': string;
+    'session.hierarchy': string;
+    'details.title': string;
+    'details.close': string;
+    'details.empty': string;
+    'details.notInWindow': string;
+    'details.input': string;
+    'details.output': string;
+    'details.running': string;
+    'todo.title': string;
+    'todo.progress.done': string;
+    'todo.progress.active': string;
+    'todo.progress.pending': string;
+    'todo.rowTitle': string;
+    'todo.completed': string;
+    'chat.loadingHistory': string;
+    'chat.loadError': string;
+    'chat.loadOlder': string;
+    'chat.toBottom': string;
+    'message.extraBlock': string;
+    'message.contextInjection': string;
+    'message.contextRecall': string;
+    'message.context.instructions.loaded': string;
+    'message.context.instructions.added': string;
+    'message.context.instructions.updated': string;
+    'message.context.instructions.removed': string;
+    'message.context.catalog.replaced': string;
+    'message.context.catalog.more': string;
+    'message.context.snapshot.supersedes': string;
+    'message.context.relay.from': string;
+    'message.context.recall.counts': string;
+    'message.context.recall.truncated': string;
+    'message.compaction': string;
+    'message.compaction.running': string;
+    'message.compaction.completed': string;
+    'message.compaction.expand': string;
+    'message.compaction.unavailable': string;
+    'message.unknownSurface': string;
+    'message.unknownBlock': string;
+    'message.stopped': string;
+    'message.branch': string;
+    'message.branchUnavailable': string;
+    'message.retry.active': string;
+    'message.retry.cancelled': string;
+    'message.retry.started': string;
+    'message.retry.scheduled': string;
+    'message.retry.status': string;
+    'message.retry.delay': string;
+    'message.retry.failure': string;
+    'message.turnError': string;
+    'message.ranFor': string;
+    'message.ttft': string;
+    'message.tokensPerSecond': string;
+    'duration.seconds': string;
+    'duration.minutes': string;
+    'command.running': string;
+    'command.failed': string;
+    'command.done': string;
+    'command.title': string;
+    'approval.waiting': string;
+    'approval.detail.aria': string;
+    'approval.escalation': string;
+    'approval.reject': string;
+    'approval.allowOnce': string;
+    'ask.rowTitle': string;
+    'ask.waiting': string;
+    'ask.cancelled': string;
+    'ask.interrupted': string;
+    'ask.answered': string;
+    'bash.running': string;
+    'bash.failed': string;
+    'bash.stopped': string;
+    'row.running': string;
+    'row.failed': string;
+    'row.stopped': string;
+    'queue.count': string;
+    'queue.edit': string;
+    'queue.edit.unsupported': string;
+    'queue.save': string;
+    'queue.cancelEdit': string;
+    'queue.remove': string;
+    'queue.steer': string;
+    'queue.steer.unavailable': string;
+    'queue.editFailed': string;
+    'queue.removeFailed': string;
+    'queue.steerFailed': string;
+    'terminal.signal': string;
+    'terminal.exitCode': string;
+    'terminal.running': string;
+    'terminal.failed': string;
+    'terminal.done': string;
+    'terminal.noOutput': string;
+    'terminal.collapseAria': string;
+    'terminal.expandAria': string;
+    'terminal.expandRest': string;
+    'json.truncated': string;
+    'clock.md': string;
+    'clock.ymd': string;
+};
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/queue/QueueDock.d.ts

@@ -0,0 +1,29 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { QueueAction, QueueItemId } from '../contract/queue.ts';
+/** Queue operations injected by the session-scoped registration. */
+export interface QueueDockInjected {
+    updateQueue: (itemId: QueueItemId, action: QueueAction) => Promise<void>;
+    notify: (level: 'info' | 'error', text: string) => void;
+}
+/** Full props of a dock entry: InputZone owner share + session standard kit + global seat + the locale seat. */
+export type QueueDockProps = PropsRuntime<'conversation.input.dock'> & QueueDockInjected & PropsLocale<'conversation'>;
+/**
+ * Queue strip: one item renders directly; multiple items default to a
+ * collapsible count header; an empty queue renders nothing.
+ */
+export declare function QueueDock({ useSession, updateQueue, notify, t }: QueueDockProps): import("react").JSX.Element | null;
+/**
+ * The dock entry as a plain registrant plugin. The conversation service is
+ * the action contract; the slot declaration has an independent lifecycle boundary.
+ */
+export declare const queueDockEntry: {
+    name: string;
+    inject: string[];
+    /**
+     * Register the queue strip as the terminal input-dock entry (order 20).
+     * @param ctx - registrant context (disposal rides ctx.effect inside slots.register).
+     */
+    apply(ctx: Context): void;
+};
+//# sourceMappingURL=QueueDock.d.ts.map

package/lib/types/client/queue/store.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Queue read face for the InputState.queue projection (frozen contract in
+ * ../input/contract.ts): a uSES-compatible observable over one session's
+ * transient inbox rows. The Session snapshot already keeps the queue array
+ * reference-stable across unrelated snapshot swaps, so this is a pure
+ * projection — no second store, no copy.
+ */
+import type { ObservableSnapshot, SessionFace } from '@deepseek-ai/dsh-client-runtime/client';
+import type { QueuedMessage } from '../input/contract.ts';
+/**
+ * Project a session's transient inbox rows as a bare observable (subscribe/getSnapshot).
+ * The wiring layer overlays this onto InputState.queue; the runtime
+ * QueuedMessage and the input-contract QueuedMessage are structurally
+ * identical.
+ * @param session - the resident session face.
+ * @returns the queue read face (snapshot reference stable while the queue is unchanged).
+ */
+export declare function queueReadFaceOf(session: SessionFace): ObservableSnapshot<readonly QueuedMessage[]>;
+//# sourceMappingURL=store.d.ts.map