@things-factory/ai-client-base 10.1.129 → 10.1.155

package/dist-server/service/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../server/service/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG","sourcesContent":["/**\n * Provider-agnostic AI client types.\n *\n * 공통 인터페이스만 정의 — 실제 호출은 provider 별 어댑터에서.\n */\n\nexport type AIRole = 'system' | 'user' | 'assistant'\n\nexport interface AITextPart {\n  type: 'text'\n  text: string\n}\n\nexport type AIImageMediaType = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp'\n\nexport interface AIImagePart {\n  type: 'image'\n  source:\n    | { kind: 'base64'; data: Buffer | Uint8Array; mediaType: AIImageMediaType }\n    | { kind: 'url'; url: string }\n}\n\n/**\n * Assistant 가 tool 을 호출하라고 한 시점의 content part.\n * 다음 턴에서 같은 id 로 tool_result 를 매핑한다.\n */\nexport interface AIToolUsePart {\n  type: 'tool_use'\n  /** provider-stable id — Anthropic tool_use.id / OpenAI tool_call.id / Gemini 의 자체 매핑 */\n  id: string\n  /** tool 이름 */\n  name: string\n  /** 호출 인자 (JSON object) */\n  arguments: Record<string, any>\n  /**\n   * provider-specific opaque metadata that must be echoed back when this tool_use\n   * is referenced in subsequent turns.\n   *\n   * Gemini: `thoughtSignature` — 안 보내면 400 에러.\n   * Anthropic: 없음.\n   * OpenAI: 없음.\n   *\n   * 호출자(assistant loop)는 AIToolCall.providerMeta 를 그대로 복사해 넣는다.\n   */\n  providerMeta?: Record<string, any>\n}\n\n/**\n * 도구 실행 결과를 LLM 에 회신하는 user 측 content part.\n *\n * Anthropic: { type: 'tool_result', tool_use_id, content } — user role 에 들어감.\n * OpenAI: tool role 메시지로 전송.\n * Gemini: functionResponse part — user role 에 들어감.\n */\nexport interface AIToolResultPart {\n  type: 'tool_result'\n  /** 매핑되는 AIToolUsePart.id */\n  toolUseId: string\n  /** 도구 실행 결과 (text 또는 JSON-serializable) */\n  content: string\n  /** 실행 중 에러 발생 표시 (LLM 이 retry/대안 판단) */\n  isError?: boolean\n}\n\nexport type AIContentPart = AITextPart | AIImagePart | AIToolUsePart | AIToolResultPart\n\nexport interface AIMessage {\n  role: AIRole\n  content: string | AIContentPart[]\n}\n\nexport interface AIChatOptions {\n  /** 모델 override (없으면 client 기본값) */\n  model?: string\n  maxTokens?: number\n  temperature?: number\n  /**\n   * system prompt — messages 의 system 메시지와 합쳐서 전달.\n   * Anthropic 의 system 파라미터 / OpenAI 의 system 메시지로 매핑.\n   */\n  systemPrompt?: string\n  stopSequences?: string[]\n}\n\nexport interface AIJSONOptions extends AIChatOptions {\n  /** JSON Schema (옵션). 어댑터가 지원하면 structured output 강제 */\n  schema?: object\n}\n\nexport interface AIVisionOptions extends AIChatOptions {}\n\n// ── Tool calling ──────────────────────────────────────────────────\n\n/**\n * Provider-agnostic 도구 정의.\n * Anthropic input_schema / OpenAI parameters / Gemini parameters 로 어댑터에서 정규화.\n */\nexport interface AITool {\n  name: string\n  description: string\n  /** JSON Schema (object 권장). enum / required / properties 등 표준 키 사용. */\n  parameters: Record<string, any>\n}\n\n/**\n * LLM 이 호출하라고 지시한 도구 1 건.\n * id 는 multi-turn 흐름에서 tool_result 매핑에 사용 — 어댑터가 항상 채워야 한다.\n */\nexport interface AIToolCall {\n  id: string\n  name: string\n  arguments: Record<string, any>\n  /**\n   * provider-specific opaque metadata to round-trip on subsequent turns.\n   * Gemini 는 `thoughtSignature` 를 여기에 담는다 — 다음 턴에 functionCall.thoughtSignature\n   * 로 복원되어야 400 에러 회피.\n   */\n  providerMeta?: Record<string, any>\n}\n\nexport interface AIToolChatOptions extends AIChatOptions {\n  /**\n   * tool 선택 모드:\n   *  - 'auto': LLM 자율 (tool 호출 또는 텍스트 응답)\n   *  - 'required': 반드시 하나 이상 tool 호출\n   *  - 'none': tool 무시, 텍스트만\n   */\n  toolChoice?: 'auto' | 'required' | 'none'\n  /** 'required' 와 함께 특정 tool 강제. provider 별 지원 다름. */\n  forceTool?: string\n  /**\n   * 병렬 tool 호출 허용 여부 (default true).\n   * false 시 LLM 이 한 번에 하나의 tool 만 호출.\n   */\n  allowParallelToolCalls?: boolean\n}\n\nexport interface AIToolChatResult {\n  /** 사용자에게 보여줄 텍스트 (tool 호출과 함께 동봉될 수도 있음) */\n  text?: string\n  /** LLM 이 호출하라고 지시한 도구들 (병렬 가능) */\n  toolCalls: AIToolCall[]\n  /**\n   * 정규화된 stop reason:\n   *   'tool_use' — tool 호출 발생\n   *   'end_turn' — 텍스트 응답 종료\n   *   'max_tokens' — 토큰 한도\n   *   'stop_sequence' — stop sequence 도달\n   *   기타 — provider 원본 그대로\n   */\n  stopReason: 'tool_use' | 'end_turn' | 'max_tokens' | 'stop_sequence' | string\n}\n\n// ── Client ────────────────────────────────────────────────────────\n\nexport interface AIClient {\n  /** 'anthropic:claude-sonnet-4-6' 등 사람이 읽을 식별자 */\n  readonly id: string\n\n  /** 텍스트 chat completion */\n  chat(messages: AIMessage[], options?: AIChatOptions): Promise<string>\n\n  /** JSON 출력 강제. 파싱된 객체 반환. */\n  generateJSON<T = unknown>(prompt: string | AIMessage[], options?: AIJSONOptions): Promise<T>\n\n  /** 이미지 입력 — 텍스트 응답. 어댑터가 vision 모델을 지원해야 함. */\n  vision?(\n    image: Buffer | Uint8Array | { url: string },\n    prompt: string,\n    options?: AIVisionOptions\n  ): Promise<string>\n\n  /**\n   * Tool calling — LLM 이 자유 텍스트 대신 정의된 도구를 schema-검증된 인자로 호출.\n   * 각 도구의 parameters 가 enum/required 강제 → invalid type / 누락 필드 봉쇄.\n   * 어댑터별로 Anthropic tool_use / OpenAI tools / Gemini functionCalls 로 매핑.\n   */\n  chatWithTools?(\n    messages: AIMessage[],\n    tools: AITool[],\n    options?: AIToolChatOptions\n  ): Promise<AIToolChatResult>\n}\n\nexport interface AIClientConfig {\n  /** 등록된 provider 이름 (예: 'anthropic', 'openai', 'gemini') */\n  provider: string\n  /** 기본 모델 ID */\n  model?: string\n  apiKey?: string\n  /** OpenAI organization (provider:'openai' 전용) */\n  organization?: string\n  baseURL?: string\n  [k: string]: any\n}\n\nexport type AIProviderFactory = (config: AIClientConfig) => AIClient\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../server/service/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG","sourcesContent":["/**\n * Provider-agnostic AI client types.\n *\n * 공통 인터페이스만 정의 — 실제 호출은 provider 별 어댑터에서.\n */\n\nexport type AIRole = 'system' | 'user' | 'assistant'\n\nexport interface AITextPart {\n  type: 'text'\n  text: string\n}\n\nexport type AIImageMediaType = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp'\n\nexport interface AIImagePart {\n  type: 'image'\n  source:\n    | { kind: 'base64'; data: Buffer | Uint8Array; mediaType: AIImageMediaType }\n    | { kind: 'url'; url: string }\n}\n\n/**\n * Assistant 가 tool 을 호출하라고 한 시점의 content part.\n * 다음 턴에서 같은 id 로 tool_result 를 매핑한다.\n */\nexport interface AIToolUsePart {\n  type: 'tool_use'\n  /** provider-stable id — Anthropic tool_use.id / OpenAI tool_call.id / Gemini 의 자체 매핑 */\n  id: string\n  /** tool 이름 */\n  name: string\n  /** 호출 인자 (JSON object) */\n  arguments: Record<string, any>\n  /**\n   * provider-specific opaque metadata that must be echoed back when this tool_use\n   * is referenced in subsequent turns.\n   *\n   * Gemini: `thoughtSignature` — 안 보내면 400 에러.\n   * Anthropic: 없음.\n   * OpenAI: 없음.\n   *\n   * 호출자(assistant loop)는 AIToolCall.providerMeta 를 그대로 복사해 넣는다.\n   */\n  providerMeta?: Record<string, any>\n}\n\n/**\n * 도구 실행 결과를 LLM 에 회신하는 user 측 content part.\n *\n * Anthropic: { type: 'tool_result', tool_use_id, content } — user role 에 들어감.\n * OpenAI: tool role 메시지로 전송.\n * Gemini: functionResponse part — user role 에 들어감.\n */\nexport interface AIToolResultPart {\n  type: 'tool_result'\n  /** 매핑되는 AIToolUsePart.id */\n  toolUseId: string\n  /** 도구 실행 결과 (text 또는 JSON-serializable) */\n  content: string\n  /** 실행 중 에러 발생 표시 (LLM 이 retry/대안 판단) */\n  isError?: boolean\n}\n\nexport type AIContentPart = AITextPart | AIImagePart | AIToolUsePart | AIToolResultPart\n\nexport interface AIMessage {\n  role: AIRole\n  content: string | AIContentPart[]\n}\n\nexport interface AIChatOptions {\n  /** 모델 override (없으면 client 기본값) */\n  model?: string\n  maxTokens?: number\n  temperature?: number\n  /**\n   * system prompt — messages 의 system 메시지와 합쳐서 전달.\n   * Anthropic 의 system 파라미터 / OpenAI 의 system 메시지로 매핑.\n   */\n  systemPrompt?: string\n  stopSequences?: string[]\n  /**\n   * Told what one provider call used, right after it returns. The metering boundary (aiClientFor) sets this per\n   * call so the usage row knows whose call it was; adapters call it once for every request they send.\n   */\n  onUsage?: (usage: AIProviderUsage) => void\n}\n\n/** What one provider request used, as the provider reported it. A count the provider did not report stays undefined. */\nexport interface AIProviderUsage {\n  model: string\n  inputTokens?: number\n  outputTokens?: number\n}\n\nexport interface AIJSONOptions extends AIChatOptions {\n  /** JSON Schema (옵션). 어댑터가 지원하면 structured output 강제 */\n  schema?: object\n}\n\nexport interface AIVisionOptions extends AIChatOptions {}\n\n// ── Tool calling ──────────────────────────────────────────────────\n\n/**\n * Provider-agnostic 도구 정의.\n * Anthropic input_schema / OpenAI parameters / Gemini parameters 로 어댑터에서 정규화.\n */\nexport interface AITool {\n  name: string\n  description: string\n  /** JSON Schema (object 권장). enum / required / properties 등 표준 키 사용. */\n  parameters: Record<string, any>\n}\n\n/**\n * LLM 이 호출하라고 지시한 도구 1 건.\n * id 는 multi-turn 흐름에서 tool_result 매핑에 사용 — 어댑터가 항상 채워야 한다.\n */\nexport interface AIToolCall {\n  id: string\n  name: string\n  arguments: Record<string, any>\n  /**\n   * provider-specific opaque metadata to round-trip on subsequent turns.\n   * Gemini 는 `thoughtSignature` 를 여기에 담는다 — 다음 턴에 functionCall.thoughtSignature\n   * 로 복원되어야 400 에러 회피.\n   */\n  providerMeta?: Record<string, any>\n}\n\nexport interface AIToolChatOptions extends AIChatOptions {\n  /**\n   * tool 선택 모드:\n   *  - 'auto': LLM 자율 (tool 호출 또는 텍스트 응답)\n   *  - 'required': 반드시 하나 이상 tool 호출\n   *  - 'none': tool 무시, 텍스트만\n   */\n  toolChoice?: 'auto' | 'required' | 'none'\n  /** 'required' 와 함께 특정 tool 강제. provider 별 지원 다름. */\n  forceTool?: string\n  /**\n   * 병렬 tool 호출 허용 여부 (default true).\n   * false 시 LLM 이 한 번에 하나의 tool 만 호출.\n   */\n  allowParallelToolCalls?: boolean\n}\n\nexport interface AIToolChatResult {\n  /** 사용자에게 보여줄 텍스트 (tool 호출과 함께 동봉될 수도 있음) */\n  text?: string\n  /** LLM 이 호출하라고 지시한 도구들 (병렬 가능) */\n  toolCalls: AIToolCall[]\n  /**\n   * 정규화된 stop reason:\n   *   'tool_use' — tool 호출 발생\n   *   'end_turn' — 텍스트 응답 종료\n   *   'max_tokens' — 토큰 한도\n   *   'stop_sequence' — stop sequence 도달\n   *   기타 — provider 원본 그대로\n   */\n  stopReason: 'tool_use' | 'end_turn' | 'max_tokens' | 'stop_sequence' | string\n}\n\n// ── Client ────────────────────────────────────────────────────────\n\nexport interface AIClient {\n  /** 'anthropic:claude-sonnet-4-6' 등 사람이 읽을 식별자 */\n  readonly id: string\n\n  /** 텍스트 chat completion */\n  chat(messages: AIMessage[], options?: AIChatOptions): Promise<string>\n\n  /** JSON 출력 강제. 파싱된 객체 반환. */\n  generateJSON<T = unknown>(prompt: string | AIMessage[], options?: AIJSONOptions): Promise<T>\n\n  /** 이미지 입력 — 텍스트 응답. 어댑터가 vision 모델을 지원해야 함. */\n  vision?(\n    image: Buffer | Uint8Array | { url: string },\n    prompt: string,\n    options?: AIVisionOptions\n  ): Promise<string>\n\n  /**\n   * Tool calling — LLM 이 자유 텍스트 대신 정의된 도구를 schema-검증된 인자로 호출.\n   * 각 도구의 parameters 가 enum/required 강제 → invalid type / 누락 필드 봉쇄.\n   * 어댑터별로 Anthropic tool_use / OpenAI tools / Gemini functionCalls 로 매핑.\n   */\n  chatWithTools?(\n    messages: AIMessage[],\n    tools: AITool[],\n    options?: AIToolChatOptions\n  ): Promise<AIToolChatResult>\n\n  /** The ids of the conversation models this key may call, sorted. Reading it also proves the key is accepted. */\n  listModels(): Promise<string[]>\n}\n\nexport interface AIClientConfig {\n  /** 등록된 provider 이름 (예: 'anthropic', 'openai', 'gemini') */\n  provider: string\n  /** The model every call uses unless a call names another. */\n  model?: string\n  /** Required - a provider is never reached with a key from the process environment. */\n  apiKey: string\n  /** OpenAI organization (provider:'openai' 전용) */\n  organization?: string\n  baseURL?: string\n  [k: string]: any\n}\n\nexport type AIProviderFactory = (config: AIClientConfig) => AIClient\n"]}