@things-factory/ai-assistant 10.1.26 → 10.1.28

package/dist-client/components/assistant-mode.d.ts

@@ -1,97 +1,109 @@
 /**
- * A mode is what a conversation *is*: who the assistant is, what it can do, what the talk is
- * about, what it offers to start with, and when it is over.
+ * A mode is what a conversation *is*: which conversation this is, and what it is about.
  *
- * Those five used to be four separate properties on the chat element plus one global registry,
- * and every host wired them one at a time. Separate means they can disagree, and they did: a
- * screen whose `systemPrompt` said "you do not edit boards here" offered `/add-monitor` in the
- * same panel, because the prompt was a property and the slash list was global.
- *
- * So a host declares one value and hands it over. What cannot be split cannot fall out of step.
+ * Those two used to be nine. The browser declared the persona, the tool categories, the model and
+ * the limits and sent them with every turn, which meant a caller holding the door's privilege
+ * chose its own authority — and it meant a screen could describe a conversation one way while the
+ * server answered it another. Since ADR-0061 decision 7 the app server registers the mode and the
+ * browser names it:
  *
  * ```ts
- * const SPACE_MODE = (spaceId: string): AssistantMode => ({
- *   id: `twin:space:${spaceId}`,
- *   systemPrompt: '...',
- *   toolCategories: ['twin'],
- *   hostContext: { spaceId },
- *   slashTemplates: TWIN_SLASH_TEMPLATES
- * })
- *
- * html`<ox-assistant-chat .mode=${SPACE_MODE(this.spaceId)}></ox-assistant-chat>`
+ * html`<ox-assistant-chat .mode=${{ kind: 'twin.space', target: spaceId, hostContext: { spaceId } }}></ox-assistant-chat>`
  * ```
+ *
+ * What the panel shows — the `/` sentences, the `@` catalog, the two notices — comes from the same
+ * declaration, fetched from the server already written in the person's language, so the panel and
+ * the door cannot offer different conversations.
  */
 export interface AssistantMode {
     /**
-     * What this conversation is about, as a string the host can compare.
-     *
-     * **The conversation's lifetime hangs on this.** When it changes, the chat closes what is on
-     * screen and starts again — because a conversation about station 3 is not a conversation
-     * about station 7, and leaving the old one up means the user reads an answer about a screen
-     * they are no longer looking at.
-     *
-     * Hosts built this by hand before, each in their own way: plant kept a module-global registry
-     * with subscribers and re-checked the context on every send, twin closed its session when the
-     * anchor moved. Both were writing the same guard around the same absence.
+     * Which conversation this is — a `<app>.<surface>` kind the app server registered.
+     */
+    kind: string;
+    /**
+     * What it is about: the space, the station, the model being edited.
      *
-     * Include whatever makes the subject specific — `twin:space:S-12`, `plant:station:3`.
+     * **With `kind`, this is the conversation's lifetime.** When either changes the chat closes what
+     * is on screen and starts again — a conversation about station 3 is not a conversation about
+     * station 7, and leaving the old one up means the person reads an answer about a screen they are
+     * no longer looking at.
      */
-    id: string;
-    /** Who the assistant is here, and what it must not claim to do. */
-    systemPrompt?: string;
-    /** Which tool categories the server may expose for this conversation. */
-    toolCategories?: string[];
-    /** What the host knows about the subject; travels with each request. */
-    hostContext?: any;
-    /** Which server-side chat entry point answers. */
-    chatEndpoint?: 'boardAIChat' | 'assistantChat';
-    /** What `@` offers. */
-    catalogEntries?: any[];
+    target?: string;
     /**
-     * What `/` offers.
+     * What the host knows about the subject; travels with each request.
      *
-     * These are sentences a person could have typed, not tool names — "이 공간의 지금 상태를
-     * 요약해줘" cannot be generated from `summarizeStatus`. But **a mode must not offer work it
-     * cannot do**: everything here should be answerable by the tools `toolCategories` opens.
+     * **The model never sees this** — it reaches the tools as `ctx.host` and nothing else (ADR-0061
+     * decision 7). Anything the model must know is answered by a read tool.
      */
-    slashTemplates?: any[];
-    /** The i18n key for the line under an empty conversation. */
-    footerNoticeKey?: string;
-    /** Follow-up chips for a proposal that arrived without its own. */
-    proposalChoices?: any[];
-    /** The i18n key for the line shown once the host reports a proposal staged. */
-    stagedNoticeKey?: string;
+    hostContext?: any;
+}
+/** What the server said this mode offers, already in the request's locale. */
+export interface AssistantModeView {
+    kind: string;
+    slashTemplates: any[];
+    catalogEntries: any[];
+    proposalChoices: any[];
+    placeholder?: string;
+    footerNotice?: string;
+    stagedNotice?: string;
 }
 /** True when these two describe different conversations, so the old one should be closed. */
 export declare function isDifferentConversation(a?: AssistantMode, b?: AssistantMode): boolean;
-/** Everything a conversation needs, after the mode, the host's own properties and the
- *  registered defaults have been reconciled. */
+/** Everything a conversation needs, after the mode, the host's own properties, the registered
+ *  defaults and the server's answer have been reconciled. */
 export interface ConversationSettings {
-    systemPrompt?: string;
-    toolCategories?: string[];
+    /** Set when a mode names this conversation; absent for a host that declares none. */
+    kind?: string;
+    target?: string;
     hostContext?: any;
     chatEndpoint: 'boardAIChat' | 'assistantChat';
     catalogEntries: any[];
     slashTemplates: any[];
-    footerNoticeKey?: string;
+    /** What the empty input says. A mode's comes translated from the server. */
+    placeholder?: string;
+    /** Sentences, not keys — a mode's come translated from the server, a host's from its own i18n. */
+    footerNotice?: string;
     proposalChoices: any[];
-    stagedNoticeKey?: string;
+    stagedNotice?: string;
 }
 /**
  * Reconcile the places a setting can come from.
  *
- * **A host that declares a mode gets the mode and nothing else.** A field the mode leaves out is
- * empty: it is not filled from the element's own properties, and it is not filled from the
- * defaults another package registered. Filling it back in is how the defect this type removes
- * returned — board-ai registers board authoring's `/add-monitor`, its component `@` catalog and
- * its "previewed on the board" line globally, and plant's factory mode, which declares no slash
- * list, offered them on a factory screen once the board modeller had been loaded. A mode that
- * wants those declares them.
+ * **A host that declares a mode gets the mode and nothing else.** What the mode does not offer is
+ * not filled in from the element's own properties or from the defaults another package registered.
+ * Filling it back in is how the defect this type removes returned — board-ai registers board
+ * authoring's `/add-monitor`, its component `@` catalog and its "previewed on the board" line
+ * globally, and plant's factory mode, which declares no slash list, offered them on a factory
+ * screen once the board modeller had been loaded.
+ *
+ * A mode's offering arrives asynchronously, so until the server has answered a mode offers
+ * nothing. Standing the defaults in during that gap would show the board's list for a moment on a
+ * screen that does not edit boards.
+ *
+ * A host that declares no mode gets exactly what it got before modes existed — its own properties,
+ * falling back to the registered defaults — and it must name its own door: the `boardAIChat`
+ * default was removed with decision 7, because a missing door should show when a surface is
+ * declared, not when a person says something.
+ */
+export declare function resolveConversation(mode: AssistantMode | undefined, own: Partial<ConversationSettings>, defaults: Partial<ConversationSettings>, view?: AssistantModeView): ConversationSettings;
+/** 한 subject 위에 설 수 있는 대화 하나 — 서버가 준 목록의 한 줄. */
+export interface AssistantModeChoice {
+    kind: string;
+    label: string;
+    isDefault: boolean;
+}
+/**
+ * 이 화면을 열 때 어느 대화로 설 것인가 — ADR-0072 A17 ①.
+ *
+ * ── 왜 기억하나 ───────────────────────────────────────────────────────────
+ * 보드를 열 때마다 저작 대화로 되돌아가면, 현장을 물으려고 온 사람은 화면을 열 때마다 같은 손질을
+ * 다시 한다. 기억은 이 브라우저에만 남는다 — 서버에 칸을 만들지 않는다.
  *
- * A host that declares no mode gets exactly what it got before modes existed — its own
- * properties, falling back to the registered defaults.
+ * ── 기억을 언제 버리나 ────────────────────────────────────────────────────
+ * 기억한 종류가 지금 목록에 없으면 따르지 않는다. 대화가 하나 없어진 판으로 바뀌었는데 그 이름으로
+ * 열려고 하면 대화가 안 열리고, 사람은 자기가 무엇을 잘못했는지 알 길이 없다. 그때는 host 가 준
+ * 대화로 둔다.
  *
- * `chatEndpoint` still falls back to `boardAIChat` when nothing names one; that default is a
- * separate question (standard A2).
+ * 고를 것이 하나뿐이면 기억을 보지 않는다 — 고른 적이 없는 화면이다.
  */
-export declare function resolveConversation(mode: AssistantMode | undefined, own: Partial<ConversationSettings>, defaults: Partial<ConversationSettings>): ConversationSettings;
+export declare function pickInitialMode(current: string | undefined, choices: ReadonlyArray<AssistantModeChoice>, remembered: string | undefined): string | undefined;

package/dist-client/components/assistant-mode.js

@@ -1,36 +1,80 @@
 /** True when these two describe different conversations, so the old one should be closed. */
 export function isDifferentConversation(a, b) {
-    return (a?.id ?? '') !== (b?.id ?? '');
+    return `${a?.kind ?? ''}|${a?.target ?? ''}` !== `${b?.kind ?? ''}|${b?.target ?? ''}`;
 }
 /**
  * Reconcile the places a setting can come from.
  *
- * **A host that declares a mode gets the mode and nothing else.** A field the mode leaves out is
- * empty: it is not filled from the element's own properties, and it is not filled from the
- * defaults another package registered. Filling it back in is how the defect this type removes
- * returned — board-ai registers board authoring's `/add-monitor`, its component `@` catalog and
- * its "previewed on the board" line globally, and plant's factory mode, which declares no slash
- * list, offered them on a factory screen once the board modeller had been loaded. A mode that
- * wants those declares them.
+ * **A host that declares a mode gets the mode and nothing else.** What the mode does not offer is
+ * not filled in from the element's own properties or from the defaults another package registered.
+ * Filling it back in is how the defect this type removes returned — board-ai registers board
+ * authoring's `/add-monitor`, its component `@` catalog and its "previewed on the board" line
+ * globally, and plant's factory mode, which declares no slash list, offered them on a factory
+ * screen once the board modeller had been loaded.
  *
- * A host that declares no mode gets exactly what it got before modes existed — its own
- * properties, falling back to the registered defaults.
+ * A mode's offering arrives asynchronously, so until the server has answered a mode offers
+ * nothing. Standing the defaults in during that gap would show the board's list for a moment on a
+ * screen that does not edit boards.
  *
- * `chatEndpoint` still falls back to `boardAIChat` when nothing names one; that default is a
- * separate question (standard A2).
+ * A host that declares no mode gets exactly what it got before modes existed — its own properties,
+ * falling back to the registered defaults — and it must name its own door: the `boardAIChat`
+ * default was removed with decision 7, because a missing door should show when a surface is
+ * declared, not when a person says something.
  */
-export function resolveConversation(mode, own, defaults) {
-    const pick = (key) => mode ? mode[key] : (own[key] ?? defaults[key]);
+export function resolveConversation(mode, own, defaults, view) {
+    if (mode) {
+        /* A view for another kind is the previous conversation's answer arriving late. */
+        const offered = view && view.kind === mode.kind ? view : undefined;
+        return {
+            kind: mode.kind,
+            target: mode.target,
+            hostContext: mode.hostContext,
+            chatEndpoint: 'assistantChat',
+            catalogEntries: offered?.catalogEntries ?? [],
+            slashTemplates: offered?.slashTemplates ?? [],
+            proposalChoices: offered?.proposalChoices ?? [],
+            placeholder: offered?.placeholder,
+            footerNotice: offered?.footerNotice,
+            stagedNotice: offered?.stagedNotice
+        };
+    }
+    const pick = (key) => own[key] ?? defaults[key];
+    const chatEndpoint = pick('chatEndpoint');
+    if (!chatEndpoint) {
+        throw new Error('[ox-assistant-chat] a surface with no mode must name its chatEndpoint. The `boardAIChat` default was ' +
+            'removed (ADR-0061 decision 7) — apps declare a mode and talk to `assistantChat`; the board product ' +
+            'names `boardAIChat` on the element.');
+    }
     return {
-        systemPrompt: pick('systemPrompt'),
-        toolCategories: pick('toolCategories'),
         hostContext: pick('hostContext'),
-        chatEndpoint: pick('chatEndpoint') ?? 'boardAIChat',
+        placeholder: pick('placeholder'),
+        chatEndpoint,
         catalogEntries: pick('catalogEntries') ?? [],
         slashTemplates: pick('slashTemplates') ?? [],
-        footerNoticeKey: pick('footerNoticeKey'),
+        footerNotice: pick('footerNotice'),
         proposalChoices: pick('proposalChoices') ?? [],
-        stagedNoticeKey: pick('stagedNoticeKey')
+        stagedNotice: pick('stagedNotice')
     };
 }
+/**
+ * 이 화면을 열 때 어느 대화로 설 것인가 — ADR-0072 A17 ①.
+ *
+ * ── 왜 기억하나 ───────────────────────────────────────────────────────────
+ * 보드를 열 때마다 저작 대화로 되돌아가면, 현장을 물으려고 온 사람은 화면을 열 때마다 같은 손질을
+ * 다시 한다. 기억은 이 브라우저에만 남는다 — 서버에 칸을 만들지 않는다.
+ *
+ * ── 기억을 언제 버리나 ────────────────────────────────────────────────────
+ * 기억한 종류가 지금 목록에 없으면 따르지 않는다. 대화가 하나 없어진 판으로 바뀌었는데 그 이름으로
+ * 열려고 하면 대화가 안 열리고, 사람은 자기가 무엇을 잘못했는지 알 길이 없다. 그때는 host 가 준
+ * 대화로 둔다.
+ *
+ * 고를 것이 하나뿐이면 기억을 보지 않는다 — 고른 적이 없는 화면이다.
+ */
+export function pickInitialMode(current, choices, remembered) {
+    if (choices.length < 2)
+        return current;
+    if (!remembered || remembered === current)
+        return current;
+    return choices.some(choice => choice.kind === remembered) ? remembered : current;
+}
 //# sourceMappingURL=assistant-mode.js.map

package/dist-client/components/assistant-mode.js.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-mode.js","sourceRoot":"","sources":["../../client/components/assistant-mode.ts"],"names":[],"mappings":"AA0EA,6FAA6F;AAC7F,MAAM,UAAU,uBAAuB,CAAC,CAAiB,EAAE,CAAiB;IAC1E,OAAO,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;AACxC,CAAC;AAgBD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAA+B,EAC/B,GAAkC,EAClC,QAAuC;IAEvC,MAAM,IAAI,GAAG,CAAuC,GAAM,EAA2B,EAAE,CACrF,IAAI,CAAC,CAAC,CAAE,IAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,GAAW,CAAC,GAAG,CAAC,IAAK,QAAgB,CAAC,GAAG,CAAC,CAAC,CAAA;IAE3E,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC;QAClC,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC;QACtC,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC;QAChC,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,aAAa;QACnD,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE;QAC5C,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE;QAC5C,eAAe,EAAE,IAAI,CAAC,iBAAiB,CAAC;QACxC,eAAe,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAC9C,eAAe,EAAE,IAAI,CAAC,iBAAiB,CAAC;KACzC,CAAA;AACH,CAAC","sourcesContent":["/**\n * A mode is what a conversation *is*: who the assistant is, what it can do, what the talk is\n * about, what it offers to start with, and when it is over.\n *\n * Those five used to be four separate properties on the chat element plus one global registry,\n * and every host wired them one at a time. Separate means they can disagree, and they did: a\n * screen whose `systemPrompt` said \"you do not edit boards here\" offered `/add-monitor` in the\n * same panel, because the prompt was a property and the slash list was global.\n *\n * So a host declares one value and hands it over. What cannot be split cannot fall out of step.\n *\n * ```ts\n * const SPACE_MODE = (spaceId: string): AssistantMode => ({\n *   id: `twin:space:${spaceId}`,\n *   systemPrompt: '...',\n *   toolCategories: ['twin'],\n *   hostContext: { spaceId },\n *   slashTemplates: TWIN_SLASH_TEMPLATES\n * })\n *\n * html`<ox-assistant-chat .mode=${SPACE_MODE(this.spaceId)}></ox-assistant-chat>`\n * ```\n */\nexport interface AssistantMode {\n  /**\n   * What this conversation is about, as a string the host can compare.\n   *\n   * **The conversation's lifetime hangs on this.** When it changes, the chat closes what is on\n   * screen and starts again — because a conversation about station 3 is not a conversation\n   * about station 7, and leaving the old one up means the user reads an answer about a screen\n   * they are no longer looking at.\n   *\n   * Hosts built this by hand before, each in their own way: plant kept a module-global registry\n   * with subscribers and re-checked the context on every send, twin closed its session when the\n   * anchor moved. Both were writing the same guard around the same absence.\n   *\n   * Include whatever makes the subject specific — `twin:space:S-12`, `plant:station:3`.\n   */\n  id: string\n\n  /** Who the assistant is here, and what it must not claim to do. */\n  systemPrompt?: string\n\n  /** Which tool categories the server may expose for this conversation. */\n  toolCategories?: string[]\n\n  /** What the host knows about the subject; travels with each request. */\n  hostContext?: any\n\n  /** Which server-side chat entry point answers. */\n  chatEndpoint?: 'boardAIChat' | 'assistantChat'\n\n  /** What `@` offers. */\n  catalogEntries?: any[]\n\n  /**\n   * What `/` offers.\n   *\n   * These are sentences a person could have typed, not tool names — \"이 공간의 지금 상태를\n   * 요약해줘\" cannot be generated from `summarizeStatus`. But **a mode must not offer work it\n   * cannot do**: everything here should be answerable by the tools `toolCategories` opens.\n   */\n  slashTemplates?: any[]\n\n  /** The i18n key for the line under an empty conversation. */\n  footerNoticeKey?: string\n\n  /** Follow-up chips for a proposal that arrived without its own. */\n  proposalChoices?: any[]\n\n  /** The i18n key for the line shown once the host reports a proposal staged. */\n  stagedNoticeKey?: string\n}\n\n/** True when these two describe different conversations, so the old one should be closed. */\nexport function isDifferentConversation(a?: AssistantMode, b?: AssistantMode): boolean {\n  return (a?.id ?? '') !== (b?.id ?? '')\n}\n\n/** Everything a conversation needs, after the mode, the host's own properties and the\n *  registered defaults have been reconciled. */\nexport interface ConversationSettings {\n  systemPrompt?: string\n  toolCategories?: string[]\n  hostContext?: any\n  chatEndpoint: 'boardAIChat' | 'assistantChat'\n  catalogEntries: any[]\n  slashTemplates: any[]\n  footerNoticeKey?: string\n  proposalChoices: any[]\n  stagedNoticeKey?: string\n}\n\n/**\n * Reconcile the places a setting can come from.\n *\n * **A host that declares a mode gets the mode and nothing else.** A field the mode leaves out is\n * empty: it is not filled from the element's own properties, and it is not filled from the\n * defaults another package registered. Filling it back in is how the defect this type removes\n * returned — board-ai registers board authoring's `/add-monitor`, its component `@` catalog and\n * its \"previewed on the board\" line globally, and plant's factory mode, which declares no slash\n * list, offered them on a factory screen once the board modeller had been loaded. A mode that\n * wants those declares them.\n *\n * A host that declares no mode gets exactly what it got before modes existed — its own\n * properties, falling back to the registered defaults.\n *\n * `chatEndpoint` still falls back to `boardAIChat` when nothing names one; that default is a\n * separate question (standard A2).\n */\nexport function resolveConversation(\n  mode: AssistantMode | undefined,\n  own: Partial<ConversationSettings>,\n  defaults: Partial<ConversationSettings>\n): ConversationSettings {\n  const pick = <K extends keyof ConversationSettings>(key: K): ConversationSettings[K] =>\n    mode ? (mode as any)[key] : ((own as any)[key] ?? (defaults as any)[key])\n\n  return {\n    systemPrompt: pick('systemPrompt'),\n    toolCategories: pick('toolCategories'),\n    hostContext: pick('hostContext'),\n    chatEndpoint: pick('chatEndpoint') ?? 'boardAIChat',\n    catalogEntries: pick('catalogEntries') ?? [],\n    slashTemplates: pick('slashTemplates') ?? [],\n    footerNoticeKey: pick('footerNoticeKey'),\n    proposalChoices: pick('proposalChoices') ?? [],\n    stagedNoticeKey: pick('stagedNoticeKey')\n  }\n}\n"]}
+{"version":3,"file":"assistant-mode.js","sourceRoot":"","sources":["../../client/components/assistant-mode.ts"],"names":[],"mappings":"AAqDA,6FAA6F;AAC7F,MAAM,UAAU,uBAAuB,CAAC,CAAiB,EAAE,CAAiB;IAC1E,OAAO,GAAG,CAAC,EAAE,IAAI,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,IAAI,EAAE,EAAE,KAAK,GAAG,CAAC,EAAE,IAAI,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,IAAI,EAAE,EAAE,CAAA;AACxF,CAAC;AAoBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAA+B,EAC/B,GAAkC,EAClC,QAAuC,EACvC,IAAwB;IAExB,IAAI,IAAI,EAAE,CAAC;QACT,kFAAkF;QAClF,MAAM,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;QAClE,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,eAAe;YAC7B,cAAc,EAAE,OAAO,EAAE,cAAc,IAAI,EAAE;YAC7C,cAAc,EAAE,OAAO,EAAE,cAAc,IAAI,EAAE;YAC7C,eAAe,EAAE,OAAO,EAAE,eAAe,IAAI,EAAE;YAC/C,WAAW,EAAE,OAAO,EAAE,WAAW;YACjC,YAAY,EAAE,OAAO,EAAE,YAAY;YACnC,YAAY,EAAE,OAAO,EAAE,YAAY;SACpC,CAAA;IACH,CAAC;IAED,MAAM,IAAI,GAAG,CAAuC,GAAM,EAA2B,EAAE,CACpF,GAAW,CAAC,GAAG,CAAC,IAAK,QAAgB,CAAC,GAAG,CAAC,CAAA;IAE7C,MAAM,YAAY,GAAG,IAAI,CAAC,cAAc,CAAC,CAAA;IACzC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,uGAAuG;YACrG,qGAAqG;YACrG,qCAAqC,CACxC,CAAA;IACH,CAAC;IAED,OAAO;QACL,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC;QAChC,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC;QAChC,YAAY;QACZ,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE;QAC5C,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE;QAC5C,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC;QAClC,eAAe,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAC9C,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC;KACnC,CAAA;AACH,CAAC;AASD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAC7B,OAA2B,EAC3B,OAA2C,EAC3C,UAA8B;IAE9B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,OAAO,CAAA;IACtC,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,OAAO;QAAE,OAAO,OAAO,CAAA;IACzD,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAA;AAClF,CAAC","sourcesContent":["/**\n * A mode is what a conversation *is*: which conversation this is, and what it is about.\n *\n * Those two used to be nine. The browser declared the persona, the tool categories, the model and\n * the limits and sent them with every turn, which meant a caller holding the door's privilege\n * chose its own authority — and it meant a screen could describe a conversation one way while the\n * server answered it another. Since ADR-0061 decision 7 the app server registers the mode and the\n * browser names it:\n *\n * ```ts\n * html`<ox-assistant-chat .mode=${{ kind: 'twin.space', target: spaceId, hostContext: { spaceId } }}></ox-assistant-chat>`\n * ```\n *\n * What the panel shows — the `/` sentences, the `@` catalog, the two notices — comes from the same\n * declaration, fetched from the server already written in the person's language, so the panel and\n * the door cannot offer different conversations.\n */\nexport interface AssistantMode {\n  /**\n   * Which conversation this is — a `<app>.<surface>` kind the app server registered.\n   */\n  kind: string\n\n  /**\n   * What it is about: the space, the station, the model being edited.\n   *\n   * **With `kind`, this is the conversation's lifetime.** When either changes the chat closes what\n   * is on screen and starts again — a conversation about station 3 is not a conversation about\n   * station 7, and leaving the old one up means the person reads an answer about a screen they are\n   * no longer looking at.\n   */\n  target?: string\n\n  /**\n   * What the host knows about the subject; travels with each request.\n   *\n   * **The model never sees this** — it reaches the tools as `ctx.host` and nothing else (ADR-0061\n   * decision 7). Anything the model must know is answered by a read tool.\n   */\n  hostContext?: any\n}\n\n/** What the server said this mode offers, already in the request's locale. */\nexport interface AssistantModeView {\n  kind: string\n  slashTemplates: any[]\n  catalogEntries: any[]\n  proposalChoices: any[]\n  placeholder?: string\n  footerNotice?: string\n  stagedNotice?: string\n}\n\n/** True when these two describe different conversations, so the old one should be closed. */\nexport function isDifferentConversation(a?: AssistantMode, b?: AssistantMode): boolean {\n  return `${a?.kind ?? ''}|${a?.target ?? ''}` !== `${b?.kind ?? ''}|${b?.target ?? ''}`\n}\n\n/** Everything a conversation needs, after the mode, the host's own properties, the registered\n *  defaults and the server's answer have been reconciled. */\nexport interface ConversationSettings {\n  /** Set when a mode names this conversation; absent for a host that declares none. */\n  kind?: string\n  target?: string\n  hostContext?: any\n  chatEndpoint: 'boardAIChat' | 'assistantChat'\n  catalogEntries: any[]\n  slashTemplates: any[]\n  /** What the empty input says. A mode's comes translated from the server. */\n  placeholder?: string\n  /** Sentences, not keys — a mode's come translated from the server, a host's from its own i18n. */\n  footerNotice?: string\n  proposalChoices: any[]\n  stagedNotice?: string\n}\n\n/**\n * Reconcile the places a setting can come from.\n *\n * **A host that declares a mode gets the mode and nothing else.** What the mode does not offer is\n * not filled in from the element's own properties or from the defaults another package registered.\n * Filling it back in is how the defect this type removes returned — board-ai registers board\n * authoring's `/add-monitor`, its component `@` catalog and its \"previewed on the board\" line\n * globally, and plant's factory mode, which declares no slash list, offered them on a factory\n * screen once the board modeller had been loaded.\n *\n * A mode's offering arrives asynchronously, so until the server has answered a mode offers\n * nothing. Standing the defaults in during that gap would show the board's list for a moment on a\n * screen that does not edit boards.\n *\n * A host that declares no mode gets exactly what it got before modes existed — its own properties,\n * falling back to the registered defaults — and it must name its own door: the `boardAIChat`\n * default was removed with decision 7, because a missing door should show when a surface is\n * declared, not when a person says something.\n */\nexport function resolveConversation(\n  mode: AssistantMode | undefined,\n  own: Partial<ConversationSettings>,\n  defaults: Partial<ConversationSettings>,\n  view?: AssistantModeView\n): ConversationSettings {\n  if (mode) {\n    /* A view for another kind is the previous conversation's answer arriving late. */\n    const offered = view && view.kind === mode.kind ? view : undefined\n    return {\n      kind: mode.kind,\n      target: mode.target,\n      hostContext: mode.hostContext,\n      chatEndpoint: 'assistantChat',\n      catalogEntries: offered?.catalogEntries ?? [],\n      slashTemplates: offered?.slashTemplates ?? [],\n      proposalChoices: offered?.proposalChoices ?? [],\n      placeholder: offered?.placeholder,\n      footerNotice: offered?.footerNotice,\n      stagedNotice: offered?.stagedNotice\n    }\n  }\n\n  const pick = <K extends keyof ConversationSettings>(key: K): ConversationSettings[K] =>\n    (own as any)[key] ?? (defaults as any)[key]\n\n  const chatEndpoint = pick('chatEndpoint')\n  if (!chatEndpoint) {\n    throw new Error(\n      '[ox-assistant-chat] a surface with no mode must name its chatEndpoint. The `boardAIChat` default was ' +\n        'removed (ADR-0061 decision 7) — apps declare a mode and talk to `assistantChat`; the board product ' +\n        'names `boardAIChat` on the element.'\n    )\n  }\n\n  return {\n    hostContext: pick('hostContext'),\n    placeholder: pick('placeholder'),\n    chatEndpoint,\n    catalogEntries: pick('catalogEntries') ?? [],\n    slashTemplates: pick('slashTemplates') ?? [],\n    footerNotice: pick('footerNotice'),\n    proposalChoices: pick('proposalChoices') ?? [],\n    stagedNotice: pick('stagedNotice')\n  }\n}\n\n/** 한 subject 위에 설 수 있는 대화 하나 — 서버가 준 목록의 한 줄. */\nexport interface AssistantModeChoice {\n  kind: string\n  label: string\n  isDefault: boolean\n}\n\n/**\n * 이 화면을 열 때 어느 대화로 설 것인가 — ADR-0072 A17 ①.\n *\n * ── 왜 기억하나 ───────────────────────────────────────────────────────────\n * 보드를 열 때마다 저작 대화로 되돌아가면, 현장을 물으려고 온 사람은 화면을 열 때마다 같은 손질을\n * 다시 한다. 기억은 이 브라우저에만 남는다 — 서버에 칸을 만들지 않는다.\n *\n * ── 기억을 언제 버리나 ────────────────────────────────────────────────────\n * 기억한 종류가 지금 목록에 없으면 따르지 않는다. 대화가 하나 없어진 판으로 바뀌었는데 그 이름으로\n * 열려고 하면 대화가 안 열리고, 사람은 자기가 무엇을 잘못했는지 알 길이 없다. 그때는 host 가 준\n * 대화로 둔다.\n *\n * 고를 것이 하나뿐이면 기억을 보지 않는다 — 고른 적이 없는 화면이다.\n */\nexport function pickInitialMode(\n  current: string | undefined,\n  choices: ReadonlyArray<AssistantModeChoice>,\n  remembered: string | undefined\n): string | undefined {\n  if (choices.length < 2) return current\n  if (!remembered || remembered === current) return current\n  return choices.some(choice => choice.kind === remembered) ? remembered : current\n}\n"]}

package/dist-client/components/assistant-mode.test.js

@@ -1,85 +1,106 @@
 /*
- * A mode is one value, and the point of it is that the parts of a conversation cannot
- * disagree with each other.
+ * A mode is one value, and the point of it is that the parts of a conversation cannot disagree
+ * with each other. Since ADR-0061 decision 7 the parts live on the server: the browser names the
+ * conversation (`kind`) and its subject (`target`), and the persona, the tool categories, the
+ * model and the limits are the app server's.
  *
- * The defect this guards against shipped: a screen whose systemPrompt said "you do not edit
- * boards here" offered `/add-monitor` in the same panel, because the prompt was an element
- * property and the slash list was a module global. Any resolution that lets a mode supply one
- * of them while something else supplies the other brings it back.
+ * The defect this still guards against shipped: a screen whose prompt said "you do not edit boards
+ * here" offered `/add-monitor` in the same panel, because the prompt was an element property and
+ * the slash list was a module global. A mode's wording now comes from the same declaration the
+ * door reads, so the two cannot describe different conversations.
  */
-import { isDifferentConversation, resolveConversation } from './assistant-mode';
-const MODE = {
-    id: 'twin:space:S-12',
-    systemPrompt: 'You are looking at one space. You do not edit boards here.',
-    toolCategories: ['twin'],
-    hostContext: { spaceId: 'S-12' },
-    slashTemplates: [{ name: 'status', template: '이 공간의 지금 상태를 요약해줘' }]
+import { isDifferentConversation, resolveConversation, pickInitialMode } from './assistant-mode';
+const MODE = { kind: 'twin.space', target: 'S-12', hostContext: { spaceId: 'S-12' } };
+/** What the server said this mode offers, already in the request's locale. */
+const MODE_VIEW = {
+    kind: 'twin.space',
+    slashTemplates: [{ name: 'status', description: 'summarize', template: '이 공간의 지금 상태를 요약해줘' }],
+    catalogEntries: [],
+    proposalChoices: [],
+    footerNotice: undefined,
+    stagedNotice: undefined
 };
+/** The board product, which declares no mode and names its own door. */
 const HOST_PROPERTIES = {
-    systemPrompt: 'a prompt the host set the old way',
-    toolCategories: ['board-ai'],
     hostContext: { boardId: 'B-1' },
     chatEndpoint: 'boardAIChat'
 };
 const GLOBAL_DEFAULTS = {
     catalogEntries: [{ type: 'rect' }],
     slashTemplates: [{ name: 'add-monitor', template: '모니터를 추가해줘' }],
-    footerNoticeKey: 'text.previewed-on-the-board'
+    footerNotice: 'previewed on the board'
 };
-describe('resolveConversation', () => {
-    test('a mode answers before the host properties it overlaps', () => {
-        const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS);
-        expect(c.systemPrompt).toBe(MODE.systemPrompt);
-        expect(c.toolCategories).toEqual(['twin']);
+describe('a mode names the conversation; the server says what it offers', () => {
+    test('★ the subject travels, and the door is the neutral one', () => {
+        const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS, MODE_VIEW);
+        expect(c.kind).toBe('twin.space');
+        expect(c.target).toBe('S-12');
         expect(c.hostContext).toEqual({ spaceId: 'S-12' });
+        expect(c.chatEndpoint).toBe('assistantChat');
     });
-    test('a mode answers before the global defaults — the prompt and the slash list cannot disagree', () => {
-        const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS);
-        expect(c.slashTemplates).toEqual(MODE.slashTemplates);
-        /* A mode that says it does not edit boards must not offer a board edit. */
+    test('★ what the mode offers comes from the server, not from what another package registered', () => {
+        const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS, MODE_VIEW);
+        expect(c.slashTemplates).toEqual(MODE_VIEW.slashTemplates);
         expect(JSON.stringify(c.slashTemplates)).not.toContain('add-monitor');
-    });
-    test('★ what a mode leaves out stays out — the defaults another package registered do not fill it', () => {
-        const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS);
-        /* The board's `@` catalog and its "previewed on the board" line belong to board authoring. */
         expect(c.catalogEntries).toEqual([]);
-        expect(c.footerNoticeKey).toBeUndefined();
+        expect(c.footerNotice).toBeUndefined();
     });
-    test('★ a mode that declares no slash list offers none, even when a board package registered its own', () => {
-        /* plant's factory mode declares no `slashTemplates`; board-ai registers `/add-monitor` globally. */
-        const { slashTemplates, ...withoutSlash } = MODE;
-        const c = resolveConversation({ ...withoutSlash, id: 'plant:factory:D-1' }, HOST_PROPERTIES, GLOBAL_DEFAULTS);
+    test('★ before the server has answered, a mode offers nothing — the defaults do not stand in', () => {
+        const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS, undefined);
         expect(c.slashTemplates).toEqual([]);
+        expect(c.catalogEntries).toEqual([]);
     });
-    test('★ a mode that leaves out a field the host also set as a property does not take the property either', () => {
-        const c = resolveConversation({ id: 'twin:none' }, HOST_PROPERTIES, GLOBAL_DEFAULTS);
-        expect(c.systemPrompt).toBeUndefined();
-        expect(c.toolCategories).toBeUndefined();
-        expect(c.hostContext).toBeUndefined();
+    test('a view for another kind is ignored — the panel is showing this conversation', () => {
+        const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS, { ...MODE_VIEW, kind: 'twin.board' });
+        expect(c.slashTemplates).toEqual([]);
     });
-    test('a host with no mode gets exactly what it had before modes existed', () => {
+});
+describe('a host with no mode', () => {
+    test('gets its own properties and the registered defaults, as before modes existed', () => {
         const c = resolveConversation(undefined, HOST_PROPERTIES, GLOBAL_DEFAULTS);
-        expect(c.systemPrompt).toBe(HOST_PROPERTIES.systemPrompt);
-        expect(c.toolCategories).toEqual(HOST_PROPERTIES.toolCategories);
+        expect(c.hostContext).toEqual({ boardId: 'B-1' });
         expect(c.slashTemplates).toEqual(GLOBAL_DEFAULTS.slashTemplates);
-    });
-    test('nothing anywhere resolves to empty lists and the board endpoint, never undefined', () => {
-        const c = resolveConversation(undefined, {}, {});
-        expect(c.catalogEntries).toEqual([]);
-        expect(c.slashTemplates).toEqual([]);
-        expect(c.proposalChoices).toEqual([]);
+        expect(c.footerNotice).toBe('previewed on the board');
         expect(c.chatEndpoint).toBe('boardAIChat');
     });
+    test('★ must name its door — there is no default any more', () => {
+        expect(() => resolveConversation(undefined, {}, {})).toThrow(/chatEndpoint/);
+    });
 });
 describe('isDifferentConversation', () => {
-    const station3 = { id: 'plant:station:3' };
-    test('a different subject ends the conversation', () => {
-        expect(isDifferentConversation(station3, { id: 'plant:station:7' })).toBe(true);
+    const station3 = { kind: 'plant.station', target: '3' };
+    test('★ a different subject ends the conversation, and so does a different kind', () => {
+        expect(isDifferentConversation(station3, { kind: 'plant.station', target: '7' })).toBe(true);
+        expect(isDifferentConversation(station3, { kind: 'plant.factory', target: '3' })).toBe(true);
         expect(isDifferentConversation(undefined, station3)).toBe(true);
     });
-    test('rewording the same subject does not', () => {
-        expect(isDifferentConversation(station3, { ...station3, systemPrompt: 'reworded' })).toBe(false);
+    test('the same subject, described again, does not', () => {
+        expect(isDifferentConversation(station3, { ...station3, hostContext: { reread: true } })).toBe(false);
         expect(isDifferentConversation(undefined, undefined)).toBe(false);
     });
 });
+/*
+ * ADR-0072 A17 ① — 화면을 열 때 어느 대화로 서나.
+ *
+ * 되살리는 것은 고른 대화이지 세션이 아니다. 그리고 없어진 대화로 되살리지 않는다 — 그러면 대화가
+ * 안 열리고 사람은 자기가 무엇을 잘못했는지 알 길이 없다.
+ */
+describe('pickInitialMode', () => {
+    const choices = [
+        { kind: 'twin.board', label: '이 그림 고치기', isDefault: true },
+        { kind: 'twin.space', label: '이 현장 지금', isDefault: false }
+    ];
+    it('★ 지난번에 고른 대화로 돌아간다 — 매번 같은 손질을 다시 하지 않는다', () => {
+        expect(pickInitialMode('twin.board', choices, 'twin.space')).toBe('twin.space');
+    });
+    it('★ 지금 목록에 없는 기억은 따르지 않는다 — 안 열리는 대화로 들어간다', () => {
+        expect(pickInitialMode('twin.board', choices, 'twin.gone')).toBe('twin.board');
+    });
+    it('★ 고를 것이 하나뿐이면 기억을 보지 않는다 — 고른 적이 없는 화면이다', () => {
+        expect(pickInitialMode('plant.station', [choices[0]], 'twin.space')).toBe('plant.station');
+    });
+    it('기억이 없으면 host 가 준 것으로 선다', () => {
+        expect(pickInitialMode('twin.board', choices, undefined)).toBe('twin.board');
+    });
+});
 //# sourceMappingURL=assistant-mode.test.js.map

package/dist-client/components/assistant-mode.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-mode.test.js","sourceRoot":"","sources":["../../client/components/assistant-mode.test.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * A mode is one value, and the point of it is that the parts of a conversation cannot\n * disagree with each other.\n *\n * The defect this guards against shipped: a screen whose systemPrompt said \"you do not edit\n * boards here\" offered `/add-monitor` in the same panel, because the prompt was an element\n * property and the slash list was a module global. Any resolution that lets a mode supply one\n * of them while something else supplies the other brings it back.\n */\nimport { isDifferentConversation, resolveConversation, type AssistantMode } from './assistant-mode'\n\nconst MODE: AssistantMode = {\n  id: 'twin:space:S-12',\n  systemPrompt: 'You are looking at one space. You do not edit boards here.',\n  toolCategories: ['twin'],\n  hostContext: { spaceId: 'S-12' },\n  slashTemplates: [{ name: 'status', template: '이 공간의 지금 상태를 요약해줘' }]\n}\n\nconst HOST_PROPERTIES = {\n  systemPrompt: 'a prompt the host set the old way',\n  toolCategories: ['board-ai'],\n  hostContext: { boardId: 'B-1' },\n  chatEndpoint: 'boardAIChat' as const\n}\n\nconst GLOBAL_DEFAULTS = {\n  catalogEntries: [{ type: 'rect' }],\n  slashTemplates: [{ name: 'add-monitor', template: '모니터를 추가해줘' }],\n  footerNoticeKey: 'text.previewed-on-the-board'\n}\n\ndescribe('resolveConversation', () => {\n  test('a mode answers before the host properties it overlaps', () => {\n    const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS)\n    expect(c.systemPrompt).toBe(MODE.systemPrompt)\n    expect(c.toolCategories).toEqual(['twin'])\n    expect(c.hostContext).toEqual({ spaceId: 'S-12' })\n  })\n\n  test('a mode answers before the global defaults — the prompt and the slash list cannot disagree', () => {\n    const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS)\n    expect(c.slashTemplates).toEqual(MODE.slashTemplates)\n    /* A mode that says it does not edit boards must not offer a board edit. */\n    expect(JSON.stringify(c.slashTemplates)).not.toContain('add-monitor')\n  })\n\n  test('★ what a mode leaves out stays out — the defaults another package registered do not fill it', () => {\n    const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS)\n    /* The board's `@` catalog and its \"previewed on the board\" line belong to board authoring. */\n    expect(c.catalogEntries).toEqual([])\n    expect(c.footerNoticeKey).toBeUndefined()\n  })\n\n  test('★ a mode that declares no slash list offers none, even when a board package registered its own', () => {\n    /* plant's factory mode declares no `slashTemplates`; board-ai registers `/add-monitor` globally. */\n    const { slashTemplates, ...withoutSlash } = MODE\n    const c = resolveConversation({ ...withoutSlash, id: 'plant:factory:D-1' }, HOST_PROPERTIES, GLOBAL_DEFAULTS)\n    expect(c.slashTemplates).toEqual([])\n  })\n\n  test('★ a mode that leaves out a field the host also set as a property does not take the property either', () => {\n    const c = resolveConversation({ id: 'twin:none' }, HOST_PROPERTIES, GLOBAL_DEFAULTS)\n    expect(c.systemPrompt).toBeUndefined()\n    expect(c.toolCategories).toBeUndefined()\n    expect(c.hostContext).toBeUndefined()\n  })\n\n  test('a host with no mode gets exactly what it had before modes existed', () => {\n    const c = resolveConversation(undefined, HOST_PROPERTIES, GLOBAL_DEFAULTS)\n    expect(c.systemPrompt).toBe(HOST_PROPERTIES.systemPrompt)\n    expect(c.toolCategories).toEqual(HOST_PROPERTIES.toolCategories)\n    expect(c.slashTemplates).toEqual(GLOBAL_DEFAULTS.slashTemplates)\n  })\n\n  test('nothing anywhere resolves to empty lists and the board endpoint, never undefined', () => {\n    const c = resolveConversation(undefined, {}, {})\n    expect(c.catalogEntries).toEqual([])\n    expect(c.slashTemplates).toEqual([])\n    expect(c.proposalChoices).toEqual([])\n    expect(c.chatEndpoint).toBe('boardAIChat')\n  })\n})\n\ndescribe('isDifferentConversation', () => {\n  const station3: AssistantMode = { id: 'plant:station:3' }\n\n  test('a different subject ends the conversation', () => {\n    expect(isDifferentConversation(station3, { id: 'plant:station:7' })).toBe(true)\n    expect(isDifferentConversation(undefined, station3)).toBe(true)\n  })\n\n  test('rewording the same subject does not', () => {\n    expect(isDifferentConversation(station3, { ...station3, systemPrompt: 'reworded' })).toBe(false)\n    expect(isDifferentConversation(undefined, undefined)).toBe(false)\n  })\n})\n"]}
+{"version":3,"file":"assistant-mode.test.js","sourceRoot":"","sources":["../../client/components/assistant-mode.test.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * A mode is one value, and the point of it is that the parts of a conversation cannot disagree\n * with each other. Since ADR-0061 decision 7 the parts live on the server: the browser names the\n * conversation (`kind`) and its subject (`target`), and the persona, the tool categories, the\n * model and the limits are the app server's.\n *\n * The defect this still guards against shipped: a screen whose prompt said \"you do not edit boards\n * here\" offered `/add-monitor` in the same panel, because the prompt was an element property and\n * the slash list was a module global. A mode's wording now comes from the same declaration the\n * door reads, so the two cannot describe different conversations.\n */\nimport { isDifferentConversation, resolveConversation, type AssistantMode, pickInitialMode } from './assistant-mode'\n\nconst MODE: AssistantMode = { kind: 'twin.space', target: 'S-12', hostContext: { spaceId: 'S-12' } }\n\n/** What the server said this mode offers, already in the request's locale. */\nconst MODE_VIEW = {\n  kind: 'twin.space',\n  slashTemplates: [{ name: 'status', description: 'summarize', template: '이 공간의 지금 상태를 요약해줘' }],\n  catalogEntries: [],\n  proposalChoices: [],\n  footerNotice: undefined,\n  stagedNotice: undefined\n}\n\n/** The board product, which declares no mode and names its own door. */\nconst HOST_PROPERTIES = {\n  hostContext: { boardId: 'B-1' },\n  chatEndpoint: 'boardAIChat' as const\n}\n\nconst GLOBAL_DEFAULTS = {\n  catalogEntries: [{ type: 'rect' }],\n  slashTemplates: [{ name: 'add-monitor', template: '모니터를 추가해줘' }],\n  footerNotice: 'previewed on the board'\n}\n\ndescribe('a mode names the conversation; the server says what it offers', () => {\n  test('★ the subject travels, and the door is the neutral one', () => {\n    const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS, MODE_VIEW)\n\n    expect(c.kind).toBe('twin.space')\n    expect(c.target).toBe('S-12')\n    expect(c.hostContext).toEqual({ spaceId: 'S-12' })\n    expect(c.chatEndpoint).toBe('assistantChat')\n  })\n\n  test('★ what the mode offers comes from the server, not from what another package registered', () => {\n    const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS, MODE_VIEW)\n\n    expect(c.slashTemplates).toEqual(MODE_VIEW.slashTemplates)\n    expect(JSON.stringify(c.slashTemplates)).not.toContain('add-monitor')\n    expect(c.catalogEntries).toEqual([])\n    expect(c.footerNotice).toBeUndefined()\n  })\n\n  test('★ before the server has answered, a mode offers nothing — the defaults do not stand in', () => {\n    const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS, undefined)\n\n    expect(c.slashTemplates).toEqual([])\n    expect(c.catalogEntries).toEqual([])\n  })\n\n  test('a view for another kind is ignored — the panel is showing this conversation', () => {\n    const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS, { ...MODE_VIEW, kind: 'twin.board' })\n\n    expect(c.slashTemplates).toEqual([])\n  })\n})\n\ndescribe('a host with no mode', () => {\n  test('gets its own properties and the registered defaults, as before modes existed', () => {\n    const c = resolveConversation(undefined, HOST_PROPERTIES, GLOBAL_DEFAULTS)\n\n    expect(c.hostContext).toEqual({ boardId: 'B-1' })\n    expect(c.slashTemplates).toEqual(GLOBAL_DEFAULTS.slashTemplates)\n    expect(c.footerNotice).toBe('previewed on the board')\n    expect(c.chatEndpoint).toBe('boardAIChat')\n  })\n\n  test('★ must name its door — there is no default any more', () => {\n    expect(() => resolveConversation(undefined, {}, {})).toThrow(/chatEndpoint/)\n  })\n})\n\ndescribe('isDifferentConversation', () => {\n  const station3: AssistantMode = { kind: 'plant.station', target: '3' }\n\n  test('★ a different subject ends the conversation, and so does a different kind', () => {\n    expect(isDifferentConversation(station3, { kind: 'plant.station', target: '7' })).toBe(true)\n    expect(isDifferentConversation(station3, { kind: 'plant.factory', target: '3' })).toBe(true)\n    expect(isDifferentConversation(undefined, station3)).toBe(true)\n  })\n\n  test('the same subject, described again, does not', () => {\n    expect(isDifferentConversation(station3, { ...station3, hostContext: { reread: true } })).toBe(false)\n    expect(isDifferentConversation(undefined, undefined)).toBe(false)\n  })\n})\n\n/*\n * ADR-0072 A17 ① — 화면을 열 때 어느 대화로 서나.\n *\n * 되살리는 것은 고른 대화이지 세션이 아니다. 그리고 없어진 대화로 되살리지 않는다 — 그러면 대화가\n * 안 열리고 사람은 자기가 무엇을 잘못했는지 알 길이 없다.\n */\ndescribe('pickInitialMode', () => {\n  const choices = [\n    { kind: 'twin.board', label: '이 그림 고치기', isDefault: true },\n    { kind: 'twin.space', label: '이 현장 지금', isDefault: false }\n  ]\n\n  it('★ 지난번에 고른 대화로 돌아간다 — 매번 같은 손질을 다시 하지 않는다', () => {\n    expect(pickInitialMode('twin.board', choices, 'twin.space')).toBe('twin.space')\n  })\n\n  it('★ 지금 목록에 없는 기억은 따르지 않는다 — 안 열리는 대화로 들어간다', () => {\n    expect(pickInitialMode('twin.board', choices, 'twin.gone')).toBe('twin.board')\n  })\n\n  it('★ 고를 것이 하나뿐이면 기억을 보지 않는다 — 고른 적이 없는 화면이다', () => {\n    expect(pickInitialMode('plant.station', [choices[0]], 'twin.space')).toBe('plant.station')\n  })\n\n  it('기억이 없으면 host 가 준 것으로 선다', () => {\n    expect(pickInitialMode('twin.board', choices, undefined)).toBe('twin.board')\n  })\n})\n"]}

package/dist-client/components/chat-echo-dedup.d.ts

@@ -22,6 +22,8 @@ export interface RemoteMessage {
         name?: string;
         email?: string;
     } | null;
+    /** 이 사람이 이 답의 문을 못 지나 본문이 한 줄로 바뀌어 왔나(ADR-0073 판정 1). */
+    redacted?: boolean;
 }
 /** 방송 메시지 → 라인. */
 export declare function remoteMessageToLine(m: RemoteMessage): DedupLine;