cueline 0.1.6 → 0.2.0

package/dist/src/observation/run-diff.js

@@ -0,0 +1,67 @@
+import { loadCueLineRunStatus } from "../api-runtime-lifecycle.js";
+function project(status) {
+    return {
+        runId: status.runId,
+        status: status.status,
+        executor: status.executor,
+        allowProcessExecution: status.allowProcessExecution,
+        phase: status.phase,
+        round: status.round,
+        maxRounds: status.maxRounds,
+        lastEventSequence: status.lastEventSequence,
+        runtimeOwnership: status.runtime.ownership,
+        cancellationRequested: status.cancellation.runRequested,
+        pendingControllerTurns: status.controller.pendingTurns,
+        acceptedCommands: status.controller.acceptedCommands,
+        archiveStatus: status.controller.archive.status,
+        jobs: { total: status.jobs.total, counts: { ...status.jobs.counts } },
+        continueAllowed: status.continueAllowed,
+        safeNextAction: status.safeNextAction,
+    };
+}
+function flatten(value, prefix = "", output = new Map()) {
+    for (const key of Object.keys(value).sort()) {
+        const field = prefix === "" ? key : `${prefix}.${key}`;
+        const item = value[key];
+        if (typeof item === "object" && item !== null && !Array.isArray(item)) {
+            flatten(item, field, output);
+        }
+        else if (item === null ||
+            typeof item === "string" ||
+            typeof item === "number" ||
+            typeof item === "boolean") {
+            output.set(field, item);
+        }
+    }
+    return output;
+}
+export async function compareCueLineRuns(leftRunId, rightRunId, options = {}) {
+    const observedAt = new Date();
+    const now = options.now ?? (() => observedAt);
+    const [leftStatus, rightStatus] = await Promise.all([
+        loadCueLineRunStatus(leftRunId, { ...options, now }),
+        loadCueLineRunStatus(rightRunId, { ...options, now }),
+    ]);
+    const left = project(leftStatus);
+    const right = project(rightStatus);
+    const { runId: _leftRunId, ...leftComparable } = left;
+    const { runId: _rightRunId, ...rightComparable } = right;
+    const leftFields = flatten(leftComparable);
+    const rightFields = flatten(rightComparable);
+    const fields = [...new Set([...leftFields.keys(), ...rightFields.keys()])].sort();
+    const changes = fields.flatMap((field) => {
+        const leftValue = leftFields.get(field) ?? 0;
+        const rightValue = rightFields.get(field) ?? 0;
+        return Object.is(leftValue, rightValue)
+            ? []
+            : [{ field, left: leftValue, right: rightValue }];
+    });
+    return {
+        schema: "cueline-run-diff/0.1",
+        equivalent: changes.length === 0,
+        left,
+        right,
+        changes,
+    };
+}
+//# sourceMappingURL=run-diff.js.map

package/dist/src/observation/run-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-diff.js","sourceRoot":"","sources":["../../../src/observation/run-diff.ts"],"names":[],"mappings":"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"}

package/dist/src/observation/run-graph.d.ts

@@ -0,0 +1,17 @@
+import { type CueLineRunTimeline, type CueLineRunTimelineOptions } from "./run-timeline.js";
+export interface CueLineRunGraphOptions extends CueLineRunTimelineOptions {
+}
+export interface CueLineRunGraph {
+    schema: "cueline-run-graph/0.1";
+    runId: string;
+    afterSequence: number;
+    limit: number;
+    totalEvents: number;
+    latestSequence: number;
+    returnedEvents: number;
+    hasMore: boolean;
+    nextAfterSequence: number;
+    mermaid: string;
+}
+export declare function buildCueLineRunGraph(timeline: CueLineRunTimeline): CueLineRunGraph;
+export declare function loadCueLineRunGraph(runId: string, options?: CueLineRunGraphOptions): Promise<CueLineRunGraph>;

package/dist/src/observation/run-graph.js

@@ -0,0 +1,77 @@
+import { CueLineError } from "../core/errors.js";
+import { loadCueLineRunTimeline, } from "./run-timeline.js";
+const DEFAULT_LIMIT = 100;
+const MAX_LIMIT = 200;
+function label(value) {
+    return value
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll("\\", "\\\\")
+        .replaceAll('"', '\\"')
+        .replaceAll("\n", " ");
+}
+function causalKey(value) {
+    return typeof value === "string" && value !== "" ? value : undefined;
+}
+export function buildCueLineRunGraph(timeline) {
+    const lines = ["flowchart TD"];
+    if (timeline.entries.length === 0) {
+        lines.push(`  empty["No events after sequence ${timeline.afterSequence}"]`);
+    }
+    else {
+        lines.push(`  start["Run ${label(timeline.runId)}"]`);
+        const requestNodes = new Map();
+        const jobNodes = new Map();
+        for (const [index, entry] of timeline.entries.entries()) {
+            const node = `e${entry.sequence}`;
+            lines.push(`  ${node}["#${entry.sequence} ${entry.category}<br/>${label(entry.summary)}"]`);
+            lines.push(`  ${index === 0 ? "start" : `e${timeline.entries[index - 1].sequence}`} --> ${node}`);
+            const requestId = causalKey(entry.attributes.requestId);
+            if (requestId !== undefined) {
+                const previous = requestNodes.get(requestId);
+                if (previous !== undefined && previous !== node) {
+                    lines.push(`  ${previous} -. request .-> ${node}`);
+                }
+                requestNodes.set(requestId, node);
+            }
+            const jobId = causalKey(entry.attributes.jobId);
+            if (jobId !== undefined) {
+                const previous = jobNodes.get(jobId);
+                if (previous !== undefined && previous !== node) {
+                    lines.push(`  ${previous} -. job .-> ${node}`);
+                }
+                jobNodes.set(jobId, node);
+            }
+            lines.push(`  class ${node} ${entry.category}`);
+        }
+    }
+    lines.push("  classDef run fill:#e8f0fe,stroke:#4c6ef5");
+    lines.push("  classDef controller fill:#f3e8ff,stroke:#8b5cf6");
+    lines.push("  classDef job fill:#e6fcf5,stroke:#0ca678");
+    lines.push("  classDef runtime fill:#fff3bf,stroke:#f08c00");
+    lines.push("  classDef caller_work fill:#e7f5ff,stroke:#1c7ed6");
+    lines.push("  classDef cancellation fill:#ffe3e3,stroke:#e03131");
+    lines.push("  classDef other fill:#f1f3f5,stroke:#868e96");
+    return {
+        schema: "cueline-run-graph/0.1",
+        runId: timeline.runId,
+        afterSequence: timeline.afterSequence,
+        limit: timeline.limit,
+        totalEvents: timeline.totalEvents,
+        latestSequence: timeline.latestSequence,
+        returnedEvents: timeline.returnedEvents,
+        hasMore: timeline.hasMore,
+        nextAfterSequence: timeline.nextAfterSequence,
+        mermaid: lines.join("\n"),
+    };
+}
+export async function loadCueLineRunGraph(runId, options = {}) {
+    const limit = options.limit ?? DEFAULT_LIMIT;
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > MAX_LIMIT) {
+        throw new CueLineError("RUN_GRAPH_LIMIT_INVALID", `Run graph limit must be a safe integer from 1 through ${MAX_LIMIT}.`);
+    }
+    const timeline = await loadCueLineRunTimeline(runId, { ...options, limit });
+    return buildCueLineRunGraph(timeline);
+}
+//# sourceMappingURL=run-graph.js.map

package/dist/src/observation/run-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-graph.js","sourceRoot":"","sources":["../../../src/observation/run-graph.ts"],"names":[],"mappings":"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"}

package/dist/src/observation/run-handoff.d.ts

@@ -0,0 +1,86 @@
+import type { CueLineRuntimeOptions } from "../api-contracts.js";
+import type { CueLineRunStatusSummary, CueLineSafeNextAction } from "../core/run-status.js";
+import type { CueLineRunState } from "../core/state-machine.js";
+export interface CueLineRunHandoffContent {
+    request: string;
+    tasks: Record<string, string>;
+    finalDeliveryText?: string;
+    blockedReason?: string;
+}
+export interface CueLineRunHandoffPacket {
+    schema: "cueline-handoff/0.1";
+    generatedAt: string;
+    contentPolicy: "metadata_only" | "bounded_request_and_tasks";
+    run: {
+        runId: string;
+        requestHash: string;
+        status: CueLineRunState["status"];
+        executor: CueLineRunState["executor"];
+        phase: CueLineRunStatusSummary["phase"];
+        round: number;
+        maxRounds: number;
+        eventSequence: number;
+        continueAllowed: boolean;
+        safeNextAction: CueLineSafeNextAction;
+    };
+    paths: {
+        home: string;
+        runDir: string;
+        events: string;
+        snapshot: string;
+        runtimeLease: string;
+    };
+    conversation: {
+        url: string | null;
+        responseAccepted: boolean;
+        lastAcceptedAction: CueLineRunStatusSummary["controller"]["lastAcceptedAction"];
+        lastAcceptedRequestId: string | null;
+        archive: CueLineRunStatusSummary["controller"]["archive"];
+    };
+    pendingControllerTurns: Array<{
+        requestId: string;
+        round: number;
+        submissionState: string;
+        conversationUrl: string | null;
+        manualSendConfirmed: boolean;
+        promptHash: string;
+        selectedModelLabel: string | null;
+        composerPromptState: "inline_ready" | "attachment_ready" | null;
+        submissionCheckpointContract: "write_ahead_v1" | null;
+    }>;
+    jobs: Array<{
+        jobId: string;
+        jobKey: string;
+        required: boolean;
+        lane: string;
+        mode: string;
+        status: string;
+        taskHash: string;
+        workdir?: string;
+        claimed?: boolean;
+        started?: boolean;
+    }>;
+    lastFailure: null | {
+        code: string;
+        stage: string | null;
+        submissionState: string | null;
+        requestId: string | null;
+        conversationUrl: string | null;
+    };
+    next: {
+        action: CueLineSafeNextAction;
+        instruction: string;
+        apiExample: string;
+    };
+    content?: CueLineRunHandoffContent;
+}
+export interface CueLineRunHandoffBuildOptions {
+    includeContent?: boolean;
+    maxContentChars?: number;
+    now?: () => Date;
+}
+export interface CueLineRunHandoffOptions extends Pick<CueLineRuntimeOptions, "home" | "environment" | "now">, Pick<CueLineRunHandoffBuildOptions, "includeContent" | "maxContentChars"> {
+}
+export declare function buildCueLineRunHandoff(state: CueLineRunState, status: CueLineRunStatusSummary, home: string, options?: CueLineRunHandoffBuildOptions): CueLineRunHandoffPacket;
+export declare function renderCueLineRunHandoffMarkdown(packet: CueLineRunHandoffPacket): string;
+export declare function createCueLineRunHandoff(runId: string, options?: CueLineRunHandoffOptions): Promise<CueLineRunHandoffPacket>;

package/dist/src/observation/run-handoff.js

@@ -0,0 +1,309 @@
+import { createHash } from "node:crypto";
+import { loadCueLineRunStatus } from "../api-runtime-lifecycle.js";
+import { CueLineError } from "../core/errors.js";
+import { jobSpecHash } from "../core/ids.js";
+import { loadPersistedRunStore } from "../core/persisted-run.js";
+import { defaultCueLineHome, runPaths } from "../state/paths.js";
+const DEFAULT_MAX_CONTENT_CHARS = 2_000;
+const MIN_MAX_CONTENT_CHARS = 16;
+const MAX_MAX_CONTENT_CHARS = 10_000;
+function sha256(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+function maxContentChars(value) {
+    const resolved = value ?? DEFAULT_MAX_CONTENT_CHARS;
+    if (!Number.isSafeInteger(resolved) ||
+        resolved < MIN_MAX_CONTENT_CHARS ||
+        resolved > MAX_MAX_CONTENT_CHARS) {
+        throw new CueLineError("RUN_HANDOFF_OPTIONS_INVALID", `maxContentChars must be an integer from ${MIN_MAX_CONTENT_CHARS} to ${MAX_MAX_CONTENT_CHARS}.`);
+    }
+    return resolved;
+}
+function bounded(value, maximum) {
+    if (value.length <= maximum)
+        return value;
+    const marker = "[truncated]";
+    if (maximum <= marker.length)
+        return marker.slice(0, maximum);
+    return `${value.slice(0, Math.max(0, maximum - marker.length))}${marker}`;
+}
+function nextStep(runId, action, jobs) {
+    const active = (job) => job.status === "pending" || job.status === "running";
+    const firstJob = action === "claim_caller_work"
+        ? jobs.find((job) => active(job) && job.mode === "work" && job.claimed !== true)
+        : action === "start_caller_work"
+            ? jobs.find((job) => active(job) && job.mode === "work" && job.claimed === true && job.started !== true)
+            : action === "continue_caller_work"
+                ? jobs.find((job) => active(job) && job.mode === "work" && job.started === true)
+                : action === "execute_caller_jobs"
+                    ? jobs.find((job) => active(job) && job.mode === "advise")
+                    : jobs.find(active);
+    const jobId = firstJob?.jobId ?? "<job-id>";
+    const shared = {
+        action,
+        instruction: "Inspect the persisted run before acting. Pro has no local tools.",
+        apiExample: `await continueCueLineRun({ runId: ${JSON.stringify(runId)}, browser });`,
+    };
+    switch (action) {
+        case "observe":
+            return {
+                action,
+                instruction: "Observe the exact persisted controller turn; do not resend or interrupt Pro.",
+                apiExample: shared.apiExample,
+            };
+        case "retry":
+            return {
+                action,
+                instruction: "Durable evidence proves the same turn was not sent; retry only that turn.",
+                apiExample: shared.apiExample,
+            };
+        case "reconcile":
+            return {
+                action,
+                instruction: "Reconcile exact conversation, model, round, and request identity; never resend.",
+                apiExample: `await confirmManualControllerSubmission(${JSON.stringify(runId)}, { requestId: "<request-id>", conversationUrl: "https://chatgpt.com/c/..." });`,
+            };
+        case "execute_caller_jobs":
+            return {
+                action,
+                instruction: "The current Codex must execute each caller advice job locally and submit terminal evidence.",
+                apiExample: `await submitCueLineCallerJobResult(${JSON.stringify(runId)}, ${JSON.stringify(jobId)}, result);`,
+            };
+        case "claim_caller_work":
+            return {
+                action,
+                instruction: "Pro only proposed the work. Claim the exact caller work job before modifying files.",
+                apiExample: `await claimCueLineCallerJob(${JSON.stringify(runId)}, ${JSON.stringify(jobId)}, { callerId: "<current-codex>" });`,
+            };
+        case "start_caller_work":
+            return {
+                action,
+                instruction: "Verify the existing claim proof, then durably start that exact claim before mutation.",
+                apiExample: `await startCueLineCallerJob(${JSON.stringify(runId)}, ${JSON.stringify(jobId)}, claimProof);`,
+            };
+        case "continue_caller_work":
+            return {
+                action,
+                instruction: "Work may already have side effects. Continue only the existing started claim; never retry automatically.",
+                apiExample: `await heartbeatCueLineCallerJob(${JSON.stringify(runId)}, ${JSON.stringify(jobId)}, claimProof);`,
+            };
+        case "inspect_runtime":
+            return {
+                action,
+                instruction: "Inspect owner and worker liveness before takeover or reconciliation.",
+                apiExample: `cueline run status ${runId} --json`,
+            };
+        case "inspect_jobs_then_continue":
+            return {
+                action,
+                instruction: "Resolve every active-looking job from durable and process evidence before continuing.",
+                apiExample: `cueline jobs --json`,
+            };
+        case "settle_controller_archive":
+            return {
+                action,
+                instruction: "Settle the durable post-completion archive state once. A started attempt must become ambiguous; never click Archive again.",
+                apiExample: shared.apiExample,
+            };
+        case "return_result":
+            return {
+                action,
+                instruction: "The run is terminal. Return its persisted result without continuing it.",
+                apiExample: `await loadCueLineRunState(${JSON.stringify(runId)});`,
+            };
+        case "continue":
+        default:
+            return shared;
+    }
+}
+export function buildCueLineRunHandoff(state, status, home, options = {}) {
+    if (state.runId !== status.runId) {
+        throw new CueLineError("RUN_HANDOFF_ID_MISMATCH", "Run state and status belong to different runs.");
+    }
+    const maximum = maxContentChars(options.maxContentChars);
+    const paths = runPaths(home, state.runId);
+    const statusJobs = new Map(status.jobs.items.map((job) => [job.jobId, job]));
+    const jobs = Object.values(state.jobs).map((job) => {
+        const observed = statusJobs.get(job.jobId);
+        const claim = job.callerWork?.claim;
+        return {
+            jobId: job.jobId,
+            jobKey: job.jobKey,
+            required: job.required,
+            lane: job.spec.lane,
+            mode: job.spec.mode,
+            status: observed?.status ?? job.status,
+            taskHash: jobSpecHash(job.spec),
+            ...(job.spec.workdir === undefined ? {} : { workdir: job.spec.workdir }),
+            ...(job.spec.mode !== "work"
+                ? {}
+                : {
+                    claimed: claim !== null && claim !== undefined,
+                    started: claim?.startedAt !== null && claim?.startedAt !== undefined,
+                }),
+        };
+    });
+    const packet = {
+        schema: "cueline-handoff/0.1",
+        generatedAt: (options.now ?? (() => new Date()))().toISOString(),
+        contentPolicy: options.includeContent === true
+            ? "bounded_request_and_tasks"
+            : "metadata_only",
+        run: {
+            runId: state.runId,
+            requestHash: sha256(state.request),
+            status: state.status,
+            executor: state.executor,
+            phase: status.phase,
+            round: state.round,
+            maxRounds: state.maxRounds,
+            eventSequence: status.lastEventSequence,
+            continueAllowed: status.continueAllowed,
+            safeNextAction: status.safeNextAction,
+        },
+        paths: {
+            home: paths.home,
+            runDir: paths.runDir,
+            events: paths.events,
+            snapshot: paths.snapshot,
+            runtimeLease: paths.runtimeLease,
+        },
+        conversation: {
+            url: state.conversationUrl,
+            responseAccepted: status.controller.responseAccepted,
+            lastAcceptedAction: status.controller.lastAcceptedAction,
+            lastAcceptedRequestId: status.controller.lastAcceptedRequestId,
+            archive: { ...status.controller.archive },
+        },
+        pendingControllerTurns: state.pendingControllerTurns.map((turn) => ({
+            requestId: turn.requestId,
+            round: turn.round,
+            submissionState: turn.submissionState,
+            conversationUrl: turn.conversationUrl,
+            manualSendConfirmed: turn.manualSendConfirmed,
+            promptHash: turn.promptHash,
+            selectedModelLabel: turn.selectedModelLabel,
+            composerPromptState: turn.composerPromptState,
+            submissionCheckpointContract: turn.submissionCheckpointContract ?? null,
+        })),
+        jobs,
+        lastFailure: state.lastFailure === null
+            ? null
+            : {
+                code: state.lastFailure.code,
+                stage: state.lastFailure.stage,
+                submissionState: state.lastFailure.submissionState,
+                requestId: state.lastFailure.requestId,
+                conversationUrl: state.lastFailure.conversationUrl,
+            },
+        next: nextStep(state.runId, status.safeNextAction, jobs),
+    };
+    if (options.includeContent === true) {
+        const trailing = [
+            ...Object.values(state.jobs).map((job) => ({
+                kind: "task",
+                key: job.jobId,
+                value: job.spec.task,
+            })),
+            ...(state.finalDeliveryText === null
+                ? []
+                : [{ kind: "final", key: "final", value: state.finalDeliveryText }]),
+            ...(state.blockedReason === null
+                ? []
+                : [{ kind: "blocked", key: "blocked", value: state.blockedReason }]),
+        ];
+        const requestBudget = trailing.length === 0 ? maximum : Math.floor(maximum / 2);
+        const content = {
+            request: bounded(state.request, requestBudget),
+            tasks: {},
+        };
+        let remaining = maximum - content.request.length;
+        trailing.forEach((item, index) => {
+            const share = Math.floor(remaining / (trailing.length - index));
+            if (share < 1)
+                return;
+            const value = bounded(item.value, share);
+            remaining -= value.length;
+            if (item.kind === "task")
+                content.tasks[item.key] = value;
+            else if (item.kind === "final")
+                content.finalDeliveryText = value;
+            else
+                content.blockedReason = value;
+        });
+        packet.content = content;
+    }
+    return packet;
+}
+function json(value) {
+    return JSON.stringify(value);
+}
+export function renderCueLineRunHandoffMarkdown(packet) {
+    const lines = [
+        "# CueLine run handoff",
+        "",
+        `- Run: ${json(packet.run.runId)}`,
+        `- Status: ${packet.run.status} / ${packet.run.phase}`,
+        `- Executor: ${packet.run.executor}`,
+        `- Round: ${packet.run.round}/${packet.run.maxRounds}`,
+        `- Event sequence: ${packet.run.eventSequence}`,
+        `- Conversation: ${json(packet.conversation.url)}`,
+        `- Controller archive: ${packet.conversation.archive.enabled ? packet.conversation.archive.status : "disabled"}`,
+        `- Run directory: ${json(packet.paths.runDir)}`,
+        `- Event log: ${json(packet.paths.events)}`,
+        `- Safe next action: ${packet.run.safeNextAction}`,
+        "",
+        "## Next step",
+        "",
+        packet.next.instruction,
+        "",
+        "```text",
+        packet.next.apiExample,
+        "```",
+        "",
+        "Before acting, run:",
+        "",
+        "```text",
+        `cueline run status ${packet.run.runId} --json`,
+        "```",
+        "",
+        "Pro has no local tools. Do not describe a dispatch as local work already performed.",
+        "",
+        "## Pending controller turns",
+        "",
+    ];
+    if (packet.pendingControllerTurns.length === 0)
+        lines.push("None.");
+    for (const turn of packet.pendingControllerTurns) {
+        lines.push(`- request=${json(turn.requestId)} round=${turn.round} submission=${turn.submissionState} manual=${turn.manualSendConfirmed ? "yes" : "no"} url=${json(turn.conversationUrl)}`);
+    }
+    lines.push("", "## Jobs", "");
+    if (packet.jobs.length === 0)
+        lines.push("None.");
+    for (const job of packet.jobs) {
+        lines.push(`- id=${json(job.jobId)} key=${json(job.jobKey)} mode=${job.mode} status=${job.status} required=${job.required ? "yes" : "no"} workdir=${json(job.workdir ?? null)} task_hash=${job.taskHash}`);
+    }
+    if (packet.content !== undefined) {
+        lines.push("", "## Bounded content", "", `- Request: ${json(packet.content.request)}`);
+        for (const [jobId, task] of Object.entries(packet.content.tasks)) {
+            lines.push(`- Task ${json(jobId)}: ${json(task)}`);
+        }
+    }
+    return lines.join("\n");
+}
+export async function createCueLineRunHandoff(runId, options = {}) {
+    const environment = options.environment ?? process.env;
+    const home = options.home ?? defaultCueLineHome(environment);
+    for (let attempt = 0; attempt < 2; attempt += 1) {
+        const store = await loadPersistedRunStore(home, runId);
+        const status = await loadCueLineRunStatus(runId, {
+            home,
+            ...(options.now === undefined ? {} : { now: options.now }),
+        });
+        if (store.lastSequence === status.lastEventSequence) {
+            return buildCueLineRunHandoff(store.state, status, home, options);
+        }
+    }
+    throw new CueLineError("RUN_HANDOFF_SNAPSHOT_CHANGED", `Run '${runId}' changed while its handoff packet was being read; retry the read-only command.`);
+}
+//# sourceMappingURL=run-handoff.js.map

package/dist/src/observation/run-handoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-handoff.js","sourceRoot":"","sources":["../../../src/observation/run-handoff.ts"],"names":[],"mappings":"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"}

package/dist/src/observation/run-status-at.d.ts

@@ -0,0 +1,41 @@
+import type { CueLineRuntimeOptions } from "../api-contracts.js";
+export interface CueLineRunStatusAtOptions extends Pick<CueLineRuntimeOptions, "environment" | "home"> {
+    sequence: number;
+}
+export interface CueLineRunStatusAt {
+    schema: "cueline-status-at/0.1";
+    runId: string;
+    requestedSequence: number;
+    latestSequence: number;
+    latestAuthoritativeSequence: number;
+    totalEvents: number;
+    authoritativeEvents: number;
+    authoritativeEventsApplied: number;
+    ignoredNonAuthoritativeEventsThroughSequence: number;
+    asOf: {
+        type: string;
+        timestamp: string;
+    };
+    state: {
+        status: string;
+        executor: string;
+        allowProcessExecution: boolean;
+        round: number;
+        maxRounds: number;
+        conversationBound: boolean;
+        pendingControllerTurns: number;
+        abandonedControllerTurns: number;
+        acceptedCommands: number;
+        pendingCommandExecution: boolean;
+        jobs: {
+            total: number;
+            counts: Record<string, number>;
+        };
+        archiveStatus: string;
+        finalDeliveryAvailable: boolean;
+        blockedReasonAvailable: boolean;
+        cancelledReasonAvailable: boolean;
+        lastFailureCode: string | null;
+    };
+}
+export declare function loadCueLineRunStatusAt(runId: string, options: CueLineRunStatusAtOptions): Promise<CueLineRunStatusAt>;