ToolJournalStart
CORE · interface · 类型合同
Opening record for one tool call, written before the handler runs.
导入
ts
import type { ToolJournalStart } from '@jangts/agent-core/types';js
/** @typedef {import('@jangts/agent-core/types').ToolJournalStart} ToolJournalStart */其他公开入口：@jangts/agent-core/types、@jangts/agent-core/structs。
定义
ts
interface ToolJournalStart字段结构
| 字段 | 类型 | 必需 | 说明 |
|---|---|---|---|
toolId | string | 必需 | Tool being invoked. |
input | unknown | 必需 | Parsed input; stored as-is so the host can build its own domain record. |
invocation | Partial<InvocationMetadata> | undefined | 可省略 | What the caller already knows. The journal fills gaps and generates an id when absent. |
使用示例
- ContextJournal：回执的请求内投影：将真实调用回执变成可用于后续上下文的请求内记录，不另起持久日志系统。
- 宿主已选定调用的同步执行适配：为宿主已经选定的同步调用统一记录开始、完成和失败，不替代选工具与授权。
读取 Runner 已记录的模型回执
入门 · Node.js
ts
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());js
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
ts
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());js
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());