EvidenceProjectionProvider

KIT · interface · Type contract

Describes which sources an observation can cite, and how to narrow it to cited ones.

Import

TypeScript

import type { EvidenceProjectionProvider } from '@jangts/agent-core/kits/evidence';

JavaScript

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

Other public entry points:@jangts/agent-core, @jangts/agent-core/types, @jangts/agent-core/structs, @jangts/agent-core/kits/evidence, @jangts/agent-core/kits.

Definition

interface EvidenceProjectionProvider<Observation, Source>

Type parameters

Type parameter	Constraint	Default type
Observation	—	—
Source	—	—

Field structure

Field	Type	Required	Description
sources	(observation: Observation) => readonly Source[]	Required	All sources the observation currently carries.
withSources	(observation: Observation, sources: Source[]) => Observation	Required	Returns a copy of the observation restricted to sources.

Member index

Member	Purpose
sources	All sources the observation currently carries.
withSources	Returns a copy of the observation restricted to sources.

Member details

sources

All sources the observation currently carries.

EvidenceProjectionProvider.sources(observation: Observation): readonly Source[]

All sources the observation currently carries.

Parameter	Type	Passing	Description
observation	Observation	Required	—

Returns: readonly Source[].

withSources

Returns a copy of the observation restricted to sources.

EvidenceProjectionProvider.withSources(observation: Observation, sources: Source[]): Observation

Returns a copy of the observation restricted to sources.

Parameter	Type	Passing	Description
observation	Observation	Required	—
sources	Source[]	Required	—

Returns: Observation.

Awaited value: Awaited<Observation>.

Examples

• Evidence: check completeness with real observations: Check requirements against App-defined evidence semantics instead of treating a model saying it is done as a real receipt.

Check whether real material has been read

Beginner · Node.js

TypeScript

import { Evidence } from '@jangts/agent-core/kits/evidence';
type Observation = { sourceId: string; read: boolean };
type Requirement = { id: string; kind: 'source-read'; sourceId: string };
const checklist = Evidence.defineEvidenceChecklist<Observation, Requirement>([
  { kind: 'source-read', description: '资料读取已成功', isSatisfied: (seen, need) => seen.read && seen.sourceId === need.sourceId },
]);
console.log(checklist.isComplete({ observations: [{ sourceId: 'manual', read: true }], requirements: [{ id: 'need-manual', kind: 'source-read', sourceId: 'manual' }] }));

JavaScript

import { Evidence } from '@jangts/agent-core/kits/evidence';
const checklist = Evidence.defineEvidenceChecklist([
    { kind: 'source-read', description: '资料读取已成功', isSatisfied: (seen, need) => seen.read && seen.sourceId === need.sourceId },
]);
console.log(checklist.isComplete({ observations: [{ sourceId: 'manual', read: true }], requirements: [{ id: 'need-manual', kind: 'source-read', sourceId: 'manual' }] }));

Return gaps from the same checklist, then limit the sources used for review

Configuration · Node.js

TypeScript

import { Evidence } from '@jangts/agent-core/kits/evidence';
type Observation = { sourceId: string; read: boolean };
type Requirement = { id: string; kind: 'source-read'; sourceId: string };
const checklist = Evidence.defineEvidenceChecklist<Observation, Requirement>([
  { kind: 'source-read', description: '资料读取已成功', isSatisfied: (seen, need) => seen.read && seen.sourceId === need.sourceId },
]);
console.log(checklist.missing({ observations: [], requirements: [{ id: 'need-manual', kind: 'source-read', sourceId: 'manual' }] }));
type ToolObservation = { toolId: string; sources: { id: string; text: string }[] };
const projection = Evidence.defineEvidenceProjection<ToolObservation, { id: string; text: string }>({
  sourceId: source => source.id,
  providers: { search: { sources: row => row.sources, withSources: (row, sources) => ({ ...row, sources }) } },
});
console.log(projection.project({ observations: [{ toolId: 'search', sources: [{ id: 'manual', text: '使用指南' }, { id: 'faq', text: '常见问题' }] }], sourceIds: ['manual'] }));

JavaScript

import { Evidence } from '@jangts/agent-core/kits/evidence';
const checklist = Evidence.defineEvidenceChecklist([
    { kind: 'source-read', description: '资料读取已成功', isSatisfied: (seen, need) => seen.read && seen.sourceId === need.sourceId },
]);
console.log(checklist.missing({ observations: [], requirements: [{ id: 'need-manual', kind: 'source-read', sourceId: 'manual' }] }));
const projection = Evidence.defineEvidenceProjection({
    sourceId: source => source.id,
    providers: { search: { sources: row => row.sources, withSources: (row, sources) => ({ ...row, sources }) } },
});
console.log(projection.project({ observations: [{ toolId: 'search', sources: [{ id: 'manual', text: '使用指南' }, { id: 'faq', text: '常见问题' }] }], sourceIds: ['manual'] }));

Related policy source

• Completeness and evidence projection rules