@xiaozhiclaw/provider-core 0.1.0

package/dist/transports/zhipu-tool-api.js

@@ -0,0 +1,126 @@
+/**
+ * ZhipuToolAPI 鈥?Zhipu-specific utility endpoints.
+ *
+ * Implements ProviderToolAPI for Zhipu GLM platform independent APIs:
+ *   C1: Web Search  鈥?POST /tools/web-search
+ *   C2: Reader      鈥?POST /tools/reader (extract web page content)
+ *   C3: Tokenizer   鈥?POST /tokenizer
+ *   C4: Moderations 鈥?POST /moderations
+ *
+ * Base URL: https://open.bigmodel.cn/api/paas/v4
+ * Auth: Authorization: Bearer $ZHIPU_API_KEY
+ *
+ * C5 (File Parser) is handled by document_parsing media handler.
+ * C6 (Realtime API) requires WebSocket 鈥?out of scope for this interface.
+ */
+const DEFAULT_TIMEOUT_MS = 30_000;
+export class ZhipuToolAPI {
+    capabilities = [
+        "web_search", "reader", "tokenizer", "moderations",
+    ];
+    baseUrl;
+    apiKey;
+    timeoutMs;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/+$/, "");
+        this.apiKey = config.apiKey;
+        this.timeoutMs = config.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    }
+    // 鈹€鈹€ C1: Web Search 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
+    async webSearch(query, options) {
+        const url = `${this.baseUrl}/tools/web-search`;
+        const body = {
+            tool: "web-search-pro",
+            messages: [{ role: "user", content: query }],
+            stream: false,
+        };
+        // GLM web-search returns structured search_result in choices
+        const data = await this.postJSON(url, body);
+        // Extract results from either format
+        const results = [];
+        const maxResults = options?.maxResults ?? 10;
+        // Format 1: web_search array at top level
+        if (data.web_search) {
+            for (const r of data.web_search.slice(0, maxResults)) {
+                results.push({
+                    title: r.title ?? "",
+                    url: r.link ?? "",
+                    snippet: (r.content ?? "").slice(0, 500),
+                    content: r.content,
+                });
+            }
+            return results;
+        }
+        // Format 2: nested in choices[].message.tool_calls[].search_result
+        for (const choice of data.choices ?? []) {
+            for (const tc of choice.message?.tool_calls ?? []) {
+                for (const sr of tc.search_result ?? []) {
+                    if (results.length >= maxResults)
+                        break;
+                    results.push({
+                        title: sr.title ?? "",
+                        url: sr.link ?? "",
+                        snippet: (sr.content ?? "").slice(0, 500),
+                        content: sr.content,
+                    });
+                }
+            }
+        }
+        return results;
+    }
+    // 鈹€鈹€ C2: Reader 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
+    async reader(pageUrl) {
+        const url = `${this.baseUrl}/tools/reader`;
+        const body = {
+            tool: "reader",
+            messages: [{ role: "user", content: pageUrl }],
+            stream: false,
+        };
+        const data = await this.postJSON(url, body);
+        const content = data.choices?.[0]?.message?.content ?? "";
+        return {
+            title: "",
+            content,
+            url: pageUrl,
+        };
+    }
+    // 鈹€鈹€ C3: Tokenizer 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
+    async tokenize(text, model) {
+        const url = `${this.baseUrl}/tokenizer`;
+        const body = { model, messages: [{ role: "user", content: text }] };
+        const data = await this.postJSON(url, body);
+        return {
+            tokenCount: data.usage?.total_tokens ?? 0,
+            model,
+        };
+    }
+    // 鈹€鈹€ C4: Moderations 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
+    async moderate(text) {
+        const url = `${this.baseUrl}/moderations`;
+        const body = { input: text };
+        const data = await this.postJSON(url, body);
+        const first = data.results?.[0];
+        return {
+            flagged: first?.flagged ?? false,
+            categories: first?.categories ?? {},
+            scores: first?.category_scores,
+        };
+    }
+    // 鈹€鈹€ Helper 鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€鈹€
+    async postJSON(url, body) {
+        const res = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${this.apiKey}`,
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(this.timeoutMs),
+        });
+        if (!res.ok) {
+            const errText = await res.text().catch(() => "");
+            throw new Error(`Zhipu Tool API error ${res.status}: ${errText}`);
+        }
+        return res.json();
+    }
+}

package/dist/wire-types.d.ts

@@ -0,0 +1,51 @@
+export type ChatMessageRole = "system" | "user" | "assistant" | "tool";
+export interface ThinkingBlock {
+    thinking: string;
+    signature: string;
+}
+export interface ToolCallMessage {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+export interface ChatMessage {
+    role: ChatMessageRole;
+    content: string | null;
+    tool_calls?: ToolCallMessage[];
+    tool_call_id?: string;
+    name?: string;
+    thinkingBlocks?: ThinkingBlock[];
+    imageUrls?: string[];
+    imageDetail?: "auto" | "low" | "high" | "xhigh";
+    imagePixelLimit?: {
+        minPixels?: number;
+        maxPixels?: number;
+    };
+    videoUrls?: string[];
+    videoFps?: number;
+    audioFormat?: "mp3" | "wav" | "aac" | "m4a";
+    audioUrls?: string[];
+    fileIds?: Array<{
+        id: string;
+        mimeType?: string;
+        size?: number;
+    }>;
+}
+export interface ToolDefinition {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters?: Record<string, unknown>;
+    };
+    meta?: {
+        serialOnly?: boolean;
+        parallelSafe?: boolean;
+        requiresApproval?: boolean;
+        isReadOnly?: boolean;
+        isDangerous?: boolean;
+    };
+}

package/dist/wire-types.js

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

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@xiaozhiclaw/provider-core",
+  "version": "0.1.0",
+  "description": "Shared QLogic LLM provider adaptation layer",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
+  },
+  "files": [
+    "dist/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "dependencies": {},
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}