@things-factory/ai-client-base 10.0.0-beta.64

package/config/config.development.js

@@ -0,0 +1,72 @@
+module.exports = {
+  /*
+    AI Client Configuration
+
+    Provider-agnostic configuration for the default AI client used by board-ai
+    and any other module that calls `getDefaultAIClient()`.
+
+    To activate, override this in your application's config (config.development.js
+    or config.production.js) with your provider/key.
+
+    Currently supported providers (registered via @things-factory/ai-client-base):
+      - 'anthropic'  — Anthropic Claude (default model: claude-sonnet-4-6)
+      - 'gemini'     — Google Gemini  (default model: gemini-3-pro)
+      - 'openai'     — OpenAI GPT     (default model: gpt-4o)
+
+    Example for Anthropic Claude:
+
+      aiClient: {
+        provider: 'anthropic',
+        model: 'claude-sonnet-4-6',
+        apiKey: process.env.ANTHROPIC_API_KEY
+      }
+
+    Example for Google Gemini:
+
+      aiClient: {
+        provider: 'gemini',
+        model: 'gemini-3-pro',
+        apiKey: process.env.GOOGLE_API_KEY
+      }
+
+    Example for on-prem / proxy / Bedrock-style endpoint:
+
+      aiClient: {
+        provider: 'anthropic',
+        model: 'claude-sonnet-4-6',
+        apiKey: 'internal-key',
+        baseURL: 'https://internal-llm-gateway.example.com'
+      }
+
+    Fields:
+      - provider : Registered adapter name. Required.
+      - model    : Model ID. Optional; falls back to adapter default.
+      - apiKey   : API key. If omitted, SDK-level environment fallback applies
+                   (Anthropic SDK: ANTHROPIC_API_KEY; Gemini adapter: GOOGLE_API_KEY,
+                   GEMINI_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY).
+      - baseURL  : Optional. On-prem / proxy / compatible endpoint.
+
+    Example for OpenAI:
+
+      aiClient: {
+        provider: 'openai',
+        model: 'gpt-4o',
+        apiKey: process.env.OPENAI_API_KEY,
+        organization: process.env.OPENAI_ORGANIZATION  // optional
+      }
+
+    Note on the legacy `openai` config key:
+      @things-factory/codelingua uses a separate `openai: { organization, apiKey }` key.
+      The two keys are intentionally independent — codelingua keeps using `openai`,
+      ai-client-base only reads `aiClient`. If you want OpenAI here too, set `aiClient`
+      explicitly with provider:'openai' (the values may duplicate codelingua's,
+      that's fine — they live in different modules).
+
+    If `aiClient` is absent, no default client is created — chat() calls will fail
+    with a clear message. Modules can still be used with an explicitly-passed AIClient
+    via setDefaultAIClient(...).
+  */
+  // aiClient: {
+  //   provider: 'anthropic'
+  // }
+}

package/config/config.production.js

@@ -0,0 +1,24 @@
+module.exports = {
+  /*
+    AI Client Configuration — Production
+
+    See config.development.js for the full reference and provider examples.
+
+    Override this in your application's production config with the actual
+    provider and credentials. Never commit real API keys to the source tree.
+
+    Recommended pattern — read from environment in your application config:
+
+      aiClient: {
+        provider: process.env.AI_PROVIDER || 'anthropic',
+        model: process.env.AI_MODEL,
+        apiKey: process.env.AI_API_KEY
+                || process.env.ANTHROPIC_API_KEY
+                || process.env.GOOGLE_API_KEY,
+        baseURL: process.env.AI_BASE_URL
+      }
+  */
+  // aiClient: {
+  //   provider: 'anthropic'
+  // }
+}

package/dist-server/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @things-factory/ai-client-base — Provider-agnostic AI client abstraction.
+ *
+ * 사용 예:
+ * ```ts
+ * import { createAIClient } from '@things-factory/ai-client-base'
+ *
+ * const client = createAIClient({
+ *   provider: 'anthropic',
+ *   model: 'claude-sonnet-4-6',
+ *   apiKey: process.env.ANTHROPIC_API_KEY
+ * })
+ *
+ * const text = await client.chat([{ role: 'user', content: 'Hello' }])
+ * const json = await client.generateJSON<MyShape>('Return {"x": 1, "y": 2} as JSON')
+ * const desc = await client.vision(imageBuffer, 'What is in this image?')
+ * ```
+ */
+export * from './service/index.js';

package/dist-server/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+/**
+ * @things-factory/ai-client-base — Provider-agnostic AI client abstraction.
+ *
+ * 사용 예:
+ * ```ts
+ * import { createAIClient } from '@things-factory/ai-client-base'
+ *
+ * const client = createAIClient({
+ *   provider: 'anthropic',
+ *   model: 'claude-sonnet-4-6',
+ *   apiKey: process.env.ANTHROPIC_API_KEY
+ * })
+ *
+ * const text = await client.chat([{ role: 'user', content: 'Hello' }])
+ * const json = await client.generateJSON<MyShape>('Return {"x": 1, "y": 2} as JSON')
+ * const desc = await client.vision(imageBuffer, 'What is in this image?')
+ * ```
+ */
+tslib_1.__exportStar(require("./service/index.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist-server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../server/index.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,6DAAkC","sourcesContent":["/**\n * @things-factory/ai-client-base — Provider-agnostic AI client abstraction.\n *\n * 사용 예:\n * ```ts\n * import { createAIClient } from '@things-factory/ai-client-base'\n *\n * const client = createAIClient({\n *   provider: 'anthropic',\n *   model: 'claude-sonnet-4-6',\n *   apiKey: process.env.ANTHROPIC_API_KEY\n * })\n *\n * const text = await client.chat([{ role: 'user', content: 'Hello' }])\n * const json = await client.generateJSON<MyShape>('Return {\"x\": 1, \"y\": 2} as JSON')\n * const desc = await client.vision(imageBuffer, 'What is in this image?')\n * ```\n */\nexport * from './service/index.js'\n"]}

package/dist-server/service/factory.d.ts

@@ -0,0 +1,16 @@
+import type { AIClient, AIClientConfig, AIProviderFactory } from './types.js';
+export declare function registerAIProvider(name: string, factory: AIProviderFactory): void;
+export declare function listRegisteredProviders(): string[];
+export declare function createAIClient(config: AIClientConfig): AIClient;
+/**
+ * 기본 client.
+ *  1) `setDefaultAIClient()` 로 명시 설정된 게 있으면 그것
+ *  2) env config 의 `aiClient` 키가 있으면 거기서 생성
+ *  3) 없으면 undefined (호출자는 nullable 처리)
+ *
+ * 다른 모듈 (예: codelingua) 의 `openai` 키와는 의도적으로 분리. 두 키는 서로 모르고 동작.
+ *
+ * 잘못된 config (provider 누락, 등록되지 않은 provider) 는 console.warn 후 undefined.
+ */
+export declare function getDefaultAIClient(): AIClient | undefined;
+export declare function setDefaultAIClient(client: AIClient | undefined): void;

package/dist-server/service/factory.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerAIProvider = registerAIProvider;
+exports.listRegisteredProviders = listRegisteredProviders;
+exports.createAIClient = createAIClient;
+exports.getDefaultAIClient = getDefaultAIClient;
+exports.setDefaultAIClient = setDefaultAIClient;
+/**
+ * AI Provider 등록 + Client 생성.
+ *
+ * - 어댑터 패키지(또는 동일 패키지의 providers/) 가 모듈 로드 시 `registerAIProvider` 호출.
+ * - 호출자는 `createAIClient({ provider: 'anthropic', ... })` 로 인스턴스 획득.
+ * - things-factory env config 의 `aiClient` 키가 있으면 `getDefaultAIClient()` 가 자동 생성.
+ */
+const env_1 = require("@things-factory/env");
+const REGISTERED_PROVIDERS = new Map();
+function registerAIProvider(name, factory) {
+    REGISTERED_PROVIDERS.set(name, factory);
+}
+function listRegisteredProviders() {
+    return Array.from(REGISTERED_PROVIDERS.keys());
+}
+function createAIClient(config) {
+    const factory = REGISTERED_PROVIDERS.get(config.provider);
+    if (!factory) {
+        throw new Error(`Unknown AI provider "${config.provider}". Registered: ${listRegisteredProviders().join(', ') || '(none)'}`);
+    }
+    return factory(config);
+}
+let _defaultClient;
+/**
+ * 기본 client.
+ *  1) `setDefaultAIClient()` 로 명시 설정된 게 있으면 그것
+ *  2) env config 의 `aiClient` 키가 있으면 거기서 생성
+ *  3) 없으면 undefined (호출자는 nullable 처리)
+ *
+ * 다른 모듈 (예: codelingua) 의 `openai` 키와는 의도적으로 분리. 두 키는 서로 모르고 동작.
+ *
+ * 잘못된 config (provider 누락, 등록되지 않은 provider) 는 console.warn 후 undefined.
+ */
+function getDefaultAIClient() {
+    if (_defaultClient)
+        return _defaultClient;
+    const cfg = env_1.config.get('aiClient', null);
+    if (!cfg)
+        return undefined;
+    if (!cfg.provider) {
+        console.warn('[ai-client-base] config.aiClient is set but missing required "provider" field. ' +
+            'See @things-factory/ai-client-base/config/config.development.js for examples.');
+        return undefined;
+    }
+    try {
+        _defaultClient = createAIClient(cfg);
+    }
+    catch (e) {
+        console.warn(`[ai-client-base] Failed to create default AI client: ${e.message}. ` +
+            `Registered providers: ${listRegisteredProviders().join(', ') || '(none)'}`);
+        return undefined;
+    }
+    return _defaultClient;
+}
+function setDefaultAIClient(client) {
+    _defaultClient = client;
+}
+//# sourceMappingURL=factory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../server/service/factory.ts"],"names":[],"mappings":";;AAYA,gDAEC;AAED,0DAEC;AAED,wCAQC;AAcD,gDAqBC;AAED,gDAEC;AAnED;;;;;;GAMG;AACH,6CAAyD;AAGzD,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAA6B,CAAA;AAEjE,SAAgB,kBAAkB,CAAC,IAAY,EAAE,OAA0B;IACzE,oBAAoB,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;AACzC,CAAC;AAED,SAAgB,uBAAuB;IACrC,OAAO,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC,CAAA;AAChD,CAAC;AAED,SAAgB,cAAc,CAAC,MAAsB;IACnD,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,wBAAwB,MAAM,CAAC,QAAQ,kBAAkB,uBAAuB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAC5G,CAAA;IACH,CAAC;IACD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAA;AACxB,CAAC;AAED,IAAI,cAAoC,CAAA;AAExC;;;;;;;;;GASG;AACH,SAAgB,kBAAkB;IAChC,IAAI,cAAc;QAAE,OAAO,cAAc,CAAA;IACzC,MAAM,GAAG,GAAG,YAAS,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAA0B,CAAA;IACpE,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAA;IAC1B,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CACV,iFAAiF;YAC/E,+EAA+E,CAClF,CAAA;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,CAAC;QACH,cAAc,GAAG,cAAc,CAAC,GAAG,CAAC,CAAA;IACtC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CACV,wDAAyD,CAAW,CAAC,OAAO,IAAI;YAC9E,yBAAyB,uBAAuB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAC9E,CAAA;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,cAAc,CAAA;AACvB,CAAC;AAED,SAAgB,kBAAkB,CAAC,MAA4B;IAC7D,cAAc,GAAG,MAAM,CAAA;AACzB,CAAC","sourcesContent":["/**\n * AI Provider 등록 + Client 생성.\n *\n * - 어댑터 패키지(또는 동일 패키지의 providers/) 가 모듈 로드 시 `registerAIProvider` 호출.\n * - 호출자는 `createAIClient({ provider: 'anthropic', ... })` 로 인스턴스 획득.\n * - things-factory env config 의 `aiClient` 키가 있으면 `getDefaultAIClient()` 가 자동 생성.\n */\nimport { config as envConfig } from '@things-factory/env'\nimport type { AIClient, AIClientConfig, AIProviderFactory } from './types.js'\n\nconst REGISTERED_PROVIDERS = new Map<string, AIProviderFactory>()\n\nexport function registerAIProvider(name: string, factory: AIProviderFactory): void {\n  REGISTERED_PROVIDERS.set(name, factory)\n}\n\nexport function listRegisteredProviders(): string[] {\n  return Array.from(REGISTERED_PROVIDERS.keys())\n}\n\nexport function createAIClient(config: AIClientConfig): AIClient {\n  const factory = REGISTERED_PROVIDERS.get(config.provider)\n  if (!factory) {\n    throw new Error(\n      `Unknown AI provider \"${config.provider}\". Registered: ${listRegisteredProviders().join(', ') || '(none)'}`\n    )\n  }\n  return factory(config)\n}\n\nlet _defaultClient: AIClient | undefined\n\n/**\n * 기본 client.\n *  1) `setDefaultAIClient()` 로 명시 설정된 게 있으면 그것\n *  2) env config 의 `aiClient` 키가 있으면 거기서 생성\n *  3) 없으면 undefined (호출자는 nullable 처리)\n *\n * 다른 모듈 (예: codelingua) 의 `openai` 키와는 의도적으로 분리. 두 키는 서로 모르고 동작.\n *\n * 잘못된 config (provider 누락, 등록되지 않은 provider) 는 console.warn 후 undefined.\n */\nexport function getDefaultAIClient(): AIClient | undefined {\n  if (_defaultClient) return _defaultClient\n  const cfg = envConfig.get('aiClient', null) as AIClientConfig | null\n  if (!cfg) return undefined\n  if (!cfg.provider) {\n    console.warn(\n      '[ai-client-base] config.aiClient is set but missing required \"provider\" field. ' +\n        'See @things-factory/ai-client-base/config/config.development.js for examples.'\n    )\n    return undefined\n  }\n  try {\n    _defaultClient = createAIClient(cfg)\n  } catch (e) {\n    console.warn(\n      `[ai-client-base] Failed to create default AI client: ${(e as Error).message}. ` +\n        `Registered providers: ${listRegisteredProviders().join(', ') || '(none)'}`\n    )\n    return undefined\n  }\n  return _defaultClient\n}\n\nexport function setDefaultAIClient(client: AIClient | undefined): void {\n  _defaultClient = client\n}\n"]}

package/dist-server/service/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './factory.js';
+export * from './providers/index.js';
+export * from './utils/index.js';

package/dist-server/service/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./types.js"), exports);
+tslib_1.__exportStar(require("./factory.js"), exports);
+tslib_1.__exportStar(require("./providers/index.js"), exports);
+tslib_1.__exportStar(require("./utils/index.js"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../server/service/index.ts"],"names":[],"mappings":";;;AAAA,qDAA0B;AAC1B,uDAA4B;AAC5B,+DAAoC;AACpC,2DAAgC","sourcesContent":["export * from './types.js'\nexport * from './factory.js'\nexport * from './providers/index.js'\nexport * from './utils/index.js'\n"]}

package/dist-server/service/providers/anthropic.d.ts

@@ -0,0 +1,13 @@
+import type { AIChatOptions, AIClient, AIClientConfig, AIJSONOptions, AIMessage, AITool, AIToolChatOptions, AIToolChatResult, AIVisionOptions } from '../types.js';
+export declare class AnthropicAIClient implements AIClient {
+    readonly id: string;
+    private sdk;
+    private defaultModel;
+    constructor(config: AIClientConfig);
+    chat(messages: AIMessage[], options?: AIChatOptions): Promise<string>;
+    generateJSON<T = unknown>(prompt: string | AIMessage[], options?: AIJSONOptions): Promise<T>;
+    vision(image: Buffer | Uint8Array | {
+        url: string;
+    }, prompt: string, options?: AIVisionOptions): Promise<string>;
+    chatWithTools(messages: AIMessage[], tools: AITool[], options?: AIToolChatOptions): Promise<AIToolChatResult>;
+}

package/dist-server/service/providers/anthropic.js

@@ -0,0 +1,201 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnthropicAIClient = void 0;
+const tslib_1 = require("tslib");
+/**
+ * Anthropic (Claude) AI Client adapter.
+ *
+ * 기본 모델: claude-sonnet-4-6 (구성에서 override 가능).
+ * SDK: @anthropic-ai/sdk
+ */
+const sdk_1 = tslib_1.__importDefault(require("@anthropic-ai/sdk"));
+const factory_js_1 = require("../factory.js");
+const parse_json_js_1 = require("../utils/parse-json.js");
+const DEFAULT_MODEL = 'claude-sonnet-4-6';
+const DEFAULT_MAX_TOKENS = 4096;
+class AnthropicAIClient {
+    constructor(config) {
+        this.sdk = new sdk_1.default({
+            apiKey: config.apiKey,
+            ...(config.baseURL && { baseURL: config.baseURL })
+        });
+        this.defaultModel = config.model ?? DEFAULT_MODEL;
+        this.id = `anthropic:${this.defaultModel}`;
+    }
+    async chat(messages, options = {}) {
+        const systemFromMessages = messages
+            .filter(m => m.role === 'system')
+            .map(extractTextContent)
+            .filter(Boolean)
+            .join('\n\n');
+        const system = [options.systemPrompt, systemFromMessages].filter(Boolean).join('\n\n');
+        const conversation = messages
+            .filter(m => m.role !== 'system')
+            .map(toAnthropicMessage);
+        const response = await this.sdk.messages.create({
+            model: options.model ?? this.defaultModel,
+            max_tokens: options.maxTokens ?? DEFAULT_MAX_TOKENS,
+            ...(options.temperature !== undefined && { temperature: options.temperature }),
+            ...(system && { system }),
+            ...(options.stopSequences && { stop_sequences: options.stopSequences }),
+            messages: conversation
+        });
+        return extractResponseText(response);
+    }
+    async generateJSON(prompt, options = {}) {
+        const messages = typeof prompt === 'string' ? [{ role: 'user', content: prompt }] : prompt;
+        const schemaHint = options.schema
+            ? `\n\nResponse MUST conform to this JSON schema:\n${JSON.stringify(options.schema)}`
+            : '';
+        const enforcedSystem = (options.systemPrompt ? options.systemPrompt + '\n\n' : '') +
+            'Return only valid JSON. No markdown code fences, no commentary.' +
+            schemaHint;
+        const text = await this.chat(messages, { ...options, systemPrompt: enforcedSystem });
+        return (0, parse_json_js_1.parseJSONResponse)(text);
+    }
+    async vision(image, prompt, options = {}) {
+        const imagePart = typeof image === 'object' && 'url' in image
+            ? { type: 'image', source: { kind: 'url', url: image.url } }
+            : {
+                type: 'image',
+                source: { kind: 'base64', data: image, mediaType: 'image/png' }
+            };
+        return this.chat([{ role: 'user', content: [imagePart, { type: 'text', text: prompt }] }], options);
+    }
+    async chatWithTools(messages, tools, options = {}) {
+        const systemFromMessages = messages
+            .filter(m => m.role === 'system')
+            .map(extractTextContent)
+            .filter(Boolean)
+            .join('\n\n');
+        const system = [options.systemPrompt, systemFromMessages].filter(Boolean).join('\n\n');
+        const conversation = messages.filter(m => m.role !== 'system').map(toAnthropicMessage);
+        const sdkTools = tools.map(t => ({
+            name: t.name,
+            description: t.description,
+            input_schema: t.parameters
+        }));
+        const toolChoice = buildAnthropicToolChoice(options);
+        const response = await this.sdk.messages.create({
+            model: options.model ?? this.defaultModel,
+            max_tokens: options.maxTokens ?? DEFAULT_MAX_TOKENS,
+            ...(options.temperature !== undefined && { temperature: options.temperature }),
+            ...(system && { system }),
+            ...(options.stopSequences && { stop_sequences: options.stopSequences }),
+            messages: conversation,
+            tools: sdkTools,
+            ...(toolChoice && { tool_choice: toolChoice })
+        });
+        const text = extractResponseText(response) || undefined;
+        const toolCalls = Array.isArray(response.content)
+            ? response.content
+                .filter((b) => b && b.type === 'tool_use')
+                .map((b) => ({
+                id: typeof b.id === 'string' && b.id ? b.id : `call_${Math.random().toString(36).slice(2, 12)}`,
+                name: b.name,
+                arguments: (b.input && typeof b.input === 'object' ? b.input : {})
+            }))
+            : [];
+        return {
+            text,
+            toolCalls,
+            stopReason: normalizeAnthropicStopReason(response.stop_reason)
+        };
+    }
+}
+exports.AnthropicAIClient = AnthropicAIClient;
+// ── 변환 유틸 ─────────────────────────────────────────────────────────
+function extractTextContent(msg) {
+    if (typeof msg.content === 'string')
+        return msg.content;
+    return msg.content
+        .filter(p => p.type === 'text')
+        .map(p => p.text)
+        .join('\n');
+}
+function toAnthropicMessage(msg) {
+    if (typeof msg.content === 'string') {
+        return { role: msg.role, content: msg.content };
+    }
+    return {
+        role: msg.role,
+        content: msg.content.map(toAnthropicContentBlock)
+    };
+}
+function toAnthropicContentBlock(part) {
+    if (part.type === 'text') {
+        return { type: 'text', text: part.text };
+    }
+    if (part.type === 'tool_use') {
+        return { type: 'tool_use', id: part.id, name: part.name, input: part.arguments };
+    }
+    if (part.type === 'tool_result') {
+        return {
+            type: 'tool_result',
+            tool_use_id: part.toolUseId,
+            content: part.content,
+            ...(part.isError && { is_error: true })
+        };
+    }
+    // image
+    if (part.source.kind === 'url') {
+        return { type: 'image', source: { type: 'url', url: part.source.url } };
+    }
+    const data = Buffer.isBuffer(part.source.data)
+        ? part.source.data.toString('base64')
+        : Buffer.from(part.source.data).toString('base64');
+    return {
+        type: 'image',
+        source: { type: 'base64', media_type: part.source.mediaType, data }
+    };
+}
+function extractResponseText(response) {
+    if (!response || !Array.isArray(response.content))
+        return '';
+    return response.content
+        .filter((b) => b && b.type === 'text')
+        .map((b) => b.text || '')
+        .join('');
+}
+function buildAnthropicToolChoice(options) {
+    const choice = options.toolChoice ?? 'auto';
+    const disableParallel = options.allowParallelToolCalls === false;
+    if (choice === 'none') {
+        return { type: 'none' };
+    }
+    if (choice === 'required') {
+        if (options.forceTool) {
+            return {
+                type: 'tool',
+                name: options.forceTool,
+                ...(disableParallel && { disable_parallel_tool_use: true })
+            };
+        }
+        return {
+            type: 'any',
+            ...(disableParallel && { disable_parallel_tool_use: true })
+        };
+    }
+    // 'auto'
+    return {
+        type: 'auto',
+        ...(disableParallel && { disable_parallel_tool_use: true })
+    };
+}
+function normalizeAnthropicStopReason(raw) {
+    switch (raw) {
+        case 'tool_use':
+            return 'tool_use';
+        case 'end_turn':
+            return 'end_turn';
+        case 'max_tokens':
+            return 'max_tokens';
+        case 'stop_sequence':
+            return 'stop_sequence';
+        default:
+            return raw ?? 'end_turn';
+    }
+}
+// Auto-register at module load
+(0, factory_js_1.registerAIProvider)('anthropic', config => new AnthropicAIClient(config));
+//# sourceMappingURL=anthropic.js.map

package/dist-server/service/providers/anthropic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../../server/service/providers/anthropic.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Anthropic (Claude) AI Client adapter.\n *\n * 기본 모델: claude-sonnet-4-6 (구성에서 override 가능).\n * SDK: @anthropic-ai/sdk\n */\nimport Anthropic from '@anthropic-ai/sdk'\nimport type {\n  AIChatOptions,\n  AIClient,\n  AIClientConfig,\n  AIContentPart,\n  AIJSONOptions,\n  AIMessage,\n  AITool,\n  AIToolCall,\n  AIToolChatOptions,\n  AIToolChatResult,\n  AIVisionOptions\n} from '../types.js'\nimport { registerAIProvider } from '../factory.js'\nimport { parseJSONResponse } from '../utils/parse-json.js'\n\nconst DEFAULT_MODEL = 'claude-sonnet-4-6'\nconst DEFAULT_MAX_TOKENS = 4096\n\nexport class AnthropicAIClient implements AIClient {\n  readonly id: string\n  private sdk: Anthropic\n  private defaultModel: string\n\n  constructor(config: AIClientConfig) {\n    this.sdk = new Anthropic({\n      apiKey: config.apiKey,\n      ...(config.baseURL && { baseURL: config.baseURL })\n    })\n    this.defaultModel = config.model ?? DEFAULT_MODEL\n    this.id = `anthropic:${this.defaultModel}`\n  }\n\n  async chat(messages: AIMessage[], options: AIChatOptions = {}): Promise<string> {\n    const systemFromMessages = messages\n      .filter(m => m.role === 'system')\n      .map(extractTextContent)\n      .filter(Boolean)\n      .join('\\n\\n')\n    const system = [options.systemPrompt, systemFromMessages].filter(Boolean).join('\\n\\n')\n\n    const conversation = messages\n      .filter(m => m.role !== 'system')\n      .map(toAnthropicMessage)\n\n    const response = await this.sdk.messages.create({\n      model: options.model ?? this.defaultModel,\n      max_tokens: options.maxTokens ?? DEFAULT_MAX_TOKENS,\n      ...(options.temperature !== undefined && { temperature: options.temperature }),\n      ...(system && { system }),\n      ...(options.stopSequences && { stop_sequences: options.stopSequences }),\n      messages: conversation\n    } as any)\n\n    return extractResponseText(response)\n  }\n\n  async generateJSON<T = unknown>(\n    prompt: string | AIMessage[],\n    options: AIJSONOptions = {}\n  ): Promise<T> {\n    const messages: AIMessage[] =\n      typeof prompt === 'string' ? [{ role: 'user', content: prompt }] : prompt\n\n    const schemaHint = options.schema\n      ? `\\n\\nResponse MUST conform to this JSON schema:\\n${JSON.stringify(options.schema)}`\n      : ''\n    const enforcedSystem =\n      (options.systemPrompt ? options.systemPrompt + '\\n\\n' : '') +\n      'Return only valid JSON. No markdown code fences, no commentary.' +\n      schemaHint\n\n    const text = await this.chat(messages, { ...options, systemPrompt: enforcedSystem })\n    return parseJSONResponse<T>(text)\n  }\n\n  async vision(\n    image: Buffer | Uint8Array | { url: string },\n    prompt: string,\n    options: AIVisionOptions = {}\n  ): Promise<string> {\n    const imagePart: AIContentPart =\n      typeof image === 'object' && 'url' in image\n        ? { type: 'image', source: { kind: 'url', url: image.url } }\n        : {\n            type: 'image',\n            source: { kind: 'base64', data: image as Buffer | Uint8Array, mediaType: 'image/png' }\n          }\n\n    return this.chat(\n      [{ role: 'user', content: [imagePart, { type: 'text', text: prompt }] }],\n      options\n    )\n  }\n\n  async chatWithTools(\n    messages: AIMessage[],\n    tools: AITool[],\n    options: AIToolChatOptions = {}\n  ): Promise<AIToolChatResult> {\n    const systemFromMessages = messages\n      .filter(m => m.role === 'system')\n      .map(extractTextContent)\n      .filter(Boolean)\n      .join('\\n\\n')\n    const system = [options.systemPrompt, systemFromMessages].filter(Boolean).join('\\n\\n')\n    const conversation = messages.filter(m => m.role !== 'system').map(toAnthropicMessage)\n\n    const sdkTools = tools.map(t => ({\n      name: t.name,\n      description: t.description,\n      input_schema: t.parameters as any\n    }))\n\n    const toolChoice = buildAnthropicToolChoice(options)\n\n    const response = await this.sdk.messages.create({\n      model: options.model ?? this.defaultModel,\n      max_tokens: options.maxTokens ?? DEFAULT_MAX_TOKENS,\n      ...(options.temperature !== undefined && { temperature: options.temperature }),\n      ...(system && { system }),\n      ...(options.stopSequences && { stop_sequences: options.stopSequences }),\n      messages: conversation,\n      tools: sdkTools,\n      ...(toolChoice && { tool_choice: toolChoice })\n    } as any)\n\n    const text = extractResponseText(response) || undefined\n    const toolCalls: AIToolCall[] = Array.isArray(response.content)\n      ? response.content\n          .filter((b: any) => b && b.type === 'tool_use')\n          .map((b: any) => ({\n            id: typeof b.id === 'string' && b.id ? b.id : `call_${Math.random().toString(36).slice(2, 12)}`,\n            name: b.name,\n            arguments: (b.input && typeof b.input === 'object' ? b.input : {}) as Record<string, any>\n          }))\n      : []\n\n    return {\n      text,\n      toolCalls,\n      stopReason: normalizeAnthropicStopReason(response.stop_reason)\n    }\n  }\n}\n\n// ── 변환 유틸 ─────────────────────────────────────────────────────────\n\nfunction extractTextContent(msg: AIMessage): string {\n  if (typeof msg.content === 'string') return msg.content\n  return msg.content\n    .filter(p => p.type === 'text')\n    .map(p => (p as { type: 'text'; text: string }).text)\n    .join('\\n')\n}\n\nfunction toAnthropicMessage(msg: AIMessage): any {\n  if (typeof msg.content === 'string') {\n    return { role: msg.role, content: msg.content }\n  }\n  return {\n    role: msg.role,\n    content: msg.content.map(toAnthropicContentBlock)\n  }\n}\n\nfunction toAnthropicContentBlock(part: AIContentPart): any {\n  if (part.type === 'text') {\n    return { type: 'text', text: part.text }\n  }\n  if (part.type === 'tool_use') {\n    return { type: 'tool_use', id: part.id, name: part.name, input: part.arguments }\n  }\n  if (part.type === 'tool_result') {\n    return {\n      type: 'tool_result',\n      tool_use_id: part.toolUseId,\n      content: part.content,\n      ...(part.isError && { is_error: true })\n    }\n  }\n  // image\n  if (part.source.kind === 'url') {\n    return { type: 'image', source: { type: 'url', url: part.source.url } }\n  }\n  const data = Buffer.isBuffer(part.source.data)\n    ? part.source.data.toString('base64')\n    : Buffer.from(part.source.data).toString('base64')\n  return {\n    type: 'image',\n    source: { type: 'base64', media_type: part.source.mediaType, data }\n  }\n}\n\nfunction extractResponseText(response: any): string {\n  if (!response || !Array.isArray(response.content)) return ''\n  return response.content\n    .filter((b: any) => b && b.type === 'text')\n    .map((b: any) => b.text || '')\n    .join('')\n}\n\nfunction buildAnthropicToolChoice(options: AIToolChatOptions): any | undefined {\n  const choice = options.toolChoice ?? 'auto'\n  const disableParallel = options.allowParallelToolCalls === false\n  if (choice === 'none') {\n    return { type: 'none' }\n  }\n  if (choice === 'required') {\n    if (options.forceTool) {\n      return {\n        type: 'tool',\n        name: options.forceTool,\n        ...(disableParallel && { disable_parallel_tool_use: true })\n      }\n    }\n    return {\n      type: 'any',\n      ...(disableParallel && { disable_parallel_tool_use: true })\n    }\n  }\n  // 'auto'\n  return {\n    type: 'auto',\n    ...(disableParallel && { disable_parallel_tool_use: true })\n  }\n}\n\nfunction normalizeAnthropicStopReason(raw: any): AIToolChatResult['stopReason'] {\n  switch (raw) {\n    case 'tool_use':\n      return 'tool_use'\n    case 'end_turn':\n      return 'end_turn'\n    case 'max_tokens':\n      return 'max_tokens'\n    case 'stop_sequence':\n      return 'stop_sequence'\n    default:\n      return raw ?? 'end_turn'\n  }\n}\n\n// Auto-register at module load\nregisterAIProvider('anthropic', config => new AnthropicAIClient(config))\n"]}

package/dist-server/service/providers/gemini.d.ts

@@ -0,0 +1,14 @@
+import type { AIChatOptions, AIClient, AIClientConfig, AIJSONOptions, AIMessage, AITool, AIToolChatOptions, AIToolChatResult, AIVisionOptions } from '../types.js';
+export declare class GeminiAIClient implements AIClient {
+    readonly id: string;
+    private sdk;
+    private defaultModel;
+    constructor(config: AIClientConfig);
+    chat(messages: AIMessage[], options?: AIChatOptions): Promise<string>;
+    generateJSON<T = unknown>(prompt: string | AIMessage[], options?: AIJSONOptions): Promise<T>;
+    vision(image: Buffer | Uint8Array | {
+        url: string;
+    }, prompt: string, options?: AIVisionOptions): Promise<string>;
+    private buildModel;
+    chatWithTools(messages: AIMessage[], tools: AITool[], options?: AIToolChatOptions): Promise<AIToolChatResult>;
+}