@deepseek-ai/dsh-experimental-session-inspector 0.2.1-alpha.1

package/lib/index.js

@@ -0,0 +1,6 @@
+//#region lib/types/index.js
+/** Host discovery entry for the Session Inspector browser plugin. */
+/** Mount the inert Host half; Session inspection belongs to the Client. */
+function apply() {}
+//#endregion
+export { apply };

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

@@ -0,0 +1,10 @@
+/** Browser plugin contributing the Session Inspector Log sidebar tab. */
+import type { Context } from '@deepseek-ai/cordis';
+/** Services required to register the localized Session-bound sidebar tab. */
+export declare const inject: string[];
+/**
+ * Register the Inspector tab for this plugin's lifetime.
+ * @param ctx - Client plugin context owning the dictionaries and registrations.
+ */
+export declare function apply(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,69 @@
+/** Session Inspector tab, table controls, and object navigation labels. */
+/** Namespace owned by the Session Inspector plugin. */
+export declare const NS = "session-inspector";
+/** Simplified Chinese labels and dictionary keys. */
+export declare const zh: {
+    readonly 'tab.title': "会话数据诊断";
+    readonly 'tab.description': "在侧边栏分析当前会话原始日志和聊天分组数据";
+    readonly 'view.presentation': "展示形式";
+    readonly 'view.sessionLog': "原始数据";
+    readonly 'view.chatNode': "对话分组";
+    readonly 'picker.pick': "在对话面板中选取元素";
+    readonly 'picker.cancel': "取消选取 (Esc)";
+    readonly 'picker.instructions': "在左侧 Chat 中悬停预览，点击选取；Esc 取消。";
+    readonly 'picker.noMatch': "当前表格没有匹配记录，请选择其他元素或按 Esc 取消。";
+    readonly 'picker.noChat': "请先在主区域打开当前 Session 的 Chat。";
+    readonly 'table.id': "序号";
+    readonly 'table.type': "类型";
+    readonly 'filter.title': "筛选类型";
+    readonly 'filter.input': "类型关键词";
+    readonly 'filter.placeholder': "输入类型片段，如 delta";
+    readonly 'filter.help': "默认包含匹配（*关键词*）；Enter 确认，Esc 取消。";
+    readonly 'filter.candidates': "类型候选";
+    readonly 'filter.loading': "正在查找候选…";
+    readonly 'filter.failed': "无法获取类型候选。";
+    readonly 'filter.noCandidates': "没有匹配候选，仍可确认当前关键词。";
+    readonly 'filter.clear': "清空";
+    readonly 'filter.cancel': "取消";
+    readonly 'filter.apply': "确认筛选";
+    readonly 'filter.context': "匹配记录的父级上下文";
+    readonly 'table.location': "T/S";
+    readonly 'table.time': "时间 (UTC)";
+    readonly 'table.data': "数据";
+    readonly 'table.older': "加载更早";
+    readonly 'table.loading': "加载中…";
+    readonly 'table.latest': "跟踪最新";
+    readonly 'table.empty': "暂无记录";
+    readonly 'table.raw': "原始数据";
+    readonly 'table.rawError': "无法序列化这条记录，可以选择其他记录继续查看。";
+    readonly 'table.resizeDetails': "调整原始数据面板高度";
+    readonly 'table.close': "关闭";
+    readonly 'table.expand': "展开子行";
+    readonly 'table.collapse': "收起子行";
+    readonly 'table.removed': "该记录已移除或结算，请选择当前记录。";
+    readonly 'object.node': "Node";
+    readonly 'object.nodeData': "Node Data";
+    readonly 'object.group': "Group";
+    readonly 'object.groupData': "Group Data";
+    readonly 'object.turn': "Turn";
+    readonly 'object.turnData': "Turn Data";
+    readonly 'object.step': "Step";
+    readonly 'object.stepData': "Step Data";
+    readonly 'object.accessor': "[Getter / Setter，未执行]";
+    readonly 'object.empty': "空";
+    readonly 'object.absent': "[空槽]";
+    readonly 'object.properties': "其他属性";
+    readonly 'object.more': "显示更多";
+    readonly 'object.navigation': "原始数据导航";
+};
+/** Dictionary keys accepted by this plugin's translator. */
+export type SessionInspectorKey = keyof typeof zh;
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Session Inspector tab and table labels. */
+        'session-inspector': SessionInspectorKey;
+    }
+}
+/** English labels, checked against the Chinese key set. */
+export declare const en: Record<SessionInspectorKey, string>;
+//# sourceMappingURL=locales.d.ts.map

package/lib/types/client/views/InspectorDetails.d.ts

@@ -0,0 +1,17 @@
+/** Locally resizable raw-data panel; pointer capture owns the drag lifetime. */
+import { type ReactNode } from 'react';
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+/** Raw text and owner callbacks for one Inspector's detail panel. */
+export type InspectorDetailsProps = PropsLocale<'session-inspector'> & {
+    readonly text: string;
+    readonly failed?: boolean;
+    readonly children?: ReactNode;
+    readonly close: () => void;
+};
+/**
+ * Resize the raw-data area from its upper edge while keeping the table visible.
+ * @param props - Complete raw text, localized labels, and close callback.
+ * @returns Detail text with a pointer- and keyboard-operated horizontal separator.
+ */
+export declare function InspectorDetails({ text, failed, children, close, t }: InspectorDetailsProps): import("react").JSX.Element;
+//# sourceMappingURL=InspectorDetails.d.ts.map

package/lib/types/client/views/InspectorObjectTree.d.ts

@@ -0,0 +1,26 @@
+/** Shared value rendering for JSON details and lazy runtime objects with identity links. */
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { InspectorObjects, InspectorObjectReference } from './objects.ts';
+/** Original value and Session-local reference navigation. */
+export type InspectorObjectTreeProps = PropsLocale<'session-inspector'> & {
+    readonly value: unknown;
+    readonly objects: InspectorObjects;
+    readonly navigate: (reference: InspectorObjectReference) => void;
+};
+/**
+ * Display serialized Inspector JSON with every container initially expanded and no reference navigation.
+ * @param props - Successful inspectorJson output and localized tree labels; empty text represents undefined.
+ * @returns The same value tree as Chat details, without collection paging or runtime-object links.
+ */
+export declare function InspectorJsonTree({ text, t }: PropsLocale<'session-inspector'> & {
+    readonly text: string;
+}): import("react").JSX.Element;
+/**
+ * Inspect the root and nested Node Data inline; other registered objects remain navigation links.
+ * Node Data titles also navigate, while repeated ancestors never expand recursively.
+ * Expanded fields are cached until their value or Conversation publication changes.
+ * @param props - Original object, weak identity lookup, locale, and reference activation.
+ * @returns A lazily expanded, typed tree that retains Map keys and collection identities.
+ */
+export declare function InspectorObjectTree(props: InspectorObjectTreeProps): import("react").JSX.Element;
+//# sourceMappingURL=InspectorObjectTree.d.ts.map

package/lib/types/client/views/InspectorTable.d.ts

@@ -0,0 +1,43 @@
+/** Virtualized raw-data table shared by Session log and Chat structure views. */
+import { type ReactNode } from 'react';
+import type { ConvViewProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-store';
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import { type InspectorRecord, type InspectorRow } from './table-model.ts';
+import type { InspectorChatTarget, InspectorObjects } from './objects.ts';
+/** Framework-bound row sources and Session pagination command. */
+export interface InspectorInjected {
+    readonly hooks: {
+        readonly rows: ObservableSnapshot<readonly InspectorRow[]>;
+    };
+    readonly keyedHooks: {
+        readonly record: (key: string) => ObservableSnapshot<InspectorRecord | undefined> | undefined;
+    };
+    /** Load the preceding page through the existing Session reference. */
+    readonly loadOlder: () => Promise<void>;
+    /** @param key - Loaded row identity. @returns Current type without mounting a row subscription. */
+    readonly typeOf: (key: string) => string | undefined;
+}
+/** Inputs of either Inspector conversation view. */
+export type InspectorTableProps = Pick<ConvViewProps, 'useSession'> & InjectFace<InspectorInjected> & PropsLocale<'session-inspector'> & {
+    readonly title: string;
+    readonly flash: boolean;
+    readonly showTime: boolean;
+    readonly modeSelector?: ReactNode;
+    readonly objects?: InspectorObjects;
+    readonly navigation?: {
+        readonly reveal: (target: InspectorChatTarget) => void;
+        readonly target: (key: string) => InspectorChatTarget | undefined;
+    };
+    readonly pickedRow?: {
+        readonly key: string;
+    } | undefined;
+    readonly notice?: string | undefined;
+};
+/**
+ * Render a paged hierarchy with stable virtual row keys and live JSON details.
+ * @param props - Framework hooks, pagination, locale, and the view's highlight policy.
+ * @returns Virtual table and selected raw data.
+ */
+export declare function InspectorTable({ title, flash, showTime, modeSelector, objects, navigation, pickedRow, notice, useRows, useRecord, useSession, loadOlder, typeOf, t }: InspectorTableProps): import("react").JSX.Element;
+//# sourceMappingURL=InspectorTable.d.ts.map

package/lib/types/client/views/TypeFilter.d.ts

@@ -0,0 +1,15 @@
+/** Anchored type-filter editor with asynchronous suggestions and explicit confirmation. */
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+/** Current confirmed query and an asynchronous candidate source. */
+export type InspectorTypeFilterProps = PropsLocale<'session-inspector'> & {
+    readonly value: string;
+    readonly suggest: (query: string) => Promise<readonly string[]>;
+    readonly apply: (query: string) => void;
+};
+/**
+ * Edit a type fragment without filtering until Enter, Apply, or a candidate is selected.
+ * @param props - Confirmed query, candidate resolver, commit callback, and localized copy.
+ * @returns A header button and its portaled editor; stale responses cannot replace newer suggestions.
+ */
+export declare function TypeFilter({ value, suggest, apply, t }: InspectorTypeFilterProps): import("react").JSX.Element;
+//# sourceMappingURL=TypeFilter.d.ts.map

package/lib/types/client/views/View.d.ts

@@ -0,0 +1,42 @@
+/** One Sidebar Inspector with locally selected Chat and Session-log presentations. */
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { InspectorInjected } from './InspectorTable.tsx';
+import type { InspectorObjects, InspectorChatTarget } from './objects.ts';
+import type { InspectorPickTarget } from './chat-node/pick-match.ts';
+/** Local Inspector presentations; these are not separate Conversation View registrations. */
+export type InspectorPresentation = 'chat-node' | 'session-log';
+/** Both sources remain lazy: only the selected table subscribes. */
+export interface SessionInspectorInjected {
+    /** @returns This Session's displayed main Chat column, or undefined without one. */
+    readonly chatRoot: () => HTMLElement | undefined;
+    /**
+     * @param owner - Visible picker button.
+     * @param picked - True accepts the target; false keeps picking.
+     * @param cancelled - Clear panel state when the gesture is cancelled or replaced.
+     * @returns Silent cleanup, or undefined if the plugin is disposed or Chat is unavailable.
+     */
+    readonly pickChat: (owner: HTMLElement, picked: (target: InspectorPickTarget) => boolean, cancelled: () => void) => (() => void) | undefined;
+    /** @param target - Log or object coordinates. @returns Exact and nearby loaded Chat identities. */
+    readonly resolveChatTargets: (target: InspectorChatTarget) => readonly InspectorChatTarget[];
+    readonly hooks: {
+        readonly chatRows: InspectorInjected['hooks']['rows'];
+        readonly logRows: InspectorInjected['hooks']['rows'];
+    };
+    readonly keyedHooks: {
+        readonly chatRecord: InspectorInjected['keyedHooks']['record'];
+        readonly logRecord: InspectorInjected['keyedHooks']['record'];
+    };
+    readonly loadOlder: InspectorInjected['loadOlder'];
+    readonly objects: InspectorObjects;
+    /** @param key - Row identity. @param mode - Current table. @returns Current raw type for filtering. */
+    readonly recordType: (key: string, mode: InspectorPresentation) => string | undefined;
+    /** @param key - Selected log row. @returns Its exact or approximate placement in the main Chat. */
+    readonly logChatTarget: (key: string) => InspectorChatTarget | undefined;
+    /** @param target - Picked Chat identity. @param mode - Current table. @returns Its closest loaded row, when available. */
+    readonly pickRow: (target: InspectorPickTarget, mode: InspectorPresentation) => string | undefined;
+}
+/** Sidebar Session source and Inspector-owned actions and data. */
+export type SessionInspectorProps = Pick<PropsRuntime<'sidebar.right.pane.tab'>, 'useSession'> & InjectFace<SessionInspectorInjected> & PropsLocale<'session-inspector'>;
+/** @param props - Session-bound sources. @returns One Inspector with an in-toolbar presentation selector. */
+export declare function SessionInspectorView(props: SessionInspectorProps): import("react").JSX.Element;
+//# sourceMappingURL=View.d.ts.map

package/lib/types/client/views/chat-node/dom.d.ts

@@ -0,0 +1,28 @@
+/** DOM lookups owned by the experimental Inspector, using existing Slot and Chat attributes. */
+import type { InspectorChatTarget } from '../objects.ts';
+/**
+ * Check an existing element's mounted and ancestor visibility without revealing it.
+ * @param element - Candidate element.
+ * @returns Whether CSS and hidden ancestors allow it to be displayed.
+ */
+export declare function displayed(element: HTMLElement): boolean;
+/**
+ * Find the displayed main Chat's outer flow column without entering a Sidebar or nested View.
+ * @returns The current Chat column, or undefined while another View is selected.
+ */
+export declare function mainChatRoot(): HTMLElement | undefined;
+/**
+ * Restrict a DOM match to the selected Chat column and its own Conversation View.
+ * @param element - Candidate node, including SVG children.
+ * @param root - Main Chat column.
+ * @returns Whether the candidate belongs to that occurrence.
+ */
+export declare function inChat(element: Element, root: HTMLElement): boolean;
+/**
+ * Enumerate exact and approximate occurrences without changing their display state.
+ * @param root - Current main Chat column.
+ * @param targets - Exact identities followed by nearby loaded Node identities.
+ * @returns Unique candidates, with the requested Turn's occurrences before other Turns.
+ */
+export declare function findChatTargets(root: HTMLElement, targets: readonly InspectorChatTarget[]): readonly HTMLElement[];
+//# sourceMappingURL=dom.d.ts.map

package/lib/types/client/views/chat-node/highlight.d.ts

@@ -0,0 +1,20 @@
+/** Clipping geometry for the Inspector's element-picker overlay outside the Chat subtree. */
+/**
+ * Intersect a Chat box with its scrollports and the transcript area above the composer.
+ * @param element - Existing Chat Node, call, or Group box.
+ * @returns The visible rectangle, or undefined when the target is outside the conversation viewport.
+ */
+export declare function visibleChatRect(element: HTMLElement): {
+    readonly left: number;
+    readonly top: number;
+    readonly width: number;
+    readonly height: number;
+} | undefined;
+/**
+ * Place an Inspector overlay without changing the Chat content box.
+ * @param overlay - Inspector-owned fixed-position element.
+ * @param element - Existing Chat Node, call, or Group box.
+ * @returns Whether any part of the target remains visible after clipping.
+ */
+export declare function placeChatHighlight(overlay: HTMLElement, element: HTMLElement): boolean;
+//# sourceMappingURL=highlight.d.ts.map

package/lib/types/client/views/chat-node/model.d.ts

@@ -0,0 +1,52 @@
+/** Chat table order follows root references and group membership, independently of row data. */
+import type { ConversationBinding } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import { type ObservableSnapshot } from '@deepseek-ai/dsh-client-store';
+import { type InspectorRecord, type InspectorRow } from '../table-model.ts';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { InspectorObjects } from '../objects.ts';
+import { type InspectorPickTarget } from './pick-match.ts';
+/** Observes structural Chat changes while visible rows observe their own Node or Group. */
+export declare class ChatNodeModel implements ObservableSnapshot<readonly InspectorRow[]> {
+    private readonly binding;
+    private readonly rows;
+    private readonly sources;
+    private readonly groups;
+    private entries;
+    private order;
+    private keys;
+    private anchors;
+    private nodeStore;
+    private grouped;
+    private subscribers;
+    private disconnect;
+    private queued;
+    private readonly targets;
+    private readonly objectIndex;
+    /** @param binding - Existing target-neutral Conversation binding for the inspected Session. */
+    constructor(binding: ConversationBinding);
+    /**
+     * Bind object references and publication updates to the inspected Session.
+     * @param sessionId - Session displayed by this model.
+     * @returns Weak object lookup and row navigation for its details.
+     */
+    objects(sessionId: SessionId): InspectorObjects;
+    /** @returns Stable flattened group/node order. */
+    getSnapshot: () => readonly InspectorRow[];
+    /**
+     * Match a picked Chat object against the current table, including folded children.
+     * @param target - Picked Chat identities.
+     * @returns Closest current Node or Group row, or undefined without a match.
+     */
+    pick(target: InspectorPickTarget): string | undefined;
+    /** @param listener - Structural invalidation callback. @returns Its disposer. */
+    subscribe: (listener: () => void) => (() => void);
+    /**
+     * Read a loaded row without adding a subscription.
+     * @param key - Stable table position.
+     * @returns Cached Node or Group metadata source, or undefined outside the loaded rows.
+     */
+    row: (key: string) => ObservableSnapshot<InspectorRecord | undefined> | undefined;
+    private refresh;
+    private schedule;
+}
+//# sourceMappingURL=model.d.ts.map

package/lib/types/client/views/chat-node/objects.d.ts

@@ -0,0 +1,24 @@
+/** Weak identity index for materialized Nodes, Groups, Turn/Step locations, and their Data readers. */
+import type { ConversationBinding } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { InspectorObjectReference } from '../objects.ts';
+type Reference = Omit<InspectorObjectReference, 'rowKey'>;
+/** Indexes each immutable publication once, without retaining its objects or node arrays. */
+export declare class ChatObjectIndex {
+    private readonly binding;
+    private readonly identities;
+    private readonly indexed;
+    /** @param binding - Existing Session-owned Conversation reader. */
+    constructor(binding: ConversationBinding);
+    /**
+     * Resolve an original object without retaining replaced publications.
+     * @param value - Original object identity.
+     * @returns Its named reference, including older identities, or undefined when unregistered.
+     */
+    reference(value: object): Reference | undefined;
+    private chat;
+    private register;
+    private location;
+    private refresh;
+}
+export {};
+//# sourceMappingURL=objects.d.ts.map

package/lib/types/client/views/chat-node/pick-match.d.ts

@@ -0,0 +1,27 @@
+/** Replaceable element-to-record matching rules for the Inspector's Chat picker. */
+import type { InspectorChatTarget } from '../objects.ts';
+/** Chat identities enriched with the Node's loaded log coordinates before row lookup. */
+export interface InspectorPickTarget extends InspectorChatTarget {
+    readonly anchorSeq?: number;
+    readonly nodeKind?: string;
+}
+/** A visible Chat box and its most specific available identity. */
+export interface InspectorElementMatch {
+    readonly element: HTMLElement;
+    readonly target: InspectorPickTarget;
+}
+/**
+ * Match tool-call boxes and Node parts before Group or Turn containers; never compare rendered text.
+ * @param element - Pointer target in the main Chat.
+ * @param root - Inspected Session's displayed main Chat column.
+ * @returns Candidate identities and the box to preview, or undefined outside matching content.
+ */
+export declare function matchChatElement(element: Element, root: HTMLElement): InspectorElementMatch | undefined;
+/**
+ * Prefer an exact Node part, then its Node, Group, Step, or Turn table row.
+ * @param target - Picked identities.
+ * @param rows - Current row identities, including members of folded Inspector groups.
+ * @returns The closest materialized table row, or undefined when none matches.
+ */
+export declare function matchChatNodeRow(target: InspectorPickTarget, rows: ReadonlyMap<string, InspectorChatTarget>): string | undefined;
+//# sourceMappingURL=pick-match.d.ts.map

package/lib/types/client/views/chat-node/picker.d.ts

@@ -0,0 +1,43 @@
+/** One-shot Inspector picking through a real click-catching mask over the main Chat. */
+import { type InspectorPickTarget } from './pick-match.ts';
+/** Owns the mask, preview, and geometry observers for one picking gesture. */
+export declare class InspectorChatPicker {
+    private readonly getRoot;
+    private readonly owner;
+    private readonly picked;
+    private readonly cancelled;
+    private readonly released;
+    private mask;
+    private overlay;
+    private root;
+    private observing;
+    private resizing;
+    /**
+     * @param getRoot - Current Session's displayed main Chat.
+     * @param owner - Inspector button; hiding or removing it cancels picking.
+     * @param picked - True completes selection; false keeps the mask for another pick.
+     * @param cancelled - Clear the owning panel's picking state.
+     * @param released - Forget this gesture after its DOM resources are released.
+     */
+    constructor(getRoot: () => HTMLElement | undefined, owner: HTMLElement, picked: (target: InspectorPickTarget) => boolean, cancelled: () => void, released: () => void);
+    /**
+     * Begin picking in the visible main Chat.
+     * @returns Whether a visible Chat was found and its mask installed.
+     */
+    start(): boolean;
+    /** Remove the mask and observers without calling panel callbacks during unmount. */
+    dispose(): void;
+    private currentRoot;
+    private readonly position;
+    private readonly verify;
+    private hit;
+    private readonly hide;
+    /** Stop the gesture and clear its owning panel's picking state. */
+    readonly cancel: () => void;
+    private readonly move;
+    private readonly suppress;
+    private readonly click;
+    private readonly wheel;
+    private readonly keydown;
+}
+//# sourceMappingURL=picker.d.ts.map

package/lib/types/client/views/chat-node/reveal-target.d.ts

@@ -0,0 +1,14 @@
+/** Precise and nearby Chat reveal candidates from the Inspector's loaded Chat snapshot. */
+import type { InspectorChatTarget } from '../objects.ts';
+import type { ChatConversationViewNode } from '@deepseek-ai/dsh-client-ui-chat/client';
+/**
+ * Preserve the primary identity or tool/exact/kind/nearest placement, then rank visible neighbors.
+ * Explicit-node primaries include missing model coordinates, even when the node is hidden.
+ * Request coordinates take precedence over the node's position.
+ * Without a known anchor sequence, only the original target is returned.
+ * @param target - Object identity or original event coordinates supplied by another View.
+ * @param nodes - Current Session's loaded Chat nodes; equal-distance candidates retain input order.
+ * @returns Primary target followed by distinct Step, Turn, and Session neighbors with only node coordinates.
+ */
+export declare function resolveChatRevealTargets(target: InspectorChatTarget, nodes: readonly ChatConversationViewNode[]): readonly InspectorChatTarget[];
+//# sourceMappingURL=reveal-target.d.ts.map

package/lib/types/client/views/chat-node/reveal.d.ts

@@ -0,0 +1,25 @@
+/** Inspector-owned DOM reveal and native scrolling, without a Conversation request channel. */
+import type { InspectorChatTarget } from '../objects.ts';
+/** Owns one deferred reveal and body-level flash, without modifying Chat content nodes. */
+export declare class InspectorChatRevealer {
+    private readonly getRoot;
+    private frame;
+    private overlay;
+    private animation;
+    private cancelScroll;
+    /** @param getRoot - Current Session's main Chat, or undefined when it is not displayed. */
+    constructor(getRoot: () => HTMLElement | undefined);
+    /**
+     * Reveal the first usable occurrence, falling back to the displayed Chat column.
+     * Hidden or empty candidates do not prevent nearby content from being highlighted.
+     * The highlight waits for scrolling to settle; reduced-motion mode scrolls immediately without a flash.
+     * @param targets - Exact and approximate Node, Group, or Turn identities in preference order.
+     */
+    reveal(targets: readonly InspectorChatTarget[]): void;
+    /** Cancel pending native scrolling and remove the Inspector-owned overlay. */
+    dispose(): void;
+    private queueFlash;
+    private smoothScroll;
+    private flash;
+}
+//# sourceMappingURL=reveal.d.ts.map

package/lib/types/client/views/format.d.ts

@@ -0,0 +1,11 @@
+/** Type-specific horizontal previews without changing raw inspector data. */
+/** Maximum text length of a horizontal row preview. */
+export declare const INSPECTOR_PREVIEW_LIMIT = 240;
+/**
+ * Format horizontal data with type-specific delta fields and bounded nesting.
+ * @param value - Original row data, which remains unchanged for JSON inspection.
+ * @param hiddenRootFields - Additional top-level metadata already displayed in the owning table's columns.
+ * @returns A bounded preview omitting type, sequence, top-level time, and singleton field names.
+ */
+export declare function inspectorPreview(value: unknown, hiddenRootFields?: readonly string[]): string;
+//# sourceMappingURL=format.d.ts.map

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

@@ -0,0 +1,8 @@
+/** Session-scoped Sidebar tab backed by the existing Chat and Session-log models. */
+import type { Context } from '@deepseek-ai/cordis';
+/**
+ * Register the Session Inspector Sidebar page and its Session-scoped sources.
+ * @param ctx - Client plugin context owning the tab registration and Session-bound model cache.
+ */
+export declare function registerInspectorTab(ctx: Context): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/client/views/object-value.d.ts

@@ -0,0 +1,28 @@
+/** Shallow, typed runtime-object inspection without JSON conversion or implicit getter calls. */
+/** One original field or collection entry, evaluated only when its parent is expanded. */
+export interface InspectorObjectEntry {
+    readonly key: string;
+    readonly name: string;
+    readonly value: unknown;
+    readonly accessor?: boolean;
+    /** An array slot without an own property, distinct from an explicit undefined value. */
+    readonly absent?: boolean;
+    /** Synthetic disclosure for non-index collection properties. */
+    readonly properties?: boolean;
+}
+/** Display of one value; child enumeration never recursively visits child values. */
+export declare class InspectorObjectValue {
+    private readonly value;
+    /** Shallow type or scalar preview; no child getters are evaluated. */
+    readonly label: string;
+    /** Whether this value permits child enumeration rather than opaque scalar display. */
+    readonly expandable: boolean;
+    /** @param value - Original runtime value, including Maps, Sets, and class instances. */
+    constructor(value: unknown);
+    /**
+     * Enumerate one level without evaluating accessors or descending into children.
+     * @returns Original children; Map keys remain values rather than being coerced to property names.
+     */
+    entries(): IterableIterator<InspectorObjectEntry>;
+}
+//# sourceMappingURL=object-value.d.ts.map

package/lib/types/client/views/objects.d.ts

@@ -0,0 +1,39 @@
+/** Session-local object references used by the Chat Inspector's detail tree. */
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-store';
+/**
+ * Inspector-owned coordinates read from DOM attributes or Chat's string-keyed snapshots.
+ * Registry access resolves these strings against current branded references; a DOM value is not itself a validated registry ID.
+ */
+export interface InspectorChatTarget {
+    readonly anchorSeq?: number;
+    readonly callId?: string;
+    readonly rootCallId?: string;
+    readonly nodeKey?: string;
+    readonly nodeKind?: string;
+    readonly groupKey?: string;
+    readonly groupPart?: string;
+    readonly turn?: number;
+    readonly step?: number;
+}
+/** A named object whose current value can be inspected independently. */
+export interface InspectorObjectReference {
+    readonly id: string;
+    readonly kind: 'node' | 'nodeData' | 'group' | 'groupData' | 'turn' | 'turnData' | 'step' | 'stepData';
+    readonly identity: string;
+    readonly target: InspectorChatTarget;
+    readonly rowKey?: string;
+    /** @returns Latest loaded value, or undefined after removal. */
+    readonly read: () => unknown;
+}
+/** Object-identity lookup for one inspected Session. */
+export interface InspectorObjects {
+    readonly sessionId: SessionId;
+    /** Conversation publications invalidate cached fields of identity-stable Data readers. */
+    readonly updates: ObservableSnapshot<object>;
+    /** @param value - An original runtime object. @returns Its named reference, when indexed. */
+    readonly reference: (value: object) => InspectorObjectReference | undefined;
+    /** @param key - Inspector table row. @returns Its reference and exact Chat group part. */
+    readonly row: (key: string) => InspectorObjectReference | undefined;
+}
+//# sourceMappingURL=objects.d.ts.map

package/lib/types/client/views/raw-json.d.ts

@@ -0,0 +1,11 @@
+/** JSON inspection of live objects, including cyclic Location stores. */
+/**
+ * Serialize raw details without allowing a formatting failure to retire the View.
+ * @param value - Original record; Maps/Sets become objects/arrays and bigint becomes an n-suffixed string.
+ * @returns JSON with circular references marked, or an error message for the detail panel.
+ */
+export declare function inspectorJson(value: unknown): {
+    readonly text: string;
+    readonly failed: boolean;
+};
+//# sourceMappingURL=raw-json.d.ts.map

package/lib/types/client/views/session-log/chat-target.d.ts

@@ -0,0 +1,16 @@
+/** Original log coordinates submitted for target-owned Chat reveal. */
+import type { SessionEventLike } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { StreamChunk } from '@deepseek-ai/dsh-llm';
+import type { InspectorChatTarget } from '../objects.ts';
+/** Original owning event and, for an Assistant child row, its selected stream chunk. */
+export interface SessionLogAnchor {
+    readonly event: SessionEventLike;
+    readonly chunk?: StreamChunk;
+}
+/**
+ * Describe a log record without reading another View's model or DOM.
+ * @param anchor - Original log event and optional selected delta.
+ * @returns Original event coordinates and any tool-call or Assistant-part identity.
+ */
+export declare function sessionLogChatTarget(anchor: SessionLogAnchor): InspectorChatTarget;
+//# sourceMappingURL=chat-target.d.ts.map

package/lib/types/client/views/session-log/groups.d.ts

@@ -0,0 +1,18 @@
+/** Turn and Step start/end ranges add ancestry without inventing or reordering log records. */
+import type { SessionEventLike } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { InspectorRow } from '../table-model.ts';
+/** One ordered pass over the loaded log; missing starts do not create synthetic headers. */
+export declare class SessionLogGroups {
+    private turn;
+    private step;
+    /**
+     * Place a record inside its open Step or Turn, retaining end records as the final children.
+     * Turn and Step headers remain expanded after their end; manual folding stays table-local.
+     * @param row - Ungrouped event row.
+     * @param event - Original event.
+     * @returns The same row identity with range ancestry and depth.
+     */
+    append(row: InspectorRow, event: SessionEventLike): InspectorRow;
+    private child;
+}
+//# sourceMappingURL=groups.d.ts.map