@things-factory/ai-assistant 10.1.26 → 10.1.28

package/dist-server/service/testing/conversation-script.d.ts

@@ -0,0 +1,123 @@
+import { type HistoryRow } from '../chat-message/llm-history.js';
+import { type ProposalOutcome } from '../chat-message/proposal-outcome.js';
+/** Who a turn was meant for. The room hears everything; only the assistant answers. */
+export type Addressee = 'room' | 'assistant';
+export interface ScriptedTurn {
+    speaker: string;
+    addressee: Addressee;
+    content: string;
+    /** `mention` 이 부른 사람 — 본문에는 마커로 실린다. */
+    mentions?: string[];
+    /** 호스트가 카드에 답한 것 — 사람의 말이 아니라 기록이다. */
+    outcome?: {
+        proposalKey: string;
+        outcome: ProposalOutcome;
+    };
+}
+/** One model call, exactly as the provider saw it. */
+export interface RecordedCall {
+    systemPrompt: string;
+    /** The conversation handed over, newest last. */
+    messages: {
+        role: string;
+        content: any;
+    }[];
+    /** Tool names offered this turn. */
+    tools: string[];
+}
+export interface ScriptResult {
+    /** Every model call, in order. A room turn must not produce one. */
+    calls: RecordedCall[];
+    /** What the assistant answered, one per `ask`. */
+    replies: string[];
+    /** Proposals returned, paired with the turn that asked for them. */
+    proposals: {
+        askedBy: string;
+        proposal: any;
+    }[];
+    /** The rows as they stand, in the order they were said. */
+    rows: HistoryRow[];
+    /** Who is in the room now, and what each of them may do. */
+    participants: ScriptParticipant[];
+    /** What each `mention` did — who joined, or why nobody did. */
+    invites: {
+        by: string;
+        invited: string[];
+        notSeated?: string[];
+    }[];
+}
+/** A person in the room. `read` is how far they have read — the fact others see as a badge. */
+export interface ScriptParticipant {
+    userId: string;
+    role: 'owner' | 'member' | 'viewer';
+    read?: number;
+}
+/** A provider that answers with a fixed script and records what it was given. */
+export interface RecordingModel {
+    client: any;
+    calls: RecordedCall[];
+}
+/**
+ * A model that answers each call with the next canned reply, and records what it saw.
+ *
+ * `toolCalls` lets a script make the model ask for a tool on a given turn — the harness then
+ * exercises the dispatch path rather than only the prompt.
+ */
+export declare function recordingModel(replies?: string[], toolCalls?: {
+    name: string;
+    arguments?: any;
+}[][]): RecordingModel;
+export interface ConversationOptions {
+    /**
+     * Who is in the room when the script starts, and as what.
+     *
+     * A conversation always has an owner — the person who started it — and `createAISession` puts
+     * them there. Since ADR-0073 a mention grants nothing, so the roster no longer decides who may
+     * name whom; it still decides who the room reaches and who is already seated.
+     */
+    participants?: ScriptParticipant[];
+    /** 이 대화가 공개인가 — 기본은 공개(ADR-0073 판정 2). 'private' 이면 멘션이 사람을 앉히지 않는다. */
+    visibility?: 'open' | 'private';
+    /** Who the assistant is on this surface — in real use it comes from the registered mode. */
+    systemPrompt?: string;
+    /** Which registered categories this conversation may use. Omitted allows none. */
+    toolCategories?: string[];
+    /** Request state the tools receive (domain, user). */
+    state?: any;
+    /** What the surface is looking at — reaches tools as `ctx.host`, never the model. */
+    hostContext?: any;
+    /** Passed through to the runner; a live-state surface makes the model read first. */
+    requireToolOnFirstTurn?: boolean;
+}
+/**
+ * Write the conversation, then run it.
+ *
+ * ```ts
+ * const result = await conversation({ toolCategories: ['twin-ops'] })
+ *   .say('alice', '3 라인이 멈춘 것 같아요')
+ *   .say('bob', '아까부터 그랬어')
+ *   .ask('alice', '왜 멈췄는지 확인해줘')
+ *   .run(recordingModel(['확인했습니다']))
+ * ```
+ */
+export declare function conversation(options?: ConversationOptions): {
+    /** Someone speaks to the room. Nobody calls the assistant; it reads this next time it is asked. */
+    say(speaker: string, content: string): /*elided*/ any;
+    /** Someone asks the assistant. This is the turn that makes a model call. */
+    ask(speaker: string, content: string): /*elided*/ any;
+    /**
+     * Someone asks the assistant **and names a colleague** — the way a second person joins.
+     *
+     * The marker is what the browser puts in the text when a name is picked from `@`, and the door
+     * reads it from the stored turn. Only a person already in the room may bring another in.
+     */
+    mention(speaker: string, userIds: string[], content: string): /*elided*/ any;
+    /** The assistant's own answer, when a script needs one already in the history. */
+    answered(content: string): /*elided*/ any;
+    /**
+     * The host says what it did with a proposal — the card's state and the model's next turn both
+     * read this row (ADR-0070 A12-a).
+     */
+    outcome(proposalKey: string, outcome: ProposalOutcome): /*elided*/ any;
+    run(model?: RecordingModel): Promise<ScriptResult>;
+};

package/dist-server/service/testing/conversation-script.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordingModel = recordingModel;
+exports.conversation = conversation;
+/*
+ * A conversation with several people in it, written as a script, so a test can say what the
+ * assistant should have heard and what it should have done.
+ *
+ * ── Why a harness (standard A15) ───────────────────────────────────────────────
+ * A shared session carries two kinds of talk: people talking to each other, and people talking to
+ * the assistant. Everything a person types is stored the same way, and the model reads all of it.
+ * So the questions a test must be able to ask are:
+ *
+ *   누가 말했나 · 누구에게 한 말인가 · 그 턴에 모델을 불렀나 · 모델이 무엇을 읽었나 ·
+ *   무엇을 쓸 수 있었나 · 답과 제안은 누구 것인가
+ *
+ * Those are hard to see from a resolver test, because the interesting part is what the model was
+ * handed — and that is a string built from stored rows. The script keeps the rows, builds the same
+ * history the door builds, and records every model call.
+ *
+ * ── What this does not do ──────────────────────────────────────────────────────
+ * No database, no GraphQL, no provider. It drives the same two pieces the door drives
+ * (`buildLlmHistory` and `registryAssistantChat`) with a recording client, so a failure names a
+ * rule rather than a stack. Anything that only the resolver does — storing, broadcasting, session
+ * activity — is out of scope here and belongs in a resolver test.
+ */
+const ai_client_base_1 = require("@things-factory/ai-client-base");
+const llm_history_js_1 = require("../chat-message/llm-history.js");
+const proposal_outcome_js_1 = require("../chat-message/proposal-outcome.js");
+const room_message_js_1 = require("../chat-message/room-message.js");
+const mention_invite_js_1 = require("../chat-session-participant/mention-invite.js");
+/**
+ * A model that answers each call with the next canned reply, and records what it saw.
+ *
+ * `toolCalls` lets a script make the model ask for a tool on a given turn — the harness then
+ * exercises the dispatch path rather than only the prompt.
+ */
+function recordingModel(replies = ['ok'], toolCalls = []) {
+    const calls = [];
+    let turn = 0;
+    let replyTurn = 0;
+    const client = {
+        id: 'recording:test',
+        async chatWithTools(messages, tools, options) {
+            const index = turn++;
+            calls.push({
+                systemPrompt: options?.systemPrompt ?? '',
+                messages: messages.map(m => ({ role: m.role, content: m.content })),
+                tools: (tools ?? []).map(t => t.name)
+            });
+            /* The loop asks again after a tool answers, so only the first call of a turn asks for tools. */
+            const wanted = toolCalls[index] ?? [];
+            if (wanted.length > 0) {
+                return {
+                    text: '',
+                    toolCalls: wanted.map((c, i) => ({ id: `call-${index}-${i}`, name: c.name, arguments: c.arguments ?? {} })),
+                    stopReason: 'tool_use'
+                };
+            }
+            return { text: replies[Math.min(replyTurn++, replies.length - 1)] ?? 'ok', toolCalls: [], stopReason: 'end_turn' };
+        }
+    };
+    return { client, calls };
+}
+/**
+ * Write the conversation, then run it.
+ *
+ * ```ts
+ * const result = await conversation({ toolCategories: ['twin-ops'] })
+ *   .say('alice', '3 라인이 멈춘 것 같아요')
+ *   .say('bob', '아까부터 그랬어')
+ *   .ask('alice', '왜 멈췄는지 확인해줘')
+ *   .run(recordingModel(['확인했습니다']))
+ * ```
+ */
+function conversation(options = {}) {
+    const turns = [];
+    const api = {
+        /** Someone speaks to the room. Nobody calls the assistant; it reads this next time it is asked. */
+        say(speaker, content) {
+            turns.push({ speaker, addressee: 'room', content });
+            return api;
+        },
+        /** Someone asks the assistant. This is the turn that makes a model call. */
+        ask(speaker, content) {
+            turns.push({ speaker, addressee: 'assistant', content });
+            return api;
+        },
+        /**
+         * Someone asks the assistant **and names a colleague** — the way a second person joins.
+         *
+         * The marker is what the browser puts in the text when a name is picked from `@`, and the door
+         * reads it from the stored turn. Only a person already in the room may bring another in.
+         */
+        mention(speaker, userIds, content) {
+            const marked = [...userIds.map(id => `@${id}{userId:${id}}`), content].join(' ');
+            turns.push({ speaker, addressee: 'assistant', content: marked, mentions: userIds });
+            return api;
+        },
+        /** The assistant's own answer, when a script needs one already in the history. */
+        answered(content) {
+            turns.push({ speaker: 'assistant', addressee: 'room', content });
+            return api;
+        },
+        /**
+         * The host says what it did with a proposal — the card's state and the model's next turn both
+         * read this row (ADR-0070 A12-a).
+         */
+        outcome(proposalKey, outcome) {
+            turns.push({ speaker: 'system', addressee: 'room', content: '', outcome: { proposalKey, outcome } });
+            return api;
+        },
+        async run(model = recordingModel()) {
+            const rows = [];
+            const replies = [];
+            const proposals = [];
+            const invites = [];
+            /* 참여자 저장소 — 실제 문이 쓰는 것과 같은 규칙을 지나되, 기억에만 둔다. */
+            const roster = (options.participants ?? [{ userId: 'alice', role: 'owner' }]).map((person, index) => ({
+                id: `participant-${index + 1}`,
+                userId: person.userId,
+                role: person.role,
+                read: person.read
+            }));
+            const participants = {
+                find: async () => roster,
+                save: async (row) => {
+                    roster.push({ id: `participant-${roster.length + 1}`, userId: row.user.id, role: row.role });
+                },
+                update: async (id, patch) => {
+                    const found = roster.find(row => row.id === id);
+                    if (found)
+                        Object.assign(found, patch);
+                }
+            };
+            for (const turn of turns) {
+                /* 호스트의 답은 사람의 말이 아니다 — 서버가 쓰는 `system` 행이다. */
+                if (turn.outcome) {
+                    rows.push({
+                        id: `row-${rows.length + 1}`,
+                        role: 'system',
+                        content: (0, proposal_outcome_js_1.formatProposalOutcomeLine)(turn.outcome.proposalKey, turn.outcome.outcome)
+                    });
+                    continue;
+                }
+                /* 빈 말은 저장되지 않는다 — 문이 지키는 규칙과 같은 것을 쓴다. */
+                const body = (0, room_message_js_1.roomMessageBody)(turn.content);
+                if (!body)
+                    continue;
+                rows.push({
+                    id: `row-${rows.length + 1}`,
+                    role: turn.speaker === 'assistant' ? 'assistant' : 'user',
+                    content: body,
+                    senderId: turn.speaker,
+                    senderName: turn.speaker,
+                    /* 사람의 말에만 대상이 있다 — 문이 찍는 값과 같은 자리다(ADR-0070 A15 결정 ①). */
+                    addressee: turn.speaker === 'assistant' ? undefined : turn.addressee
+                });
+                /* 멘션은 사람의 말을 저장하는 문에서만 사람을 불러들인다(ADR-0071 결정 1 ①). */
+                if (turn.speaker !== 'assistant') {
+                    const invite = await (0, mention_invite_js_1.inviteMentionedUsers)({
+                        content: body,
+                        sessionId: 'script-session',
+                        domainId: 'script-domain',
+                        inviter: { id: turn.speaker },
+                        participants,
+                        visibility: options.visibility
+                    });
+                    if (invite.invited.length > 0 || invite.notSeated) {
+                        invites.push({ by: turn.speaker, invited: invite.invited, notSeated: invite.notSeated });
+                    }
+                }
+                /* Only a turn addressed to the assistant runs it. Room talk is context for the next one. */
+                if (turn.addressee !== 'assistant')
+                    continue;
+                const result = await (0, ai_client_base_1.registryAssistantChat)({
+                    client: model.client,
+                    messages: (0, llm_history_js_1.buildLlmHistory)(rows, {}),
+                    systemPrompt: options.systemPrompt ?? 'you are a test assistant',
+                    toolCategories: options.toolCategories,
+                    hostContext: options.hostContext,
+                    state: options.state ?? { domain: { id: 'dom-1' }, user: { id: 'u-1' } },
+                    requireToolOnFirstTurn: options.requireToolOnFirstTurn
+                });
+                replies.push(result.reply);
+                rows.push({ id: `row-${rows.length + 1}`, role: 'assistant', content: result.reply });
+                for (const proposal of result.loop.proposals ?? [])
+                    proposals.push({ askedBy: turn.speaker, proposal });
+            }
+            return {
+                calls: model.calls,
+                replies,
+                proposals,
+                rows,
+                participants: roster.map(row => ({ userId: row.userId, role: row.role, read: row.read })),
+                invites
+            };
+        }
+    };
+    return api;
+}
+//# sourceMappingURL=conversation-script.js.map

package/dist-server/service/testing/conversation-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-script.js","sourceRoot":"","sources":["../../../server/service/testing/conversation-script.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * A conversation with several people in it, written as a script, so a test can say what the\n * assistant should have heard and what it should have done.\n *\n * ── Why a harness (standard A15) ───────────────────────────────────────────────\n * A shared session carries two kinds of talk: people talking to each other, and people talking to\n * the assistant. Everything a person types is stored the same way, and the model reads all of it.\n * So the questions a test must be able to ask are:\n *\n *   누가 말했나 · 누구에게 한 말인가 · 그 턴에 모델을 불렀나 · 모델이 무엇을 읽었나 ·\n *   무엇을 쓸 수 있었나 · 답과 제안은 누구 것인가\n *\n * Those are hard to see from a resolver test, because the interesting part is what the model was\n * handed — and that is a string built from stored rows. The script keeps the rows, builds the same\n * history the door builds, and records every model call.\n *\n * ── What this does not do ──────────────────────────────────────────────────────\n * No database, no GraphQL, no provider. It drives the same two pieces the door drives\n * (`buildLlmHistory` and `registryAssistantChat`) with a recording client, so a failure names a\n * rule rather than a stack. Anything that only the resolver does — storing, broadcasting, session\n * activity — is out of scope here and belongs in a resolver test.\n */\nimport { registryAssistantChat } from '@things-factory/ai-client-base'\n\nimport { buildLlmHistory, type HistoryRow } from '../chat-message/llm-history.js'\nimport { formatProposalOutcomeLine, type ProposalOutcome } from '../chat-message/proposal-outcome.js'\nimport { roomMessageBody } from '../chat-message/room-message.js'\nimport { inviteMentionedUsers } from '../chat-session-participant/mention-invite.js'\n\n/** Who a turn was meant for. The room hears everything; only the assistant answers. */\nexport type Addressee = 'room' | 'assistant'\n\nexport interface ScriptedTurn {\n  speaker: string\n  addressee: Addressee\n  content: string\n  /** `mention` 이 부른 사람 — 본문에는 마커로 실린다. */\n  mentions?: string[]\n  /** 호스트가 카드에 답한 것 — 사람의 말이 아니라 기록이다. */\n  outcome?: { proposalKey: string; outcome: ProposalOutcome }\n}\n\n/** One model call, exactly as the provider saw it. */\nexport interface RecordedCall {\n  systemPrompt: string\n  /** The conversation handed over, newest last. */\n  messages: { role: string; content: any }[]\n  /** Tool names offered this turn. */\n  tools: string[]\n}\n\nexport interface ScriptResult {\n  /** Every model call, in order. A room turn must not produce one. */\n  calls: RecordedCall[]\n  /** What the assistant answered, one per `ask`. */\n  replies: string[]\n  /** Proposals returned, paired with the turn that asked for them. */\n  proposals: { askedBy: string; proposal: any }[]\n  /** The rows as they stand, in the order they were said. */\n  rows: HistoryRow[]\n  /** Who is in the room now, and what each of them may do. */\n  participants: ScriptParticipant[]\n  /** What each `mention` did — who joined, or why nobody did. */\n  invites: { by: string; invited: string[]; notSeated?: string[] }[]\n}\n\n/** A person in the room. `read` is how far they have read — the fact others see as a badge. */\nexport interface ScriptParticipant {\n  userId: string\n  role: 'owner' | 'member' | 'viewer'\n  read?: number\n}\n\n/** A provider that answers with a fixed script and records what it was given. */\nexport interface RecordingModel {\n  client: any\n  calls: RecordedCall[]\n}\n\n/**\n * A model that answers each call with the next canned reply, and records what it saw.\n *\n * `toolCalls` lets a script make the model ask for a tool on a given turn — the harness then\n * exercises the dispatch path rather than only the prompt.\n */\nexport function recordingModel(\n  replies: string[] = ['ok'],\n  toolCalls: { name: string; arguments?: any }[][] = []\n): RecordingModel {\n  const calls: RecordedCall[] = []\n  let turn = 0\n  let replyTurn = 0\n\n  const client = {\n    id: 'recording:test',\n    async chatWithTools(messages: any[], tools: any[], options: any) {\n      const index = turn++\n      calls.push({\n        systemPrompt: options?.systemPrompt ?? '',\n        messages: messages.map(m => ({ role: m.role, content: m.content })),\n        tools: (tools ?? []).map(t => t.name)\n      })\n      /* The loop asks again after a tool answers, so only the first call of a turn asks for tools. */\n      const wanted = toolCalls[index] ?? []\n      if (wanted.length > 0) {\n        return {\n          text: '',\n          toolCalls: wanted.map((c, i) => ({ id: `call-${index}-${i}`, name: c.name, arguments: c.arguments ?? {} })),\n          stopReason: 'tool_use'\n        }\n      }\n      return { text: replies[Math.min(replyTurn++, replies.length - 1)] ?? 'ok', toolCalls: [], stopReason: 'end_turn' }\n    }\n  }\n\n  return { client, calls }\n}\n\nexport interface ConversationOptions {\n  /**\n   * Who is in the room when the script starts, and as what.\n   *\n   * A conversation always has an owner — the person who started it — and `createAISession` puts\n   * them there. Since ADR-0073 a mention grants nothing, so the roster no longer decides who may\n   * name whom; it still decides who the room reaches and who is already seated.\n   */\n  participants?: ScriptParticipant[]\n  /** 이 대화가 공개인가 — 기본은 공개(ADR-0073 판정 2). 'private' 이면 멘션이 사람을 앉히지 않는다. */\n  visibility?: 'open' | 'private'\n  /** Who the assistant is on this surface — in real use it comes from the registered mode. */\n  systemPrompt?: string\n  /** Which registered categories this conversation may use. Omitted allows none. */\n  toolCategories?: string[]\n  /** Request state the tools receive (domain, user). */\n  state?: any\n  /** What the surface is looking at — reaches tools as `ctx.host`, never the model. */\n  hostContext?: any\n  /** Passed through to the runner; a live-state surface makes the model read first. */\n  requireToolOnFirstTurn?: boolean\n}\n\n/**\n * Write the conversation, then run it.\n *\n * ```ts\n * const result = await conversation({ toolCategories: ['twin-ops'] })\n *   .say('alice', '3 라인이 멈춘 것 같아요')\n *   .say('bob', '아까부터 그랬어')\n *   .ask('alice', '왜 멈췄는지 확인해줘')\n *   .run(recordingModel(['확인했습니다']))\n * ```\n */\nexport function conversation(options: ConversationOptions = {}) {\n  const turns: ScriptedTurn[] = []\n\n  const api = {\n    /** Someone speaks to the room. Nobody calls the assistant; it reads this next time it is asked. */\n    say(speaker: string, content: string) {\n      turns.push({ speaker, addressee: 'room', content })\n      return api\n    },\n    /** Someone asks the assistant. This is the turn that makes a model call. */\n    ask(speaker: string, content: string) {\n      turns.push({ speaker, addressee: 'assistant', content })\n      return api\n    },\n    /**\n     * Someone asks the assistant **and names a colleague** — the way a second person joins.\n     *\n     * The marker is what the browser puts in the text when a name is picked from `@`, and the door\n     * reads it from the stored turn. Only a person already in the room may bring another in.\n     */\n    mention(speaker: string, userIds: string[], content: string) {\n      const marked = [...userIds.map(id => `@${id}{userId:${id}}`), content].join(' ')\n      turns.push({ speaker, addressee: 'assistant', content: marked, mentions: userIds })\n      return api\n    },\n\n    /** The assistant's own answer, when a script needs one already in the history. */\n    answered(content: string) {\n      turns.push({ speaker: 'assistant', addressee: 'room', content })\n      return api\n    },\n\n    /**\n     * The host says what it did with a proposal — the card's state and the model's next turn both\n     * read this row (ADR-0070 A12-a).\n     */\n    outcome(proposalKey: string, outcome: ProposalOutcome) {\n      turns.push({ speaker: 'system', addressee: 'room', content: '', outcome: { proposalKey, outcome } })\n      return api\n    },\n\n    async run(model: RecordingModel = recordingModel()): Promise<ScriptResult> {\n      const rows: HistoryRow[] = []\n      const replies: string[] = []\n      const proposals: { askedBy: string; proposal: any }[] = []\n      const invites: { by: string; invited: string[]; notSeated?: string[] }[] = []\n\n      /* 참여자 저장소 — 실제 문이 쓰는 것과 같은 규칙을 지나되, 기억에만 둔다. */\n      const roster: any[] = (options.participants ?? [{ userId: 'alice', role: 'owner' }]).map((person, index) => ({\n        id: `participant-${index + 1}`,\n        userId: person.userId,\n        role: person.role,\n        read: person.read\n      }))\n      const participants = {\n        find: async () => roster,\n        save: async (row: any) => {\n          roster.push({ id: `participant-${roster.length + 1}`, userId: row.user.id, role: row.role })\n        },\n        update: async (id: string, patch: any) => {\n          const found = roster.find(row => row.id === id)\n          if (found) Object.assign(found, patch)\n        }\n      }\n\n      for (const turn of turns) {\n        /* 호스트의 답은 사람의 말이 아니다 — 서버가 쓰는 `system` 행이다. */\n        if (turn.outcome) {\n          rows.push({\n            id: `row-${rows.length + 1}`,\n            role: 'system',\n            content: formatProposalOutcomeLine(turn.outcome.proposalKey, turn.outcome.outcome)\n          })\n          continue\n        }\n\n        /* 빈 말은 저장되지 않는다 — 문이 지키는 규칙과 같은 것을 쓴다. */\n        const body = roomMessageBody(turn.content)\n        if (!body) continue\n\n        rows.push({\n          id: `row-${rows.length + 1}`,\n          role: turn.speaker === 'assistant' ? 'assistant' : 'user',\n          content: body,\n          senderId: turn.speaker,\n          senderName: turn.speaker,\n          /* 사람의 말에만 대상이 있다 — 문이 찍는 값과 같은 자리다(ADR-0070 A15 결정 ①). */\n          addressee: turn.speaker === 'assistant' ? undefined : turn.addressee\n        })\n\n        /* 멘션은 사람의 말을 저장하는 문에서만 사람을 불러들인다(ADR-0071 결정 1 ①). */\n        if (turn.speaker !== 'assistant') {\n          const invite = await inviteMentionedUsers({\n            content: body,\n            sessionId: 'script-session',\n            domainId: 'script-domain',\n            inviter: { id: turn.speaker },\n            participants,\n            visibility: options.visibility\n          })\n          if (invite.invited.length > 0 || invite.notSeated) {\n            invites.push({ by: turn.speaker, invited: invite.invited, notSeated: invite.notSeated })\n          }\n        }\n\n        /* Only a turn addressed to the assistant runs it. Room talk is context for the next one. */\n        if (turn.addressee !== 'assistant') continue\n\n        const result = await registryAssistantChat({\n          client: model.client,\n          messages: buildLlmHistory(rows, {}) as any,\n          systemPrompt: options.systemPrompt ?? 'you are a test assistant',\n          toolCategories: options.toolCategories,\n          hostContext: options.hostContext,\n          state: options.state ?? { domain: { id: 'dom-1' }, user: { id: 'u-1' } },\n          requireToolOnFirstTurn: options.requireToolOnFirstTurn\n        })\n\n        replies.push(result.reply)\n        rows.push({ id: `row-${rows.length + 1}`, role: 'assistant', content: result.reply })\n        for (const proposal of result.loop.proposals ?? []) proposals.push({ askedBy: turn.speaker, proposal })\n      }\n\n      return {\n        calls: model.calls,\n        replies,\n        proposals,\n        rows,\n        participants: roster.map(row => ({ userId: row.userId, role: row.role, read: row.read })),\n        invites\n      }\n    }\n  }\n\n  return api\n}\n"]}

package/dist-server/service/testing/mode-conformance.d.ts

@@ -0,0 +1,40 @@
+import { type Translate } from '../assistant-mode/resolve.js';
+export interface ModeRunResult {
+    /** 이 모드가 모델에게 실제로 건넨 도구 이름. */
+    offeredTools: string[];
+    /** 모델이 받은 시스템 프롬프트 — 서버의 것인지 확인할 수 있다. */
+    systemPrompt: string;
+    /** 첫 턴에 도구를 강제했는가. */
+    requiredToolOnFirstTurn: boolean;
+    reply: string;
+}
+/** 시험용 번역기 — 키를 그대로 돌려준다. 문장이 나와야 할 자리에 키가 나오면 눈에 띈다. */
+export declare const keyEchoTranslate: Translate;
+/**
+ * 등록된 모드로 한 턴을 돌린다 — 프롬프트도 도구도 **등록에서** 나온다.
+ *
+ * 시험이 자기 값을 넘기면 그 시험은 선언을 안 본 것이다. 그래서 여기서는 `kind` 만 받는다.
+ */
+export declare function runRegisteredMode(kind: string, options?: {
+    client: any;
+    hostContext?: any;
+    state?: any;
+    toolAccess?: any;
+    reply?: string;
+}): Promise<ModeRunResult>;
+export interface ModeWording {
+    placeholder?: string;
+    slash: {
+        name: string;
+        description: string;
+        template: string;
+    }[];
+    footerNotice?: string;
+    stagedNotice?: string;
+}
+/** 화면에 낼 말 — 주어진 사전으로 옮긴 결과. 키가 그대로 남으면 사전에 없는 것이다. */
+export declare function modeWording(kind: string, dictionary: Record<string, string>): ModeWording;
+/** 사전에 없어서 키가 그대로 화면에 나갈 말들. 비어 있어야 한다. */
+export declare function missingWording(kind: string, dictionary: Record<string, string>): string[];
+/** 이 모드가 자기 도구로 못 하는 일을 제안하는가 — 부팅 보고와 같은 답. */
+export declare function modePromisesItCannotKeep(kind: string): string[];

package/dist-server/service/testing/mode-conformance.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.keyEchoTranslate = void 0;
+exports.runRegisteredMode = runRegisteredMode;
+exports.modeWording = modeWording;
+exports.missingWording = missingWording;
+exports.modePromisesItCannotKeep = modePromisesItCannotKeep;
+/*
+ * 등록된 모드가 **선언한 대로 도는가** — 글자가 아니라 문을 지나서 본다.
+ *
+ * 모드 선언은 소스에 적힌 값이고, 사람이 만나는 것은 그 값이 문을 지나 만들어 낸 것이다. 그 둘이
+ * 어긋나는 자리가 오늘 하루에만 여럿 나왔다: 범주에 없는 도구를 프롬프트가 부르라고 했고, 키는 있는데
+ * 번역이 없었고, 부품에 규칙이 있는데 부르는 쪽이 없었다. 전부 「선언은 맞는데 돌지 않는」 모양이다.
+ *
+ * 그래서 앱의 시험이 이것으로 **자기 모드를 실제로 돌려 본다**:
+ *   · 그 이름으로 모드가 서는가
+ *   · 그 모드가 여는 도구가 무엇인가 — 모델에게 실제로 건네지는 목록
+ *   · 첫 턴 도구 호출을 강제하는가
+ *   · 화면에 낼 말이 **키가 아니라 문장**으로 나오는가
+ *   · 슬래시가 가리키는 도구가 그 모드 안에 있는가
+ */
+const ai_client_base_1 = require("@things-factory/ai-client-base");
+const registry_js_1 = require("../assistant-mode/registry.js");
+const resolve_js_1 = require("../assistant-mode/resolve.js");
+/** 시험용 번역기 — 키를 그대로 돌려준다. 문장이 나와야 할 자리에 키가 나오면 눈에 띈다. */
+const keyEchoTranslate = key => key;
+exports.keyEchoTranslate = keyEchoTranslate;
+/**
+ * 등록된 모드로 한 턴을 돌린다 — 프롬프트도 도구도 **등록에서** 나온다.
+ *
+ * 시험이 자기 값을 넘기면 그 시험은 선언을 안 본 것이다. 그래서 여기서는 `kind` 만 받는다.
+ */
+async function runRegisteredMode(kind, options = {}) {
+    const settings = (0, resolve_js_1.resolveModeSettings)({ kind }, exports.keyEchoTranslate);
+    let requiredToolOnFirstTurn = false;
+    const result = await (0, ai_client_base_1.registryAssistantChat)({
+        client: options.client,
+        messages: [{ role: 'user', content: '한 턴' }],
+        systemPrompt: settings.systemPrompt,
+        toolCategories: settings.toolCategories,
+        requireToolOnFirstTurn: (requiredToolOnFirstTurn = Boolean(settings.requireToolOnFirstTurn)),
+        model: settings.model,
+        temperature: settings.temperature,
+        maxTokens: settings.maxTokens,
+        hostContext: options.hostContext,
+        toolAccess: options.toolAccess,
+        state: options.state ?? { domain: { id: 'dom-1' }, user: { id: 'u-1' } }
+    });
+    return {
+        offeredTools: [...result.offeredTools],
+        systemPrompt: settings.systemPrompt,
+        requiredToolOnFirstTurn,
+        reply: result.reply
+    };
+}
+/** 화면에 낼 말 — 주어진 사전으로 옮긴 결과. 키가 그대로 남으면 사전에 없는 것이다. */
+function modeWording(kind, dictionary) {
+    const view = (0, resolve_js_1.assistantModeView)(kind, key => dictionary[key] ?? key);
+    return {
+        placeholder: view.placeholder,
+        slash: view.slashTemplates,
+        footerNotice: view.footerNotice,
+        stagedNotice: view.stagedNotice
+    };
+}
+/** 사전에 없어서 키가 그대로 화면에 나갈 말들. 비어 있어야 한다. */
+function missingWording(kind, dictionary) {
+    const missing = [];
+    const spec = (0, registry_js_1.getAssistantMode)(kind);
+    if (!spec)
+        return [`mode:${kind}`];
+    for (const key of [spec.placeholderKey, spec.footerNoticeKey, spec.stagedNoticeKey]) {
+        if (key && !(key in dictionary))
+            missing.push(key);
+    }
+    for (const slash of spec.slashTemplates ?? []) {
+        for (const key of [slash.descriptionKey, slash.templateKey]) {
+            if (!(key in dictionary))
+                missing.push(key);
+        }
+    }
+    return missing;
+}
+/** 이 모드가 자기 도구로 못 하는 일을 제안하는가 — 부팅 보고와 같은 답. */
+function modePromisesItCannotKeep(kind) {
+    return (0, registry_js_1.getAssistantModeWarnings)()
+        .filter(warning => warning.params.kind === kind)
+        .map(warning => `${warning.code}:${warning.params.slash}→${warning.params.tool}`);
+}
+//# sourceMappingURL=mode-conformance.js.map

package/dist-server/service/testing/mode-conformance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-conformance.js","sourceRoot":"","sources":["../../../server/service/testing/mode-conformance.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * 등록된 모드가 **선언한 대로 도는가** — 글자가 아니라 문을 지나서 본다.\n *\n * 모드 선언은 소스에 적힌 값이고, 사람이 만나는 것은 그 값이 문을 지나 만들어 낸 것이다. 그 둘이\n * 어긋나는 자리가 오늘 하루에만 여럿 나왔다: 범주에 없는 도구를 프롬프트가 부르라고 했고, 키는 있는데\n * 번역이 없었고, 부품에 규칙이 있는데 부르는 쪽이 없었다. 전부 「선언은 맞는데 돌지 않는」 모양이다.\n *\n * 그래서 앱의 시험이 이것으로 **자기 모드를 실제로 돌려 본다**:\n *   · 그 이름으로 모드가 서는가\n *   · 그 모드가 여는 도구가 무엇인가 — 모델에게 실제로 건네지는 목록\n *   · 첫 턴 도구 호출을 강제하는가\n *   · 화면에 낼 말이 **키가 아니라 문장**으로 나오는가\n *   · 슬래시가 가리키는 도구가 그 모드 안에 있는가\n */\nimport { registryAssistantChat } from '@things-factory/ai-client-base'\n\nimport { getAssistantMode, getAssistantModeWarnings } from '../assistant-mode/registry.js'\nimport { assistantModeView, resolveModeSettings, type Translate } from '../assistant-mode/resolve.js'\n\nexport interface ModeRunResult {\n  /** 이 모드가 모델에게 실제로 건넨 도구 이름. */\n  offeredTools: string[]\n  /** 모델이 받은 시스템 프롬프트 — 서버의 것인지 확인할 수 있다. */\n  systemPrompt: string\n  /** 첫 턴에 도구를 강제했는가. */\n  requiredToolOnFirstTurn: boolean\n  reply: string\n}\n\n/** 시험용 번역기 — 키를 그대로 돌려준다. 문장이 나와야 할 자리에 키가 나오면 눈에 띈다. */\nexport const keyEchoTranslate: Translate = key => key\n\n/**\n * 등록된 모드로 한 턴을 돌린다 — 프롬프트도 도구도 **등록에서** 나온다.\n *\n * 시험이 자기 값을 넘기면 그 시험은 선언을 안 본 것이다. 그래서 여기서는 `kind` 만 받는다.\n */\nexport async function runRegisteredMode(\n  kind: string,\n  options: { client: any; hostContext?: any; state?: any; toolAccess?: any; reply?: string } = {} as any\n): Promise<ModeRunResult> {\n  const settings = resolveModeSettings({ kind }, keyEchoTranslate)\n  let requiredToolOnFirstTurn = false\n\n  const result = await registryAssistantChat({\n    client: options.client,\n    messages: [{ role: 'user', content: '한 턴' }] as any,\n    systemPrompt: settings.systemPrompt,\n    toolCategories: settings.toolCategories,\n    requireToolOnFirstTurn: (requiredToolOnFirstTurn = Boolean(settings.requireToolOnFirstTurn)),\n    model: settings.model,\n    temperature: settings.temperature,\n    maxTokens: settings.maxTokens,\n    hostContext: options.hostContext,\n    toolAccess: options.toolAccess,\n    state: options.state ?? { domain: { id: 'dom-1' }, user: { id: 'u-1' } }\n  })\n\n  return {\n    offeredTools: [...result.offeredTools],\n    systemPrompt: settings.systemPrompt,\n    requiredToolOnFirstTurn,\n    reply: result.reply\n  }\n}\n\nexport interface ModeWording {\n  placeholder?: string\n  slash: { name: string; description: string; template: string }[]\n  footerNotice?: string\n  stagedNotice?: string\n}\n\n/** 화면에 낼 말 — 주어진 사전으로 옮긴 결과. 키가 그대로 남으면 사전에 없는 것이다. */\nexport function modeWording(kind: string, dictionary: Record<string, string>): ModeWording {\n  const view = assistantModeView(kind, key => dictionary[key] ?? key)\n  return {\n    placeholder: view.placeholder,\n    slash: view.slashTemplates,\n    footerNotice: view.footerNotice,\n    stagedNotice: view.stagedNotice\n  }\n}\n\n/** 사전에 없어서 키가 그대로 화면에 나갈 말들. 비어 있어야 한다. */\nexport function missingWording(kind: string, dictionary: Record<string, string>): string[] {\n  const missing: string[] = []\n  const spec = getAssistantMode(kind)\n  if (!spec) return [`mode:${kind}`]\n\n  for (const key of [spec.placeholderKey, spec.footerNoticeKey, spec.stagedNoticeKey]) {\n    if (key && !(key in dictionary)) missing.push(key)\n  }\n  for (const slash of spec.slashTemplates ?? []) {\n    for (const key of [slash.descriptionKey, slash.templateKey]) {\n      if (!(key in dictionary)) missing.push(key)\n    }\n  }\n  return missing\n}\n\n/** 이 모드가 자기 도구로 못 하는 일을 제안하는가 — 부팅 보고와 같은 답. */\nexport function modePromisesItCannotKeep(kind: string): string[] {\n  return getAssistantModeWarnings()\n    .filter(warning => warning.params.kind === kind)\n    .map(warning => `${warning.code}:${warning.params.slash}→${warning.params.tool}`)\n}\n"]}

package/dist-server/tool-registry-boot-report.d.ts

@@ -1,3 +1,6 @@
 import { type ToolRegistryWarning } from '@things-factory/ai-client-base';
+import { type AssistantModeWarning } from './service/assistant-mode/index.js';
 /** One line per code: the code, how many, and which tools. Empty when there is nothing to report. */
 export declare function formatToolRegistryWarnings(warnings: ReadonlyArray<ToolRegistryWarning>): string[];
+/** One line per code: the code, how many, and which modes promised what. */
+export declare function formatAssistantModeWarnings(warnings: ReadonlyArray<AssistantModeWarning>): string[];

package/dist-server/tool-registry-boot-report.js

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatToolRegistryWarnings = formatToolRegistryWarnings;
+exports.formatAssistantModeWarnings = formatAssistantModeWarnings;
 /*
- * At boot, say which registered tools are not yet what the tool contract requires (A1 stage one).
+ * At boot, say what registered but is not yet what the contracts require — tools with no privilege
+ * (A1 stage one) and modes offering `/` sentences their tools cannot answer (ADR-0058 decision 3).
+ *
+ * One window, because it is one question: what state is this deployment's AI in (standard A7-a).
  *
  * Registration no longer refuses a tool that changes something without declaring its privilege —
  * refusing would stop apps whose tools predate the field. The registry records each omission as a
@@ -12,18 +16,37 @@ exports.formatToolRegistryWarnings = formatToolRegistryWarnings;
  */
 const env_1 = require("@things-factory/env");
 const ai_client_base_1 = require("@things-factory/ai-client-base");
+const index_js_1 = require("./service/assistant-mode/index.js");
 /** One line per code: the code, how many, and which tools. Empty when there is nothing to report. */
 function formatToolRegistryWarnings(warnings) {
     const byCode = new Map();
     for (const warning of warnings) {
         const tools = byCode.get(warning.code) ?? [];
-        tools.push(`${warning.params.category}/${warning.params.tool}(${warning.params.kind})`);
+        /* 문 이름이 있으면 함께 적는다 — 「어느 문이 아직 선언이 없나」가 다음에 할 일이다. */
+        const doors = warning.params.doors?.length ? ` → ${warning.params.doors.join(' + ')}` : '';
+        tools.push(`${warning.params.category}/${warning.params.tool}(${warning.params.kind})${doors}`);
         byCode.set(warning.code, tools);
     }
     return [...byCode].map(([code, tools]) => `[ai-assistant] ${code} ×${tools.length}: ${tools.join(', ')}`);
 }
+/** One line per code: the code, how many, and which modes promised what. */
+function formatAssistantModeWarnings(warnings) {
+    const byCode = new Map();
+    for (const warning of warnings) {
+        const offers = byCode.get(warning.code) ?? [];
+        offers.push(`${warning.params.kind}:/${warning.params.slash}→${warning.params.tool}`);
+        byCode.set(warning.code, offers);
+    }
+    return [...byCode].map(([code, offers]) => `[ai-assistant] ${code} ×${offers.length}: ${offers.join(', ')}`);
+}
+/*
+ * After every module has registered: a mode may declare its slash sentences before the package
+ * that registers the tools they need, so this cannot be checked when the mode registers.
+ */
 process.on('bootstrap-module-start', () => {
     for (const line of formatToolRegistryWarnings((0, ai_client_base_1.getToolRegistryWarnings)()))
         env_1.logger.warn(line);
+    for (const line of formatAssistantModeWarnings((0, index_js_1.getAssistantModeWarnings)()))
+        env_1.logger.warn(line);
 });
 //# sourceMappingURL=tool-registry-boot-report.js.map

package/dist-server/tool-registry-boot-report.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-registry-boot-report.js","sourceRoot":"","sources":["../server/tool-registry-boot-report.ts"],"names":[],"mappings":";;AAaA,gEAQC;AArBD;;;;;;;;GAQG;AACH,6CAA4C;AAC5C,mEAAkG;AAElG,qGAAqG;AACrG,SAAgB,0BAA0B,CAAC,QAA4C;IACrF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAA;IAC1C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QAC5C,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAA;QACvF,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACjC,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,kBAAkB,IAAI,KAAK,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAC3G,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,wBAA+B,EAAE,GAAG,EAAE;IAC/C,KAAK,MAAM,IAAI,IAAI,0BAA0B,CAAC,IAAA,wCAAuB,GAAE,CAAC;QAAE,YAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC7F,CAAC,CAAC,CAAA","sourcesContent":["/*\n * At boot, say which registered tools are not yet what the tool contract requires (A1 stage one).\n *\n * Registration no longer refuses a tool that changes something without declaring its privilege —\n * refusing would stop apps whose tools predate the field. The registry records each omission as a\n * code instead. This prints that list once, after every module has registered, grouped by code,\n * so the person starting the server sees which tools still need a declaration. When the list is\n * empty across the apps, registration becomes a refusal and this report goes away.\n */\nimport { logger } from '@things-factory/env'\nimport { getToolRegistryWarnings, type ToolRegistryWarning } from '@things-factory/ai-client-base'\n\n/** One line per code: the code, how many, and which tools. Empty when there is nothing to report. */\nexport function formatToolRegistryWarnings(warnings: ReadonlyArray<ToolRegistryWarning>): string[] {\n  const byCode = new Map<string, string[]>()\n  for (const warning of warnings) {\n    const tools = byCode.get(warning.code) ?? []\n    tools.push(`${warning.params.category}/${warning.params.tool}(${warning.params.kind})`)\n    byCode.set(warning.code, tools)\n  }\n  return [...byCode].map(([code, tools]) => `[ai-assistant] ${code} ×${tools.length}: ${tools.join(', ')}`)\n}\n\nprocess.on('bootstrap-module-start' as any, () => {\n  for (const line of formatToolRegistryWarnings(getToolRegistryWarnings())) logger.warn(line)\n})\n"]}
+{"version":3,"file":"tool-registry-boot-report.js","sourceRoot":"","sources":["../server/tool-registry-boot-report.ts"],"names":[],"mappings":";;AAkBA,gEAUC;AAGD,kEAQC;AAvCD;;;;;;;;;;;GAWG;AACH,6CAA4C;AAC5C,mEAAkG;AAElG,gEAAuG;AAEvG,qGAAqG;AACrG,SAAgB,0BAA0B,CAAC,QAA4C;IACrF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAA;IAC1C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QAC5C,sDAAsD;QACtD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QAC1F,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC,CAAA;QAC/F,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IACjC,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,kBAAkB,IAAI,KAAK,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAC3G,CAAC;AAED,4EAA4E;AAC5E,SAAgB,2BAA2B,CAAC,QAA6C;IACvF,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAA;IAC1C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAA;QAC7C,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;QACrF,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAClC,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,kBAAkB,IAAI,KAAK,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAC9G,CAAC;AAED;;;GAGG;AACH,OAAO,CAAC,EAAE,CAAC,wBAA+B,EAAE,GAAG,EAAE;IAC/C,KAAK,MAAM,IAAI,IAAI,0BAA0B,CAAC,IAAA,wCAAuB,GAAE,CAAC;QAAE,YAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC3F,KAAK,MAAM,IAAI,IAAI,2BAA2B,CAAC,IAAA,mCAAwB,GAAE,CAAC;QAAE,YAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAC/F,CAAC,CAAC,CAAA","sourcesContent":["/*\n * At boot, say what registered but is not yet what the contracts require — tools with no privilege\n * (A1 stage one) and modes offering `/` sentences their tools cannot answer (ADR-0058 decision 3).\n *\n * One window, because it is one question: what state is this deployment's AI in (standard A7-a).\n *\n * Registration no longer refuses a tool that changes something without declaring its privilege —\n * refusing would stop apps whose tools predate the field. The registry records each omission as a\n * code instead. This prints that list once, after every module has registered, grouped by code,\n * so the person starting the server sees which tools still need a declaration. When the list is\n * empty across the apps, registration becomes a refusal and this report goes away.\n */\nimport { logger } from '@things-factory/env'\nimport { getToolRegistryWarnings, type ToolRegistryWarning } from '@things-factory/ai-client-base'\n\nimport { getAssistantModeWarnings, type AssistantModeWarning } from './service/assistant-mode/index.js'\n\n/** One line per code: the code, how many, and which tools. Empty when there is nothing to report. */\nexport function formatToolRegistryWarnings(warnings: ReadonlyArray<ToolRegistryWarning>): string[] {\n  const byCode = new Map<string, string[]>()\n  for (const warning of warnings) {\n    const tools = byCode.get(warning.code) ?? []\n    /* 문 이름이 있으면 함께 적는다 — 「어느 문이 아직 선언이 없나」가 다음에 할 일이다. */\n    const doors = warning.params.doors?.length ? ` → ${warning.params.doors.join(' + ')}` : ''\n    tools.push(`${warning.params.category}/${warning.params.tool}(${warning.params.kind})${doors}`)\n    byCode.set(warning.code, tools)\n  }\n  return [...byCode].map(([code, tools]) => `[ai-assistant] ${code} ×${tools.length}: ${tools.join(', ')}`)\n}\n\n/** One line per code: the code, how many, and which modes promised what. */\nexport function formatAssistantModeWarnings(warnings: ReadonlyArray<AssistantModeWarning>): string[] {\n  const byCode = new Map<string, string[]>()\n  for (const warning of warnings) {\n    const offers = byCode.get(warning.code) ?? []\n    offers.push(`${warning.params.kind}:/${warning.params.slash}→${warning.params.tool}`)\n    byCode.set(warning.code, offers)\n  }\n  return [...byCode].map(([code, offers]) => `[ai-assistant] ${code} ×${offers.length}: ${offers.join(', ')}`)\n}\n\n/*\n * After every module has registered: a mode may declare its slash sentences before the package\n * that registers the tools they need, so this cannot be checked when the mode registers.\n */\nprocess.on('bootstrap-module-start' as any, () => {\n  for (const line of formatToolRegistryWarnings(getToolRegistryWarnings())) logger.warn(line)\n  for (const line of formatAssistantModeWarnings(getAssistantModeWarnings())) logger.warn(line)\n})\n"]}