@nahisaho/katashiro-llm 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nahisaho
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/LLMClient.d.ts

@@ -0,0 +1,64 @@
+/**
+ * LLM Client - マルチプロバイダーファサード
+ *
+ * @requirement REQ-LLM-001, REQ-LLM-004
+ * @design DES-KATASHIRO-003-LLM §3.4
+ */
+import type { ZodType, z } from 'zod';
+import type { LLMProvider, LLMClientConfig, GenerateRequest, GenerateResponse, StreamChunk, FallbackResult } from './types.js';
+/**
+ * LLMクライアント
+ *
+ * フォールバック機能とリトライ機能を提供するファサードクラス
+ */
+export declare class LLMClient {
+    private primaryProvider;
+    private fallbackProviders;
+    private retryCount;
+    private retryDelay;
+    constructor(config: LLMClientConfig);
+    /**
+     * テキスト生成（フォールバック対応）
+     */
+    generate(request: GenerateRequest): Promise<GenerateResponse & {
+        _fallback?: FallbackResult;
+    }>;
+    /**
+     * ストリーミング生成
+     */
+    generateStream(request: GenerateRequest): AsyncGenerator<StreamChunk>;
+    /**
+     * 構造化出力生成
+     */
+    generateStructured<T extends ZodType>(request: GenerateRequest, schema: T): Promise<z.infer<T>>;
+    /**
+     * トークン数カウント
+     */
+    countTokens(text: string, model?: string): Promise<number>;
+    /**
+     * プライマリプロバイダー取得
+     */
+    getProvider(): LLMProvider;
+    /**
+     * プロバイダー一覧取得
+     */
+    getProviders(): LLMProvider[];
+    /**
+     * リトライラッパー
+     */
+    private withRetry;
+    private sleep;
+}
+/**
+ * デフォルトLLMクライアント取得
+ */
+export declare function getLLMClient(): LLMClient;
+/**
+ * LLMクライアント初期化
+ */
+export declare function initLLMClient(config: LLMClientConfig): LLMClient;
+/**
+ * LLMクライアントリセット（テスト用）
+ */
+export declare function resetLLMClient(): void;
+//# sourceMappingURL=LLMClient.d.ts.map

package/dist/LLMClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMClient.d.ts","sourceRoot":"","sources":["../src/LLMClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACtC,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,eAAe;IAOnC;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,GAAG;QAAE,SAAS,CAAC,EAAE,cAAc,CAAA;KAAE,CAAC;IA+BpG;;OAEG;IACI,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,cAAc,CAAC,WAAW,CAAC;IAgB5E;;OAEG;IACG,kBAAkB,CAAC,CAAC,SAAS,OAAO,EACxC,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,CAAC,GACR,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAItB;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhE;;OAEG;IACH,WAAW,IAAI,WAAW;IAI1B;;OAEG;IACH,YAAY,IAAI,WAAW,EAAE;IAI7B;;OAEG;YACW,SAAS;IAiBvB,OAAO,CAAC,KAAK;CAGd;AAKD;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAKxC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAGhE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/dist/LLMClient.js

@@ -0,0 +1,139 @@
+/**
+ * LLM Client - マルチプロバイダーファサード
+ *
+ * @requirement REQ-LLM-001, REQ-LLM-004
+ * @design DES-KATASHIRO-003-LLM §3.4
+ */
+/**
+ * LLMクライアント
+ *
+ * フォールバック機能とリトライ機能を提供するファサードクラス
+ */
+export class LLMClient {
+    primaryProvider;
+    fallbackProviders;
+    retryCount;
+    retryDelay;
+    constructor(config) {
+        this.primaryProvider = config.provider;
+        this.fallbackProviders = config.fallbackProviders ?? [];
+        this.retryCount = config.enableRetry !== false ? (config.retryCount ?? 3) : 0;
+        this.retryDelay = config.retryDelay ?? 1000;
+    }
+    /**
+     * テキスト生成（フォールバック対応）
+     */
+    async generate(request) {
+        const providers = [this.primaryProvider, ...this.fallbackProviders];
+        const errors = [];
+        for (const provider of providers) {
+            try {
+                const response = await this.withRetry(() => provider.generate(request));
+                return {
+                    ...response,
+                    _fallback: errors.length > 0 ? {
+                        provider: provider.name,
+                        attemptedProviders: errors.map((e) => e.provider),
+                        errors,
+                    } : undefined,
+                };
+            }
+            catch (error) {
+                errors.push({
+                    provider: provider.name,
+                    error: error,
+                    timestamp: new Date(),
+                });
+            }
+        }
+        // すべてのプロバイダーが失敗
+        throw new AggregateError(errors.map((e) => e.error), `All LLM providers failed: ${errors.map((e) => e.provider).join(', ')}`);
+    }
+    /**
+     * ストリーミング生成
+     */
+    async *generateStream(request) {
+        const providers = [this.primaryProvider, ...this.fallbackProviders];
+        const errors = [];
+        for (const provider of providers) {
+            try {
+                yield* provider.generateStream(request);
+                return;
+            }
+            catch (error) {
+                errors.push(error);
+            }
+        }
+        throw new AggregateError(errors, 'All LLM providers failed for streaming');
+    }
+    /**
+     * 構造化出力生成
+     */
+    async generateStructured(request, schema) {
+        return this.primaryProvider.generateStructured(request, schema);
+    }
+    /**
+     * トークン数カウント
+     */
+    async countTokens(text, model) {
+        return this.primaryProvider.countTokens(text, model);
+    }
+    /**
+     * プライマリプロバイダー取得
+     */
+    getProvider() {
+        return this.primaryProvider;
+    }
+    /**
+     * プロバイダー一覧取得
+     */
+    getProviders() {
+        return [this.primaryProvider, ...this.fallbackProviders];
+    }
+    /**
+     * リトライラッパー
+     */
+    async withRetry(fn) {
+        let lastError;
+        for (let attempt = 0; attempt <= this.retryCount; attempt++) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt < this.retryCount) {
+                    await this.sleep(this.retryDelay * Math.pow(2, attempt));
+                }
+            }
+        }
+        throw lastError;
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+// シングルトン管理
+let defaultClient = null;
+/**
+ * デフォルトLLMクライアント取得
+ */
+export function getLLMClient() {
+    if (!defaultClient) {
+        throw new Error('LLM client not initialized. Call initLLMClient() first.');
+    }
+    return defaultClient;
+}
+/**
+ * LLMクライアント初期化
+ */
+export function initLLMClient(config) {
+    defaultClient = new LLMClient(config);
+    return defaultClient;
+}
+/**
+ * LLMクライアントリセット（テスト用）
+ */
+export function resetLLMClient() {
+    defaultClient = null;
+}
+//# sourceMappingURL=LLMClient.js.map

package/dist/LLMClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LLMClient.js","sourceRoot":"","sources":["../src/LLMClient.ts"],"names":[],"mappings":"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"}

package/dist/PromptManager.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Prompt Manager - プロンプトテンプレート管理
+ *
+ * @requirement REQ-LLM-002
+ * @design DES-KATASHIRO-003-LLM §3.2
+ */
+import type { PromptTemplate, Message } from './types.js';
+/**
+ * テンプレート変数
+ */
+export type TemplateVariables = Record<string, unknown>;
+/**
+ * PromptManager - プロンプトテンプレート管理
+ */
+export declare class PromptManager {
+    private templates;
+    /**
+     * テンプレート登録
+     */
+    register(template: PromptTemplate): void;
+    /**
+     * テンプレート取得
+     */
+    get(id: string): PromptTemplate | undefined;
+    /**
+     * テンプレート一覧取得
+     */
+    list(): PromptTemplate[];
+    /**
+     * テンプレート削除
+     */
+    unregister(id: string): boolean;
+    /**
+     * テンプレートをレンダリング
+     */
+    render(id: string, variables?: TemplateVariables): string;
+    /**
+     * テンプレートをメッセージとしてレンダリング
+     */
+    renderAsMessage(id: string, variables?: TemplateVariables, role?: Message['role']): Message;
+    /**
+     * 複数テンプレートをチェーン
+     */
+    chain(templateIds: string[], variables?: TemplateVariables, separator?: string): string;
+    /**
+     * テンプレート文字列をレンダリング（直接）
+     */
+    renderString(template: string, variables?: TemplateVariables): string;
+    /**
+     * テンプレートをレンダリング（内部）
+     */
+    private renderTemplate;
+    /**
+     * クリア
+     */
+    clear(): void;
+}
+/**
+ * PromptManager シングルトン取得
+ */
+export declare function getPromptManager(): PromptManager;
+/**
+ * PromptManager リセット（テスト用）
+ */
+export declare function resetPromptManager(): void;
+//# sourceMappingURL=PromptManager.d.ts.map

package/dist/PromptManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptManager.d.ts","sourceRoot":"","sources":["../src/PromptManager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAA0C;IAE3D;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;IAIxC;;OAEG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI3C;;OAEG;IACH,IAAI,IAAI,cAAc,EAAE;IAIxB;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,GAAE,iBAAsB,GAAG,MAAM;IAS7D;;OAEG;IACH,eAAe,CACb,EAAE,EAAE,MAAM,EACV,SAAS,GAAE,iBAAsB,EACjC,IAAI,GAAE,OAAO,CAAC,MAAM,CAAU,GAC7B,OAAO;IAKV;;OAEG;IACH,KAAK,CACH,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,GAAE,iBAAsB,EACjC,SAAS,SAAS,GACjB,MAAM;IAMT;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,iBAAsB,GAAG,MAAM;IAUzE;;OAEG;IACH,OAAO,CAAC,cAAc;IA4BtB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAKD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/PromptManager.js

@@ -0,0 +1,121 @@
+/**
+ * Prompt Manager - プロンプトテンプレート管理
+ *
+ * @requirement REQ-LLM-002
+ * @design DES-KATASHIRO-003-LLM §3.2
+ */
+/**
+ * PromptManager - プロンプトテンプレート管理
+ */
+export class PromptManager {
+    templates = new Map();
+    /**
+     * テンプレート登録
+     */
+    register(template) {
+        this.templates.set(template.id, template);
+    }
+    /**
+     * テンプレート取得
+     */
+    get(id) {
+        return this.templates.get(id);
+    }
+    /**
+     * テンプレート一覧取得
+     */
+    list() {
+        return Array.from(this.templates.values());
+    }
+    /**
+     * テンプレート削除
+     */
+    unregister(id) {
+        return this.templates.delete(id);
+    }
+    /**
+     * テンプレートをレンダリング
+     */
+    render(id, variables = {}) {
+        const template = this.templates.get(id);
+        if (!template) {
+            throw new Error(`Template not found: ${id}`);
+        }
+        return this.renderTemplate(template, variables);
+    }
+    /**
+     * テンプレートをメッセージとしてレンダリング
+     */
+    renderAsMessage(id, variables = {}, role = 'user') {
+        const content = this.render(id, variables);
+        return { role, content };
+    }
+    /**
+     * 複数テンプレートをチェーン
+     */
+    chain(templateIds, variables = {}, separator = '\n\n') {
+        return templateIds
+            .map((id) => this.render(id, variables))
+            .join(separator);
+    }
+    /**
+     * テンプレート文字列をレンダリング（直接）
+     */
+    renderString(template, variables = {}) {
+        return template.replace(/\{\{(\w+)\}\}/g, (_, key) => {
+            const value = variables[key];
+            if (value === undefined) {
+                return `{{${key}}}`;
+            }
+            return String(value);
+        });
+    }
+    /**
+     * テンプレートをレンダリング（内部）
+     */
+    renderTemplate(template, variables) {
+        // 必須変数のチェック
+        for (const varDef of template.variables) {
+            if (varDef.required && variables[varDef.name] === undefined) {
+                if (varDef.default !== undefined) {
+                    variables[varDef.name] = varDef.default;
+                }
+                else {
+                    throw new Error(`Missing required variable: ${varDef.name} for template: ${template.id}`);
+                }
+            }
+        }
+        // デフォルト値の適用
+        for (const varDef of template.variables) {
+            if (variables[varDef.name] === undefined && varDef.default !== undefined) {
+                variables[varDef.name] = varDef.default;
+            }
+        }
+        // テンプレートのレンダリング
+        return this.renderString(template.template, variables);
+    }
+    /**
+     * クリア
+     */
+    clear() {
+        this.templates.clear();
+    }
+}
+// シングルトン
+let promptManagerInstance = null;
+/**
+ * PromptManager シングルトン取得
+ */
+export function getPromptManager() {
+    if (!promptManagerInstance) {
+        promptManagerInstance = new PromptManager();
+    }
+    return promptManagerInstance;
+}
+/**
+ * PromptManager リセット（テスト用）
+ */
+export function resetPromptManager() {
+    promptManagerInstance = null;
+}
+//# sourceMappingURL=PromptManager.js.map

package/dist/PromptManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PromptManager.js","sourceRoot":"","sources":["../src/PromptManager.ts"],"names":[],"mappings":"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"}

package/dist/TokenCounter.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Token Counter - トークン数カウント
+ *
+ * @requirement REQ-LLM-001
+ * @design DES-KATASHIRO-003-LLM §3.1
+ */
+/**
+ * TokenCounter - トークン数カウントユーティリティ
+ */
+export declare class TokenCounter {
+    /**
+     * テキストのトークン数を推定
+     */
+    estimate(text: string, model?: string): number;
+    /**
+     * メッセージ配列のトークン数を推定
+     */
+    estimateMessages(messages: Array<{
+        role: string;
+        content: string;
+    }>, model?: string): number;
+    /**
+     * トークン数が制限内か確認
+     */
+    isWithinLimit(text: string, limit: number, model?: string): boolean;
+    /**
+     * 制限内に収まるようにテキストを切り詰め
+     */
+    truncateToLimit(text: string, limit: number, model?: string): string;
+    /**
+     * モデル別トークン係数取得
+     */
+    private getTokenFactor;
+}
+/**
+ * TokenCounter シングルトン取得
+ */
+export declare function getTokenCounter(): TokenCounter;
+/**
+ * TokenCounter リセット（テスト用）
+ */
+export declare function resetTokenCounter(): void;
+//# sourceMappingURL=TokenCounter.d.ts.map

package/dist/TokenCounter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenCounter.d.ts","sourceRoot":"","sources":["../src/TokenCounter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH;;GAEG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAK9C;;OAEG;IACH,gBAAgB,CACd,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAClD,KAAK,CAAC,EAAE,MAAM,GACb,MAAM;IAYT;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO;IAInE;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAWpE;;OAEG;IACH,OAAO,CAAC,cAAc;CAcvB;AAKD;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAK9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/TokenCounter.js

@@ -0,0 +1,100 @@
+/**
+ * Token Counter - トークン数カウント
+ *
+ * @requirement REQ-LLM-001
+ * @design DES-KATASHIRO-003-LLM §3.1
+ */
+/**
+ * モデル別トークン推定係数
+ */
+const MODEL_TOKEN_FACTORS = {
+    'gpt-4o': 4.0,
+    'gpt-4o-mini': 4.0,
+    'gpt-4-turbo': 4.0,
+    'gpt-4': 4.0,
+    'gpt-3.5-turbo': 4.0,
+    'claude-3-5-sonnet': 4.5,
+    'claude-3-opus': 4.5,
+    'claude-3-sonnet': 4.5,
+    'claude-3-haiku': 4.5,
+    'gemini-pro': 4.0,
+    'gemini-1.5-pro': 4.0,
+    default: 4.0,
+};
+/**
+ * TokenCounter - トークン数カウントユーティリティ
+ */
+export class TokenCounter {
+    /**
+     * テキストのトークン数を推定
+     */
+    estimate(text, model) {
+        const factor = this.getTokenFactor(model);
+        return Math.ceil(text.length / factor);
+    }
+    /**
+     * メッセージ配列のトークン数を推定
+     */
+    estimateMessages(messages, model) {
+        let total = 0;
+        for (const message of messages) {
+            // ロールのオーバーヘッド（約4トークン）
+            total += 4;
+            total += this.estimate(message.content, model);
+        }
+        // メッセージ区切りのオーバーヘッド
+        total += 3;
+        return total;
+    }
+    /**
+     * トークン数が制限内か確認
+     */
+    isWithinLimit(text, limit, model) {
+        return this.estimate(text, model) <= limit;
+    }
+    /**
+     * 制限内に収まるようにテキストを切り詰め
+     */
+    truncateToLimit(text, limit, model) {
+        const currentTokens = this.estimate(text, model);
+        if (currentTokens <= limit) {
+            return text;
+        }
+        const factor = this.getTokenFactor(model);
+        const targetLength = Math.floor(limit * factor * 0.9); // 10%マージン
+        return text.slice(0, targetLength) + '...';
+    }
+    /**
+     * モデル別トークン係数取得
+     */
+    getTokenFactor(model) {
+        if (!model) {
+            return MODEL_TOKEN_FACTORS.default ?? 4.0;
+        }
+        // モデル名の部分一致
+        for (const [key, factor] of Object.entries(MODEL_TOKEN_FACTORS)) {
+            if (model.includes(key)) {
+                return factor;
+            }
+        }
+        return MODEL_TOKEN_FACTORS.default ?? 4.0;
+    }
+}
+// シングルトン
+let tokenCounterInstance = null;
+/**
+ * TokenCounter シングルトン取得
+ */
+export function getTokenCounter() {
+    if (!tokenCounterInstance) {
+        tokenCounterInstance = new TokenCounter();
+    }
+    return tokenCounterInstance;
+}
+/**
+ * TokenCounter リセット（テスト用）
+ */
+export function resetTokenCounter() {
+    tokenCounterInstance = null;
+}
+//# sourceMappingURL=TokenCounter.js.map

package/dist/TokenCounter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TokenCounter.js","sourceRoot":"","sources":["../src/TokenCounter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,mBAAmB,GAA2B;IAClD,QAAQ,EAAE,GAAG;IACb,aAAa,EAAE,GAAG;IAClB,aAAa,EAAE,GAAG;IAClB,OAAO,EAAE,GAAG;IACZ,eAAe,EAAE,GAAG;IACpB,mBAAmB,EAAE,GAAG;IACxB,eAAe,EAAE,GAAG;IACpB,iBAAiB,EAAE,GAAG;IACtB,gBAAgB,EAAE,GAAG;IACrB,YAAY,EAAE,GAAG;IACjB,gBAAgB,EAAE,GAAG;IACrB,OAAO,EAAE,GAAG;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,OAAO,YAAY;IACvB;;OAEG;IACH,QAAQ,CAAC,IAAY,EAAE,KAAc;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,gBAAgB,CACd,QAAkD,EAClD,KAAc;QAEd,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,sBAAsB;YACtB,KAAK,IAAI,CAAC,CAAC;YACX,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjD,CAAC;QACD,mBAAmB;QACnB,KAAK,IAAI,CAAC,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,IAAY,EAAE,KAAa,EAAE,KAAc;QACvD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,KAAK,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,IAAY,EAAE,KAAa,EAAE,KAAc;QACzD,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACjD,IAAI,aAAa,IAAI,KAAK,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU;QACjE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,GAAG,KAAK,CAAC;IAC7C,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,KAAc;QACnC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,mBAAmB,CAAC,OAAO,IAAI,GAAG,CAAC;QAC5C,CAAC;QAED,YAAY;QACZ,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAChE,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,OAAO,MAAM,CAAC;YAChB,CAAC;QACH,CAAC;QAED,OAAO,mBAAmB,CAAC,OAAO,IAAI,GAAG,CAAC;IAC5C,CAAC;CACF;AAED,SAAS;AACT,IAAI,oBAAoB,GAAwB,IAAI,CAAC;AAErD;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC1B,oBAAoB,GAAG,IAAI,YAAY,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,oBAAoB,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,oBAAoB,GAAG,IAAI,CAAC;AAC9B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * LLM Package - Main Entry Point
+ *
+ * @requirement REQ-LLM-001〜006
+ * @design DES-KATASHIRO-003-LLM
+ */
+export * from './types.js';
+export * from './providers/index.js';
+export { LLMClient, getLLMClient, initLLMClient, resetLLMClient, } from './LLMClient.js';
+export { PromptManager, getPromptManager, resetPromptManager, type TemplateVariables, } from './PromptManager.js';
+export { TokenCounter, getTokenCounter, resetTokenCounter, } from './TokenCounter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,YAAY,CAAC;AAG3B,cAAc,sBAAsB,CAAC;AAGrC,OAAO,EACL,SAAS,EACT,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * LLM Package - Main Entry Point
+ *
+ * @requirement REQ-LLM-001〜006
+ * @design DES-KATASHIRO-003-LLM
+ */
+// Types
+export * from './types.js';
+// Providers
+export * from './providers/index.js';
+// Client
+export { LLMClient, getLLMClient, initLLMClient, resetLLMClient, } from './LLMClient.js';
+// Prompt Manager
+export { PromptManager, getPromptManager, resetPromptManager, } from './PromptManager.js';
+// Token Counter
+export { TokenCounter, getTokenCounter, resetTokenCounter, } from './TokenCounter.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,YAAY;AACZ,cAAc,sBAAsB,CAAC;AAErC,SAAS;AACT,OAAO,EACL,SAAS,EACT,YAAY,EACZ,aAAa,EACb,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,iBAAiB;AACjB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,kBAAkB,GAEnB,MAAM,oBAAoB,CAAC;AAE5B,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,eAAe,EACf,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}