dsh-vscode-mode 0.8.0 → 0.9.0

package/src/client/addToConversation.ts

@@ -264,6 +264,138 @@ export interface CtxLike {
   get: (name: string) => unknown
 }
 
+/** 新建会话结果（ok=false 供调用方降级回当前对话注入）。 */
+export interface DraftSessionResult {
+  ok: boolean
+  /** 新会话 id（ok=true 时存在；投递命令按它内嵌）。 */
+  id?: string
+}
+
+/** apiproxy wire 端点（POST /api/<method>；浏览器同源 fetch 自带 cookie 鉴权；实证 401=未鉴权而非 404）。 */
+const SESSION_CREATE_PATH = '/api/session/create'
+/** apiproxy wire 端点：发送任务（session/prompt；点击即发送方案）。 */
+const SESSION_PROMPT_PATH = '/api/session/prompt'
+
+/** mint RPC 请求 id（RpcId 品牌类型运行时即普通字符串）。 */
+function mintRpcId(): string {
+  try {
+    return globalThis.crypto?.randomUUID?.() ?? ('rpc-' + Date.now())
+  } catch {
+    return 'rpc-' + Date.now()
+  }
+}
+
+/**
+ * RPC 返回解析（照官方 dsh-client-runtime 调用形态：`const { result } = await api.sessions.create(...)`）。
+ * 官方 api.sessions 面返回**信封** `{ rpcId, result: RpcResult }`——须解 .result；
+ * 兼容裸 RpcResult 形态（个别补丁面直接回 {ok, value}）。
+ * @author ddj 2026年09月23号
+ * @param res 信封或裸 RpcResult
+ * @returns 归一后的 { ok, value }
+ */
+function rpcOk(res: unknown): { ok: boolean; value?: unknown } {
+  const envelope = (res as { result?: unknown } | null)?.result
+  const r = (envelope ?? res) as { ok?: boolean; value?: unknown } | null
+  return { ok: r?.ok === true, value: r?.value }
+}
+
+/**
+ * wire 直调 session/create（主路径）：ClientRequest 信封 → ServerResponse.result（RpcResult 形态）。
+ * 契约以当前安装版 dsh-host-apiproxy 为准（api/sessions.d.ts「Method signatures are the
+ * source of truth」）：`create({cwd}) → {sessionId}`；信封 = `{type:'client-request', rpcId,
+ * method, payload}` → `{result: {ok:true, value:{sessionId}} | {ok:false, error}}`。
+ * @author ddj 2026年09月23号
+ * @param cwd 新会话工作区目录
+ * @returns 新会话 id（失败空串）
+ */
+async function apiSessionCreate(cwd: string | undefined): Promise<string> {
+  const res = await fetch(SESSION_CREATE_PATH, {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify({
+      type: 'client-request',
+      rpcId: mintRpcId(),
+      method: 'session/create',
+      payload: cwd ? { cwd } : {},
+    }),
+  })
+  const json = await res.json().catch(() => null) as { result?: { ok?: boolean; value?: { sessionId?: unknown } } } | null
+  const id = json?.result?.value?.sessionId
+  return json?.result?.ok === true && typeof id === 'string' ? id : ''
+}
+
+/**
+ * wire 直发 session/prompt（点击即发送方案）：任务文本投给目标会话 agent。
+ * 契约 = 当前安装树 SessionsApi.prompt：`{sessionId, mode:'queue', content:[{type:'text',text}]}`。
+ * 发送成功会话即有内容 → 不再被 blank 隐藏（列表可见）。
+ * @author ddj 2026年09月23号
+ * @param sessionId 目标会话 id（新会话）
+ * @param text 任务文本
+ * @returns 是否受理
+ */
+export async function apiSessionPrompt(sessionId: string, text: string): Promise<boolean> {
+  try {
+    const res = await fetch(SESSION_PROMPT_PATH, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({
+        type: 'client-request',
+        rpcId: mintRpcId(),
+        method: 'session/prompt',
+        payload: { sessionId, mode: 'queue', content: [{ type: 'text', text }] },
+      }),
+    })
+    const json = await res.json().catch(() => null) as { result?: { ok?: boolean } } | null
+    return json?.result?.ok === true
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 新建独立会话承载旁路任务（02-deep-session-prompt：深度分析不污染当前对话）。
+ * 主路径 = apiproxy wire 直调（不依赖 service 面形态猜测）；回落 remote.session.create
+ * 与旧 sessions.create 两代 service 面（宽松解析）。任一步不符返回 ok:false，调用方降级。
+ * @author ddj 2026年09月23号
+ * @param ctx 客户端服务上下文（remote.session + sessions，仅回落用）
+ * @param cwd 新会话工作区目录（与当前会话同工作区）
+ * @returns 新会话结果（含 id）
+ */
+export async function newDraftSession(ctx: CtxLike, cwd: string | undefined): Promise<DraftSessionResult> {
+  // 主路径：wire 直调
+  try {
+    const id = await apiSessionCreate(cwd)
+    if (id) return { ok: true, id }
+  } catch { /* wire 不可用：回落 service 面 */ }
+  try {
+    // 回落 1：remote.session service 面（官方返回信封 {rpcId, result}，见 rpcOk；实参双形态兼容）
+    const remote = ctx.get('remote.session') as {
+      create?: (req: unknown) => Promise<unknown>
+    } | undefined
+    if (typeof remote?.create === 'function') {
+      const payload = cwd ? { cwd } : {}
+      for (const arg of [payload, { rpcId: mintRpcId(), payload }]) {
+        const r = rpcOk(await remote.create(arg))
+        const id = r.value as { sessionId?: unknown } | undefined
+        if (r.ok && typeof id?.sessionId === 'string') return { ok: true, id: id.sessionId }
+      }
+    }
+    // 回落 2：旧版 client store 形态（id / {id} / {sessionId} / {session:{id}} 四解）
+    const sessions = ctx.get('sessions') as { create?: (opts?: { cwd?: string }) => unknown } | undefined
+    if (typeof sessions?.create === 'function') {
+      const created = await sessions.create(cwd ? { cwd } : undefined)
+      const id = typeof created === 'string' && created ? created
+        : typeof (created as { id?: unknown } | null)?.id === 'string' ? (created as { id: string }).id
+        : typeof (created as { sessionId?: unknown } | null)?.sessionId === 'string' ? (created as { sessionId: string }).sessionId
+        : typeof (created as { session?: { id?: unknown } } | null)?.session?.id === 'string'
+          ? (created as { session: { id: string } }).session.id
+          : ''
+      if (id) return { ok: true, id }
+    }
+  } catch { /* 全部失败：调用方降级 */ }
+  return { ok: false }
+}
+
 /** 注入器产物：给 EditorView 用的动作集合。 */
 export interface AddToConversation {
   /** 追加文件/文件夹引用 chip（@path [Lstart-end]）；忙态自动降级纯文本。 */
@@ -273,6 +405,12 @@ export interface AddToConversation {
     range?: RefRange,
     appearance?: RefAppearance,
   ): Promise<AddOutcome>
+  /** 追加纯文本（AI 深度分析任务等长文本注入；插到当前光标，失败不整篇重建）。 */
+  appendText(sessionId: string | undefined, text: string): Promise<AddOutcome>
+  /** 新建独立会话并切换（旁路任务隔离；失败 ok:false 供降级回当前对话）。 */
+  startDraftSession(cwd?: string): Promise<DraftSessionResult>
+  /** 发送任务给目标会话 agent（点击即发送；失败 false 供降级）。 */
+  sendTask(sessionId: string | undefined, text: string): Promise<boolean>
 }
 
 /**
@@ -392,5 +530,69 @@ export function createAddToConversation(ctx: CtxLike): AddToConversation {
     return 'failed'
   }
 
-  return { appendReference }
+  /**
+   * 追加纯文本（AI 深度分析任务注入）：走官方 plain-text 通道插到当前光标。
+   * 失败语义与 appendReference 一致：宁可不写也不整篇重建（保护既有 chip）。
+   * @author ddj 2026年09月23号
+   * @param sessionId 会话 id
+   * @param text 待注入文本
+   * @returns 注入结果（ok / unavailable / failed）
+   */
+  const appendText: AddToConversation['appendText'] = async (sessionId, text) => {
+    const input = inputFor(ctx, sessionId)
+    if (!input) return 'unavailable'
+    const cur = draftCursor(input)
+    if (!cur) return 'unavailable'
+    const at = insertOffsetOf(caretOf(input), detectEndOf(cur))
+    const span: TokenSpanLike = { start: at, end: at, draftRev: cur.draftRev }
+    return safeInsertText(input, text, span) ? 'ok' : 'failed'
+  }
+
+  /**
+   * 新建独立会话（02-deep-session-prompt：旁路任务不污染当前对话）。
+   * 闭包持有真服务 ctx（面板 SidebarCtx 无 .get，会话操作必须经此门面）；
+   * 创建后尽力 `sessions.open(id)` 切换视图（缺失不致命，草稿仍可写入）。
+   * @author ddj 2026年09月23号
+   * @param cwd 新会话工作区目录（与当前会话同工作区）
+   * @returns 新会话结果（失败供降级）
+   */
+  const startDraftSession: AddToConversation['startDraftSession'] = async (cwd) => {
+    const result = await newDraftSession(ctx, cwd)
+    if (result.ok && result.id) {
+      // 尽力切换到新会话（缺失/异常不影响结果——仅视图不切换）
+      try {
+        const sessions = ctx.get('sessions') as { open?: (id: string) => void } | undefined
+        sessions?.open?.(result.id)
+      } catch { /* 切换失败仅视图停留 */ }
+    }
+    return result
+  }
+
+  /**
+   * 发送任务给目标会话 agent（点击即发送方案：任务落地会话即非 blank，列表可见）。
+   * 主路径 wire 直发 session/prompt；回落 remote.session.prompt service 面。
+   * @author ddj 2026年09月23号
+   * @param sessionId 目标会话 id
+   * @param text 任务文本
+   * @returns 是否受理
+   */
+  const sendTask: AddToConversation['sendTask'] = async (sessionId, text) => {
+    if (!sessionId) return false
+    try {
+      if (await apiSessionPrompt(sessionId, text)) return true
+    } catch { /* 回落 service 面 */ }
+    try {
+      const remote = ctx.get('remote.session') as { prompt?: (req: unknown) => Promise<unknown> } | undefined
+      if (typeof remote?.prompt === 'function') {
+        // 官方 api.sessions.prompt(request) 返回信封（rpcOk 解 .result）；实参双形态兼容
+        const payload = { sessionId, mode: 'queue', content: [{ type: 'text', text }] }
+        for (const arg of [payload, { rpcId: mintRpcId(), payload }]) {
+          if (rpcOk(await remote.prompt(arg)).ok) return true
+        }
+      }
+    } catch { /* 全失败 */ }
+    return false
+  }
+
+  return { appendReference, appendText, startDraftSession, sendTask }
 }

package/src/client/pendingNav.ts

@@ -0,0 +1,141 @@
+/**
+ * dsh-vscode-mode client — 跨挂载/跨热重载的待跳转交接（pending nav handoff）。
+ *
+ * 为什么必须落 window（第三次事故根因，2026-09-23 实测取证）：
+ * 并行改码触发插件 client HMR 热重载（保留 console 中装配日志重复 6-7 轮为证）时，
+ * EditorView 被重挂载、模块级变量随 bundle 重求值复位——挂载级 `pendingFocusRef`
+ * 一并销毁，首开跳转只打开文件、不落目标行，热重载平息后的第二次点击才正常。
+ * window 属性跨热重载存活（先例：`__edrvLspProvidersRegistered__`、`__DSH_DEBUG_LOG__`）。
+ *
+ * 语义约定：
+ * - `putPendingNav` 写槽（openFileAt 与挂载级 ref 同步写，ref 是快路径、槽是交接路径）；
+ * - `readPendingNav` **只读不消费**——过期/形状非法才清；新鲜槽可反复读；
+ * - 落点成功后由调用方 `clearPendingNav`（与 ref 同一清除点，防止残留二次跳）；
+ * - TTL 到点自动失效，避免"稍后莫名跳一下"（用户已离开目标意图窗口）。
+ * 作者 ddj 2026-09-23
+ */
+
+// --region 类型与常量
+
+/** 待跳转形状（行列均 1-based；at = 写入时刻，TTL 判据）。 */
+export interface PendingNav {
+  path: string
+  line?: number | null
+  column?: number | null
+  endLine?: number | null
+  endColumn?: number | null
+  at: number
+}
+
+/** 写入接口（at 由 putPendingNav 盖时间戳）。 */
+export type PendingNavInput = Omit<PendingNav, 'at'>
+
+/** window 槽键名（跨热重载存活的全局挂点）。 */
+export const PENDING_NAV_KEY = '__edrvPendingNav__'
+
+/** 交接有效期：超过即失效清槽（点击意图的有效窗口，防陈旧跳转）。 */
+export const PENDING_NAV_TTL = 30000
+
+// --endregion
+
+// --region 纯函数（可单测）
+
+/**
+ * 形状守卫：非法入参返回 null，合法则归一化为 PendingNav。
+ * 行列非有限数字一律归 null（缺省语义 = 不定位行），path 必须为非空字符串。
+ * @author ddj 2026年09月23号
+ * @param raw 任意来源的原始值
+ * @returns 归一化后的 PendingNav 或 null
+ */
+export function sanitizeNav(raw: unknown): PendingNav | null {
+  if (!raw || typeof raw !== 'object') return null
+  const src = raw as Record<string, unknown>
+  if (typeof src.path !== 'string' || !src.path) return null
+  const num = (v: unknown): number | null => (typeof v === 'number' && Number.isFinite(v) ? v : null)
+  const at = num(src.at)
+  if (at === null) return null // at 是 TTL 判据：缺失/非法直接整体无效，不兜 0 免依赖巧合
+  return {
+    path: src.path,
+    line: num(src.line),
+    column: num(src.column),
+    endLine: num(src.endLine),
+    endColumn: num(src.endColumn),
+    at,
+  }
+}
+
+/**
+ * 新鲜度判定：形状合法且未超过 TTL 才算有效；过期返回 null。
+ * @author ddj 2026年09月23号
+ * @param nav 已归一化的待跳转（可空）
+ * @param now 当前时刻（毫秒）
+ * @param ttl 有效期（毫秒）
+ * @returns 有效导航或 null
+ */
+export function freshNav(nav: PendingNav | null, now: number, ttl: number): PendingNav | null {
+  if (!nav) return null
+  return now - nav.at <= ttl ? nav : null
+}
+
+// --endregion
+
+// --region window 槽适配
+
+/** window 上的槽宿主（node 环境无 window，读写降级为 no-op）。 */
+type NavSlotHost = Record<string, unknown>
+
+/**
+ * 取槽宿主：仅浏览器环境返回 window，否则 undefined（测试/SSR 降级）。
+ * @author ddj 2026年09月23号
+ */
+function slotHost(): NavSlotHost | undefined {
+  if (typeof window === 'undefined') return undefined
+  return window as unknown as NavSlotHost
+}
+
+/**
+ * 写入待跳转（盖写整槽；at 由调用方给定或取当前时间）。
+ * 非法 path 直接丢弃，不写槽。
+ * @author ddj 2026年09月23号
+ * @param nav 待跳转内容（不含 at）
+ * @param now 写入时刻（测试注入用）
+ * @returns 是否写入成功
+ */
+export function putPendingNav(nav: PendingNavInput, now: number = Date.now()): boolean {
+  const host = slotHost()
+  if (!host) return false
+  if (typeof nav?.path !== 'string' || !nav.path) return false
+  host[PENDING_NAV_KEY] = { ...nav, at: now }
+  return true
+}
+
+/**
+ * 读取新鲜的待跳转（**不消费**；过期或形状非法才清槽）。
+ * @author ddj 2026年09月23号
+ * @param now 当前时刻（测试注入用）
+ * @param ttl 有效期（毫秒）
+ * @returns 有效导航或 null
+ */
+export function readPendingNav(now: number = Date.now(), ttl: number = PENDING_NAV_TTL): PendingNav | null {
+  const host = slotHost()
+  if (!host) return null
+  const nav = freshNav(sanitizeNav(host[PENDING_NAV_KEY]), now, ttl)
+  if (!nav) {
+    // 失效即清：过期/垃圾数据不留在 window 上
+    if (host[PENDING_NAV_KEY] !== undefined) delete host[PENDING_NAV_KEY]
+    return null
+  }
+  return nav
+}
+
+/**
+ * 清除待跳转槽（落点成功或显式放弃时调用）。
+ * @author ddj 2026年09月23号
+ */
+export function clearPendingNav(): void {
+  const host = slotHost()
+  if (!host) return
+  delete host[PENDING_NAV_KEY]
+}
+
+// --endregion

package/src/client/sidebar/panels/FileExplorer.ts

@@ -10,7 +10,7 @@
  * 作者 ddj 2026-08-26 / 2026-08-27 / 2026-08-31 / 2026-09-10 / 2026-09-16
  */
 import React from 'react'
-import { FileTypeIcon, IconFolderClose16, IconFolderOpen16, IconRefreshOutline16, classifyFileType } from '../../ui/icons.js'
+import { IconFolderClose16, IconFolderOpen16, IconRefreshOutline16, fileIconEl } from '../../ui/icons.js'
 import { rpc } from '../../rpc.js'
 import { ContextMenu } from '../../ui/ContextMenu.js'
 import { buildTreeMenu } from '../contextMenu.js'
@@ -48,20 +48,7 @@ function dirIconEl(isOpen) {
   return React.createElement(Icon, { size: 16, className: 'edrv-tree-icon' })
 }
 
-/**
- * 文件图标元素（官方 FileTypeIcon + classifyFileType 分类，未知类型为 other）。
- * @author ddj 2026年09月10号
- * @param name 文件名（含扩展名）
- * @returns 图标元素；原语缺失或分类异常返回 null
- */
-function fileIconEl(name) {
-  if (typeof FileTypeIcon !== 'function' || typeof classifyFileType !== 'function') return null
-  try {
-    return React.createElement(FileTypeIcon, { kind: classifyFileType(String(name ?? '')), size: 16, className: 'edrv-tree-icon' })
-  } catch (error) {
-    return null
-  }
-}
+// 文件图标元素（fileIconEl）已上移 icons.ts 共享（SVN 变更行同用），此处直接引用。
 
 /**
  * 行图标分派：目录 → 文件夹图标，文件 → 官方类型图标。