@things-factory/ai-assistant 10.1.154 → 10.1.156

package/client/settings/ai-usage-setting-let.ts

@@ -0,0 +1,252 @@
+import '@things-factory/setting-base/dist-client/layout/settinglet.js'
+import '@operato/input/ox-input-select-buttons.js'
+
+import gql from 'graphql-tag'
+import { css, html, LitElement, nothing } from 'lit'
+import { customElement, state } from 'lit/decorators.js'
+import { client } from '@operato/graphql'
+import { i18next, localize } from '@operato/i18n'
+import { FormFieldStyles, ScrollbarStyles } from '@operato/styles'
+
+import { periodRange, totalsOf, type UsageBucketSize, type UsagePeriod, type UsageRow } from './usage-model.js'
+
+const t = (key: string, defaultValue: string, options: Record<string, unknown> = {}) =>
+  i18next.t(`ai-assistant.usage.${key}`, { ...options, defaultValue })
+
+const USAGE_QUERY = gql`
+  query AiUsageSummary($from: DateTimeISO!, $to: DateTimeISO!, $bucket: String!, $includeDescendants: Boolean) {
+    aiUsageSummary(from: $from, to: $to, bucket: $bucket, includeDescendants: $includeDescendants) {
+      bucket
+      agentId
+      agentName
+      provider
+      model
+      domainId
+      domainName
+      userId
+      userName
+      calls
+      inputTokens
+      outputTokens
+      failures
+    }
+  }
+`
+
+/**
+ * AI usage of this domain - per hour, day or month × agent × person, in the domain's time zone
+ * (design/ai/agent-settings.md §7-3). With "domains below", what they did with this domain's agents is added as one
+ * line per domain; their people are not named here.
+ */
+@customElement('ai-usage-setting-let')
+export class AiUsageSettingLet extends localize(i18next)(LitElement) {
+  static styles = [
+    FormFieldStyles,
+    ScrollbarStyles,
+    css`
+      :host {
+        display: block;
+      }
+      [slot='content'] {
+        display: grid;
+        gap: 8px;
+        text-transform: none;
+      }
+      .filters {
+        display: flex;
+        flex-wrap: wrap;
+        align-items: center;
+        gap: 8px 12px;
+      }
+      .filters select {
+        height: var(--form-element-height-small, 26px);
+        font-size: 12px;
+      }
+      .filters label {
+        display: inline-flex;
+        align-items: center;
+        gap: 4px;
+        font-size: 12px;
+      }
+      .table {
+        max-height: 360px;
+        overflow: auto;
+      }
+      table {
+        width: 100%;
+        border-collapse: collapse;
+        font-size: 12px;
+      }
+      th,
+      td {
+        padding: 4px 8px;
+        border-bottom: 1px solid var(--md-sys-color-outline-variant);
+        white-space: nowrap;
+        text-align: left;
+      }
+      th {
+        position: sticky;
+        top: 0;
+        background: var(--md-sys-color-surface-container);
+        font-weight: 600;
+        color: var(--md-sys-color-on-surface-variant);
+      }
+      td.number,
+      th.number {
+        text-align: right;
+        font-variant-numeric: tabular-nums;
+      }
+      td.failed {
+        color: var(--md-sys-color-error);
+      }
+      tr.total td {
+        font-weight: 600;
+        border-top: 2px solid var(--md-sys-color-outline-variant);
+      }
+      .below {
+        color: var(--md-sys-color-on-surface-variant);
+      }
+      .state {
+        font-size: 12px;
+        color: var(--md-sys-color-on-surface-variant);
+      }
+      .state.failed {
+        color: var(--md-sys-color-error);
+      }
+    `
+  ]
+
+  @state() private period: UsagePeriod = '7d'
+  @state() private bucket: UsageBucketSize = 'day'
+  @state() private includeDescendants = false
+  @state() private agentFilter = ''
+  @state() private userFilter = ''
+  @state() private rows?: UsageRow[]
+  @state() private failed?: string
+
+  connectedCallback() {
+    super.connectedCallback()
+    this.load()
+  }
+
+  private loadToken = 0
+
+  private async load() {
+    const token = ++this.loadToken
+    this.failed = undefined
+    this.rows = undefined
+    const { from, to } = periodRange(this.period, new Date())
+    try {
+      const response = await client.query({
+        query: USAGE_QUERY,
+        fetchPolicy: 'network-only',
+        variables: { from, to, bucket: this.bucket, includeDescendants: this.includeDescendants }
+      })
+      if (token !== this.loadToken) return
+      /* This client answers a refusal in `errors` (errorPolicy 'all') instead of throwing. */
+      if ((response as any).errors?.length) throw new Error((response as any).errors[0].message)
+      this.rows = response.data?.aiUsageSummary ?? []
+    } catch (error: any) {
+      if (token !== this.loadToken) return
+      this.failed = error?.graphQLErrors?.[0]?.message ?? error?.message ?? String(error)
+    }
+  }
+
+  render() {
+    return html`
+      <setting-let>
+        <div slot="title">${t('title', 'AI usage')}</div>
+        <div slot="content">${this.renderFilters()} ${this.renderTable()}</div>
+      </setting-let>
+    `
+  }
+
+  private renderFilters() {
+    const rows = this.rows ?? []
+    const agents = [...new Map(rows.filter(one => one.agentId).map(one => [one.agentId!, one.agentName ?? t('deleted-agent', '(deleted agent)')])).entries()]
+    const users = [...new Map(rows.filter(one => one.userId).map(one => [one.userId!, one.userName ?? one.userId!])).entries()]
+    return html`
+      <div class="filters">
+        <ox-input-select-buttons
+          .value=${this.period}
+          .options=${[
+            { display: t('today', 'Today'), value: 'today' },
+            { display: t('7d', '7 days'), value: '7d' },
+            { display: t('30d', '30 days'), value: '30d' }
+          ]}
+          @change=${(e: CustomEvent) => e.detail && ((this.period = e.detail), this.load())}></ox-input-select-buttons>
+        <ox-input-select-buttons
+          .value=${this.bucket}
+          .options=${[
+            { display: t('by-hour', 'Hour'), value: 'hour' },
+            { display: t('by-day', 'Day'), value: 'day' },
+            { display: t('by-month', 'Month'), value: 'month' }
+          ]}
+          @change=${(e: CustomEvent) => e.detail && ((this.bucket = e.detail), this.load())}></ox-input-select-buttons>
+        <select aria-label=${t('agent', 'Agent')} @change=${(e: Event) => (this.agentFilter = (e.target as HTMLSelectElement).value)}>
+          <option value="">${t('all-agents', 'All agents')}</option>
+          ${agents.map(([id, name]) => html`<option value=${id} ?selected=${id === this.agentFilter}>${name}</option>`)}
+        </select>
+        <select aria-label=${t('person', 'Person')} @change=${(e: Event) => (this.userFilter = (e.target as HTMLSelectElement).value)}>
+          <option value="">${t('all-people', 'Everyone')}</option>
+          ${users.map(([id, name]) => html`<option value=${id} ?selected=${id === this.userFilter}>${name}</option>`)}
+        </select>
+        <label>
+          <input type="checkbox" .checked=${this.includeDescendants} @change=${(e: Event) => ((this.includeDescendants = (e.target as HTMLInputElement).checked), this.load())} />
+          ${t('include-below', 'Domains below')}
+        </label>
+      </div>
+    `
+  }
+
+  private renderTable() {
+    if (this.failed) return html`<div class="state failed">${t('load-failed', 'Could not read the usage.')} ${this.failed}</div>`
+    if (!this.rows) return html`<div class="state">${t('loading', 'Reading…')}</div>`
+
+    const rows = this.rows.filter(one => (!this.agentFilter || one.agentId === this.agentFilter) && (!this.userFilter || one.userId === this.userFilter))
+    if (!rows.length) return html`<div class="state">${t('empty', 'No AI was used in this period.')}</div>`
+
+    const total = totalsOf(rows)
+    const number = (value: number) => value.toLocaleString()
+    return html`
+      <div class="table">
+        <table>
+          <thead>
+            <tr>
+              <th>${t('when', 'When')}</th>
+              <th>${t('agent', 'Agent')}</th>
+              <th>${t('person', 'Person')}</th>
+              <th class="number">${t('calls', 'Calls')}</th>
+              <th class="number">${t('input-tokens', 'Input tokens')}</th>
+              <th class="number">${t('output-tokens', 'Output tokens')}</th>
+              <th class="number">${t('failures', 'Failed')}</th>
+            </tr>
+          </thead>
+          <tbody>
+            ${rows.map(
+              row => html`<tr>
+                <td>${row.bucket}</td>
+                <td title=${`${row.provider} · ${row.model}`}>${row.agentName ?? t('deleted-agent', '(deleted agent)')}</td>
+                <td>
+                  ${row.userName ??
+                  (row.userId ? row.userId : nothing)}${!row.userId && row.domainName ? html`<span class="below">(${row.domainName})</span>` : nothing}
+                </td>
+                <td class="number">${number(row.calls)}</td>
+                <td class="number">${number(row.inputTokens)}</td>
+                <td class="number">${number(row.outputTokens)}</td>
+                <td class="number ${row.failures ? 'failed' : ''}">${number(row.failures)}</td>
+              </tr>`
+            )}
+            <tr class="total">
+              <td colspan="3">${t('total', 'Total')}</td>
+              <td class="number">${number(total.calls)}</td>
+              <td class="number">${number(total.inputTokens)}</td>
+              <td class="number">${number(total.outputTokens)}</td>
+              <td class="number">${number(total.failures)}</td>
+            </tr>
+          </tbody>
+        </table>
+      </div>
+    `
+  }
+}

package/client/settings/usage-model.ts

@@ -0,0 +1,46 @@
+/** What the AI usage card asks for and adds up (design/ai/agent-settings.md §7-3). */
+export type UsagePeriod = 'today' | '7d' | '30d'
+export type UsageBucketSize = 'hour' | 'day' | 'month'
+
+export interface UsageRow {
+  bucket: string
+  agentId?: string | null
+  agentName?: string | null
+  provider: string
+  model: string
+  domainId: string
+  domainName: string
+  userId?: string | null
+  userName?: string | null
+  calls: number
+  inputTokens: number
+  outputTokens: number
+  failures: number
+}
+
+/**
+ * The span a period covers, up to the end of the current hour - usage is stored by the hour, so the hour in progress
+ * is counted whole.
+ */
+export function periodRange(period: UsagePeriod, now: Date): { from: Date; to: Date } {
+  const to = new Date(now)
+  to.setMinutes(0, 0, 0)
+  to.setHours(to.getHours() + 1)
+  const from = new Date(now)
+  from.setHours(0, 0, 0, 0)
+  if (period === '7d') from.setDate(from.getDate() - 6)
+  if (period === '30d') from.setDate(from.getDate() - 29)
+  return { from, to }
+}
+
+export function totalsOf(rows: UsageRow[]) {
+  return rows.reduce(
+    (sum, row) => ({
+      calls: sum.calls + row.calls,
+      inputTokens: sum.inputTokens + row.inputTokens,
+      outputTokens: sum.outputTokens + row.outputTokens,
+      failures: sum.failures + row.failures
+    }),
+    { calls: 0, inputTokens: 0, outputTokens: 0, failures: 0 }
+  )
+}

package/client/setup-assistant-dock.ts

@@ -117,7 +117,7 @@ export class AssistantDockButton extends LitElement {
 
 let installed = false
 
-export function setupAssistantDock(options: { viewpart?: string; overlayBoundary?: () => Element | undefined } = {}): void {
+export function setupAssistantDock(options: { viewpart?: string } = {}): void {
   if (installed) return
   installed = true
   const viewpart = options.viewpart ?? ASSISTANT_DOCK_VIEWPART
@@ -129,9 +129,8 @@ export function setupAssistantDock(options: { viewpart?: string; overlayBoundary
    * makes the element would make a new dock on every opening - and a new composer, the text being written gone
    * (design/ai/shared-dock.md §2-1, §2-7). The same element is put back instead, as the entity360 dock is.
    */
-  const dock = document.createElement('ox-assistant-dock') as HTMLElement & { viewpart: string; overlayBoundary?: () => Element | undefined }
+  const dock = document.createElement('ox-assistant-dock') as HTMLElement & { viewpart: string }
   dock.viewpart = viewpart
-  dock.overlayBoundary = options.overlayBoundary
 
   appendViewpart({
     name: viewpart,

package/client/utils/agent-choice.ts

@@ -0,0 +1,56 @@
+/**
+ * Which AI agent the dock sends a turn with (design/ai/agent-settings.md §5).
+ *
+ * The server lists the agents a person may pick in this domain (`aiAgentChoices`); the dock sends the id of one, and
+ * the server decides the provider, the model and the key from it. What a person last picked is a convenience of this
+ * browser, kept per domain: an id the list no longer has is dropped and the domain's default answers.
+ */
+export interface AgentChoice {
+  id: string
+  name: string
+  provider: string
+  model: string
+  isDefault: boolean
+}
+
+/** The agent to send with: the remembered one while the domain still offers it, else the default, else the first. */
+export function pickAgentId(choices: AgentChoice[], remembered?: string | null): string | undefined {
+  if (remembered && choices.some(one => one.id === remembered)) return remembered
+  return (choices.find(one => one.isDefault) ?? choices[0])?.id
+}
+
+/** A picker is drawn only when there is something to pick (the same rule as the mode picker, ADR-0072). */
+export function offersAgentPicker(choices: AgentChoice[]): boolean {
+  return choices.length >= 2
+}
+
+export function agentMemoryKey(contextPath: string | undefined): string {
+  return `assistant-agent:${contextPath ?? ''}`
+}
+
+export function rememberedAgent(contextPath: string | undefined): string | undefined {
+  try {
+    return localStorage.getItem(agentMemoryKey(contextPath)) ?? undefined
+  } catch {
+    return undefined
+  }
+}
+
+export function rememberAgent(contextPath: string | undefined, agentId: string): void {
+  try {
+    localStorage.setItem(agentMemoryKey(contextPath), agentId)
+  } catch {
+    /* A browser that blocks storage still picks - it just asks again next time. */
+  }
+}
+
+const PROVIDER_LABEL: Record<string, string> = { openai: 'OpenAI', anthropic: 'Claude', gemini: 'Gemini' }
+
+/** `Claude · claude-sonnet-4-6` - what the picker shows beside a name. */
+export function agentDetail(choice: Pick<AgentChoice, 'provider' | 'model'>): string {
+  return `${PROVIDER_LABEL[choice.provider] ?? choice.provider} · ${choice.model}`
+}
+
+export function providerLabel(provider: string): string {
+  return PROVIDER_LABEL[provider] ?? provider
+}

package/client/utils/assistant-navigation.test.ts

@@ -2,25 +2,31 @@ import { surfaceTransition } from './assistant-navigation.js'
 import { readFileSync } from 'node:fs'
 import { join } from 'node:path'
 
-describe('a screen offers context without taking over an active conversation', () => {
-  test.each([false, true])('a different identity resets even when active=%s', active => {
+describe('the page decides the conversation - no choice is put to the person', () => {
+  test.each([false, true])('a different identity resets even when busy=%s', busy => {
     for (const sameSubject of [false, true]) {
-      expect(surfaceTransition({ identityChanged: true, sameSubject, active })).toBe('reset')
+      expect(surfaceTransition({ identityChanged: true, sameSubject, busy })).toBe('reset')
     }
   })
-  test('an empty conversation follows the screen', () => {
-    expect(surfaceTransition({ identityChanged: false, sameSubject: false, active: false })).toBe('follow')
+  test('★ another screen is followed - a conversation in progress or text being written does not hold the dock', () => {
+    expect(surfaceTransition({ identityChanged: false, sameSubject: false, busy: false })).toBe('follow')
   })
-  test('an existing conversation, draft or ongoing response offers a switch', () => {
-    expect(surfaceTransition({ identityChanged: false, sameSubject: false, active: true })).toBe('offer')
+  test('★ an answer in progress finishes in its own conversation first, then the dock follows', () => {
+    expect(surfaceTransition({ identityChanged: false, sameSubject: false, busy: true })).toBe('wait')
   })
   test('returning to the same subject refreshes without reopening', () => {
-    expect(surfaceTransition({ identityChanged: false, sameSubject: true, active: true })).toBe('refresh')
+    expect(surfaceTransition({ identityChanged: false, sameSubject: true, busy: true })).toBe('refresh')
   })
 })
 
 describe('navigation wiring', () => {
   const dock = readFileSync(join(__dirname, '../components/assistant-dock.ts'), 'utf8')
+  test('★ what was being written stays with its subject and comes back on return', () => {
+    expect(dock).toMatch(/if \(transition !== 'reset'\) this\.keepDraft\(\)/)
+    expect(dock).toContain('void this.restoreDraft()')
+    expect(dock).not.toContain('screenChanged')
+    expect(dock).not.toContain('switch-to-screen')
+  })
   test('history hides rather than unmounts the chat and its unsent input', () => {
     expect(dock).toContain('?hidden=${this.showingHistory}')
     expect(dock).toContain('ready && !this.loading && !this.failure')

package/client/utils/assistant-navigation.ts

@@ -1,6 +1,11 @@
-/** Screen changes offer a new subject; identity changes must never carry the old conversation. */
-export function surfaceTransition(input: { identityChanged: boolean; sameSubject: boolean; active: boolean }): 'reset' | 'refresh' | 'offer' | 'follow' {
+/**
+ * The page decides the conversation (design/ai/shared-dock.md §2-3, 2026-10-12): moving to another screen moves the
+ * dock to that screen's conversation, with no choice put to the person. What was being written stays with its subject
+ * and comes back on return. An answer in progress finishes first - then the dock follows. An identity change never
+ * carries the old conversation.
+ */
+export function surfaceTransition(input: { identityChanged: boolean; sameSubject: boolean; busy: boolean }): 'reset' | 'refresh' | 'wait' | 'follow' {
   if (input.identityChanged) return 'reset'
   if (input.sameSubject) return 'refresh'
-  return input.active ? 'offer' : 'follow'
+  return input.busy ? 'wait' : 'follow'
 }

package/client/utils/composer-frame.ts

@@ -20,8 +20,19 @@ export function composerHeight(content: number, chat: number, resting: number):
 
 export type ComposerKey = { key: string; shiftKey?: boolean; ctrlKey?: boolean; metaKey?: boolean; altKey?: boolean }
 
-/** What a key does in the box: send, close the wide box, or nothing of ours (the textarea keeps it). */
-export function composerKeyAction(e: ComposerKey, wide: boolean): 'send' | 'narrow' | null {
+/**
+ * What a key does in the box: send, close the wide box, take the suggestion, or nothing of ours (the textarea keeps
+ * it). The words shown in an empty box are a request the screen suggests - a plain Tab writes them in, so the person
+ * does not have to type what the screen already said.
+ */
+export function composerKeyAction(
+  e: ComposerKey,
+  wide: boolean,
+  box: { empty?: boolean; suggestion?: string } = {}
+): 'send' | 'narrow' | 'take-suggestion' | null {
+  if (e.key === 'Tab' && !e.shiftKey && !e.ctrlKey && !e.metaKey && !e.altKey && box.empty && box.suggestion?.trim()) {
+    return 'take-suggestion'
+  }
   if (e.key === 'Escape') return wide ? 'narrow' : null
   if (e.key !== 'Enter' || e.altKey) return null
   if (e.ctrlKey || e.metaKey) return 'send'
@@ -47,3 +58,18 @@ export function tableAsWords(table: { rows: string[][]; text?: string | null }):
 export function appendWords(written: string, words: string): string {
   return written.trim() ? `${written.replace(/\s+$/, '')}\n${words}` : words
 }
+
+/**
+ * The request the empty box suggests, which a Tab writes in: the conversation's first example request, its own
+ * before the host's. A placeholder is how to write, not a request, so it is never the suggestion. Once the
+ * conversation is under way an opening example no longer fits, and nothing is suggested.
+ */
+export function composerSuggestion(input: {
+  started: boolean
+  modeExamples?: Array<{ items: string[] }>
+  hostExamples?: Array<{ items: string[] }>
+}): string | undefined {
+  if (input.started) return undefined
+  const groups = input.modeExamples?.length ? input.modeExamples : input.hostExamples
+  return groups?.find(group => group.items.length > 0)?.items[0]
+}

package/client/utils/menu-room.ts

@@ -0,0 +1,33 @@
+/**
+ * The page's menu gives the dock its room (2026-10-12). When the dock opens beside the page, the left menu folds to its
+ * icons; when the dock closes, the menu opens again - only if it is still folded the way the dock left it. A menu the
+ * person folded themselves stays folded, and the dock's fold is never saved as the person's choice: it sets the menu's
+ * state without the menu's own `setCollapsed`, which stores it.
+ */
+export interface MenuLike {
+  collapsed: boolean
+}
+
+export function foldForDock(menu: MenuLike | undefined): boolean {
+  if (!menu || menu.collapsed) return false
+  menu.collapsed = true
+  return true
+}
+
+export function unfoldAfterDock(menu: MenuLike | undefined, foldedByDock: boolean): void {
+  if (!menu || !foldedByDock || !menu.collapsed) return
+  menu.collapsed = false
+}
+
+/** The framework's menu (`ox-menu-part` of @operato/menu), wherever the layout put it. */
+export function findMenu(root: Document | ShadowRoot = document): (HTMLElement & MenuLike) | undefined {
+  const found = root.querySelector('ox-menu-part') as (HTMLElement & MenuLike) | null
+  if (found) return found
+  for (const element of root.querySelectorAll('*')) {
+    if (element.shadowRoot) {
+      const inner = findMenu(element.shadowRoot)
+      if (inner) return inner
+    }
+  }
+  return undefined
+}

package/dist-client/bootstrap.d.ts

@@ -0,0 +1,8 @@
+import './settings/ai-agent-setting-let.js';
+import './settings/ai-usage-setting-let.js';
+/**
+ * Every application that carries the AI assistant gets its domain's AI agents and AI usage in Settings ›
+ * {domain} settings (design/ai/agent-settings.md §7). They are the domain's, not the person's, so they go on the
+ * tenant tab - and only for someone who may change the domain's settings, as the doors behind them require.
+ */
+export default function bootstrap(): void;

package/dist-client/bootstrap.js

@@ -0,0 +1,26 @@
+import { html } from 'lit';
+import { store } from '@operato/shell';
+import { auth, hasPrivilege } from '@things-factory/auth-base/dist-client/index.js';
+import { ADD_SETTING } from '@things-factory/setting-base/dist-client/index.js';
+import './settings/ai-agent-setting-let.js';
+import './settings/ai-usage-setting-let.js';
+/**
+ * Every application that carries the AI assistant gets its domain's AI agents and AI usage in Settings ›
+ * {domain} settings (design/ai/agent-settings.md §7). They are the domain's, not the person's, so they go on the
+ * tenant tab - and only for someone who may change the domain's settings, as the doors behind them require.
+ */
+export default function bootstrap() {
+    auth.on('profile', async () => {
+        if (!(await hasPrivilege({ privilege: 'mutation', category: 'setting', domainOwnerGranted: true })))
+            return;
+        store.dispatch({
+            type: ADD_SETTING,
+            setting: { seq: 60, scope: 'tenant', template: html `<ai-agent-setting-let></ai-agent-setting-let>` }
+        });
+        store.dispatch({
+            type: ADD_SETTING,
+            setting: { seq: 61, scope: 'tenant', template: html `<ai-usage-setting-let></ai-usage-setting-let>` }
+        });
+    });
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist-client/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../client/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,CAAA;AAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,gDAAgD,CAAA;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,mDAAmD,CAAA;AAE/E,OAAO,oCAAoC,CAAA;AAC3C,OAAO,oCAAoC,CAAA;AAE3C;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,SAAS;IAC/B,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,IAAI,EAAE;QAC5B,IAAI,CAAC,CAAC,MAAM,YAAY,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC,CAAC;YAAE,OAAM;QAE3G,KAAK,CAAC,QAAQ,CAAC;YACb,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAA,+CAA+C,EAAE;SACrG,CAAC,CAAA;QACF,KAAK,CAAC,QAAQ,CAAC;YACb,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAA,+CAA+C,EAAE;SACrG,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC","sourcesContent":["import { html } from 'lit'\nimport { store } from '@operato/shell'\nimport { auth, hasPrivilege } from '@things-factory/auth-base/dist-client/index.js'\nimport { ADD_SETTING } from '@things-factory/setting-base/dist-client/index.js'\n\nimport './settings/ai-agent-setting-let.js'\nimport './settings/ai-usage-setting-let.js'\n\n/**\n * Every application that carries the AI assistant gets its domain's AI agents and AI usage in Settings ›\n * {domain} settings (design/ai/agent-settings.md §7). They are the domain's, not the person's, so they go on the\n * tenant tab - and only for someone who may change the domain's settings, as the doors behind them require.\n */\nexport default function bootstrap() {\n  auth.on('profile', async () => {\n    if (!(await hasPrivilege({ privilege: 'mutation', category: 'setting', domainOwnerGranted: true }))) return\n\n    store.dispatch({\n      type: ADD_SETTING,\n      setting: { seq: 60, scope: 'tenant', template: html`<ai-agent-setting-let></ai-agent-setting-let>` }\n    })\n    store.dispatch({\n      type: ADD_SETTING,\n      setting: { seq: 61, scope: 'tenant', template: html`<ai-usage-setting-let></ai-usage-setting-let>` }\n    })\n  })\n}\n"]}

package/dist-client/components/assistant-chat.d.ts

@@ -298,6 +298,18 @@ export declare class OxAssistantChat extends LitElement {
         busy: boolean;
         draft: boolean;
     };
+    /**
+     * What is being written, handed to the host when the page moves to another subject - it belongs to the conversation
+     * it was written in, and comes back with `restoreDraft` when the person returns. The box is left empty.
+     */
+    takeDraft(): {
+        text: string;
+        attachments: ChatAttachment[];
+    } | undefined;
+    restoreDraft(draft: {
+        text: string;
+        attachments: ChatAttachment[];
+    }): void;
     private errorMessage?;
     /** C4 presence/roster — 세션 참여자 목록. lastSeenAt 으로 online 판정. */
     private participants;
@@ -356,6 +368,17 @@ export declare class OxAssistantChat extends LitElement {
     /** 이 subject 에 설 수 있는 대화들 — 기본이 먼저. 하나뿐이면 고르개를 그리지 않는다. */
     private modeChoices;
     private modeChoicesToken;
+    /** The AI agents this domain lets a person pick (design/ai/agent-settings.md §5). One or none draws no picker. */
+    private agentChoices;
+    private agentId?;
+    private agentChoicesToken;
+    private get contextPath();
+    /**
+     * Asks which agents this domain offers. The list changes when someone edits the domain's agents, so it is read
+     * again whenever the conversation's subject is - never cached for the life of the page.
+     */
+    private loadAgentChoices;
+    private onAgentPick;
     /**
      * 이 화면에 설 수 있는 대화를 서버에 묻는다.
      *
@@ -453,6 +476,8 @@ export declare class OxAssistantChat extends LitElement {
     private tableShape;
     private renderTablePreview;
     private onKeyDown;
+    /** The request a Tab writes into the empty box - `composerSuggestion` decides it. */
+    private get suggestion();
     /** input 이벤트 — value 즉시 반영 + popup 갱신은 150ms 디바운스 (F-Finder 와 동일).
      *  big board 에서 매 keystroke filter 비용 절감 + 한국어 IME 조합 중 깜빡임 완화. */
     private onTextareaInput;
@@ -497,8 +522,6 @@ export declare class OxAssistantChat extends LitElement {
      * 읽었고, 그러면 호스트 값을 한쪽만 반영하는 상태가 만들어질 수 있었다.
      */
     private get exampleGroups();
-    /** 이 표면이 실제로 쓸 수 있는 트리거 — 판정은 `chat-triggers.ts` 가 하고 여기서는 사실만 읽는다. */
-    private get triggerChips();
     private static readonly EXAMPLE_GROUPS;
     /** 보드의 세션 탭 — 다중 세션 활성화 시 패널 상단. host 가 sessions 비워두면 표시 X.
      *  레이블은 session.name 우선, 없으면 fallback "세션 N". */
@@ -525,14 +548,19 @@ export declare class OxAssistantChat extends LitElement {
      * 돌아온다.
      */
     private renderModeSubject;
+    /**
+     * Which AI answers the next turn - at the end of the row above the box, where the words about writing stand. A row of
+     * its own spent a line of the dock on one control. It is a property of the turn, not of the conversation: switching
+     * keeps the conversation and only the next answer comes from the other agent. Drawn only when there is a choice.
+     */
+    private renderAgentPicker;
+    private renderModePicker;
     private renderSessionTabs;
     /** C4 roster — 세션 참여자 + online 표시. 참여자 2명 미만이면 숨김(혼자면 의미 없음). */
     private renderRoster;
     private _onSessionTabClick;
     private _onSessionCreateClick;
     private renderEmpty;
-    /** trigger chip 클릭 — textarea 에 trigger 문자 삽입 + focus + popup 자동 활성. */
-    private insertTrigger;
     /** 예시 클릭 — 입력창에 채우고 포커스 (사용자가 수정 후 전송 가능) */
     private useExample;
     private renderInlineExamples;