@deepseek-ai/dsh-client-ui-tool 0.1.1-rc.2 → 0.1.2-alpha.3

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

@@ -1,39 +1,14 @@
-/**
- * Pure derivation of the web-card props from a frozen call slice: the
- * `card:'web'` render intent the `web_search`/`web_fetch` tools declare at
- * result time arrives on the snapshot as `resultView`, and this is the one
- * place that turns it into what {@link WebBlock} draws. Both conversation
- * render sites (the chat tool row's resident/expanded body and the details
- * panel's Output section) call this, so the sources and fetch summary they
- * show are derived once.
- *
- * The web card is result-only by contract: those tools keep a generic pending
- * call view, so there is nothing to derive while the call is still running and
- * a running call always takes the generic path.
- * @module
- */
+/** Pure web-card derivation from raw web result metadata. @module */
 import type { WebBlockProps } from '@deepseek-ai/dsh-client-ui-primitives';
 import type { ToolCallBlock } from './tool-call-model.ts';
+type DistributiveOmit<T, K extends keyof T> = T extends unknown ? Omit<T, K> : never;
+/** Web-card data owned by the presenter; render sites add localized labels and classes. */
+export type WebCardModelProps = DistributiveOmit<WebBlockProps, 'labels' | 'className'>;
 /**
- * Derive the web-card props for a tool call, or null when this call is not a
- * web card and belongs on the generic path.
- *
- * The result side supplies the whole card: the sources and answer for a
- * `search`, the URL and status for a `fetch`. Cases producing null, all of
- * them the documented generic-card default:
- *
- * - A running call (no `resultView` yet): the web tools keep a generic pending
- *   card, so nothing web-shaped exists until the call settles.
- * - A settled call whose result view is not a web card — including a `card`
- *   value this UI version does not know, which arrives over the wire and so
- *   cannot be trusted to be one of the compiled variants, and a generic result
- *   view (a web tool's error path returns the generic card, whose text the
- *   generic path preserves).
- * - A web card whose `kind` this UI version does not know (a newer host's
- *   value): the wire cannot be trusted to be `search` or `fetch`, so it takes
- *   the generic path rather than rendering as a malformed fetch.
- * @param block - RunningToolCall or ToolResultNode off the snapshot caches.
- * @returns the web-card props, or null for the generic path.
+ * Derive a settled root web-search or web-fetch card from persisted metadata.
+ * @param block - running or settled Tool block.
+ * @returns web-card props, or null for the generic path.
  */
-export declare function webCardModel(block: ToolCallBlock): WebBlockProps | null;
+export declare function webCardModel(block: ToolCallBlock): WebCardModelProps | null;
+export {};
 //# sourceMappingURL=web-card-model.d.ts.map

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

@@ -1,22 +1,13 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ToolCallViewProps } from '../../contract/slots.ts';
-/** Full row props: the toolview runtime share plus the standard locale seat. */
 type AskQuestionRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
-/** One-line question-interaction row (the whole row toggles the call's
- *  Input/Output sections, ToolRow's unified expand). */
+/** Summarizes a pending, answered, cancelled, or interrupted question set. */
 export declare function AskQuestionRow({ toolName, block, inspect, t }: AskQuestionRowProps): import("react").JSX.Element;
-/**
- * The ask-question row as a plain registrant plugin following the chat
- * toolview declaration across independent activation and reload lifetimes.
- */
+/** Registers the ask-user-question conversation row. */
 export declare const askQuestionToolview: {
     name: string;
     inject: string[];
-    /**
-     * Register the ask-question row into the Tool-owned keyed view slot.
-     * @param ctx - registrant context (disposal rides ctx.effect inside slots.register).
-     */
     apply(ctx: Context): void;
 };
 export {};

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

@@ -1,25 +1,13 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ToolCallViewProps } from '../../contract/slots.ts';
-/** Bash row props: the toolview runtime share plus the standard locale seat. */
 type BashRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
-/**
- * Bash row: icon + Bash · {description} in the shared ToolRow chrome, the
- * whole row toggling the command's terminal or generic error card (ToolRow's unified
- * expand interaction, replicated locally per the registrant posture).
- */
+/** Renders expandable Bash output with an accessible lifecycle label. */
 export declare function BashRow({ toolName, block, sessionId, useSessions, inspect, t }: BashRowProps): import("react").JSX.Element;
-/**
- * The sample as a plain registrant plugin. Slot injection follows the chat
- * toolview declaration across independent activation and reload lifetimes.
- */
+/** Registers the standalone Bash conversation-row sample. */
 export declare const bashToolviewSample: {
     name: string;
     inject: string[];
-    /**
-     * Register the bash row into the Tool-owned keyed view slot.
-     * @param ctx - registrant context (disposal rides ctx.effect inside slots.register).
-     */
     apply(ctx: Context): void;
 };
 export {};

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

@@ -1,30 +1,15 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ToolCallViewProps } from '../../contract/slots.ts';
-/** Full row props: the toolview runtime share plus the standard locale seat. */
 type FileMutationRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
 /**
- * File-mutation row: icon + {Edit,Write} · {path} in the shared ToolRow chrome,
- * with the applied diff as the row's collapsed-by-default card body. The
- * summary is a path link (a file tool's interaction); the host's `openFile`
- * resolves it against the session cwd, so this passes the tool's own path
- * verbatim. An errored mutation has no diff card, so ToolRow surfaces the
- * model-facing error text through its Output section and its first line in the
- * collapsed summary instead.
+ * Lets users expand an applied file diff and open the reported path.
  */
 export declare function FileMutationRow({ toolName, block, cwd, home, openFile, inspect, t }: FileMutationRowProps): import("react").JSX.Element;
-/**
- * The file-mutation rows as a plain registrant plugin following the chat
- * toolview declaration across independent activation and reload lifetimes.
- */
+/** Registers the edit and write conversation rows. */
 export declare const fileMutationToolview: {
     name: string;
     inject: string[];
-    /**
-     * Register the file-mutation row into the Tool-owned keyed view slot
-     * under both mutation tool names.
-     * @param ctx - registrant context (disposal rides ctx.effect inside slots.register).
-     */
     apply(ctx: Context): void;
 };
 export {};

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

@@ -1,25 +1,15 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ToolCallViewProps } from '../../contract/slots.ts';
-/** Full row props: the toolview runtime share plus the standard locale seat. */
 type ReadRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
 /**
- * Read row: icon + Read · {path} in the shared ToolRow chrome, with the file's
- * read card as the row's collapsed-by-default card body. The summary path is an
- * openable host link when the row names a single file.
+ * Lets users expand a completed read result and open its reported path.
  */
 export declare function ReadRow({ toolName, block, cwd, home, openFile, inspect, t }: ReadRowProps): import("react").JSX.Element;
-/**
- * The read row as a plain registrant plugin following the atomic Tool-view
- * declaration across independent activation and reload lifetimes.
- */
+/** Registers the read tool's conversation row. */
 export declare const readToolview: {
     name: string;
     inject: string[];
-    /**
-     * Register the read row into the Tool-owned keyed view slot.
-     * @param ctx - registrant context (disposal rides ctx.effect inside slots.register).
-     */
     apply(ctx: Context): void;
 };
 export {};

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

@@ -1,30 +1,13 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ToolCallViewProps } from '../../contract/slots.ts';
-/** Full row props: the toolview runtime share plus the standard locale seat. */
 type SearchRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
-/**
- * Search row: icon + Grep/Glob · {summary} in the shared ToolRow chrome, with the
- * completed search's card as the row's collapsed-by-default card body (a capped
- * search's recovery footer rides below it, inside ToolRow). Registered under
- * both `grep` and `glob`; the derived model's `kind` decides the card shape. A
- * settled call with no search card surfaces its model-facing text through
- * ToolRow's Output section, since the keyed SearchRow owns this render slot.
- */
+/** Lets users expand grep or glob results and recover capped searches. */
 export declare function SearchRow({ toolName, block, inspect, t }: SearchRowProps): import("react").JSX.Element;
-/**
- * The search view follows the atomic Tool-view declaration across activation
- * and reload. One component registers under both keys because `grep` and
- * `glob` are the same visual object discriminated by the result view's `kind`.
- */
+/** Registers the grep and glob conversation rows. */
 export declare const searchToolview: {
     name: string;
     inject: string[];
-    /**
-     * Register the search row into the Tool-owned keyed view slot under both
-     * the `grep` and `glob` tool names.
-     * @param ctx - registrant context (disposal rides ctx.effect inside slots.register).
-     */
     apply(ctx: Context): void;
 };
 export {};

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

@@ -1,24 +1,13 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ToolCallViewProps } from '../../contract/slots.ts';
-/** Todo row props: the toolview runtime share plus the standard locale seat. */
 type TodoRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
-/** One-line plan update row (the whole row toggles the call's Input/Output
- *  sections, ToolRow's unified expand). Non-ok execution states keep the
- *  shared row's dot semantics — a cancelled call wrote no todo/write, so it
- *  must not read as a completed update. */
+/** Summarizes a plan update without presenting a cancelled call as completed. */
 export declare function TodoRow({ toolName, block, inspect, t }: TodoRowProps): import("react").JSX.Element;
-/**
- * The todo row as a plain registrant plugin following the atomic Tool-view
- * declaration across independent activation and reload lifetimes.
- */
+/** Registers the todo conversation row. */
 export declare const todoToolview: {
     name: string;
     inject: string[];
-    /**
-     * Register the todo row into the Tool-owned keyed view slot.
-     * @param ctx - registrant context (disposal rides ctx.effect inside slots.register).
-     */
     apply(ctx: Context): void;
 };
 export {};

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

@@ -1,25 +1,13 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
 import type { ToolCallViewProps } from '../../contract/slots.ts';
-/** Full row props: the toolview runtime share plus the standard locale seat. */
 type WebRowProps = ToolCallViewProps & PropsLocale<'conversation'>;
-/**
- * Web row: icon + Search/Fetch · {summary} in the shared ToolRow chrome, with
- * the completed retrieval's web card as the row's collapsed-by-default card
- * body. The row discriminates on `toolName` only to pick its icon and title.
- */
+/** Lets users expand a completed web search or fetch result. */
 export declare function WebRow({ toolName, block, inspect, t }: WebRowProps): import("react").JSX.Element;
-/**
- * The web rows follow the atomic Tool-view declaration across activation and
- * reload. One WebRow component registers under both web tool names.
- */
+/** Registers the web search and fetch conversation rows. */
 export declare const webToolview: {
     name: string;
     inject: string[];
-    /**
-     * Register the web row under both web tool names' keyed toolview holes.
-     * @param ctx - registrant context (disposal rides ctx.effect inside slots.register).
-     */
     apply(ctx: Context): void;
 };
 export {};

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.1-rc.2",
+  "version": "0.1.2-alpha.3",
   "publishConfig": {
     "access": "public"
   },
@@ -32,8 +32,8 @@
   "dsh": {
     "client": {
       "inject": [
+        "@deepseek-ai/dsh-api-workspace-controller",
         "@deepseek-ai/dsh-client-connection",
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-ui-conversation"
       ],
@@ -45,29 +45,27 @@
     "clsx": "^2.0.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2"
+    "@deepseek-ai/cordis": "^4.0.2"
   },
   "devDependencies": {
     "@testing-library/react": "^16.1.0",
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.1-rc.2",
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-connection": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.1-rc.2"
+    "@deepseek-ai/dsh-api-remotes": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-connection": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-alpha.3",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-chat": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-util-workspace-path": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.3"
   },
   "files": [
     "lib/index.js",