@things-factory/ai-assistant 10.1.223 → 10.1.227

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/ai-assistant",
-  "version": "10.1.223",
+  "version": "10.1.227",
   "main": "dist-server/index.js",
   "things-factory": true,
   "author": "heartyoh",
@@ -35,25 +35,27 @@
     "@operato/shell": "^10.29.39",
     "@operato/styles": "^10.0.0",
     "@operato/utils": "^10.29.39",
-    "@things-factory/ai-client-base": "^10.1.223",
-    "@things-factory/apptool-base": "^10.1.221",
-    "@things-factory/attachment-base": "^10.1.223",
-    "@things-factory/auth-base": "^10.1.223",
+    "@things-factory/ai-client-base": "^10.1.227",
+    "@things-factory/apptool-base": "^10.1.227",
+    "@things-factory/attachment-base": "^10.1.227",
+    "@things-factory/auth-base": "^10.1.227",
     "@things-factory/env": "^10.1.149",
-    "@things-factory/setting-base": "^10.1.223",
-    "@things-factory/shell": "^10.1.208",
+    "@things-factory/setting-base": "^10.1.227",
+    "@things-factory/shell": "^10.1.227",
     "dompurify": "^3.0.0",
     "exceljs": "4.2.0",
     "graphql-scalars": "^1.22.0",
     "graphql-tag": "^2.12.6",
     "graphql-upload": "^15.0.2",
+    "jszip": "^3.10.1",
     "lit": "^3.1.2",
-    "marked": "^15.0.0"
+    "marked": "^15.0.0",
+    "pdfjs-dist": "5.7.284"
   },
   "browser": "dist-client/index.js",
   "devDependencies": {
     "copyfiles": "^2.4.1",
     "rimraf": "^5.0.0"
   },
-  "gitHead": "868f2026b8373371ad04f42b0a097964d0d0ed0f"
+  "gitHead": "f66591e3864aab08a6fb93fb1fcf1c9de6b546ac"
 }

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

@@ -58,7 +58,7 @@ class AssistantModeView {
 
   @Field(() => GraphQLJSON, {
     nullable: true,
-    description: "What this conversation accepts as attachments: { kinds: ('image'|'text'|'spreadsheet')[], maxBytes, maxFiles, maxChars }. Null: none."
+    description: "What this conversation accepts as attachments: { kinds: ('image'|'text'|'spreadsheet'|'document')[], maxBytes, maxFiles, maxChars }. Null: none."
   })
   attachments?: any
 }

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

@@ -44,12 +44,12 @@ export function turnSystemPrompt(modePrompt: string, screen: { page?: string; su
 }
 
 /**
- * The categories a mode opens: its own, the AI 작업판 (design/ai/workspace.md), the attachment reader when it
+ * The categories a mode opens: its own, the AI 작업 패널 (design/ai/workspace.md), the attachment reader when it
  * takes files (design/ai/shared-dock.md §9-4), and one propose tool per record it may enter (design/ai/data-entry.md).
  */
 export function modeToolCategories(mode: { toolCategories?: string[]; attachments?: { kinds?: string[] }; entryTargets?: string[]; readTargets?: string[] }): string[] | undefined {
   const extra = [
-    /* Every conversation may put a large result on the AI 작업판 (design/ai/workspace.md). */
+    /* Every conversation may put a large result on the AI 작업 패널 (design/ai/workspace.md). */
     'assistant-workspace',
     /* Every conversation may read who works here and offer to bring one of them in (people/, ADR-0073 decision 3). */
     ...PEOPLE_CATEGORIES,
@@ -64,7 +64,7 @@ export function modeToolCategories(mode: { toolCategories?: string[]; attachment
 /**
  * The categories an unattended run of a mode opens: its own and the lists it reads (design/ai/unattended-run.md §3).
  *
- * Not the 입력안 tools - nobody is there to press the card - nor the AI 작업판 or the attachment reader: there is no
+ * Not the 입력안 tools - nobody is there to press the card - nor the AI 작업 패널 or the attachment reader: there is no
  * conversation for a card or a file to belong to.
  */
 export function unattendedToolCategories(mode: { toolCategories?: string[]; readTargets?: string[] }): string[] {
@@ -129,7 +129,7 @@ function axesOfKey(mode: FrontMode, key: string): string[] {
 }
 
 /**
- * The categories a turn puts in front when the mode's tools do not fit in one call: the mode's own, the AI 작업판, the
+ * The categories a turn puts in front when the mode's tools do not fit in one call: the mode's own, the AI 작업 패널, the
  * people list and the invite card, the attachment reader, and the open screen's records. The rest the model opens with `openTools`.
  */
 export function modeFrontCategories(mode: FrontMode, screen: TurnScreen = {}): string[] {

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

@@ -72,7 +72,7 @@ describe('the open screen decides what goes in front', () => {
     expect(modeFrontCategories({ ...mode, readTargets: [], entryTargets: [] }, { page: 'cash-transaction-list' })).toEqual(['office-ops', 'assistant-workspace', 'data-read:organization.employee', 'chat-invite', 'chat-attachments'])
   })
 
-  it('no screen: the mode\'s own, the AI 작업판 and the attachment reader', () => {
+  it('no screen: the mode\'s own, the AI 작업 패널 and the attachment reader', () => {
     expect(modeFrontCategories(mode)).toEqual(['office-ops', 'assistant-workspace', 'data-read:organization.employee', 'chat-invite', 'chat-attachments'])
     expect(modeFrontCategories(mode, { page: 'some-other-page' })).toEqual(['office-ops', 'assistant-workspace', 'data-read:organization.employee', 'chat-invite', 'chat-attachments'])
   })

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

@@ -35,7 +35,7 @@ it('★ the settings come from the registered mode', () => {
   expect(settings).toEqual({
     /* The app's persona, then the rules every conversation follows (design/ai/screen-pattern.md §4). */
     systemPrompt: conversationPrompt('you answer about one space'),
-    /* Every conversation may put a large result on the AI 작업판 (design/ai/workspace.md). */
+    /* Every conversation may put a large result on the AI 작업 패널 (design/ai/workspace.md). */
     toolCategories: ['twin-ops', 'assistant-workspace', 'data-read:organization.employee', 'chat-invite'],
     requireToolOnFirstTurn: true,
     temperature: 0.2,

package/server/service/chat-session/attachment-policy.ts

@@ -7,10 +7,12 @@
  */
 
 /*
- * 'spreadsheet' is a kind a mode opens, never a file the door receives: the screen reads each .xlsx sheet into CSV
- * text before sending (client/utils/spreadsheet-text.ts), so a mode that takes spreadsheets takes that text.
+ * 'spreadsheet' and 'document' are kinds a mode opens, never files the door receives: the screen reads each .xlsx sheet
+ * into CSV text (client/utils/spreadsheet-text.ts), and each PDF, .docx and .pptx into text with its page and slide
+ * numbers (client/utils/document-text.ts) before sending, so a mode that takes them takes that text. A scanned PDF
+ * page arrives as an image, which the mode takes as 'image'.
  */
-export type AttachmentKind = 'image' | 'text' | 'spreadsheet'
+export type AttachmentKind = 'image' | 'text' | 'spreadsheet' | 'document'
 
 export interface AttachmentPolicy {
   kinds: AttachmentKind[]
@@ -47,9 +49,9 @@ export type AttachmentRefusal =
   | { code: 'too-many-attachments'; maxFiles: number }
 
 /** `null` when every file may go; otherwise the first reason, by name - said before sending, never cut silently. */
-/** A kind the policy takes - text also when it takes spreadsheets, which arrive as the text of their sheets. */
+/** A kind the policy takes - text also when it takes spreadsheets or documents, which arrive as their text. */
 function takes(policy: AttachmentPolicy, kind: AttachmentKind): boolean {
-  return policy.kinds.includes(kind) || (kind === 'text' && policy.kinds.includes('spreadsheet'))
+  return policy.kinds.includes(kind) || (kind === 'text' && (policy.kinds.includes('spreadsheet') || policy.kinds.includes('document')))
 }
 
 /** The characters of a text file the model reads under this policy. */

package/server/service/data-entry/entry-apply.ts

@@ -59,7 +59,7 @@ export interface EntryApplyDeps {
   execute(document: string, variables: Record<string, unknown>): Promise<{ data?: any; errors?: readonly { message: string }[] }>
   state: any
   report?(message: string, error: unknown): void
-  /** The fingerprint of what the AI 작업판 showed, when the person reviewed it there - entered only if the proposal is still that one. */
+  /** The fingerprint of what the AI 작업 패널 showed, when the person reviewed it there - entered only if the proposal is still that one. */
   reviewedHash?: string
 }
 
@@ -101,7 +101,7 @@ export async function applyEntryProposal(key: string, deps: EntryApplyDeps, targ
   if (proposal.kind !== 'entry') return nothing('refused', 'not-an-entry-proposal')
   if (superseded) return nothing('refused', 'superseded')
   if (deps.answered) return nothing('refused', 'already-answered')
-  /* What the 작업판 showed and what is entered are one proposal (design/ai/workspace.md §6-1). */
+  /* What the 작업 패널 showed and what is entered are one proposal (design/ai/workspace.md §6-1). */
   if (deps.reviewedHash && deps.reviewedHash !== entryProposalHash(proposal)) return nothing('refused', 'review-stale')
 
   const target = targetOf(proposal.target)

package/server/service/data-entry/entry-hash.ts

@@ -1,5 +1,5 @@
 /*
- * One 입력안's fingerprint - what the AI 작업판 showed and what the card enters are the same proposal
+ * One 입력안's fingerprint - what the AI 작업 패널 showed and what the card enters are the same proposal
  * (operato-application/design/ai/workspace.md §6-1). The screen's copy and the server's are one rule;
  * `test/entry-hash-agree.test.ts` runs both over one table.
  *

package/server/service/data-read/read-target.ts

@@ -4,7 +4,7 @@
  * The application declares what it lets the assistant read: its list query, the conditions the model may set and
  * how each becomes one of the query's filters, the columns to show, and the screen that lists the same records.
  * The framework reads the rows through that query with the person's request state - the same @privilege and
- * domain as the screen - counts and sums them itself, and puts a long result on the AI 작업판 as the query returned
+ * domain as the screen - counts and sums them itself, and puts a long result on the AI 작업 패널 as the query returned
  * it. The model is told the count, the sums and a few rows; it never copies a table.
  *
  * Pure but for the GraphQL runner, which comes in as an argument - the rules are tested without a server.
@@ -101,7 +101,7 @@ export interface ReadTarget {
   mine?: boolean
 }
 
-/** At most this many rows are read - the AI 작업판 table's own limit (workspace-blocks MAX_TABLE_ROWS). */
+/** At most this many rows are read - the AI 작업 패널 table's own limit (workspace-blocks MAX_TABLE_ROWS). */
 export const MAX_READ_ROWS = 1000
 /** Rows the model is shown; the rest stay on the card. */
 export const ROWS_FOR_MODEL = 20

package/server/service/data-read/read-tools.ts

@@ -2,7 +2,7 @@
  * The tools of an AI 조회 target (operato-application/design/ai/read-targets.md §4, §5).
  *
  * query<X> reads the rows through the application's list query as the person, and tells the model the count, the
- * sums, the groups and a few rows. A longer result goes on the AI 작업판 as a proposal the server builds from the rows
+ * sums, the groups and a few rows. A longer result goes on the AI 작업 패널 as a proposal the server builds from the rows
  * themselves - the table is never written by the model. open<X>Screen reads nothing: it hands the card the address
  * of the application's list screen with the conditions it takes.
  */
@@ -145,7 +145,7 @@ export async function queryRecords(target: ReadTarget, args: any, context: any,
     label: title,
     ...said,
     forScreen: { workspace, contents: workspaceContents(workspace!) },
-    message: `${rows.length} rows of ${total} are on the AI 작업판 as read - the person opens it from the card.${incomplete} Say the point in one or two lines from the sums, groups and rows above; do not write the table out.`
+    message: `${rows.length} rows of ${total} are on the AI 작업 패널 as read - the person opens it from the card.${incomplete} Say the point in one or two lines from the sums, groups and rows above; do not write the table out.`
   }
 }
 
@@ -186,14 +186,14 @@ export function readCategoryOf(target: ReadTarget, run: (context: any) => Graphq
       doors: [door],
       description:
         `Read ${target.description} Set the conditions the question names. Returns the count, the sums, ` +
-        `groups when groupBy is given (a date column groups by month) and the first ${ROWS_FOR_MODEL} rows; more rows go on the AI 작업판 as read.`,
+        `groups when groupBy is given (a date column groups by month) and the first ${ROWS_FOR_MODEL} rows; more rows go on the AI 작업 패널 as read.`,
       schema: {
         type: 'object',
         properties: {
           id: { type: 'string', description: 'One record by its id, from an earlier answer - its detail.' },
           ...conditions,
           groupBy: { type: 'string', description: `One column to group by: ${target.columns.map(one => one.name).join(', ')}.` },
-          show: { type: 'string', enum: ['answer', 'workspace'], description: 'workspace to put even a short result on the AI 작업판.' },
+          show: { type: 'string', enum: ['answer', 'workspace'], description: 'workspace to put even a short result on the AI 작업 패널.' },
           title: { type: 'string', description: 'The workspace title, in the person\'s language.' },
           name: { type: 'string', description: 'The workspace key; the same key again makes a new version.' }
         }
@@ -218,7 +218,7 @@ export function readCategoryOf(target: ReadTarget, run: (context: any) => Graphq
     description: `data read: ${target.key}`,
     guidance: [
       `- To answer from ${target.key} records - a list, or one record found by its name, code or id - call ${queryToolName(target.key)} with the conditions the question names. Every number you say comes from its result - never add up rows yourself; use its sums and groups.`,
-      `- A list, a summary by item or month, or a comparison: call it with groupBy, and let a long result go on the AI 작업판 - then answer in one or two lines.`,
+      `- A list, a summary by item or month, or a comparison: call it with groupBy, and let a long result go on the AI 작업 패널 - then answer in one or two lines.`,
       `- When the result says complete: false, say how many of how many were read and ask to narrow - never call partial sums the total.`,
       ...(target.columns.some(one => one.currency)
         ? [`- Sums of ${target.columns.filter(one => one.currency).map(one => one.name).join(', ')} come per currency. Say each currency's sum; never add two currencies into one number. A comparison across currencies uses a rate you read, and says the rate and its date.`]

package/server/service/data-read/read-words.test.ts

@@ -84,7 +84,7 @@ describe('the read tool', () => {
     expect(result.legend).toEqual({ kind: { HR: '인사', EVENT: '행사' }, state: { unread: '안 읽음' } })
   })
 
-  it('★ the 작업판 table shows the words', async () => {
+  it('★ the 작업 패널 table shows the words', async () => {
     const result: any = await queryRecords(target, { show: 'workspace' }, context, run)
     const table = result.forScreen.workspace.blocks.find((one: any) => one.kind === 'table')
     expect(table.rows[0]).toMatchObject({ kind: '인사', state: '안 읽음', publishedAt: '2026-10-26 09:09' })

package/server/service/index.ts

@@ -40,7 +40,7 @@ export * from './data-read/read-target.js'
 export { registerReadTarget, readCategoryOf, registerDetailRead, detailCategoryOf, runDetail, type DetailRun } from './data-read/read-tools.js'
 export * from './data-read/list-read.js'
 export * from './people/index.js'
-/* The AI 작업판 - large results on a page of their own (design/ai/workspace.md). */
+/* The AI 작업 패널 - large results on a page of their own (design/ai/workspace.md). */
 export * from './workspace/workspace-blocks.js'
 /* 무엇이 근거인가 — 도구 결과 밖의 셋(프롬프트 · 대화 · 화면 스냅숏). */
 export * from './grounding-sources.js'

package/server/service/people/index.ts

@@ -1,6 +1,6 @@
 /*
  * The people tools every conversation carries - the people list (people-read.ts) and the invite card (invite-tools.ts).
- * Registered once, at boot, as the AI 작업판 is.
+ * Registered once, at boot, as the AI 작업 패널 is.
  */
 import { registerReadTarget } from '../data-read/read-tools.js'
 import { peopleReadTarget } from './people-read.js'

package/server/service/unattended-run/run-unattended.test.ts

@@ -197,7 +197,7 @@ describe('§3 what runs, and what is kept', () => {
     expect(seen).toHaveLength(2)
   })
 
-  it('★ only the mode\'s own reads are offered - no 입력안, no 작업판, and none behind a door the owner cannot pass', async () => {
+  it('★ only the mode\'s own reads are offered - no 입력안, no 작업 패널, and none behind a door the owner cannot pass', async () => {
     const { client, seen } = scriptedModel([said('drafted')])
     await runAssistantUnattended(input(), deps({ model: client }))
     expect(seen[0].tools.map((tool: any) => tool.name).sort()).toEqual(['readCard', 'readGoals', 'readSales'])

package/server/service/workspace/workspace-blocks.ts

@@ -1,5 +1,5 @@
 /*
- * The AI 작업판 - what a workspace is made of (operato-application/design/ai/workspace.md §3).
+ * The AI 작업 패널 - what a workspace is made of (operato-application/design/ai/workspace.md §3).
  *
  * The model does not write HTML. A workspace is a list of blocks of known kinds; the screen draws each, so
  * theme, language and accessibility are the framework's. A block that does not fit is not dropped: it is

package/server/service/workspace/workspace-tools.ts

@@ -1,5 +1,5 @@
 /*
- * showInWorkspace - the model puts a large result on the AI 작업판 (operato-application/design/ai/workspace.md §5).
+ * showInWorkspace - the model puts a large result on the AI 작업 패널 (operato-application/design/ai/workspace.md §5).
  *
  * The result rides on the answer as a proposal of kind 'workspace', so the conversation's gates hold for it:
  * who may read the conversation reads the workspace, and a value behind a door the reader cannot pass hides

package/server/service/workspace/workspace.test.ts

@@ -1,5 +1,5 @@
 /*
- * The AI 작업판 (design/ai/workspace.md) - what a block may be, what happens to one that is not, and what the
+ * The AI 작업 패널 (design/ai/workspace.md) - what a block may be, what happens to one that is not, and what the
  * tool hands back.
  */
 import { normalizeWorkspace, workspaceName, MAX_SERIES } from './workspace-blocks'

package/test/attachment-policy-agree.test.ts

@@ -5,13 +5,16 @@
 import * as server from '../server/service/chat-session/attachment-policy'
 import * as screen from '../client/utils/attachment-policy'
 
-const policies = [undefined, { kinds: [] }, { kinds: ['image'] }, { kinds: ['image', 'text'], maxBytes: 100, maxFiles: 2 }] as any[]
+/* A document arrives as its text (and a scanned page as an image) - the door sees what the screen sends, never the PDF. */
+const policies = [undefined, { kinds: [] }, { kinds: ['image'] }, { kinds: ['image', 'text'], maxBytes: 100, maxFiles: 2 }, { kinds: ['document'] }, { kinds: ['image', 'document'] }] as any[]
 const fileSets = [
   [],
   [{ name: 'a.png', type: 'image/png', size: 10 }],
   [{ name: 'a.csv', type: 'text/csv', size: 10 }],
   [{ name: 'report.CSV', type: '', size: 10 }],
   [{ name: 'a.pdf', type: 'application/pdf', size: 10 }],
+  [{ name: 'a.pdf.txt', type: 'text/plain', size: 10 }],
+  [{ name: 'a.pdf - p2.jpg', type: 'image/jpeg', size: 10 }],
   [{ name: 'big.png', type: 'image/png', size: 101 }],
   [{ name: 'a.png', type: 'image/png', size: 1 }, { name: 'b.png', type: 'image/png', size: 1 }, { name: 'c.png', type: 'image/png', size: 1 }],
   /* Mixed batches: the same "no" in the same order - kind, then size, then one too many, file by file. */

package/test/document-text.test.ts

@@ -0,0 +1,175 @@
+/*
+ * A document read into the text a conversation carries (design/ai/shared-dock.md §9-6): every page and slide marked
+ * with its own number, a scanned PDF page drawn as an image, the old .doc/.ppt refused by name, and a document longer
+ * than the limit refused - never cut.
+ */
+import JSZip from 'jszip'
+
+import * as screen from '../client/utils/attachment-policy'
+import { docxText, documentKindOf, drawingText, isScannedPage, pdfPageText, readDocx, readPdf, readPptx, scannedPageName, slideOrder, xmlDecode } from '../client/utils/document-text'
+
+const W = 'xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main"'
+const para = (text: string, style?: string) => `<w:p>${style ? `<w:pPr><w:pStyle w:val="${style}"/></w:pPr>` : ''}<w:r><w:t xml:space="preserve">${text}</w:t></w:r></w:p>`
+
+async function zip(parts: Record<string, string>): Promise<Uint8Array> {
+  const archive = new JSZip()
+  for (const [path, text] of Object.entries(parts)) archive.file(path, text)
+  return archive.generateAsync({ type: 'uint8array' })
+}
+
+/* A paragraph is a shape of its own; "#n" is the page-number placeholder a notes page repeats. */
+const shape = (text: string) =>
+  text.startsWith('#')
+    ? `<p:sp><p:nvSpPr><p:nvPr><p:ph type="sldNum" idx="5"/></p:nvPr></p:nvSpPr><p:txBody><a:p><a:fld type="slidenum"><a:t>${text.slice(1)}</a:t></a:fld></a:p></p:txBody></p:sp>`
+    : `<p:sp><p:txBody><a:p><a:r><a:t>${text}</a:t></a:r></a:p></p:txBody></p:sp>`
+const slideXml = (...paragraphs: string[]) => `<p:sld xmlns:p="p" xmlns:a="a"><p:cSld><p:spTree>${paragraphs.map(shape).join('')}</p:spTree></p:cSld></p:sld>`
+
+async function pptx(slides: { text: string[]; notes?: string[] }[], order = slides.map((_, i) => i)) {
+  const parts: Record<string, string> = {
+    'ppt/presentation.xml': `<p:presentation xmlns:p="p" xmlns:r="r"><p:sldIdLst>${order.map(i => `<p:sldId id="${256 + i}" r:id="rId${i + 1}"/>`).join('')}</p:sldIdLst></p:presentation>`,
+    'ppt/_rels/presentation.xml.rels': `<Relationships>${slides.map((_, i) => `<Relationship Id="rId${i + 1}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide" Target="slides/slide${i + 1}.xml"/>`).join('')}</Relationships>`
+  }
+  slides.forEach((slide, i) => {
+    parts[`ppt/slides/slide${i + 1}.xml`] = slideXml(...slide.text)
+    if (slide.notes) {
+      parts[`ppt/slides/_rels/slide${i + 1}.xml.rels`] = `<Relationships><Relationship Id="rId9" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesSlide" Target="../notesSlides/notesSlide${i + 1}.xml"/></Relationships>`
+      parts[`ppt/notesSlides/notesSlide${i + 1}.xml`] = slideXml(...slide.notes)
+    }
+  })
+  return zip(parts)
+}
+
+const pdf = (pages: string[]) => async () => ({
+  numPages: pages.length,
+  getPage: async (n: number) => ({
+    getTextContent: async () => ({ items: pages[n - 1].split('\n').map(str => ({ str, hasEOL: true })) })
+  })
+})
+const drawn = (n: number) => Promise.resolve(new Blob([`page ${n}`], { type: 'image/jpeg' }))
+
+describe('which files are documents', () => {
+  it('by type, or by name when the browser did not know it', () => {
+    expect(documentKindOf({ name: 'a.PDF', type: '' })).toBe('pdf')
+    expect(documentKindOf({ name: 'x', type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' })).toBe('docx')
+    expect(documentKindOf({ name: '발표.pptx' })).toBe('pptx')
+    expect(documentKindOf({ name: '옛문서.doc' })).toBe('doc')
+    expect(documentKindOf({ name: '옛발표.ppt' })).toBe('ppt')
+    expect(documentKindOf({ name: 'a.png', type: 'image/png' })).toBeNull()
+  })
+
+  it('★ the picker offers them only to a mode that takes documents', () => {
+    expect(screen.acceptOf({ kinds: ['image', 'text', 'document'] })).toMatch(/\.pdf/)
+    expect(screen.acceptOf({ kinds: ['image', 'text', 'document'] })).toMatch(/\.docx/)
+    expect(screen.acceptOf({ kinds: ['image', 'text', 'document'] })).toMatch(/\.pptx/)
+    expect(screen.acceptOf({ kinds: ['image', 'text'] })).not.toMatch(/\.pdf/)
+  })
+})
+
+describe('Word', () => {
+  it('★ paragraphs in order, headings led by #, a table row on one line', async () => {
+    const xml = `<w:document ${W}><w:body>${para('계약서', 'Title')}${para('제1조 목적', 'Heading2')}${para('갑과 을은 &amp; 다음과 같이 정한다.')}<w:tbl><w:tr><w:tc>${para('품목')}</w:tc><w:tc>${para('금액')}</w:tc></w:tr><w:tr><w:tc>${para('설계')}${para('1차')}</w:tc><w:tc>${para('1,000,000')}</w:tc></w:tr></w:tbl>${para('끝')}</w:body></w:document>`
+    expect(docxText(xml)).toBe(['# 계약서', '## 제1조 목적', '갑과 을은 & 다음과 같이 정한다.', '| 품목 | 금액 |', '| 설계 1차 | 1,000,000 |', '끝'].join('\n'))
+  })
+
+  it('reads a .docx into one text file named after it', async () => {
+    const data = await zip({ 'word/document.xml': `<w:document ${W}><w:body>${para('본문')}</w:body></w:document>` })
+    const read: any = await readDocx(data, '계약서.docx', 20_000, JSZip)
+    expect(read.files.text.name).toBe('계약서.docx.txt')
+    expect(read.files.text.text).toMatch(/^# 계약서\.docx · Word/)
+    expect(read.files.text.text).toMatch(/\n본문\n$/)
+  })
+
+  it('a file that is not a .docx, or one with nothing in it, is said', async () => {
+    expect(await readDocx(new Uint8Array([1, 2, 3]), 'x.docx', 20_000, JSZip)).toEqual({ refusal: { code: 'attachment-document-unreadable', name: 'x.docx' } })
+    const empty = await zip({ 'word/document.xml': `<w:document ${W}><w:body><w:p/></w:body></w:document>` })
+    expect(await readDocx(empty, 'empty.docx', 20_000, JSZip)).toEqual({ refusal: { code: 'attachment-document-empty', name: 'empty.docx' } })
+  })
+
+  it('★ longer than the limit is refused, never cut', async () => {
+    const data = await zip({ 'word/document.xml': `<w:document ${W}><w:body>${para('가'.repeat(500))}</w:body></w:document>` })
+    expect(await readDocx(data, 'long.docx', 300, JSZip)).toEqual({ refusal: { code: 'attachment-document-too-long', name: 'long.docx', maxChars: 300 } })
+  })
+})
+
+describe('PowerPoint', () => {
+  it('★ slides in the order the presentation shows them, each with its number and its notes', async () => {
+    const data = await pptx([{ text: ['둘째로 둔 슬라이드'] }, { text: ['표지', '2026 사업계획'], notes: ['발표자가 할 말', '#1'] }], [1, 0])
+    const read: any = await readPptx(data, '발표.pptx', 20_000, JSZip)
+    expect(read.files.text.text).toBe(
+      ['# 발표.pptx · PowerPoint · 2 slides · each slide begins with "--- slide N ---", its notes after "notes:"', '--- slide 1 ---', '표지', '2026 사업계획', 'notes:', '발표자가 할 말', '--- slide 2 ---', '둘째로 둔 슬라이드', ''].join('\n')
+    )
+  })
+
+  it('reads the slide list through its relationships', () => {
+    expect(slideOrder('<p:sldIdLst><p:sldId id="1" r:id="rId7"/></p:sldIdLst>', '<Relationships><Relationship Id="rId7" Target="slides/slide3.xml"/></Relationships>')).toEqual(['ppt/slides/slide3.xml'])
+    expect(drawingText(slideXml('a', 'b'))).toEqual(['a', 'b'])
+    /* The number, date and footer a page repeats are left out by their placeholder, not by what they say. */
+    expect(drawingText(slideXml('a', '#7'))).toEqual(['a'])
+  })
+
+  it('a deck with no words on any slide is said', async () => {
+    const data = await pptx([{ text: [] }])
+    expect(await readPptx(data, 'pictures.pptx', 20_000, JSZip)).toEqual({ refusal: { code: 'attachment-document-empty', name: 'pictures.pptx' } })
+  })
+})
+
+describe('PDF', () => {
+  it('★ every page is marked with its own number', async () => {
+    const read: any = await readPdf(pdf(['제1조 이 계약은 갑과 을 사이의 용역에 관한 것이다', '제2조 계약 기간은 2026년 11월부터이다']), '계약서.pdf', 20_000, { allowed: true, max: 4 }, drawn)
+    expect(read.files.text.text).toBe(
+      ['# 계약서.pdf · PDF · 2 pages · each page begins with "--- page N ---", N its own page number', '--- page 1 ---', '제1조 이 계약은 갑과 을 사이의 용역에 관한 것이다', '--- page 2 ---', '제2조 계약 기간은 2026년 11월부터이다', ''].join('\n')
+    )
+    expect(read.files.images).toEqual([])
+  })
+
+  it('★ a page with no text is a scan - drawn as an image named by its page, and the text says where it went', async () => {
+    const read: any = await readPdf(pdf(['본문이 있는 첫 쪽입니다. 글자가 충분히 있습니다.', '3']), '스캔.pdf', 20_000, { allowed: true, max: 4 }, drawn)
+    expect(read.files.images.map((one: any) => [one.name, one.page])).toEqual([['스캔.pdf - p2.jpg', 2]])
+    expect(read.files.text.text).toContain(`--- page 2 ---\n(no text on this page - a scan, sent as the image "${scannedPageName('스캔.pdf', 2)}")`)
+  })
+
+  it('★ a scan is refused by name when the mode takes no images, or when it has more pages than a message carries', async () => {
+    expect(await readPdf(pdf(['', '']), 'scan.pdf', 20_000, { allowed: false, max: 4 }, drawn)).toEqual({ refusal: { code: 'attachment-scan-needs-images', name: 'scan.pdf' } })
+    expect(await readPdf(pdf(['', '', '', '', '', '']), 'scan.pdf', 20_000, { allowed: true, max: 4 }, drawn)).toEqual({
+      refusal: { code: 'attachment-scan-too-many-pages', name: 'scan.pdf', pages: 6, max: 4 }
+    })
+  })
+
+  it('a wholly scanned PDF goes as its images and the page list', async () => {
+    const read: any = await readPdf(pdf(['', '']), 'scan.pdf', 20_000, { allowed: true, max: 4 }, drawn)
+    expect(read.files.images).toHaveLength(2)
+  })
+
+  it('longer than the limit is refused, never cut; a broken file is said', async () => {
+    expect(await readPdf(pdf(['가'.repeat(400)]), 'long.pdf', 300, { allowed: true, max: 4 }, drawn)).toEqual({ refusal: { code: 'attachment-document-too-long', name: 'long.pdf', maxChars: 300 } })
+    expect(await readPdf(() => Promise.reject(new Error('bad')), 'bad.pdf', 300, { allowed: true, max: 4 }, drawn)).toEqual({ refusal: { code: 'attachment-document-unreadable', name: 'bad.pdf' } })
+  })
+
+  it('joins pdf.js items into lines and tells a scan by its letters', () => {
+    expect(pdfPageText([{ str: '제1조', hasEOL: false }, { str: '  목적', hasEOL: true }, { str: '본문' }])).toBe('제1조 목적\n본문')
+    expect(isScannedPage('- 3 -')).toBe(true)
+    expect(isScannedPage('이 쪽에는 글자가 열여섯 자보다 많습니다')).toBe(false)
+  })
+})
+
+it('decodes the entities OOXML writes', () => {
+  expect(xmlDecode('&lt;a&gt; &amp; &quot;b&quot; &#44032; &#xAC00;')).toBe('<a> & "b" 가 가')
+})
+
+describe('every refusal is said in every locale', () => {
+  const { readFileSync } = require('fs')
+  const { join } = require('path')
+  const source = readFileSync(join(__dirname, '../client/utils/document-text.ts'), 'utf8')
+  const codes = [...new Set([...source.matchAll(/code: '(attachment-[a-z-]+)'/g)].map((match: any) => match[1]))]
+
+  it('the parser finds the refusals', () => {
+    expect(codes.length).toBeGreaterThanOrEqual(6)
+  })
+
+  for (const locale of ['en', 'ko', 'ja', 'zh', 'ms', 'es']) {
+    it(locale, () => {
+      const dictionary = JSON.parse(readFileSync(join(__dirname, `../translations/${locale}.json`), 'utf8'))
+      expect(codes.filter(code => !dictionary[`ai-assistant.text.${code}`])).toEqual([])
+    })
+  }
+})

package/test/entry-workspace.test.ts

@@ -1,5 +1,5 @@
 /*
- * Reviewing a 입력안 in the AI 작업판 (operato-application/design/ai/workspace.md §6-1): read-only on the page,
+ * Reviewing a 입력안 in the AI 작업 패널 (operato-application/design/ai/workspace.md §6-1): read-only on the page,
  * entered from the dock's card - and only as the page showed it.
  */
 import { readFileSync } from 'fs'

package/test/workspace.test.ts

@@ -1,5 +1,5 @@
 /*
- * The AI 작업판 on the screen (design/ai/workspace.md) - which versions a reader sees, the card's version, and the
+ * The AI 작업 패널 on the screen (design/ai/workspace.md) - which versions a reader sees, the card's version, and the
  * table's sort and CSV. The page and the chat are read as text: importing them pulls the shell.
  */
 import { readFileSync } from 'fs'

package/translations/en.json

@@ -293,6 +293,12 @@
   "ai-assistant.text.pasted-table-name": "pasted table ({rows} rows)",
   "ai-assistant.text.attachment-sheet-unreadable": "{name} cannot be read as an Excel file.",
   "ai-assistant.text.attachment-sheet-empty": "{name} has no sheet with anything in it.",
+  "ai-assistant.text.attachment-old-office-not-read": "{name} is an old Office file (.doc or .ppt) and is not read. Save it as .docx or .pptx and attach it again.",
+  "ai-assistant.text.attachment-document-unreadable": "{name} cannot be read as a document.",
+  "ai-assistant.text.attachment-document-empty": "{name} has no text to read.",
+  "ai-assistant.text.attachment-document-too-long": "{name} is longer than {maxChars} characters as text and was not sent. Split it and attach the parts.",
+  "ai-assistant.text.attachment-scan-needs-images": "{name} has scanned pages, which go as images, and this conversation takes no images.",
+  "ai-assistant.text.attachment-scan-too-many-pages": "{name} has {pages} scanned pages; one message carries at most {max}. Attach the pages you need as a smaller PDF.",
   "ai-assistant.entry.review-in-workspace": "review in the workspace",
   "ai-assistant.entry.review-stale": "this proposal changed after it was reviewed in the workspace - review it again before entering.",
   "ai-assistant.workspace.entry-not-found": "there is no proposal here that you can see.",

package/translations/es.json

@@ -293,6 +293,12 @@
   "ai-assistant.text.pasted-table-name": "tabla pegada ({rows} filas)",
   "ai-assistant.text.attachment-sheet-unreadable": "{name} no se puede leer como archivo de Excel.",
   "ai-assistant.text.attachment-sheet-empty": "{name} no tiene ninguna hoja con contenido.",
+  "ai-assistant.text.attachment-old-office-not-read": "{name} es un archivo antiguo de Office (.doc o .ppt) y no se lee. Guárdalo como .docx o .pptx y adjúntalo de nuevo.",
+  "ai-assistant.text.attachment-document-unreadable": "{name} no se puede leer como documento.",
+  "ai-assistant.text.attachment-document-empty": "{name} no tiene texto que leer.",
+  "ai-assistant.text.attachment-document-too-long": "{name} supera los {maxChars} caracteres como texto y no se envió. Divídelo y adjunta las partes.",
+  "ai-assistant.text.attachment-scan-needs-images": "{name} tiene páginas escaneadas, que se envían como imágenes, y esta conversación no admite imágenes.",
+  "ai-assistant.text.attachment-scan-too-many-pages": "{name} tiene {pages} páginas escaneadas; un mensaje lleva como máximo {max}. Adjunta las páginas que necesites como un PDF más pequeño.",
   "ai-assistant.entry.review-in-workspace": "revisar en el espacio de trabajo",
   "ai-assistant.entry.review-stale": "esta propuesta cambió después de revisarse en el espacio de trabajo; revísela de nuevo antes de introducirla.",
   "ai-assistant.workspace.entry-not-found": "aquí no hay ninguna propuesta que pueda ver.",

package/translations/ja.json

@@ -293,6 +293,12 @@
   "ai-assistant.text.pasted-table-name": "貼り付けた表 {rows}行",
   "ai-assistant.text.attachment-sheet-unreadable": "{name} を Excel ファイルとして読み込めません。",
   "ai-assistant.text.attachment-sheet-empty": "{name} には内容のあるシートがありません。",
+  "ai-assistant.text.attachment-old-office-not-read": "{name} は古い Office 形式(.doc・.ppt)のため読み込みません。.docx・.pptx で保存して再度添付してください。",
+  "ai-assistant.text.attachment-document-unreadable": "{name} を文書として読み込めません。",
+  "ai-assistant.text.attachment-document-empty": "{name} に読み取れる文字がありません。",
+  "ai-assistant.text.attachment-document-too-long": "{name} はテキストにすると {maxChars} 文字を超えるため送信しませんでした。分けて添付してください。",
+  "ai-assistant.text.attachment-scan-needs-images": "{name} にはスキャンしたページがあり画像として送る必要がありますが、この会話は画像を受け付けません。",
+  "ai-assistant.text.attachment-scan-too-many-pages": "{name} のスキャンしたページは {pages} ページですが、一度に送れるのは {max} ページまでです。必要なページだけを PDF に分けて添付してください。",
   "ai-assistant.entry.review-in-workspace": "作業ボードで確認",
   "ai-assistant.entry.review-stale": "作業ボードで確認した後に入力案が変わりました。もう一度確認してから入力してください。",
   "ai-assistant.workspace.entry-not-found": "表示できる入力案はありません。",

package/translations/ko.json

@@ -223,7 +223,7 @@
   "ai-assistant.entry.issue.not-in-source": "자료에 없는 값입니다",
   "ai-assistant.entry.issue.source-scattered": "값이 자료의 한 줄에 함께 있지 않습니다",
   "ai-assistant.entry.issue.source-not-checked": "사진 자료는 대조하지 못했습니다",
-  "ai-assistant.workspace.title": "AI 작업판",
+  "ai-assistant.workspace.title": "AI 작업 패널",
   "ai-assistant.workspace.unreadable": "그릴 수 없는 블록입니다 ({reason})",
   "ai-assistant.workspace.rows": "{count}행",
   "ai-assistant.workspace.csv": "CSV",
@@ -231,14 +231,14 @@
   "ai-assistant.workspace.other": "기타",
   "ai-assistant.workspace.as-chart": "차트",
   "ai-assistant.workspace.as-table": "표로 보기",
-  "ai-assistant.workspace.loading": "작업판을 불러오는 중…",
-  "ai-assistant.workspace.unreadable-page": "작업판을 읽지 못했습니다: {reason}",
-  "ai-assistant.workspace.not-found": "볼 수 있는 작업판이 없습니다.",
-  "ai-assistant.workspace.newer": "새 판({version})이 있습니다.",
+  "ai-assistant.workspace.loading": "작업 패널을 불러오는 중…",
+  "ai-assistant.workspace.unreadable-page": "작업 패널을 읽지 못했습니다: {reason}",
+  "ai-assistant.workspace.not-found": "볼 수 있는 작업 패널이 없습니다.",
+  "ai-assistant.workspace.newer": "새 버전({version})이 있습니다.",
   "ai-assistant.workspace.show-newer": "보기",
-  "ai-assistant.workspace.versions": "판",
-  "ai-assistant.workspace.version": "판 {version} / {of}",
-  "ai-assistant.workspace.open": "작업판에서 보기",
+  "ai-assistant.workspace.versions": "버전",
+  "ai-assistant.workspace.version": "버전 {version} / {of}",
+  "ai-assistant.workspace.open": "작업 패널에서 보기",
   "ai-assistant.screen.open": "화면에서 열기",
   "ai-assistant.screen.not-applied": "화면에서는 걸리지 않는 조건: {conditions}",
   "ai-assistant.read.count": "건수",
@@ -293,8 +293,14 @@
   "ai-assistant.text.pasted-table-name": "붙여넣은 표 {rows}행",
   "ai-assistant.text.attachment-sheet-unreadable": "{name} 을 엑셀 파일로 읽을 수 없습니다.",
   "ai-assistant.text.attachment-sheet-empty": "{name} 에 내용이 있는 시트가 없습니다.",
-  "ai-assistant.entry.review-in-workspace": "작업판에서 검토",
-  "ai-assistant.entry.review-stale": "작업판에서 검토한 뒤 입력안이 바뀌었습니다. 다시 검토한 뒤 입력하십시오.",
+  "ai-assistant.text.attachment-old-office-not-read": "{name} 은 옛 Office 형식(.doc·.ppt)이라 읽지 않습니다. .docx·.pptx 로 저장해 다시 첨부해 주십시오.",
+  "ai-assistant.text.attachment-document-unreadable": "{name} 을 문서로 읽을 수 없습니다.",
+  "ai-assistant.text.attachment-document-empty": "{name} 에 읽을 글자가 없습니다.",
+  "ai-assistant.text.attachment-document-too-long": "{name} 은 글자로 바꾸면 {maxChars} 자를 넘어 보내지 않았습니다. 나눠 첨부해 주십시오.",
+  "ai-assistant.text.attachment-scan-needs-images": "{name} 에 스캔한 쪽이 있어 이미지로 보내야 하는데, 이 대화는 이미지를 받지 않습니다.",
+  "ai-assistant.text.attachment-scan-too-many-pages": "{name} 의 스캔한 쪽은 {pages}쪽인데 한 번에 {max}쪽까지 보낼 수 있습니다. 필요한 쪽만 PDF 로 나눠 첨부해 주십시오.",
+  "ai-assistant.entry.review-in-workspace": "작업 패널에서 검토",
+  "ai-assistant.entry.review-stale": "작업 패널에서 검토한 뒤 입력안이 바뀌었습니다. 다시 검토한 뒤 입력하십시오.",
   "ai-assistant.workspace.entry-not-found": "볼 수 있는 입력안이 없습니다.",
   "ai-assistant.workspace.entry-superseded": "대화에서 더 새로운 카드가 이 카드를 대신했습니다. 그 카드를 검토하십시오.",
   "ai-assistant.workspace.entry-press-in-dock": "검토 화면입니다. 입력은 AI 도크의 카드에 있는 단추로 합니다.",