Skip to content

@codesoul-co/hypha-harness / react-quantum-executor

模块用法

用于执行该边界的运行时行为。React quantum executor 模块公开 3 类、1 常量、1 函数、13 接口、1 类型。

从包入口导入

ts
import {
  ArtifactReActContextSnapshotStore,
  ContinuationIdentityValidator,
  ReActQuantumExecutor,
  REACT_CONTEXT_SNAPSHOT_VERSION,
  createContinuationReActQuantumDescriptor,
} from '@codesoul-co/hypha-harness';

import type {
  ArtifactReActContextSnapshotStoreOptions,
  ExecuteReActQuantumRequest,
  ExecuteReActQuantumResult,
  ReActContextSnapshot,
  ReActContextSnapshotPutResult,
  ReActContextSnapshotStore,
  ReActOperationReceiptReconciler,
  ReActQuantumExecutorOptions,
} from '@codesoul-co/hypha-harness';

// 完整导出列表见下方。

使用要点

  • 14 个类型/接口用于应用代码、Adapter 或测试中的静态契约;请使用 import type,运行时不应依赖它们。
  • 3 个类提供可实例化的运行时实现;构造参数与公开方法在各自条目中完整列出。
  • 1 个函数是该模块的直接操作入口;每个 overload 的必需/可选参数与返回类型均在下方列出。
  • 1 个常量/枚举提供稳定值、Schema、Definition 或默认配置;应复用这些导出,避免在应用中复制内部值。

公共导出

Symbol种类签名说明
ArtifactReActContextSnapshotStorenew ArtifactReActContextSnapshotStore(options: ArtifactReActContextSnapshotStoreOptions): ArtifactReActContextSnapshotStoreDurable content-addressed Context snapshots selected by the checkpoint scope hash.
ContinuationIdentityValidatornew ContinuationIdentityValidator(): ContinuationIdentityValidatorContinuation Identity Validator 类,共公开 5 个构造函数或成员;精确签名见本条目的声明与成员表。
ReActQuantumExecutornew ReActQuantumExecutor(options: ReActQuantumExecutorOptions): ReActQuantumExecutorRebuilds and executes exactly one fenced ReAct quantum from durable Runtime evidence.
REACT_CONTEXT_SNAPSHOT_VERSION常量const REACT_CONTEXT_SNAPSHOT_VERSION: "1.0.0"react-quantum-executor 模块导出的 REACT CONTEXT SNAPSHOT VERSION 常量。
createContinuationReActQuantumDescriptor函数createContinuationReActQuantumDescriptor(command: Readonly<SessionCommandRecord>, input: unknown): ContinuationReActQuantumDescriptorCreate Continuation ReAct Quantum Descriptor 函数,提供 1 个公开调用签名;参数与返回类型见下表。
ArtifactReActContextSnapshotStoreOptions接口interface ArtifactReActContextSnapshotStoreOptionsArtifact ReAct Context Snapshot Store Options 接口,共包含 2 个公开字段或方法。
ExecuteReActQuantumRequest接口interface ExecuteReActQuantumRequestExecute ReAct Quantum Request 接口,共包含 3 个公开字段或方法。
ExecuteReActQuantumResult接口interface ExecuteReActQuantumResultExecute ReAct Quantum Result 接口,共包含 2 个公开字段或方法。
ReActContextSnapshot接口interface ReActContextSnapshotReAct Context Snapshot 接口,共包含 7 个公开字段或方法。
ReActContextSnapshotPutResult接口interface ReActContextSnapshotPutResultReAct Context Snapshot Put Result 接口,共包含 3 个公开字段或方法。
ReActContextSnapshotStore接口interface ReActContextSnapshotStoreReAct Context Snapshot Store 接口,共包含 3 个公开字段或方法。
ReActOperationReceiptReconciler接口interface ReActOperationReceiptReconcilerReAct Operation Receipt Reconciler 接口,共包含 1 个公开字段或方法。
ReActQuantumExecutorOptions接口interface ReActQuantumExecutorOptionsReAct Quantum Executor Options 接口,共包含 10 个公开字段或方法。
ReActQuantumOutcomeRecorder接口interface ReActQuantumOutcomeRecorderReAct Quantum Outcome Recorder 接口,共包含 1 个公开字段或方法。
ReActQuantumRevisionValidator接口interface ReActQuantumRevisionValidatorReAct Quantum Revision Validator 接口,共包含 1 个公开字段或方法。
ReActQuantumRunnerFactory接口interface ReActQuantumRunnerFactoryReAct Quantum Runner Factory 接口,共包含 1 个公开字段或方法。
ReActQuantumRuntimeReader接口interface ReActQuantumRuntimeReaderReAct Quantum Runtime Reader 接口,共包含 1 个公开字段或方法。
ReActQuantumRuntimeState接口interface ReActQuantumRuntimeStateReAct Quantum Runtime State 接口,共包含 10 个公开字段或方法。
ReActQuantumRuntimeStatus类型type ReActQuantumRuntimeStatus = 'created' | 'running' | 'waiting_human' | 'completed' | 'failed' | 'cancelled'ReAct Quantum Runtime Status 公共类型别名;完整类型表达式见声明。

ArtifactReActContextSnapshotStore

Durable content-addressed Context snapshots selected by the checkpoint scope hash.

  • 种类: 类
  • 导入: import { ArtifactReActContextSnapshotStore } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export declare class ArtifactReActContextSnapshotStore implements ReActContextSnapshotStore {
    constructor(options: ArtifactReActContextSnapshotStoreOptions);
    put(input: ReActContextSnapshot): Promise<ReActContextSnapshotPutResult>;
    get(scopeHash: string): Promise<ReActContextSnapshot | null>;
    delete(scopeHash: string): Promise<boolean>;
}

公开成员

成员种类签名说明
constructor构造函数(options: ArtifactReActContextSnapshotStoreOptions): ArtifactReActContextSnapshotStore创建该类的实例。
delete方法delete(scopeHash: string): Promise<boolean>公开方法;参数与返回类型以签名列为准。
get方法get(scopeHash: string): Promise<ReActContextSnapshot | null>公开方法;参数与返回类型以签名列为准。
put方法put(input: ReActContextSnapshot): Promise<ReActContextSnapshotPutResult>公开方法;参数与返回类型以签名列为准。

ContinuationIdentityValidator

Continuation Identity Validator 类,共公开 5 个构造函数或成员;精确签名见本条目的声明与成员表。

  • 种类: 类
  • 导入: import { ContinuationIdentityValidator } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export declare class ContinuationIdentityValidator {
    validateCommand(command: Readonly<SessionCommandRecord>, descriptor: Readonly<ContinuationReActQuantumDescriptor>): void;
    validateCheckpoint(descriptor: Readonly<ContinuationReActQuantumDescriptor>, checkpoint: Readonly<ReActContinuationCheckpoint>, checkpointRef: string): void;
    validateSnapshot(descriptor: Readonly<ReActQuantumDescriptor>, snapshot: Readonly<ReActContextSnapshot>): void;
    validateRuntimeState(descriptor: Readonly<ReActQuantumDescriptor>, state: Readonly<ReActQuantumRuntimeState>): void;
}

公开成员

成员种类签名说明
constructor构造函数(): ContinuationIdentityValidator创建该类的实例。
validateCheckpoint方法validateCheckpoint(descriptor: Readonly<ContinuationReActQuantumDescriptor>, checkpoint: Readonly<ReActContinuationCheckpoint>, checkpointRef: string): void公开方法;参数与返回类型以签名列为准。
validateCommand方法validateCommand(command: Readonly<SessionCommandRecord>, descriptor: Readonly<ContinuationReActQuantumDescriptor>): void公开方法;参数与返回类型以签名列为准。
validateRuntimeState方法validateRuntimeState(descriptor: Readonly<ReActQuantumDescriptor>, state: Readonly<ReActQuantumRuntimeState>): void公开方法;参数与返回类型以签名列为准。
validateSnapshot方法validateSnapshot(descriptor: Readonly<ReActQuantumDescriptor>, snapshot: Readonly<ReActContextSnapshot>): void公开方法;参数与返回类型以签名列为准。

ReActQuantumExecutor

Rebuilds and executes exactly one fenced ReAct quantum from durable Runtime evidence.

  • 种类: 类
  • 导入: import { ReActQuantumExecutor } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export declare class ReActQuantumExecutor {
    constructor(options: ReActQuantumExecutorOptions);
    runOneQuantum(input: ExecuteReActQuantumRequest): Promise<ExecuteReActQuantumResult>;
}

公开成员

成员种类签名说明
constructor构造函数(options: ReActQuantumExecutorOptions): ReActQuantumExecutor创建该类的实例。
runOneQuantum方法runOneQuantum(input: ExecuteReActQuantumRequest): Promise<ExecuteReActQuantumResult>公开方法;参数与返回类型以签名列为准。

REACT_CONTEXT_SNAPSHOT_VERSION

react-quantum-executor 模块导出的 REACT CONTEXT SNAPSHOT VERSION 常量。

  • 种类: 常量
  • 导入: import { REACT_CONTEXT_SNAPSHOT_VERSION } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export declare const REACT_CONTEXT_SNAPSHOT_VERSION: "1.0.0";

createContinuationReActQuantumDescriptor

Create Continuation ReAct Quantum Descriptor 函数,提供 1 个公开调用签名;参数与返回类型见下表。

  • 种类: 函数
  • 导入: import { createContinuationReActQuantumDescriptor } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export declare function createContinuationReActQuantumDescriptor(command: Readonly<SessionCommandRecord>, input: unknown): ContinuationReActQuantumDescriptor;

调用签名

text
createContinuationReActQuantumDescriptor(command: Readonly<SessionCommandRecord>, input: unknown): ContinuationReActQuantumDescriptor

参数

参数类型必需说明
commandReadonly<SessionCommandRecord>必需参数;接受的值由类型列定义。
inputunknown必需参数;接受的值由类型列定义。

返回值

  • 类型: ContinuationReActQuantumDescriptor
  • 说明: 返回值契约由上述类型定义。

ArtifactReActContextSnapshotStoreOptions

Artifact ReAct Context Snapshot Store Options 接口,共包含 2 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { ArtifactReActContextSnapshotStoreOptions } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export interface ArtifactReActContextSnapshotStoreOptions {
    artifacts: ArtifactStoreProvider;
    maxSnapshotBytes?: number;
}

契约成员

成员种类签名说明
artifacts属性artifacts: ArtifactStoreProvider公开属性;类型、只读和可选状态以签名列为准。
maxSnapshotBytes属性maxSnapshotBytes?: number公开属性;类型、只读和可选状态以签名列为准。

ExecuteReActQuantumRequest

Execute ReAct Quantum Request 接口,共包含 3 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { ExecuteReActQuantumRequest } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export interface ExecuteReActQuantumRequest {
    command?: Readonly<SessionCommandRecord>;
    descriptor: ReActQuantumDescriptor;
    signal: AbortSignal;
}

契约成员

成员种类签名说明
command属性command?: Readonly<SessionCommandRecord>公开属性;类型、只读和可选状态以签名列为准。
descriptor属性descriptor: ReActQuantumDescriptor公开属性;类型、只读和可选状态以签名列为准。
signal属性signal: AbortSignal公开属性;类型、只读和可选状态以签名列为准。

ExecuteReActQuantumResult

Execute ReAct Quantum Result 接口,共包含 2 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { ExecuteReActQuantumResult } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export interface ExecuteReActQuantumResult {
    disposition: 'completed' | 'suspended' | 'waiting_human' | 'cancelled' | 'failed' | 'terminal';
    react?: ReActRunResult;
}

契约成员

成员种类签名说明
disposition属性disposition: "completed" | "cancelled" | "failed" | "suspended" | "waiting_human" | "terminal"公开属性;类型、只读和可选状态以签名列为准。
react属性react?: ReActRunResult公开属性;类型、只读和可选状态以签名列为准。

ReActContextSnapshot

ReAct Context Snapshot 接口,共包含 7 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { ReActContextSnapshot } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export interface ReActContextSnapshot {
    version: typeof REACT_CONTEXT_SNAPSHOT_VERSION;
    runId: string;
    stepId: string;
    scopeHash: string;
    agentRef: SpecRef;
    context: ReActRunContext;
    createdAt: string;
}

契约成员

成员种类签名说明
agentRef属性agentRef: SpecRef公开属性;类型、只读和可选状态以签名列为准。
context属性context: ReActRunContext公开属性;类型、只读和可选状态以签名列为准。
createdAt属性createdAt: string公开属性;类型、只读和可选状态以签名列为准。
runId属性runId: string公开属性;类型、只读和可选状态以签名列为准。
scopeHash属性scopeHash: string公开属性;类型、只读和可选状态以签名列为准。
stepId属性stepId: string公开属性;类型、只读和可选状态以签名列为准。
version属性version: "1.0.0"公开属性;类型、只读和可选状态以签名列为准。

ReActContextSnapshotPutResult

ReAct Context Snapshot Put Result 接口,共包含 3 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { ReActContextSnapshotPutResult } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export interface ReActContextSnapshotPutResult {
    snapshot: ReActContextSnapshot;
    snapshotHash: string;
    reused: boolean;
}

契约成员

成员种类签名说明
reused属性reused: boolean公开属性;类型、只读和可选状态以签名列为准。
snapshot属性snapshot: ReActContextSnapshot公开属性;类型、只读和可选状态以签名列为准。
snapshotHash属性snapshotHash: string公开属性;类型、只读和可选状态以签名列为准。

ReActContextSnapshotStore

ReAct Context Snapshot Store 接口,共包含 3 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { ReActContextSnapshotStore } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export interface ReActContextSnapshotStore {
    put(snapshot: ReActContextSnapshot): Promise<ReActContextSnapshotPutResult>;
    get(scopeHash: string): Promise<ReActContextSnapshot | null>;
    delete(scopeHash: string): Promise<boolean>;
}

契约成员

成员种类签名说明
delete方法delete(scopeHash: string): Promise<boolean>公开方法;参数与返回类型以签名列为准。
get方法get(scopeHash: string): Promise<ReActContextSnapshot | null>公开方法;参数与返回类型以签名列为准。
put方法put(snapshot: ReActContextSnapshot): Promise<ReActContextSnapshotPutResult>公开方法;参数与返回类型以签名列为准。

ReActOperationReceiptReconciler

ReAct Operation Receipt Reconciler 接口,共包含 1 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { ReActOperationReceiptReconciler } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export interface ReActOperationReceiptReconciler {
    reconcile(input: {
        descriptor: Readonly<ReActQuantumDescriptor>;
        receiptRefs: readonly string[];
        signal: AbortSignal;
    }): Promise<void>;
}

契约成员

成员种类签名说明
reconcile方法reconcile(input: { descriptor: Readonly<ReActQuantumDescriptor>; receiptRefs: readonly string[]; signal: AbortSignal; }): Promise<void>公开方法;参数与返回类型以签名列为准。

ReActQuantumExecutorOptions

ReAct Quantum Executor Options 接口,共包含 10 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { ReActQuantumExecutorOptions } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export interface ReActQuantumExecutorOptions {
    checkpoints: ReActContinuationCheckpointStore;
    contextSnapshots: ReActContextSnapshotStore;
    runtime: ReActQuantumRuntimeReader;
    runnerFactory: ReActQuantumRunnerFactory;
    outcomeRecorder: ReActQuantumOutcomeRecorder;
    revisionValidator?: ReActQuantumRevisionValidator;
    receiptReconciler?: ReActOperationReceiptReconciler;
    checkpointReferenceFor?: (checkpoint: Readonly<ReActContinuationCheckpoint>) => string;
    quantumIterations: number;
    now?: () => string;
}

契约成员

成员种类签名说明
checkpointReferenceFor方法checkpointReferenceFor?(checkpoint: Readonly<ReActContinuationCheckpoint>): string公开方法;参数与返回类型以签名列为准。
checkpoints属性checkpoints: ReActContinuationCheckpointStore公开属性;类型、只读和可选状态以签名列为准。
contextSnapshots属性contextSnapshots: ReActContextSnapshotStore公开属性;类型、只读和可选状态以签名列为准。
now方法now?(): string公开方法;参数与返回类型以签名列为准。
outcomeRecorder属性outcomeRecorder: ReActQuantumOutcomeRecorder公开属性;类型、只读和可选状态以签名列为准。
quantumIterations属性quantumIterations: number公开属性;类型、只读和可选状态以签名列为准。
receiptReconciler属性receiptReconciler?: ReActOperationReceiptReconciler公开属性;类型、只读和可选状态以签名列为准。
revisionValidator属性revisionValidator?: ReActQuantumRevisionValidator公开属性;类型、只读和可选状态以签名列为准。
runnerFactory属性runnerFactory: ReActQuantumRunnerFactory公开属性;类型、只读和可选状态以签名列为准。
runtime属性runtime: ReActQuantumRuntimeReader公开属性;类型、只读和可选状态以签名列为准。

ReActQuantumOutcomeRecorder

ReAct Quantum Outcome Recorder 接口,共包含 1 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { ReActQuantumOutcomeRecorder } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export interface ReActQuantumOutcomeRecorder {
    record(input: {
        descriptor: Readonly<ReActQuantumDescriptor>;
        state: Readonly<ReActQuantumRuntimeState>;
        react: Readonly<ReActRunResult>;
        disposition: Exclude<ExecuteReActQuantumResult['disposition'], 'terminal'>;
        signal: AbortSignal;
    }): Promise<void>;
}

契约成员

成员种类签名说明
record方法record(input: { descriptor: Readonly<ReActQuantumDescriptor>; state: Readonly<ReActQuantumRuntimeState>; react: Readonly<ReActRunResult>; disposition: Exclude<ExecuteReActQuantumResult["disposition"], "terminal">; signal: AbortSignal; }): Promise<void>公开方法;参数与返回类型以签名列为准。

ReActQuantumRevisionValidator

ReAct Quantum Revision Validator 接口,共包含 1 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { ReActQuantumRevisionValidator } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export interface ReActQuantumRevisionValidator {
    validate(descriptor: Readonly<ReActQuantumDescriptor>, state: Readonly<ReActQuantumRuntimeState>): Promise<void>;
}

契约成员

成员种类签名说明
validate方法validate(descriptor: Readonly<ReActQuantumDescriptor>, state: Readonly<ReActQuantumRuntimeState>): Promise<void>公开方法;参数与返回类型以签名列为准。

ReActQuantumRunnerFactory

ReAct Quantum Runner Factory 接口,共包含 1 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { ReActQuantumRunnerFactory } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export interface ReActQuantumRunnerFactory {
    create(input: {
        descriptor: Readonly<ReActQuantumDescriptor>;
        state: Readonly<ReActQuantumRuntimeState>;
        snapshot: Readonly<ReActContextSnapshot>;
        signal: AbortSignal;
    }): Promise<Pick<ReActRunner, 'run'>>;
}

契约成员

成员种类签名说明
create方法create(input: { descriptor: Readonly<ReActQuantumDescriptor>; state: Readonly<ReActQuantumRuntimeState>; snapshot: Readonly<ReActContextSnapshot>; signal: AbortSignal; }): Promise<Pick<ReActRunner, "run">>公开方法;参数与返回类型以签名列为准。

ReActQuantumRuntimeReader

ReAct Quantum Runtime Reader 接口,共包含 1 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { ReActQuantumRuntimeReader } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export interface ReActQuantumRuntimeReader {
    replay(descriptor: Readonly<ReActQuantumDescriptor>): Promise<ReActQuantumRuntimeState>;
}

契约成员

成员种类签名说明
replay方法replay(descriptor: Readonly<ReActQuantumDescriptor>): Promise<ReActQuantumRuntimeState>公开方法;参数与返回类型以签名列为准。

ReActQuantumRuntimeState

ReAct Quantum Runtime State 接口,共包含 10 个公开字段或方法。

  • 种类: 接口
  • 导入: import type { ReActQuantumRuntimeState } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export interface ReActQuantumRuntimeState {
    runId: string;
    sessionId: string;
    userId: string;
    status: ReActQuantumRuntimeStatus;
    cancellationRevision: number;
    agentRef: SpecRef;
    domainPackRef: SpecRef;
    workflowRef?: SpecRef;
    promptSnapshotHash: string;
    capabilitySnapshotHash: string;
}

契约成员

成员种类签名说明
agentRef属性agentRef: SpecRef公开属性;类型、只读和可选状态以签名列为准。
cancellationRevision属性cancellationRevision: number公开属性;类型、只读和可选状态以签名列为准。
capabilitySnapshotHash属性capabilitySnapshotHash: string公开属性;类型、只读和可选状态以签名列为准。
domainPackRef属性domainPackRef: SpecRef公开属性;类型、只读和可选状态以签名列为准。
promptSnapshotHash属性promptSnapshotHash: string公开属性;类型、只读和可选状态以签名列为准。
runId属性runId: string公开属性;类型、只读和可选状态以签名列为准。
sessionId属性sessionId: string公开属性;类型、只读和可选状态以签名列为准。
status属性status: ReActQuantumRuntimeStatus公开属性;类型、只读和可选状态以签名列为准。
userId属性userId: string公开属性;类型、只读和可选状态以签名列为准。
workflowRef属性workflowRef?: SpecRef公开属性;类型、只读和可选状态以签名列为准。

ReActQuantumRuntimeStatus

ReAct Quantum Runtime Status 公共类型别名;完整类型表达式见声明。

  • 种类: 类型
  • 导入: import type { ReActQuantumRuntimeStatus } from '@codesoul-co/hypha-harness';
  • 源码模块: react-quantum-executor

声明

text
export type ReActQuantumRuntimeStatus = 'created' | 'running' | 'waiting_human' | 'completed' | 'failed' | 'cancelled';