dsh-working-activity 0.2.0 → 0.2.2

package/package.json

@@ -1,92 +1,106 @@
-{
-  "name": "dsh-working-activity",
-  "description": "Live model working-status line: playful copy, running tool, turn elapsed — for TUI prompt and Web UI",
-  "version": "0.2.0",
-  "type": "module",
-  "main": "lib/types/index.js",
-  "types": "lib/types/index.d.ts",
-  "exports": {
-    ".": {
-      "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"
-    },
-    "./invariant": {
-      "types": "./lib/types/invariant.d.ts",
-      "default": "./lib/types/invariant.js"
-    },
-    "./status": {
-      "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",
-    "cordis.patch.yml"
-  ],
-  "engines": {
-    "node": "^22.19 || >=24"
-  },
-  "scripts": {
-    "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"
-  },
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@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-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",
-    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-agent-loop": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
-    "@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"
-  }
-}
+{
+  "name": "dsh-working-activity",
+  "description": "Live model working-status line: playful copy, running tool, turn elapsed — for TUI prompt and Web UI",
+  "version": "0.2.2",
+  "type": "module",
+  "main": "lib/types/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "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"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/types/invariant.js"
+    },
+    "./status": {
+      "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",
+    "cordis.patch.yml"
+  ],
+  "engines": {
+    "node": "^22.19 || >=24"
+  },
+  "scripts": {
+    "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"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@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-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",
+    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-agent-loop": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-agent-loop-testkit": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@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"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/dsh-client-runtime": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-conversation": {
+      "optional": true
+    },
+    "@deepseek-ai/dsh-client-ui-slots": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  }
+}

package/src/client/WorkingLine.module.css

@@ -1,74 +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;
-  }
-}
+/* 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

@@ -1,37 +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>
-  )
-}
+// 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

@@ -1,50 +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
-  }
-}
+/**
+ * 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

@@ -1,6 +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
-}
+/* 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

@@ -1,42 +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))
-}
+/**
+ * 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))
+}