context-lens 0.3.2 → 0.4.0

package/dist/lhar/tools.js

@@ -0,0 +1,48 @@
+/**
+ * Extract structured tool definition summaries from a ContextInfo.
+ *
+ * Returns one entry per tool schema available to the model, with name and
+ * description only (no full input_schema, keeping the LHAR lightweight).
+ */
+export function extractToolDefinitions(contextInfo) {
+    return contextInfo.tools.map((tool) => {
+        if ("function" in tool) {
+            // OpenAI format: { type: "function", function: { name, description } }
+            const fn = tool.function;
+            return {
+                name: fn.name,
+                description: fn.description ?? null,
+            };
+        }
+        // Anthropic format: { name, description } or Gemini functionDeclarations
+        const t = tool;
+        return {
+            name: t.name,
+            description: t.description ?? null,
+        };
+    });
+}
+/**
+ * Extract structured tool call entries from a ContextInfo's parsed messages.
+ *
+ * Scans contentBlocks for tool_use blocks and returns each invocation with
+ * its name, call ID, and arguments.
+ */
+export function extractToolCalls(contextInfo) {
+    const calls = [];
+    for (const msg of contextInfo.messages) {
+        if (!msg.contentBlocks)
+            continue;
+        for (const block of msg.contentBlocks) {
+            if (block.type === "tool_use" && "name" in block) {
+                calls.push({
+                    name: block.name,
+                    call_id: block.id || null,
+                    arguments: block.input ?? null,
+                });
+            }
+        }
+    }
+    return calls;
+}
+//# sourceMappingURL=tools.js.map

package/dist/lhar/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/lhar/tools.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,WAAwB;IAExB,OAAO,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACpC,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;YACvB,uEAAuE;YACvE,MAAM,EAAE,GAAI,IAAmB,CAAC,QAAQ,CAAC;YACzC,OAAO;gBACL,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,WAAW,EAAE,EAAE,CAAC,WAAW,IAAI,IAAI;aACpC,CAAC;QACJ,CAAC;QACD,yEAAyE;QACzE,MAAM,CAAC,GAAG,IAAqB,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI;SACnC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAwB;IACvD,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;QACvC,IAAI,CAAC,GAAG,CAAC,aAAa;YAAE,SAAS;QACjC,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;YACtC,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;gBACjD,KAAK,CAAC,IAAI,CAAC;oBACT,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,KAAK,CAAC,EAAE,IAAI,IAAI;oBACzB,SAAS,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;iBAC/B,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/lhar-types.generated.d.ts

@@ -14,6 +14,32 @@ export type CompositionCategory = "system_prompt" | "tool_definitions" | "tool_r
 export interface LHARLLMHTTPArchiveFormat {
     [k: string]: unknown;
 }
+/**
+ * A tool/function available to the model in this request.
+ *
+ * This interface was referenced by `LHARLLMHTTPArchiveFormat`'s JSON-Schema
+ * via the `definition` "ToolDefinitionEntry".
+ */
+export interface ToolDefinitionEntry {
+    name: string;
+    description: string | null;
+}
+/**
+ * A tool invocation found in the conversation history of this request.
+ *
+ * This interface was referenced by `LHARLLMHTTPArchiveFormat`'s JSON-Schema
+ * via the `definition` "ToolCallEntry".
+ */
+export interface ToolCallEntry {
+    name: string;
+    call_id: string | null;
+    /**
+     * The arguments passed to the tool. Object when parsed, string when raw/unparsed.
+     */
+    arguments: {
+        [k: string]: unknown;
+    } | string | null;
+}
 /**
  * This interface was referenced by `LHARLLMHTTPArchiveFormat`'s JSON-Schema
  * via the `definition` "CompositionEntry".
@@ -120,6 +146,14 @@ export interface LharRecord {
             cumulative_tokens: number;
             compaction_detected: boolean;
         };
+        /**
+         * Tool/function schemas available to the model in this request.
+         */
+        tool_definitions?: ToolDefinitionEntry[];
+        /**
+         * Tool invocations found in the conversation history of this request.
+         */
+        tool_calls?: ToolCallEntry[];
         security: {
             alerts: {
                 message_index: number;

package/dist/lhar-types.generated.d.ts.map

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

package/dist/lhar.d.ts

@@ -7,7 +7,10 @@
 export { redactHeaders, SENSITIVE_HEADERS } from "./http/headers.js";
 export { analyzeComposition, normalizeComposition, } from "./lhar/composition.js";
 export { toLharJson, toLharJsonl } from "./lhar/export.js";
+export type { ParsedLhar } from "./lhar/reader.js";
+export { parseLharContent, readLharFile } from "./lhar/reader.js";
 export { buildLharRecord, buildSessionLine } from "./lhar/record.js";
 export type { ParsedResponseUsage } from "./lhar/response.js";
-export { parseResponseUsage } from "./lhar/response.js";
+export { extractResponseId, parseResponseUsage } from "./lhar/response.js";
+export { extractToolCalls, extractToolDefinitions } from "./lhar/tools.js";
 //# sourceMappingURL=lhar.d.ts.map

package/dist/lhar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lhar.d.ts","sourceRoot":"","sources":["../src/lhar.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG3D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"lhar.d.ts","sourceRoot":"","sources":["../src/lhar.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,EACL,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3D,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACrE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/lhar.js

@@ -10,8 +10,12 @@ export { redactHeaders, SENSITIVE_HEADERS } from "./http/headers.js";
 export { analyzeComposition, normalizeComposition, } from "./lhar/composition.js";
 // Export serialization (JSONL / JSON)
 export { toLharJson, toLharJsonl } from "./lhar/export.js";
+// LHAR file reader
+export { parseLharContent, readLharFile } from "./lhar/reader.js";
 // Record & session builders
 export { buildLharRecord, buildSessionLine } from "./lhar/record.js";
 // Response usage parsing
-export { parseResponseUsage } from "./lhar/response.js";
+export { extractResponseId, parseResponseUsage } from "./lhar/response.js";
+// Tool extraction
+export { extractToolCalls, extractToolDefinitions } from "./lhar/tools.js";
 //# sourceMappingURL=lhar.js.map

package/dist/lhar.js.map

@@ -1 +1 @@
-{"version":3,"file":"lhar.js","sourceRoot":"","sources":["../src/lhar.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4DAA4D;AAC5D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrE,uBAAuB;AACvB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,sCAAsC;AACtC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE3D,4BAA4B;AAC5B,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAErE,yBAAyB;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"lhar.js","sourceRoot":"","sources":["../src/lhar.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4DAA4D;AAC5D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACrE,uBAAuB;AACvB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,sCAAsC;AACtC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE3D,mBAAmB;AACnB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAClE,4BAA4B;AAC5B,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAErE,yBAAyB;AACzB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,kBAAkB;AAClB,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/proxy/capture.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Capture writer for the proxy.
+ *
+ * Writes raw request/response pairs as JSON files to the capture directory.
+ * Uses atomic writes (write to .tmp, then rename) so readers never see
+ * partial files. Zero external dependencies.
+ */
+export interface CaptureData {
+    timestamp: string;
+    method: string;
+    path: string;
+    source: string | null;
+    provider: string;
+    apiFormat: string;
+    targetUrl: string;
+    requestHeaders: Record<string, string>;
+    requestBody: Record<string, any> | null;
+    requestBytes: number;
+    responseStatus: number;
+    responseHeaders: Record<string, string>;
+    responseBody: string;
+    responseIsStreaming: boolean;
+    responseBytes: number;
+    timings: {
+        send_ms: number;
+        wait_ms: number;
+        receive_ms: number;
+        total_ms: number;
+    };
+}
+/**
+ * Create a capture writer for a given directory.
+ *
+ * Ensures the directory exists on first use. File names are
+ * `{timestamp}-{counter}.json` for natural sort order and uniqueness.
+ */
+export declare function createCaptureWriter(captureDir: string): {
+    write: (capture: CaptureData) => string | null;
+};
+//# sourceMappingURL=capture.d.ts.map

package/dist/proxy/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/proxy/capture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM;qBAe5B,WAAW,KAAG,MAAM,GAAG,IAAI;EA4BpD"}

package/dist/proxy/capture.js

@@ -0,0 +1,56 @@
+/**
+ * Capture writer for the proxy.
+ *
+ * Writes raw request/response pairs as JSON files to the capture directory.
+ * Uses atomic writes (write to .tmp, then rename) so readers never see
+ * partial files. Zero external dependencies.
+ */
+import fs from "node:fs";
+import { join } from "node:path";
+/**
+ * Create a capture writer for a given directory.
+ *
+ * Ensures the directory exists on first use. File names are
+ * `{timestamp}-{counter}.json` for natural sort order and uniqueness.
+ */
+export function createCaptureWriter(captureDir) {
+    let dirReady = false;
+    let counter = 0;
+    function ensureDir() {
+        if (dirReady)
+            return;
+        fs.mkdirSync(captureDir, { recursive: true });
+        dirReady = true;
+    }
+    /**
+     * Write a capture to disk atomically.
+     *
+     * Returns the filename (without directory) on success, or null on error.
+     */
+    function write(capture) {
+        ensureDir();
+        const seq = String(counter++).padStart(6, "0");
+        const ts = Date.now();
+        const filename = `${ts}-${seq}.json`;
+        const filePath = join(captureDir, filename);
+        const tmpPath = `${filePath}.tmp`;
+        try {
+            fs.writeFileSync(tmpPath, JSON.stringify(capture));
+            fs.renameSync(tmpPath, filePath);
+            return filename;
+        }
+        catch (err) {
+            console.error("Capture write error:", err instanceof Error ? err.message : String(err));
+            // Clean up temp file if rename failed
+            try {
+                fs.unlinkSync(tmpPath);
+            }
+            catch {
+                /* may not exist */
+            }
+            return null;
+        }
+    }
+    return { write };
+}
+//# sourceMappingURL=capture.js.map

package/dist/proxy/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../src/proxy/capture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AA0BjC;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,SAAS,SAAS;QAChB,IAAI,QAAQ;YAAE,OAAO;QACrB,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACH,SAAS,KAAK,CAAC,OAAoB;QACjC,SAAS,EAAE,CAAC;QACZ,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC/C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,GAAG,QAAQ,MAAM,CAAC;QAElC,IAAI,CAAC;YACH,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;YACnD,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YACjC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CACX,sBAAsB,EACtB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CACjD,CAAC;YACF,sCAAsC;YACtC,IAAI,CAAC;gBACH,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;YAAC,MAAM,CAAC;gBACP,mBAAmB;YACrB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC"}

package/dist/proxy/config.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Proxy configuration.
+ *
+ * Reads from environment variables with safe defaults.
+ * Zero external dependencies.
+ */
+import type { Upstreams } from "./routing.js";
+export interface ProxyConfig {
+    upstreams: Upstreams;
+    bindHost: string;
+    port: number;
+    allowTargetOverride: boolean;
+    captureDir: string;
+}
+export declare function loadProxyConfig(): ProxyConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/proxy/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/proxy/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,EAAE,OAAO,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,eAAe,IAAI,WAAW,CAiC7C"}

package/dist/proxy/config.js

@@ -0,0 +1,34 @@
+/**
+ * Proxy configuration.
+ *
+ * Reads from environment variables with safe defaults.
+ * Zero external dependencies.
+ */
+import { homedir } from "node:os";
+import { join } from "node:path";
+export function loadProxyConfig() {
+    const upstreams = {
+        openai: process.env.UPSTREAM_OPENAI_URL || "https://api.openai.com/v1",
+        anthropic: process.env.UPSTREAM_ANTHROPIC_URL || "https://api.anthropic.com",
+        chatgpt: process.env.UPSTREAM_CHATGPT_URL || "https://chatgpt.com",
+        gemini: process.env.UPSTREAM_GEMINI_URL ||
+            "https://generativelanguage.googleapis.com",
+        geminiCodeAssist: process.env.UPSTREAM_GEMINI_CODE_ASSIST_URL ||
+            "https://cloudcode-pa.googleapis.com",
+    };
+    // Bind only to localhost unless explicitly overridden.
+    const bindHost = process.env.CONTEXT_LENS_BIND_HOST || "127.0.0.1";
+    const port = parseInt(process.env.CONTEXT_LENS_PROXY_PORT || "4040", 10);
+    // Do not honor `x-target-url` unless explicitly enabled.
+    const allowTargetOverride = process.env.CONTEXT_LENS_ALLOW_TARGET_OVERRIDE === "1";
+    const captureDir = process.env.CONTEXT_LENS_CAPTURE_DIR ||
+        join(homedir(), ".context-lens", "captures");
+    return {
+        upstreams,
+        bindHost,
+        port,
+        allowTargetOverride,
+        captureDir,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/proxy/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/proxy/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAYjC,MAAM,UAAU,eAAe;IAC7B,MAAM,SAAS,GAAc;QAC3B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,2BAA2B;QACtE,SAAS,EACP,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,2BAA2B;QACnE,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,qBAAqB;QAClE,MAAM,EACJ,OAAO,CAAC,GAAG,CAAC,mBAAmB;YAC/B,2CAA2C;QAC7C,gBAAgB,EACd,OAAO,CAAC,GAAG,CAAC,+BAA+B;YAC3C,qCAAqC;KACxC,CAAC;IAEF,uDAAuD;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,WAAW,CAAC;IACnE,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IAEzE,yDAAyD;IACzD,MAAM,mBAAmB,GACvB,OAAO,CAAC,GAAG,CAAC,kCAAkC,KAAK,GAAG,CAAC;IAEzD,MAAM,UAAU,GACd,OAAO,CAAC,GAAG,CAAC,wBAAwB;QACpC,IAAI,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;IAE/C,OAAO;QACL,SAAS;QACT,QAAQ;QACR,IAAI;QACJ,mBAAmB;QACnB,UAAU;KACX,CAAC;AACJ,CAAC"}

package/dist/proxy/forward.d.ts

@@ -0,0 +1,20 @@
+/**
+ * HTTP forwarding logic for the proxy.
+ *
+ * Receives incoming requests, forwards them to the appropriate LLM upstream,
+ * captures the raw request/response pair to disk, and pipes the response
+ * back to the client. Zero external dependencies.
+ */
+import http from "node:http";
+import type { CaptureData } from "./capture.js";
+import { type Upstreams } from "./routing.js";
+export interface ForwardOptions {
+    upstreams: Upstreams;
+    allowTargetOverride: boolean;
+    onCapture: (capture: CaptureData) => void;
+}
+/**
+ * Create the main proxy request handler.
+ */
+export declare function createProxyHandler(opts: ForwardOptions): (req: http.IncomingMessage, res: http.ServerResponse) => void;
+//# sourceMappingURL=forward.d.ts.map

package/dist/proxy/forward.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forward.d.ts","sourceRoot":"","sources":["../../src/proxy/forward.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,SAAS,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;CAC3C;AAgHD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,cAAc,GACnB,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI,CAuJ/D"}

package/dist/proxy/forward.js

@@ -0,0 +1,210 @@
+/**
+ * HTTP forwarding logic for the proxy.
+ *
+ * Receives incoming requests, forwards them to the appropriate LLM upstream,
+ * captures the raw request/response pair to disk, and pipes the response
+ * back to the client. Zero external dependencies.
+ */
+import http from "node:http";
+import https from "node:https";
+import url from "node:url";
+import { selectHeaders } from "./headers.js";
+import { classifyRequest, extractSource, resolveTargetUrl, } from "./routing.js";
+/**
+ * Build headers to send to the upstream, stripping proxy-internal ones.
+ */
+function buildForwardHeaders(reqHeaders, targetHost, bodyLength) {
+    const forwardHeaders = { ...reqHeaders };
+    delete forwardHeaders["x-target-url"];
+    delete forwardHeaders.host;
+    if (targetHost) {
+        forwardHeaders.host = targetHost;
+    }
+    if (bodyLength != null) {
+        delete forwardHeaders["transfer-encoding"];
+        forwardHeaders["content-length"] = bodyLength;
+    }
+    return forwardHeaders;
+}
+/**
+ * Wire up error/close handlers between client response and upstream request.
+ */
+function attachLifecycleHandlers(res, proxyReq) {
+    res.on("close", () => {
+        if (!proxyReq.destroyed)
+            proxyReq.destroy();
+    });
+    proxyReq.on("error", (err) => {
+        if (res.destroyed)
+            return;
+        const detail = err.message || ("code" in err ? err.code : "unknown");
+        console.error("Proxy error:", detail);
+        if (!res.headersSent) {
+            res.writeHead(502, { "Content-Type": "application/json" });
+        }
+        if (!res.destroyed) {
+            res.end(JSON.stringify({ error: "Proxy error", details: err.message }));
+        }
+    });
+}
+/**
+ * Resolve headers for routing, filtering x-target-url when not allowed.
+ */
+function headersForResolution(headers, remoteAddr, allowTargetOverride) {
+    const h = headers;
+    if (h["x-target-url"] &&
+        !(allowTargetOverride && isLocalRemote(remoteAddr))) {
+        const { "x-target-url": _drop, ...rest } = h;
+        return rest;
+    }
+    return h;
+}
+function isLocalRemote(addr) {
+    if (!addr)
+        return false;
+    return addr === "127.0.0.1" || addr === "::1" || addr === "::ffff:127.0.0.1";
+}
+/**
+ * Forward a non-POST request (GET /v1/models, OPTIONS, etc.) without capturing.
+ */
+function forwardPassthrough(req, res, targetUrl, body) {
+    const targetParsed = url.parse(targetUrl);
+    const forwardHeaders = buildForwardHeaders(req.headers, targetParsed.host, body ? body.length : undefined);
+    const protocol = targetParsed.protocol === "https:" ? https : http;
+    const proxyReq = protocol.request({
+        hostname: targetParsed.hostname,
+        port: targetParsed.port,
+        path: targetParsed.path,
+        method: req.method,
+        headers: forwardHeaders,
+    }, (proxyRes) => {
+        if (!res.headersSent)
+            res.writeHead(proxyRes.statusCode, proxyRes.headers);
+        proxyRes.pipe(res);
+        proxyRes.on("error", (err) => {
+            console.error("Upstream response error (forward):", err.message);
+            if (!res.destroyed)
+                res.end();
+        });
+    });
+    attachLifecycleHandlers(res, proxyReq);
+    if (body)
+        proxyReq.write(body);
+    proxyReq.end();
+}
+/**
+ * Create the main proxy request handler.
+ */
+export function createProxyHandler(opts) {
+    return function handleProxy(req, res) {
+        const parsedUrl = url.parse(req.url);
+        const { source, cleanPath } = extractSource(parsedUrl.pathname);
+        const search = parsedUrl.search || null;
+        const routingHeaders = headersForResolution(req.headers, req.socket.remoteAddress, opts.allowTargetOverride);
+        const { targetUrl, provider } = resolveTargetUrl(cleanPath, search, routingHeaders, opts.upstreams);
+        const { apiFormat } = classifyRequest(cleanPath, routingHeaders);
+        const hasAuth = !!req.headers.authorization;
+        const sourceTag = source ? `[${source}]` : "";
+        console.log(`${req.method} ${req.url} → ${targetUrl} [${provider}] ${sourceTag} auth=${hasAuth}`);
+        // Non-POST requests: pass through without capturing
+        if (req.method !== "POST") {
+            forwardPassthrough(req, res, targetUrl, null);
+            return;
+        }
+        // Buffer the request body
+        const chunks = [];
+        let clientAborted = false;
+        req.on("data", (chunk) => {
+            chunks.push(chunk);
+        });
+        req.on("error", () => {
+            clientAborted = true;
+        });
+        req.on("end", () => {
+            if (clientAborted)
+                return;
+            const bodyBuffer = Buffer.concat(chunks);
+            const bodyText = bodyBuffer.toString("utf8");
+            // Try to parse as JSON (for the capture file), but forward regardless
+            let bodyJson = null;
+            try {
+                bodyJson = JSON.parse(bodyText);
+            }
+            catch {
+                // Not JSON; capture as null, forward the raw bytes
+            }
+            const targetParsed = url.parse(targetUrl);
+            const forwardHeaders = buildForwardHeaders(req.headers, targetParsed.host, bodyBuffer.length);
+            const protocol = targetParsed.protocol === "https:" ? https : http;
+            const startTime = performance.now();
+            let firstByteTime = 0;
+            let requestSentTime = 0;
+            const reqBytes = bodyBuffer.length;
+            const proxyReq = protocol.request({
+                hostname: targetParsed.hostname,
+                port: targetParsed.port,
+                path: targetParsed.path,
+                method: req.method,
+                headers: forwardHeaders,
+            }, (proxyRes) => {
+                console.log(`  ← ${proxyRes.statusCode} ${proxyRes.statusMessage}`);
+                res.writeHead(proxyRes.statusCode, proxyRes.headers);
+                const isStreaming = proxyRes.headers["content-type"]?.includes("text/event-stream");
+                let respBytes = 0;
+                const respChunks = [];
+                proxyRes.on("data", (chunk) => {
+                    if (!firstByteTime)
+                        firstByteTime = performance.now();
+                    respBytes += chunk.length;
+                    respChunks.push(chunk);
+                    if (!res.destroyed)
+                        res.write(chunk);
+                });
+                proxyRes.on("end", () => {
+                    const endTime = performance.now();
+                    if (!firstByteTime)
+                        firstByteTime = endTime;
+                    const respBody = Buffer.concat(respChunks).toString("utf8");
+                    const capture = {
+                        timestamp: new Date().toISOString(),
+                        method: req.method,
+                        path: cleanPath,
+                        source,
+                        provider,
+                        apiFormat,
+                        targetUrl,
+                        requestHeaders: selectHeaders(req.headers),
+                        requestBody: bodyJson,
+                        requestBytes: reqBytes,
+                        responseStatus: proxyRes.statusCode || 0,
+                        responseHeaders: selectHeaders(proxyRes.headers),
+                        responseBody: respBody,
+                        responseIsStreaming: !!isStreaming,
+                        responseBytes: respBytes,
+                        timings: {
+                            send_ms: Math.round(Math.max(0, (requestSentTime || firstByteTime) - startTime)),
+                            wait_ms: Math.round(Math.max(0, firstByteTime - (requestSentTime || startTime))),
+                            receive_ms: Math.round(endTime - firstByteTime),
+                            total_ms: Math.round(endTime - startTime),
+                        },
+                    };
+                    opts.onCapture(capture);
+                    if (!res.destroyed)
+                        res.end();
+                });
+                proxyRes.on("error", (err) => {
+                    console.error("Upstream response error:", err.message);
+                    if (!res.destroyed)
+                        res.end();
+                });
+            });
+            attachLifecycleHandlers(res, proxyReq);
+            proxyReq.on("finish", () => {
+                requestSentTime = performance.now();
+            });
+            proxyReq.write(bodyBuffer);
+            proxyReq.end();
+        });
+    };
+}
+//# sourceMappingURL=forward.js.map

package/dist/proxy/forward.js.map

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

package/dist/proxy/headers.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Header redaction for the proxy.
+ *
+ * The proxy captures headers for debugging but must never persist secrets.
+ * This is the single source of truth for what gets stripped.
+ */
+/** Case-insensitive set of header names that must never be persisted. */
+export declare const SENSITIVE_HEADERS: Set<string>;
+/**
+ * Select a safe subset of headers for capture.
+ *
+ * Drops sensitive headers and keeps only string-valued entries
+ * (Node can represent multi-valued headers as arrays).
+ */
+export declare function selectHeaders(headers: Record<string, any>): Record<string, string>;
+//# sourceMappingURL=headers.d.ts.map

package/dist/proxy/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../src/proxy/headers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yEAAyE;AACzE,eAAO,MAAM,iBAAiB,aAY5B,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB"}

package/dist/proxy/headers.js

@@ -0,0 +1,37 @@
+/**
+ * Header redaction for the proxy.
+ *
+ * The proxy captures headers for debugging but must never persist secrets.
+ * This is the single source of truth for what gets stripped.
+ */
+/** Case-insensitive set of header names that must never be persisted. */
+export const SENSITIVE_HEADERS = new Set([
+    "authorization",
+    "x-api-key",
+    "cookie",
+    "set-cookie",
+    "x-target-url",
+    "proxy-authorization",
+    "x-auth-token",
+    "x-forwarded-authorization",
+    "www-authenticate",
+    "proxy-authenticate",
+    "x-goog-api-key",
+]);
+/**
+ * Select a safe subset of headers for capture.
+ *
+ * Drops sensitive headers and keeps only string-valued entries
+ * (Node can represent multi-valued headers as arrays).
+ */
+export function selectHeaders(headers) {
+    const result = {};
+    for (const [key, val] of Object.entries(headers)) {
+        if (SENSITIVE_HEADERS.has(key.toLowerCase()))
+            continue;
+        if (typeof val === "string")
+            result[key] = val;
+    }
+    return result;
+}
+//# sourceMappingURL=headers.js.map

package/dist/proxy/headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.js","sourceRoot":"","sources":["../../src/proxy/headers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yEAAyE;AACzE,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IACvC,eAAe;IACf,WAAW;IACX,QAAQ;IACR,YAAY;IACZ,cAAc;IACd,qBAAqB;IACrB,cAAc;IACd,2BAA2B;IAC3B,kBAAkB;IAClB,oBAAoB;IACpB,gBAAgB;CACjB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,OAA4B;IAE5B,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;YAAE,SAAS;QACvD,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}