@deepseek-ai/dsh-client-ui-tool 0.0.1-rc.1

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

@@ -0,0 +1,31 @@
+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.
+ */
+export declare function FileMutationRow({ toolName, block, cwd, 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.
+ */
+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 {};
+//# sourceMappingURL=file-mutation-row.d.ts.map

package/lib/types/client/tool/toolviews/plan-summary.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Pure plan derivation for the todo_write row's one-line summary. Several items
+ * may be `in_progress` at once — parallel work runs concurrent tasks, so a
+ * summary built from one active item would silently drop the rest. The plan
+ * strip header derives its own counts inline and shares nothing with this, so
+ * this stays inside the toolviews domain rather than in `contract/` (the
+ * inter-domain face).
+ * @module
+ */
+/**
+ * One list item as the row sees it: unvalidated model JSON parsed from a call's
+ * args, so any field may be missing or mistyped.
+ */
+export interface PlanItemLike {
+    content?: unknown;
+    status?: unknown;
+}
+/**
+ * Counts plus the two halves of the summary, deliberately NOT pre-joined: the
+ * row ellipsizes its summary text, and a count concatenated onto the end of the
+ * task name is the first thing a narrow row clips — exactly when it carries
+ * information. The row renders `activeExtra` in its own non-shrinking span
+ * beside the truncatable text.
+ */
+export interface PlanSummary {
+    done: number;
+    total: number;
+    /** First `in_progress` content, or null when that first item is unusable. */
+    activeContent: string | null;
+    /** Active items beyond the first; 0 whenever there is no `activeContent` to sit beside. */
+    activeExtra: number;
+}
+/**
+ * Derive the counts and the active summary from a whole-list snapshot. It names
+ * the first `in_progress` item and counts the remaining active ones, so a
+ * parallel plan reports how many tasks are running rather than naming one and
+ * hiding the others. `activeContent` is null when nothing is in progress, or
+ * when the first active item's content is missing, mistyped, or blank once
+ * trimmed — the tool's own rule for usable content, applied here because a
+ * rejected call keeps its args verbatim. The row then renders the counts alone
+ * rather than falling back to the generic tool summary: the counts are already
+ * known to be good, and the active-item clause is the only part an unusable
+ * name costs.
+ * @param todos - the whole list, in model order.
+ * @returns the done/total counts and the two summary halves.
+ */
+export declare function planSummary(todos: readonly PlanItemLike[]): PlanSummary;
+//# sourceMappingURL=plan-summary.d.ts.map

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

@@ -0,0 +1,26 @@
+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.
+ */
+export declare function ReadRow({ toolName, block, cwd, 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.
+ */
+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 {};
+//# sourceMappingURL=read-row.d.ts.map

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

@@ -0,0 +1,31 @@
+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 + Search · {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.
+ */
+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`.
+ */
+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 {};
+//# sourceMappingURL=search-row.d.ts.map

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

@@ -0,0 +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';
+/** 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. */
+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.
+ */
+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 {};
+//# sourceMappingURL=todo-row.d.ts.map

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

@@ -0,0 +1,26 @@
+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.
+ */
+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.
+ */
+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 {};
+//# sourceMappingURL=web-row.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,4 @@
+/** Host loader entry for the browser-only Tool UI plugin. */
+/** Provides no host-side behavior. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-tool`.
+ * @module @deepseek-ai/dsh-client-ui-tool/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-tool-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@deepseek-ai/dsh-client-ui-tool",
+  "description": "Client Tool call-tree renderer and keyed per-tool presentation slot",
+  "version": "0.0.1-rc.1",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-tool"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.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-client-runtime",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "BSD-3-Clause",
+  "dependencies": {
+    "clsx": "^2.0.0"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "@deepseek-ai/dsh-client-connection": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-web-react": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}