ralph-research 0.1.2 → 0.1.4

package/dist/core/state/research-session-resume-candidate.js

@@ -0,0 +1,62 @@
+export function selectResearchSessionResumeCandidate(input) {
+    const normalizedGoal = normalizeGoal(input.goal);
+    const goalMatches = input.sessions.filter((session) => normalizeGoal(session.goal) === normalizedGoal);
+    const candidatePool = goalMatches.length > 0 ? goalMatches : input.sessions;
+    return [...candidatePool].sort(compareResumeCandidates)[0];
+}
+function compareResumeCandidates(left, right) {
+    const statusPriorityDelta = getStatusPriority(right) - getStatusPriority(left);
+    if (statusPriorityDelta !== 0) {
+        return statusPriorityDelta;
+    }
+    const completedCyclesDelta = getCompletedCycles(right) - getCompletedCycles(left);
+    if (completedCyclesDelta !== 0) {
+        return completedCyclesDelta;
+    }
+    const checkpointDelta = parseTimestamp(getLastCheckpointAt(right)) - parseTimestamp(getLastCheckpointAt(left));
+    if (checkpointDelta !== 0) {
+        return checkpointDelta;
+    }
+    const updatedAtDelta = parseTimestamp(right.updatedAt) - parseTimestamp(left.updatedAt);
+    if (updatedAtDelta !== 0) {
+        return updatedAtDelta;
+    }
+    const createdAtDelta = parseTimestamp(right.createdAt) - parseTimestamp(left.createdAt);
+    if (createdAtDelta !== 0) {
+        return createdAtDelta;
+    }
+    return right.sessionId.localeCompare(left.sessionId);
+}
+function getStatusPriority(session) {
+    switch (session.status) {
+        case "halted":
+            return 1;
+        case "running":
+            return 0;
+        default:
+            return -1;
+    }
+}
+function normalizeGoal(goal) {
+    return goal.trim();
+}
+function getCompletedCycles(session) {
+    if ("progress" in session) {
+        return session.progress.completedCycles;
+    }
+    return session.completedCycles;
+}
+function getLastCheckpointAt(session) {
+    if ("progress" in session) {
+        return session.progress.lastCheckpointAt;
+    }
+    return session.lastCheckpointAt;
+}
+function parseTimestamp(value) {
+    if (!value) {
+        return Number.NEGATIVE_INFINITY;
+    }
+    const parsed = Date.parse(value);
+    return Number.isNaN(parsed) ? Number.NEGATIVE_INFINITY : parsed;
+}
+//# sourceMappingURL=research-session-resume-candidate.js.map

package/dist/core/state/research-session-resume-candidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-session-resume-candidate.js","sourceRoot":"","sources":["../../../src/core/state/research-session-resume-candidate.ts"],"names":[],"mappings":"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"}

package/dist/core/state/research-session-state-machine.d.ts

@@ -0,0 +1,62 @@
+import type { DecisionRecord } from "../model/decision-record.js";
+import { type ResearchSessionProgressSignal, type ResearchSessionRecord, type ResearchSessionStopCondition } from "../model/research-session.js";
+import type { RunRecord } from "../model/run-record.js";
+export interface AdvanceResearchSessionCompletedCycleInput {
+    current: ResearchSessionRecord;
+    run: RunRecord;
+    decision: DecisionRecord | null;
+    frontierIds: string[];
+    signal: Omit<ResearchSessionProgressSignal, "cycle">;
+    at: string;
+}
+export interface AdvanceResearchSessionCompletedCycleResult {
+    transition: "cycle_checkpointed" | "session_halted";
+    session: ResearchSessionRecord;
+}
+export declare function startResearchSessionFromDraft(input: {
+    draft: ResearchSessionRecord;
+    sessionId: string;
+    at: string;
+}): ResearchSessionRecord;
+export declare function resumeResearchSession(input: {
+    current: ResearchSessionRecord;
+    at: string;
+}): ResearchSessionRecord;
+export declare function advanceResearchSessionCompletedCycle(input: AdvanceResearchSessionCompletedCycleInput): AdvanceResearchSessionCompletedCycleResult;
+export declare function interruptResearchSession(input: {
+    current: ResearchSessionRecord;
+    at: string;
+    note?: string;
+}): ResearchSessionRecord;
+export declare function haltResearchSession(input: {
+    current: ResearchSessionRecord;
+    stopCondition: Extract<ResearchSessionStopCondition, {
+        type: "repeated_failures" | "no_meaningful_progress" | "insufficient_evidence" | "operator_stop";
+    }>;
+    at: string;
+}): ResearchSessionRecord;
+export declare function completeResearchSession(input: {
+    current: ResearchSessionRecord;
+    summary: string;
+    evidenceBundlePath: string;
+    achievedAtCycle?: number;
+    promotion?: {
+        promotedRunId: string;
+        promotedDecisionId: string;
+        promotedCommitSha: string;
+    };
+    at: string;
+}): ResearchSessionRecord;
+export declare function failResearchSession(input: {
+    current: ResearchSessionRecord;
+    message: string;
+    stack?: string;
+    at: string;
+}): ResearchSessionRecord;
+export declare function deriveResearchSessionCompletedCycleStopCondition(input: {
+    session: ResearchSessionRecord;
+    run: RunRecord;
+    decision: DecisionRecord | null;
+}): Extract<ResearchSessionStopCondition, {
+    type: "repeated_failures" | "no_meaningful_progress" | "insufficient_evidence" | "operator_stop";
+}> | null;

package/dist/core/state/research-session-state-machine.js

@@ -0,0 +1,443 @@
+import { isResumableResearchSessionStatus, researchSessionRecordSchema, } from "../model/research-session.js";
+export function startResearchSessionFromDraft(input) {
+    if (input.draft.status !== "draft") {
+        throw new Error(`Session ${input.draft.sessionId} is not a launch draft`);
+    }
+    const started = researchSessionRecordSchema.parse({
+        sessionId: normalizeRequiredString(input.sessionId, "Session id"),
+        goal: input.draft.goal,
+        workingDirectory: input.draft.workingDirectory,
+        status: "running",
+        agent: {
+            ...input.draft.agent,
+            ttySession: {
+                ...input.draft.agent.ttySession,
+            },
+        },
+        context: {
+            trackableGlobs: [...input.draft.context.trackableGlobs],
+            webSearch: input.draft.context.webSearch,
+            shellCommandAllowlistAdditions: [...input.draft.context.shellCommandAllowlistAdditions],
+            shellCommandAllowlistRemovals: [...input.draft.context.shellCommandAllowlistRemovals],
+        },
+        workspace: {
+            strategy: "git_worktree",
+            ...(input.draft.workspace.baseRef ? { baseRef: input.draft.workspace.baseRef } : {}),
+            promoted: false,
+        },
+        stopPolicy: {
+            ...input.draft.stopPolicy,
+        },
+        progress: {
+            completedCycles: 0,
+            nextCycle: 1,
+            latestFrontierIds: [],
+            repeatedFailureStreak: 0,
+            noMeaningfulProgressStreak: 0,
+            insufficientEvidenceStreak: 0,
+        },
+        stopCondition: {
+            type: "none",
+        },
+        resume: {
+            resumable: true,
+            checkpointType: "completed_cycle_boundary",
+            resumeFromCycle: 1,
+            requiresUserConfirmation: false,
+        },
+        ...(input.draft.draftState
+            ? {
+                draftState: cloneResearchSessionDraftState(input.draft.draftState),
+            }
+            : {}),
+        createdAt: input.at,
+        updatedAt: input.at,
+    });
+    return researchSessionRecordSchema.parse({
+        ...started,
+        submittedSnapshot: createResearchSessionSubmittedSnapshot(started),
+    });
+}
+export function resumeResearchSession(input) {
+    if (!isResumableResearchSessionStatus(input.current.status)) {
+        throw new Error(`Session ${input.current.sessionId} cannot resume from status ${input.current.status}`);
+    }
+    const nextRecord = researchSessionRecordSchema.parse({
+        ...input.current,
+        status: "running",
+        stopCondition: {
+            type: "none",
+        },
+        resume: {
+            ...input.current.resume,
+            resumable: true,
+            requiresUserConfirmation: false,
+        },
+        updatedAt: input.at,
+    });
+    delete nextRecord.resume.interruptionDetectedAt;
+    delete nextRecord.resume.interruptedDuringCycle;
+    delete nextRecord.resume.note;
+    delete nextRecord.endedAt;
+    return researchSessionRecordSchema.parse(nextRecord);
+}
+export function advanceResearchSessionCompletedCycle(input) {
+    const checkpointed = checkpointResearchSessionCompletedCycle(input);
+    const stopCondition = deriveResearchSessionCompletedCycleStopCondition({
+        session: checkpointed,
+        run: input.run,
+        decision: input.decision,
+    });
+    if (!stopCondition) {
+        return {
+            transition: "cycle_checkpointed",
+            session: checkpointed,
+        };
+    }
+    return {
+        transition: "session_halted",
+        session: haltResearchSession({
+            current: checkpointed,
+            stopCondition,
+            at: input.at,
+        }),
+    };
+}
+export function interruptResearchSession(input) {
+    if (input.current.status !== "running") {
+        throw new Error(`Session ${input.current.sessionId} cannot record an interruption from status ${input.current.status}`);
+    }
+    const nextRecord = researchSessionRecordSchema.parse({
+        ...input.current,
+        status: "awaiting_resume",
+        stopCondition: {
+            type: "none",
+        },
+        resume: {
+            ...input.current.resume,
+            resumable: true,
+            requiresUserConfirmation: true,
+            interruptionDetectedAt: input.at,
+            interruptedDuringCycle: input.current.progress.nextCycle,
+            ...(input.note ? { note: normalizeRequiredString(input.note, "Resume note") } : {}),
+        },
+        updatedAt: input.at,
+    });
+    delete nextRecord.endedAt;
+    return researchSessionRecordSchema.parse(nextRecord);
+}
+export function haltResearchSession(input) {
+    if (input.current.status !== "running") {
+        throw new Error(`Session ${input.current.sessionId} cannot halt from status ${input.current.status}`);
+    }
+    const nextRecord = researchSessionRecordSchema.parse({
+        ...input.current,
+        status: "halted",
+        stopCondition: input.stopCondition,
+        resume: {
+            ...input.current.resume,
+            resumable: true,
+            requiresUserConfirmation: true,
+        },
+        updatedAt: input.at,
+    });
+    delete nextRecord.endedAt;
+    return researchSessionRecordSchema.parse(nextRecord);
+}
+export function completeResearchSession(input) {
+    if (input.current.status !== "running") {
+        throw new Error(`Session ${input.current.sessionId} cannot complete from status ${input.current.status}`);
+    }
+    const achievedAtCycle = input.achievedAtCycle ?? input.current.progress.completedCycles;
+    if (achievedAtCycle < 1) {
+        throw new Error("Goal completion requires at least one completed cycle");
+    }
+    const nextRecord = researchSessionRecordSchema.parse({
+        ...input.current,
+        status: "goal_achieved",
+        stopCondition: {
+            type: "goal_achieved",
+            summary: normalizeRequiredString(input.summary, "Goal summary"),
+            achievedAtCycle,
+        },
+        resume: {
+            ...input.current.resume,
+            resumable: false,
+            requiresUserConfirmation: false,
+        },
+        evidenceBundlePath: normalizeRequiredString(input.evidenceBundlePath, "Evidence bundle path"),
+        updatedAt: input.at,
+        endedAt: input.at,
+    });
+    delete nextRecord.resume.interruptionDetectedAt;
+    delete nextRecord.resume.interruptedDuringCycle;
+    delete nextRecord.resume.note;
+    if (input.promotion) {
+        nextRecord.workspace = {
+            ...input.current.workspace,
+            promoted: true,
+            promotedAt: input.at,
+            promotedRunId: input.promotion.promotedRunId,
+            promotedDecisionId: input.promotion.promotedDecisionId,
+            promotedCommitSha: input.promotion.promotedCommitSha,
+        };
+    }
+    return researchSessionRecordSchema.parse(nextRecord);
+}
+export function failResearchSession(input) {
+    if (!["running", "awaiting_resume", "halted"].includes(input.current.status)) {
+        throw new Error(`Session ${input.current.sessionId} cannot fail from status ${input.current.status}`);
+    }
+    const nextRecord = researchSessionRecordSchema.parse({
+        ...input.current,
+        status: "failed",
+        stopCondition: {
+            type: "unrecoverable_error",
+            message: normalizeRequiredString(input.message, "Failure message"),
+            ...(input.stack ? { stack: normalizeRequiredString(input.stack, "Failure stack") } : {}),
+        },
+        resume: {
+            ...input.current.resume,
+            resumable: false,
+            requiresUserConfirmation: false,
+        },
+        updatedAt: input.at,
+        endedAt: input.at,
+    });
+    delete nextRecord.resume.interruptionDetectedAt;
+    delete nextRecord.resume.interruptedDuringCycle;
+    delete nextRecord.resume.note;
+    return researchSessionRecordSchema.parse(nextRecord);
+}
+export function deriveResearchSessionCompletedCycleStopCondition(input) {
+    if (input.run.status === "needs_human" || input.decision?.outcome === "needs_human") {
+        return {
+            type: "operator_stop",
+            note: `Cycle ${input.run.cycle} requires manual review before continuing.`,
+        };
+    }
+    if (input.session.progress.repeatedFailureStreak >= input.session.stopPolicy.repeatedFailures) {
+        return {
+            type: "repeated_failures",
+            count: input.session.progress.repeatedFailureStreak,
+            threshold: input.session.stopPolicy.repeatedFailures,
+        };
+    }
+    if (input.session.progress.noMeaningfulProgressStreak >= input.session.stopPolicy.noMeaningfulProgress) {
+        return {
+            type: "no_meaningful_progress",
+            count: input.session.progress.noMeaningfulProgressStreak,
+            threshold: input.session.stopPolicy.noMeaningfulProgress,
+        };
+    }
+    if (input.session.progress.insufficientEvidenceStreak >= input.session.stopPolicy.insufficientEvidence) {
+        return {
+            type: "insufficient_evidence",
+            count: input.session.progress.insufficientEvidenceStreak,
+            threshold: input.session.stopPolicy.insufficientEvidence,
+        };
+    }
+    return null;
+}
+function checkpointResearchSessionCompletedCycle(input) {
+    if (input.current.status !== "running") {
+        throw new Error(`Session ${input.current.sessionId} cannot checkpoint a cycle from status ${input.current.status}`);
+    }
+    if (input.run.cycle !== input.current.progress.nextCycle) {
+        throw new Error(`Run ${input.run.runId} cycle ${input.run.cycle} does not match next resumable cycle ${input.current.progress.nextCycle}`);
+    }
+    const frontierIds = [...new Set(input.frontierIds)];
+    const nextRecord = researchSessionRecordSchema.parse({
+        ...input.current,
+        workspace: {
+            ...input.current.workspace,
+            currentRef: input.run.workspaceRef,
+            ...(input.run.workspacePath ? { currentPath: input.run.workspacePath } : {}),
+        },
+        progress: {
+            completedCycles: input.run.cycle,
+            nextCycle: input.run.cycle + 1,
+            latestRunId: input.run.runId,
+            ...(input.decision ? { latestDecisionId: input.decision.decisionId } : {}),
+            latestFrontierIds: frontierIds,
+            repeatedFailureStreak: input.signal.outcome === "failed" ? input.current.progress.repeatedFailureStreak + 1 : 0,
+            noMeaningfulProgressStreak: input.signal.meaningfulProgress ? 0 : input.current.progress.noMeaningfulProgressStreak + 1,
+            insufficientEvidenceStreak: input.signal.insufficientEvidence ? input.current.progress.insufficientEvidenceStreak + 1 : 0,
+            ...(input.signal.meaningfulProgress ? { lastMeaningfulProgressCycle: input.run.cycle } : {}),
+            lastCheckpointAt: input.at,
+            lastSignals: {
+                cycle: input.run.cycle,
+                ...input.signal,
+            },
+        },
+        stopCondition: {
+            type: "none",
+        },
+        resume: {
+            resumable: true,
+            checkpointType: "completed_cycle_boundary",
+            resumeFromCycle: input.run.cycle + 1,
+            requiresUserConfirmation: false,
+            checkpointRunId: input.run.runId,
+            ...(input.decision ? { checkpointDecisionId: input.decision.decisionId } : {}),
+        },
+        updatedAt: input.at,
+    });
+    if (!input.signal.meaningfulProgress && input.current.progress.lastMeaningfulProgressCycle !== undefined) {
+        nextRecord.progress.lastMeaningfulProgressCycle = input.current.progress.lastMeaningfulProgressCycle;
+    }
+    delete nextRecord.resume.interruptionDetectedAt;
+    delete nextRecord.resume.interruptedDuringCycle;
+    delete nextRecord.resume.note;
+    delete nextRecord.progress.latestDecisionId;
+    delete nextRecord.resume.checkpointDecisionId;
+    delete nextRecord.workspace.currentPath;
+    if (input.decision) {
+        nextRecord.progress.latestDecisionId = input.decision.decisionId;
+        nextRecord.resume.checkpointDecisionId = input.decision.decisionId;
+    }
+    if (input.run.workspacePath) {
+        nextRecord.workspace.currentPath = input.run.workspacePath;
+    }
+    delete nextRecord.endedAt;
+    return researchSessionRecordSchema.parse(nextRecord);
+}
+function normalizeRequiredString(value, label) {
+    const normalized = value.trim();
+    if (!normalized) {
+        throw new Error(`${label} is required`);
+    }
+    return normalized;
+}
+function cloneResearchSessionDraftState(draftState) {
+    return {
+        currentStep: draftState.currentStep,
+        completedSteps: [...draftState.completedSteps],
+        returnToReview: draftState.returnToReview,
+        reviewConfirmed: draftState.reviewConfirmed,
+        ...(draftState.flowState
+            ? {
+                flowState: {
+                    ...(draftState.flowState.permissions
+                        ? {
+                            permissions: {
+                                ...draftState.flowState.permissions,
+                            },
+                        }
+                        : {}),
+                    ...(draftState.flowState.stopRules
+                        ? {
+                            stopRules: {
+                                ...draftState.flowState.stopRules,
+                            },
+                        }
+                        : {}),
+                    ...(draftState.flowState.outputs
+                        ? {
+                            outputs: {
+                                ...draftState.flowState.outputs,
+                            },
+                        }
+                        : {}),
+                    ...(draftState.flowState.review
+                        ? {
+                            review: {
+                                sections: draftState.flowState.review.sections.map((section) => ({
+                                    index: section.index,
+                                    label: section.label,
+                                    step: section.step,
+                                    fields: section.fields.map((field) => ({
+                                        label: field.label,
+                                        value: field.value,
+                                    })),
+                                })),
+                            },
+                        }
+                        : {}),
+                },
+            }
+            : {}),
+        ...(draftState.goalStep
+            ? {
+                goalStep: {
+                    ...draftState.goalStep,
+                },
+            }
+            : {}),
+        ...(draftState.contextStep
+            ? {
+                contextStep: {
+                    ...draftState.contextStep,
+                },
+            }
+            : {}),
+        ...(draftState.workspaceStep
+            ? {
+                workspaceStep: {
+                    ...draftState.workspaceStep,
+                },
+            }
+            : {}),
+        ...(draftState.agentStep
+            ? {
+                agentStep: {
+                    ...draftState.agentStep,
+                },
+            }
+            : {}),
+    };
+}
+function createResearchSessionSubmittedSnapshot(session) {
+    return {
+        sessionId: session.sessionId,
+        goal: session.goal,
+        workingDirectory: session.workingDirectory,
+        status: session.status,
+        agent: {
+            ...session.agent,
+            ttySession: {
+                ...session.agent.ttySession,
+            },
+        },
+        context: {
+            trackableGlobs: [...session.context.trackableGlobs],
+            webSearch: session.context.webSearch,
+            shellCommandAllowlistAdditions: [...session.context.shellCommandAllowlistAdditions],
+            shellCommandAllowlistRemovals: [...session.context.shellCommandAllowlistRemovals],
+        },
+        workspace: {
+            ...session.workspace,
+        },
+        stopPolicy: {
+            ...session.stopPolicy,
+        },
+        progress: {
+            ...session.progress,
+            latestFrontierIds: [...session.progress.latestFrontierIds],
+            ...(session.progress.lastSignals
+                ? {
+                    lastSignals: {
+                        ...session.progress.lastSignals,
+                        newArtifacts: [...session.progress.lastSignals.newArtifacts],
+                        reasons: [...session.progress.lastSignals.reasons],
+                    },
+                }
+                : {}),
+        },
+        stopCondition: {
+            ...session.stopCondition,
+        },
+        resume: {
+            ...session.resume,
+        },
+        ...(session.draftState
+            ? {
+                draftState: cloneResearchSessionDraftState(session.draftState),
+            }
+            : {}),
+        createdAt: session.createdAt,
+        updatedAt: session.updatedAt,
+        ...(session.endedAt ? { endedAt: session.endedAt } : {}),
+    };
+}
+//# sourceMappingURL=research-session-state-machine.js.map

package/dist/core/state/research-session-state-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-session-state-machine.js","sourceRoot":"","sources":["../../../src/core/state/research-session-state-machine.ts"],"names":[],"mappings":"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"}

package/dist/mcp/server.d.ts

@@ -1,6 +1,10 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ResearchSessionOrchestratorService } from "../app/services/research-session-orchestrator-service.js";
+import { ResearchSessionRecoveryService } from "../app/services/research-session-recovery-service.js";
 export interface RalphResearchMcpServerOptions {
     repoRoot?: string;
+    createResearchSessionOrchestratorService?: () => Pick<ResearchSessionOrchestratorService, "startSession" | "continueSession">;
+    createResearchSessionRecoveryService?: () => Pick<ResearchSessionRecoveryService, "inspectSession">;
 }
 export declare function createRalphResearchMcpServer(options?: RalphResearchMcpServerOptions): McpServer;
 export declare function startMcpServer(options?: RalphResearchMcpServerOptions): Promise<McpServer>;