@tienne/gestalt 0.1.0

package/dist/src/execute/passthrough-engine.d.ts

@@ -0,0 +1,181 @@
+import type { Spec, ExecuteSession, ExecutionPlan, PlanningStepResult, ClassifiedAC, AtomicTask, TaskExecutionResult, EvaluationResult, StructuralCommand, StructuralResult, EvaluateStage, DriftScore, FixTask, SpecPatch, TerminationReason } from '../core/types.js';
+import { ExecuteError } from '../core/errors.js';
+import { type Result } from '../core/result.js';
+import { EventStore } from '../events/store.js';
+import type { AgentRegistry } from '../agent/registry.js';
+export interface ExecuteContext {
+    systemPrompt: string;
+    planningPrompt: string;
+    currentPrinciple: string;
+    principleStrategy: string;
+    phase: 'planning';
+    stepNumber: number;
+    totalSteps: number;
+    spec: Spec;
+    previousSteps: PlanningStepResult[];
+}
+export interface PassthroughStartResult {
+    session: ExecuteSession;
+    executeContext: ExecuteContext;
+}
+export interface PassthroughPlanStepResult {
+    session: ExecuteSession;
+    executeContext?: ExecuteContext;
+    isLastStep: boolean;
+}
+export interface PassthroughPlanCompleteResult {
+    session: ExecuteSession;
+    executionPlan: ExecutionPlan;
+}
+export interface TaskExecutionContext {
+    systemPrompt: string;
+    taskPrompt: string;
+    phase: 'executing';
+    currentTask: AtomicTask;
+    similarityStrategy: string;
+    pendingTasks: AtomicTask[];
+    completedTaskIds: string[];
+}
+export interface PassthroughExecutionStartResult {
+    session: ExecuteSession;
+    taskContext: TaskExecutionContext | null;
+    allTasksCompleted: boolean;
+}
+export interface DriftRetrospectiveContext {
+    systemPrompt: string;
+    retrospectivePrompt: string;
+    driftScore: DriftScore;
+}
+export interface PassthroughTaskSubmitResult {
+    session: ExecuteSession;
+    taskContext: TaskExecutionContext | null;
+    allTasksCompleted: boolean;
+    driftScore?: DriftScore;
+    retrospectiveContext?: DriftRetrospectiveContext;
+}
+export interface StructuralEvaluateContext {
+    phase: 'evaluating';
+    stage: 'structural';
+    commands: StructuralCommand[];
+    message: string;
+}
+export interface ContextualEvaluateContext {
+    systemPrompt: string;
+    evaluatePrompt: string;
+    phase: 'evaluating';
+    stage: 'contextual';
+    spec: Spec;
+    taskResults: TaskExecutionResult[];
+    classifiedACs: ClassifiedAC[];
+    structuralResult: StructuralResult;
+}
+export interface PassthroughEvaluateResult {
+    session: ExecuteSession;
+    stage: EvaluateStage;
+    structuralContext?: StructuralEvaluateContext;
+    contextualContext?: ContextualEvaluateContext;
+    evaluationResult?: EvaluationResult;
+    shortCircuited?: boolean;
+}
+export interface StructuralFixContext {
+    systemPrompt: string;
+    fixPrompt: string;
+    phase: 'evolving';
+    stage: 'fix';
+    failedCommands: StructuralResult['commands'];
+}
+export interface ContextualEvolveContext {
+    systemPrompt: string;
+    evolvePrompt: string;
+    phase: 'evolving';
+    stage: 'evolve';
+    evaluationResult: EvaluationResult;
+    evolutionHistory: ExecuteSession['evolutionHistory'];
+}
+export interface ReExecutionContext {
+    systemPrompt: string;
+    taskPrompt: string;
+    phase: 'evolving';
+    stage: 're_execute';
+    currentTask: AtomicTask;
+    impactedTaskIds: string[];
+    patchSummary: string;
+}
+export interface PassthroughEvolveFixResult {
+    session: ExecuteSession;
+    fixContext?: StructuralFixContext;
+    evolveContext?: ContextualEvolveContext;
+    terminated?: boolean;
+    terminationReason?: TerminationReason;
+}
+export interface PassthroughEvolvePatchResult {
+    session: ExecuteSession;
+    reExecuteContext?: ReExecutionContext;
+    impactedTaskIds: string[];
+    terminated?: boolean;
+    terminationReason?: TerminationReason;
+}
+export interface PassthroughReExecuteResult {
+    session: ExecuteSession;
+    reExecuteContext?: ReExecutionContext;
+    allTasksCompleted: boolean;
+}
+export declare class PassthroughExecuteEngine {
+    private eventStore;
+    private sessionManager;
+    private agentRegistry?;
+    constructor(eventStore: EventStore, agentRegistry?: AgentRegistry);
+    start(spec: Spec): Result<PassthroughStartResult, ExecuteError>;
+    planStep(sessionId: string, stepResult: PlanningStepResult): Result<PassthroughPlanStepResult, ExecuteError>;
+    planComplete(sessionId: string): Result<PassthroughPlanCompleteResult, ExecuteError>;
+    startExecution(sessionId: string): Result<PassthroughExecutionStartResult, ExecuteError>;
+    submitTaskResult(sessionId: string, taskResult: TaskExecutionResult, driftThreshold?: number): Result<PassthroughTaskSubmitResult, ExecuteError>;
+    /**
+     * Call 1: Start evaluation → returns structural commands to run.
+     */
+    startEvaluation(sessionId: string): Result<PassthroughEvaluateResult, ExecuteError>;
+    /**
+     * Call 2: Submit structural results → returns contextual context or short-circuits.
+     */
+    submitStructuralResult(sessionId: string, structuralResult: StructuralResult): Result<PassthroughEvaluateResult, ExecuteError>;
+    /**
+     * Call 3: Submit contextual evaluation result → completes session.
+     */
+    submitEvaluation(sessionId: string, evaluationResult: EvaluationResult): Result<PassthroughEvaluateResult, ExecuteError>;
+    getSession(sessionId: string): ExecuteSession;
+    listSessions(): ExecuteSession[];
+    /**
+     * evolve_fix: Structural 실패 시 fix context를 반환하거나, fix 결과를 제출한다.
+     * - fixTasks 없으면: fixContext 반환 (caller가 fix 생성)
+     * - fixTasks 있으면: fix 기록 후 re-evaluate를 위한 상태 복원
+     */
+    startStructuralFix(sessionId: string, fixTasks?: FixTask[]): Result<PassthroughEvolveFixResult, ExecuteError>;
+    /**
+     * evolve: Contextual evolution 시작.
+     * - evaluationResult에서 gap 분석 후 evolveContext 반환
+     * - caller가 SpecPatch를 생성
+     * - terminateReason='caller'이면 즉시 종료
+     */
+    startContextualEvolve(sessionId: string, terminateReason?: 'caller'): Result<PassthroughEvolveFixResult, ExecuteError>;
+    /**
+     * evolve_patch: Spec 패치 제출 → 검증 → 적용 → impacted tasks 식별 → re-execute context 반환
+     */
+    submitSpecPatch(sessionId: string, patch: SpecPatch): Result<PassthroughEvolvePatchResult, ExecuteError>;
+    /**
+     * evolve_re_execute: Re-execution 중 태스크 결과 제출
+     */
+    submitReExecuteTaskResult(sessionId: string, taskResult: TaskExecutionResult): Result<PassthroughReExecuteResult, ExecuteError>;
+    private countStructuralFixes;
+    private buildReExecuteContext;
+    private buildNextReExecuteTaskContext;
+    private buildNextTaskContext;
+    private findSimilarTasks;
+    private buildContextualEvaluateContext;
+    private validateStepResult;
+    private validateFigureGround;
+    private validateClosure;
+    private validateProximity;
+    private crossValidateDAG;
+    private buildExecuteContext;
+}
+//# sourceMappingURL=passthrough-engine.d.ts.map

package/dist/src/execute/passthrough-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"passthrough-engine.d.ts","sourceRoot":"","sources":["../../../src/execute/passthrough-engine.ts"],"names":[],"mappings":"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"}