@triggerlink/sdk 0.4.5 → 0.4.7

package/README.md

@@ -81,9 +81,9 @@ import { createFunction } from "@triggerlink/sdk";
 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.
+// Built-in providers, zero extra installs: anthropic / openai / deepseek / zai
+// (plus createAnthropic / createOpenAI / createDeepSeek / createZhipu for custom baseURL/apiKey).
+// Default instances read ANTHROPIC_API_KEY / OPENAI_API_KEY / DEEPSEEK_API_KEY / ZHIPU_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
@@ -130,6 +130,29 @@ Notes:
   turns, tool results), each element carrying `role`/`content` — same field name and shape as
   AgentKit's `result.output`, so helpers like `findLastIndex((m) => m.role === "assistant")`
   port directly. `lastAssistantTextMessageContent(result)` is the built-in shortcut.
+- **`lifecycle.onResponse`**: fired once per *actual* LLM call (inside the durable step, after
+  redaction) with `{ result, iteration }`; `result` is an `AgentIterationResult`
+  (`{ text, output, toolCalls, usage }` for that iteration) and works directly with
+  `lastAssistantTextMessageContent(result)`. Memo-hit replays do not re-fire it, so hook side
+  effects run exactly once per LLM call; a throwing hook fails the step (platform retries).
+  There is no `network.state` — because function code is the router, extract results after
+  `agent.run` returns (via `result.output` / `result.toolCalls`), or write to your own storage
+  inside the hook (closure variables don't survive platform re-invocations):
+
+  ```ts
+  const codeAgent = createAgent({
+    name: "code-agent",
+    model: openai("gpt-4.1"),
+    lifecycle: {
+      onResponse: async ({ result }) => {
+        const lastAssistantText = lastAssistantTextMessageContent(result);
+        if (lastAssistantText?.includes("<task_summary>")) {
+          await db.runs.update(runId, { summary: lastAssistantText }); // your own storage
+        }
+      },
+    },
+  });
+  ```
 - **`redact` hook** (optional): transforms each step's output inside `step.run` before
   persistence, e.g. to strip secrets or PII from memos. It must be deterministic and
   replay-safe — the memo is what the model sees of its own prior turns after a crash-resume:

package/dist/agent.d.ts

@@ -9,6 +9,7 @@ export type TextMessage = UserModelMessage | AssistantModelMessage | ToolModelMe
 export { anthropic, createAnthropic } from "@ai-sdk/anthropic";
 export { openai, createOpenAI } from "@ai-sdk/openai";
 export { deepseek, createDeepSeek } from "@ai-sdk/deepseek";
+export { zai, createZhipu } from "zhipu-ai-provider";
 /** Agent 工具定义。parameters 为 zod schema；handler 入参是 schema parse 后的值。 */
 export interface AgentTool<P = unknown, R = unknown> {
     description: string;
@@ -36,6 +37,36 @@ export interface RedactCtx {
  * responseMessages）不得破坏，否则抛错（见 assertLlmMemoShape）。
  */
 export type RedactHook = (output: unknown, ctx: RedactCtx) => unknown;
+/** 单轮 LLM 调用的结果（lifecycle.onResponse 的入参）。 */
+export interface AgentIterationResult {
+    /** 本轮 assistant 文本 */
+    text: string;
+    /** 本轮 assistant 消息（与 lastAssistantTextMessageContent 兼容） */
+    output: TextMessage[];
+    /** 本轮模型发起的工具调用（尚未执行） */
+    toolCalls: Array<{
+        toolCallId: string;
+        toolName: string;
+        input: unknown;
+    }>;
+    usage: {
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+}
+export interface AgentLifecycle {
+    /**
+     * 每次 LLM 调用真实执行后触发一次（memo 命中/恢复重放不触发），
+     * 看到的是 redact 之后的最终内容（与落库 memo、模型历史一致）。
+     * 抛错视同 step 失败：StepError → 平台退避重试（LLM 会被重新调用）。
+     * 注意：函数会被平台反复重入，闭包变量不可靠；要保留 hook 产出请写自己的存储，
+     * 或在 agent.run 返回后从 AgentResult 收尾提取。
+     */
+    onResponse?: (args: {
+        result: AgentIterationResult;
+        iteration: number;
+    }) => void | Promise<void>;
+}
 export interface AgentOpts {
     /** 稳定标识，用作 memo 键前缀（agent/<name>/...）；同一函数内不同 Agent 必须不同名（§5.2） */
     name: string;
@@ -46,6 +77,7 @@ export interface AgentOpts {
     /** 迭代上限（一次迭代 = 一次 LLM 调用 + 其全部工具执行），默认 10；超限抛错使 run 失败 */
     maxIterations?: number;
     redact?: RedactHook;
+    lifecycle?: AgentLifecycle;
 }
 export interface AgentResult {
     /** 最终一条 assistant 文本 */

package/dist/agent.js

@@ -4,12 +4,13 @@
 // 主入口 index.ts 不得 import 本模块（§8.1），否则未装 ai 的普通用户会在 import 时崩溃。
 import { generateText, tool, } from "ai";
 // 内置 provider，开箱即用：默认实例从环境变量读 API key
-// （ANTHROPIC_API_KEY / OPENAI_API_KEY / DEEPSEEK_API_KEY）；
+// （ANTHROPIC_API_KEY / OPENAI_API_KEY / DEEPSEEK_API_KEY / ZHIPU_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";
+export { zai, createZhipu } from "zhipu-ai-provider";
 /**
  * 定义一个 Agent 工具（泛型工厂）：让 zod schema 的类型流到 handler 入参。
  * 与直接写字面量等价，但获得完整的类型推断；跨 Agent 复用工具时也应使用它。
@@ -115,6 +116,17 @@ export function createAgent(opts) {
                     };
                     const out = redact ? redact(memo, { kind: "llm", iteration: i }) : memo;
                     assertLlmMemoShape(out, agent.name); // 落库前拦截坏结构
+                    // onResponse 在 step 回调内触发：只在 LLM 真实执行时跑一次，
+                    // memo 命中/恢复重放不重复触发；抛错视同 step 失败走重试。
+                    await opts.lifecycle?.onResponse?.({
+                        result: {
+                            text: out.text,
+                            output: out.responseMessages,
+                            toolCalls: out.toolCalls,
+                            usage: out.usage,
+                        },
+                        iteration: i,
+                    });
                     return out;
                 });
                 assertLlmMemoShape(llmMemo, agent.name); // memo 命中路径同样校验（防御脏数据）

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.5";
+export declare const sdkVersion = "triggerlink-ts/0.4.6";
 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.5";
+export const sdkVersion = "triggerlink-ts/0.4.6";
 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.5",
+  "version": "0.4.7",
   "description": "TriggerLink TypeScript SDK: durable, crash-recoverable functions for Next.js / Node.js",
   "keywords": [
     "triggerlink",
@@ -59,8 +59,9 @@
   },
   "dependencies": {
     "@ai-sdk/anthropic": "^4.0.39",
-    "@ai-sdk/deepseek": "^3.0.28",
+    "@ai-sdk/deepseek": "^3.0.32",
     "@ai-sdk/openai": "^4.0.42",
-    "ai": "^7.0.66"
+    "ai": "^7.0.66",
+    "zhipu-ai-provider": "^0.4.0"
   }
 }