@things-factory/ai-assistant 10.1.26 → 10.1.28

package/dist-server/service/chat-message/chat-message-subscription.js

@@ -23,6 +23,7 @@ const shell_1 = require("@things-factory/shell");
 const chat_message_js_1 = require("./chat-message.js");
 const chat_message_broadcast_js_1 = require("./chat-message-broadcast.js");
 const subscribe_auth_js_1 = require("../subscribe-auth.js");
+const reader_gate_js_1 = require("./reader-gate.js");
 // publishChatMessage 는 데코레이터 없는 chat-message-publish.ts 에 분리 (테스트 import 가능).
 var chat_message_publish_js_1 = require("./chat-message-publish.js");
 Object.defineProperty(exports, "publishChatMessage", { enumerable: true, get: function () { return chat_message_publish_js_1.publishChatMessage; } });
@@ -30,13 +31,24 @@ var chat_message_broadcast_js_2 = require("./chat-message-broadcast.js");
 Object.defineProperty(exports, "CHAT_MESSAGE_TOPIC", { enumerable: true, get: function () { return chat_message_broadcast_js_2.CHAT_MESSAGE_TOPIC; } });
 Object.defineProperty(exports, "chatMessageFilter", { enumerable: true, get: function () { return chat_message_broadcast_js_2.chatMessageFilter; } });
 let ChatMessageSubscription = class ChatMessageSubscription {
-    chatMessageActivity(payload, sessionId) {
-        return payload.message;
+    /*
+     * 방송도 **받는 사람 기준으로** 가린다 — ADR-0073 판정 1. 저장해 놓고 읽을 때만 가리면, 그 자리에
+     * 앉아 있던 사람은 방송으로 원문을 받는다. 같은 값이 두 길로 나가고 한쪽만 문을 본다.
+     */
+    async chatMessageActivity(payload, sessionId, context) {
+        const [message] = await (0, reader_gate_js_1.readerGate)(context)([payload.message]);
+        return message;
     }
 };
 exports.ChatMessageSubscription = ChatMessageSubscription;
 tslib_1.__decorate([
-    (0, type_graphql_1.Subscription)({
+    (0, type_graphql_1.Subscription)(() => chat_message_js_1.ChatMessage, {
+        /*
+         * 돌려주는 형을 **명시한다**. 이 핸들러가 async 가 되면서(받는 사람마다 가리기 — ADR-0073 판정 1)
+         * 반환형이 `Promise<ChatMessage>` 가 되었고, type-graphql 의 reflection 은 Promise 안을 못 본다.
+         * 빠지면 스키마를 세울 때 NoExplicitTypeError 로 **패키지 적재 자체가 실패한다** — 시험이 아니라
+         * 부팅이 죽는다. plant 레인이 설치본에서 이 오류를 잡아 알려 주었다(2026-09-18).
+         */
         description: 'Subscribes to chat messages (user / assistant / system) of a session for real-time group chat.',
         subscribe: async ({ args, context }) => {
             const { domain, user } = context.state;
@@ -44,12 +56,18 @@ tslib_1.__decorate([
             await (0, subscribe_auth_js_1.assertDomainSubscribeAllowed)(domain, user, (d, u) => process.superUserGranted(d, u));
             return (0, graphql_yoga_1.pipe)(shell_1.pubsub.subscribe(chat_message_broadcast_js_1.CHAT_MESSAGE_TOPIC), (0, graphql_yoga_1.filter)((0, chat_message_broadcast_js_1.chatMessageFilter)(domain.id, sessionId)));
         }
-    }),
+    })
+    /*
+     * 방송도 **받는 사람 기준으로** 가린다 — ADR-0073 판정 1. 저장해 놓고 읽을 때만 가리면, 그 자리에
+     * 앉아 있던 사람은 방송으로 원문을 받는다. 같은 값이 두 길로 나가고 한쪽만 문을 본다.
+     */
+    ,
     tslib_1.__param(0, (0, type_graphql_1.Root)()),
     tslib_1.__param(1, (0, type_graphql_1.Arg)('sessionId')),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
     tslib_1.__metadata("design:type", Function),
-    tslib_1.__metadata("design:paramtypes", [Object, String]),
-    tslib_1.__metadata("design:returntype", chat_message_js_1.ChatMessage)
+    tslib_1.__metadata("design:paramtypes", [Object, String, Object]),
+    tslib_1.__metadata("design:returntype", Promise)
 ], ChatMessageSubscription.prototype, "chatMessageActivity", null);
 exports.ChatMessageSubscription = ChatMessageSubscription = tslib_1.__decorate([
     (0, type_graphql_1.Resolver)(chat_message_js_1.ChatMessage)

package/dist-server/service/chat-message/chat-message-subscription.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-message-subscription.js","sourceRoot":"","sources":["../../../server/service/chat-message/chat-message-subscription.ts"],"names":[],"mappings":";;;;AAAA;;;;;;;;;;;;;;GAcG;AACH,+CAAgE;AAChE,+CAA2C;AAC3C,iDAA8C;AAC9C,uDAA+C;AAC/C,2EAA4G;AAC5G,4DAAmE;AAEnE,8EAA8E;AAC9E,qEAA8D;AAArD,6HAAA,kBAAkB,OAAA;AAC3B,yEAAmF;AAA1E,+HAAA,kBAAkB,OAAA;AAAE,8HAAA,iBAAiB,OAAA;AAIvC,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAalC,mBAAmB,CAAS,OAA2B,EAAoB,SAAiB;QAC1F,OAAO,OAAO,CAAC,OAAO,CAAA;IACxB,CAAC;CACF,CAAA;AAhBY,0DAAuB;AAalC;IAZC,IAAA,2BAAY,EAAC;QACZ,WAAW,EACT,gGAAgG;QAClG,SAAS,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;YACrC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;YACtC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;YAE1B,MAAM,IAAA,gDAA4B,EAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAE1F,OAAO,IAAA,mBAAI,EAAC,cAAM,CAAC,SAAS,CAAC,8CAAkB,CAAC,EAAE,IAAA,qBAAM,EAAC,IAAA,6CAAiB,EAAC,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;QACpG,CAAC;KACF,CAAC;IACmB,mBAAA,IAAA,mBAAI,GAAE,CAAA;IAA+B,mBAAA,IAAA,kBAAG,EAAC,WAAW,CAAC,CAAA;;;4CAAqB,6BAAW;kEAEzG;kCAfU,uBAAuB;IADnC,IAAA,uBAAQ,EAAC,6BAAW,CAAC;GACT,uBAAuB,CAgBnC","sourcesContent":["/*\n * ChatMessageSubscription — 그룹챗 메시지 실시간 방송.\n *\n * 클래스 이름이 `BoardChatMessageSubscription` 이었다. 전선 이름(`chatMessageActivity`)은 처음부터\n * 중립이었고 클래스 이름만 보드였다 — 중립 패키지로 옮기면서 고쳤다(2026-09-10). 전선이 안 바뀌므로\n * 소비처는 그대로다.\n *\n * ChatMessage(사용자 / AI / system) 가 영속될 때마다 같은 세션 구독자에게 방송 →\n * 그룹챗의 척추. 클라이언트(board-ai-chat)가 구독해 원격 메시지를 transcript 에 append.\n * 자기 발신 에코는 클라이언트가 message.id 로 dedup (mutation 응답으로 이미 렌더).\n *\n * patch spine(board-patch-subscription.ts)과 동일 패턴 — PubSub + graphql-ws, domain 격리.\n * 차이: 필터 키가 board 가 아닌 sessionId (채팅은 ChatSession 단위).\n * 순수 로직(토픽/필터)은 chat-message-broadcast.ts (테스트 가능). 여기엔 pubsub 의존만.\n */\nimport { Resolver, Subscription, Root, Arg } from 'type-graphql'\nimport { filter, pipe } from 'graphql-yoga'\nimport { pubsub } from '@things-factory/shell'\nimport { ChatMessage } from './chat-message.js'\nimport { CHAT_MESSAGE_TOPIC, chatMessageFilter, type ChatMessagePayload } from './chat-message-broadcast.js'\nimport { assertDomainSubscribeAllowed } from '../subscribe-auth.js'\n\n// publishChatMessage 는 데코레이터 없는 chat-message-publish.ts 에 분리 (테스트 import 가능).\nexport { publishChatMessage } from './chat-message-publish.js'\nexport { CHAT_MESSAGE_TOPIC, chatMessageFilter } from './chat-message-broadcast.js'\nexport type { ChatMessagePayload } from './chat-message-broadcast.js'\n\n@Resolver(ChatMessage)\nexport class ChatMessageSubscription {\n  @Subscription({\n    description:\n      'Subscribes to chat messages (user / assistant / system) of a session for real-time group chat.',\n    subscribe: async ({ args, context }) => {\n      const { domain, user } = context.state\n      const { sessionId } = args\n\n      await assertDomainSubscribeAllowed(domain, user, (d, u) => process.superUserGranted(d, u))\n\n      return pipe(pubsub.subscribe(CHAT_MESSAGE_TOPIC), filter(chatMessageFilter(domain.id, sessionId)))\n    }\n  })\n  chatMessageActivity(@Root() payload: ChatMessagePayload, @Arg('sessionId') sessionId: string): ChatMessage {\n    return payload.message\n  }\n}\n"]}
+{"version":3,"file":"chat-message-subscription.js","sourceRoot":"","sources":["../../../server/service/chat-message/chat-message-subscription.ts"],"names":[],"mappings":";;;;AAAA;;;;;;;;;;;;;;GAcG;AACH,+CAAqE;AACrE,+CAA2C;AAC3C,iDAA8C;AAC9C,uDAA+C;AAC/C,2EAA4G;AAC5G,4DAAmE;AACnE,qDAA6C;AAE7C,8EAA8E;AAC9E,qEAA8D;AAArD,6HAAA,kBAAkB,OAAA;AAC3B,yEAAmF;AAA1E,+HAAA,kBAAkB,OAAA;AAAE,8HAAA,iBAAiB,OAAA;AAIvC,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAuB5B,AAJN;;;OAGG;IACH,KAAK,CAAC,mBAAmB,CACf,OAA2B,EACjB,SAAiB,EAC5B,OAAY;QAEnB,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,IAAA,2BAAU,EAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;QAC9D,OAAO,OAAsB,CAAA;IAC/B,CAAC;CACF,CAAA;AA/BY,0DAAuB;AAuB5B;IAtBL,IAAA,2BAAY,EAAC,GAAG,EAAE,CAAC,6BAAW,EAAE;QAC/B;;;;;WAKG;QACH,WAAW,EACT,gGAAgG;QAClG,SAAS,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;YACrC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,KAAK,CAAA;YACtC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;YAE1B,MAAM,IAAA,gDAA4B,EAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAE1F,OAAO,IAAA,mBAAI,EAAC,cAAM,CAAC,SAAS,CAAC,8CAAkB,CAAC,EAAE,IAAA,qBAAM,EAAC,IAAA,6CAAiB,EAAC,MAAM,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;QACpG,CAAC;KACF,CAAC;IACF;;;OAGG;;IAEA,mBAAA,IAAA,mBAAI,GAAE,CAAA;IACN,mBAAA,IAAA,kBAAG,EAAC,WAAW,CAAC,CAAA;IAChB,mBAAA,IAAA,kBAAG,GAAE,CAAA;;;;kEAIP;kCA9BU,uBAAuB;IADnC,IAAA,uBAAQ,EAAC,6BAAW,CAAC;GACT,uBAAuB,CA+BnC","sourcesContent":["/*\n * ChatMessageSubscription — 그룹챗 메시지 실시간 방송.\n *\n * 클래스 이름이 `BoardChatMessageSubscription` 이었다. 전선 이름(`chatMessageActivity`)은 처음부터\n * 중립이었고 클래스 이름만 보드였다 — 중립 패키지로 옮기면서 고쳤다(2026-09-10). 전선이 안 바뀌므로\n * 소비처는 그대로다.\n *\n * ChatMessage(사용자 / AI / system) 가 영속될 때마다 같은 세션 구독자에게 방송 →\n * 그룹챗의 척추. 클라이언트(board-ai-chat)가 구독해 원격 메시지를 transcript 에 append.\n * 자기 발신 에코는 클라이언트가 message.id 로 dedup (mutation 응답으로 이미 렌더).\n *\n * patch spine(board-patch-subscription.ts)과 동일 패턴 — PubSub + graphql-ws, domain 격리.\n * 차이: 필터 키가 board 가 아닌 sessionId (채팅은 ChatSession 단위).\n * 순수 로직(토픽/필터)은 chat-message-broadcast.ts (테스트 가능). 여기엔 pubsub 의존만.\n */\nimport { Resolver, Subscription, Root, Arg, Ctx } from 'type-graphql'\nimport { filter, pipe } from 'graphql-yoga'\nimport { pubsub } from '@things-factory/shell'\nimport { ChatMessage } from './chat-message.js'\nimport { CHAT_MESSAGE_TOPIC, chatMessageFilter, type ChatMessagePayload } from './chat-message-broadcast.js'\nimport { assertDomainSubscribeAllowed } from '../subscribe-auth.js'\nimport { readerGate } from './reader-gate.js'\n\n// publishChatMessage 는 데코레이터 없는 chat-message-publish.ts 에 분리 (테스트 import 가능).\nexport { publishChatMessage } from './chat-message-publish.js'\nexport { CHAT_MESSAGE_TOPIC, chatMessageFilter } from './chat-message-broadcast.js'\nexport type { ChatMessagePayload } from './chat-message-broadcast.js'\n\n@Resolver(ChatMessage)\nexport class ChatMessageSubscription {\n  @Subscription(() => ChatMessage, {\n    /*\n     * 돌려주는 형을 **명시한다**. 이 핸들러가 async 가 되면서(받는 사람마다 가리기 — ADR-0073 판정 1)\n     * 반환형이 `Promise<ChatMessage>` 가 되었고, type-graphql 의 reflection 은 Promise 안을 못 본다.\n     * 빠지면 스키마를 세울 때 NoExplicitTypeError 로 **패키지 적재 자체가 실패한다** — 시험이 아니라\n     * 부팅이 죽는다. plant 레인이 설치본에서 이 오류를 잡아 알려 주었다(2026-09-18).\n     */\n    description:\n      'Subscribes to chat messages (user / assistant / system) of a session for real-time group chat.',\n    subscribe: async ({ args, context }) => {\n      const { domain, user } = context.state\n      const { sessionId } = args\n\n      await assertDomainSubscribeAllowed(domain, user, (d, u) => process.superUserGranted(d, u))\n\n      return pipe(pubsub.subscribe(CHAT_MESSAGE_TOPIC), filter(chatMessageFilter(domain.id, sessionId)))\n    }\n  })\n  /*\n   * 방송도 **받는 사람 기준으로** 가린다 — ADR-0073 판정 1. 저장해 놓고 읽을 때만 가리면, 그 자리에\n   * 앉아 있던 사람은 방송으로 원문을 받는다. 같은 값이 두 길로 나가고 한쪽만 문을 본다.\n   */\n  async chatMessageActivity(\n    @Root() payload: ChatMessagePayload,\n    @Arg('sessionId') sessionId: string,\n    @Ctx() context: any\n  ): Promise<ChatMessage> {\n    const [message] = await readerGate(context)([payload.message])\n    return message as ChatMessage\n  }\n}\n"]}

package/dist-server/service/chat-message/chat-message.d.ts

@@ -6,6 +6,38 @@ export declare class ChatMessage {
     sessionId?: string;
     role: string;
     content: string;
+    /**
+     * 이 말이 누구에게 한 말인가 — `'assistant'` · `'room'`(ADR-0070 A15 결정 ①).
+     *
+     * **값은 그 행을 쓴 문이 찍는다.** 어시스턴트에게 묻는 문(`assistantChat`)이 저장한 사람의 행은
+     * `assistant` 이고, 사람끼리의 문(`appendSessionTurns`)이 저장한 행은 `room` 이다. 클라이언트가
+     * 인자로 보내지 않는다 — 인자로 받으면 「어느 문을 불렀나」와 「무엇을 적어 보냈나」 두 사실이
+     * 생기고, 둘은 어긋날 수 있다.
+     *
+     * 사람의 행에만 뜻이 있다. 어시스턴트의 답은 `parentMessage` 로 자기를 부른 턴에 귀속되고,
+     * `system` 행은 누구에게 한 말이 아니다.
+     */
+    addressee?: string;
+    /**
+     * 이 행의 값이 지나온 문들 — ADR-0073 판정 1.
+     *
+     * 어시스턴트의 답과 제안 행에만 채워진다. 사람의 말은 빈 목록이다 — 사람이 자기 입으로 한 말에는
+     * 문이 없다. 답을 저장할 때 그 턴에 부른 도구들의 `doors`(ADR-0072)를 합쳐 옮겨 적는다.
+     *
+     * 읽을 때마다 **읽는 사람**이 이 문을 전부 지나는지 보고, 못 지나면 본문 대신 한 줄이 나간다. 그래서
+     * 이 칸은 "누가 볼 수 있나"를 적은 것이고, 저장된 값 자체는 누구에게도 달라지지 않는다.
+     *
+     * 목록이 비면 누구나 읽는다. 등록기가 모르는 도구가 답에 끼면 `unresolved:<도구>` 가 적히고 아무도
+     * 못 지난다 — 모르는 값은 가려지는 쪽으로 넘어뜨린다.
+     */
+    doors?: string[];
+    /**
+     * 이 행이 **이 사람에게** 가려져 나갔는가 — 저장하지 않는다.
+     *
+     * 같은 행이 사람마다 다르게 나가므로 칸에 적을 값이 없다. 읽어 나갈 때 채운다. 화면은 이것으로
+     * 자물쇠를 그리고, 본문에 온 한 줄을 어시스턴트의 말로 오해하지 않는다.
+     */
+    redacted?: boolean;
     relatedPatchId?: string;
     relatedImportSessionId?: string;
     /**

package/dist-server/service/chat-message/chat-message.js

@@ -75,6 +75,23 @@ tslib_1.__decorate([
     (0, type_graphql_1.Field)({ description: 'Message content' }),
     tslib_1.__metadata("design:type", String)
 ], ChatMessage.prototype, "content", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'varchar', length: 16, nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: "Who this turn was for: 'assistant' | 'room'. Written by the door that stored it, never sent by the client." }),
+    tslib_1.__metadata("design:type", String)
+], ChatMessage.prototype, "addressee", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'simple-array', nullable: true }),
+    (0, type_graphql_1.Field)(() => [String], {
+        nullable: true,
+        description: 'GraphQL doors the tools behind this answer went through. Empty for what people typed. A reader who does not pass all of them gets a one-line notice in place of the content.'
+    }),
+    tslib_1.__metadata("design:type", Array)
+], ChatMessage.prototype, "doors", void 0);
+tslib_1.__decorate([
+    (0, type_graphql_1.Field)({ nullable: true, description: 'True when the content was replaced because this reader does not pass the row doors.' }),
+    tslib_1.__metadata("design:type", Boolean)
+], ChatMessage.prototype, "redacted", void 0);
 tslib_1.__decorate([
     (0, typeorm_1.Column)({ nullable: true }),
     (0, type_graphql_1.Field)({ nullable: true, description: 'PatchEntry.id this message triggered (if any).' }),

package/dist-server/service/chat-message/chat-message.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat-message.js","sourceRoot":"","sources":["../../../server/service/chat-message/chat-message.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ChatMessage — ChatSession 의 한 메시지.\n *\n * role: 'user' | 'assistant' | 'system'\n * 'system' 은 사용자 직접 편집/import 진행 등 시스템이 자동 생성하는 컨텍스트 메시지.\n *\n * relatedPatchId / relatedImportSessionId 로 메시지가 트리거한 패치·임포트와 연결.\n */\nimport {\n  Column,\n  CreateDateColumn,\n  DeleteDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\nimport { Field, ID, ObjectType } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\n\nimport { User } from '@things-factory/auth-base'\nimport { config } from '@things-factory/env'\n\nimport { ChatSession } from '../chat-session/chat-session.js'\n\nconst ORMCONFIG = config.get('ormconfig', {})\nconst DATABASE_TYPE = ORMCONFIG.type\n\n@Entity()\n@Index('ix_chat_message_1', (message: ChatMessage) => [message.session, message.createdAt])\n@ObjectType({ description: 'A single chat message in a ChatSession.' })\nexport class ChatMessage {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { nullable: true })\n  readonly id?: string\n\n  @ManyToOne(type => ChatSession, session => session.messages, { onDelete: 'CASCADE' })\n  session?: ChatSession\n\n  @RelationId((message: ChatMessage) => message.session)\n  sessionId?: string\n\n  @Column({ type: 'varchar', length: 16 })\n  @Field({ description: \"'user' | 'assistant' | 'system'\" })\n  role!: string\n\n  @Column({\n    type:\n      DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'\n        ? 'longtext'\n        : DATABASE_TYPE == 'oracle'\n          ? 'clob'\n          : DATABASE_TYPE == 'mssql'\n            ? 'nvarchar'\n            : 'text',\n    length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined\n  })\n  @Field({ description: 'Message content' })\n  content!: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'PatchEntry.id this message triggered (if any).' })\n  relatedPatchId?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'ImportSession.id this message triggered (if any).' })\n  relatedImportSessionId?: string\n\n  /**\n   * AI 가 응답을 만드는 동안 호출한 도구 trace — JSON-stringified.\n   *\n   * 컬럼은 string (PatchEntry.ops 와 동일 패턴), GraphQL 노출은 toolUsagesJson getter\n   * 로 parse 된 객체. UI 의 fold-able 박스 (\"AI 가 이런 도구를 사용했습니다\") 가\n   * 페이지 reload / loadHistory 후에도 살아있도록 영속.\n   *\n   * 형태: ToolUsage[] (assistant.ts 의 시간순 trace, summarizeToolResult 로 압축).\n   * null 이면 도구 호출 없었던 메시지 (text-only 응답).\n   */\n  @Column({\n    type:\n      DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'\n        ? 'longtext'\n        : DATABASE_TYPE == 'oracle'\n          ? 'clob'\n          : DATABASE_TYPE == 'mssql'\n            ? 'nvarchar'\n            : 'text',\n    length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined,\n    nullable: true\n  })\n  toolUsages?: string\n\n  /** GraphQL 노출용 — JSON 배열로 parse. */\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Tool usage trace — array of {name, arguments, result, kind}. Only on assistant messages.'\n  })\n  get toolUsagesJson(): any {\n    if (!this.toolUsages) return null\n    try {\n      return JSON.parse(this.toolUsages)\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * 접지 경고 — 이 답이 언급했으나 근거(프롬프트·보드 문맥·이력·도구 결과)에 없던 식별자 목록.\n   *\n   * **왜 영속하는가**: 도크의 협의는 여러 사람이 며칠에 걸쳐 읽는다. 경고가 그 자리에서만\n   * 보이고 새로 고치면 사라지면, 나중에 읽는 사람은 검증되지 않은 문장을 검증된 것으로 읽는다.\n   * 다시 계산할 수도 없다 — 근거였던 도구 결과 원문은 남지 않고 압축본만 남기 때문이다.\n   *\n   * 형태: string[] 를 JSON-stringify. 비었으면 null(= 접지 정상).\n   */\n  @Column({ type: 'varchar', length: 1024, nullable: true })\n  groundingWarnings?: string\n\n  /** GraphQL 노출용 — 식별자 배열로 parse. */\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description: 'Ungrounded identifiers mentioned by this reply (hallucination candidates). Null when grounded.'\n  })\n  get groundingWarningsJson(): any {\n    if (!this.groundingWarnings) return null\n    try {\n      return JSON.parse(this.groundingWarnings)\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * 메시지를 일으킨 사용자.\n   *   - role='user' → 보낸 사용자\n   *   - role='assistant' → 그 응답을 트리거한 사용자 (직전 user 메시지의 작성자)\n   *   - role='system' → 시스템 액션을 일으킨 사용자 (예: 직접 편집한 사용자)\n   *\n   * nullable — legacy 메시지 (이 필드 추가 이전에 작성) 는 null. 또한 ad-hoc 모드 / 시스템\n   * 자동 메시지 중 사용자 컨텍스트가 없는 경우도 null 가능.\n   */\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'User who triggered this message.' })\n  creator?: User\n\n  @RelationId((message: ChatMessage) => message.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'Last user to update this message (for future edit support).' })\n  updater?: User\n\n  @RelationId((message: ChatMessage) => message.updater)\n  updaterId?: string\n\n  /**\n   * 부모 메시지 — 이 메시지가 \"응답하는 대상\" / \"이어가는 메시지\" 의 id.\n   *\n   * 의미 (role 별):\n   *   - 'user' → 직전 in-session 메시지 (보통 assistant 또는 system). 첫 turn 은 null.\n   *   - 'assistant' → 이 응답이 답하는 user 메시지. (regenerate 로 같은 user 메시지를 부모로\n   *     하는 형제 assistant 메시지가 생기면 자연스럽게 branching tree 가 됨)\n   *   - 'system' → 직전 in-session 메시지 (timeline 연속성 유지).\n   *\n   * 이 한 컬럼으로 향후 어떤 흐름이든 표현 가능 — linear chain / branching (regenerate) /\n   * tree (replies-to-specific-message) 등. UI/쿼리는 점진 도입.\n   *\n   * onDelete: 'SET NULL' — 부모 메시지가 삭제돼도 child 는 남되 dangling 마킹.\n   */\n  @ManyToOne(type => ChatMessage, { nullable: true, onDelete: 'SET NULL' })\n  parentMessage?: ChatMessage\n\n  @RelationId((message: ChatMessage) => message.parentMessage)\n  @Field({\n    nullable: true,\n    description:\n      'Id of the message this one is in-response-to / continues. Enables linear / branching / tree structures.'\n  })\n  parentMessageId?: string\n\n  @CreateDateColumn()\n  @Field({ nullable: true, description: 'Creation timestamp.' })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true, description: 'Last update timestamp (relevant once message editing is supported).' })\n  updatedAt?: Date\n\n  @DeleteDateColumn()\n  @Field({ nullable: true, description: 'Soft delete timestamp.' })\n  deletedAt?: Date\n}\n"]}
+{"version":3,"file":"chat-message.js","sourceRoot":"","sources":["../../../server/service/chat-message/chat-message.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ChatMessage — ChatSession 의 한 메시지.\n *\n * role: 'user' | 'assistant' | 'system'\n * 'system' 은 사용자 직접 편집/import 진행 등 시스템이 자동 생성하는 컨텍스트 메시지.\n *\n * relatedPatchId / relatedImportSessionId 로 메시지가 트리거한 패치·임포트와 연결.\n */\nimport {\n  Column,\n  CreateDateColumn,\n  DeleteDateColumn,\n  Entity,\n  Index,\n  ManyToOne,\n  PrimaryGeneratedColumn,\n  RelationId,\n  UpdateDateColumn\n} from 'typeorm'\nimport { Field, ID, ObjectType } from 'type-graphql'\nimport { GraphQLJSON } from 'graphql-scalars'\n\nimport { User } from '@things-factory/auth-base'\nimport { config } from '@things-factory/env'\n\nimport { ChatSession } from '../chat-session/chat-session.js'\n\nconst ORMCONFIG = config.get('ormconfig', {})\nconst DATABASE_TYPE = ORMCONFIG.type\n\n@Entity()\n@Index('ix_chat_message_1', (message: ChatMessage) => [message.session, message.createdAt])\n@ObjectType({ description: 'A single chat message in a ChatSession.' })\nexport class ChatMessage {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { nullable: true })\n  readonly id?: string\n\n  @ManyToOne(type => ChatSession, session => session.messages, { onDelete: 'CASCADE' })\n  session?: ChatSession\n\n  @RelationId((message: ChatMessage) => message.session)\n  sessionId?: string\n\n  @Column({ type: 'varchar', length: 16 })\n  @Field({ description: \"'user' | 'assistant' | 'system'\" })\n  role!: string\n\n  @Column({\n    type:\n      DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'\n        ? 'longtext'\n        : DATABASE_TYPE == 'oracle'\n          ? 'clob'\n          : DATABASE_TYPE == 'mssql'\n            ? 'nvarchar'\n            : 'text',\n    length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined\n  })\n  @Field({ description: 'Message content' })\n  content!: string\n\n  /**\n   * 이 말이 누구에게 한 말인가 — `'assistant'` · `'room'`(ADR-0070 A15 결정 ①).\n   *\n   * **값은 그 행을 쓴 문이 찍는다.** 어시스턴트에게 묻는 문(`assistantChat`)이 저장한 사람의 행은\n   * `assistant` 이고, 사람끼리의 문(`appendSessionTurns`)이 저장한 행은 `room` 이다. 클라이언트가\n   * 인자로 보내지 않는다 — 인자로 받으면 「어느 문을 불렀나」와 「무엇을 적어 보냈나」 두 사실이\n   * 생기고, 둘은 어긋날 수 있다.\n   *\n   * 사람의 행에만 뜻이 있다. 어시스턴트의 답은 `parentMessage` 로 자기를 부른 턴에 귀속되고,\n   * `system` 행은 누구에게 한 말이 아니다.\n   */\n  @Column({ type: 'varchar', length: 16, nullable: true })\n  @Field({ nullable: true, description: \"Who this turn was for: 'assistant' | 'room'. Written by the door that stored it, never sent by the client.\" })\n  addressee?: string\n\n  /**\n   * 이 행의 값이 지나온 문들 — ADR-0073 판정 1.\n   *\n   * 어시스턴트의 답과 제안 행에만 채워진다. 사람의 말은 빈 목록이다 — 사람이 자기 입으로 한 말에는\n   * 문이 없다. 답을 저장할 때 그 턴에 부른 도구들의 `doors`(ADR-0072)를 합쳐 옮겨 적는다.\n   *\n   * 읽을 때마다 **읽는 사람**이 이 문을 전부 지나는지 보고, 못 지나면 본문 대신 한 줄이 나간다. 그래서\n   * 이 칸은 \"누가 볼 수 있나\"를 적은 것이고, 저장된 값 자체는 누구에게도 달라지지 않는다.\n   *\n   * 목록이 비면 누구나 읽는다. 등록기가 모르는 도구가 답에 끼면 `unresolved:<도구>` 가 적히고 아무도\n   * 못 지난다 — 모르는 값은 가려지는 쪽으로 넘어뜨린다.\n   */\n  @Column({ type: 'simple-array', nullable: true })\n  @Field(() => [String], {\n    nullable: true,\n    description:\n      'GraphQL doors the tools behind this answer went through. Empty for what people typed. A reader who does not pass all of them gets a one-line notice in place of the content.'\n  })\n  doors?: string[]\n\n  /**\n   * 이 행이 **이 사람에게** 가려져 나갔는가 — 저장하지 않는다.\n   *\n   * 같은 행이 사람마다 다르게 나가므로 칸에 적을 값이 없다. 읽어 나갈 때 채운다. 화면은 이것으로\n   * 자물쇠를 그리고, 본문에 온 한 줄을 어시스턴트의 말로 오해하지 않는다.\n   */\n  @Field({ nullable: true, description: 'True when the content was replaced because this reader does not pass the row doors.' })\n  redacted?: boolean\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'PatchEntry.id this message triggered (if any).' })\n  relatedPatchId?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'ImportSession.id this message triggered (if any).' })\n  relatedImportSessionId?: string\n\n  /**\n   * AI 가 응답을 만드는 동안 호출한 도구 trace — JSON-stringified.\n   *\n   * 컬럼은 string (PatchEntry.ops 와 동일 패턴), GraphQL 노출은 toolUsagesJson getter\n   * 로 parse 된 객체. UI 의 fold-able 박스 (\"AI 가 이런 도구를 사용했습니다\") 가\n   * 페이지 reload / loadHistory 후에도 살아있도록 영속.\n   *\n   * 형태: ToolUsage[] (assistant.ts 의 시간순 trace, summarizeToolResult 로 압축).\n   * null 이면 도구 호출 없었던 메시지 (text-only 응답).\n   */\n  @Column({\n    type:\n      DATABASE_TYPE == 'mysql' || DATABASE_TYPE == 'mariadb'\n        ? 'longtext'\n        : DATABASE_TYPE == 'oracle'\n          ? 'clob'\n          : DATABASE_TYPE == 'mssql'\n            ? 'nvarchar'\n            : 'text',\n    length: DATABASE_TYPE == 'mssql' ? 'MAX' : undefined,\n    nullable: true\n  })\n  toolUsages?: string\n\n  /** GraphQL 노출용 — JSON 배열로 parse. */\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description:\n      'Tool usage trace — array of {name, arguments, result, kind}. Only on assistant messages.'\n  })\n  get toolUsagesJson(): any {\n    if (!this.toolUsages) return null\n    try {\n      return JSON.parse(this.toolUsages)\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * 접지 경고 — 이 답이 언급했으나 근거(프롬프트·보드 문맥·이력·도구 결과)에 없던 식별자 목록.\n   *\n   * **왜 영속하는가**: 도크의 협의는 여러 사람이 며칠에 걸쳐 읽는다. 경고가 그 자리에서만\n   * 보이고 새로 고치면 사라지면, 나중에 읽는 사람은 검증되지 않은 문장을 검증된 것으로 읽는다.\n   * 다시 계산할 수도 없다 — 근거였던 도구 결과 원문은 남지 않고 압축본만 남기 때문이다.\n   *\n   * 형태: string[] 를 JSON-stringify. 비었으면 null(= 접지 정상).\n   */\n  @Column({ type: 'varchar', length: 1024, nullable: true })\n  groundingWarnings?: string\n\n  /** GraphQL 노출용 — 식별자 배열로 parse. */\n  @Field(() => GraphQLJSON, {\n    nullable: true,\n    description: 'Ungrounded identifiers mentioned by this reply (hallucination candidates). Null when grounded.'\n  })\n  get groundingWarningsJson(): any {\n    if (!this.groundingWarnings) return null\n    try {\n      return JSON.parse(this.groundingWarnings)\n    } catch {\n      return null\n    }\n  }\n\n  /**\n   * 메시지를 일으킨 사용자.\n   *   - role='user' → 보낸 사용자\n   *   - role='assistant' → 그 응답을 트리거한 사용자 (직전 user 메시지의 작성자)\n   *   - role='system' → 시스템 액션을 일으킨 사용자 (예: 직접 편집한 사용자)\n   *\n   * nullable — legacy 메시지 (이 필드 추가 이전에 작성) 는 null. 또한 ad-hoc 모드 / 시스템\n   * 자동 메시지 중 사용자 컨텍스트가 없는 경우도 null 가능.\n   */\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'User who triggered this message.' })\n  creator?: User\n\n  @RelationId((message: ChatMessage) => message.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'Last user to update this message (for future edit support).' })\n  updater?: User\n\n  @RelationId((message: ChatMessage) => message.updater)\n  updaterId?: string\n\n  /**\n   * 부모 메시지 — 이 메시지가 \"응답하는 대상\" / \"이어가는 메시지\" 의 id.\n   *\n   * 의미 (role 별):\n   *   - 'user' → 직전 in-session 메시지 (보통 assistant 또는 system). 첫 turn 은 null.\n   *   - 'assistant' → 이 응답이 답하는 user 메시지. (regenerate 로 같은 user 메시지를 부모로\n   *     하는 형제 assistant 메시지가 생기면 자연스럽게 branching tree 가 됨)\n   *   - 'system' → 직전 in-session 메시지 (timeline 연속성 유지).\n   *\n   * 이 한 컬럼으로 향후 어떤 흐름이든 표현 가능 — linear chain / branching (regenerate) /\n   * tree (replies-to-specific-message) 등. UI/쿼리는 점진 도입.\n   *\n   * onDelete: 'SET NULL' — 부모 메시지가 삭제돼도 child 는 남되 dangling 마킹.\n   */\n  @ManyToOne(type => ChatMessage, { nullable: true, onDelete: 'SET NULL' })\n  parentMessage?: ChatMessage\n\n  @RelationId((message: ChatMessage) => message.parentMessage)\n  @Field({\n    nullable: true,\n    description:\n      'Id of the message this one is in-response-to / continues. Enables linear / branching / tree structures.'\n  })\n  parentMessageId?: string\n\n  @CreateDateColumn()\n  @Field({ nullable: true, description: 'Creation timestamp.' })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true, description: 'Last update timestamp (relevant once message editing is supported).' })\n  updatedAt?: Date\n\n  @DeleteDateColumn()\n  @Field({ nullable: true, description: 'Soft delete timestamp.' })\n  deletedAt?: Date\n}\n"]}

package/dist-server/service/chat-message/door-access.d.ts

@@ -0,0 +1,15 @@
+import type { ToolPrivilege, ToolSpec } from '@things-factory/ai-client-base';
+/** 이 문을 지키는 권한 — 그 문에 닿는다고 선언한 도구에서 가져온다. */
+export declare function doorPrivilege(door: string, specs: readonly ToolSpec[]): ToolPrivilege | undefined;
+export interface DoorCheckDeps {
+    /** 등록된 도구 명세 전부 — 문→권한을 찾는 표 노릇. */
+    specs: readonly ToolSpec[];
+    /** AUTH 조회. `User.hasPrivilege` 를 그대로 싸서 넘긴다. */
+    hasPrivilege(privilege: ToolPrivilege): Promise<boolean>;
+}
+/**
+ * 문 하나를 이 사람이 지나는가 — `doorGate` 에 넣을 검사.
+ *
+ * 되풀이 조회를 줄이는 기억은 `doorGate` 가 한다. 여기는 한 번의 판정만 한다.
+ */
+export declare function doorCheck(deps: DoorCheckDeps): (door: string) => Promise<boolean>;

package/dist-server/service/chat-message/door-access.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.doorPrivilege = doorPrivilege;
+exports.doorCheck = doorCheck;
+/** 이 문을 지키는 권한 — 그 문에 닿는다고 선언한 도구에서 가져온다. */
+function doorPrivilege(door, specs) {
+    for (const spec of specs) {
+        if ((spec.doors ?? []).includes(door))
+            return spec.privilege;
+    }
+    return undefined;
+}
+/**
+ * 문 하나를 이 사람이 지나는가 — `doorGate` 에 넣을 검사.
+ *
+ * 되풀이 조회를 줄이는 기억은 `doorGate` 가 한다. 여기는 한 번의 판정만 한다.
+ */
+function doorCheck(deps) {
+    return async (door) => {
+        const privilege = doorPrivilege(door, deps.specs);
+        if (!privilege)
+            return false;
+        return await deps.hasPrivilege(privilege);
+    };
+}
+//# sourceMappingURL=door-access.js.map

package/dist-server/service/chat-message/door-access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"door-access.js","sourceRoot":"","sources":["../../../server/service/chat-message/door-access.ts"],"names":[],"mappings":";;AAkBA,sCAKC;AAcD,8BAOC;AA3BD,6CAA6C;AAC7C,SAAgB,aAAa,CAAC,IAAY,EAAE,KAA0B;IACpE,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAE,IAAY,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAQ,IAAY,CAAC,SAAS,CAAA;IAChF,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AASD;;;;GAIG;AACH,SAAgB,SAAS,CAAC,IAAmB;IAC3C,OAAO,KAAK,EAAE,IAAY,EAAE,EAAE;QAC5B,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;QACjD,IAAI,CAAC,SAAS;YAAE,OAAO,KAAK,CAAA;QAE5B,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAA;IAC3C,CAAC,CAAA;AACH,CAAC","sourcesContent":["/*\n * 문 → 그 문을 지키는 권한 — ADR-0073 판정 1 의 관문을 세우는 자리.\n *\n * ── 왜 도구 등록기에서 찾나 ───────────────────────────────────────────────\n * 행에 적힌 것은 문 이름(`Query.jobOrders`)이고, 사람이 가진 것은 권한(`job-order:query`)이다. 둘을\n * 잇는 정본은 AUTH 의 필드→권한 표이고, 그 표는 아직 없다(ADR-0072 결정 2 (b) — 수석 아키텍트가 청하기로\n * 되어 있다). 그때까지는 도구 명세가 이미 들고 있는 짝을 쓴다: 그 문에 닿는다고 선언한 도구가 자기\n * 권한도 함께 적어 두었다.\n *\n * **이것은 사본이다.** 표가 서면 `doorPrivilege` 하나만 그 표를 보게 바꾸고 나머지는 그대로 둔다.\n *\n * ── 모르는 문은 닫는다 ────────────────────────────────────────────────────\n * 어느 도구도 그 문을 선언하지 않았으면 무엇이 그 문을 지키는지 알 수 없다. 모를 때 열면, 도구가 사라진\n * 뒤에 남은 옛 답이 전부 공개된다 — 지우는 일이 여는 일이 된다. 닫는 쪽으로 넘어뜨린다.\n */\nimport type { ToolPrivilege, ToolSpec } from '@things-factory/ai-client-base'\n\n/** 이 문을 지키는 권한 — 그 문에 닿는다고 선언한 도구에서 가져온다. */\nexport function doorPrivilege(door: string, specs: readonly ToolSpec[]): ToolPrivilege | undefined {\n  for (const spec of specs) {\n    if (((spec as any).doors ?? []).includes(door)) return (spec as any).privilege\n  }\n  return undefined\n}\n\nexport interface DoorCheckDeps {\n  /** 등록된 도구 명세 전부 — 문→권한을 찾는 표 노릇. */\n  specs: readonly ToolSpec[]\n  /** AUTH 조회. `User.hasPrivilege` 를 그대로 싸서 넘긴다. */\n  hasPrivilege(privilege: ToolPrivilege): Promise<boolean>\n}\n\n/**\n * 문 하나를 이 사람이 지나는가 — `doorGate` 에 넣을 검사.\n *\n * 되풀이 조회를 줄이는 기억은 `doorGate` 가 한다. 여기는 한 번의 판정만 한다.\n */\nexport function doorCheck(deps: DoorCheckDeps): (door: string) => Promise<boolean> {\n  return async (door: string) => {\n    const privilege = doorPrivilege(door, deps.specs)\n    if (!privilege) return false\n\n    return await deps.hasPrivilege(privilege)\n  }\n}\n"]}

package/dist-server/service/chat-message/fold-session-history.d.ts

@@ -0,0 +1,30 @@
+import type { AIClient } from '@things-factory/ai-client-base';
+/** How many newly-dropped turns are worth another summarisation call. */
+export declare const DEFAULT_SUMMARY_THRESHOLD = 10;
+export interface FoldSessionHistoryInput {
+    sessionId: string;
+    domainId: string;
+    /** The same client that answered — a summary is written by whatever this deployment has. */
+    client: Pick<AIClient, 'chat'>;
+    /** The cap the door uses when it builds the history, so both sides agree on what fell off. */
+    maxTurns: number;
+    threshold?: number;
+    locale?: string;
+    /** Test seam: the two repositories this reads and writes. */
+    repos?: {
+        sessions: any;
+        messages: any;
+    };
+}
+/**
+ * Where the rows after the summary's watermark are.
+ *
+ * Kept separate so the window can be read without a database: the array is an OR, and the second
+ * branch continues within one timestamp by id — the same axis the ordering uses, or a burst of
+ * messages in the same millisecond would be summarised twice or not at all.
+ */
+export declare function rowsAfterWatermark(sessionId: string, mark: {
+    id?: string;
+    createdAt?: Date;
+} | undefined): any;
+export declare function foldSessionHistory(input: FoldSessionHistoryInput): Promise<void>;

package/dist-server/service/chat-message/fold-session-history.js

@@ -0,0 +1,133 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SUMMARY_THRESHOLD = void 0;
+exports.rowsAfterWatermark = rowsAfterWatermark;
+exports.foldSessionHistory = foldSessionHistory;
+/*
+ * Folding a long conversation's earlier turns into a summary — for every surface, not only boards.
+ *
+ * ── The gap this closes (2026-09-18) ───────────────────────────────────────────
+ * The pieces were all here: a cap on how many turns reach the model, a notice when turns are left
+ * out, `ChatSession.lastSummary` to carry what was dropped, and pure rules for when to re-summarise
+ * (`history-summary`, `fold-history`). Only the board product ever called them. The neutral door —
+ * the one the twin, plant and figure conversations run through — never did, so those sessions kept
+ * announcing "the first N messages were left out" and never summarised them.
+ *
+ * That is worst exactly where it was designed to help: a twin deliberation runs for days, and what
+ * the room agreed on in the first hour is what falls off the front.
+ *
+ * ── What is here and what is not ───────────────────────────────────────────────
+ * The rules stay pure and tested elsewhere. This is the reading and the writing: find what the
+ * stored summary does not cover yet, ask the model for a new one, store it. It is called after the
+ * reply has gone out, and it never throws — a conversation must not fail because a summary did not
+ * get written, and the next turn says "N left out" honestly if it did not.
+ */
+const typeorm_1 = require("typeorm");
+const fold_history_js_1 = require("./fold-history.js");
+const history_summary_js_1 = require("./history-summary.js");
+/*
+ * 엔티티는 **늦게 가져온다.** 위에서 import 하면 이 파일을 읽는 순간 TypeGraphQL 데코레이터가 돌고,
+ * 데코레이터 메타데이터가 없는 자리(시험 러너)에서 모듈 적재가 깨진다. 규칙 자체는 데이터베이스가
+ * 없어도 검사할 수 있어야 한다.
+ */
+async function defaultRepos() {
+    const { getRepository } = await Promise.resolve().then(() => __importStar(require('@things-factory/shell')));
+    const { ChatSession } = await Promise.resolve().then(() => __importStar(require('../chat-session/chat-session.js')));
+    const { ChatMessage } = await Promise.resolve().then(() => __importStar(require('./chat-message.js')));
+    return { sessions: getRepository(ChatSession), messages: getRepository(ChatMessage) };
+}
+/** How many newly-dropped turns are worth another summarisation call. */
+exports.DEFAULT_SUMMARY_THRESHOLD = 10;
+/**
+ * Where the rows after the summary's watermark are.
+ *
+ * Kept separate so the window can be read without a database: the array is an OR, and the second
+ * branch continues within one timestamp by id — the same axis the ordering uses, or a burst of
+ * messages in the same millisecond would be summarised twice or not at all.
+ */
+function rowsAfterWatermark(sessionId, mark) {
+    const session = { id: sessionId };
+    if (!mark?.createdAt)
+        return { session };
+    return [
+        { session, createdAt: (0, typeorm_1.MoreThan)(mark.createdAt) },
+        { session, createdAt: mark.createdAt, id: (0, typeorm_1.MoreThan)(mark.id) }
+    ];
+}
+async function foldSessionHistory(input) {
+    try {
+        const { sessions, messages } = input.repos ?? (await defaultRepos());
+        const session = await sessions.findOneBy({ id: input.sessionId, domain: { id: input.domainId } });
+        if (!session)
+            return;
+        const stored = { text: session.lastSummary, upToMessageId: session.summaryUpToMessageId };
+        const order = { createdAt: 'ASC', id: 'ASC' };
+        const relations = { creator: true };
+        /* 요약이 덮은 지점을 알면 그 뒤만 읽는다 — 매 턴 전체 대화를 읽지 않는다. */
+        let mark;
+        if (stored.text && stored.upToMessageId) {
+            mark = await messages.findOne({ where: { session: { id: input.sessionId }, id: stored.upToMessageId } });
+        }
+        /* 워터마크 행이 사라졌으면 덮은 범위를 모른다 — 전부 다시 본다. */
+        const startsAfterSummary = Boolean(stored.text && mark?.createdAt);
+        const rows = await messages.find({ where: rowsAfterWatermark(input.sessionId, startsAfterSummary ? mark : undefined), relations, order });
+        const { patch } = await (0, fold_history_js_1.foldHistorySummary)({
+            rows: rows.map((row) => ({
+                id: row.id,
+                role: row.role,
+                content: row.content ?? '',
+                senderId: row.creator?.id,
+                senderName: row.creator?.name || row.creator?.username
+            })),
+            rowsStartAfterSummary: startsAfterSummary,
+            stored,
+            maxTurns: input.maxTurns,
+            threshold: input.threshold ?? exports.DEFAULT_SUMMARY_THRESHOLD,
+            summarize: content => input.client.chat([{ role: 'user', content }], {
+                systemPrompt: (0, history_summary_js_1.summaryInstruction)(input.locale),
+                maxTokens: 700,
+                /* 요약은 창작이 아니다 — 흔들림을 줄인다. */
+                temperature: 0
+            })
+        });
+        if (patch)
+            await sessions.update(input.sessionId, patch);
+    }
+    catch {
+        /* 요약 실패는 대화를 막지 않는다 — 다음 턴이 「N 개 생략」으로 정직하게 알린다. */
+    }
+}
+//# sourceMappingURL=fold-session-history.js.map

package/dist-server/service/chat-message/fold-session-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fold-session-history.js","sourceRoot":"","sources":["../../../server/service/chat-message/fold-session-history.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Folding a long conversation's earlier turns into a summary — for every surface, not only boards.\n *\n * ── The gap this closes (2026-09-18) ───────────────────────────────────────────\n * The pieces were all here: a cap on how many turns reach the model, a notice when turns are left\n * out, `ChatSession.lastSummary` to carry what was dropped, and pure rules for when to re-summarise\n * (`history-summary`, `fold-history`). Only the board product ever called them. The neutral door —\n * the one the twin, plant and figure conversations run through — never did, so those sessions kept\n * announcing \"the first N messages were left out\" and never summarised them.\n *\n * That is worst exactly where it was designed to help: a twin deliberation runs for days, and what\n * the room agreed on in the first hour is what falls off the front.\n *\n * ── What is here and what is not ───────────────────────────────────────────────\n * The rules stay pure and tested elsewhere. This is the reading and the writing: find what the\n * stored summary does not cover yet, ask the model for a new one, store it. It is called after the\n * reply has gone out, and it never throws — a conversation must not fail because a summary did not\n * get written, and the next turn says \"N left out\" honestly if it did not.\n */\nimport { MoreThan } from 'typeorm'\n\nimport type { AIClient } from '@things-factory/ai-client-base'\n\nimport { foldHistorySummary } from './fold-history.js'\nimport { summaryInstruction } from './history-summary.js'\n\n/*\n * 엔티티는 **늦게 가져온다.** 위에서 import 하면 이 파일을 읽는 순간 TypeGraphQL 데코레이터가 돌고,\n * 데코레이터 메타데이터가 없는 자리(시험 러너)에서 모듈 적재가 깨진다. 규칙 자체는 데이터베이스가\n * 없어도 검사할 수 있어야 한다.\n */\nasync function defaultRepos() {\n  const { getRepository } = await import('@things-factory/shell')\n  const { ChatSession } = await import('../chat-session/chat-session.js')\n  const { ChatMessage } = await import('./chat-message.js')\n  return { sessions: getRepository(ChatSession as any), messages: getRepository(ChatMessage as any) }\n}\n\n/** How many newly-dropped turns are worth another summarisation call. */\nexport const DEFAULT_SUMMARY_THRESHOLD = 10\n\nexport interface FoldSessionHistoryInput {\n  sessionId: string\n  domainId: string\n  /** The same client that answered — a summary is written by whatever this deployment has. */\n  client: Pick<AIClient, 'chat'>\n  /** The cap the door uses when it builds the history, so both sides agree on what fell off. */\n  maxTurns: number\n  threshold?: number\n  locale?: string\n  /** Test seam: the two repositories this reads and writes. */\n  repos?: { sessions: any; messages: any }\n}\n\n/**\n * Where the rows after the summary's watermark are.\n *\n * Kept separate so the window can be read without a database: the array is an OR, and the second\n * branch continues within one timestamp by id — the same axis the ordering uses, or a burst of\n * messages in the same millisecond would be summarised twice or not at all.\n */\nexport function rowsAfterWatermark(sessionId: string, mark: { id?: string; createdAt?: Date } | undefined): any {\n  const session = { id: sessionId } as any\n  if (!mark?.createdAt) return { session }\n  return [\n    { session, createdAt: MoreThan(mark.createdAt) },\n    { session, createdAt: mark.createdAt, id: MoreThan(mark.id) }\n  ]\n}\n\nexport async function foldSessionHistory(input: FoldSessionHistoryInput): Promise<void> {\n  try {\n    const { sessions, messages } = input.repos ?? (await defaultRepos())\n    const session = await sessions.findOneBy({ id: input.sessionId, domain: { id: input.domainId } as any })\n    if (!session) return\n\n    const stored = { text: (session as any).lastSummary, upToMessageId: (session as any).summaryUpToMessageId }\n    const order = { createdAt: 'ASC', id: 'ASC' } as any\n    const relations = { creator: true } as any\n\n    /* 요약이 덮은 지점을 알면 그 뒤만 읽는다 — 매 턴 전체 대화를 읽지 않는다. */\n    let mark: { id?: string; createdAt?: Date } | undefined\n    if (stored.text && stored.upToMessageId) {\n      mark = await messages.findOne({ where: { session: { id: input.sessionId } as any, id: stored.upToMessageId } })\n    }\n    /* 워터마크 행이 사라졌으면 덮은 범위를 모른다 — 전부 다시 본다. */\n    const startsAfterSummary = Boolean(stored.text && mark?.createdAt)\n    const rows = await messages.find({ where: rowsAfterWatermark(input.sessionId, startsAfterSummary ? mark : undefined), relations, order })\n\n    const { patch } = await foldHistorySummary({\n      rows: rows.map((row: any) => ({\n        id: row.id,\n        role: row.role,\n        content: row.content ?? '',\n        senderId: row.creator?.id,\n        senderName: row.creator?.name || row.creator?.username\n      })),\n      rowsStartAfterSummary: startsAfterSummary,\n      stored,\n      maxTurns: input.maxTurns,\n      threshold: input.threshold ?? DEFAULT_SUMMARY_THRESHOLD,\n      summarize: content =>\n        input.client.chat!([{ role: 'user', content }], {\n          systemPrompt: summaryInstruction(input.locale),\n          maxTokens: 700,\n          /* 요약은 창작이 아니다 — 흔들림을 줄인다. */\n          temperature: 0\n        })\n    })\n\n    if (patch) await sessions.update(input.sessionId, patch as any)\n  } catch {\n    /* 요약 실패는 대화를 막지 않는다 — 다음 턴이 「N 개 생략」으로 정직하게 알린다. */\n  }\n}\n"]}

package/dist-server/service/chat-message/llm-history.d.ts

@@ -10,6 +10,13 @@ export interface HistoryRow {
     senderId?: string;
     /** 프롬프트에 노출할 표시 이름. 이메일 같은 개인정보는 넣지 않는다. */
     senderName?: string;
+    /**
+     * 누구에게 한 말인가 — `'assistant'` · `'room'`(ADR-0070 A15). 문이 저장한 값 그대로.
+     *
+     * 없는 행(이 칸이 생기기 전에 저장된 것)은 **모른다.** 모르는 것을 `room` 으로 적으면 그것이
+     * 지어낸 사실이다 — 그때는 대상 없이 발신자만 적는다.
+     */
+    addressee?: string;
 }
 export interface BuildLlmHistoryOptions {
     /** 이 메시지까지만 유지하고 이후는 버린다(편집·재생성으로 접은 구간). 미지정이면 전부 사용. */

package/dist-server/service/chat-message/llm-history.js

@@ -2,12 +2,17 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildLlmHistory = buildLlmHistory;
 const history_summary_js_1 = require("./history-summary.js");
-/** 사람이 아닌 기록(캔버스 직접 편집 등)의 표기. */
-const SYSTEM_LABEL = '시스템';
-/** 이름을 모르는 참여자의 표기 — 빈 대괄호를 남기지 않는다. */
-const UNKNOWN_LABEL = '참여자';
-/** 상한으로 잘라낸 앞부분을 알리는 표기 — 모델이 남은 첫 줄을 대화의 시작으로 오해하지 않게. */
-const OMITTED_LABEL = '시스템';
+/*
+ * These labels and notices are read by the model, so they are English. The reply the model writes is in the
+ * language the person used; that is the model's doing, not this file's. They were Korean, which made every
+ * conversation in this house speak Korean to the model whatever the reader's language was.
+ */
+/** Marks a record no person wrote (a direct canvas edit, for one). */
+const SYSTEM_LABEL = 'system';
+/** Marks a participant whose name we do not have — better than empty brackets. */
+const UNKNOWN_LABEL = 'participant';
+/** Marks the notice about messages the turn limit dropped, so the model does not read the first kept line as the start. */
+const OMITTED_LABEL = 'system';
 /**
  * 저장된 이력 → LLM 대화.
  *
@@ -30,19 +35,17 @@ function buildLlmHistory(rows, options = {}) {
             /* 요약이 있으면 그것을 싣는다. **요약임을 밝힌다** — 모델이 원문처럼 인용하지 않게.
              * 요약이 밀려난 구간을 다 덮지 못하면 남은 개수도 함께 알린다(최신이 아님을 숨기지 않는다). */
             const uncovered = (0, history_summary_js_1.pendingForSummary)(dropped, options.summary).length;
-            const tail = uncovered
-                ? ` 그 뒤 ${uncovered}개 메시지는 요약에 아직 반영되지 않았습니다.`
-                : '';
+            const tail = uncovered ? ` ${uncovered} message(s) after it are not in the summary yet.` : '';
             out.push({
                 role: 'user',
-                content: `[${OMITTED_LABEL}] 이 대화의 앞부분 ${dropped.length}개 메시지는 길이 제한으로 아래 요약으로 대체되었습니다(원문 아님 — 요약에 없는 사실은 사용자에게 확인하세요).${tail}\n${summaryText}`
+                content: `[${OMITTED_LABEL}] The first ${dropped.length} message(s) of this conversation were replaced by the summary below because of the length limit. It is a summary, not the original — ask the person about anything it does not say.${tail}\n${summaryText}`
             });
         }
         else {
             /* 요약이 아직 없으면 생략 사실만 알린다 — 개수만 밝히고 내용은 지어내지 않는다. */
             out.push({
                 role: 'user',
-                content: `[${OMITTED_LABEL}] 이 대화의 앞부분 ${omitted}개 메시지는 길이 제한으로 생략되었습니다. 필요하면 사용자에게 다시 확인하세요.`
+                content: `[${OMITTED_LABEL}] The first ${omitted} message(s) of this conversation were left out because of the length limit. Ask the person again if you need them.`
             });
         }
     }
@@ -58,6 +61,15 @@ function buildLlmHistory(rows, options = {}) {
             out.push({ role: 'user', content: `[${SYSTEM_LABEL}] ${content}` });
             continue;
         }
+        /*
+         * 사람의 말은 **누구에게 한 말인지까지** 적는다(ADR-0070 A15 결정 ②). 대상이 있을 때만 적으면
+         * 모델은 빈 자리에서 추론한다 — 옆 사람이 방에 한 말을 자기에게 온 지시로 읽는 것이 그 결과다.
+         */
+        const addressee = (row.addressee ?? '').trim();
+        if (addressee) {
+            out.push({ role: 'user', content: `[${speaker(row)} → ${addressee}] ${content}` });
+            continue;
+        }
         out.push({ role: 'user', content: label ? `[${speaker(row)}] ${content}` : content });
     }
     return out;

package/dist-server/service/chat-message/llm-history.js.map

@@ -1 +1 @@
-{"version":3,"file":"llm-history.js","sourceRoot":"","sources":["../../../server/service/chat-message/llm-history.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * 에이전트에게 넘길 대화 이력 조립 — 순수 로직(리졸버와 분리해 단위 테스트 가능).\n *\n * ── 왜 서버 정본인가 ─────────────────────────────────────────────────────────\n * 예전에는 클라이언트가 화면에 들고 있던 줄들을 그대로 LLM 에 넘겼다. 협의(여러 참여자)에서는\n * 참여자마다 화면이 달라 **에이전트가 사람마다 다른 대화를 본다**. 서버는 ChatMessage 에 정본을\n * 갖고 있으므로 그것을 쓴다. 세션이 없는 즉석 대화(ad-hoc)만 클라이언트 이력을 쓴다.\n *\n * ── 발신자 표기 ─────────────────────────────────────────────────────────────\n * LLMMessage 는 `{ role, content }` 뿐이다 — 발신자 칸이 없다(Anthropic·Gemini 는 message.name 을\n * 지원하지 않아 이식성이 없다). 그래서 발신자는 **본문 맨 앞 표기**로만 전달할 수 있다.\n *\n *   [김철수] 승인합니다\n *\n * **이 표기는 추론용 문맥이며 권한 판정 근거가 아니다.** 사용자가 본문에 같은 형식을 직접 적을 수\n * 있으므로, 되돌릴 수 없는 조치의 승인 여부는 반드시 서버 게이트(요청자 신원 기반)가 판정한다.\n * 표기는 \"누가 무슨 맥락에서 말했는지\"를 모델이 이해하게 하는 용도로만 쓴다.\n *\n * 발신자가 **한 명뿐이면 표기하지 않는다** — 혼자 쓰는 대화(대다수)에 노이즈와 토큰을 늘리지 않고,\n * 기존 동작과 같은 프롬프트를 유지한다.\n *\n * ── system 행 ───────────────────────────────────────────────────────────────\n * 캔버스 직접 편집 기록(`User directly edited the board: …`)은 원래 에이전트에게 알리려고 남긴 것인데,\n * 클라이언트가 role='system' 을 걸러내 사장돼 있었다. LLMMessage 에 system 역할이 없으므로\n * `[시스템]` 표기를 붙인 user 메시지로 넘긴다 — 사람이 아니므로 발신자 수 계산에는 넣지 않는다.\n *\n * ── 편집·재생성으로 접은 구간 ───────────────────────────────────────────────\n * 클라이언트의 메시지 편집은 화면에서만 접고 **서버 이력은 유지**한다(board-ai-chat.editUserMessage).\n * 서버 정본으로 바꾸면 접은 말이 에이전트 문맥에 되살아난다. 그래서 호출자가 `truncateAfterMessageId`\n * (마지막으로 남긴 메시지 id)를 주면 그 뒤 행을 버린다. 단 `keepMessageIds` 로 지정한 행(방금 저장한\n * 새 사용자 메시지)은 시간상 뒤에 있어도 항상 남긴다.\n *\n * 알려진 한계(현행 동작과 동일): 공유 세션에서 접은 구간에 **다른 사람의 발언**이 있으면 그것도\n * 함께 제외된다. 오늘 클라이언트가 보내는 이력도 같으므로 이 단계에서는 동등성을 유지하고,\n * \"내 발언만 접기\"는 별도 개선으로 다룬다.\n */\nimport type { LLMMessage } from '../types.js'\nimport { pendingForSummary, type StoredSummary } from './history-summary.js'\n\n/** 이력 한 줄 — 저장된 ChatMessage 에서 필요한 것만(엔티티·typeorm 비의존). */\nexport interface HistoryRow {\n  id?: string\n  role: string\n  /** 멘션 마커(#token{refid:N})는 호출자가 미리 제거해 넘긴다 — 모델 주의 분산·토큰 낭비 방지. */\n  content: string\n  /** 발신자 식별자(서버 내부용 — 발신자 수 계산에만 쓰고 프롬프트에 넣지 않는다). */\n  senderId?: string\n  /** 프롬프트에 노출할 표시 이름. 이메일 같은 개인정보는 넣지 않는다. */\n  senderName?: string\n}\n\nexport interface BuildLlmHistoryOptions {\n  /** 이 메시지까지만 유지하고 이후는 버린다(편집·재생성으로 접은 구간). 미지정이면 전부 사용. */\n  truncateAfterMessageId?: string\n  /** 잘라내기와 무관하게 항상 유지할 메시지 id(방금 저장한 새 사용자 메시지 등). */\n  keepMessageIds?: string[]\n  /** 발신자 표기 강제 — 미지정이면 사람 발신자가 둘 이상일 때만 표기. 테스트·특수 호출용. */\n  labelSenders?: boolean\n  /**\n   * 모델에 넘길 **최근 메시지 수 상한**. 초과분(오래된 앞부분)은 버리고 생략 표시를 남긴다.\n   *\n   * 왜 필요한가: 협의는 며칠에 걸친다. 상한이 없으면 매 턴 전체 이력을 보내 프롬프트가 무한히\n   * 자라고(비용·지연·문맥 한계) 오래된 말이 최근 상황을 덮는다. 미지정이면 전부 보낸다(기존 동작).\n   *\n   * **생략은 반드시 알린다** — 조용히 버리면 모델은 남은 첫 줄을 대화의 시작으로 오해한다.\n   * 이건 상한일 뿐 요약이 아니다. 버린 내용을 요약해 실어 보내는 것은 다음 단계다(ChatSession.lastSummary).\n   */\n  maxTurns?: number\n  /**\n   * 상한으로 밀려난 앞부분을 대신할 **요약**(세션에 저장된 것).\n   *\n   * 있으면 \"N개 생략\" 대신 요약을 첫 줄로 싣는다 — 며칠 이어지는 협의에서 앞에서 합의한 것이\n   * 없던 일이 되지 않게. 요약이 밀려난 구간을 **전부 덮지 못하면** 덮지 못한 개수도 함께 밝힌다\n   * (요약이 최신이 아닐 수 있다는 사실을 숨기지 않는다).\n   */\n  summary?: StoredSummary\n}\n\n/** 사람이 아닌 기록(캔버스 직접 편집 등)의 표기. */\nconst SYSTEM_LABEL = '시스템'\n/** 이름을 모르는 참여자의 표기 — 빈 대괄호를 남기지 않는다. */\nconst UNKNOWN_LABEL = '참여자'\n/** 상한으로 잘라낸 앞부분을 알리는 표기 — 모델이 남은 첫 줄을 대화의 시작으로 오해하지 않게. */\nconst OMITTED_LABEL = '시스템'\n\n/**\n * 저장된 이력 → LLM 대화.\n *\n * 입력은 **시간 오름차순**을 가정한다(호출자가 createdAt ASC 로 조회). 정렬을 다시 하지 않는다 —\n * 같은 시각의 순서까지 보장하려면 조회 쪽에서 결정해야 하고, 여기서 추측하면 두 곳이 어긋난다.\n */\nexport function buildLlmHistory(rows: HistoryRow[], options: BuildLlmHistoryOptions = {}): LLMMessage[] {\n  const keep = new Set(options.keepMessageIds ?? [])\n  const truncated = truncate(rows, options.truncateAfterMessageId, keep)\n  /* 상한 — 최근 것부터 남긴다. 오래된 말보다 최근 상황이 답을 좌우한다. */\n  const limit = options.maxTurns && options.maxTurns > 0 ? options.maxTurns : 0\n  const omitted = limit && truncated.length > limit ? truncated.length - limit : 0\n  const kept = omitted ? truncated.slice(-limit) : truncated\n\n  const label =\n    options.labelSenders ?? new Set(kept.filter(r => isHuman(r)).map(r => r.senderId ?? '')).size > 1\n\n  const out: LLMMessage[] = []\n  if (omitted) {\n    const dropped = truncated.slice(0, truncated.length - kept.length)\n    const summaryText = (options.summary?.text ?? '').trim()\n    if (summaryText) {\n      /* 요약이 있으면 그것을 싣는다. **요약임을 밝힌다** — 모델이 원문처럼 인용하지 않게.\n       * 요약이 밀려난 구간을 다 덮지 못하면 남은 개수도 함께 알린다(최신이 아님을 숨기지 않는다). */\n      const uncovered = pendingForSummary(dropped, options.summary).length\n      const tail = uncovered\n        ? ` 그 뒤 ${uncovered}개 메시지는 요약에 아직 반영되지 않았습니다.`\n        : ''\n      out.push({\n        role: 'user',\n        content: `[${OMITTED_LABEL}] 이 대화의 앞부분 ${dropped.length}개 메시지는 길이 제한으로 아래 요약으로 대체되었습니다(원문 아님 — 요약에 없는 사실은 사용자에게 확인하세요).${tail}\\n${summaryText}`\n      })\n    } else {\n      /* 요약이 아직 없으면 생략 사실만 알린다 — 개수만 밝히고 내용은 지어내지 않는다. */\n      out.push({\n        role: 'user',\n        content: `[${OMITTED_LABEL}] 이 대화의 앞부분 ${omitted}개 메시지는 길이 제한으로 생략되었습니다. 필요하면 사용자에게 다시 확인하세요.`\n      })\n    }\n  }\n  for (const row of kept) {\n    const content = (row.content ?? '').trim()\n    if (!content) continue // 빈 본문(pending 자리 등)은 모델에 넘길 것이 없다\n    if (row.role === 'assistant') {\n      out.push({ role: 'assistant', content })\n      continue\n    }\n    if (row.role === 'system') {\n      out.push({ role: 'user', content: `[${SYSTEM_LABEL}] ${content}` })\n      continue\n    }\n    out.push({ role: 'user', content: label ? `[${speaker(row)}] ${content}` : content })\n  }\n  return out\n}\n\n/** 사람이 보낸 줄인가 — 발신자 수 계산 대상. system 기록은 사람이 아니다. */\nfunction isHuman(row: HistoryRow): boolean {\n  return row.role !== 'assistant' && row.role !== 'system'\n}\n\nfunction speaker(row: HistoryRow): string {\n  const name = (row.senderName ?? '').trim()\n  return name || UNKNOWN_LABEL\n}\n\n/**\n * 접은 구간 제거. `truncateAfterMessageId` 가 없거나 이력에서 못 찾으면 **전부 유지**한다\n * (조용히 다 버리는 것보다 다 보내는 쪽이 안전하다 — 문맥 상실은 답을 망친다).\n */\nfunction truncate(rows: HistoryRow[], afterId: string | undefined, keep: Set<string>): HistoryRow[] {\n  if (!afterId) return rows\n  const idx = rows.findIndex(r => r.id === afterId)\n  if (idx < 0) return rows\n  const head = rows.slice(0, idx + 1)\n  const tail = rows.slice(idx + 1).filter(r => r.id && keep.has(r.id))\n  return [...head, ...tail]\n}\n"]}
+{"version":3,"file":"llm-history.js","sourceRoot":"","sources":["../../../server/service/chat-message/llm-history.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * 에이전트에게 넘길 대화 이력 조립 — 순수 로직(리졸버와 분리해 단위 테스트 가능).\n *\n * ── 왜 서버 정본인가 ─────────────────────────────────────────────────────────\n * 예전에는 클라이언트가 화면에 들고 있던 줄들을 그대로 LLM 에 넘겼다. 협의(여러 참여자)에서는\n * 참여자마다 화면이 달라 **에이전트가 사람마다 다른 대화를 본다**. 서버는 ChatMessage 에 정본을\n * 갖고 있으므로 그것을 쓴다. 세션이 없는 즉석 대화(ad-hoc)만 클라이언트 이력을 쓴다.\n *\n * ── 발신자 표기 ─────────────────────────────────────────────────────────────\n * LLMMessage 는 `{ role, content }` 뿐이다 — 발신자 칸이 없다(Anthropic·Gemini 는 message.name 을\n * 지원하지 않아 이식성이 없다). 그래서 발신자는 **본문 맨 앞 표기**로만 전달할 수 있다.\n *\n *   [김철수] 승인합니다\n *\n * **이 표기는 추론용 문맥이며 권한 판정 근거가 아니다.** 사용자가 본문에 같은 형식을 직접 적을 수\n * 있으므로, 되돌릴 수 없는 조치의 승인 여부는 반드시 서버 게이트(요청자 신원 기반)가 판정한다.\n * 표기는 \"누가 무슨 맥락에서 말했는지\"를 모델이 이해하게 하는 용도로만 쓴다.\n *\n * 발신자가 **한 명뿐이면 표기하지 않는다** — 혼자 쓰는 대화(대다수)에 노이즈와 토큰을 늘리지 않고,\n * 기존 동작과 같은 프롬프트를 유지한다.\n *\n * ── system 행 ───────────────────────────────────────────────────────────────\n * 캔버스 직접 편집 기록(`User directly edited the board: …`)은 원래 에이전트에게 알리려고 남긴 것인데,\n * 클라이언트가 role='system' 을 걸러내 사장돼 있었다. LLMMessage 에 system 역할이 없으므로\n * `[시스템]` 표기를 붙인 user 메시지로 넘긴다 — 사람이 아니므로 발신자 수 계산에는 넣지 않는다.\n *\n * ── 편집·재생성으로 접은 구간 ───────────────────────────────────────────────\n * 클라이언트의 메시지 편집은 화면에서만 접고 **서버 이력은 유지**한다(board-ai-chat.editUserMessage).\n * 서버 정본으로 바꾸면 접은 말이 에이전트 문맥에 되살아난다. 그래서 호출자가 `truncateAfterMessageId`\n * (마지막으로 남긴 메시지 id)를 주면 그 뒤 행을 버린다. 단 `keepMessageIds` 로 지정한 행(방금 저장한\n * 새 사용자 메시지)은 시간상 뒤에 있어도 항상 남긴다.\n *\n * 알려진 한계(현행 동작과 동일): 공유 세션에서 접은 구간에 **다른 사람의 발언**이 있으면 그것도\n * 함께 제외된다. 오늘 클라이언트가 보내는 이력도 같으므로 이 단계에서는 동등성을 유지하고,\n * \"내 발언만 접기\"는 별도 개선으로 다룬다.\n */\nimport type { LLMMessage } from '../types.js'\nimport { pendingForSummary, type StoredSummary } from './history-summary.js'\n\n/** 이력 한 줄 — 저장된 ChatMessage 에서 필요한 것만(엔티티·typeorm 비의존). */\nexport interface HistoryRow {\n  id?: string\n  role: string\n  /** 멘션 마커(#token{refid:N})는 호출자가 미리 제거해 넘긴다 — 모델 주의 분산·토큰 낭비 방지. */\n  content: string\n  /** 발신자 식별자(서버 내부용 — 발신자 수 계산에만 쓰고 프롬프트에 넣지 않는다). */\n  senderId?: string\n  /** 프롬프트에 노출할 표시 이름. 이메일 같은 개인정보는 넣지 않는다. */\n  senderName?: string\n  /**\n   * 누구에게 한 말인가 — `'assistant'` · `'room'`(ADR-0070 A15). 문이 저장한 값 그대로.\n   *\n   * 없는 행(이 칸이 생기기 전에 저장된 것)은 **모른다.** 모르는 것을 `room` 으로 적으면 그것이\n   * 지어낸 사실이다 — 그때는 대상 없이 발신자만 적는다.\n   */\n  addressee?: string\n}\n\nexport interface BuildLlmHistoryOptions {\n  /** 이 메시지까지만 유지하고 이후는 버린다(편집·재생성으로 접은 구간). 미지정이면 전부 사용. */\n  truncateAfterMessageId?: string\n  /** 잘라내기와 무관하게 항상 유지할 메시지 id(방금 저장한 새 사용자 메시지 등). */\n  keepMessageIds?: string[]\n  /** 발신자 표기 강제 — 미지정이면 사람 발신자가 둘 이상일 때만 표기. 테스트·특수 호출용. */\n  labelSenders?: boolean\n  /**\n   * 모델에 넘길 **최근 메시지 수 상한**. 초과분(오래된 앞부분)은 버리고 생략 표시를 남긴다.\n   *\n   * 왜 필요한가: 협의는 며칠에 걸친다. 상한이 없으면 매 턴 전체 이력을 보내 프롬프트가 무한히\n   * 자라고(비용·지연·문맥 한계) 오래된 말이 최근 상황을 덮는다. 미지정이면 전부 보낸다(기존 동작).\n   *\n   * **생략은 반드시 알린다** — 조용히 버리면 모델은 남은 첫 줄을 대화의 시작으로 오해한다.\n   * 이건 상한일 뿐 요약이 아니다. 버린 내용을 요약해 실어 보내는 것은 다음 단계다(ChatSession.lastSummary).\n   */\n  maxTurns?: number\n  /**\n   * 상한으로 밀려난 앞부분을 대신할 **요약**(세션에 저장된 것).\n   *\n   * 있으면 \"N개 생략\" 대신 요약을 첫 줄로 싣는다 — 며칠 이어지는 협의에서 앞에서 합의한 것이\n   * 없던 일이 되지 않게. 요약이 밀려난 구간을 **전부 덮지 못하면** 덮지 못한 개수도 함께 밝힌다\n   * (요약이 최신이 아닐 수 있다는 사실을 숨기지 않는다).\n   */\n  summary?: StoredSummary\n}\n\n/*\n * These labels and notices are read by the model, so they are English. The reply the model writes is in the\n * language the person used; that is the model's doing, not this file's. They were Korean, which made every\n * conversation in this house speak Korean to the model whatever the reader's language was.\n */\n/** Marks a record no person wrote (a direct canvas edit, for one). */\nconst SYSTEM_LABEL = 'system'\n/** Marks a participant whose name we do not have — better than empty brackets. */\nconst UNKNOWN_LABEL = 'participant'\n/** Marks the notice about messages the turn limit dropped, so the model does not read the first kept line as the start. */\nconst OMITTED_LABEL = 'system'\n\n/**\n * 저장된 이력 → LLM 대화.\n *\n * 입력은 **시간 오름차순**을 가정한다(호출자가 createdAt ASC 로 조회). 정렬을 다시 하지 않는다 —\n * 같은 시각의 순서까지 보장하려면 조회 쪽에서 결정해야 하고, 여기서 추측하면 두 곳이 어긋난다.\n */\nexport function buildLlmHistory(rows: HistoryRow[], options: BuildLlmHistoryOptions = {}): LLMMessage[] {\n  const keep = new Set(options.keepMessageIds ?? [])\n  const truncated = truncate(rows, options.truncateAfterMessageId, keep)\n  /* 상한 — 최근 것부터 남긴다. 오래된 말보다 최근 상황이 답을 좌우한다. */\n  const limit = options.maxTurns && options.maxTurns > 0 ? options.maxTurns : 0\n  const omitted = limit && truncated.length > limit ? truncated.length - limit : 0\n  const kept = omitted ? truncated.slice(-limit) : truncated\n\n  const label =\n    options.labelSenders ?? new Set(kept.filter(r => isHuman(r)).map(r => r.senderId ?? '')).size > 1\n\n  const out: LLMMessage[] = []\n  if (omitted) {\n    const dropped = truncated.slice(0, truncated.length - kept.length)\n    const summaryText = (options.summary?.text ?? '').trim()\n    if (summaryText) {\n      /* 요약이 있으면 그것을 싣는다. **요약임을 밝힌다** — 모델이 원문처럼 인용하지 않게.\n       * 요약이 밀려난 구간을 다 덮지 못하면 남은 개수도 함께 알린다(최신이 아님을 숨기지 않는다). */\n      const uncovered = pendingForSummary(dropped, options.summary).length\n      const tail = uncovered ? ` ${uncovered} message(s) after it are not in the summary yet.` : ''\n      out.push({\n        role: 'user',\n        content: `[${OMITTED_LABEL}] The first ${dropped.length} message(s) of this conversation were replaced by the summary below because of the length limit. It is a summary, not the original — ask the person about anything it does not say.${tail}\\n${summaryText}`\n      })\n    } else {\n      /* 요약이 아직 없으면 생략 사실만 알린다 — 개수만 밝히고 내용은 지어내지 않는다. */\n      out.push({\n        role: 'user',\n        content: `[${OMITTED_LABEL}] The first ${omitted} message(s) of this conversation were left out because of the length limit. Ask the person again if you need them.`\n      })\n    }\n  }\n  for (const row of kept) {\n    const content = (row.content ?? '').trim()\n    if (!content) continue // 빈 본문(pending 자리 등)은 모델에 넘길 것이 없다\n    if (row.role === 'assistant') {\n      out.push({ role: 'assistant', content })\n      continue\n    }\n    if (row.role === 'system') {\n      out.push({ role: 'user', content: `[${SYSTEM_LABEL}] ${content}` })\n      continue\n    }\n    /*\n     * 사람의 말은 **누구에게 한 말인지까지** 적는다(ADR-0070 A15 결정 ②). 대상이 있을 때만 적으면\n     * 모델은 빈 자리에서 추론한다 — 옆 사람이 방에 한 말을 자기에게 온 지시로 읽는 것이 그 결과다.\n     */\n    const addressee = (row.addressee ?? '').trim()\n    if (addressee) {\n      out.push({ role: 'user', content: `[${speaker(row)} → ${addressee}] ${content}` })\n      continue\n    }\n    out.push({ role: 'user', content: label ? `[${speaker(row)}] ${content}` : content })\n  }\n  return out\n}\n\n/** 사람이 보낸 줄인가 — 발신자 수 계산 대상. system 기록은 사람이 아니다. */\nfunction isHuman(row: HistoryRow): boolean {\n  return row.role !== 'assistant' && row.role !== 'system'\n}\n\nfunction speaker(row: HistoryRow): string {\n  const name = (row.senderName ?? '').trim()\n  return name || UNKNOWN_LABEL\n}\n\n/**\n * 접은 구간 제거. `truncateAfterMessageId` 가 없거나 이력에서 못 찾으면 **전부 유지**한다\n * (조용히 다 버리는 것보다 다 보내는 쪽이 안전하다 — 문맥 상실은 답을 망친다).\n */\nfunction truncate(rows: HistoryRow[], afterId: string | undefined, keep: Set<string>): HistoryRow[] {\n  if (!afterId) return rows\n  const idx = rows.findIndex(r => r.id === afterId)\n  if (idx < 0) return rows\n  const head = rows.slice(0, idx + 1)\n  const tail = rows.slice(idx + 1).filter(r => r.id && keep.has(r.id))\n  return [...head, ...tail]\n}\n"]}