@charivo/llm 0.3.2 → 0.4.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/README.md CHANGED
@@ -35,10 +35,27 @@ const reply = await manager.generateResponse({
35
35
  });
36
36
  ```
37
37
 
38
+ ## History Retention
39
+
40
+ `LLMManager` keeps the latest 40 turns by default. A turn is one user message
41
+ plus one character response, so the stored conversation history is capped at 80
42
+ messages. This bounds memory growth and the context sent to your LLM client.
43
+
44
+ Pass `maxHistoryTurns` to change the limit:
45
+
46
+ ```ts
47
+ const manager = createLLMManager(client, {
48
+ maxHistoryTurns: 20,
49
+ });
50
+ ```
51
+
52
+ Use `maxHistoryTurns: null` to opt out and keep unbounded history.
53
+
38
54
  ## Exports
39
55
 
40
56
  - `LLMManager`
41
- - `createLLMManager(client)`
57
+ - `createLLMManager(client, options?)`
58
+ - `LLMManagerOptions`
42
59
  - `CharacterPromptBuilder`
43
60
  - `MessageHistoryManager`
44
61
  - `MessageConverter`
package/dist/index.d.mts CHANGED
@@ -8,16 +8,32 @@ declare class CharacterPromptBuilder {
8
8
  static buildSystemPromptOrDefault(character?: Character): string;
9
9
  }
10
10
 
11
+ interface MessageHistoryManagerOptions {
12
+ maxMessages?: number | null;
13
+ pruneBatchSize?: number;
14
+ }
15
+ interface AddMessageOptions {
16
+ /**
17
+ * Internal escape hatch for workflows that need multiple appends to become
18
+ * visible as one pruning boundary, such as user/assistant turn pairs.
19
+ */
20
+ prune?: boolean;
21
+ }
11
22
  /**
12
23
  * 메시지 히스토리 관리
13
24
  */
14
25
  declare class MessageHistoryManager {
15
26
  private history;
16
- add(message: Message): void;
27
+ private readonly maxMessages?;
28
+ private readonly pruneBatchSize;
29
+ constructor(options?: MessageHistoryManagerOptions);
30
+ add(message: Message, options?: AddMessageOptions): void;
17
31
  removeLast(): Message | undefined;
18
32
  clear(): void;
19
33
  getAll(): Message[];
34
+ getRecent(maxMessages?: number): Message[];
20
35
  size(): number;
36
+ pruneToMax(): void;
21
37
  }
22
38
 
23
39
  /**
@@ -55,6 +71,9 @@ declare class LLMValidators {
55
71
  static validateMessage(message: Message): void;
56
72
  }
57
73
 
74
+ interface LLMManagerOptions {
75
+ maxHistoryTurns?: number | null;
76
+ }
58
77
  /**
59
78
  * LLM Manager - LLM 세션의 상태 관리를 담당하는 클래스
60
79
  *
@@ -67,9 +86,10 @@ declare class LLMValidators {
67
86
  */
68
87
  declare class LLMManager {
69
88
  private llmClient;
70
- private historyManager;
89
+ private readonly historyManager;
90
+ private readonly maxHistoryMessages?;
71
91
  private character;
72
- constructor(llmClient: LLMClient);
92
+ constructor(llmClient: LLMClient, options?: LLMManagerOptions);
73
93
  /**
74
94
  * 캐릭터 설정
75
95
  * 캐릭터가 변경되는 경우에만 히스토리를 초기화합니다.
@@ -95,10 +115,11 @@ declare class LLMManager {
95
115
  * LLM API 호출을 위한 메시지 준비
96
116
  */
97
117
  private prepareApiMessages;
118
+ private getHistoryForApiCall;
98
119
  }
99
120
  /**
100
121
  * LLM Manager 생성 헬퍼 함수
101
122
  */
102
- declare function createLLMManager(llmClient: LLMClient): LLMManager;
123
+ declare function createLLMManager(llmClient: LLMClient, options?: LLMManagerOptions): LLMManager;
103
124
 
104
- export { CharacterPromptBuilder, LLMManager, LLMValidators, MessageConverter, MessageHistoryManager, ResponseMessageBuilder, createLLMManager };
125
+ export { type AddMessageOptions, CharacterPromptBuilder, LLMManager, type LLMManagerOptions, LLMValidators, MessageConverter, MessageHistoryManager, type MessageHistoryManagerOptions, ResponseMessageBuilder, createLLMManager };
package/dist/index.d.ts CHANGED
@@ -8,16 +8,32 @@ declare class CharacterPromptBuilder {
8
8
  static buildSystemPromptOrDefault(character?: Character): string;
9
9
  }
10
10
 
11
+ interface MessageHistoryManagerOptions {
12
+ maxMessages?: number | null;
13
+ pruneBatchSize?: number;
14
+ }
15
+ interface AddMessageOptions {
16
+ /**
17
+ * Internal escape hatch for workflows that need multiple appends to become
18
+ * visible as one pruning boundary, such as user/assistant turn pairs.
19
+ */
20
+ prune?: boolean;
21
+ }
11
22
  /**
12
23
  * 메시지 히스토리 관리
13
24
  */
14
25
  declare class MessageHistoryManager {
15
26
  private history;
16
- add(message: Message): void;
27
+ private readonly maxMessages?;
28
+ private readonly pruneBatchSize;
29
+ constructor(options?: MessageHistoryManagerOptions);
30
+ add(message: Message, options?: AddMessageOptions): void;
17
31
  removeLast(): Message | undefined;
18
32
  clear(): void;
19
33
  getAll(): Message[];
34
+ getRecent(maxMessages?: number): Message[];
20
35
  size(): number;
36
+ pruneToMax(): void;
21
37
  }
22
38
 
23
39
  /**
@@ -55,6 +71,9 @@ declare class LLMValidators {
55
71
  static validateMessage(message: Message): void;
56
72
  }
57
73
 
74
+ interface LLMManagerOptions {
75
+ maxHistoryTurns?: number | null;
76
+ }
58
77
  /**
59
78
  * LLM Manager - LLM 세션의 상태 관리를 담당하는 클래스
60
79
  *
@@ -67,9 +86,10 @@ declare class LLMValidators {
67
86
  */
68
87
  declare class LLMManager {
69
88
  private llmClient;
70
- private historyManager;
89
+ private readonly historyManager;
90
+ private readonly maxHistoryMessages?;
71
91
  private character;
72
- constructor(llmClient: LLMClient);
92
+ constructor(llmClient: LLMClient, options?: LLMManagerOptions);
73
93
  /**
74
94
  * 캐릭터 설정
75
95
  * 캐릭터가 변경되는 경우에만 히스토리를 초기화합니다.
@@ -95,10 +115,11 @@ declare class LLMManager {
95
115
  * LLM API 호출을 위한 메시지 준비
96
116
  */
97
117
  private prepareApiMessages;
118
+ private getHistoryForApiCall;
98
119
  }
99
120
  /**
100
121
  * LLM Manager 생성 헬퍼 함수
101
122
  */
102
- declare function createLLMManager(llmClient: LLMClient): LLMManager;
123
+ declare function createLLMManager(llmClient: LLMClient, options?: LLMManagerOptions): LLMManager;
103
124
 
104
- export { CharacterPromptBuilder, LLMManager, LLMValidators, MessageConverter, MessageHistoryManager, ResponseMessageBuilder, createLLMManager };
125
+ export { type AddMessageOptions, CharacterPromptBuilder, LLMManager, type LLMManagerOptions, LLMValidators, MessageConverter, MessageHistoryManager, type MessageHistoryManagerOptions, ResponseMessageBuilder, createLLMManager };
package/dist/index.js CHANGED
@@ -25,8 +25,23 @@ Respond naturally in plain text with no bracketed emotion tags or control markup
25
25
  // src/message-history-manager.ts
26
26
  var MessageHistoryManager = class {
27
27
  history = [];
28
- add(message) {
28
+ maxMessages;
29
+ pruneBatchSize;
30
+ constructor(options = {}) {
31
+ if (options.maxMessages !== void 0 && options.maxMessages !== null && (!Number.isInteger(options.maxMessages) || options.maxMessages <= 0)) {
32
+ throw new TypeError("maxMessages must be a positive integer or null");
33
+ }
34
+ if (options.pruneBatchSize !== void 0 && (!Number.isInteger(options.pruneBatchSize) || options.pruneBatchSize <= 0)) {
35
+ throw new TypeError("pruneBatchSize must be a positive integer");
36
+ }
37
+ this.maxMessages = options.maxMessages === null ? void 0 : options.maxMessages;
38
+ this.pruneBatchSize = options.pruneBatchSize ?? 1;
39
+ }
40
+ add(message, options = {}) {
29
41
  this.history.push(message);
42
+ if (options.prune !== false) {
43
+ this.pruneToMax();
44
+ }
30
45
  }
31
46
  removeLast() {
32
47
  return this.history.pop();
@@ -37,9 +52,31 @@ var MessageHistoryManager = class {
37
52
  getAll() {
38
53
  return [...this.history];
39
54
  }
55
+ getRecent(maxMessages) {
56
+ if (maxMessages !== void 0 && (!Number.isInteger(maxMessages) || maxMessages <= 0)) {
57
+ throw new TypeError("maxMessages must be a positive integer");
58
+ }
59
+ if (maxMessages === void 0 || this.history.length <= maxMessages) {
60
+ return this.getAll();
61
+ }
62
+ return this.history.slice(-maxMessages);
63
+ }
40
64
  size() {
41
65
  return this.history.length;
42
66
  }
67
+ pruneToMax() {
68
+ if (this.maxMessages === void 0) {
69
+ return;
70
+ }
71
+ while (this.history.length > this.maxMessages) {
72
+ const excess = this.history.length - this.maxMessages;
73
+ const removeCount = Math.min(
74
+ Math.ceil(excess / this.pruneBatchSize) * this.pruneBatchSize,
75
+ this.history.length
76
+ );
77
+ this.history.splice(0, removeCount);
78
+ }
79
+ }
43
80
  };
44
81
 
45
82
  // src/message-converter.ts
@@ -90,11 +127,18 @@ var LLMValidators = class {
90
127
  }
91
128
  }
92
129
  };
130
+ var DEFAULT_MAX_HISTORY_TURNS = 40;
93
131
  var LLMManager = class {
94
- constructor(llmClient) {
132
+ constructor(llmClient, options = {}) {
95
133
  this.llmClient = llmClient;
96
- }
97
- historyManager = new MessageHistoryManager();
134
+ this.maxHistoryMessages = resolveMaxHistoryMessages(options);
135
+ this.historyManager = new MessageHistoryManager({
136
+ maxMessages: this.maxHistoryMessages,
137
+ pruneBatchSize: 2
138
+ });
139
+ }
140
+ historyManager;
141
+ maxHistoryMessages;
98
142
  character = null;
99
143
  /**
100
144
  * 캐릭터 설정
@@ -134,8 +178,8 @@ var LLMManager = class {
134
178
  } catch (error) {
135
179
  throw core.toCharivoError("state", error);
136
180
  }
137
- this.historyManager.add(message);
138
- const historyMessages = this.historyManager.getAll();
181
+ this.historyManager.add(message, { prune: false });
182
+ const historyMessages = this.getHistoryForApiCall();
139
183
  const apiMessages = this.prepareApiMessages(historyMessages);
140
184
  try {
141
185
  const assistantMessage = await this.llmClient.call(apiMessages);
@@ -144,7 +188,8 @@ var LLMManager = class {
144
188
  this.character.id
145
189
  // validateCharacterSet 후 character는 non-null 보장됨
146
190
  );
147
- this.historyManager.add(responseMessage);
191
+ this.historyManager.add(responseMessage, { prune: false });
192
+ this.historyManager.pruneToMax();
148
193
  return assistantMessage;
149
194
  } catch (error) {
150
195
  this.historyManager.removeLast();
@@ -163,9 +208,28 @@ var LLMManager = class {
163
208
  );
164
209
  return MessageConverter.combineWithSystemPrompt(systemPrompt, messages);
165
210
  }
211
+ getHistoryForApiCall() {
212
+ const historyMessages = this.historyManager.getRecent(
213
+ this.maxHistoryMessages
214
+ );
215
+ if (historyMessages[0]?.type === "character") {
216
+ return historyMessages.slice(1);
217
+ }
218
+ return historyMessages;
219
+ }
166
220
  };
167
- function createLLMManager(llmClient) {
168
- return new LLMManager(llmClient);
221
+ function createLLMManager(llmClient, options) {
222
+ return new LLMManager(llmClient, options);
223
+ }
224
+ function resolveMaxHistoryMessages(options) {
225
+ if (options.maxHistoryTurns === null) {
226
+ return void 0;
227
+ }
228
+ const maxHistoryTurns = options.maxHistoryTurns ?? DEFAULT_MAX_HISTORY_TURNS;
229
+ if (!Number.isInteger(maxHistoryTurns) || maxHistoryTurns <= 0) {
230
+ throw new TypeError("maxHistoryTurns must be a positive integer or null");
231
+ }
232
+ return maxHistoryTurns * 2;
169
233
  }
170
234
 
171
235
  exports.CharacterPromptBuilder = CharacterPromptBuilder;
package/dist/index.js.map CHANGED
@@ -1 +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":["toCharivoError"],"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, toCharivoError } 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 try {\n LLMValidators.validateCharacterSet(this.character);\n LLMValidators.validateMessage(message);\n } catch (error) {\n throw toCharivoError(\"state\", error);\n }\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 toCharivoError(\"provider\", 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"]}
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":["toCharivoError"],"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\nexport interface MessageHistoryManagerOptions {\n maxMessages?: number | null;\n pruneBatchSize?: number;\n}\n\nexport interface AddMessageOptions {\n /**\n * Internal escape hatch for workflows that need multiple appends to become\n * visible as one pruning boundary, such as user/assistant turn pairs.\n */\n prune?: boolean;\n}\n\n/**\n * 메시지 히스토리 관리\n */\nexport class MessageHistoryManager {\n private history: Message[] = [];\n private readonly maxMessages?: number;\n private readonly pruneBatchSize: number;\n\n constructor(options: MessageHistoryManagerOptions = {}) {\n if (\n options.maxMessages !== undefined &&\n options.maxMessages !== null &&\n (!Number.isInteger(options.maxMessages) || options.maxMessages <= 0)\n ) {\n throw new TypeError(\"maxMessages must be a positive integer or null\");\n }\n\n if (\n options.pruneBatchSize !== undefined &&\n (!Number.isInteger(options.pruneBatchSize) || options.pruneBatchSize <= 0)\n ) {\n throw new TypeError(\"pruneBatchSize must be a positive integer\");\n }\n\n this.maxMessages =\n options.maxMessages === null ? undefined : options.maxMessages;\n this.pruneBatchSize = options.pruneBatchSize ?? 1;\n }\n\n add(message: Message, options: AddMessageOptions = {}): void {\n this.history.push(message);\n\n if (options.prune !== false) {\n this.pruneToMax();\n }\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 getRecent(maxMessages?: number): Message[] {\n if (\n maxMessages !== undefined &&\n (!Number.isInteger(maxMessages) || maxMessages <= 0)\n ) {\n throw new TypeError(\"maxMessages must be a positive integer\");\n }\n\n if (maxMessages === undefined || this.history.length <= maxMessages) {\n return this.getAll();\n }\n\n return this.history.slice(-maxMessages);\n }\n\n size(): number {\n return this.history.length;\n }\n\n pruneToMax(): void {\n if (this.maxMessages === undefined) {\n return;\n }\n\n while (this.history.length > this.maxMessages) {\n const excess = this.history.length - this.maxMessages;\n const removeCount = Math.min(\n Math.ceil(excess / this.pruneBatchSize) * this.pruneBatchSize,\n this.history.length,\n );\n this.history.splice(0, removeCount);\n }\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, toCharivoError } 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\nconst DEFAULT_MAX_HISTORY_TURNS = 40;\n\nexport interface LLMManagerOptions {\n maxHistoryTurns?: number | null;\n}\n\n/**\n * LLM Manager - LLM 세션의 상태 관리를 담당하는 클래스\n *\n * 역할:\n * - 캐릭터 설정 및 관리\n * - 메시지 히스토리 관리\n * - LLM 클라이언트와의 통신\n * - 메시지 형식 변환\n * - 프롬프트 생성\n */\nexport class LLMManager {\n private readonly historyManager: MessageHistoryManager;\n private readonly maxHistoryMessages?: number;\n private character: Character | null = null;\n\n constructor(\n private llmClient: LLMClient,\n options: LLMManagerOptions = {},\n ) {\n this.maxHistoryMessages = resolveMaxHistoryMessages(options);\n this.historyManager = new MessageHistoryManager({\n maxMessages: this.maxHistoryMessages,\n pruneBatchSize: 2,\n });\n }\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 try {\n LLMValidators.validateCharacterSet(this.character);\n LLMValidators.validateMessage(message);\n } catch (error) {\n throw toCharivoError(\"state\", error);\n }\n\n // Defer pruning until the assistant message is appended. On failure we\n // only removeLast() the in-flight user message, so older history must\n // remain intact during the API call.\n this.historyManager.add(message, { prune: false });\n\n // 히스토리 메시지 가져오기\n const historyMessages = this.getHistoryForApiCall();\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, { prune: false });\n this.historyManager.pruneToMax();\n\n return assistantMessage;\n } catch (error) {\n // 에러가 발생하면 마지막 메시지를 히스토리에서 제거\n this.historyManager.removeLast();\n throw toCharivoError(\"provider\", 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 private getHistoryForApiCall(): Message[] {\n const historyMessages = this.historyManager.getRecent(\n this.maxHistoryMessages,\n );\n\n if (historyMessages[0]?.type === \"character\") {\n return historyMessages.slice(1);\n }\n\n return historyMessages;\n }\n}\n\n/**\n * LLM Manager 생성 헬퍼 함수\n */\nexport function createLLMManager(\n llmClient: LLMClient,\n options?: LLMManagerOptions,\n): LLMManager {\n return new LLMManager(llmClient, options);\n}\n\nfunction resolveMaxHistoryMessages(\n options: LLMManagerOptions,\n): number | undefined {\n if (options.maxHistoryTurns === null) {\n return undefined;\n }\n\n const maxHistoryTurns = options.maxHistoryTurns ?? DEFAULT_MAX_HISTORY_TURNS;\n\n if (!Number.isInteger(maxHistoryTurns) || maxHistoryTurns <= 0) {\n throw new TypeError(\"maxHistoryTurns must be a positive integer or null\");\n }\n\n return maxHistoryTurns * 2;\n}\n"]}
package/dist/index.mjs CHANGED
@@ -23,8 +23,23 @@ Respond naturally in plain text with no bracketed emotion tags or control markup
23
23
  // src/message-history-manager.ts
24
24
  var MessageHistoryManager = class {
25
25
  history = [];
26
- add(message) {
26
+ maxMessages;
27
+ pruneBatchSize;
28
+ constructor(options = {}) {
29
+ if (options.maxMessages !== void 0 && options.maxMessages !== null && (!Number.isInteger(options.maxMessages) || options.maxMessages <= 0)) {
30
+ throw new TypeError("maxMessages must be a positive integer or null");
31
+ }
32
+ if (options.pruneBatchSize !== void 0 && (!Number.isInteger(options.pruneBatchSize) || options.pruneBatchSize <= 0)) {
33
+ throw new TypeError("pruneBatchSize must be a positive integer");
34
+ }
35
+ this.maxMessages = options.maxMessages === null ? void 0 : options.maxMessages;
36
+ this.pruneBatchSize = options.pruneBatchSize ?? 1;
37
+ }
38
+ add(message, options = {}) {
27
39
  this.history.push(message);
40
+ if (options.prune !== false) {
41
+ this.pruneToMax();
42
+ }
28
43
  }
29
44
  removeLast() {
30
45
  return this.history.pop();
@@ -35,9 +50,31 @@ var MessageHistoryManager = class {
35
50
  getAll() {
36
51
  return [...this.history];
37
52
  }
53
+ getRecent(maxMessages) {
54
+ if (maxMessages !== void 0 && (!Number.isInteger(maxMessages) || maxMessages <= 0)) {
55
+ throw new TypeError("maxMessages must be a positive integer");
56
+ }
57
+ if (maxMessages === void 0 || this.history.length <= maxMessages) {
58
+ return this.getAll();
59
+ }
60
+ return this.history.slice(-maxMessages);
61
+ }
38
62
  size() {
39
63
  return this.history.length;
40
64
  }
65
+ pruneToMax() {
66
+ if (this.maxMessages === void 0) {
67
+ return;
68
+ }
69
+ while (this.history.length > this.maxMessages) {
70
+ const excess = this.history.length - this.maxMessages;
71
+ const removeCount = Math.min(
72
+ Math.ceil(excess / this.pruneBatchSize) * this.pruneBatchSize,
73
+ this.history.length
74
+ );
75
+ this.history.splice(0, removeCount);
76
+ }
77
+ }
41
78
  };
42
79
 
43
80
  // src/message-converter.ts
@@ -88,11 +125,18 @@ var LLMValidators = class {
88
125
  }
89
126
  }
90
127
  };
128
+ var DEFAULT_MAX_HISTORY_TURNS = 40;
91
129
  var LLMManager = class {
92
- constructor(llmClient) {
130
+ constructor(llmClient, options = {}) {
93
131
  this.llmClient = llmClient;
94
- }
95
- historyManager = new MessageHistoryManager();
132
+ this.maxHistoryMessages = resolveMaxHistoryMessages(options);
133
+ this.historyManager = new MessageHistoryManager({
134
+ maxMessages: this.maxHistoryMessages,
135
+ pruneBatchSize: 2
136
+ });
137
+ }
138
+ historyManager;
139
+ maxHistoryMessages;
96
140
  character = null;
97
141
  /**
98
142
  * 캐릭터 설정
@@ -132,8 +176,8 @@ var LLMManager = class {
132
176
  } catch (error) {
133
177
  throw toCharivoError("state", error);
134
178
  }
135
- this.historyManager.add(message);
136
- const historyMessages = this.historyManager.getAll();
179
+ this.historyManager.add(message, { prune: false });
180
+ const historyMessages = this.getHistoryForApiCall();
137
181
  const apiMessages = this.prepareApiMessages(historyMessages);
138
182
  try {
139
183
  const assistantMessage = await this.llmClient.call(apiMessages);
@@ -142,7 +186,8 @@ var LLMManager = class {
142
186
  this.character.id
143
187
  // validateCharacterSet 후 character는 non-null 보장됨
144
188
  );
145
- this.historyManager.add(responseMessage);
189
+ this.historyManager.add(responseMessage, { prune: false });
190
+ this.historyManager.pruneToMax();
146
191
  return assistantMessage;
147
192
  } catch (error) {
148
193
  this.historyManager.removeLast();
@@ -161,9 +206,28 @@ var LLMManager = class {
161
206
  );
162
207
  return MessageConverter.combineWithSystemPrompt(systemPrompt, messages);
163
208
  }
209
+ getHistoryForApiCall() {
210
+ const historyMessages = this.historyManager.getRecent(
211
+ this.maxHistoryMessages
212
+ );
213
+ if (historyMessages[0]?.type === "character") {
214
+ return historyMessages.slice(1);
215
+ }
216
+ return historyMessages;
217
+ }
164
218
  };
165
- function createLLMManager(llmClient) {
166
- return new LLMManager(llmClient);
219
+ function createLLMManager(llmClient, options) {
220
+ return new LLMManager(llmClient, options);
221
+ }
222
+ function resolveMaxHistoryMessages(options) {
223
+ if (options.maxHistoryTurns === null) {
224
+ return void 0;
225
+ }
226
+ const maxHistoryTurns = options.maxHistoryTurns ?? DEFAULT_MAX_HISTORY_TURNS;
227
+ if (!Number.isInteger(maxHistoryTurns) || maxHistoryTurns <= 0) {
228
+ throw new TypeError("maxHistoryTurns must be a positive integer or null");
229
+ }
230
+ return maxHistoryTurns * 2;
167
231
  }
168
232
 
169
233
  export { CharacterPromptBuilder, LLMManager, LLMValidators, MessageConverter, MessageHistoryManager, ResponseMessageBuilder, createLLMManager };
@@ -1 +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.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, toCharivoError } 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 try {\n LLMValidators.validateCharacterSet(this.character);\n LLMValidators.validateMessage(message);\n } catch (error) {\n throw toCharivoError(\"state\", error);\n }\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 toCharivoError(\"provider\", 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"]}
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;;;ACNO,IAAM,wBAAN,MAA4B;AAAA,EACzB,UAAqB,EAAC;AAAA,EACb,WAAA;AAAA,EACA,cAAA;AAAA,EAEjB,WAAA,CAAY,OAAA,GAAwC,EAAC,EAAG;AACtD,IAAA,IACE,OAAA,CAAQ,WAAA,KAAgB,MAAA,IACxB,OAAA,CAAQ,gBAAgB,IAAA,KACvB,CAAC,MAAA,CAAO,SAAA,CAAU,OAAA,CAAQ,WAAW,CAAA,IAAK,OAAA,CAAQ,eAAe,CAAA,CAAA,EAClE;AACA,MAAA,MAAM,IAAI,UAAU,gDAAgD,CAAA;AAAA,IACtE;AAEA,IAAA,IACE,OAAA,CAAQ,cAAA,KAAmB,MAAA,KAC1B,CAAC,MAAA,CAAO,SAAA,CAAU,OAAA,CAAQ,cAAc,CAAA,IAAK,OAAA,CAAQ,cAAA,IAAkB,CAAA,CAAA,EACxE;AACA,MAAA,MAAM,IAAI,UAAU,2CAA2C,CAAA;AAAA,IACjE;AAEA,IAAA,IAAA,CAAK,WAAA,GACH,OAAA,CAAQ,WAAA,KAAgB,IAAA,GAAO,SAAY,OAAA,CAAQ,WAAA;AACrD,IAAA,IAAA,CAAK,cAAA,GAAiB,QAAQ,cAAA,IAAkB,CAAA;AAAA,EAClD;AAAA,EAEA,GAAA,CAAI,OAAA,EAAkB,OAAA,GAA6B,EAAC,EAAS;AAC3D,IAAA,IAAA,CAAK,OAAA,CAAQ,KAAK,OAAO,CAAA;AAEzB,IAAA,IAAI,OAAA,CAAQ,UAAU,KAAA,EAAO;AAC3B,MAAA,IAAA,CAAK,UAAA,EAAW;AAAA,IAClB;AAAA,EACF;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,UAAU,WAAA,EAAiC;AACzC,IAAA,IACE,WAAA,KAAgB,WACf,CAAC,MAAA,CAAO,UAAU,WAAW,CAAA,IAAK,eAAe,CAAA,CAAA,EAClD;AACA,MAAA,MAAM,IAAI,UAAU,wCAAwC,CAAA;AAAA,IAC9D;AAEA,IAAA,IAAI,WAAA,KAAgB,MAAA,IAAa,IAAA,CAAK,OAAA,CAAQ,UAAU,WAAA,EAAa;AACnE,MAAA,OAAO,KAAK,MAAA,EAAO;AAAA,IACrB;AAEA,IAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,KAAA,CAAM,CAAC,WAAW,CAAA;AAAA,EACxC;AAAA,EAEA,IAAA,GAAe;AACb,IAAA,OAAO,KAAK,OAAA,CAAQ,MAAA;AAAA,EACtB;AAAA,EAEA,UAAA,GAAmB;AACjB,IAAA,IAAI,IAAA,CAAK,gBAAgB,MAAA,EAAW;AAClC,MAAA;AAAA,IACF;AAEA,IAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,MAAA,GAAS,IAAA,CAAK,WAAA,EAAa;AAC7C,MAAA,MAAM,MAAA,GAAS,IAAA,CAAK,OAAA,CAAQ,MAAA,GAAS,IAAA,CAAK,WAAA;AAC1C,MAAA,MAAM,cAAc,IAAA,CAAK,GAAA;AAAA,QACvB,KAAK,IAAA,CAAK,MAAA,GAAS,IAAA,CAAK,cAAc,IAAI,IAAA,CAAK,cAAA;AAAA,QAC/C,KAAK,OAAA,CAAQ;AAAA,OACf;AACA,MAAA,IAAA,CAAK,OAAA,CAAQ,MAAA,CAAO,CAAA,EAAG,WAAW,CAAA;AAAA,IACpC;AAAA,EACF;AACF;;;AC5FO,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;ACZA,IAAM,yBAAA,GAA4B,EAAA;AAgB3B,IAAM,aAAN,MAAiB;AAAA,EAKtB,WAAA,CACU,SAAA,EACR,OAAA,GAA6B,EAAC,EAC9B;AAFQ,IAAA,IAAA,CAAA,SAAA,GAAA,SAAA;AAGR,IAAA,IAAA,CAAK,kBAAA,GAAqB,0BAA0B,OAAO,CAAA;AAC3D,IAAA,IAAA,CAAK,cAAA,GAAiB,IAAI,qBAAA,CAAsB;AAAA,MAC9C,aAAa,IAAA,CAAK,kBAAA;AAAA,MAClB,cAAA,EAAgB;AAAA,KACjB,CAAA;AAAA,EACH;AAAA,EAbiB,cAAA;AAAA,EACA,kBAAA;AAAA,EACT,SAAA,GAA8B,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBtC,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,IAAI;AACF,MAAA,aAAA,CAAc,oBAAA,CAAqB,KAAK,SAAS,CAAA;AACjD,MAAA,aAAA,CAAc,gBAAgB,OAAO,CAAA;AAAA,IACvC,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,cAAA,CAAe,SAAS,KAAK,CAAA;AAAA,IACrC;AAKA,IAAA,IAAA,CAAK,eAAe,GAAA,CAAI,OAAA,EAAS,EAAE,KAAA,EAAO,OAAO,CAAA;AAGjD,IAAA,MAAM,eAAA,GAAkB,KAAK,oBAAA,EAAqB;AAGlD,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,eAAe,GAAA,CAAI,eAAA,EAAiB,EAAE,KAAA,EAAO,OAAO,CAAA;AACzD,MAAA,IAAA,CAAK,eAAe,UAAA,EAAW;AAE/B,MAAA,OAAO,gBAAA;AAAA,IACT,SAAS,KAAA,EAAO;AAEd,MAAA,IAAA,CAAK,eAAe,UAAA,EAAW;AAC/B,MAAA,MAAM,cAAA,CAAe,YAAY,KAAK,CAAA;AAAA,IACxC;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;AAAA,EAEQ,oBAAA,GAAkC;AACxC,IAAA,MAAM,eAAA,GAAkB,KAAK,cAAA,CAAe,SAAA;AAAA,MAC1C,IAAA,CAAK;AAAA,KACP;AAEA,IAAA,IAAI,eAAA,CAAgB,CAAC,CAAA,EAAG,IAAA,KAAS,WAAA,EAAa;AAC5C,MAAA,OAAO,eAAA,CAAgB,MAAM,CAAC,CAAA;AAAA,IAChC;AAEA,IAAA,OAAO,eAAA;AAAA,EACT;AACF;AAKO,SAAS,gBAAA,CACd,WACA,OAAA,EACY;AACZ,EAAA,OAAO,IAAI,UAAA,CAAW,SAAA,EAAW,OAAO,CAAA;AAC1C;AAEA,SAAS,0BACP,OAAA,EACoB;AACpB,EAAA,IAAI,OAAA,CAAQ,oBAAoB,IAAA,EAAM;AACpC,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,MAAM,eAAA,GAAkB,QAAQ,eAAA,IAAmB,yBAAA;AAEnD,EAAA,IAAI,CAAC,MAAA,CAAO,SAAA,CAAU,eAAe,CAAA,IAAK,mBAAmB,CAAA,EAAG;AAC9D,IAAA,MAAM,IAAI,UAAU,oDAAoD,CAAA;AAAA,EAC1E;AAEA,EAAA,OAAO,eAAA,GAAkB,CAAA;AAC3B","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\nexport interface MessageHistoryManagerOptions {\n maxMessages?: number | null;\n pruneBatchSize?: number;\n}\n\nexport interface AddMessageOptions {\n /**\n * Internal escape hatch for workflows that need multiple appends to become\n * visible as one pruning boundary, such as user/assistant turn pairs.\n */\n prune?: boolean;\n}\n\n/**\n * 메시지 히스토리 관리\n */\nexport class MessageHistoryManager {\n private history: Message[] = [];\n private readonly maxMessages?: number;\n private readonly pruneBatchSize: number;\n\n constructor(options: MessageHistoryManagerOptions = {}) {\n if (\n options.maxMessages !== undefined &&\n options.maxMessages !== null &&\n (!Number.isInteger(options.maxMessages) || options.maxMessages <= 0)\n ) {\n throw new TypeError(\"maxMessages must be a positive integer or null\");\n }\n\n if (\n options.pruneBatchSize !== undefined &&\n (!Number.isInteger(options.pruneBatchSize) || options.pruneBatchSize <= 0)\n ) {\n throw new TypeError(\"pruneBatchSize must be a positive integer\");\n }\n\n this.maxMessages =\n options.maxMessages === null ? undefined : options.maxMessages;\n this.pruneBatchSize = options.pruneBatchSize ?? 1;\n }\n\n add(message: Message, options: AddMessageOptions = {}): void {\n this.history.push(message);\n\n if (options.prune !== false) {\n this.pruneToMax();\n }\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 getRecent(maxMessages?: number): Message[] {\n if (\n maxMessages !== undefined &&\n (!Number.isInteger(maxMessages) || maxMessages <= 0)\n ) {\n throw new TypeError(\"maxMessages must be a positive integer\");\n }\n\n if (maxMessages === undefined || this.history.length <= maxMessages) {\n return this.getAll();\n }\n\n return this.history.slice(-maxMessages);\n }\n\n size(): number {\n return this.history.length;\n }\n\n pruneToMax(): void {\n if (this.maxMessages === undefined) {\n return;\n }\n\n while (this.history.length > this.maxMessages) {\n const excess = this.history.length - this.maxMessages;\n const removeCount = Math.min(\n Math.ceil(excess / this.pruneBatchSize) * this.pruneBatchSize,\n this.history.length,\n );\n this.history.splice(0, removeCount);\n }\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, toCharivoError } 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\nconst DEFAULT_MAX_HISTORY_TURNS = 40;\n\nexport interface LLMManagerOptions {\n maxHistoryTurns?: number | null;\n}\n\n/**\n * LLM Manager - LLM 세션의 상태 관리를 담당하는 클래스\n *\n * 역할:\n * - 캐릭터 설정 및 관리\n * - 메시지 히스토리 관리\n * - LLM 클라이언트와의 통신\n * - 메시지 형식 변환\n * - 프롬프트 생성\n */\nexport class LLMManager {\n private readonly historyManager: MessageHistoryManager;\n private readonly maxHistoryMessages?: number;\n private character: Character | null = null;\n\n constructor(\n private llmClient: LLMClient,\n options: LLMManagerOptions = {},\n ) {\n this.maxHistoryMessages = resolveMaxHistoryMessages(options);\n this.historyManager = new MessageHistoryManager({\n maxMessages: this.maxHistoryMessages,\n pruneBatchSize: 2,\n });\n }\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 try {\n LLMValidators.validateCharacterSet(this.character);\n LLMValidators.validateMessage(message);\n } catch (error) {\n throw toCharivoError(\"state\", error);\n }\n\n // Defer pruning until the assistant message is appended. On failure we\n // only removeLast() the in-flight user message, so older history must\n // remain intact during the API call.\n this.historyManager.add(message, { prune: false });\n\n // 히스토리 메시지 가져오기\n const historyMessages = this.getHistoryForApiCall();\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, { prune: false });\n this.historyManager.pruneToMax();\n\n return assistantMessage;\n } catch (error) {\n // 에러가 발생하면 마지막 메시지를 히스토리에서 제거\n this.historyManager.removeLast();\n throw toCharivoError(\"provider\", 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 private getHistoryForApiCall(): Message[] {\n const historyMessages = this.historyManager.getRecent(\n this.maxHistoryMessages,\n );\n\n if (historyMessages[0]?.type === \"character\") {\n return historyMessages.slice(1);\n }\n\n return historyMessages;\n }\n}\n\n/**\n * LLM Manager 생성 헬퍼 함수\n */\nexport function createLLMManager(\n llmClient: LLMClient,\n options?: LLMManagerOptions,\n): LLMManager {\n return new LLMManager(llmClient, options);\n}\n\nfunction resolveMaxHistoryMessages(\n options: LLMManagerOptions,\n): number | undefined {\n if (options.maxHistoryTurns === null) {\n return undefined;\n }\n\n const maxHistoryTurns = options.maxHistoryTurns ?? DEFAULT_MAX_HISTORY_TURNS;\n\n if (!Number.isInteger(maxHistoryTurns) || maxHistoryTurns <= 0) {\n throw new TypeError(\"maxHistoryTurns must be a positive integer or null\");\n }\n\n return maxHistoryTurns * 2;\n}\n"]}
@@ -41,7 +41,7 @@ var OpenAILLMProvider = class {
41
41
  temperature: this.temperature,
42
42
  max_tokens: this.maxTokens
43
43
  }),
44
- `request timed out after ${REQUEST_TIMEOUT_MS}ms`
44
+ `OpenAI LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`
45
45
  );
46
46
  return completion.choices[0]?.message?.content || "";
47
47
  } catch (error) {
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/openai/provider.ts","../../src/openai/index.ts"],"names":["CharivoStateError","OpenAI","toCharivoError","CharivoTimeoutError"],"mappings":"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","file":"index.js","sourcesContent":["import OpenAI from \"openai\";\nimport {\n CharivoStateError,\n CharivoTimeoutError,\n LLMProvider,\n toCharivoError,\n} from \"@charivo/core\";\n\nconst REQUEST_TIMEOUT_MS = 30_000;\n\nexport interface OpenAILLMConfig {\n apiKey: string;\n model?: string;\n temperature?: number;\n maxTokens?: number;\n dangerouslyAllowBrowser?: boolean;\n}\n\nexport class OpenAILLMProvider implements LLMProvider {\n private openai: OpenAI;\n private model: string;\n private temperature: number;\n private maxTokens: number;\n\n constructor(config: OpenAILLMConfig) {\n if (typeof window !== \"undefined\" && !config.dangerouslyAllowBrowser) {\n throw new CharivoStateError(\n \"OpenAI LLM provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing\",\n );\n }\n\n this.openai = new OpenAI({\n apiKey: config.apiKey,\n dangerouslyAllowBrowser: config.dangerouslyAllowBrowser,\n });\n\n this.model = config.model || \"gpt-4.1-nano\";\n this.temperature = config.temperature || 0.7;\n this.maxTokens = config.maxTokens || 1000;\n }\n\n async generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n try {\n const openAIMessages = messages.map((msg) => ({\n role: msg.role as \"system\" | \"user\" | \"assistant\",\n content: msg.content,\n }));\n\n const completion = await withTimeout(\n this.openai.chat.completions.create({\n model: this.model,\n messages: openAIMessages,\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n }),\n `request timed out after ${REQUEST_TIMEOUT_MS}ms`,\n );\n\n return completion.choices[0]?.message?.content || \"\";\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenAI LLM request failed\");\n }\n }\n}\n\nexport function createOpenAILLMProvider(\n config: OpenAILLMConfig,\n): OpenAILLMProvider {\n return new OpenAILLMProvider(config);\n}\n\nasync function withTimeout<T>(\n promise: Promise<T>,\n timeoutMessage: string,\n): Promise<T> {\n let timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n const timeoutPromise = new Promise<T>((_, reject) => {\n timeoutId = setTimeout(\n () => reject(new CharivoTimeoutError(timeoutMessage)),\n REQUEST_TIMEOUT_MS,\n );\n });\n\n try {\n return await Promise.race([promise, timeoutPromise]);\n } finally {\n if (timeoutId) {\n clearTimeout(timeoutId);\n }\n }\n}\n","import { LLMClient } from \"@charivo/core\";\nimport {\n createOpenAILLMProvider,\n OpenAILLMConfig,\n OpenAILLMProvider,\n} from \"./provider\";\n\n// OpenAILLMConfig를 직접 사용\nexport type OpenAILLMClientConfig = OpenAILLMConfig;\n\n/**\n * OpenAI LLM Client - OpenAI provider를 래핑해서 클라이언트에서 직접 사용하는 Stateless 클라이언트\n *\n * 로컬 개발이나 테스트 환경에서 사용. 프로덕션에서는 보안상 권장하지 않음.\n * API 키가 클라이언트에 노출되므로 서버 환경에서만 사용하거나 테스트용으로만 사용해야 함.\n *\n * Stateless 설계: 세션 관리는 외부에서 담당하고, 이 클라이언트는 API 호출만 담당\n */\nexport class OpenAILLMClient implements LLMClient {\n private provider: OpenAILLMProvider;\n\n constructor(config: OpenAILLMClientConfig) {\n // Intentional dev/test escape hatch: this direct browser client exposes\n // credentials. For production, see docs/guide/choosing-packages.md#remote.\n this.provider = createOpenAILLMProvider({\n ...config,\n dangerouslyAllowBrowser: true,\n });\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n // Provider를 사용해서 응답 생성\n const assistantMessage = await this.provider.generateResponse(messages);\n\n return assistantMessage;\n }\n}\n\nexport function createOpenAILLMClient(\n config: OpenAILLMClientConfig,\n): OpenAILLMClient {\n return new OpenAILLMClient(config);\n}\n"]}
1
+ {"version":3,"sources":["../../src/openai/provider.ts","../../src/openai/index.ts"],"names":["CharivoStateError","OpenAI","toCharivoError","CharivoTimeoutError"],"mappings":"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","file":"index.js","sourcesContent":["import OpenAI from \"openai\";\nimport {\n CharivoStateError,\n CharivoTimeoutError,\n LLMProvider,\n toCharivoError,\n} from \"@charivo/core\";\n\nconst REQUEST_TIMEOUT_MS = 30_000;\n\nexport interface OpenAILLMConfig {\n apiKey: string;\n model?: string;\n temperature?: number;\n maxTokens?: number;\n dangerouslyAllowBrowser?: boolean;\n}\n\nexport class OpenAILLMProvider implements LLMProvider {\n private openai: OpenAI;\n private model: string;\n private temperature: number;\n private maxTokens: number;\n\n constructor(config: OpenAILLMConfig) {\n if (typeof window !== \"undefined\" && !config.dangerouslyAllowBrowser) {\n throw new CharivoStateError(\n \"OpenAI LLM provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing\",\n );\n }\n\n this.openai = new OpenAI({\n apiKey: config.apiKey,\n dangerouslyAllowBrowser: config.dangerouslyAllowBrowser,\n });\n\n this.model = config.model || \"gpt-4.1-nano\";\n this.temperature = config.temperature || 0.7;\n this.maxTokens = config.maxTokens || 1000;\n }\n\n async generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n try {\n const openAIMessages = messages.map((msg) => ({\n role: msg.role as \"system\" | \"user\" | \"assistant\",\n content: msg.content,\n }));\n\n const completion = await withTimeout(\n this.openai.chat.completions.create({\n model: this.model,\n messages: openAIMessages,\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n }),\n `OpenAI LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`,\n );\n\n return completion.choices[0]?.message?.content || \"\";\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenAI LLM request failed\");\n }\n }\n}\n\nexport function createOpenAILLMProvider(\n config: OpenAILLMConfig,\n): OpenAILLMProvider {\n return new OpenAILLMProvider(config);\n}\n\nasync function withTimeout<T>(\n promise: Promise<T>,\n timeoutMessage: string,\n): Promise<T> {\n let timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n const timeoutPromise = new Promise<T>((_, reject) => {\n timeoutId = setTimeout(\n () => reject(new CharivoTimeoutError(timeoutMessage)),\n REQUEST_TIMEOUT_MS,\n );\n });\n\n try {\n return await Promise.race([promise, timeoutPromise]);\n } finally {\n if (timeoutId) {\n clearTimeout(timeoutId);\n }\n }\n}\n","import { LLMClient } from \"@charivo/core\";\nimport {\n createOpenAILLMProvider,\n OpenAILLMConfig,\n OpenAILLMProvider,\n} from \"./provider\";\n\n// OpenAILLMConfig를 직접 사용\nexport type OpenAILLMClientConfig = OpenAILLMConfig;\n\n/**\n * OpenAI LLM Client - OpenAI provider를 래핑해서 클라이언트에서 직접 사용하는 Stateless 클라이언트\n *\n * 로컬 개발이나 테스트 환경에서 사용. 프로덕션에서는 보안상 권장하지 않음.\n * API 키가 클라이언트에 노출되므로 서버 환경에서만 사용하거나 테스트용으로만 사용해야 함.\n *\n * Stateless 설계: 세션 관리는 외부에서 담당하고, 이 클라이언트는 API 호출만 담당\n */\nexport class OpenAILLMClient implements LLMClient {\n private provider: OpenAILLMProvider;\n\n constructor(config: OpenAILLMClientConfig) {\n // Intentional dev/test escape hatch: this direct browser client exposes\n // credentials. For production, see docs/guide/choosing-packages.md#remote.\n this.provider = createOpenAILLMProvider({\n ...config,\n dangerouslyAllowBrowser: true,\n });\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n // Provider를 사용해서 응답 생성\n const assistantMessage = await this.provider.generateResponse(messages);\n\n return assistantMessage;\n }\n}\n\nexport function createOpenAILLMClient(\n config: OpenAILLMClientConfig,\n): OpenAILLMClient {\n return new OpenAILLMClient(config);\n}\n"]}
@@ -35,7 +35,7 @@ var OpenAILLMProvider = class {
35
35
  temperature: this.temperature,
36
36
  max_tokens: this.maxTokens
37
37
  }),
38
- `request timed out after ${REQUEST_TIMEOUT_MS}ms`
38
+ `OpenAI LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`
39
39
  );
40
40
  return completion.choices[0]?.message?.content || "";
41
41
  } catch (error) {
@@ -1 +1 @@
1
- {"version":3,"sources":["../../src/openai/provider.ts","../../src/openai/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import OpenAI from \"openai\";\nimport {\n CharivoStateError,\n CharivoTimeoutError,\n LLMProvider,\n toCharivoError,\n} from \"@charivo/core\";\n\nconst REQUEST_TIMEOUT_MS = 30_000;\n\nexport interface OpenAILLMConfig {\n apiKey: string;\n model?: string;\n temperature?: number;\n maxTokens?: number;\n dangerouslyAllowBrowser?: boolean;\n}\n\nexport class OpenAILLMProvider implements LLMProvider {\n private openai: OpenAI;\n private model: string;\n private temperature: number;\n private maxTokens: number;\n\n constructor(config: OpenAILLMConfig) {\n if (typeof window !== \"undefined\" && !config.dangerouslyAllowBrowser) {\n throw new CharivoStateError(\n \"OpenAI LLM provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing\",\n );\n }\n\n this.openai = new OpenAI({\n apiKey: config.apiKey,\n dangerouslyAllowBrowser: config.dangerouslyAllowBrowser,\n });\n\n this.model = config.model || \"gpt-4.1-nano\";\n this.temperature = config.temperature || 0.7;\n this.maxTokens = config.maxTokens || 1000;\n }\n\n async generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n try {\n const openAIMessages = messages.map((msg) => ({\n role: msg.role as \"system\" | \"user\" | \"assistant\",\n content: msg.content,\n }));\n\n const completion = await withTimeout(\n this.openai.chat.completions.create({\n model: this.model,\n messages: openAIMessages,\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n }),\n `request timed out after ${REQUEST_TIMEOUT_MS}ms`,\n );\n\n return completion.choices[0]?.message?.content || \"\";\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenAI LLM request failed\");\n }\n }\n}\n\nexport function createOpenAILLMProvider(\n config: OpenAILLMConfig,\n): OpenAILLMProvider {\n return new OpenAILLMProvider(config);\n}\n\nasync function withTimeout<T>(\n promise: Promise<T>,\n timeoutMessage: string,\n): Promise<T> {\n let timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n const timeoutPromise = new Promise<T>((_, reject) => {\n timeoutId = setTimeout(\n () => reject(new CharivoTimeoutError(timeoutMessage)),\n REQUEST_TIMEOUT_MS,\n );\n });\n\n try {\n return await Promise.race([promise, timeoutPromise]);\n } finally {\n if (timeoutId) {\n clearTimeout(timeoutId);\n }\n }\n}\n","import { LLMClient } from \"@charivo/core\";\nimport {\n createOpenAILLMProvider,\n OpenAILLMConfig,\n OpenAILLMProvider,\n} from \"./provider\";\n\n// OpenAILLMConfig를 직접 사용\nexport type OpenAILLMClientConfig = OpenAILLMConfig;\n\n/**\n * OpenAI LLM Client - OpenAI provider를 래핑해서 클라이언트에서 직접 사용하는 Stateless 클라이언트\n *\n * 로컬 개발이나 테스트 환경에서 사용. 프로덕션에서는 보안상 권장하지 않음.\n * API 키가 클라이언트에 노출되므로 서버 환경에서만 사용하거나 테스트용으로만 사용해야 함.\n *\n * Stateless 설계: 세션 관리는 외부에서 담당하고, 이 클라이언트는 API 호출만 담당\n */\nexport class OpenAILLMClient implements LLMClient {\n private provider: OpenAILLMProvider;\n\n constructor(config: OpenAILLMClientConfig) {\n // Intentional dev/test escape hatch: this direct browser client exposes\n // credentials. For production, see docs/guide/choosing-packages.md#remote.\n this.provider = createOpenAILLMProvider({\n ...config,\n dangerouslyAllowBrowser: true,\n });\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n // Provider를 사용해서 응답 생성\n const assistantMessage = await this.provider.generateResponse(messages);\n\n return assistantMessage;\n }\n}\n\nexport function createOpenAILLMClient(\n config: OpenAILLMClientConfig,\n): OpenAILLMClient {\n return new OpenAILLMClient(config);\n}\n"]}
1
+ {"version":3,"sources":["../../src/openai/provider.ts","../../src/openai/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import OpenAI from \"openai\";\nimport {\n CharivoStateError,\n CharivoTimeoutError,\n LLMProvider,\n toCharivoError,\n} from \"@charivo/core\";\n\nconst REQUEST_TIMEOUT_MS = 30_000;\n\nexport interface OpenAILLMConfig {\n apiKey: string;\n model?: string;\n temperature?: number;\n maxTokens?: number;\n dangerouslyAllowBrowser?: boolean;\n}\n\nexport class OpenAILLMProvider implements LLMProvider {\n private openai: OpenAI;\n private model: string;\n private temperature: number;\n private maxTokens: number;\n\n constructor(config: OpenAILLMConfig) {\n if (typeof window !== \"undefined\" && !config.dangerouslyAllowBrowser) {\n throw new CharivoStateError(\n \"OpenAI LLM provider is for server-side use only. Set dangerouslyAllowBrowser: true for testing\",\n );\n }\n\n this.openai = new OpenAI({\n apiKey: config.apiKey,\n dangerouslyAllowBrowser: config.dangerouslyAllowBrowser,\n });\n\n this.model = config.model || \"gpt-4.1-nano\";\n this.temperature = config.temperature || 0.7;\n this.maxTokens = config.maxTokens || 1000;\n }\n\n async generateResponse(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n try {\n const openAIMessages = messages.map((msg) => ({\n role: msg.role as \"system\" | \"user\" | \"assistant\",\n content: msg.content,\n }));\n\n const completion = await withTimeout(\n this.openai.chat.completions.create({\n model: this.model,\n messages: openAIMessages,\n temperature: this.temperature,\n max_tokens: this.maxTokens,\n }),\n `OpenAI LLM request timed out after ${REQUEST_TIMEOUT_MS}ms`,\n );\n\n return completion.choices[0]?.message?.content || \"\";\n } catch (error) {\n throw toCharivoError(\"provider\", error, \"OpenAI LLM request failed\");\n }\n }\n}\n\nexport function createOpenAILLMProvider(\n config: OpenAILLMConfig,\n): OpenAILLMProvider {\n return new OpenAILLMProvider(config);\n}\n\nasync function withTimeout<T>(\n promise: Promise<T>,\n timeoutMessage: string,\n): Promise<T> {\n let timeoutId: ReturnType<typeof setTimeout> | undefined;\n\n const timeoutPromise = new Promise<T>((_, reject) => {\n timeoutId = setTimeout(\n () => reject(new CharivoTimeoutError(timeoutMessage)),\n REQUEST_TIMEOUT_MS,\n );\n });\n\n try {\n return await Promise.race([promise, timeoutPromise]);\n } finally {\n if (timeoutId) {\n clearTimeout(timeoutId);\n }\n }\n}\n","import { LLMClient } from \"@charivo/core\";\nimport {\n createOpenAILLMProvider,\n OpenAILLMConfig,\n OpenAILLMProvider,\n} from \"./provider\";\n\n// OpenAILLMConfig를 직접 사용\nexport type OpenAILLMClientConfig = OpenAILLMConfig;\n\n/**\n * OpenAI LLM Client - OpenAI provider를 래핑해서 클라이언트에서 직접 사용하는 Stateless 클라이언트\n *\n * 로컬 개발이나 테스트 환경에서 사용. 프로덕션에서는 보안상 권장하지 않음.\n * API 키가 클라이언트에 노출되므로 서버 환경에서만 사용하거나 테스트용으로만 사용해야 함.\n *\n * Stateless 설계: 세션 관리는 외부에서 담당하고, 이 클라이언트는 API 호출만 담당\n */\nexport class OpenAILLMClient implements LLMClient {\n private provider: OpenAILLMProvider;\n\n constructor(config: OpenAILLMClientConfig) {\n // Intentional dev/test escape hatch: this direct browser client exposes\n // credentials. For production, see docs/guide/choosing-packages.md#remote.\n this.provider = createOpenAILLMProvider({\n ...config,\n dangerouslyAllowBrowser: true,\n });\n }\n\n async call(\n messages: Array<{ role: string; content: string }>,\n ): Promise<string> {\n // Provider를 사용해서 응답 생성\n const assistantMessage = await this.provider.generateResponse(messages);\n\n return assistantMessage;\n }\n}\n\nexport function createOpenAILLMClient(\n config: OpenAILLMClientConfig,\n): OpenAILLMClient {\n return new OpenAILLMClient(config);\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@charivo/llm",
3
- "version": "0.3.2",
3
+ "version": "0.4.0",
4
4
  "description": "LLM manager and browser adapters for Charivo",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",