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

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

@@ -0,0 +1,26 @@
+/** Strict per-session header/body content inserted into the resident conversation layout. */
+import type { ConversationSessionHeaderSlotProps, ConversationSessionSlotProps } from '../contract/slots.ts';
+/** Full props composed from the strict session body contract. */
+export type ConversationSessionProps = ConversationSessionSlotProps;
+/** Full props composed from the strict session header contract. */
+export type ConversationSessionHeaderProps = ConversationSessionHeaderSlotProps;
+/**
+ * Renders Session header chrome above the resident conversation scrollport.
+ * When the desktop bridge's unified toolbar is mounted, the title cluster
+ * (breadcrumbs + actions) and the utilities row portal into the toolbar's
+ * `centerHost` and the rightbar corner into its `sessionEndHost`: the header
+ * itself collapses to `display: contents`, keeping only the View-tabs row in
+ * the body — zero height when there are no tabs. Host absence (plain web, or
+ * the bridge unmounted mid-session) renders the original in-place header.
+ * @param props - Strict Session store, view ledger, navigation, render, and locale shares.
+ * @returns the hidden blank-session header or visible title and tabs.
+ */
+export declare function ConversationSessionHeader({ sessionId, useSession, useSessions, useConversation, useConversationViews, useStore, renderSlot, open, selectView, t, }: ConversationSessionHeaderProps): import("react").JSX.Element;
+/**
+ * Renders the active Session view inside the resident scrollport and keeps
+ * the input draft mirrored while blank Hero chrome is visible.
+ * @param props - Strict Session input/store, view ledger, and render shares.
+ * @returns the active view area, or null while the Session remains blank.
+ */
+export declare function ConversationSession({ useSession, useConversation, useConversationViews, useInput, inputActions, useStore, actions, renderSlot, bindDraftMirror, openView, }: ConversationSessionProps): import("react").JSX.Element | null;
+//# sourceMappingURL=ConversationSession.d.ts.map

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

@@ -0,0 +1,46 @@
+import type { ReactNode, RefObject } from 'react';
+import type { ConversationSlotProps } from '../contract/slots.ts';
+/** The owner's locale seat type, passed to hero chrome as a plain prop. */
+type HeroTranslate = ConversationSlotProps['t'];
+/**
+ * Basename label for the workspace chip (the shared derivation);
+ * separator-only paths echo the raw cwd.
+ * @param cwd - workspace directory path (non-empty).
+ * @returns chip label.
+ */
+export declare function workspaceLabel(cwd: string): string;
+/**
+ * The workspace chip (folder + label + chevron), always interactive: before
+ * the first message the workspace stays switchable — picking another one
+ * moves the New Session flow to that workspace's blank session. Without a
+ * label the chip renders its placeholder state: closed folder + the
+ * "Choose workspace" call to action.
+ * @param props.label - chip label (see {@link workspaceLabel}); omitted → placeholder.
+ * @param props.menuOpen - menu expansion echo.
+ * @param props.onClick - menu toggle.
+ * @returns the chip button element.
+ */
+export declare function WorkspaceChip({ buttonRef, label, menuOpen, onClick, t }: {
+    buttonRef?: RefObject<HTMLButtonElement>;
+    label?: string | undefined;
+    menuOpen?: boolean;
+    onClick?: () => void;
+    t: HeroTranslate;
+}): import("react").JSX.Element;
+/** Hero chrome props. The workspace row rides the InputBar accessory hole, not here. */
+export interface HeroShellProps {
+    /** The owner's locale seat, passed down as a plain prop. */
+    t: HeroTranslate;
+    /** Authorized renderer for the hero brand-mark slot. */
+    renderSlot: ConversationSlotProps['renderSlot'];
+    /** Overlay content after the stack (modals). */
+    children?: ReactNode;
+}
+/**
+ * Render the hero chrome (headline only; no composer, no workspace row).
+ * @param props - see {@link HeroShellProps}.
+ * @returns the centered hero element tree.
+ */
+export declare function HeroShell({ t, renderSlot, children }: HeroShellProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=EmptyHero.d.ts.map

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

@@ -0,0 +1,18 @@
+/** The default composer body: the 'conversation.composer.bar' slot entry.
+ * Machine state arrives through the standard provide channel
+ * (useInput + inputActions); the keyboard/DOM command face and stop arrive
+ * through this entry's own inject, whose hooks compartment binds
+ * useNotices/useLexicon; layout-phase inputs (variant and placeholder) ride
+ * the owner props. Session facts
+ * (running/removed/promptError) are self-selected via useSession.
+ *
+ * The text surface is the shell-owned Lexical editor bound here through
+ * ComposerContentEditable; chips render as decorator portals, and the
+ * keymap registers submit/menu/paste gestures on the editor command layer.
+ * The no-session state renders the SAME div inert as the Workspace-picker
+ * trigger instead of a parallel tree.
+ */
+import type { ComposerBarProps } from '../contract/slots.ts';
+export type InputBarProps = ComposerBarProps;
+export declare const InputBar: import("react").MemoExoticComponent<({ useSession, useInput, inputActions, keyboard, addFiles, removeAttachment, resolveDraftAttachments, retryFileUpload, toggleCommandMenu, stop, command, t, renderSlot, useBusyEnter, useFileUploads, useNotices, useLexicon, useMenuLauncher, useProjection, sessionId, variant, disabled: inert, blocked, workspacePickerOpen, onRequestWorkspace, placeholder, accessory, }: InputBarProps) => import("react").JSX.Element>;
+//# sourceMappingURL=InputBar.d.ts.map

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

@@ -0,0 +1,11 @@
+import type { PermissionSelect as PermissionSelectValue } from '@deepseek-ai/dsh-permission-presets/client';
+import type { ComposerBarProps } from '../contract/slots.ts';
+export interface PermissionSelectProps {
+    value: PermissionSelectValue | undefined;
+    locked: boolean;
+    command: (line: string) => Promise<boolean>;
+    /** The owning bar's locale seat, passed down as a plain prop. */
+    t: ComposerBarProps['t'];
+}
+export declare function PermissionSelect({ value, locked, command, t }: PermissionSelectProps): import("react").JSX.Element | null;
+//# sourceMappingURL=PermissionSelect.d.ts.map

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

@@ -0,0 +1,21 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { TodoItem } from '@deepseek-ai/dsh-tool-todo/client';
+export interface TodoPanelProps {
+    /** The session's current plan (empty renders nothing) — selected by the dock adapter. */
+    todos: readonly TodoItem[];
+    /** The dock entry's locale seat, passed down as a plain prop. */
+    t: TodoDockProps['t'];
+}
+export declare function TodoPanel({ todos, t }: TodoPanelProps): import("react").JSX.Element | null;
+/** Props for the projected todo dock. */
+export type TodoDockProps = PropsRuntime<'conversation.input.dock'> & PropsLocale<'conversation'>;
+/** Renders the current todo projection, or nothing when it is absent. */
+export declare function TodoDock({ useProjection, t }: TodoDockProps): import("react").JSX.Element;
+/** Registers the projected todo dock. */
+export declare const todoDockEntry: {
+    name: string;
+    inject: string[];
+    apply(ctx: Context): void;
+};
+//# sourceMappingURL=TodoPanel.d.ts.map

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

@@ -0,0 +1,18 @@
+/** Safari-specific textarea layout recovery for the conversation composer. */
+/** Browser identity fields needed to distinguish Safari from other WebKit-based browsers. */
+export interface BrowserIdentity {
+    readonly userAgent: string;
+    readonly vendor: string;
+}
+/**
+ * Detect Safari's `Version/... Safari/...` form while excluding known alternate iOS browser tokens.
+ * @param identity - Browser user-agent and vendor values.
+ * @returns Whether the identity should use the Safari-specific recovery.
+ */
+export declare function isSafariBrowser(identity: BrowserIdentity): boolean;
+/**
+ * Repair Safari's stale native textarea layout and the scrollport auto height it can contaminate.
+ * @param input - Composer textarea whose own scrollable overflow must stay zero.
+ */
+export declare function repairSafariTextareaLayout(input: HTMLTextAreaElement | null): void;
+//# sourceMappingURL=safari.d.ts.map

package/lib/types/client/skeleton/toolbar-hosts.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Browser-local mirror of the desktop toolbar's portal hosts. The
+ * conversation apply world subscribes to `ctx.layout`'s toolbar-host
+ * registry (ui-layout) and republishes here, because React components in
+ * this package reach browser-local state through module stores, not through
+ * the cordis face. Elements only — nothing here is serialized or persisted;
+ * a reload (or a toolbar unmount) falls back to null and the session header
+ * renders in place.
+ */
+import type { ToolbarHosts } from '@deepseek-ai/dsh-client-ui-layout/client';
+/** Republish one registry snapshot (mount, remount, or null on unmount). */
+export declare function setToolbarHosts(hosts: ToolbarHosts | null): void;
+/** useSyncExternalStore snapshot getter. */
+export declare function getToolbarHosts(): ToolbarHosts | null;
+/** useSyncExternalStore subscription; returns the unsubscriber. */
+export declare function subscribeToolbarHosts(listener: () => void): () => void;
+//# sourceMappingURL=toolbar-hosts.d.ts.map

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

@@ -0,0 +1,24 @@
+/** Per-session Conversation store shared by the shell body and header. */
+import { type EngineStoreHandle } from '@deepseek-ai/dsh-client-store';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { ConversationStoreState } from './contract/views.ts';
+/** Declared write set for the Conversation shell. */
+type ConversationActions = {
+    setDraft: (draft: ConversationStoreState, text: string) => void;
+    setView: (draft: ConversationStoreState, view: string) => void;
+    openView: (draft: ConversationStoreState, view: string, focus: string) => void;
+    completeViewRequest: (draft: ConversationStoreState) => void;
+};
+/**
+ * Declare per-session draft persistence and View selection.
+ * @returns the store handle.
+ */
+export declare function createConversationStore(): EngineStoreHandle<ConversationStoreState, ConversationActions>;
+/**
+ * Read the persisted View preference before the Slot store is materialized.
+ * @param sessionId - Session-scoped persistence suffix.
+ * @returns the preferred View id, or null when storage has no usable value.
+ */
+export declare function readConversationViewPreference(sessionId: SessionId): string | null;
+export {};
+//# sourceMappingURL=stores.d.ts.map

package/lib/types/client/view-selection.d.ts

@@ -0,0 +1,9 @@
+import type { ViewTab } from './contract/views.ts';
+/**
+ * Resolve a preferred registered View, then Chat, without choosing another View.
+ * @param tabs - currently registered Views.
+ * @param selectedId - preferred View identity, when one is stored.
+ * @returns the selected View, Chat fallback, or undefined when neither is registered.
+ */
+export declare function resolveActiveView(tabs: readonly ViewTab[], selectedId: string | null): ViewTab | undefined;
+//# sourceMappingURL=view-selection.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,9 @@
+/** Host registration for browser conversation preferences. */
+import type { Context } from '@deepseek-ai/cordis';
+export { BUSY_ENTER_BEHAVIORS, BUSY_ENTER_FIELD, CONVERSATION_SETTINGS_NAMESPACE, DEFAULT_BUSY_ENTER_BEHAVIOR, type BusyEnterBehavior, type ConversationSettings, } from './submission-settings.ts';
+/**
+ * Register the durable conversation section when a settings provider exists.
+ * @param ctx - Host context whose optional settings service owns the section.
+ */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/submission-settings.d.ts

@@ -0,0 +1,20 @@
+/** Busy-Enter preference stored in the Host user-settings document. */
+import z from '@deepseek-ai/schemastery';
+/** Settings namespace owned by the conversation plugin. */
+export declare const CONVERSATION_SETTINGS_NAMESPACE = "ui-conversation";
+/** Field carrying the delivery mode for plain Enter while an agent is busy. */
+export declare const BUSY_ENTER_FIELD = "busyEnter";
+/** Busy-Enter behaviors accepted at settings and input boundaries. */
+export declare const BUSY_ENTER_BEHAVIORS: readonly ["queue", "steer"];
+/** Configurable meaning of plain Enter while the addressed agent is busy. */
+export type BusyEnterBehavior = typeof BUSY_ENTER_BEHAVIORS[number];
+/** Default preserves Enter-as-Queue for running conversations. */
+export declare const DEFAULT_BUSY_ENTER_BEHAVIOR: BusyEnterBehavior;
+/** Durable conversation section shared by the Host schema and the browser scope. */
+export interface ConversationSettings {
+    /** Delivery mode for plain Enter while the addressed agent is busy. */
+    busyEnter: BusyEnterBehavior;
+}
+/** Durable conversation schema; also the wire envelope the browser scope validates against. */
+export declare const ConversationSettingsSchema: z<ConversationSettings>;
+//# sourceMappingURL=submission-settings.d.ts.map

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "@crazx/dsh-client-ui-conversation",
+  "description": "Target-neutral Conversation assembly, shell, composer, queue, and view navigation",
+  "version": "0.1.5-alpha.1.zw.3",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aka-danielZhang/deepseek-harness.git",
+    "directory": "packages/client/ui-conversation"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-api-session-controller",
+        "@deepseek-ai/dsh-client-file-upload",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-layout",
+        "@deepseek-ai/dsh-client-ui-renderer",
+        "@deepseek-ai/dsh-client-ui-session",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-workspace"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "dependencies": {
+    "clsx": "^2.0.0",
+    "@deepseek-ai/schemastery": "^3.18.2",
+    "@lexical/history": "^0.49.0",
+    "@lexical/plain-text": "^0.49.0",
+    "@lexical/text": "^0.49.0",
+    "@lexical/utils": "^0.49.0",
+    "lexical": "^0.49.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-api-session-controller": "npm:@crazx/dsh-api-session-controller@0.1.5-alpha.1.zw.3",
+    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-attachment": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-brand": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-file-upload": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-test-runtime": "npm:@crazx/dsh-client-test-runtime@0.1.5-alpha.1.zw.3",
+    "@deepseek-ai/dsh-client-ui-layout": "npm:@crazx/dsh-client-ui-layout@0.1.5-alpha.1.zw.3",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-workspace": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-commands": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-goal": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-llm-retry": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-permission-presets": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-plan-mode": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-token-meter": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-tool-todo": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-util-crypto": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-workspace": "^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-util-workspace-path": "^0.1.5-alpha.1",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "@lexical/headless": "^0.49.0",
+    "react-dom": "^18.2.0",
+    "@types/react-dom": "~18.3.0",
+    "zod": "^4.4.3",
+    "@deepseek-ai/dsh-settings": "^0.1.5-alpha.1"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}