@triggerlink/sdk 0.4.3 → 0.4.5

package/README.md

@@ -126,6 +126,10 @@ Notes:
   (`{ 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.
+- **Message history**: `AgentResult.output` is the full conversation (user input, assistant
+  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.
 - **`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

@@ -1,6 +1,11 @@
-import { type LanguageModel } from "ai";
+import { type AssistantModelMessage, type LanguageModel, type ToolModelMessage, type UserModelMessage } from "ai";
 import type { ZodType } from "zod";
 import type { StepTool } from "./step.js";
+/**
+ * 对话消息：user / assistant / tool 三种（不含 system——system prompt 走
+ * AgentOpts.system 参数，不进消息列表）。AgentResult.output 的元素类型。
+ */
+export type TextMessage = UserModelMessage | AssistantModelMessage | ToolModelMessage;
 export { anthropic, createAnthropic } from "@ai-sdk/anthropic";
 export { openai, createOpenAI } from "@ai-sdk/openai";
 export { deepseek, createDeepSeek } from "@ai-sdk/deepseek";
@@ -58,7 +63,15 @@ export interface AgentResult {
      * 工具产出，无需解析最终文本。恢复重放时 memo 命中路径同样重建该列表。
      */
     toolCalls: AgentToolCallRecord[];
+    /**
+     * 完整对话历史（user 输入 + 各轮 assistant 消息 + 工具结果），字段名与 AgentKit
+     * 的 result.output 对齐——可自行 findLastIndex 等遍历（元素含 role/content）。
+     * 恢复重放时由 memo 原样重建；启用 redact 时历史内容即脱敏后内容。
+     */
+    output: TextMessage[];
 }
+/** 取最后一条 assistant 消息的文本内容（拼接所有 text part）；没有则返回 undefined。 */
+export declare function lastAssistantTextMessageContent(result: AgentResult): string | undefined;
 /** 一次工具执行的记录。 */
 export interface AgentToolCallRecord {
     toolCallId: string;

package/dist/agent.js

@@ -23,6 +23,22 @@ export function createTool(def) {
         throw new Error("createTool: handler is required");
     return def;
 }
+/** 取最后一条 assistant 消息的文本内容（拼接所有 text part）；没有则返回 undefined。 */
+export function lastAssistantTextMessageContent(result) {
+    // 不用 findLast:tsconfig lib 为 ES2022
+    for (let i = result.output.length - 1; i >= 0; i--) {
+        const msg = result.output[i];
+        if (msg.role !== "assistant")
+            continue;
+        if (typeof msg.content === "string")
+            return msg.content;
+        return msg.content
+            .filter((p) => p.type === "text")
+            .map((p) => p.text)
+            .join("");
+    }
+    return undefined;
+}
 /** redact 钩子可能破坏 llm memo 结构；此处 fail loud，不让坏 memo 落库或参与历史重建（§5.7）。 */
 function assertLlmMemoShape(m, name) {
     const o = m;
@@ -106,7 +122,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, toolCalls };
+                    return { text: llmMemo.text, iterations: i + 1, usage, toolCalls, output: messages };
                 }
                 // 并行 tool call 顺序执行（数组序），每个一个 durable step（§5.3）
                 for (const call of llmMemo.toolCalls) {

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