@things-factory/figure-service 10.1.153 → 10.1.155

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-service",
-  "version": "10.1.153",
+  "version": "10.1.155",
   "publishConfig": {
     "access": "public",
     "@things-factory:registry": "https://registry.npmjs.org"
@@ -27,16 +27,16 @@
   "dependencies": {
     "@hatiolab/figure-model": "^0.6.3",
     "@operato/typeorm-history": "^10.0.0",
-    "@things-factory/ai-client-base": "^10.1.149",
-    "@things-factory/attachment-base": "^10.1.150",
-    "@things-factory/auth-base": "^10.1.150",
+    "@things-factory/ai-client-base": "^10.1.155",
+    "@things-factory/attachment-base": "^10.1.155",
+    "@things-factory/auth-base": "^10.1.155",
     "@things-factory/env": "^10.1.149",
-    "@things-factory/setting-base": "^10.1.150",
-    "@things-factory/shell": "^10.1.150",
+    "@things-factory/setting-base": "^10.1.155",
+    "@things-factory/shell": "^10.1.155",
     "graphql-scalars": "^1.22.4",
     "graphql-upload": "^15.0.2",
     "jszip": "^3.10.1",
     "koa-router": "^7.4.0"
   },
-  "gitHead": "54b3e985a55d5d0b01622d87f385f07518fb5d16"
+  "gitHead": "0211c9c0764a26c10151fdc7d60094fc334905ff"
 }

package/server/service/figure/figure-llm-smoke.test.ts

@@ -9,7 +9,7 @@
  *   RUN_FIGURE_LLM_SMOKE=1 OPENAI_API_KEY=... yarn test:figure-llm-smoke
  * 선택: FIGURE_LLM_PROVIDER=anthropic|gemini|openai, FIGURE_LLM_MODEL=<model id>
  */
-import { createAIClient, setDefaultAIClient } from '@things-factory/ai-client-base'
+import { createAIClient, type AIClient } from '@things-factory/ai-client-base'
 
 import { applyFigureProposal, createFigureAsset, inspectFigureAsset } from '@hatiolab/figure-model'
 
@@ -39,18 +39,19 @@ const picked = process.env.RUN_FIGURE_LLM_SMOKE === '1' ? provider() : undefined
 const describeIf = picked ? describe : describe.skip
 
 describeIf('Figure 실제 LLM smoke', () => {
+  let client: AIClient
   beforeAll(() => {
-    setDefaultAIClient(createAIClient({ ...picked!, ...(process.env.FIGURE_LLM_MODEL ? { model: process.env.FIGURE_LLM_MODEL } : {}) }))
+    client = createAIClient({ ...picked!, ...(process.env.FIGURE_LLM_MODEL ? { model: process.env.FIGURE_LLM_MODEL } : {}) })
     // eslint-disable-next-line no-console
     console.log(`[figure-llm-smoke] provider=${picked!.provider} model=${process.env.FIGURE_LLM_MODEL ?? '(adapter default)'}`)
   })
 
-  afterAll(() => setDefaultAIClient(undefined))
 
   test(
     '새 Figure 는 게이트를 지나는 명령 목록으로 온다',
     async () => {
       const result = await proposeFigureSteps({
+        client,
         prompt: 'two cylindrical rollers inside a simple rectangular press frame; make the rollers visually distinct',
         name: 'Roll press'
       })
@@ -74,7 +75,7 @@ describeIf('Figure 실제 LLM smoke', () => {
         { kind: 'attach', part: 'port', face: 'back', to: { part: 'body', face: 'front' } },
         { kind: 'fit-room', placement: 'floor' }
       ] as any)
-      const result = await proposeFigureSteps({ prompt: 'make the port twice as wide and give it an accent colour', base: draft })
+      const result = await proposeFigureSteps({ client, prompt: 'make the port twice as wide and give it an accent colour', base: draft })
 
       const ids = result.source.document.model.nodes.map((n: any) => n.id)
       expect(ids.some((id: string) => id.includes('body'))).toBe(true)

package/server/service/figure/figure-mutation.ts

@@ -3,6 +3,7 @@ import { Arg, Ctx, Directive, Mutation, Resolver, UseMiddleware } from 'type-gra
 
 import { isFigureType, parseFigureAsset, placeholderType, TYPE_LENGTH } from '@hatiolab/figure-model'
 import { getRepository, Refusal, SpeakRefusals } from '@things-factory/shell'
+import { aiClientFor } from '@things-factory/ai-client-base'
 
 import { Figure } from './figure.js'
 import { FigureHistory } from './figure-history.js'
@@ -225,6 +226,19 @@ export class FigureMutation {
       throw new Error(`Figure ${id} 를 찾을 수 없다`)
     }
 
+    /*
+      **그림만 바꾸면 발행이 풀리지 않는다.** 미리보기에서 사람이 돌려 놓은 각도로 찍은 그림이 그렇게 온다.
+      그림은 발행이 약속하는 것이 아니다 — 발행본은 제 그림을 따로 갖고, 다음 발행이 이 그림을 가져간다.
+      판본 구독자를 거치지 않는다: 발행된 행의 저장을 판으로 베끼는데, 이것은 판이 아니다.
+    */
+    if (patch.thumbnail !== undefined && Object.keys(patch).every(key => key === 'thumbnail' || (patch as any)[key] === undefined)) {
+      const picture = await pictureOf(tx, domain, user, patch.thumbnail, figure)
+      if (picture.thumbnailHash) {
+        await repository.createQueryBuilder().update(Figure).set({ ...picture, updater: user }).where('id = :id', { id }).callListeners(false).execute()
+      }
+      return { figure: await repository.findOneOrFail({ where: { id } }), violations: [] }
+    }
+
     // 정본이 바뀌면 파생값도 다시 계산한다. 안 바뀌었으면 손대지 않는다 —
     // 이름만 고쳤는데 점수가 흔들리면 읽는 사람이 원인을 못 찾는다.
     let derived: { score: number; triangles: number; groups: number } | undefined
@@ -542,7 +556,7 @@ export class FigureMutation {
   @Mutation(returns => FigureProposal, {
     description: 'Asks the authoring assistant for modeller commands that make or revise a figure. Nothing is saved.'
   })
-  async proposeFigure(@Arg('request') request: ProposeRequest): Promise<FigureProposal> {
+  async proposeFigure(@Arg('request') request: ProposeRequest, @Ctx() context: ResolverContext): Promise<FigureProposal> {
     // 그림은 메모리로 받는다. 참고용이라 저장하지 않는다 — 남기면 지울 사람이 없다.
     let image
     if (request.image) {
@@ -556,6 +570,7 @@ export class FigureMutation {
 
     try {
       const result = await proposeFigureSteps({
+        client: await aiClientFor({ domain: context.state.domain, user: context.state.user }),
         prompt: request.prompt,
         base: request.base ? parseFigureAsset(request.base) : undefined,
         name: request.name,

package/server/service/figure/figure-namespace-db.test.ts

@@ -17,6 +17,7 @@ let Figure: any
 let FigureMutation: any
 let FigureQuery: any
 let figurePackageOf: any
+let FigureHistory: any
 
 function loadCompiled(modulePath: string): any {
   const { existsSync } = require('fs')
@@ -29,7 +30,7 @@ function loadCompiled(modulePath: string): any {
 
 beforeAll(async () => {
   Figure = loadCompiled('service/figure/figure').Figure
-  const FigureHistory = loadCompiled('service/figure/figure-history').FigureHistory
+  FigureHistory = loadCompiled('service/figure/figure-history').FigureHistory
   const Subscriber = loadCompiled('service/figure/event-subscriber').FigureHistoryEntitySubscriber
   ;({ FigureMutation } = loadCompiled('service/figure/figure-mutation'))
   ;({ FigureQuery } = loadCompiled('service/figure/figure-query'))
@@ -130,7 +131,7 @@ describe('figureBlueprints answers each full name, an item or a refusal', () =>
       context
     )
 
-    expect(answer.release).toBeNull()
+    expect(Object.keys(answer).sort()).toEqual(['items', 'refused'])
     expect(answer.items.map((item: any) => [item.type, item.ref])).toEqual([['hatiolab.com/conveyor', 'hatiolab.com/conveyor@1']])
     expect(answer.items[0].asset.version).toBe('figure-asset-1')
     expect(answer.refused.map((r: any) => [r.type, r.code])).toEqual([
@@ -170,6 +171,34 @@ describe('the figure package', () => {
     expect(read.releases[0].source).toBe(stored.source)
   })
 
+  it('dates each release when it was released, not when the figure was made, and carries its note', async () => {
+    const { domain, context } = await domainWith('hatiolab.com')
+    const figure = await releasedFigure(context, 'trailer-23')
+    /* sqlite keeps these times to the second */
+    await new Promise(resolve => setTimeout(resolve, 1100))
+    const current = await dataSource!.getRepository(Figure).findOneOrFail({ where: { id: figure.id } })
+    await new FigureMutation().saveFigure(releasable('Trailer 23 wide'), context, figure.id, current.source)
+    await new FigureMutation().releaseFigure(figure.id, 'wider body', context)
+
+    const { bytes } = await figurePackageOf({
+      refs: ['hatiolab.com/trailer-23@1', 'hatiolab.com/trailer-23@2'],
+      domain,
+      exportedBy: 'author',
+      sourceUrl: 'x',
+      files: { put: async () => ({}), send: async () => {}, read: async () => Buffer.alloc(0) }
+    })
+    const zip = await JSZip.loadAsync(bytes)
+    const files = new Map<string, Uint8Array>()
+    for (const path of Object.keys(zip.files)) if (!zip.files[path].dir) files.set(path, await zip.files[path].async('uint8array'))
+    const [first, second] = readFigurePackage(files, sha256).releases
+
+    const histories = await dataSource!.getRepository(FigureHistory).find({ where: { originalId: figure.id }, order: { version: 'ASC' } })
+    expect(first.releasedAt).toBe(new Date(histories[0].updatedAt).toISOString())
+    expect(second.releasedAt).toBe(new Date(histories[1].updatedAt).toISOString())
+    expect(second.releasedAt > first.releasedAt).toBe(true)
+    expect([first.comment, second.comment]).toEqual(['first', 'wider body'])
+  })
+
   it('refuses a release this domain cannot read, and a malformed reference', async () => {
     const { domain, context } = await domainWith('hatiolab.com')
     await releasedFigure(context, 'conveyor')

package/server/service/figure/figure-package-export.ts

@@ -126,6 +126,8 @@ function packageReleaseOf(
     thumbnail: history.thumbnailHash && blobs.has(history.thumbnailHash) ? history.thumbnailHash : null,
     deprecated: !!figure.deprecated,
     supersededBy: figure.supersededBy && figure.namespace ? `${figure.namespace}/${figure.supersededBy}` : null,
-    releasedAt: new Date(history.createdAt ?? Date.now()).toISOString()
+    /* The history row copies the figure's own createdAt; the save that released this version is its updatedAt. */
+    releasedAt: new Date(history.updatedAt ?? history.createdAt ?? Date.now()).toISOString(),
+    comment: history.comment ?? null
   }
 }

package/server/service/figure/figure-propose-clips.test.ts

@@ -5,7 +5,6 @@
  */
 import { addFigureBox, applyFigureAuthoring, createFigureAsset, editFigurePart } from '@hatiolab/figure-model'
 import type { FigureAsset } from '@hatiolab/figure-model'
-import { setDefaultAIClient } from '@things-factory/ai-client-base'
 import type { AIClient } from '@things-factory/ai-client-base'
 
 import { ProposeFigureFailure, judgeFigureAnswer, proposeFigureSteps } from './figure-propose-steps'
@@ -26,8 +25,6 @@ function stubClient(answers: unknown[]): AIClient & { calls: number; sent: any[]
   return client as unknown as AIClient & { calls: number; sent: any[][] }
 }
 
-afterEach(() => setDefaultAIClient(undefined))
-
 function door(): FigureAsset {
   let a = createFigureAsset('Door')
   a = addFigureBox(a, { id: 'frame', size: { x: 1000, y: 100, z: 200 }, position: { x: 0, y: 50, z: 0 } })
@@ -52,8 +49,7 @@ describe('an AI answer and the clips of the draft it revises', () => {
 
   it('asked three times and three times lossy, nothing comes back: no half-made figure to save', async () => {
     const client = stubClient([lossy])
-    setDefaultAIClient(client)
-    await expect(proposeFigureSteps({ prompt: '문을 없애 줘', base: door() })).rejects.toBeInstanceOf(ProposeFigureFailure)
+    await expect(proposeFigureSteps({ client, prompt: '문을 없애 줘', base: door() })).rejects.toBeInstanceOf(ProposeFigureFailure)
     expect(client.calls).toBe(3)
     expect(JSON.stringify(client.sent)).not.toMatch(/dropClips/)
   })
@@ -66,8 +62,8 @@ describe('an AI answer and the clips of the draft it revises', () => {
 
   it('an answer that stops no clip keeps every clip, a rename of the part it hangs from included', async () => {
     const base = door()
-    setDefaultAIClient(stubClient([{ steps: [{ kind: 'rename', name: 'Door 2' }, { kind: 'nudge-part', part: 'sign', by: { x: 50 } }, { kind: 'rename-part', target: 'frame', name: 'jamb' }] }]))
-    const made = await proposeFigureSteps({ prompt: '이름을 바꿔 줘', base })
+    const client = stubClient([{ steps: [{ kind: 'rename', name: 'Door 2' }, { kind: 'nudge-part', part: 'sign', by: { x: 50 } }, { kind: 'rename-part', target: 'frame', name: 'jamb' }] }])
+    const made = await proposeFigureSteps({ client, prompt: '이름을 바꿔 줘', base })
     expect(made.source.drivers).toEqual(base.drivers)
   })
 })

package/server/service/figure/figure-propose-steps.test.ts

@@ -6,7 +6,6 @@
  * the proposer says it could not make it, and nothing half made comes back.
  */
 import { FIGURE_PROPOSAL_GRAMMAR, applyFigureProposal, createFigureAsset, inspectFigureAsset } from '@hatiolab/figure-model'
-import { setDefaultAIClient } from '@things-factory/ai-client-base'
 import type { AIClient } from '@things-factory/ai-client-base'
 
 import { ProposeFigureFailure, proposeFigureSteps, rulesPromptFigure } from './figure-propose-steps'
@@ -32,8 +31,6 @@ function stubClient(answers: unknown[]): AIClient & { calls: number; sent: any[]
   return client as unknown as AIClient & { calls: number; sent: any[][]; system?: string }
 }
 
-afterEach(() => setDefaultAIClient(undefined))
-
 const liftTable = [
   { kind: 'add-part', part: { id: 'base', kind: 'box', dimensions: { width: 1200, height: 80, depth: 800 } } },
   { kind: 'add-part', part: { id: 'column', kind: 'cylinder', dimensions: { radius: 90, length: 600 } } },
@@ -66,8 +63,7 @@ describe('the model is told the kernel\'s commands and the open draft', () => {
   it('a revision carries the draft\'s source', async () => {
     const draft = applyFigureProposal(createFigureAsset('Lift table'), liftTable as any)
     const client = stubClient([{ steps: [{ kind: 'rename', name: 'Lift table 2' }] }])
-    setDefaultAIClient(client)
-    const made = await proposeFigureSteps({ prompt: '이름을 바꿔 줘', base: draft })
+    const made = await proposeFigureSteps({ client, prompt: '이름을 바꿔 줘', base: draft })
     expect(client.sent[0]![0]!.content).toContain('"version":"figure-asset-1"')
     expect(made.source.name).toBe('Lift table 2')
     expect(draft.name).toBe('Lift table')
@@ -76,8 +72,8 @@ describe('the model is told the kernel\'s commands and the open draft', () => {
 
 describe('the steps are held to the kernel and the gate', () => {
   it('a list the kernel takes comes back with the figure it makes, the gate clean, on the first attempt', async () => {
-    setDefaultAIClient(stubClient([{ steps: liftTable }]))
-    const made = await proposeFigureSteps({ prompt: '리프트 테이블', name: 'Lift table' })
+    const client = stubClient([{ steps: liftTable }])
+    const made = await proposeFigureSteps({ client, prompt: '리프트 테이블', name: 'Lift table' })
     expect(made.attempts).toBe(1)
     expect(made.steps).toEqual(liftTable)
     expect(inspectFigureAsset(made.source).violations).toEqual([])
@@ -86,8 +82,7 @@ describe('the steps are held to the kernel and the gate', () => {
 
   it('a refused step goes back with its place and the kernel\'s code, and the next answer is taken', async () => {
     const client = stubClient([{ steps: wrongFace }, { steps: liftTable }])
-    setDefaultAIClient(client)
-    const made = await proposeFigureSteps({ prompt: '리프트 테이블', name: 'Lift table' })
+    const made = await proposeFigureSteps({ client, prompt: '리프트 테이블', name: 'Lift table' })
     expect(made.attempts).toBe(2)
     const said = client.sent[1]!.at(-1)!.content as string
     expect(said).toMatch(/ATTACH_FACE: steps\[4\]: attach: /)
@@ -95,23 +90,21 @@ describe('the steps are held to the kernel and the gate', () => {
 
   it('a new figure must come out whole: a list that leaves the room undeclared is sent back', async () => {
     const client = stubClient([{ steps: withoutRoom }, { steps: liftTable }])
-    setDefaultAIClient(client)
-    const made = await proposeFigureSteps({ prompt: '리프트 테이블', name: 'Lift table' })
+    const made = await proposeFigureSteps({ client, prompt: '리프트 테이블', name: 'Lift table' })
     expect(made.attempts).toBe(2)
     expect(client.sent[1]!.at(-1)!.content).toMatch(/OCCUPANCY_UNDECLARED/)
   })
 
   it('a revision is not blamed for what the draft already had', async () => {
     const draft = applyFigureProposal(createFigureAsset('Lift table'), withoutRoom as any)
-    setDefaultAIClient(stubClient([{ steps: [{ kind: 'rename', name: 'Lift' }] }]))
-    const made = await proposeFigureSteps({ prompt: '이름', base: draft })
+    const client = stubClient([{ steps: [{ kind: 'rename', name: 'Lift' }] }])
+    const made = await proposeFigureSteps({ client, prompt: '이름', base: draft })
     expect(made.attempts).toBe(1)
   })
 
   it('three refusals said back, then it says it could not make it, with the last reasons -- nothing half made', async () => {
     const client = stubClient([{ steps: wrongFace }, new Error('cut short'), { nope: true }])
-    setDefaultAIClient(client)
-    const failure = await proposeFigureSteps({ prompt: '리프트 테이블', name: 'Lift table' }).catch(e => e)
+    const failure = await proposeFigureSteps({ client, prompt: '리프트 테이블', name: 'Lift table' }).catch(e => e)
     expect(failure).toBeInstanceOf(ProposeFigureFailure)
     expect(failure.message).toBe('만들지 못했습니다.')
     expect(failure.attempts).toBe(3)

package/server/service/figure/figure-propose-steps.ts

@@ -1,6 +1,6 @@
 import { FIGURE_PROPOSAL_GRAMMAR, applyFigureProposal, createFigureAsset, inspectFigureAsset, serializeFigureAsset, figureCostOf, figureScoreOf } from '@hatiolab/figure-model'
 import type { FigureAsset, FigureProposalStep, FigureRefusalDetails } from '@hatiolab/figure-model'
-import { getDefaultAIClient } from '@things-factory/ai-client-base'
+import type { AIClient } from '@things-factory/ai-client-base'
 import type { AIImageMediaType, AIMessage } from '@things-factory/ai-client-base'
 
 /**
@@ -20,6 +20,8 @@ const MAX_ATTEMPTS = 3
 const GENERATE_MAX_TOKENS = 16384
 
 export interface ProposeFigureInput {
+  /** The domain's AI agent that answers (aiClientFor). */
+  client: AIClient
   /** What the author asked for, in their words. */
   prompt: string
   /** The open draft to revise. Absent: a new figure. */
@@ -140,8 +142,7 @@ export function judgeFigureAnswer(base: FigureAsset, answer: unknown, revising:
 
 /** Asks the model for steps and holds them to the kernel and the gate, three times at most. */
 export async function proposeFigureSteps(input: ProposeFigureInput): Promise<ProposeFigureResult> {
-  const client = getDefaultAIClient()
-  if (!client) throw new ProposeFigureFailure('AI 모델이 설정돼 있지 않습니다.', [], 0)
+  const { client } = input
 
   const base = input.base ?? createFigureAsset(input.name ?? 'Figure')
   const system = rulesPromptFigure()

package/server/service/figure/figure-query.ts

@@ -321,12 +321,12 @@ export class FigureQuery {
    *
    * One answer per name: an item, or a refusal that names why. A refusal never takes another item away -- the board
    * draws what it got and a stand-in with the reason for the rest. This server keeps its policy: the latest release,
-   * shadowed by the child domain as `figureBlueprint` does. `release` is null; a type map is the board server's.
+   * shadowed by the child domain as `figureBlueprint` does. A type map is the board server's.
    */
   @Directive('@privilege(category: "figure-published", privilege: "query", domainOwnerGranted: true)')
   @Query(returns => GraphQLJSON, {
     description:
-      'Released figures asked together by full name {namespace}/{type}: { release: null, items: [{ type, ref, asset }], refused: [{ type, code, message }] }. The latest release of each; one refusal never removes another item.'
+      'Released figures asked together by full name {namespace}/{type}: { items: [{ type, ref, asset }], refused: [{ type, code, message }] }. The latest release of each; one refusal never removes another item.'
   })
   async figureBlueprints(
     @Arg('types', type => [String], { description: 'Full figure names {namespace}/{type}. At most 500.' }) types: string[],
@@ -376,7 +376,7 @@ export class FigureQuery {
       }
     }
 
-    return { release: null, items, refused }
+    return { items, refused }
   }
 }
 

package/server/service/figure/figure-thumbnail-db.test.ts

@@ -135,6 +135,30 @@ describe('a picture kept by its content', () => {
     expect(row.thumbnailUpdatedAt).toBeTruthy()
     useThumbnailFiles(was)
   })
+
+  it('a patch of the picture alone replaces only the picture: a released figure stays released, at its version, with no new version row', async () => {
+    const was = useThumbnailFiles(mapFiles())
+    const domain = await newDomain()
+    const context = { state: { domain, user: undefined, tx: dataSource!.manager } }
+    const figure = await dataSource!.getRepository(Figure).save({ type: 'CHOSEN', name: 'chosen', source: SOURCE, state: 'draft', version: 0, domain })
+    await new FigureMutation().updateFigure(figure.id, { thumbnail: picture(11) }, context)
+    /* Released as a row, without the subscriber that would copy it into a version. */
+    await dataSource!.getRepository(Figure).createQueryBuilder().update(Figure).set({ state: 'released', version: 3 }).where('id = :id', { id: figure.id }).callListeners(false).execute()
+    const versions = await dataSource!.getRepository(FigureHistory).count({ where: { originalId: figure.id } })
+    const before = await dataSource!.getRepository(Figure).findOneOrFail({ where: { id: figure.id } })
+
+    const { figure: chosen } = await new FigureMutation().updateFigure(figure.id, { thumbnail: picture(12) }, context)
+    expect([chosen.state, chosen.version, chosen.source]).toEqual(['released', 3, SOURCE])
+    expect(chosen.thumbnailHash).toBe(sha256Of(bytesOf(picture(12))))
+    expect(chosen.thumbnailHash).not.toBe(before.thumbnailHash)
+    expect(await dataSource!.getRepository(FigureHistory).count({ where: { originalId: figure.id } })).toBe(versions)
+
+    /* The same picture again is no change: the time stays. */
+    const { figure: again } = await new FigureMutation().updateFigure(figure.id, { thumbnail: picture(12) }, context)
+    expect(again.thumbnailUpdatedAt).toEqual(chosen.thumbnailUpdatedAt)
+    await expect(new FigureMutation().updateFigure(figure.id, { thumbnail: 'not a picture' }, context)).rejects.toThrow(/data URL/)
+    useThumbnailFiles(was)
+  })
 })
 
 describe('served behind the permission, from the figure\'s own domain', () => {

package/server/service/figure/figure-tools.test.ts

@@ -12,7 +12,7 @@
  *
  * 실제 모델은 부르지 않는다. 여기서 볼 것은 모델의 솜씨가 아니라 **우리 배선**이다.
  */
-import { clearToolRegistry, getToolCategories, registryAssistantChat } from '@things-factory/ai-client-base'
+import { clearToolRegistry, getToolCategories, registryAssistantChat, setAIClientForTesting } from '@things-factory/ai-client-base'
 
 import { __setFigureToolDepsForTest, registerFigureToolCategories } from './figure-tools'
 
@@ -50,7 +50,11 @@ const ROWS = [
 /** 부른 것을 적어 두는 가짜 제안기. */
 const proposed: any[] = []
 
+/* The proposal tool asks the domain's AI agent; here a stand-in answers - the proposer below never calls it. */
+const agentClient: any = { id: 'test:figure', chat: async () => '', generateJSON: async () => ({}), listModels: async () => [] }
+
 function install() {
+  setAIClientForTesting(agentClient)
   const model = require('@hatiolab/figure-model')
   __setFigureToolDepsForTest({
     getRepository: () => stubRepository(ROWS),
@@ -93,7 +97,10 @@ beforeEach(() => {
   registerFigureToolCategories()
 })
 
-afterEach(() => clearToolRegistry())
+afterEach(() => {
+  clearToolRegistry()
+  setAIClientForTesting(undefined)
+})
 
 test('실제 registryAssistantChat 경계가 열린 모델 문맥을 Figure 도구에 전달한다', async () => {
   const seen: any[] = []

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

@@ -35,7 +35,7 @@
  * 있다. 그래서 호출자 도메인 소속을 먼저 확인한다.
  */
 import { randomUUID } from 'crypto'
-import { registerToolCategory, type ToolCategory, type ToolSpec } from '@things-factory/ai-client-base'
+import { aiClientFor, registerToolCategory, type ToolCategory, type ToolSpec } from '@things-factory/ai-client-base'
 
 /*
   서버 의존성은 lazy require 다. 등록은 부팅 초반에 평가되고 그때 typeorm DataSource 가 준비되지
@@ -353,6 +353,13 @@ function figureToolSpecs(): ToolSpec[] {
         let result: any
         try {
           result = await proposeFigureSteps({
+            /* The agent of this conversation's turn - the one the person picked, or the domain default. */
+            client: await aiClientFor({
+              domain: ctx?.state?.domain,
+              user: ctx?.state?.user,
+              agentId: ctx?.state?.aiAgentId,
+              modeKind: ctx?.mode?.kind
+            }),
             prompt,
             base,
             name: typeof args?.name === 'string' && args.name.trim() ? args.name.trim() : undefined,