@things-factory/ai-assistant 10.1.24 → 10.1.26

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

@@ -0,0 +1,97 @@
+/**
+ * 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 places a setting can come from.
+ *
+ * **A host that declares a mode gets the mode and nothing else.** A field the mode leaves out is
+ * empty: it is not filled from the element's own properties, and it is not filled from the
+ * defaults another package registered. Filling it back in is how the defect this type removes
+ * returned — board-ai registers board authoring's `/add-monitor`, its component `@` catalog and
+ * its "previewed on the board" line globally, and plant's factory mode, which declares no slash
+ * list, offered them on a factory screen once the board modeller had been loaded. A mode that
+ * wants those declares them.
+ *
+ * A host that declares no mode gets exactly what it got before modes existed — its own
+ * properties, falling back to the registered defaults.
+ *
+ * `chatEndpoint` still falls back to `boardAIChat` when nothing names one; that default is a
+ * separate question (standard A2).
+ */
+export declare function resolveConversation(mode: AssistantMode | undefined, own: Partial<ConversationSettings>, defaults: Partial<ConversationSettings>): ConversationSettings;

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

@@ -0,0 +1,36 @@
+/** 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 places a setting can come from.
+ *
+ * **A host that declares a mode gets the mode and nothing else.** A field the mode leaves out is
+ * empty: it is not filled from the element's own properties, and it is not filled from the
+ * defaults another package registered. Filling it back in is how the defect this type removes
+ * returned — board-ai registers board authoring's `/add-monitor`, its component `@` catalog and
+ * its "previewed on the board" line globally, and plant's factory mode, which declares no slash
+ * list, offered them on a factory screen once the board modeller had been loaded. A mode that
+ * wants those declares them.
+ *
+ * A host that declares no mode gets exactly what it got before modes existed — its own
+ * properties, falling back to the registered defaults.
+ *
+ * `chatEndpoint` still falls back to `boardAIChat` when nothing names one; that default is a
+ * separate question (standard A2).
+ */
+export function resolveConversation(mode, own, defaults) {
+    const pick = (key) => mode ? 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;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAA+B,EAC/B,GAAkC,EAClC,QAAuC;IAEvC,MAAM,IAAI,GAAG,CAAuC,GAAM,EAA2B,EAAE,CACrF,IAAI,CAAC,CAAC,CAAE,IAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,GAAW,CAAC,GAAG,CAAC,IAAK,QAAgB,CAAC,GAAG,CAAC,CAAC,CAAA;IAE3E,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 places a setting can come from.\n *\n * **A host that declares a mode gets the mode and nothing else.** A field the mode leaves out is\n * empty: it is not filled from the element's own properties, and it is not filled from the\n * defaults another package registered. Filling it back in is how the defect this type removes\n * returned — board-ai registers board authoring's `/add-monitor`, its component `@` catalog and\n * its \"previewed on the board\" line globally, and plant's factory mode, which declares no slash\n * list, offered them on a factory screen once the board modeller had been loaded. A mode that\n * wants those declares them.\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 *\n * `chatEndpoint` still falls back to `boardAIChat` when nothing names one; that default is a\n * separate question (standard A2).\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 ? (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,85 @@
+/*
+ * 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 stays out — the defaults another package registered do not fill it', () => {
+        const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS);
+        /* The board's `@` catalog and its "previewed on the board" line belong to board authoring. */
+        expect(c.catalogEntries).toEqual([]);
+        expect(c.footerNoticeKey).toBeUndefined();
+    });
+    test('★ a mode that declares no slash list offers none, even when a board package registered its own', () => {
+        /* plant's factory mode declares no `slashTemplates`; board-ai registers `/add-monitor` globally. */
+        const { slashTemplates, ...withoutSlash } = MODE;
+        const c = resolveConversation({ ...withoutSlash, id: 'plant:factory:D-1' }, HOST_PROPERTIES, GLOBAL_DEFAULTS);
+        expect(c.slashTemplates).toEqual([]);
+    });
+    test('★ a mode that leaves out a field the host also set as a property does not take the property either', () => {
+        const c = resolveConversation({ id: 'twin:none' }, HOST_PROPERTIES, GLOBAL_DEFAULTS);
+        expect(c.systemPrompt).toBeUndefined();
+        expect(c.toolCategories).toBeUndefined();
+        expect(c.hostContext).toBeUndefined();
+    });
+    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 stays out — the defaults another package registered do not fill it', () => {\n    const c = resolveConversation(MODE, HOST_PROPERTIES, GLOBAL_DEFAULTS)\n    /* The board's `@` catalog and its \"previewed on the board\" line belong to board authoring. */\n    expect(c.catalogEntries).toEqual([])\n    expect(c.footerNoticeKey).toBeUndefined()\n  })\n\n  test('★ a mode that declares no slash list offers none, even when a board package registered its own', () => {\n    /* plant's factory mode declares no `slashTemplates`; board-ai registers `/add-monitor` globally. */\n    const { slashTemplates, ...withoutSlash } = MODE\n    const c = resolveConversation({ ...withoutSlash, id: 'plant:factory:D-1' }, HOST_PROPERTIES, GLOBAL_DEFAULTS)\n    expect(c.slashTemplates).toEqual([])\n  })\n\n  test('★ a mode that leaves out a field the host also set as a property does not take the property either', () => {\n    const c = resolveConversation({ id: 'twin:none' }, HOST_PROPERTIES, GLOBAL_DEFAULTS)\n    expect(c.systemPrompt).toBeUndefined()\n    expect(c.toolCategories).toBeUndefined()\n    expect(c.hostContext).toBeUndefined()\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"]}