dsh-side-chat-plus 0.3.1

package/src/client/layout.css

@@ -0,0 +1,16 @@
+/**
+ * Layout push: when the side-chat panel is open it OCCUPIES layout instead of
+ * floating over it — the app shell (#root) gives up the right margin so the
+ * center column (conversation + input bar) squeezes left, like a VSCode
+ * sidebar. The width rides a CSS variable the panel sets.
+ */
+#root {
+  margin-right: var(--dsh-subchat-width, 0px);
+  transition: margin-right var(--ds-transition-duration-slow) var(--ds-ease-in-out);
+}
+
+@media (prefers-reduced-motion: reduce) {
+  #root {
+    transition: none;
+  }
+}

package/src/client/locales.ts

@@ -0,0 +1,181 @@
+/**
+ * Client locale dictionaries for dsh-side-chat (zh + en), registered under the
+ * `sidechat` namespace.
+ */
+export const LOCALE_NS = 'sidechat'
+
+export const zh = {
+  'ask.new': '在侧边聊天中提问',
+  'ask.continue': '继续在激活的侧边聊天中提问',
+  'panel.title': '侧边聊天',
+  'panel.empty': '当前会话还没有侧边聊天。选中消息文本后点「在侧边聊天中提问」即可发起。',
+  'panel.close': '关闭',
+  'panel.input.placeholder': '输入消息，回车发送',
+  'panel.send': '发送',
+  'panel.stop': '停止',
+  'panel.lookup': '需要时从工作区 / 主会话查信息',
+  'panel.model': '模型',
+  'panel.provider': '服务商',
+  'panel.effort': '思考难度',
+  'panel.permission': '权限',
+  'panel.noModel': '（继承）',
+  'panel.effortDefault': '默认',
+  'panel.expand': '展开侧边聊天',
+  'panel.collapse': '收起侧边聊天',
+  'panel.dispose': '结束此侧边聊天',
+  'panel.delete': '删除',
+  'panel.deleteAll': '删除全部',
+  'panel.error': '侧边聊天出错',
+  'panel.running': '思考中…',
+  'panel.copy': '复制',
+  'panel.copied': '已复制',
+  'panel.footnotes': '脚注',
+  'panel.think': '思考',
+  'panel.commands': '命令',
+  'command.model': '/model 模型',
+  'command.permission': '/permission 权限',
+  'plan.chipTitle': '计划模式已开启 — 点击关闭（/plan off）',
+  'plan.chipAria': '计划模式已开启，按下关闭',
+  'goal.label': '目标',
+  'image.railGroup': '图片附件',
+  'image.railOpen': '查看原图',
+  'image.railScrollLeft': '向左滚动',
+  'image.railScrollRight': '向右滚动',
+  'image.remove': '移除图片',
+  'image.label': '图片',
+  'image.open': '查看原图',
+  'image.loading': '加载中…',
+  'image.loadFailed': '加载失败',
+  'image.lightboxDialog': '图片预览',
+  'image.close': '关闭',
+  'image.dropTitle': '拖放图片到此处',
+  'image.dropDesc': '支持 PNG / JPEG / WebP / GIF',
+  'image.unsupported': '不支持的图片格式',
+  'image.tooMany': '图片数量超出限制',
+  'image.fileTooLarge': '图片过大',
+  'settingsNav': '侧边聊天',
+  'settings.lookupTitle': '默认勾选「需要时从工作区 / 主会话查信息」',
+  'settings.lookupDesc': '新会话的侧边聊天默认打开此开关；可在每次聊天中临时更改',
+  'settings.sendImmediatelyTitle': '选中内容后立即发送',
+  'settings.sendImmediatelyDesc': '关闭后，选中的内容会作为附件先放进侧边聊天输入框，由你确认后再发送',
+  'settings.defaultPromptTitle': '默认用户提示词',
+  'settings.defaultPromptDesc': '「立即发送」开启时，选中的内容会自动附加这段提示词，让回答更符合你的需求',
+  'settings.defaultPromptPlaceholder': '例如：请用中文回答，并尽量简洁…',
+  'settings.bringModeTitle': '带回内容的方式',
+  'settings.bringModeDesc': '把侧边聊天的 AI 回复带回主会话时，内容落在哪里（两种方式都不会立即发送）',
+  'settings.bringModeDraftTitle': '写入输入框草稿',
+  'settings.bringModeDraftDesc': '内容进入主会话输入框，可直接编辑后再发送',
+  'settings.bringModeContextTitle': '注入为折叠提示行',
+  'settings.bringModeContextDesc': '内容作为一条折叠的上下文提示行注入主会话（带来源标记），不写输入框；下次对话时模型可见',
+  'insert.direct': '直接带回',
+  'insert.summarize': '摘要后带回',
+  'insert.summarizing': '摘要中…',
+  'insert.failed': '无法写入主会话输入框',
+  'insert.summarizeFailed': '摘要失败',
+  'insert.contextSummary': '侧边聊天带回',
+  'insert.summarizeContextSummary': '侧边聊天摘要',
+  'question.options': '可选选项',
+  'question.option': '选项',
+  'question.bringAll': '带入全部',
+  'question.bringAllNew': '新会话全部',
+  'question.bringOne': '带入',
+  'question.bringOneNew': '新会话',
+  'question.bringing': '带入中…',
+  'question.failed': '带入侧边聊天失败',
+  'question.delete': '删除',
+  'question.deleteAll': '删除全部',
+  'question.collapse': '折叠',
+  'question.expand': '展开',
+  'question.allPrompt': '请帮我理解上面的问题和各个选项的含义，并给出选择建议。',
+  'question.onePrompt': '请帮我理解这个选项的含义，以及它在这个问题中的利弊。',
+  'question.openHint': '主会话有一个问题弹框，点击在侧边聊天里询问',
+}
+
+export const en = {
+  'ask.new': 'Ask in side chat',
+  'ask.continue': 'Continue active side chat',
+  'panel.title': 'Side chat',
+  'panel.empty': 'No side chat for this conversation yet. Select some message text and choose "Ask in side chat".',
+  'panel.close': 'Close',
+  'panel.input.placeholder': 'Type a message, Enter to send',
+  'panel.send': 'Send',
+  'panel.stop': 'Stop',
+  'panel.lookup': 'Look up workspace / parent when needed',
+  'panel.model': 'Model',
+  'panel.provider': 'Provider',
+  'panel.effort': 'Effort',
+  'panel.permission': 'Permission',
+  'panel.noModel': '(inherited)',
+  'panel.effortDefault': 'Default',
+  'panel.expand': 'Expand side chat',
+  'panel.collapse': 'Collapse side chat',
+  'panel.dispose': 'End this side chat',
+  'panel.delete': 'Delete',
+  'panel.deleteAll': 'Delete all',
+  'panel.error': 'Side chat error',
+  'panel.running': 'Thinking…',
+  'panel.copy': 'Copy',
+  'panel.copied': 'Copied',
+  'panel.footnotes': 'Footnotes',
+  'panel.think': 'Think',
+  'panel.commands': 'Commands',
+  'command.model': '/model Model',
+  'command.permission': '/permission Permission',
+  'plan.chipTitle': 'Plan mode on — click to turn off (/plan off)',
+  'plan.chipAria': 'Plan mode on, press to turn off',
+  'goal.label': 'Goal',
+  'image.railGroup': 'Image attachments',
+  'image.railOpen': 'Open original',
+  'image.railScrollLeft': 'Scroll left',
+  'image.railScrollRight': 'Scroll right',
+  'image.remove': 'Remove image',
+  'image.label': 'Image',
+  'image.open': 'Open original',
+  'image.loading': 'Loading…',
+  'image.loadFailed': 'Load failed',
+  'image.lightboxDialog': 'Image preview',
+  'image.close': 'Close',
+  'image.dropTitle': 'Drop images here',
+  'image.dropDesc': 'PNG / JPEG / WebP / GIF',
+  'image.unsupported': 'Unsupported image type',
+  'image.tooMany': 'Too many images',
+  'image.fileTooLarge': 'Image too large',
+  'settingsNav': 'Side chat',
+  'settings.lookupTitle': 'Default on: "look up workspace / parent when needed"',
+  'settings.lookupDesc': 'New conversations start with this switch on; you can still change it per chat',
+  'settings.sendImmediatelyTitle': 'Send selected text immediately',
+  'settings.sendImmediatelyDesc': 'When off, the selection is staged as an attachment in the composer for you to confirm before sending',
+  'settings.defaultPromptTitle': 'Default prompt',
+  'settings.defaultPromptDesc': 'When "send immediately" is on, this prompt is appended to the selection so the answer matches your needs',
+  'settings.defaultPromptPlaceholder': 'e.g. Answer in Chinese and keep it concise…',
+  'settings.bringModeTitle': 'Bring-back target',
+  'settings.bringModeDesc': 'Where a side-chat AI reply lands when brought back (neither mode sends immediately)',
+  'settings.bringModeDraftTitle': 'Into the composer draft',
+  'settings.bringModeDraftDesc': 'Text lands in the main composer so you can edit before sending',
+  'settings.bringModeContextTitle': 'As a collapsed context row',
+  'settings.bringModeContextDesc': 'Text is injected as a collapsed, source-tagged context row — not into the composer; the model sees it next turn',
+  'insert.direct': 'Insert directly',
+  'insert.summarize': 'Summarize & insert',
+  'insert.summarizing': 'Summarizing…',
+  'insert.failed': 'Could not write to the main composer',
+  'insert.summarizeFailed': 'Summarization failed',
+  'insert.contextSummary': 'Brought from side chat',
+  'insert.summarizeContextSummary': 'Side chat summary',
+  'question.options': 'Options',
+  'question.option': 'Option',
+  'question.bringAll': 'Bring all',
+  'question.bringAllNew': 'New chat (all)',
+  'question.bringOne': 'Bring',
+  'question.bringOneNew': 'New chat',
+  'question.bringing': 'Bringing…',
+  'question.failed': 'Failed to bring into the side chat',
+  'question.delete': 'Delete',
+  'question.deleteAll': 'Delete all',
+  'question.collapse': 'Collapse',
+  'question.expand': 'Expand',
+  'question.allPrompt': 'Please explain what this question is asking and what each option means, and advise how I should choose.',
+  'question.onePrompt': 'Please explain what this option means and its trade-offs for this question.',
+  'question.openHint': 'The main conversation has a question dialog — click to ask in the side chat',
+}
+
+export type SidechatLocaleKey = keyof typeof zh

package/src/context-types.ts

@@ -0,0 +1,384 @@
+/**
+ * Structural types for the cordis services this plugin consumes, plus the
+ * Context augmentation both halves share. A third-party plugin resolves
+ * outside the DSH monorepo's single cordis instance, so the upstream
+ * `declare module 'cordis'` augmentations do not reach this Context; the
+ * members below mirror the actual runtime shapes this plugin touches.
+ *
+ * The `sessions` field is a union of the HOST store face (get/list) and the
+ * CLIENT list feed (list.getSnapshot/subscribe): each half only touches its
+ * own side, and the shared declaration keeps the two cordis instance layers
+ * from colliding under one tsconfig.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http'
+import type { Context } from 'cordis'
+
+/** One named webserver route. */
+export interface SideWebRoute {
+  kind: 'exact' | 'prefix'
+  path: string
+  handler: (req: IncomingMessage, res: ServerResponse) => void | Promise<void>
+}
+
+/** The webServer service face this plugin uses. */
+export interface SideWebServer {
+  register(route: SideWebRoute): () => void
+}
+
+/** A published session's header slice (authoritative cwd, lineage, origin). */
+export interface SideSessionHeader {
+  cwd?: string
+  parentSession?: string
+  origin?: 'subagent'
+  delegationDepth?: number
+}
+
+/** One session event (fold source for history and permission current). */
+export interface SideSessionEvent {
+  type: string
+  seq: number
+  time: number
+  data: Record<string, unknown>
+  surfaceOp?: 'append' | 'replace' | 'remove'
+  sourceEventSeqs?: number[]
+}
+
+/** The live session face the host reads (header + append-only event log). */
+export interface SideSession {
+  id: string
+  header: SideSessionHeader
+  events?: readonly SideSessionEvent[]
+  requestHeader?: () => { config?: { provider?: string; model?: string; reasoningEffort?: string; maxTokens?: number } } | undefined
+}
+
+/** The host session store face (`ctx.sessions` host side). */
+export interface SideSessionStore {
+  get(id: string): SideSession | undefined
+  list(): SideSession[]
+}
+
+/** One session list row (client list feed). */
+export interface SideSessionSummary {
+  id: string
+  displayTitle: string
+  cwd?: string
+  origin?: 'subagent'
+  parentId?: string
+  running: boolean
+}
+
+/** The session list snapshot the browser half subscribes to. */
+export interface SideSessionList {
+  current: string | undefined
+  byId: Record<string, SideSessionSummary>
+}
+
+/** One selectable answer in a user-question dialog. */
+export interface SideQuestionOption {
+  label: string
+  description?: string
+}
+
+/** One question in a pending user-question dialog. */
+export interface SideQuestionItem {
+  id: string
+  question: string
+  detail?: string
+  header?: string
+  options?: SideQuestionOption[]
+  multiSelect?: boolean
+}
+
+/** A pending main-conversation interaction (question / plan-review / approval dialog). */
+export interface SidePendingInteraction {
+  /** Presentation discriminator: the question family, or an approval. */
+  kind: 'question' | 'plan-review' | 'approval'
+  /** Opaque render identity and request key (e.g. `question:1`). */
+  key: string
+  sessionId: string
+  /** The request's question list (present for the question family). */
+  questions?: SideQuestionItem[]
+}
+
+/** The per-session pending-interaction source exposed by the `uiSession` service. */
+export interface SidePendingInteractionStore {
+  getSnapshot(): ReadonlyMap<string, SidePendingInteraction>
+  subscribe(fn: () => void): () => void
+}
+
+/** The client sessions service face (list feed + scope resolution). */
+export interface SideSessionsService {
+  list: {
+    getSnapshot(): SideSessionList
+    subscribe(fn: () => void): () => void
+  }
+  /** Resolve an Agent-scoped context view for a listed session id (use-and-discard). */
+  scope(id: string): Context | undefined
+}
+
+/** The client UI-session service face (per-session pending interactions). */
+export interface SideUiSessionService {
+  /** Per-session pending UI interaction (question / plan-review / approval). */
+  pendingInteractions: SidePendingInteractionStore
+}
+
+/** Agent options (provider/model/maxTokens). */
+export interface SideAgentOptions {
+  provider?: string
+  model?: string
+  maxTokens?: number
+}
+
+/** The live agent face (`ctx.agents.get(id)` / `AgentHandle.agent`). */
+export interface SideAgent {
+  readonly id: string
+  readonly options: SideAgentOptions
+  readonly session: SideSession
+  readonly status: string
+  readonly ctx: Context
+  followup(message: unknown): void
+  inject(message: unknown): void
+  cancel(cause: { kind: 'user' | 'parent' | 'disposed' } | { kind: 'hook'; reason: string }): void
+  whenIdle(): Promise<void>
+}
+
+/** The agent handle `ctx.agents.create` resolves (owner tears the agent down). */
+export interface SideAgentHandle {
+  agent: SideAgent
+  dispose(): Promise<void>
+}
+
+/** `ctx.agents.create` options (mirror of CreateAgentOptions). */
+export interface SideCreateAgentOptions {
+  sessionId: string
+  meta?: {
+    cwd?: string
+    parentSession?: string
+    agentPreset?: string
+  }
+  agentOptions?: SideAgentOptions
+  setup?: (agentCtx: Context) => void | Promise<void>
+}
+
+/** The host agent registry face. */
+export interface SideAgentsService {
+  get(id: string): SideAgent | undefined
+  create(options: SideCreateAgentOptions): Promise<SideAgentHandle>
+}
+
+/** Live provider / model / reasoning-effort selection for one agent. */
+export interface SideModelSelection {
+  provider: string
+  model: string
+  reasoningEffort?: string
+}
+
+/**
+ * Mutable selection plus the value captured when the current step entered
+ * prompt assembly (`current` / `assembled`).
+ */
+export interface SideModelSelectionRef {
+  current: SideModelSelection | undefined
+  assembled: SideModelSelection | undefined
+}
+
+/**
+ * Couple a mutable selection to an agent's prompt assembly and request routing
+ * (`installModelSelection` on the agent package). Typed structurally rather
+ * than imported: this plugin resolves outside the DSH monorepo's single cordis
+ * instance, so the upstream export is reached through a loose signature.
+ */
+export type SideInstallModelSelection = (agentCtx: Context, selection: SideModelSelectionRef) => () => void
+
+/** The workspace registry face (archive a session durably). */
+export interface SideWorkspaceRegistry {
+  archiveSession(sessionId: string): Promise<void>
+}
+
+/** `sessionQuery.readSession` snapshot. */
+export interface SideSessionLogSnapshot {
+  session: SideSessionHeader
+  events: SideSessionEvent[]
+}
+
+/** The session query face. */
+export interface SideSessionQuery {
+  readSession(sessionId: string): Promise<SideSessionLogSnapshot>
+}
+
+/** Sandbox mode vocabulary (read from the session override). */
+export type SideSandboxMode = 'read-only' | 'workspace-write' | 'danger-full-access'
+
+/** The sandbox policy face. */
+export interface SideSandboxPolicy {
+  overrideOf(session: SideSession): SideSandboxMode | undefined
+}
+
+/** One permission preset option. */
+export interface SidePresetOption {
+  value: string
+  name: string
+  description?: string
+}
+
+/** The permission presets face. */
+export interface SidePermissionPresets {
+  current(events: readonly SideSessionEvent[]): string
+  set(session: SideSession, name: string): void
+  selectFor(state: unknown): { options: SidePresetOption[]; currentValue: string }
+}
+
+/** The agent presets face (composeFrom joins a child to the parent's composition). */
+export interface SideAgentPresets {
+  composeFrom(agentCtx: Context, parentCtx: Context): string | undefined
+}
+
+/** One provider route. */
+export interface SideLlmProvider {
+  id: string
+  name: string
+}
+
+/** One model entry. */
+export interface SideLlmModel {
+  provider: string
+  id: string
+  name: string
+  description?: string
+}
+
+/** One reasoning-effort entry. */
+export interface SideLlmEffort {
+  id: string
+  name: string
+  description?: string
+}
+
+/** One model-request stream chunk (minimal structural view for text collection). */
+export interface SideLlmStreamChunk {
+  type: string
+  text?: string
+}
+
+/** Minimal generate options the summarize route builds (a hand-built user prompt). */
+export interface SideLlmGenerateOptions {
+  provider: string
+  model: string
+  reasoningEffort?: string
+  maxTokens?: number
+  signal?: AbortSignal
+  messages: Array<{
+    id?: string
+    role: 'user' | 'assistant' | 'system'
+    content: Array<{ type: 'text'; text: string }>
+    source?: { kind: string }
+  }>
+}
+
+/** The llm face (model/effort catalog + one-shot streaming calls). */
+export interface SideLlm {
+  listProviders(): SideLlmProvider[]
+  listModels(provider: string): Promise<SideLlmModel[]>
+  resolveModelInfo(provider: string, model: string): Promise<{
+    provider: string
+    id: string
+    name: string
+    reasoning?: { efforts: readonly SideLlmEffort[]; defaultEffort?: string }
+  }>
+  stream(options: SideLlmGenerateOptions): AsyncIterable<SideLlmStreamChunk>
+}
+
+/** The client locale service face. */
+export interface SideLocaleService {
+  getSnapshot(): { active: string }
+  subscribe(fn: () => void): () => void
+  register(ns: string, locale: string, dict: Record<string, string>): () => void
+}
+
+/** The host settings service face (namespace registration + read/write). */
+export interface SideSettingsService {
+  register(ns: unknown, schema: unknown): { get(): unknown; watch(cb: (next: unknown, prev: unknown) => void): () => void }
+  describe(opts: { redactSecrets?: boolean }): Array<{ ns: unknown; value?: unknown; revision?: number }>
+  update(ns: unknown, patch: Record<string, unknown>, expectedRevision?: number): Promise<void>
+}
+
+/** The client slots service face (settings.section registration). */
+export interface SideSlotsService {
+  inject(name: string, factory: () => () => void): void
+  register(options: Record<string, unknown>, component: unknown): () => void
+}
+
+/** One durable image reference (mirror of ImageAttachmentRef). */
+export interface SideImageAttachmentRef {
+  attachmentId: string
+  mediaType: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif'
+  bytes: number
+  width: number
+  height: number
+  name?: string
+}
+
+/** The host attachment store face (`ctx.attachments`). */
+export interface SideAttachmentStore {
+  readonly imageLimits: {
+    maxImageBytes: number
+    maxImagesPerMessage: number
+    maxMessageImageBytes: number
+    maxImagePixels: number
+    mediaTypes: readonly string[]
+  }
+  validateImage(input: { data: Uint8Array; mediaType: string; name?: string }): Promise<void>
+  saveImage(input: { data: Uint8Array; mediaType: string; name?: string }): Promise<SideImageAttachmentRef>
+  readImage(ref: SideImageAttachmentRef): Promise<{ ref: SideImageAttachmentRef; data: Uint8Array }>
+}
+
+/** The host command registry face (`ctx.commands`). */
+export interface SideCommandsService {
+  list(agent: SideAgent): Array<{ name: string; description: string }>
+  execute(agent: SideAgent, line: string, signal: AbortSignal): Promise<unknown>
+}
+
+/** The per-session composer input face this plugin writes to (draft-only). */
+export interface SideSessionInput {
+  /** Replace the session composer draft (never submits). */
+  setDraft(text: string): void
+  /** Live input state store (draft read). */
+  state: { getSnapshot(): { draft: string } }
+  /** Surface a notice on the session composer. */
+  notify(level: 'info' | 'error', text: string): void
+}
+
+/** The conversation service face (`ctx.conversation`) — input registry only. */
+export interface SideConversationService {
+  input: {
+    /** Resolve the input facade for one session-scope context. */
+    for(actx: Context): SideSessionInput
+  }
+}
+
+declare module 'cordis' {
+  interface Context {
+    webServer: SideWebServer
+    sessions: SideSessionStore & SideSessionsService
+    agents: SideAgentsService
+    workspaceRegistry: SideWorkspaceRegistry
+    sessionQuery: SideSessionQuery
+    sandboxPolicy: SideSandboxPolicy
+    permissionPresets: SidePermissionPresets
+    agentPresets: SideAgentPresets
+    llm: SideLlm
+    locale: SideLocaleService
+    settings: SideSettingsService
+    slots: SideSlotsService
+    attachments: SideAttachmentStore
+    commands: SideCommandsService
+    conversation: SideConversationService
+    uiSession: SideUiSessionService
+    inject(deps: string[], callback: (ctx: Context) => void): void
+    get(name: string): unknown | undefined
+    on(name: string, listener: (...args: any[]) => any): () => void
+    effect(fn: () => void | (() => void), label?: string): void
+  }
+}
+
+export type { Context }

package/src/css-modules.d.ts

@@ -0,0 +1,10 @@
+/** CSS module typing (the tsdown CSS plugin inlines hashed class maps). */
+declare module '*.module.css' {
+  const classes: Record<string, string>
+  export default classes
+}
+
+declare module '*.css' {
+  const content: string
+  export default content
+}