@things-factory/figure-ui 10.1.167 → 10.1.169

package/client/figure-assistant.ts

@@ -10,11 +10,21 @@ import { i18next } from '@operato/i18n'
 import { navigate } from '@operato/shell'
 import { registerProposalHandler } from '@things-factory/ai-assistant/dist-client/index.js'
 
+import { fetchProposalOutcome } from './graphql/index.js'
 import { modellerPathOf } from './modeller/modeller-route.js'
-import { pendNewFigure, runFigureProposal, type FigureApplyDetail } from './modeller/ai-proposal.js'
+import { pendNewFigure, proposalOutcomeFrom, runFigureProposal, type FigureApplyDetail } from './modeller/ai-proposal.js'
 
 export const FIGURE_CANDIDATE_TOOL = 'proposeFigureCandidate'
 
+/**
+ * The dock's "check the result" of a figure proposal, on every screen that offers its card: what the server recorded of
+ * its save (ADR-0097 §5.6 item 5). The modeller asks it, and so does an app's home where a new figure's card is made --
+ * there it was missing, and a card cut off by a reload stayed "no answer" for good (figure audit 2026-10-16 N8).
+ */
+export async function figureProposalOutcome(proposalKey: string) {
+  return proposalOutcomeFrom(await fetchProposalOutcome(proposalKey), (key, params) => i18next.t(key, params))
+}
+
 registerProposalHandler(FIGURE_CANDIDATE_TOOL, async (proposal, context) => {
   const outcome = await runFigureProposal(
     proposal,
@@ -27,6 +37,10 @@ registerProposalHandler(FIGURE_CANDIDATE_TOOL, async (proposal, context) => {
         const opened = pendNewFigure(steps, key)
         navigate(modellerPathOf())
         return opened
+      },
+      savedInto: fetchProposalOutcome,
+      openSaved(id) {
+        navigate(modellerPathOf({ id }))
       }
     },
     (key, params) => i18next.t(key, params)

package/client/modeller/ai-proposal.ts

@@ -7,7 +7,7 @@
  */
 import type { FigureProposalStep } from '@hatiolab/figure-model'
 import type { FigureProductSession } from './product-session.js'
-import { clipLossOf, refusalRecordOf, type FigureRefusalRecord } from './refusals.js'
+import { clipLossOf, editRefusalOf, refusalRecordOf, type FigureRefusalRecord } from './refusals.js'
 
 /** What the card carries, as `proposeFigureCandidate` returned it. */
 export interface FigureProposalCard {
@@ -28,6 +28,8 @@ export interface FigureApplyDetail extends FigureRefusalRecord {
   key?: string
   steps: FigureProposalStep[]
   create: boolean
+  /** The figure a revision was made for: the one the model read. */
+  figureId?: string
   context?: string
   revision?: number
   applied?: boolean
@@ -41,6 +43,10 @@ export interface FigureProposalTarget {
   offer(detail: FigureApplyDetail): FigureApplyDetail
   /** Opens a new figure in the modeller and applies the steps there; resolves once the page has, or has not. */
   openNew(steps: FigureProposalStep[], key?: string): Promise<{ applied: boolean; error?: string; code?: string }>
+  /** The figures the server recorded a save of this proposal into (`figureProposalOutcome`), first saved first. */
+  savedInto(key: string): Promise<ReadonlyArray<{ figureId: string; type?: string; name?: string }>>
+  /** Opens a saved figure in the modeller. */
+  openSaved(figureId: string): void
 }
 
 export interface FigureProposalOutcome {
@@ -78,7 +84,8 @@ function refused(refusal: FigureRefusalRecord & { error?: string }, say: Say): F
         ? (error ?? '')
         : clips
           ? say('figure.text.proposal-would-drop-clips', { clips: clips.map(c => c.clip).join(', ') })
-          : say('figure.text.proposal-refused', { reason: error ?? '' })
+          : /* A refusal with a code is said from it, as the modeller says an edit it refuses; never its message (audit N6). */
+            say('figure.text.proposal-refused', { reason: code ? editRefusalOf(refusal, (key, params) => say(key, params)) : (error ?? '') })
   return { verdict: 'refused', errorCode: code ?? 'refused', note }
 }
 
@@ -95,6 +102,12 @@ export function takeFigureOffer(
 ): boolean {
   const view = session.read()
   if (detail.create && onSavedFigure) return false
+  /*
+    A revision is for the figure the model read; with another open it is left untaken, and the handler says it needs that
+    figure open. The version is no proof of the figure: two figures opened in two page loads stood at the same one
+    (figure audit 2026-10-16 N3).
+  */
+  if (!detail.create && typeof detail.figureId === 'string' && detail.figureId !== (view.id ?? view.creationId)) return false
   if (detail.create && view.dirty) {
     /* A new figure already being made is the person's; a proposal does not go on top of it or replace it. */
     detail.applied = false
@@ -104,8 +117,11 @@ export function takeFigureOffer(
   }
   try {
     if (detail.create) {
-      /* Created under the proposal's key: taken twice, it meets the first figure, never a second (ADR-0097 §5.6 item 5). */
-      if (detail.key) session.createUnder(detail.key)
+      /*
+        Taken on the new figure the modeller has open, whose conversation asked for it: the figure keeps its own creation
+        id, the anchor of that conversation (ADR-0061 decision 3, ruled 2026-10-16). One proposal stays one figure by the
+        save's record of it, which `runFigureProposal` reads before the card runs again.
+      */
       session.applyProposal(detail.steps, view.revision!, view.context!, detail.key)
     } else if (detail.steps) session.applyProposal(detail.steps, detail.revision!, detail.context!, detail.key)
     else session.apply(detail.changes as never, 'ai', detail.revision, detail.context)
@@ -121,15 +137,26 @@ export function takeFigureOffer(
 
 export async function runFigureProposal(card: FigureProposalCard, target: FigureProposalTarget, say: Say): Promise<FigureProposalOutcome> {
   const steps = card?.steps
-  if (!Array.isArray(steps) || !steps.length) return { verdict: 'unavailable', errorCode: 'no-steps' }
+  if (!Array.isArray(steps) || !steps.length) return { verdict: 'unavailable', errorCode: 'no-steps', note: say('figure.text.proposal-empty') }
   const create = card.create === true
+  /*
+    A new figure's proposal already saved into a figure is not made again: that figure is opened (ADR-0061 decision 3,
+    ruled 2026-10-16). Taken on a new figure that kept its own creation id, the save's record is what says it was made.
+  */
+  if (create && card.key) {
+    const saved = await target.savedInto(card.key)
+    if (saved.length) {
+      target.openSaved(saved[0]!.figureId)
+      return proposalOutcomeFrom(saved, say)!
+    }
+  }
   const accepted = (): FigureProposalOutcome => ({
     verdict: 'accepted',
     applied: steps.length,
     note: say('figure.text.proposal-applied', { n: String(steps.length) })
   })
 
-  const detail = target.offer({ key: card.key, steps, create, context: card.context, revision: card.revision })
+  const detail = target.offer({ key: card.key, steps, create, figureId: create ? undefined : card.figureId, context: card.context, revision: card.revision })
   if (detail.applied) return accepted()
   if (detail.applied === false) return refused(detail, say)
 
@@ -148,11 +175,14 @@ export async function runFigureProposal(card: FigureProposalCard, target: Figure
   modeller on a new figure; the page takes it once it has started that figure. Left untaken, it lapses -- a later new
   figure must not receive steps nobody is waiting for.
 */
-let pending: { steps: FigureProposalStep[]; key?: string; settle: (result: { applied: boolean; error?: string; code?: string }) => void } | undefined
+type Settle = (result: { applied: boolean; error?: string; code?: string }) => void
+let pending: { steps: FigureProposalStep[]; key?: string; settle: Settle; hold(): void; resume(): void } | undefined
 
 export function pendNewFigure(steps: FigureProposalStep[], key?: string, ms = 10_000): Promise<{ applied: boolean; error?: string; code?: string }> {
   pending?.settle({ applied: false, code: 'not-opened' })
   return new Promise(resolve => {
+    let timer: ReturnType<typeof setTimeout> | undefined
+    const lapse = () => mine.settle({ applied: false, code: 'not-opened' })
     const mine = {
       steps,
       key,
@@ -160,17 +190,36 @@ export function pendNewFigure(steps: FigureProposalStep[], key?: string, ms = 10
         clearTimeout(timer)
         if (pending === mine) pending = undefined
         resolve(result)
+      },
+      hold: () => clearTimeout(timer),
+      resume: () => {
+        clearTimeout(timer)
+        timer = setTimeout(lapse, ms)
       }
     }
-    const timer = setTimeout(() => mine.settle({ applied: false, code: 'not-opened' }), ms)
+    mine.resume()
     pending = mine
   })
 }
 
+/**
+ * For a page about to ask the person whether to leave unsaved edits: the new figure waiting to open stops its clock
+ * while they answer -- an answer is no absent page (figure audit 2026-10-16 N4). Give it the answer: leaving runs the
+ * clock again for the page that opens; staying says now that it was not opened. Nothing waiting: undefined.
+ */
+export function askingToLeave(): ((leaving: boolean) => void) | undefined {
+  const waiting = pending
+  if (!waiting) return undefined
+  waiting.hold()
+  return leaving => {
+    if (pending !== waiting) return
+    if (leaving) waiting.resume()
+    else waiting.settle({ applied: false, code: 'not-opened' })
+  }
+}
+
 /** For the page, on a new figure it has just started: the steps waiting for it, and where to say how it went. */
-export function takePendingNewFigure():
-  | { steps: FigureProposalStep[]; key?: string; settle: (result: { applied: boolean; error?: string; code?: string }) => void }
-  | undefined {
+export function takePendingNewFigure(): { steps: FigureProposalStep[]; key?: string; settle: Settle } | undefined {
   const taken = pending
   pending = undefined
   return taken

package/client/modeller/figure-properties.ts

@@ -8,7 +8,6 @@ import { i18next, localize } from '@operato/i18n'
 import { FIGURE_FACES } from '@hatiolab/figure-model'
 import type { FigureAuthoringAction, FigureFace } from '@hatiolab/figure-model'
 
-import './figure-carrier.js'
 import { occupancyFromParts } from './occupancy.js'
 import { tagsOf, figureFigureFacts, type Placement, type FigureFigureFacts } from './figure-facts.js'
 import { offeredMountingOf } from './mounting-part.js'
@@ -26,7 +25,7 @@ const FACES = Object.keys(FIGURE_FACES) as FigureFace[]
  * catalogue files it.
  *
  * Two kinds of change leave this tab, and it does neither itself:
- *  - `command` carries an authoring command (rename, declare the room, the mounting face, the carrier). The page runs it
+ *  - `command` carries an authoring command (rename, declare the room, the mounting face). The page runs it
  *    through the session, so it is one step of the same undo history as every other edit, and is saved with it.
  *  - `catalog` carries a change to the row (category, tags). Those are not in the asset; the page writes them
  *    to the saved row at once, so they need a saved figure.
@@ -125,7 +124,6 @@ export class FigureProperties extends localize(i18next)(LitElement) {
         <h3>${i18next.t('figure.label.group-standing')}</h3>
         ${this.renderSpace(facts)} ${this.renderMounting(facts)}
       </section>
-      <figure-carrier .carrier=${this.revision?.asset.carrier}></figure-carrier>
       <section>
         <h3>${i18next.t('figure.label.group-catalog')}</h3>
         ${this.renderCatalog()}

package/client/modeller/product-session.ts

@@ -14,6 +14,15 @@ import {
 } from '@hatiolab/figure-model'
 
 /** Consent to let clips go, and the figure and version it was given on. */
+
+/**
+ * A request the session refuses, with its code: a screen says it from the code (`sessionRefusalOf`), never from the
+ * message, which stays for logs (ADR-0054; figure audit 2026-10-16 N6 -- an AI card put the message in its note).
+ */
+function refusal(code: string, message: string): Error & { code: string } {
+  return Object.assign(Error(message), { code })
+}
+
 export interface FigureClipConsentFor extends FigureClipConsent {
   context: string
   revision: number
@@ -72,8 +81,12 @@ export function createFigureProductSession(store: FigureProductStore) {
     return result
   }
   const inEffect = () => [...new Set(done.filter((tag): tag is string => !!tag))]
+  /*
+    The creation id is read with the rest: a figure not saved yet is named by it (ADR-0061 decision 3) -- its AI
+    conversation is anchored on it, and its first save inserts the row under it, so the name holds across that save.
+  */
   function read() {
-    return { ...workspace.read(), id, loading, saving, error }
+    return { ...workspace.read(), id, creationId, loading, saving, error }
   }
   /*
     The version on screen, one object for as long as it is the version: the workspace hands out one asset per version
@@ -106,13 +119,18 @@ export function createFigureProductSession(store: FigureProductStore) {
     }
     return { dropClips: given.dropClips }
   }
-  function writable() {
+  /* A model open to read: the draft is read during a save too -- the dock reads it when the person sends (audit N5). */
+  function readable() {
     const view = workspace.read()
-    if (loading || error || !view.context || view.revision === null) throw Error('먼저 모델을 정상적으로 열어 주세요.')
-    // Serializing writes also makes create retries safe: no second create while the first is pending.
-    if (saving) throw Error('저장이 끝난 뒤 편집해 주세요.')
+    if (loading || error || !view.context || view.revision === null) throw refusal('SESSION_NOT_OPEN', '먼저 모델을 정상적으로 열어 주세요.')
     return { context: view.context, expectedRevision: view.revision, origin: 'ui' as const }
   }
+  function writable() {
+    const open = readable()
+    // Serializing writes also makes create retries safe: no second create while the first is pending.
+    if (saving) throw refusal('SESSION_SAVING', '저장이 끝난 뒤 편집해 주세요.')
+    return open
+  }
   function clear() {
     workspace.close({ discardDesignChanges: true })
     id = undefined
@@ -175,7 +193,7 @@ export function createFigureProductSession(store: FigureProductStore) {
       const control = writable()
       // AI must supply the context AND revision captured when it started. Never substitute current values.
       if (origin === 'ai' && (context === undefined || expectedRevision === undefined))
-        throw Error('AI 편집에는 요청 당시의 모델 문맥과 리비전이 필요합니다.')
+        throw refusal('SESSION_VERSION_MISSING', 'AI 편집에는 요청 당시의 모델 문맥과 리비전이 필요합니다.')
       return tracked('do', () =>
         workspace.apply({
           ...control,
@@ -196,13 +214,14 @@ export function createFigureProductSession(store: FigureProductStore) {
       return tracked('do', () => workspace.applyProposal({ origin: 'ai', context, expectedRevision, steps }), key)
     },
     /**
-     * A new figure made from an AI proposal is created under the proposal's key (ADR-0097 §5.6 item 5): the same
-     * proposal taken twice meets the first figure on the server, never a second one. Only on a new figure not yet
-     * touched -- one being made is the person's, and keeps its own.
+     * A new figure opened for an AI proposal from another screen is created under the proposal's key (ADR-0097 §5.6
+     * item 5). Only before the modeller names the figure to the AI dock: once a conversation is anchored on the creation
+     * id it stays (ADR-0061 decision 3), and the save's record of the proposal keeps one proposal one figure. Only on a
+     * new figure not yet touched -- one being made is the person's, and keeps its own.
      */
     createUnder(key: string) {
-      if (id || workspace.read().dirty) throw Error('손대지 않은 새 모델에만 쓸 수 있습니다.')
-      if (!/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(key)) throw Error('제안 식별자가 올바르지 않습니다.')
+      if (id || workspace.read().dirty) throw refusal('SESSION_NEW_FIGURE_TOUCHED', '손대지 않은 새 모델에만 쓸 수 있습니다.')
+      if (!/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(key)) throw refusal('SESSION_PROPOSAL_KEY', '제안 식별자가 올바르지 않습니다.')
       creationId = key
     },
     /** The AI proposals whose steps are in the model now, each once. */
@@ -224,7 +243,7 @@ export function createFigureProductSession(store: FigureProductStore) {
     /** What a command would do, on a copy (ADR-0097 §5.5): nothing is written, and the answer names its version. */
     previewCommand(action: FigureAuthoringAction) {
       const view = workspace.read()
-      if (loading || error || !view.context || view.revision === null) throw Error('먼저 모델을 정상적으로 열어 주세요.')
+      if (loading || error || !view.context || view.revision === null) throw refusal('SESSION_NOT_OPEN', '먼저 모델을 정상적으로 열어 주세요.')
       return workspace.previewCommand({ context: view.context, action })
     },
     /** One authoring command — what a person means, not a graph edit — as one step of the same history. */
@@ -251,7 +270,7 @@ export function createFigureProductSession(store: FigureProductStore) {
       return tracked('redo', () => workspace.redo(writable()))
     },
     source() {
-      const { context } = writable()
+      const { context } = readable()
       return workspace.export({ context }).text
     },
     /**

package/client/modeller/refusals.ts

@@ -226,8 +226,22 @@ function documentLimitRefusalOf(error: unknown, say: Say): string | null {
  * the kernel's English on the screen (the duplicate of a row's part showed 「EDIT_TARGET: … not a repeated template」,
  * 2026-09-27).
  */
+/** The modeller session's own refusals (`product-session.ts`), by their code. Nothing for any other refusal. */
+const SESSION_REFUSALS: Record<string, string> = {
+  SESSION_NOT_OPEN: 'figure.text.session-not-open',
+  SESSION_SAVING: 'figure.text.session-saving',
+  SESSION_VERSION_MISSING: 'figure.text.session-version-missing',
+  SESSION_NEW_FIGURE_TOUCHED: 'figure.text.session-new-figure-touched',
+  SESSION_PROPOSAL_KEY: 'figure.text.session-proposal-key'
+}
+export function sessionRefusalOf(error: unknown, say: Say): string | null {
+  const key = SESSION_REFUSALS[codeOf(error) ?? '']
+  return key ? say(key, {}) : null
+}
+
 export function editRefusalOf(error: unknown, say: Say): string {
   return (
+    sessionRefusalOf(error, say) ??
     sizeRangeRefusalOf(error, say) ??
     inputRangeRefusalOf(error, say) ??
     repeatPitchRefusalOf(error, say) ??

package/client/pages/figure-modeller-page.ts

@@ -6,7 +6,8 @@ import { modellerPathOf } from '../modeller/modeller-route.js'
 import { createFigureProductSession } from '../modeller/product-session.js'
 import { figureProductStore } from '../graphql/store.js'
 import { i18next } from '@operato/i18n'
-import { fetchFigure, fetchFigureTypeNames, fetchProposalOutcome, updateFigure } from '../graphql/index.js'
+import { fetchFigure, fetchFigureTypeNames, updateFigure } from '../graphql/index.js'
+import { figureProposalOutcome } from '../figure-assistant.js'
 import { availableRecipes, recipeGuide } from '../modeller/recipe-source.js'
 import type { RecipeTemplate } from '../modeller/recipes.js'
 import { occupancyFromParts } from '../modeller/occupancy.js'
@@ -30,7 +31,7 @@ import {
 import type { FirstSave } from '../modeller/first-save.js'
 import { typeOf } from '../modeller/first-save.js'
 import { editRefusalOf } from '../modeller/refusals.js'
-import { proposalOutcomeFrom, takeFigureOffer, takePendingNewFigure } from '../modeller/ai-proposal.js'
+import { askingToLeave, takeFigureOffer, takePendingNewFigure } from '../modeller/ai-proposal.js'
 
 /**
  * The product page has exactly one authoritative workspace for UI and AI input transactions.
@@ -126,22 +127,23 @@ export class FigureModellerPage extends PageView {
   /** The figure the AI dock was last told about - another id is another conversation. */
   private assistantFor?: string
   /*
-    The figure on screen is what the AI dock talks about (design/ai/shared-dock.md §3). A figure not saved yet has no
-    row to hang a conversation on, so it provides nothing and the dock stays on the application's conversation.
+    The figure on screen is what the AI dock talks about (design/ai/shared-dock.md §3). A figure not saved yet is named
+    by its creation id, the id its first save inserts the row under (ADR-0061 decision 3, ADR-0072 decision 6): the
+    anchor is the same before and after that save, so the conversation goes on, with nothing to bind again.
     The draft is read at the moment of sending, never cached - the dock must not answer about a shape already changed.
   */
   private provideAssistant = () => {
     const view = this.session.read()
     if (!this.active || view.loading || view.error || !view.context) return
-    if (!view.id) {
+    const id = view.id ?? view.creationId
+    if (!id) {
       this.withdrawAssistant()
       return
     }
-    if (this.assistantFor === view.id) {
+    if (this.assistantFor === id) {
       notifyAssistantSurface(this)
       return
     }
-    const id = view.id
     this.assistantFor = id
     provideAssistantSurface(this, {
       key: `figure:${id}`,
@@ -151,11 +153,10 @@ export class FigureModellerPage extends PageView {
       detail: () => (this.session.read().dirty ? i18next.t('figure.text.unsaved-changes') : ''),
       anchor: () => ({ anchorType: 'figure', anchorId: id }),
       /* The card's "check the result": the server's record, never the dock's memory; nothing is applied again. */
-      proposalOutcome: async (proposalKey: string) =>
-        proposalOutcomeFrom(await fetchProposalOutcome(proposalKey), (key, params) => i18next.t(key, params)),
+      proposalOutcome: figureProposalOutcome,
       hostContext: () => ({
         surface: 'figure-modeller',
-        editorMode: 'existing',
+        editorMode: this.session.read().id ? 'existing' : 'new',
         figureId: id,
         draftSource: JSON.parse(this.session.source()),
         /* The version the model sees; a proposal is applied on it, or refused if the figure moved on (ADR-0094). */
@@ -388,6 +389,8 @@ export class FigureModellerPage extends PageView {
       The shell asks this while the edited model is still on screen. The app's own prompt, as every operato screen
       asks -- not the browser's confirm box (user, 2026-09-24).
     */
+    /* A new figure the dock is opening waits for this answer, not against a clock (audit N4). */
+    const answered = askingToLeave()
     this.discardApproved = !!(await OxPrompt.open({
       type: 'warning',
       title: i18next.t('figure.text.unsaved-changes'),
@@ -395,6 +398,7 @@ export class FigureModellerPage extends PageView {
       confirmButton: { text: i18next.t('figure.button.leave-without-saving') },
       cancelButton: { text: i18next.t('figure.button.keep-editing') }
     }))
+    answered?.(this.discardApproved)
     return this.discardApproved
   }
   async pageUpdated(changes: Record<string, unknown>, lifecycle: { resourceId?: string }) {

package/dist-client/figure-assistant.d.ts

@@ -1 +1,7 @@
 export declare const FIGURE_CANDIDATE_TOOL = "proposeFigureCandidate";
+/**
+ * The dock's "check the result" of a figure proposal, on every screen that offers its card: what the server recorded of
+ * its save (ADR-0097 §5.6 item 5). The modeller asks it, and so does an app's home where a new figure's card is made --
+ * there it was missing, and a card cut off by a reload stayed "no answer" for good (figure audit 2026-10-16 N8).
+ */
+export declare function figureProposalOutcome(proposalKey: string): Promise<import("./modeller/ai-proposal.js").FigureProposalOutcome | undefined>;

package/dist-client/figure-assistant.js

@@ -9,9 +9,18 @@
 import { i18next } from '@operato/i18n';
 import { navigate } from '@operato/shell';
 import { registerProposalHandler } from '@things-factory/ai-assistant/dist-client/index.js';
+import { fetchProposalOutcome } from './graphql/index.js';
 import { modellerPathOf } from './modeller/modeller-route.js';
-import { pendNewFigure, runFigureProposal } from './modeller/ai-proposal.js';
+import { pendNewFigure, proposalOutcomeFrom, runFigureProposal } from './modeller/ai-proposal.js';
 export const FIGURE_CANDIDATE_TOOL = 'proposeFigureCandidate';
+/**
+ * The dock's "check the result" of a figure proposal, on every screen that offers its card: what the server recorded of
+ * its save (ADR-0097 §5.6 item 5). The modeller asks it, and so does an app's home where a new figure's card is made --
+ * there it was missing, and a card cut off by a reload stayed "no answer" for good (figure audit 2026-10-16 N8).
+ */
+export async function figureProposalOutcome(proposalKey) {
+    return proposalOutcomeFrom(await fetchProposalOutcome(proposalKey), (key, params) => i18next.t(key, params));
+}
 registerProposalHandler(FIGURE_CANDIDATE_TOOL, async (proposal, context) => {
     const outcome = await runFigureProposal(proposal, {
         offer(detail) {
@@ -22,6 +31,10 @@ registerProposalHandler(FIGURE_CANDIDATE_TOOL, async (proposal, context) => {
             const opened = pendNewFigure(steps, key);
             navigate(modellerPathOf());
             return opened;
+        },
+        savedInto: fetchProposalOutcome,
+        openSaved(id) {
+            navigate(modellerPathOf({ id }));
         }
     }, (key, params) => i18next.t(key, params));
     if (outcome.note)

package/dist-client/figure-assistant.js.map

@@ -1 +1 @@
-{"version":3,"file":"figure-assistant.js","sourceRoot":"","sources":["../client/figure-assistant.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAA;AAE3F,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAA0B,MAAM,2BAA2B,CAAA;AAEpG,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAA;AAE7D,uBAAuB,CAAC,qBAAqB,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IACzE,MAAM,OAAO,GAAG,MAAM,iBAAiB,CACrC,QAAQ,EACR;QACE,KAAK,CAAC,MAAyB;YAC7B,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;YACjE,OAAO,MAAM,CAAA;QACf,CAAC;QACD,OAAO,CAAC,KAAK,EAAE,GAAG;YAChB,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;YACxC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAA;YAC1B,OAAO,MAAM,CAAA;QACf,CAAC;KACF,EACD,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CACxC,CAAA;IACD,IAAI,OAAO,CAAC,IAAI;QAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACjG,OAAO,OAAO,CAAA;AAChB,CAAC,CAAC,CAAA","sourcesContent":["/*\n * What the AI dock does with a figure proposal - figure-ui declares it because figure-service declares the tool\n * (`proposeFigureCandidate`, design/ai/shared-dock.md §4).\n *\n * A proposal is a list of the modeller's own commands (ADR-0094). Running it applies them in the modeller as one step\n * of its history: a revision on the figure open there, at the version the model saw; a new figure on a new figure the\n * modeller opens. The outcome is said in words on every branch (`ai-proposal.ts`).\n */\nimport { i18next } from '@operato/i18n'\nimport { navigate } from '@operato/shell'\nimport { registerProposalHandler } from '@things-factory/ai-assistant/dist-client/index.js'\n\nimport { modellerPathOf } from './modeller/modeller-route.js'\nimport { pendNewFigure, runFigureProposal, type FigureApplyDetail } from './modeller/ai-proposal.js'\n\nexport const FIGURE_CANDIDATE_TOOL = 'proposeFigureCandidate'\n\nregisterProposalHandler(FIGURE_CANDIDATE_TOOL, async (proposal, context) => {\n  const outcome = await runFigureProposal(\n    proposal,\n    {\n      offer(detail: FigureApplyDetail) {\n        window.dispatchEvent(new CustomEvent('figure-apply', { detail }))\n        return detail\n      },\n      openNew(steps, key) {\n        const opened = pendNewFigure(steps, key)\n        navigate(modellerPathOf())\n        return opened\n      }\n    },\n    (key, params) => i18next.t(key, params)\n  )\n  if (outcome.note) context.notify(outcome.verdict === 'accepted' ? 'info' : 'error', outcome.note)\n  return outcome\n})\n"]}
+{"version":3,"file":"figure-assistant.js","sourceRoot":"","sources":["../client/figure-assistant.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAA;AAE3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAA0B,MAAM,2BAA2B,CAAA;AAEzH,MAAM,CAAC,MAAM,qBAAqB,GAAG,wBAAwB,CAAA;AAE7D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,WAAmB;IAC7D,OAAO,mBAAmB,CAAC,MAAM,oBAAoB,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAA;AAC9G,CAAC;AAED,uBAAuB,CAAC,qBAAqB,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE;IACzE,MAAM,OAAO,GAAG,MAAM,iBAAiB,CACrC,QAAQ,EACR;QACE,KAAK,CAAC,MAAyB;YAC7B,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;YACjE,OAAO,MAAM,CAAA;QACf,CAAC;QACD,OAAO,CAAC,KAAK,EAAE,GAAG;YAChB,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;YACxC,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAA;YAC1B,OAAO,MAAM,CAAA;QACf,CAAC;QACD,SAAS,EAAE,oBAAoB;QAC/B,SAAS,CAAC,EAAE;YACV,QAAQ,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;QAClC,CAAC;KACF,EACD,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CACxC,CAAA;IACD,IAAI,OAAO,CAAC,IAAI;QAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IACjG,OAAO,OAAO,CAAA;AAChB,CAAC,CAAC,CAAA","sourcesContent":["/*\n * What the AI dock does with a figure proposal - figure-ui declares it because figure-service declares the tool\n * (`proposeFigureCandidate`, design/ai/shared-dock.md §4).\n *\n * A proposal is a list of the modeller's own commands (ADR-0094). Running it applies them in the modeller as one step\n * of its history: a revision on the figure open there, at the version the model saw; a new figure on a new figure the\n * modeller opens. The outcome is said in words on every branch (`ai-proposal.ts`).\n */\nimport { i18next } from '@operato/i18n'\nimport { navigate } from '@operato/shell'\nimport { registerProposalHandler } from '@things-factory/ai-assistant/dist-client/index.js'\n\nimport { fetchProposalOutcome } from './graphql/index.js'\nimport { modellerPathOf } from './modeller/modeller-route.js'\nimport { pendNewFigure, proposalOutcomeFrom, runFigureProposal, type FigureApplyDetail } from './modeller/ai-proposal.js'\n\nexport const FIGURE_CANDIDATE_TOOL = 'proposeFigureCandidate'\n\n/**\n * The dock's \"check the result\" of a figure proposal, on every screen that offers its card: what the server recorded of\n * its save (ADR-0097 §5.6 item 5). The modeller asks it, and so does an app's home where a new figure's card is made --\n * there it was missing, and a card cut off by a reload stayed \"no answer\" for good (figure audit 2026-10-16 N8).\n */\nexport async function figureProposalOutcome(proposalKey: string) {\n  return proposalOutcomeFrom(await fetchProposalOutcome(proposalKey), (key, params) => i18next.t(key, params))\n}\n\nregisterProposalHandler(FIGURE_CANDIDATE_TOOL, async (proposal, context) => {\n  const outcome = await runFigureProposal(\n    proposal,\n    {\n      offer(detail: FigureApplyDetail) {\n        window.dispatchEvent(new CustomEvent('figure-apply', { detail }))\n        return detail\n      },\n      openNew(steps, key) {\n        const opened = pendNewFigure(steps, key)\n        navigate(modellerPathOf())\n        return opened\n      },\n      savedInto: fetchProposalOutcome,\n      openSaved(id) {\n        navigate(modellerPathOf({ id }))\n      }\n    },\n    (key, params) => i18next.t(key, params)\n  )\n  if (outcome.note) context.notify(outcome.verdict === 'accepted' ? 'info' : 'error', outcome.note)\n  return outcome\n})\n"]}

package/dist-client/modeller/ai-proposal.d.ts

@@ -19,6 +19,8 @@ export interface FigureApplyDetail extends FigureRefusalRecord {
     key?: string;
     steps: FigureProposalStep[];
     create: boolean;
+    /** The figure a revision was made for: the one the model read. */
+    figureId?: string;
     context?: string;
     revision?: number;
     applied?: boolean;
@@ -34,6 +36,14 @@ export interface FigureProposalTarget {
         error?: string;
         code?: string;
     }>;
+    /** The figures the server recorded a save of this proposal into (`figureProposalOutcome`), first saved first. */
+    savedInto(key: string): Promise<ReadonlyArray<{
+        figureId: string;
+        type?: string;
+        name?: string;
+    }>>;
+    /** Opens a saved figure in the modeller. */
+    openSaved(figureId: string): void;
 }
 export interface FigureProposalOutcome {
     verdict: 'accepted' | 'refused' | 'unavailable';
@@ -64,18 +74,26 @@ export declare function takeFigureOffer(session: FigureProductSession, detail: F
     say: Say;
 }): boolean;
 export declare function runFigureProposal(card: FigureProposalCard, target: FigureProposalTarget, say: Say): Promise<FigureProposalOutcome>;
+type Settle = (result: {
+    applied: boolean;
+    error?: string;
+    code?: string;
+}) => void;
 export declare function pendNewFigure(steps: FigureProposalStep[], key?: string, ms?: number): Promise<{
     applied: boolean;
     error?: string;
     code?: string;
 }>;
+/**
+ * For a page about to ask the person whether to leave unsaved edits: the new figure waiting to open stops its clock
+ * while they answer -- an answer is no absent page (figure audit 2026-10-16 N4). Give it the answer: leaving runs the
+ * clock again for the page that opens; staying says now that it was not opened. Nothing waiting: undefined.
+ */
+export declare function askingToLeave(): ((leaving: boolean) => void) | undefined;
 /** For the page, on a new figure it has just started: the steps waiting for it, and where to say how it went. */
 export declare function takePendingNewFigure(): {
     steps: FigureProposalStep[];
     key?: string;
-    settle: (result: {
-        applied: boolean;
-        error?: string;
-        code?: string;
-    }) => void;
+    settle: Settle;
 } | undefined;
+export {};