@codesoul-co/hypha-harness / long-horizon-react-supervisor

• Package index: @codesoul-co/hypha-harness
• Source: packages/harness/src/long-horizon-react-supervisor.ts
• Exports: 15

Using this module

Use the Long horizon react supervisor module for using the public contracts and operations for this capability boundary. It exports 2 classes, 1 function, 11 interfaces, 1 type.

Import from the package entrypoint

import {
  LongHorizonReActSupervisor,
  ServerIngressReActContinuationScheduler,
  reActContinuationIdempotencyKey,
} from '@codesoul-co/hypha-harness';

import type {
  CoordinateReActQuantumResultInput,
  EnqueueReActContinuationCommandRequest,
  LongHorizonReActQuantumInput,
  LongHorizonReActQuantumResult,
  LongHorizonReActSupervisorOptions,
  ReActContinuationCommandIngress,
  ReActContinuationIntent,
  ReActContinuationScheduler,
} from '@codesoul-co/hypha-harness';

// The complete export list is documented below.

Usage patterns

• Use the 12 type/interface exports as static contracts in application code, adapters, or tests. Import them with import type; they do not exist at runtime.
• The module exposes 2 classes as constructable runtime implementations. Each symbol entry lists its constructor and public methods.
• The module exposes 1 function as direct operation entrypoints. Every overload, required/optional parameter, and return type is documented below.

Public exports

Symbol	Kind	Signature	Description
LongHorizonReActSupervisor	class	new LongHorizonReActSupervisor(options: LongHorizonReActSupervisorOptions): LongHorizonReActSupervisor	Executes exactly one bounded ReAct quantum. It never hides an unbounded loop. A retryable quantum boundary is handed to a durable scheduler; global budget, deadline, and non-progress boundaries require an explicit operator/workflow decision.
ServerIngressReActContinuationScheduler	class	new ServerIngressReActContinuationScheduler(options: ServerIngressReActContinuationSchedulerOptions): ServerIngressReActContinuationScheduler	Sends a complete continuation envelope through the Server command ingress. The ingress owns payload persistence and Queue reference/hash generation.
reActContinuationIdempotencyKey	function	reActContinuationIdempotencyKey(input: ContinueReActCommandPayloadV1): string	Re Act Continuation Idempotency Key function with 1 public call signature; parameters and return types are listed below.
CoordinateReActQuantumResultInput	interface	interface CoordinateReActQuantumResultInput	Coordinate ReAct Quantum Result Input interface with 2 public fields or methods.
EnqueueReActContinuationCommandRequest	interface	interface EnqueueReActContinuationCommandRequest	Enqueue ReAct Continuation Command Request interface with 13 public fields or methods.
LongHorizonReActQuantumInput	interface	interface LongHorizonReActQuantumInput	Long Horizon ReAct Quantum Input interface with 3 public fields or methods.
LongHorizonReActQuantumResult	interface	interface LongHorizonReActQuantumResult	Long Horizon ReAct Quantum Result interface with 4 public fields or methods.
LongHorizonReActSupervisorOptions	interface	interface LongHorizonReActSupervisorOptions	Long Horizon ReAct Supervisor Options interface with 3 public fields or methods.
ReActContinuationCommandIngress	interface	interface ReActContinuationCommandIngress	ReAct Continuation Command Ingress interface with 1 public fields or methods.
ReActContinuationIntent	interface	interface ReActContinuationIntent	ReAct Continuation Intent interface with 6 public fields or methods.
ReActContinuationScheduler	interface	interface ReActContinuationScheduler	ReAct Continuation Scheduler interface with 1 public fields or methods.
ReActContinuationScheduleRequest	interface	interface ReActContinuationScheduleRequest	ReAct Continuation Schedule Request interface with 7 public fields or methods.
ReActContinuationScheduleResult	interface	interface ReActContinuationScheduleResult	ReAct Continuation Schedule Result interface with 2 public fields or methods.
ServerIngressReActContinuationSchedulerOptions	interface	interface ServerIngressReActContinuationSchedulerOptions	Server Ingress ReAct Continuation Scheduler Options interface with 2 public fields or methods.
LongHorizonReActDisposition	type	type LongHorizonReActDisposition = 'completed' | 'continuation_scheduled' | 'continuation_required' | 'waiting_human' | 'cancelled' | 'failed'	Public type alias for Long Horizon ReAct Disposition; the declaration contains its complete type expression.

LongHorizonReActSupervisor

Executes exactly one bounded ReAct quantum. It never hides an unbounded loop. A retryable quantum boundary is handed to a durable scheduler; global budget, deadline, and non-progress boundaries require an explicit operator/workflow decision.

• Kind: class
• Import: import { LongHorizonReActSupervisor } from '@codesoul-co/hypha-harness';
• Source module: long-horizon-react-supervisor

Declaration

export declare class LongHorizonReActSupervisor {
    constructor(options: LongHorizonReActSupervisorOptions);
    runQuantum(input: LongHorizonReActQuantumInput): Promise<LongHorizonReActQuantumResult>;
    coordinateResult(input: CoordinateReActQuantumResultInput): Promise<LongHorizonReActQuantumResult>;
}

Public members

Member	Kind	Signature	Description
constructor	constructor	(options: LongHorizonReActSupervisorOptions): LongHorizonReActSupervisor	Creates an instance of this class.
coordinateResult	method	coordinateResult(input: CoordinateReActQuantumResultInput): Promise<LongHorizonReActQuantumResult>	Public method; parameters and return type are shown in the signature.
runQuantum	method	runQuantum(input: LongHorizonReActQuantumInput): Promise<LongHorizonReActQuantumResult>	Public method; parameters and return type are shown in the signature.

ServerIngressReActContinuationScheduler

Sends a complete continuation envelope through the Server command ingress. The ingress owns payload persistence and Queue reference/hash generation.

• Kind: class
• Import: import { ServerIngressReActContinuationScheduler } from '@codesoul-co/hypha-harness';
• Source module: long-horizon-react-supervisor

Declaration

export declare class ServerIngressReActContinuationScheduler implements ReActContinuationScheduler {
    constructor(options: ServerIngressReActContinuationSchedulerOptions);
    schedule(input: ReActContinuationScheduleRequest): Promise<ReActContinuationScheduleResult>;
}

Public members

Member	Kind	Signature	Description
constructor	constructor	(options: ServerIngressReActContinuationSchedulerOptions): ServerIngressReActContinuationScheduler	Creates an instance of this class.
schedule	method	schedule(input: ReActContinuationScheduleRequest): Promise<ReActContinuationScheduleResult>	Public method; parameters and return type are shown in the signature.

reActContinuationIdempotencyKey

Re Act Continuation Idempotency Key function with 1 public call signature; parameters and return types are listed below.

• Kind: function
• Import: import { reActContinuationIdempotencyKey } from '@codesoul-co/hypha-harness';
• Source module: long-horizon-react-supervisor

Declaration

export declare function reActContinuationIdempotencyKey(input: ContinueReActCommandPayloadV1): string;

Call signature

reActContinuationIdempotencyKey(input: ContinueReActCommandPayloadV1): string

Parameters

Parameter	Type	Required	Description
input	ContinueReActCommandPayloadV1	Yes	Required parameter; accepted values are defined by the type column.

Returns

• Type: string
• Description: The return contract is defined by the type shown above.

CoordinateReActQuantumResultInput

Coordinate ReAct Quantum Result Input interface with 2 public fields or methods.

• Kind: interface
• Import: import type { CoordinateReActQuantumResultInput } from '@codesoul-co/hypha-harness';
• Source module: long-horizon-react-supervisor

Declaration

export interface CoordinateReActQuantumResultInput {
    react: ReActRunResult;
    continuation?: ReActContinuationIntent;
}

Contract members

Member	Kind	Signature	Description
continuation	property	continuation?: ReActContinuationIntent	Public property; its type, readonly modifier and optionality are shown in the signature.
react	property	react: ReActRunResult	Public property; its type, readonly modifier and optionality are shown in the signature.

EnqueueReActContinuationCommandRequest

Enqueue ReAct Continuation Command Request interface with 13 public fields or methods.

• Kind: interface
• Import: import type { EnqueueReActContinuationCommandRequest } from '@codesoul-co/hypha-harness';
• Source module: long-horizon-react-supervisor

Declaration

export interface EnqueueReActContinuationCommandRequest {
    id: string;
    commandType: 'continue_react';
    idempotencyKey: string;
    tenantId?: string;
    userId: string;
    workspaceId?: string;
    sessionId: string;
    targetRunId: string;
    priority?: number;
    maxAttempts?: number;
    payload: ContinueReActCommandPayloadV1;
    createdAt: string;
    availableAt: string;
}

Contract members

Member	Kind	Signature	Description
availableAt	property	availableAt: string	Public property; its type, readonly modifier and optionality are shown in the signature.
commandType	property	commandType: "continue_react"	Public property; its type, readonly modifier and optionality are shown in the signature.
createdAt	property	createdAt: string	Public property; its type, readonly modifier and optionality are shown in the signature.
id	property	id: string	Public property; its type, readonly modifier and optionality are shown in the signature.
idempotencyKey	property	idempotencyKey: string	Public property; its type, readonly modifier and optionality are shown in the signature.
maxAttempts	property	maxAttempts?: number	Public property; its type, readonly modifier and optionality are shown in the signature.
payload	property	payload: ContinueReActCommandPayloadV1	Public property; its type, readonly modifier and optionality are shown in the signature.
priority	property	priority?: number	Public property; its type, readonly modifier and optionality are shown in the signature.
sessionId	property	sessionId: string	Public property; its type, readonly modifier and optionality are shown in the signature.
targetRunId	property	targetRunId: string	Public property; its type, readonly modifier and optionality are shown in the signature.
tenantId	property	tenantId?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
userId	property	userId: string	Public property; its type, readonly modifier and optionality are shown in the signature.
workspaceId	property	workspaceId?: string	Public property; its type, readonly modifier and optionality are shown in the signature.

LongHorizonReActQuantumInput

Long Horizon ReAct Quantum Input interface with 3 public fields or methods.

• Kind: interface
• Import: import type { LongHorizonReActQuantumInput } from '@codesoul-co/hypha-harness';
• Source module: long-horizon-react-supervisor

Declaration

export interface LongHorizonReActQuantumInput {
    context: ReActRunContext;
    control?: ReActRunControl;
    continuation?: ReActContinuationIntent;
}

Contract members

Member	Kind	Signature	Description
context	property	context: ReActRunContext	Public property; its type, readonly modifier and optionality are shown in the signature.
continuation	property	continuation?: ReActContinuationIntent	Public property; its type, readonly modifier and optionality are shown in the signature.
control	property	control?: ReActRunControl	Public property; its type, readonly modifier and optionality are shown in the signature.

LongHorizonReActQuantumResult

Long Horizon ReAct Quantum Result interface with 4 public fields or methods.

• Kind: interface
• Import: import type { LongHorizonReActQuantumResult } from '@codesoul-co/hypha-harness';
• Source module: long-horizon-react-supervisor

Declaration

export interface LongHorizonReActQuantumResult {
    disposition: LongHorizonReActDisposition;
    react: ReActRunResult;
    scheduledTaskId?: string;
    scheduleReused?: boolean;
}

Contract members

Member	Kind	Signature	Description
disposition	property	disposition: LongHorizonReActDisposition	Public property; its type, readonly modifier and optionality are shown in the signature.
react	property	react: ReActRunResult	Public property; its type, readonly modifier and optionality are shown in the signature.
scheduledTaskId	property	scheduledTaskId?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
scheduleReused	property	scheduleReused?: boolean	Public property; its type, readonly modifier and optionality are shown in the signature.

LongHorizonReActSupervisorOptions

Long Horizon ReAct Supervisor Options interface with 3 public fields or methods.

• Kind: interface
• Import: import type { LongHorizonReActSupervisorOptions } from '@codesoul-co/hypha-harness';
• Source module: long-horizon-react-supervisor

Declaration

export interface LongHorizonReActSupervisorOptions {
    runner: Pick<ReActRunner, 'run'>;
    scheduler?: ReActContinuationScheduler;
    now?: () => string;
}

Contract members

Member	Kind	Signature	Description
now	method	now?(): string	Public method; parameters and return type are shown in the signature.
runner	property	runner: Pick<ReActRunner, "run">	Public property; its type, readonly modifier and optionality are shown in the signature.
scheduler	property	scheduler?: ReActContinuationScheduler	Public property; its type, readonly modifier and optionality are shown in the signature.

ReActContinuationCommandIngress

ReAct Continuation Command Ingress interface with 1 public fields or methods.

• Kind: interface
• Import: import type { ReActContinuationCommandIngress } from '@codesoul-co/hypha-harness';
• Source module: long-horizon-react-supervisor

Declaration

export interface ReActContinuationCommandIngress {
    enqueue(request: EnqueueReActContinuationCommandRequest): Promise<Pick<SessionCommandRecord, 'id' | 'status'>>;
}

Contract members

Member	Kind	Signature	Description
enqueue	method	enqueue(request: EnqueueReActContinuationCommandRequest): Promise<Pick<SessionCommandRecord, "id" | "status">>	Public method; parameters and return type are shown in the signature.

ReActContinuationIntent

ReAct Continuation Intent interface with 6 public fields or methods.

• Kind: interface
• Import: import type { ReActContinuationIntent } from '@codesoul-co/hypha-harness';
• Source module: long-horizon-react-supervisor

Declaration

export interface ReActContinuationIntent {
    tenantId?: string;
    workspaceId?: string;
    availableAt?: string;
    priority?: number;
    maxAttempts?: number;
    buildPayload(checkpoint: Readonly<ReActContinuationCheckpoint>): ContinueReActCommandPayloadV1 | Promise<ContinueReActCommandPayloadV1>;
}

Contract members

Member	Kind	Signature	Description
availableAt	property	availableAt?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
buildPayload	method	buildPayload(checkpoint: Readonly<ReActContinuationCheckpoint>): ContinueReActCommandPayloadV1 | Promise<ContinueReActCommandPayloadV1>	Public method; parameters and return type are shown in the signature.
maxAttempts	property	maxAttempts?: number	Public property; its type, readonly modifier and optionality are shown in the signature.
priority	property	priority?: number	Public property; its type, readonly modifier and optionality are shown in the signature.
tenantId	property	tenantId?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
workspaceId	property	workspaceId?: string	Public property; its type, readonly modifier and optionality are shown in the signature.

ReActContinuationScheduler

ReAct Continuation Scheduler interface with 1 public fields or methods.

• Kind: interface
• Import: import type { ReActContinuationScheduler } from '@codesoul-co/hypha-harness';
• Source module: long-horizon-react-supervisor

Declaration

export interface ReActContinuationScheduler {
    schedule(request: ReActContinuationScheduleRequest): Promise<ReActContinuationScheduleResult>;
}

Contract members

Member	Kind	Signature	Description
schedule	method	schedule(request: ReActContinuationScheduleRequest): Promise<ReActContinuationScheduleResult>	Public method; parameters and return type are shown in the signature.

ReActContinuationScheduleRequest

ReAct Continuation Schedule Request interface with 7 public fields or methods.

• Kind: interface
• Import: import type { ReActContinuationScheduleRequest } from '@codesoul-co/hypha-harness';
• Source module: long-horizon-react-supervisor

Declaration

export interface ReActContinuationScheduleRequest {
    version: '1.0.0';
    tenantId?: string;
    workspaceId?: string;
    payload: ContinueReActCommandPayloadV1;
    availableAt: string;
    priority?: number;
    maxAttempts?: number;
}

Contract members

Member	Kind	Signature	Description
availableAt	property	availableAt: string	Public property; its type, readonly modifier and optionality are shown in the signature.
maxAttempts	property	maxAttempts?: number	Public property; its type, readonly modifier and optionality are shown in the signature.
payload	property	payload: ContinueReActCommandPayloadV1	Public property; its type, readonly modifier and optionality are shown in the signature.
priority	property	priority?: number	Public property; its type, readonly modifier and optionality are shown in the signature.
tenantId	property	tenantId?: string	Public property; its type, readonly modifier and optionality are shown in the signature.
version	property	version: "1.0.0"	Public property; its type, readonly modifier and optionality are shown in the signature.
workspaceId	property	workspaceId?: string	Public property; its type, readonly modifier and optionality are shown in the signature.

ReActContinuationScheduleResult

ReAct Continuation Schedule Result interface with 2 public fields or methods.

• Kind: interface
• Import: import type { ReActContinuationScheduleResult } from '@codesoul-co/hypha-harness';
• Source module: long-horizon-react-supervisor

Declaration

export interface ReActContinuationScheduleResult {
    taskId: string;
    reused: boolean;
}

Contract members

Member	Kind	Signature	Description
reused	property	reused: boolean	Public property; its type, readonly modifier and optionality are shown in the signature.
taskId	property	taskId: string	Public property; its type, readonly modifier and optionality are shown in the signature.

ServerIngressReActContinuationSchedulerOptions

Server Ingress ReAct Continuation Scheduler Options interface with 2 public fields or methods.

• Kind: interface
• Import: import type { ServerIngressReActContinuationSchedulerOptions } from '@codesoul-co/hypha-harness';
• Source module: long-horizon-react-supervisor

Declaration

export interface ServerIngressReActContinuationSchedulerOptions {
    ingress: ReActContinuationCommandIngress;
    now?: () => string;
}

Contract members

Member	Kind	Signature	Description
ingress	property	ingress: ReActContinuationCommandIngress	Public property; its type, readonly modifier and optionality are shown in the signature.
now	method	now?(): string	Public method; parameters and return type are shown in the signature.

LongHorizonReActDisposition

Public type alias for Long Horizon ReAct Disposition; the declaration contains its complete type expression.

• Kind: type
• Import: import type { LongHorizonReActDisposition } from '@codesoul-co/hypha-harness';
• Source module: long-horizon-react-supervisor

Declaration

export type LongHorizonReActDisposition = 'completed' | 'continuation_scheduled' | 'continuation_required' | 'waiting_human' | 'cancelled' | 'failed';