@deepseek-ai/dsh-client-ui-tool 0.1.7-alpha.2 → 0.1.7-rc.2

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

@@ -1,7 +1,7 @@
 /** Tool UI slot declarations and their composed component props. */
-import type { HostObservable, InjectFace, PropsLocale, PropsRenderSlots, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { HostObservable, InjectFace, PropsLocale, PropsRenderSlots, PropsRuntime, SlotHookFactory } from '@deepseek-ai/dsh-client-ui-slots';
 import type { RemoteHostFacts } from '@deepseek-ai/dsh-api-remotes/client';
-import type { OpenFileOptions, ToolCallBlock, UseDisclosure } from '@deepseek-ai/dsh-client-ui-chat/client';
+import type { AssistantChatData, 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';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface SlotMap {
@@ -12,12 +12,15 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
          *
          * 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 ToolCallOwnerProps.
+         * or settled node through explicit phase props. Preparing blocks have no dispatched
+         * arguments; useToolCallArgumentsPartial optionally subscribes to their raw prefix.
          */
         'tool.call.toolview': {
             kind: 'keyed';
             scope: 'session';
             owner: ToolCallOwnerProps;
+            hookContext: ToolCallHookContext;
+            inject: ToolCallInjected;
         };
         /**
          * Durable images of a settled image-bearing Tool call, rendered through
@@ -39,6 +42,20 @@ 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. */
@@ -49,37 +66,43 @@ export interface ToolImagesOwnerProps {
     align: 'start' | 'end';
 }
 /** Standard owner currency supplied to every atomic Tool view. */
-export interface ToolCallOwnerProps {
-    /** Stable injected Hook; each invocation owns its open state and subscribes to enclosing-Turn resets. */
+export interface ToolCallCommonProps {
+    /** Stable Hook; each invocation owns its open state and subscribes to enclosing-Turn resets. */
     useDisclosure: UseDisclosure;
-    /** Tool call identity, stable across running and settled forms. */
+    /** Call identity, stable across all stages. */
     callId: string;
     /** Wire Tool name and keyed dispatch value. */
     toolName: string;
-    /** Frozen running call or settled result node. */
-    block: ToolCallBlock;
     /** Session workspace root for relative summaries. */
     cwd?: string | undefined;
     /** Host account home; POSIX home-rooted summaries display as `~`. */
     home?: string | undefined;
-    /**
-     * Open a Tool argument path. A view that knows which line the call was about
-     * passes it, and the opened surface lands there.
-     */
+    /** Open an argument path at its optional requested line. */
     openFile: (path: string, options?: OpenFileOptions) => void;
-    /**
-     * Session-authorized image loader for the `tool.call.images` slot, supplied
-     * by the chat node that owns this call. A composed chat node always
-     * supplies it (`ChatNodeOwnerProps.loadImage` is required), so the tool
-     * layer never imports an attachment implementation nor handles URL
-     * authorization.
-     */
+    /** Chat-supplied, session-authorized loader for durable images; Tool views do not manage attachment URLs. */
     loadImage: MessageImageLoader;
     /** Inspect this call in the trajectory view when available. */
     inspect?: (() => void) | undefined;
 }
+/** Stage-specific tool data; only start/result expose the dispatched call material. */
+export type ToolCallPhaseProps = {
+    readonly phase: 'preparing';
+    readonly block: PreparingToolCall;
+} | {
+    readonly phase: 'start';
+    readonly block: StartedToolCall;
+} | {
+    readonly phase: 'result';
+    readonly block: ToolResultNode;
+};
+/** Common owner callbacks and the data admitted at the current tool stage. */
+export type ToolCallOwnerProps = ToolCallCommonProps & ToolCallPhaseProps;
 /** Full props of a registered atomic Tool view. */
 export type ToolCallViewProps = PropsRuntime<'tool.call.toolview'>;
+/** Existing argument/result business components exclude the preparation stage. */
+export type StartedToolCallViewProps = Exclude<ToolCallViewProps, {
+    readonly phase: 'preparing';
+}>;
 /** Injected Host description for POSIX home-path display. */
 export type ToolHostInfoInjected = {
     hooks: {
@@ -92,6 +115,6 @@ export type ToolHostInfoInjected = {
         hostInfo: HostObservable<RemoteHostFacts>;
     };
 };
-/** Full props of the Tool call-tree renderer registered as a `tool-call` Chat Node. */
+/** Full props of the Tool call-tree renderer registered as a tool-call Chat Node. */
 export type ToolTreeProps = PropsRuntime<'conversation.chat.node', 'tool-call'> & PropsRenderSlots<'tool.call.toolview'> & PropsLocale<'conversation'> & InjectFace<ToolHostInfoInjected>;
 //# sourceMappingURL=slots.d.ts.map

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 { ToolCallOwnerProps, ToolCallViewProps, ToolHostInfoInjected, ToolTreeProps, } from './contract/slots.ts';
+export type { StartedToolCallViewProps, ToolCallCommonProps, ToolCallOwnerProps, ToolCallPhaseProps, ToolCallViewProps, ToolCallHookContext, ToolCallInjected, ToolHostInfoInjected, ToolTreeProps, UseToolCallArgumentsPartial, } from './contract/slots.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,19 @@
+/** 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/components/ToolRow.d.ts

@@ -70,6 +70,8 @@ export interface ToolRowProps {
     filePathLine?: number | undefined;
     /** Open the path (already cwd-resolved), landing on `filePathLine` when given. */
     onOpenFile?: ((path: string, options?: OpenFileOptions) => void) | undefined;
+    /** Safe http(s) URL from tool args; when set, the summary renders as a link that opens it in a new tab. */
+    href?: string | undefined;
     /**
      * Jump to this call in the trajectory view: a hover-revealed Inspect pill
      * over the expanded body. Absent = no affordance.
@@ -78,8 +80,9 @@ export interface ToolRowProps {
 }
 /**
  * Render one localized tool summary and lazily mounted result card.
+ * Preparation retains the icon, title, and optional tool-name summary without disclosure.
  * @param props - tool state, summary, output, and navigation callbacks.
  * @returns the tool disclosure.
  */
-export declare const ToolRow: import("react").MemoExoticComponent<({ t, variant, toolName, icon, title, summary, summarySuffix, bodyRaw, output, askQuestion, errorSummary, terminal, diff, read, image, renderSlot, loadImage, search, web, details, state, filePath, filePathLine, onOpenFile, inspect, useDisclosure, }: ToolRowProps) => import("react").JSX.Element>;
+export declare const ToolRow: import("react").MemoExoticComponent<({ t, variant, toolName, icon, title, summary, summarySuffix, bodyRaw, output, askQuestion, errorSummary, terminal, diff, read, image, renderSlot, loadImage, search, web, details, state, filePath, filePathLine, onOpenFile, href, inspect, useDisclosure, }: ToolRowProps) => import("react").JSX.Element>;
 //# sourceMappingURL=ToolRow.d.ts.map

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

@@ -1,5 +1,6 @@
 /** Shared narrowing for raw Tool call and result fields consumed by card models. */
-import type { ToolCallBlock, ToolResultNode } from '@deepseek-ai/dsh-client-ui-chat/client';
+import type { ToolResultNode } from '@deepseek-ai/dsh-client-ui-chat/client';
+import type { ToolCallBlock } from './tool-call-model.ts';
 /** A parsed, in-window Tool call whose arguments are a JSON object. */
 export interface ParsedToolCall {
     name: string;
@@ -7,8 +8,8 @@ export interface ParsedToolCall {
 }
 /**
  * Parse the call head paired with one immutable Tool block.
- * @param block - running or settled Tool block.
- * @returns the Tool name and object arguments, or null when the call head or valid JSON object is unavailable.
+ * @param block - preparing, dispatched, or settled Tool block.
+ * @returns the Tool name and object arguments, or null during preparation or when valid arguments are unavailable.
  */
 export declare function parsedToolCall(block: ToolCallBlock): ParsedToolCall | null;
 /**

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

@@ -1,5 +1,5 @@
 /** Todo changes relative to the preceding recorded write. */
-import type { ToolCallBlock } from '@deepseek-ai/dsh-client-ui-chat/client';
+import type { ToolCallBlock } from './tool-call-model.ts';
 import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ToolDetailsModel } from '../components/ToolDetails.tsx';
 import type { TodoBaseline } from './todo-history.ts';

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

@@ -11,13 +11,13 @@ export type { ToolCallBlock } from '@deepseek-ai/dsh-client-ui-chat/client';
 /** Tool-call row variants selected by the generic atomic renderer. */
 export type ToolRowVariant = 'search' | 'read' | 'bash' | 'write' | 'edit' | 'code' | 'others';
 /** Row lifecycle state used by summary styling and accessible status text. */
-export type ToolRowState = 'running' | 'ok' | 'error' | 'stopped';
+export type ToolRowState = 'preparing' | 'running' | 'ok' | 'error' | 'stopped';
 /** Locale-neutral structured fact consumed only by the user-facing Tool row. */
 export interface AutoReviewDenial {
     /** Raw persisted reviewer reason; display normalization happens at render time. */
     reason: string | null;
 }
-type ToolTitleKey = Extract<LocaleKeysOf<'conversation'>, `tool.title.${string}`>;
+type ToolTitleKey = Extract<LocaleKeysOf<'conversation'>, `tool.title.${string}` | 'ask.rowTitle' | 'todo.rowTitle'>;
 /** Locale key per generic row variant. */
 export declare const VARIANT_TITLE_KEYS: {
     readonly search: "tool.title.search";
@@ -34,10 +34,17 @@ export declare const VARIANT_TITLE_KEYS: {
  * @returns matching variant, others when unknown.
  */
 export declare function classifyTool(toolName: string): ToolRowVariant;
+/**
+ * Select a tool-owned or generic title without reading arguments.
+ * @param toolName - wire tool name.
+ * @returns the localized title key.
+ */
+export declare function toolTitleKey(toolName: string): ToolTitleKey;
 /** Everything ToolRow needs, derived once from the frozen slice. */
 export interface ToolRowModel {
     variant: ToolRowVariant;
     titleKey: ToolTitleKey;
+    /** Generic rows retain the wire tool name; available arguments append their summary. */
     summary: string;
     /**
      * Filesystem path from args (`path` / `file_path`) when the row is a file
@@ -73,7 +80,7 @@ export declare function formatToolBody(variant: ToolRowVariant, argsRaw: string)
 /**
  * Derive the full row model from a frozen call slice.
  * @param toolName - wire tool name (dispatch-supplied; survives windowless results).
- * @param block - RunningToolCall or ToolResultNode off the snapshot caches.
+ * @param block - preparing call, dispatched call, or result from the snapshot.
  * @param cwd - session workspace root; workspace-rooted path summaries display relative to it.
  * @param home - host account home; a leftover POSIX home path displays as `~`.
  * @returns the row model.

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

@@ -10,5 +10,11 @@ export type WebCardModelProps = DistributiveOmit<WebBlockProps, 'labels' | 'clas
  * @returns web-card props, or null for the generic path.
  */
 export declare function webCardModel(block: ToolCallBlock): WebCardModelProps | null;
+/**
+ * Read the openable URL of a web_fetch call from its arguments.
+ * @param block - running or settled Tool block.
+ * @returns the http(s) URL, or undefined for another tool, protocol, or unparsable argument.
+ */
+export declare function webFetchHref(block: ToolCallBlock): string | undefined;
 export {};
 //# sourceMappingURL=web-card-model.d.ts.map

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

@@ -0,0 +1,9 @@
+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

package/lib/types/client/tool/toolviews/GenericToolCard.d.ts

@@ -1,7 +1,8 @@
 import type { ToolCallOwnerProps, ToolTreeProps } from '../../contract/slots.ts';
 /** Card props: the owner payload plus the render site's locale seat (plain prop). */
-export interface GenericToolCardProps extends ToolCallOwnerProps {
+export type GenericToolCardProps = ToolCallOwnerProps & {
     t: ToolTreeProps['t'];
-}
+};
+/** @param props - current tool stage and locale. @returns its preparation or dispatched card. */
 export declare function GenericToolCard({ toolName, block, cwd, home, openFile, inspect, useDisclosure, t }: GenericToolCardProps): import("react").JSX.Element;
 //# sourceMappingURL=GenericToolCard.d.ts.map

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

@@ -7,7 +7,7 @@ type BashRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
  * @param props - tool call, Session sources, locale, and inspection callback.
  * @returns the Bash output row.
  */
-export declare const BashRow: import("react").MemoExoticComponent<({ toolName, block, sessionId, useSessions, inspect, useDisclosure, t }: BashRowProps) => import("react").JSX.Element>;
+export declare const BashRow: import("react").MemoExoticComponent<(props: BashRowProps) => import("react").JSX.Element>;
 /** Registers the standalone Bash conversation-row sample. */
 export declare const bashToolviewSample: {
     name: string;

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

@@ -1,16 +1,18 @@
 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 DetailsRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
 /**
  * Present recorded entities, receipts, and report fields in the existing expandable row.
  * @param props - Tool call, row actions, and locale supplied by the keyed slot.
  * @returns A Tool row with structured details or generic input/output.
  */
-export declare function DetailsRow({ toolName, block, cwd, home, openFile, inspect, useDisclosure, t }: ToolCallViewProps & PropsLocale<'conversation'>): import("react").JSX.Element;
+export declare function DetailsRow({ toolName, block, cwd, home, openFile, inspect, useDisclosure, t }: DetailsRowProps): import("react").JSX.Element;
 /** Register recorded-result details through the standard atomic Tool slot. */
 export declare const detailsToolview: {
     name: string;
     inject: string[];
     apply(ctx: Context): void;
 };
+export {};
 //# sourceMappingURL=details-row.d.ts.map

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

@@ -5,7 +5,7 @@ type FileMutationRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
 /**
  * Lets users expand an applied file diff and open the reported path.
  */
-export declare function FileMutationRow({ toolName, block, cwd, home, openFile, inspect, useDisclosure, t }: FileMutationRowProps): import("react").JSX.Element;
+export declare function FileMutationRow(props: 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.1.7-alpha.2",
+  "version": "0.1.7-rc.2",
   "publishConfig": {
     "access": "public"
   },
@@ -46,32 +46,32 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "clsx": "^2.0.0",
-    "@deepseek-ai/dsh-spill-policy": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-agent": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-llm": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-session": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-tools": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-tool-jobs": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-tool-session-query": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-tool-terminal": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-spill-policy": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-tool-jobs": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-tool-session-query": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-tool-terminal": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-spill": "0.1.7-rc.2",
     "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-api-remotes": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-spill": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-api-workspace-controller": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-chat": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-session": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-util-workspace-path": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-ptc-runtime": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-token-meter": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-attachment": "0.1.7-alpha.2"
+    "@deepseek-ai/dsh-api-remotes": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-connection": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-test-runtime": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-workspace-controller": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-chat": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-util-workspace-path": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-attachment": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-ptc-runtime": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-token-meter": "0.1.7-rc.2"
   },
   "files": [
     "lib/index.js",