agentrace 0.0.7 → 0.0.8

package/README.md

@@ -31,14 +31,15 @@ That's it! When you use Claude Code, sessions will be automatically sent to Agen
 
 ## Commands
 
-| Command                      | Description                            |
-| ---------------------------- | -------------------------------------- |
-| `agentrace init --url <url>` | Initial setup + hooks installation     |
-| `agentrace login`            | Open the web dashboard                 |
-| `agentrace send`             | Send transcript diff (used by hooks)   |
-| `agentrace on`               | Enable hooks                           |
-| `agentrace off`              | Disable hooks                          |
-| `agentrace uninstall`        | Remove hooks and configuration         |
+| Command                                      | Description                            |
+| -------------------------------------------- | -------------------------------------- |
+| `agentrace init --url <url>`                 | Initial setup + hooks installation     |
+| `agentrace init --url <url> --proxy <proxy>` | Setup with proxy                       |
+| `agentrace login`                            | Open the web dashboard                 |
+| `agentrace send`                             | Send transcript diff (used by hooks)   |
+| `agentrace on`                               | Enable hooks                           |
+| `agentrace off`                              | Disable hooks                          |
+| `agentrace uninstall`                        | Remove hooks and configuration         |
 
 ## Command Details
 
@@ -122,6 +123,38 @@ Configuration is stored in the following locations:
 - Only the transcript diff is sent to the server when a Claude Code conversation ends
 - Errors do not block Claude Code's operation by design
 
+## Proxy Configuration
+
+If you need to connect through an HTTP proxy, you can configure it in several ways:
+
+### 1. Using the `--proxy` Option
+
+```bash
+npx agentrace init --url http://localhost:9080 --proxy http://proxy.example.com:8080
+```
+
+For proxies requiring authentication:
+
+```bash
+npx agentrace init --url http://localhost:9080 --proxy http://user:pass@proxy.example.com:8080
+```
+
+### 2. Using Environment Variables
+
+If `proxy_url` is not set in the config file, the CLI will check the following environment variables (in order):
+
+1. `HTTPS_PROXY`
+2. `https_proxy`
+3. `HTTP_PROXY`
+4. `http_proxy`
+
+```bash
+export HTTPS_PROXY=http://proxy.example.com:8080
+npx agentrace send
+```
+
+**Priority:** Config file > Environment variables
+
 ## Requirements
 
 - Node.js 18 or later

package/dist/commands/init.d.ts

@@ -1,5 +1,6 @@
 export interface InitOptions {
     url?: string;
+    proxy?: string;
     dev?: boolean;
 }
 export declare function initCommand(options?: InitOptions): Promise<void>;

package/dist/commands/init.js

@@ -25,6 +25,18 @@ export async function initCommand(options = {}) {
         console.error("Error: Invalid URL format");
         process.exit(1);
     }
+    // Validate proxy URL if provided
+    if (options.proxy) {
+        try {
+            new URL(options.proxy);
+        }
+        catch {
+            console.error("Error: Invalid proxy URL format");
+            console.error("Example: http://proxy.example.com:8080");
+            console.error("         http://user:pass@proxy.example.com:8080");
+            process.exit(1);
+        }
+    }
     console.log("AgenTrace Setup\n");
     if (options.dev) {
         console.log("[Dev Mode] Using local CLI for hooks\n");
@@ -61,8 +73,12 @@ export async function initCommand(options = {}) {
         saveConfig({
             server_url: serverUrlStr,
             api_key: result.apiKey,
+            ...(options.proxy && { proxy_url: options.proxy }),
         });
         console.log(`✓ Config saved to ${getConfigPath()}`);
+        if (options.proxy) {
+            console.log(`  Proxy: ${options.proxy}`);
+        }
         // Determine hook command
         let hookCommand;
         if (options.dev) {

package/dist/config/manager.d.ts

@@ -1,6 +1,7 @@
 export interface AgentraceConfig {
     server_url: string;
     api_key: string;
+    proxy_url?: string;
 }
 export declare function getConfigPath(): string;
 export declare function loadConfig(): AgentraceConfig | null;

package/dist/index.js

@@ -13,9 +13,10 @@ program
     .command("init")
     .description("Initialize agentrace configuration and hooks")
     .requiredOption("--url <url>", "Server URL (required)")
+    .option("--proxy <url>", "HTTP/HTTPS proxy URL")
     .option("--dev", "Use local CLI path for development")
     .action(async (options) => {
-    await initCommand({ url: options.url, dev: options.dev });
+    await initCommand({ url: options.url, proxy: options.proxy, dev: options.dev });
 });
 program
     .command("login")

package/dist/mcp/plan-document-client.js

@@ -1,4 +1,6 @@
+import { fetch } from "undici";
 import { loadConfig } from "../config/manager.js";
+import { createDispatcher } from "../utils/proxy.js";
 export class PlanDocumentClient {
     serverUrl;
     apiKey;
@@ -20,6 +22,7 @@ export class PlanDocumentClient {
             method,
             headers,
             body: body ? JSON.stringify(body) : undefined,
+            dispatcher: createDispatcher(),
         });
         if (!response.ok) {
             const errorText = await response.text();

package/dist/utils/http.js

@@ -1,4 +1,6 @@
+import { fetch } from "undici";
 import { loadConfig } from "../config/manager.js";
+import { createDispatcher } from "./proxy.js";
 function getBaseUrl(config) {
     return config.server_url.replace(/\/+$/, '');
 }
@@ -16,6 +18,7 @@ export async function sendIngest(payload) {
                 Authorization: `Bearer ${config.api_key}`,
             },
             body: JSON.stringify(payload),
+            dispatcher: createDispatcher(),
         });
         if (!response.ok) {
             const text = await response.text();
@@ -41,6 +44,7 @@ export async function createWebSession() {
                 "Content-Type": "application/json",
                 Authorization: `Bearer ${config.api_key}`,
             },
+            dispatcher: createDispatcher(),
         });
         if (!response.ok) {
             const text = await response.text();

package/dist/utils/proxy.d.ts

@@ -0,0 +1,11 @@
+import { ProxyAgent } from 'undici';
+/**
+ * プロキシURLを取得する
+ * 優先順位: 設定ファイル > 環境変数（HTTPS_PROXY > HTTP_PROXY）
+ */
+export declare function getProxyUrl(): string | undefined;
+/**
+ * undici の dispatcher を生成する
+ * プロキシ設定がない場合は undefined を返す（デフォルト動作）
+ */
+export declare function createDispatcher(): ProxyAgent | undefined;

package/dist/utils/proxy.js

@@ -0,0 +1,29 @@
+import { ProxyAgent } from 'undici';
+import { loadConfig } from '../config/manager.js';
+/**
+ * プロキシURLを取得する
+ * 優先順位: 設定ファイル > 環境変数（HTTPS_PROXY > HTTP_PROXY）
+ */
+export function getProxyUrl() {
+    const config = loadConfig();
+    // 設定ファイル優先
+    if (config?.proxy_url) {
+        return config.proxy_url;
+    }
+    // 環境変数フォールバック（大文字・小文字両方サポート）
+    return process.env.HTTPS_PROXY
+        || process.env.https_proxy
+        || process.env.HTTP_PROXY
+        || process.env.http_proxy;
+}
+/**
+ * undici の dispatcher を生成する
+ * プロキシ設定がない場合は undefined を返す（デフォルト動作）
+ */
+export function createDispatcher() {
+    const proxyUrl = getProxyUrl();
+    if (!proxyUrl) {
+        return undefined;
+    }
+    return new ProxyAgent(proxyUrl);
+}

package/dist/utils/proxy.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/proxy.test.js

@@ -0,0 +1,116 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { ProxyAgent } from 'undici';
+// モックを設定
+vi.mock('../config/manager.js', () => ({
+    loadConfig: vi.fn(),
+}));
+import { getProxyUrl, createDispatcher } from './proxy.js';
+import { loadConfig } from '../config/manager.js';
+const mockedLoadConfig = vi.mocked(loadConfig);
+describe('proxy', () => {
+    const originalEnv = process.env;
+    beforeEach(() => {
+        // 環境変数をリセット
+        process.env = { ...originalEnv };
+        delete process.env.HTTPS_PROXY;
+        delete process.env.https_proxy;
+        delete process.env.HTTP_PROXY;
+        delete process.env.http_proxy;
+        // モックをリセット
+        vi.clearAllMocks();
+    });
+    afterEach(() => {
+        process.env = originalEnv;
+    });
+    describe('getProxyUrl', () => {
+        it('設定ファイルにproxy_urlがある場合、それを返す', () => {
+            mockedLoadConfig.mockReturnValue({
+                server_url: 'http://localhost:8080',
+                api_key: 'test-key',
+                proxy_url: 'http://proxy.example.com:8080',
+            });
+            expect(getProxyUrl()).toBe('http://proxy.example.com:8080');
+        });
+        it('設定ファイルにproxy_urlがなく、HTTPS_PROXYがある場合、それを返す', () => {
+            mockedLoadConfig.mockReturnValue({
+                server_url: 'http://localhost:8080',
+                api_key: 'test-key',
+            });
+            process.env.HTTPS_PROXY = 'http://https-proxy.example.com:8080';
+            expect(getProxyUrl()).toBe('http://https-proxy.example.com:8080');
+        });
+        it('設定ファイルにproxy_urlがなく、https_proxy（小文字）がある場合、それを返す', () => {
+            mockedLoadConfig.mockReturnValue({
+                server_url: 'http://localhost:8080',
+                api_key: 'test-key',
+            });
+            process.env.https_proxy = 'http://https-proxy-lower.example.com:8080';
+            expect(getProxyUrl()).toBe('http://https-proxy-lower.example.com:8080');
+        });
+        it('設定ファイルにproxy_urlがなく、HTTP_PROXYがある場合、それを返す', () => {
+            mockedLoadConfig.mockReturnValue({
+                server_url: 'http://localhost:8080',
+                api_key: 'test-key',
+            });
+            process.env.HTTP_PROXY = 'http://http-proxy.example.com:8080';
+            expect(getProxyUrl()).toBe('http://http-proxy.example.com:8080');
+        });
+        it('設定ファイルにproxy_urlがなく、http_proxy（小文字）がある場合、それを返す', () => {
+            mockedLoadConfig.mockReturnValue({
+                server_url: 'http://localhost:8080',
+                api_key: 'test-key',
+            });
+            process.env.http_proxy = 'http://http-proxy-lower.example.com:8080';
+            expect(getProxyUrl()).toBe('http://http-proxy-lower.example.com:8080');
+        });
+        it('設定ファイルも環境変数もない場合、undefinedを返す', () => {
+            mockedLoadConfig.mockReturnValue({
+                server_url: 'http://localhost:8080',
+                api_key: 'test-key',
+            });
+            expect(getProxyUrl()).toBeUndefined();
+        });
+        it('設定ファイルがnullの場合、環境変数にフォールバックする', () => {
+            mockedLoadConfig.mockReturnValue(null);
+            process.env.HTTPS_PROXY = 'http://env-proxy.example.com:8080';
+            expect(getProxyUrl()).toBe('http://env-proxy.example.com:8080');
+        });
+        it('設定ファイルが環境変数より優先される', () => {
+            mockedLoadConfig.mockReturnValue({
+                server_url: 'http://localhost:8080',
+                api_key: 'test-key',
+                proxy_url: 'http://config-proxy.example.com:8080',
+            });
+            process.env.HTTPS_PROXY = 'http://env-proxy.example.com:8080';
+            expect(getProxyUrl()).toBe('http://config-proxy.example.com:8080');
+        });
+        it('HTTPS_PROXYがHTTP_PROXYより優先される', () => {
+            mockedLoadConfig.mockReturnValue({
+                server_url: 'http://localhost:8080',
+                api_key: 'test-key',
+            });
+            process.env.HTTPS_PROXY = 'http://https-proxy.example.com:8080';
+            process.env.HTTP_PROXY = 'http://http-proxy.example.com:8080';
+            expect(getProxyUrl()).toBe('http://https-proxy.example.com:8080');
+        });
+    });
+    describe('createDispatcher', () => {
+        it('プロキシURLがある場合、ProxyAgentを返す', () => {
+            mockedLoadConfig.mockReturnValue({
+                server_url: 'http://localhost:8080',
+                api_key: 'test-key',
+                proxy_url: 'http://proxy.example.com:8080',
+            });
+            const dispatcher = createDispatcher();
+            expect(dispatcher).toBeInstanceOf(ProxyAgent);
+        });
+        it('プロキシURLがない場合、undefinedを返す', () => {
+            mockedLoadConfig.mockReturnValue({
+                server_url: 'http://localhost:8080',
+                api_key: 'test-key',
+            });
+            const dispatcher = createDispatcher();
+            expect(dispatcher).toBeUndefined();
+        });
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentrace",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "description": "CLI for AgenTrace - Claude Code session tracker",
   "type": "module",
   "bin": {
@@ -13,6 +13,8 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -38,12 +40,14 @@
     "@modelcontextprotocol/sdk": "^1.0.0",
     "commander": "^12.0.0",
     "diff-match-patch-es": "^1.0.0",
+    "undici": "^7.18.2",
     "zod": "^3.25.0"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "tsx": "^4.0.0",
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.17"
   },
   "engines": {
     "node": ">=18.0.0"