@things-factory/ai-assistant 10.1.213 → 10.1.214

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/ai-assistant",
-  "version": "10.1.213",
+  "version": "10.1.214",
   "main": "dist-server/index.js",
   "things-factory": true,
   "author": "heartyoh",
@@ -55,5 +55,5 @@
     "copyfiles": "^2.4.1",
     "rimraf": "^5.0.0"
   },
-  "gitHead": "81f23aa18cb584c7d8185e81cca0d688f509cf8c"
+  "gitHead": "15a9f9b0b21a3ad50159d4a4f81e861362f6ef72"
 }

package/server/service/assistant-chat-resolver.ts

@@ -54,7 +54,7 @@ import { attachmentForModel, describeAttachment, findChatAttachment } from './ch
 import { readTurnAttachments } from './chat-session/turn-attachments.js'
 import { getAssistantMode } from './assistant-mode/registry.js'
 import { resolveModeSettings } from './assistant-mode/resolve.js'
-import { modeFrontCategories } from './assistant-mode/mode-categories.js'
+import { modeFrontCategories, selectionAxesOf } from './assistant-mode/mode-categories.js'
 import { usedToolNames } from './chat-message/used-tools.js'
 import { splitNextRequest } from './assistant-mode/screen-rules.js'
 import { requestTranslator } from './request-translator.js'
@@ -511,13 +511,15 @@ export class AssistantChatResolver {
       systemPrompt,
       toolCategories: settings.toolCategories,
       /*
-       * What goes in front when the mode's tools do not fit in one call (ADR-0061 decision 9): the open page's and the
-       * anchored record's, then what this conversation used. The anchor is the stored one, never the client's.
+       * What goes in front when the mode's tools do not fit in one call (ADR-0061 decision 9): the open page's, the
+       * anchored record's and the latest selection's, then what this conversation used. The anchor and the selection are
+       * the stored ones, never the client's.
        */
       front: {
         categories: modeFrontCategories(getAssistantMode(input.mode.kind) ?? {}, {
           page: input.page,
-          subjectAxis: (session as any)?.anchorType === 'subject' ? String((session as any).anchorId ?? '').split(':')[0] || undefined : undefined
+          subjectAxis: (session as any)?.anchorType === 'subject' ? String((session as any).anchorId ?? '').split(':')[0] || undefined : undefined,
+          selectionAxes: selectionAxesOf(storedRows as any)
         }),
         tools: usedToolNames(storedRows as any, [OPEN_TOOLS])
       },

package/server/service/assistant-mode/mode-categories.ts

@@ -61,6 +61,31 @@ export interface TurnScreen {
   page?: string
   /** The axis of the record the conversation is anchored to (`contract` of `subject` · `contract:<id>`), from the stored anchor. */
   subjectAxis?: string
+  /** The axes of the records the latest selection named (`contract` of `[keys] contracts contract:<id>`) - `selectionAxesOf`. */
+  selectionAxes?: string[]
+}
+
+/** The line of a selection note the model reads - the client's `SELECTION_KEYS_PREFIX` (assistant-selection.ts). */
+export const SELECTION_KEYS_LINE = '[keys]'
+
+/**
+ * The axes of the records the latest selection note names (「AI와 작업」, shared-dock §2-11-1): a list hands its rows as
+ * `<axis>:<uuid>`, so the rows' list is read with the tool of that axis. Put in front like an anchored record's - picked
+ * on 미수금, the contracts' read was not in front, and the model looked for them among attachments and a dashboard's cards
+ * before it opened the right tool (2026-10-25). A note is the server's (`appendSessionNote`, system); a person's words
+ * are never read for it.
+ */
+export function selectionAxesOf(rows: { role?: string; content?: string | null }[]): string[] {
+  for (let i = rows.length - 1; i >= 0; i--) {
+    if (rows[i].role !== 'system') continue
+    const line = String(rows[i].content ?? '')
+      .split('\n')
+      .find(one => one.startsWith(SELECTION_KEYS_LINE))
+    if (!line) continue
+    const keys = line.slice(SELECTION_KEYS_LINE.length).trim().split(/\s+/)
+    return [...new Set(keys.map(one => one.match(/^([a-z0-9-]+):/)?.[1]).filter((one): one is string => !!one))]
+  }
+  return []
 }
 
 type FrontMode = { toolCategories?: string[]; attachments?: { kinds?: string[] }; entryTargets?: string[]; readTargets?: string[] }
@@ -72,7 +97,12 @@ type FrontMode = { toolCategories?: string[]; attachments?: { kinds?: string[] }
  */
 export function screenTargetKeys(mode: FrontMode, screen: TurnScreen, routeOf: (key: string) => string | undefined = key => readTargetOf(key)?.screen?.route): string[] {
   const keys = [...new Set([...(mode.readTargets ?? []), ...(mode.entryTargets ?? [])])]
-  return keys.filter(key => (!!screen.page && routeOf(key) === screen.page) || (!!screen.subjectAxis && axesOfKey(mode, key).includes(screen.subjectAxis)))
+  return keys.filter(
+    key =>
+      (!!screen.page && routeOf(key) === screen.page) ||
+      (!!screen.subjectAxis && axesOfKey(mode, key).includes(screen.subjectAxis)) ||
+      (!!screen.selectionAxes?.length && axesOfKey(mode, key).some(axis => screen.selectionAxes!.includes(axis)))
+  )
 }
 
 /** The records a key is about: its last part, and the axes a card joins or a whole answer covers (EntryTarget.axes · DetailRead.axes). */

package/server/service/assistant-mode/mode-front.test.ts

@@ -4,7 +4,9 @@
  */
 import { clearReadTargets, declareDetailRead, declareReadTarget } from '../data-read/read-target'
 import { listReadTarget } from '../data-read/list-read'
-import { modeFrontCategories, modeScreens, screenTargetKeys } from './mode-categories'
+import { modeFrontCategories, modeScreens, screenTargetKeys, selectionAxesOf, SELECTION_KEYS_LINE } from './mode-categories'
+import { readFileSync } from 'node:fs'
+import { join } from 'node:path'
 import { clearEntryTargets, declareEntryTarget } from '../data-entry/entry-target'
 
 const list = (key: string, route?: string) =>
@@ -42,6 +44,30 @@ describe('the open screen decides what goes in front', () => {
     expect(screenTargetKeys(mode, { subjectAxis: 'contract-round' })).toEqual(['office.contract-round'])
   })
 
+  it('★ the rows a person picked put their list in front - by the axis of their keys, from the latest note only', () => {
+    const rows = [
+      { role: 'system', content: 'Selected 1 · 미수금: H1\n[keys] contracts contract:a1' },
+      { role: 'user', content: '[keys] loans loan:x - typed by a person, never read for it' },
+      { role: 'system', content: 'Selected 2 · 입출금: A, B\n[keys] transactions cash-transaction:b1 cash-transaction:b2' }
+    ]
+    expect(selectionAxesOf(rows)).toEqual(['cash-transaction'])
+    expect(selectionAxesOf(rows.slice(0, 2))).toEqual(['contract'])
+    expect(selectionAxesOf([{ role: 'system', content: 'Selected 1 · L\n[keys] rows a1' }])).toEqual([])
+    expect(selectionAxesOf([])).toEqual([])
+    expect(screenTargetKeys(mode, { selectionAxes: ['contract'] })).toEqual(['office.contract'])
+    expect(modeFrontCategories(mode, { page: 'receivable-page', selectionAxes: ['contract'] })).toEqual(expect.arrayContaining(['data-read:office.contract', 'data-entry:office.contract']))
+  })
+
+  it('★ a turn puts the stored conversation\'s selection in front - never the client\'s', () => {
+    const resolver = readFileSync(join(__dirname, '../assistant-chat-resolver.ts'), 'utf-8')
+    expect(resolver).toMatch(/modeFrontCategories\([\s\S]{0,400}selectionAxes: selectionAxesOf\(storedRows as any\)/)
+  })
+
+  it('the note\'s key line is the one the client writes', () => {
+    const client = readFileSync(join(__dirname, '../../../client/utils/assistant-selection.ts'), 'utf-8')
+    expect(client).toContain(`export const SELECTION_KEYS_PREFIX = '${SELECTION_KEYS_LINE}'`)
+  })
+
   it('★ a record the mode does not read or enter is not put in front', () => {
     expect(modeFrontCategories({ ...mode, readTargets: [], entryTargets: [] }, { page: 'cash-transaction-list' })).toEqual(['office-ops', 'assistant-workspace', 'data-read:organization.employee', 'chat-invite', 'chat-attachments'])
   })

package/translations/en.json

@@ -441,5 +441,12 @@
   "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.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

@@ -441,5 +441,12 @@
   "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.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

@@ -441,5 +441,12 @@
   "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.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

@@ -441,5 +441,12 @@
   "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.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

@@ -441,5 +441,12 @@
   "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.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

@@ -441,5 +441,12 @@
   "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.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}条记录，并立即提出现在可以做的事。"
 }