ReflectionReport

KIT · interface · 类型合同

Request-local reflection result.

导入

TypeScript

import type { ReflectionReport } from '@jangts/agent-core/kits/reflection';

JavaScript

/** @typedef {import('@jangts/agent-core/kits/reflection').ReflectionReport} ReflectionReport */

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

定义

interface ReflectionReport

字段结构

字段	类型	必需	说明
id	string	必需	只读。见类型定义及调用场景。
status	"completed" | "incomplete"	必需	只读。incomplete when evidence, model budget or the timeout stopped the work early.
question	string	必需	只读。Question as submitted; at most 2000 characters.
findings	readonly ReflectionFinding[]	必需	只读。见类型定义及调用场景。
limitations	readonly string[]	必需	只读。Known limitations, for example exhausted budgets or incomplete coverage.
evidence	readonly ReflectionEvidence[]	必需	只读。Evidence items the reflection actually saw.
coverage	readonly { readonly consistency: "best-effort" | "snapshot"; readonly complete: boolean | null; readonly gaps: readonly string[]; }[]	必需	只读。Coverage statement of each page that was read.
createdAtMs	number	必需	只读。见类型定义及调用场景。
expiresAtMs	number | undefined	可省略	只读。见类型定义及调用场景。
persisted	false	必需	只读。Marker: a report is returned to the caller and never stored by the Kit.

使用示例

• 日志复盘：授权元数据与证据报告：App 提供获准证据源，复盘任务通过普通模型与工具合同生成有来源的报告。

绑定复盘模型、证据源和授权

入门 · Node.js

TypeScript

import { defineReflection } from '@jangts/agent-core/kits/reflection';
import type { ReflectionSource } from '@jangts/agent-core/kits/reflection';
import type { ModelRunner, OperationContext } from '@jangts/agent-core';

export function review<App>(model: ModelRunner, source: ReflectionSource<App>,
  authorize: (question: string, context: OperationContext<App>) => Promise<void>) {
  return defineReflection({ model, source, authorize,
    maxCalls: 4, reserveCalls: 1, maxPages: 4, maxEvents: 64, maxEvidenceChars: 12000 });
}

JavaScript

import { defineReflection } from '@jangts/agent-core/kits/reflection';
export function review(model, source, authorize) {
    return defineReflection({ model, source, authorize,
        maxCalls: 4, reserveCalls: 1, maxPages: 4, maxEvents: 64, maxEvidenceChars: 12000 });
}

从日志 reader 构造同一种证据源

配置 · Node.js

reader 的目录范围、关闭与保留期由 App 管理。适配后的 source 可传入同一个 defineReflection。

TypeScript

import { defineReflectionLogSource } from '@jangts/agent-core/kits/reflection';
import type { ReflectionLogReader } from '@jangts/agent-core/kits/reflection';
import type { OperationContext } from '@jangts/agent-core';

export function logSource<App>(reader: ReflectionLogReader, traceId: string,
  authorize: (context: OperationContext<App>) => Promise<void>) {
  return defineReflectionLogSource({ reader, traceId, id: 'authorized-history', authorize });
}

JavaScript

import { defineReflectionLogSource } from '@jangts/agent-core/kits/reflection';
export function logSource(reader, traceId, authorize) {
    return defineReflectionLogSource({ reader, traceId, id: 'authorized-history', authorize });
}

相关策略源码

• 复盘证据引用和报告检查

相关定义

• ReflectionEvidence
• ReflectionFinding
• ReflectionPage