@triggerlink/sdk 0.4.2 → 0.4.3

package/README.md

@@ -122,6 +122,10 @@ Notes:
   *L + T* platform callbacks (one per step). Each step appears in the dashboard run detail
   with its output — per-call tracing and token usage for free.
 - **Multi-tool responses** are executed sequentially in array order, one step each.
+- **Structured tool outputs**: `AgentResult.toolCalls` lists every tool execution of the run
+  (`{ toolCallId, toolName, input, output }`, in order; rebuilt from memos on recovery).
+  This covers the "done tool writes to shared state" pattern from agent frameworks like
+  AgentKit — read the tool's output here instead of parsing the final text.
 - **`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

@@ -52,6 +52,20 @@ export interface AgentResult {
         inputTokens: number;
         outputTokens: number;
     };
+    /**
+     * 本次运行的全部工具执行记录（按执行顺序，含结构化输出）。
+     * 覆盖 AgentKit 的 "done 工具写 state.kv" 模式：函数代码从这里的 output 读取
+     * 工具产出，无需解析最终文本。恢复重放时 memo 命中路径同样重建该列表。
+     */
+    toolCalls: AgentToolCallRecord[];
+}
+/** 一次工具执行的记录。 */
+export interface AgentToolCallRecord {
+    toolCallId: string;
+    toolName: string;
+    input: unknown;
+    /** 工具的返回值（redact 钩子启用时为脱敏后的值——与模型所见一致） */
+    output: unknown;
 }
 export interface Agent {
     readonly name: string;

package/dist/agent.js

@@ -75,6 +75,7 @@ export function createAgent(opts) {
             const toolStepId = `agent/${agent.name}/tool`;
             const messages = [{ role: "user", content: input }];
             const usage = { inputTokens: 0, outputTokens: 0 };
+            const toolCalls = [];
             for (let i = 0;; i++) {
                 if (i >= maxIterations) {
                     throw new Error(`agent "${agent.name}": maxIterations (${maxIterations}) exceeded`);
@@ -105,7 +106,7 @@ export function createAgent(opts) {
                 usage.outputTokens += llmMemo.usage.outputTokens ?? 0;
                 messages.push(...llmMemo.responseMessages);
                 if (llmMemo.toolCalls.length === 0) {
-                    return { text: llmMemo.text, iterations: i + 1, usage };
+                    return { text: llmMemo.text, iterations: i + 1, usage, toolCalls };
                 }
                 // 并行 tool call 顺序执行（数组序），每个一个 durable step（§5.3）
                 for (const call of llmMemo.toolCalls) {
@@ -119,6 +120,8 @@ export function createAgent(opts) {
                             ? redact(out, { kind: "tool", iteration: i, toolName: call.toolName })
                             : out;
                     });
+                    // memo 命中时 step.run 直接返回缓存值,重放路径同样补全记录
+                    toolCalls.push({ toolCallId: call.toolCallId, toolName: call.toolName, input: call.input, output });
                     const toolMsg = {
                         role: "tool",
                         content: [

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.2";
+export declare const sdkVersion = "triggerlink-ts/0.4.3";
 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.2";
+export const sdkVersion = "triggerlink-ts/0.4.3";
 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.2",
+  "version": "0.4.3",
   "description": "TriggerLink TypeScript SDK: durable, crash-recoverable functions for Next.js / Node.js",
   "keywords": [
     "triggerlink",