@things-factory/ai-assistant 10.1.20 → 10.1.25

package/dist-client/components/assistant-mode.d.ts

@@ -0,0 +1,91 @@
+/**
+ * A mode is what a conversation *is*: who the assistant is, what it can do, what the talk is
+ * about, what it offers to start with, and when it is over.
+ *
+ * Those five used to be four separate properties on the chat element plus one global registry,
+ * and every host wired them one at a time. Separate means they can disagree, and they did: a
+ * screen whose `systemPrompt` said "you do not edit boards here" offered `/add-monitor` in the
+ * same panel, because the prompt was a property and the slash list was global.
+ *
+ * So a host declares one value and hands it over. What cannot be split cannot fall out of step.
+ *
+ * ```ts
+ * const SPACE_MODE = (spaceId: string): AssistantMode => ({
+ *   id: `twin:space:${spaceId}`,
+ *   systemPrompt: '...',
+ *   toolCategories: ['twin'],
+ *   hostContext: { spaceId },
+ *   slashTemplates: TWIN_SLASH_TEMPLATES
+ * })
+ *
+ * html`<ox-assistant-chat .mode=${SPACE_MODE(this.spaceId)}></ox-assistant-chat>`
+ * ```
+ */
+export interface AssistantMode {
+    /**
+     * What this conversation is about, as a string the host can compare.
+     *
+     * **The conversation's lifetime hangs on this.** When it changes, the chat closes what is on
+     * screen and starts again — because a conversation about station 3 is not a conversation
+     * about station 7, and leaving the old one up means the user reads an answer about a screen
+     * they are no longer looking at.
+     *
+     * Hosts built this by hand before, each in their own way: plant kept a module-global registry
+     * with subscribers and re-checked the context on every send, twin closed its session when the
+     * anchor moved. Both were writing the same guard around the same absence.
+     *
+     * Include whatever makes the subject specific — `twin:space:S-12`, `plant:station:3`.
+     */
+    id: string;
+    /** Who the assistant is here, and what it must not claim to do. */
+    systemPrompt?: string;
+    /** Which tool categories the server may expose for this conversation. */
+    toolCategories?: string[];
+    /** What the host knows about the subject; travels with each request. */
+    hostContext?: any;
+    /** Which server-side chat entry point answers. */
+    chatEndpoint?: 'boardAIChat' | 'assistantChat';
+    /** What `@` offers. */
+    catalogEntries?: any[];
+    /**
+     * What `/` offers.
+     *
+     * These are sentences a person could have typed, not tool names — "이 공간의 지금 상태를
+     * 요약해줘" cannot be generated from `summarizeStatus`. But **a mode must not offer work it
+     * cannot do**: everything here should be answerable by the tools `toolCategories` opens.
+     */
+    slashTemplates?: any[];
+    /** The i18n key for the line under an empty conversation. */
+    footerNoticeKey?: string;
+    /** Follow-up chips for a proposal that arrived without its own. */
+    proposalChoices?: any[];
+    /** The i18n key for the line shown once the host reports a proposal staged. */
+    stagedNoticeKey?: string;
+}
+/** True when these two describe different conversations, so the old one should be closed. */
+export declare function isDifferentConversation(a?: AssistantMode, b?: AssistantMode): boolean;
+/** Everything a conversation needs, after the mode, the host's own properties and the
+ *  registered defaults have been reconciled. */
+export interface ConversationSettings {
+    systemPrompt?: string;
+    toolCategories?: string[];
+    hostContext?: any;
+    chatEndpoint: 'boardAIChat' | 'assistantChat';
+    catalogEntries: any[];
+    slashTemplates: any[];
+    footerNoticeKey?: string;
+    proposalChoices: any[];
+    stagedNoticeKey?: string;
+}
+/**
+ * Reconcile the three places a setting can come from.
+ *
+ * **The mode answers first, as a whole.** Then the host's own properties, then whatever was
+ * registered globally. The order matters in one direction only: a host that declares a mode
+ * must not have half of its conversation decided somewhere else, which is the failure this
+ * type exists to remove.
+ *
+ * A host that declares no mode gets exactly what it got before modes existed — its own
+ * properties, falling back to the registered defaults.
+ */
+export declare function resolveConversation(mode: AssistantMode | undefined, own: Partial<ConversationSettings>, defaults: Partial<ConversationSettings>): ConversationSettings;

package/dist-client/components/assistant-mode.js

@@ -0,0 +1,30 @@
+/** True when these two describe different conversations, so the old one should be closed. */
+export function isDifferentConversation(a, b) {
+    return (a?.id ?? '') !== (b?.id ?? '');
+}
+/**
+ * Reconcile the three places a setting can come from.
+ *
+ * **The mode answers first, as a whole.** Then the host's own properties, then whatever was
+ * registered globally. The order matters in one direction only: a host that declares a mode
+ * must not have half of its conversation decided somewhere else, which is the failure this
+ * type exists to remove.
+ *
+ * A host that declares no mode gets exactly what it got before modes existed — its own
+ * properties, falling back to the registered defaults.
+ */
+export function resolveConversation(mode, own, defaults) {
+    const pick = (key) => mode?.[key] ?? own[key] ?? defaults[key];
+    return {
+        systemPrompt: pick('systemPrompt'),
+        toolCategories: pick('toolCategories'),
+        hostContext: pick('hostContext'),
+        chatEndpoint: pick('chatEndpoint') ?? 'boardAIChat',
+        catalogEntries: pick('catalogEntries') ?? [],
+        slashTemplates: pick('slashTemplates') ?? [],
+        footerNoticeKey: pick('footerNoticeKey'),
+        proposalChoices: pick('proposalChoices') ?? [],
+        stagedNoticeKey: pick('stagedNoticeKey')
+    };
+}
+//# sourceMappingURL=assistant-mode.js.map

package/dist-client/components/assistant-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-mode.js","sourceRoot":"","sources":["../../client/components/assistant-mode.ts"],"names":[],"mappings":"AA0EA,6FAA6F;AAC7F,MAAM,UAAU,uBAAuB,CAAC,CAAiB,EAAE,CAAiB;IAC1E,OAAO,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;AACxC,CAAC;AAgBD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAA+B,EAC/B,GAAkC,EAClC,QAAuC;IAEvC,MAAM,IAAI,GAAG,CAAuC,GAAM,EAA2B,EAAE,CACpF,IAAY,EAAE,CAAC,GAAG,CAAC,IAAK,GAAW,CAAC,GAAG,CAAC,IAAK,QAAgB,CAAC,GAAG,CAAC,CAAA;IAErE,OAAO;QACL,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC;QAClC,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC;QACtC,WAAW,EAAE,IAAI,CAAC,aAAa,CAAC;QAChC,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,aAAa;QACnD,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE;QAC5C,cAAc,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE;QAC5C,eAAe,EAAE,IAAI,CAAC,iBAAiB,CAAC;QACxC,eAAe,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAC9C,eAAe,EAAE,IAAI,CAAC,iBAAiB,CAAC;KACzC,CAAA;AACH,CAAC","sourcesContent":["/**\n * A mode is what a conversation *is*: who the assistant is, what it can do, what the talk is\n * about, what it offers to start with, and when it is over.\n *\n * Those five used to be four separate properties on the chat element plus one global registry,\n * and every host wired them one at a time. Separate means they can disagree, and they did: a\n * screen whose `systemPrompt` said \"you do not edit boards here\" offered `/add-monitor` in the\n * same panel, because the prompt was a property and the slash list was global.\n *\n * So a host declares one value and hands it over. What cannot be split cannot fall out of step.\n *\n * ```ts\n * const SPACE_MODE = (spaceId: string): AssistantMode => ({\n *   id: `twin:space:${spaceId}`,\n *   systemPrompt: '...',\n *   toolCategories: ['twin'],\n *   hostContext: { spaceId },\n *   slashTemplates: TWIN_SLASH_TEMPLATES\n * })\n *\n * html`<ox-assistant-chat .mode=${SPACE_MODE(this.spaceId)}></ox-assistant-chat>`\n * ```\n */\nexport interface AssistantMode {\n  /**\n   * What this conversation is about, as a string the host can compare.\n   *\n   * **The conversation's lifetime hangs on this.** When it changes, the chat closes what is on\n   * screen and starts again — because a conversation about station 3 is not a conversation\n   * about station 7, and leaving the old one up means the user reads an answer about a screen\n   * they are no longer looking at.\n   *\n   * Hosts built this by hand before, each in their own way: plant kept a module-global registry\n   * with subscribers and re-checked the context on every send, twin closed its session when the\n   * anchor moved. Both were writing the same guard around the same absence.\n   *\n   * Include whatever makes the subject specific — `twin:space:S-12`, `plant:station:3`.\n   */\n  id: string\n\n  /** Who the assistant is here, and what it must not claim to do. */\n  systemPrompt?: string\n\n  /** Which tool categories the server may expose for this conversation. */\n  toolCategories?: string[]\n\n  /** What the host knows about the subject; travels with each request. */\n  hostContext?: any\n\n  /** Which server-side chat entry point answers. */\n  chatEndpoint?: 'boardAIChat' | 'assistantChat'\n\n  /** What `@` offers. */\n  catalogEntries?: any[]\n\n  /**\n   * What `/` offers.\n   *\n   * These are sentences a person could have typed, not tool names — \"이 공간의 지금 상태를\n   * 요약해줘\" cannot be generated from `summarizeStatus`. But **a mode must not offer work it\n   * cannot do**: everything here should be answerable by the tools `toolCategories` opens.\n   */\n  slashTemplates?: any[]\n\n  /** The i18n key for the line under an empty conversation. */\n  footerNoticeKey?: string\n\n  /** Follow-up chips for a proposal that arrived without its own. */\n  proposalChoices?: any[]\n\n  /** The i18n key for the line shown once the host reports a proposal staged. */\n  stagedNoticeKey?: string\n}\n\n/** True when these two describe different conversations, so the old one should be closed. */\nexport function isDifferentConversation(a?: AssistantMode, b?: AssistantMode): boolean {\n  return (a?.id ?? '') !== (b?.id ?? '')\n}\n\n/** Everything a conversation needs, after the mode, the host's own properties and the\n *  registered defaults have been reconciled. */\nexport interface ConversationSettings {\n  systemPrompt?: string\n  toolCategories?: string[]\n  hostContext?: any\n  chatEndpoint: 'boardAIChat' | 'assistantChat'\n  catalogEntries: any[]\n  slashTemplates: any[]\n  footerNoticeKey?: string\n  proposalChoices: any[]\n  stagedNoticeKey?: string\n}\n\n/**\n * Reconcile the three places a setting can come from.\n *\n * **The mode answers first, as a whole.** Then the host's own properties, then whatever was\n * registered globally. The order matters in one direction only: a host that declares a mode\n * must not have half of its conversation decided somewhere else, which is the failure this\n * type exists to remove.\n *\n * A host that declares no mode gets exactly what it got before modes existed — its own\n * properties, falling back to the registered defaults.\n */\nexport function resolveConversation(\n  mode: AssistantMode | undefined,\n  own: Partial<ConversationSettings>,\n  defaults: Partial<ConversationSettings>\n): ConversationSettings {\n  const pick = <K extends keyof ConversationSettings>(key: K): ConversationSettings[K] =>\n    (mode as any)?.[key] ?? (own as any)[key] ?? (defaults as any)[key]\n\n  return {\n    systemPrompt: pick('systemPrompt'),\n    toolCategories: pick('toolCategories'),\n    hostContext: pick('hostContext'),\n    chatEndpoint: pick('chatEndpoint') ?? 'boardAIChat',\n    catalogEntries: pick('catalogEntries') ?? [],\n    slashTemplates: pick('slashTemplates') ?? [],\n    footerNoticeKey: pick('footerNoticeKey'),\n    proposalChoices: pick('proposalChoices') ?? [],\n    stagedNoticeKey: pick('stagedNoticeKey')\n  }\n}\n"]}

package/dist-client/components/assistant-mode.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist-client/components/assistant-mode.test.js

@@ -0,0 +1,72 @@
+/*
+ * A mode is one value, and the point of it is that the parts of a conversation cannot
+ * disagree with each other.
+ *
+ * The defect this guards against shipped: a screen whose systemPrompt said "you do not edit
+ * boards here" offered `/add-monitor` in the same panel, because the prompt was an element
+ * property and the slash list was a module global. Any resolution that lets a mode supply one
+ * of them while something else supplies the other brings it back.
+ */
+import { isDifferentConversation, resolveConversation } from './assistant-mode';
+const MODE = {
+    id: 'twin:space:S-12',
+    systemPrompt: 'You are looking at one space. You do not edit boards here.',
+    toolCategories: ['twin'],
+    hostContext: { spaceId: 'S-12' },
+    slashTemplates: [{ name: 'status', template: '이 공간의 지금 상태를 요약해줘' }]
+};
+const HOST_PROPERTIES = {
+    systemPrompt: 'a prompt the host set the old way',
+    toolCategories: ['board-ai'],
+    hostContext: { boardId: 'B-1' },
+    chatEndpoint: 'boardAIChat'
+};
+const GLOBAL_DEFAULTS = {
+    catalogEntries: [{ type: 'rect' }],
+    slashTemplates: [{ name: 'add-monitor', template: '모니터를 추가해줘' }],
+    footerNoticeKey: 'text.previewed-on-the-board'
+};
+describe('resolveConversation', () => {
+    test('a mode answers before the host properties it overlaps', () => {
+        const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS);
+        expect(c.systemPrompt).toBe(MODE.systemPrompt);
+        expect(c.toolCategories).toEqual(['twin']);
+        expect(c.hostContext).toEqual({ spaceId: 'S-12' });
+    });
+    test('a mode answers before the global defaults — the prompt and the slash list cannot disagree', () => {
+        const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS);
+        expect(c.slashTemplates).toEqual(MODE.slashTemplates);
+        /* A mode that says it does not edit boards must not offer a board edit. */
+        expect(JSON.stringify(c.slashTemplates)).not.toContain('add-monitor');
+    });
+    test('what a mode leaves out still comes from the defaults', () => {
+        const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS);
+        expect(c.catalogEntries).toEqual(GLOBAL_DEFAULTS.catalogEntries);
+        expect(c.footerNoticeKey).toBe(GLOBAL_DEFAULTS.footerNoticeKey);
+    });
+    test('a host with no mode gets exactly what it had before modes existed', () => {
+        const c = resolveConversation(undefined, HOST_PROPERTIES, GLOBAL_DEFAULTS);
+        expect(c.systemPrompt).toBe(HOST_PROPERTIES.systemPrompt);
+        expect(c.toolCategories).toEqual(HOST_PROPERTIES.toolCategories);
+        expect(c.slashTemplates).toEqual(GLOBAL_DEFAULTS.slashTemplates);
+    });
+    test('nothing anywhere resolves to empty lists and the board endpoint, never undefined', () => {
+        const c = resolveConversation(undefined, {}, {});
+        expect(c.catalogEntries).toEqual([]);
+        expect(c.slashTemplates).toEqual([]);
+        expect(c.proposalChoices).toEqual([]);
+        expect(c.chatEndpoint).toBe('boardAIChat');
+    });
+});
+describe('isDifferentConversation', () => {
+    const station3 = { id: 'plant:station:3' };
+    test('a different subject ends the conversation', () => {
+        expect(isDifferentConversation(station3, { id: 'plant:station:7' })).toBe(true);
+        expect(isDifferentConversation(undefined, station3)).toBe(true);
+    });
+    test('rewording the same subject does not', () => {
+        expect(isDifferentConversation(station3, { ...station3, systemPrompt: 'reworded' })).toBe(false);
+        expect(isDifferentConversation(undefined, undefined)).toBe(false);
+    });
+});
+//# sourceMappingURL=assistant-mode.test.js.map

package/dist-client/components/assistant-mode.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-mode.test.js","sourceRoot":"","sources":["../../client/components/assistant-mode.test.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * A mode is one value, and the point of it is that the parts of a conversation cannot\n * disagree with each other.\n *\n * The defect this guards against shipped: a screen whose systemPrompt said \"you do not edit\n * boards here\" offered `/add-monitor` in the same panel, because the prompt was an element\n * property and the slash list was a module global. Any resolution that lets a mode supply one\n * of them while something else supplies the other brings it back.\n */\nimport { isDifferentConversation, resolveConversation, type AssistantMode } from './assistant-mode'\n\nconst MODE: AssistantMode = {\n  id: 'twin:space:S-12',\n  systemPrompt: 'You are looking at one space. You do not edit boards here.',\n  toolCategories: ['twin'],\n  hostContext: { spaceId: 'S-12' },\n  slashTemplates: [{ name: 'status', template: '이 공간의 지금 상태를 요약해줘' }]\n}\n\nconst HOST_PROPERTIES = {\n  systemPrompt: 'a prompt the host set the old way',\n  toolCategories: ['board-ai'],\n  hostContext: { boardId: 'B-1' },\n  chatEndpoint: 'boardAIChat' as const\n}\n\nconst GLOBAL_DEFAULTS = {\n  catalogEntries: [{ type: 'rect' }],\n  slashTemplates: [{ name: 'add-monitor', template: '모니터를 추가해줘' }],\n  footerNoticeKey: 'text.previewed-on-the-board'\n}\n\ndescribe('resolveConversation', () => {\n  test('a mode answers before the host properties it overlaps', () => {\n    const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS)\n    expect(c.systemPrompt).toBe(MODE.systemPrompt)\n    expect(c.toolCategories).toEqual(['twin'])\n    expect(c.hostContext).toEqual({ spaceId: 'S-12' })\n  })\n\n  test('a mode answers before the global defaults — the prompt and the slash list cannot disagree', () => {\n    const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS)\n    expect(c.slashTemplates).toEqual(MODE.slashTemplates)\n    /* A mode that says it does not edit boards must not offer a board edit. */\n    expect(JSON.stringify(c.slashTemplates)).not.toContain('add-monitor')\n  })\n\n  test('what a mode leaves out still comes from the defaults', () => {\n    const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS)\n    expect(c.catalogEntries).toEqual(GLOBAL_DEFAULTS.catalogEntries)\n    expect(c.footerNoticeKey).toBe(GLOBAL_DEFAULTS.footerNoticeKey)\n  })\n\n  test('a host with no mode gets exactly what it had before modes existed', () => {\n    const c = resolveConversation(undefined, HOST_PROPERTIES, GLOBAL_DEFAULTS)\n    expect(c.systemPrompt).toBe(HOST_PROPERTIES.systemPrompt)\n    expect(c.toolCategories).toEqual(HOST_PROPERTIES.toolCategories)\n    expect(c.slashTemplates).toEqual(GLOBAL_DEFAULTS.slashTemplates)\n  })\n\n  test('nothing anywhere resolves to empty lists and the board endpoint, never undefined', () => {\n    const c = resolveConversation(undefined, {}, {})\n    expect(c.catalogEntries).toEqual([])\n    expect(c.slashTemplates).toEqual([])\n    expect(c.proposalChoices).toEqual([])\n    expect(c.chatEndpoint).toBe('boardAIChat')\n  })\n})\n\ndescribe('isDifferentConversation', () => {\n  const station3: AssistantMode = { id: 'plant:station:3' }\n\n  test('a different subject ends the conversation', () => {\n    expect(isDifferentConversation(station3, { id: 'plant:station:7' })).toBe(true)\n    expect(isDifferentConversation(undefined, station3)).toBe(true)\n  })\n\n  test('rewording the same subject does not', () => {\n    expect(isDifferentConversation(station3, { ...station3, systemPrompt: 'reworded' })).toBe(false)\n    expect(isDifferentConversation(undefined, undefined)).toBe(false)\n  })\n})\n"]}

package/dist-client/index.d.ts

@@ -5,12 +5,12 @@
  */
 export * from './components/assistant-chat.js';
 export * from './components/chat-defaults.js';
+export * from './components/assistant-mode.js';
 export * from './components/markdown.js';
 export * from './components/chat-echo-dedup.js';
 export * from './components/chat-input-builder.js';
 export * from './components/mention-popup.js';
 export * from './components/mention-popup-helpers.js';
-export * from './utils/board-edit-patch.js';
 export * from './utils/assistant-session-controller.js';
 export * from './utils/assistant-session-transport.js';
 export * from './components/assistant-session-toolbar.js';

package/dist-client/index.js

@@ -5,12 +5,12 @@
  */
 export * from './components/assistant-chat.js';
 export * from './components/chat-defaults.js';
+export * from './components/assistant-mode.js';
 export * from './components/markdown.js';
 export * from './components/chat-echo-dedup.js';
 export * from './components/chat-input-builder.js';
 export * from './components/mention-popup.js';
 export * from './components/mention-popup-helpers.js';
-export * from './utils/board-edit-patch.js';
 export * from './utils/assistant-session-controller.js';
 export * from './utils/assistant-session-transport.js';
 export * from './components/assistant-session-toolbar.js';

package/dist-client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,gCAAgC,CAAA;AAC9C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,0BAA0B,CAAA;AACxC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,oCAAoC,CAAA;AAClD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,uCAAuC,CAAA;AACrD,cAAc,6BAA6B,CAAA;AAC3C,cAAc,yCAAyC,CAAA;AACvD,cAAc,wCAAwC,CAAA;AACtD,cAAc,2CAA2C,CAAA;AACzD,cAAc,sCAAsC,CAAA","sourcesContent":["/**\n * `@things-factory/ai-assistant` — 대화면.\n *\n * 표준 컴포넌트는 `<ox-assistant-chat>` 이다.\n */\nexport * from './components/assistant-chat.js'\nexport * from './components/chat-defaults.js'\nexport * from './components/markdown.js'\nexport * from './components/chat-echo-dedup.js'\nexport * from './components/chat-input-builder.js'\nexport * from './components/mention-popup.js'\nexport * from './components/mention-popup-helpers.js'\nexport * from './utils/board-edit-patch.js'\nexport * from './utils/assistant-session-controller.js'\nexport * from './utils/assistant-session-transport.js'\nexport * from './components/assistant-session-toolbar.js'\nexport * from './utils/assistant-request-context.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,gCAAgC,CAAA;AAC9C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,0BAA0B,CAAA;AACxC,cAAc,iCAAiC,CAAA;AAC/C,cAAc,oCAAoC,CAAA;AAClD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,uCAAuC,CAAA;AACrD,cAAc,yCAAyC,CAAA;AACvD,cAAc,wCAAwC,CAAA;AACtD,cAAc,2CAA2C,CAAA;AACzD,cAAc,sCAAsC,CAAA","sourcesContent":["/**\n * `@things-factory/ai-assistant` — 대화면.\n *\n * 표준 컴포넌트는 `<ox-assistant-chat>` 이다.\n */\nexport * from './components/assistant-chat.js'\nexport * from './components/chat-defaults.js'\nexport * from './components/assistant-mode.js'\nexport * from './components/markdown.js'\nexport * from './components/chat-echo-dedup.js'\nexport * from './components/chat-input-builder.js'\nexport * from './components/mention-popup.js'\nexport * from './components/mention-popup-helpers.js'\nexport * from './utils/assistant-session-controller.js'\nexport * from './utils/assistant-session-transport.js'\nexport * from './components/assistant-session-toolbar.js'\nexport * from './utils/assistant-request-context.js'\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/ai-assistant",
-  "version": "10.1.20",
+  "version": "10.1.25",
   "main": "dist-server/index.js",
   "things-factory": true,
   "author": "heartyoh",
@@ -29,8 +29,8 @@
     "@operato/graphql": "^10.0.0",
     "@operato/i18n": "^10.0.0",
     "@operato/styles": "^10.0.0",
-    "@things-factory/ai-client-base": "^10.1.20",
-    "@things-factory/auth-base": "^10.1.20",
+    "@things-factory/ai-client-base": "^10.1.25",
+    "@things-factory/auth-base": "^10.1.24",
     "@things-factory/env": "^10.1.20",
     "@things-factory/shell": "^10.1.20",
     "dompurify": "^3.0.0",
@@ -43,6 +43,5 @@
   "devDependencies": {
     "copyfiles": "^2.4.1",
     "rimraf": "^5.0.0"
-  },
-  "gitHead": "6bd01660a4b28554bbe6ae4ee58f3ff844c5af69"
+  }
 }

package/client/utils/board-edit-patch.ts

@@ -1,374 +0,0 @@
-/**
- * Client-side BoardEditPatch types + applier.
- *
- * NOTE: 동일 정의가 server/service/types.ts + apply-patch.ts 에 있음.
- * client 번들이 server 코드를 import 하지 않도록 분리. 변경 시 양쪽 동기화 필요.
- */
-
-/**
- * 컴포넌트 타깃팅은 항상 `refid` (things-scene universal numeric handle).
- * `id` 는 데이터 바인딩 이름이며 unique 가 아니므로 targeting 에 사용하지 않는다.
- *
- * 보드는 최상위 부모 — 자체 속성 (fillStyle / width / height / name 등) 을 갖고,
- * `modifyBoard` 로 변경. 자식 컴포넌트 변경 (`modify`) 와 분리.
- *
- * Phase 2 — Scene 조작 op (align/distribute/group/ungroup/zorder). model 차원
- * 시뮬레이션은 noop 이고 things-scene API 가 정본.
- */
-export type AlignDirection =
-  | 'left'
-  | 'right'
-  | 'center'
-  | 'top'
-  | 'middle'
-  | 'bottom'
-
-export type DistributeAxis = 'horizontal' | 'vertical'
-
-export type ZorderDirection = 'front' | 'back' | 'forward' | 'backward'
-
-/**
- * Sugar layout — `arrange` op 의 layout 종류.
- * Server-side types.ts 의 ArrangeLayout 와 일치 — drift test 가 검증.
- */
-export type ArrangeLayout =
-  | { type: 'grid'; cols: number; gap?: number; anchor?: { left: number; top: number } }
-  | {
-      type: 'row'
-      gap?: number
-      anchor?: { left: number; top: number }
-      align?: 'start' | 'center' | 'end'
-    }
-  | {
-      type: 'column'
-      gap?: number
-      anchor?: { left: number; top: number }
-      align?: 'start' | 'center' | 'end'
-    }
-
-export type BoardEditOp =
-  | { op: 'add'; component: any }
-  | { op: 'remove'; refid: number }
-  | { op: 'modify'; refid: number; patch: any }
-  | { op: 'modifyBoard'; patch: any }
-  | { op: 'replace'; board: any }
-  | { op: 'align'; refids: number[]; direction: AlignDirection }
-  | { op: 'distribute'; refids: number[]; axis: DistributeAxis }
-  | { op: 'group'; refids: number[] }
-  | { op: 'ungroup'; refid: number }
-  | { op: 'zorder'; refid: number; direction: ZorderDirection }
-  | { op: 'arrange'; refids: number[]; layout: ArrangeLayout }
-
-/**
- * C-1 — Scene 조작 action (ephemeral). 모델 변경 X, undo 영향 X.
- * 호스트가 board-action-execute 이벤트로 받아서 things-scene API 직접 호출.
- */
-export type BoardActionOp =
-  | { action: 'selectComponents'; refids: number[] }
-  | { action: 'centerToComponent'; refid: number; animated?: boolean }
-  | { action: 'fitToView'; mode?: 'fit' | 'ratio' | 'width' | 'height' }
-  | { action: 'setSceneMode'; mode: 'edit' | 'view' }
-  | { action: 'highlightComponents'; refids: number[] }
-
-export interface BoardEditPatch {
-  ops: BoardEditOp[]
-  summary: string
-  confidence: number
-}
-
-export interface PatchApplyReport {
-  /** 패치 적용 후 보드. 모든 op 가 noop 이어도 입력 그대로 반환. */
-  board: any
-  /** 실제로 보드를 바꾼 op 들. */
-  applied: BoardEditOp[]
-  /** id 매칭 실패 등으로 noop 이 된 op 들 — 호출자가 사용자에게 알릴 단서. */
-  missed: BoardEditOp[]
-}
-
-const EMPTY_BOARD = { width: 1000, height: 600, components: [] as any[] }
-
-/**
- * Patch 를 BoardModel 에 적용 (pure, board 를 mutate 하지 않음).
- */
-export function applyBoardEditPatch(board: any | undefined, patch: BoardEditPatch): any {
-  return applyBoardEditPatchVerbose(board, patch).board
-}
-
-/**
- * Verbose 변형 — 각 op 의 적용 여부를 보고.
- *
- * `modify` 와 `remove` 는 id 가 보드에 없으면 silent no-op 이 된다. LLM 이 잘못된
- * id 를 만들어 보내면 사용자에게 "수정했습니다" 라고 답하지만 실제로는 아무 변화도
- * 없는 상황이 발생 — 호스트가 missed 를 보고 사용자에게 경고할 수 있도록 별도
- * entry point 제공.
- */
-export function applyBoardEditPatchVerbose(
-  board: any | undefined,
-  patch: BoardEditPatch
-): PatchApplyReport {
-  let result: any = board ?? EMPTY_BOARD
-  const applied: BoardEditOp[] = []
-  const missed: BoardEditOp[] = []
-
-  for (const op of patch.ops) {
-    if (SCENE_ONLY_OPS.has(op.op)) {
-      // scene-only — model 차원 noop, scene 차원 적용. applied 분류.
-      applied.push(op)
-      continue
-    }
-    const next = applyOp(result, op)
-    // componentsUnchanged 는 components 배열 동일 + width/height/fillStyle 동일 만 본다.
-    // modify / remove 의 silent no-op (ghost refid) 검출 전용 — modifyBoard 가 sky
-    // 등 다른 root 키만 바꿀 때 false negative 로 missed 분류되는 회귀 방지.
-    const componentMutating = op.op === 'modify' || op.op === 'remove'
-    if (next === result || (componentMutating && componentsUnchanged(result, next))) {
-      missed.push(op)
-    } else {
-      applied.push(op)
-      result = next
-    }
-  }
-
-  return { board: result, applied, missed }
-}
-
-function componentsUnchanged(prev: any, next: any): boolean {
-  // applyOp 는 항상 새 객체를 만든다. 따라서 reference 비교가 안 되고 내용 비교 필요.
-  // components 는 map/filter 결과 reference 도 다를 수 있으므로 length + 요소 ref 비교.
-  const a = prev.components ?? []
-  const b = next.components ?? []
-  if (a.length !== b.length) return false
-  for (let i = 0; i < a.length; i++) {
-    if (a[i] !== b[i]) return false
-  }
-  return prev.width === next.width && prev.height === next.height && prev.fillStyle === next.fillStyle
-}
-
-const SCENE_ONLY_OPS = new Set<BoardEditOp['op']>([
-  'align',
-  'distribute',
-  'group',
-  'ungroup',
-  'zorder',
-  'arrange'
-])
-
-function applyOp(board: any, op: BoardEditOp): any {
-  switch (op.op) {
-    case 'replace':
-      return op.board
-    case 'add':
-      return { ...board, components: [...(board.components || []), op.component] }
-    case 'remove':
-      // 자식 (group/container 안) refid 도 매칭 — deep search.
-      return {
-        ...board,
-        components: removeComponentDeep(board.components || [], op.refid)
-      }
-    case 'modify':
-      // 자식 refid 도 매칭 — group/container 안의 컴포넌트 수정 가능.
-      return {
-        ...board,
-        components: modifyComponentDeep(board.components || [], op.refid, op.patch)
-      }
-    case 'modifyBoard': {
-      const patch = { ...(op.patch || {}) }
-      delete patch.components // 자식 변경은 별도 op
-      return mergeComponent(board, patch) // 최상위 board 자체에 deep-merge
-    }
-    case 'align':
-    case 'distribute':
-    case 'group':
-    case 'ungroup':
-    case 'zorder':
-    case 'arrange':
-      // scene-only — model 차원 noop. things-scene API 가 정본.
-      return board
-    default:
-      return board
-  }
-}
-
-/**
- * 주어진 board 상태에서 op 의 inverse 를 계산.
- *
- * Revert 기능 — patch 적용 직전 board + op 로 역연산을 만든다. 호스트가
- * 누적해두면 나중에 역순 실행만으로 복원.
- *
- * add 의 inverse 는 새로 발급될 refid 를 알아야 → 모델 단계에서 계산 불가.
- * 호스트가 scene.add 직후 refid 를 캡처해 직접 만들 것.
- */
-export function computeInverseOp(board: any, op: BoardEditOp): BoardEditOp | null {
-  if (!board) return null
-  const components = board.components ?? []
-
-  switch (op.op) {
-    case 'add':
-      return null
-
-    case 'remove': {
-      // 자식 refid 도 매칭 (deep search)
-      const target = findComponentDeep(components, op.refid)
-      if (!target) return null
-      return { op: 'add', component: JSON.parse(JSON.stringify(target)) }
-    }
-
-    case 'modify': {
-      // 자식 refid 도 매칭 (deep search)
-      const target = findComponentDeep(components, op.refid)
-      if (!target) return null
-      const oldValues: any = {}
-      for (const k of Object.keys(op.patch || {})) {
-        const v = (target as any)[k]
-        oldValues[k] = v === undefined ? null : JSON.parse(JSON.stringify(v))
-      }
-      return { op: 'modify', refid: op.refid, patch: oldValues }
-    }
-
-    case 'modifyBoard': {
-      const oldValues: any = {}
-      const patch = op.patch || {}
-      for (const k of Object.keys(patch)) {
-        if (k === 'components') continue
-        const v = (board as any)[k]
-        oldValues[k] = v === undefined ? null : JSON.parse(JSON.stringify(v))
-      }
-      return { op: 'modifyBoard', patch: oldValues }
-    }
-
-    case 'replace':
-      return { op: 'replace', board: JSON.parse(JSON.stringify(board)) }
-
-    case 'zorder': {
-      // forward ↔ backward / front ↔ back. front/back 의 inverse 는 정확하지
-      // 않을 수 있음 (best-effort) — 정확 inverse 는 호스트가 zorder 직전 index
-      // 를 캡처해서 명시 modify 시퀀스로 만들어야.
-      const opp: Record<string, 'front' | 'back' | 'forward' | 'backward'> = {
-        forward: 'backward',
-        backward: 'forward',
-        front: 'back',
-        back: 'front'
-      }
-      const dir = opp[op.direction]
-      if (!dir) return null
-      return { op: 'zorder', refid: op.refid, direction: dir }
-    }
-
-    case 'align':
-    case 'distribute':
-    case 'group':
-    case 'ungroup':
-    case 'arrange':
-      // scene 호출 후에야 변경 결과 알 수 있음. 호스트가 직접 inverse 만든다.
-      return null
-
-    default:
-      return null
-  }
-}
-
-/**
- * 컴포넌트에 부분 patch 를 적용 (deep merge).
- * threeD 등 nested object 는 deep merge — 색만 바꾸려고 했을 때 geometry 까지 사라지지 않도록.
- *
- * patch 내 `null` 의 시맨틱 — **"이 키를 제거하라"**:
- *   - fillStyle/strokeStyle 처럼 `string | object | undefined` 인 필드는 null 로
- *     set 하면 typeof null === 'object' 함정에 빠져 다운스트림 (3D 텍스처 등) 이 크래시.
- *   - computeInverseOp 가 base 에 키가 없던 (`undefined`) 경우 inverse 를 null 로
- *     발급하므로, 이 시맨틱과 정확히 일치 — inverse 가 자연스럽게 올바로 동작.
- *
- * host (board-modeller-page) 에서 things-scene 의 component.set(merged) 호출 전에 사용.
- */
-export function mergeComponent(base: any, patch: any): any {
-  const out: any = { ...base }
-  for (const key of Object.keys(patch)) {
-    const patchVal = patch[key]
-    if (patchVal === null) {
-      delete out[key]
-    } else if (isPlainObject(base[key]) && isPlainObject(patchVal)) {
-      out[key] = deepMerge(base[key], patchVal)
-    } else {
-      out[key] = patchVal
-    }
-  }
-  return out
-}
-
-function deepMerge(a: any, b: any): any {
-  const out: any = { ...a }
-  for (const key of Object.keys(b)) {
-    const bv = b[key]
-    if (bv === null) {
-      delete out[key]
-    } else if (isPlainObject(a[key]) && isPlainObject(bv)) {
-      out[key] = deepMerge(a[key], bv)
-    } else {
-      out[key] = bv
-    }
-  }
-  return out
-}
-
-function isPlainObject(v: any): boolean {
-  return v !== null && typeof v === 'object' && !Array.isArray(v)
-}
-
-// ── 자식 컴포넌트 (group/container 안) 까지 매칭 — deep search ─
-// server/service/apply-patch.ts 와 동일 로직. drift test 가 동등성 보장.
-
-function findComponentDeep(components: any[], refid: number): any | undefined {
-  for (const c of components) {
-    if (!c) continue
-    if (c.refid === refid) return c
-    if (Array.isArray(c.components) && c.components.length > 0) {
-      const sub = findComponentDeep(c.components, refid)
-      if (sub) return sub
-    }
-  }
-  return undefined
-}
-
-function modifyComponentDeep(components: any[], refid: number, patch: any): any[] {
-  let changed = false
-  const out = components.map(c => {
-    if (!c) return c
-    if (c.refid === refid) {
-      changed = true
-      return mergeComponent(c, patch)
-    }
-    if (Array.isArray(c.components) && c.components.length > 0) {
-      const updated = modifyComponentDeep(c.components, refid, patch)
-      if (updated !== c.components) {
-        changed = true
-        return { ...c, components: updated }
-      }
-    }
-    return c
-  })
-  return changed ? out : components
-}
-
-function removeComponentDeep(components: any[], refid: number): any[] {
-  let changed = false
-  const out: any[] = []
-  for (const c of components) {
-    if (!c) {
-      out.push(c)
-      continue
-    }
-    if (c.refid === refid) {
-      changed = true
-      continue
-    }
-    if (Array.isArray(c.components) && c.components.length > 0) {
-      const updated = removeComponentDeep(c.components, refid)
-      if (updated !== c.components) {
-        changed = true
-        out.push({ ...c, components: updated })
-        continue
-      }
-    }
-    out.push(c)
-  }
-  return changed ? out : components
-}