@triggerlink/sdk 0.4.0 → 0.4.2

package/README.md

@@ -73,26 +73,33 @@ Built on the [Vercel AI SDK](https://github.com/vercel/ai) for multi-provider
 support; design details in [`docs/agent-design.md`](../docs/agent-design.md).
 
 ```bash
-npm install @triggerlink/sdk ai zod @ai-sdk/anthropic   # or another AI SDK provider
+npm install @triggerlink/sdk zod   # zod is for tool schemas; ai + providers are bundled
 ```
 
 ```ts
 import { createFunction } from "@triggerlink/sdk";
-import { createAgent } from "@triggerlink/sdk/agent";   // subpath import, not the main entry
-import { anthropic } from "@ai-sdk/anthropic";
+import { createAgent, createTool, anthropic } from "@triggerlink/sdk/agent";   // subpath import, not the main entry
 import { z } from "zod";
 
+// Built-in providers, zero extra installs: anthropic / openai / deepseek
+// (plus createAnthropic / createOpenAI / createDeepSeek for custom baseURL/apiKey).
+// Default instances read ANTHROPIC_API_KEY / OPENAI_API_KEY / DEEPSEEK_API_KEY from the env.
+// Any other AI SDK LanguageModel can still be passed as `model` directly.
+
+// createTool is a generic factory: the zod schema's type flows into the handler's
+// params — annotate nothing. Plain object literals also work; use createTool when
+// sharing a tool across agents.
+const searchKb = createTool({
+  description: "Search the knowledge base",
+  parameters: z.object({ query: z.string() }),
+  handler: async ({ query }) => kb.search(query),   // query: string, inferred
+});
+
 const researcher = createAgent({
   name: "researcher",                    // stable ID, used in memo keys — do not rename casually
   model: anthropic("claude-sonnet-4-5"), // any AI SDK LanguageModel
   system: "You are a research assistant. Answer concisely.",
-  tools: {
-    search: {
-      description: "Search the knowledge base",
-      parameters: z.object({ query: z.string() }),
-      handler: async ({ query }) => kb.search(query),
-    },
-  },
+  tools: { search: searchKb },
   maxIterations: 10,                     // safety cap; the run fails when exceeded
 });
 
@@ -123,7 +130,8 @@ Notes:
   callback timeout (5 minutes by default); two different agents in one function must have
   different `name`s; changing the tool set or loop structure between retries of the same run
   can misalign memo keys (changing prompt text is safe).
-- The `ai` and `zod` packages are optional peer dependencies — only agent users install them.
+- `ai` and the three built-in providers are regular dependencies of the SDK (bundled, no extra install); `zod` is an optional peer dependency — install it if you define tool schemas.
+- **HTTP proxies**: if your environment routes external traffic through `http_proxy`/`https_proxy`, note that Node's global `fetch` ignores them by default — LLM calls will fail with `AI_APICallError: Cannot connect to API`. On Node 24+, start your app with `node --use-env-proxy`; on older Node, install `undici` and set `setGlobalDispatcher(new EnvHttpProxyAgent())` before serving.
 
 ## Sending events (any TS code, modeled after Inngest's `inngest.send`)
 

package/dist/agent.d.ts

@@ -1,12 +1,20 @@
 import { type LanguageModel } from "ai";
 import type { ZodType } from "zod";
 import type { StepTool } from "./step.js";
+export { anthropic, createAnthropic } from "@ai-sdk/anthropic";
+export { openai, createOpenAI } from "@ai-sdk/openai";
+export { deepseek, createDeepSeek } from "@ai-sdk/deepseek";
 /** Agent 工具定义。parameters 为 zod schema；handler 入参是 schema parse 后的值。 */
 export interface AgentTool<P = unknown, R = unknown> {
     description: string;
     parameters: ZodType<P>;
     handler: (params: P) => Promise<R> | R;
 }
+/**
+ * 定义一个 Agent 工具（泛型工厂）：让 zod schema 的类型流到 handler 入参。
+ * 与直接写字面量等价，但获得完整的类型推断；跨 Agent 复用工具时也应使用它。
+ */
+export declare function createTool<P, R>(def: AgentTool<P, R>): AgentTool<P, R>;
 /** redact 钩子的上下文（§5.7）。 */
 export interface RedactCtx {
     /** 产生输出的 step 类型 */
@@ -29,7 +37,7 @@ export interface AgentOpts {
     /** AI SDK 的 LanguageModel（用户自带 provider 包，如 @ai-sdk/anthropic） */
     model: LanguageModel;
     system?: string;
-    tools?: Record<string, AgentTool>;
+    tools?: Record<string, AgentTool<any, any>>;
     /** 迭代上限（一次迭代 = 一次 LLM 调用 + 其全部工具执行），默认 10；超限抛错使 run 失败 */
     maxIterations?: number;
     redact?: RedactHook;

package/dist/agent.js

@@ -3,6 +3,26 @@
 // 本模块只通过子路径 @triggerlink/sdk/agent 导出——ai/zod 是 optional peer 依赖，
 // 主入口 index.ts 不得 import 本模块（§8.1），否则未装 ai 的普通用户会在 import 时崩溃。
 import { generateText, tool, } from "ai";
+// 内置 provider，开箱即用：默认实例从环境变量读 API key
+// （ANTHROPIC_API_KEY / OPENAI_API_KEY / DEEPSEEK_API_KEY）；
+// 需要自定义 baseURL/apiKey/代理时用 createXxx 构造专属实例。
+// 其余 provider 不受影响：createAgent 的 model 接受任意 AI SDK LanguageModel。
+export { anthropic, createAnthropic } from "@ai-sdk/anthropic";
+export { openai, createOpenAI } from "@ai-sdk/openai";
+export { deepseek, createDeepSeek } from "@ai-sdk/deepseek";
+/**
+ * 定义一个 Agent 工具（泛型工厂）：让 zod schema 的类型流到 handler 入参。
+ * 与直接写字面量等价，但获得完整的类型推断；跨 Agent 复用工具时也应使用它。
+ */
+export function createTool(def) {
+    if (!def.description)
+        throw new Error("createTool: description is required");
+    if (!def.parameters)
+        throw new Error("createTool: parameters is required");
+    if (typeof def.handler !== "function")
+        throw new Error("createTool: handler is required");
+    return def;
+}
 /** redact 钩子可能破坏 llm memo 结构；此处 fail loud，不让坏 memo 落库或参与历史重建（§5.7）。 */
 function assertLlmMemoShape(m, name) {
     const o = m;

package/dist/serve.d.ts

@@ -1,6 +1,6 @@
 import type { Client } from "./client.js";
 import type { TriggerFunction } from "./function.js";
-export declare const sdkVersion = "triggerlink-ts/0.4.0";
+export declare const sdkVersion = "triggerlink-ts/0.4.2";
 export declare const SIGNATURE_HEADER = "x-triggerlink-signature";
 export interface ServeOptions {
     client: Client;

package/dist/serve.js

@@ -1,7 +1,7 @@
 import { ExecCtx, StepInterrupt } from "./execx.js";
 import { createStepTool, errMessage } from "./step.js";
 import { verifySignature } from "./sign.js";
-export const sdkVersion = "triggerlink-ts/0.4.0";
+export const sdkVersion = "triggerlink-ts/0.4.2";
 export const SIGNATURE_HEADER = "x-triggerlink-signature";
 const MAX_BODY = 10 << 20; // 10 MB，与平台一致
 function json(data, status = 200) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@triggerlink/sdk",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "TriggerLink TypeScript SDK: durable, crash-recoverable functions for Next.js / Node.js",
   "keywords": [
     "triggerlink",
@@ -36,6 +36,9 @@
     "prepublishOnly": "npm run build"
   },
   "license": "MIT",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/bearalise/triggerlink.git",
@@ -43,20 +46,21 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "ai": "^7.0.66",
     "typescript": "^5.5.0",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "ai": "^7.0.0",
     "zod": "^3.25.76 || ^4.1.8"
   },
   "peerDependenciesMeta": {
-    "ai": {
-      "optional": true
-    },
     "zod": {
       "optional": true
     }
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "^4.0.39",
+    "@ai-sdk/deepseek": "^3.0.28",
+    "@ai-sdk/openai": "^4.0.42",
+    "ai": "^7.0.66"
   }
 }