@agentgazer/shared 0.2.0 → 0.3.1

package/dist/providers.js

@@ -1,12 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KNOWN_PROVIDER_NAMES = void 0;
+exports.SELECTABLE_PROVIDER_NAMES = exports.KNOWN_PROVIDER_NAMES = exports.PROVIDER_DISPLAY_NAMES = void 0;
 exports.detectProvider = detectProvider;
 exports.detectProviderByHostname = detectProviderByHostname;
 exports.getProviderBaseUrl = getProviderBaseUrl;
+exports.getProviderRootUrl = getProviderRootUrl;
+exports.providerUsesPathRouting = providerUsesPathRouting;
+exports.getProviderChatEndpoint = getProviderChatEndpoint;
 exports.getProviderAuthHeader = getProviderAuthHeader;
 exports.parsePathPrefix = parsePathPrefix;
+exports.rewriteProviderPath = rewriteProviderPath;
 exports.parseAgentPath = parseAgentPath;
+/** Mapping of provider names to their popular model names for display. */
+exports.PROVIDER_DISPLAY_NAMES = {
+    openai: "OpenAI (GPT-4)",
+    anthropic: "Anthropic (Claude)",
+    google: "Google (Gemini)",
+    mistral: "Mistral",
+    cohere: "Cohere (Command)",
+    deepseek: "DeepSeek",
+    moonshot: "Moonshot (Kimi)",
+    zhipu: "Zhipu (GLM-4)",
+    minimax: "MiniMax (abab)",
+    baichuan: "Baichuan",
+};
 /** All known provider names (excludes "unknown"). Single source of truth. */
 exports.KNOWN_PROVIDER_NAMES = [
     "openai",
@@ -19,7 +36,22 @@ exports.KNOWN_PROVIDER_NAMES = [
     "zhipu",
     "minimax",
     "baichuan",
-    "yi",
+];
+/**
+ * Provider names available for user selection in UI/CLI.
+ * Excludes providers without active API access.
+ */
+exports.SELECTABLE_PROVIDER_NAMES = [
+    "openai",
+    "anthropic",
+    "google",
+    "mistral",
+    "cohere",
+    "deepseek",
+    "moonshot",
+    "zhipu",
+    "minimax",
+    "baichuan",
 ];
 const PROVIDER_PATTERNS = [
     {
@@ -50,7 +82,7 @@ const PROVIDER_PATTERNS = [
     },
     {
         name: "moonshot",
-        hostPatterns: [/^api\.moonshot\.cn$/],
+        hostPatterns: [/^api\.moonshot\.ai$/, /^api\.moonshot\.cn$/],
     },
     {
         name: "zhipu",
@@ -58,16 +90,12 @@ const PROVIDER_PATTERNS = [
     },
     {
         name: "minimax",
-        hostPatterns: [/^api\.minimax\.chat$/],
+        hostPatterns: [/^api\.minimax\.io$/, /^api\.minimax\.chat$/],
     },
     {
         name: "baichuan",
         hostPatterns: [/^api\.baichuan-ai\.com$/],
     },
-    {
-        name: "yi",
-        hostPatterns: [/^api\.lingyiwanwu\.com$/],
-    },
 ];
 function detectProvider(url) {
     let hostname = "";
@@ -123,26 +151,76 @@ function detectProviderByHostname(url) {
     return "unknown";
 }
 function getProviderBaseUrl(provider) {
+    // Base URLs include version path so users can set OPENAI_BASE_URL=http://localhost:4000/openai
+    // and the SDK will send /openai/chat/completions which becomes /v1/chat/completions
+    const urls = {
+        openai: "https://api.openai.com/v1",
+        anthropic: "https://api.anthropic.com/v1",
+        google: "https://generativelanguage.googleapis.com/v1beta/openai",
+        mistral: "https://api.mistral.ai/v1",
+        cohere: "https://api.cohere.com/v2",
+        deepseek: "https://api.deepseek.com/v1",
+        moonshot: "https://api.moonshot.ai/v1",
+        zhipu: "https://api.z.ai/api/paas/v4",
+        minimax: "https://api.minimax.io/v1",
+        baichuan: "https://api.baichuan-ai.com/v1",
+    };
+    return urls[provider] ?? null;
+}
+/**
+ * Returns the root API URL for a provider for path-based routing.
+ * Includes version prefix where needed (e.g., /v1beta for Google).
+ * Used for providers that need path-based routing (e.g., Google's native API).
+ */
+function getProviderRootUrl(provider) {
     const urls = {
         openai: "https://api.openai.com",
         anthropic: "https://api.anthropic.com",
-        google: "https://generativelanguage.googleapis.com",
+        google: "https://generativelanguage.googleapis.com/v1beta", // Include version prefix
         mistral: "https://api.mistral.ai",
         cohere: "https://api.cohere.com",
         deepseek: "https://api.deepseek.com",
-        moonshot: "https://api.moonshot.cn",
-        zhipu: "https://open.bigmodel.cn",
-        minimax: "https://api.minimax.chat",
+        moonshot: "https://api.moonshot.ai",
+        zhipu: "https://api.z.ai",
+        minimax: "https://api.minimax.io",
         baichuan: "https://api.baichuan-ai.com",
-        yi: "https://api.lingyiwanwu.com",
     };
     return urls[provider] ?? null;
 }
+/**
+ * Check if a provider uses path-based routing (client provides the full path).
+ * These providers expect the trailing path to be preserved, not replaced with a fixed endpoint.
+ */
+function providerUsesPathRouting(provider) {
+    // Google's native API uses paths like /v1beta/models/{model}:generateContent
+    return provider === "google";
+}
+/**
+ * Returns the complete chat endpoint URL for a provider.
+ * This is the full URL including path - no additional path construction needed.
+ * Returns null for unknown providers.
+ */
+function getProviderChatEndpoint(provider) {
+    const endpoints = {
+        openai: "https://api.openai.com/v1/chat/completions",
+        anthropic: "https://api.anthropic.com/v1/messages",
+        google: "https://generativelanguage.googleapis.com/v1beta/openai/chat/completions",
+        mistral: "https://api.mistral.ai/v1/chat/completions",
+        cohere: "https://api.cohere.com/v2/chat",
+        deepseek: "https://api.deepseek.com/v1/chat/completions",
+        moonshot: "https://api.moonshot.ai/v1/chat/completions",
+        zhipu: "https://api.z.ai/api/paas/v4/chat/completions",
+        minimax: "https://api.minimax.io/v1/text/chatcompletion_v2",
+        baichuan: "https://api.baichuan-ai.com/v1/chat/completions",
+    };
+    return endpoints[provider] ?? null;
+}
 /**
  * Returns the auth header name and value for a given provider.
  * Different providers use different header conventions.
+ * @param useNativeApi - For Google, whether to use native API auth (x-goog-api-key) vs OpenAI-compatible (Bearer)
  */
-function getProviderAuthHeader(provider, apiKey) {
+function getProviderAuthHeader(provider, apiKey, useNativeApi = false) {
     switch (provider) {
         case "openai":
         case "mistral":
@@ -152,12 +230,15 @@ function getProviderAuthHeader(provider, apiKey) {
         case "zhipu":
         case "minimax":
         case "baichuan":
-        case "yi":
             return { name: "authorization", value: `Bearer ${apiKey}` };
         case "anthropic":
             return { name: "x-api-key", value: apiKey };
         case "google":
-            return { name: "x-goog-api-key", value: apiKey };
+            // Google native API uses x-goog-api-key, OpenAI-compatible uses Bearer
+            if (useNativeApi) {
+                return { name: "x-goog-api-key", value: apiKey };
+            }
+            return { name: "authorization", value: `Bearer ${apiKey}` };
         default:
             return null;
     }
@@ -174,10 +255,29 @@ function parsePathPrefix(path) {
     const segment = match[1].toLowerCase();
     const rest = match[2] ?? "/";
     if (exports.KNOWN_PROVIDER_NAMES.includes(segment)) {
-        return { provider: segment, remainingPath: rest };
+        // Apply path rewriting for non-OpenAI-compatible providers
+        const rewrittenPath = rewriteProviderPath(segment, rest);
+        return { provider: segment, remainingPath: rewrittenPath };
     }
     return null;
 }
+/**
+ * Rewrite OpenAI-compatible paths to provider-specific paths.
+ * Some Chinese providers use different endpoint structures.
+ */
+function rewriteProviderPath(provider, path) {
+    switch (provider) {
+        case "minimax":
+            // MiniMax uses /v1/text/chatcompletion_v2 instead of /v1/chat/completions
+            if (path === "/v1/chat/completions" || path.startsWith("/v1/chat/completions?")) {
+                return path.replace("/v1/chat/completions", "/v1/text/chatcompletion_v2");
+            }
+            break;
+        // Zhipu base URL already includes /api/paas, so /v4/chat/completions works directly
+        // Moonshot and Baichuan use standard OpenAI-compatible paths
+    }
+    return path;
+}
 /**
  * Parse a URL path to extract an agent ID from /agents/{id}/... format.
  * Given "/agents/my-bot/openai/v1/chat/completions" returns:

package/dist/providers.js.map

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

package/dist/simhash.d.ts

@@ -0,0 +1,28 @@
+/**
+ * SimHash - Locality Sensitive Hashing for text similarity detection.
+ * Used by Google for web page deduplication.
+ *
+ * Similar texts produce hashes with small Hamming distance.
+ * Different texts produce hashes with large Hamming distance.
+ */
+/**
+ * Compute 64-bit SimHash for text.
+ *
+ * Algorithm:
+ * 1. Tokenize text into n-grams
+ * 2. Hash each token to 64-bit value
+ * 3. For each bit position, sum +1 if bit is 1, -1 if bit is 0
+ * 4. Final hash: bit is 1 if sum > 0, else 0
+ */
+export declare function computeSimHash(text: string): bigint;
+/**
+ * Compute Hamming distance between two SimHash values.
+ * Returns the number of differing bits.
+ */
+export declare function hammingDistance(a: bigint, b: bigint): number;
+/**
+ * Check if two SimHash values are similar.
+ * Default threshold of 3 bits difference is commonly used.
+ */
+export declare function isSimilar(a: bigint, b: bigint, threshold?: number): boolean;
+//# sourceMappingURL=simhash.d.ts.map

package/dist/simhash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simhash.d.ts","sourceRoot":"","sources":["../src/simhash.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiCH;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA8BnD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAW5D;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,SAAI,GAAG,OAAO,CAEtE"}

package/dist/simhash.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * SimHash - Locality Sensitive Hashing for text similarity detection.
+ * Used by Google for web page deduplication.
+ *
+ * Similar texts produce hashes with small Hamming distance.
+ * Different texts produce hashes with large Hamming distance.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeSimHash = computeSimHash;
+exports.hammingDistance = hammingDistance;
+exports.isSimilar = isSimilar;
+// 64-bit SimHash using bigint
+const HASH_BITS = 64n;
+/**
+ * Simple string hash function (FNV-1a variant)
+ */
+function hashToken(token) {
+    let hash = 0xcbf29ce484222325n; // FNV offset basis
+    for (let i = 0; i < token.length; i++) {
+        hash ^= BigInt(token.charCodeAt(i));
+        hash = BigInt.asUintN(64, hash * 0x100000001b3n); // FNV prime
+    }
+    return hash;
+}
+/**
+ * Tokenize text into n-grams (default: 3-grams)
+ */
+function tokenize(text, n = 3) {
+    const normalized = text.toLowerCase().replace(/\s+/g, " ").trim();
+    if (normalized.length < n) {
+        return [normalized];
+    }
+    const tokens = [];
+    for (let i = 0; i <= normalized.length - n; i++) {
+        tokens.push(normalized.slice(i, i + n));
+    }
+    return tokens;
+}
+/**
+ * Compute 64-bit SimHash for text.
+ *
+ * Algorithm:
+ * 1. Tokenize text into n-grams
+ * 2. Hash each token to 64-bit value
+ * 3. For each bit position, sum +1 if bit is 1, -1 if bit is 0
+ * 4. Final hash: bit is 1 if sum > 0, else 0
+ */
+function computeSimHash(text) {
+    const tokens = tokenize(text);
+    if (tokens.length === 0) {
+        return 0n;
+    }
+    // Vector of 64 counters (one per bit position)
+    const vector = new Array(64).fill(0);
+    for (const token of tokens) {
+        const hash = hashToken(token);
+        for (let i = 0; i < 64; i++) {
+            // Check if bit i is set
+            if ((hash >> BigInt(i)) & 1n) {
+                vector[i]++;
+            }
+            else {
+                vector[i]--;
+            }
+        }
+    }
+    // Build final hash from vector
+    let result = 0n;
+    for (let i = 0; i < 64; i++) {
+        if (vector[i] > 0) {
+            result |= 1n << BigInt(i);
+        }
+    }
+    return result;
+}
+/**
+ * Compute Hamming distance between two SimHash values.
+ * Returns the number of differing bits.
+ */
+function hammingDistance(a, b) {
+    let xor = a ^ b;
+    let count = 0;
+    // Count set bits (Brian Kernighan's algorithm)
+    while (xor > 0n) {
+        xor &= xor - 1n;
+        count++;
+    }
+    return count;
+}
+/**
+ * Check if two SimHash values are similar.
+ * Default threshold of 3 bits difference is commonly used.
+ */
+function isSimilar(a, b, threshold = 3) {
+    return hammingDistance(a, b) <= threshold;
+}
+//# sourceMappingURL=simhash.js.map

package/dist/simhash.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentgazer/shared",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Shared types, schemas, and utilities for AgentGazer packages",
   "license": "Apache-2.0",
   "main": "./dist/index.js",