dsh-working-activity 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, chimney (ccch1mneyyy)
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -18,26 +18,37 @@ Two optional sinks, both off by default only when their seam is absent:
 
 ## Installation
 
+The package is a self-mounting bundle: it declares `dsh.bundle.patch`
+(`cordis.patch.yml`), so the official CLI both installs it and appends it to
+the profile's bundle layer stack:
+
+```sh
+dsh plugin --profile <profile> add dsh-working-activity
+```
+
+At boot, app-boot applies the bundle's patch list over the profile root and
+the package inserts its own `working-activity` row — no manual configuration
+required. To tune a value, override the row's config by id in the profile's
+user layer (`$DSH_HOME/profiles/<profile>/cordis.patch.yml`) instead of
+inserting a second same-id row:
+
 ```yaml
-# cordis.yml
-plugins:
-  - id: working-activity
-    name: 'dsh-working-activity'
+- id: working-activity
+  config:
+    publishIntervalMs: 500
 ```
 
 ## TUI usage
 
-Enable the plugin alongside `dsh-tui` and add the slot to the left prompt template:
+Install the plugin into a profile that composes the official `dsh-tui`, then
+add the `${activity}` slot to the left prompt template in the profile's user
+layer (`$DSH_HOME/profiles/<profile>/cordis.patch.yml`):
 
 ```yaml
-plugins:
-  - id: tui
-    name: '@deepseek-ai/dsh-tui'
-    config:
-      theme:
-        leftPrompt: '${cwd}${git/worktree}${activity}${model}${token_meter/cache_hit_rate}${context}'
-  - id: working-activity
-    name: 'dsh-working-activity'
+- id: tui
+  config:
+    theme:
+      leftPrompt: '${cwd}${git/worktree}${activity}${model}${token_meter/cache_hit_rate}${context}'
 ```
 
 While a turn runs, the prompt line shows e.g. `dsh main 跑个命令 npm test · 12s deepseek-chat …`; while thinking, `嗯…让我捋捋 · 总1m23s`; after the turn, `搞定 ✓ · 4 工具 · 想12s 干11s` briefly. Without `${activity}` in the template, the plugin is inert in the TUI (the slot is unregistered values are omitted by the template renderer).
@@ -57,7 +68,7 @@ Both fall back to the previous static label while the plugin is absent, so the W
 |---|---|---|---|
 | `phrases` | `boolean` | `true` | Playful copy pool; `false` renders plain functional labels |
 | `publish` | `boolean` | `true` | Append `activity/status` session events for UI consumers |
-| `tickMs` | `number` | `500` | Status render tick interval (50–5000) |
+| `tickMs` | `number` | `500` | Status render tick interval (100–5000) |
 | `publishIntervalMs` | `number` | `2000` | Minimum interval between published events while the line is stable (500–30000) |
 | `detailLimit` | `number` | `40` | Max displayed detail length (paths/commands/patterns), 8–120 |
 | `customActions` | `object` | `{}` | Exact tool-name → action-copy pools, e.g. `{"my_deploy": ["部署一下", "上线中"]}` |

package/cordis.patch.yml

@@ -0,0 +1,19 @@
+# dsh-working-activity bundle patch: mount the plugin itself into the
+# profile composition tree.
+#
+# `dsh plugin --profile <name> add dsh-working-activity` auto-initializes the
+# profile (first layer @deepseek-ai/dsh-base), pnpm-installs this package into
+# the profile, and the CLI's reconcile step appends it to the profile's
+# dsh.profile.bundles because this package.json declares `dsh.bundle.patch`.
+# At boot, app-boot applies every bundle's patch list in bundle order over the
+# empty root; this insert list is what actually mounts the working-activity
+# row — no manual configuration is needed.
+#
+# All row config stays at schema defaults (phrases/publish/tickMs/
+# publishIntervalMs/detailLimit/customActions/narrate). To tune a value (for
+# dsh-cc, set publishIntervalMs to 500), override this row's config by id in
+# the profile's own cordis.patch.yml user layer — do NOT insert a second
+# same-id row.
+- insert:
+    - id: working-activity
+      name: 'dsh-working-activity'

package/lib/client.js

@@ -0,0 +1,80 @@
+window.__ModuleLoader__.load({
+	id: "dsh-working-activity",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		let react_jsx_runtime = require("react/jsx-runtime");
+		//#region \0dsh-css:C:\Users\17481\AppData\Local\Temp\dshwa-scan\packages\activity\working-activity\src\client\WorkingLine.module.css.mjs
+		const css = ".GDqYEG_line{box-sizing:border-box;width:100%;max-width:var(--dsh-composer-card-max-width);font-family:var(--dsw-font-family);color:var(--dsw-alias-label-secondary);align-items:center;gap:8px;margin:0 auto;padding:4px 16px 0;font-size:13px;line-height:18px;display:flex}.GDqYEG_marker{background:var(--dsw-alias-label-tertiary);border-radius:50%;flex:none;width:7px;height:7px;animation:1.6s ease-in-out infinite GDqYEG_working-pulse}.GDqYEG_line[data-activity-phase=done] .GDqYEG_marker{background:var(--dsw-alias-state-business-primary);animation:none}.GDqYEG_line[data-activity-phase=tool] .GDqYEG_marker{background:var(--dsw-alias-state-business-primary)}.GDqYEG_line[data-activity-phase=waiting] .GDqYEG_marker{background:var(--dsw-alias-label-tertiary);opacity:.6}.GDqYEG_text{text-overflow:ellipsis;white-space:nowrap;overflow:hidden}.GDqYEG_tools{background:var(--dsw-alias-surface-tertiary);min-width:18px;color:var(--dsw-alias-label-secondary);text-align:center;border-radius:9px;flex:none;padding:0 5px;font-size:11px;line-height:18px}@keyframes GDqYEG_working-pulse{0%,to{opacity:1}50%{opacity:.35}}";
+		const tagId = "dsh-working-activity/WorkingLine.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "dsh-working-activity";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var WorkingLine_module_css_default = {
+			"line": "GDqYEG_line",
+			"working-pulse": "GDqYEG_working-pulse",
+			"tools": "GDqYEG_tools",
+			"text": "GDqYEG_text",
+			"marker": "GDqYEG_marker"
+		};
+		//#endregion
+		//#region src/client/WorkingLine.tsx
+		/** Tool-count badge copy (no locale seat: the line text itself is host-composed). */
+		const TOOLS_LABEL = "tools this turn";
+		/**
+		* Working-line dock entry: reads the latest activity snapshot off the
+		* conversation snapshot and renders the row, or nothing when idle/absent.
+		*/
+		function WorkingLine({ useSession }) {
+			const activity = useSession((s) => s.activity);
+			if (activity === null || activity.phase === "idle" || activity.line === "") return null;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				className: WorkingLine_module_css_default.line,
+				"data-activity-phase": activity.phase,
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: WorkingLine_module_css_default.marker,
+						"aria-hidden": "true"
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: WorkingLine_module_css_default.text,
+						children: activity.line
+					}),
+					activity.toolCount > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+						className: WorkingLine_module_css_default.tools,
+						title: `${activity.toolCount} ${TOOLS_LABEL}`,
+						children: activity.toolCount
+					})
+				]
+			});
+		}
+		//#endregion
+		//#region src/client/index.ts
+		/** Required services for the dock registration. */
+		const inject = ["slots"];
+		/**
+		* Client plugin body: the working-line dock entry.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			ctx.slots.inject("conversation.input.dock", () => ctx.slots.register({
+				name: "conversation.input.dock",
+				id: "activity",
+				order: 15,
+				registrant: "dsh-working-activity"
+			}, WorkingLine));
+		}
+		//#endregion
+		exports.WorkingLine = WorkingLine;
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","names":["css"],"sources":["../src/client/WorkingLine.tsx","../src/client/index.ts"],"sourcesContent":["// Working-line dock entry: one dim full-width row above the composer card\n// showing the live working-activity snapshot — phase-colored breathing\n// marker, the host-composed status line, and the turn's tool count badge.\n// Renders for every live phase (waiting/thinking/tool) and the done summary;\n// hides while idle or before the first publish.\n//\n// The 'conversation.input.dock' SlotMap declaration lives in\n// @deepseek-ai/dsh-client-ui-conversation/client (contract/slots.ts); this\n// entry contributes into it without owning it.\nimport type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots'\nimport css from './WorkingLine.module.css'\n\n/** Full props of the dock entry: the input-zone runtime share (session standard kit). */\nexport type WorkingLineProps = PropsRuntime<'conversation.input.dock'>\n\n/** Tool-count badge copy (no locale seat: the line text itself is host-composed). */\nconst TOOLS_LABEL = 'tools this turn'\n\n/**\n * Working-line dock entry: reads the latest activity snapshot off the\n * conversation snapshot and renders the row, or nothing when idle/absent.\n */\nexport function WorkingLine({ useSession }: WorkingLineProps) {\n  const activity = useSession(s => s.activity)\n  if (activity === null || activity.phase === 'idle' || activity.line === '') return null\n  return (\n    <div className={css.line} data-activity-phase={activity.phase}>\n      <span className={css.marker} aria-hidden=\"true\" />\n      <span className={css.text}>{activity.line}</span>\n      {activity.toolCount > 0 && (\n        <span className={css.tools} title={`${activity.toolCount} ${TOOLS_LABEL}`}>\n          {activity.toolCount}\n        </span>\n      )}\n    </div>\n  )\n}\n","/**\n * Working-activity surface plugin, browser half: the working-line entry in\n * the conversation.input.dock strip. This package's node half emits\n * `activity/status` session events; the web runtime patch narrows them into\n * the conversation snapshot's `activity` member, so this dock entry reads\n * the live frame through the standard session kit and owns no store, no\n * refresh chain, and no event listener.\n *\n * Mount contract (see the root README's \"Web UI 集成\" section): the web\n * client's client-modules host scans loader entries for `dsh.client`\n * declarations and serves this package's `./client` bundle at\n * /plugins/dsh-working-activity/client.js. The entry contributes into the\n * input dock — no official-source patch is involved.\n */\nimport type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'\n// Type-only: pulls the ui-conversation SlotMap merge (the input.dock entry)\n// through the Client assembly boundary.\nimport type {} from '@deepseek-ai/dsh-client-ui-conversation/client'\nimport { WorkingLine } from './WorkingLine.tsx'\nimport type { ActivityPhase, ActivitySnapshot } from './activity.ts'\n\nexport { WorkingLine, type WorkingLineProps } from './WorkingLine.tsx'\nexport type { ActivityPhase, ActivitySnapshot } from './activity.ts'\n\n/** Required services for the dock registration. */\nexport const inject = ['slots']\n\n/**\n * Client plugin body: the working-line dock entry.\n * @param ctx - client root context.\n */\nexport function apply(ctx: ClientContext): void {\n  ctx.slots.inject('conversation.input.dock', () => ctx.slots.register({\n    name: 'conversation.input.dock',\n    // The pre-slots patch used the same id in ui-conversation; entries with\n    // equal order render in registration order, and goal (10) / queue (20)\n    // keep their seats — this row sits between them.\n    id: 'activity',\n    order: 15,\n    registrant: 'dsh-working-activity',\n  }, WorkingLine))\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBA,MAAM,cAAc;;;;;EAMpB,SAAgB,YAAY,EAAE,cAAgC;GAC5D,MAAM,WAAW,YAAW,MAAK,EAAE,QAAQ;GAC3C,IAAI,aAAa,QAAQ,SAAS,UAAU,UAAU,SAAS,SAAS,IAAI,OAAO;GACnF,OACE,iBAAA,GAAA,kBAAA,KAAA,CAAC,OAAD;IAAK,WAAWA,+BAAI;IAAM,uBAAqB,SAAS;IAAxD,UAAA;KACE,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;MAAM,WAAWA,+BAAI;MAAQ,eAAY;KAAQ,CAAA;KACjD,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;MAAM,WAAWA,+BAAI;MAAO,UAAA,SAAS;KAAW,CAAA;KAC/C,SAAS,YAAY,KACpB,iBAAA,GAAA,kBAAA,IAAA,CAAC,QAAD;MAAM,WAAWA,+BAAI;MAAO,OAAO,GAAG,SAAS,UAAU,GAAG;MACzD,UAAA,SAAS;KACN,CAAA;IAEL;;EAET;;;;ECXA,MAAa,SAAS,CAAC,OAAO;;;;;EAM9B,SAAgB,MAAM,KAA0B;GAC9C,IAAI,MAAM,OAAO,iCAAiC,IAAI,MAAM,SAAS;IACnE,MAAM;IAIN,IAAI;IACJ,OAAO;IACP,YAAY;GACd,GAAG,WAAW,CAAC;EACjB"}

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

@@ -0,0 +1,9 @@
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+/** Full props of the dock entry: the input-zone runtime share (session standard kit). */
+export type WorkingLineProps = PropsRuntime<'conversation.input.dock'>;
+/**
+ * Working-line dock entry: reads the latest activity snapshot off the
+ * conversation snapshot and renders the row, or nothing when idle/absent.
+ */
+export declare function WorkingLine({ useSession }: WorkingLineProps): import("react").JSX.Element | null;
+//# sourceMappingURL=WorkingLine.d.ts.map

package/lib/types/client/WorkingLine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkingLine.d.ts","sourceRoot":"","sources":["../../../src/client/WorkingLine.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAGpE,yFAAyF;AACzF,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,yBAAyB,CAAC,CAAA;AAKtE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAAE,UAAU,EAAE,EAAE,gBAAgB,sCAc3D"}

package/lib/types/client/WorkingLine.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import css from './WorkingLine.module.css';
+/** Tool-count badge copy (no locale seat: the line text itself is host-composed). */
+const TOOLS_LABEL = 'tools this turn';
+/**
+ * Working-line dock entry: reads the latest activity snapshot off the
+ * conversation snapshot and renders the row, or nothing when idle/absent.
+ */
+export function WorkingLine({ useSession }) {
+    const activity = useSession(s => s.activity);
+    if (activity === null || activity.phase === 'idle' || activity.line === '')
+        return null;
+    return (_jsxs("div", { className: css.line, "data-activity-phase": activity.phase, children: [_jsx("span", { className: css.marker, "aria-hidden": "true" }), _jsx("span", { className: css.text, children: activity.line }), activity.toolCount > 0 && (_jsx("span", { className: css.tools, title: `${activity.toolCount} ${TOOLS_LABEL}`, children: activity.toolCount }))] }));
+}

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

@@ -0,0 +1,48 @@
+/**
+ * Client-side activity snapshot type + the ConversationSnapshot merge that
+ * carries it.
+ *
+ * The host half (@deepseek-ai/dsh-working-activity's node side) publishes
+ * `activity/status` session events; the web runtime patch (dsh-client-runtime
+ * activity field, shipping separately) narrows those frames into the
+ * conversation snapshot's `activity` member. Until that runtime release lands
+ * on npm, this module re-declares the field via declaration merging so the
+ * dock component type-checks against the published rc.6 types.
+ *
+ * REMOVE the `declare module` block below once
+ * `@deepseek-ai/dsh-client-runtime/client` ships `ConversationSnapshot.activity`
+ * natively (the runtime's own `ActivityStatusView` is structurally identical
+ * to {@link ActivitySnapshot}; the two then agree by construction).
+ * @module @deepseek-ai/dsh-working-activity/client/activity
+ */
+/** The `activity/status` phase vocabulary, mirroring the host's ActivityPhase. */
+export type ActivityPhase = 'idle' | 'waiting' | 'thinking' | 'tool' | 'done';
+/** One `activity/status` snapshot as rendered by the dock line. */
+export interface ActivitySnapshot {
+    /** Which activity phase the model is in right now. */
+    readonly phase: ActivityPhase;
+    /** Full human-readable status line (plain text, no ANSI). */
+    readonly line: string;
+    /** Short label of the current work (tool action or stage), when any. */
+    readonly label?: string;
+    /** Detail fragment (path / command / search pattern), when any. */
+    readonly detail?: string;
+    /** The playful phrase currently shown, when any. */
+    readonly phrase?: string;
+    /** Tools completed in the current turn. */
+    readonly toolCount: number;
+    /** Wall-clock milliseconds since the current turn started (0 when idle). */
+    readonly turnElapsedMs: number;
+    /** Wall-clock time the current phase started, for animations. */
+    readonly phaseStartedAt: number;
+}
+declare module '@deepseek-ai/dsh-client-runtime/client' {
+    interface ConversationSnapshot {
+        /**
+         * Latest validated `activity/status` snapshot (the working-activity
+         * plugin's live working line), or null before the first publish.
+         */
+        activity: ActivitySnapshot | null;
+    }
+}
+//# sourceMappingURL=activity.d.ts.map

package/lib/types/client/activity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activity.d.ts","sourceRoot":"","sources":["../../../src/client/activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,kFAAkF;AAClF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAA;AAE7E,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,mEAAmE;IACnE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,2CAA2C;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,4EAA4E;IAC5E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC;AAED,OAAO,QAAQ,wCAAwC,CAAC;IACtD,UAAU,oBAAoB;QAC5B;;;WAGG;QACH,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAA;KAClC;CACF"}

package/lib/types/client/activity.js

@@ -0,0 +1,18 @@
+/**
+ * Client-side activity snapshot type + the ConversationSnapshot merge that
+ * carries it.
+ *
+ * The host half (@deepseek-ai/dsh-working-activity's node side) publishes
+ * `activity/status` session events; the web runtime patch (dsh-client-runtime
+ * activity field, shipping separately) narrows those frames into the
+ * conversation snapshot's `activity` member. Until that runtime release lands
+ * on npm, this module re-declares the field via declaration merging so the
+ * dock component type-checks against the published rc.6 types.
+ *
+ * REMOVE the `declare module` block below once
+ * `@deepseek-ai/dsh-client-runtime/client` ships `ConversationSnapshot.activity`
+ * natively (the runtime's own `ActivityStatusView` is structurally identical
+ * to {@link ActivitySnapshot}; the two then agree by construction).
+ * @module @deepseek-ai/dsh-working-activity/client/activity
+ */
+export {};

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

@@ -0,0 +1,25 @@
+/**
+ * Working-activity surface plugin, browser half: the working-line entry in
+ * the conversation.input.dock strip. This package's node half emits
+ * `activity/status` session events; the web runtime patch narrows them into
+ * the conversation snapshot's `activity` member, so this dock entry reads
+ * the live frame through the standard session kit and owns no store, no
+ * refresh chain, and no event listener.
+ *
+ * Mount contract (see the root README's "Web UI 集成" section): the web
+ * client's client-modules host scans loader entries for `dsh.client`
+ * declarations and serves this package's `./client` bundle at
+ * /plugins/dsh-working-activity/client.js. The entry contributes into the
+ * input dock — no official-source patch is involved.
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+export { WorkingLine, type WorkingLineProps } from './WorkingLine.tsx';
+export type { ActivityPhase, ActivitySnapshot } from './activity.ts';
+/** Required services for the dock registration. */
+export declare const inject: string[];
+/**
+ * Client plugin body: the working-line dock entry.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAA;AAO3E,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACtE,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAEpE,mDAAmD;AACnD,eAAO,MAAM,MAAM,UAAY,CAAA;AAE/B;;;GAGG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAU9C"}

package/lib/types/client/index.js

@@ -0,0 +1,19 @@
+import { WorkingLine } from "./WorkingLine.js";
+export { WorkingLine } from "./WorkingLine.js";
+/** Required services for the dock registration. */
+export const inject = ['slots'];
+/**
+ * Client plugin body: the working-line dock entry.
+ * @param ctx - client root context.
+ */
+export function apply(ctx) {
+    ctx.slots.inject('conversation.input.dock', () => ctx.slots.register({
+        name: 'conversation.input.dock',
+        // The pre-slots patch used the same id in ui-conversation; entries with
+        // equal order render in registration order, and goal (10) / queue (20)
+        // keep their seats — this row sits between them.
+        id: 'activity',
+        order: 15,
+        registrant: 'dsh-working-activity',
+    }, WorkingLine));
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-working-activity",
   "description": "Live model working-status line: playful copy, running tool, turn elapsed — for TUI prompt and Web UI",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "main": "lib/types/index.js",
   "types": "lib/types/index.d.ts",
@@ -10,6 +10,10 @@
       "types": "./lib/types/index.d.ts",
       "default": "./lib/types/index.js"
     },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
     "./events": {
       "types": "./lib/types/events.d.ts",
       "default": "./lib/types/events.js"
@@ -22,20 +26,36 @@
       "types": "./lib/types/status.d.ts",
       "default": "./lib/types/status.js"
     },
+    "./cordis.patch.yml": "./cordis.patch.yml",
     "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
   "files": [
     "lib",
-    "src"
+    "src",
+    "cordis.patch.yml"
   ],
   "engines": {
     "node": "^22.19 || >=24"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json"
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.client.json",
+    "build:client": "tsdown -c tsdown.config.ts"
   },
   "license": "BSD-3-Clause",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-slots"
+      ]
+    }
+  },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1"
   },
@@ -44,7 +64,11 @@
     "@deepseek-ai/dsh-agent": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-session": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6"
+    "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
+    "react": "^18.2.0"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
@@ -55,7 +79,14 @@
     "@deepseek-ai/dsh-llm": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-session": "^0.1.0-rc.6",
     "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
     "@types/node": "^22.0.0",
+    "@types/react": "~18.3.1",
+    "lightningcss": "^1.32.0",
+    "react": "^18.2.0",
+    "tsdown": "^0.22.2",
     "typescript": "^6.0.3"
   }
 }

package/src/client/WorkingLine.module.css

@@ -0,0 +1,74 @@
+/* Working line row: one dim line with a phase-colored breathing marker and
+   the turn's tool-count badge, sized to the composer dock inset like the
+   queue strip. Mirrors the pre-slots patch's WorkingLine visuals, re-targeted
+   at the rc.6 design tokens. */
+
+.line {
+  box-sizing: border-box;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  width: 100%;
+  max-width: var(--dsh-composer-card-max-width);
+  margin: 0 auto;
+  padding: 4px 16px 0;
+  font-family: var(--dsw-font-family);
+  font-size: 13px;
+  line-height: 18px;
+  color: var(--dsw-alias-label-secondary);
+}
+
+.marker {
+  flex: none;
+  width: 7px;
+  height: 7px;
+  border-radius: 50%;
+  background: var(--dsw-alias-label-tertiary);
+  animation: working-pulse 1.6s ease-in-out infinite;
+}
+
+/* The model's turn is done: steady marker in the brand tone, no pulse. */
+.line[data-activity-phase='done'] .marker {
+  background: var(--dsw-alias-state-business-primary);
+  animation: none;
+}
+
+/* A tool is actually executing: brand-tone pulse. */
+.line[data-activity-phase='tool'] .marker {
+  background: var(--dsw-alias-state-business-primary);
+}
+
+/* Waiting for the first token: muted pulse. */
+.line[data-activity-phase='waiting'] .marker {
+  background: var(--dsw-alias-label-tertiary);
+  opacity: 0.6;
+}
+
+.text {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.tools {
+  flex: none;
+  min-width: 18px;
+  padding: 0 5px;
+  border-radius: 9px;
+  background: var(--dsw-alias-surface-tertiary);
+  color: var(--dsw-alias-label-secondary);
+  font-size: 11px;
+  line-height: 18px;
+  text-align: center;
+}
+
+@keyframes working-pulse {
+  0%,
+  100% {
+    opacity: 1;
+  }
+
+  50% {
+    opacity: 0.35;
+  }
+}

package/src/client/WorkingLine.tsx

@@ -0,0 +1,37 @@
+// Working-line dock entry: one dim full-width row above the composer card
+// showing the live working-activity snapshot — phase-colored breathing
+// marker, the host-composed status line, and the turn's tool count badge.
+// Renders for every live phase (waiting/thinking/tool) and the done summary;
+// hides while idle or before the first publish.
+//
+// The 'conversation.input.dock' SlotMap declaration lives in
+// @deepseek-ai/dsh-client-ui-conversation/client (contract/slots.ts); this
+// entry contributes into it without owning it.
+import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots'
+import css from './WorkingLine.module.css'
+
+/** Full props of the dock entry: the input-zone runtime share (session standard kit). */
+export type WorkingLineProps = PropsRuntime<'conversation.input.dock'>
+
+/** Tool-count badge copy (no locale seat: the line text itself is host-composed). */
+const TOOLS_LABEL = 'tools this turn'
+
+/**
+ * Working-line dock entry: reads the latest activity snapshot off the
+ * conversation snapshot and renders the row, or nothing when idle/absent.
+ */
+export function WorkingLine({ useSession }: WorkingLineProps) {
+  const activity = useSession(s => s.activity)
+  if (activity === null || activity.phase === 'idle' || activity.line === '') return null
+  return (
+    <div className={css.line} data-activity-phase={activity.phase}>
+      <span className={css.marker} aria-hidden="true" />
+      <span className={css.text}>{activity.line}</span>
+      {activity.toolCount > 0 && (
+        <span className={css.tools} title={`${activity.toolCount} ${TOOLS_LABEL}`}>
+          {activity.toolCount}
+        </span>
+      )}
+    </div>
+  )
+}

package/src/client/activity.ts

@@ -0,0 +1,50 @@
+/**
+ * Client-side activity snapshot type + the ConversationSnapshot merge that
+ * carries it.
+ *
+ * The host half (@deepseek-ai/dsh-working-activity's node side) publishes
+ * `activity/status` session events; the web runtime patch (dsh-client-runtime
+ * activity field, shipping separately) narrows those frames into the
+ * conversation snapshot's `activity` member. Until that runtime release lands
+ * on npm, this module re-declares the field via declaration merging so the
+ * dock component type-checks against the published rc.6 types.
+ *
+ * REMOVE the `declare module` block below once
+ * `@deepseek-ai/dsh-client-runtime/client` ships `ConversationSnapshot.activity`
+ * natively (the runtime's own `ActivityStatusView` is structurally identical
+ * to {@link ActivitySnapshot}; the two then agree by construction).
+ * @module @deepseek-ai/dsh-working-activity/client/activity
+ */
+
+/** The `activity/status` phase vocabulary, mirroring the host's ActivityPhase. */
+export type ActivityPhase = 'idle' | 'waiting' | 'thinking' | 'tool' | 'done'
+
+/** One `activity/status` snapshot as rendered by the dock line. */
+export interface ActivitySnapshot {
+  /** Which activity phase the model is in right now. */
+  readonly phase: ActivityPhase
+  /** Full human-readable status line (plain text, no ANSI). */
+  readonly line: string
+  /** Short label of the current work (tool action or stage), when any. */
+  readonly label?: string
+  /** Detail fragment (path / command / search pattern), when any. */
+  readonly detail?: string
+  /** The playful phrase currently shown, when any. */
+  readonly phrase?: string
+  /** Tools completed in the current turn. */
+  readonly toolCount: number
+  /** Wall-clock milliseconds since the current turn started (0 when idle). */
+  readonly turnElapsedMs: number
+  /** Wall-clock time the current phase started, for animations. */
+  readonly phaseStartedAt: number
+}
+
+declare module '@deepseek-ai/dsh-client-runtime/client' {
+  interface ConversationSnapshot {
+    /**
+     * Latest validated `activity/status` snapshot (the working-activity
+     * plugin's live working line), or null before the first publish.
+     */
+    activity: ActivitySnapshot | null
+  }
+}

package/src/client/css-modules.d.ts

@@ -0,0 +1,6 @@
+/* CSS Modules ambient declaration for the client half (tsc only; the tsdown
+   bundle inlines compiled class maps). */
+declare module '*.module.css' {
+  const classes: Readonly<Record<string, string>>
+  export default classes
+}

package/src/client/index.ts

@@ -0,0 +1,42 @@
+/**
+ * Working-activity surface plugin, browser half: the working-line entry in
+ * the conversation.input.dock strip. This package's node half emits
+ * `activity/status` session events; the web runtime patch narrows them into
+ * the conversation snapshot's `activity` member, so this dock entry reads
+ * the live frame through the standard session kit and owns no store, no
+ * refresh chain, and no event listener.
+ *
+ * Mount contract (see the root README's "Web UI 集成" section): the web
+ * client's client-modules host scans loader entries for `dsh.client`
+ * declarations and serves this package's `./client` bundle at
+ * /plugins/dsh-working-activity/client.js. The entry contributes into the
+ * input dock — no official-source patch is involved.
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+// Type-only: pulls the ui-conversation SlotMap merge (the input.dock entry)
+// through the Client assembly boundary.
+import type {} from '@deepseek-ai/dsh-client-ui-conversation/client'
+import { WorkingLine } from './WorkingLine.tsx'
+import type { ActivityPhase, ActivitySnapshot } from './activity.ts'
+
+export { WorkingLine, type WorkingLineProps } from './WorkingLine.tsx'
+export type { ActivityPhase, ActivitySnapshot } from './activity.ts'
+
+/** Required services for the dock registration. */
+export const inject = ['slots']
+
+/**
+ * Client plugin body: the working-line dock entry.
+ * @param ctx - client root context.
+ */
+export function apply(ctx: ClientContext): void {
+  ctx.slots.inject('conversation.input.dock', () => ctx.slots.register({
+    name: 'conversation.input.dock',
+    // The pre-slots patch used the same id in ui-conversation; entries with
+    // equal order render in registration order, and goal (10) / queue (20)
+    // keep their seats — this row sits between them.
+    id: 'activity',
+    order: 15,
+    registrant: 'dsh-working-activity',
+  }, WorkingLine))
+}