@ai-zen/agents-sdk 0.5.7 → 0.7.0

package/dist/runtime/SdkCallbackTool.d.ts

@@ -1,6 +1,11 @@
 import { Tool, ToolCallContext } from "@ai-zen/agents-core";
 import type { AgentNS } from "@ai-zen/agents-core";
-import type { ToolEnv } from "../types/index.js";
+import type { AgentDefinition, AppConfig, ToolEnv } from "../types/index.js";
+/** SdkCallbackTool 构造选项。env 为核心字段，未来可在此扩展可选项。 */
+export interface SdkCallbackToolOptions {
+    /** 注入的工具环境 */
+    env: ToolEnv;
+}
 /**
  * SdkCallbackTool — SDK 内置工具基类。
  *
@@ -11,18 +16,29 @@ import type { ToolEnv } from "../types/index.js";
  *   - 一个工具一个类，文件名 = 类名（PascalCase）
  *   - 依赖环境（cwd、config）通过构造参数显式注入
  *   - 相对路径统一用 resolve() 解析到 env.cwd
+ *   - 工具定义（function）由子类以类体字段提供（见 SdkCallbackTool.function）
  */
 export declare abstract class SdkCallbackTool extends Tool {
     /** 注入的工具环境 */
     readonly env: ToolEnv;
-    constructor(options: {
-        function: AgentNS.FunctionDefine;
-        env: ToolEnv;
-    });
-    /** 工具核心逻辑（由子类实现，参数为 parsed_args） */
-    abstract call(input: unknown): unknown | Promise<unknown>;
-    /** 桥接 core 的 Tool.exec：解析参数 → call → 序列化 */
-    exec(ctx: ToolCallContext): Promise<string>;
+    /** 工具定义。由子类以类体字段 function = {...} 提供。 */
+    function: AgentNS.FunctionDefine;
+    /**
+     * 工具对当前 Agent 的可用性判断。由工具自行声明，直接透传完整
+     * app config 与 agent definition（含 modelId / permissions 等），工具自取所需
+     * （如是否配置了图片模型、当前模型是否为视觉模型）。
+     * 在 buildTools/filter 阶段调用；返回 false 的工具不会注册给该 Agent。
+     * 不实现则默认可用。
+     */
+    isAvailable?(config: AppConfig, definition: AgentDefinition): boolean;
+    constructor(options: SdkCallbackToolOptions);
+    /**
+     * 工具核心逻辑（由子类实现，参数为 parsedArgs）。
+     * 可选第二参 ctx：透传完整 ToolCallContext，需中止能力（signal）的工具自行读取。
+     */
+    abstract call(input: unknown, ctx?: ToolCallContext): unknown | Promise<unknown>;
+    /** 桥接 core 的 Tool.exec：解析参数 → call → 序列化/透传内容块 */
+    exec(ctx: ToolCallContext): Promise<AgentNS.MessageContent>;
     /** 将相对路径解析到 env.cwd，绝对路径原样返回 */
     resolve(p: string): string;
 }

package/dist/runtime/SdkCallbackTool.js

@@ -10,19 +10,23 @@ import { Tool } from "@ai-zen/agents-core";
  *   - 一个工具一个类，文件名 = 类名（PascalCase）
  *   - 依赖环境（cwd、config）通过构造参数显式注入
  *   - 相对路径统一用 resolve() 解析到 env.cwd
+ *   - 工具定义（function）由子类以类体字段提供（见 SdkCallbackTool.function）
  */
 export class SdkCallbackTool extends Tool {
     /** 注入的工具环境 */
     env;
     constructor(options) {
-        super({ function: options.function });
+        super();
         this.env = options.env;
     }
-    /** 桥接 core 的 Tool.exec：解析参数 → call → 序列化 */
+    /** 桥接 core 的 Tool.exec：解析参数 → call → 序列化/透传内容块 */
     async exec(ctx) {
-        const result = await this.call(ctx.parsed_args);
+        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.5.7",
+  "version": "0.7.0",
   "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.3.1"
+    "openai": "^7.5.0",
+    "@ai-zen/agents-core": "^4.0.0"
   },
   "devDependencies": {
     "@types/node": "^24.12.2",