@things-factory/ai-assistant 10.1.46 → 10.1.50

package/dist-client/utils/assistant-activity.d.ts

@@ -0,0 +1,22 @@
+export interface SessionActivity {
+    sessionId: string;
+    kind: 'message' | 'meta';
+    anchorType?: string;
+    anchorId?: string;
+    at: string;
+    preview?: string;
+    actorId?: string;
+}
+type Listener = (activity: SessionActivity) => void;
+export declare function unreadSessionCount(): number;
+export declare function isSessionUnread(sessionId: string): boolean;
+/** 그 세션을 읽었다 — 도크가 세션을 열 때 호출(서버 markSessionRead 와 짝). */
+export declare function clearSessionUnread(sessionId: string): void;
+export declare function subscribeSessionActivity(fn: Listener): () => void;
+/**
+ * 구독 시작 — 부팅에서 1회. 재호출은 무시(중복 구독 방지).
+ * 실패해도 앱을 막지 않는다 — 배지가 없을 뿐이고, 도크를 열면 목록을 직접 읽는다.
+ */
+export declare function startSessionActivityFeed(): void;
+export declare function setOpenSession(sessionId: string): void;
+export {};

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

@@ -0,0 +1,104 @@
+/*
+ * AI 세션 활동 구독 — **앱 전역 1회**. 도크가 닫혀 있어도(마운트되지 않아도) 새 소식을 안다.
+ *
+ * operato-twin 의 `twin-ai-activity.ts` 에서 올려 왔다(2026-09-25, design/ai/shared-dock.md §2-8) — 안 읽음은
+ * 모든 앱에서 같은 기능이다. `setupAssistantDock()` 이 부팅에서 한 번 연다.
+ *
+ * ── 왜 도크가 아니라 여기인가 ───────────────────────────────────────────────
+ * 도크는 asidebar viewpart 이고 닫혀 있으면 **렌더되지 않는다**(템플릿이 아예 안 붙는다). 그래서
+ * 도크 안에서 구독하면 닫아 둔 동안 아무 소식을 받지 못한다 — 배지를 띄울 수 없다.
+ * 구독은 부팅 시 한 번 열고, 도크·컨텍스트 밴드는 이 스토어를 본다.
+ *
+ * ── 종류에 따라 다르게 다룬다 ───────────────────────────────────────────────
+ *   message — 새 메시지. 안 읽은 세션으로 표시(배지 올림). **내가 보낸 것은 올리지 않는다.**
+ *   meta    — 이름 변경 등. 목록 갱신만 알리고 배지는 올리지 않는다(소음 방지).
+ *
+ * 정확한 미읽음 **개수**는 세지 않는다 — 세션 수만 센다(서버 목록 정책과 같다).
+ */
+import gql from 'graphql-tag';
+import { client, gqlContext } from '@operato/graphql';
+const listeners = new Set();
+/** 안 읽은 세션 id — 개수가 아니라 세션 단위. 도크에서 그 세션을 열면 지운다. */
+const unreadSessions = new Set();
+let subscription = null;
+const ACTIVITY_SUBSCRIPTION = gql `
+  subscription MySessionActivity {
+    mySessionActivity {
+      sessionId
+      kind
+      anchorType
+      anchorId
+      at
+      preview
+      actorId
+    }
+  }
+`;
+export function unreadSessionCount() {
+    return unreadSessions.size;
+}
+export function isSessionUnread(sessionId) {
+    return unreadSessions.has(sessionId);
+}
+/** 그 세션을 읽었다 — 도크가 세션을 열 때 호출(서버 markSessionRead 와 짝). */
+export function clearSessionUnread(sessionId) {
+    if (unreadSessions.delete(sessionId))
+        notify({ sessionId, kind: 'meta', at: new Date().toISOString() });
+}
+export function subscribeSessionActivity(fn) {
+    listeners.add(fn);
+    return () => listeners.delete(fn);
+}
+function notify(activity) {
+    listeners.forEach(fn => {
+        try {
+            fn(activity);
+        }
+        catch {
+            /* 구독자 오류가 다른 구독자를 막지 않는다 */
+        }
+    });
+}
+/**
+ * 구독 시작 — 부팅에서 1회. 재호출은 무시(중복 구독 방지).
+ * 실패해도 앱을 막지 않는다 — 배지가 없을 뿐이고, 도크를 열면 목록을 직접 읽는다.
+ */
+export function startSessionActivityFeed() {
+    if (subscription)
+        return;
+    try {
+        subscription = client
+            .subscribe({ query: ACTIVITY_SUBSCRIPTION, context: gqlContext() })
+            .subscribe({
+            next: ({ data }) => {
+                const activity = data?.mySessionActivity;
+                if (!activity?.sessionId)
+                    return;
+                /* 자기 발신은 배지를 올리지 않는다 — 방금 내가 쓴 것이 안 읽음으로 뜨면 어색하다.
+                 * 서버는 actorId(사용자 id)를 싣지만 클라는 내부 관리키를 판정에 쓰지 않는다 →
+                 * 자기 발신 판정은 도크가 열려 있는 세션인지로 대신한다(그 세션은 이미 읽고 있다). */
+                if (activity.kind === 'message' && !isOpenSession(activity.sessionId)) {
+                    unreadSessions.add(activity.sessionId);
+                }
+                notify(activity);
+            },
+            error: () => {
+                subscription = null; // 재연결은 다음 호출에 맡긴다(자동 재시도 루프를 두지 않는다)
+            }
+        });
+    }
+    catch {
+        subscription = null;
+    }
+}
+/* 도크가 지금 열어 둔 세션 — 그 세션의 활동은 배지를 올리지 않는다(보고 있으므로). */
+let openSessionId = '';
+export function setOpenSession(sessionId) {
+    openSessionId = sessionId || '';
+    if (openSessionId)
+        clearSessionUnread(openSessionId);
+}
+function isOpenSession(sessionId) {
+    return !!openSessionId && openSessionId === sessionId;
+}
+//# sourceMappingURL=assistant-activity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-activity.js","sourceRoot":"","sources":["../../client/utils/assistant-activity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,GAAG,MAAM,aAAa,CAAA;AAE7B,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAerD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAY,CAAA;AACrC,qDAAqD;AACrD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAA;AACxC,IAAI,YAAY,GAAmC,IAAI,CAAA;AAEvD,MAAM,qBAAqB,GAAG,GAAG,CAAA;;;;;;;;;;;;CAYhC,CAAA;AAGD,MAAM,UAAU,kBAAkB;IAChC,OAAO,cAAc,CAAC,IAAI,CAAA;AAC5B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;AACtC,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,IAAI,cAAc,CAAC,MAAM,CAAC,SAAS,CAAC;QAAE,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAA;AACzG,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,EAAY;IACnD,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACjB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;AACnC,CAAC;AAED,SAAS,MAAM,CAAC,QAAyB;IACvC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE;QACrB,IAAI,CAAC;YACH,EAAE,CAAC,QAAQ,CAAC,CAAA;QACd,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;QAC9B,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB;IACtC,IAAI,YAAY;QAAE,OAAM;IACxB,IAAI,CAAC;QACH,YAAY,GAAG,MAAM;aAClB,SAAS,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,CAAC;aAClE,SAAS,CAAC;YACT,IAAI,EAAE,CAAC,EAAE,IAAI,EAAO,EAAE,EAAE;gBACtB,MAAM,QAAQ,GAAgC,IAAI,EAAE,iBAAiB,CAAA;gBACrE,IAAI,CAAC,QAAQ,EAAE,SAAS;oBAAE,OAAM;gBAChC;;qEAEqD;gBACrD,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;oBACtE,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;gBACxC,CAAC;gBACD,MAAM,CAAC,QAAQ,CAAC,CAAA;YAClB,CAAC;YACD,KAAK,EAAE,GAAG,EAAE;gBACV,YAAY,GAAG,IAAI,CAAA,CAAC,qCAAqC;YAC3D,CAAC;SACF,CAAC,CAAA;IACN,CAAC;IAAC,MAAM,CAAC;QACP,YAAY,GAAG,IAAI,CAAA;IACrB,CAAC;AACH,CAAC;AAED,sDAAsD;AACtD,IAAI,aAAa,GAAG,EAAE,CAAA;AACtB,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC9C,aAAa,GAAG,SAAS,IAAI,EAAE,CAAA;IAC/B,IAAI,aAAa;QAAE,kBAAkB,CAAC,aAAa,CAAC,CAAA;AACtD,CAAC;AACD,SAAS,aAAa,CAAC,SAAiB;IACtC,OAAO,CAAC,CAAC,aAAa,IAAI,aAAa,KAAK,SAAS,CAAA;AACvD,CAAC","sourcesContent":["/*\n * AI 세션 활동 구독 — **앱 전역 1회**. 도크가 닫혀 있어도(마운트되지 않아도) 새 소식을 안다.\n *\n * operato-twin 의 `twin-ai-activity.ts` 에서 올려 왔다(2026-09-25, design/ai/shared-dock.md §2-8) — 안 읽음은\n * 모든 앱에서 같은 기능이다. `setupAssistantDock()` 이 부팅에서 한 번 연다.\n *\n * ── 왜 도크가 아니라 여기인가 ───────────────────────────────────────────────\n * 도크는 asidebar viewpart 이고 닫혀 있으면 **렌더되지 않는다**(템플릿이 아예 안 붙는다). 그래서\n * 도크 안에서 구독하면 닫아 둔 동안 아무 소식을 받지 못한다 — 배지를 띄울 수 없다.\n * 구독은 부팅 시 한 번 열고, 도크·컨텍스트 밴드는 이 스토어를 본다.\n *\n * ── 종류에 따라 다르게 다룬다 ───────────────────────────────────────────────\n *   message — 새 메시지. 안 읽은 세션으로 표시(배지 올림). **내가 보낸 것은 올리지 않는다.**\n *   meta    — 이름 변경 등. 목록 갱신만 알리고 배지는 올리지 않는다(소음 방지).\n *\n * 정확한 미읽음 **개수**는 세지 않는다 — 세션 수만 센다(서버 목록 정책과 같다).\n */\nimport gql from 'graphql-tag'\n\nimport { client, gqlContext } from '@operato/graphql'\n\n\nexport interface SessionActivity {\n  sessionId: string\n  kind: 'message' | 'meta'\n  anchorType?: string\n  anchorId?: string\n  at: string\n  preview?: string\n  actorId?: string\n}\n\ntype Listener = (activity: SessionActivity) => void\n\nconst listeners = new Set<Listener>()\n/** 안 읽은 세션 id — 개수가 아니라 세션 단위. 도크에서 그 세션을 열면 지운다. */\nconst unreadSessions = new Set<string>()\nlet subscription: { unsubscribe(): void } | null = null\n\nconst ACTIVITY_SUBSCRIPTION = gql`\n  subscription MySessionActivity {\n    mySessionActivity {\n      sessionId\n      kind\n      anchorType\n      anchorId\n      at\n      preview\n      actorId\n    }\n  }\n`\n\n\nexport function unreadSessionCount(): number {\n  return unreadSessions.size\n}\n\nexport function isSessionUnread(sessionId: string): boolean {\n  return unreadSessions.has(sessionId)\n}\n\n/** 그 세션을 읽었다 — 도크가 세션을 열 때 호출(서버 markSessionRead 와 짝). */\nexport function clearSessionUnread(sessionId: string): void {\n  if (unreadSessions.delete(sessionId)) notify({ sessionId, kind: 'meta', at: new Date().toISOString() })\n}\n\nexport function subscribeSessionActivity(fn: Listener): () => void {\n  listeners.add(fn)\n  return () => listeners.delete(fn)\n}\n\nfunction notify(activity: SessionActivity) {\n  listeners.forEach(fn => {\n    try {\n      fn(activity)\n    } catch {\n      /* 구독자 오류가 다른 구독자를 막지 않는다 */\n    }\n  })\n}\n\n/**\n * 구독 시작 — 부팅에서 1회. 재호출은 무시(중복 구독 방지).\n * 실패해도 앱을 막지 않는다 — 배지가 없을 뿐이고, 도크를 열면 목록을 직접 읽는다.\n */\nexport function startSessionActivityFeed(): void {\n  if (subscription) return\n  try {\n    subscription = client\n      .subscribe({ query: ACTIVITY_SUBSCRIPTION, context: gqlContext() })\n      .subscribe({\n        next: ({ data }: any) => {\n          const activity: SessionActivity | undefined = data?.mySessionActivity\n          if (!activity?.sessionId) return\n          /* 자기 발신은 배지를 올리지 않는다 — 방금 내가 쓴 것이 안 읽음으로 뜨면 어색하다.\n           * 서버는 actorId(사용자 id)를 싣지만 클라는 내부 관리키를 판정에 쓰지 않는다 →\n           * 자기 발신 판정은 도크가 열려 있는 세션인지로 대신한다(그 세션은 이미 읽고 있다). */\n          if (activity.kind === 'message' && !isOpenSession(activity.sessionId)) {\n            unreadSessions.add(activity.sessionId)\n          }\n          notify(activity)\n        },\n        error: () => {\n          subscription = null // 재연결은 다음 호출에 맡긴다(자동 재시도 루프를 두지 않는다)\n        }\n      })\n  } catch {\n    subscription = null\n  }\n}\n\n/* 도크가 지금 열어 둔 세션 — 그 세션의 활동은 배지를 올리지 않는다(보고 있으므로). */\nlet openSessionId = ''\nexport function setOpenSession(sessionId: string): void {\n  openSessionId = sessionId || ''\n  if (openSessionId) clearSessionUnread(openSessionId)\n}\nfunction isOpenSession(sessionId: string): boolean {\n  return !!openSessionId && openSessionId === sessionId\n}\n\n"]}

package/dist-client/utils/assistant-ask.d.ts

@@ -0,0 +1,23 @@
+export interface AssistantAsk {
+    /** Sent as the next question. */
+    ask?: string;
+    /** Put in the input, not sent. */
+    draft?: string;
+    /** Ask in the open conversation instead of a new one. */
+    continueCurrent?: boolean;
+    /** A new conversation's name. */
+    name?: string;
+    /** Turns carried into the new conversation before the question. */
+    transcript?: {
+        role: 'user' | 'ai';
+        content: string;
+    }[];
+    /** A note stored first: what the screen was showing when the person asked. */
+    context?: string;
+}
+type Listener = () => void;
+export declare function askAssistant(ask: AssistantAsk): void;
+/** The dock takes the request once. */
+export declare function takeAssistantAsk(): AssistantAsk | undefined;
+export declare function subscribeAssistantAsk(listener: Listener): () => void;
+export {};

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

@@ -0,0 +1,18 @@
+let pending;
+const listeners = new Set();
+export function askAssistant(ask) {
+    pending = ask;
+    listeners.forEach(listener => listener());
+    window.dispatchEvent(new CustomEvent('assistant-dock-open'));
+}
+/** The dock takes the request once. */
+export function takeAssistantAsk() {
+    const ask = pending;
+    pending = undefined;
+    return ask;
+}
+export function subscribeAssistantAsk(listener) {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+}
+//# sourceMappingURL=assistant-ask.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-ask.js","sourceRoot":"","sources":["../../client/utils/assistant-ask.ts"],"names":[],"mappings":"AAwBA,IAAI,OAAiC,CAAA;AACrC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAY,CAAA;AAErC,MAAM,UAAU,YAAY,CAAC,GAAiB;IAC5C,OAAO,GAAG,GAAG,CAAA;IACb,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAA;IACzC,MAAM,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,qBAAqB,CAAC,CAAC,CAAA;AAC9D,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,gBAAgB;IAC9B,MAAM,GAAG,GAAG,OAAO,CAAA;IACnB,OAAO,GAAG,SAAS,CAAA;IACnB,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAkB;IACtD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IACvB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;AACzC,CAAC","sourcesContent":["/*\n * Asking the assistant from another screen - `askAssistant()` (design/ai/shared-dock.md §2-11).\n *\n * Generalised from operato-twin's promotion channel and operato-plant's ask box: a toast's \"ask AI\", a\n * header ask box, a performance page carrying its context. The request waits here until the dock takes it,\n * so a dock that is closed (not mounted) still gets it when it opens.\n */\nexport interface AssistantAsk {\n  /** Sent as the next question. */\n  ask?: string\n  /** Put in the input, not sent. */\n  draft?: string\n  /** Ask in the open conversation instead of a new one. */\n  continueCurrent?: boolean\n  /** A new conversation's name. */\n  name?: string\n  /** Turns carried into the new conversation before the question. */\n  transcript?: { role: 'user' | 'ai'; content: string }[]\n  /** A note stored first: what the screen was showing when the person asked. */\n  context?: string\n}\n\ntype Listener = () => void\n\nlet pending: AssistantAsk | undefined\nconst listeners = new Set<Listener>()\n\nexport function askAssistant(ask: AssistantAsk): void {\n  pending = ask\n  listeners.forEach(listener => listener())\n  window.dispatchEvent(new CustomEvent('assistant-dock-open'))\n}\n\n/** The dock takes the request once. */\nexport function takeAssistantAsk(): AssistantAsk | undefined {\n  const ask = pending\n  pending = undefined\n  return ask\n}\n\nexport function subscribeAssistantAsk(listener: Listener): () => void {\n  listeners.add(listener)\n  return () => listeners.delete(listener)\n}\n"]}

package/dist-client/utils/assistant-capability-read.d.ts

@@ -0,0 +1,6 @@
+import { type AiCapability } from './assistant-capability.js';
+/**
+ * Asks `aiCapability` (standard A7-a). A GraphQL error is thrown for the caller to show; the caller keeps
+ * `unknown` meanwhile and asks again — it does not remember a failed read as an answer.
+ */
+export declare function readAiCapability(): Promise<AiCapability>;

package/dist-client/utils/assistant-capability-read.js

@@ -0,0 +1,23 @@
+import { client } from '@operato/graphql';
+import gql from 'graphql-tag';
+import { capabilityOf } from './assistant-capability.js';
+/**
+ * Asks `aiCapability` (standard A7-a). A GraphQL error is thrown for the caller to show; the caller keeps
+ * `unknown` meanwhile and asks again — it does not remember a failed read as an answer.
+ */
+export async function readAiCapability() {
+    const result = await client.query({
+        query: gql `
+      query {
+        aiCapability {
+          state
+        }
+      }
+    `,
+        fetchPolicy: 'no-cache'
+    });
+    if (result.errors?.length)
+        throw new Error(result.errors[0].message);
+    return capabilityOf(result.data?.aiCapability);
+}
+//# sourceMappingURL=assistant-capability-read.js.map

package/dist-client/utils/assistant-capability-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-capability-read.js","sourceRoot":"","sources":["../../client/utils/assistant-capability-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACzC,OAAO,GAAG,MAAM,aAAa,CAAA;AAE7B,OAAO,EAAE,YAAY,EAAqB,MAAM,2BAA2B,CAAA;AAE3E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;QAChC,KAAK,EAAE,GAAG,CAAA;;;;;;KAMT;QACD,WAAW,EAAE,UAAU;KACxB,CAAC,CAAA;IAEF,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAA;IACpE,OAAO,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAA;AAChD,CAAC","sourcesContent":["import { client } from '@operato/graphql'\nimport gql from 'graphql-tag'\n\nimport { capabilityOf, type AiCapability } from './assistant-capability.js'\n\n/**\n * Asks `aiCapability` (standard A7-a). A GraphQL error is thrown for the caller to show; the caller keeps\n * `unknown` meanwhile and asks again — it does not remember a failed read as an answer.\n */\nexport async function readAiCapability(): Promise<AiCapability> {\n  const result = await client.query({\n    query: gql`\n      query {\n        aiCapability {\n          state\n        }\n      }\n    `,\n    fetchPolicy: 'no-cache'\n  })\n\n  if (result.errors?.length) throw new Error(result.errors[0].message)\n  return capabilityOf(result.data?.aiCapability)\n}\n"]}

package/dist-client/utils/assistant-capability.d.ts

@@ -0,0 +1,4 @@
+export type AiCapability = 'configured' | 'not-configured' | 'unknown';
+export declare function capabilityOf(answer: {
+    state?: string | null;
+} | null | undefined): AiCapability;

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

@@ -0,0 +1,17 @@
+/*
+ * Whether this deployment has an AI to answer — the rule every dock reads before offering a conversation.
+ *
+ * AI standard A7-a: a screen does not find out by failing. Without this a dock takes the question, sends
+ * it, and only then shows the provider's error. `aiCapability` answers first.
+ *
+ * Three states, and the third is the screen's own: not asked yet, or an answer that could not be read.
+ * It is never folded into `configured` — that is where the question started (a button that was always on).
+ *
+ * Pure, so it is tested without GraphQL. The read is `readAiCapability` (`assistant-capability-read.ts`).
+ * Warehouse and twin each held a copy of this until it moved here (2026-09-24).
+ */
+export function capabilityOf(answer) {
+    const state = answer?.state;
+    return state === 'configured' || state === 'not-configured' ? state : 'unknown';
+}
+//# sourceMappingURL=assistant-capability.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-capability.js","sourceRoot":"","sources":["../../client/utils/assistant-capability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,UAAU,YAAY,CAAC,MAAoD;IAC/E,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,CAAA;IAC3B,OAAO,KAAK,KAAK,YAAY,IAAI,KAAK,KAAK,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AACjF,CAAC","sourcesContent":["/*\n * Whether this deployment has an AI to answer — the rule every dock reads before offering a conversation.\n *\n * AI standard A7-a: a screen does not find out by failing. Without this a dock takes the question, sends\n * it, and only then shows the provider's error. `aiCapability` answers first.\n *\n * Three states, and the third is the screen's own: not asked yet, or an answer that could not be read.\n * It is never folded into `configured` — that is where the question started (a button that was always on).\n *\n * Pure, so it is tested without GraphQL. The read is `readAiCapability` (`assistant-capability-read.ts`).\n * Warehouse and twin each held a copy of this until it moved here (2026-09-24).\n */\n\nexport type AiCapability = 'configured' | 'not-configured' | 'unknown'\n\nexport function capabilityOf(answer: { state?: string | null } | null | undefined): AiCapability {\n  const state = answer?.state\n  return state === 'configured' || state === 'not-configured' ? state : 'unknown'\n}\n"]}

package/dist-client/utils/assistant-capability.test.d.ts

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

package/dist-client/utils/assistant-capability.test.js

@@ -0,0 +1,16 @@
+/*
+ * A7-a — the third state is never read as the first.
+ */
+import { capabilityOf } from './assistant-capability';
+describe('capabilityOf', () => {
+    it('passes the two answers the door gives', () => {
+        expect(capabilityOf({ state: 'configured' })).toBe('configured');
+        expect(capabilityOf({ state: 'not-configured' })).toBe('not-configured');
+    });
+    it('★ not asked yet, and an answer it cannot read, are unknown — never configured', () => {
+        for (const answer of [undefined, null, {}, { state: null }, { state: 'yes' }, { state: 'CONFIGURED' }]) {
+            expect(capabilityOf(answer)).toBe('unknown');
+        }
+    });
+});
+//# sourceMappingURL=assistant-capability.test.js.map

package/dist-client/utils/assistant-capability.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-capability.test.js","sourceRoot":"","sources":["../../client/utils/assistant-capability.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAErD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;QAChE,MAAM,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAA;IAC1E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+EAA+E,EAAE,GAAG,EAAE;QACvF,KAAK,MAAM,MAAM,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;YACvG,MAAM,CAAC,YAAY,CAAC,MAAa,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACrD,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA","sourcesContent":["/*\n * A7-a — the third state is never read as the first.\n */\nimport { capabilityOf } from './assistant-capability'\n\ndescribe('capabilityOf', () => {\n  it('passes the two answers the door gives', () => {\n    expect(capabilityOf({ state: 'configured' })).toBe('configured')\n    expect(capabilityOf({ state: 'not-configured' })).toBe('not-configured')\n  })\n\n  it('★ not asked yet, and an answer it cannot read, are unknown — never configured', () => {\n    for (const answer of [undefined, null, {}, { state: null }, { state: 'yes' }, { state: 'CONFIGURED' }]) {\n      expect(capabilityOf(answer as any)).toBe('unknown')\n    }\n  })\n})\n"]}

package/dist-client/utils/assistant-proposals.d.ts

@@ -0,0 +1,29 @@
+import type { AssistantSurface } from './assistant-surface.js';
+export type ProposalVerdict = 'accepted' | 'refused' | 'unavailable' | 'declined';
+export interface ProposalOutcome {
+    verdict: ProposalVerdict;
+    errorCode?: string;
+    applied?: number;
+    missed?: number;
+    /** A line for the conversation, besides the outcome itself (e.g. what was created). */
+    note?: string;
+}
+export interface ProposalContext {
+    sessionId?: string;
+    surface?: AssistantSurface;
+    /** Asks the person before anything irreversible. `false` → the handler returns `declined`. */
+    confirm(options: {
+        title: string;
+        text: string;
+        confirmText?: string;
+        cancelText?: string;
+        type?: 'warning' | 'info';
+    }): Promise<boolean>;
+    notify(level: 'info' | 'error', message: string): void;
+}
+export type ProposalHandler = (proposal: any, context: ProposalContext) => Promise<ProposalOutcome>;
+/** Registered by the package that declares the tool - `proposeAction` by twin, a figure candidate by figure-ui. */
+export declare function registerProposalHandler(tool: string, handler: ProposalHandler): void;
+export declare function proposalHandlerOf(tool: string | undefined): ProposalHandler | undefined;
+/** Runs the proposal - never throws; a failure is a `refused` outcome with its message as the code. */
+export declare function runProposal(proposal: any, context: ProposalContext): Promise<ProposalOutcome>;

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

@@ -0,0 +1,22 @@
+const handlers = new Map();
+/** Registered by the package that declares the tool - `proposeAction` by twin, a figure candidate by figure-ui. */
+export function registerProposalHandler(tool, handler) {
+    handlers.set(tool, handler);
+}
+export function proposalHandlerOf(tool) {
+    return tool ? handlers.get(tool) : undefined;
+}
+/** Runs the proposal - never throws; a failure is a `refused` outcome with its message as the code. */
+export async function runProposal(proposal, context) {
+    const handler = proposalHandlerOf(proposal?.tool);
+    if (!handler)
+        return { verdict: 'unavailable', errorCode: 'unknown-proposal-kind' };
+    try {
+        const outcome = await handler(proposal, context);
+        return outcome?.verdict ? outcome : { verdict: 'unavailable', errorCode: 'no-outcome' };
+    }
+    catch (error) {
+        return { verdict: 'refused', errorCode: error?.message || 'failed' };
+    }
+}
+//# sourceMappingURL=assistant-proposals.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-proposals.js","sourceRoot":"","sources":["../../client/utils/assistant-proposals.ts"],"names":[],"mappings":"AA4BA,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA2B,CAAA;AAEnD,mHAAmH;AACnH,MAAM,UAAU,uBAAuB,CAAC,IAAY,EAAE,OAAwB;IAC5E,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AAC7B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAwB;IACxD,OAAO,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AAC9C,CAAC;AAED,uGAAuG;AACvG,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAa,EAAE,OAAwB;IACvE,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IACjD,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,uBAAuB,EAAE,CAAA;IACnF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QAChD,OAAO,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,CAAA;IACzF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAG,KAAe,EAAE,OAAO,IAAI,QAAQ,EAAE,CAAA;IACjF,CAAC;AACH,CAAC","sourcesContent":["/*\n * Proposal handlers - each proposal kind is applied by the package that declared its tool\n * (design/ai/shared-dock.md §4). The dock has no kind-specific code: it finds the handler, runs it,\n * and reports the outcome on every branch (ADR-0070). A kind nobody handles is `unavailable`.\n */\nimport type { AssistantSurface } from './assistant-surface.js'\n\nexport type ProposalVerdict = 'accepted' | 'refused' | 'unavailable' | 'declined'\n\nexport interface ProposalOutcome {\n  verdict: ProposalVerdict\n  errorCode?: string\n  applied?: number\n  missed?: number\n  /** A line for the conversation, besides the outcome itself (e.g. what was created). */\n  note?: string\n}\n\nexport interface ProposalContext {\n  sessionId?: string\n  surface?: AssistantSurface\n  /** Asks the person before anything irreversible. `false` → the handler returns `declined`. */\n  confirm(options: { title: string; text: string; confirmText?: string; cancelText?: string; type?: 'warning' | 'info' }): Promise<boolean>\n  notify(level: 'info' | 'error', message: string): void\n}\n\nexport type ProposalHandler = (proposal: any, context: ProposalContext) => Promise<ProposalOutcome>\n\nconst handlers = new Map<string, ProposalHandler>()\n\n/** Registered by the package that declares the tool - `proposeAction` by twin, a figure candidate by figure-ui. */\nexport function registerProposalHandler(tool: string, handler: ProposalHandler): void {\n  handlers.set(tool, handler)\n}\n\nexport function proposalHandlerOf(tool: string | undefined): ProposalHandler | undefined {\n  return tool ? handlers.get(tool) : undefined\n}\n\n/** Runs the proposal - never throws; a failure is a `refused` outcome with its message as the code. */\nexport async function runProposal(proposal: any, context: ProposalContext): Promise<ProposalOutcome> {\n  const handler = proposalHandlerOf(proposal?.tool)\n  if (!handler) return { verdict: 'unavailable', errorCode: 'unknown-proposal-kind' }\n  try {\n    const outcome = await handler(proposal, context)\n    return outcome?.verdict ? outcome : { verdict: 'unavailable', errorCode: 'no-outcome' }\n  } catch (error) {\n    return { verdict: 'refused', errorCode: (error as Error)?.message || 'failed' }\n  }\n}\n"]}

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

@@ -0,0 +1,12 @@
+export declare function sessionActions(entry: {
+    participant?: boolean;
+    hidden?: boolean;
+    mine?: boolean;
+    owner?: boolean;
+}): {
+    rename: boolean;
+    hide: boolean;
+    unhide: boolean;
+    remove: boolean;
+    setVisibility: boolean;
+};

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

@@ -0,0 +1,19 @@
+/*
+ * Which actions a row of the conversation list offers this viewer - pure, so the rule is tested alone.
+ *
+ * The same hints the server gives on each inbox entry; the doors decide again:
+ *   rename        any participant                 (the name is the topic label; reversible)
+ *   hide/unhide   anyone, for their own list only (reversible)
+ *   delete        the creator (`mine`)            (not reversible from a screen)
+ *   visibility    the owner (`owner`)             (opening shows what is already written)
+ */
+export function sessionActions(entry) {
+    return {
+        rename: entry.participant !== false,
+        hide: !entry.hidden,
+        unhide: !!entry.hidden,
+        remove: !!entry.mine,
+        setVisibility: !!entry.owner
+    };
+}
+//# sourceMappingURL=assistant-session-actions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-session-actions.js","sourceRoot":"","sources":["../../client/utils/assistant-session-actions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,KAAmF;IAChH,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,WAAW,KAAK,KAAK;QACnC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM;QACnB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM;QACtB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI;QACpB,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK;KAC7B,CAAA;AACH,CAAC","sourcesContent":["/*\n * Which actions a row of the conversation list offers this viewer - pure, so the rule is tested alone.\n *\n * The same hints the server gives on each inbox entry; the doors decide again:\n *   rename        any participant                 (the name is the topic label; reversible)\n *   hide/unhide   anyone, for their own list only (reversible)\n *   delete        the creator (`mine`)            (not reversible from a screen)\n *   visibility    the owner (`owner`)             (opening shows what is already written)\n */\nexport function sessionActions(entry: { participant?: boolean; hidden?: boolean; mine?: boolean; owner?: boolean }) {\n  return {\n    rename: entry.participant !== false,\n    hide: !entry.hidden,\n    unhide: !!entry.hidden,\n    remove: !!entry.mine,\n    setVisibility: !!entry.owner\n  }\n}\n"]}

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

@@ -0,0 +1,72 @@
+export { sessionActions } from './assistant-session-actions.js';
+/**
+ * Managing the conversations on one anchor - list, rename, hide, delete, and who may read them.
+ *
+ * These were written once, inside operato-twin's dock (things-factory `b3d1081f4c`, `b44c986c07`,
+ * 2026-07-30), and every other dock (plant, figure, warehouse, ecs) had only the tabs. They are the
+ * framework's doors (`chatSessionInbox` · `renameAISession` · `hideAISession` · `deleteAISession` ·
+ * `setSessionVisibility`), so the screen for them belongs here too - one list every dock opens.
+ *
+ * Who may do what is the server's to decide; the entry carries hints only:
+ *   rename        any participant                 (the name is the topic label; reversible)
+ *   hide/unhide   anyone, for their own list only (reversible)
+ *   delete        the creator (`mine`)            (not reversible from a screen)
+ *   visibility    the owner (`owner`)             (opening shows what is already written)
+ */
+export type SessionVisibility = 'open' | 'private';
+/** One row of `chatSessionInbox`, as the list draws it. */
+export interface AssistantSessionEntry {
+    id: string;
+    name?: string;
+    kind?: string;
+    lastMessageAt?: string;
+    lastMessagePreview?: string;
+    previewRedacted?: boolean;
+    unread?: boolean;
+    participant?: boolean;
+    /** I created it - only then may I delete it. */
+    mine?: boolean;
+    /** I own it - only then may I change who reads it. */
+    owner?: boolean;
+    /** Hidden from my own list (returned only with the hidden filter on). */
+    hidden?: boolean;
+    visibility?: SessionVisibility | string;
+}
+/** Legacy single filter - kept for callers written before the filter set. */
+export type AssistantSessionFilter = 'all' | 'mine' | 'hidden';
+/** What the manager narrows by (design/ai/shared-dock.md §2-6). Defaults: this kind, everyone's, any visibility, hidden out. */
+export interface AssistantSessionFilters {
+    /** A kind (mode) to list; empty lists every kind on the anchor. */
+    kind?: string;
+    whose?: 'all' | 'mine' | 'participant';
+    visibility?: 'all' | 'open' | 'private';
+    includeHidden?: boolean;
+    unreadOnly?: boolean;
+}
+export interface AssistantSessionQuery {
+    anchorType: string;
+    anchorId: string;
+    search?: string;
+    filter?: AssistantSessionFilter;
+    filters?: AssistantSessionFilters;
+    limit?: number;
+    offset?: number;
+}
+export interface AssistantSessionPage {
+    entries: AssistantSessionEntry[];
+    /** How many pass the filter - so "load more" knows whether the end of the list is the end of the data. */
+    total: number;
+    /** How many I hid - so a hidden conversation is never forgotten. */
+    hiddenCount: number;
+}
+export interface AssistantSessionAdmin {
+    inbox(query: AssistantSessionQuery): Promise<AssistantSessionPage>;
+    rename(sessionId: string, name: string): Promise<boolean>;
+    hide(sessionId: string, hidden: boolean): Promise<boolean>;
+    remove(sessionId: string): Promise<boolean>;
+    setVisibility(sessionId: string, visibility: SessionVisibility): Promise<boolean>;
+}
+/** The page size the server allows at most (`chatSessionInbox` clamps to 200). */
+export declare const SESSION_PAGE_MAX = 200;
+/** The framework's session doors, as they are. */
+export declare const assistantSessionAdmin: AssistantSessionAdmin;

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

@@ -0,0 +1,81 @@
+import { client } from '@operato/graphql';
+import { i18next } from '@operato/i18n';
+import gql from 'graphql-tag';
+export { sessionActions } from './assistant-session-actions.js';
+/** The page size the server allows at most (`chatSessionInbox` clamps to 200). */
+export const SESSION_PAGE_MAX = 200;
+async function mutate(mutation, variables, field) {
+    const result = await client.mutate({ mutation, variables });
+    if (result.errors?.length)
+        throw new Error(result.errors[0].message);
+    return result.data?.[field] === true;
+}
+/** The framework's session doors, as they are. */
+export const assistantSessionAdmin = {
+    async inbox({ anchorType, anchorId, search, filter = 'all', filters = {}, limit = 50, offset = 0 }) {
+        const hidden = filters.includeHidden ?? filter === 'hidden';
+        const mine = filters.whose ? filters.whose === 'mine' : filter === 'mine';
+        const result = await client.query({
+            query: gql `
+        query ($t: String!, $i: String!, $h: Boolean, $q: String, $m: Boolean, $l: Int, $o: Int, $k: String, $p: Boolean, $v: String, $u: Boolean) {
+          hiddenSessionCount(anchorType: $t, anchorId: $i)
+          chatSessionInboxTotal(anchorType: $t, anchorId: $i, showHidden: $h, search: $q, mineOnly: $m, kind: $k, participantOnly: $p, visibility: $v, unreadOnly: $u)
+          chatSessionInbox(anchorType: $t, anchorId: $i, showHidden: $h, search: $q, mineOnly: $m, kind: $k, participantOnly: $p, visibility: $v, unreadOnly: $u, limit: $l, offset: $o) {
+            id
+            name
+            kind
+            lastMessageAt
+            lastMessagePreview
+            previewRedacted
+            unread
+            participant
+            mine
+            owner
+            hidden
+            visibility
+          }
+        }
+      `,
+            variables: {
+                t: anchorType,
+                i: anchorId,
+                /* Hidden ones only when asked - elsewhere they stay out of the list. */
+                h: hidden,
+                q: search?.trim() || null,
+                m: mine,
+                k: filters.kind || null,
+                p: filters.whose === 'participant' || null,
+                v: filters.visibility && filters.visibility !== 'all' ? filters.visibility : null,
+                u: filters.unreadOnly || null,
+                l: Math.min(SESSION_PAGE_MAX, Math.max(1, limit)),
+                o: Math.max(0, offset)
+            },
+            fetchPolicy: 'no-cache'
+        });
+        if (result.errors?.length)
+            throw new Error(result.errors[0].message);
+        const entries = result.data?.chatSessionInbox;
+        if (!Array.isArray(entries)) {
+            throw new Error(i18next.t('ai-assistant.text.sessions-unreadable', { defaultValue: 'could not load the conversation list.' }));
+        }
+        return {
+            /* With the hidden filter the server returns hidden ones alongside the rest, marked - the total counts both. */
+            entries,
+            total: result.data?.chatSessionInboxTotal ?? entries.length,
+            hiddenCount: result.data?.hiddenSessionCount ?? 0
+        };
+    },
+    rename(sessionId, name) {
+        return mutate(gql `mutation ($id: String!, $n: String!) { renameAISession(sessionId: $id, name: $n) }`, { id: sessionId, n: name }, 'renameAISession');
+    },
+    hide(sessionId, hidden) {
+        return mutate(gql `mutation ($id: String!, $h: Boolean) { hideAISession(sessionId: $id, hidden: $h) }`, { id: sessionId, h: hidden }, 'hideAISession');
+    },
+    remove(sessionId) {
+        return mutate(gql `mutation ($id: String!) { deleteAISession(sessionId: $id) }`, { id: sessionId }, 'deleteAISession');
+    },
+    setVisibility(sessionId, visibility) {
+        return mutate(gql `mutation ($id: String!, $v: String!) { setSessionVisibility(sessionId: $id, visibility: $v) }`, { id: sessionId, v: visibility }, 'setSessionVisibility');
+    }
+};
+//# sourceMappingURL=assistant-session-admin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assistant-session-admin.js","sourceRoot":"","sources":["../../client/utils/assistant-session-admin.ts"],"names":[],"mappings":"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","sourcesContent":["import { client } from '@operato/graphql'\nimport { i18next } from '@operato/i18n'\nimport gql from 'graphql-tag'\n\nexport { sessionActions } from './assistant-session-actions.js'\n\n/**\n * Managing the conversations on one anchor - list, rename, hide, delete, and who may read them.\n *\n * These were written once, inside operato-twin's dock (things-factory `b3d1081f4c`, `b44c986c07`,\n * 2026-07-30), and every other dock (plant, figure, warehouse, ecs) had only the tabs. They are the\n * framework's doors (`chatSessionInbox` · `renameAISession` · `hideAISession` · `deleteAISession` ·\n * `setSessionVisibility`), so the screen for them belongs here too - one list every dock opens.\n *\n * Who may do what is the server's to decide; the entry carries hints only:\n *   rename        any participant                 (the name is the topic label; reversible)\n *   hide/unhide   anyone, for their own list only (reversible)\n *   delete        the creator (`mine`)            (not reversible from a screen)\n *   visibility    the owner (`owner`)             (opening shows what is already written)\n */\n\nexport type SessionVisibility = 'open' | 'private'\n\n/** One row of `chatSessionInbox`, as the list draws it. */\nexport interface AssistantSessionEntry {\n  id: string\n  name?: string\n  kind?: string\n  lastMessageAt?: string\n  lastMessagePreview?: string\n  previewRedacted?: boolean\n  unread?: boolean\n  participant?: boolean\n  /** I created it - only then may I delete it. */\n  mine?: boolean\n  /** I own it - only then may I change who reads it. */\n  owner?: boolean\n  /** Hidden from my own list (returned only with the hidden filter on). */\n  hidden?: boolean\n  visibility?: SessionVisibility | string\n}\n\n/** Legacy single filter - kept for callers written before the filter set. */\nexport type AssistantSessionFilter = 'all' | 'mine' | 'hidden'\n\n/** What the manager narrows by (design/ai/shared-dock.md §2-6). Defaults: this kind, everyone's, any visibility, hidden out. */\nexport interface AssistantSessionFilters {\n  /** A kind (mode) to list; empty lists every kind on the anchor. */\n  kind?: string\n  whose?: 'all' | 'mine' | 'participant'\n  visibility?: 'all' | 'open' | 'private'\n  includeHidden?: boolean\n  unreadOnly?: boolean\n}\n\nexport interface AssistantSessionQuery {\n  anchorType: string\n  anchorId: string\n  search?: string\n  filter?: AssistantSessionFilter\n  filters?: AssistantSessionFilters\n  limit?: number\n  offset?: number\n}\n\nexport interface AssistantSessionPage {\n  entries: AssistantSessionEntry[]\n  /** How many pass the filter - so \"load more\" knows whether the end of the list is the end of the data. */\n  total: number\n  /** How many I hid - so a hidden conversation is never forgotten. */\n  hiddenCount: number\n}\n\nexport interface AssistantSessionAdmin {\n  inbox(query: AssistantSessionQuery): Promise<AssistantSessionPage>\n  rename(sessionId: string, name: string): Promise<boolean>\n  hide(sessionId: string, hidden: boolean): Promise<boolean>\n  remove(sessionId: string): Promise<boolean>\n  setVisibility(sessionId: string, visibility: SessionVisibility): Promise<boolean>\n}\n\n/** The page size the server allows at most (`chatSessionInbox` clamps to 200). */\nexport const SESSION_PAGE_MAX = 200\n\nasync function mutate(mutation: any, variables: Record<string, unknown>, field: string): Promise<boolean> {\n  const result = await client.mutate({ mutation, variables })\n  if (result.errors?.length) throw new Error(result.errors[0].message)\n  return result.data?.[field] === true\n}\n\n/** The framework's session doors, as they are. */\nexport const assistantSessionAdmin: AssistantSessionAdmin = {\n  async inbox({ anchorType, anchorId, search, filter = 'all', filters = {}, limit = 50, offset = 0 }) {\n    const hidden = filters.includeHidden ?? filter === 'hidden'\n    const mine = filters.whose ? filters.whose === 'mine' : filter === 'mine'\n    const result = await client.query({\n      query: gql`\n        query ($t: String!, $i: String!, $h: Boolean, $q: String, $m: Boolean, $l: Int, $o: Int, $k: String, $p: Boolean, $v: String, $u: Boolean) {\n          hiddenSessionCount(anchorType: $t, anchorId: $i)\n          chatSessionInboxTotal(anchorType: $t, anchorId: $i, showHidden: $h, search: $q, mineOnly: $m, kind: $k, participantOnly: $p, visibility: $v, unreadOnly: $u)\n          chatSessionInbox(anchorType: $t, anchorId: $i, showHidden: $h, search: $q, mineOnly: $m, kind: $k, participantOnly: $p, visibility: $v, unreadOnly: $u, limit: $l, offset: $o) {\n            id\n            name\n            kind\n            lastMessageAt\n            lastMessagePreview\n            previewRedacted\n            unread\n            participant\n            mine\n            owner\n            hidden\n            visibility\n          }\n        }\n      `,\n      variables: {\n        t: anchorType,\n        i: anchorId,\n        /* Hidden ones only when asked - elsewhere they stay out of the list. */\n        h: hidden,\n        q: search?.trim() || null,\n        m: mine,\n        k: filters.kind || null,\n        p: filters.whose === 'participant' || null,\n        v: filters.visibility && filters.visibility !== 'all' ? filters.visibility : null,\n        u: filters.unreadOnly || null,\n        l: Math.min(SESSION_PAGE_MAX, Math.max(1, limit)),\n        o: Math.max(0, offset)\n      },\n      fetchPolicy: 'no-cache'\n    })\n\n    if (result.errors?.length) throw new Error(result.errors[0].message)\n    const entries = result.data?.chatSessionInbox\n    if (!Array.isArray(entries)) {\n      throw new Error(i18next.t('ai-assistant.text.sessions-unreadable', { defaultValue: 'could not load the conversation list.' }))\n    }\n\n    return {\n      /* With the hidden filter the server returns hidden ones alongside the rest, marked - the total counts both. */\n      entries,\n      total: result.data?.chatSessionInboxTotal ?? entries.length,\n      hiddenCount: result.data?.hiddenSessionCount ?? 0\n    }\n  },\n\n  rename(sessionId, name) {\n    return mutate(gql`mutation ($id: String!, $n: String!) { renameAISession(sessionId: $id, name: $n) }`, { id: sessionId, n: name }, 'renameAISession')\n  },\n\n  hide(sessionId, hidden) {\n    return mutate(gql`mutation ($id: String!, $h: Boolean) { hideAISession(sessionId: $id, hidden: $h) }`, { id: sessionId, h: hidden }, 'hideAISession')\n  },\n\n  remove(sessionId) {\n    return mutate(gql`mutation ($id: String!) { deleteAISession(sessionId: $id) }`, { id: sessionId }, 'deleteAISession')\n  },\n\n  setVisibility(sessionId, visibility) {\n    return mutate(\n      gql`mutation ($id: String!, $v: String!) { setSessionVisibility(sessionId: $id, visibility: $v) }`,\n      { id: sessionId, v: visibility },\n      'setSessionVisibility'\n    )\n  }\n}\n"]}

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

@@ -17,6 +17,8 @@ export interface AssistantSessionTarget {
     scope: string;
     anchorType: string;
     anchorId: string;
+    /** The conversation kind (mode) the tabs list - all readable conversations of it, not only mine (shared dock §2-6). */
+    kind?: string;
 }
 export interface AssistantSessionTransport {
     list(target: AssistantSessionTarget): Promise<AssistantSession[]>;