@nahisaho/katashiro-llm 2.0.0

package/dist/types.d.ts

@@ -0,0 +1,251 @@
+/**
+ * LLM Package Types
+ *
+ * @requirement REQ-LLM-001, REQ-LLM-005, REQ-LLM-006
+ * @design DES-KATASHIRO-003-LLM §3.1
+ */
+import type { ZodType, z } from 'zod';
+/**
+ * メッセージロール
+ */
+export type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+/**
+ * コンテンツパート（マルチモーダル対応）
+ */
+export type ContentPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image_url';
+    image_url: {
+        url: string;
+        detail?: 'auto' | 'low' | 'high';
+    };
+};
+/**
+ * ツール呼び出し
+ */
+export interface ToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/**
+ * ツール定義
+ */
+export interface ToolDefinition {
+    type: 'function';
+    function: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    };
+}
+/**
+ * メッセージ
+ */
+export interface Message {
+    role: MessageRole;
+    content: string | ContentPart[];
+    name?: string;
+    toolCallId?: string;
+    toolCalls?: ToolCall[];
+}
+/**
+ * ツール選択オプション
+ */
+export type ToolChoice = 'auto' | 'none' | 'required' | {
+    type: 'function';
+    function: {
+        name: string;
+    };
+};
+/**
+ * レスポンスフォーマット
+ */
+export interface ResponseFormat {
+    type: 'text' | 'json_object';
+}
+/**
+ * 生成リクエスト
+ */
+export interface GenerateRequest {
+    /** モデル名 */
+    model?: string;
+    /** メッセージ履歴 */
+    messages: Message[];
+    /** 温度パラメータ (0-2) */
+    temperature?: number;
+    /** 最大トークン数 */
+    maxTokens?: number;
+    /** Top-P サンプリング */
+    topP?: number;
+    /** 停止シーケンス */
+    stopSequences?: string[];
+    /** ツール定義 */
+    tools?: ToolDefinition[];
+    /** ツール選択 */
+    toolChoice?: ToolChoice;
+    /** レスポンスフォーマット */
+    responseFormat?: ResponseFormat;
+    /** ユーザーID（監査用） */
+    user?: string;
+}
+/**
+ * トークン使用量
+ */
+export interface TokenUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+/**
+ * 終了理由
+ */
+export type FinishReason = 'stop' | 'length' | 'tool_calls' | 'content_filter';
+/**
+ * 生成レスポンス
+ */
+export interface GenerateResponse {
+    /** レスポンスID */
+    id: string;
+    /** 使用モデル */
+    model: string;
+    /** 生成テキスト */
+    content: string;
+    /** ツール呼び出し */
+    toolCalls?: ToolCall[];
+    /** トークン使用量 */
+    usage: TokenUsage;
+    /** 終了理由 */
+    finishReason: FinishReason;
+    /** メタデータ */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * ストリームチャンク
+ */
+export interface StreamChunk {
+    type: 'content' | 'tool_call' | 'usage' | 'done';
+    content?: string;
+    toolCall?: Partial<ToolCall>;
+    usage?: TokenUsage;
+}
+/**
+ * LLMプロバイダーインターフェース
+ */
+export interface LLMProvider {
+    /** プロバイダー名 */
+    readonly name: string;
+    /** サポートモデル */
+    readonly supportedModels: string[];
+    /**
+     * テキスト生成
+     */
+    generate(request: GenerateRequest): Promise<GenerateResponse>;
+    /**
+     * ストリーミング生成
+     */
+    generateStream(request: GenerateRequest): AsyncGenerator<StreamChunk>;
+    /**
+     * 構造化出力生成
+     */
+    generateStructured<T extends ZodType>(request: GenerateRequest, schema: T): Promise<z.infer<T>>;
+    /**
+     * トークン数カウント
+     */
+    countTokens(text: string, model?: string): Promise<number>;
+}
+/**
+ * プロバイダー設定
+ */
+export interface ProviderConfig {
+    /** APIキー */
+    apiKey?: string;
+    /** ベースURL */
+    baseURL?: string;
+    /** デフォルトモデル */
+    defaultModel?: string;
+    /** タイムアウト（ミリ秒） */
+    timeout?: number;
+    /** 最大リトライ回数 */
+    maxRetries?: number;
+}
+/**
+ * LLMクライアント設定
+ */
+export interface LLMClientConfig {
+    /** プライマリプロバイダー */
+    provider: LLMProvider;
+    /** フォールバックプロバイダー */
+    fallbackProviders?: LLMProvider[];
+    /** セマンティックキャッシュ有効化 */
+    enableCache?: boolean;
+    /** キャッシュTTL（ミリ秒） */
+    cacheTTL?: number;
+    /** 自動リトライ有効化 */
+    enableRetry?: boolean;
+    /** リトライ回数 */
+    retryCount?: number;
+    /** リトライ遅延（ミリ秒） */
+    retryDelay?: number;
+}
+/**
+ * プロンプトテンプレート
+ */
+export interface PromptTemplate {
+    /** テンプレートID */
+    id: string;
+    /** テンプレート名 */
+    name: string;
+    /** テンプレート内容 */
+    template: string;
+    /** 変数定義 */
+    variables: Array<{
+        name: string;
+        type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+        required?: boolean;
+        default?: unknown;
+        description?: string;
+    }>;
+    /** 説明 */
+    description?: string;
+    /** メタデータ */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * キャッシュエントリ
+ */
+export interface CacheEntry<T = GenerateResponse> {
+    /** キー（ハッシュ） */
+    key: string;
+    /** 値 */
+    value: T;
+    /** 作成日時 */
+    createdAt: Date;
+    /** 有効期限 */
+    expiresAt: Date;
+    /** ヒット数 */
+    hits: number;
+    /** 類似度スコア（セマンティックキャッシュ用） */
+    similarity?: number;
+}
+/**
+ * フォールバック結果
+ */
+export interface FallbackResult {
+    /** 成功プロバイダー */
+    provider: string;
+    /** 試行プロバイダー */
+    attemptedProviders: string[];
+    /** エラー履歴 */
+    errors: Array<{
+        provider: string;
+        error: Error;
+        timestamp: Date;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * LLM Package Types
+ *
+ * @requirement REQ-LLM-001, REQ-LLM-005, REQ-LLM-006
+ * @design DES-KATASHIRO-003-LLM §3.1
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@nahisaho/katashiro-llm",
+  "version": "2.0.0",
+  "description": "LLM Provider abstraction for KATASHIRO",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "zod": "^3.23.8",
+    "@nahisaho/katashiro-core": "2.0.0",
+    "@nahisaho/katashiro-observability": "2.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.3",
+    "vitest": "^3.0.0",
+    "@types/node": "^22.10.0"
+  },
+  "peerDependencies": {
+    "openai": "^4.0.0",
+    "@anthropic-ai/sdk": "^0.30.0"
+  },
+  "peerDependenciesMeta": {
+    "openai": {
+      "optional": true
+    },
+    "@anthropic-ai/sdk": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "nahisaho",
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  }
+}

package/src/LLMClient.ts

@@ -0,0 +1,171 @@
+/**
+ * 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 class LLMClient {
+  private primaryProvider: LLMProvider;
+  private fallbackProviders: LLMProvider[];
+  private retryCount: number;
+  private retryDelay: number;
+
+  constructor(config: LLMClientConfig) {
+    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: GenerateRequest): Promise<GenerateResponse & { _fallback?: FallbackResult }> {
+    const providers = [this.primaryProvider, ...this.fallbackProviders];
+    const errors: FallbackResult['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 as 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: GenerateRequest): AsyncGenerator<StreamChunk> {
+    const providers = [this.primaryProvider, ...this.fallbackProviders];
+    const errors: Error[] = [];
+
+    for (const provider of providers) {
+      try {
+        yield* provider.generateStream(request);
+        return;
+      } catch (error) {
+        errors.push(error as Error);
+      }
+    }
+
+    throw new AggregateError(errors, 'All LLM providers failed for streaming');
+  }
+
+  /**
+   * 構造化出力生成
+   */
+  async generateStructured<T extends ZodType>(
+    request: GenerateRequest,
+    schema: T
+  ): Promise<z.infer<T>> {
+    return this.primaryProvider.generateStructured(request, schema);
+  }
+
+  /**
+   * トークン数カウント
+   */
+  async countTokens(text: string, model?: string): Promise<number> {
+    return this.primaryProvider.countTokens(text, model);
+  }
+
+  /**
+   * プライマリプロバイダー取得
+   */
+  getProvider(): LLMProvider {
+    return this.primaryProvider;
+  }
+
+  /**
+   * プロバイダー一覧取得
+   */
+  getProviders(): LLMProvider[] {
+    return [this.primaryProvider, ...this.fallbackProviders];
+  }
+
+  /**
+   * リトライラッパー
+   */
+  private async withRetry<T>(fn: () => Promise<T>): Promise<T> {
+    let lastError: Error | undefined;
+
+    for (let attempt = 0; attempt <= this.retryCount; attempt++) {
+      try {
+        return await fn();
+      } catch (error) {
+        lastError = error as Error;
+        if (attempt < this.retryCount) {
+          await this.sleep(this.retryDelay * Math.pow(2, attempt));
+        }
+      }
+    }
+
+    throw lastError;
+  }
+
+  private sleep(ms: number): Promise<void> {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+}
+
+// シングルトン管理
+let defaultClient: LLMClient | null = null;
+
+/**
+ * デフォルトLLMクライアント取得
+ */
+export function getLLMClient(): LLMClient {
+  if (!defaultClient) {
+    throw new Error('LLM client not initialized. Call initLLMClient() first.');
+  }
+  return defaultClient;
+}
+
+/**
+ * LLMクライアント初期化
+ */
+export function initLLMClient(config: LLMClientConfig): LLMClient {
+  defaultClient = new LLMClient(config);
+  return defaultClient;
+}
+
+/**
+ * LLMクライアントリセット（テスト用）
+ */
+export function resetLLMClient(): void {
+  defaultClient = null;
+}

package/src/PromptManager.ts

@@ -0,0 +1,156 @@
+/**
+ * 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 class PromptManager {
+  private templates: Map<string, PromptTemplate> = new Map();
+
+  /**
+   * テンプレート登録
+   */
+  register(template: PromptTemplate): void {
+    this.templates.set(template.id, template);
+  }
+
+  /**
+   * テンプレート取得
+   */
+  get(id: string): PromptTemplate | undefined {
+    return this.templates.get(id);
+  }
+
+  /**
+   * テンプレート一覧取得
+   */
+  list(): PromptTemplate[] {
+    return Array.from(this.templates.values());
+  }
+
+  /**
+   * テンプレート削除
+   */
+  unregister(id: string): boolean {
+    return this.templates.delete(id);
+  }
+
+  /**
+   * テンプレートをレンダリング
+   */
+  render(id: string, variables: TemplateVariables = {}): string {
+    const template = this.templates.get(id);
+    if (!template) {
+      throw new Error(`Template not found: ${id}`);
+    }
+
+    return this.renderTemplate(template, variables);
+  }
+
+  /**
+   * テンプレートをメッセージとしてレンダリング
+   */
+  renderAsMessage(
+    id: string,
+    variables: TemplateVariables = {},
+    role: Message['role'] = 'user'
+  ): Message {
+    const content = this.render(id, variables);
+    return { role, content };
+  }
+
+  /**
+   * 複数テンプレートをチェーン
+   */
+  chain(
+    templateIds: string[],
+    variables: TemplateVariables = {},
+    separator = '\n\n'
+  ): string {
+    return templateIds
+      .map((id) => this.render(id, variables))
+      .join(separator);
+  }
+
+  /**
+   * テンプレート文字列をレンダリング（直接）
+   */
+  renderString(template: string, variables: TemplateVariables = {}): string {
+    return template.replace(/\{\{(\w+)\}\}/g, (_, key) => {
+      const value = variables[key];
+      if (value === undefined) {
+        return `{{${key}}}`;
+      }
+      return String(value);
+    });
+  }
+
+  /**
+   * テンプレートをレンダリング（内部）
+   */
+  private renderTemplate(
+    template: PromptTemplate,
+    variables: TemplateVariables
+  ): string {
+    // 必須変数のチェック
+    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(): void {
+    this.templates.clear();
+  }
+}
+
+// シングルトン
+let promptManagerInstance: PromptManager | null = null;
+
+/**
+ * PromptManager シングルトン取得
+ */
+export function getPromptManager(): PromptManager {
+  if (!promptManagerInstance) {
+    promptManagerInstance = new PromptManager();
+  }
+  return promptManagerInstance;
+}
+
+/**
+ * PromptManager リセット（テスト用）
+ */
+export function resetPromptManager(): void {
+  promptManagerInstance = null;
+}