ToolJournalFinish

CORE · interface · 类型合同

Closing record for one tool call, written once with the terminal outcome.

导入

TypeScript

import type { ToolJournalFinish } from '@jangts/agent-core/types';

JavaScript

/** @typedef {import('@jangts/agent-core/types').ToolJournalFinish} ToolJournalFinish */

其他公开入口：@jangts/agent-core/types、@jangts/agent-core/structs。

定义

interface ToolJournalFinish

字段结构

字段	类型	必需	说明
invocationId	string	必需	Invocation opened by beginTool.
status	"error" | "success" | "cancelled"	必需	Terminal status; cancelled is distinct from error.
value	unknown	必需	Produced value on success; failure detail on error; ignored for cancellation.

使用示例

• ContextJournal：回执的请求内投影：将真实调用回执变成可用于后续上下文的请求内记录，不另起持久日志系统。
• 宿主已选定调用的同步执行适配：为宿主已经选定的同步调用统一记录开始、完成和失败，不替代选工具与授权。

读取 Runner 已记录的模型回执

入门 · Node.js

TypeScript

import { ModelRunner } from '@jangts/agent-core';
const runner = new ModelRunner({ provider: { async *stream() { yield '服务运行正常'; } } });
const result = await runner.invoke('查询服务状态');
console.log(result.invocation.invocationId);
console.log(runner.journal.snapshot());

JavaScript

import { ModelRunner } from '@jangts/agent-core';
const runner = new ModelRunner({ provider: { async *stream() { yield '服务运行正常'; } } });
const result = await runner.invoke('查询服务状态');
console.log(result.invocation.invocationId);
console.log(runner.journal.snapshot());

应用适配器记录它实际执行的本地工具

配置 · Node.js

TypeScript

import { ContextJournal } from '@jangts/agent-core/journal';
const journal = new ContextJournal();
const invocationId = journal.beginTool({ toolId: 'get_status', input: {} });
// 此处由 App 实际执行本地读取；不是模型提供的回执。
const status = '服务运行正常';
journal.finishTool({ invocationId, status: 'success', value: status });
console.log(journal.snapshot());

JavaScript

import { ContextJournal } from '@jangts/agent-core/journal';
const journal = new ContextJournal();
const invocationId = journal.beginTool({ toolId: 'get_status', input: {} });
// 此处由 App 实际执行本地读取；不是模型提供的回执。
const status = '服务运行正常';
journal.finishTool({ invocationId, status: 'success', value: status });
console.log(journal.snapshot());

相关策略源码

• 同步调用、取消和回执的边界