@charivo/llm 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Zeikar
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,54 @@
1
+ # @charivo/llm
2
+
3
+ Stateful LLM manager for Charivo conversations.
4
+
5
+ `@charivo/llm` owns character-aware prompt building and message history.
6
+ It wraps an `LLMClient` implementation from another package.
7
+
8
+ ## Install
9
+
10
+ ```bash
11
+ pnpm add @charivo/llm
12
+ ```
13
+
14
+ ## Usage
15
+
16
+ ```ts
17
+ import { createLLMManager } from "@charivo/llm";
18
+ import { createRemoteLLMClient } from "@charivo/llm/remote";
19
+
20
+ const manager = createLLMManager(
21
+ createRemoteLLMClient({ apiEndpoint: "/api/chat" }),
22
+ );
23
+
24
+ manager.setCharacter({
25
+ id: "hiyori",
26
+ name: "Hiyori",
27
+ personality: "Cheerful and helpful assistant",
28
+ });
29
+
30
+ const reply = await manager.generateResponse({
31
+ id: "1",
32
+ content: "Hello",
33
+ timestamp: new Date(),
34
+ type: "user",
35
+ });
36
+ ```
37
+
38
+ ## Exports
39
+
40
+ - `LLMManager`
41
+ - `createLLMManager(client)`
42
+ - `CharacterPromptBuilder`
43
+ - `MessageHistoryManager`
44
+ - `MessageConverter`
45
+ - `ResponseMessageBuilder`
46
+ - `LLMValidators`
47
+
48
+ ## Manager API
49
+
50
+ - `setCharacter(character)`
51
+ - `getCharacter()`
52
+ - `generateResponse(message)`
53
+ - `getHistory()`
54
+ - `clearHistory()`
@@ -0,0 +1,104 @@
1
+ import { Character, Message, LLMClient } from '@charivo/core';
2
+
3
+ /**
4
+ * 캐릭터 정보를 시스템 프롬프트로 변환하는 유틸리티
5
+ */
6
+ declare class CharacterPromptBuilder {
7
+ static buildSystemPrompt(character: Character): string;
8
+ static buildSystemPromptOrDefault(character?: Character): string;
9
+ }
10
+
11
+ /**
12
+ * 메시지 히스토리 관리
13
+ */
14
+ declare class MessageHistoryManager {
15
+ private history;
16
+ add(message: Message): void;
17
+ removeLast(): Message | undefined;
18
+ clear(): void;
19
+ getAll(): Message[];
20
+ size(): number;
21
+ }
22
+
23
+ /**
24
+ * 메시지 형식 변환 유틸리티
25
+ */
26
+ declare class MessageConverter {
27
+ /**
28
+ * Charivo Message를 OpenAI 형식으로 변환
29
+ */
30
+ static toOpenAIFormat(messages: Message[]): Array<{
31
+ role: string;
32
+ content: string;
33
+ }>;
34
+ /**
35
+ * 시스템 프롬프트와 메시지들을 OpenAI 형식으로 결합
36
+ */
37
+ static combineWithSystemPrompt(systemPrompt: string, messages: Message[]): Array<{
38
+ role: string;
39
+ content: string;
40
+ }>;
41
+ }
42
+
43
+ /**
44
+ * AI 응답 메시지 생성 헬퍼
45
+ */
46
+ declare class ResponseMessageBuilder {
47
+ static create(content: string, characterId: string, messageId?: string): Message;
48
+ }
49
+
50
+ /**
51
+ * LLM 관련 검증 유틸리티
52
+ */
53
+ declare class LLMValidators {
54
+ static validateCharacterSet(character: Character | null): asserts character is Character;
55
+ static validateMessage(message: Message): void;
56
+ }
57
+
58
+ /**
59
+ * LLM Manager - LLM 세션의 상태 관리를 담당하는 클래스
60
+ *
61
+ * 역할:
62
+ * - 캐릭터 설정 및 관리
63
+ * - 메시지 히스토리 관리
64
+ * - LLM 클라이언트와의 통신
65
+ * - 메시지 형식 변환
66
+ * - 프롬프트 생성
67
+ */
68
+ declare class LLMManager {
69
+ private llmClient;
70
+ private historyManager;
71
+ private character;
72
+ constructor(llmClient: LLMClient);
73
+ /**
74
+ * 캐릭터 설정
75
+ * 캐릭터가 변경되는 경우에만 히스토리를 초기화합니다.
76
+ */
77
+ setCharacter(character: Character): void;
78
+ /**
79
+ * 현재 설정된 캐릭터 반환
80
+ */
81
+ getCharacter(): Character | null;
82
+ /**
83
+ * 히스토리 초기화
84
+ */
85
+ clearHistory(): void;
86
+ /**
87
+ * 현재 히스토리 반환
88
+ */
89
+ getHistory(): Message[];
90
+ /**
91
+ * 메시지 응답 생성
92
+ */
93
+ generateResponse(message: Message): Promise<string>;
94
+ /**
95
+ * LLM API 호출을 위한 메시지 준비
96
+ */
97
+ private prepareApiMessages;
98
+ }
99
+ /**
100
+ * LLM Manager 생성 헬퍼 함수
101
+ */
102
+ declare function createLLMManager(llmClient: LLMClient): LLMManager;
103
+
104
+ export { CharacterPromptBuilder, LLMManager, LLMValidators, MessageConverter, MessageHistoryManager, ResponseMessageBuilder, createLLMManager };
@@ -0,0 +1,104 @@
1
+ import { Character, Message, LLMClient } from '@charivo/core';
2
+
3
+ /**
4
+ * 캐릭터 정보를 시스템 프롬프트로 변환하는 유틸리티
5
+ */
6
+ declare class CharacterPromptBuilder {
7
+ static buildSystemPrompt(character: Character): string;
8
+ static buildSystemPromptOrDefault(character?: Character): string;
9
+ }
10
+
11
+ /**
12
+ * 메시지 히스토리 관리
13
+ */
14
+ declare class MessageHistoryManager {
15
+ private history;
16
+ add(message: Message): void;
17
+ removeLast(): Message | undefined;
18
+ clear(): void;
19
+ getAll(): Message[];
20
+ size(): number;
21
+ }
22
+
23
+ /**
24
+ * 메시지 형식 변환 유틸리티
25
+ */
26
+ declare class MessageConverter {
27
+ /**
28
+ * Charivo Message를 OpenAI 형식으로 변환
29
+ */
30
+ static toOpenAIFormat(messages: Message[]): Array<{
31
+ role: string;
32
+ content: string;
33
+ }>;
34
+ /**
35
+ * 시스템 프롬프트와 메시지들을 OpenAI 형식으로 결합
36
+ */
37
+ static combineWithSystemPrompt(systemPrompt: string, messages: Message[]): Array<{
38
+ role: string;
39
+ content: string;
40
+ }>;
41
+ }
42
+
43
+ /**
44
+ * AI 응답 메시지 생성 헬퍼
45
+ */
46
+ declare class ResponseMessageBuilder {
47
+ static create(content: string, characterId: string, messageId?: string): Message;
48
+ }
49
+
50
+ /**
51
+ * LLM 관련 검증 유틸리티
52
+ */
53
+ declare class LLMValidators {
54
+ static validateCharacterSet(character: Character | null): asserts character is Character;
55
+ static validateMessage(message: Message): void;
56
+ }
57
+
58
+ /**
59
+ * LLM Manager - LLM 세션의 상태 관리를 담당하는 클래스
60
+ *
61
+ * 역할:
62
+ * - 캐릭터 설정 및 관리
63
+ * - 메시지 히스토리 관리
64
+ * - LLM 클라이언트와의 통신
65
+ * - 메시지 형식 변환
66
+ * - 프롬프트 생성
67
+ */
68
+ declare class LLMManager {
69
+ private llmClient;
70
+ private historyManager;
71
+ private character;
72
+ constructor(llmClient: LLMClient);
73
+ /**
74
+ * 캐릭터 설정
75
+ * 캐릭터가 변경되는 경우에만 히스토리를 초기화합니다.
76
+ */
77
+ setCharacter(character: Character): void;
78
+ /**
79
+ * 현재 설정된 캐릭터 반환
80
+ */
81
+ getCharacter(): Character | null;
82
+ /**
83
+ * 히스토리 초기화
84
+ */
85
+ clearHistory(): void;
86
+ /**
87
+ * 현재 히스토리 반환
88
+ */
89
+ getHistory(): Message[];
90
+ /**
91
+ * 메시지 응답 생성
92
+ */
93
+ generateResponse(message: Message): Promise<string>;
94
+ /**
95
+ * LLM API 호출을 위한 메시지 준비
96
+ */
97
+ private prepareApiMessages;
98
+ }
99
+ /**
100
+ * LLM Manager 생성 헬퍼 함수
101
+ */
102
+ declare function createLLMManager(llmClient: LLMClient): LLMManager;
103
+
104
+ export { CharacterPromptBuilder, LLMManager, LLMValidators, MessageConverter, MessageHistoryManager, ResponseMessageBuilder, createLLMManager };
package/dist/index.js ADDED
@@ -0,0 +1,175 @@
1
+ 'use strict';
2
+
3
+ // src/character-prompt-builder.ts
4
+ var CharacterPromptBuilder = class {
5
+ static buildSystemPrompt(character) {
6
+ const name = character.name;
7
+ const description = character.description || "";
8
+ const personality = character.personality || "";
9
+ return `You are ${name}. ${description} ${personality}
10
+
11
+ Respond naturally in plain text with no bracketed emotion tags or control markup.`.trim();
12
+ }
13
+ static buildSystemPromptOrDefault(character) {
14
+ if (character) {
15
+ return this.buildSystemPrompt(character);
16
+ }
17
+ return `You are a helpful assistant.
18
+
19
+ Respond naturally in plain text with no bracketed emotion tags or control markup.`.trim();
20
+ }
21
+ };
22
+
23
+ // src/message-history-manager.ts
24
+ var MessageHistoryManager = class {
25
+ history = [];
26
+ add(message) {
27
+ this.history.push(message);
28
+ }
29
+ removeLast() {
30
+ return this.history.pop();
31
+ }
32
+ clear() {
33
+ this.history = [];
34
+ }
35
+ getAll() {
36
+ return [...this.history];
37
+ }
38
+ size() {
39
+ return this.history.length;
40
+ }
41
+ };
42
+
43
+ // src/message-converter.ts
44
+ var MessageConverter = class {
45
+ /**
46
+ * Charivo Message를 OpenAI 형식으로 변환
47
+ */
48
+ static toOpenAIFormat(messages) {
49
+ return messages.map((msg) => ({
50
+ role: msg.type === "user" ? "user" : "assistant",
51
+ content: msg.content
52
+ }));
53
+ }
54
+ /**
55
+ * 시스템 프롬프트와 메시지들을 OpenAI 형식으로 결합
56
+ */
57
+ static combineWithSystemPrompt(systemPrompt, messages) {
58
+ return [
59
+ { role: "system", content: systemPrompt },
60
+ ...this.toOpenAIFormat(messages)
61
+ ];
62
+ }
63
+ };
64
+
65
+ // src/response-message-builder.ts
66
+ var ResponseMessageBuilder = class {
67
+ static create(content, characterId, messageId) {
68
+ return {
69
+ id: messageId || "ai-" + Date.now(),
70
+ content,
71
+ timestamp: /* @__PURE__ */ new Date(),
72
+ type: "character",
73
+ characterId
74
+ };
75
+ }
76
+ };
77
+
78
+ // src/validators.ts
79
+ var LLMValidators = class {
80
+ static validateCharacterSet(character) {
81
+ if (!character) {
82
+ throw new Error("Character must be set before generating response");
83
+ }
84
+ }
85
+ static validateMessage(message) {
86
+ if (!message.content || typeof message.content !== "string") {
87
+ throw new Error("Message content must be a non-empty string");
88
+ }
89
+ }
90
+ };
91
+
92
+ // src/llm-manager.ts
93
+ var LLMManager = class {
94
+ constructor(llmClient) {
95
+ this.llmClient = llmClient;
96
+ }
97
+ historyManager = new MessageHistoryManager();
98
+ character = null;
99
+ /**
100
+ * 캐릭터 설정
101
+ * 캐릭터가 변경되는 경우에만 히스토리를 초기화합니다.
102
+ */
103
+ setCharacter(character) {
104
+ if (this.character?.id !== character.id) {
105
+ this.historyManager.clear();
106
+ }
107
+ this.character = character;
108
+ }
109
+ /**
110
+ * 현재 설정된 캐릭터 반환
111
+ */
112
+ getCharacter() {
113
+ return this.character;
114
+ }
115
+ /**
116
+ * 히스토리 초기화
117
+ */
118
+ clearHistory() {
119
+ this.historyManager.clear();
120
+ }
121
+ /**
122
+ * 현재 히스토리 반환
123
+ */
124
+ getHistory() {
125
+ return this.historyManager.getAll();
126
+ }
127
+ /**
128
+ * 메시지 응답 생성
129
+ */
130
+ async generateResponse(message) {
131
+ LLMValidators.validateCharacterSet(this.character);
132
+ LLMValidators.validateMessage(message);
133
+ this.historyManager.add(message);
134
+ const historyMessages = this.historyManager.getAll();
135
+ const apiMessages = this.prepareApiMessages(historyMessages);
136
+ try {
137
+ const assistantMessage = await this.llmClient.call(apiMessages);
138
+ const responseMessage = ResponseMessageBuilder.create(
139
+ assistantMessage,
140
+ this.character.id
141
+ // validateCharacterSet 후 character는 non-null 보장됨
142
+ );
143
+ this.historyManager.add(responseMessage);
144
+ return assistantMessage;
145
+ } catch (error) {
146
+ this.historyManager.removeLast();
147
+ throw error;
148
+ }
149
+ }
150
+ /**
151
+ * LLM API 호출을 위한 메시지 준비
152
+ */
153
+ prepareApiMessages(messages) {
154
+ if (!this.character) {
155
+ return MessageConverter.toOpenAIFormat(messages);
156
+ }
157
+ const systemPrompt = CharacterPromptBuilder.buildSystemPrompt(
158
+ this.character
159
+ );
160
+ return MessageConverter.combineWithSystemPrompt(systemPrompt, messages);
161
+ }
162
+ };
163
+ function createLLMManager(llmClient) {
164
+ return new LLMManager(llmClient);
165
+ }
166
+
167
+ exports.CharacterPromptBuilder = CharacterPromptBuilder;
168
+ exports.LLMManager = LLMManager;
169
+ exports.LLMValidators = LLMValidators;
170
+ exports.MessageConverter = MessageConverter;
171
+ exports.MessageHistoryManager = MessageHistoryManager;
172
+ exports.ResponseMessageBuilder = ResponseMessageBuilder;
173
+ exports.createLLMManager = createLLMManager;
174
+ //# sourceMappingURL=index.js.map
175
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/character-prompt-builder.ts","../src/message-history-manager.ts","../src/message-converter.ts","../src/response-message-builder.ts","../src/validators.ts","../src/llm-manager.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { Character } from \"@charivo/core\";\n\n/**\n * 캐릭터 정보를 시스템 프롬프트로 변환하는 유틸리티\n */\nexport class CharacterPromptBuilder {\n static buildSystemPrompt(character: Character): string {\n const name = character.name;\n const description = character.description || \"\";\n const personality = character.personality || \"\";\n\n return `You are ${name}. ${description} ${personality}\n\nRespond naturally in plain text with no bracketed emotion tags or control markup.`.trim();\n }\n\n static buildSystemPromptOrDefault(character?: Character): string {\n if (character) {\n return this.buildSystemPrompt(character);\n }\n return `You are a helpful assistant.\n\nRespond naturally in plain text with no bracketed emotion tags or control markup.`.trim();\n }\n}\n","import { Message } from \"@charivo/core\";\n\n/**\n * 메시지 히스토리 관리\n */\nexport class MessageHistoryManager {\n private history: Message[] = [];\n\n add(message: Message): void {\n this.history.push(message);\n }\n\n removeLast(): Message | undefined {\n return this.history.pop();\n }\n\n clear(): void {\n this.history = [];\n }\n\n getAll(): Message[] {\n return [...this.history]; // 복사본 반환\n }\n\n size(): number {\n return this.history.length;\n }\n}\n","import { Message } from \"@charivo/core\";\n\n/**\n * 메시지 형식 변환 유틸리티\n */\nexport class MessageConverter {\n /**\n * Charivo Message를 OpenAI 형식으로 변환\n */\n static toOpenAIFormat(\n messages: Message[],\n ): Array<{ role: string; content: string }> {\n return messages.map((msg) => ({\n role: msg.type === \"user\" ? \"user\" : \"assistant\",\n content: msg.content,\n }));\n }\n\n /**\n * 시스템 프롬프트와 메시지들을 OpenAI 형식으로 결합\n */\n static combineWithSystemPrompt(\n systemPrompt: string,\n messages: Message[],\n ): Array<{ role: string; content: string }> {\n return [\n { role: \"system\", content: systemPrompt },\n ...this.toOpenAIFormat(messages),\n ];\n }\n}\n","import { Message } from \"@charivo/core\";\n\n/**\n * AI 응답 메시지 생성 헬퍼\n */\nexport class ResponseMessageBuilder {\n static create(\n content: string,\n characterId: string,\n messageId?: string,\n ): Message {\n return {\n id: messageId || \"ai-\" + Date.now(),\n content,\n timestamp: new Date(),\n type: \"character\",\n characterId,\n };\n }\n}\n","import { Character, Message } from \"@charivo/core\";\n\n/**\n * LLM 관련 검증 유틸리티\n */\nexport class LLMValidators {\n static validateCharacterSet(\n character: Character | null,\n ): asserts character is Character {\n if (!character) {\n throw new Error(\"Character must be set before generating response\");\n }\n }\n\n static validateMessage(message: Message): void {\n if (!message.content || typeof message.content !== \"string\") {\n throw new Error(\"Message content must be a non-empty string\");\n }\n }\n}\n","import { LLMClient, Message, Character } from \"@charivo/core\";\nimport { MessageHistoryManager } from \"./message-history-manager\";\nimport { CharacterPromptBuilder } from \"./character-prompt-builder\";\nimport { MessageConverter } from \"./message-converter\";\nimport { LLMValidators } from \"./validators\";\nimport { ResponseMessageBuilder } from \"./response-message-builder\";\n\n/**\n * LLM Manager - LLM 세션의 상태 관리를 담당하는 클래스\n *\n * 역할:\n * - 캐릭터 설정 및 관리\n * - 메시지 히스토리 관리\n * - LLM 클라이언트와의 통신\n * - 메시지 형식 변환\n * - 프롬프트 생성\n */\nexport class LLMManager {\n private historyManager = new MessageHistoryManager();\n private character: Character | null = null;\n\n constructor(private llmClient: LLMClient) {}\n\n /**\n * 캐릭터 설정\n * 캐릭터가 변경되는 경우에만 히스토리를 초기화합니다.\n */\n setCharacter(character: Character): void {\n // 캐릭터가 변경되는 경우에만 히스토리 초기화\n if (this.character?.id !== character.id) {\n this.historyManager.clear();\n }\n this.character = character;\n }\n\n /**\n * 현재 설정된 캐릭터 반환\n */\n getCharacter(): Character | null {\n return this.character;\n }\n\n /**\n * 히스토리 초기화\n */\n clearHistory(): void {\n this.historyManager.clear();\n }\n\n /**\n * 현재 히스토리 반환\n */\n getHistory(): Message[] {\n return this.historyManager.getAll();\n }\n\n /**\n * 메시지 응답 생성\n */\n async generateResponse(message: Message): Promise<string> {\n LLMValidators.validateCharacterSet(this.character);\n LLMValidators.validateMessage(message);\n\n // 새 메시지를 히스토리에 추가\n this.historyManager.add(message);\n\n // 히스토리 메시지 가져오기\n const historyMessages = this.historyManager.getAll();\n\n // LLM API 형식으로 변환 (시스템 프롬프트 포함)\n const apiMessages = this.prepareApiMessages(historyMessages);\n\n try {\n // LLM 클라이언트를 통해 응답 생성\n const assistantMessage = await this.llmClient.call(apiMessages);\n\n // AI 응답 메시지 생성 및 히스토리에 추가\n const responseMessage = ResponseMessageBuilder.create(\n assistantMessage,\n this.character!.id, // validateCharacterSet 후 character는 non-null 보장됨\n );\n this.historyManager.add(responseMessage);\n\n return assistantMessage;\n } catch (error) {\n // 에러가 발생하면 마지막 메시지를 히스토리에서 제거\n this.historyManager.removeLast();\n throw error;\n }\n }\n\n /**\n * LLM API 호출을 위한 메시지 준비\n */\n private prepareApiMessages(\n messages: Message[],\n ): Array<{ role: string; content: string }> {\n if (!this.character) {\n return MessageConverter.toOpenAIFormat(messages);\n }\n\n const systemPrompt = CharacterPromptBuilder.buildSystemPrompt(\n this.character,\n );\n return MessageConverter.combineWithSystemPrompt(systemPrompt, messages);\n }\n}\n\n/**\n * LLM Manager 생성 헬퍼 함수\n */\nexport function createLLMManager(llmClient: LLMClient): LLMManager {\n return new LLMManager(llmClient);\n}\n"]}
package/dist/index.mjs ADDED
@@ -0,0 +1,167 @@
1
+ // src/character-prompt-builder.ts
2
+ var CharacterPromptBuilder = class {
3
+ static buildSystemPrompt(character) {
4
+ const name = character.name;
5
+ const description = character.description || "";
6
+ const personality = character.personality || "";
7
+ return `You are ${name}. ${description} ${personality}
8
+
9
+ Respond naturally in plain text with no bracketed emotion tags or control markup.`.trim();
10
+ }
11
+ static buildSystemPromptOrDefault(character) {
12
+ if (character) {
13
+ return this.buildSystemPrompt(character);
14
+ }
15
+ return `You are a helpful assistant.
16
+
17
+ Respond naturally in plain text with no bracketed emotion tags or control markup.`.trim();
18
+ }
19
+ };
20
+
21
+ // src/message-history-manager.ts
22
+ var MessageHistoryManager = class {
23
+ history = [];
24
+ add(message) {
25
+ this.history.push(message);
26
+ }
27
+ removeLast() {
28
+ return this.history.pop();
29
+ }
30
+ clear() {
31
+ this.history = [];
32
+ }
33
+ getAll() {
34
+ return [...this.history];
35
+ }
36
+ size() {
37
+ return this.history.length;
38
+ }
39
+ };
40
+
41
+ // src/message-converter.ts
42
+ var MessageConverter = class {
43
+ /**
44
+ * Charivo Message를 OpenAI 형식으로 변환
45
+ */
46
+ static toOpenAIFormat(messages) {
47
+ return messages.map((msg) => ({
48
+ role: msg.type === "user" ? "user" : "assistant",
49
+ content: msg.content
50
+ }));
51
+ }
52
+ /**
53
+ * 시스템 프롬프트와 메시지들을 OpenAI 형식으로 결합
54
+ */
55
+ static combineWithSystemPrompt(systemPrompt, messages) {
56
+ return [
57
+ { role: "system", content: systemPrompt },
58
+ ...this.toOpenAIFormat(messages)
59
+ ];
60
+ }
61
+ };
62
+
63
+ // src/response-message-builder.ts
64
+ var ResponseMessageBuilder = class {
65
+ static create(content, characterId, messageId) {
66
+ return {
67
+ id: messageId || "ai-" + Date.now(),
68
+ content,
69
+ timestamp: /* @__PURE__ */ new Date(),
70
+ type: "character",
71
+ characterId
72
+ };
73
+ }
74
+ };
75
+
76
+ // src/validators.ts
77
+ var LLMValidators = class {
78
+ static validateCharacterSet(character) {
79
+ if (!character) {
80
+ throw new Error("Character must be set before generating response");
81
+ }
82
+ }
83
+ static validateMessage(message) {
84
+ if (!message.content || typeof message.content !== "string") {
85
+ throw new Error("Message content must be a non-empty string");
86
+ }
87
+ }
88
+ };
89
+
90
+ // src/llm-manager.ts
91
+ var LLMManager = class {
92
+ constructor(llmClient) {
93
+ this.llmClient = llmClient;
94
+ }
95
+ historyManager = new MessageHistoryManager();
96
+ character = null;
97
+ /**
98
+ * 캐릭터 설정
99
+ * 캐릭터가 변경되는 경우에만 히스토리를 초기화합니다.
100
+ */
101
+ setCharacter(character) {
102
+ if (this.character?.id !== character.id) {
103
+ this.historyManager.clear();
104
+ }
105
+ this.character = character;
106
+ }
107
+ /**
108
+ * 현재 설정된 캐릭터 반환
109
+ */
110
+ getCharacter() {
111
+ return this.character;
112
+ }
113
+ /**
114
+ * 히스토리 초기화
115
+ */
116
+ clearHistory() {
117
+ this.historyManager.clear();
118
+ }
119
+ /**
120
+ * 현재 히스토리 반환
121
+ */
122
+ getHistory() {
123
+ return this.historyManager.getAll();
124
+ }
125
+ /**
126
+ * 메시지 응답 생성
127
+ */
128
+ async generateResponse(message) {
129
+ LLMValidators.validateCharacterSet(this.character);
130
+ LLMValidators.validateMessage(message);
131
+ this.historyManager.add(message);
132
+ const historyMessages = this.historyManager.getAll();
133
+ const apiMessages = this.prepareApiMessages(historyMessages);
134
+ try {
135
+ const assistantMessage = await this.llmClient.call(apiMessages);
136
+ const responseMessage = ResponseMessageBuilder.create(
137
+ assistantMessage,
138
+ this.character.id
139
+ // validateCharacterSet 후 character는 non-null 보장됨
140
+ );
141
+ this.historyManager.add(responseMessage);
142
+ return assistantMessage;
143
+ } catch (error) {
144
+ this.historyManager.removeLast();
145
+ throw error;
146
+ }
147
+ }
148
+ /**
149
+ * LLM API 호출을 위한 메시지 준비
150
+ */
151
+ prepareApiMessages(messages) {
152
+ if (!this.character) {
153
+ return MessageConverter.toOpenAIFormat(messages);
154
+ }
155
+ const systemPrompt = CharacterPromptBuilder.buildSystemPrompt(
156
+ this.character
157
+ );
158
+ return MessageConverter.combineWithSystemPrompt(systemPrompt, messages);
159
+ }
160
+ };
161
+ function createLLMManager(llmClient) {
162
+ return new LLMManager(llmClient);
163
+ }
164
+
165
+ export { CharacterPromptBuilder, LLMManager, LLMValidators, MessageConverter, MessageHistoryManager, ResponseMessageBuilder, createLLMManager };
166
+ //# sourceMappingURL=index.mjs.map
167
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/character-prompt-builder.ts","../src/message-history-manager.ts","../src/message-converter.ts","../src/response-message-builder.ts","../src/validators.ts","../src/llm-manager.ts"],"names":[],"mappings":";AAKO,IAAM,yBAAN,MAA6B;AAAA,EAClC,OAAO,kBAAkB,SAAA,EAA8B;AACrD,IAAA,MAAM,OAAO,SAAA,CAAU,IAAA;AACvB,IAAA,MAAM,WAAA,GAAc,UAAU,WAAA,IAAe,EAAA;AAC7C,IAAA,MAAM,WAAA,GAAc,UAAU,WAAA,IAAe,EAAA;AAE7C,IAAA,OAAO,CAAA,QAAA,EAAW,IAAI,CAAA,EAAA,EAAK,WAAW,IAAI,WAAW;;AAAA,iFAAA,CAAA,CAE0B,IAAA,EAAK;AAAA,EACtF;AAAA,EAEA,OAAO,2BAA2B,SAAA,EAA+B;AAC/D,IAAA,IAAI,SAAA,EAAW;AACb,MAAA,OAAO,IAAA,CAAK,kBAAkB,SAAS,CAAA;AAAA,IACzC;AACA,IAAA,OAAO,CAAA;;AAAA,iFAAA,CAAA,CAEwE,IAAA,EAAK;AAAA,EACtF;AACF;;;ACnBO,IAAM,wBAAN,MAA4B;AAAA,EACzB,UAAqB,EAAC;AAAA,EAE9B,IAAI,OAAA,EAAwB;AAC1B,IAAA,IAAA,CAAK,OAAA,CAAQ,KAAK,OAAO,CAAA;AAAA,EAC3B;AAAA,EAEA,UAAA,GAAkC;AAChC,IAAA,OAAO,IAAA,CAAK,QAAQ,GAAA,EAAI;AAAA,EAC1B;AAAA,EAEA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,UAAU,EAAC;AAAA,EAClB;AAAA,EAEA,MAAA,GAAoB;AAClB,IAAA,OAAO,CAAC,GAAG,IAAA,CAAK,OAAO,CAAA;AAAA,EACzB;AAAA,EAEA,IAAA,GAAe;AACb,IAAA,OAAO,KAAK,OAAA,CAAQ,MAAA;AAAA,EACtB;AACF;;;ACtBO,IAAM,mBAAN,MAAuB;AAAA;AAAA;AAAA;AAAA,EAI5B,OAAO,eACL,QAAA,EAC0C;AAC1C,IAAA,OAAO,QAAA,CAAS,GAAA,CAAI,CAAC,GAAA,MAAS;AAAA,MAC5B,IAAA,EAAM,GAAA,CAAI,IAAA,KAAS,MAAA,GAAS,MAAA,GAAS,WAAA;AAAA,MACrC,SAAS,GAAA,CAAI;AAAA,KACf,CAAE,CAAA;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,uBAAA,CACL,YAAA,EACA,QAAA,EAC0C;AAC1C,IAAA,OAAO;AAAA,MACL,EAAE,IAAA,EAAM,QAAA,EAAU,OAAA,EAAS,YAAA,EAAa;AAAA,MACxC,GAAG,IAAA,CAAK,cAAA,CAAe,QAAQ;AAAA,KACjC;AAAA,EACF;AACF;;;ACzBO,IAAM,yBAAN,MAA6B;AAAA,EAClC,OAAO,MAAA,CACL,OAAA,EACA,WAAA,EACA,SAAA,EACS;AACT,IAAA,OAAO;AAAA,MACL,EAAA,EAAI,SAAA,IAAa,KAAA,GAAQ,IAAA,CAAK,GAAA,EAAI;AAAA,MAClC,OAAA;AAAA,MACA,SAAA,sBAAe,IAAA,EAAK;AAAA,MACpB,IAAA,EAAM,WAAA;AAAA,MACN;AAAA,KACF;AAAA,EACF;AACF;;;ACdO,IAAM,gBAAN,MAAoB;AAAA,EACzB,OAAO,qBACL,SAAA,EACgC;AAChC,IAAA,IAAI,CAAC,SAAA,EAAW;AACd,MAAA,MAAM,IAAI,MAAM,kDAAkD,CAAA;AAAA,IACpE;AAAA,EACF;AAAA,EAEA,OAAO,gBAAgB,OAAA,EAAwB;AAC7C,IAAA,IAAI,CAAC,OAAA,CAAQ,OAAA,IAAW,OAAO,OAAA,CAAQ,YAAY,QAAA,EAAU;AAC3D,MAAA,MAAM,IAAI,MAAM,4CAA4C,CAAA;AAAA,IAC9D;AAAA,EACF;AACF;;;ACFO,IAAM,aAAN,MAAiB;AAAA,EAItB,YAAoB,SAAA,EAAsB;AAAtB,IAAA,IAAA,CAAA,SAAA,GAAA,SAAA;AAAA,EAAuB;AAAA,EAHnC,cAAA,GAAiB,IAAI,qBAAA,EAAsB;AAAA,EAC3C,SAAA,GAA8B,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQtC,aAAa,SAAA,EAA4B;AAEvC,IAAA,IAAI,IAAA,CAAK,SAAA,EAAW,EAAA,KAAO,SAAA,CAAU,EAAA,EAAI;AACvC,MAAA,IAAA,CAAK,eAAe,KAAA,EAAM;AAAA,IAC5B;AACA,IAAA,IAAA,CAAK,SAAA,GAAY,SAAA;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA,EAKA,YAAA,GAAiC;AAC/B,IAAA,OAAO,IAAA,CAAK,SAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKA,YAAA,GAAqB;AACnB,IAAA,IAAA,CAAK,eAAe,KAAA,EAAM;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA,EAKA,UAAA,GAAwB;AACtB,IAAA,OAAO,IAAA,CAAK,eAAe,MAAA,EAAO;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,iBAAiB,OAAA,EAAmC;AACxD,IAAA,aAAA,CAAc,oBAAA,CAAqB,KAAK,SAAS,CAAA;AACjD,IAAA,aAAA,CAAc,gBAAgB,OAAO,CAAA;AAGrC,IAAA,IAAA,CAAK,cAAA,CAAe,IAAI,OAAO,CAAA;AAG/B,IAAA,MAAM,eAAA,GAAkB,IAAA,CAAK,cAAA,CAAe,MAAA,EAAO;AAGnD,IAAA,MAAM,WAAA,GAAc,IAAA,CAAK,kBAAA,CAAmB,eAAe,CAAA;AAE3D,IAAA,IAAI;AAEF,MAAA,MAAM,gBAAA,GAAmB,MAAM,IAAA,CAAK,SAAA,CAAU,KAAK,WAAW,CAAA;AAG9D,MAAA,MAAM,kBAAkB,sBAAA,CAAuB,MAAA;AAAA,QAC7C,gBAAA;AAAA,QACA,KAAK,SAAA,CAAW;AAAA;AAAA,OAClB;AACA,MAAA,IAAA,CAAK,cAAA,CAAe,IAAI,eAAe,CAAA;AAEvC,MAAA,OAAO,gBAAA;AAAA,IACT,SAAS,KAAA,EAAO;AAEd,MAAA,IAAA,CAAK,eAAe,UAAA,EAAW;AAC/B,MAAA,MAAM,KAAA;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,mBACN,QAAA,EAC0C;AAC1C,IAAA,IAAI,CAAC,KAAK,SAAA,EAAW;AACnB,MAAA,OAAO,gBAAA,CAAiB,eAAe,QAAQ,CAAA;AAAA,IACjD;AAEA,IAAA,MAAM,eAAe,sBAAA,CAAuB,iBAAA;AAAA,MAC1C,IAAA,CAAK;AAAA,KACP;AACA,IAAA,OAAO,gBAAA,CAAiB,uBAAA,CAAwB,YAAA,EAAc,QAAQ,CAAA;AAAA,EACxE;AACF;AAKO,SAAS,iBAAiB,SAAA,EAAkC;AACjE,EAAA,OAAO,IAAI,WAAW,SAAS,CAAA;AACjC","file":"index.mjs","sourcesContent":["import { Character } from \"@charivo/core\";\n\n/**\n * 캐릭터 정보를 시스템 프롬프트로 변환하는 유틸리티\n */\nexport class CharacterPromptBuilder {\n static buildSystemPrompt(character: Character): string {\n const name = character.name;\n const description = character.description || \"\";\n const personality = character.personality || \"\";\n\n return `You are ${name}. ${description} ${personality}\n\nRespond naturally in plain text with no bracketed emotion tags or control markup.`.trim();\n }\n\n static buildSystemPromptOrDefault(character?: Character): string {\n if (character) {\n return this.buildSystemPrompt(character);\n }\n return `You are a helpful assistant.\n\nRespond naturally in plain text with no bracketed emotion tags or control markup.`.trim();\n }\n}\n","import { Message } from \"@charivo/core\";\n\n/**\n * 메시지 히스토리 관리\n */\nexport class MessageHistoryManager {\n private history: Message[] = [];\n\n add(message: Message): void {\n this.history.push(message);\n }\n\n removeLast(): Message | undefined {\n return this.history.pop();\n }\n\n clear(): void {\n this.history = [];\n }\n\n getAll(): Message[] {\n return [...this.history]; // 복사본 반환\n }\n\n size(): number {\n return this.history.length;\n }\n}\n","import { Message } from \"@charivo/core\";\n\n/**\n * 메시지 형식 변환 유틸리티\n */\nexport class MessageConverter {\n /**\n * Charivo Message를 OpenAI 형식으로 변환\n */\n static toOpenAIFormat(\n messages: Message[],\n ): Array<{ role: string; content: string }> {\n return messages.map((msg) => ({\n role: msg.type === \"user\" ? \"user\" : \"assistant\",\n content: msg.content,\n }));\n }\n\n /**\n * 시스템 프롬프트와 메시지들을 OpenAI 형식으로 결합\n */\n static combineWithSystemPrompt(\n systemPrompt: string,\n messages: Message[],\n ): Array<{ role: string; content: string }> {\n return [\n { role: \"system\", content: systemPrompt },\n ...this.toOpenAIFormat(messages),\n ];\n }\n}\n","import { Message } from \"@charivo/core\";\n\n/**\n * AI 응답 메시지 생성 헬퍼\n */\nexport class ResponseMessageBuilder {\n static create(\n content: string,\n characterId: string,\n messageId?: string,\n ): Message {\n return {\n id: messageId || \"ai-\" + Date.now(),\n content,\n timestamp: new Date(),\n type: \"character\",\n characterId,\n };\n }\n}\n","import { Character, Message } from \"@charivo/core\";\n\n/**\n * LLM 관련 검증 유틸리티\n */\nexport class LLMValidators {\n static validateCharacterSet(\n character: Character | null,\n ): asserts character is Character {\n if (!character) {\n throw new Error(\"Character must be set before generating response\");\n }\n }\n\n static validateMessage(message: Message): void {\n if (!message.content || typeof message.content !== \"string\") {\n throw new Error(\"Message content must be a non-empty string\");\n }\n }\n}\n","import { LLMClient, Message, Character } from \"@charivo/core\";\nimport { MessageHistoryManager } from \"./message-history-manager\";\nimport { CharacterPromptBuilder } from \"./character-prompt-builder\";\nimport { MessageConverter } from \"./message-converter\";\nimport { LLMValidators } from \"./validators\";\nimport { ResponseMessageBuilder } from \"./response-message-builder\";\n\n/**\n * LLM Manager - LLM 세션의 상태 관리를 담당하는 클래스\n *\n * 역할:\n * - 캐릭터 설정 및 관리\n * - 메시지 히스토리 관리\n * - LLM 클라이언트와의 통신\n * - 메시지 형식 변환\n * - 프롬프트 생성\n */\nexport class LLMManager {\n private historyManager = new MessageHistoryManager();\n private character: Character | null = null;\n\n constructor(private llmClient: LLMClient) {}\n\n /**\n * 캐릭터 설정\n * 캐릭터가 변경되는 경우에만 히스토리를 초기화합니다.\n */\n setCharacter(character: Character): void {\n // 캐릭터가 변경되는 경우에만 히스토리 초기화\n if (this.character?.id !== character.id) {\n this.historyManager.clear();\n }\n this.character = character;\n }\n\n /**\n * 현재 설정된 캐릭터 반환\n */\n getCharacter(): Character | null {\n return this.character;\n }\n\n /**\n * 히스토리 초기화\n */\n clearHistory(): void {\n this.historyManager.clear();\n }\n\n /**\n * 현재 히스토리 반환\n */\n getHistory(): Message[] {\n return this.historyManager.getAll();\n }\n\n /**\n * 메시지 응답 생성\n */\n async generateResponse(message: Message): Promise<string> {\n LLMValidators.validateCharacterSet(this.character);\n LLMValidators.validateMessage(message);\n\n // 새 메시지를 히스토리에 추가\n this.historyManager.add(message);\n\n // 히스토리 메시지 가져오기\n const historyMessages = this.historyManager.getAll();\n\n // LLM API 형식으로 변환 (시스템 프롬프트 포함)\n const apiMessages = this.prepareApiMessages(historyMessages);\n\n try {\n // LLM 클라이언트를 통해 응답 생성\n const assistantMessage = await this.llmClient.call(apiMessages);\n\n // AI 응답 메시지 생성 및 히스토리에 추가\n const responseMessage = ResponseMessageBuilder.create(\n assistantMessage,\n this.character!.id, // validateCharacterSet 후 character는 non-null 보장됨\n );\n this.historyManager.add(responseMessage);\n\n return assistantMessage;\n } catch (error) {\n // 에러가 발생하면 마지막 메시지를 히스토리에서 제거\n this.historyManager.removeLast();\n throw error;\n }\n }\n\n /**\n * LLM API 호출을 위한 메시지 준비\n */\n private prepareApiMessages(\n messages: Message[],\n ): Array<{ role: string; content: string }> {\n if (!this.character) {\n return MessageConverter.toOpenAIFormat(messages);\n }\n\n const systemPrompt = CharacterPromptBuilder.buildSystemPrompt(\n this.character,\n );\n return MessageConverter.combineWithSystemPrompt(systemPrompt, messages);\n }\n}\n\n/**\n * LLM Manager 생성 헬퍼 함수\n */\nexport function createLLMManager(llmClient: LLMClient): LLMManager {\n return new LLMManager(llmClient);\n}\n"]}