dsh-watcher 0.4.3 → 0.5.1

package/lib/dsh-watcher.js

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import { createHash } from "node:crypto";
 //#region src/insights/engine.mjs
-/** Read-only DSH 0.1.5-rc.2 log fold. No prompt, reasoning or tool body is retained. */
+/** Read-only DSH 0.1.5-rc.3 log fold. No prompt, reasoning or tool body is retained. */
 const record = (v) => v !== null && typeof v === "object" && !Array.isArray(v);
 const count = (v) => Number.isSafeInteger(v) && v >= 0;
 const elapsed = (start, end) => start === null ? 0 : Math.max(0, end - start);
@@ -30,7 +30,7 @@ function emptyStats() {
 	};
 }
 function initialState(header = {}, inherited = 0) {
-	const s = {
+	return {
 		version: 1,
 		sessionId: String(header.id ?? ""),
 		skip: inherited,
@@ -49,8 +49,6 @@ function initialState(header = {}, inherited = 0) {
 		findings: [],
 		findingCount: 0
 	};
-	s.wire = buildView(s);
-	return s;
 }
 function normalizeUsage(value) {
 	if (!record(value) || !count(value.inputTokens) || !count(value.outputTokens)) return null;
@@ -244,7 +242,6 @@ function reduceEvent(state, event) {
 	if ((event.type === "assistant/attempt" || event.type === "assistant/message") && d.stream !== void 0 && !Array.isArray(d.stream)) return state;
 	if (event.type === "assistant/attempt" && (!state.open || state.open.turn !== d.turn || state.open.step !== d.step)) return state;
 	const s = structuredClone(state);
-	s.wire = state.wire;
 	s.seq = event.seq;
 	s.updatedAt = event.time;
 	if (event.type === "request/header") {
@@ -332,14 +329,14 @@ function reduceEvent(state, event) {
 				};
 				s.previousFailure = failure;
 				if (failure.seqs.length >= 3) {
-					const id = `repeat:${d.turn}:${failure.seqs[0]}`;
+					const id = `repeat:${d.turn}:${t.signature.slice(0, 16)}`;
 					const finding = {
 						id,
 						kind: "repeated-failure",
 						turn: d.turn,
 						seqs: failure.seqs,
 						steps: failure.steps,
-						title: `同一操作连续失败 ${failure.seqs.length} 次`,
+						title: `第 ${d.turn} 轮 · 同一操作连续失败 ${failure.seqs.length} 次`,
 						detail: "参数与错误结果指纹相同；这是重复失败证据，不是确定的空转或质量判决。"
 					};
 					const old = s.findings.findIndex((f) => f.id === id);
@@ -360,9 +357,9 @@ function reduceEvent(state, event) {
 		s.tools = [];
 		s.previousFailure = null;
 	}
-	s.wire = buildView(s);
 	return s;
 }
+const wireCache = /* @__PURE__ */ new WeakMap();
 function buildView(s) {
 	return {
 		version: s.version,
@@ -385,7 +382,12 @@ function buildView(s) {
 	};
 }
 function viewOf(s) {
-	return s.wire;
+	let wire = wireCache.get(s);
+	if (wire === void 0) {
+		wire = buildView(s);
+		wireCache.set(s, wire);
+	}
+	return wire;
 }
 //#endregion
 //#region src/insights/projection.ts
@@ -509,8 +511,7 @@ const stateSchema = z.object({
 		steps: z.array(number)
 	}).nullable(),
 	findings: z.array(finding).max(30),
-	findingCount: number,
-	wire: viewSchema
+	findingCount: number
 });
 function installProjection(ctx) {
 	ctx.sessionProjections.register({
@@ -528,8 +529,12 @@ function installProjection(ctx) {
 		try {
 			for (const session of c.sessions.list?.() ?? []) try {
 				c.sessionProjections.snapshot(session);
-			} catch {}
-		} catch {}
+			} catch (error) {
+				c.logger?.warn?.(`dsh-watcher: projection warm-up failed for a session: ${String(error)}`);
+			}
+		} catch (error) {
+			c.logger?.warn?.(`dsh-watcher: session warm-up skipped: ${String(error)}`);
+		}
 	});
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-watcher",
-  "version": "0.4.3",
+  "version": "0.5.1",
   "description": "Read-only DSH session insights and local model usage statistics",
   "type": "module",
   "main": "lib/dsh-watcher.js",
@@ -71,34 +71,35 @@
   "license": "MIT",
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-ui-chat": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-session": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-session-stats": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-session-projection": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-rc.1",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.2-rc.1"
+    "@deepseek-ai/dsh-api-remotes": "^0.1.5-rc.3",
+    "@deepseek-ai/dsh-client-ui-chat": "^0.1.5-rc.3",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-rc.3",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.3",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.3",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.5-rc.3",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-rc.3",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.3",
+    "@deepseek-ai/dsh-session": "^0.1.5-rc.3",
+    "@deepseek-ai/dsh-session-projection": "^0.1.5-rc.3",
+    "@deepseek-ai/dsh-session-stats": "^0.1.5-rc.3"
   },
   "dependencies": {
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-ui-chat": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-session": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-session": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-session-stats": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-session-projection": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-api-remotes": "0.1.2-rc.1",
+    "@deepseek-ai/cordis": "4.0.2",
+    "@deepseek-ai/dsh-api-remotes": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-client-ui-chat": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-client-ui-session": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-session": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-session-projection": "0.1.5-rc.3",
+    "@deepseek-ai/dsh-session-stats": "0.1.5-rc.3",
+    "@types/node": "^22.20.4",
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.0",
     "react": "^18.2.0",

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

@@ -1,18 +0,0 @@
-import type { InsightsView } from '../insights/projection.ts';
-type Evidence = {
-    turn: number;
-    steps: number[];
-    seqs: number[];
-};
-export declare function SessionInsights({ value, now, running, waiting, onEvidence }: {
-    value: InsightsView | undefined;
-    now: number;
-    running: boolean;
-    waiting: boolean;
-    onEvidence: (e: Evidence) => void;
-}): import("react").JSX.Element | null;
-export declare function InsightsSettings(props: {
-    remote?: any;
-}): import("react").JSX.Element;
-export {};
-//# sourceMappingURL=Insights.d.ts.map

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

@@ -1,7 +0,0 @@
-import type { InsightsView } from '../insights/projection.ts';
-export declare function TimingPanel({ stats, scope, tokensPerSecond, }: {
-    stats: InsightsView['totals'];
-    scope: 'turn' | 'session';
-    tokensPerSecond?: number | null;
-}): import("react").JSX.Element;
-//# sourceMappingURL=TimingPanel.d.ts.map

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

@@ -1,9 +0,0 @@
-import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
-import type { CompleteHistoryResult } from '../hub/history.ts';
-export interface WatcherInjected {
-    loadAllHistory: (signal: AbortSignal) => Promise<CompleteHistoryResult>;
-}
-export type WatcherProps = PropsRuntime<'conversation.session.header.utilities'> & WatcherInjected;
-/** Native session-header utility: exact work picture, typed evidence, no steering. */
-export declare function Watcher(props: WatcherProps): import("react").JSX.Element;
-//# sourceMappingURL=Watcher.d.ts.map

package/lib/types/client/disclosure-depth.d.ts

@@ -1,22 +0,0 @@
-export type DisclosureDepth = 'overview' | 'detail';
-export type DisclosureLayer = 'phase' | 'step' | 'cluster' | 'model' | 'reasoning';
-type LayerOverrides = Readonly<Record<DisclosureLayer, Readonly<Record<string, boolean>>>>;
-export interface DisclosureState {
-    readonly depth: DisclosureDepth;
-    readonly turns: Readonly<Record<number, boolean>>;
-    readonly layers: LayerOverrides;
-}
-export declare function createDisclosureState(depth?: DisclosureDepth): DisclosureState;
-/** Overview keeps the automatic Turn policy; detail opens every Turn by default. */
-export declare function turnDisclosureOpen(state: DisclosureState, turn: number, overviewDefaultOpen: boolean): boolean;
-/** Overview stops at phase headers; detail opens every nested level by default. */
-export declare function layerDisclosureOpen(state: DisclosureState, layer: DisclosureLayer, key: string): boolean;
-export declare function setLayerDisclosure(state: DisclosureState, layer: DisclosureLayer, key: string, open: boolean): DisclosureState;
-export declare function toggleTurnDisclosure(state: DisclosureState, turn: number, overviewDefaultOpen: boolean): DisclosureState;
-export declare function toggleLayerDisclosure(state: DisclosureState, layer: DisclosureLayer, key: string): DisclosureState;
-/** Choosing a depth applies it immediately instead of inheriting stale manual folds. */
-export declare function chooseDisclosureDepth(depth: DisclosureDepth): DisclosureState;
-/** Session-specific ids may change, while the user's chosen depth remains useful. */
-export declare function resetDisclosureOverrides(state: DisclosureState): DisclosureState;
-export {};
-//# sourceMappingURL=disclosure-depth.d.ts.map

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

@@ -1,9 +0,0 @@
-import type { Context as ClientContext } from '@deepseek-ai/cordis';
-export declare const name = "dsh-watcher-client";
-export declare const inject: string[];
-/**
- * Native session-header utility. Order 50 sits after Session log (0)
- * and before the files-panel toggle (110). No overlay glyph.
- */
-export declare function apply(ctx: ClientContext): void;
-//# sourceMappingURL=index.d.ts.map

package/lib/types/client/model-trace-definition.d.ts

@@ -1,11 +0,0 @@
-import type { Context as ClientContext } from '@deepseek-ai/cordis';
-import { type ModelStepTrace } from '../observation/model-trace.ts';
-declare module '@deepseek-ai/dsh-client-ui-conversation/client' {
-    interface ConversationStepDataMap {
-        /** Provider-exposed model activity retained for one Step. */
-        'dsh-watcher-model-stage': ModelStepTrace;
-    }
-}
-/** Register the Step-scoped, read-only model-stage projection. */
-export declare function registerModelTraceDefinition(ctx: ClientContext): void;
-//# sourceMappingURL=model-trace-definition.d.ts.map

package/lib/types/client/step-timeline.d.ts

@@ -1,15 +0,0 @@
-import type { WorkItem, WorkStep } from '../observation/fold.ts';
-import type { ModelStepTrace } from '../observation/model-trace.ts';
-type StepTimelineOccurrence = {
-    readonly kind: 'occurrence';
-    readonly item: WorkItem;
-    readonly occurrenceIndex: number;
-};
-export type StepTimelineEntry = StepTimelineOccurrence | {
-    readonly kind: 'model';
-    readonly trace: ModelStepTrace;
-};
-/** Compose the visible rows owned by one authoritative DSH Step. */
-export declare function stepTimelineEntries(step: Pick<WorkStep, 'items' | 'model'>): readonly StepTimelineEntry[];
-export {};
-//# sourceMappingURL=step-timeline.d.ts.map

package/lib/types/dsh-watcher.d.ts

@@ -1,6 +0,0 @@
-import type { Context } from '@deepseek-ai/cordis';
-export declare const name = "dsh-watcher";
-export declare const inject: string[];
-/** Host-owned replayable statistics; no new transport or model-facing writes. */
-export declare function apply(ctx: Context): void;
-//# sourceMappingURL=dsh-watcher.d.ts.map

package/lib/types/hub/aggregation.d.ts

@@ -1,40 +0,0 @@
-import type { WorkItem, WorkStatus } from '../observation/fold.ts';
-export type WorkClusterBasis = 'mutable-target' | 'shared-target' | 'exact-call' | 'single';
-export interface WorkStatusCounts {
-    running: number;
-    waiting: number;
-    success: number;
-    failure: number;
-    returned: number;
-    interrupted: number;
-    unknown: number;
-}
-export type NonEmptyWorkItems = readonly [WorkItem, ...WorkItem[]];
-/** A reversible analysis projection. `items` always retains the source records. */
-export interface WorkCluster {
-    id: string;
-    basis: WorkClusterBasis;
-    title: string;
-    items: NonEmptyWorkItems;
-    executionCount: number;
-    stepCount: number;
-    retryCount: number;
-    iterationCount: number;
-    latestStatus: WorkStatus;
-    statusCounts: Readonly<WorkStatusCounts>;
-}
-/**
- * Group one phase for analysis without changing evidence identity or order.
- *
- * - Mutable calls may group by operation + target so changed inputs remain
- *   comparable as iterations.
- * - Reads may group by one exact file target so different line windows stay
- *   comparable.
- * - Search, Glob, Grep, Bash, and every other tool require exact normalized
- *   arguments. Sharing a cwd, broad path, tool name, or translated title is
- *   never enough.
- * - Messages and otherwise unsigned records remain singletons.
- */
-export declare function clusterWorkItems(items: readonly WorkItem[]): readonly WorkCluster[];
-export declare function clusterOutcomeSummary(cluster: WorkCluster): string;
-//# sourceMappingURL=aggregation.d.ts.map

package/lib/types/hub/follow.d.ts

@@ -1,27 +0,0 @@
-import type { WorkPicture } from '../observation/fold.ts';
-export interface FollowSnapshot {
-    follow: boolean;
-    unread: number;
-    selectedId: string | null;
-}
-export interface RailScrollState {
-    atBottom: boolean;
-}
-/**
- * Follow versus pin state for the work rail.
- *
- * The rail follows the newest recorded occurrence by default. Selecting
- * history or scrolling away pins the viewport; later occurrences and result
- * updates increment `unread` without yanking the reader away from evidence.
- */
-export declare function createFollow(): {
-    snapshot: () => FollowSnapshot;
-    /** Counts appended occurrences or a settled live result while pinned. */
-    onPicture(picture: Pick<WorkPicture, "nodes">): FollowSnapshot;
-    onSelect(id: string): FollowSnapshot;
-    onScroll({ atBottom }: RailScrollState): FollowSnapshot;
-    setFollow(next: boolean): FollowSnapshot;
-    backToLatest(): FollowSnapshot;
-    reset(): FollowSnapshot;
-};
-//# sourceMappingURL=follow.d.ts.map

package/lib/types/hub/history.d.ts

@@ -1,30 +0,0 @@
-/** Minimal public facts needed to page one shared RC8 Session window. */
-export interface HistoryWindowState {
-    hasMore: boolean;
-    loadingOlder: boolean;
-    headKey: string;
-}
-export type CompleteHistoryResult = {
-    kind: 'complete';
-    pages: number;
-} | {
-    kind: 'cancelled';
-    pages: number;
-} | {
-    kind: 'blocked';
-    pages: number;
-    reason: 'busy' | 'no-progress' | 'page-limit';
-};
-export interface CompleteHistoryOptions {
-    read: () => HistoryWindowState;
-    loadOlder: () => Promise<void>;
-    signal: AbortSignal;
-    maxPages?: number;
-}
-/**
- * Pull every older RC8 page in order. The Session remains the sole owner of
- * history continuity; this helper only repeats its public, read-only paging
- * verb and fails closed if one request does not advance the visible head.
- */
-export declare function loadCompleteHistory({ read, loadOlder, signal, maxPages, }: CompleteHistoryOptions): Promise<CompleteHistoryResult>;
-//# sourceMappingURL=history.d.ts.map

package/lib/types/hub/overview.d.ts

@@ -1,10 +0,0 @@
-import type { WorkGroup, WorkStatus, WorkTurn } from '../observation/fold.ts';
-/** Overview progress is deliberately separate from execution evidence status. */
-export type OverviewState = 'active' | 'current' | 'waiting' | 'failure' | 'interrupted' | 'settled' | 'partial';
-export declare const OVERVIEW_STATE_LABEL: Readonly<Record<OverviewState, string>>;
-/** Project evidence status into the one question overview markers answer: where should the user look? */
-export declare function overviewStateOf(status: WorkStatus, isLatest: boolean): OverviewState;
-export declare function groupOverviewSummary(group: WorkGroup): string;
-export declare function turnOverviewSummary(turn: WorkTurn): string;
-export declare function turnNeedsDefaultDisclosure(state: OverviewState, isLatest: boolean): boolean;
-//# sourceMappingURL=overview.d.ts.map

package/lib/types/hub/watcher.d.ts

@@ -1,4 +0,0 @@
-/** Stable model entry for consumers that need Watcher's truthful work picture. */
-export { EMPTY_PICTURE, foldEvents, foldSnapshot, normalizedSignature, pairTools, parseJsonl, } from '../observation/fold.ts';
-export type { WorkGroup, WorkItem, WorkPhase, WorkPicture, WorkPresentation, WorkStatus, WorkStep, WorkTurn, } from '../observation/fold.ts';
-//# sourceMappingURL=watcher.d.ts.map