import { createProcessObservation, type ProcessObservationSource, } from "./processObservation.js"; import { commitProcessReactiveProposal, createProcessReactiveSnapshot, reduceProcessReactiveScenario, } from "./processReactiveRuntime.js"; import { processReactiveScenarioSchema, type ProcessReactiveAction, type ProcessReactiveScenario, } from "./processReactiveScenario.js"; export const terminalTrigger = (literal = "Ready") => ({ kind: "terminal_text" as const, view: "decoded" as const, encoding: "utf8" as const, literal, case_sensitive: true, control_sequences: "include" as const, occurrence: 1, since: { kind: "scenario_start" as const }, consume: false, }); export const scenarioWith = ( transitions: readonly unknown[], ): ProcessReactiveScenario => processReactiveScenarioSchema.parse({ initial_state: "starting", deadline_ms: 30000, states: [ { id: "starting", max_visits: 4, deadline_ms: 5000, on: transitions, }, ], }); export const finish = ( id: string, when: unknown, priority = 100, actions: readonly unknown[] = [], ) => ({ id, priority, max_uses: 4, when, actions, target: { kind: "finish", outcome: "passed" }, }); export const collectionFor = (source: ProcessObservationSource) => { switch (source) { case "terminal_raw": return "frames" as const; case "terminal_rendered": return "rendered_frames" as const; case "process": return "process_samples" as const; case "filesystem": return "filesystem_checkpoints" as const; case "shim": return "shim_events" as const; case "http": case "websocket": return "protocol_events" as const; case "replay_transition": return "replay_transitions" as const; case "interaction": return "interaction_events" as const; case "lifecycle": return "lifecycle" as const; } }; export const observation = ( source: ProcessObservationSource, order: number, payload: unknown, ) => createProcessObservation({ source, source_sequence: order, captured_at_ms: order, subject_id: null, location: { collection: collectionFor(source), index: order, capture_order: order, }, payload, }); export const succeededEffect = ( action: ProcessReactiveAction, order: number, ) => ({ status: "succeeded" as const, observation: action.type === "checkpoint" ? observation("filesystem", order, { name: action.name }) : observation("interaction", order, { type: action.type === "send_input" ? "input" : action.type === "resize" ? "resize" : action.type === "close_stdin" ? "stdin_close" : "signal", data: action.type === "send_input" ? action.sensitive ? `` : action.data : action.type === "resize" ? `${String(action.columns)}x${String(action.rows)}` : action.type === "close_stdin" ? "" : action.signal, outcome: "dispatched", }), }); export const offer = ( scenario: ProcessReactiveScenario, snapshot: ReturnType, value: ReturnType, ) => { const proposed = reduceProcessReactiveScenario(scenario, snapshot, { kind: "observation", observation: value, }); return proposed.kind === "proposal" ? commitProcessReactiveProposal( scenario, proposed, proposed.effects.map((effect, index) => ({ ...succeededEffect( effect, (proposed.snapshot.observations.at(-1)?.capture_order ?? -1) + index + 1, ), })), ) : proposed; };