@things-factory/ai-assistant 10.1.13 → 10.1.16

package/client/components/chat-defaults.ts

@@ -28,6 +28,28 @@ export interface ChatDefaults {
    * 그 말을 한다.
    */
   footerNoticeKey?: string
+  /**
+   * Follow-up chips offered on a proposal that arrived without its own `choices`.
+   *
+   * These used to sit in the chat component as a literal array: "다른 콘셉트 재제안", "비율 슬림
+   * 조정", "색상 테마 변경", "디테일 보강". Those are a 3D modeller's words, written in Korean with
+   * no i18n, inside a component four apps share. A plant screen proposal offered to slim its
+   * aspect ratio.
+   *
+   * Same reason as `footerNoticeKey`: the host that knows what a follow-up means writes it.
+   * Leave it unset and a proposal without choices simply gets none, which is correct.
+   */
+  proposalChoices?: any[]
+  /**
+   * The **i18n key** for the line shown once the host reports a proposal staged. Unset means the
+   * badge is never drawn.
+   *
+   * The component cannot know this on its own. It used to read "선택지가 딸려 있다" as "the model is
+   * in the 3D viewer" and say so — in a component plant and twin also use, neither of which has a
+   * 3D viewer. Staging is something the host does, so the host says whether it happened
+   * (`acknowledgeProposalStaged`) and in what words.
+   */
+  stagedNoticeKey?: string
 }
 
 export const chatDefaults: ChatDefaults = { catalogEntries: [], slashTemplates: [] }
@@ -37,4 +59,6 @@ export function registerChatDefaults(defaults: Partial<ChatDefaults>): void {
   if (defaults.catalogEntries) chatDefaults.catalogEntries = defaults.catalogEntries
   if (defaults.slashTemplates) chatDefaults.slashTemplates = defaults.slashTemplates
   if (defaults.footerNoticeKey) chatDefaults.footerNoticeKey = defaults.footerNoticeKey
+  if (defaults.proposalChoices) chatDefaults.proposalChoices = defaults.proposalChoices
+  if (defaults.stagedNoticeKey) chatDefaults.stagedNoticeKey = defaults.stagedNoticeKey
 }

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

@@ -96,7 +96,7 @@ export interface AssistantChatInputArgs {
  */
 export function buildAssistantChatInput(args: AssistantChatInputArgs): Record<string, any> {
   if (!args.systemPrompt?.trim()) {
-    throw new Error('[ox-board-ai-chat] systemPrompt is required when the chat talks to assistantChat')
+    throw new Error('[ox-assistant-chat] systemPrompt is required when the chat talks to assistantChat')
   }
 
   return {

package/client/index.ts

@@ -1,10 +1,9 @@
 /**
  * `@things-factory/ai-assistant` — 대화면.
  *
- * `<ox-board-ai-chat>` 은 **이름을 안 바꿨다.** 커스텀 엘리먼트 이름은 소비처 여덟 곳의 템플릿에
- * 박혀 있고, 그것을 같은 커밋에서 함께 바꾸면 무엇이 깨졌는지 못 가린다. 이름은 별도로 옮긴다.
+ * 표준 컴포넌트는 `<ox-assistant-chat>` 이다.
  */
-export * from './components/board-ai-chat.js'
+export * from './components/assistant-chat.js'
 export * from './components/chat-defaults.js'
 export * from './components/markdown.js'
 export * from './components/chat-echo-dedup.js'

package/dist-client/components/{board-ai-chat.d.ts → assistant-chat.d.ts}

@@ -1,5 +1,5 @@
 /**
- * <ox-board-ai-chat> — AI 주도 보드 모델링 채팅 컴포넌트 (Lit).
+ * <ox-assistant-chat> — AI 도우미 채팅 컴포넌트 (Lit).
  *
  * 입력:
  *   - sessionId: 영속 ChatSession 식별자 (없으면 ad-hoc 모드, 메시지 영속 안 됨)
@@ -19,7 +19,16 @@ import { type AssistantRequestContext } from '../utils/assistant-request-context
 import { LitElement } from 'lit';
 import './mention-popup.js';
 import { type FilterResult } from './mention-popup.js';
-export declare class OxBoardAIChat extends LitElement {
+export interface ChatAttachment {
+    id: string;
+    file: File;
+    name: string;
+    size: number;
+    type: string;
+    url: string;
+    base64?: string;
+}
+export declare class OxAssistantChat extends LitElement {
     /** 영속 세션 id. 없으면 ad-hoc (메시지 영속 안 됨). */
     sessionId?: string;
     prepareSession?: (adopt: (id: string) => void) => Promise<string | undefined>;
@@ -182,6 +191,17 @@ export declare class OxBoardAIChat extends LitElement {
     private lastFailedInput?;
     /** 되돌려진 patch id 들 — 한 번 revert 한 patch 는 버튼 비활성 */
     private revertedPatchIds;
+    /** 첨부된 파일/이미지 목록 */
+    private attachments;
+    /** 드래그 오버 상태 (시각 피드백용) */
+    private dragOver;
+    private onAttachFiles;
+    private readFileAsBase64;
+    private removeAttachment;
+    private onComposerPaste;
+    private onComposerDragOver;
+    private onComposerDragLeave;
+    private onComposerDrop;
     /** mini action — 인라인 예시 토글 */
     private examplesOpen;
     /** 복사 toast 표시 상태 */
@@ -192,6 +212,21 @@ export declare class OxBoardAIChat extends LitElement {
     private openToolSteps;
     /** 이미 실행을 요청한 제안 키 — 같은 카드를 두 번 눌러 되돌릴 수 없는 명령이 두 번 나가지 않게. */
     private sentProposals;
+    /** Proposal keys the host has reported staged. Only the host knows; see `acknowledgeProposalStaged`. */
+    private stagedProposals;
+    /**
+     * The host reports that it put this candidate somewhere the person can look at it.
+     *
+     * Staging happens outside this component — a dock catches `assistant-proposal-preview`, hands
+     * the candidate to a viewer, and only that host knows whether it worked, or whether it has a
+     * viewer at all. So the card says nothing until the host calls this, and it then says it in the
+     * words the host registered (`chatDefaults.stagedNoticeKey`).
+     *
+     * Safe to call for a candidate the card never showed; the key simply never matches.
+     */
+    acknowledgeProposalStaged(proposal: any): void;
+    /** Once per page: the miss is a wiring mistake, and repeating it per candidate buries it. */
+    private static warnedMissingStagedNotice;
     /**
      * 이 대화가 길어져 앞부분이 프롬프트에서 접혔다는 **사실**(서버 보고). 주제 이탈을 판정한 것이
      * 아니다 — 판정하면 오탐이 생기고, 오탐이 생기면 사용자는 안내 자체를 무시한다.
@@ -365,6 +400,7 @@ export declare class OxBoardAIChat extends LitElement {
      * 실행 결과는 호스트가 **대화에 기록**한다 — 누가 무엇을 실행했는지가 협의 이력에 남아야 한다.
      */
     private renderProposals;
+    private onChoiceClick;
     /**
      * 제안 식별 키 — 같은 조치를 두 번 실행하지 않도록 **효과**(명령·대상·인자)로만 만든다.
      *
@@ -432,6 +468,6 @@ export declare class OxBoardAIChat extends LitElement {
 }
 declare global {
     interface HTMLElementTagNameMap {
-        'ox-board-ai-chat': OxBoardAIChat;
+        'ox-assistant-chat': OxAssistantChat;
     }
 }