@ai-zen/agents-sdk 0.6.0 → 0.7.1

package/dist/runtime/SdkCallbackTool.js

@@ -19,11 +19,14 @@ export class SdkCallbackTool extends Tool {
         super();
         this.env = options.env;
     }
-    /** 桥接 core 的 Tool.exec：解析参数 → call → 序列化 */
+    /** 桥接 core 的 Tool.exec：解析参数 → call → 序列化/透传内容块 */
     async exec(ctx) {
-        const result = await this.call(ctx.parsed_args, ctx);
+        const result = await this.call(ctx.parsedArgs, ctx);
         if (typeof result === "string")
             return result;
+        // 内容块数组（图片/文件等）直接透传，让模型能收到结构化内容
+        if (Array.isArray(result))
+            return result;
         // JSON.stringify(undefined) 返回 undefined（非字符串），会破坏 Promise<string> 契约
         return JSON.stringify(result) ?? "";
     }

package/dist/runtime/createAgent.js

@@ -18,8 +18,8 @@ export async function createAgent(provider, agentId) {
     const modelId = definition.modelId ?? provider.config.defaultModel;
     if (!modelId)
         throw new Error("未指定模型且无默认模型");
-    const model = createModel(provider, modelId);
-    const tools = provider.buildTools(definition.permissions ?? {}, {
+    const { client, model, modelConfig } = createModel(provider, modelId);
+    const tools = provider.buildTools(definition, {
         exclude: {
             subagents: definition.function?.name
                 ? [definition.function.name]
@@ -29,10 +29,11 @@ export async function createAgent(provider, agentId) {
     const agent = new SdkAgent({
         provider,
         definition,
+        client,
         model,
+        modelConfig,
         messages: definition.messages,
         tools,
-        permissions: definition.permissions,
     });
     return agent;
 }

package/dist/runtime/createModel.d.ts

@@ -1,8 +1,21 @@
-import type { ChatCompletionModel } from "@ai-zen/agents-core";
+import OpenAI from "openai";
 import type { Provider } from "./Provider.js";
 /**
- * 模型工厂 — 根据 modelId 和 Provider 构建 Core ChatCompletionModel。
+ * Agent 模型装配结果：openai SDK client + 模型名 + 模型参数。
+ * Agent 构造时直接消费此结构。
+ */
+export interface AgentModel {
+    /** openai 官方 SDK 客户端 */
+    client: OpenAI;
+    /** 发送给 API 的模型名 */
+    model: string;
+    /** 模型参数（defaultParams），透传给 API（可含厂商特有字段，如 DeepSeek thinking） */
+    modelConfig?: Record<string, unknown>;
+}
+/**
+ * 模型工厂 — 根据 modelId 和 Provider 装配 openai SDK client。
  *
- * 同步版本，使用 endp​oint.chatCompletionSync() 避免不必要的 async。
+ * 端点（baseUrl / apiKey）来自 config.endpoints，发送给 API 的模型名 = modelName || id。
+ * 任何 OpenAI 兼容端点（OpenAI / 智谱 BigModel / DeepSeek 等）均可通过 baseURL 接入。
  */
-export declare function createModel(provider: Provider, modelId: string): ChatCompletionModel;
+export declare function createModel(provider: Provider, modelId: string): AgentModel;

package/dist/runtime/createModel.js

@@ -1,8 +1,9 @@
-import { OpenAI, ChatGPT } from "@ai-zen/agents-core";
+import OpenAI from "openai";
 /**
- * 模型工厂 — 根据 modelId 和 Provider 构建 Core ChatCompletionModel。
+ * 模型工厂 — 根据 modelId 和 Provider 装配 openai SDK client。
  *
- * 同步版本，使用 endp​oint.chatCompletionSync() 避免不必要的 async。
+ * 端点（baseUrl / apiKey）来自 config.endpoints，发送给 API 的模型名 = modelName || id。
+ * 任何 OpenAI 兼容端点（OpenAI / 智谱 BigModel / DeepSeek 等）均可通过 baseURL 接入。
  */
 export function createModel(provider, modelId) {
     const config = provider.config;
@@ -12,15 +13,18 @@ export function createModel(provider, modelId) {
     const endpointConfig = config.endpoints.find((e) => e.id === modelConfig.endpointId);
     if (!endpointConfig)
         throw new Error(`端点 "${modelConfig.endpointId}" 未配置`);
-    const endpoint = new OpenAI({
-        openai_endpoint: endpointConfig.baseUrl,
-        api_key: endpointConfig.apiKey,
+    if (!endpointConfig.apiKey) {
+        throw new Error(`端点 "${endpointConfig.name}" 的 API Key 未设置`);
+    }
+    const client = new OpenAI({
+        apiKey: endpointConfig.apiKey,
+        baseURL: endpointConfig.baseUrl,
     });
     // 发送给 API 的模型名：modelName > id
     const apiModelName = modelConfig.modelName || modelConfig.id;
-    const model = new ChatGPT({
-        model_config: modelConfig.defaultParams,
-        request_config: endpoint.chatCompletionSync(apiModelName),
-    });
-    return model;
+    return {
+        client,
+        model: apiModelName,
+        modelConfig: modelConfig.defaultParams,
+    };
 }

package/dist/types/index.d.ts

@@ -29,6 +29,8 @@ export interface Model {
     maxContextTokens: number;
     maxContextChars?: number;
     defaultParams?: Record<string, unknown>;
+    /** 是否支持图片输入（视觉模型）。看图工具（viewImage）仅对视觉模型启用；generateImage 是否返回图片内容块也据此判断 */
+    vision?: boolean;
     description?: string;
     version?: number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-zen/agents-sdk",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "AI-Zen Agents SDK — shared business logic for CLI and Desktop",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -18,7 +18,8 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "dayjs": "^1.11.21",
-    "@ai-zen/agents-core": "^3.4.0"
+    "openai": "^7.5.0",
+    "@ai-zen/agents-core": "^4.0.0"
   },
   "devDependencies": {
     "@types/node": "^24.12.2",