@things-factory/ai-assistant 10.1.26 → 10.1.28

package/dist-client/utils/assistant-session-controller.d.ts

@@ -12,6 +12,14 @@ export interface AssistantSessionTransport {
     list(target: AssistantSessionTarget): Promise<AssistantSession[]>;
     create(target: AssistantSessionTarget): Promise<AssistantSession>;
     isEmpty?(sessionId: string): Promise<boolean>;
+    /**
+     * 이 대화를 여기까지 읽었다 — 열린 대화가 바뀔 때 한 번.
+     *
+     * 읽은 지점은 **다른 참여자에게 보이는 사실**이다(안 읽음 배지 · 목록의 굵은 글씨). 도크마다 손으로
+     * 부르던 것을 여기로 올렸다 — twin 만 부르고 있었고, 멘션으로 사람이 들어올 수 있게 된 뒤에는
+     * 세 화면이 같은 사실을 달리 말하게 된다.
+     */
+    markRead?(sessionId: string): Promise<void> | void;
 }
 export interface AssistantSessionState {
     target?: AssistantSessionTarget;
@@ -39,6 +47,8 @@ export declare class AssistantSessionController {
     private remember;
     private preference;
     private publish;
+    /** 실패는 삼킨다 — 읽음 표시가 못 가는 것이 대화를 막을 이유는 아니다. */
+    private markRead;
     open(target?: AssistantSessionTarget, force?: boolean): Promise<void>;
     select(id: string): boolean;
     reset(): Promise<void>;

package/dist-client/utils/assistant-session-controller.js

@@ -28,9 +28,25 @@ export class AssistantSessionController {
         }
     }
     publish(patch) {
+        const before = this.state.sessionId;
         this.state = { ...this.state, ...patch };
+        /*
+         * 열린 대화가 바뀌면 읽음 지점을 옮긴다. 한 자리에서 하는 이유는 여는 길이 넷이기 때문이다
+         * (열기 · 고르기 · 새로 시작 · 보내며 만들기) — 갈래마다 부르면 한 곳이 빠진다.
+         */
+        if (this.state.sessionId && this.state.sessionId !== before)
+            void this.markRead(this.state.sessionId);
         this.changed(this.state);
     }
+    /** 실패는 삼킨다 — 읽음 표시가 못 가는 것이 대화를 막을 이유는 아니다. */
+    async markRead(sessionId) {
+        try {
+            await this.transport.markRead?.(sessionId);
+        }
+        catch {
+            /* noop */
+        }
+    }
     async open(target, force = false) {
         const key = keyOf(target);
         if (!force && key === keyOf(this.state.target) && (this.state.loading || this.state.sessionId || (this.lazy && this.state.target && !this.state.error)))

package/dist-client/utils/assistant-session-controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-session-controller.js","sourceRoot":"","sources":["../../client/utils/assistant-session-controller.ts"],"names":[],"mappings":"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","sourcesContent":["export interface AssistantSession { id: string; name?: string }\nexport interface AssistantSessionTarget {\n  /** Account/domain boundary supplied by the authenticated host. */\n  scope: string\n  anchorType: string\n  anchorId: string\n}\nexport interface AssistantSessionTransport {\n  list(target: AssistantSessionTarget): Promise<AssistantSession[]>\n  create(target: AssistantSessionTarget): Promise<AssistantSession>\n  isEmpty?(sessionId: string): Promise<boolean>\n}\nexport interface AssistantSessionState {\n  target?: AssistantSessionTarget\n  sessions: AssistantSession[]\n  sessionId: string\n  loading: boolean\n  error: string\n  /** Changes on reset, including temporary conversations without a server ID. */\n  revision: number\n}\nconst keyOf = (target?: AssistantSessionTarget) => target\n  ? JSON.stringify([target.scope, target.anchorType, target.anchorId]) : ''\n\n/** Domain-neutral session lifecycle. Never deletes history or edits host documents. */\nexport class AssistantSessionController {\n  state: AssistantSessionState = { sessions: [], sessionId: '', loading: false, error: '', revision: 0 }\n  private generation = 0\n  private preferred = new Map<string, string>()\n  private pending = new Map<string, Promise<AssistantSession[]>>()\n\n  private transport: AssistantSessionTransport\n  private changed: (state: AssistantSessionState) => void\n  private storage?: Pick<Storage, 'getItem' | 'setItem'>\n  private lazy: boolean\n  private preparing?: Promise<string | undefined>\n  constructor(transport: AssistantSessionTransport, changed: (state: AssistantSessionState) => void,\n    storage?: Pick<Storage, 'getItem' | 'setItem'>, options: { lazy?: boolean } = {}) {\n    this.transport = transport\n    this.changed = changed\n    this.storage = storage\n    this.lazy = !!options.lazy\n  }\n\n  private remember(key: string, id: string) {\n    this.preferred.set(key, id)\n    try { this.storage?.setItem('assistant-session:' + key, id) } catch { /* Storage is optional. */ }\n  }\n\n  private preference(key: string): string | undefined {\n    try { return this.preferred.get(key) || this.storage?.getItem('assistant-session:' + key) || undefined }\n    catch { return this.preferred.get(key) }\n  }\n\n  private publish(patch: Partial<AssistantSessionState>) {\n    this.state = { ...this.state, ...patch }\n    this.changed(this.state)\n  }\n\n  async open(target?: AssistantSessionTarget, force = false): Promise<void> {\n    const key = keyOf(target)\n    if (!force && key === keyOf(this.state.target) && (this.state.loading || this.state.sessionId || (this.lazy && this.state.target && !this.state.error))) return\n    const generation = ++this.generation\n    const snapshot = target ? { ...target } : undefined\n    this.publish({ target: snapshot, sessions: [], sessionId: '', loading: !!target, error: '' })\n    if (!snapshot) return\n    try {\n      let pending = this.pending.get(key)\n      if (!pending) {\n        pending = (async () => {\n          const sessions = await this.transport.list(snapshot)\n          // Failed/malformed reads must not create replacement sessions.\n          if (!Array.isArray(sessions) || sessions.some(session => !session.id)) throw new Error('Invalid session list')\n          if (sessions.length || this.lazy) return [...sessions]\n          // Do not issue a mutation for a target abandoned while the inbox was loading.\n          if (keyOf(this.state.target) !== key || this.pending.get(key) !== pending) throw new Error('Session target changed')\n          const created = await this.transport.create(snapshot)\n          if (!created?.id) throw new Error('Invalid new session')\n          return [created]\n        })()\n        this.pending.set(key, pending)\n        void pending.finally(() => {\n          if (this.pending.get(key) === pending) this.pending.delete(key)\n        }).catch(() => {})\n      }\n      const sessions = await pending\n      if (generation !== this.generation) return\n      const preference = this.preference(key)\n      const sessionId = this.lazy && preference === '__draft__' ? '' : sessions.find(session => session.id === preference)?.id || sessions[0]?.id || ''\n      this.remember(key, sessionId || '__draft__')\n      this.publish({ sessions, sessionId, loading: false })\n    } catch (error) {\n      if (generation === this.generation) this.publish({ loading: false, error: error instanceof Error ? error.message : String(error) })\n    }\n  }\n\n  select(id: string): boolean {\n    if (this.state.loading || !this.state.sessions.some(session => session.id === id)) return false\n    this.remember(keyOf(this.state.target), id)\n    this.publish({ sessionId: id, error: '' })\n    return true\n  }\n\n  async reset(): Promise<void> {\n    if (this.state.loading || this.preparing) return\n    if (this.lazy) {\n      if (!this.state.sessionId) return\n      ++this.generation\n      this.remember(keyOf(this.state.target), '__draft__')\n      this.publish({ sessionId: '', error: '', revision: this.state.revision + 1 })\n      return\n    }\n    const target = this.state.target\n    if (!target) {\n      this.publish({ sessions: [], sessionId: '', error: '', revision: this.state.revision + 1 })\n      return\n    }\n    const generation = ++this.generation\n    const key = keyOf(target)\n    this.publish({ loading: true, error: '' })\n    try {\n      if (this.state.sessionId && this.transport.isEmpty) {\n        const empty = await this.transport.isEmpty(this.state.sessionId)\n        if (generation !== this.generation) return\n        if (empty) { this.publish({ loading: false }); return }\n      }\n      const session = await this.transport.create({ ...target })\n      if (!session?.id) throw new Error('Invalid new session')\n      this.remember(key, session.id)\n      if (generation !== this.generation) return\n      this.publish({ sessions: [session, ...this.state.sessions.filter(existing => existing.id !== session.id)], sessionId: session.id,\n        loading: false, revision: this.state.revision + 1 })\n    } catch (error) {\n      if (generation === this.generation) this.publish({ loading: false, error: error instanceof Error ? error.message : String(error) })\n    }\n  }\n\n  /** Called only for a real send. Adoption happens before hosts render the new ID. */\n  prepareSession(adopt: (id: string) => void = () => {}): Promise<string | undefined> {\n    if (this.state.sessionId) return Promise.resolve(this.state.sessionId)\n    if (!this.state.target) return Promise.resolve(undefined)\n    if (this.state.loading || this.state.error) return Promise.reject(new Error('Session history is not ready'))\n    if (this.preparing) return this.preparing\n    const target = { ...this.state.target }, generation = this.generation\n    const pending = (async () => {\n      const session = await this.transport.create(target)\n      if (generation !== this.generation) throw new Error('Session target changed')\n      if (!session?.id) throw new Error('Invalid new session')\n      adopt(session.id)\n      this.remember(keyOf(target), session.id)\n      this.publish({ sessionId: session.id, sessions: [session, ...this.state.sessions] })\n      return session.id\n    })()\n    this.preparing = pending\n    void pending.finally(() => { if (this.preparing === pending) this.preparing = undefined }).catch(() => {})\n    return pending\n  }\n\n  /** Invalidate pending UI updates at logout/disposal. Server authorization remains authoritative. */\n  clear() {\n    ++this.generation\n    this.preferred.clear()\n    this.pending.clear()\n    this.publish({ target: undefined, sessions: [], sessionId: '', loading: false, error: '', revision: this.state.revision + 1 })\n  }\n}\n"]}
+{"version":3,"file":"assistant-session-controller.js","sourceRoot":"","sources":["../../client/utils/assistant-session-controller.ts"],"names":[],"mappings":"AA6BA,MAAM,KAAK,GAAG,CAAC,MAA+B,EAAE,EAAE,CAAC,MAAM;IACvD,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAE3E,uFAAuF;AACvF,MAAM,OAAO,0BAA0B;IAWrC,YAAY,SAAoC,EAAE,OAA+C,EAC/F,OAA8C,EAAE,UAA8B,EAAE;QAXlF,UAAK,GAA0B,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAA;QAC9F,eAAU,GAAG,CAAC,CAAA;QACd,cAAS,GAAG,IAAI,GAAG,EAAkB,CAAA;QACrC,YAAO,GAAG,IAAI,GAAG,EAAuC,CAAA;QAS9D,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAA;IAC5B,CAAC;IAEO,QAAQ,CAAC,GAAW,EAAE,EAAU;QACtC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAA;QAC3B,IAAI,CAAC;YAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,GAAG,GAAG,EAAE,EAAE,CAAC,CAAA;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,0BAA0B,CAAC,CAAC;IACpG,CAAC;IAEO,UAAU,CAAC,GAAW;QAC5B,IAAI,CAAC;YAAC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,oBAAoB,GAAG,GAAG,CAAC,IAAI,SAAS,CAAA;QAAC,CAAC;QACxG,MAAM,CAAC;YAAC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAAC,CAAC;IAC1C,CAAC;IAEO,OAAO,CAAC,KAAqC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAA;QACnC,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAA;QACxC;;;WAGG;QACH,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,MAAM;YAAE,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACrG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC1B,CAAC;IAED,+CAA+C;IACvC,KAAK,CAAC,QAAQ,CAAC,SAAiB;QACtC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC,CAAA;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,UAAU;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAA+B,EAAE,KAAK,GAAG,KAAK;QACvD,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;QACzB,IAAI,CAAC,KAAK,IAAI,GAAG,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAAE,OAAM;QAC/J,MAAM,UAAU,GAAG,EAAE,IAAI,CAAC,UAAU,CAAA;QACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;QACnD,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;QAC7F,IAAI,CAAC,QAAQ;YAAE,OAAM;QACrB,IAAI,CAAC;YACH,IAAI,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACnC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;oBACpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;oBACpD,+DAA+D;oBAC/D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;wBAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;oBAC9G,IAAI,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI;wBAAE,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAA;oBACtD,8EAA8E;oBAC9E,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO;wBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;oBACpH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;oBACrD,IAAI,CAAC,OAAO,EAAE,EAAE;wBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAA;oBACxD,OAAO,CAAC,OAAO,CAAC,CAAA;gBAClB,CAAC,CAAC,EAAE,CAAA;gBACJ,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;gBAC9B,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE;oBACxB,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO;wBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;gBACjE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;YACpB,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAA;YAC9B,IAAI,UAAU,KAAK,IAAI,CAAC,UAAU;gBAAE,OAAM;YAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;YACvC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,IAAI,UAAU,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,UAAU,CAAC,EAAE,EAAE,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAA;YACjJ,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,IAAI,WAAW,CAAC,CAAA;YAC5C,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAA;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,UAAU,KAAK,IAAI,CAAC,UAAU;gBAAE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACrI,CAAC;IACH,CAAC;IAED,MAAM,CAAC,EAAU;QACf,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC;YAAE,OAAO,KAAK,CAAA;QAC/F,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAA;QAC3C,IAAI,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;QAC1C,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS;YAAE,OAAM;QAChD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS;gBAAE,OAAM;YACjC,EAAE,IAAI,CAAC,UAAU,CAAA;YACjB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAA;YACpD,IAAI,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC,CAAA;YAC7E,OAAM;QACR,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;QAChC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC,CAAA;YAC3F,OAAM;QACR,CAAC;QACD,MAAM,UAAU,GAAG,EAAE,IAAI,CAAC,UAAU,CAAA;QACpC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAA;QACzB,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;QAC1C,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;gBACnD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;gBAChE,IAAI,UAAU,KAAK,IAAI,CAAC,UAAU;oBAAE,OAAM;gBAC1C,IAAI,KAAK,EAAE,CAAC;oBAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;oBAAC,OAAM;gBAAC,CAAC;YACzD,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAA;YAC1D,IAAI,CAAC,OAAO,EAAE,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAA;YACxD,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;YAC9B,IAAI,UAAU,KAAK,IAAI,CAAC,UAAU;gBAAE,OAAM;YAC1C,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE;gBAC9H,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC,CAAA;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,UAAU,KAAK,IAAI,CAAC,UAAU;gBAAE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACrI,CAAC;IACH,CAAC;IAED,oFAAoF;IACpF,cAAc,CAAC,QAA8B,GAAG,EAAE,GAAE,CAAC;QACnD,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;QACtE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;QACzD,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC,CAAA;QAC5G,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,SAAS,CAAA;QACzC,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;QACrE,MAAM,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;YAC1B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;YACnD,IAAI,UAAU,KAAK,IAAI,CAAC,UAAU;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;YAC7E,IAAI,CAAC,OAAO,EAAE,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAA;YACxD,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;YACjB,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,CAAC,CAAA;YACxC,IAAI,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;YACpF,OAAO,OAAO,CAAC,EAAE,CAAA;QACnB,CAAC,CAAC,EAAE,CAAA;QACJ,IAAI,CAAC,SAAS,GAAG,OAAO,CAAA;QACxB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,SAAS,KAAK,OAAO;YAAE,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAC1G,OAAO,OAAO,CAAA;IAChB,CAAC;IAED,oGAAoG;IACpG,KAAK;QACH,EAAE,IAAI,CAAC,UAAU,CAAA;QACjB,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;QACtB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;QACpB,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC,CAAA;IAChI,CAAC;CACF","sourcesContent":["export interface AssistantSession { id: string; name?: string }\nexport interface AssistantSessionTarget {\n  /** Account/domain boundary supplied by the authenticated host. */\n  scope: string\n  anchorType: string\n  anchorId: string\n}\nexport interface AssistantSessionTransport {\n  list(target: AssistantSessionTarget): Promise<AssistantSession[]>\n  create(target: AssistantSessionTarget): Promise<AssistantSession>\n  isEmpty?(sessionId: string): Promise<boolean>\n  /**\n   * 이 대화를 여기까지 읽었다 — 열린 대화가 바뀔 때 한 번.\n   *\n   * 읽은 지점은 **다른 참여자에게 보이는 사실**이다(안 읽음 배지 · 목록의 굵은 글씨). 도크마다 손으로\n   * 부르던 것을 여기로 올렸다 — twin 만 부르고 있었고, 멘션으로 사람이 들어올 수 있게 된 뒤에는\n   * 세 화면이 같은 사실을 달리 말하게 된다.\n   */\n  markRead?(sessionId: string): Promise<void> | void\n}\nexport interface AssistantSessionState {\n  target?: AssistantSessionTarget\n  sessions: AssistantSession[]\n  sessionId: string\n  loading: boolean\n  error: string\n  /** Changes on reset, including temporary conversations without a server ID. */\n  revision: number\n}\nconst keyOf = (target?: AssistantSessionTarget) => target\n  ? JSON.stringify([target.scope, target.anchorType, target.anchorId]) : ''\n\n/** Domain-neutral session lifecycle. Never deletes history or edits host documents. */\nexport class AssistantSessionController {\n  state: AssistantSessionState = { sessions: [], sessionId: '', loading: false, error: '', revision: 0 }\n  private generation = 0\n  private preferred = new Map<string, string>()\n  private pending = new Map<string, Promise<AssistantSession[]>>()\n\n  private transport: AssistantSessionTransport\n  private changed: (state: AssistantSessionState) => void\n  private storage?: Pick<Storage, 'getItem' | 'setItem'>\n  private lazy: boolean\n  private preparing?: Promise<string | undefined>\n  constructor(transport: AssistantSessionTransport, changed: (state: AssistantSessionState) => void,\n    storage?: Pick<Storage, 'getItem' | 'setItem'>, options: { lazy?: boolean } = {}) {\n    this.transport = transport\n    this.changed = changed\n    this.storage = storage\n    this.lazy = !!options.lazy\n  }\n\n  private remember(key: string, id: string) {\n    this.preferred.set(key, id)\n    try { this.storage?.setItem('assistant-session:' + key, id) } catch { /* Storage is optional. */ }\n  }\n\n  private preference(key: string): string | undefined {\n    try { return this.preferred.get(key) || this.storage?.getItem('assistant-session:' + key) || undefined }\n    catch { return this.preferred.get(key) }\n  }\n\n  private publish(patch: Partial<AssistantSessionState>) {\n    const before = this.state.sessionId\n    this.state = { ...this.state, ...patch }\n    /*\n     * 열린 대화가 바뀌면 읽음 지점을 옮긴다. 한 자리에서 하는 이유는 여는 길이 넷이기 때문이다\n     * (열기 · 고르기 · 새로 시작 · 보내며 만들기) — 갈래마다 부르면 한 곳이 빠진다.\n     */\n    if (this.state.sessionId && this.state.sessionId !== before) void this.markRead(this.state.sessionId)\n    this.changed(this.state)\n  }\n\n  /** 실패는 삼킨다 — 읽음 표시가 못 가는 것이 대화를 막을 이유는 아니다. */\n  private async markRead(sessionId: string): Promise<void> {\n    try {\n      await this.transport.markRead?.(sessionId)\n    } catch {\n      /* noop */\n    }\n  }\n\n  async open(target?: AssistantSessionTarget, force = false): Promise<void> {\n    const key = keyOf(target)\n    if (!force && key === keyOf(this.state.target) && (this.state.loading || this.state.sessionId || (this.lazy && this.state.target && !this.state.error))) return\n    const generation = ++this.generation\n    const snapshot = target ? { ...target } : undefined\n    this.publish({ target: snapshot, sessions: [], sessionId: '', loading: !!target, error: '' })\n    if (!snapshot) return\n    try {\n      let pending = this.pending.get(key)\n      if (!pending) {\n        pending = (async () => {\n          const sessions = await this.transport.list(snapshot)\n          // Failed/malformed reads must not create replacement sessions.\n          if (!Array.isArray(sessions) || sessions.some(session => !session.id)) throw new Error('Invalid session list')\n          if (sessions.length || this.lazy) return [...sessions]\n          // Do not issue a mutation for a target abandoned while the inbox was loading.\n          if (keyOf(this.state.target) !== key || this.pending.get(key) !== pending) throw new Error('Session target changed')\n          const created = await this.transport.create(snapshot)\n          if (!created?.id) throw new Error('Invalid new session')\n          return [created]\n        })()\n        this.pending.set(key, pending)\n        void pending.finally(() => {\n          if (this.pending.get(key) === pending) this.pending.delete(key)\n        }).catch(() => {})\n      }\n      const sessions = await pending\n      if (generation !== this.generation) return\n      const preference = this.preference(key)\n      const sessionId = this.lazy && preference === '__draft__' ? '' : sessions.find(session => session.id === preference)?.id || sessions[0]?.id || ''\n      this.remember(key, sessionId || '__draft__')\n      this.publish({ sessions, sessionId, loading: false })\n    } catch (error) {\n      if (generation === this.generation) this.publish({ loading: false, error: error instanceof Error ? error.message : String(error) })\n    }\n  }\n\n  select(id: string): boolean {\n    if (this.state.loading || !this.state.sessions.some(session => session.id === id)) return false\n    this.remember(keyOf(this.state.target), id)\n    this.publish({ sessionId: id, error: '' })\n    return true\n  }\n\n  async reset(): Promise<void> {\n    if (this.state.loading || this.preparing) return\n    if (this.lazy) {\n      if (!this.state.sessionId) return\n      ++this.generation\n      this.remember(keyOf(this.state.target), '__draft__')\n      this.publish({ sessionId: '', error: '', revision: this.state.revision + 1 })\n      return\n    }\n    const target = this.state.target\n    if (!target) {\n      this.publish({ sessions: [], sessionId: '', error: '', revision: this.state.revision + 1 })\n      return\n    }\n    const generation = ++this.generation\n    const key = keyOf(target)\n    this.publish({ loading: true, error: '' })\n    try {\n      if (this.state.sessionId && this.transport.isEmpty) {\n        const empty = await this.transport.isEmpty(this.state.sessionId)\n        if (generation !== this.generation) return\n        if (empty) { this.publish({ loading: false }); return }\n      }\n      const session = await this.transport.create({ ...target })\n      if (!session?.id) throw new Error('Invalid new session')\n      this.remember(key, session.id)\n      if (generation !== this.generation) return\n      this.publish({ sessions: [session, ...this.state.sessions.filter(existing => existing.id !== session.id)], sessionId: session.id,\n        loading: false, revision: this.state.revision + 1 })\n    } catch (error) {\n      if (generation === this.generation) this.publish({ loading: false, error: error instanceof Error ? error.message : String(error) })\n    }\n  }\n\n  /** Called only for a real send. Adoption happens before hosts render the new ID. */\n  prepareSession(adopt: (id: string) => void = () => {}): Promise<string | undefined> {\n    if (this.state.sessionId) return Promise.resolve(this.state.sessionId)\n    if (!this.state.target) return Promise.resolve(undefined)\n    if (this.state.loading || this.state.error) return Promise.reject(new Error('Session history is not ready'))\n    if (this.preparing) return this.preparing\n    const target = { ...this.state.target }, generation = this.generation\n    const pending = (async () => {\n      const session = await this.transport.create(target)\n      if (generation !== this.generation) throw new Error('Session target changed')\n      if (!session?.id) throw new Error('Invalid new session')\n      adopt(session.id)\n      this.remember(keyOf(target), session.id)\n      this.publish({ sessionId: session.id, sessions: [session, ...this.state.sessions] })\n      return session.id\n    })()\n    this.preparing = pending\n    void pending.finally(() => { if (this.preparing === pending) this.preparing = undefined }).catch(() => {})\n    return pending\n  }\n\n  /** Invalidate pending UI updates at logout/disposal. Server authorization remains authoritative. */\n  clear() {\n    ++this.generation\n    this.preferred.clear()\n    this.pending.clear()\n    this.publish({ target: undefined, sessions: [], sessionId: '', loading: false, error: '', revision: this.state.revision + 1 })\n  }\n}\n"]}

package/dist-client/utils/assistant-session-controller.test.d.ts

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

package/dist-client/utils/assistant-session-controller.test.js

@@ -0,0 +1,56 @@
+/*
+ * What this guards: opening a conversation marks it read, wherever the panel is mounted.
+ *
+ * Read position is a fact other participants see — the unread dot, the bold row in the list. Only
+ * the twin dock called it, by hand, at one of the four places a conversation becomes the open one.
+ * Once a mention can bring someone into a figure or plant conversation, three screens telling
+ * different stories about "read" is the same defect in three places.
+ */
+import { AssistantSessionController } from './assistant-session-controller';
+const target = { scope: 'scope-1', anchorType: 'figure', anchorId: 'fig-1' };
+function controller(sessions = [{ id: 's1', name: 'first' }]) {
+    const read = [];
+    const store = new Map();
+    const transport = {
+        list: async () => sessions,
+        create: async () => ({ id: 's2', name: 'new' }),
+        isEmpty: async () => false,
+        markRead: async (sessionId) => {
+            read.push(sessionId);
+        }
+    };
+    const instance = new AssistantSessionController(transport, () => { }, { getItem: key => store.get(key) ?? null, setItem: (key, value) => store.set(key, value) });
+    return { instance, read, transport };
+}
+it('★ opening a conversation marks it read', async () => {
+    const { instance, read } = controller();
+    await instance.open(target);
+    expect(read).toEqual(['s1']);
+});
+it('★ switching to another conversation marks that one', async () => {
+    const { instance, read } = controller([{ id: 's1' }, { id: 's9' }]);
+    await instance.open(target);
+    instance.select('s9');
+    expect(read).toEqual(['s1', 's9']);
+});
+it('the same conversation staying open is not marked again', async () => {
+    const { instance, read } = controller();
+    await instance.open(target);
+    instance.select('s1');
+    expect(read).toEqual(['s1']);
+});
+it('★ a transport that cannot mark read does not break opening a conversation', async () => {
+    const { instance } = controller();
+    instance.transport.markRead = async () => {
+        throw new Error('offline');
+    };
+    await expect(instance.open(target)).resolves.toBeUndefined();
+    expect(instance.state.sessionId).toBe('s1');
+});
+it('a host with no markRead at all still works — it is optional', async () => {
+    const { instance } = controller();
+    instance.transport.markRead = undefined;
+    await instance.open(target);
+    expect(instance.state.sessionId).toBe('s1');
+});
+//# sourceMappingURL=assistant-session-controller.test.js.map

package/dist-client/utils/assistant-session-controller.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-session-controller.test.js","sourceRoot":"","sources":["../../client/utils/assistant-session-controller.test.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * What this guards: opening a conversation marks it read, wherever the panel is mounted.\n *\n * Read position is a fact other participants see — the unread dot, the bold row in the list. Only\n * the twin dock called it, by hand, at one of the four places a conversation becomes the open one.\n * Once a mention can bring someone into a figure or plant conversation, three screens telling\n * different stories about \"read\" is the same defect in three places.\n */\nimport { AssistantSessionController } from './assistant-session-controller'\n\nconst target = { scope: 'scope-1', anchorType: 'figure', anchorId: 'fig-1' }\n\nfunction controller(sessions: any[] = [{ id: 's1', name: 'first' }]) {\n  const read: string[] = []\n  const store = new Map<string, string>()\n  const transport = {\n    list: async () => sessions,\n    create: async () => ({ id: 's2', name: 'new' }),\n    isEmpty: async () => false,\n    markRead: async (sessionId: string) => {\n      read.push(sessionId)\n    }\n  }\n  const instance = new AssistantSessionController(\n    transport as any,\n    () => {},\n    { getItem: key => store.get(key) ?? null, setItem: (key, value) => store.set(key, value) }\n  )\n  return { instance, read, transport }\n}\n\nit('★ opening a conversation marks it read', async () => {\n  const { instance, read } = controller()\n\n  await instance.open(target)\n\n  expect(read).toEqual(['s1'])\n})\n\nit('★ switching to another conversation marks that one', async () => {\n  const { instance, read } = controller([{ id: 's1' }, { id: 's9' }])\n  await instance.open(target)\n\n  instance.select('s9')\n\n  expect(read).toEqual(['s1', 's9'])\n})\n\nit('the same conversation staying open is not marked again', async () => {\n  const { instance, read } = controller()\n  await instance.open(target)\n\n  instance.select('s1')\n\n  expect(read).toEqual(['s1'])\n})\n\nit('★ a transport that cannot mark read does not break opening a conversation', async () => {\n  const { instance } = controller()\n  ;(instance as any).transport.markRead = async () => {\n    throw new Error('offline')\n  }\n\n  await expect(instance.open(target)).resolves.toBeUndefined()\n  expect(instance.state.sessionId).toBe('s1')\n})\n\nit('a host with no markRead at all still works — it is optional', async () => {\n  const { instance } = controller()\n  ;(instance as any).transport.markRead = undefined\n\n  await instance.open(target)\n\n  expect(instance.state.sessionId).toBe('s1')\n})\n"]}

package/dist-client/utils/assistant-session-transport.js

@@ -1,4 +1,5 @@
 import { client } from '@operato/graphql';
+import { i18next } from '@operato/i18n';
 import gql from 'graphql-tag';
 /** Existing authorized session API; does not introduce a product-specific storage format. */
 export const assistantSessionTransport = {
@@ -10,7 +11,7 @@ export const assistantSessionTransport = {
         if (result.errors?.length)
             throw new Error(result.errors[0].message);
         if (!Array.isArray(result.data?.chatMessages))
-            throw new Error('대화 내용을 확인하지 못했습니다.');
+            throw new Error(i18next.t('ai-assistant.text.messages-unreadable', { defaultValue: 'could not read this conversation.' }));
         return result.data.chatMessages.length === 0;
     },
     async list(target) {
@@ -21,9 +22,16 @@ export const assistantSessionTransport = {
         if (result.errors?.length)
             throw new Error(result.errors[0].message);
         if (!Array.isArray(result.data?.chatSessionInbox))
-            throw new Error('대화 목록을 불러오지 못했습니다.');
+            throw new Error(i18next.t('ai-assistant.text.sessions-unreadable', { defaultValue: 'could not load the conversation list.' }));
         return result.data.chatSessionInbox;
     },
+    async markRead(sessionId) {
+        /* 참여자가 아닌 대화(내 읽음 지점이 없는 자리)면 서버가 false 를 돌려준다 — 그것도 답이다. */
+        await client.mutate({
+            mutation: gql `mutation($id:String!){markSessionRead(sessionId:$id)}`,
+            variables: { id: sessionId }
+        });
+    },
     async create(target) {
         const result = await client.mutate({
             mutation: gql `mutation($type:String!,$id:String!){createAISession(anchorType:$type,anchorId:$id){id name}}`,
@@ -32,7 +40,7 @@ export const assistantSessionTransport = {
         if (result.errors?.length)
             throw new Error(result.errors[0].message);
         if (!result.data?.createAISession?.id)
-            throw new Error('대화를 만들지 못했습니다.');
+            throw new Error(i18next.t('ai-assistant.text.session-not-created', { defaultValue: 'could not start a conversation.' }));
         return result.data.createAISession;
     }
 };

package/dist-client/utils/assistant-session-transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"assistant-session-transport.js","sourceRoot":"","sources":["../../client/utils/assistant-session-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,GAAG,MAAM,aAAa,CAAA;AAG7B,6FAA6F;AAC7F,MAAM,CAAC,MAAM,yBAAyB,GAA8B;IAClE,KAAK,CAAC,OAAO,CAAC,SAAS;QACrB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;YAChC,KAAK,EAAE,GAAG,CAAA,6DAA6D;YACvE,SAAS,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,UAAU;SACtD,CAAC,CAAA;QACF,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QACpE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAA;QACpF,OAAO,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,CAAA;IAC9C,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,MAAM;QACf,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;YAChC,KAAK,EAAE,GAAG,CAAA,oHAAoH;YAC9H,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,UAAU;SACrF,CAAC,CAAA;QACF,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QACpE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAA;QACxF,OAAO,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAA;IACrC,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,MAAM;QACjB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;YACjC,QAAQ,EAAE,GAAG,CAAA,8FAA8F;YAC3G,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,QAAQ,EAAE;SAC5D,CAAC,CAAA;QACF,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QACpE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAA;QACxE,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAA;IACpC,CAAC;CACF,CAAA","sourcesContent":["import { client } from '@operato/graphql'\nimport gql from 'graphql-tag'\nimport type { AssistantSessionTransport } from './assistant-session-controller'\n\n/** Existing authorized session API; does not introduce a product-specific storage format. */\nexport const assistantSessionTransport: AssistantSessionTransport = {\n  async isEmpty(sessionId) {\n    const result = await client.query({\n      query: gql`query($id:String!){chatMessages(sessionId:$id,limit:1){id}}`,\n      variables: { id: sessionId }, fetchPolicy: 'no-cache'\n    })\n    if (result.errors?.length) throw new Error(result.errors[0].message)\n    if (!Array.isArray(result.data?.chatMessages)) throw new Error('대화 내용을 확인하지 못했습니다.')\n    return result.data.chatMessages.length === 0\n  },\n  async list(target) {\n    const result = await client.query({\n      query: gql`query($type:String!,$id:String!){chatSessionInbox(anchorType:$type,anchorId:$id,mineOnly:true,limit:100){id name}}`,\n      variables: { type: target.anchorType, id: target.anchorId }, fetchPolicy: 'no-cache'\n    })\n    if (result.errors?.length) throw new Error(result.errors[0].message)\n    if (!Array.isArray(result.data?.chatSessionInbox)) throw new Error('대화 목록을 불러오지 못했습니다.')\n    return result.data.chatSessionInbox\n  },\n  async create(target) {\n    const result = await client.mutate({\n      mutation: gql`mutation($type:String!,$id:String!){createAISession(anchorType:$type,anchorId:$id){id name}}`,\n      variables: { type: target.anchorType, id: target.anchorId }\n    })\n    if (result.errors?.length) throw new Error(result.errors[0].message)\n    if (!result.data?.createAISession?.id) throw new Error('대화를 만들지 못했습니다.')\n    return result.data.createAISession\n  }\n}\n"]}
+{"version":3,"file":"assistant-session-transport.js","sourceRoot":"","sources":["../../client/utils/assistant-session-transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,GAAG,MAAM,aAAa,CAAA;AAG7B,6FAA6F;AAC7F,MAAM,CAAC,MAAM,yBAAyB,GAA8B;IAClE,KAAK,CAAC,OAAO,CAAC,SAAS;QACrB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;YAChC,KAAK,EAAE,GAAG,CAAA,6DAA6D;YACvE,SAAS,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,WAAW,EAAE,UAAU;SACtD,CAAC,CAAA;QACF,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QACpE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uCAAuC,EAAE,EAAE,YAAY,EAAE,mCAAmC,EAAE,CAAC,CAAC,CAAA;QACzK,OAAO,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,CAAA;IAC9C,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,MAAM;QACf,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;YAChC,KAAK,EAAE,GAAG,CAAA,oHAAoH;YAC9H,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,WAAW,EAAE,UAAU;SACrF,CAAC,CAAA;QACF,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QACpE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uCAAuC,EAAE,EAAE,YAAY,EAAE,uCAAuC,EAAE,CAAC,CAAC,CAAA;QACjL,OAAO,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAA;IACrC,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,SAAS;QACtB,6DAA6D;QAC7D,MAAM,MAAM,CAAC,MAAM,CAAC;YAClB,QAAQ,EAAE,GAAG,CAAA,uDAAuD;YACpE,SAAS,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;SAC7B,CAAC,CAAA;IACJ,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,MAAM;QACjB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC;YACjC,QAAQ,EAAE,GAAG,CAAA,8FAA8F;YAC3G,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,UAAU,EAAE,EAAE,EAAE,MAAM,CAAC,QAAQ,EAAE;SAC5D,CAAC,CAAA;QACF,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;QACpE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uCAAuC,EAAE,EAAE,YAAY,EAAE,iCAAiC,EAAE,CAAC,CAAC,CAAA;QAC/J,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAA;IACpC,CAAC;CACF,CAAA","sourcesContent":["import { client } from '@operato/graphql'\nimport { i18next } from '@operato/i18n'\nimport gql from 'graphql-tag'\nimport type { AssistantSessionTransport } from './assistant-session-controller'\n\n/** Existing authorized session API; does not introduce a product-specific storage format. */\nexport const assistantSessionTransport: AssistantSessionTransport = {\n  async isEmpty(sessionId) {\n    const result = await client.query({\n      query: gql`query($id:String!){chatMessages(sessionId:$id,limit:1){id}}`,\n      variables: { id: sessionId }, fetchPolicy: 'no-cache'\n    })\n    if (result.errors?.length) throw new Error(result.errors[0].message)\n    if (!Array.isArray(result.data?.chatMessages)) throw new Error(i18next.t('ai-assistant.text.messages-unreadable', { defaultValue: 'could not read this conversation.' }))\n    return result.data.chatMessages.length === 0\n  },\n  async list(target) {\n    const result = await client.query({\n      query: gql`query($type:String!,$id:String!){chatSessionInbox(anchorType:$type,anchorId:$id,mineOnly:true,limit:100){id name}}`,\n      variables: { type: target.anchorType, id: target.anchorId }, fetchPolicy: 'no-cache'\n    })\n    if (result.errors?.length) throw new Error(result.errors[0].message)\n    if (!Array.isArray(result.data?.chatSessionInbox)) throw new Error(i18next.t('ai-assistant.text.sessions-unreadable', { defaultValue: 'could not load the conversation list.' }))\n    return result.data.chatSessionInbox\n  },\n  async markRead(sessionId) {\n    /* 참여자가 아닌 대화(내 읽음 지점이 없는 자리)면 서버가 false 를 돌려준다 — 그것도 답이다. */\n    await client.mutate({\n      mutation: gql`mutation($id:String!){markSessionRead(sessionId:$id)}`,\n      variables: { id: sessionId }\n    })\n  },\n  async create(target) {\n    const result = await client.mutate({\n      mutation: gql`mutation($type:String!,$id:String!){createAISession(anchorType:$type,anchorId:$id){id name}}`,\n      variables: { type: target.anchorType, id: target.anchorId }\n    })\n    if (result.errors?.length) throw new Error(result.errors[0].message)\n    if (!result.data?.createAISession?.id) throw new Error(i18next.t('ai-assistant.text.session-not-created', { defaultValue: 'could not start a conversation.' }))\n    return result.data.createAISession\n  }\n}\n"]}

package/dist-server/service/assistant-capability-resolver.d.ts

@@ -0,0 +1,17 @@
+import '@things-factory/auth-base';
+declare class AiRegistrationWarning {
+    code: string;
+    params: any;
+    message: string;
+}
+declare class AiCapabilityView {
+    state: string;
+    provider?: string;
+    model?: string;
+    reason?: string;
+    warnings: AiRegistrationWarning[];
+}
+export declare class AssistantCapabilityResolver {
+    aiCapability(_context: any): Promise<AiCapabilityView>;
+}
+export {};

package/dist-server/service/assistant-capability-resolver.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssistantCapabilityResolver = void 0;
+const tslib_1 = require("tslib");
+/*
+ * One window for one question: what state is this deployment's AI in.
+ *
+ * Two things were being answered by failure or by a log line — whether a provider is configured at
+ * all (standard A7-a), and which registrations are not yet what the contracts ask for (A1 stage one,
+ * and the modes' `/` sentences). They are the same question asked by different people, so they come
+ * back together, as codes.
+ *
+ * A screen reads this **before** offering to ask the assistant. It is a query: reading what a
+ * deployment can do is reading.
+ */
+const type_graphql_1 = require("type-graphql");
+const graphql_scalars_1 = require("graphql-scalars");
+require("@things-factory/auth-base");
+const ai_client_base_1 = require("@things-factory/ai-client-base");
+const index_js_1 = require("./assistant-mode/index.js");
+let AiRegistrationWarning = class AiRegistrationWarning {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'What is missing, as a code — never prose a screen has to parse.' }),
+    tslib_1.__metadata("design:type", String)
+], AiRegistrationWarning.prototype, "code", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, { description: 'Which registration it is about (category, tool, mode, slash).' }),
+    tslib_1.__metadata("design:type", Object)
+], AiRegistrationWarning.prototype, "params", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'The same thing in a sentence, for whoever reads a boot log.' }),
+    tslib_1.__metadata("design:type", String)
+], AiRegistrationWarning.prototype, "message", void 0);
+AiRegistrationWarning = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'A registration that was accepted but is not yet what the contract asks for.' })
+], AiRegistrationWarning);
+let AiCapabilityView = class AiCapabilityView {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: "'configured' or 'not-configured'. A screen that has not asked yet knows a third state of its own: it does not know." }),
+    tslib_1.__metadata("design:type", String)
+], AiCapabilityView.prototype, "state", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Which provider answers.' }),
+    tslib_1.__metadata("design:type", String)
+], AiCapabilityView.prototype, "provider", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The default model this deployment would use.' }),
+    tslib_1.__metadata("design:type", String)
+], AiCapabilityView.prototype, "model", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Why it is not configured: no-config · no-provider · unknown-provider · no-adapter.' }),
+    tslib_1.__metadata("design:type", String)
+], AiCapabilityView.prototype, "reason", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [AiRegistrationWarning], { description: 'Tools with no declared privilege, and modes offering work their tools cannot do.' }),
+    tslib_1.__metadata("design:type", Array)
+], AiCapabilityView.prototype, "warnings", void 0);
+AiCapabilityView = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: "Whether this deployment has an AI, and what its registrations are missing." })
+], AiCapabilityView);
+let AssistantCapabilityResolver = class AssistantCapabilityResolver {
+    async aiCapability(_context) {
+        const capability = (0, ai_client_base_1.aiCapability)();
+        const warnings = [...(0, ai_client_base_1.getToolRegistryWarnings)(), ...(0, index_js_1.getAssistantModeWarnings)()].map(warning => ({
+            code: warning.code,
+            params: warning.params,
+            message: warning.message
+        }));
+        return { ...capability, warnings };
+    }
+};
+exports.AssistantCapabilityResolver = AssistantCapabilityResolver;
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(() => AiCapabilityView, {
+        description: 'Whether this deployment has an AI configured, and which registrations are incomplete. Read this before offering to ask the assistant — do not find out by failing.'
+    }),
+    (0, type_graphql_1.Directive)('@privilege(category: "ai-assistant", privilege: "query")'),
+    tslib_1.__param(0, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], AssistantCapabilityResolver.prototype, "aiCapability", null);
+exports.AssistantCapabilityResolver = AssistantCapabilityResolver = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)()
+], AssistantCapabilityResolver);
+//# sourceMappingURL=assistant-capability-resolver.js.map

package/dist-server/service/assistant-capability-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-capability-resolver.js","sourceRoot":"","sources":["../../server/service/assistant-capability-resolver.ts"],"names":[],"mappings":";;;;AAAA;;;;;;;;;;GAUG;AACH,+CAAiF;AACjF,qDAA6C;AAC7C,qCAAkC;AAElC,mEAAsF;AAEtF,wDAAoE;AAGpE,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;CAS1B,CAAA;AAPC;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,iEAAiE,EAAE,CAAC;;mDAC9E;AAGZ;IADC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,6BAAW,EAAE,EAAE,WAAW,EAAE,+DAA+D,EAAE,CAAC;;qDAChG;AAGX;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,6DAA6D,EAAE,CAAC;;sDACvE;AARX,qBAAqB;IAD1B,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,6EAA6E,EAAE,CAAC;GACrG,qBAAqB,CAS1B;AAGD,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;CAerB,CAAA;AAbC;IADC,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,qHAAqH,EAAE,CAAC;;+CACjI;AAGb;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC;;kDACjD;AAGjB;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,8CAA8C,EAAE,CAAC;;+CACzE;AAGd;IADC,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,oFAAoF,EAAE,CAAC;;gDAC9G;AAGf;IADC,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,CAAC,qBAAqB,CAAC,EAAE,EAAE,WAAW,EAAE,kFAAkF,EAAE,CAAC;;kDACzG;AAd7B,gBAAgB;IADrB,IAAA,yBAAU,EAAC,EAAE,WAAW,EAAE,4EAA4E,EAAE,CAAC;GACpG,gBAAgB,CAerB;AAGM,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;IAKhC,AAAN,KAAK,CAAC,YAAY,CAAQ,QAAa;QACrC,MAAM,UAAU,GAAG,IAAA,6BAAY,GAAE,CAAA;QACjC,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAA,wCAAuB,GAAE,EAAE,GAAG,IAAA,mCAAwB,GAAE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC7F,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC,CAAC,CAAA;QAEH,OAAO,EAAE,GAAG,UAAU,EAAE,QAAQ,EAAsB,CAAA;IACxD,CAAC;CACF,CAAA;AAfY,kEAA2B;AAKhC;IAJL,IAAA,oBAAK,EAAC,GAAG,EAAE,CAAC,gBAAgB,EAAE;QAC7B,WAAW,EAAE,oKAAoK;KAClL,CAAC;IACD,IAAA,wBAAS,EAAC,0DAA0D,CAAC;IAClD,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;+DASxB;sCAdU,2BAA2B;IADvC,IAAA,uBAAQ,GAAE;GACE,2BAA2B,CAevC","sourcesContent":["/*\n * One window for one question: what state is this deployment's AI in.\n *\n * Two things were being answered by failure or by a log line — whether a provider is configured at\n * all (standard A7-a), and which registrations are not yet what the contracts ask for (A1 stage one,\n * and the modes' `/` sentences). They are the same question asked by different people, so they come\n * back together, as codes.\n *\n * A screen reads this **before** offering to ask the assistant. It is a query: reading what a\n * deployment can do is reading.\n */\nimport { Ctx, Directive, Field, ObjectType, Query, Resolver } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\nimport '@things-factory/auth-base'\n\nimport { aiCapability, getToolRegistryWarnings } from '@things-factory/ai-client-base'\n\nimport { getAssistantModeWarnings } from './assistant-mode/index.js'\n\n@ObjectType({ description: 'A registration that was accepted but is not yet what the contract asks for.' })\nclass AiRegistrationWarning {\n  @Field({ description: 'What is missing, as a code — never prose a screen has to parse.' })\n  code: string\n\n  @Field(() => GraphQLJSON, { description: 'Which registration it is about (category, tool, mode, slash).' })\n  params: any\n\n  @Field({ description: 'The same thing in a sentence, for whoever reads a boot log.' })\n  message: string\n}\n\n@ObjectType({ description: \"Whether this deployment has an AI, and what its registrations are missing.\" })\nclass AiCapabilityView {\n  @Field({ description: \"'configured' or 'not-configured'. A screen that has not asked yet knows a third state of its own: it does not know.\" })\n  state: string\n\n  @Field({ nullable: true, description: 'Which provider answers.' })\n  provider?: string\n\n  @Field({ nullable: true, description: 'The default model this deployment would use.' })\n  model?: string\n\n  @Field({ nullable: true, description: 'Why it is not configured: no-config · no-provider · unknown-provider · no-adapter.' })\n  reason?: string\n\n  @Field(() => [AiRegistrationWarning], { description: 'Tools with no declared privilege, and modes offering work their tools cannot do.' })\n  warnings: AiRegistrationWarning[]\n}\n\n@Resolver()\nexport class AssistantCapabilityResolver {\n  @Query(() => AiCapabilityView, {\n    description: 'Whether this deployment has an AI configured, and which registrations are incomplete. Read this before offering to ask the assistant — do not find out by failing.'\n  })\n  @Directive('@privilege(category: \"ai-assistant\", privilege: \"query\")')\n  async aiCapability(@Ctx() _context: any): Promise<AiCapabilityView> {\n    const capability = aiCapability()\n    const warnings = [...getToolRegistryWarnings(), ...getAssistantModeWarnings()].map(warning => ({\n      code: warning.code,\n      params: warning.params,\n      message: warning.message\n    }))\n\n    return { ...capability, warnings } as AiCapabilityView\n  }\n}\n"]}

package/dist-server/service/assistant-chat-resolver.d.ts

@@ -3,17 +3,16 @@ declare class AssistantMessageInput {
     role: string;
     content: string;
 }
+declare class AssistantModeInput {
+    kind: string;
+    target?: string;
+}
 declare class AssistantChatInput {
     sessionId?: string;
     messages: AssistantMessageInput[];
-    systemPrompt: string;
-    toolCategories?: string[];
+    mode: AssistantModeInput;
     hostContext?: any;
     truncateAfterMessageId?: string;
-    requireGroundingTools?: boolean;
-    model?: string;
-    temperature?: number;
-    maxTokens?: number;
 }
 declare class AssistantChatOutput {
     reply: string;
@@ -21,6 +20,7 @@ declare class AssistantChatOutput {
     sessionId?: string;
     userMessageId?: string;
     assistantMessageId?: string;
+    historyFolded?: any;
     toolUsages?: any;
     offeredTools?: string[];
     proposals?: any;