botrun-horse 2.29.2 → 2.31.0

package/botrun-c/prototypes/firestore-gax-debug/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "firestore-gax-debug",
+  "version": "1.0.0",
+  "description": "Debug google-gax compatibility issue with Firestore",
+  "type": "module",
+  "scripts": {
+    "test": "node test.js"
+  },
+  "dependencies": {
+    "@google-cloud/firestore": "^7.10.0"
+  }
+}

package/botrun-c/prototypes/firestore-gax-debug/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+packages:
+  - '.'

package/botrun-c/prototypes/firestore-gax-debug/test.js

@@ -0,0 +1,98 @@
+/**
+ * Firestore + google-gax 相容性測試
+ *
+ * 目標：找出能正常運作的套件版本組合
+ *
+ * 錯誤訊息：
+ * Error [ERR_PACKAGE_PATH_NOT_EXPORTED]: Package subpath './build/src/fallback'
+ * is not defined by "exports" in google-gax/package.json
+ */
+
+import { Firestore, FieldValue } from '@google-cloud/firestore';
+
+async function testFirestore() {
+  console.log('🔍 開始測試 Firestore 寫入...\n');
+
+  try {
+    // 初始化 Firestore
+    const db = new Firestore({
+      projectId: 'botrun-c',
+      ignoreUndefinedProperties: true,
+    });
+
+    console.log('✅ Firestore 初始化成功');
+    console.log(`   projectId: botrun-c\n`);
+
+    // 測試文件路徑
+    const testDocRef = db.collection('test_counters').doc('test-key-001');
+
+    // 測試 1: 基本寫入
+    console.log('📝 測試 1: 基本寫入 (set)...');
+    await testDocRef.set({
+      count: 1,
+      createdAt: FieldValue.serverTimestamp(),
+      message: 'Test from firestore-gax-debug',
+    });
+    console.log('✅ 基本寫入成功\n');
+
+    // 測試 2: 原子遞增 (這裡最容易出錯)
+    console.log('📝 測試 2: 原子遞增 (FieldValue.increment)...');
+    await testDocRef.set(
+      {
+        count: FieldValue.increment(1),
+        updatedAt: FieldValue.serverTimestamp(),
+      },
+      { merge: true }
+    );
+    console.log('✅ 原子遞增成功\n');
+
+    // 測試 3: 讀取資料
+    console.log('📝 測試 3: 讀取資料...');
+    const doc = await testDocRef.get();
+    const data = doc.data();
+    console.log('✅ 讀取成功');
+    console.log(`   count: ${data?.count}`);
+    console.log(`   message: ${data?.message}\n`);
+
+    // 測試 4: 更新
+    console.log('📝 測試 4: 更新 (update)...');
+    await testDocRef.update({
+      count: FieldValue.increment(1),
+      lastTest: new Date().toISOString(),
+    });
+    console.log('✅ 更新成功\n');
+
+    // 測試 5: 最終讀取
+    console.log('📝 測試 5: 最終讀取...');
+    const finalDoc = await testDocRef.get();
+    const finalData = finalDoc.data();
+    console.log('✅ 最終讀取成功');
+    console.log(`   final count: ${finalData?.count}`);
+    console.log(`   lastTest: ${finalData?.lastTest}\n`);
+
+    // 清理測試資料
+    console.log('🧹 清理測試資料...');
+    await testDocRef.delete();
+    console.log('✅ 清理完成\n');
+
+    console.log('🎉 所有測試通過！');
+    console.log('✅ Firestore + google-gax 相容性正常\n');
+
+  } catch (error) {
+    console.error('❌ 測試失敗！\n');
+    console.error('錯誤類型:', error.constructor.name);
+    console.error('錯誤訊息:', error.message);
+    console.error('錯誤堆疊:', error.stack);
+
+    // 特別檢查是否為 google-gax 問題
+    if (error.message.includes('google-gax') || error.message.includes('ERR_PACKAGE_PATH_NOT_EXPORTED')) {
+      console.error('\n⚠️  這是 google-gax 套件相容性問題！');
+      console.error('   建議：嘗試降級 @google-cloud/firestore 版本');
+    }
+
+    process.exit(1);
+  }
+}
+
+// 執行測試
+testFirestore();

package/botrun-c/prototypes/taiwan-haiku/README.md

@@ -0,0 +1,93 @@
+# Taiwan Haiku Prototype
+
+測試 Claude Agent SDK 與台灣 Vertex AI 端點（asia-east1）整合
+
+## 目標
+
+驗證 Claude Agent SDK 可以透過台灣 Vertex AI 端點使用 Haiku 4.5 模型。
+
+## 設定步驟
+
+### 1. 安裝依賴
+
+```bash
+cd prototypes/taiwan-haiku
+pnpm install
+```
+
+### 2. 設定環境變數
+
+複製 `.env.example` 到 `.env`：
+
+```bash
+cp .env.example .env
+```
+
+編輯 `.env` 檔案：
+
+```env
+# Google Cloud 專案 ID
+GOOGLE_CLOUD_PROJECT=your-project-id
+
+# Vertex AI 區域（台灣）
+VERTEX_AI_REGION=asia-east1
+CLOUD_ML_REGION=asia-east1
+
+# 啟用 Vertex AI
+CLAUDE_CODE_USE_VERTEX=1
+
+# 如果需要指定 service account（可選）
+# GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json
+```
+
+### 3. 驗證 Google Cloud 認證
+
+```bash
+gcloud auth application-default login
+```
+
+或使用 service account：
+
+```bash
+export GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account-key.json
+```
+
+### 4. 執行測試
+
+```bash
+pnpm dev
+```
+
+## 預期結果
+
+如果配置正確，應該會看到：
+
+1. ✅ 環境配置資訊
+2. ✅ Claude Agent SDK 成功啟動
+3. ✅ 收到 Haiku 4.5 的回應（繁體中文）
+4. ✅ 測試摘要（事件數、回應長度、執行時間等）
+
+## 重要資訊
+
+- **模型名稱**：`claude-haiku-4-5@20251001`
+- **台灣區域**：`asia-east1`
+- **認證方式**：Google Cloud Application Default Credentials
+
+## 故障排除
+
+### 錯誤：Model not found
+
+- 確認專案有啟用 Vertex AI API
+- 確認區域支援 Haiku 4.5（asia-east1 應該支援）
+- 檢查模型名稱是否正確
+
+### 錯誤：Authentication failed
+
+- 執行 `gcloud auth application-default login`
+- 或設定正確的 `GOOGLE_APPLICATION_CREDENTIALS`
+
+### 錯誤：API not enabled
+
+```bash
+gcloud services enable aiplatform.googleapis.com
+```

package/botrun-c/prototypes/taiwan-haiku/index.ts

@@ -0,0 +1,139 @@
+/**
+ * Taiwan Haiku Prototype
+ * 測試 Claude Agent SDK 與台灣 Vertex AI 端點整合
+ */
+import 'dotenv/config';
+import { query, Options } from '@anthropic-ai/claude-agent-sdk';
+
+async function main() {
+  console.log('🚀 Taiwan Haiku Prototype - 開始測試');
+  console.log('📍 使用台灣 Vertex AI 端點 (asia-east1)');
+
+  // 顯示環境配置
+  console.log('\n📝 環境配置：');
+  console.log(`  CLAUDE_CODE_USE_VERTEX: ${process.env.CLAUDE_CODE_USE_VERTEX}`);
+  console.log(`  GOOGLE_CLOUD_PROJECT: ${process.env.GOOGLE_CLOUD_PROJECT}`);
+  console.log(`  VERTEX_AI_REGION: ${process.env.VERTEX_AI_REGION}`);
+  console.log(`  CLOUD_ML_REGION: ${process.env.CLOUD_ML_REGION}`);
+
+  // 建立簡單的測試訊息
+  async function* generateMessages() {
+    yield {
+      type: 'user' as const,
+      message: {
+        role: 'user' as const,
+        content: 'Hello! 請用繁體中文回答：你現在是透過哪個端點運行的？台灣還是美國？',
+      },
+      parent_tool_use_id: null,
+      session_id: 'test-session',
+    };
+  }
+
+  // Stderr callback 捕獲詳細錯誤
+  const stderrCallback = (data: string) => {
+    if (data.trim()) {
+      console.error(`[Claude Code stderr]:`, data.trim());
+    }
+  };
+
+  // Agent SDK 選項
+  const options: Partial<Options> = {
+    model: 'claude-haiku-4-5',  // Haiku 4.5 模型（無版本後綴）
+    permissionMode: 'bypassPermissions',
+    maxTurns: 5,
+    allowedTools: [],  // 最簡單測試：不使用任何工具
+    systemPrompt: '你是一個測試助手。請用繁體中文回答。',
+    stderr: stderrCallback,  // 捕獲 stderr
+  };
+
+  console.log('\n🤖 開始 Claude Agent SDK query...');
+  console.log(`   模型：${options.model}`);
+
+  try {
+    const startTime = Date.now();
+    let eventCount = 0;
+    let responseText = '';
+
+    const result = query({
+      prompt: generateMessages(),
+      options,
+    });
+
+    console.log('\n📦 開始接收事件...\n');
+
+    for await (const msg of result) {
+      eventCount++;
+
+      // 詳細 debug：顯示每個事件
+      console.log(`\n[事件 ${eventCount}] type: ${msg.type}, subtype: ${(msg as any).subtype || 'none'}`);
+      if (msg.type === 'stream_event') {
+        console.log(`  stream_event.type: ${msg.event.type}`);
+      }
+
+      // 處理文字串流
+      if (msg.type === 'stream_event' &&
+          msg.event.type === 'content_block_delta' &&
+          msg.event.delta.type === 'text_delta') {
+        const text = msg.event.delta.text;
+        responseText += text;
+        process.stdout.write(text);  // 即時顯示
+      }
+
+      // 顯示 session ID
+      if (msg.type === 'system' && msg.subtype === 'init') {
+        console.log(`✅ Session 已建立：${msg.session_id}`);
+      }
+
+      // 處理 assistant 訊息
+      if (msg.type === 'assistant') {
+        console.log(`  assistant message content:`, JSON.stringify(msg.message.content, null, 2));
+        for (const block of msg.message.content) {
+          if (block.type === 'text') {
+            console.log('\n📝 收到完整回應：');
+            console.log('='.repeat(60));
+            console.log(block.text);
+            console.log('='.repeat(60));
+            responseText += block.text;
+          }
+        }
+      }
+
+      // 處理結果
+      if (msg.type === 'result') {
+        if (msg.subtype === 'success') {
+          console.log('\n✅ 測試成功！');
+        } else if (msg.subtype.includes('error')) {
+          console.log(`\n❌ 錯誤：${msg.subtype}`);
+        }
+      }
+    }
+
+    const duration = Date.now() - startTime;
+
+    console.log('\n\n' + '='.repeat(60));
+    console.log('📊 測試結果摘要');
+    console.log('='.repeat(60));
+    console.log(`✅ 總事件數：${eventCount}`);
+    console.log(`✅ 回應長度：${responseText.length} 字元`);
+    console.log(`✅ 執行時間：${duration}ms`);
+    console.log(`✅ 模型：${options.model}`);
+    console.log(`✅ 端點：Vertex AI ${process.env.VERTEX_AI_REGION || process.env.CLOUD_ML_REGION}`);
+    console.log('='.repeat(60));
+
+  } catch (error) {
+    console.error('\n❌ 發生錯誤：');
+    console.error(error);
+
+    if (error instanceof Error) {
+      console.error('\n錯誤詳情：');
+      console.error(`  名稱：${error.name}`);
+      console.error(`  訊息：${error.message}`);
+      console.error(`  堆疊：${error.stack}`);
+    }
+
+    process.exit(1);
+  }
+}
+
+// 執行
+main().catch(console.error);

package/botrun-c/prototypes/taiwan-haiku/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "taiwan-haiku-prototype",
+  "version": "1.0.0",
+  "description": "Prototype: Claude Agent SDK with Taiwan Vertex AI endpoint",
+  "main": "index.js",
+  "type": "module",
+  "scripts": {
+    "dev": "tsx index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.1.29",
+    "@anthropic-ai/sdk": "^0.68.0",
+    "@anthropic-ai/vertex-sdk": "^0.14.0",
+    "dotenv": "^16.4.7"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3"
+  }
+}