@things-factory/ai-assistant 10.1.47 → 10.1.52

package/client/components/assistant-session-manager.ts

@@ -0,0 +1,607 @@
+import '@material/web/icon/icon.js'
+
+import { css, html, LitElement, nothing, type PropertyValues, type TemplateResult } from 'lit'
+import { customElement, property, state } from 'lit/decorators.js'
+
+import { i18next } from '@operato/i18n'
+import { OxPrompt } from '@operato/popup'
+
+import {
+  assistantSessionAdmin,
+  sessionActions,
+  type AssistantSessionAdmin,
+  type AssistantSessionEntry,
+  type AssistantSessionFilters
+} from '../utils/assistant-session-admin.js'
+
+const PAGE = 30
+
+
+const t = (key: string, defaultValue: string, options: Record<string, unknown> = {}) =>
+  i18next.t(`ai-assistant.session.${key}`, { defaultValue, ...options })
+
+/**
+ * The conversations on one anchor, managed - `<ox-assistant-session-manager>`.
+ *
+ * Search, a filter (all / mine / including hidden), paging, and on each row: open, rename, hide or
+ * unhide, private ⇄ public, delete. Taken from operato-twin's dock, where it was written first, so every
+ * dock gets it by placing this element (typically behind the toolbar's "All History").
+ *
+ * ── What is the host's ──────────────────────────────────────────────────────────
+ * Opening and starting a conversation belong to the dock's session controller, so this element asks
+ * with the toolbar's own events and does not open anything itself:
+ *   assistant-session-select   { sessionId }    open that conversation
+ *   assistant-session-reset                     start a new one
+ *   assistant-session-changed  { sessionId, change: 'renamed' | 'hidden' | 'unhidden' | 'removed' | 'visibility' }
+ *                                               a row changed - the host refreshes its tabs; if the open
+ *                                               conversation was removed or hidden, it moves off it
+ *
+ * ── What is the server's ────────────────────────────────────────────────────────
+ * Who may do what (`sessionActions`): rename any participant, hide anyone for their own list, delete
+ * the creator, visibility the owner. The buttons follow those hints; the doors decide again.
+ *
+ * ── Asking before what cannot be undone ─────────────────────────────────────────
+ * Delete, and opening a private conversation to the domain, ask on the row itself - [Cancel][OK].
+ * Making it private, hiding and renaming do not: each can be undone from the same row.
+ */
+@customElement('ox-assistant-session-manager')
+export class AssistantSessionManager extends LitElement {
+  static styles = css`
+    :host {
+      display: flex;
+      flex-direction: column;
+      min-height: 0;
+      font-size: 12.5px;
+      color: var(--md-sys-color-on-surface);
+    }
+
+    .bar {
+      display: flex;
+      align-items: center;
+      gap: 6px;
+      padding: 8px 10px;
+      border-bottom: 1px solid var(--md-sys-color-outline-variant);
+    }
+
+    .bar input,
+    .bar select {
+      min-width: 0;
+      height: 28px;
+      box-sizing: border-box;
+      border: 1px solid var(--md-sys-color-outline-variant);
+      border-radius: 6px;
+      background: var(--md-sys-color-surface-container-lowest);
+      color: inherit;
+      font: inherit;
+      padding: 0 8px;
+    }
+
+    .bar input {
+      flex: 1;
+    }
+
+    .new {
+      flex: none;
+      border: 0;
+      border-radius: 6px;
+      padding: 4px 8px;
+      background: transparent;
+      color: var(--md-sys-color-primary);
+      font: inherit;
+      font-weight: 650;
+      cursor: pointer;
+    }
+
+    .filters {
+      display: flex;
+      flex-wrap: wrap;
+      align-items: center;
+      gap: 6px 10px;
+      padding: 6px 10px;
+      border-bottom: 1px solid var(--md-sys-color-outline-variant);
+      font-size: 11.5px;
+      color: var(--md-sys-color-on-surface-variant);
+    }
+
+    .filters select {
+      height: 26px;
+      border: 1px solid var(--md-sys-color-outline-variant);
+      border-radius: 6px;
+      background: var(--md-sys-color-surface-container-lowest);
+      color: inherit;
+      font: inherit;
+    }
+
+    .filters label {
+      display: inline-flex;
+      align-items: center;
+      gap: 3px;
+      cursor: pointer;
+    }
+
+    .kind {
+      color: var(--md-sys-color-primary);
+    }
+
+    .list {
+      flex: 1;
+      min-height: 0;
+      overflow: auto;
+    }
+
+    .row {
+      position: relative;
+      display: flex;
+      align-items: center;
+      gap: 8px;
+      padding: 9px 10px;
+      border-bottom: 1px solid var(--md-sys-color-outline-variant);
+      cursor: pointer;
+    }
+
+    .row:hover,
+    .row.current {
+      background: var(--md-sys-color-surface-container);
+    }
+
+    .row.hidden {
+      opacity: 0.6;
+    }
+
+    .dot {
+      flex: none;
+      width: 7px;
+      height: 7px;
+      border-radius: 50%;
+    }
+
+    .row.unread .dot {
+      background: var(--md-sys-color-primary);
+    }
+
+    .row md-icon {
+      --md-icon-size: 16px;
+      flex: none;
+      color: var(--md-sys-color-on-surface-variant);
+    }
+
+    .body {
+      flex: 1;
+      min-width: 0;
+    }
+
+    .title,
+    .prev {
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+    }
+
+    .row.unread .title {
+      font-weight: 700;
+    }
+
+    .prev {
+      color: var(--md-sys-color-on-surface-variant);
+      font-size: 11px;
+    }
+
+    /* Row actions show on hover and on keyboard focus - the list's body is the names. */
+    .acts {
+      display: none;
+      gap: 2px;
+    }
+
+    .row:hover .acts,
+    .row:focus-within .acts {
+      display: flex;
+    }
+
+    button.icon {
+      display: inline-flex;
+      padding: 3px;
+      border: 0;
+      border-radius: 6px;
+      background: none;
+      color: var(--md-sys-color-on-surface-variant);
+      cursor: pointer;
+    }
+
+    button.icon:hover {
+      background: var(--md-sys-color-surface-container-high);
+      color: var(--md-sys-color-on-surface);
+    }
+
+    button.icon.danger:hover {
+      color: var(--md-sys-color-error);
+    }
+
+    .rename {
+      flex: 1;
+      min-width: 0;
+      height: 26px;
+      border: 1px solid var(--md-sys-color-primary);
+      border-radius: 6px;
+      padding: 0 6px;
+      font: inherit;
+      background: var(--md-sys-color-surface-container-lowest);
+      color: inherit;
+    }
+
+    .ask {
+      display: grid;
+      gap: 6px;
+      padding: 10px;
+      border-bottom: 1px solid var(--md-sys-color-outline-variant);
+      background: var(--md-sys-color-surface-container);
+    }
+
+    .ask .buttons {
+      display: flex;
+      justify-content: flex-end;
+      gap: 6px;
+    }
+
+    .ask button {
+      border: 1px solid var(--md-sys-color-outline-variant);
+      border-radius: 6px;
+      padding: 4px 10px;
+      background: var(--md-sys-color-surface-container-lowest);
+      color: inherit;
+      font: inherit;
+      cursor: pointer;
+    }
+
+    .ask button.ok {
+      border-color: var(--md-sys-color-primary);
+      background: var(--md-sys-color-primary);
+      color: var(--md-sys-color-on-primary);
+    }
+
+    .ask button.ok.danger {
+      border-color: var(--md-sys-color-error);
+      background: var(--md-sys-color-error);
+      color: var(--md-sys-color-on-error);
+    }
+
+    .note,
+    .empty {
+      padding: 14px 12px;
+      color: var(--md-sys-color-on-surface-variant);
+    }
+
+    [role='alert'] {
+      color: var(--md-sys-color-error);
+    }
+
+    .more,
+    .hiddenfilter {
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      gap: 6px;
+      width: 100%;
+      padding: 8px;
+      border: 0;
+      border-top: 1px solid var(--md-sys-color-outline-variant);
+      background: none;
+      color: var(--md-sys-color-on-surface-variant);
+      font: inherit;
+      cursor: pointer;
+    }
+
+    .hiddenfilter md-icon {
+      --md-icon-size: 16px;
+    }
+  `
+
+  /** The anchor whose conversations are listed - the same one the dock's session controller opened. */
+  @property({ type: String }) anchorType = ''
+  @property({ type: String }) anchorId = ''
+  /** The conversation the dock has open - marked in the list. */
+  @property({ type: String }) sessionId = ''
+  /** The doors. Replaceable for tests; a host normally leaves it. */
+  @property({ attribute: false }) admin: AssistantSessionAdmin = assistantSessionAdmin
+  /** The conversation kind (mode) open in the dock - the list's default scope (§2-6). */
+  @property({ type: String }) kind = ''
+  /** kind → the words people know it by (the modes' labels), for each row. */
+  @property({ attribute: false }) kindLabels: Record<string, string> = {}
+
+  @state() private entries: AssistantSessionEntry[] = []
+  @state() private total = 0
+  @state() private hiddenCount = 0
+  @state() private search = ''
+  @state() private allKinds = false
+  @state() private whose: NonNullable<AssistantSessionFilters['whose']> = 'all'
+  @state() private visibility: NonNullable<AssistantSessionFilters['visibility']> = 'all'
+  @state() private includeHidden = false
+  @state() private unreadOnly = false
+  @state() private pageSize = PAGE
+  @state() private loading = false
+  @state() private error = ''
+  @state() private renamingId = ''
+
+  private generation = 0
+  private searchTimer?: ReturnType<typeof setTimeout>
+
+  /** Read the list again - the host calls this after it opened or started a conversation. */
+  async reload(): Promise<void> {
+    const generation = ++this.generation
+    if (!this.anchorType || !this.anchorId) {
+      this.entries = []
+      this.total = this.hiddenCount = 0
+      return
+    }
+
+    this.loading = true
+    this.error = ''
+    try {
+      /*
+       * Paging reads again from the start rather than appending - live activity reorders the list, and
+       * appending a later page to an earlier order duplicates and drops rows.
+       */
+      const page = await this.admin.inbox({
+        anchorType: this.anchorType,
+        anchorId: this.anchorId,
+        search: this.search,
+        filters: {
+          kind: this.allKinds ? '' : this.kind,
+          whose: this.whose,
+          visibility: this.visibility,
+          includeHidden: this.includeHidden,
+          unreadOnly: this.unreadOnly
+        },
+        limit: this.pageSize,
+        offset: 0
+      })
+      if (generation !== this.generation) return
+      this.entries = page.entries
+      this.total = page.total
+      this.hiddenCount = page.hiddenCount
+    } catch (error) {
+      if (generation !== this.generation) return
+      this.entries = []
+      this.total = this.hiddenCount = 0
+      this.error = (error as Error).message || t('failed', 'could not load the conversation list.')
+    } finally {
+      if (generation === this.generation) this.loading = false
+    }
+  }
+
+  protected updated(changed: PropertyValues) {
+    if (changed.has('anchorType') || changed.has('anchorId') || changed.has('admin') || changed.has('kind')) void this.reload()
+
+    /*
+     * The rename box takes the keys the moment it opens, with the name selected. `autofocus` works once
+     * per document, so the second rename opened a box that ignored the typing (2026-09-24, operato-ecs).
+     */
+    if (changed.has('renamingId') && this.renamingId) {
+      const input = this.renderRoot.querySelector('input.rename') as HTMLInputElement | null
+      input?.focus()
+      input?.select()
+    }
+  }
+
+  disconnectedCallback() {
+    this.generation++
+    clearTimeout(this.searchTimer)
+    super.disconnectedCallback()
+  }
+
+  private emit(name: string, detail?: unknown) {
+    this.dispatchEvent(new CustomEvent(name, { detail, bubbles: true, composed: true }))
+  }
+
+  /* ── what the person does ────────────────────────────────────────────────────────── */
+
+  private onSearch(value: string) {
+    this.search = value
+    clearTimeout(this.searchTimer)
+    /* Not on every keystroke. A new search starts from the first page. */
+    this.searchTimer = setTimeout(() => {
+      this.pageSize = PAGE
+      void this.reload()
+    }, 200)
+  }
+
+  /** A filter changed - the list starts from its first page again. */
+  private refilter(change: () => void) {
+    change()
+    this.pageSize = PAGE
+    void this.reload()
+  }
+
+  private loadMore() {
+    this.pageSize += PAGE
+    void this.reload()
+  }
+
+  /** Runs one door, then reads the list again - on success and on failure alike, so the row shows the truth. */
+  private async act(entry: AssistantSessionEntry, change: string, run: () => Promise<boolean>, refused: string) {
+    this.renamingId = ''
+    try {
+      if (!(await run())) this.error = refused
+      else this.emit('assistant-session-changed', { sessionId: entry.id, change })
+    } catch (error) {
+      /* Never pass a failure silently - a person must not believe a conversation was deleted when it was not. */
+      this.error = (error as Error).message
+    }
+    const error = this.error
+    await this.reload()
+    if (error && !this.error) this.error = error
+  }
+
+  private rename(entry: AssistantSessionEntry, name: string) {
+    const trimmed = name.trim()
+    this.renamingId = ''
+    if (!trimmed || trimmed === entry.name) return
+    void this.act(entry, 'renamed', () => this.admin.rename(entry.id, trimmed), t('rename-refused', 'this conversation could not be renamed.'))
+  }
+
+  private setHidden(entry: AssistantSessionEntry, hidden: boolean) {
+    void this.act(entry, hidden ? 'hidden' : 'unhidden', () => this.admin.hide(entry.id, hidden), t('hide-refused', 'this conversation could not be hidden.'))
+  }
+
+  private setVisibility(entry: AssistantSessionEntry, visibility: 'open' | 'private') {
+    void this.act(
+      entry,
+      'visibility',
+      () => this.admin.setVisibility(entry.id, visibility),
+      t('visibility-refused', 'only the owner of this conversation can change who reads it.')
+    )
+  }
+
+  private _removeSession(entry: AssistantSessionEntry) {
+    void this.act(entry, 'removed', () => this.admin.remove(entry.id), t('remove-refused', 'this conversation could not be deleted.'))
+  }
+
+  /* ── drawing ─────────────────────────────────────────────────────────────────────── */
+
+  render(): TemplateResult {
+    const shown = this.entries.length
+
+    return html`
+      <div class="bar">
+        <input
+          .value=${this.search}
+          placeholder=${t('search', 'Search names and last messages')}
+          aria-label=${t('search', 'Search names and last messages')}
+          @input=${(e: Event) => this.onSearch((e.target as HTMLInputElement).value)}
+          @keydown=${(e: KeyboardEvent) => e.key === 'Escape' && this.onSearch('')}
+        />
+        <button class="new" @click=${() => this.emit('assistant-session-reset')}>+ ${t('new', 'New conversation')}</button>
+      </div>
+      <div class="filters">
+        ${this.kind
+          ? html`<select aria-label=${t('filter-kind', 'Which kind')} .value=${this.allKinds ? 'all' : 'this'}
+              @change=${(e: Event) => this.refilter(() => (this.allKinds = (e.target as HTMLSelectElement).value === 'all'))}>
+              <option value="this">${this.kindLabels[this.kind] || t('filter-this-kind', 'This conversation')}</option>
+              <option value="all">${t('filter-all-kinds', 'All kinds here')}</option>
+            </select>`
+          : nothing}
+        <select aria-label=${t('filter-whose', 'Whose')} .value=${this.whose}
+          @change=${(e: Event) => this.refilter(() => (this.whose = (e.target as HTMLSelectElement).value as any))}>
+          <option value="all">${t('filter-all', 'All')}</option>
+          <option value="mine">${t('filter-mine', 'Started by me')}</option>
+          <option value="participant">${t('filter-participant', "I'm in")}</option>
+        </select>
+        <select aria-label=${t('filter-visibility', 'Visibility')} .value=${this.visibility}
+          @change=${(e: Event) => this.refilter(() => (this.visibility = (e.target as HTMLSelectElement).value as any))}>
+          <option value="all">${t('filter-any-visibility', 'Public and private')}</option>
+          <option value="open">${t('filter-open', 'Public')}</option>
+          <option value="private">${t('filter-private', 'Private')}</option>
+        </select>
+        <label><input type="checkbox" .checked=${this.unreadOnly}
+          @change=${(e: Event) => this.refilter(() => (this.unreadOnly = (e.target as HTMLInputElement).checked))} />${t('filter-unread', 'Unread')}</label>
+        <label><input type="checkbox" .checked=${this.includeHidden}
+          @change=${(e: Event) => this.refilter(() => (this.includeHidden = (e.target as HTMLInputElement).checked))} />${t('filter-hidden', 'Including hidden')}</label>
+      </div>
+      <div class="list">
+        ${this.error ? html`<div class="note" role="alert">${this.error}</div>` : nothing}
+        ${shown === 0 && !this.loading
+          ? html`<div class="empty">${this.search ? t('no-match', 'No conversation matches "{q}".', { q: this.search }) : t('none', 'No conversations yet.')}</div>`
+          : this.entries.map(entry => this.renderRow(entry))}
+        ${shown < this.total
+          ? html`<button class="more" @click=${() => this.loadMore()}>${t('load-more', 'Show more ({rest})', { rest: this.total - shown })}</button>`
+          : nothing}
+      </div>
+      <!-- A hidden conversation must not be forgotten: say how many, and one press shows them. -->
+      ${this.hiddenCount > 0 && !this.includeHidden
+        ? html`<button class="hiddenfilter" @click=${() => this.refilter(() => (this.includeHidden = true))}>
+            <md-icon>visibility_off</md-icon>${t('hidden-count', '{count} hidden', { count: this.hiddenCount })}
+          </button>`
+        : nothing}
+    `
+  }
+
+  private renderRow(entry: AssistantSessionEntry): TemplateResult {
+    const name = entry.name || t('untitled', 'Untitled conversation')
+    const actions = sessionActions(entry)
+    const isPrivate = entry.visibility === 'private'
+
+    if (this.renamingId === entry.id) {
+      return html`<div class="row">
+        <span class="dot"></span>
+        <input
+          class="rename"
+          .value=${entry.name || ''}
+          aria-label=${t('rename', 'Rename')}
+          @keydown=${(e: KeyboardEvent) => {
+            if (e.key === 'Enter') this.rename(entry, (e.target as HTMLInputElement).value)
+            if (e.key === 'Escape') this.renamingId = ''
+          }}
+          @blur=${(e: Event) => this.rename(entry, (e.target as HTMLInputElement).value)}
+        />
+      </div>`
+    }
+
+    return html`<div
+      class="row ${entry.unread ? 'unread' : ''} ${entry.hidden ? 'hidden' : ''} ${entry.id === this.sessionId ? 'current' : ''}"
+      @click=${() => this.emit('assistant-session-select', { sessionId: entry.id, kind: entry.kind })}
+    >
+      <span class="dot"></span>
+      <md-icon title=${isPrivate ? t('private', 'Private - only its participants read it') : t('open', 'Public - everyone in this domain reads it')}
+        >${isPrivate ? 'lock' : 'public'}</md-icon
+      >
+      <span class="body">
+        <div class="title" @dblclick=${(e: Event) => { e.stopPropagation(); if (actions.rename) this.renamingId = entry.id }}>${name}</div>
+        <div class="prev">${this.allKinds && entry.kind ? html`<span class="kind">${this.kindLabels[entry.kind] || entry.kind}</span> · ` : nothing}${entry.lastMessagePreview || ''}</div>
+      </span>
+      <span class="acts" @click=${(e: Event) => e.stopPropagation()}>
+        ${actions.rename
+          ? html`<button class="icon" title=${t('rename', 'Rename')} aria-label=${t('rename', 'Rename')} @click=${() => (this.renamingId = entry.id)}>
+              <md-icon>edit</md-icon>
+            </button>`
+          : nothing}
+        ${actions.setVisibility
+          ? isPrivate
+            ? html`<button class="icon" title=${t('make-open', 'Make public')} aria-label=${t('make-open', 'Make public')}
+                @click=${() => this.askOpen(entry, name)}><md-icon>public</md-icon></button>`
+            : html`<button class="icon" title=${t('make-private', 'Make private')} aria-label=${t('make-private', 'Make private')}
+                @click=${() => this.setVisibility(entry, 'private')}><md-icon>lock</md-icon></button>`
+          : nothing}
+        <button
+          class="icon"
+          title=${actions.unhide ? t('unhide', 'Show in my list') : t('hide', 'Hide from my list')}
+          aria-label=${actions.unhide ? t('unhide', 'Show in my list') : t('hide', 'Hide from my list')}
+          @click=${() => this.setHidden(entry, !entry.hidden)}
+        >
+          <md-icon>${actions.unhide ? 'visibility' : 'visibility_off'}</md-icon>
+        </button>
+        ${actions.remove
+          ? html`<button class="icon danger" title=${t('remove', 'Delete')} aria-label=${t('remove', 'Delete')}
+              @click=${() => this.askRemove(entry, name)}><md-icon>delete</md-icon></button>`
+          : nothing}
+      </span>
+    </div>`
+  }
+
+  /** Before what cannot be taken back - the platform's confirm, [Cancel][OK] (decided 2026-09-25, §7-3). */
+  private async ask(title: string, text: string, confirmText: string): Promise<boolean> {
+    return !!(await OxPrompt.open({
+      type: 'warning',
+      title,
+      text,
+      confirmButton: { text: confirmText },
+      cancelButton: { text: t('cancel', 'Cancel') }
+    }))
+  }
+
+  private async askRemove(entry: AssistantSessionEntry, name: string) {
+    const ok = await this.ask(
+      t('remove', 'Delete'),
+      t('confirm-remove', 'Delete "{name}"? It disappears for every participant and cannot be brought back.', { name }),
+      t('remove', 'Delete')
+    )
+    if (ok) this._removeSession(entry)
+  }
+
+  private async askOpen(entry: AssistantSessionEntry, name: string) {
+    const ok = await this.ask(
+      t('make-open', 'Make public'),
+      t('confirm-open', 'Make "{name}" public? Everyone in this domain will be able to read what is already written.', { name }),
+      t('make-open', 'Make public')
+    )
+    if (ok) this.setVisibility(entry, 'open')
+  }
+}

package/client/components/chat-echo-dedup.ts

@@ -44,6 +44,10 @@ export function remoteMessageToLine(m: RemoteMessage): DedupLine {
     patchId: m.relatedPatchId ?? undefined,
     toolUsages: Array.isArray(m.toolUsagesJson) ? m.toolUsagesJson : undefined,
     groundingWarnings: Array.isArray(m.groundingWarningsJson) ? m.groundingWarningsJson : undefined,
+    /* Files sent with the turn (shared dock §9) - opened through the conversation's own route when drawn. */
+    attachments: Array.isArray((m as any).attachmentsJson)
+      ? (m as any).attachmentsJson.map((a: any) => ({ id: a.id, name: a.name, type: a.mimetype, size: a.size }))
+      : undefined,
     senderEmail: m.creator?.email ?? undefined,
     senderName: m.creator?.name ?? undefined,
     /*

package/client/components/chat-input-builder.ts

@@ -94,6 +94,8 @@ export interface AssistantChatInputArgs {
   mode: { kind: string; target?: string }
   truncateAfterMessageId?: string
   hostContext?: any
+  /** Files stored with the conversation by attachToConversation, sent with this turn. */
+  attachmentIds?: string[]
 }
 
 /**
@@ -116,6 +118,7 @@ export function buildAssistantChatInput(args: AssistantChatInputArgs): Record<st
     messages: args.history,
     mode: { kind: args.mode.kind, ...(args.mode.target ? { target: args.mode.target } : {}) },
     ...(args.truncateAfterMessageId ? { truncateAfterMessageId: args.truncateAfterMessageId } : {}),
-    ...(args.hostContext ? { hostContext: args.hostContext } : {})
+    ...(args.hostContext ? { hostContext: args.hostContext } : {}),
+    ...(args.attachmentIds?.length ? { attachmentIds: args.attachmentIds } : {})
   }
 }

package/client/components/panel-aria.test.ts

@@ -41,14 +41,19 @@ describe('the panel does not raise a second tab axis', () => {
  * 이미지는 `hostContext.image` 로 사람 턴에 붙는 길이 있다.
  */
 describe('the attach control offers only what has a path', () => {
-  it('★ 이미지만 받는다 — 읽히지 않는 것을 화면이 권하지 않는다', () => {
-    /*
-     * 여기서는 주석을 안 벗긴다. `image/*` 자체가 `/*` 를 품고 있어서, 주석 벗기개가 그 자리를 주석의
-     * 시작으로 읽고 다음 `*` + `/` 까지 지워 버린다 — 값이 사라지고 시험은 「없다」고 답한다.
-     * 이 값은 주석에 적힐 일이 없으므로 원문에서 그대로 읽는다.
-     */
-    const accept = readFileSync(join(__dirname, 'assistant-chat.ts'), 'utf-8').match(/accept="([^"]*)"/)
+  /*
+   * 2026-09-25 — 받을 것을 **모드가 선언한다**(design/ai/shared-dock.md §9-1). 이미지 · 글 파일 모두 이제 모델에
+   * 닿는 길이 있다(보낸 턴에는 원문, 그 뒤에는 readChatAttachment). 그래서 규칙이 「이미지만」에서 「모드가 선언한
+   * 것만, 선언이 없으면 아무것도」로 넓어졌다. 보드 문(boardAIChat)은 모드 정책을 모르므로 이미지 길 그대로다.
+   */
+  const source = readFileSync(join(__dirname, 'assistant-chat.ts'), 'utf-8')
 
-    expect(accept?.[1]).toBe('image/*')
+  it('★ 중립 문은 모드의 선언만 받는다 — 선언이 없으면 첨부 단추가 없다', () => {
+    expect(source).toMatch(/accept=\$\{this\.usesAttachmentPolicy \? acceptOf\(this\.modeView\?\.attachments\) : 'image\/\*'\}/)
+    expect(source).toMatch(/return !this\.usesAttachmentPolicy \|\| !!this\.modeView\?\.attachments\?\.kinds\?\.length/)
+  })
+
+  it('보드 문은 이미지 길 그대로다', () => {
+    expect(source).toMatch(/: 'image\/\*'\}/)
   })
 })

package/client/index.ts

@@ -14,6 +14,14 @@ export * from './components/mention-popup-helpers.js'
 export * from './utils/assistant-session-controller.js'
 export * from './utils/assistant-session-transport.js'
 export * from './components/assistant-session-toolbar.js'
+export * from './utils/assistant-session-admin.js'
+export * from './components/assistant-session-manager.js'
+export * from './components/assistant-dock.js'
+export * from './setup-assistant-dock.js'
+export * from './utils/assistant-surface.js'
+export * from './utils/assistant-proposals.js'
+export * from './utils/assistant-ask.js'
+export * from './utils/assistant-activity.js'
 export * from './utils/assistant-request-context.js'
 export * from './utils/assistant-capability.js'
 export * from './utils/assistant-capability-read.js'