@crazx/dsh-client-ui-conversation 0.1.5-alpha.1.zw.3

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

@@ -0,0 +1,20 @@
+/**
+ * Queue read face for the InputState.queue projection (frozen contract in
+ * ../contract/input.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 { SessionFace } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-store';
+import type { QueuedMessage } from '../contract/input.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=queue-store.d.ts.map

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

@@ -0,0 +1,52 @@
+/**
+ * Composer submission policy. It owns the live busy-Enter preference and
+ * resolves submission gestures into queue/steer delivery modes; Host and
+ * Agent keep the actual delivery-window authority.
+ */
+import { type SnapshotStore } from '@deepseek-ai/dsh-client-store';
+import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/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';
+/**
+ * Resolve one submission gesture against the busy-Enter preference. Plain
+ * Enter and the primary Send button share the `enter` gesture, so the button
+ * delivers exactly what Enter would. Direct `steer` is intentionally
+ * best-effort: AgentLoop turns a closed-window submission into the next waking
+ * Queue item.
+ * @param preferred - the live busy-Enter preference.
+ * @param running - whether the addressed agent currently reports busy.
+ * @param gesture - plain Enter (or the Send button) 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.
+ */
+export declare function resolveSubmitMode(preferred: BusyEnterBehavior, running: boolean, gesture: ComposerSubmitGesture, steeringAvailable: boolean): InputSubmitMode;
+/**
+ * Busy-Enter preference shared by the composer bar inject face and its
+ * Settings row: one live store the bar's submission gestures and Send label
+ * read, backed by the Host user-settings document when one is composed.
+ */
+export declare class ComposerSubmissionPolicy {
+    /** Reactive preference source for the composer bar and 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>);
+    /**
+     * Change the busy-state submission behavior; 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,330 @@
+/** `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: {
+    '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;
+    'placeholder.steerQueue': string;
+    'input.commands': string;
+    'input.stop': string;
+    'input.send': string;
+    'input.send.queue': string;
+    'input.send.steer': string;
+    'input.accessMode': string;
+    'attachment.pending': string;
+    'attachment.scrollLeft': string;
+    'attachment.scrollRight': string;
+    'attachment.dropTitle': string;
+    'attachment.dropDesc': string;
+    'attachment.dropBlocked': 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.unsupportedType': string;
+    'image.tooMany': string;
+    'image.fileTooLarge': string;
+    'image.totalTooLarge': string;
+    'image.tooManyPixels': string;
+    'image.dimensionTooLarge': string;
+    'image.modelUnsupported': string;
+    'image.sendFailed': string;
+    'file.attach': string;
+    'file.pending': string;
+    'file.remove': string;
+    'file.uploading': string;
+    'file.uploadFailed': string;
+    'file.retry': string;
+    'file.stillUploading': string;
+    'file.sessionUnavailable': string;
+    'file.notStaged': string;
+    'file.label': string;
+    'context.aria': string;
+    'context.used': string;
+    'context.system': string;
+    'context.tools': string;
+    'context.messages': string;
+    'settings.enter.title': string;
+    'settings.enter.description': string;
+    'settings.enter.queue': string;
+    'settings.enter.steer': string;
+    'access.preset.readOnly': string;
+    'access.preset.workspaceWrite': string;
+    'access.preset.fullAccess': 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;
+    'todo.title': string;
+    'todo.progress.done': string;
+    'todo.progress.active': string;
+    'todo.progress.pending': string;
+    'todo.rowTitle': string;
+    'todo.completed': string;
+    'command.attachmentsUnsupported': string;
+    'ask.rowTitle': string;
+    'ask.waiting': string;
+    'ask.cancelled': string;
+    'ask.cancelledDetail': string;
+    'ask.interrupted': string;
+    'ask.interruptedDetail': string;
+    'ask.answered': string;
+    'ask.skipped': string;
+    'bash.running': string;
+    'bash.failed': string;
+    'bash.stopped': string;
+    'row.running': string;
+    'row.failed': string;
+    'row.stopped': string;
+    'row.input': string;
+    'row.output': string;
+    'row.inspect': string;
+    'tool.title.search': string;
+    'tool.title.read': string;
+    'tool.title.bash': string;
+    'tool.title.write': string;
+    'tool.title.edit': string;
+    'tool.title.code': string;
+    'tool.title.generic': string;
+    'tool.title.inspect': string;
+    'tool.title.runCordis': string;
+    'tool.title.stopCordis': string;
+    'tool.title.removeCordis': string;
+    'tool.title.pwsh': string;
+    'tool.title.readImage': string;
+    'tool.title.grep': string;
+    'tool.title.glob': string;
+    'tool.title.webSearch': string;
+    'tool.title.webFetch': string;
+    'diff.files.one': string;
+    'diff.files.other': string;
+    'diff.collapseAria': string;
+    'diff.expandAria': string;
+    'diff.expandRest': string;
+    'read.window': string;
+    'read.collapseAria': string;
+    'read.expandAria': string;
+    'read.expandRest': string;
+    'search.paths': string;
+    'search.paths.truncated': string;
+    'search.matches': string;
+    'search.matches.truncated': string;
+    'search.noResults': string;
+    'search.collapseAria': string;
+    'search.expandAria': string;
+    'search.expandRest': string;
+    'web.noResults': string;
+    'web.sourcesTruncated': string;
+    'web.http': string;
+    'web.contentTruncated': string;
+    'details.running': string;
+    'queue.count': string;
+    'queue.sending': string;
+    'queue.image': string;
+    'queue.file': 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;
+    'terminal.sendInput': string;
+    'terminal.session': 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: {
+    '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;
+    'placeholder.steerQueue': string;
+    'input.commands': string;
+    'input.stop': string;
+    'input.send': string;
+    'input.send.queue': string;
+    'input.send.steer': string;
+    'input.accessMode': string;
+    'attachment.pending': string;
+    'attachment.scrollLeft': string;
+    'attachment.scrollRight': string;
+    'attachment.dropTitle': string;
+    'attachment.dropDesc': string;
+    'attachment.dropBlocked': 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.unsupportedType': string;
+    'image.tooMany': string;
+    'image.fileTooLarge': string;
+    'image.totalTooLarge': string;
+    'image.tooManyPixels': string;
+    'image.dimensionTooLarge': string;
+    'image.modelUnsupported': string;
+    'image.sendFailed': string;
+    'file.attach': string;
+    'file.pending': string;
+    'file.remove': string;
+    'file.uploading': string;
+    'file.uploadFailed': string;
+    'file.retry': string;
+    'file.stillUploading': string;
+    'file.sessionUnavailable': string;
+    'file.notStaged': string;
+    'file.label': string;
+    'context.aria': string;
+    'context.used': string;
+    'context.system': string;
+    'context.tools': string;
+    'context.messages': string;
+    'settings.enter.title': string;
+    'settings.enter.description': string;
+    'settings.enter.queue': string;
+    'settings.enter.steer': string;
+    'access.preset.readOnly': string;
+    'access.preset.workspaceWrite': string;
+    'access.preset.fullAccess': 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;
+    'todo.title': string;
+    'todo.progress.done': string;
+    'todo.progress.active': string;
+    'todo.progress.pending': string;
+    'todo.rowTitle': string;
+    'todo.completed': string;
+    'command.attachmentsUnsupported': string;
+    'ask.rowTitle': string;
+    'ask.waiting': string;
+    'ask.cancelled': string;
+    'ask.cancelledDetail': string;
+    'ask.interrupted': string;
+    'ask.interruptedDetail': string;
+    'ask.answered': string;
+    'ask.skipped': string;
+    'bash.running': string;
+    'bash.failed': string;
+    'bash.stopped': string;
+    'row.running': string;
+    'row.failed': string;
+    'row.stopped': string;
+    'row.input': string;
+    'row.output': string;
+    'row.inspect': string;
+    'tool.title.search': string;
+    'tool.title.read': string;
+    'tool.title.bash': string;
+    'tool.title.write': string;
+    'tool.title.edit': string;
+    'tool.title.code': string;
+    'tool.title.generic': string;
+    'tool.title.inspect': string;
+    'tool.title.runCordis': string;
+    'tool.title.stopCordis': string;
+    'tool.title.removeCordis': string;
+    'tool.title.pwsh': string;
+    'tool.title.readImage': string;
+    'tool.title.grep': string;
+    'tool.title.glob': string;
+    'tool.title.webSearch': string;
+    'tool.title.webFetch': string;
+    'diff.files.one': string;
+    'diff.files.other': string;
+    'diff.collapseAria': string;
+    'diff.expandAria': string;
+    'diff.expandRest': string;
+    'read.window': string;
+    'read.collapseAria': string;
+    'read.expandAria': string;
+    'read.expandRest': string;
+    'search.paths': string;
+    'search.paths.truncated': string;
+    'search.matches': string;
+    'search.matches.truncated': string;
+    'search.noResults': string;
+    'search.collapseAria': string;
+    'search.expandAria': string;
+    'search.expandRest': string;
+    'web.noResults': string;
+    'web.sourcesTruncated': string;
+    'web.http': string;
+    'web.contentTruncated': string;
+    'details.running': string;
+    'queue.count': string;
+    'queue.sending': string;
+    'queue.image': string;
+    'queue.file': 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;
+    'terminal.sendInput': string;
+    'terminal.session': string;
+};
+//# sourceMappingURL=locales.d.ts.map

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

@@ -0,0 +1,26 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
+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;
+    /** Resolve one durable queued image into a session-scoped browser URL. */
+    loadImage: (attachment: ImageAttachmentRef) => Promise<string>;
+}
+/** 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. Local submissions
+ * show sending status and disabled actions until their Host queue rows arrive.
+ */
+export declare function QueueDock({ useSession, updateQueue, notify, loadImage, t }: QueueDockProps): import("react").JSX.Element | null;
+/** Registers queue actions backed by the session-scoped conversation service. */
+export declare const queueDockEntry: {
+    name: string;
+    inject: string[];
+    apply(ctx: Context): void;
+};
+//# sourceMappingURL=QueueDock.d.ts.map

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

@@ -0,0 +1,185 @@
+/**
+ * Scope-addressed conversation send, cancel, and history orchestration.
+ *
+ * Scope addressing rides the cordis Service tracker: property access through
+ * `ctx.conversation` rebinds `this.ctx` to the caller's context, so methods
+ * read the session tag with `scopeOf`. Mutable state must remain reachable
+ * through one property read; assignment through the tracker proxy and `#`
+ * private fields bypass that rebinding.
+ */
+import { Service } from '@deepseek-ai/cordis';
+import type { Context } from '@deepseek-ai/cordis';
+import type { SessionFace } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
+import type { ComposerAttachment, DraftFileUpload } from './contract/slots.ts';
+import type { QueueAction, QueueItemId } from './contract/queue.ts';
+import type { ComposerBlocks } from './contract/composer-blocks.ts';
+import type { DraftAttachmentId, DraftAttachmentSerializationResult, SessionInputResolver, SubmitOutcome } from './contract/input.ts';
+import type { InputSubmitMode } from './contract/composer-submission.ts';
+/**
+ * The outward conversation face (`ctx.conversation`): the scope-addressed
+ * verbs and the input registry other plugins may reach — and exactly what a
+ * test fake must supply.
+ */
+export interface IConversation {
+    /** The per-session input machine registry (SessionInputResolver face). */
+    readonly input: SessionInputResolver;
+    /**
+     * The per-session composer-block registry: how a plugin the composer
+     * cannot import makes a session's input inert with its own reason.
+     */
+    readonly blocks: ComposerBlocks;
+    /**
+     * Send a prompt into the caller scope's session (queued turn).
+     * @param text - prompt text, sent verbatim as one text block.
+     * @returns completion; business failures reject (and land in promptError).
+     */
+    send(text: string): Promise<void>;
+    /**
+     * Apply one edit, remove, or Steer operation to a pending queue occurrence.
+     * @param itemId - agent-owned inbox occurrence identity.
+     * @param action - requested queue operation.
+     * @returns completion; converged QueueDock races resolve, while other failures reject.
+     */
+    updateQueue(itemId: QueueItemId, action: QueueAction): Promise<void>;
+    /**
+     * Cancel the scoped session's in-flight turn while preserving its pending Queue.
+     * @returns completion; failures reject as in send.
+     */
+    cancel(): Promise<void>;
+    /**
+     * Pull one older history page for the scoped session.
+     * @returns completion of the page pull.
+     */
+    loadOlder(): Promise<void>;
+}
+/** Unsupported browser-declared image type, localized by the UI boundary. */
+export declare class UnsupportedImageMediaTypeError extends Error {
+    /** Browser-declared MIME value, possibly empty. */
+    readonly mediaType: string;
+    /** @param mediaType - Browser-declared MIME value, possibly empty. */
+    constructor(mediaType: string);
+}
+/** Scope-addressed conversation service (root singleton, provided as `conversation`). */
+export declare class ConversationController extends Service implements IConversation {
+    /** The per-session input machine registry (SessionInputResolver face). */
+    readonly input: SessionInputResolver;
+    /** The per-session composer-block registry. */
+    readonly blocks: ComposerBlocks;
+    /** Live upload state per file-kind draft; images never appear here. */
+    readonly fileUploads: SnapshotStore<Record<string, DraftFileUpload>>;
+    private readonly draftAttachments;
+    private readonly fileUploadOperations;
+    private readonly pendingFileUploads;
+    private readonly fileUploadQueue;
+    private activeFileUploads;
+    private readonly maxConcurrentFileUploads;
+    /**
+     * @param ctx - owning root context (the plugin apply context; the service
+     * registers itself and follows that fiber's lifetime).
+     * @param config - carries the SessionInputResolver and composer-block registry
+     * constructed by the plugin apply (the same instances the slot inject
+     * factories close over).
+     */
+    constructor(ctx: Context, config: {
+        input: SessionInputResolver;
+        blocks: ComposerBlocks;
+        maxConcurrentFileUploads: number;
+    });
+    /**
+     * Send a prompt into the scoped session. Business failures also land in the
+     * session snapshot's promptError (object-layer state); the rejection here
+     * exists for caller choreography (the composer restores the draft on it).
+     * @param text - prompt text, sent verbatim as one text block.
+     */
+    send(text: string): Promise<void>;
+    /**
+     * Submit ordered draft attachments with text through one host admission. A local
+     * submission echo enters the session snapshot synchronously; serialization
+     * and the prompt round-trip start after the browser can paint it. On the
+     * echo's observed retirement seeds admitted image previews into the durable
+     * cache and removes every attachment from the draft registry. On failure,
+     * every attachment remains registered so the composer can restore it.
+     * @param session - target session.
+     * @param text - serialized prompt text.
+     * @param attachmentIds - ordered draft-local attachment ids.
+     * @param mode - queue or steer delivery selected by composer policy.
+     * @param signal - optional cancellation for the complete Host admission.
+     * @returns the Host admission outcome; local attachment preparation failures reject.
+     */
+    sendSession(session: SessionFace, text: string, attachmentIds: readonly DraftAttachmentId[], mode: InputSubmitMode, signal?: AbortSignal): Promise<SubmitOutcome>;
+    /**
+     * Create runtime-only draft attachments. Files whose browser MIME is an
+     * accepted image type become image drafts (object URL preview, bytes sent
+     * with the prompt); every other file becomes a file draft whose background
+     * upload starts immediately and remains owned by this service across Session
+     * navigation until completion or explicit removal.
+     * @param sessionId - target Agent-scope identity.
+     * @param files - browser files to register.
+     * @returns ordered draft descriptors.
+     */
+    createDrafts(sessionId: SessionId, files: readonly File[]): readonly ComposerAttachment[];
+    /**
+     * Restart one failed file upload.
+     * @param sessionId - target Agent-scope identity.
+     * @param id - draft attachment id whose upload previously failed.
+     */
+    retryFileUpload(sessionId: SessionId, id: DraftAttachmentId): void;
+    /**
+     * Stage carried file drafts again for a new Session.
+     * @param sessionId - target Agent-scope identity after a Workspace switch.
+     * @param ids - carried draft attachment ids.
+     */
+    rebindDraftFiles(sessionId: SessionId, ids: readonly DraftAttachmentId[]): void;
+    private beginFileUpload;
+    /** Start queued upload Workers until the configured concurrency is occupied. */
+    private pumpFileUploads;
+    /**
+     * Resolve ordered input-state ids to runtime-owned draft attachments.
+     * @param ids - draft attachment ids.
+     * @returns descriptors that remain live, in requested order.
+     */
+    resolveDraftAttachments(ids: readonly DraftAttachmentId[]): readonly ComposerAttachment[];
+    /**
+     * Serialize ordered draft attachments to command-submit wire payloads without
+     * sending or releasing them. Images are encoded; generic files cite receipts
+     * from their completed background uploads and never reread browser bytes.
+     * @param attachmentIds - ordered draft-local attachment ids.
+     * @returns wire payloads in id order.
+     */
+    serializeDraftAttachments(attachmentIds: readonly DraftAttachmentId[]): Promise<DraftAttachmentSerializationResult>;
+    /**
+     * Release one browser-owned draft attachment, aborting its active upload.
+     * @param id - draft attachment id.
+     */
+    releaseDraftAttachment(id: DraftAttachmentId): void;
+    /**
+     * Release a set of browser-owned draft attachments.
+     * @param attachments - descriptors to release.
+     */
+    releaseDraftAttachments(attachments: readonly ComposerAttachment[]): void;
+    /** Apply one operation to a pending queue occurrence. */
+    updateQueue(itemId: QueueItemId, action: QueueAction): Promise<void>;
+    /** Cancel the scoped session's in-flight turn while preserving Queue (failures land in promptError and reject, as in send). */
+    cancel(): Promise<void>;
+    /** Pull one older history page for the scoped Session. */
+    loadOlder(): Promise<void>;
+    /** Resolve the caller scope's session face or throw on root contexts. */
+    private scopedSession;
+    /** Read the caller's session scope tag via the sessions service; root contexts fail loud. */
+    private scopeId;
+    private requireSessions;
+    /**
+     * Settle one submission's draft attachments when its echo retires. Observed:
+     * each image leaves the registry, handing its preview URL to the durable
+     * image cache (seeded under the admitted reference so the transcript node
+     * renders immediately while the cache reads canonical bytes) or revoking it
+     * when the cache already holds that reference. Failed: nothing changes;
+     * the ids stay registered for the composer's rail restore.
+     */
+    private settleSubmittedAttachments;
+    /** Canonical base64 wire form of one browser image file. */
+    private encodeImage;
+}
+//# sourceMappingURL=service.d.ts.map

package/lib/types/client/settings/EnterBehaviorRow.d.ts

@@ -0,0 +1,21 @@
+import type { SnapshotStore } from '@deepseek-ai/dsh-client-store';
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { BusyEnterBehavior } from '../contract/composer-submission.ts';
+/** Registration-side preference face. */
+export interface EnterBehaviorRowInjected {
+    hooks: {
+        /** Persisted busy-state preference bound as useBusyEnter. */
+        busyEnter: SnapshotStore<BusyEnterBehavior>;
+    };
+    /** Change the busy-state plain-Enter behavior. */
+    setBusyEnter: (behavior: BusyEnterBehavior) => void;
+}
+/** Full Settings-row props. */
+export type EnterBehaviorRowProps = PropsRuntime<'settings.general.item'> & PropsLocale<'conversation'> & InjectFace<EnterBehaviorRowInjected>;
+/**
+ * Render the busy-state Enter behavior selector.
+ * @param props - composed Settings slot props.
+ * @returns the preference row.
+ */
+export declare function EnterBehaviorRow({ useBusyEnter, setBusyEnter, t }: EnterBehaviorRowProps): import("react").JSX.Element;
+//# sourceMappingURL=EnterBehaviorRow.d.ts.map

package/lib/types/client/skeleton/ContextMeter.d.ts

@@ -0,0 +1,14 @@
+/** Composer context-occupancy meter: a ring beside the send button fed by the
+ * `contextPressure` projection, with a click-open panel of the heuristic
+ * `contextBreakdown` composition (system prompt, tools, conversation).
+ * Renders nothing until a provider reports both pressure and a route
+ * capacity. */
+import type { UseProjection } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { ComposerBarProps } from '../contract/slots.ts';
+export interface ContextMeterProps {
+    useProjection: UseProjection;
+    /** The owning bar's locale seat, passed down as a plain prop. */
+    t: ComposerBarProps['t'];
+}
+export declare function ContextMeter({ useProjection, t }: ContextMeterProps): import("react").JSX.Element | null;
+//# sourceMappingURL=ContextMeter.d.ts.map

package/lib/types/client/skeleton/ConversationRoot.d.ts

@@ -0,0 +1,5 @@
+import type { ConversationSlotProps } from '../contract/slots.ts';
+/** Full props composed from the slot contract. */
+export type ConversationRootProps = ConversationSlotProps;
+export declare function ConversationRoot({ sessionId, useSession, useSessions, useSessionPendingInteraction, useWorkspaces, useConversation, useInput, useComposerBlock, renderSlot, renderSlotChain, selectWorkspace, t, }: ConversationRootProps): import("react").JSX.Element;
+//# sourceMappingURL=ConversationRoot.d.ts.map