@things-factory/board-ai 10.0.0-beta.64

package/config/config.development.js

@@ -0,0 +1,43 @@
+module.exports = {
+  /*
+    Board AI Configuration
+
+    Settings for AI-driven board modeling. Override in your application's config
+    to tune behavior. Requires the `aiClient` key (see @things-factory/ai-client-base
+    config/config.development.js).
+  */
+  boardAI: {
+    /*
+      Patch confidence threshold for automatic application.
+      Patches with confidence >= this value are auto-applied to the board;
+      below this threshold, the UI requests user review before applying.
+
+      Range: 0..1
+    */
+    patchAutoApplyConfidence: 0.85,
+
+    /*
+      Maximum number of recent messages included in LLM context for each chat() call.
+      Older messages will be compressed into ChatSession.lastSummary (planned).
+
+      Higher = better long-term memory, more tokens per call.
+    */
+    maxContextMessages: 50,
+
+    /*
+      Default LLM options for chat() calls. Overridable per-request via mutation input.
+
+      Example:
+        defaultChatOptions: {
+          model: 'claude-sonnet-4-6',
+          temperature: 0.4,
+          maxTokens: 4096
+        }
+    */
+    defaultChatOptions: {
+      // model: undefined,
+      // temperature: undefined,
+      // maxTokens: 4096
+    }
+  }
+}

package/config/config.production.js

@@ -0,0 +1,15 @@
+module.exports = {
+  /*
+    Board AI Configuration — Production
+
+    See config.development.js for the full reference. Production typically uses
+    the same defaults; tune only when telemetry shows specific need.
+  */
+  boardAI: {
+    patchAutoApplyConfidence: 0.85,
+    maxContextMessages: 50,
+    defaultChatOptions: {
+      // maxTokens: 4096
+    }
+  }
+}

package/dist-client/components/board-ai-chat.d.ts

@@ -0,0 +1,127 @@
+/**
+ * <ox-board-ai-chat> — AI 주도 보드 모델링 채팅 컴포넌트 (Lit).
+ *
+ * 입력:
+ *   - sessionId: 영속 ChatSession 식별자 (없으면 ad-hoc 모드, 메시지 영속 안 됨)
+ *   - currentBoard: 현재 BoardModel JSON (호스트가 동기화)
+ *   - scopes / knownTypes / categories: 도메인 컨텍스트
+ *
+ * 출력 (이벤트):
+ *   - `board-edit-patch` { detail: { patch, summary, confidence, patchId } }
+ *     호스트가 받아서 보드 모델에 적용 (applyBoardEditPatch helper).
+ *   - `chat-followup` { detail: { question } }
+ *
+ * 모드 전환은 컨테이너 (워크스페이스) 의 책임. 이 컴포넌트는 자체로 풀 채팅 UX.
+ */
+import '@material/web/icon/icon.js';
+import { LitElement } from 'lit';
+export declare class OxBoardAIChat extends LitElement {
+    /** 영속 세션 id. 없으면 ad-hoc (메시지 영속 안 됨). */
+    sessionId?: string;
+    /**
+     * 현재 BoardModel — chat() 입력으로 그대로 전달.
+     *
+     * 주의: 호스트가 라이브 편집 가능한 캔버스(things-scene)를 갖고 있다면, 캔버스 안에서
+     * 일어나는 수작업 편집이 이 property 에는 자동 반영되지 않는다. 이 경우 `boardProvider`
+     * 콜백을 같이 넘기면 send() 시점에 라이브 보드를 pull 한다.
+     */
+    currentBoard?: any;
+    /**
+     * 라이브 보드 모델 공급자 (선택).
+     *
+     * 호스트가 things-scene 같은 캔버스를 사용 중이면 사용자가 캔버스에서 수작업 편집한
+     * 내용은 `currentBoard` property 에 자동 반영되지 않는다. 이 콜백을 등록하면 `send()`
+     * 직전에 호출해 가장 최신 보드를 pull → AI 가 항상 라이브 상태를 본다.
+     *
+     * 우선순위: boardProvider() ?? currentBoard.
+     */
+    boardProvider?: () => any;
+    /**
+     * 모델러에서 현재 선택된 컴포넌트의 `refid` 목록.
+     *
+     * refid 는 things-scene 이 모든 컴포넌트에 자동 발급하는 universal numeric handle.
+     * 호스트가 매 render 마다 `.selectedRefids=${...}` 로 갱신. AI 한테 selection 정보로
+     * 그대로 전달되어 "선택한" / "selected" / "this" 류 지시어 해석에 사용.
+     */
+    selectedRefids: number[];
+    /** board-import registry scopes. */
+    scopes?: string[];
+    knownTypes?: string[];
+    categories?: string[];
+    /**
+     * 컴포넌트 type 별 유효 속성 스킴.
+     * 형태: [{ type, description?, group?, properties? }]
+     * LLM 이 정확한 컴포넌트를 만들도록 mutation input 으로 forwarding.
+     */
+    componentSchemas?: Array<{
+        type: string;
+        description?: string;
+        group?: string;
+        properties?: Record<string, any>;
+    }>;
+    placeholder: string;
+    private lines;
+    private input;
+    /** 마지막 send 실패 시 보존 — 다시 시도 버튼 클릭 시 사용 */
+    private lastFailedInput?;
+    /** 되돌려진 patch id 들 — 한 번 revert 한 patch 는 버튼 비활성 */
+    private revertedPatchIds;
+    /** mini action — 인라인 예시 토글 */
+    private examplesOpen;
+    /** 복사 toast 표시 상태 */
+    private toastMessage?;
+    /** 복사 confirmation feedback (메시지 idx → 짧은 시간 동안 ✓ 표시) */
+    private copiedIdx?;
+    private busy;
+    private errorMessage?;
+    static styles: import("lit").CSSResult[];
+    connectedCallback(): void;
+    updated(changed: Map<string, any>): void;
+    private loadHistory;
+    render(): import("lit-html").TemplateResult<1>;
+    private onKeyDown;
+    /** 예시 그룹 — i18n 키. localize mixin 이 언어 변경 시 자동 재렌더. */
+    private static readonly EXAMPLE_GROUPS;
+    private renderEmpty;
+    /** 예시 클릭 — 입력창에 채우고 포커스 (사용자가 수정 후 전송 가능) */
+    private useExample;
+    /** "새 대화" — UI 의 메시지 라인 비움 (서버 ChatSession 이력은 그대로 보존) */
+    private clearChat;
+    private renderInlineExamples;
+    private retryLastSend;
+    /**
+     * 메시지별 hover 액션 — 텍스트 chip 으로 명확.
+     *   user      : 액션 row 자체 X (자기 메시지에 시각 노이즈 X — 편집은 input 위 "새 대화" 흐름 또는 마우스 더블클릭)
+     *   assistant : 복사 + 재생성 + (patch 적용된 경우만) 되돌리기
+     *   system    : 없음
+     */
+    private renderMessageActions;
+    /**
+     * "AI 가 이런 도구를 사용했습니다" fold-able 박스.
+     *
+     * - 기본 닫힘 (toolUsagesOpen=false). 헤더 클릭 시 toggle.
+     * - 펼쳤을 때 도구 별로 name + arguments + result + read/write 색상 배지.
+     * - 디버그 / 신뢰도 향상용 — 사용자가 "왜 이렇게 답했지" 의문 가질 때 즉시 검증.
+     */
+    private renderToolUsages;
+    private toggleToolUsages;
+    private formatJson;
+    private copyMessage;
+    private showToast;
+    /**
+     * 사용자 메시지 편집 — 해당 메시지 + 이후 모두 UI 에서 제거하고 입력창에 채움.
+     * 서버 영속 history 는 그대로 유지 (다음 send 시 새 메시지로 추가).
+     */
+    private editUserMessage;
+    /**
+     * AI 응답 재생성 — 해당 assistant 메시지 + 이후 제거하고, 직전 user 메시지를 다시 send.
+     */
+    private regenerateAssistant;
+    private onRevertClick;
+    private send;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'ox-board-ai-chat': OxBoardAIChat;
+    }
+}