@things-factory/ai-assistant 10.1.46 → 10.1.50

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 {\n  id: string\n  name?: string\n  /**\n   * 어느 대화인가 — 등록된 모드의 kind (ADR-0072 결정 3).\n   *\n   * 목록은 한 대상의 대화를 **모두** 보여 준다. 그 대상 위에 대화가 둘 설 수 있으므로(A17), 고른 것이\n   * 지금 열려 있는 대화와 다를 수 있다. 그때 화면은 그 대화로 따라가야 한다 — 안 그러면 문이 거절하고\n   * (`session-kind-mismatch`), 목록은 눌리는데 안 열리는 목록이 된다.\n   *\n   * 칸이 서기 전에 난 세션에는 값이 없다. 그때는 지금 대화로 두고, 서버가 다음 턴에 찍는다.\n   */\n  kind?: string\n}\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"]}
+{"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 {\n  id: string\n  name?: string\n  /**\n   * 어느 대화인가 — 등록된 모드의 kind (ADR-0072 결정 3).\n   *\n   * 목록은 한 대상의 대화를 **모두** 보여 준다. 그 대상 위에 대화가 둘 설 수 있으므로(A17), 고른 것이\n   * 지금 열려 있는 대화와 다를 수 있다. 그때 화면은 그 대화로 따라가야 한다 — 안 그러면 문이 거절하고\n   * (`session-kind-mismatch`), 목록은 눌리는데 안 열리는 목록이 된다.\n   *\n   * 칸이 서기 전에 난 세션에는 값이 없다. 그때는 지금 대화로 두고, 서버가 다음 턴에 찍는다.\n   */\n  kind?: string\n}\nexport interface AssistantSessionTarget {\n  /** Account/domain boundary supplied by the authenticated host. */\n  scope: string\n  anchorType: string\n  anchorId: string\n  /** The conversation kind (mode) the tabs list - all readable conversations of it, not only mine (shared dock §2-6). */\n  kind?: 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-transport.js

@@ -16,8 +16,12 @@ export const assistantSessionTransport = {
     },
     async list(target) {
         const result = await client.query({
-            query: gql `query($type:String!,$id:String!){chatSessionInbox(anchorType:$type,anchorId:$id,mineOnly:true,limit:100){id name kind}}`,
-            variables: { type: target.anchorType, id: target.anchorId }, fetchPolicy: 'no-cache'
+            /*
+             * Every readable conversation of this kind on the anchor, not only mine - the same scope the manager
+             * shows by default (design/ai/shared-dock.md §2-6). Without a kind: every kind, as before.
+             */
+            query: gql `query($type:String!,$id:String!,$kind:String){chatSessionInbox(anchorType:$type,anchorId:$id,kind:$kind,limit:100){id name kind}}`,
+            variables: { type: target.anchorType, id: target.anchorId, kind: target.kind || null }, fetchPolicy: 'no-cache'
         });
         if (result.errors?.length)
             throw new Error(result.errors[0].message);

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,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,yHAAyH;YACnI,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,mGAAmG;YAChH,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 kind}}`,\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 kind}}`,\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"]}
+{"version":3,"file":"assistant-session-transport.js","sourceRoot":"","sources":["../../client/utils/assistant-session-transport.ts"],"names":[],"mappings":"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","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      /*\n       * Every readable conversation of this kind on the anchor, not only mine - the same scope the manager\n       * shows by default (design/ai/shared-dock.md §2-6). Without a kind: every kind, as before.\n       */\n      query: gql`query($type:String!,$id:String!,$kind:String){chatSessionInbox(anchorType:$type,anchorId:$id,kind:$kind,limit:100){id name kind}}`,\n      variables: { type: target.anchorType, id: target.anchorId, kind: target.kind || null }, 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 kind}}`,\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-client/utils/assistant-surface.d.ts

@@ -0,0 +1,72 @@
+/** The row a conversation hangs on - its session anchor (ADR-0072 decision 6). */
+export interface AssistantAnchor {
+    anchorType: string;
+    anchorId: string;
+}
+/** No anchor could stand - said to the person as a fact and what to do. */
+export interface AssistantStuck {
+    stuck: string;
+    message: string;
+}
+export type AnchorResult = AssistantAnchor | AssistantStuck;
+export declare function isAnchor(result: AnchorResult | undefined): result is AssistantAnchor;
+/** For a surface that authors a board - the chat gets the board, the dock applies its patches. */
+export interface BoardSurface {
+    currentBoard?: () => any;
+    boardProvider?: () => any;
+    selectedRefids?: () => number[];
+    knownTypes?: () => string[];
+    categories?: () => any[];
+    componentSchemas?: () => any;
+    searchProvider?: (query: string) => any[];
+    applyPatch(detail: any): Promise<{
+        applied: number;
+        missed: number;
+        note?: string;
+    }> | {
+        applied: number;
+        missed: number;
+        note?: string;
+    };
+    revertPatch?(patchId: string): Promise<void> | void;
+    applyAction?(detail: any): Promise<void> | void;
+    /** The chat door for board authoring, until board-ai joins the neutral door (ADR-0061 decision 0-1). */
+    chatEndpoint?: 'boardAIChat' | 'assistantChat';
+}
+export interface AssistantSurface {
+    /** Identity - a different key is a different conversation. */
+    key: string;
+    /** Matched against the server's mode `subjects` (assistantModes(subject)). */
+    subject: string;
+    /** The session anchor, or why none could stand. May ask the server (a row uuid, a domain id). */
+    anchor(): Promise<AnchorResult> | AnchorResult;
+    /** Words for the header - never a raw identifier. */
+    label(): string;
+    detail?(): string;
+    icon?: string;
+    /** Read at the moment of sending - never cached, so a draft cannot go stale. */
+    hostContext?(): Record<string, unknown>;
+    board?: BoardSurface;
+    /** The dock opened another conversation for this surface - e.g. the board modeller records its direct edits under it. */
+    sessionChanged?(sessionId: string): void;
+}
+type Listener = () => void;
+/** An editor with a draft says it is on screen. The last one provided wins until it is cleared. */
+export declare function provideAssistantSurface(owner: object, surface: AssistantSurface): void;
+/** The editor is gone or inactive. A later provider that replaced it is left alone. */
+export declare function clearAssistantSurface(owner: object): void;
+/** The editor's draft or identity changed - the dock reads it again. */
+export declare function notifyAssistantSurface(owner: object): void;
+/** How a page's `context.subject` of this type becomes a surface - declared once by the app. */
+export declare function registerSubjectSurface(type: string, make: (subject: {
+    type: string;
+    id?: string;
+}) => AssistantSurface): void;
+/** The app's own conversation when the screen shows nothing in particular - a factory, a site, a catalog. */
+export declare function registerAssistantHome(surface: AssistantSurface): void;
+export declare function subscribeAssistantSurface(listener: Listener): () => void;
+/** What the dock talks about now: a provided editor, else the page's subject, else the app's home. */
+export declare function currentAssistantSurface(): AssistantSurface | undefined;
+/** The app's home surface - for the header's "back to the app's conversation". */
+export declare function assistantHomeSurface(): AssistantSurface | undefined;
+export {};

package/dist-client/utils/assistant-surface.js

@@ -0,0 +1,99 @@
+/*
+ * What the screen shows - the one way a screen tells the AI dock (design/ai/shared-dock.md §3).
+ *
+ * Before this there were five ways: `context.subject` (warehouse), `BoardEditHost` (twin), `StationAITarget`
+ * (plant), window events (figure) and the board modeller's own panel. The dock now reads one answer:
+ *
+ *   1. an editor that holds a draft provides a surface          provideAssistantSurface(owner, surface)
+ *   2. a page that shows one thing says so in its context        get context() { return { subject: { type, id } } }
+ *      and the app says once how such a subject becomes a surface registerSubjectSurface(type, make)
+ *   3. otherwise the app's home                                   registerAssistantHome(surface)
+ *
+ * The first that answers wins. The dock follows changes through `subscribeAssistantSurface`.
+ */
+import { store } from '@operato/shell';
+export function isAnchor(result) {
+    return !!result && 'anchorId' in result && !!result.anchorId;
+}
+const provided = new Map();
+let lastOwner;
+const subjectMakers = new Map();
+let home;
+const listeners = new Set();
+function changed() {
+    listeners.forEach(listener => {
+        try {
+            listener();
+        }
+        catch {
+            /* one listener's error does not stop the others */
+        }
+    });
+}
+/** An editor with a draft says it is on screen. The last one provided wins until it is cleared. */
+export function provideAssistantSurface(owner, surface) {
+    provided.set(owner, surface);
+    lastOwner = owner;
+    changed();
+}
+/** The editor is gone or inactive. A later provider that replaced it is left alone. */
+export function clearAssistantSurface(owner) {
+    if (!provided.delete(owner))
+        return;
+    if (lastOwner === owner)
+        lastOwner = [...provided.keys()].pop();
+    changed();
+}
+/** The editor's draft or identity changed - the dock reads it again. */
+export function notifyAssistantSurface(owner) {
+    if (provided.has(owner))
+        changed();
+}
+/** How a page's `context.subject` of this type becomes a surface - declared once by the app. */
+export function registerSubjectSurface(type, make) {
+    subjectMakers.set(type, make);
+    changed();
+}
+/** The app's own conversation when the screen shows nothing in particular - a factory, a site, a catalog. */
+export function registerAssistantHome(surface) {
+    home = surface;
+    changed();
+}
+export function subscribeAssistantSurface(listener) {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+}
+let pageSubjectKey = '';
+let pageSurface;
+function surfaceFromPage() {
+    const subject = store.getState()?.route?.context?.subject;
+    const type = subject?.type;
+    const make = type ? subjectMakers.get(type) : undefined;
+    if (!make)
+        return undefined;
+    const key = JSON.stringify([type, subject?.id ?? '']);
+    if (key !== pageSubjectKey) {
+        pageSubjectKey = key;
+        pageSurface = make({ type, id: subject?.id });
+    }
+    return pageSurface;
+}
+/** What the dock talks about now: a provided editor, else the page's subject, else the app's home. */
+export function currentAssistantSurface() {
+    return (lastOwner && provided.get(lastOwner)) || surfaceFromPage() || home;
+}
+/** The app's home surface - for the header's "back to the app's conversation". */
+export function assistantHomeSurface() {
+    return home;
+}
+/* The page context lives in the store; a page change is a surface change. */
+let lastRouteSubject = '';
+store.subscribe(() => {
+    const subject = store.getState()?.route?.context?.subject;
+    const key = JSON.stringify([subject?.type ?? '', subject?.id ?? '']);
+    if (key !== lastRouteSubject) {
+        lastRouteSubject = key;
+        changed();
+    }
+});
+//# sourceMappingURL=assistant-surface.js.map

package/dist-client/utils/assistant-surface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-surface.js","sourceRoot":"","sources":["../../client/utils/assistant-surface.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * What the screen shows - the one way a screen tells the AI dock (design/ai/shared-dock.md §3).\n *\n * Before this there were five ways: `context.subject` (warehouse), `BoardEditHost` (twin), `StationAITarget`\n * (plant), window events (figure) and the board modeller's own panel. The dock now reads one answer:\n *\n *   1. an editor that holds a draft provides a surface          provideAssistantSurface(owner, surface)\n *   2. a page that shows one thing says so in its context        get context() { return { subject: { type, id } } }\n *      and the app says once how such a subject becomes a surface registerSubjectSurface(type, make)\n *   3. otherwise the app's home                                   registerAssistantHome(surface)\n *\n * The first that answers wins. The dock follows changes through `subscribeAssistantSurface`.\n */\nimport { store } from '@operato/shell'\n\n/** The row a conversation hangs on - its session anchor (ADR-0072 decision 6). */\nexport interface AssistantAnchor {\n  anchorType: string\n  anchorId: string\n}\n\n/** No anchor could stand - said to the person as a fact and what to do. */\nexport interface AssistantStuck {\n  stuck: string\n  message: string\n}\n\nexport type AnchorResult = AssistantAnchor | AssistantStuck\n\nexport function isAnchor(result: AnchorResult | undefined): result is AssistantAnchor {\n  return !!result && 'anchorId' in result && !!result.anchorId\n}\n\n/** For a surface that authors a board - the chat gets the board, the dock applies its patches. */\nexport interface BoardSurface {\n  currentBoard?: () => any\n  boardProvider?: () => any\n  selectedRefids?: () => number[]\n  knownTypes?: () => string[]\n  categories?: () => any[]\n  componentSchemas?: () => any\n  searchProvider?: (query: string) => any[]\n  applyPatch(detail: any): Promise<{ applied: number; missed: number; note?: string }> | { applied: number; missed: number; note?: string }\n  revertPatch?(patchId: string): Promise<void> | void\n  applyAction?(detail: any): Promise<void> | void\n  /** The chat door for board authoring, until board-ai joins the neutral door (ADR-0061 decision 0-1). */\n  chatEndpoint?: 'boardAIChat' | 'assistantChat'\n}\n\nexport interface AssistantSurface {\n  /** Identity - a different key is a different conversation. */\n  key: string\n  /** Matched against the server's mode `subjects` (assistantModes(subject)). */\n  subject: string\n  /** The session anchor, or why none could stand. May ask the server (a row uuid, a domain id). */\n  anchor(): Promise<AnchorResult> | AnchorResult\n  /** Words for the header - never a raw identifier. */\n  label(): string\n  detail?(): string\n  icon?: string\n  /** Read at the moment of sending - never cached, so a draft cannot go stale. */\n  hostContext?(): Record<string, unknown>\n  board?: BoardSurface\n  /** The dock opened another conversation for this surface - e.g. the board modeller records its direct edits under it. */\n  sessionChanged?(sessionId: string): void\n}\n\ntype Listener = () => void\n\nconst provided = new Map<object, AssistantSurface>()\nlet lastOwner: object | undefined\nconst subjectMakers = new Map<string, (subject: { type: string; id?: string }) => AssistantSurface>()\nlet home: AssistantSurface | undefined\nconst listeners = new Set<Listener>()\n\nfunction changed() {\n  listeners.forEach(listener => {\n    try {\n      listener()\n    } catch {\n      /* one listener's error does not stop the others */\n    }\n  })\n}\n\n/** An editor with a draft says it is on screen. The last one provided wins until it is cleared. */\nexport function provideAssistantSurface(owner: object, surface: AssistantSurface): void {\n  provided.set(owner, surface)\n  lastOwner = owner\n  changed()\n}\n\n/** The editor is gone or inactive. A later provider that replaced it is left alone. */\nexport function clearAssistantSurface(owner: object): void {\n  if (!provided.delete(owner)) return\n  if (lastOwner === owner) lastOwner = [...provided.keys()].pop()\n  changed()\n}\n\n/** The editor's draft or identity changed - the dock reads it again. */\nexport function notifyAssistantSurface(owner: object): void {\n  if (provided.has(owner)) changed()\n}\n\n/** How a page's `context.subject` of this type becomes a surface - declared once by the app. */\nexport function registerSubjectSurface(type: string, make: (subject: { type: string; id?: string }) => AssistantSurface): void {\n  subjectMakers.set(type, make)\n  changed()\n}\n\n/** The app's own conversation when the screen shows nothing in particular - a factory, a site, a catalog. */\nexport function registerAssistantHome(surface: AssistantSurface): void {\n  home = surface\n  changed()\n}\n\nexport function subscribeAssistantSurface(listener: Listener): () => void {\n  listeners.add(listener)\n  return () => listeners.delete(listener)\n}\n\nlet pageSubjectKey = ''\nlet pageSurface: AssistantSurface | undefined\n\nfunction surfaceFromPage(): AssistantSurface | undefined {\n  const subject = (store.getState() as any)?.route?.context?.subject\n  const type = subject?.type\n  const make = type ? subjectMakers.get(type) : undefined\n  if (!make) return undefined\n  const key = JSON.stringify([type, subject?.id ?? ''])\n  if (key !== pageSubjectKey) {\n    pageSubjectKey = key\n    pageSurface = make({ type, id: subject?.id })\n  }\n  return pageSurface\n}\n\n/** What the dock talks about now: a provided editor, else the page's subject, else the app's home. */\nexport function currentAssistantSurface(): AssistantSurface | undefined {\n  return (lastOwner && provided.get(lastOwner)) || surfaceFromPage() || home\n}\n\n/** The app's home surface - for the header's \"back to the app's conversation\". */\nexport function assistantHomeSurface(): AssistantSurface | undefined {\n  return home\n}\n\n/* The page context lives in the store; a page change is a surface change. */\nlet lastRouteSubject = ''\nstore.subscribe(() => {\n  const subject = (store.getState() as any)?.route?.context?.subject\n  const key = JSON.stringify([subject?.type ?? '', subject?.id ?? ''])\n  if (key !== lastRouteSubject) {\n    lastRouteSubject = key\n    changed()\n  }\n})\n"]}

package/dist-client/utils/attachment-policy.d.ts

@@ -0,0 +1,35 @@
+export type AttachmentKind = 'image' | 'text';
+export interface AttachmentPolicy {
+    kinds: AttachmentKind[];
+    maxBytes?: number;
+    maxFiles?: number;
+}
+export declare const DEFAULT_MAX_BYTES: number;
+export declare const DEFAULT_MAX_FILES = 5;
+export declare function attachmentKindOf(file: {
+    type?: string;
+    name?: string;
+}): AttachmentKind | null;
+export type AttachmentRefusal = {
+    code: 'attachments-not-accepted';
+} | {
+    code: 'attachment-kind-not-accepted';
+    name: string;
+    kinds: AttachmentKind[];
+} | {
+    code: 'attachment-too-large';
+    name: string;
+    maxBytes: number;
+} | {
+    code: 'too-many-attachments';
+    maxFiles: number;
+};
+export declare function refuseAttachments(policy: AttachmentPolicy | null | undefined, files: {
+    name?: string;
+    type?: string;
+    size?: number;
+}[]): AttachmentRefusal | null;
+/** The file picker's `accept` for a policy. */
+export declare function acceptOf(policy: AttachmentPolicy | null | undefined): string;
+/** Where a conversation's file opens - the gated route, under the page's domain path. */
+export declare function chatAttachmentUrl(sessionId: string, attachmentId: string): string;

package/dist-client/utils/attachment-policy.js

@@ -0,0 +1,56 @@
+/*
+ * What a conversation accepts as attachments - the screen's copy of the server rule
+ * (server/service/chat-session/attachment-policy.ts, design/ai/shared-dock.md §9-1).
+ *
+ * The screen checks first so the person hears "no" before anything is sent; the door checks again and is
+ * the authority. `test/attachment-policy-agree.test.ts` runs both copies over one table so they cannot drift.
+ */
+export const DEFAULT_MAX_BYTES = 5 * 1024 * 1024;
+export const DEFAULT_MAX_FILES = 5;
+const TEXT_TYPES = ['text/plain', 'text/csv', 'text/markdown', 'application/json'];
+const TEXT_EXTENSIONS = ['.txt', '.csv', '.md', '.json'];
+export function attachmentKindOf(file) {
+    const type = (file.type || '').toLowerCase();
+    if (type.startsWith('image/'))
+        return 'image';
+    if (TEXT_TYPES.includes(type))
+        return 'text';
+    const name = (file.name || '').toLowerCase();
+    if (TEXT_EXTENSIONS.some(ext => name.endsWith(ext)))
+        return 'text';
+    return null;
+}
+export function refuseAttachments(policy, files) {
+    if (!files.length)
+        return null;
+    if (!policy || !policy.kinds?.length)
+        return { code: 'attachments-not-accepted' };
+    const maxFiles = policy.maxFiles ?? DEFAULT_MAX_FILES;
+    if (files.length > maxFiles)
+        return { code: 'too-many-attachments', maxFiles };
+    const maxBytes = policy.maxBytes ?? DEFAULT_MAX_BYTES;
+    for (const file of files) {
+        const kind = attachmentKindOf(file);
+        if (!kind || !policy.kinds.includes(kind)) {
+            return { code: 'attachment-kind-not-accepted', name: file.name || '', kinds: policy.kinds };
+        }
+        if ((file.size ?? 0) > maxBytes)
+            return { code: 'attachment-too-large', name: file.name || '', maxBytes };
+    }
+    return null;
+}
+/** The file picker's `accept` for a policy. */
+export function acceptOf(policy) {
+    const accept = [];
+    if (policy?.kinds?.includes('image'))
+        accept.push('image/*');
+    if (policy?.kinds?.includes('text'))
+        accept.push(...TEXT_EXTENSIONS, ...TEXT_TYPES);
+    return accept.join(',');
+}
+/** Where a conversation's file opens - the gated route, under the page's domain path. */
+export function chatAttachmentUrl(sessionId, attachmentId) {
+    const domainPath = /^\/domain\/[^/]+/.exec(location.pathname)?.[0] ?? '';
+    return `${domainPath}/chat-attachments/${encodeURIComponent(sessionId)}/${encodeURIComponent(attachmentId)}`;
+}
+//# sourceMappingURL=attachment-policy.js.map

package/dist-client/utils/attachment-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment-policy.js","sourceRoot":"","sources":["../../client/utils/attachment-policy.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * What a conversation accepts as attachments - the screen's copy of the server rule\n * (server/service/chat-session/attachment-policy.ts, design/ai/shared-dock.md §9-1).\n *\n * The screen checks first so the person hears \"no\" before anything is sent; the door checks again and is\n * the authority. `test/attachment-policy-agree.test.ts` runs both copies over one table so they cannot drift.\n */\n\nexport type AttachmentKind = 'image' | 'text'\n\nexport interface AttachmentPolicy {\n  kinds: AttachmentKind[]\n  maxBytes?: number\n  maxFiles?: number\n}\n\nexport const DEFAULT_MAX_BYTES = 5 * 1024 * 1024\nexport const DEFAULT_MAX_FILES = 5\n\nconst TEXT_TYPES = ['text/plain', 'text/csv', 'text/markdown', 'application/json']\nconst TEXT_EXTENSIONS = ['.txt', '.csv', '.md', '.json']\n\nexport function attachmentKindOf(file: { type?: string; name?: string }): AttachmentKind | null {\n  const type = (file.type || '').toLowerCase()\n  if (type.startsWith('image/')) return 'image'\n  if (TEXT_TYPES.includes(type)) return 'text'\n  const name = (file.name || '').toLowerCase()\n  if (TEXT_EXTENSIONS.some(ext => name.endsWith(ext))) return 'text'\n  return null\n}\n\nexport type AttachmentRefusal =\n  | { code: 'attachments-not-accepted' }\n  | { code: 'attachment-kind-not-accepted'; name: string; kinds: AttachmentKind[] }\n  | { code: 'attachment-too-large'; name: string; maxBytes: number }\n  | { code: 'too-many-attachments'; maxFiles: number }\n\nexport function refuseAttachments(\n  policy: AttachmentPolicy | null | undefined,\n  files: { name?: string; type?: string; size?: number }[]\n): AttachmentRefusal | null {\n  if (!files.length) return null\n  if (!policy || !policy.kinds?.length) return { code: 'attachments-not-accepted' }\n\n  const maxFiles = policy.maxFiles ?? DEFAULT_MAX_FILES\n  if (files.length > maxFiles) return { code: 'too-many-attachments', maxFiles }\n\n  const maxBytes = policy.maxBytes ?? DEFAULT_MAX_BYTES\n  for (const file of files) {\n    const kind = attachmentKindOf(file)\n    if (!kind || !policy.kinds.includes(kind)) {\n      return { code: 'attachment-kind-not-accepted', name: file.name || '', kinds: policy.kinds }\n    }\n    if ((file.size ?? 0) > maxBytes) return { code: 'attachment-too-large', name: file.name || '', maxBytes }\n  }\n  return null\n}\n\n/** The file picker's `accept` for a policy. */\nexport function acceptOf(policy: AttachmentPolicy | null | undefined): string {\n  const accept: string[] = []\n  if (policy?.kinds?.includes('image')) accept.push('image/*')\n  if (policy?.kinds?.includes('text')) accept.push(...TEXT_EXTENSIONS, ...TEXT_TYPES)\n  return accept.join(',')\n}\n\n/** Where a conversation's file opens - the gated route, under the page's domain path. */\nexport function chatAttachmentUrl(sessionId: string, attachmentId: string): string {\n  const domainPath = /^\\/domain\\/[^/]+/.exec(location.pathname)?.[0] ?? ''\n  return `${domainPath}/chat-attachments/${encodeURIComponent(sessionId)}/${encodeURIComponent(attachmentId)}`\n}\n"]}

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

@@ -13,6 +13,7 @@ declare class AssistantChatInput {
     mode: AssistantModeInput;
     hostContext?: any;
     truncateAfterMessageId?: string;
+    attachmentIds?: string[];
 }
 declare class AssistantChatOutput {
     reply: string;

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

@@ -49,6 +49,11 @@ const session_kind_js_1 = require("./chat-session/session-kind.js");
 const reader_gate_js_1 = require("./chat-message/reader-gate.js");
 const mention_invite_js_1 = require("./chat-session-participant/mention-invite.js");
 const invite_notification_js_1 = require("./chat-session-participant/invite-notification.js");
+const participant_lookup_js_1 = require("./chat-session-participant/participant-lookup.js");
+const session_write_gate_js_1 = require("./chat-session/session-write-gate.js");
+const attachment_policy_js_1 = require("./chat-session/attachment-policy.js");
+const session_attachments_js_1 = require("./chat-session/session-attachments.js");
+const registry_js_1 = require("./assistant-mode/registry.js");
 const resolve_js_1 = require("./assistant-mode/resolve.js");
 const request_translator_js_1 = require("./request-translator.js");
 /**
@@ -123,6 +128,13 @@ tslib_1.__decorate([
     }),
     tslib_1.__metadata("design:type", String)
 ], AssistantChatInput.prototype, "truncateAfterMessageId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [String], {
+        nullable: true,
+        description: 'Files stored with this conversation by attachToConversation, sent with this turn.'
+    }),
+    tslib_1.__metadata("design:type", Array)
+], AssistantChatInput.prototype, "attachmentIds", void 0);
 AssistantChatInput = tslib_1.__decorate([
     (0, type_graphql_1.InputType)({ description: 'One turn of a conversation that has no document of its own.' })
 ], AssistantChatInput);
@@ -222,6 +234,16 @@ let AssistantChatResolver = class AssistantChatResolver {
             const found = await sessionRepo.findOneBy({ id: input.sessionId, domain: { id: domain.id } });
             if (!found)
                 throw new Error(`ChatSession ${input.sessionId} not found`);
+            /*
+             * A private conversation is written by its people only - and here more than anywhere: the answer is
+             * built on this conversation's history, so an outsider's question would read it back to them.
+             */
+            await (0, session_write_gate_js_1.assertMayWriteSession)({
+                session: found,
+                userId: user?.id,
+                isParticipant: () => (0, participant_lookup_js_1.isSessionParticipant)(domain.id, found.id, user?.id),
+                t: (key, options) => t(key, options)
+            });
             if (found.anchorType === 'figure' && input.hostContext?.figureId !== found.anchorId) {
                 throw new Error(context.t('ai-assistant.text.other-figure-history', {
                     defaultValue: 'this conversation belongs to another figure. open the conversation of the model you have open.'
@@ -253,6 +275,25 @@ let AssistantChatResolver = class AssistantChatResolver {
         (0, station_session_guard_js_1.assertStationSession)(session, input.hostContext, t);
         const lastUserMessage = input.messages[input.messages.length - 1];
         let userMessageId;
+        /*
+         * Files sent with this turn (design/ai/shared-dock.md §9). They were stored with this conversation by
+         * attachToConversation; one that is not this conversation's is refused, never read. The policy is the
+         * mode's - checked again here, since the door is the authority, not the screen.
+         */
+        const attachmentRows = [];
+        if (input.attachmentIds?.length) {
+            if (!session)
+                throw new Error(t('ai-assistant.text.attachments-need-session', { defaultValue: 'attachments need a saved conversation.' }));
+            for (const id of input.attachmentIds) {
+                const row = await (0, session_attachments_js_1.findChatAttachment)(domain.id, session.id, id);
+                if (!row)
+                    throw new Error(t('ai-assistant.text.attachment-not-in-session', { defaultValue: 'an attachment does not belong to this conversation.' }));
+                attachmentRows.push(row);
+            }
+            const refusal = (0, attachment_policy_js_1.refuseAttachments)((0, registry_js_1.getAssistantMode)(input.mode.kind)?.attachments, attachmentRows.map(row => ({ name: row.name, type: row.mimetype, size: Number(row.size) })));
+            if (refusal)
+                throw new Error(t(`ai-assistant.text.${refusal.code}`, { ...refusal, defaultValue: refusal.code }));
+        }
         if (session && lastUserMessage?.role === 'user') {
             const previousLast = await messageRepo.findOne({
                 where: { session: { id: session.id } },
@@ -268,6 +309,7 @@ let AssistantChatResolver = class AssistantChatResolver {
                  * from the request — two sources for one fact can disagree.
                  */
                 addressee: 'assistant',
+                attachments: attachmentRows.length ? JSON.stringify(attachmentRows.map(session_attachments_js_1.describeAttachment)) : undefined,
                 creator: user,
                 updater: user,
                 parentMessage: previousLast ? { id: previousLast.id } : undefined
@@ -300,7 +342,7 @@ let AssistantChatResolver = class AssistantChatResolver {
                 visibility: session.visibility
             });
             if (invite.invited.length > 0) {
-                const payload = (0, invite_notification_js_1.buildInviteNotification)(invite.invited, undefined, user);
+                const payload = (0, invite_notification_js_1.buildInviteNotification)(invite.invited, undefined, user, session?.name);
                 try {
                     if (payload)
                         await context.state?.notify?.(payload);
@@ -356,7 +398,13 @@ let AssistantChatResolver = class AssistantChatResolver {
             storedRows.map(message => ({
                 id: message.id,
                 role: message.role,
-                content: message.content,
+                /*
+                 * A file sent in an earlier turn is not sent again - one line names it, and the model opens it
+                 * with readChatAttachment when it needs to (cost is a usage axis, ADR-0061 decision 6).
+                 */
+                content: message.id !== userMessageId && message.attachmentsJson?.length
+                    ? [message.content, ...message.attachmentsJson.map(attachment_policy_js_1.attachmentHistoryLine)].join('\n')
+                    : message.content,
                 senderId: message.creator?.id,
                 senderName: message.creator?.name,
                 addressee: message.addressee
@@ -370,7 +418,27 @@ let AssistantChatResolver = class AssistantChatResolver {
                     : undefined
             })
             : input.messages.map(message => ({ role: message.role, content: message.content }));
-        if (input.hostContext?.image?.data && conversation.length > 0) {
+        if (attachmentRows.length && conversation.length > 0) {
+            const last = conversation[conversation.length - 1];
+            if (last.role === 'user' && typeof last.content === 'string') {
+                const parts = [{ type: 'text', text: last.content }];
+                for (const row of attachmentRows) {
+                    const file = await (0, session_attachments_js_1.attachmentForModel)(row);
+                    if (file.type === 'image') {
+                        parts.push({ type: 'image', source: { kind: 'base64', data: file.data, mediaType: file.mediaType } });
+                    }
+                    else {
+                        parts.push({
+                            type: 'text',
+                            text: `[attachment ${row.id}: ${file.name}${file.truncated ? ' - cut, the file is longer' : ''}]\n${file.text}`
+                        });
+                    }
+                }
+                last.content = parts;
+            }
+        }
+        else if (input.hostContext?.image?.data && conversation.length > 0) {
+            /* The screen-image path (figure's rendered view) - not a file of the conversation. */
             const last = conversation[conversation.length - 1];
             if (last.role === 'user' && typeof last.content === 'string') {
                 const raw = input.hostContext.image;
@@ -464,7 +532,7 @@ let AssistantChatResolver = class AssistantChatResolver {
                 domainId: domain.id,
                 client,
                 maxTurns: LLM_HISTORY_MAX_TURNS,
-                locale: context.state?.locale
+                locale: context.state?.lng
             });
         }
         return {