dsh-working-activity 0.2.3 → 0.2.5

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))
+}

package/src/events.ts

@@ -1,45 +1,45 @@
-/**
- * `activity/status` session event — a log-only, non-surface snapshot of the
- * model's current working activity, published by this plugin for any UI
- * consumer (Web client, telemetry, …). It never enters derived model history
- * (no `surfaceOp`), so it cannot leak into prompts; UIs render it like
- * `todo/write` or `plan/mode`.
- * @module @deepseek-ai/dsh-working-activity/events
- */
-
-import type { ActivityPhase } from './status.js'
-
-/** Durable payload of one `activity/status` snapshot. */
-export interface ActivityStatusEvent {
-  /** Which activity phase the model is in. */
-  readonly phase: ActivityPhase
-  /** Human-readable status line (plain text, no ANSI). */
-  readonly line: string
-  /** Short label of the current work, when any. */
-  readonly label?: string
-  /** Detail fragment (path / command / pattern), when any. */
-  readonly detail?: string
-  /** The playful phrase currently shown, when the copy pool is on. */
-  readonly phrase?: string
-  /** Tools completed in the current turn. */
-  readonly toolCount: number
-  /** Milliseconds since the current turn started (0 when idle). */
-  readonly turnElapsedMs: number
-  /** Wall-clock time (epoch ms) the current phase started, for animations. */
-  readonly phaseStartedAt: number
-}
-
-/** The `activity/status` phase vocabulary, exported for wire consumers. */
-export type { ActivityPhase }
-
-declare module '@deepseek-ai/dsh-session/types' {
-  interface SessionEventMap {
-    /**
-     * Log-only UI snapshot of the model's working activity (thinking copy,
-     * running tool, turn elapsed). Never a surface event: UIs render it, the
-     * model never sees it.
-     * @param data - The rendered status snapshot.
-     */
-    'activity/status': ActivityStatusEvent
-  }
-}
+/**
+ * `activity/status` session event — a log-only, non-surface snapshot of the
+ * model's current working activity, published by this plugin for any UI
+ * consumer (Web client, telemetry, …). It never enters derived model history
+ * (no `surfaceOp`), so it cannot leak into prompts; UIs render it like
+ * `todo/write` or `plan/mode`.
+ * @module @deepseek-ai/dsh-working-activity/events
+ */
+
+import type { ActivityPhase } from './status.js'
+
+/** Durable payload of one `activity/status` snapshot. */
+export interface ActivityStatusEvent {
+  /** Which activity phase the model is in. */
+  readonly phase: ActivityPhase
+  /** Human-readable status line (plain text, no ANSI). */
+  readonly line: string
+  /** Short label of the current work, when any. */
+  readonly label?: string
+  /** Detail fragment (path / command / pattern), when any. */
+  readonly detail?: string
+  /** The playful phrase currently shown, when the copy pool is on. */
+  readonly phrase?: string
+  /** Tools completed in the current turn. */
+  readonly toolCount: number
+  /** Milliseconds since the current turn started (0 when idle). */
+  readonly turnElapsedMs: number
+  /** Wall-clock time (epoch ms) the current phase started, for animations. */
+  readonly phaseStartedAt: number
+}
+
+/** The `activity/status` phase vocabulary, exported for wire consumers. */
+export type { ActivityPhase }
+
+declare module '@deepseek-ai/dsh-session/types' {
+  interface SessionEventMap {
+    /**
+     * Log-only UI snapshot of the model's working activity (thinking copy,
+     * running tool, turn elapsed). Never a surface event: UIs render it, the
+     * model never sees it.
+     * @param data - The rendered status snapshot.
+     */
+    'activity/status': ActivityStatusEvent
+  }
+}