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

package/README.i18n.yaml

@@ -1,6 +1,55 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/extensions/ui-cordis/README.md
-README.md: 1f3677d48eda13cad18a24ed6021f30535db686a
-README.zh.md: f3855ce6f75efc7510abdaff8d211cec167d5117
+/:
+  en: cdad52474ffc161d
+  zh: 864ed938d5ee9012
+/deepseek-ai-dsh-client-ui-cordis:
+  en: 63d8703a05312146
+  zh: 9e4c02908b65c417
+/deepseek-ai-dsh-client-ui-cordis/summary:
+  en: 4d3e762156a6e66e
+  zh: 436215c71fd8905c
+/deepseek-ai-dsh-client-ui-cordis/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: 09388d293f9be9cb
+/deepseek-ai-dsh-client-ui-cordis/use-this-package:
+  en: b2f4dd7bdcfa5fea
+  zh: 23e48220e532f98a
+/deepseek-ai-dsh-client-ui-cordis/use-this-package/what-the-panel-shows:
+  en: 56ec98fc74c1706a
+  zh: 06d2c6315aa20217
+/deepseek-ai-dsh-client-ui-cordis/use-this-package/what-the-tool-cards-show:
+  en: a9c45dd79deab953
+  zh: 6d68858f202ee247
+/deepseek-ai-dsh-client-ui-cordis/use-this-package/boundaries-to-plan-around:
+  en: c76ace6595f805d6
+  zh: 53ee7e51823f367c
+/deepseek-ai-dsh-client-ui-cordis/understand-the-implementation:
+  en: e4e1b788078bcd0d
+  zh: 93d0cb3132fd2157
+/deepseek-ai-dsh-client-ui-cordis/understand-the-implementation/design-philosophy:
+  en: b27840fda9efefc6
+  zh: 53ed0401355290eb
+/deepseek-ai-dsh-client-ui-cordis/understand-the-implementation/source-map:
+  en: de077f5773f79ac6
+  zh: 6d6f98cc34d530a5
+/deepseek-ai-dsh-client-ui-cordis/understand-the-implementation/how-the-panel-stays-current:
+  en: cbcc34aa282d8739
+  zh: ad054d71184037e3
+/deepseek-ai-dsh-client-ui-cordis/further-exploration:
+  en: 30316fa7214c7995
+  zh: 01bf063e4c21b0c7
+/deepseek-ai-dsh-client-ui-cordis/model-experience:
+  en: 83a0687b7ad68dde
+  zh: 9763803384bef7af
+/deepseek-ai-dsh-client-ui-cordis/model-experience/kv-cache-effect:
+  en: ec4562df89d18e78
+  zh: 30084e7fb8dee95d
+/deepseek-ai-dsh-client-ui-cordis/known-limitations-and-deferred-work:
+  en: 3b9cfd230ab18a75
+  zh: 47b87bb34b9c9d1c
+/deepseek-ai-dsh-client-ui-cordis/known-limitations-and-deferred-work/dev-note:
+  en: 82bc60a2bd964744
+  zh: 900679483cdbde4b

package/README.md

@@ -33,6 +33,8 @@ A `sidebar.footer.action` seat shows a badge counting what runs plus what waits;
 
 ### What the tool cards show
 
+Preparing calls show their ordinary Cordis icon and title in one non-expandable row. This stage does not derive a package identity, read its live inventory, or mount its business view; those operations require the start/result props.
+
 The `cordis_define` card is a record: the name and purpose the model wrote, the source it wrote, and whether the definition is running — no switch, no approval, and a pointer to the panel. The `cordis_run` card shows the mode, the plugin, package, and run ids, the outcome, and offers the package's own business view through the `tool.view.cordis` slot when the package registered one. Define, run, stop, and undefine cards retain their ordinary business glyph when they fail or are interrupted, including a correlated activation failure after a successful run receipt. All cards render from the recorded call and result, so replay shows the same card.
 
 ### Boundaries to plan around

package/README.zh.md

@@ -33,6 +33,8 @@ kind: "package-reference"
 
 ### 工具卡片显示什么
 
+准备中的调用显示为带普通 Cordis 图标与标题的不可展开单行。此阶段不派生包身份、不读取其当前清单，也不挂载其业务视图；这些操作需要 start/result props。
+
 `cordis_define` 卡片是一份记录：模型写下的 name 与 purpose、它写的源码，以及该定义是否在跑——没有开关、没有审批，只有一句指向面板的指引。`cordis_run` 卡片显示模式、插件标识、包标识与运行标识、结果，并在包注册了业务视图时经 `tool.view.cordis` slot 提供它。define、run、stop 与 undefine 卡片在失败或中断时继续保留普通业务图标，包括调用回执成功后发生的关联激活失败。所有卡片都渲染会话记录下的 call 与 result，因此回放显示同一张卡。
 
 ### 需要规划的边界

package/lib/client.js

@@ -137,10 +137,51 @@ window.__ModuleLoader__.load({
 			"title": "cvtE3a_title"
 		};
 		//#endregion
+		//#region lib/types/client/CordisPreparingRow.js
+		/* v8 ignore next -- Non-expandable rows never invoke DisclosureRow's required toggle callback. */
+		const noop = () => void 0;
+		/**
+		* Render a Cordis-owned prefix without disclosure.
+		* @param props - Cordis prefix, styling, and locale.
+		* @returns the preparation row.
+		*/
+		function CordisPreparingRow({ toolName, t, icon, title, className, rowClassName, titleClassName }) {
+			return (0, react_jsx_runtime.jsx)("div", {
+				"data-tool": toolName,
+				"data-state": "preparing",
+				"aria-label": t("a11y.preparing"),
+				children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.DisclosureRow, {
+					icon,
+					title,
+					className,
+					rowClassName,
+					titleClassName,
+					open: false,
+					expandable: false,
+					onToggle: noop,
+					running: true
+				})
+			});
+		}
+		//#endregion
 		//#region lib/types/client/CordisActionRow.js
 		/** Localized cards for `cordis_stop` and `cordis_undefine`. */
 		/** Render one Stop or Remove call with Cordis-owned localized copy. */
-		function CordisActionRow({ callId, toolName, block, inspect, t }) {
+		function CordisActionRow(props) {
+			if (props.phase === "preparing") {
+				const remove = props.toolName === "cordis_undefine";
+				return (0, react_jsx_runtime.jsx)(CordisPreparingRow, {
+					...props,
+					icon: remove ? (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconTrashOutlineRegular, { size: 14 }) : (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconStopFillRegular, { size: 14 }),
+					title: props.t(remove ? "row.removeTitle" : "row.stopTitle"),
+					className: CordisRunRow_module_css_default.card,
+					rowClassName: CordisRunRow_module_css_default.row,
+					titleClassName: CordisRunRow_module_css_default.title
+				});
+			}
+			return (0, react_jsx_runtime.jsx)(StartedCordisActionRow, { ...props });
+		}
+		function StartedCordisActionRow({ callId, toolName, block, inspect, t }) {
 			const card = cordisActionCard(block);
 			const remove = toolName === "cordis_undefine";
 			const summary = card.errorSummary ?? card.pluginId ?? callId;
@@ -264,7 +305,18 @@ window.__ModuleLoader__.load({
 			}
 		}
 		/** Render one immutable Package definition. */
-		function CordisDefineRow({ callId, block, inspect, useInventory, useLoaded, t }) {
+		function CordisDefineRow(props) {
+			if (props.phase === "preparing") return (0, react_jsx_runtime.jsx)(CordisPreparingRow, {
+				...props,
+				icon: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCodeOutlineRegular, { size: 14 }),
+				title: props.t("row.defineTitle"),
+				className: CordisDefineRow_module_css_default.card,
+				rowClassName: CordisDefineRow_module_css_default.row,
+				titleClassName: CordisDefineRow_module_css_default.title
+			});
+			return (0, react_jsx_runtime.jsx)(StartedCordisDefineRow, { ...props });
+		}
+		function StartedCordisDefineRow({ callId, block, inspect, useInventory, useLoaded, t }) {
 			const card = cordisDefineCard(block);
 			const inventory = useInventory((snapshot) => snapshot);
 			const loaded = useLoaded((snapshot) => snapshot);
@@ -458,7 +510,18 @@ window.__ModuleLoader__.load({
 			superseded: "status.superseded"
 		};
 		/** Render one activation result and, when eligible, its Package-owned view. */
-		function CordisRunRow({ callId, block, inspect, renderSlot, useInventory, useLoaded, useRunCards, useActiveRuns, onObserveRunCard, t }) {
+		function CordisRunRow(props) {
+			if (props.phase === "preparing") return (0, react_jsx_runtime.jsx)(CordisPreparingRow, {
+				...props,
+				icon: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCodeOutlineRegular, { size: 14 }),
+				title: props.t("row.runTitle"),
+				className: CordisRunRow_module_css_default.card,
+				rowClassName: CordisRunRow_module_css_default.row,
+				titleClassName: CordisRunRow_module_css_default.title
+			});
+			return (0, react_jsx_runtime.jsx)(StartedCordisRunRow, { ...props });
+		}
+		function StartedCordisRunRow({ callId, block, inspect, renderSlot, useInventory, useLoaded, useRunCards, useActiveRuns, onObserveRunCard, t }) {
 			const card = cordisRunCard(block);
 			const inventory = useInventory((snapshot) => snapshot);
 			const loaded = useLoaded((snapshot) => snapshot);
@@ -1164,6 +1227,7 @@ window.__ModuleLoader__.load({
 		/** Simplified Chinese Cordis UI messages. */
 		const zh = {
 			"row.defineTitle": "注册 Cordis 插件",
+			"a11y.preparing": "准备调用 Cordis 工具",
 			"row.runTitle": "运行 Cordis 插件",
 			"row.updateTitle": "更新 Cordis 插件",
 			"row.stopTitle": "停止 Cordis 插件",
@@ -1217,6 +1281,7 @@ window.__ModuleLoader__.load({
 		/** English Cordis UI messages. */
 		const en = {
 			"row.defineTitle": "Register Cordis Plugin",
+			"a11y.preparing": "Preparing a Cordis tool call",
 			"row.runTitle": "Run Cordis Plugin",
 			"row.updateTitle": "Update Cordis Plugin",
 			"row.stopTitle": "Stop Cordis Plugin",

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

@@ -4,5 +4,5 @@ import type { ToolCallViewProps } from '@deepseek-ai/dsh-client-ui-tool/client';
 /** Full action-card props composed by the keyed Tool slot. */
 export type CordisActionRowProps = ToolCallViewProps & PropsLocale<'cordis'>;
 /** Render one Stop or Remove call with Cordis-owned localized copy. */
-export declare function CordisActionRow({ callId, toolName, block, inspect, t }: CordisActionRowProps): import("react").JSX.Element;
+export declare function CordisActionRow(props: CordisActionRowProps): import("react").JSX.Element;
 //# sourceMappingURL=CordisActionRow.d.ts.map

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

@@ -5,5 +5,5 @@ import type { CordisCardFace } from './slots.ts';
 /** Full card props composed by the keyed Tool slot. */
 export type CordisDefineRowProps = ToolCallViewProps & InjectFace<CordisCardFace> & PropsLocale<'cordis'>;
 /** Render one immutable Package definition. */
-export declare function CordisDefineRow({ callId, block, inspect, useInventory, useLoaded, t, }: CordisDefineRowProps): import("react").JSX.Element;
+export declare function CordisDefineRow(props: CordisDefineRowProps): import("react").JSX.Element;
 //# sourceMappingURL=CordisDefineRow.d.ts.map

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

@@ -0,0 +1,19 @@
+/** Argument-free Cordis tool prefix shared by its three card families. */
+import type { ReactNode } from 'react';
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ToolCallViewProps } from '@deepseek-ai/dsh-client-ui-tool/client';
+type CordisPreparingRowProps = Pick<ToolCallViewProps, 'toolName'> & PropsLocale<'cordis'> & {
+    readonly icon: ReactNode;
+    readonly title: string;
+    readonly className?: string | undefined;
+    readonly rowClassName?: string | undefined;
+    readonly titleClassName?: string | undefined;
+};
+/**
+ * Render a Cordis-owned prefix without disclosure.
+ * @param props - Cordis prefix, styling, and locale.
+ * @returns the preparation row.
+ */
+export declare function CordisPreparingRow({ toolName, t, icon, title, className, rowClassName, titleClassName, }: CordisPreparingRowProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=CordisPreparingRow.d.ts.map

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

@@ -5,5 +5,5 @@ import type { CordisRunCardFace } from './slots.ts';
 /** Full Run-card props including its declared Package business-view child slot. */
 export type CordisRunRowProps = ToolCallViewProps & InjectFace<CordisRunCardFace> & PropsRenderSlots<'tool.view.cordis'> & PropsLocale<'cordis'>;
 /** Render one activation result and, when eligible, its Package-owned view. */
-export declare function CordisRunRow({ callId, block, inspect, renderSlot, useInventory, useLoaded, useRunCards, useActiveRuns, onObserveRunCard, t, }: CordisRunRowProps): import("react").JSX.Element;
+export declare function CordisRunRow(props: CordisRunRowProps): import("react").JSX.Element;
 //# sourceMappingURL=CordisRunRow.d.ts.map

package/lib/types/client/card-model.d.ts

@@ -1,7 +1,7 @@
 /** Replay-stable view models for Cordis lifecycle Tool calls. */
-import type { ToolCallViewProps } from '@deepseek-ai/dsh-client-ui-tool/client';
+import type { StartedToolCallViewProps } from '@deepseek-ai/dsh-client-ui-tool/client';
 import type { CordisDynamicPackageId, CordisDynamicPluginId, CordisDynamicPluginRunId, CordisDynamicRunMode } from './events.ts';
-type Block = ToolCallViewProps['block'];
+type Block = StartedToolCallViewProps['block'];
 /** Lifecycle of the tool call itself. */
 export type CordisToolState = 'running' | 'ok' | 'error' | 'stopped';
 /** Frozen `cordis_define` presentation data. */

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

@@ -3,6 +3,7 @@ export declare const NS = "cordis";
 /** Simplified Chinese Cordis UI messages. */
 export declare const zh: {
     'row.defineTitle': string;
+    'a11y.preparing': string;
     'row.runTitle': string;
     'row.updateTitle': string;
     'row.stopTitle': string;
@@ -64,6 +65,7 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
 /** English Cordis UI messages. */
 export declare const en: {
     'row.defineTitle': string;
+    'a11y.preparing': string;
     'row.runTitle': string;
     'row.updateTitle': string;
     'row.stopTitle': string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-cordis",
   "description": "Cordis dynamic-plugin definition card: the keyed cordis_define tool row with its run/stop switch",
-  "version": "0.1.7-alpha.2",
+  "version": "0.1.7-rc.2",
   "publishConfig": {
     "access": "public"
   },
@@ -47,18 +47,18 @@
   "devDependencies": {
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
-    "@deepseek-ai/dsh-client-connection": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-api-remotes": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-cordis-client-runner": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-session": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-client-ui-sidebar": "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-client-ui-tool": "0.1.7-alpha.2",
-    "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-client-ui-slots": "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-cordis-client-runner": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "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-client-ui-slots": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-tool": "0.1.7-rc.2",
+    "@deepseek-ai/cordis": "~4.0.4"
   },
   "files": [
     "lib/index.js",