@things-factory/board-ai 10.1.5 → 10.1.7

package/client/components/default-catalog-entries.ts

@@ -11,7 +11,7 @@
  * 의 tool 카탈로그 회귀 테스트가 server-side drift 는 잡음, client 는 별도 검증
  * 필요). 향후 GraphQL 'boardAICatalog' query 도입 시 이 파일 제거 가능.
  */
-import type { CatalogEntry } from './mention-popup-helpers.js'
+import type { CatalogEntry } from '@things-factory/ai-assistant/dist-client/index.js'
 
 export const DEFAULT_CATALOG_ENTRIES: CatalogEntry[] = [
   // ── Prefabs (3) ─────────────────────────────────────────

package/client/components/default-slash-templates.ts

@@ -13,7 +13,7 @@
  *     자동 호환 — drift 검증은 default-catalog-entries.test.ts 가 잡음
  *   - 너무 많이 만들지 말 것 (popup 이 과해짐). 가장 흔한 의도만.
  */
-import type { SlashTemplate } from './mention-popup-helpers.js'
+import type { SlashTemplate } from '@things-factory/ai-assistant/dist-client/index.js'
 
 export const DEFAULT_SLASH_TEMPLATES: SlashTemplate[] = [
   {

package/client/index.ts

@@ -1,11 +1,44 @@
 /**
  * @things-factory/board-ai — client entries.
  *
- * - `<ox-board-ai-chat>`: 자연어 채팅 컴포넌트 (Lit). board-modeller 또는 워크스페이스에서 임베드.
+ * 대화면 자체는 **`@things-factory/ai-assistant` 로 나갔다**(2026-09-10). 여기 남은 것은 보드
+ * 저작의 기본 목록이고, 아래 한 줄이 그것을 대화면에 넣는다 — 등록하는 쪽이 주인이다.
  *
- * 향후 추가 예정:
- *   - `<ox-board-workspace>`: editor / ai / split 모드 전환 컨테이너
- *   - 모드 전환 애니메이션 + 단축키 + 자동 전환 룰
+ * 이 패키지를 import 하는 소비처는 예전과 똑같이 동작한다: 엘리먼트가 등록되고, 보드 카탈로그와
+ * 슬래시 목록이 채워진다.
  */
-export * from './components/board-ai-chat.js'
-export * from './utils/board-edit-patch.js'
+/*
+ * ⚠ **빌드된 경로를 명시한다** (2026-09-10).
+ *
+ * 처음에 `@things-factory/ai-assistant/client` 로 적었다. `exports` 맵이 없으니 그 서브패스가
+ * **소스 디렉터리**로 떨어지고, webpack 이 `.ts` 원본을 번들에 실었다. 데코레이터 메타데이터가
+ * 없는 채로 실려서 화면이 `Reflect.metadata is not a function` 으로 죽었다 — 빌드는 통과했고
+ * 브라우저에서만 터진다.
+ *
+ * 이 저장소에 같은 부류가 이미 있다: 원본 `.ts` 를 싣는 패키지 때문에 앱마다 webpack stopgap 을
+ * 두고 있다(barcode-base·print-base). 하나 더 만들지 않는다.
+ *
+ * `dist-client/index.js` 를 직접 가리키면 webpack 은 빌드된 JS 를, tsc 는 옆의 `index.d.ts` 를
+ * 집는다. 오늘 `ingest` 를 `dist-shared` 로 가리킨 것과 같은 이유다.
+ */
+import { registerChatDefaults } from '@things-factory/ai-assistant/dist-client/index.js'
+import { DEFAULT_CATALOG_ENTRIES } from './components/default-catalog-entries.js'
+import { DEFAULT_SLASH_TEMPLATES } from './components/default-slash-templates.js'
+
+/*
+ * `footerNoticeKey` — the promise at the bottom of the empty chat.
+ *
+ * It used to be a default inside the chat component: "AI responses are previewed on the board
+ * before they are applied." operato-figure showed that sentence with no board anywhere (2026-09-11).
+ * The promise is only true because board authoring **has** the machinery — a patch is staged and
+ * the user applies it. The package with the machinery says the sentence.
+ */
+registerChatDefaults({
+  catalogEntries: DEFAULT_CATALOG_ENTRIES,
+  slashTemplates: DEFAULT_SLASH_TEMPLATES,
+  footerNoticeKey: 'board-ai.text.preview-before-apply'
+})
+
+export * from '@things-factory/ai-assistant/dist-client/index.js'
+export * from './components/default-catalog-entries.js'
+export * from './components/default-slash-templates.js'

package/dist-client/client/components/default-catalog-entries.d.ts

@@ -11,5 +11,5 @@
  * 의 tool 카탈로그 회귀 테스트가 server-side drift 는 잡음, client 는 별도 검증
  * 필요). 향후 GraphQL 'boardAICatalog' query 도입 시 이 파일 제거 가능.
  */
-import type { CatalogEntry } from './mention-popup-helpers.js';
+import type { CatalogEntry } from '@things-factory/ai-assistant/dist-client/index.js';
 export declare const DEFAULT_CATALOG_ENTRIES: CatalogEntry[];

package/dist-client/client/components/default-catalog-entries.js.map

@@ -1 +1 @@
-{"version":3,"file":"default-catalog-entries.js","sourceRoot":"","sources":["../../../client/components/default-catalog-entries.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,2DAA2D;IAC3D;QACE,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,6BAA6B;KAC3C;IACD;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,gBAAgB;KAC9B;IACD;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,qBAAqB;KACnC;IACD,2DAA2D;IAC3D;QACE,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,wBAAwB;KACtC;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,yBAAyB;KACvC;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,6BAA6B;KAC3C;IACD;QACE,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,+BAA+B;KAC7C;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,8BAA8B;KAC5C;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,mCAAmC;KACjD;IACD;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,yBAAyB;KACvC;IACD,2DAA2D;IAC3D;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,uBAAuB;KACrC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,uBAAuB;KACrC;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,+BAA+B;KAC7C;IACD;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,qBAAqB;KACnC;IACD;QACE,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,kBAAkB;KAChC;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,aAAa;KAC3B;CACF,CAAA","sourcesContent":["/**\n * Default 카탈로그 항목 (client-side hardcoded).\n *\n * 사용자 popup discoverability 용. server-side 카탈로그가 권위 source 이지만, 매번\n * GraphQL 호출해 동적으로 가져오는 대신 default 항목을 client 에 캐시. 호스트 패키지\n * (operato 등) 가 추가 prefab 등록 시 popup 에는 안 나타나지만, 사용자가 직접 이름을\n * 타이핑하면 server-side resolver 가 정상 처리 (catalog-resolver.ts).\n *\n * Drift 경고 — 이 파일과 server-side 의 prefab-registry.ts / COLOR_PALETTES /\n * LAYOUT_TEMPLATES 가 일치해야 한다. 새 default 추가 시 양쪽 동기 (assistant.test.ts\n * 의 tool 카탈로그 회귀 테스트가 server-side drift 는 잡음, client 는 별도 검증\n * 필요). 향후 GraphQL 'boardAICatalog' query 도입 시 이 파일 제거 가능.\n */\nimport type { CatalogEntry } from './mention-popup-helpers.js'\n\nexport const DEFAULT_CATALOG_ENTRIES: CatalogEntry[] = [\n  // ── Prefabs (3) ─────────────────────────────────────────\n  {\n    name: 'monitor-card',\n    kind: 'prefab',\n    description: 'KPI 모니터링 카드 — 라벨 + 큰 값 + 부제'\n  },\n  {\n    name: 'gauge-panel',\n    kind: 'prefab',\n    description: '원형 게이지 + 라벨 패널'\n  },\n  {\n    name: 'stat-tile',\n    kind: 'prefab',\n    description: '강조 컬러 KPI 타일 (큰 숫자)'\n  },\n  // ── Palettes (7) ────────────────────────────────────────\n  {\n    name: 'industrial-steel',\n    kind: 'palette',\n    description: '제조 / 공장 — 강철 + cyan 강조'\n  },\n  {\n    name: 'financial-trader',\n    kind: 'palette',\n    description: '금융 / 트레이딩 — navy + gold'\n  },\n  {\n    name: 'control-room-dark',\n    kind: 'palette',\n    description: 'NOC / 관제실 — pure black + 네온'\n  },\n  {\n    name: 'medical-clean',\n    kind: 'palette',\n    description: '의료 / 헬스케어 — soft white + blue'\n  },\n  {\n    name: 'logistics-warm',\n    kind: 'palette',\n    description: '물류 / 운송 — warm earth + amber'\n  },\n  {\n    name: 'neon-cyberpunk',\n    kind: 'palette',\n    description: 'SF / 사이버펑크 — black + magenta/cyan'\n  },\n  {\n    name: 'paper-light',\n    kind: 'palette',\n    description: '보고서 / 프레젠테이션 — 종이 light'\n  },\n  // ── Layouts (6) ─────────────────────────────────────────\n  {\n    name: 'kpi-row',\n    kind: 'layout',\n    description: '상단 KPI 4-tile + 메인 영역'\n  },\n  {\n    name: '3x3-grid',\n    kind: 'layout',\n    description: '균등 3×3 그리드 — 9개 동등 단위'\n  },\n  {\n    name: 't-shape-command',\n    kind: 'layout',\n    description: '관제실 — alarm bar + main + side'\n  },\n  {\n    name: 'side-rail',\n    kind: 'layout',\n    description: '좌측 narrow + 메인 wide'\n  },\n  {\n    name: 'split-half',\n    kind: 'layout',\n    description: '50/50 가로 분할 — 비교'\n  },\n  {\n    name: 'header-content-footer',\n    kind: 'layout',\n    description: '보고서 형식 — 3단'\n  }\n]\n"]}
+{"version":3,"file":"default-catalog-entries.js","sourceRoot":"","sources":["../../../client/components/default-catalog-entries.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,2DAA2D;IAC3D;QACE,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,6BAA6B;KAC3C;IACD;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,gBAAgB;KAC9B;IACD;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,qBAAqB;KACnC;IACD,2DAA2D;IAC3D;QACE,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,wBAAwB;KACtC;IACD;QACE,IAAI,EAAE,kBAAkB;QACxB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,yBAAyB;KACvC;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,6BAA6B;KAC3C;IACD;QACE,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,+BAA+B;KAC7C;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,8BAA8B;KAC5C;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,mCAAmC;KACjD;IACD;QACE,IAAI,EAAE,aAAa;QACnB,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,yBAAyB;KACvC;IACD,2DAA2D;IAC3D;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,uBAAuB;KACrC;IACD;QACE,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,uBAAuB;KACrC;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,+BAA+B;KAC7C;IACD;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,qBAAqB;KACnC;IACD;QACE,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,kBAAkB;KAChC;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,aAAa;KAC3B;CACF,CAAA","sourcesContent":["/**\n * Default 카탈로그 항목 (client-side hardcoded).\n *\n * 사용자 popup discoverability 용. server-side 카탈로그가 권위 source 이지만, 매번\n * GraphQL 호출해 동적으로 가져오는 대신 default 항목을 client 에 캐시. 호스트 패키지\n * (operato 등) 가 추가 prefab 등록 시 popup 에는 안 나타나지만, 사용자가 직접 이름을\n * 타이핑하면 server-side resolver 가 정상 처리 (catalog-resolver.ts).\n *\n * Drift 경고 — 이 파일과 server-side 의 prefab-registry.ts / COLOR_PALETTES /\n * LAYOUT_TEMPLATES 가 일치해야 한다. 새 default 추가 시 양쪽 동기 (assistant.test.ts\n * 의 tool 카탈로그 회귀 테스트가 server-side drift 는 잡음, client 는 별도 검증\n * 필요). 향후 GraphQL 'boardAICatalog' query 도입 시 이 파일 제거 가능.\n */\nimport type { CatalogEntry } from '@things-factory/ai-assistant/dist-client/index.js'\n\nexport const DEFAULT_CATALOG_ENTRIES: CatalogEntry[] = [\n  // ── Prefabs (3) ─────────────────────────────────────────\n  {\n    name: 'monitor-card',\n    kind: 'prefab',\n    description: 'KPI 모니터링 카드 — 라벨 + 큰 값 + 부제'\n  },\n  {\n    name: 'gauge-panel',\n    kind: 'prefab',\n    description: '원형 게이지 + 라벨 패널'\n  },\n  {\n    name: 'stat-tile',\n    kind: 'prefab',\n    description: '강조 컬러 KPI 타일 (큰 숫자)'\n  },\n  // ── Palettes (7) ────────────────────────────────────────\n  {\n    name: 'industrial-steel',\n    kind: 'palette',\n    description: '제조 / 공장 — 강철 + cyan 강조'\n  },\n  {\n    name: 'financial-trader',\n    kind: 'palette',\n    description: '금융 / 트레이딩 — navy + gold'\n  },\n  {\n    name: 'control-room-dark',\n    kind: 'palette',\n    description: 'NOC / 관제실 — pure black + 네온'\n  },\n  {\n    name: 'medical-clean',\n    kind: 'palette',\n    description: '의료 / 헬스케어 — soft white + blue'\n  },\n  {\n    name: 'logistics-warm',\n    kind: 'palette',\n    description: '물류 / 운송 — warm earth + amber'\n  },\n  {\n    name: 'neon-cyberpunk',\n    kind: 'palette',\n    description: 'SF / 사이버펑크 — black + magenta/cyan'\n  },\n  {\n    name: 'paper-light',\n    kind: 'palette',\n    description: '보고서 / 프레젠테이션 — 종이 light'\n  },\n  // ── Layouts (6) ─────────────────────────────────────────\n  {\n    name: 'kpi-row',\n    kind: 'layout',\n    description: '상단 KPI 4-tile + 메인 영역'\n  },\n  {\n    name: '3x3-grid',\n    kind: 'layout',\n    description: '균등 3×3 그리드 — 9개 동등 단위'\n  },\n  {\n    name: 't-shape-command',\n    kind: 'layout',\n    description: '관제실 — alarm bar + main + side'\n  },\n  {\n    name: 'side-rail',\n    kind: 'layout',\n    description: '좌측 narrow + 메인 wide'\n  },\n  {\n    name: 'split-half',\n    kind: 'layout',\n    description: '50/50 가로 분할 — 비교'\n  },\n  {\n    name: 'header-content-footer',\n    kind: 'layout',\n    description: '보고서 형식 — 3단'\n  }\n]\n"]}

package/dist-client/client/components/default-slash-templates.d.ts

@@ -13,5 +13,5 @@
  *     자동 호환 — drift 검증은 default-catalog-entries.test.ts 가 잡음
  *   - 너무 많이 만들지 말 것 (popup 이 과해짐). 가장 흔한 의도만.
  */
-import type { SlashTemplate } from './mention-popup-helpers.js';
+import type { SlashTemplate } from '@things-factory/ai-assistant/dist-client/index.js';
 export declare const DEFAULT_SLASH_TEMPLATES: SlashTemplate[];

package/dist-client/client/components/default-slash-templates.js.map

@@ -1 +1 @@
-{"version":3,"file":"default-slash-templates.js","sourceRoot":"","sources":["../../../client/components/default-slash-templates.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,uBAAuB,GAAoB;IACtD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,oBAAoB;QACjC,QAAQ,EAAE,0BAA0B;KACrC;IACD;QACE,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,iBAAiB;QAC9B,QAAQ,EAAE,sBAAsB;KACjC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,mBAAmB;QAChC,QAAQ,EAAE,wBAAwB;KACnC;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,eAAe;QAC5B,QAAQ,EAAE,mCAAmC;KAC9C;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,uBAAuB;QACpC,QAAQ,EAAE,6CAA6C;KACxD;IACD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,gBAAgB;QAC7B,QAAQ,EAAE,oDAAoD;KAC/D;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,YAAY;QACzB,QAAQ,EAAE,+BAA+B;KAC1C;IACD;QACE,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,WAAW;QACxB,QAAQ,EAAE,mBAAmB;KAC9B;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,iBAAiB;QAC9B,QAAQ,EAAE,wBAAwB;KACnC;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,eAAe;QAC5B,QAAQ,EAAE,yBAAyB;KACpC;IACD;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,2BAA2B;QACxC,QAAQ,EAAE,yBAAyB;KACpC;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,kBAAkB;QAC/B,QAAQ,EAAE,6BAA6B;KACxC;IACD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,YAAY;QACzB,QAAQ,EAAE,iCAAiC;KAC5C;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,eAAe;QAC5B,QAAQ,EAAE,6BAA6B;KACxC;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,eAAe;QAC5B,QAAQ,EAAE,8BAA8B;KACzC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,YAAY;QACzB,QAAQ,EAAE,2BAA2B;KACtC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,cAAc;QAC3B,QAAQ,EAAE,4BAA4B;KACvC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,eAAe;QAC5B,QAAQ,EAAE,wBAAwB;KACnC;IACD;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,aAAa;QAC1B,QAAQ,EAAE,yBAAyB;KACpC;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,iBAAiB;QAC9B,QAAQ,EAAE,+BAA+B;KAC1C;IACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,kBAAkB;QAC/B,QAAQ,EAAE,gCAAgC;KAC3C;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,iBAAiB;QAC9B,QAAQ,EAAE,iCAAiC;KAC5C;CACF,CAAA","sourcesContent":["/**\n * Default slash templates — 사용자에게 빠르게 작성된 자연어 prompt 를 끼워주는 단축키.\n *\n * `/grid` → \"선택한 컴포넌트들을 3x2 그리드로 정렬해줘\" 같이 텍스트가 textarea 에\n * 삽입됨. 사용자는 그대로 보내거나 숫자/카탈로그 이름을 수정해 보낼 수 있다.\n *\n * Slash 는 LLM 우회 명령이 아니다 — AI 가 받는 입력은 일반 자연어 prompt 와 동일.\n * 단지 \"이런 명령이 가능하구나\" 의 discoverability 를 popup 으로 보여주는 역할.\n *\n * 수정 / 추가 정책:\n *   - 한국어 우선 (자연어가 한국어라야 한국 사용자에게 즉시 작동)\n *   - 카탈로그 이름 (@monitor-card 등) 가 들어간 템플릿은 server-side resolver 와\n *     자동 호환 — drift 검증은 default-catalog-entries.test.ts 가 잡음\n *   - 너무 많이 만들지 말 것 (popup 이 과해짐). 가장 흔한 의도만.\n */\nimport type { SlashTemplate } from './mention-popup-helpers.js'\n\nexport const DEFAULT_SLASH_TEMPLATES: SlashTemplate[] = [\n  {\n    name: 'grid',\n    description: '선택한 컴포넌트들을 그리드로 정렬',\n    template: '선택한 컴포넌트들을 3x2 그리드로 정렬해줘'\n  },\n  {\n    name: 'row',\n    description: '선택한 컴포넌트들을 한 줄로',\n    template: '선택한 컴포넌트들을 한 줄로 배치해줘'\n  },\n  {\n    name: 'column',\n    description: '선택한 컴포넌트들을 세로로 일렬',\n    template: '선택한 컴포넌트들을 세로로 일렬 배치해줘'\n  },\n  {\n    name: 'palette',\n    description: '검증된 색 팔레트로 통일',\n    template: '@industrial-steel 팔레트로 보드 전체 통일해줘'\n  },\n  {\n    name: 'atmosphere',\n    description: '보드 분위기 변경 (자연어 자유 작성)',\n    template: '보드 분위기를 어둡고 차분하게 바꿔줘 (atmosphere primer 활용)'\n  },\n  {\n    name: 'dashboard',\n    description: 'KPI 대시보드 기본 구성',\n    template: '@kpi-row 레이아웃으로 @stat-tile 4개를 상단에 + 아래 메인 영역 구성해줘'\n  },\n  {\n    name: 'add-monitor',\n    description: '모니터링 카드 추가',\n    template: '@monitor-card 추가 (제목과 값은 적절히)'\n  },\n  {\n    name: 'fit',\n    description: '보드 전체 보이게',\n    template: '보드 전체가 보이게 화면 맞춰줘'\n  },\n  {\n    name: 'center',\n    description: '선택 컴포넌트 화면 가운데로',\n    template: '선택한 컴포넌트를 화면 가운데로 이동해줘'\n  },\n  {\n    name: 'inspect',\n    description: '선택 컴포넌트 정보 보기',\n    template: '현재 선택된 컴포넌트의 모든 속성을 보여줘'\n  },\n  {\n    name: 'align',\n    description: '선택 컴포넌트 정렬 (좌/우/위/아래/가운데)',\n    template: '선택한 컴포넌트들을 왼쪽 기준으로 정렬해줘'\n  },\n  {\n    name: 'distribute',\n    description: '선택 컴포넌트 간격 균등 분배',\n    template: '선택한 컴포넌트들을 가로로 간격 균등하게 분배해줘'\n  },\n  {\n    name: 'duplicate',\n    description: '선택 컴포넌트 복제',\n    template: '선택한 컴포넌트를 오른쪽에 같은 크기로 하나 더 복제해줘'\n  },\n  {\n    name: 'match-size',\n    description: '선택 컴포넌트 크기 통일',\n    template: '선택한 컴포넌트들을 첫 번째와 같은 크기로 맞춰줘'\n  },\n  {\n    name: 'z-front',\n    description: '선택 컴포넌트 맨 앞으로',\n    template: '선택한 컴포넌트를 z-order 맨 앞으로 가져와줘'\n  },\n  {\n    name: 'rotate',\n    description: '선택 컴포넌트 회전',\n    template: '선택한 컴포넌트를 시계방향으로 90도 회전해줘'\n  },\n  {\n    name: 'z-back',\n    description: '선택 컴포넌트 맨 뒤로',\n    template: '선택한 컴포넌트를 z-order 맨 뒤로 보내줘'\n  },\n  {\n    name: 'mirror',\n    description: '선택 컴포넌트 좌우 반전',\n    template: '선택한 컴포넌트를 좌우 대칭으로 반전해줘'\n  },\n  {\n    name: 'group',\n    description: '선택 컴포넌트 그룹화',\n    template: '선택한 컴포넌트들을 하나의 그룹으로 묶어줘'\n  },\n  {\n    name: 'rename-sequential',\n    description: '선택 컴포넌트들에 순번 라벨',\n    template: '선택한 컴포넌트들에 1, 2, 3 순번 라벨을 붙여줘'\n  },\n  {\n    name: 'bulk-set',\n    description: '선택 컴포넌트 속성 일괄 변경',\n    template: '선택한 컴포넌트들의 [속성]을 [값]으로 일괄 설정해줘'\n  },\n  {\n    name: 'cleanup',\n    description: '겹침/어색한 위치 자동 정리',\n    template: '겹쳐있거나 어색한 위치의 컴포넌트들을 자연스럽게 정리해줘'\n  }\n]\n"]}
+{"version":3,"file":"default-slash-templates.js","sourceRoot":"","sources":["../../../client/components/default-slash-templates.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,uBAAuB,GAAoB;IACtD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,oBAAoB;QACjC,QAAQ,EAAE,0BAA0B;KACrC;IACD;QACE,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,iBAAiB;QAC9B,QAAQ,EAAE,sBAAsB;KACjC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,mBAAmB;QAChC,QAAQ,EAAE,wBAAwB;KACnC;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,eAAe;QAC5B,QAAQ,EAAE,mCAAmC;KAC9C;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,uBAAuB;QACpC,QAAQ,EAAE,6CAA6C;KACxD;IACD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,gBAAgB;QAC7B,QAAQ,EAAE,oDAAoD;KAC/D;IACD;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,YAAY;QACzB,QAAQ,EAAE,+BAA+B;KAC1C;IACD;QACE,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,WAAW;QACxB,QAAQ,EAAE,mBAAmB;KAC9B;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,iBAAiB;QAC9B,QAAQ,EAAE,wBAAwB;KACnC;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,eAAe;QAC5B,QAAQ,EAAE,yBAAyB;KACpC;IACD;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,2BAA2B;QACxC,QAAQ,EAAE,yBAAyB;KACpC;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,kBAAkB;QAC/B,QAAQ,EAAE,6BAA6B;KACxC;IACD;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,YAAY;QACzB,QAAQ,EAAE,iCAAiC;KAC5C;IACD;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,eAAe;QAC5B,QAAQ,EAAE,6BAA6B;KACxC;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,eAAe;QAC5B,QAAQ,EAAE,8BAA8B;KACzC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,YAAY;QACzB,QAAQ,EAAE,2BAA2B;KACtC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,cAAc;QAC3B,QAAQ,EAAE,4BAA4B;KACvC;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,eAAe;QAC5B,QAAQ,EAAE,wBAAwB;KACnC;IACD;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,aAAa;QAC1B,QAAQ,EAAE,yBAAyB;KACpC;IACD;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,iBAAiB;QAC9B,QAAQ,EAAE,+BAA+B;KAC1C;IACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,kBAAkB;QAC/B,QAAQ,EAAE,gCAAgC;KAC3C;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,iBAAiB;QAC9B,QAAQ,EAAE,iCAAiC;KAC5C;CACF,CAAA","sourcesContent":["/**\n * Default slash templates — 사용자에게 빠르게 작성된 자연어 prompt 를 끼워주는 단축키.\n *\n * `/grid` → \"선택한 컴포넌트들을 3x2 그리드로 정렬해줘\" 같이 텍스트가 textarea 에\n * 삽입됨. 사용자는 그대로 보내거나 숫자/카탈로그 이름을 수정해 보낼 수 있다.\n *\n * Slash 는 LLM 우회 명령이 아니다 — AI 가 받는 입력은 일반 자연어 prompt 와 동일.\n * 단지 \"이런 명령이 가능하구나\" 의 discoverability 를 popup 으로 보여주는 역할.\n *\n * 수정 / 추가 정책:\n *   - 한국어 우선 (자연어가 한국어라야 한국 사용자에게 즉시 작동)\n *   - 카탈로그 이름 (@monitor-card 등) 가 들어간 템플릿은 server-side resolver 와\n *     자동 호환 — drift 검증은 default-catalog-entries.test.ts 가 잡음\n *   - 너무 많이 만들지 말 것 (popup 이 과해짐). 가장 흔한 의도만.\n */\nimport type { SlashTemplate } from '@things-factory/ai-assistant/dist-client/index.js'\n\nexport const DEFAULT_SLASH_TEMPLATES: SlashTemplate[] = [\n  {\n    name: 'grid',\n    description: '선택한 컴포넌트들을 그리드로 정렬',\n    template: '선택한 컴포넌트들을 3x2 그리드로 정렬해줘'\n  },\n  {\n    name: 'row',\n    description: '선택한 컴포넌트들을 한 줄로',\n    template: '선택한 컴포넌트들을 한 줄로 배치해줘'\n  },\n  {\n    name: 'column',\n    description: '선택한 컴포넌트들을 세로로 일렬',\n    template: '선택한 컴포넌트들을 세로로 일렬 배치해줘'\n  },\n  {\n    name: 'palette',\n    description: '검증된 색 팔레트로 통일',\n    template: '@industrial-steel 팔레트로 보드 전체 통일해줘'\n  },\n  {\n    name: 'atmosphere',\n    description: '보드 분위기 변경 (자연어 자유 작성)',\n    template: '보드 분위기를 어둡고 차분하게 바꿔줘 (atmosphere primer 활용)'\n  },\n  {\n    name: 'dashboard',\n    description: 'KPI 대시보드 기본 구성',\n    template: '@kpi-row 레이아웃으로 @stat-tile 4개를 상단에 + 아래 메인 영역 구성해줘'\n  },\n  {\n    name: 'add-monitor',\n    description: '모니터링 카드 추가',\n    template: '@monitor-card 추가 (제목과 값은 적절히)'\n  },\n  {\n    name: 'fit',\n    description: '보드 전체 보이게',\n    template: '보드 전체가 보이게 화면 맞춰줘'\n  },\n  {\n    name: 'center',\n    description: '선택 컴포넌트 화면 가운데로',\n    template: '선택한 컴포넌트를 화면 가운데로 이동해줘'\n  },\n  {\n    name: 'inspect',\n    description: '선택 컴포넌트 정보 보기',\n    template: '현재 선택된 컴포넌트의 모든 속성을 보여줘'\n  },\n  {\n    name: 'align',\n    description: '선택 컴포넌트 정렬 (좌/우/위/아래/가운데)',\n    template: '선택한 컴포넌트들을 왼쪽 기준으로 정렬해줘'\n  },\n  {\n    name: 'distribute',\n    description: '선택 컴포넌트 간격 균등 분배',\n    template: '선택한 컴포넌트들을 가로로 간격 균등하게 분배해줘'\n  },\n  {\n    name: 'duplicate',\n    description: '선택 컴포넌트 복제',\n    template: '선택한 컴포넌트를 오른쪽에 같은 크기로 하나 더 복제해줘'\n  },\n  {\n    name: 'match-size',\n    description: '선택 컴포넌트 크기 통일',\n    template: '선택한 컴포넌트들을 첫 번째와 같은 크기로 맞춰줘'\n  },\n  {\n    name: 'z-front',\n    description: '선택 컴포넌트 맨 앞으로',\n    template: '선택한 컴포넌트를 z-order 맨 앞으로 가져와줘'\n  },\n  {\n    name: 'rotate',\n    description: '선택 컴포넌트 회전',\n    template: '선택한 컴포넌트를 시계방향으로 90도 회전해줘'\n  },\n  {\n    name: 'z-back',\n    description: '선택 컴포넌트 맨 뒤로',\n    template: '선택한 컴포넌트를 z-order 맨 뒤로 보내줘'\n  },\n  {\n    name: 'mirror',\n    description: '선택 컴포넌트 좌우 반전',\n    template: '선택한 컴포넌트를 좌우 대칭으로 반전해줘'\n  },\n  {\n    name: 'group',\n    description: '선택 컴포넌트 그룹화',\n    template: '선택한 컴포넌트들을 하나의 그룹으로 묶어줘'\n  },\n  {\n    name: 'rename-sequential',\n    description: '선택 컴포넌트들에 순번 라벨',\n    template: '선택한 컴포넌트들에 1, 2, 3 순번 라벨을 붙여줘'\n  },\n  {\n    name: 'bulk-set',\n    description: '선택 컴포넌트 속성 일괄 변경',\n    template: '선택한 컴포넌트들의 [속성]을 [값]으로 일괄 설정해줘'\n  },\n  {\n    name: 'cleanup',\n    description: '겹침/어색한 위치 자동 정리',\n    template: '겹쳐있거나 어색한 위치의 컴포넌트들을 자연스럽게 정리해줘'\n  }\n]\n"]}

package/dist-client/client/index.d.ts

@@ -1,11 +1,3 @@
-/**
- * @things-factory/board-ai — client entries.
- *
- * - `<ox-board-ai-chat>`: 자연어 채팅 컴포넌트 (Lit). board-modeller 또는 워크스페이스에서 임베드.
- *
- * 향후 추가 예정:
- *   - `<ox-board-workspace>`: editor / ai / split 모드 전환 컨테이너
- *   - 모드 전환 애니메이션 + 단축키 + 자동 전환 룰
- */
-export * from './components/board-ai-chat.js';
-export * from './utils/board-edit-patch.js';
+export * from '@things-factory/ai-assistant/dist-client/index.js';
+export * from './components/default-catalog-entries.js';
+export * from './components/default-slash-templates.js';

package/dist-client/client/index.js

@@ -1,12 +1,43 @@
 /**
  * @things-factory/board-ai — client entries.
  *
- * - `<ox-board-ai-chat>`: 자연어 채팅 컴포넌트 (Lit). board-modeller 또는 워크스페이스에서 임베드.
+ * 대화면 자체는 **`@things-factory/ai-assistant` 로 나갔다**(2026-09-10). 여기 남은 것은 보드
+ * 저작의 기본 목록이고, 아래 한 줄이 그것을 대화면에 넣는다 — 등록하는 쪽이 주인이다.
  *
- * 향후 추가 예정:
- *   - `<ox-board-workspace>`: editor / ai / split 모드 전환 컨테이너
- *   - 모드 전환 애니메이션 + 단축키 + 자동 전환 룰
+ * 이 패키지를 import 하는 소비처는 예전과 똑같이 동작한다: 엘리먼트가 등록되고, 보드 카탈로그와
+ * 슬래시 목록이 채워진다.
  */
-export * from './components/board-ai-chat.js';
-export * from './utils/board-edit-patch.js';
+/*
+ * ⚠ **빌드된 경로를 명시한다** (2026-09-10).
+ *
+ * 처음에 `@things-factory/ai-assistant/client` 로 적었다. `exports` 맵이 없으니 그 서브패스가
+ * **소스 디렉터리**로 떨어지고, webpack 이 `.ts` 원본을 번들에 실었다. 데코레이터 메타데이터가
+ * 없는 채로 실려서 화면이 `Reflect.metadata is not a function` 으로 죽었다 — 빌드는 통과했고
+ * 브라우저에서만 터진다.
+ *
+ * 이 저장소에 같은 부류가 이미 있다: 원본 `.ts` 를 싣는 패키지 때문에 앱마다 webpack stopgap 을
+ * 두고 있다(barcode-base·print-base). 하나 더 만들지 않는다.
+ *
+ * `dist-client/index.js` 를 직접 가리키면 webpack 은 빌드된 JS 를, tsc 는 옆의 `index.d.ts` 를
+ * 집는다. 오늘 `ingest` 를 `dist-shared` 로 가리킨 것과 같은 이유다.
+ */
+import { registerChatDefaults } from '@things-factory/ai-assistant/dist-client/index.js';
+import { DEFAULT_CATALOG_ENTRIES } from './components/default-catalog-entries.js';
+import { DEFAULT_SLASH_TEMPLATES } from './components/default-slash-templates.js';
+/*
+ * `footerNoticeKey` — the promise at the bottom of the empty chat.
+ *
+ * It used to be a default inside the chat component: "AI responses are previewed on the board
+ * before they are applied." operato-figure showed that sentence with no board anywhere (2026-09-11).
+ * The promise is only true because board authoring **has** the machinery — a patch is staged and
+ * the user applies it. The package with the machinery says the sentence.
+ */
+registerChatDefaults({
+    catalogEntries: DEFAULT_CATALOG_ENTRIES,
+    slashTemplates: DEFAULT_SLASH_TEMPLATES,
+    footerNoticeKey: 'board-ai.text.preview-before-apply'
+});
+export * from '@things-factory/ai-assistant/dist-client/index.js';
+export * from './components/default-catalog-entries.js';
+export * from './components/default-slash-templates.js';
 //# sourceMappingURL=index.js.map

package/dist-client/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,+BAA+B,CAAA;AAC7C,cAAc,6BAA6B,CAAA","sourcesContent":["/**\n * @things-factory/board-ai — client entries.\n *\n * - `<ox-board-ai-chat>`: 자연어 채팅 컴포넌트 (Lit). board-modeller 또는 워크스페이스에서 임베드.\n *\n * 향후 추가 예정:\n *   - `<ox-board-workspace>`: editor / ai / split 모드 전환 컨테이너\n *   - 모드 전환 애니메이션 + 단축키 + 자동 전환 룰\n */\nexport * from './components/board-ai-chat.js'\nexport * from './utils/board-edit-patch.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../client/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mDAAmD,CAAA;AACxF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAA;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAA;AAEjF;;;;;;;GAOG;AACH,oBAAoB,CAAC;IACnB,cAAc,EAAE,uBAAuB;IACvC,cAAc,EAAE,uBAAuB;IACvC,eAAe,EAAE,oCAAoC;CACtD,CAAC,CAAA;AAEF,cAAc,mDAAmD,CAAA;AACjE,cAAc,yCAAyC,CAAA;AACvD,cAAc,yCAAyC,CAAA","sourcesContent":["/**\n * @things-factory/board-ai — client entries.\n *\n * 대화면 자체는 **`@things-factory/ai-assistant` 로 나갔다**(2026-09-10). 여기 남은 것은 보드\n * 저작의 기본 목록이고, 아래 한 줄이 그것을 대화면에 넣는다 — 등록하는 쪽이 주인이다.\n *\n * 이 패키지를 import 하는 소비처는 예전과 똑같이 동작한다: 엘리먼트가 등록되고, 보드 카탈로그와\n * 슬래시 목록이 채워진다.\n */\n/*\n * ⚠ **빌드된 경로를 명시한다** (2026-09-10).\n *\n * 처음에 `@things-factory/ai-assistant/client` 로 적었다. `exports` 맵이 없으니 그 서브패스가\n * **소스 디렉터리**로 떨어지고, webpack 이 `.ts` 원본을 번들에 실었다. 데코레이터 메타데이터가\n * 없는 채로 실려서 화면이 `Reflect.metadata is not a function` 으로 죽었다 — 빌드는 통과했고\n * 브라우저에서만 터진다.\n *\n * 이 저장소에 같은 부류가 이미 있다: 원본 `.ts` 를 싣는 패키지 때문에 앱마다 webpack stopgap 을\n * 두고 있다(barcode-base·print-base). 하나 더 만들지 않는다.\n *\n * `dist-client/index.js` 를 직접 가리키면 webpack 은 빌드된 JS 를, tsc 는 옆의 `index.d.ts` 를\n * 집는다. 오늘 `ingest` 를 `dist-shared` 로 가리킨 것과 같은 이유다.\n */\nimport { registerChatDefaults } from '@things-factory/ai-assistant/dist-client/index.js'\nimport { DEFAULT_CATALOG_ENTRIES } from './components/default-catalog-entries.js'\nimport { DEFAULT_SLASH_TEMPLATES } from './components/default-slash-templates.js'\n\n/*\n * `footerNoticeKey` — the promise at the bottom of the empty chat.\n *\n * It used to be a default inside the chat component: \"AI responses are previewed on the board\n * before they are applied.\" operato-figure showed that sentence with no board anywhere (2026-09-11).\n * The promise is only true because board authoring **has** the machinery — a patch is staged and\n * the user applies it. The package with the machinery says the sentence.\n */\nregisterChatDefaults({\n  catalogEntries: DEFAULT_CATALOG_ENTRIES,\n  slashTemplates: DEFAULT_SLASH_TEMPLATES,\n  footerNoticeKey: 'board-ai.text.preview-before-apply'\n})\n\nexport * from '@things-factory/ai-assistant/dist-client/index.js'\nexport * from './components/default-catalog-entries.js'\nexport * from './components/default-slash-templates.js'\n"]}

package/dist-client/server/service/assistant.d.ts

@@ -4,8 +4,8 @@
 import type { AIClient, AITool, AIToolCall, AIToolChatResult } from '@things-factory/ai-client-base';
 import { type BoardModel, type ComponentCategory } from '@things-factory/board-import';
 import type { BoardAIAssistant, BoardEditOp, ChatOptions, ChatResponse, LLMMessage } from './types.js';
-import { type AgenticLoopResult } from '@things-factory/ai-client-base';
-import { type ToolSpec, type ToolCategoryFilter } from '@things-factory/ai-client-base';
+import { formatAbortNotice, summarizeToolResult, type ToolGate as NeutralToolGate } from '@things-factory/ai-client-base';
+import { type ToolCategoryFilter } from '@things-factory/ai-client-base';
 export interface BoardAIAssistantOptions {
     /** 기본 scope (chat 호출 시 옵션이 없으면 사용) */
     scopes?: string[];
@@ -51,20 +51,7 @@ export declare function listColorPaletteNames(): string[];
  * 등록된 레이아웃 템플릿 이름 목록 — 위와 동일.
  */
 export declare function listLayoutTemplateNames(): string[];
-/**
- * agentic loop 의 비정상 종료 사유 → 사용자 메시지에 부기할 한국어 한 줄.
- *
- * 정상 종료 (abortReason undefined) 면 빈 문자열 — concat 해도 무해.
- * 사용자에게 "왜 중간에 멈췄는지" 단서 제공이 목적 — 침묵 종료 금지.
- */
-export declare function formatAbortNotice(abortReason: AgenticLoopResult['abortReason']): string;
-/**
- * tool 결과를 UI fold-able 박스에 보여줄 만한 크기로 요약.
- *
- * 원본 그대로면 findComponents 50개 / getAtmosphereGuide 같은 큰 객체가 ChatMessage
- * 영속까지 부담 — 핵심 모양만 유지하고 나머지는 marker.
- */
-export declare function summarizeToolResult(value: any, depth?: number): any;
+export { formatAbortNotice, summarizeToolResult };
 export declare function isWriteTool(name: string): boolean;
 export declare function isActionTool(name: string): boolean;
 /**
@@ -86,14 +73,27 @@ export interface ToolExposure {
     /** 외부 카테고리 화이트리스트(registerToolCategory 이름). 미지정 = 전부. */
     toolCategories?: ToolCategoryFilter;
 }
-export interface ToolGate {
+/**
+ * 보드의 게이트 — 공용 게이트 + 이 패키지가 가진 코어 도구 이름집합.
+ *
+ * `coreOn` 이 여기 있는 이유: 「코어 보드 편집 도구」라는 것이 board-ai 에만 있는 개념이다.
+ * 공용 게이트는 레지스트리만 안다.
+ */
+export interface ToolGate extends NeutralToolGate {
     coreOn: boolean;
-    filter: ToolCategoryFilter;
-    isRead(name: string): boolean;
-    isWrite(name: string): boolean;
-    isAction(name: string): boolean;
-    spec(name: string): ToolSpec | undefined;
 }
+/**
+ * ── 레지스트리 판정을 공용으로 옮겼다 (2026-09-10) ─────────────────────────
+ * 이 함수가 두 출처에 답하고 있었다 — **도구 레지스트리**(등록된 카테고리의 kind·spec)와
+ * **이 패키지의 코어 이름집합**. 앞엣것은 중립이다: 「이 이름이 어느 종류이고 이 대화가 볼 수
+ * 있나」는 호스트가 누구든 같은 답이다.
+ *
+ * 그래서 앞엣것은 `registryToolGate` 로 내려갔고, 여기서 뒤엣것을 **더한다**. 이 갈이가 없으면
+ * 보드 없는 제품이 같은 dispatch 규율을 받으려고 자기 게이트를 써야 하고, 그러면 접지 가드가
+ * 갈렸던 것과 같은 일이 게이트에서 난다.
+ *
+ * 더하는 것이지 덮는 것이 아니다 — 덮으면 코어 이름집합에 없는 등록 도구가 조용히 잠긴다.
+ */
 export declare function buildToolGate(exposure?: ToolExposure): ToolGate;
 /**
  * Tool call → BoardActionOp 변환 (C-1 ephemeral scene 조작).

package/dist-client/server/service/assistant.js

@@ -12,11 +12,11 @@ import { buildComponentStyleSummary } from './styling/read-tools';
  *
  * board 의 것(문서·선택 refid·편집 op)은 타입 매개변수로 넘긴다 — 루프는 그 모양을 모른다.
  */
-import { runAgenticLoop } from '@things-factory/ai-client-base';
+import { runAgenticLoop, formatAbortNotice, summarizeToolResult, registryToolGate, extendToolGate } from '@things-factory/ai-client-base';
 import { checkReplyGrounding } from './grounding';
 import { collectAllComponents, findComponentByRefid } from './component-tree';
 import { isStylingTool, dispatchStylingTool, buildStylingToolDefinitions } from './styling/registry.js';
-import { getToolSpecsFor, getToolKind, findToolSpec, getCategoryGuidance, isTransientAIError } from '@things-factory/ai-client-base';
+import { getToolSpecsFor, getToolKind, getCategoryGuidance } from '@things-factory/ai-client-base';
 import { validateWriteToolCall } from './validation/tool-validation';
 const ALL_CATEGORIES = [
     'container',
@@ -201,7 +201,8 @@ export class DefaultBoardAIAssistant {
          * 근거집합의 정의와 사정거리는 ./grounding 머리말 참조(식별자 없는 창작 서술은 잡지 못한다). */
         const warnings = checkReplyGrounding(baseReply, {
             systemPrompt,
-            boardContext,
+            /* 근거집합의 칸 이름은 공용 패키지의 것이다 — 이 값이 보드 문맥이라는 것은 이 파일만 안다. */
+            hostContext: boardContext,
             messages: messages.map(m => (typeof m.content === 'string' ? m.content : '')),
             toolResults: loopResult.groundedTexts
         });
@@ -1793,66 +1794,19 @@ export function listColorPaletteNames() {
 export function listLayoutTemplateNames() {
     return Object.keys(LAYOUT_TEMPLATES.templates);
 }
-/**
- * agentic loop 의 비정상 종료 사유 → 사용자 메시지에 부기할 한국어 한 줄.
+/*
+ * 중단 통지 · 도구 결과 요약 — **공용 패키지로 옮겼다** (2026-09-10).
  *
- * 정상 종료 (abortReason undefined) 면 빈 문자열 — concat 해도 무해.
- * 사용자에게 "왜 중간에 멈췄는지" 단서 제공이 목적 — 침묵 종료 금지.
- */
-export function formatAbortNotice(abortReason) {
-    if (!abortReason)
-        return '';
-    switch (abortReason.type) {
-        case 'aborted':
-            return '\n\n_(요청이 중단되어 일부만 처리됐어요.)_';
-        case 'provider_error':
-            /* 남의 말(SDK 원문)을 사용자에게 보여주지 않는다 — "Error fetching from undefined: [503 …]" 은
-             * 사용자가 할 수 있는 일을 알려주지 않는다. 일시 장애는 이미 몇 번 다시 시도한 뒤이므로,
-             * 지금 필요한 안내는 "잠시 후 다시" 하나다. 원문은 서버 로그에 남는다. */
-            return isTransientAIError({ message: abortReason.message })
-                ? '\n\n_(AI 서비스가 일시적으로 응답하지 않았어요. 잠시 후 다시 시도해 주세요.)_'
-                : '\n\n_(처리 중 오류가 발생했어요. 같은 요청이 계속 실패하면 관리자에게 알려 주세요.)_';
-        case 'max_iterations':
-            return `\n\n_(작업이 너무 길어 ${abortReason.iter}회에서 중단했어요. 더 작게 나눠 요청해보세요.)_`;
-        case 'repeated_validation_failure':
-            return `\n\n_(\`${abortReason.toolName}\` 호출이 ${abortReason.consecutive}회 연속 실패해 중단했어요. 요청을 다시 표현해보세요.)_`;
-    }
-}
-/**
- * tool 결과를 UI fold-able 박스에 보여줄 만한 크기로 요약.
+ * 둘 다 보드를 모르는 함수였다. 옮긴 이유는 중복이 아니라 **한쪽만 갖고 있었던 것**이다:
+ * `twin-ai` 는 `summarizeToolResult: v => v` 로 요약을 아예 안 하고 있었다. 한 제품은 압축해서
+ * 영속하고 다른 제품은 원본을 영속했고, 그렇게 갈린 이유가 어디에도 없었다.
+ *
+ * 중단 통지는 더 무겁다 — 안 붙이면 **잘린 답이 완결된 답과 똑같이 보인다.** 그 보장을 제품마다
+ * 기억해야 하는 것으로 두면 언젠가 한 제품이 잊는다.
  *
- * 원본 그대로면 findComponents 50개 / getAtmosphereGuide 같은 큰 객체가 ChatMessage
- * 영속까지 부담 — 핵심 모양만 유지하고 나머지는 marker.
+ * 여기 남은 것은 재수출이다. 이 패키지를 지나는 소비처가 이름을 그대로 쓰게 한다.
  */
-export function summarizeToolResult(value, depth = 0) {
-    if (value === null || value === undefined)
-        return value;
-    if (typeof value === 'string') {
-        return value.length > 200 ? `${value.slice(0, 200)}…[+${value.length - 200} chars]` : value;
-    }
-    if (typeof value === 'number' || typeof value === 'boolean')
-        return value;
-    if (Array.isArray(value)) {
-        if (depth >= 2)
-            return `[Array(${value.length})]`;
-        const out = value.slice(0, 5).map(v => summarizeToolResult(v, depth + 1));
-        if (value.length > 5)
-            out.push(`…[+${value.length - 5} items]`);
-        return out;
-    }
-    if (typeof value === 'object') {
-        if (depth >= 3) {
-            const keys = Object.keys(value).slice(0, 6).join(',');
-            return `{${keys}${Object.keys(value).length > 6 ? ',…' : ''}}`;
-        }
-        const out = {};
-        for (const key of Object.keys(value)) {
-            out[key] = summarizeToolResult(value[key], depth + 1);
-        }
-        return out;
-    }
-    return undefined;
-}
+export { formatAbortNotice, summarizeToolResult };
 export function isWriteTool(name) {
     if (WRITE_TOOL_NAMES.has(name))
         return true;
@@ -1863,18 +1817,26 @@ export function isActionTool(name) {
         return true;
     return getToolKind(name) === 'action';
 }
+/**
+ * ── 레지스트리 판정을 공용으로 옮겼다 (2026-09-10) ─────────────────────────
+ * 이 함수가 두 출처에 답하고 있었다 — **도구 레지스트리**(등록된 카테고리의 kind·spec)와
+ * **이 패키지의 코어 이름집합**. 앞엣것은 중립이다: 「이 이름이 어느 종류이고 이 대화가 볼 수
+ * 있나」는 호스트가 누구든 같은 답이다.
+ *
+ * 그래서 앞엣것은 `registryToolGate` 로 내려갔고, 여기서 뒤엣것을 **더한다**. 이 갈이가 없으면
+ * 보드 없는 제품이 같은 dispatch 규율을 받으려고 자기 게이트를 써야 하고, 그러면 접지 가드가
+ * 갈렸던 것과 같은 일이 게이트에서 난다.
+ *
+ * 더하는 것이지 덮는 것이 아니다 — 덮으면 코어 이름집합에 없는 등록 도구가 조용히 잠긴다.
+ */
 export function buildToolGate(exposure = {}) {
     const coreOn = exposure.boardTools !== false;
-    const filter = exposure.toolCategories;
-    const kind = (name) => getToolKind(name, filter);
-    return {
-        coreOn,
-        filter,
-        isRead: name => (coreOn && READ_TOOL_NAMES.has(name)) || kind(name) === 'read' || kind(name) === 'external',
-        isWrite: name => (coreOn && WRITE_TOOL_NAMES.has(name)) || kind(name) === 'write',
-        isAction: name => (coreOn && ACTION_TOOL_NAMES.has(name)) || kind(name) === 'action',
-        spec: name => findToolSpec(name, filter)
-    };
+    const gate = extendToolGate(registryToolGate(exposure.toolCategories), {
+        isRead: name => coreOn && READ_TOOL_NAMES.has(name),
+        isWrite: name => coreOn && WRITE_TOOL_NAMES.has(name),
+        isAction: name => coreOn && ACTION_TOOL_NAMES.has(name)
+    });
+    return { ...gate, coreOn };
 }
 /**
  * tool-registry plugin point — 등록된 모든 외부 카테고리의 LLM tool 정의를 도출.