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

package/dist-server/service/patch-entry/patch-entry.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PatchEntry = void 0;
+const tslib_1 = require("tslib");
+/**
+ * PatchEntry — 보드의 한 변경 단위 (영구 이력).
+ *
+ * source 별:
+ *   - 'ai': AI 가 chat 응답에서 생성
+ *   - 'user-direct': 사용자가 모델러에서 직접 편집 — 변경 이벤트로 자동 기록
+ *   - 'import': ImportSession 결과 (도면 → 보드)
+ *
+ * AI 컨텍스트 유지의 핵심: 사용자 직접 편집도 PatchEntry 로 기록되어
+ * 다음 chat 호출 시 system 메시지로 자동 합류 → AI 가 모든 변경을 인지.
+ */
+const typeorm_1 = require("typeorm");
+const type_graphql_1 = require("type-graphql");
+const graphql_scalars_1 = require("graphql-scalars");
+const env_1 = require("@things-factory/env");
+const chat_session_js_1 = require("../chat-session/chat-session.js");
+const ORMCONFIG = env_1.config.get('ormconfig', {});
+const DATABASE_TYPE = ORMCONFIG.type;
+let PatchEntry = class PatchEntry {
+    /** GraphQL 노출용 — JSON 객체로 변환. */
+    get opsJson() {
+        try {
+            return JSON.parse(this.ops || '[]');
+        }
+        catch {
+            return [];
+        }
+    }
+};
+exports.PatchEntry = PatchEntry;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { nullable: true }),
+    tslib_1.__metadata("design:type", String)
+], PatchEntry.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => chat_session_js_1.ChatSession, session => session.patches, { onDelete: 'CASCADE' }),
+    tslib_1.__metadata("design:type", chat_session_js_1.ChatSession)
+], PatchEntry.prototype, "session", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((patch) => patch.session),
+    tslib_1.__metadata("design:type", String)
+], PatchEntry.prototype, "sessionId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 32 }),
+    (0, type_graphql_1.Field)({ description: "'ai' | 'user-direct' | 'import'" }),
+    tslib_1.__metadata("design:type", String)
+], PatchEntry.prototype, "source", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({
+        type: DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'
+            ? 'longtext'
+            : DATABASE_TYPE == 'oracle'
+                ? 'clob'
+                : DATABASE_TYPE == 'mssql'
+                    ? 'nvarchar'
+                    : 'text',
+        length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined
+    }),
+    tslib_1.__metadata("design:type", String)
+], PatchEntry.prototype, "ops", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(type => graphql_scalars_1.GraphQLJSON, { description: 'BoardEditOp[] (parsed JSON array).' }),
+    tslib_1.__metadata("design:type", Object),
+    tslib_1.__metadata("design:paramtypes", [])
+], PatchEntry.prototype, "opsJson", null);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'text', nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Short human summary of this patch.' }),
+    tslib_1.__metadata("design:type", String)
+], PatchEntry.prototype, "summary", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'float', nullable: true }),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { nullable: true, description: 'AI confidence 0..1 (null for user-direct).' }),
+    tslib_1.__metadata("design:type", Number)
+], PatchEntry.prototype, "confidence", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ default: false }),
+    (0, type_graphql_1.Field)({ description: 'Whether this patch was reverted.' }),
+    tslib_1.__metadata("design:type", Boolean)
+], PatchEntry.prototype, "reverted", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true }),
+    tslib_1.__metadata("design:type", Date)
+], PatchEntry.prototype, "createdAt", void 0);
+exports.PatchEntry = PatchEntry = tslib_1.__decorate([
+    (0, typeorm_1.Entity)(),
+    (0, typeorm_1.Index)('ix_patch_entry_1', (patch) => [patch.session, patch.createdAt]),
+    (0, type_graphql_1.ObjectType)({ description: 'One board edit operation history (cascade-deleted with ChatSession).' })
+], PatchEntry);
+//# sourceMappingURL=patch-entry.js.map

package/dist-server/service/patch-entry/patch-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-entry.js","sourceRoot":"","sources":["../../../server/service/patch-entry/patch-entry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * PatchEntry — 보드의 한 변경 단위 (영구 이력).\n *\n * source 별:\n *   - 'ai': AI 가 chat 응답에서 생성\n *   - 'user-direct': 사용자가 모델러에서 직접 편집 — 변경 이벤트로 자동 기록\n *   - 'import': ImportSession 결과 (도면 → 보드)\n *\n * AI 컨텍스트 유지의 핵심: 사용자 직접 편집도 PatchEntry 로 기록되어\n * 다음 chat 호출 시 system 메시지로 자동 합류 → AI 가 모든 변경을 인지.\n */\nimport {\n  Column,\n  CreateDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId\n} from 'typeorm'\nimport { Field, ID, Float, ObjectType } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\n\nimport { config } from '@things-factory/env'\n\nimport { ChatSession } from '../chat-session/chat-session.js'\n\nconst ORMCONFIG = config.get('ormconfig', {})\nconst DATABASE_TYPE = ORMCONFIG.type\n\n@Entity()\n@Index('ix_patch_entry_1', (patch: PatchEntry) => [patch.session, patch.createdAt])\n@ObjectType({ description: 'One board edit operation history (cascade-deleted with ChatSession).' })\nexport class PatchEntry {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { nullable: true })\n  readonly id?: string\n\n  @ManyToOne(type => ChatSession, session => session.patches, { onDelete: 'CASCADE' })\n  session?: ChatSession\n\n  @RelationId((patch: PatchEntry) => patch.session)\n  sessionId?: string\n\n  /** 'ai' | 'user-direct' | 'import' */\n  @Column({ type: 'varchar', length: 32 })\n  @Field({ description: \"'ai' | 'user-direct' | 'import'\" })\n  source!: string\n\n  /** BoardEditOp[] JSON-stringified — column 으로는 long text. */\n  @Column({\n    type:\n      DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'\n        ? 'longtext'\n        : DATABASE_TYPE == 'oracle'\n          ? 'clob'\n          : DATABASE_TYPE == 'mssql'\n            ? 'nvarchar'\n            : 'text',\n    length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined\n  })\n  ops!: string\n\n  /** GraphQL 노출용 — JSON 객체로 변환. */\n  @Field(type => GraphQLJSON, { description: 'BoardEditOp[] (parsed JSON array).' })\n  get opsJson(): any {\n    try {\n      return JSON.parse(this.ops || '[]')\n    } catch {\n      return []\n    }\n  }\n\n  @Column({ type: 'text', nullable: true })\n  @Field({ nullable: true, description: 'Short human summary of this patch.' })\n  summary?: string\n\n  @Column({ type: 'float', nullable: true })\n  @Field(type => Float, { nullable: true, description: 'AI confidence 0..1 (null for user-direct).' })\n  confidence?: number\n\n  @Column({ default: false })\n  @Field({ description: 'Whether this patch was reverted.' })\n  reverted!: boolean\n\n  @CreateDateColumn()\n  @Field({ nullable: true })\n  createdAt?: Date\n}\n"]}

package/dist-server/service/types.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Board AI — 자연어 채팅 인터페이스 타입 정의.
+ *
+ * 핵심 개념:
+ *   - 단일 진입점 `chat()`. 의도 분류(생성/편집/스타일/질문)는 AI 의 일.
+ *   - 출력은 항상 `ChatResponse`. 보드 변경이 있으면 `patch` 동봉.
+ *   - patch 의 op 는 직교 4 종 (add / remove / modify / replace).
+ *     style/move 등은 modify.patch 안에 흡수.
+ */
+import type { BoardComponent, BoardModel } from '@things-factory/board-import';
+export interface LLMMessage {
+    role: 'user' | 'assistant';
+    content: string;
+}
+export interface ChatOptions {
+    /** board-import 의 registry scope — 등록된 ImportRule 에서 type/category 후보 추출 */
+    scopes?: string[];
+    /** 사용 가능한 도메인 type (override). 미지정 시 scopes 에서 자동 추출 */
+    knownTypes?: string[];
+    /** 사용 가능한 카테고리 (override). 미지정 시 scopes 에서 자동 추출 */
+    categories?: string[];
+    /**
+     * 컴포넌트 type 별 유효 속성 스킴.
+     * LLM 이 정확한 컴포넌트 생성을 하도록 type 의 description, group, default model 키 전달.
+     *
+     * 예:
+     *   [{ type: 'rect', description: 'Rectangle', group: 'shape',
+     *      properties: { fillStyle: '#fff', strokeStyle: '#000' } }, ...]
+     */
+    componentSchemas?: ComponentSchema[];
+    /**
+     * 사용자가 모델러에서 현재 선택한 컴포넌트의 `refid` 목록.
+     *
+     * refid 는 things-scene 이 모든 컴포넌트에 자동 발급하는 universal numeric handle.
+     * id (데이터 바인딩 이름, unique 아님) 와는 다른 개념 — 선택은 항상 refid 로 표현.
+     */
+    selectedRefids?: number[];
+    /** LLM 모델 override */
+    model?: string;
+    /** LLM 옵션 */
+    temperature?: number;
+    maxTokens?: number;
+}
+export interface ComponentSchema {
+    type: string;
+    description?: string;
+    group?: string;
+    /**
+     * 좌표/크기/경로 관련 키들 — type 마다 다름.
+     * 예) ['left', 'top', 'width', 'height']  vs  ['cx', 'cy', 'radius']  vs  ['points']
+     * LLM 이 type 별 정확한 좌표 키를 사용하도록 명시.
+     */
+    geometryKeys?: string[];
+    /**
+     * 좌표 외 type 특화 속성 (style, value, min/max 등).
+     * default 값 또는 keys 만 — LLM 의 token 절감을 위해 호출자가 적절히 압축.
+     */
+    properties?: Record<string, any>;
+}
+/**
+ * AI 가 응답을 만드는 동안 호출한 도구의 시간순 trace.
+ *
+ * UX 목적 — 사용자가 "왜 이렇게 답했지" 의문 가질 때 fold-able 박스에서 확인.
+ * 디버그용 + 신뢰도 향상.
+ */
+export interface ToolUsage {
+    /** 도구 이름 (예: 'getSelection', 'modifyBoard', 'addComponent') */
+    name: string;
+    /** 호출 인자 JSON */
+    arguments: any;
+    /** 도구 결과 — read tool 은 실제 값 (truncated 가능), write tool 은 queued 마커 */
+    result: any;
+    /** read tool / write tool 분류 */
+    kind: 'read' | 'write' | 'unknown';
+}
+export interface ChatResponse {
+    /** 사용자에게 보여줄 텍스트 응답 */
+    reply: string;
+    /** 보드 변경이 있으면 patch */
+    patch?: BoardEditPatch;
+    /** 모호한 입력 시 명확화 질문 (patch 없음) */
+    followUp?: string;
+    /** AI 가 응답 만드는 과정에서 호출한 도구들 (시간순). UI fold-able 박스용. */
+    toolUsages?: ToolUsage[];
+}
+export interface BoardEditPatch {
+    ops: BoardEditOp[];
+    /** 사용자 검수용 1-2 문장 요약 */
+    summary: string;
+    /** 0..1 신뢰도 */
+    confidence: number;
+}
+/**
+ * 보드 변경 op.
+ *
+ * 식별자 정책 — 기존 컴포넌트 타깃팅은 `refid` (number) 만 사용.
+ * things-scene 의 모든 컴포넌트는 `refid` 를 자동 발급받는다 (universal).
+ * `model.id` 는 optional metadata 일 뿐 — 항상 존재하지 않으므로 targeting 에는
+ * 부적합. 별개 개념이므로 BoardEditOp / tool 인자에서도 별개 식별자로 분리하지
+ * 않고 refid 단일 채널로 일원화.
+ *
+ * 계층 — 보드는 **최상위 부모** 이고 그 자체로 자기 속성 (fillStyle, width, height,
+ * name 등) 을 갖는다. 자식 컴포넌트와 별개. 보드 속성 변경은 `modifyBoard`,
+ * 자식 변경은 `modify` (refid 기반).
+ *
+ * style 변경 / 이동 / 크기 변경 등 자식 컴포넌트의 변경은 모두 `modify.patch` 안에
+ * 흡수. 보드 root 속성 변경은 `modifyBoard.patch` 로.
+ */
+export type BoardEditOp = {
+    op: 'add';
+    component: BoardComponent;
+} | {
+    op: 'remove';
+    refid: number;
+} | {
+    op: 'modify';
+    refid: number;
+    patch: Partial<BoardComponent>;
+} | {
+    op: 'modifyBoard';
+    patch: Partial<BoardModel>;
+} | {
+    op: 'replace';
+    board: BoardModel;
+};
+/**
+ * BoardAIAssistant — 자연어 채팅으로 보드를 다루는 단일 인터페이스.
+ *
+ * 사용:
+ *   const ai = new DefaultBoardAIAssistant(baseClient, { scopes: ['fmsim'] })
+ *   const r = await ai.chat([{ role: 'user', content: 'AGV 3대 추가' }], currentBoard)
+ *   if (r.patch) currentBoard = applyBoardEditPatch(currentBoard, r.patch)
+ */
+export interface BoardAIAssistant {
+    readonly id: string;
+    chat(messages: LLMMessage[], currentBoard: BoardModel | undefined, options?: ChatOptions): Promise<ChatResponse>;
+}

package/dist-server/service/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist-server/service/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../server/service/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Board AI — 자연어 채팅 인터페이스 타입 정의.\n *\n * 핵심 개념:\n *   - 단일 진입점 `chat()`. 의도 분류(생성/편집/스타일/질문)는 AI 의 일.\n *   - 출력은 항상 `ChatResponse`. 보드 변경이 있으면 `patch` 동봉.\n *   - patch 의 op 는 직교 4 종 (add / remove / modify / replace).\n *     style/move 등은 modify.patch 안에 흡수.\n */\nimport type { BoardComponent, BoardModel } from '@things-factory/board-import'\n\nexport interface LLMMessage {\n  role: 'user' | 'assistant'\n  content: string\n}\n\nexport interface ChatOptions {\n  /** board-import 의 registry scope — 등록된 ImportRule 에서 type/category 후보 추출 */\n  scopes?: string[]\n  /** 사용 가능한 도메인 type (override). 미지정 시 scopes 에서 자동 추출 */\n  knownTypes?: string[]\n  /** 사용 가능한 카테고리 (override). 미지정 시 scopes 에서 자동 추출 */\n  categories?: string[]\n  /**\n   * 컴포넌트 type 별 유효 속성 스킴.\n   * LLM 이 정확한 컴포넌트 생성을 하도록 type 의 description, group, default model 키 전달.\n   *\n   * 예:\n   *   [{ type: 'rect', description: 'Rectangle', group: 'shape',\n   *      properties: { fillStyle: '#fff', strokeStyle: '#000' } }, ...]\n   */\n  componentSchemas?: ComponentSchema[]\n  /**\n   * 사용자가 모델러에서 현재 선택한 컴포넌트의 `refid` 목록.\n   *\n   * refid 는 things-scene 이 모든 컴포넌트에 자동 발급하는 universal numeric handle.\n   * id (데이터 바인딩 이름, unique 아님) 와는 다른 개념 — 선택은 항상 refid 로 표현.\n   */\n  selectedRefids?: number[]\n  /** LLM 모델 override */\n  model?: string\n  /** LLM 옵션 */\n  temperature?: number\n  maxTokens?: number\n}\n\nexport interface ComponentSchema {\n  type: string\n  description?: string\n  group?: string\n  /**\n   * 좌표/크기/경로 관련 키들 — type 마다 다름.\n   * 예) ['left', 'top', 'width', 'height']  vs  ['cx', 'cy', 'radius']  vs  ['points']\n   * LLM 이 type 별 정확한 좌표 키를 사용하도록 명시.\n   */\n  geometryKeys?: string[]\n  /**\n   * 좌표 외 type 특화 속성 (style, value, min/max 등).\n   * default 값 또는 keys 만 — LLM 의 token 절감을 위해 호출자가 적절히 압축.\n   */\n  properties?: Record<string, any>\n}\n\n/**\n * AI 가 응답을 만드는 동안 호출한 도구의 시간순 trace.\n *\n * UX 목적 — 사용자가 \"왜 이렇게 답했지\" 의문 가질 때 fold-able 박스에서 확인.\n * 디버그용 + 신뢰도 향상.\n */\nexport interface ToolUsage {\n  /** 도구 이름 (예: 'getSelection', 'modifyBoard', 'addComponent') */\n  name: string\n  /** 호출 인자 JSON */\n  arguments: any\n  /** 도구 결과 — read tool 은 실제 값 (truncated 가능), write tool 은 queued 마커 */\n  result: any\n  /** read tool / write tool 분류 */\n  kind: 'read' | 'write' | 'unknown'\n}\n\nexport interface ChatResponse {\n  /** 사용자에게 보여줄 텍스트 응답 */\n  reply: string\n  /** 보드 변경이 있으면 patch */\n  patch?: BoardEditPatch\n  /** 모호한 입력 시 명확화 질문 (patch 없음) */\n  followUp?: string\n  /** AI 가 응답 만드는 과정에서 호출한 도구들 (시간순). UI fold-able 박스용. */\n  toolUsages?: ToolUsage[]\n}\n\nexport interface BoardEditPatch {\n  ops: BoardEditOp[]\n  /** 사용자 검수용 1-2 문장 요약 */\n  summary: string\n  /** 0..1 신뢰도 */\n  confidence: number\n}\n\n/**\n * 보드 변경 op.\n *\n * 식별자 정책 — 기존 컴포넌트 타깃팅은 `refid` (number) 만 사용.\n * things-scene 의 모든 컴포넌트는 `refid` 를 자동 발급받는다 (universal).\n * `model.id` 는 optional metadata 일 뿐 — 항상 존재하지 않으므로 targeting 에는\n * 부적합. 별개 개념이므로 BoardEditOp / tool 인자에서도 별개 식별자로 분리하지\n * 않고 refid 단일 채널로 일원화.\n *\n * 계층 — 보드는 **최상위 부모** 이고 그 자체로 자기 속성 (fillStyle, width, height,\n * name 등) 을 갖는다. 자식 컴포넌트와 별개. 보드 속성 변경은 `modifyBoard`,\n * 자식 변경은 `modify` (refid 기반).\n *\n * style 변경 / 이동 / 크기 변경 등 자식 컴포넌트의 변경은 모두 `modify.patch` 안에\n * 흡수. 보드 root 속성 변경은 `modifyBoard.patch` 로.\n */\nexport type BoardEditOp =\n  | { op: 'add'; component: BoardComponent }\n  | { op: 'remove'; refid: number }\n  | { op: 'modify'; refid: number; patch: Partial<BoardComponent> }\n  | { op: 'modifyBoard'; patch: Partial<BoardModel> }\n  | { op: 'replace'; board: BoardModel }\n\n/**\n * BoardAIAssistant — 자연어 채팅으로 보드를 다루는 단일 인터페이스.\n *\n * 사용:\n *   const ai = new DefaultBoardAIAssistant(baseClient, { scopes: ['fmsim'] })\n *   const r = await ai.chat([{ role: 'user', content: 'AGV 3대 추가' }], currentBoard)\n *   if (r.patch) currentBoard = applyBoardEditPatch(currentBoard, r.patch)\n */\nexport interface BoardAIAssistant {\n  readonly id: string\n  chat(\n    messages: LLMMessage[],\n    currentBoard: BoardModel | undefined,\n    options?: ChatOptions\n  ): Promise<ChatResponse>\n}\n"]}