@things-factory/ai-assistant 10.1.45 → 10.1.47

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

@@ -22,6 +22,30 @@ export function isDifferentConversation(a, b) {
  * declared, not when a person says something.
  */
 export function resolveConversation(mode, own, defaults, view) {
+    if (mode && own.chatEndpoint === 'boardAIChat') {
+        /*
+         * The board door with a declared mode. The mode decides persona and tools on the server; the
+         * door stays `boardAIChat` because only it carries the board document and returns patches -
+         * `assistantChat` has no document. What the panel offers comes from the mode where the mode
+         * declares it, and from the board's own defaults (the # component catalog, the slash
+         * templates) where it does not, so a mode that declares nothing does not empty the panel.
+         */
+        const offered = view && view.kind === mode.kind ? view : undefined;
+        const pickOwn = (key) => own[key] ?? defaults[key];
+        const orOwn = (list, key) => list && list.length > 0 ? list : pickOwn(key) ?? [];
+        return {
+            kind: mode.kind,
+            target: mode.target,
+            hostContext: mode.hostContext ?? pickOwn('hostContext'),
+            chatEndpoint: 'boardAIChat',
+            catalogEntries: orOwn(offered?.catalogEntries, 'catalogEntries'),
+            slashTemplates: orOwn(offered?.slashTemplates, 'slashTemplates'),
+            proposalChoices: orOwn(offered?.proposalChoices, 'proposalChoices'),
+            placeholder: offered?.placeholder ?? pickOwn('placeholder'),
+            footerNotice: offered?.footerNotice ?? pickOwn('footerNotice'),
+            stagedNotice: offered?.stagedNotice ?? pickOwn('stagedNotice')
+        };
+    }
     if (mode) {
         /* A view for another kind is the previous conversation's answer arriving late. */
         const offered = view && view.kind === mode.kind ? view : undefined;

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":"AAyDA,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;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CAAC,UAAqC,EAAE,WAA+B;IAC7G,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,WAAW;QAAE,OAAO,SAAS,CAAA;IAC/D,OAAO,UAAU,CAAA;AACnB,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  /** 빈 대화의 제목과 한 줄 — 이 대화가 무엇을 하는 자리인지. host 속성보다 앞선다. */\n  intro?: { title: string; subtitle: string }\n  /** 빈 대화의 예시 — 이 대화에서 실제로 할 수 있는 말. host 속성보다 앞선다. */\n  examples?: Array<{ label: string; items: 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\n/**\n * 목록에서 고른 대화로 따라갈 것인가 — ADR-0072 결정 3.\n *\n * 목록은 한 대상의 대화를 **모두** 보여 주고, 그 대상 위에는 대화가 둘 설 수 있다(A17). 고른 것이 지금\n * 열린 대화와 다른데 화면이 그대로 있으면 문이 거절하고(`session-kind-mismatch`), 목록은 눌리는데 안\n * 열리는 목록이 된다 — 선언은 있고 길이 없는 그 모양이다.\n *\n * 칸이 서기 전에 난 세션에는 값이 없다. 그때는 지금 대화로 둔다 — 서버가 다음 턴에 지금 대화로 찍는다.\n *\n * `undefined` 는 「그대로 둔다」는 뜻이다.\n */\nexport function followPickedConversation(pickedKind: string | undefined | null, currentKind: string | undefined): string | undefined {\n  if (!pickedKind || pickedKind === currentKind) return undefined\n  return pickedKind\n}\n"]}
+{"version":3,"file":"assistant-mode.js","sourceRoot":"","sources":["../../client/components/assistant-mode.ts"],"names":[],"mappings":"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","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  /** 빈 대화의 제목과 한 줄 — 이 대화가 무엇을 하는 자리인지. host 속성보다 앞선다. */\n  intro?: { title: string; subtitle: string }\n  /** 빈 대화의 예시 — 이 대화에서 실제로 할 수 있는 말. host 속성보다 앞선다. */\n  examples?: Array<{ label: string; items: 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 && own.chatEndpoint === 'boardAIChat') {\n    /*\n     * The board door with a declared mode. The mode decides persona and tools on the server; the\n     * door stays `boardAIChat` because only it carries the board document and returns patches -\n     * `assistantChat` has no document. What the panel offers comes from the mode where the mode\n     * declares it, and from the board's own defaults (the # component catalog, the slash\n     * templates) where it does not, so a mode that declares nothing does not empty the panel.\n     */\n    const offered = view && view.kind === mode.kind ? view : undefined\n    const pickOwn = <K extends keyof ConversationSettings>(key: K): ConversationSettings[K] =>\n      (own as any)[key] ?? (defaults as any)[key]\n    const orOwn = (list: any[] | undefined, key: 'catalogEntries' | 'slashTemplates' | 'proposalChoices') =>\n      list && list.length > 0 ? list : (pickOwn(key) as any[]) ?? []\n    return {\n      kind: mode.kind,\n      target: mode.target,\n      hostContext: mode.hostContext ?? pickOwn('hostContext'),\n      chatEndpoint: 'boardAIChat',\n      catalogEntries: orOwn(offered?.catalogEntries, 'catalogEntries'),\n      slashTemplates: orOwn(offered?.slashTemplates, 'slashTemplates'),\n      proposalChoices: orOwn(offered?.proposalChoices, 'proposalChoices'),\n      placeholder: offered?.placeholder ?? pickOwn('placeholder'),\n      footerNotice: offered?.footerNotice ?? pickOwn('footerNotice'),\n      stagedNotice: offered?.stagedNotice ?? pickOwn('stagedNotice')\n    }\n  }\n\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\n/**\n * 목록에서 고른 대화로 따라갈 것인가 — ADR-0072 결정 3.\n *\n * 목록은 한 대상의 대화를 **모두** 보여 주고, 그 대상 위에는 대화가 둘 설 수 있다(A17). 고른 것이 지금\n * 열린 대화와 다른데 화면이 그대로 있으면 문이 거절하고(`session-kind-mismatch`), 목록은 눌리는데 안\n * 열리는 목록이 된다 — 선언은 있고 길이 없는 그 모양이다.\n *\n * 칸이 서기 전에 난 세션에는 값이 없다. 그때는 지금 대화로 둔다 — 서버가 다음 턴에 지금 대화로 찍는다.\n *\n * `undefined` 는 「그대로 둔다」는 뜻이다.\n */\nexport function followPickedConversation(pickedKind: string | undefined | null, currentKind: string | undefined): string | undefined {\n  if (!pickedKind || pickedKind === currentKind) return undefined\n  return pickedKind\n}\n"]}

package/dist-client/components/chat-input-builder.d.ts

@@ -45,6 +45,15 @@ export interface ChatMutationInputArgs {
         token: string;
         refid: number;
     }>;
+    /**
+     * The registered conversation this board chat is (ADR-0061 decision 7). When sent, the server
+     * takes the persona, tool categories, model and limits from that mode and ignores the per-request
+     * ones above. Omitted for a surface that declares no mode.
+     */
+    mode?: {
+        kind: string;
+        target?: string;
+    };
 }
 /**
  * GraphQL mutation 의 input 객체를 빌드.

package/dist-client/components/chat-input-builder.js

@@ -26,7 +26,8 @@ export function buildChatMutationInput(args) {
         categories: args.categories,
         componentSchemas: args.componentSchemas,
         selectedRefids: args.selectedRefids,
-        ...(args.mentions && args.mentions.length > 0 && { mentions: args.mentions })
+        ...(args.mentions && args.mentions.length > 0 && { mentions: args.mentions }),
+        ...(args.mode?.kind ? { mode: { kind: args.mode.kind, ...(args.mode.target ? { target: args.mode.target } : {}) } } : {})
     };
 }
 /**

package/dist-client/components/chat-input-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-input-builder.js","sourceRoot":"","sources":["../../client/components/chat-input-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuCH;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAA2B;IAChE,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;QACjC,QAAQ,EAAE,IAAI,CAAC,OAAO;QACtB,YAAY,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;QACpC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,sBAAsB,EAAE,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/F,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,qDAAqD;QACrD,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;KAC9E,CAAA;AACH,CAAC;AAuBD;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAA4B;IAClE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,kGAAkG;YAChG,kEAAkE,CACrE,CAAA;IACH,CAAC;IAED,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;QACjC,QAAQ,EAAE,IAAI,CAAC,OAAO;QACtB,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;QACzF,GAAG,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,sBAAsB,EAAE,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/F,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/D,CAAA;AACH,CAAC","sourcesContent":["/**\n * boardAIChat GraphQL mutation 의 input 객체 빌더.\n *\n * board-ai-chat.ts (Lit / Material Web 의존) 와 분리 — pure 함수만 두면 jest 의 node\n * 환경에서도 import 가능. 회귀 테스트 (selectedRefids 누락 등) 가 단위 테스트로 잠긴다.\n */\n\nexport interface ChatMutationInputArgs {\n  sessionId?: string\n  history: Array<{ role: string; content: string }>\n  liveBoard: any\n  scopes?: string[]\n  /** 편집으로 접은 지점(마지막으로 남긴 서버 메시지 id) — 서버가 그 뒤 이력을 에이전트 문맥에서 뺀다. */\n  truncateAfterMessageId?: string\n  /** 이 대화면이 무엇을 보고 있는지(예: { spaceId }) — 도구가 대상을 알 수 있게. 없으면 모델이 식별자를 되묻는다. */\n  hostContext?: any\n  /**\n   * 이 대화면이 쓸 수 있는 외부 도구 카테고리(registerToolCategory 이름).\n   * 미지정 = 등록된 전부(현행 동작). 지정하면 정의와 **실행** 모두 그 범위로 제한된다.\n   */\n  toolCategories?: string[]\n  /** 코어 보드 편집 도구(addComponent·스타일링·씬 조작) 사용 여부. 기본 true. */\n  boardTools?: boolean\n  /**\n   * 첫 턴에 도구 호출을 강제할지 — 라이브 상태를 다루는 대화면에서 켠다.\n   * 근거 없이 상태를 단언하는 답(도구를 아예 부르지 않은 답)을 원천에서 막는다.\n   */\n  requireGroundingTools?: boolean\n  knownTypes?: string[]\n  categories?: string[]\n  componentSchemas?: any\n  /**\n   * 선택된 컴포넌트의 `refid` 배열 — things-scene universal numeric handle.\n   * id (데이터 바인딩 이름) 와는 다른 개념.\n   */\n  selectedRefids: number[]\n  /**\n   * popup 에서 명시 선택한 #mention 매핑 — {token, refid}.\n   * 사용자 textarea 에는 #token 만 보이고, 정확한 refid 는 이 별도 채널로 server 에 전달.\n   * server 가 mention map 으로 LLM 에 정확한 refid 정보 첨부 (사용자 노출 0).\n   */\n  mentions?: Array<{ token: string; refid: number }>\n}\n\n/**\n * GraphQL mutation 의 input 객체를 빌드.\n *\n * 핵심 보호 — `selectedRefids` 가 항상 포함되어야 한다. 누락이 사용자에게 보고된\n * \"AI 가 선택된 컴포넌트를 모른다\" 의 root cause 였다.\n */\nexport function buildChatMutationInput(args: ChatMutationInputArgs): Record<string, any> {\n  return {\n    sessionId: args.sessionId ?? null,\n    messages: args.history,\n    currentBoard: args.liveBoard ?? null,\n    scopes: args.scopes,\n    ...(args.truncateAfterMessageId ? { truncateAfterMessageId: args.truncateAfterMessageId } : {}),\n    ...(args.hostContext ? { hostContext: args.hostContext } : {}),\n    /* 미지정은 서버 기본(전부 허용)에 맡긴다 — null 을 보내 굳이 덮어쓰지 않는다. */\n    ...(args.toolCategories ? { toolCategories: args.toolCategories } : {}),\n    ...(args.boardTools === false ? { boardTools: false } : {}),\n    ...(args.requireGroundingTools ? { requireGroundingTools: true } : {}),\n    knownTypes: args.knownTypes,\n    categories: args.categories,\n    componentSchemas: args.componentSchemas,\n    selectedRefids: args.selectedRefids,\n    ...(args.mentions && args.mentions.length > 0 && { mentions: args.mentions })\n  }\n}\n\n/**\n * Input for `assistantChat` — the door for a surface that has no document of its own.\n *\n * Deliberately a separate builder rather than a flag on the one above. The two mutations take\n * different inputs, and folding them together would mean a board field reaching a surface that\n * has no board, or a required field going missing with nothing to notice it. The one thing they\n * share is the conversation, and that is passed the same way.\n */\nexport interface AssistantChatInputArgs {\n  sessionId?: string\n  history: Array<{ role: string; content: string }>\n  /**\n   * Which conversation this is and what it is about. The persona, the tool categories, the model\n   * and the limits belong to the mode the app server registered (ADR-0061 decision 7) — a caller\n   * that could choose its own tool categories was a caller choosing its own authority.\n   */\n  mode: { kind: string; target?: string }\n  truncateAfterMessageId?: string\n  hostContext?: any\n}\n\n/**\n * Build the neutral input.\n *\n * Refuses a conversation with no mode instead of sending one. A turn with no mode has no persona\n * and no tools, and an answer given as nobody reads like a bad model rather than a missing\n * argument — the server refuses it too, and this says so where the surface is.\n */\nexport function buildAssistantChatInput(args: AssistantChatInputArgs): Record<string, any> {\n  if (!args.mode?.kind?.trim()) {\n    throw new Error(\n      '[ox-assistant-chat] mode.kind is required when the chat talks to assistantChat — the app server ' +\n        'registers the mode and the screen names it (ADR-0061 decision 7)'\n    )\n  }\n\n  return {\n    sessionId: args.sessionId ?? null,\n    messages: args.history,\n    mode: { kind: args.mode.kind, ...(args.mode.target ? { target: args.mode.target } : {}) },\n    ...(args.truncateAfterMessageId ? { truncateAfterMessageId: args.truncateAfterMessageId } : {}),\n    ...(args.hostContext ? { hostContext: args.hostContext } : {})\n  }\n}\n"]}
+{"version":3,"file":"chat-input-builder.js","sourceRoot":"","sources":["../../client/components/chat-input-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6CH;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAA2B;IAChE,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;QACjC,QAAQ,EAAE,IAAI,CAAC,OAAO;QACtB,YAAY,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;QACpC,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,GAAG,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,sBAAsB,EAAE,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/F,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,qDAAqD;QACrD,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7E,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1H,CAAA;AACH,CAAC;AAuBD;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAA4B;IAClE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,kGAAkG;YAChG,kEAAkE,CACrE,CAAA;IACH,CAAC;IAED,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;QACjC,QAAQ,EAAE,IAAI,CAAC,OAAO;QACtB,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;QACzF,GAAG,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,sBAAsB,EAAE,IAAI,CAAC,sBAAsB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/F,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC/D,CAAA;AACH,CAAC","sourcesContent":["/**\n * boardAIChat GraphQL mutation 의 input 객체 빌더.\n *\n * board-ai-chat.ts (Lit / Material Web 의존) 와 분리 — pure 함수만 두면 jest 의 node\n * 환경에서도 import 가능. 회귀 테스트 (selectedRefids 누락 등) 가 단위 테스트로 잠긴다.\n */\n\nexport interface ChatMutationInputArgs {\n  sessionId?: string\n  history: Array<{ role: string; content: string }>\n  liveBoard: any\n  scopes?: string[]\n  /** 편집으로 접은 지점(마지막으로 남긴 서버 메시지 id) — 서버가 그 뒤 이력을 에이전트 문맥에서 뺀다. */\n  truncateAfterMessageId?: string\n  /** 이 대화면이 무엇을 보고 있는지(예: { spaceId }) — 도구가 대상을 알 수 있게. 없으면 모델이 식별자를 되묻는다. */\n  hostContext?: any\n  /**\n   * 이 대화면이 쓸 수 있는 외부 도구 카테고리(registerToolCategory 이름).\n   * 미지정 = 등록된 전부(현행 동작). 지정하면 정의와 **실행** 모두 그 범위로 제한된다.\n   */\n  toolCategories?: string[]\n  /** 코어 보드 편집 도구(addComponent·스타일링·씬 조작) 사용 여부. 기본 true. */\n  boardTools?: boolean\n  /**\n   * 첫 턴에 도구 호출을 강제할지 — 라이브 상태를 다루는 대화면에서 켠다.\n   * 근거 없이 상태를 단언하는 답(도구를 아예 부르지 않은 답)을 원천에서 막는다.\n   */\n  requireGroundingTools?: boolean\n  knownTypes?: string[]\n  categories?: string[]\n  componentSchemas?: any\n  /**\n   * 선택된 컴포넌트의 `refid` 배열 — things-scene universal numeric handle.\n   * id (데이터 바인딩 이름) 와는 다른 개념.\n   */\n  selectedRefids: number[]\n  /**\n   * popup 에서 명시 선택한 #mention 매핑 — {token, refid}.\n   * 사용자 textarea 에는 #token 만 보이고, 정확한 refid 는 이 별도 채널로 server 에 전달.\n   * server 가 mention map 으로 LLM 에 정확한 refid 정보 첨부 (사용자 노출 0).\n   */\n  mentions?: Array<{ token: string; refid: number }>\n  /**\n   * The registered conversation this board chat is (ADR-0061 decision 7). When sent, the server\n   * takes the persona, tool categories, model and limits from that mode and ignores the per-request\n   * ones above. Omitted for a surface that declares no mode.\n   */\n  mode?: { kind: string; target?: string }\n}\n\n/**\n * GraphQL mutation 의 input 객체를 빌드.\n *\n * 핵심 보호 — `selectedRefids` 가 항상 포함되어야 한다. 누락이 사용자에게 보고된\n * \"AI 가 선택된 컴포넌트를 모른다\" 의 root cause 였다.\n */\nexport function buildChatMutationInput(args: ChatMutationInputArgs): Record<string, any> {\n  return {\n    sessionId: args.sessionId ?? null,\n    messages: args.history,\n    currentBoard: args.liveBoard ?? null,\n    scopes: args.scopes,\n    ...(args.truncateAfterMessageId ? { truncateAfterMessageId: args.truncateAfterMessageId } : {}),\n    ...(args.hostContext ? { hostContext: args.hostContext } : {}),\n    /* 미지정은 서버 기본(전부 허용)에 맡긴다 — null 을 보내 굳이 덮어쓰지 않는다. */\n    ...(args.toolCategories ? { toolCategories: args.toolCategories } : {}),\n    ...(args.boardTools === false ? { boardTools: false } : {}),\n    ...(args.requireGroundingTools ? { requireGroundingTools: true } : {}),\n    knownTypes: args.knownTypes,\n    categories: args.categories,\n    componentSchemas: args.componentSchemas,\n    selectedRefids: args.selectedRefids,\n    ...(args.mentions && args.mentions.length > 0 && { mentions: args.mentions }),\n    ...(args.mode?.kind ? { mode: { kind: args.mode.kind, ...(args.mode.target ? { target: args.mode.target } : {}) } } : {})\n  }\n}\n\n/**\n * Input for `assistantChat` — the door for a surface that has no document of its own.\n *\n * Deliberately a separate builder rather than a flag on the one above. The two mutations take\n * different inputs, and folding them together would mean a board field reaching a surface that\n * has no board, or a required field going missing with nothing to notice it. The one thing they\n * share is the conversation, and that is passed the same way.\n */\nexport interface AssistantChatInputArgs {\n  sessionId?: string\n  history: Array<{ role: string; content: string }>\n  /**\n   * Which conversation this is and what it is about. The persona, the tool categories, the model\n   * and the limits belong to the mode the app server registered (ADR-0061 decision 7) — a caller\n   * that could choose its own tool categories was a caller choosing its own authority.\n   */\n  mode: { kind: string; target?: string }\n  truncateAfterMessageId?: string\n  hostContext?: any\n}\n\n/**\n * Build the neutral input.\n *\n * Refuses a conversation with no mode instead of sending one. A turn with no mode has no persona\n * and no tools, and an answer given as nobody reads like a bad model rather than a missing\n * argument — the server refuses it too, and this says so where the surface is.\n */\nexport function buildAssistantChatInput(args: AssistantChatInputArgs): Record<string, any> {\n  if (!args.mode?.kind?.trim()) {\n    throw new Error(\n      '[ox-assistant-chat] mode.kind is required when the chat talks to assistantChat — the app server ' +\n        'registers the mode and the screen names it (ADR-0061 decision 7)'\n    )\n  }\n\n  return {\n    sessionId: args.sessionId ?? null,\n    messages: args.history,\n    mode: { kind: args.mode.kind, ...(args.mode.target ? { target: args.mode.target } : {}) },\n    ...(args.truncateAfterMessageId ? { truncateAfterMessageId: args.truncateAfterMessageId } : {}),\n    ...(args.hostContext ? { hostContext: args.hostContext } : {})\n  }\n}\n"]}

package/dist-client/index.d.ts

@@ -15,3 +15,5 @@ export * from './utils/assistant-session-controller.js';
 export * from './utils/assistant-session-transport.js';
 export * from './components/assistant-session-toolbar.js';
 export * from './utils/assistant-request-context.js';
+export * from './utils/assistant-capability.js';
+export * from './utils/assistant-capability-read.js';

package/dist-client/index.js

@@ -15,4 +15,6 @@ export * from './utils/assistant-session-controller.js';
 export * from './utils/assistant-session-transport.js';
 export * from './components/assistant-session-toolbar.js';
 export * from './utils/assistant-request-context.js';
+export * from './utils/assistant-capability.js';
+export * from './utils/assistant-capability-read.js';
 //# sourceMappingURL=index.js.map

package/dist-client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,gCAAgC,CAAA;AAC9C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0BAA0B,CAAA;AACxC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,oCAAoC,CAAA;AAClD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,uCAAuC,CAAA;AACrD,cAAc,yCAAyC,CAAA;AACvD,cAAc,wCAAwC,CAAA;AACtD,cAAc,2CAA2C,CAAA;AACzD,cAAc,sCAAsC,CAAA","sourcesContent":["/**\n * `@things-factory/ai-assistant` — 대화면.\n *\n * 표준 컴포넌트는 `<ox-assistant-chat>` 이다.\n */\nexport * from './components/assistant-chat.js'\nexport * from './components/chat-defaults.js'\nexport * from './components/assistant-mode.js'\nexport * from './components/markdown.js'\nexport * from './components/chat-echo-dedup.js'\nexport * from './components/chat-input-builder.js'\nexport * from './components/mention-popup.js'\nexport * from './components/mention-popup-helpers.js'\nexport * from './utils/assistant-session-controller.js'\nexport * from './utils/assistant-session-transport.js'\nexport * from './components/assistant-session-toolbar.js'\nexport * from './utils/assistant-request-context.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,gCAAgC,CAAA;AAC9C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0BAA0B,CAAA;AACxC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,oCAAoC,CAAA;AAClD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,uCAAuC,CAAA;AACrD,cAAc,yCAAyC,CAAA;AACvD,cAAc,wCAAwC,CAAA;AACtD,cAAc,2CAA2C,CAAA;AACzD,cAAc,sCAAsC,CAAA;AACpD,cAAc,iCAAiC,CAAA;AAC/C,cAAc,sCAAsC,CAAA","sourcesContent":["/**\n * `@things-factory/ai-assistant` — 대화면.\n *\n * 표준 컴포넌트는 `<ox-assistant-chat>` 이다.\n */\nexport * from './components/assistant-chat.js'\nexport * from './components/chat-defaults.js'\nexport * from './components/assistant-mode.js'\nexport * from './components/markdown.js'\nexport * from './components/chat-echo-dedup.js'\nexport * from './components/chat-input-builder.js'\nexport * from './components/mention-popup.js'\nexport * from './components/mention-popup-helpers.js'\nexport * from './utils/assistant-session-controller.js'\nexport * from './utils/assistant-session-transport.js'\nexport * from './components/assistant-session-toolbar.js'\nexport * from './utils/assistant-request-context.js'\nexport * from './utils/assistant-capability.js'\nexport * from './utils/assistant-capability-read.js'\n"]}