@robiteame/dsh-client-ui-session-tree 0.1.0

package/lib/index.js

@@ -0,0 +1,6 @@
+// packages/client/ui-session-tree/src/index.ts
+function apply() {
+}
+export {
+  apply
+};

package/lib/invariant.js

@@ -0,0 +1,12 @@
+// packages/client/ui-session-tree/src/invariant.ts
+var PACKAGE_NAME = "@robiteame/dsh-client-ui-session-tree";
+var name = "client-ui-session-tree-invariant";
+var inject = ["invariants"];
+var install = () => {
+};
+var apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+export {
+  apply,
+  inject,
+  name
+};

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

@@ -0,0 +1,39 @@
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { JumpView, SessionTreeView } from '@robiteame/dsh-pi-agent-session-tree/client';
+export interface SessionTreeOverlayState {
+    open: boolean;
+    nativePanel: boolean;
+}
+/** Minimal external store shared by the command listener and the React drawer. */
+export declare class SessionTreeOverlayController {
+    private state;
+    private readonly listeners;
+    readonly getSnapshot: () => SessionTreeOverlayState;
+    readonly subscribe: (listener: () => void) => (() => void);
+    open(): void;
+    close(): void;
+    setNativePanel(nativePanel: boolean): void;
+    dispose(): void;
+    private update;
+}
+export interface SessionTreeRemoteActions {
+    load(sessionId: SessionId): Promise<SessionTreeView>;
+    jump(sessionId: SessionId, nodeId: string | null): Promise<JumpView>;
+    fork(sessionId: SessionId, nodeId: string, branch: string): Promise<{
+        cursor: string;
+        branch: string;
+        forkCount: number;
+    }>;
+    onRefresh(sessionId: SessionId, callback: () => void): () => void;
+}
+export type SessionTreeOverlayProps = PropsRuntime<'shell.overlay'> & PropsLocale<'session-tree'> & {
+    controller: SessionTreeOverlayController;
+    remoteActions: SessionTreeRemoteActions;
+};
+/**
+ * Render an additive right-side drawer without replacing Harness' Tool details
+ * occupant. The root stays mounted as a browser-visible activation marker;
+ * only the drawer opts back into pointer events.
+ */
+export declare function SessionTreeOverlay({ controller, remoteActions, useSessions, t, }: SessionTreeOverlayProps): import("react").JSX.Element;

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

@@ -0,0 +1,4 @@
+import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SessionTreeViewProps } from './slots.ts';
+export declare function SessionTreePanel({ closeDetails, sessionId, load, jump, select, fork, onRefresh, t }: SessionTreeViewProps & PropsLocale<'session-tree'>): import("react").JSX.Element;
+export declare function SessionTreeDock(props: SessionTreeViewProps & PropsLocale<'session-tree'>): import("react").JSX.Element;

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

@@ -0,0 +1,24 @@
+/** Browser half of the session-tree extension: a right-details-sidebar panel. */
+import type { Context as ClientContext } from '@deepseek-ai/cordis';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { CommandResult } from '@deepseek-ai/dsh-commands/types';
+declare module '@deepseek-ai/cordis' {
+    interface Events {
+        'command/executed'(sessionId: SessionId, name: string, result: CommandResult): void;
+    }
+}
+import type { SessionTreeView } from '@robiteame/dsh-pi-agent-session-tree/client';
+import { type SessionTreeKey } from './locales.ts';
+export { SessionTreePanel, SessionTreeDock } from './SessionTreePanel.tsx';
+export { SessionTreeOverlay, SessionTreeOverlayController } from './SessionTreeOverlay.tsx';
+export type { SessionTreeOverlayProps, SessionTreeOverlayState } from './SessionTreeOverlay.tsx';
+export type { SessionTreePanelActions, SessionTreeViewProps } from './slots.ts';
+export type { SessionTreeKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        'session-tree': SessionTreeKey;
+    }
+}
+export declare const inject: string[];
+export declare function apply(ctx: ClientContext): Promise<() => Promise<void>>;
+export type LoadedSessionTreeView = SessionTreeView;

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

@@ -0,0 +1,51 @@
+/** `session-tree` namespace dictionaries. */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'panel.title': string;
+    'panel.open': string;
+    'panel.close': string;
+    'panel.empty': string;
+    'panel.error': string;
+    'panel.branch': string;
+    'panel.nodes': string;
+    'panel.cursor': string;
+    'panel.selectedHint': string;
+    'panel.select': string;
+    'panel.jump': string;
+    'panel.jump.failed': string;
+    'panel.refresh': string;
+    'panel.head': string;
+    'panel.fork': string;
+    'node.role.system': string;
+    'node.role.user': string;
+    'node.role.assistant': string;
+    'node.role.tool': string;
+    'node.summary': string;
+    'node.noMessage': string;
+};
+/** The session-tree namespace key union. */
+export type SessionTreeKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'panel.title': string;
+    'panel.open': string;
+    'panel.close': string;
+    'panel.empty': string;
+    'panel.error': string;
+    'panel.branch': string;
+    'panel.nodes': string;
+    'panel.cursor': string;
+    'panel.selectedHint': string;
+    'panel.select': string;
+    'panel.jump': string;
+    'panel.jump.failed': string;
+    'panel.refresh': string;
+    'panel.head': string;
+    'panel.fork': string;
+    'node.role.system': string;
+    'node.role.user': string;
+    'node.role.assistant': string;
+    'node.role.tool': string;
+    'node.summary': string;
+    'node.noMessage': string;
+};

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

@@ -0,0 +1,23 @@
+/** Session tree's injected face for the right details-sidebar panel seat. */
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { JumpView, SessionTreeView } from '@robiteame/dsh-pi-agent-session-tree/client';
+export interface SessionTreePanelActions {
+    load: (sessionId: SessionId) => Promise<SessionTreeView>;
+    jump: (nodeId: string | null) => Promise<JumpView>;
+    select?: (nodeId: string) => Promise<{
+        nodeId: string;
+    }>;
+    fork: (nodeId: string, branch: string) => Promise<{
+        cursor: string;
+        branch: string;
+        forkCount: number;
+    }>;
+    onRefresh?: (callback: () => void) => () => void;
+}
+/** Props the visual tree actually consumes, independent of its slot adapter. */
+export type SessionTreeViewProps = SessionTreePanelActions & {
+    sessionId: SessionId;
+    panel?: string;
+    closeDetails?: () => void;
+    t: (key: import('./locales.ts').SessionTreeKey) => string;
+};

package/lib/types/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Session-tree panel plugin, node half. Pure UI plugin: the empty apply exists
+ * so the plugin appears in the host cordis.yml / Loader; the browser half
+ * ships via exports["./client"], discovered through the package.json
+ * dsh.client declaration.
+ */
+/** Host plugin body — no host-side behavior for this surface plugin. */
+export declare function apply(): void;

package/lib/types/invariant.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Package-owned invariant companion for `@robiteame/dsh-client-ui-session-tree`.
+ * @module @robiteame/dsh-client-ui-session-tree/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-session-tree-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@robiteame/dsh-client-ui-session-tree",
+  "description": "Session-tree WebUI panel: a native right-details-sidebar dock on patched Harness and an additive right-side overlay on official builds",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/robiteame/dsh-session-tree-extension.git",
+    "directory": "packages/client/ui-session-tree"
+  },
+  "bugs": {
+    "url": "https://github.com/robiteame/dsh-session-tree-extension/issues"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-chat",
+        "@deepseek-ai/dsh-client-ui-layout"
+      ],
+      "platform": "web"
+    }
+  },
+  "scripts": {
+    "build": "node ../../../scripts/build.mjs ui",
+    "watch": "node ../../../scripts/build.mjs ui"
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.2"
+  },
+  "devDependencies": {
+    "@robiteame/dsh-pi-agent-session-tree": "^0.1.0",
+    "@testing-library/dom": "^10.0.0",
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=22"
+  }
+}