@things-factory/board-import 10.0.0-beta.71 → 10.0.0-beta.73

package/dist-server/service/import-tools.js

@@ -0,0 +1,227 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BOARD_IMPORT_TOOL_CATEGORY = void 0;
+exports.registerBoardImportTools = registerBoardImportTools;
+/**
+ * board-import 의 LLM tool 카테고리 등록.
+ *
+ * board-ai 의 chat 흐름 안에서 사용자가 "이 도면을 보드로 만들어줘" / "import 결과 검수
+ * 후 이 이름으로 저장" 같은 자연어를 발화하면 LLM 이 본 카테고리의 tool 들을 호출한다.
+ *
+ * 노출되는 tool:
+ *   - listImportAdapters       (read)     : 등록된 FormatAdapter 능력 조회
+ *   - importBoardAsync         (external) : Attachment → ImportSession 비동기 시작
+ *   - getImportSession         (read)     : ImportSession 진행/결과 조회
+ *   - materializeImportSession (external) : ImportSession.result → 새 Board entity
+ *
+ * dispatch wiring:
+ *   board-ai 의 chat 메서드가 ToolCallContext (resolver state — domain/user/tx) 를 closure 로
+ *   주입한다. builder 는 ctx.state 에서 typeorm getRepository / domain / user 를 추출해
+ *   service-level 함수 (import-actions, materialize-from-session) 를 호출한다.
+ *
+ *   이 layer 가 없으면 builder 가 typeorm 에 직접 의존해야 했고, board-ai 가 typeorm 까지
+ *   알게 되는 leakage 가 생겼을 것 — 의도적으로 builder 가 ctx.state.typeorm 같은 식으로
+ *   접근하지 않고 things-factory 표준 getRepository 를 호출.
+ */
+const shell_1 = require("@things-factory/shell");
+const ai_client_base_1 = require("@things-factory/ai-client-base");
+// 모든 server-side 의존성 (entity / service 함수 / 외부 패키지) 은 module-level import
+// 없이 lazy require — module load 만으로 typeorm decorator / 외부 controllers chain
+// (예: board-service 의 puppeteer pool) 이 평가되어 jest 환경에서 깨지는 것을 회피.
+// 운영에서는 builder 첫 호출 시 cache 채워져 이후 호출은 직접 dispatch.
+//
+// 이 패턴은 LLM tool layer 의 일반 정책으로 가져갈 수 있다 — registerToolCategory 가
+// 평가되는 시점은 server bootstrap 의 매우 이른 단계라, 그때 typeorm DataSource init 이
+// 아직 끝나지 않았을 가능성이 있다.
+let _depsCache;
+function getDeps() {
+    if (!_depsCache) {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const isMod = require('./import-session/import-session');
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const bsMod = require('@things-factory/board-service');
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const actionsMod = require('./import-session/import-actions');
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const materializeMod = require('./import-session/materialize-from-session');
+        _depsCache = {
+            ImportSession: isMod.ImportSession,
+            Board: bsMod.Board,
+            Group: bsMod.Group,
+            startImportJobAsync: actionsMod.startImportJobAsync,
+            fetchImportSession: actionsMod.fetchImportSession,
+            describeAdapter: actionsMod.describeAdapter,
+            materializeFromSession: materializeMod.materializeFromSession
+        };
+    }
+    return _depsCache;
+}
+/**
+ * tool builder 의 ctx.state 가 도메인 식별을 갖는지 검증. 미설정이면 명확한 에러로 실패 —
+ * board-ai 의 toolCallContext wiring 누락 / 비인증 호출 등을 빠르게 찾기 위해.
+ */
+function requireDomainContext(state) {
+    if (!state || !state.domain) {
+        throw new Error('[board-import] tool builder 의 ctx.state.domain 미설정. ' +
+            'board-ai 의 ChatOptions.toolCallContext 에 ResolverContext.state 가 전달됐는지 확인.');
+    }
+    return { domain: state.domain, user: state.user };
+}
+const importToolsCategory = {
+    name: 'board-import',
+    description: 'Drawing/CAD/IFC/image → Board 변환 파이프라인 (zero-to-twin).',
+    specs: [
+        {
+            kind: 'read',
+            name: 'listImportAdapters',
+            description: '등록된 도면 import 어댑터 (DXF / Image / 향후 IFC, glTF 등) 의 능력 조회. ' +
+                '사용자가 어떤 형식 import 가 가능한지 묻거나, LLM 이 적절한 어댑터 선택을 inspect 할 때 사용.',
+            schema: { type: 'object', properties: {} },
+            builder: async () => {
+                // 동적 import — pipeline 모듈의 DEFAULT_ADAPTERS 를 inspect.
+                // eslint-disable-next-line @typescript-eslint/no-var-requires
+                const pipelineModule = require('./pipeline/index');
+                const adapters = pipelineModule.DEFAULT_ADAPTERS ?? [];
+                return adapters.map(getDeps().describeAdapter);
+            }
+        },
+        {
+            kind: 'external',
+            name: 'importBoardAsync',
+            description: 'Attachment(도면/조감도/사진) 을 비동기로 보드 모델로 변환 시작. 즉시 ImportSession 을 ' +
+                '반환하고 백그라운드에서 진행. status 가 completed 가 될 때까지 getImportSession 으로 ' +
+                'polling 해서 결과를 확인. 형식은 자동 감지 — DXF / GLTF / image 등.',
+            schema: {
+                type: 'object',
+                properties: {
+                    attachmentId: {
+                        type: 'string',
+                        description: 'Attachment id (attachment-base 에 미리 업로드된 도면 파일).'
+                    },
+                    chatSessionId: {
+                        type: 'string',
+                        description: 'board-ai chat session id (선택). 진행 메시지가 chat 흐름에 합류.'
+                    },
+                    scopes: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'ImportRule 의 scope (예: ["fmsim"]). 도메인별 매핑 규칙 활성화.'
+                    },
+                    parseOptions: {
+                        type: 'object',
+                        description: 'Adapter 파싱 옵션 (excludeLayers / maxEntities / context 등).',
+                        additionalProperties: true
+                    }
+                },
+                required: ['attachmentId']
+            },
+            builder: async (args, ctx) => {
+                const { domain, user } = requireDomainContext(ctx?.state);
+                const session = await getDeps().startImportJobAsync({
+                    attachmentId: args.attachmentId,
+                    chatSessionId: args.chatSessionId,
+                    scopes: args.scopes,
+                    parseOptions: args.parseOptions
+                }, { domain, user }, (0, shell_1.getRepository)(getDeps().ImportSession));
+                return {
+                    sessionId: session.id,
+                    status: session.status,
+                    progress: session.progress,
+                    message: session.message
+                };
+            }
+        },
+        {
+            kind: 'read',
+            name: 'getImportSession',
+            description: 'ImportSession 의 진행/결과 조회. status 가 queued/parsing/mapping/assembling/binding 인 ' +
+                '동안은 progress 와 message 를 반환, completed 면 result.boardModel 까지 포함. failed 면 ' +
+                'message 에 에러 사유.',
+            schema: {
+                type: 'object',
+                properties: {
+                    sessionId: { type: 'string', description: 'ImportSession id (importBoardAsync 가 반환).' }
+                },
+                required: ['sessionId']
+            },
+            builder: async (args, ctx) => {
+                const { domain, user } = requireDomainContext(ctx?.state);
+                const session = await getDeps().fetchImportSession(args.sessionId, { domain, user }, (0, shell_1.getRepository)(getDeps().ImportSession));
+                if (!session)
+                    return { found: false };
+                return {
+                    found: true,
+                    sessionId: session.id,
+                    status: session.status,
+                    progress: session.progress,
+                    message: session.message,
+                    // result 는 큰 boardModel 을 포함할 수 있어 status 가 completed 일 때만.
+                    result: session.status === 'completed' ? session.result : undefined,
+                    totalEntities: session.totalEntities,
+                    completedAt: session.completedAt
+                };
+            }
+        },
+        {
+            kind: 'external',
+            name: 'materializeImportSession',
+            description: '완료된 ImportSession 의 결과 boardModel 을 새 Board entity 로 영속화. status 가 ' +
+                'completed 인 세션만 처리. 결과 Board 는 state="draft" 로 생성되므로 사용자가 검수 후 ' +
+                '발행해야 한다.',
+            themeNote: '⚠ 사용자의 명시적 confirm 후에만 호출. import 결과 미리보기를 보여주고 "이 이름으로 ' +
+                '저장하시겠어요?" 같은 확인 받은 다음 발동.',
+            schema: {
+                type: 'object',
+                properties: {
+                    sessionId: { type: 'string' },
+                    name: { type: 'string', description: '새 Board 이름 — 같은 도메인 내 unique.' },
+                    description: { type: 'string' },
+                    groupId: { type: 'string' },
+                    type: { type: 'string', enum: ['main', 'sub', 'popup'] },
+                    thumbnail: {
+                        type: 'string',
+                        description: 'Base64 thumbnail. 미지정 시 빈 placeholder 사용 (별도 thumbnail 생성 호출).'
+                    }
+                },
+                required: ['sessionId', 'name']
+            },
+            builder: async (args, ctx) => {
+                const { domain, user } = requireDomainContext(ctx?.state);
+                const session = await getDeps().fetchImportSession(args.sessionId, { domain, user }, (0, shell_1.getRepository)(getDeps().ImportSession));
+                const { Board, Group, materializeFromSession } = getDeps();
+                const board = await materializeFromSession(session, {
+                    sessionId: args.sessionId,
+                    name: args.name,
+                    description: args.description,
+                    groupId: args.groupId,
+                    type: args.type,
+                    thumbnail: args.thumbnail
+                }, { domain, user }, {
+                    boardRepo: (0, shell_1.getRepository)(Board),
+                    groupRepo: (0, shell_1.getRepository)(Group)
+                });
+                // 큰 model 본문은 LLM 회신에서 제외 — id 와 메타만.
+                return {
+                    boardId: board.id,
+                    name: board.name,
+                    state: board.state,
+                    sourceImportSessionId: board.sourceImportSessionId
+                };
+            }
+        }
+    ]
+};
+// 등록 — module 로드 시 side-effect.
+(0, ai_client_base_1.registerToolCategory)(importToolsCategory);
+/**
+ * 명시적 register 함수 — 테스트나 lazy bootstrap 에서 import 만으로 발동되는 side-effect 가
+ * 부담스러울 때 import 후 명시 호출 가능.
+ */
+function registerBoardImportTools() {
+    (0, ai_client_base_1.registerToolCategory)(importToolsCategory);
+}
+/**
+ * 테스트용 — registerToolCategory 의 입력으로 사용된 카테고리 객체. 외부에서 inspect 가능.
+ */
+exports.BOARD_IMPORT_TOOL_CATEGORY = importToolsCategory;
+//# sourceMappingURL=import-tools.js.map

package/dist-server/service/import-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-tools.js","sourceRoot":"","sources":["../../server/service/import-tools.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * board-import 의 LLM tool 카테고리 등록.\n *\n * board-ai 의 chat 흐름 안에서 사용자가 \"이 도면을 보드로 만들어줘\" / \"import 결과 검수\n * 후 이 이름으로 저장\" 같은 자연어를 발화하면 LLM 이 본 카테고리의 tool 들을 호출한다.\n *\n * 노출되는 tool:\n *   - listImportAdapters       (read)     : 등록된 FormatAdapter 능력 조회\n *   - importBoardAsync         (external) : Attachment → ImportSession 비동기 시작\n *   - getImportSession         (read)     : ImportSession 진행/결과 조회\n *   - materializeImportSession (external) : ImportSession.result → 새 Board entity\n *\n * dispatch wiring:\n *   board-ai 의 chat 메서드가 ToolCallContext (resolver state — domain/user/tx) 를 closure 로\n *   주입한다. builder 는 ctx.state 에서 typeorm getRepository / domain / user 를 추출해\n *   service-level 함수 (import-actions, materialize-from-session) 를 호출한다.\n *\n *   이 layer 가 없으면 builder 가 typeorm 에 직접 의존해야 했고, board-ai 가 typeorm 까지\n *   알게 되는 leakage 가 생겼을 것 — 의도적으로 builder 가 ctx.state.typeorm 같은 식으로\n *   접근하지 않고 things-factory 표준 getRepository 를 호출.\n */\nimport { getRepository } from '@things-factory/shell'\nimport {\n  registerToolCategory,\n  type ToolCategory,\n  type ToolSpec\n} from '@things-factory/ai-client-base'\n\n// 모든 server-side 의존성 (entity / service 함수 / 외부 패키지) 은 module-level import\n// 없이 lazy require — module load 만으로 typeorm decorator / 외부 controllers chain\n// (예: board-service 의 puppeteer pool) 이 평가되어 jest 환경에서 깨지는 것을 회피.\n// 운영에서는 builder 첫 호출 시 cache 채워져 이후 호출은 직접 dispatch.\n//\n// 이 패턴은 LLM tool layer 의 일반 정책으로 가져갈 수 있다 — registerToolCategory 가\n// 평가되는 시점은 server bootstrap 의 매우 이른 단계라, 그때 typeorm DataSource init 이\n// 아직 끝나지 않았을 가능성이 있다.\nlet _depsCache: any | undefined\nfunction getDeps(): any {\n  if (!_depsCache) {\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const isMod = require('./import-session/import-session')\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const bsMod = require('@things-factory/board-service')\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const actionsMod = require('./import-session/import-actions')\n    // eslint-disable-next-line @typescript-eslint/no-var-requires\n    const materializeMod = require('./import-session/materialize-from-session')\n    _depsCache = {\n      ImportSession: isMod.ImportSession,\n      Board: bsMod.Board,\n      Group: bsMod.Group,\n      startImportJobAsync: actionsMod.startImportJobAsync,\n      fetchImportSession: actionsMod.fetchImportSession,\n      describeAdapter: actionsMod.describeAdapter,\n      materializeFromSession: materializeMod.materializeFromSession\n    }\n  }\n  return _depsCache\n}\n\n/**\n * tool builder 의 ctx.state 가 도메인 식별을 갖는지 검증. 미설정이면 명확한 에러로 실패 —\n * board-ai 의 toolCallContext wiring 누락 / 비인증 호출 등을 빠르게 찾기 위해.\n */\nfunction requireDomainContext(state: any): { domain: any; user: any } {\n  if (!state || !state.domain) {\n    throw new Error(\n      '[board-import] tool builder 의 ctx.state.domain 미설정. ' +\n        'board-ai 의 ChatOptions.toolCallContext 에 ResolverContext.state 가 전달됐는지 확인.'\n    )\n  }\n  return { domain: state.domain, user: state.user }\n}\n\nconst importToolsCategory: ToolCategory = {\n  name: 'board-import',\n  description: 'Drawing/CAD/IFC/image → Board 변환 파이프라인 (zero-to-twin).',\n  specs: [\n    {\n      kind: 'read',\n      name: 'listImportAdapters',\n      description:\n        '등록된 도면 import 어댑터 (DXF / Image / 향후 IFC, glTF 등) 의 능력 조회. ' +\n        '사용자가 어떤 형식 import 가 가능한지 묻거나, LLM 이 적절한 어댑터 선택을 inspect 할 때 사용.',\n      schema: { type: 'object', properties: {} },\n      builder: async () => {\n        // 동적 import — pipeline 모듈의 DEFAULT_ADAPTERS 를 inspect.\n        // eslint-disable-next-line @typescript-eslint/no-var-requires\n        const pipelineModule = require('./pipeline/index')\n        const adapters: any[] = pipelineModule.DEFAULT_ADAPTERS ?? []\n        return adapters.map(getDeps().describeAdapter)\n      }\n    },\n    {\n      kind: 'external',\n      name: 'importBoardAsync',\n      description:\n        'Attachment(도면/조감도/사진) 을 비동기로 보드 모델로 변환 시작. 즉시 ImportSession 을 ' +\n        '반환하고 백그라운드에서 진행. status 가 completed 가 될 때까지 getImportSession 으로 ' +\n        'polling 해서 결과를 확인. 형식은 자동 감지 — DXF / GLTF / image 등.',\n      schema: {\n        type: 'object',\n        properties: {\n          attachmentId: {\n            type: 'string',\n            description: 'Attachment id (attachment-base 에 미리 업로드된 도면 파일).'\n          },\n          chatSessionId: {\n            type: 'string',\n            description: 'board-ai chat session id (선택). 진행 메시지가 chat 흐름에 합류.'\n          },\n          scopes: {\n            type: 'array',\n            items: { type: 'string' },\n            description: 'ImportRule 의 scope (예: [\"fmsim\"]). 도메인별 매핑 규칙 활성화.'\n          },\n          parseOptions: {\n            type: 'object',\n            description: 'Adapter 파싱 옵션 (excludeLayers / maxEntities / context 등).',\n            additionalProperties: true\n          }\n        },\n        required: ['attachmentId']\n      },\n      builder: async (args, ctx) => {\n        const { domain, user } = requireDomainContext(ctx?.state)\n        const session = await getDeps().startImportJobAsync(\n          {\n            attachmentId: args.attachmentId,\n            chatSessionId: args.chatSessionId,\n            scopes: args.scopes,\n            parseOptions: args.parseOptions\n          },\n          { domain, user },\n          getRepository(getDeps().ImportSession) as any\n        )\n        return {\n          sessionId: session.id,\n          status: session.status,\n          progress: session.progress,\n          message: session.message\n        }\n      }\n    },\n    {\n      kind: 'read',\n      name: 'getImportSession',\n      description:\n        'ImportSession 의 진행/결과 조회. status 가 queued/parsing/mapping/assembling/binding 인 ' +\n        '동안은 progress 와 message 를 반환, completed 면 result.boardModel 까지 포함. failed 면 ' +\n        'message 에 에러 사유.',\n      schema: {\n        type: 'object',\n        properties: {\n          sessionId: { type: 'string', description: 'ImportSession id (importBoardAsync 가 반환).' }\n        },\n        required: ['sessionId']\n      },\n      builder: async (args, ctx) => {\n        const { domain, user } = requireDomainContext(ctx?.state)\n        const session = await getDeps().fetchImportSession(\n          args.sessionId,\n          { domain, user },\n          getRepository(getDeps().ImportSession) as any\n        )\n        if (!session) return { found: false }\n        return {\n          found: true,\n          sessionId: session.id,\n          status: session.status,\n          progress: session.progress,\n          message: session.message,\n          // result 는 큰 boardModel 을 포함할 수 있어 status 가 completed 일 때만.\n          result: session.status === 'completed' ? session.result : undefined,\n          totalEntities: session.totalEntities,\n          completedAt: session.completedAt\n        }\n      }\n    },\n    {\n      kind: 'external',\n      name: 'materializeImportSession',\n      description:\n        '완료된 ImportSession 의 결과 boardModel 을 새 Board entity 로 영속화. status 가 ' +\n        'completed 인 세션만 처리. 결과 Board 는 state=\"draft\" 로 생성되므로 사용자가 검수 후 ' +\n        '발행해야 한다.',\n      themeNote:\n        '⚠ 사용자의 명시적 confirm 후에만 호출. import 결과 미리보기를 보여주고 \"이 이름으로 ' +\n        '저장하시겠어요?\" 같은 확인 받은 다음 발동.',\n      schema: {\n        type: 'object',\n        properties: {\n          sessionId: { type: 'string' },\n          name: { type: 'string', description: '새 Board 이름 — 같은 도메인 내 unique.' },\n          description: { type: 'string' },\n          groupId: { type: 'string' },\n          type: { type: 'string', enum: ['main', 'sub', 'popup'] },\n          thumbnail: {\n            type: 'string',\n            description: 'Base64 thumbnail. 미지정 시 빈 placeholder 사용 (별도 thumbnail 생성 호출).'\n          }\n        },\n        required: ['sessionId', 'name']\n      },\n      builder: async (args, ctx) => {\n        const { domain, user } = requireDomainContext(ctx?.state)\n        const session = await getDeps().fetchImportSession(\n          args.sessionId,\n          { domain, user },\n          getRepository(getDeps().ImportSession) as any\n        )\n        const { Board, Group, materializeFromSession } = getDeps()\n        const board = await materializeFromSession(\n          session as any,\n          {\n            sessionId: args.sessionId,\n            name: args.name,\n            description: args.description,\n            groupId: args.groupId,\n            type: args.type,\n            thumbnail: args.thumbnail\n          },\n          { domain, user },\n          {\n            boardRepo: getRepository(Board) as any,\n            groupRepo: getRepository(Group) as any\n          }\n        )\n        // 큰 model 본문은 LLM 회신에서 제외 — id 와 메타만.\n        return {\n          boardId: (board as any).id,\n          name: (board as any).name,\n          state: (board as any).state,\n          sourceImportSessionId: (board as any).sourceImportSessionId\n        }\n      }\n    }\n  ] as ToolSpec[]\n}\n\n// 등록 — module 로드 시 side-effect.\nregisterToolCategory(importToolsCategory)\n\n/**\n * 명시적 register 함수 — 테스트나 lazy bootstrap 에서 import 만으로 발동되는 side-effect 가\n * 부담스러울 때 import 후 명시 호출 가능.\n */\nexport function registerBoardImportTools(): void {\n  registerToolCategory(importToolsCategory)\n}\n\n/**\n * 테스트용 — registerToolCategory 의 입력으로 사용된 카테고리 객체. 외부에서 inspect 가능.\n */\nexport const BOARD_IMPORT_TOOL_CATEGORY = importToolsCategory\n"]}

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

@@ -1,22 +1,25 @@
-export * from './import-session/index.js';
-export declare const entities: typeof import("./import-session/import-session.js").ImportSession[];
+export * from './import-session/index';
+export declare const entities: typeof import("./import-session/import-session").ImportSession[];
 export declare const schema: {
-    resolverClasses: typeof import("./import-session/import-session-resolver.js").ImportSessionResolver[];
+    resolverClasses: typeof import("./import-session/import-session-resolver").ImportSessionResolver[];
 };
-export { importBoard } from './pipeline/index.js';
-export type { ImportOptions, ImportResult } from './pipeline/index.js';
-export { applyMapping, GENERIC_OBJECT_TYPE } from './pipeline/stage2-mapping.js';
-export { assembleBoard } from './pipeline/stage3-board.js';
-export { applyDataBinding } from './pipeline/stage4-binding.js';
-export type { BoardModel, BoardComponent, AssembleOptions } from './pipeline/stage3-board.js';
-export type { MappingOptions } from './pipeline/stage2-mapping.js';
-export type { BindingOptions } from './pipeline/stage4-binding.js';
-export { convertGenericTo, revertToGeneric } from './converters/generic-to.js';
-export type { ConvertOptions } from './converters/generic-to.js';
-export { DxfAdapter } from './adapters/dxf-adapter.js';
-export { registerImportRules, registerSubscriptionRules, register3DPresets, getImportRules, getSubscriptionRules, get3DPresets, find3DPreset, findSubscriptionRule, clearImportRules, clearSubscriptionRules, clear3DPresets, clearAllRegistries } from './registry/index.js';
-export type { EntityKind, EntityAttribs, EntityRelation, Vec2, Vec3, Size2, Size3, BoundingBox, UniversalEntity, ParseResult, AdapterMetadata, ParseOptions, AdapterInput, FormatAdapter, AdapterCapabilities } from './types/index.js';
-export type { ComponentCategory, ImportRule, ImportMatcher, ImportBuildSpec, IdStrategy, ComponentDraft, ThreeDPreset, ThreeDGeometry, ThreeDMaterial, SubscriptionRule, MappingResult, MappingWarning } from './types/registry.js';
-export { setAIClient, getAIClient, DefaultBoardImportAI } from './ai/types.js';
+export { importBoard } from './pipeline/index';
+export type { ImportOptions, ImportResult } from './pipeline/index';
+export { applyMapping, GENERIC_OBJECT_TYPE, DEFAULT_CATEGORY_FALLBACK } from './pipeline/stage2-mapping';
+export { assembleBoard } from './pipeline/stage3-board';
+export { applyDataBinding } from './pipeline/stage4-binding';
+export type { BoardModel, BoardComponent, AssembleOptions } from './pipeline/stage3-board';
+export type { MappingOptions } from './pipeline/stage2-mapping';
+export type { BindingOptions } from './pipeline/stage4-binding';
+export { convertGenericTo, // deprecated alias — keep for backward-compat
+convertPlaceholderTo, isPlaceholderType, CORE_PLACEHOLDER_TYPES } from './converters/generic-to';
+export type { ConvertOptions } from './converters/generic-to';
+export { DxfAdapter } from './adapters/dxf-adapter';
+export { ImageAdapter } from './adapters/image-adapter';
+export { registerImportRules, registerSubscriptionRules, register3DPresets, getImportRules, getSubscriptionRules, get3DPresets, find3DPreset, findSubscriptionRule, clearImportRules, clearSubscriptionRules, clear3DPresets, clearAllRegistries } from './registry/index';
+export type { EntityKind, EntityAttribs, EntityRelation, Vec2, Vec3, Size2, Size3, BoundingBox, UniversalEntity, ParseResult, AdapterMetadata, ParseOptions, AdapterInput, FormatAdapter, AdapterCapabilities } from './types/index';
+export type { ComponentCategory, ImportRule, ImportMatcher, ImportBuildSpec, IdStrategy, ComponentDraft, ThreeDPreset, ThreeDGeometry, ThreeDMaterial, SubscriptionRule, MappingResult, MappingWarning } from './types/registry';
+export { setAIClient, getAIClient, DefaultBoardImportAI } from './ai/types';
+export { registerBoardImportTools, BOARD_IMPORT_TOOL_CATEGORY } from './import-tools';
 export type { BoardImportAI, AIClient, // deprecated alias for BoardImportAI
-ConventionInferenceOptions, RuleSuggestion, ClassificationOptions, LabeledEntity, EntityClassification, ImageParseOptions } from './ai/types.js';
+ConventionInferenceOptions, RuleSuggestion, ClassificationOptions, LabeledEntity, EntityClassification, ImageParseOptions } from './ai/types';

package/dist-server/service/index.js

@@ -1,47 +1,57 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DefaultBoardImportAI = exports.getAIClient = exports.setAIClient = exports.clearAllRegistries = exports.clear3DPresets = exports.clearSubscriptionRules = exports.clearImportRules = exports.findSubscriptionRule = exports.find3DPreset = exports.get3DPresets = exports.getSubscriptionRules = exports.getImportRules = exports.register3DPresets = exports.registerSubscriptionRules = exports.registerImportRules = exports.DxfAdapter = exports.revertToGeneric = exports.convertGenericTo = exports.applyDataBinding = exports.assembleBoard = exports.GENERIC_OBJECT_TYPE = exports.applyMapping = exports.importBoard = exports.schema = exports.entities = void 0;
+exports.BOARD_IMPORT_TOOL_CATEGORY = exports.registerBoardImportTools = exports.DefaultBoardImportAI = exports.getAIClient = exports.setAIClient = exports.clearAllRegistries = exports.clear3DPresets = exports.clearSubscriptionRules = exports.clearImportRules = exports.findSubscriptionRule = exports.find3DPreset = exports.get3DPresets = exports.getSubscriptionRules = exports.getImportRules = exports.register3DPresets = exports.registerSubscriptionRules = exports.registerImportRules = exports.ImageAdapter = exports.DxfAdapter = exports.CORE_PLACEHOLDER_TYPES = exports.isPlaceholderType = exports.convertPlaceholderTo = exports.convertGenericTo = exports.applyDataBinding = exports.assembleBoard = exports.DEFAULT_CATEGORY_FALLBACK = exports.GENERIC_OBJECT_TYPE = exports.applyMapping = exports.importBoard = exports.schema = exports.entities = void 0;
 const tslib_1 = require("tslib");
 // ImportSession (비동기 import) — things-factory 모듈 통합용
-const index_js_1 = require("./import-session/index.js");
-tslib_1.__exportStar(require("./import-session/index.js"), exports);
-exports.entities = [...index_js_1.entities];
-exports.schema = { resolverClasses: [...index_js_1.resolverClasses] };
+const index_1 = require("./import-session/index");
+tslib_1.__exportStar(require("./import-session/index"), exports);
+exports.entities = [...index_1.entities];
+exports.schema = { resolverClasses: [...index_1.resolverClasses] };
 // Pipeline (high-level)
-var index_js_2 = require("./pipeline/index.js");
-Object.defineProperty(exports, "importBoard", { enumerable: true, get: function () { return index_js_2.importBoard; } });
+var index_2 = require("./pipeline/index");
+Object.defineProperty(exports, "importBoard", { enumerable: true, get: function () { return index_2.importBoard; } });
 // Stage 별 (low-level)
-var stage2_mapping_js_1 = require("./pipeline/stage2-mapping.js");
-Object.defineProperty(exports, "applyMapping", { enumerable: true, get: function () { return stage2_mapping_js_1.applyMapping; } });
-Object.defineProperty(exports, "GENERIC_OBJECT_TYPE", { enumerable: true, get: function () { return stage2_mapping_js_1.GENERIC_OBJECT_TYPE; } });
-var stage3_board_js_1 = require("./pipeline/stage3-board.js");
-Object.defineProperty(exports, "assembleBoard", { enumerable: true, get: function () { return stage3_board_js_1.assembleBoard; } });
-var stage4_binding_js_1 = require("./pipeline/stage4-binding.js");
-Object.defineProperty(exports, "applyDataBinding", { enumerable: true, get: function () { return stage4_binding_js_1.applyDataBinding; } });
+var stage2_mapping_1 = require("./pipeline/stage2-mapping");
+Object.defineProperty(exports, "applyMapping", { enumerable: true, get: function () { return stage2_mapping_1.applyMapping; } });
+Object.defineProperty(exports, "GENERIC_OBJECT_TYPE", { enumerable: true, get: function () { return stage2_mapping_1.GENERIC_OBJECT_TYPE; } });
+Object.defineProperty(exports, "DEFAULT_CATEGORY_FALLBACK", { enumerable: true, get: function () { return stage2_mapping_1.DEFAULT_CATEGORY_FALLBACK; } });
+var stage3_board_1 = require("./pipeline/stage3-board");
+Object.defineProperty(exports, "assembleBoard", { enumerable: true, get: function () { return stage3_board_1.assembleBoard; } });
+var stage4_binding_1 = require("./pipeline/stage4-binding");
+Object.defineProperty(exports, "applyDataBinding", { enumerable: true, get: function () { return stage4_binding_1.applyDataBinding; } });
 // Converters
-var generic_to_js_1 = require("./converters/generic-to.js");
-Object.defineProperty(exports, "convertGenericTo", { enumerable: true, get: function () { return generic_to_js_1.convertGenericTo; } });
-Object.defineProperty(exports, "revertToGeneric", { enumerable: true, get: function () { return generic_to_js_1.revertToGeneric; } });
+var generic_to_1 = require("./converters/generic-to");
+Object.defineProperty(exports, "convertGenericTo", { enumerable: true, get: function () { return generic_to_1.convertGenericTo; } });
+Object.defineProperty(exports, "convertPlaceholderTo", { enumerable: true, get: function () { return generic_to_1.convertPlaceholderTo; } });
+Object.defineProperty(exports, "isPlaceholderType", { enumerable: true, get: function () { return generic_to_1.isPlaceholderType; } });
+Object.defineProperty(exports, "CORE_PLACEHOLDER_TYPES", { enumerable: true, get: function () { return generic_to_1.CORE_PLACEHOLDER_TYPES; } });
 // Adapters
-var dxf_adapter_js_1 = require("./adapters/dxf-adapter.js");
-Object.defineProperty(exports, "DxfAdapter", { enumerable: true, get: function () { return dxf_adapter_js_1.DxfAdapter; } });
+var dxf_adapter_1 = require("./adapters/dxf-adapter");
+Object.defineProperty(exports, "DxfAdapter", { enumerable: true, get: function () { return dxf_adapter_1.DxfAdapter; } });
+var image_adapter_1 = require("./adapters/image-adapter");
+Object.defineProperty(exports, "ImageAdapter", { enumerable: true, get: function () { return image_adapter_1.ImageAdapter; } });
 // Registry
-var index_js_3 = require("./registry/index.js");
-Object.defineProperty(exports, "registerImportRules", { enumerable: true, get: function () { return index_js_3.registerImportRules; } });
-Object.defineProperty(exports, "registerSubscriptionRules", { enumerable: true, get: function () { return index_js_3.registerSubscriptionRules; } });
-Object.defineProperty(exports, "register3DPresets", { enumerable: true, get: function () { return index_js_3.register3DPresets; } });
-Object.defineProperty(exports, "getImportRules", { enumerable: true, get: function () { return index_js_3.getImportRules; } });
-Object.defineProperty(exports, "getSubscriptionRules", { enumerable: true, get: function () { return index_js_3.getSubscriptionRules; } });
-Object.defineProperty(exports, "get3DPresets", { enumerable: true, get: function () { return index_js_3.get3DPresets; } });
-Object.defineProperty(exports, "find3DPreset", { enumerable: true, get: function () { return index_js_3.find3DPreset; } });
-Object.defineProperty(exports, "findSubscriptionRule", { enumerable: true, get: function () { return index_js_3.findSubscriptionRule; } });
-Object.defineProperty(exports, "clearImportRules", { enumerable: true, get: function () { return index_js_3.clearImportRules; } });
-Object.defineProperty(exports, "clearSubscriptionRules", { enumerable: true, get: function () { return index_js_3.clearSubscriptionRules; } });
-Object.defineProperty(exports, "clear3DPresets", { enumerable: true, get: function () { return index_js_3.clear3DPresets; } });
-Object.defineProperty(exports, "clearAllRegistries", { enumerable: true, get: function () { return index_js_3.clearAllRegistries; } });
+var index_3 = require("./registry/index");
+Object.defineProperty(exports, "registerImportRules", { enumerable: true, get: function () { return index_3.registerImportRules; } });
+Object.defineProperty(exports, "registerSubscriptionRules", { enumerable: true, get: function () { return index_3.registerSubscriptionRules; } });
+Object.defineProperty(exports, "register3DPresets", { enumerable: true, get: function () { return index_3.register3DPresets; } });
+Object.defineProperty(exports, "getImportRules", { enumerable: true, get: function () { return index_3.getImportRules; } });
+Object.defineProperty(exports, "getSubscriptionRules", { enumerable: true, get: function () { return index_3.getSubscriptionRules; } });
+Object.defineProperty(exports, "get3DPresets", { enumerable: true, get: function () { return index_3.get3DPresets; } });
+Object.defineProperty(exports, "find3DPreset", { enumerable: true, get: function () { return index_3.find3DPreset; } });
+Object.defineProperty(exports, "findSubscriptionRule", { enumerable: true, get: function () { return index_3.findSubscriptionRule; } });
+Object.defineProperty(exports, "clearImportRules", { enumerable: true, get: function () { return index_3.clearImportRules; } });
+Object.defineProperty(exports, "clearSubscriptionRules", { enumerable: true, get: function () { return index_3.clearSubscriptionRules; } });
+Object.defineProperty(exports, "clear3DPresets", { enumerable: true, get: function () { return index_3.clear3DPresets; } });
+Object.defineProperty(exports, "clearAllRegistries", { enumerable: true, get: function () { return index_3.clearAllRegistries; } });
 // AI domain interface (Phase 3+) — provider 추상화는 @things-factory/ai-client-base
-var types_js_1 = require("./ai/types.js");
-Object.defineProperty(exports, "setAIClient", { enumerable: true, get: function () { return types_js_1.setAIClient; } });
-Object.defineProperty(exports, "getAIClient", { enumerable: true, get: function () { return types_js_1.getAIClient; } });
-Object.defineProperty(exports, "DefaultBoardImportAI", { enumerable: true, get: function () { return types_js_1.DefaultBoardImportAI; } });
+var types_1 = require("./ai/types");
+Object.defineProperty(exports, "setAIClient", { enumerable: true, get: function () { return types_1.setAIClient; } });
+Object.defineProperty(exports, "getAIClient", { enumerable: true, get: function () { return types_1.getAIClient; } });
+Object.defineProperty(exports, "DefaultBoardImportAI", { enumerable: true, get: function () { return types_1.DefaultBoardImportAI; } });
+// LLM tool 노출 — board-ai 의 chat 흐름이 자동 dispatch 가능하도록 등록.
+// import 시 module side-effect 로 registerToolCategory 발동. 명시 호출도 가능.
+var import_tools_1 = require("./import-tools");
+Object.defineProperty(exports, "registerBoardImportTools", { enumerable: true, get: function () { return import_tools_1.registerBoardImportTools; } });
+Object.defineProperty(exports, "BOARD_IMPORT_TOOL_CATEGORY", { enumerable: true, get: function () { return import_tools_1.BOARD_IMPORT_TOOL_CATEGORY; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";;;;AAAA,qDAAqD;AACrD,wDAGkC;AAClC,oEAAyC;AAE5B,QAAA,QAAQ,GAAG,CAAC,GAAG,mBAAqB,CAAC,CAAA;AACrC,QAAA,MAAM,GAAG,EAAE,eAAe,EAAE,CAAC,GAAG,0BAA4B,CAAC,EAAE,CAAA;AAE5E,wBAAwB;AACxB,gDAAiD;AAAxC,uGAAA,WAAW,OAAA;AAGpB,sBAAsB;AACtB,kEAAgF;AAAvE,iHAAA,YAAY,OAAA;AAAE,wHAAA,mBAAmB,OAAA;AAC1C,8DAA0D;AAAjD,gHAAA,aAAa,OAAA;AACtB,kEAA+D;AAAtD,qHAAA,gBAAgB,OAAA;AAKzB,aAAa;AACb,4DAA8E;AAArE,iHAAA,gBAAgB,OAAA;AAAE,gHAAA,eAAe,OAAA;AAG1C,WAAW;AACX,4DAAsD;AAA7C,4GAAA,UAAU,OAAA;AAEnB,WAAW;AACX,gDAa4B;AAZ1B,+GAAA,mBAAmB,OAAA;AACnB,qHAAA,yBAAyB,OAAA;AACzB,6GAAA,iBAAiB,OAAA;AACjB,0GAAA,cAAc,OAAA;AACd,gHAAA,oBAAoB,OAAA;AACpB,wGAAA,YAAY,OAAA;AACZ,wGAAA,YAAY,OAAA;AACZ,gHAAA,oBAAoB,OAAA;AACpB,4GAAA,gBAAgB,OAAA;AAChB,kHAAA,sBAAsB,OAAA;AACtB,0GAAA,cAAc,OAAA;AACd,8GAAA,kBAAkB,OAAA;AAsCpB,gFAAgF;AAChF,0CAIsB;AAHpB,uGAAA,WAAW,OAAA;AACX,uGAAA,WAAW,OAAA;AACX,gHAAA,oBAAoB,OAAA","sourcesContent":["// ImportSession (비동기 import) — things-factory 모듈 통합용\nimport {\n  entities as ImportSessionEntities,\n  resolverClasses as ImportSessionResolverClasses\n} from './import-session/index.js'\nexport * from './import-session/index.js'\n\nexport const entities = [...ImportSessionEntities]\nexport const schema = { resolverClasses: [...ImportSessionResolverClasses] }\n\n// Pipeline (high-level)\nexport { importBoard } from './pipeline/index.js'\nexport type { ImportOptions, ImportResult } from './pipeline/index.js'\n\n// Stage 별 (low-level)\nexport { applyMapping, GENERIC_OBJECT_TYPE } from './pipeline/stage2-mapping.js'\nexport { assembleBoard } from './pipeline/stage3-board.js'\nexport { applyDataBinding } from './pipeline/stage4-binding.js'\nexport type { BoardModel, BoardComponent, AssembleOptions } from './pipeline/stage3-board.js'\nexport type { MappingOptions } from './pipeline/stage2-mapping.js'\nexport type { BindingOptions } from './pipeline/stage4-binding.js'\n\n// Converters\nexport { convertGenericTo, revertToGeneric } from './converters/generic-to.js'\nexport type { ConvertOptions } from './converters/generic-to.js'\n\n// Adapters\nexport { DxfAdapter } from './adapters/dxf-adapter.js'\n\n// Registry\nexport {\n  registerImportRules,\n  registerSubscriptionRules,\n  register3DPresets,\n  getImportRules,\n  getSubscriptionRules,\n  get3DPresets,\n  find3DPreset,\n  findSubscriptionRule,\n  clearImportRules,\n  clearSubscriptionRules,\n  clear3DPresets,\n  clearAllRegistries\n} from './registry/index.js'\n\n// Types — Universal Entity\nexport type {\n  EntityKind,\n  EntityAttribs,\n  EntityRelation,\n  Vec2,\n  Vec3,\n  Size2,\n  Size3,\n  BoundingBox,\n  UniversalEntity,\n  ParseResult,\n  AdapterMetadata,\n  ParseOptions,\n  AdapterInput,\n  FormatAdapter,\n  AdapterCapabilities\n} from './types/index.js'\n\n// Types — Registry\nexport type {\n  ComponentCategory,\n  ImportRule,\n  ImportMatcher,\n  ImportBuildSpec,\n  IdStrategy,\n  ComponentDraft,\n  ThreeDPreset,\n  ThreeDGeometry,\n  ThreeDMaterial,\n  SubscriptionRule,\n  MappingResult,\n  MappingWarning\n} from './types/registry.js'\n\n// AI domain interface (Phase 3+) — provider 추상화는 @things-factory/ai-client-base\nexport {\n  setAIClient,\n  getAIClient,\n  DefaultBoardImportAI\n} from './ai/types.js'\nexport type {\n  BoardImportAI,\n  AIClient, // deprecated alias for BoardImportAI\n  ConventionInferenceOptions,\n  RuleSuggestion,\n  ClassificationOptions,\n  LabeledEntity,\n  EntityClassification,\n  ImageParseOptions\n} from './ai/types.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";;;;AAAA,qDAAqD;AACrD,kDAG+B;AAC/B,iEAAsC;AAEzB,QAAA,QAAQ,GAAG,CAAC,GAAG,gBAAqB,CAAC,CAAA;AACrC,QAAA,MAAM,GAAG,EAAE,eAAe,EAAE,CAAC,GAAG,uBAA4B,CAAC,EAAE,CAAA;AAE5E,wBAAwB;AACxB,0CAA8C;AAArC,oGAAA,WAAW,OAAA;AAGpB,sBAAsB;AACtB,4DAIkC;AAHhC,8GAAA,YAAY,OAAA;AACZ,qHAAA,mBAAmB,OAAA;AACnB,2HAAA,yBAAyB,OAAA;AAE3B,wDAAuD;AAA9C,6GAAA,aAAa,OAAA;AACtB,4DAA4D;AAAnD,kHAAA,gBAAgB,OAAA;AAKzB,aAAa;AACb,sDAKgC;AAJ9B,8GAAA,gBAAgB,OAAA;AAChB,kHAAA,oBAAoB,OAAA;AACpB,+GAAA,iBAAiB,OAAA;AACjB,oHAAA,sBAAsB,OAAA;AAIxB,WAAW;AACX,sDAAmD;AAA1C,yGAAA,UAAU,OAAA;AACnB,0DAAuD;AAA9C,6GAAA,YAAY,OAAA;AAErB,WAAW;AACX,0CAayB;AAZvB,4GAAA,mBAAmB,OAAA;AACnB,kHAAA,yBAAyB,OAAA;AACzB,0GAAA,iBAAiB,OAAA;AACjB,uGAAA,cAAc,OAAA;AACd,6GAAA,oBAAoB,OAAA;AACpB,qGAAA,YAAY,OAAA;AACZ,qGAAA,YAAY,OAAA;AACZ,6GAAA,oBAAoB,OAAA;AACpB,yGAAA,gBAAgB,OAAA;AAChB,+GAAA,sBAAsB,OAAA;AACtB,uGAAA,cAAc,OAAA;AACd,2GAAA,kBAAkB,OAAA;AAsCpB,gFAAgF;AAChF,oCAImB;AAHjB,oGAAA,WAAW,OAAA;AACX,oGAAA,WAAW,OAAA;AACX,6GAAA,oBAAoB,OAAA;AAGtB,0DAA0D;AAC1D,oEAAoE;AACpE,+CAGuB;AAFrB,wHAAA,wBAAwB,OAAA;AACxB,0HAAA,0BAA0B,OAAA","sourcesContent":["// ImportSession (비동기 import) — things-factory 모듈 통합용\nimport {\n  entities as ImportSessionEntities,\n  resolverClasses as ImportSessionResolverClasses\n} from './import-session/index'\nexport * from './import-session/index'\n\nexport const entities = [...ImportSessionEntities]\nexport const schema = { resolverClasses: [...ImportSessionResolverClasses] }\n\n// Pipeline (high-level)\nexport { importBoard } from './pipeline/index'\nexport type { ImportOptions, ImportResult } from './pipeline/index'\n\n// Stage 별 (low-level)\nexport {\n  applyMapping,\n  GENERIC_OBJECT_TYPE,\n  DEFAULT_CATEGORY_FALLBACK\n} from './pipeline/stage2-mapping'\nexport { assembleBoard } from './pipeline/stage3-board'\nexport { applyDataBinding } from './pipeline/stage4-binding'\nexport type { BoardModel, BoardComponent, AssembleOptions } from './pipeline/stage3-board'\nexport type { MappingOptions } from './pipeline/stage2-mapping'\nexport type { BindingOptions } from './pipeline/stage4-binding'\n\n// Converters\nexport {\n  convertGenericTo,         // deprecated alias — keep for backward-compat\n  convertPlaceholderTo,\n  isPlaceholderType,\n  CORE_PLACEHOLDER_TYPES\n} from './converters/generic-to'\nexport type { ConvertOptions } from './converters/generic-to'\n\n// Adapters\nexport { DxfAdapter } from './adapters/dxf-adapter'\nexport { ImageAdapter } from './adapters/image-adapter'\n\n// Registry\nexport {\n  registerImportRules,\n  registerSubscriptionRules,\n  register3DPresets,\n  getImportRules,\n  getSubscriptionRules,\n  get3DPresets,\n  find3DPreset,\n  findSubscriptionRule,\n  clearImportRules,\n  clearSubscriptionRules,\n  clear3DPresets,\n  clearAllRegistries\n} from './registry/index'\n\n// Types — Universal Entity\nexport type {\n  EntityKind,\n  EntityAttribs,\n  EntityRelation,\n  Vec2,\n  Vec3,\n  Size2,\n  Size3,\n  BoundingBox,\n  UniversalEntity,\n  ParseResult,\n  AdapterMetadata,\n  ParseOptions,\n  AdapterInput,\n  FormatAdapter,\n  AdapterCapabilities\n} from './types/index'\n\n// Types — Registry\nexport type {\n  ComponentCategory,\n  ImportRule,\n  ImportMatcher,\n  ImportBuildSpec,\n  IdStrategy,\n  ComponentDraft,\n  ThreeDPreset,\n  ThreeDGeometry,\n  ThreeDMaterial,\n  SubscriptionRule,\n  MappingResult,\n  MappingWarning\n} from './types/registry'\n\n// AI domain interface (Phase 3+) — provider 추상화는 @things-factory/ai-client-base\nexport {\n  setAIClient,\n  getAIClient,\n  DefaultBoardImportAI\n} from './ai/types'\n\n// LLM tool 노출 — board-ai 의 chat 흐름이 자동 dispatch 가능하도록 등록.\n// import 시 module side-effect 로 registerToolCategory 발동. 명시 호출도 가능.\nexport {\n  registerBoardImportTools,\n  BOARD_IMPORT_TOOL_CATEGORY\n} from './import-tools'\nexport type {\n  BoardImportAI,\n  AIClient, // deprecated alias for BoardImportAI\n  ConventionInferenceOptions,\n  RuleSuggestion,\n  ClassificationOptions,\n  LabeledEntity,\n  EntityClassification,\n  ImageParseOptions\n} from './ai/types'\n"]}

package/dist-server/service/pipeline/index.d.ts

@@ -1,6 +1,6 @@
-import type { AdapterInput, FormatAdapter, ParseOptions, ParseResult } from '../types/index.js';
-import type { MappingResult } from '../types/registry.js';
-import { type BoardModel } from './stage3-board.js';
+import type { AdapterInput, FormatAdapter, ParseOptions, ParseResult } from '../types/index';
+import type { MappingResult } from '../types/registry';
+import { type BoardModel } from './stage3-board';
 export interface ImportOptions {
     file: AdapterInput;
     filename?: string;
@@ -24,10 +24,43 @@ export interface ImportResult {
     mapping: MappingResult;
     parse: ParseResult;
 }
+/**
+ * 변환 시안 (variant) — AI 가 같은 도면을 다른 관점으로 해석한 결과. 사용자가 review 단계에서
+ * 시각 비교 후 선택. parse 가 multi-variant 응답하면 (현재 ImageAdapter), 각 variant 마다
+ * 독립 mapping + assemble. DXF 같은 single-variant adapter 는 1 boardModel 만.
+ */
+export interface VariantResult {
+    id: string;
+    label: string;
+    description?: string;
+    /** 보드 정체성 — name 자동 추천 기반. */
+    subjectName?: string;
+    /** 보드 정체성 — description 자동 추천 기반. */
+    subjectDescription?: string;
+    /** AI 의 의도 narrative — review 카드 표시 (transient). */
+    importStrategy?: string;
+    boardModel: BoardModel;
+    /** mapping 통계 (시안별 — entities 가 다르므로 stats 도 다름). */
+    stats: MappingResult['stats'];
+}
+export interface ImportVariantsResult {
+    variants: VariantResult[];
+    /** 각 시안의 mapping 결과 묶음. variants[i] 와 같은 인덱스. */
+    mappings: MappingResult[];
+    parse: ParseResult;
+}
+export declare const DEFAULT_ADAPTERS: FormatAdapter[];
 export declare function importBoard(opts: ImportOptions): Promise<ImportResult>;
-export { applyMapping } from './stage2-mapping.js';
-export { assembleBoard } from './stage3-board.js';
-export { applyDataBinding } from './stage4-binding.js';
-export type { BoardModel, BoardComponent, AssembleOptions } from './stage3-board.js';
-export type { MappingOptions } from './stage2-mapping.js';
-export type { BindingOptions } from './stage4-binding.js';
+/**
+ * 다중 시안 import — parse 1번 (비싼 VLM/DXF), 시안별 mapping + assemble.
+ *
+ * AI multi-variant adapter (ImageAdapter) 는 parse.variants 에 N 시안 반환 → 각각 mapping +
+ * assemble. Single-variant adapter (DxfAdapter) 는 parse.variants 미존재 → 단일 시안 1 boardModel.
+ */
+export declare function importBoardVariants(opts: ImportOptions): Promise<ImportVariantsResult>;
+export { applyMapping } from './stage2-mapping';
+export { assembleBoard } from './stage3-board';
+export { applyDataBinding } from './stage4-binding';
+export type { BoardModel, BoardComponent, AssembleOptions } from './stage3-board';
+export type { MappingOptions } from './stage2-mapping';
+export type { BindingOptions } from './stage4-binding';