@things-factory/ai-assistant 10.1.26 → 10.1.28

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

@@ -36,10 +36,20 @@ const chat_session_js_1 = require("./chat-session/chat-session.js");
 const station_session_guard_js_1 = require("./chat-session/station-session-guard.js");
 const chat_message_js_1 = require("./chat-message/chat-message.js");
 const llm_history_js_1 = require("./chat-message/llm-history.js");
+const history_summary_js_1 = require("./chat-message/history-summary.js");
+const fold_session_history_js_1 = require("./chat-message/fold-session-history.js");
+const grounding_sources_js_1 = require("./grounding-sources.js");
 const chat_message_publish_js_1 = require("./chat-message/chat-message-publish.js");
 const session_activity_publish_js_1 = require("./chat-session/session-activity-publish.js");
 const session_inbox_js_1 = require("./chat-session/session-inbox.js");
 const tool_access_js_1 = require("./tool-access.js");
+const chat_session_participant_js_1 = require("./chat-session-participant/chat-session-participant.js");
+const message_doors_js_1 = require("./chat-message/message-doors.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 resolve_js_1 = require("./assistant-mode/resolve.js");
+const request_translator_js_1 = require("./request-translator.js");
 /**
  * How many stored messages reach the model.
  *
@@ -61,6 +71,22 @@ tslib_1.__decorate([
 AssistantMessageInput = tslib_1.__decorate([
     (0, type_graphql_1.InputType)()
 ], AssistantMessageInput);
+let AssistantModeInput = class AssistantModeInput {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'A mode kind the app server registered — `<app>.<surface>`, e.g. "twin.space".' }),
+    tslib_1.__metadata("design:type", String)
+], AssistantModeInput.prototype, "kind", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({
+        nullable: true,
+        description: 'What this conversation is about — the space, the station, the model being edited. With `kind` it is the conversation\'s lifetime: when either changes the screen closes the conversation and starts another.'
+    }),
+    tslib_1.__metadata("design:type", String)
+], AssistantModeInput.prototype, "target", void 0);
+AssistantModeInput = tslib_1.__decorate([
+    (0, type_graphql_1.InputType)({ description: 'Which conversation this is, and what it is about.' })
+], AssistantModeInput);
 let AssistantChatInput = class AssistantChatInput {
 };
 tslib_1.__decorate([
@@ -77,18 +103,11 @@ tslib_1.__decorate([
     tslib_1.__metadata("design:type", Array)
 ], AssistantChatInput.prototype, "messages", void 0);
 tslib_1.__decorate([
-    (0, type_graphql_1.Field)({
-        description: 'Who the assistant is on this surface, in the words of the product that owns the screen. The rules for using each tool come from whoever registered it and are appended by the server.'
-    }),
-    tslib_1.__metadata("design:type", String)
-], AssistantChatInput.prototype, "systemPrompt", void 0);
-tslib_1.__decorate([
-    (0, type_graphql_1.Field)(() => [String], {
-        nullable: true,
-        description: 'Registered tool categories this conversation may use (registerToolCategory names, e.g. ["figure-authoring"]). Omitted or empty allows none — a plain conversation. A tool that declares a privilege is offered only to a caller who holds it.'
+    (0, type_graphql_1.Field)(() => AssistantModeInput, {
+        description: 'Which conversation this is. The persona, the tool categories, the model and the limits come from the mode the app server registered (ADR-0061 decision 7) — a caller choosing its own tool categories would be a caller choosing its own authority.'
     }),
-    tslib_1.__metadata("design:type", Array)
-], AssistantChatInput.prototype, "toolCategories", void 0);
+    tslib_1.__metadata("design:type", AssistantModeInput)
+], AssistantChatInput.prototype, "mode", void 0);
 tslib_1.__decorate([
     (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, {
         nullable: true,
@@ -103,25 +122,6 @@ tslib_1.__decorate([
     }),
     tslib_1.__metadata("design:type", String)
 ], AssistantChatInput.prototype, "truncateAfterMessageId", void 0);
-tslib_1.__decorate([
-    (0, type_graphql_1.Field)({
-        nullable: true,
-        description: 'Require a tool call before the model may answer. For surfaces that report live state, where an unchecked assertion reads the same as a checked one.'
-    }),
-    tslib_1.__metadata("design:type", Boolean)
-], AssistantChatInput.prototype, "requireGroundingTools", void 0);
-tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true, description: 'Model identifier override. Falls back to the configured default.' }),
-    tslib_1.__metadata("design:type", String)
-], AssistantChatInput.prototype, "model", void 0);
-tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true, description: 'Sampling temperature override.' }),
-    tslib_1.__metadata("design:type", Number)
-], AssistantChatInput.prototype, "temperature", void 0);
-tslib_1.__decorate([
-    (0, type_graphql_1.Field)({ nullable: true, description: 'Max output tokens per call.' }),
-    tslib_1.__metadata("design:type", Number)
-], AssistantChatInput.prototype, "maxTokens", 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);
@@ -147,6 +147,13 @@ tslib_1.__decorate([
     (0, type_graphql_1.Field)({ nullable: true, description: 'Stored ChatMessage id of the reply.' }),
     tslib_1.__metadata("design:type", String)
 ], AssistantChatOutput.prototype, "assistantMessageId", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, {
+        nullable: true,
+        description: 'Set when this turn did not fit: { omitted, summarized } — how many earlier messages the model did not see, and whether a summary stood in for them. Without it the person watches the conversation lose its beginning in silence, while the model is told.'
+    }),
+    tslib_1.__metadata("design:type", Object)
+], AssistantChatOutput.prototype, "historyFolded", void 0);
 tslib_1.__decorate([
     (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, {
         nullable: true,
@@ -199,6 +206,13 @@ let AssistantChatResolver = class AssistantChatResolver {
         if (!client) {
             throw new Error('No AI client configured. Set config.aiClient = { provider, model, apiKey } or call setDefaultAIClient(...).');
         }
+        /*
+         * Read the declaration before anything is stored. A kind this server does not have is a
+         * mismatched deployment, and the person should see that instead of a conversation with no
+         * persona and no tools.
+         */
+        const t = (0, request_translator_js_1.requestTranslator)(context);
+        const settings = (0, resolve_js_1.resolveModeSettings)(input.mode, t);
         const { domain, user } = context.state;
         const sessionRepo = (0, shell_1.getRepository)(chat_session_js_1.ChatSession);
         const messageRepo = (0, shell_1.getRepository)(chat_message_js_1.ChatMessage);
@@ -208,14 +222,18 @@ let AssistantChatResolver = class AssistantChatResolver {
             if (!found)
                 throw new Error(`ChatSession ${input.sessionId} not found`);
             if (found.anchorType === 'figure' && input.hostContext?.figureId !== found.anchorId) {
-                throw new Error('이 대화는 다른 Figure의 이력입니다. 현재 모델의 대화를 다시 여세요.');
+                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.'
+                }));
             }
             if (found.anchorType === 'application' && (input.hostContext?.app !== found.anchorId || input.hostContext?.figureId)) {
-                throw new Error('애플리케이션 대화와 모델 대화를 구분해서 다시 여세요.');
+                throw new Error(context.t('ai-assistant.text.application-vs-model-history', {
+                    defaultValue: 'this conversation is about the application, not about a model. open the one you want.'
+                }));
             }
             session = found;
         }
-        (0, station_session_guard_js_1.assertStationSession)(session, input.hostContext);
+        (0, station_session_guard_js_1.assertStationSession)(session, input.hostContext, t);
         const lastUserMessage = input.messages[input.messages.length - 1];
         let userMessageId;
         if (session && lastUserMessage?.role === 'user') {
@@ -227,6 +245,12 @@ let AssistantChatResolver = class AssistantChatResolver {
                 session: { id: session.id },
                 role: 'user',
                 content: lastUserMessage.content,
+                /*
+                 * This door is the one people call to ask the assistant, so a turn stored here was for the
+                 * assistant (ADR-0070 A15 decision ①). The value comes from which door was called, never
+                 * from the request — two sources for one fact can disagree.
+                 */
+                addressee: 'assistant',
                 creator: user,
                 updater: user,
                 parentMessage: previousLast ? { id: previousLast.id } : undefined
@@ -246,6 +270,28 @@ let AssistantChatResolver = class AssistantChatResolver {
             catch {
                 /* noop */
             }
+            /*
+             * 사람이 `@이름` 으로 부른 사람은 이 대화에 들어온다(ADR-0071 결정 1). 이 문은 **사람의 턴**을
+             * 저장하는 문이라 그 일을 한다 — 모델의 답이나 도구 결과는 아무도 초대하지 않는다.
+             */
+            const invite = await (0, mention_invite_js_1.inviteMentionedUsers)({
+                content: lastUserMessage.content,
+                sessionId: session.id,
+                domainId: domain.id,
+                inviter: user,
+                participants: (0, shell_1.getRepository)(chat_session_participant_js_1.ChatSessionParticipant),
+                visibility: session.visibility
+            });
+            if (invite.invited.length > 0) {
+                const payload = (0, invite_notification_js_1.buildInviteNotification)(invite.invited, undefined, user);
+                try {
+                    if (payload)
+                        await context.state?.notify?.(payload);
+                }
+                catch {
+                    /* 편지가 못 갔다고 방에 들어온 사실이 취소되지는 않는다. */
+                }
+            }
             (0, chat_message_publish_js_1.publishChatMessage)({ domainId: domain.id, sessionId: session.id, message: saved });
             (0, session_activity_publish_js_1.publishSessionActivity)({
                 domainId: domain.id,
@@ -257,12 +303,47 @@ let AssistantChatResolver = class AssistantChatResolver {
                 actorId: user?.id
             });
         }
-        const conversation = session
-            ? (0, llm_history_js_1.buildLlmHistory)(await messageRepo.find({
+        /*
+         * 이번 턴에 상한 밖으로 밀려난 것이 있는가 — 화면이 「대화가 길어졌다」를 알릴 근거다.
+         *
+         * 이 문은 그 사실을 내지 않았다. 대화창에는 그 안내를 그리는 자리가 있고(`historyFolded`), 보드
+         * 문만 그 값을 채웠다. 그래서 앱의 대화는 앞부분이 잘려 나가도 **사람에게는 아무 말도 하지 않았다** —
+         * 모델에게는 「N 개 생략」을 적어 보내면서.
+         */
+        const readRows = session
+            ? await messageRepo.find({
                 where: { session: { id: session.id } },
                 order: { createdAt: 'ASC' },
                 relations: ['creator']
-            }), {
+            })
+            : [];
+        /*
+         * 모델이 읽는 이력도 **부른 사람** 기준으로 가린다 — ADR-0073 판정 1. 가리지 않으면, 문을 한 번도
+         * 안 지난 사람이 "아까 그 수 다시 말해 줘" 한 마디로 값을 가져간다. 모델이 옮겨 적는 순간 그 값은
+         * 문 없는 새 답이 된다. 가린 자리를 지우지 않고 한 줄로 남기는 이유도 같다 — 지우면 모델이 그런
+         * 말이 없었다고 답하고, 그것은 거짓말이다.
+         */
+        const storedRows = await (0, reader_gate_js_1.readerGate)(context)(readRows);
+        const capped = (0, history_summary_js_1.splitByCap)(storedRows.map(row => ({ id: row.id, role: row.role, content: row.content ?? '' })), LLM_HISTORY_MAX_TURNS);
+        const historyFolded = capped.dropped.length > 0
+            ? { omitted: capped.dropped.length, summarized: Boolean(session?.lastSummary) }
+            : undefined;
+        const conversation = session
+            ? (0, llm_history_js_1.buildLlmHistory)(
+            /*
+             * The model reads who spoke and who they spoke to. The entity carries the speaker as a
+             * relation and the addressee as a column; the history wants them as plain fields, and
+             * without this mapping every line arrived unattributed — a room of people read as one
+             * voice (ADR-0070 A15 decision ②).
+             */
+            storedRows.map(message => ({
+                id: message.id,
+                role: message.role,
+                content: message.content,
+                senderId: message.creator?.id,
+                senderName: message.creator?.name,
+                addressee: message.addressee
+            })), {
                 maxTurns: LLM_HISTORY_MAX_TURNS,
                 truncateAfterMessageId: input.truncateAfterMessageId,
                 /* The message just stored is this turn's question — truncation must never drop it. */
@@ -287,22 +368,46 @@ let AssistantChatResolver = class AssistantChatResolver {
         const result = await (0, ai_client_base_1.registryAssistantChat)({
             client,
             messages: conversation,
-            systemPrompt: input.systemPrompt,
-            toolCategories: input.toolCategories,
+            systemPrompt: settings.systemPrompt,
+            toolCategories: settings.toolCategories,
             toolAccess: (0, tool_access_js_1.toolAccessFor)(context),
+            /* The stop notice is a sentence a person reads — the server writes it in their language (ADR-0054). */
+            t,
             hostContext: input.hostContext,
+            /*
+             * 근거는 도구 결과만이 아니다 — 시스템 프롬프트 · 이 대화의 말 · 화면이 보낸 스냅숏도 근거다
+             * (`ai-client-base/utils/grounding`). 이 문은 그 셋을 넘기지 않아, **사람이 방금 타이핑한
+             * 식별자**를 되받아 적은 답이 「근거 없음」으로 표시됐다. 그런 경고가 몇 번 나오면 사람이 경고
+             * 자체를 안 보게 된다.
+             */
+            groundingSources: (0, grounding_sources_js_1.groundingSourcesFor)({
+                systemPrompt: settings.systemPrompt,
+                messages: conversation,
+                hostContext: input.hostContext
+            }),
             state: context.state,
-            model: input.model,
-            temperature: input.temperature,
-            maxTokens: input.maxTokens,
-            requireToolOnFirstTurn: input.requireGroundingTools
+            model: settings.model,
+            temperature: settings.temperature,
+            maxTokens: settings.maxTokens,
+            requireToolOnFirstTurn: settings.requireToolOnFirstTurn
         });
+        /*
+         * 이 답이 지나온 문 — ADR-0073 판정 1. 행에도, 목록 미리보기에도 같은 값이 간다. 한쪽만 적으면
+         * 가려진 답이 목록에는 그대로 뜬다.
+         */
+        const answerDoors = (0, message_doors_js_1.doorsForAnswer)((result.loop.toolUsages ?? []).map((usage) => usage?.name).filter(Boolean), name => (0, ai_client_base_1.findToolSpec)(name, settings.toolCategories)?.doors);
         let assistantMessageId;
         if (session) {
             const stored = await messageRepo.save({
                 session: { id: session.id },
                 role: 'assistant',
                 content: result.reply,
+                /*
+                 * 이 답이 지나온 문을 함께 적는다 — ADR-0073 판정 1. 방은 도메인 안에서 공개이므로, 이 문장이
+                 * 실어 나르는 값을 나중에 읽는 사람이 열 수 있는지 판정할 근거가 행에 있어야 한다. 적지 않으면
+                 * 빈 목록이 되고, 빈 목록은 누구나 읽는다는 뜻이다.
+                 */
+                doors: answerDoors,
                 toolUsages: result.loop.toolUsages?.length ? JSON.stringify(result.loop.toolUsages) : undefined,
                 groundingWarnings: result.groundingWarnings?.length ? JSON.stringify(result.groundingWarnings) : undefined,
                 creator: user,
@@ -324,7 +429,23 @@ let AssistantChatResolver = class AssistantChatResolver {
             await sessionRepo.update(session.id, {
                 aiClientId: client.id,
                 updater: user,
-                ...(0, session_inbox_js_1.activityPatch)(result.reply)
+                ...(0, session_inbox_js_1.activityPatch)(result.reply, new Date(), answerDoors)
+            });
+            /*
+             * 상한 밖으로 밀려난 앞부분을 요약으로 접는다 — **답을 돌려준 뒤**에 한다(사용자 대기 시간에
+             * 요약 호출을 얹지 않는다). 기다리지 않으므로 실패해도 대화에는 영향이 없다: 요약이 없으면 다음
+             * 턴이 「N 개 생략」으로 정직하게 알린다.
+             *
+             * 이 문에는 이 호출이 없었다. 조각은 다 있었는데(상한 · 생략 알림 · `lastSummary` · 순수 규칙)
+             * 부르는 쪽이 보드 제품 하나뿐이어서, 앱의 대화는 며칠이 지나도 앞부분을 요약하지 않고 매 턴
+             * 「생략했다」고만 말했다 — 협의가 길어질수록 처음에 합의한 것이 먼저 사라진다.
+             */
+            void (0, fold_session_history_js_1.foldSessionHistory)({
+                sessionId: session.id,
+                domainId: domain.id,
+                client,
+                maxTurns: LLM_HISTORY_MAX_TURNS,
+                locale: context.state?.locale
             });
         }
         return {
@@ -336,7 +457,8 @@ let AssistantChatResolver = class AssistantChatResolver {
             toolUsages: result.loop.toolUsages?.length ? result.loop.toolUsages : null,
             offeredTools: result.offeredTools,
             proposals: result.loop.proposals?.length ? result.loop.proposals : null,
-            groundingWarnings: result.groundingWarnings?.length ? result.groundingWarnings : null
+            groundingWarnings: result.groundingWarnings?.length ? result.groundingWarnings : null,
+            historyFolded: historyFolded ?? null
         };
     }
 };

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

@@ -1 +1 @@
-{"version":3,"file":"assistant-chat-resolver.js","sourceRoot":"","sources":["../../server/service/assistant-chat-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * The neutral door into a conversation.\n *\n * ── Why this exists (2026-09-11) ───────────────────────────────────────────────\n * The chat component moved here from `board-ai`, but the only mutation it could call stayed\n * behind. operato-figure mounted the dock, registered four tools, and got\n * `Cannot query field \"boardAIChat\" on type \"Mutation\"` — it does not load board-ai. The twin has\n * the same shape and it does not show: its space deliberation runs through board-ai's door purely\n * because the board authoring half of the same product already loaded that package.\n *\n * ── Why the board resolver was not moved ───────────────────────────────────────\n * `board-ai-resolver.ts` is 692 lines and the larger part of it is board authoring itself:\n * `currentBoard` as a BoardModel, PatchEntry, board patch broadcasts, refid injection for\n * component mentions. Moving that here would teach this package the board document, which is the\n * dependency we just cut, pointing the other way.\n *\n * So the door moved and the editor did not. `boardAIChat` stays in board-ai for board authoring;\n * this one is for a surface that asks questions and runs registered tools.\n *\n * ── What this is not ───────────────────────────────────────────────────────────\n * It has no document, so it takes no document and returns no patch. Tools that write to a\n * document are not offered here — `registryAssistantChat` enforces that, and it decides what may\n * be dispatched from the same list it offers, so the two cannot drift apart.\n */\nimport { Arg, Ctx, Directive, Field, InputType, Mutation, ObjectType, Resolver } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\nimport '@things-factory/auth-base'\n\nimport { config } from '@things-factory/env'\nimport { getRepository } from '@things-factory/shell'\nimport { createAIClient, getDefaultAIClient, registryAssistantChat, type AIClient } from '@things-factory/ai-client-base'\n\nimport { ChatSession } from './chat-session/chat-session.js'\nimport { assertStationSession } from './chat-session/station-session-guard.js'\nimport { ChatMessage } from './chat-message/chat-message.js'\nimport { buildLlmHistory } from './chat-message/llm-history.js'\nimport { publishChatMessage } from './chat-message/chat-message-publish.js'\nimport { publishSessionActivity } from './chat-session/session-activity-publish.js'\nimport { activityPatch, autoSessionName } from './chat-session/session-inbox.js'\nimport { toolAccessFor } from './tool-access.js'\n\n/**\n * How many stored messages reach the model.\n *\n * A deliberation runs for days. Without a cap the prompt grows without bound and the oldest turns\n * bury the recent ones. Kept the same as the board conversation's cap so the two surfaces of one\n * product do not remember differently.\n */\nconst LLM_HISTORY_MAX_TURNS = 40\n\n@InputType()\nclass AssistantMessageInput {\n  @Field({ description: \"Role: 'user' or 'assistant'\" })\n  role: string\n\n  @Field({ description: 'Message content' })\n  content: string\n}\n\n@InputType({ description: 'One turn of a conversation that has no document of its own.' })\nclass AssistantChatInput {\n  @Field({\n    nullable: true,\n    description: 'ChatSession id. Omit for a one-off question with no persistence.'\n  })\n  sessionId?: string\n\n  @Field(() => [AssistantMessageInput], {\n    description:\n      'Conversation, newest last. For a persisted session only the last user message is appended; the rest is read from storage.'\n  })\n  messages: AssistantMessageInput[]\n\n  @Field({\n    description:\n      'Who the assistant is on this surface, in the words of the product that owns the screen. The rules for using each tool come from whoever registered it and are appended by the server.'\n  })\n  systemPrompt: string\n\n  @Field(() => [String], {\n    nullable: true,\n    description:\n      'Registered tool categories this conversation may use (registerToolCategory names, e.g. [\"figure-authoring\"]). Omitted or empty allows none — a plain conversation. A tool that declares a privilege is offered only to a caller who holds it.'\n  })\n  toolCategories?: string[]\n\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'What this surface is looking at (e.g. { figureId } while modelling). Tools read it so the model never has to ask the user for identifiers. Client-supplied — never used for authorization; a tool verifies the scope belongs to the caller tenant.'\n  })\n  hostContext?: any\n\n  @Field({\n    nullable: true,\n    description:\n      'Last message to keep from the stored history. The client keeps its own truncation when a user edits a message, so pass the last kept id to hide the retracted span from the model.'\n  })\n  truncateAfterMessageId?: string\n\n  @Field({\n    nullable: true,\n    description:\n      'Require a tool call before the model may answer. For surfaces that report live state, where an unchecked assertion reads the same as a checked one.'\n  })\n  requireGroundingTools?: boolean\n\n  @Field({ nullable: true, description: 'Model identifier override. Falls back to the configured default.' })\n  model?: string\n\n  @Field({ nullable: true, description: 'Sampling temperature override.' })\n  temperature?: number\n\n  @Field({ nullable: true, description: 'Max output tokens per call.' })\n  maxTokens?: number\n}\n\n@ObjectType()\nclass AssistantChatOutput {\n  @Field({ description: 'The reply, including the notice when the loop stopped early.' })\n  reply: string\n\n  @Field({ description: 'AI client identifier (provider:model).' })\n  clientId: string\n\n  @Field({ nullable: true, description: 'Echo of the session id, when persisted.' })\n  sessionId?: string\n\n  @Field({ nullable: true, description: 'Stored ChatMessage id of the user input.' })\n  userMessageId?: string\n\n  @Field({ nullable: true, description: 'Stored ChatMessage id of the reply.' })\n  assistantMessageId?: string\n\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description: 'Tool usages during the turn — {name, arguments, result, kind}. The surface shows them foldably.'\n  })\n  toolUsages?: any\n\n  @Field(() => [String], {\n    nullable: true,\n    description:\n      'Tool names offered to the model this turn. A surface that expected a category and sees it missing here knows the registration did not happen, rather than reading a vague answer as a refusal.'\n  })\n  offeredTools?: string[]\n\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Actions a tool recorded without executing — each carries what the tool returned alongside `proposed: true`. The surface renders a confirm button; executing is the user\\'s act.'\n  })\n  proposals?: any\n\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Identifiers in the reply that appear in nothing the model received. Hallucination candidates surfaced to the user; the reply itself is not altered. Null when the answer is grounded.'\n  })\n  groundingWarnings?: any\n}\n\nfunction resolveAIClient(): AIClient | undefined {\n  const existing = getDefaultAIClient()\n  if (existing) return existing\n  const cfg = config.get('aiClient', null) as any\n  if (cfg && cfg.provider) return createAIClient(cfg)\n  return undefined\n}\n\n@Resolver()\nexport class AssistantChatResolver {\n  /*\n   * No `@transaction`, for the same reason the board conversation has none: a model call takes\n   * seconds to tens of seconds, and holding a write lock for that long collides with everything\n   * else on SQLite. Writes are short and around the call. For a conversation, a partly stored\n   * history is safer than a lost one.\n   */\n  @Mutation(() => AssistantChatOutput, {\n    description:\n      'Ask the assistant a question on a surface that has no document of its own. Tools come from the registry; with a sessionId the conversation is persisted.'\n  })\n  /*\n   * `ai-assistant:mutation` — the same door as the board conversation's, which moved here on\n   * 2026-09-10. No `legacy` alias: this operation is new, so no one was ever passing under an old\n   * name, and declaring an alias would open a second name that nothing needs.\n   */\n  @Directive('@privilege(category: \"ai-assistant\", privilege: \"mutation\")')\n  async assistantChat(@Arg('input') input: AssistantChatInput, @Ctx() context: any): Promise<AssistantChatOutput> {\n    const client = resolveAIClient()\n    if (!client) {\n      throw new Error(\n        'No AI client configured. Set config.aiClient = { provider, model, apiKey } or call setDefaultAIClient(...).'\n      )\n    }\n\n    const { domain, user } = context.state\n    const sessionRepo = getRepository(ChatSession)\n    const messageRepo = getRepository(ChatMessage)\n\n    let session: ChatSession | undefined\n    if (input.sessionId) {\n      const found = await sessionRepo.findOneBy({ id: input.sessionId, domain: { id: domain.id } as any })\n      if (!found) throw new Error(`ChatSession ${input.sessionId} not found`)\n      if (found.anchorType === 'figure' && input.hostContext?.figureId !== found.anchorId) {\n        throw new Error('이 대화는 다른 Figure의 이력입니다. 현재 모델의 대화를 다시 여세요.')\n      }\n      if (found.anchorType === 'application' && (input.hostContext?.app !== found.anchorId || input.hostContext?.figureId)) {\n        throw new Error('애플리케이션 대화와 모델 대화를 구분해서 다시 여세요.')\n      }\n      session = found\n    }\n\n    assertStationSession(session, input.hostContext)\n\n    const lastUserMessage = input.messages[input.messages.length - 1]\n    let userMessageId: string | undefined\n\n    if (session && lastUserMessage?.role === 'user') {\n      const previousLast = await messageRepo.findOne({\n        where: { session: { id: session.id } as any },\n        order: { createdAt: 'DESC' }\n      })\n      const saved = await messageRepo.save({\n        session: { id: session.id } as any,\n        role: 'user',\n        content: lastUserMessage.content,\n        creator: user,\n        updater: user,\n        parentMessage: previousLast ? ({ id: previousLast.id } as any) : undefined\n      })\n      userMessageId = saved.id\n\n      /*\n       * Session activity is denormalised for the list: most-recent ordering and another\n       * participant's unread badge read it. Best effort — a conversation must not fail because a\n       * list sorts one position late.\n       */\n      try {\n        const patch: any = activityPatch(lastUserMessage.content)\n        if (!session.name) patch.name = autoSessionName(lastUserMessage.content)\n        await sessionRepo.update(session.id!, patch)\n      } catch {\n        /* noop */\n      }\n\n      publishChatMessage({ domainId: domain.id, sessionId: session.id, message: saved } as any)\n      publishSessionActivity({\n        domainId: domain.id,\n        sessionId: session.id!,\n        kind: 'message',\n        anchorType: (session as any).anchorType,\n        anchorId: (session as any).anchorId,\n        preview: lastUserMessage.content,\n        actorId: user?.id\n      })\n    }\n\n    const conversation = session\n      ? buildLlmHistory(\n          await messageRepo.find({\n            where: { session: { id: session.id } as any },\n            order: { createdAt: 'ASC' },\n            relations: ['creator']\n          }),\n          {\n            maxTurns: LLM_HISTORY_MAX_TURNS,\n            truncateAfterMessageId: input.truncateAfterMessageId,\n            /* The message just stored is this turn's question — truncation must never drop it. */\n            keepMessageIds: userMessageId ? [userMessageId] : undefined,\n            summary: (session as any).lastSummary\n              ? { text: (session as any).lastSummary, upToMessageId: (session as any).summaryUpToMessageId }\n              : undefined\n          }\n        )\n      : input.messages.map(message => ({ role: message.role as any, content: message.content }))\n\n    if (input.hostContext?.image?.data && conversation.length > 0) {\n      const last = conversation[conversation.length - 1]\n      if (last.role === 'user' && typeof last.content === 'string') {\n        const raw = input.hostContext.image\n        const rawData = typeof raw.data === 'string' ? raw.data.replace(/^data:image\\/[a-zA-Z]+;base64,/, '') : raw.data\n        const buf = typeof rawData === 'string' ? Buffer.from(rawData, 'base64') : Buffer.from(rawData)\n        last.content = [\n          { type: 'text', text: last.content },\n          { type: 'image', source: { kind: 'base64', data: buf, mediaType: raw.mediaType || 'image/png' } }\n        ] as any\n      }\n    }\n\n    const result = await registryAssistantChat({\n      client,\n      messages: conversation as any,\n      systemPrompt: input.systemPrompt,\n      toolCategories: input.toolCategories,\n      toolAccess: toolAccessFor(context),\n      hostContext: input.hostContext,\n      state: context.state,\n      model: input.model,\n      temperature: input.temperature,\n      maxTokens: input.maxTokens,\n      requireToolOnFirstTurn: input.requireGroundingTools\n    })\n\n    let assistantMessageId: string | undefined\n    if (session) {\n      const stored = await messageRepo.save({\n        session: { id: session.id } as any,\n        role: 'assistant',\n        content: result.reply,\n        toolUsages: result.loop.toolUsages?.length ? JSON.stringify(result.loop.toolUsages) : undefined,\n        groundingWarnings: result.groundingWarnings?.length ? JSON.stringify(result.groundingWarnings) : undefined,\n        creator: user,\n        updater: user,\n        parentMessage: userMessageId ? ({ id: userMessageId } as any) : undefined\n      })\n      assistantMessageId = stored.id\n\n      publishChatMessage({ domainId: domain.id, sessionId: session.id, message: stored } as any)\n      /* The reply is session activity too. Leaving it out shows other participants \"nothing new\". */\n      publishSessionActivity({\n        domainId: domain.id,\n        sessionId: session.id!,\n        kind: 'message',\n        anchorType: (session as any).anchorType,\n        anchorId: (session as any).anchorId,\n        preview: result.reply,\n        actorId: user?.id\n      })\n\n      await sessionRepo.update(session.id!, {\n        aiClientId: client.id,\n        updater: user,\n        ...activityPatch(result.reply)\n      } as any)\n    }\n\n    return {\n      reply: result.reply,\n      clientId: client.id,\n      sessionId: session?.id,\n      userMessageId,\n      assistantMessageId,\n      toolUsages: result.loop.toolUsages?.length ? result.loop.toolUsages : null,\n      offeredTools: result.offeredTools,\n      proposals: result.loop.proposals?.length ? result.loop.proposals : null,\n      groundingWarnings: result.groundingWarnings?.length ? result.groundingWarnings : null\n    }\n  }\n}\n"]}
+{"version":3,"file":"assistant-chat-resolver.js","sourceRoot":"","sources":["../../server/service/assistant-chat-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * The neutral door into a conversation.\n *\n * ── Why this exists (2026-09-11) ───────────────────────────────────────────────\n * The chat component moved here from `board-ai`, but the only mutation it could call stayed\n * behind. operato-figure mounted the dock, registered four tools, and got\n * `Cannot query field \"boardAIChat\" on type \"Mutation\"` — it does not load board-ai. The twin has\n * the same shape and it does not show: its space deliberation runs through board-ai's door purely\n * because the board authoring half of the same product already loaded that package.\n *\n * ── Why the board resolver was not moved ───────────────────────────────────────\n * `board-ai-resolver.ts` is 692 lines and the larger part of it is board authoring itself:\n * `currentBoard` as a BoardModel, PatchEntry, board patch broadcasts, refid injection for\n * component mentions. Moving that here would teach this package the board document, which is the\n * dependency we just cut, pointing the other way.\n *\n * So the door moved and the editor did not. `boardAIChat` stays in board-ai for board authoring;\n * this one is for a surface that asks questions and runs registered tools.\n *\n * ── What this is not ───────────────────────────────────────────────────────────\n * It has no document, so it takes no document and returns no patch. Tools that write to a\n * document are not offered here — `registryAssistantChat` enforces that, and it decides what may\n * be dispatched from the same list it offers, so the two cannot drift apart.\n */\nimport { Arg, Ctx, Directive, Field, InputType, Mutation, ObjectType, Resolver } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\nimport '@things-factory/auth-base'\n\nimport { config } from '@things-factory/env'\nimport { getRepository } from '@things-factory/shell'\nimport {\n  createAIClient,\n  findToolSpec,\n  getDefaultAIClient,\n  registryAssistantChat,\n  type AIClient\n} from '@things-factory/ai-client-base'\n\nimport { ChatSession } from './chat-session/chat-session.js'\nimport { assertStationSession } from './chat-session/station-session-guard.js'\nimport { ChatMessage } from './chat-message/chat-message.js'\nimport { buildLlmHistory } from './chat-message/llm-history.js'\nimport { splitByCap } from './chat-message/history-summary.js'\nimport { foldSessionHistory } from './chat-message/fold-session-history.js'\nimport { groundingSourcesFor } from './grounding-sources.js'\nimport { publishChatMessage } from './chat-message/chat-message-publish.js'\nimport { publishSessionActivity } from './chat-session/session-activity-publish.js'\nimport { activityPatch, autoSessionName } from './chat-session/session-inbox.js'\nimport { toolAccessFor } from './tool-access.js'\nimport { ChatSessionParticipant } from './chat-session-participant/chat-session-participant.js'\nimport { doorsForAnswer } from './chat-message/message-doors.js'\nimport { readerGate } from './chat-message/reader-gate.js'\nimport { inviteMentionedUsers } from './chat-session-participant/mention-invite.js'\nimport { buildInviteNotification } from './chat-session-participant/invite-notification.js'\nimport { resolveModeSettings } from './assistant-mode/resolve.js'\nimport { requestTranslator } from './request-translator.js'\n\n/**\n * How many stored messages reach the model.\n *\n * A deliberation runs for days. Without a cap the prompt grows without bound and the oldest turns\n * bury the recent ones. Kept the same as the board conversation's cap so the two surfaces of one\n * product do not remember differently.\n */\nconst LLM_HISTORY_MAX_TURNS = 40\n\n@InputType()\nclass AssistantMessageInput {\n  @Field({ description: \"Role: 'user' or 'assistant'\" })\n  role: string\n\n  @Field({ description: 'Message content' })\n  content: string\n}\n\n@InputType({ description: 'Which conversation this is, and what it is about.' })\nclass AssistantModeInput {\n  @Field({ description: 'A mode kind the app server registered — `<app>.<surface>`, e.g. \"twin.space\".' })\n  kind: string\n\n  @Field({\n    nullable: true,\n    description:\n      'What this conversation is about — the space, the station, the model being edited. With `kind` it is the conversation\\'s lifetime: when either changes the screen closes the conversation and starts another.'\n  })\n  target?: string\n}\n\n@InputType({ description: 'One turn of a conversation that has no document of its own.' })\nclass AssistantChatInput {\n  @Field({\n    nullable: true,\n    description: 'ChatSession id. Omit for a one-off question with no persistence.'\n  })\n  sessionId?: string\n\n  @Field(() => [AssistantMessageInput], {\n    description:\n      'Conversation, newest last. For a persisted session only the last user message is appended; the rest is read from storage.'\n  })\n  messages: AssistantMessageInput[]\n\n  @Field(() => AssistantModeInput, {\n    description:\n      'Which conversation this is. The persona, the tool categories, the model and the limits come from the mode the app server registered (ADR-0061 decision 7) — a caller choosing its own tool categories would be a caller choosing its own authority.'\n  })\n  mode: AssistantModeInput\n\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'What this surface is looking at (e.g. { figureId } while modelling). Tools read it so the model never has to ask the user for identifiers. Client-supplied — never used for authorization; a tool verifies the scope belongs to the caller tenant.'\n  })\n  hostContext?: any\n\n  @Field({\n    nullable: true,\n    description:\n      'Last message to keep from the stored history. The client keeps its own truncation when a user edits a message, so pass the last kept id to hide the retracted span from the model.'\n  })\n  truncateAfterMessageId?: string\n\n}\n\n@ObjectType()\nclass AssistantChatOutput {\n  @Field({ description: 'The reply, including the notice when the loop stopped early.' })\n  reply: string\n\n  @Field({ description: 'AI client identifier (provider:model).' })\n  clientId: string\n\n  @Field({ nullable: true, description: 'Echo of the session id, when persisted.' })\n  sessionId?: string\n\n  @Field({ nullable: true, description: 'Stored ChatMessage id of the user input.' })\n  userMessageId?: string\n\n  @Field({ nullable: true, description: 'Stored ChatMessage id of the reply.' })\n  assistantMessageId?: string\n\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Set when this turn did not fit: { omitted, summarized } — how many earlier messages the model did not see, and whether a summary stood in for them. Without it the person watches the conversation lose its beginning in silence, while the model is told.'\n  })\n  historyFolded?: any\n\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description: 'Tool usages during the turn — {name, arguments, result, kind}. The surface shows them foldably.'\n  })\n  toolUsages?: any\n\n  @Field(() => [String], {\n    nullable: true,\n    description:\n      'Tool names offered to the model this turn. A surface that expected a category and sees it missing here knows the registration did not happen, rather than reading a vague answer as a refusal.'\n  })\n  offeredTools?: string[]\n\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Actions a tool recorded without executing — each carries what the tool returned alongside `proposed: true`. The surface renders a confirm button; executing is the user\\'s act.'\n  })\n  proposals?: any\n\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Identifiers in the reply that appear in nothing the model received. Hallucination candidates surfaced to the user; the reply itself is not altered. Null when the answer is grounded.'\n  })\n  groundingWarnings?: any\n}\n\nfunction resolveAIClient(): AIClient | undefined {\n  const existing = getDefaultAIClient()\n  if (existing) return existing\n  const cfg = config.get('aiClient', null) as any\n  if (cfg && cfg.provider) return createAIClient(cfg)\n  return undefined\n}\n\n@Resolver()\nexport class AssistantChatResolver {\n  /*\n   * No `@transaction`, for the same reason the board conversation has none: a model call takes\n   * seconds to tens of seconds, and holding a write lock for that long collides with everything\n   * else on SQLite. Writes are short and around the call. For a conversation, a partly stored\n   * history is safer than a lost one.\n   */\n  @Mutation(() => AssistantChatOutput, {\n    description:\n      'Ask the assistant a question on a surface that has no document of its own. Tools come from the registry; with a sessionId the conversation is persisted.'\n  })\n  /*\n   * `ai-assistant:mutation` — the same door as the board conversation's, which moved here on\n   * 2026-09-10. No `legacy` alias: this operation is new, so no one was ever passing under an old\n   * name, and declaring an alias would open a second name that nothing needs.\n   */\n  @Directive('@privilege(category: \"ai-assistant\", privilege: \"mutation\")')\n  async assistantChat(@Arg('input') input: AssistantChatInput, @Ctx() context: any): Promise<AssistantChatOutput> {\n    const client = resolveAIClient()\n    if (!client) {\n      throw new Error(\n        'No AI client configured. Set config.aiClient = { provider, model, apiKey } or call setDefaultAIClient(...).'\n      )\n    }\n\n    /*\n     * Read the declaration before anything is stored. A kind this server does not have is a\n     * mismatched deployment, and the person should see that instead of a conversation with no\n     * persona and no tools.\n     */\n    const t = requestTranslator(context)\n    const settings = resolveModeSettings(input.mode, t)\n\n    const { domain, user } = context.state\n    const sessionRepo = getRepository(ChatSession)\n    const messageRepo = getRepository(ChatMessage)\n\n    let session: ChatSession | undefined\n    if (input.sessionId) {\n      const found = await sessionRepo.findOneBy({ id: input.sessionId, domain: { id: domain.id } as any })\n      if (!found) throw new Error(`ChatSession ${input.sessionId} not found`)\n      if (found.anchorType === 'figure' && input.hostContext?.figureId !== found.anchorId) {\n        throw new Error(\n          context.t('ai-assistant.text.other-figure-history', {\n            defaultValue: 'this conversation belongs to another figure. open the conversation of the model you have open.'\n          })\n        )\n      }\n      if (found.anchorType === 'application' && (input.hostContext?.app !== found.anchorId || input.hostContext?.figureId)) {\n        throw new Error(\n          context.t('ai-assistant.text.application-vs-model-history', {\n            defaultValue: 'this conversation is about the application, not about a model. open the one you want.'\n          })\n        )\n      }\n      session = found\n    }\n\n    assertStationSession(session, input.hostContext, t)\n\n    const lastUserMessage = input.messages[input.messages.length - 1]\n    let userMessageId: string | undefined\n\n    if (session && lastUserMessage?.role === 'user') {\n      const previousLast = await messageRepo.findOne({\n        where: { session: { id: session.id } as any },\n        order: { createdAt: 'DESC' }\n      })\n      const saved = await messageRepo.save({\n        session: { id: session.id } as any,\n        role: 'user',\n        content: lastUserMessage.content,\n        /*\n         * This door is the one people call to ask the assistant, so a turn stored here was for the\n         * assistant (ADR-0070 A15 decision ①). The value comes from which door was called, never\n         * from the request — two sources for one fact can disagree.\n         */\n        addressee: 'assistant',\n        creator: user,\n        updater: user,\n        parentMessage: previousLast ? ({ id: previousLast.id } as any) : undefined\n      })\n      userMessageId = saved.id\n\n      /*\n       * Session activity is denormalised for the list: most-recent ordering and another\n       * participant's unread badge read it. Best effort — a conversation must not fail because a\n       * list sorts one position late.\n       */\n      try {\n        const patch: any = activityPatch(lastUserMessage.content)\n        if (!session.name) patch.name = autoSessionName(lastUserMessage.content)\n        await sessionRepo.update(session.id!, patch)\n      } catch {\n        /* noop */\n      }\n\n      /*\n       * 사람이 `@이름` 으로 부른 사람은 이 대화에 들어온다(ADR-0071 결정 1). 이 문은 **사람의 턴**을\n       * 저장하는 문이라 그 일을 한다 — 모델의 답이나 도구 결과는 아무도 초대하지 않는다.\n       */\n      const invite = await inviteMentionedUsers({\n        content: lastUserMessage.content,\n        sessionId: session.id!,\n        domainId: domain.id,\n        inviter: user,\n        participants: getRepository(ChatSessionParticipant),\n        visibility: (session as any).visibility\n      })\n      if (invite.invited.length > 0) {\n        const payload = buildInviteNotification(invite.invited, undefined, user)\n        try {\n          if (payload) await (context.state as any)?.notify?.(payload)\n        } catch {\n          /* 편지가 못 갔다고 방에 들어온 사실이 취소되지는 않는다. */\n        }\n      }\n\n      publishChatMessage({ domainId: domain.id, sessionId: session.id, message: saved } as any)\n      publishSessionActivity({\n        domainId: domain.id,\n        sessionId: session.id!,\n        kind: 'message',\n        anchorType: (session as any).anchorType,\n        anchorId: (session as any).anchorId,\n        preview: lastUserMessage.content,\n        actorId: user?.id\n      })\n    }\n\n    /*\n     * 이번 턴에 상한 밖으로 밀려난 것이 있는가 — 화면이 「대화가 길어졌다」를 알릴 근거다.\n     *\n     * 이 문은 그 사실을 내지 않았다. 대화창에는 그 안내를 그리는 자리가 있고(`historyFolded`), 보드\n     * 문만 그 값을 채웠다. 그래서 앱의 대화는 앞부분이 잘려 나가도 **사람에게는 아무 말도 하지 않았다** —\n     * 모델에게는 「N 개 생략」을 적어 보내면서.\n     */\n    const readRows = session\n      ? await messageRepo.find({\n          where: { session: { id: session.id } as any },\n          order: { createdAt: 'ASC' },\n          relations: ['creator']\n        })\n      : []\n    /*\n     * 모델이 읽는 이력도 **부른 사람** 기준으로 가린다 — ADR-0073 판정 1. 가리지 않으면, 문을 한 번도\n     * 안 지난 사람이 \"아까 그 수 다시 말해 줘\" 한 마디로 값을 가져간다. 모델이 옮겨 적는 순간 그 값은\n     * 문 없는 새 답이 된다. 가린 자리를 지우지 않고 한 줄로 남기는 이유도 같다 — 지우면 모델이 그런\n     * 말이 없었다고 답하고, 그것은 거짓말이다.\n     */\n    const storedRows = await readerGate(context)(readRows)\n    const capped = splitByCap(\n      storedRows.map(row => ({ id: row.id, role: row.role, content: row.content ?? '' })),\n      LLM_HISTORY_MAX_TURNS\n    )\n    const historyFolded =\n      capped.dropped.length > 0\n        ? { omitted: capped.dropped.length, summarized: Boolean((session as any)?.lastSummary) }\n        : undefined\n\n    const conversation = session\n      ? buildLlmHistory(\n          /*\n           * The model reads who spoke and who they spoke to. The entity carries the speaker as a\n           * relation and the addressee as a column; the history wants them as plain fields, and\n           * without this mapping every line arrived unattributed — a room of people read as one\n           * voice (ADR-0070 A15 decision ②).\n           */\n          storedRows.map(message => ({\n            id: message.id,\n            role: message.role,\n            content: message.content,\n            senderId: (message as any).creator?.id,\n            senderName: (message as any).creator?.name,\n            addressee: (message as any).addressee\n          })),\n          {\n            maxTurns: LLM_HISTORY_MAX_TURNS,\n            truncateAfterMessageId: input.truncateAfterMessageId,\n            /* The message just stored is this turn's question — truncation must never drop it. */\n            keepMessageIds: userMessageId ? [userMessageId] : undefined,\n            summary: (session as any).lastSummary\n              ? { text: (session as any).lastSummary, upToMessageId: (session as any).summaryUpToMessageId }\n              : undefined\n          }\n        )\n      : input.messages.map(message => ({ role: message.role as any, content: message.content }))\n\n    if (input.hostContext?.image?.data && conversation.length > 0) {\n      const last = conversation[conversation.length - 1]\n      if (last.role === 'user' && typeof last.content === 'string') {\n        const raw = input.hostContext.image\n        const rawData = typeof raw.data === 'string' ? raw.data.replace(/^data:image\\/[a-zA-Z]+;base64,/, '') : raw.data\n        const buf = typeof rawData === 'string' ? Buffer.from(rawData, 'base64') : Buffer.from(rawData)\n        last.content = [\n          { type: 'text', text: last.content },\n          { type: 'image', source: { kind: 'base64', data: buf, mediaType: raw.mediaType || 'image/png' } }\n        ] as any\n      }\n    }\n\n    const result = await registryAssistantChat({\n      client,\n      messages: conversation as any,\n      systemPrompt: settings.systemPrompt,\n      toolCategories: settings.toolCategories,\n      toolAccess: toolAccessFor(context),\n      /* The stop notice is a sentence a person reads — the server writes it in their language (ADR-0054). */\n      t,\n      hostContext: input.hostContext,\n      /*\n       * 근거는 도구 결과만이 아니다 — 시스템 프롬프트 · 이 대화의 말 · 화면이 보낸 스냅숏도 근거다\n       * (`ai-client-base/utils/grounding`). 이 문은 그 셋을 넘기지 않아, **사람이 방금 타이핑한\n       * 식별자**를 되받아 적은 답이 「근거 없음」으로 표시됐다. 그런 경고가 몇 번 나오면 사람이 경고\n       * 자체를 안 보게 된다.\n       */\n      groundingSources: groundingSourcesFor({\n        systemPrompt: settings.systemPrompt,\n        messages: conversation as any,\n        hostContext: input.hostContext\n      }),\n      state: context.state,\n      model: settings.model,\n      temperature: settings.temperature,\n      maxTokens: settings.maxTokens,\n      requireToolOnFirstTurn: settings.requireToolOnFirstTurn\n    })\n\n    /*\n     * 이 답이 지나온 문 — ADR-0073 판정 1. 행에도, 목록 미리보기에도 같은 값이 간다. 한쪽만 적으면\n     * 가려진 답이 목록에는 그대로 뜬다.\n     */\n    const answerDoors = doorsForAnswer(\n      (result.loop.toolUsages ?? []).map((usage: any) => usage?.name).filter(Boolean),\n      name => (findToolSpec(name, settings.toolCategories) as any)?.doors\n    )\n\n    let assistantMessageId: string | undefined\n    if (session) {\n      const stored = await messageRepo.save({\n        session: { id: session.id } as any,\n        role: 'assistant',\n        content: result.reply,\n        /*\n         * 이 답이 지나온 문을 함께 적는다 — ADR-0073 판정 1. 방은 도메인 안에서 공개이므로, 이 문장이\n         * 실어 나르는 값을 나중에 읽는 사람이 열 수 있는지 판정할 근거가 행에 있어야 한다. 적지 않으면\n         * 빈 목록이 되고, 빈 목록은 누구나 읽는다는 뜻이다.\n         */\n        doors: answerDoors,\n        toolUsages: result.loop.toolUsages?.length ? JSON.stringify(result.loop.toolUsages) : undefined,\n        groundingWarnings: result.groundingWarnings?.length ? JSON.stringify(result.groundingWarnings) : undefined,\n        creator: user,\n        updater: user,\n        parentMessage: userMessageId ? ({ id: userMessageId } as any) : undefined\n      })\n      assistantMessageId = stored.id\n\n      publishChatMessage({ domainId: domain.id, sessionId: session.id, message: stored } as any)\n      /* The reply is session activity too. Leaving it out shows other participants \"nothing new\". */\n      publishSessionActivity({\n        domainId: domain.id,\n        sessionId: session.id!,\n        kind: 'message',\n        anchorType: (session as any).anchorType,\n        anchorId: (session as any).anchorId,\n        preview: result.reply,\n        actorId: user?.id\n      })\n\n      await sessionRepo.update(session.id!, {\n        aiClientId: client.id,\n        updater: user,\n        ...activityPatch(result.reply, new Date(), answerDoors)\n      } as any)\n\n      /*\n       * 상한 밖으로 밀려난 앞부분을 요약으로 접는다 — **답을 돌려준 뒤**에 한다(사용자 대기 시간에\n       * 요약 호출을 얹지 않는다). 기다리지 않으므로 실패해도 대화에는 영향이 없다: 요약이 없으면 다음\n       * 턴이 「N 개 생략」으로 정직하게 알린다.\n       *\n       * 이 문에는 이 호출이 없었다. 조각은 다 있었는데(상한 · 생략 알림 · `lastSummary` · 순수 규칙)\n       * 부르는 쪽이 보드 제품 하나뿐이어서, 앱의 대화는 며칠이 지나도 앞부분을 요약하지 않고 매 턴\n       * 「생략했다」고만 말했다 — 협의가 길어질수록 처음에 합의한 것이 먼저 사라진다.\n       */\n      void foldSessionHistory({\n        sessionId: session.id!,\n        domainId: domain.id,\n        client,\n        maxTurns: LLM_HISTORY_MAX_TURNS,\n        locale: context.state?.locale\n      })\n    }\n\n    return {\n      reply: result.reply,\n      clientId: client.id,\n      sessionId: session?.id,\n      userMessageId,\n      assistantMessageId,\n      toolUsages: result.loop.toolUsages?.length ? result.loop.toolUsages : null,\n      offeredTools: result.offeredTools,\n      proposals: result.loop.proposals?.length ? result.loop.proposals : null,\n      groundingWarnings: result.groundingWarnings?.length ? result.groundingWarnings : null,\n      historyFolded: historyFolded ?? null\n    }\n  }\n}\n"]}

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

@@ -0,0 +1,25 @@
+import '@things-factory/auth-base';
+declare class AssistantModeSlashView {
+    name: string;
+    description: string;
+    template: string;
+}
+declare class AssistantModeView {
+    kind: string;
+    slashTemplates: AssistantModeSlashView[];
+    catalogEntries: any[];
+    proposalChoices: any[];
+    placeholder?: string;
+    footerNotice?: string;
+    stagedNotice?: string;
+}
+declare class AssistantModeChoice {
+    kind: string;
+    label: string;
+    isDefault: boolean;
+}
+export declare class AssistantModeResolver {
+    assistantModes(subject: string, context: any): Promise<AssistantModeChoice[]>;
+    assistantMode(kind: string, context: any): Promise<AssistantModeView>;
+}
+export {};

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

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssistantModeResolver = void 0;
+const tslib_1 = require("tslib");
+/*
+ * The screen asks what its conversation offers.
+ *
+ * The `/` sentences, the `@` catalog and the two notices used to travel from the browser into the
+ * request, which meant the screen and the door could describe the same conversation differently.
+ * They are declared once, in the mode, as i18n keys — and this query hands them over already
+ * written in the request's locale (ADR-0054, and the same rule A11 applied to the stop notice).
+ * The persona, the tool categories and the limits stay on the server: nothing here returns them.
+ */
+const type_graphql_1 = require("type-graphql");
+const graphql_scalars_1 = require("graphql-scalars");
+require("@things-factory/auth-base");
+const resolve_js_1 = require("./resolve.js");
+const registry_js_1 = require("./registry.js");
+const request_translator_js_1 = require("../request-translator.js");
+let AssistantModeSlashView = class AssistantModeSlashView {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Short name shown in the list.' }),
+    tslib_1.__metadata("design:type", String)
+], AssistantModeSlashView.prototype, "name", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'One line about what it does.' }),
+    tslib_1.__metadata("design:type", String)
+], AssistantModeSlashView.prototype, "description", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'The sentence that lands in the input.' }),
+    tslib_1.__metadata("design:type", String)
+], AssistantModeSlashView.prototype, "template", void 0);
+AssistantModeSlashView = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'One `/` sentence, in the words of this request.' })
+], AssistantModeSlashView);
+let AssistantModeView = class AssistantModeView {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'The mode kind this describes.' }),
+    tslib_1.__metadata("design:type", String)
+], AssistantModeView.prototype, "kind", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => [AssistantModeSlashView], { description: 'What `/` offers.' }),
+    tslib_1.__metadata("design:type", Array)
+], AssistantModeView.prototype, "slashTemplates", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, { description: 'What `@` offers.' }),
+    tslib_1.__metadata("design:type", Array)
+], AssistantModeView.prototype, "catalogEntries", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)(() => graphql_scalars_1.GraphQLJSON, { description: 'Follow-up chips for a proposal that arrived without its own.' }),
+    tslib_1.__metadata("design:type", Array)
+], AssistantModeView.prototype, "proposalChoices", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'What the empty input says — what this conversation is for.' }),
+    tslib_1.__metadata("design:type", String)
+], AssistantModeView.prototype, "placeholder", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The line under an empty conversation.' }),
+    tslib_1.__metadata("design:type", String)
+], AssistantModeView.prototype, "footerNotice", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The line shown once the host reports a proposal staged.' }),
+    tslib_1.__metadata("design:type", String)
+], AssistantModeView.prototype, "stagedNotice", void 0);
+AssistantModeView = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'What a conversation offers on screen.' })
+], AssistantModeView);
+let AssistantModeChoice = class AssistantModeChoice {
+};
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'The mode kind to open.' }),
+    tslib_1.__metadata("design:type", String)
+], AssistantModeChoice.prototype, "kind", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'What to call it where a person chooses — already in the words of this request.' }),
+    tslib_1.__metadata("design:type", String)
+], AssistantModeChoice.prototype, "label", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ description: 'Whether this is the one to open when the person has not chosen.' }),
+    tslib_1.__metadata("design:type", Boolean)
+], AssistantModeChoice.prototype, "isDefault", void 0);
+AssistantModeChoice = tslib_1.__decorate([
+    (0, type_graphql_1.ObjectType)({ description: 'A conversation a screen may open for what it is showing.' })
+], AssistantModeChoice);
+let AssistantModeResolver = class AssistantModeResolver {
+    /*
+     * 이 화면이 보여 주는 것으로 열 수 있는 대화들 — ADR-0072 A17 ①.
+     *
+     * 화면은 자기가 무엇을 보여 주는지(`subject`)만 안다. 그 위에 어느 대화가 서는지는 앱 서버가
+     * 선언한다. 화면이 종류 목록을 손으로 들고 있으면, 대화를 하나 더 세운 날 그 화면만 모른 채로 남는다.
+     *
+     * 하나만 오면 고르개를 내지 않는다 — 고를 것이 없는 고르개는 자리만 차지한다.
+     */
+    async assistantModes(subject, context) {
+        const t = (0, request_translator_js_1.requestTranslator)(context);
+        return (0, registry_js_1.assistantModesForSubject)(subject).map(mode => ({
+            kind: mode.kind,
+            /*
+             * 이름이 없는 대화는 종류를 그대로 쓴다. 부팅 보고가 이미 그것을 경고로 말하므로 여기서 숨기지
+             * 않는다 — 화면에 `twin.space` 가 뜨면 그것이 빠진 선언을 가리킨다.
+             */
+            label: mode.labelKey ? t(mode.labelKey) : mode.kind,
+            isDefault: (mode.defaultFor ?? []).includes(subject)
+        }));
+    }
+    async assistantMode(kind, context) {
+        return (0, resolve_js_1.assistantModeView)(kind, (0, request_translator_js_1.requestTranslator)(context));
+    }
+};
+exports.AssistantModeResolver = AssistantModeResolver;
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(() => [AssistantModeChoice], {
+        description: 'Conversations that stand for this kind of subject, the default first. A screen showing one subject opens the head of this list and offers the rest; a single entry means there is nothing to choose.'
+    }),
+    (0, type_graphql_1.Directive)('@privilege(category: "ai-assistant", privilege: "query")'),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('subject')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], AssistantModeResolver.prototype, "assistantModes", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Query)(() => AssistantModeView, {
+        description: 'What this conversation offers on screen — `/` sentences, the `@` catalog and the notices, translated.'
+    })
+    /* Reading what a conversation offers is reading, and the same door the session list uses. */
+    ,
+    (0, type_graphql_1.Directive)('@privilege(category: "ai-assistant", privilege: "query")'),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('kind')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
+], AssistantModeResolver.prototype, "assistantMode", null);
+exports.AssistantModeResolver = AssistantModeResolver = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)()
+], AssistantModeResolver);
+//# sourceMappingURL=assistant-mode-resolver.js.map