@things-factory/ai-assistant 10.1.46 → 10.1.47

package/client/components/assistant-chat.ts

@@ -4529,7 +4529,9 @@ export class OxAssistantChat extends LitElement {
                 categories: this.categories,
                 componentSchemas: this.componentSchemas,
                 selectedRefids: this.selectedRefids ?? [],
-                mentions
+                mentions,
+                /* With a declared mode the server owns persona and tools; the board door still carries the board. */
+                mode: this.conversation.kind ? { kind: this.conversation.kind, target: this.conversation.target } : undefined
               })
         }
       })

package/client/components/assistant-mode.ts

@@ -103,6 +103,33 @@ export function resolveConversation(
   defaults: Partial<ConversationSettings>,
   view?: AssistantModeView
 ): ConversationSettings {
+  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 = <K extends keyof ConversationSettings>(key: K): ConversationSettings[K] =>
+      (own as any)[key] ?? (defaults as any)[key]
+    const orOwn = (list: any[] | undefined, key: 'catalogEntries' | 'slashTemplates' | 'proposalChoices') =>
+      list && list.length > 0 ? list : (pickOwn(key) as any[]) ?? []
+    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/client/components/chat-input-builder.ts

@@ -40,6 +40,12 @@ export interface ChatMutationInputArgs {
    * server 가 mention map 으로 LLM 에 정확한 refid 정보 첨부 (사용자 노출 0).
    */
   mentions?: Array<{ 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 }
 }
 
 /**
@@ -64,7 +70,8 @@ export function buildChatMutationInput(args: ChatMutationInputArgs): Record<stri
     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/client/index.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/client/utils/assistant-capability-read.ts

@@ -0,0 +1,24 @@
+import { client } from '@operato/graphql'
+import gql from 'graphql-tag'
+
+import { capabilityOf, type AiCapability } from './assistant-capability.js'
+
+/**
+ * Asks `aiCapability` (standard A7-a). A GraphQL error is thrown for the caller to show; the caller keeps
+ * `unknown` meanwhile and asks again — it does not remember a failed read as an answer.
+ */
+export async function readAiCapability(): Promise<AiCapability> {
+  const result = await client.query({
+    query: gql`
+      query {
+        aiCapability {
+          state
+        }
+      }
+    `,
+    fetchPolicy: 'no-cache'
+  })
+
+  if (result.errors?.length) throw new Error(result.errors[0].message)
+  return capabilityOf(result.data?.aiCapability)
+}

package/client/utils/assistant-capability.test.ts

@@ -0,0 +1,17 @@
+/*
+ * A7-a — the third state is never read as the first.
+ */
+import { capabilityOf } from './assistant-capability'
+
+describe('capabilityOf', () => {
+  it('passes the two answers the door gives', () => {
+    expect(capabilityOf({ state: 'configured' })).toBe('configured')
+    expect(capabilityOf({ state: 'not-configured' })).toBe('not-configured')
+  })
+
+  it('★ not asked yet, and an answer it cannot read, are unknown — never configured', () => {
+    for (const answer of [undefined, null, {}, { state: null }, { state: 'yes' }, { state: 'CONFIGURED' }]) {
+      expect(capabilityOf(answer as any)).toBe('unknown')
+    }
+  })
+})

package/client/utils/assistant-capability.ts

@@ -0,0 +1,19 @@
+/*
+ * Whether this deployment has an AI to answer — the rule every dock reads before offering a conversation.
+ *
+ * AI standard A7-a: a screen does not find out by failing. Without this a dock takes the question, sends
+ * it, and only then shows the provider's error. `aiCapability` answers first.
+ *
+ * Three states, and the third is the screen's own: not asked yet, or an answer that could not be read.
+ * It is never folded into `configured` — that is where the question started (a button that was always on).
+ *
+ * Pure, so it is tested without GraphQL. The read is `readAiCapability` (`assistant-capability-read.ts`).
+ * Warehouse and twin each held a copy of this until it moved here (2026-09-24).
+ */
+
+export type AiCapability = 'configured' | 'not-configured' | 'unknown'
+
+export function capabilityOf(answer: { state?: string | null } | null | undefined): AiCapability {
+  const state = answer?.state
+  return state === 'configured' || state === 'not-configured' ? state : 'unknown'
+}

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

@@ -4039,7 +4039,9 @@ let OxAssistantChat = class OxAssistantChat extends LitElement {
                             categories: this.categories,
                             componentSchemas: this.componentSchemas,
                             selectedRefids: this.selectedRefids ?? [],
-                            mentions
+                            mentions,
+                            /* With a declared mode the server owns persona and tools; the board door still carries the board. */
+                            mode: this.conversation.kind ? { kind: this.conversation.kind, target: this.conversation.target } : undefined
                         })
                 }
             });