dsh-side-chat-plus 0.3.3 → 0.3.4

package/lib/index.js

@@ -20,7 +20,8 @@ const SUBCHAT_PREFS_DEFAULTS = {
 	lookupDefault: false,
 	sendImmediately: true,
 	defaultPrompt: "",
-	bringMode: "draft"
+	bringMode: "draft",
+	panelHome: "sidebar-right"
 };
 //#endregion
 //#region src/trust-fence.ts
@@ -268,12 +269,21 @@ function openTurnStart(events) {
 	if (lastEnd !== void 0 && lastEnd >= lastStart) return void 0;
 	return lastStart;
 }
+/**
+* Read a session's event log across DSH versions: 0.1.5+ exposes
+* `snapshotEvents()`; 0.1.2-era sessions carried a plain `events` getter.
+*/
+function sessionEvents(session) {
+	if (typeof session.snapshotEvents === "function") return session.snapshotEvents();
+	return session.events ?? [];
+}
 /** Schemastery schema for the user-facing preferences (validated by the settings service). */
 const PrefsSchema = z.object({
 	lookupDefault: z.boolean().default(SUBCHAT_PREFS_DEFAULTS.lookupDefault),
 	sendImmediately: z.boolean().default(SUBCHAT_PREFS_DEFAULTS.sendImmediately),
 	defaultPrompt: z.string().default(SUBCHAT_PREFS_DEFAULTS.defaultPrompt),
-	bringMode: z.union(["draft", "context"]).default(SUBCHAT_PREFS_DEFAULTS.bringMode)
+	bringMode: z.union(["draft", "context"]).default(SUBCHAT_PREFS_DEFAULTS.bringMode),
+	panelHome: z.union(["floating", "sidebar-right"]).default(SUBCHAT_PREFS_DEFAULTS.panelHome)
 });
 /** The API method table bound to the plugin context and the live side-chat map. */
 function buildApi(ctx, sideChats, getSettings) {
@@ -387,12 +397,12 @@ function buildApi(ctx, sideChats, getSettings) {
 		const childId = requireString(payload, "childId");
 		const line = requireString(payload, "line");
 		const child = childOf(childId);
-		return { executed: await ctx.commands.execute(child, line, new AbortController().signal) !== void 0 };
+		return { executed: await ctx.commands.execute(child, line, [], new AbortController().signal) !== void 0 };
 	};
 	/** Fold one side-chat agent's plan/goal state for its composer chrome. */
 	const state = (payload) => {
 		const childId = requireString(payload, "childId");
-		const events = childOf(childId).session.events ?? [];
+		const events = sessionEvents(childOf(childId).session);
 		let planActive = false;
 		let planWanted = null;
 		let goal = null;
@@ -482,7 +492,7 @@ function buildApi(ctx, sideChats, getSettings) {
 		});
 		try {
 			const explicitPreset = typeof record.preset === "string" && record.preset !== "" ? record.preset : void 0;
-			const parentPreset = ctx.permissionPresets.current(parent.session.events ?? []);
+			const parentPreset = ctx.permissionPresets.current(parent.session);
 			const preset = explicitPreset ?? parentPreset;
 			if (preset !== "custom") ctx.permissionPresets.set(handle.agent.session, preset);
 		} catch (error) {
@@ -522,7 +532,7 @@ function buildApi(ctx, sideChats, getSettings) {
 			const agent = record.handle.agent;
 			const status = agent.status;
 			const statusRunning = status === "running";
-			const eventRunningSince = openTurnStart(agent.session.events ?? []);
+			const eventRunningSince = openTurnStart(sessionEvents(agent.session));
 			const running = statusRunning || status === void 0 && eventRunningSince !== void 0;
 			const runningSince = running ? eventRunningSince ?? Date.now() : void 0;
 			items.push({

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

@@ -66,6 +66,15 @@ export declare const zh: {
     'settings.bringModeDraftDesc': string;
     'settings.bringModeContextTitle': string;
     'settings.bringModeContextDesc': string;
+    'settings.panelHomeTitle': string;
+    'settings.panelHomeDesc': string;
+    'settings.panelHomeFloatingTitle': string;
+    'settings.panelHomeFloatingDesc': string;
+    'settings.panelHomeDockTitle': string;
+    'settings.panelHomeDockDesc': string;
+    'dock.title': string;
+    'dock.unavailable': string;
+    'dock.openFailed': string;
     'insert.direct': string;
     'insert.summarize': string;
     'insert.summarizing': string;
@@ -152,6 +161,15 @@ export declare const en: {
     'settings.bringModeDraftDesc': string;
     'settings.bringModeContextTitle': string;
     'settings.bringModeContextDesc': string;
+    'settings.panelHomeTitle': string;
+    'settings.panelHomeDesc': string;
+    'settings.panelHomeFloatingTitle': string;
+    'settings.panelHomeFloatingDesc': string;
+    'settings.panelHomeDockTitle': string;
+    'settings.panelHomeDockDesc': string;
+    'dock.title': string;
+    'dock.unavailable': string;
+    'dock.openFailed': string;
     'insert.direct': string;
     'insert.summarize': string;
     'insert.summarizing': string;

package/lib/types/context-types.d.ts

@@ -42,7 +42,13 @@ export interface SideSessionEvent {
 export interface SideSession {
     id: string;
     header: SideSessionHeader;
+    /**
+     * 0.1.2-era event getter. Removed in 0.1.5 (snapshotEvents takes over), so
+     * host code reads through `sessionEvents()` which prefers the new method.
+     */
     events?: readonly SideSessionEvent[];
+    /** 0.1.5+ snapshot of the full event log; absent on 0.1.2-era sessions. */
+    snapshotEvents?: (fromSeq?: number, toSeqExclusive?: number) => readonly SideSessionEvent[];
     requestHeader?: () => {
         config?: {
             provider?: string;
@@ -204,9 +210,9 @@ export interface SidePresetOption {
     name: string;
     description?: string;
 }
-/** The permission presets face. */
+/** The permission presets face (`current` reads the SESSION, not event rows). */
 export interface SidePermissionPresets {
-    current(events: readonly SideSessionEvent[]): string;
+    current(session: SideSession): string;
     set(session: SideSession, name: string): void;
     selectFor(state: unknown): {
         options: SidePresetOption[];
@@ -299,9 +305,35 @@ export interface SideSettingsService {
 }
 /** The client slots service face (settings.section registration). */
 export interface SideSlotsService {
-    inject(name: string, factory: () => () => void): void;
+    inject(name: string, factory: () => () => void): () => void;
     register(options: Record<string, unknown>, component: unknown): () => void;
 }
+/** One right-sidebar tab type definition (dsh-client-ui-sidebar-right contract, mirror). */
+export interface SideTabDefinition {
+    /** Stable unique key; the body seat entry registers under the same key. */
+    id: string;
+    /** Discriminator used by `openTab(kind)` and the pane dispatch. */
+    kind: string;
+    /** Registry band ('builtin' | 'extension' | 'fallback'); defaults to the extension band. */
+    priority?: string;
+    /** Fresh title for the tab chip captured at open time. */
+    title(address: string): string;
+}
+/** The right-sidebar tab-type registry face (`ctx.sidebarRight.tabs`). */
+export interface SideSidebarRightTabs {
+    /** Register a tab type; returns a disposer (hold it in the caller's ctx.effect). */
+    register(definition: SideTabDefinition): () => void;
+}
+/** The cross-plugin right-sidebar face (`ctx.sidebarRight`, ui-sidebar-right). */
+export interface SideSidebarRight {
+    tabs: SideSidebarRightTabs;
+    /** Open a page type by kind in the mounted session; reveals the column. */
+    openTab(kind: string, options?: {
+        paneId?: string;
+        replaceTab?: boolean;
+        revealIfOpened?: boolean;
+    }): void;
+}
 /** One durable image reference (mirror of ImageAttachmentRef). */
 export interface SideImageAttachmentRef {
     attachmentId: string;
@@ -341,7 +373,7 @@ export interface SideCommandsService {
         name: string;
         description: string;
     }>;
-    execute(agent: SideAgent, line: string, signal: AbortSignal): Promise<unknown>;
+    execute(agent: SideAgent, line: string, submittedAttachments: readonly unknown[], signal: AbortSignal): Promise<unknown>;
 }
 /** The per-session composer input face this plugin writes to (draft-only). */
 export interface SideSessionInput {

package/lib/types/settings-shared.d.ts

@@ -9,6 +9,8 @@
 export declare const SUBCHAT_PREFS_NS = "dsh-side-chat";
 /** How a brought-back reply lands in the main conversation. */
 export type BringMode = 'draft' | 'context';
+/** Where the side-chat panel lives when a side chat is open. */
+export type PanelHome = 'floating' | 'sidebar-right';
 /** User-facing side-chat preferences. */
 export interface SubchatPrefs {
     /** Whether the "look up workspace / parent when needed" switch defaults on. */
@@ -19,6 +21,8 @@ export interface SubchatPrefs {
     defaultPrompt: string;
     /** How brought-back content lands: into the composer draft, or as a collapsed context row. */
     bringMode: BringMode;
+    /** Which container hosts the panel: the classic floating right-edge panel, or the new built-in right sidebar. */
+    panelHome: PanelHome;
 }
 /** Fallback prefs used whenever the settings document is unreachable or malformed. */
 export declare const SUBCHAT_PREFS_DEFAULTS: SubchatPrefs;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-side-chat-plus",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "侧边聊天 Plus (Side chat Plus) — DSH web plugin: select text in a conversation and ask it in a per-session side chat (hidden ordinary session, own right-side panel, inherits model/effort/permissions, lookup toggle).",
   "private": false,
   "type": "module",
@@ -67,47 +67,47 @@
     "schemastery": "^3.18.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-attachment": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-session": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-session-query": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-workspace": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-permission-presets": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-sandbox-policy": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
+    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-attachment": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-session-query": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-workspace": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-permission-presets": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-sandbox-policy": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
+    "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0 || ^0.1.5-alpha.1",
     "cordis": "^4.0.0-rc.7",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-agent": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-attachment": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-llm": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-session": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-session-query": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-workspace": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-permission-presets": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-sandbox-policy": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-agent-presets": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
-    "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.6 || ^0.1.1-0 || ^0.1.2-0",
+    "@deepseek-ai/dsh-agent": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-attachment": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-session-query": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-workspace": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-permission-presets": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-sandbox-policy": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-agent-presets": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-settings": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-home-paths": "^0.1.5-alpha.2",
     "@types/node": "^24.0.0",
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.1",

package/src/client/client.module.css

@@ -56,6 +56,25 @@
   font-family: var(--dsw-font-family);
   font-size: 14px;
   pointer-events: auto;
+  transition: transform var(--ds-transition-duration-slow) var(--ds-ease-in-out);
+}
+
+/* Embedded in the built-in right sidebar (dock mode): fill the tab pane,
+   drop the floating chrome (fixed positioning, resize rail, own border). */
+.panelEmbedded {
+  position: absolute;
+  inset: 0;
+  width: 100%;
+  border-left: none;
+  border-radius: 0;
+}
+
+/* A built-in sidebar overlay (fullscreen preview / floated panel) owns the
+   viewport: slide this panel out of the way; the layout margin is dropped by
+   the matching width effect so the main column reclaims the space. */
+.panelConflictHidden {
+  transform: translateX(calc(100% + 24px));
+  pointer-events: none;
 }
 
 .panelResize {