@things-factory/ai-assistant 10.1.212 → 10.1.214

package/test/assistant-dock.test.ts

@@ -13,6 +13,7 @@ const code = (file: string) => read(file).replace(/\/\*[\s\S]*?\*\//g, '').repla
 const dock = code('../client/components/assistant-dock.ts')
 /* Not comment-stripped: the chat has strings like 'image/*' that a comment regex would eat. */
 const chat = read('../client/components/assistant-chat.ts')
+const transport = read('../client/utils/assistant-session-transport.ts')
 
 describe('no empty panel', () => {
   it('not configured, unreadable, no surface and a stuck anchor are each said', () => {
@@ -171,6 +172,20 @@ describe('what twin needed of the dock', () => {
     assert.match(dock, /this\.startCarried\(ask\)\.catch\(\(?\w*\)? => \{\s*notify\(\{ level: 'error'/)
   })
 
+  it('★ a request made on the screen is never dropped while an answer is written - it waits and is taken after', () => {
+    const busy = dock.slice(dock.indexOf('if (this.navigationState.busy) {', dock.indexOf('private async takeAsk')), dock.indexOf('if (this.navigationState.draft', dock.indexOf('private async takeAsk')))
+    assert.match(busy, /this\.takeWhenIdle\(\)\s*return/)
+    assert.doesNotMatch(busy, /takeAssistantAsk\(\)/)
+  })
+
+  it('★ unsent words are asked about before a new request takes the dock - never dropped without asking', () => {
+    assert.match(dock, /if \(this\.navigationState\.draft && !\(await this\.mayLeaveConversation\(\)\)\) \{\s*const waiting = takeAssistantAsk\(\)/)
+  })
+
+  it('a note is drawn without the line only the model reads', () => {
+    assert.match(chat, />\$\{noteForDisplay\(content\)\}<\/span/)
+  })
+
   it('★ and nothing is sent into the previous conversation after it - the request depended on the context that failed', () => {
     assert.match(dock, /this\.startCarried\(ask\)\.catch\([\s\S]*?return undefined\s*\}\)[\s\S]{0,200}?if \(!id\) return\n/)
   })
@@ -203,3 +218,61 @@ describe('closing and opening the dock again (design/ai/shared-dock.md §2-1, §
     assert.match(opening, /if \(this\.hasUpdated && this\.sessionId\) \{\s*this\.loadHistory\(\)\s*this\._startPresence\(\)\s*this\._startMessageSubscription\(\)/)
   })
 })
+
+/*
+ * A screen request (「AI와 작업」) - design/ai/shared-dock.md §2-11-1, the user (2026-10-24): 「"AI와 작업" 기능이 unstable
+ * 하다. 작동 방식을 신뢰할 수 있도록 새로운 세션을 여는지, 기존 세션을 활용하는지 등등을 명확하게 하라.」 One test per rule.
+ */
+describe('a screen request', () => {
+  const take = dock.slice(dock.indexOf('private async takeScreenRequest()'), dock.indexOf('\n  }\n', dock.indexOf('private async takeScreenRequest()')))
+  const send = chat.slice(chat.indexOf('async sendScreenRequest('), chat.indexOf('\n  }\n', chat.indexOf('async sendScreenRequest(')))
+
+  it('goes its own way - a request carrying a selection is a screen request', () => {
+    assert.match(dock, /if \(peekAssistantAsk\(\)\?\.selection\) return this\.takeScreenRequest\(\)/)
+  })
+
+  it('★ 1. to this screen\'s conversation - never a new one; another screen\'s conversation open comes back here', () => {
+    assert.doesNotMatch(take, /newConversation|startCarried|createAISession|controller\.reset|conversationView\+\+/)
+    assert.match(take, /if \(this\.scopeKey\(here\) !== this\.openedFor[^\n]*\) \{\s*(?:\/\*[^*]*\*\/\s*)?this\.keepDraft\(\)\s*this\.surface = here\s*await this\.open\(\)/)
+    assert.match(take, /this\.showingHistory = false/)
+    /* Someone else's open conversation the dock showed by default is not this person's - their own is started (draft along). */
+    assert.match(take, /if \(this\.sessions\.find\(one => one\.id === this\.sessionId\)\?\.participant === false\) await this\.goToOwnConversation\(\)/)
+    /* ...and that is their own most recent one here, a new one only when they have none. */
+    assert.match(dock, /const own = this\.sessions\.find\(one => one\.participant !== false && one\.id !== this\.sessionId\)/)
+    assert.match(dock, /if \(own\) \{\s*if \(this\.controller\.select\(own\.id\)\) this\.conversationView\+\+\s*\} else \{\s*await this\.controller\.reset\(\)/)
+    assert.match(transport, /participant\}\}/)
+    /* No conversation yet: the chat makes this screen's one on sending, through the controller - never a second. */
+    assert.match(send, /if \(!this\.sessionId && this\.prepareSession\) \{\s*await this\.prepareSession\(/)
+  })
+
+  it('★ 2. the selection is noted for that turn, before the request', () => {
+    assert.match(take, /chat\.sendScreenRequest\(request, selectionNote\(ask\.selection!, t\)\)/)
+    const noted = send.indexOf('APPEND_SESSION_NOTE_MUTATION')
+    assert.ok(noted > 0 && noted < send.indexOf('await this.send()'))
+  })
+
+  it('★ 3. sent, always - the request goes out, never as a draft', () => {
+    assert.match(send, /this\.input = text\s*await this\.send\(\)/)
+    assert.doesNotMatch(take, /asking|draft:/)
+    assert.match(take, /ask\.ask\?\.trim\(\) \|\| t\('screen-request-default'/)
+  })
+
+  it('★ 4. what the person was writing is set aside and put back', () => {
+    assert.match(send, /const kept = this\.takeDraft\(\)/)
+    assert.match(send, /finally \{[\s\S]*if \(kept && !this\.input\.trim\(\) && !this\.attachments\.length\) this\.restoreDraft\(kept\)/)
+    assert.match(send, /if \(this\.input\.trim\(\) === text\.trim\(\)\) this\.input = ''/)
+  })
+
+  it('★ 5. not sent: said, and the screen is told', () => {
+    assert.match(take, /const fail = \(reason: string\) => \{\s*notify\(\{ level: 'error', message: reason \}\)\s*settleAssistantAsk\(ask, \{ sent: false, reason \}\)/)
+    assert.match(take, /if \(!outcome\?\.sent\) return fail\(/)
+    assert.match(take, /settleAssistantAsk\(ask, \{ sent: true \}\)/)
+  })
+
+  it('★ 6. an answer being written: said once, and the request goes right after it', () => {
+    const busy = take.slice(take.indexOf('if (this.navigationState.busy)'), take.indexOf('const here'))
+    assert.match(busy, /notify\(\{ level: 'info', message: t\('screen-request-waits'/)
+    assert.match(busy, /this\.takeWhenIdle\(\)\s*return/)
+    assert.doesNotMatch(busy, /takeAssistantAsk\(\)/)
+  })
+})

package/translations/en.json

@@ -424,5 +424,29 @@
   "ai-assistant.text.invite-body-named": "{who} brought you into the conversation \"{name}\".",
   "ai-assistant.text.invite-body": "{who} brought you into a conversation.",
   "ai-assistant.text.board-invite-title": "Board collaboration invite",
-  "ai-assistant.text.board-invite-body": "{who} invited you to collaborate on a board."
+  "ai-assistant.text.board-invite-body": "{who} invited you to collaborate on a board.",
+  "ai-assistant.people.title": "People",
+  "ai-assistant.people.name": "Name",
+  "ai-assistant.people.department": "Department",
+  "ai-assistant.people.position": "Position",
+  "ai-assistant.people.responsibility": "Responsibility",
+  "ai-assistant.people.user": "User",
+  "ai-assistant.people.invite-one": "Invite {name} to this conversation",
+  "ai-assistant.people.invite-pick": "{count} people named {name} - pick whom to invite",
+  "ai-assistant.people.invited": "{names} joined this conversation and was told.",
+  "ai-assistant.dock.selection-note": "Selected {count} · {title}",
+  "ai-assistant.dock.selection-more": "and {count} more",
+  "ai-assistant.dock.screen-request-waits": "An answer is being written - your request goes right after it.",
+  "ai-assistant.dock.screen-request-not-ready": "The conversation is not ready yet. Try again in a moment.",
+  "ai-assistant.dock.screen-request-default": "Read the selected records and suggest what can be done with them now.",
+  "ai-assistant.dock.screen-request-failed": "The request was not sent. Try again.",
+  "ai-assistant.text.screen-request-busy": "an answer is still being written.",
+  "ai-assistant.text.screen-request-no-session": "this screen has no conversation to send to.",
+  "ai-assistant.selection.count": "{n} selected",
+  "ai-assistant.selection.request": "Describe what to do with these records",
+  "ai-assistant.selection.work-with-ai": "Work with AI",
+  "ai-assistant.selection.region": "Work with selection",
+  "ai-assistant.selection.pick-rows": "Select rows to work on with AI.",
+  "ai-assistant.selection.save-first": "Save or cancel pending edits before working with the selected rows.",
+  "ai-assistant.selection.ask": "Read the {n} selected records from {title} and suggest what can be done with them now."
 }

package/translations/es.json

@@ -424,5 +424,29 @@
   "ai-assistant.text.invite-body-named": "{who} te invitó a la conversación \"{name}\".",
   "ai-assistant.text.invite-body": "{who} te invitó a una conversación.",
   "ai-assistant.text.board-invite-title": "Invitación a colaborar en un tablero",
-  "ai-assistant.text.board-invite-body": "{who} te invitó a colaborar en un tablero."
+  "ai-assistant.text.board-invite-body": "{who} te invitó a colaborar en un tablero.",
+  "ai-assistant.people.title": "Personas",
+  "ai-assistant.people.name": "Nombre",
+  "ai-assistant.people.department": "Departamento",
+  "ai-assistant.people.position": "Cargo",
+  "ai-assistant.people.responsibility": "Responsabilidad",
+  "ai-assistant.people.user": "Usuario",
+  "ai-assistant.people.invite-one": "Invitar a {name} a esta conversación",
+  "ai-assistant.people.invite-pick": "Hay {count} personas llamadas {name}: elige a quién invitar",
+  "ai-assistant.people.invited": "{names} se unió a esta conversación y recibió un aviso.",
+  "ai-assistant.dock.selection-note": "{count} seleccionados · {title}",
+  "ai-assistant.dock.selection-more": "y {count} más",
+  "ai-assistant.dock.screen-request-waits": "Se está escribiendo una respuesta: tu solicitud se envía justo después.",
+  "ai-assistant.dock.screen-request-not-ready": "La conversación aún no está lista. Inténtalo de nuevo en un momento.",
+  "ai-assistant.dock.screen-request-default": "Lee los registros seleccionados y sugiere qué se puede hacer ahora.",
+  "ai-assistant.dock.screen-request-failed": "La solicitud no se envió. Inténtalo de nuevo.",
+  "ai-assistant.text.screen-request-busy": "todavía se está escribiendo una respuesta.",
+  "ai-assistant.text.screen-request-no-session": "esta pantalla no tiene una conversación a la que enviar.",
+  "ai-assistant.selection.count": "{n} seleccionados",
+  "ai-assistant.selection.request": "Describe qué hacer con estos registros",
+  "ai-assistant.selection.work-with-ai": "Trabajar con IA",
+  "ai-assistant.selection.region": "Trabajar con la selección",
+  "ai-assistant.selection.pick-rows": "Selecciona primero las filas con las que trabajar con la IA.",
+  "ai-assistant.selection.save-first": "Guarda o cancela las ediciones pendientes antes de trabajar con las filas seleccionadas.",
+  "ai-assistant.selection.ask": "Lee los {n} registros seleccionados de {title} y sugiere qué se puede hacer con ellos ahora."
 }

package/translations/ja.json

@@ -424,5 +424,29 @@
   "ai-assistant.text.invite-body-named": "{who} さんが会話「{name}」に招待しました。",
   "ai-assistant.text.invite-body": "{who} さんが会話に招待しました。",
   "ai-assistant.text.board-invite-title": "ボード共同作業への招待",
-  "ai-assistant.text.board-invite-body": "{who} さんがボードの共同作業に招待しました。"
+  "ai-assistant.text.board-invite-body": "{who} さんがボードの共同作業に招待しました。",
+  "ai-assistant.people.title": "メンバー",
+  "ai-assistant.people.name": "氏名",
+  "ai-assistant.people.department": "部署",
+  "ai-assistant.people.position": "役職",
+  "ai-assistant.people.responsibility": "担当",
+  "ai-assistant.people.user": "ユーザー",
+  "ai-assistant.people.invite-one": "{name} さんをこの会話に招待",
+  "ai-assistant.people.invite-pick": "{name} さんが {count} 人います — 招待する人を選んでください",
+  "ai-assistant.people.invited": "{names} さんがこの会話に参加し、通知を受けました。",
+  "ai-assistant.dock.selection-note": "選択 {count}件 · {title}",
+  "ai-assistant.dock.selection-more": "ほか {count}件",
+  "ai-assistant.dock.screen-request-waits": "回答を作成中です — 終わり次第リクエストを送ります。",
+  "ai-assistant.dock.screen-request-not-ready": "会話の準備がまだできていません。少し後でもう一度お試しください。",
+  "ai-assistant.dock.screen-request-default": "選択した記録を読んで、今できることをまとめて。",
+  "ai-assistant.dock.screen-request-failed": "リクエストを送れませんでした。もう一度お試しください。",
+  "ai-assistant.text.screen-request-busy": "まだ回答を作成中です。",
+  "ai-assistant.text.screen-request-no-session": "この画面には送信先の会話がありません。",
+  "ai-assistant.selection.count": "{n}件選択",
+  "ai-assistant.selection.request": "選択した項目にすることを入力してください",
+  "ai-assistant.selection.work-with-ai": "AIと作業",
+  "ai-assistant.selection.region": "選択項目の作業",
+  "ai-assistant.selection.pick-rows": "AIと作業する行を先に選択してください。",
+  "ai-assistant.selection.save-first": "編集中の内容を保存または取り消してから、選択した行で作業してください。",
+  "ai-assistant.selection.ask": "{title}で選択した{n}件を読んで、今できることをすぐ提案して。"
 }

package/translations/ko.json

@@ -424,5 +424,29 @@
   "ai-assistant.text.invite-body-named": "{who} 님이 \"{name}\" 대화에 초대했습니다.",
   "ai-assistant.text.invite-body": "{who} 님이 대화에 초대했습니다.",
   "ai-assistant.text.board-invite-title": "보드 협업 초대",
-  "ai-assistant.text.board-invite-body": "{who} 님이 보드 협업에 초대했습니다."
+  "ai-assistant.text.board-invite-body": "{who} 님이 보드 협업에 초대했습니다.",
+  "ai-assistant.people.title": "구성원",
+  "ai-assistant.people.name": "이름",
+  "ai-assistant.people.department": "부서",
+  "ai-assistant.people.position": "직책",
+  "ai-assistant.people.responsibility": "담당",
+  "ai-assistant.people.user": "사용자",
+  "ai-assistant.people.invite-one": "{name} 님을 이 대화에 초대",
+  "ai-assistant.people.invite-pick": "{name} 님이 {count}명입니다 — 초대할 사람을 고르세요",
+  "ai-assistant.people.invited": "{names} 님이 이 대화에 들어왔고 알림을 받았습니다.",
+  "ai-assistant.dock.selection-note": "선택 {count}건 · {title}",
+  "ai-assistant.dock.selection-more": "외 {count}건",
+  "ai-assistant.dock.screen-request-waits": "답을 쓰는 중입니다 — 끝나면 바로 요청을 보냅니다.",
+  "ai-assistant.dock.screen-request-not-ready": "대화가 아직 준비되지 않았습니다. 잠시 뒤 다시 눌러 주세요.",
+  "ai-assistant.dock.screen-request-default": "선택한 기록을 읽고 지금 할 수 있는 일을 정리해 줘.",
+  "ai-assistant.dock.screen-request-failed": "요청을 보내지 못했습니다. 다시 눌러 주세요.",
+  "ai-assistant.text.screen-request-busy": "아직 답을 쓰는 중입니다.",
+  "ai-assistant.text.screen-request-no-session": "이 화면에는 보낼 대화가 없습니다.",
+  "ai-assistant.selection.count": "{n}건 선택",
+  "ai-assistant.selection.request": "선택한 항목에 할 일을 적으세요",
+  "ai-assistant.selection.work-with-ai": "AI와 작업",
+  "ai-assistant.selection.region": "선택 항목 작업",
+  "ai-assistant.selection.pick-rows": "AI와 함께 작업할 행을 먼저 선택하세요.",
+  "ai-assistant.selection.save-first": "편집 중인 내용을 먼저 저장하거나 취소한 뒤 선택한 행으로 작업하세요.",
+  "ai-assistant.selection.ask": "{title}에서 선택한 {n}건을 읽고 지금 할 수 있는 일을 바로 제안해 줘."
 }

package/translations/ms.json

@@ -424,5 +424,29 @@
   "ai-assistant.text.invite-body-named": "{who} menjemput anda ke perbualan \"{name}\".",
   "ai-assistant.text.invite-body": "{who} menjemput anda ke sebuah perbualan.",
   "ai-assistant.text.board-invite-title": "Jemputan kerjasama papan",
-  "ai-assistant.text.board-invite-body": "{who} menjemput anda bekerjasama pada papan."
+  "ai-assistant.text.board-invite-body": "{who} menjemput anda bekerjasama pada papan.",
+  "ai-assistant.people.title": "Ahli",
+  "ai-assistant.people.name": "Nama",
+  "ai-assistant.people.department": "Jabatan",
+  "ai-assistant.people.position": "Jawatan",
+  "ai-assistant.people.responsibility": "Tanggungjawab",
+  "ai-assistant.people.user": "Pengguna",
+  "ai-assistant.people.invite-one": "Jemput {name} ke perbualan ini",
+  "ai-assistant.people.invite-pick": "{count} orang bernama {name} - pilih siapa yang hendak dijemput",
+  "ai-assistant.people.invited": "{names} telah menyertai perbualan ini dan dimaklumkan.",
+  "ai-assistant.dock.selection-note": "Dipilih {count} · {title}",
+  "ai-assistant.dock.selection-more": "dan {count} lagi",
+  "ai-assistant.dock.screen-request-waits": "Jawapan sedang ditulis - permintaan anda dihantar sejurus selepas itu.",
+  "ai-assistant.dock.screen-request-not-ready": "Perbualan belum sedia. Cuba lagi sebentar lagi.",
+  "ai-assistant.dock.screen-request-default": "Baca rekod yang dipilih dan cadangkan apa yang boleh dibuat sekarang.",
+  "ai-assistant.dock.screen-request-failed": "Permintaan tidak dihantar. Cuba lagi.",
+  "ai-assistant.text.screen-request-busy": "jawapan masih sedang ditulis.",
+  "ai-assistant.text.screen-request-no-session": "skrin ini tiada perbualan untuk dihantar.",
+  "ai-assistant.selection.count": "{n} dipilih",
+  "ai-assistant.selection.request": "Tulis apa yang perlu dibuat dengan rekod ini",
+  "ai-assistant.selection.work-with-ai": "Bekerja dengan AI",
+  "ai-assistant.selection.region": "Kerja dengan pilihan",
+  "ai-assistant.selection.pick-rows": "Pilih baris untuk diusahakan bersama AI dahulu.",
+  "ai-assistant.selection.save-first": "Simpan atau batalkan suntingan yang belum disimpan sebelum bekerja dengan baris yang dipilih.",
+  "ai-assistant.selection.ask": "Baca {n} rekod yang dipilih daripada {title} dan cadangkan apa yang boleh dibuat sekarang."
 }

package/translations/zh.json

@@ -424,5 +424,29 @@
   "ai-assistant.text.invite-body-named": "{who} 邀请你加入对话“{name}”。",
   "ai-assistant.text.invite-body": "{who} 邀请你加入对话。",
   "ai-assistant.text.board-invite-title": "看板协作邀请",
-  "ai-assistant.text.board-invite-body": "{who} 邀请你协作编辑看板。"
+  "ai-assistant.text.board-invite-body": "{who} 邀请你协作编辑看板。",
+  "ai-assistant.people.title": "成员",
+  "ai-assistant.people.name": "姓名",
+  "ai-assistant.people.department": "部门",
+  "ai-assistant.people.position": "职位",
+  "ai-assistant.people.responsibility": "职责",
+  "ai-assistant.people.user": "用户",
+  "ai-assistant.people.invite-one": "邀请 {name} 加入此对话",
+  "ai-assistant.people.invite-pick": "有 {count} 位 {name} — 请选择要邀请的人",
+  "ai-assistant.people.invited": "{names} 已加入此对话并收到通知。",
+  "ai-assistant.dock.selection-note": "已选 {count} 条 · {title}",
+  "ai-assistant.dock.selection-more": "等另外 {count} 条",
+  "ai-assistant.dock.screen-request-waits": "正在生成回答 — 完成后立即发送你的请求。",
+  "ai-assistant.dock.screen-request-not-ready": "对话尚未就绪，请稍后再试。",
+  "ai-assistant.dock.screen-request-default": "读取所选记录，并整理现在可以做的事。",
+  "ai-assistant.dock.screen-request-failed": "请求未发送，请重试。",
+  "ai-assistant.text.screen-request-busy": "回答仍在生成中。",
+  "ai-assistant.text.screen-request-no-session": "此页面没有可发送的对话。",
+  "ai-assistant.selection.count": "已选择 {n} 条",
+  "ai-assistant.selection.request": "请写下要对所选记录做什么",
+  "ai-assistant.selection.work-with-ai": "与 AI 协作",
+  "ai-assistant.selection.region": "所选记录操作",
+  "ai-assistant.selection.pick-rows": "请先选择要与 AI 一起处理的行。",
+  "ai-assistant.selection.save-first": "请先保存或取消正在编辑的内容，再处理所选行。",
+  "ai-assistant.selection.ask": "读取在{title}中选择的{n}条记录，并立即提出现在可以做的事。"
 }