@deepseek-ai/dsh-client-ui-tool 0.2.0-rc.1 → 0.2.1-alpha.1

package/lib/types/client/contract/slots.d.ts

@@ -1,8 +1,9 @@
 /** Tool UI slot declarations and their composed component props. */
-import type { HostObservable, InjectFace, PropsLocale, PropsRenderSlots, PropsRuntime, SlotHookFactory } from '@deepseek-ai/dsh-client-ui-slots';
+import type { HostObservable, InjectFace, PropsLocale, PropsRenderSlots, PropsRuntime, SessionIdOf } from '@deepseek-ai/dsh-client-ui-slots';
 import type { RemoteHostFacts } from '@deepseek-ai/dsh-api-remotes/client';
-import type { AssistantChatData, OpenFileOptions, PreparingToolCall, StartedToolCall, ToolResultNode, UseDisclosure } from '@deepseek-ai/dsh-client-ui-chat/client';
+import type { OpenFileOptions, PreparingToolCall, StartedToolCall, ToolResultNode, UseDisclosure } from '@deepseek-ai/dsh-client-ui-chat/client';
 import type { MessageImageLoader, MessageImageSource } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { AskUserQuestionAnswerItem, AskUserQuestionItem } from '@deepseek-ai/dsh-user-questions/types';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface SlotMap {
         /**
@@ -11,16 +12,14 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
          * `key: '<tool name>'`; a typo never renders.
          *
          * Registering an occupied key replaces its view; unclaimed keys use the
-         * generic row. The owner supplies the call identity and frozen running
-         * or settled node through explicit phase props. Preparing blocks have no dispatched
-         * arguments; useToolCallArgumentsPartial optionally subscribes to their raw prefix.
+         * generic row. The owner supplies the call identity and running
+         * or settled node through explicit phase props. Every stage supplies
+         * `name` and a lazy `args` view; preparing arguments may be incomplete.
          */
         'tool.call.toolview': {
             kind: 'keyed';
             scope: 'session';
             owner: ToolCallOwnerProps;
-            hookContext: ToolCallHookContext;
-            inject: ToolCallInjected;
         };
         /**
          * Durable images of a settled image-bearing Tool call, rendered through
@@ -42,20 +41,6 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
         };
     }
 }
-/** Subscribe to this preparing call's raw argument prefix; other phases return an empty string. */
-export type UseToolCallArgumentsPartial = () => string;
-/** Call-local sources supplied by the Tool tree to the slot's Hook binding. */
-export interface ToolCallHookContext {
-    readonly callId: string;
-    /** This call's Step source, present only while preparing. */
-    readonly assistant: HostObservable<Readonly<AssistantChatData> | undefined> | undefined;
-}
-/** Framework-bound subscriptions available to atomic Tool views on demand. */
-export interface ToolCallInjected {
-    hooks: {
-        toolCallArgumentsPartial: SlotHookFactory<'tool.call.toolview', UseToolCallArgumentsPartial>;
-    };
-}
 /** Owner currency of the Tool image gallery slot: references plus the loader. */
 export interface ToolImagesOwnerProps {
     /** Durable references or submission-echo previews in result order. */
@@ -103,6 +88,50 @@ export type ToolCallViewProps = PropsRuntime<'tool.call.toolview'>;
 export type StartedToolCallViewProps = Exclude<ToolCallViewProps, {
     readonly phase: 'preparing';
 }>;
+/**
+ * One settled `ask_user_question` call as its transcript row read it. The row
+ * reads the questions from the recorded call JSON, and the answers from
+ * whichever recorded them: its own result when the answer arrived in time, or
+ * the `userQuestions` projection when a late reply settled the call.
+ */
+export interface UserQuestionRecord {
+    /** The call's questions, with the option lists the panel renders. */
+    readonly questions: readonly AskUserQuestionItem[];
+    /** The recorded answer batch; an item with no selection and no custom text was skipped. */
+    readonly answers: readonly AskUserQuestionAnswerItem[];
+}
+/**
+ * Optional answer-panel provider consumed by the ask-question row. A timed
+ * `ask_user_question` call stays answerable after its result is recorded, and
+ * its panel can be closed, so the transcript row is the way back to it. A
+ * composition without a question UI has no panel to show.
+ */
+export interface UserQuestionPanels {
+    /**
+     * Put one call's answer panel back in the composer, ahead of any other
+     * pending question.
+     * @param sessionId - Session the call belongs to.
+     * @param callId - `ask_user_question` call whose panel to show.
+     * @returns whether a panel for that call was there to show.
+     */
+    reveal(sessionId: SessionIdOf, callId: string): boolean;
+    /**
+     * Show one settled call's recorded answers as a read-only panel, ahead of
+     * any other pending question. Closing that panel drops it for good; the row
+     * builds it again from the same record.
+     * @param sessionId - Session the call belongs to.
+     * @param callId - `ask_user_question` call whose record to show.
+     * @param record - the call's questions and recorded answers.
+     * @returns whether the panel was shown.
+     */
+    review(sessionId: SessionIdOf, callId: string, record: UserQuestionRecord): boolean;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        /** Optional user-question answer-panel provider. */
+        userQuestionPanels: UserQuestionPanels;
+    }
+}
 /** Injected Host description for POSIX home-path display. */
 export type ToolHostInfoInjected = {
     hooks: {

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

@@ -1,4 +1,4 @@
 /** Browser Tool plugin: whole-call composition and keyed atomic Tool views. */
 export { apply, inject } from './apply.ts';
-export type { StartedToolCallViewProps, ToolCallCommonProps, ToolCallOwnerProps, ToolCallPhaseProps, ToolCallViewProps, ToolCallHookContext, ToolCallInjected, ToolHostInfoInjected, ToolTreeProps, UseToolCallArgumentsPartial, } from './contract/slots.ts';
+export type { StartedToolCallViewProps, ToolCallCommonProps, ToolCallOwnerProps, ToolCallPhaseProps, ToolCallViewProps, ToolHostInfoInjected, ToolTreeProps, UserQuestionPanels, UserQuestionRecord, } from './contract/slots.ts';
 //# sourceMappingURL=index.d.ts.map

package/lib/types/client/tool/components/QuestionToolRow.d.ts

@@ -0,0 +1,13 @@
+import type { ToolRowProps } from './ToolRow.tsx';
+type QuestionToolRowProps = Pick<ToolRowProps, 'useDisclosure' | 't' | 'summary' | 'bodyRaw' | 'output' | 'askQuestion' | 'state' | 'inspect'> & {
+    readonly openPanel: () => boolean;
+    readonly panelLabel: string;
+};
+/**
+ * Render a question with its answer-panel entry point.
+ * @param props - Question transcript, panel action, and disclosure state.
+ * @returns The question's summary and optional expanded record.
+ */
+export declare function QuestionToolRow({ useDisclosure, t, summary, bodyRaw, output, askQuestion, state, inspect, openPanel, panelLabel, }: QuestionToolRowProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=QuestionToolRow.d.ts.map

package/lib/types/client/tool/components/ToolRow.d.ts

@@ -23,10 +23,9 @@ export interface ToolRowProps {
     summary: string;
     /**
      * Trailing summary fragment rendered outside the ellipsized summary text, so
-     * a narrow row clips the summary before this. For a fragment whose whole
-     * value is surviving that clip — the todo row's parallel-active count.
-     * null/absent = the summary is the whole collapsed content. Dropped on an
-     * error row, whose collapsed summary is the failure line instead.
+     * a narrow row clips the summary before this. Appears before diff totals
+     * when both are present. null/absent omits this fragment. Error and stopped
+     * rows omit both the suffix and diff totals.
      */
     summarySuffix?: string | null | undefined;
     /** Original argument JSON formatted only while the row is expanded. */
@@ -39,6 +38,7 @@ export interface ToolRowProps {
     errorSummary?: string | null | undefined;
     /** Terminal card; card fields are mutually exclusive and replace text sections. */
     terminal?: TerminalCardModel | null | undefined;
+    /** Diff card with inline totals colored on header hover and while expanded. */
     diff?: DiffCardModel | null | undefined;
     read?: ReadCardModel | null | undefined;
     /**

package/lib/types/client/tool/models/raw-tool-call.d.ts

@@ -18,11 +18,4 @@ export declare function parsedToolCall(block: ToolCallBlock): ParsedToolCall | n
  * @returns its text, or undefined for any other content layout.
  */
 export declare function singleResultText(block: ToolResultNode): string | undefined;
-/**
- * Validate the optional escalation pair shared by first-party shell and file
- * mutation tools.
- * @param args - parsed open-root Tool arguments.
- * @returns whether the declared escalation fields form a valid pair.
- */
-export declare function validEscalationFields(args: Record<string, unknown>): boolean;
 //# sourceMappingURL=raw-tool-call.d.ts.map

package/lib/types/client/tool/models/tool-call-model.d.ts

@@ -48,8 +48,9 @@ export interface ToolRowModel {
     summary: string;
     /**
      * Filesystem path from args (`path` / `file_path`) when the row is a file
-     * tool; absent for URL reads and non-file tools. The chat view resolves
-     * relative values against the session cwd before opening.
+     * tool; absent for URL reads and non-file tools. A `file_path` argument
+     * supplies it at every stage once its string is complete. The chat view
+     * resolves relative values against the session cwd before opening.
      */
     filePath: string | undefined;
     /** Original argument JSON retained for expansion-time body formatting. */

package/lib/types/client/tool/toolviews/ask-question-row.d.ts

@@ -1,9 +1,25 @@
 import type { Context } from '@deepseek-ai/cordis';
-import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
-import type { ToolCallViewProps } from '../../contract/slots.ts';
-type AskQuestionRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ToolCallViewProps, UserQuestionRecord } from '../../contract/slots.ts';
+/** Injected panel verbs for the row's own Session, filled by the optional panel provider. */
+interface AskQuestionPanelInjected {
+    /**
+     * Show one call's answer panel in the composer.
+     * @param callId - the row's own `ask_user_question` call.
+     * @returns whether a panel for that call was there to show.
+     */
+    revealPanel: (callId: string) => boolean;
+    /**
+     * Show one settled call's recorded answers as a read-only panel.
+     * @param callId - the row's own `ask_user_question` call.
+     * @param record - the call's questions and recorded answers, read from this row.
+     * @returns whether a panel provider was there to show it.
+     */
+    reviewPanel: (callId: string, record: UserQuestionRecord) => boolean;
+}
+type AskQuestionRowProps = ToolCallViewProps & PropsLocale<'conversation'> & InjectFace<AskQuestionPanelInjected>;
 /** Summarizes a pending, answered, cancelled, or interrupted question set. */
-export declare function AskQuestionRow({ toolName, block, inspect, useDisclosure, t }: AskQuestionRowProps): import("react").JSX.Element;
+export declare function AskQuestionRow({ callId, toolName, block, inspect, useDisclosure, useProjection, revealPanel, reviewPanel, t, }: AskQuestionRowProps): import("react").JSX.Element;
 /** Registers the ask-user-question conversation row. */
 export declare const askQuestionToolview: {
     name: string;

package/lib/types/client/tool/toolviews/bash-sample.d.ts

@@ -3,11 +3,12 @@ import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ToolCallViewProps } from '../../contract/slots.ts';
 type BashRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
 /**
- * Render expandable Bash output with an accessible lifecycle label.
+ * Render expandable Bash output with an accessible lifecycle label. While the
+ * call is preparing the row shows the description streamed so far and cannot expand.
  * @param props - tool call, Session sources, locale, and inspection callback.
  * @returns the Bash output row.
  */
-export declare const BashRow: import("react").MemoExoticComponent<(props: BashRowProps) => import("react").JSX.Element>;
+export declare const BashRow: import("react").MemoExoticComponent<({ toolName, block, sessionId, useSessions, inspect, useDisclosure, t }: BashRowProps) => import("react").JSX.Element>;
 /** Registers the standalone Bash conversation-row sample. */
 export declare const bashToolviewSample: {
     name: string;

package/lib/types/client/tool/toolviews/file-mutation-row.d.ts

@@ -3,9 +3,10 @@ import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ToolCallViewProps } from '../../contract/slots.ts';
 type FileMutationRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
 /**
- * Lets users expand an applied file diff and open the reported path.
+ * Shows the path and decoded input size through preparation, execution, and
+ * settlement, with the applied diff available once the call settles.
  */
-export declare function FileMutationRow(props: FileMutationRowProps): import("react").JSX.Element;
+export declare function FileMutationRow({ toolName, block, cwd, home, openFile, inspect, useDisclosure, t }: FileMutationRowProps): import("react").JSX.Element;
 /** Registers the edit and write conversation rows. */
 export declare const fileMutationToolview: {
     name: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-tool",
   "description": "Client Tool call-tree renderer and keyed per-tool presentation slot",
-  "version": "0.2.0-rc.1",
+  "version": "0.2.1-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -38,7 +38,7 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.4"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
   },
   "devDependencies": {
     "@testing-library/react": "^16.1.0",
@@ -46,32 +46,34 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "clsx": "^2.0.0",
-    "@deepseek-ai/dsh-spill-policy": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-agent": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-llm": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-session": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-system-prompt": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-tools": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-tool-jobs": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-tool-terminal": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-spill": "0.2.0-rc.1",
-    "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-api-remotes": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-tool-session-query": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-test-runtime": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-connection": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-api-workspace-controller": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-chat": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-attachment": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-ptc-runtime": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-token-meter": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-session": "0.2.0-rc.1",
-    "@deepseek-ai/dsh-util-workspace-path": "0.2.0-rc.1"
+    "@deepseek-ai/dsh-spill-policy": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-tools": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-tool-session-query": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-tool-terminal": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-spill": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-tool-jobs": "0.2.1-alpha.1",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/dsh-api-remotes": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-connection": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-test-runtime": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-api-workspace-controller": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-chat": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-util-workspace-path": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-token-meter": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-user-questions": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-ptc-runtime": "0.2.1-alpha.1"
   },
   "files": [
     "lib/index.js",

package/lib/types/client/tool/components/PreparingToolRow.d.ts

@@ -1,19 +0,0 @@
-/** Tool-owned non-expandable chrome without dispatched argument material. */
-import type { ReactNode } from 'react';
-import type { ToolCallViewProps } from '../../contract/slots.ts';
-import { type ToolRowProps } from './ToolRow.tsx';
-/** Inputs contain a tool-owned icon/title and no expandable body. */
-type PreparingToolRowProps = Pick<ToolCallViewProps, 'toolName' | 'useDisclosure'> & {
-    readonly icon: ReactNode;
-    readonly title: string;
-    readonly summary?: string;
-    readonly t: ToolRowProps['t'];
-};
-/**
- * Render a non-expandable tool prefix with an optional preparation summary.
- * @param props - tool prefix and locale.
- * @returns the preparation row.
- */
-export declare function PreparingToolRow({ toolName, useDisclosure, icon, title, summary, t }: PreparingToolRowProps): import("react").JSX.Element;
-export {};
-//# sourceMappingURL=PreparingToolRow.d.ts.map

package/lib/types/client/tool/tool-call-arguments-partial.d.ts

@@ -1,9 +0,0 @@
-import type { ToolCallInjected } from '../contract/slots.ts';
-/**
- * Bind one call without subscribing until its component invokes the Hook.
- * @param _standard - framework-provided scope props.
- * @param context - the preparing call's Step source and identity.
- * @returns a Hook that reads only this call's raw argument prefix.
- */
-export declare const bindToolCallArgumentsPartial: ToolCallInjected['hooks']['toolCallArgumentsPartial'];
-//# sourceMappingURL=tool-call-arguments-partial.d.ts.map