thehood 0.1.0-preview.0

package/dist/runtime/externalTransfer.d.ts

@@ -0,0 +1,20 @@
+import type { ExternalTransferManifest, ExternalTransferPurpose, JsonObject, RoleAssignment, RunArtifact, RunRecord, RuntimeRole } from "./types.js";
+export interface BuildExternalTransferManifestInput {
+    run: RunRecord;
+    role: RuntimeRole;
+    destination: RoleAssignment;
+    purpose: ExternalTransferPurpose;
+    approvalPhrase: string;
+    artifacts: RunArtifact[];
+}
+export interface ExternalTransferPreview {
+    manifestArtifact: RunArtifact;
+    manifest: ExternalTransferManifest;
+}
+export declare const buildExternalTransferManifest: (input: BuildExternalTransferManifestInput) => Promise<ExternalTransferManifest>;
+export declare const writeExternalTransferManifestArtifact: (input: BuildExternalTransferManifestInput) => Promise<{
+    manifest: ExternalTransferManifest;
+    artifact: RunArtifact;
+}>;
+export declare const readLatestExternalTransferManifest: (run: RunRecord) => Promise<ExternalTransferPreview>;
+export declare const transferManifestSummary: (manifest: ExternalTransferManifest) => JsonObject;

package/dist/runtime/externalTransfer.js

@@ -0,0 +1,156 @@
+import crypto from "node:crypto";
+import { readRunArtifact, writeRunArtifact } from "./artifacts.js";
+import { InputError } from "./errors.js";
+import { newId, nowIso } from "./ids.js";
+const maxArtifactBytes = 200_000;
+const previewBytes = 4_000;
+const secretPatterns = [
+    /(?:api[_-]?key|secret|password|token)\s*[:=]\s*["']?[A-Za-z0-9_./+=-]{8,}/i,
+    /authorization:\s*bearer/i,
+    /ssh-rsa|-----BEGIN [A-Z ]*PRIVATE KEY-----/
+];
+const sha256 = (value) => crypto.createHash("sha256").update(value).digest("hex");
+const artifactRiskClass = (purpose) => {
+    switch (purpose) {
+        case "progress_packet":
+        case "memory_packet":
+        case "reconciliation":
+            return "private_runtime_memory";
+        case "repo_context":
+            return "repo_context";
+    }
+};
+const detectSecretPatternHits = (content) => secretPatterns.filter((pattern) => pattern.test(content)).length;
+const buildRisk = (purpose, artifactContents) => {
+    const secretPatternHits = artifactContents.reduce((count, content) => count + detectSecretPatternHits(content), 0);
+    const reasons = [
+        purpose === "repo_context"
+            ? "Transfer includes runtime-captured repository context."
+            : "Transfer includes private TheHood runtime memory."
+    ];
+    if (secretPatternHits > 0) {
+        reasons.push("Secret-like text was detected in the transfer source artifact preview.");
+    }
+    return {
+        class: secretPatternHits > 0 ? "secret_risk" : artifactRiskClass(purpose),
+        reasons,
+        secretPatternHits
+    };
+};
+const artifactRef = async (run, artifact) => {
+    const result = await readRunArtifact({
+        repoPath: run.repoPath,
+        runId: run.runId,
+        ref: artifact.ref,
+        maxBytes: maxArtifactBytes
+    });
+    if (result.truncated) {
+        throw new InputError(`External transfer source artifact is too large to review safely: ${artifact.ref}`);
+    }
+    return {
+        ref: {
+            kind: artifact.kind,
+            ref: artifact.ref,
+            summary: artifact.summary,
+            byteLength: result.byteLength,
+            truncated: result.truncated,
+            sha256: sha256(result.content)
+        },
+        content: result.content
+    };
+};
+const previewContent = (contents) => {
+    const joined = contents.join("\n\n--- artifact boundary ---\n\n");
+    const truncated = Buffer.byteLength(joined, "utf8") > previewBytes;
+    return {
+        content: joined.slice(0, previewBytes),
+        truncated
+    };
+};
+export const buildExternalTransferManifest = async (input) => {
+    const inspected = await Promise.all(input.artifacts.map((artifact) => artifactRef(input.run, artifact)));
+    const contents = inspected.map((item) => item.content);
+    const preview = previewContent(contents);
+    const approvalHint = `I approve ${input.approvalPhrase} for run ${input.run.runId}.`;
+    return {
+        schemaVersion: 1,
+        kind: "external_transfer_manifest",
+        runId: input.run.runId,
+        createdAt: nowIso(),
+        destination: input.destination,
+        role: input.role,
+        purpose: input.purpose,
+        approvalPhrase: input.approvalPhrase,
+        approvalHint,
+        artifacts: inspected.map((item) => item.ref),
+        totalBytes: inspected.reduce((total, item) => total + item.ref.byteLength, 0),
+        risk: buildRisk(input.purpose, contents),
+        redaction: {
+            status: "not_applied",
+            notes: [
+                "The manifest previews the exact bounded artifact content before external transfer.",
+                "Source artifacts remain canonical; provider-visible packets are built from these artifacts."
+            ]
+        },
+        preview: {
+            maxBytes: previewBytes,
+            content: preview.content,
+            truncated: preview.truncated
+        },
+        provenance: {
+            sourceArtifactRefs: input.artifacts.map((artifact) => artifact.ref),
+            notes: [
+                "Generated by the runtime before an external provider transfer approval gate.",
+                "Approval should be based on this manifest, not on provider session context."
+            ]
+        }
+    };
+};
+export const writeExternalTransferManifestArtifact = async (input) => {
+    const manifest = await buildExternalTransferManifest(input);
+    const artifact = await writeRunArtifact({
+        repoPath: input.run.repoPath,
+        runId: input.run.runId,
+        kind: "transfer_manifest",
+        name: `${input.purpose}-${input.destination.provider}-${newId("transfer")}.json`,
+        content: `${JSON.stringify(manifest, null, 2)}\n`,
+        summary: `${input.purpose} transfer manifest for ${input.destination.provider}:${input.destination.model}.`
+    });
+    return {
+        manifest,
+        artifact
+    };
+};
+const isManifest = (value) => value !== null &&
+    typeof value === "object" &&
+    !Array.isArray(value) &&
+    value.kind === "external_transfer_manifest";
+export const readLatestExternalTransferManifest = async (run) => {
+    const manifestArtifact = run.artifacts.filter((artifact) => artifact.kind === "transfer_manifest").at(-1);
+    if (!manifestArtifact) {
+        throw new InputError(`Run ${run.runId} does not have a transfer manifest artifact.`);
+    }
+    const result = await readRunArtifact({
+        repoPath: run.repoPath,
+        runId: run.runId,
+        ref: manifestArtifact.ref,
+        maxBytes: maxArtifactBytes
+    });
+    const parsed = JSON.parse(result.content);
+    if (!isManifest(parsed)) {
+        throw new InputError(`Transfer manifest artifact is invalid: ${manifestArtifact.ref}`);
+    }
+    return {
+        manifestArtifact,
+        manifest: parsed
+    };
+};
+export const transferManifestSummary = (manifest) => ({
+    destination: `${manifest.destination.provider}:${manifest.destination.model}`,
+    purpose: manifest.purpose,
+    riskClass: manifest.risk.class,
+    totalBytes: manifest.totalBytes,
+    artifactCount: manifest.artifacts.length,
+    approvalPhrase: manifest.approvalPhrase
+});
+//# sourceMappingURL=externalTransfer.js.map

package/dist/runtime/externalTransfer.js.map

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

package/dist/runtime/fanout.d.ts

@@ -0,0 +1,64 @@
+import type { AgentResponse } from "../providers/types.js";
+import type { JsonObject, RoleAssignment, RunArtifact, RunRecord, RuntimeRole } from "./types.js";
+export type FanoutStatus = "completed" | "blocked" | "failed";
+export type FanoutItemStatus = "completed" | "blocked" | "failed";
+export interface FanoutItemInput {
+    role: RuntimeRole;
+    brief: string;
+    summonKind?: string;
+    persona?: string;
+    agent?: RoleAssignment;
+    constraints?: string[];
+    evidenceRefs?: string[];
+}
+export interface FanoutAgentsInput {
+    repoPath: string;
+    runId: string;
+    items: FanoutItemInput[];
+    maxItems?: number;
+}
+export interface FanoutBounds {
+    requestedItems: number;
+    maxItems: number;
+    hardMaxItems: number;
+    executedItems: number;
+    execution: "sequential";
+}
+export interface FanoutItemResult {
+    index: number;
+    role: RuntimeRole;
+    summonKind: string;
+    brief: string;
+    status: FanoutItemStatus;
+    stopReason: string;
+    providerResponseCount: number;
+    assignment?: RoleAssignment;
+    providerStatus?: AgentResponse["status"];
+    directiveArtifact?: RunArtifact;
+    responseArtifact?: RunArtifact;
+    error?: string;
+}
+export interface FanoutAgentsResult {
+    run: RunRecord;
+    status: FanoutStatus;
+    bounds: FanoutBounds;
+    items: FanoutItemResult[];
+    artifact: RunArtifact;
+}
+export interface FanoutArtifactPayload {
+    schemaVersion: 1;
+    kind: "fanout";
+    runId: string;
+    createdAt: string;
+    status: FanoutStatus;
+    bounds: FanoutBounds;
+    safety: {
+        sidecarOnly: boolean;
+        readOnlyRolesOnly: boolean;
+        canSatisfyRequiredGates: boolean;
+        instruction: string;
+    };
+    items: JsonObject[];
+}
+export declare const defaultFanoutMaxItems = 8;
+export declare const fanoutAgents: (input: FanoutAgentsInput) => Promise<FanoutAgentsResult>;

package/dist/runtime/fanout.js

@@ -0,0 +1,263 @@
+import { writeRunArtifact } from "./artifacts.js";
+import { loadConfig } from "./config.js";
+import { InputError } from "./errors.js";
+import { newId, nowIso } from "./ids.js";
+import { defaultRolePermissions } from "./permissions.js";
+import { loadRun, saveRun } from "./store.js";
+import { summonAgent } from "./summons.js";
+const fanoutRoles = [
+    "orchestrator",
+    "planner",
+    "researcher",
+    "qa",
+    "verifier",
+    "critic"
+];
+export const defaultFanoutMaxItems = 8;
+const hardFanoutMaxItems = 8;
+const maxTextLength = 500;
+const createEvent = (type, message, data) => ({
+    id: newId("event"),
+    createdAt: nowIso(),
+    type,
+    message,
+    ...(data ? { data } : {})
+});
+const truncateText = (value) => value.length <= maxTextLength ? value : `${value.slice(0, maxTextLength - 3)}...`;
+const isFanoutRole = (role) => fanoutRoles.includes(role) && !defaultRolePermissions[role].edit;
+const normalizeItems = (items, maxItems) => {
+    if (items.length === 0) {
+        throw new InputError("Fan-out requires at least one item.");
+    }
+    if (items.length > maxItems) {
+        throw new InputError(`Fan-out accepts at most ${maxItems} item(s) for this call.`);
+    }
+    return items.map((item, index) => {
+        if (!isFanoutRole(item.role)) {
+            throw new InputError(`Fan-out item ${index + 1} role must be orchestrator, planner, researcher, qa, verifier, or critic.`);
+        }
+        const brief = item.brief.trim();
+        if (!brief) {
+            throw new InputError(`Fan-out item ${index + 1} brief cannot be empty.`);
+        }
+        return {
+            role: item.role,
+            brief,
+            ...(item.summonKind ? { summonKind: item.summonKind } : {}),
+            ...(item.persona ? { persona: item.persona } : {}),
+            ...(item.agent ? { agent: item.agent } : {}),
+            constraints: item.constraints ?? [],
+            evidenceRefs: item.evidenceRefs ?? []
+        };
+    });
+};
+const resolveConfiguredMaxItems = (value) => {
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new InputError("Configured defaults.fanoutMaxItems must be a positive integer.");
+    }
+    if (value > hardFanoutMaxItems) {
+        throw new InputError(`Configured defaults.fanoutMaxItems cannot exceed ${hardFanoutMaxItems}.`);
+    }
+    return value;
+};
+const resolveMaxItems = (value, configuredMaxItems) => {
+    const policyMaxItems = resolveConfiguredMaxItems(configuredMaxItems);
+    if (value === undefined) {
+        return policyMaxItems;
+    }
+    if (!Number.isSafeInteger(value) || value < 1) {
+        throw new InputError("Fan-out maxItems must be a positive integer.");
+    }
+    if (value > policyMaxItems) {
+        throw new InputError(`Fan-out maxItems cannot exceed configured defaults.fanoutMaxItems (${policyMaxItems}).`);
+    }
+    if (value > hardFanoutMaxItems) {
+        throw new InputError(`Fan-out maxItems cannot exceed ${hardFanoutMaxItems}.`);
+    }
+    return value;
+};
+const itemStatusFromResponse = (run, response) => {
+    if (run.approvalRequired || response?.status === "blocked") {
+        return "blocked";
+    }
+    if (response?.status === "failed") {
+        return "failed";
+    }
+    return "completed";
+};
+const resultFromSummon = (index, brief, result) => {
+    const latestResponse = result.providerResponses.at(-1);
+    const status = itemStatusFromResponse(result.run, latestResponse);
+    return {
+        index,
+        role: result.role,
+        summonKind: result.summonKind,
+        brief: truncateText(brief),
+        status,
+        stopReason: result.stopReason,
+        providerResponseCount: result.providerResponses.length,
+        assignment: result.assignment,
+        ...(latestResponse ? { providerStatus: latestResponse.status } : {}),
+        ...(result.directiveArtifact ? { directiveArtifact: result.directiveArtifact } : {}),
+        ...(result.responseArtifact ? { responseArtifact: result.responseArtifact } : {})
+    };
+};
+const failedItem = (index, item, error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        index,
+        role: item.role,
+        summonKind: item.summonKind ?? (item.role === "qa" ? "qa" : "review"),
+        brief: truncateText(item.brief),
+        status: "failed",
+        stopReason: message,
+        providerResponseCount: 0,
+        ...(item.agent ? { assignment: item.agent } : {}),
+        error: message
+    };
+};
+const fanoutStatus = (items) => {
+    if (items.some((item) => item.status === "blocked")) {
+        return "blocked";
+    }
+    if (items.some((item) => item.status === "failed")) {
+        return "failed";
+    }
+    return "completed";
+};
+const artifactSummary = (artifact) => artifact
+    ? {
+        kind: artifact.kind,
+        ref: artifact.ref,
+        summary: artifact.summary
+    }
+    : undefined;
+const assignmentSummary = (assignment) => assignment
+    ? {
+        provider: assignment.provider,
+        model: assignment.model
+    }
+    : undefined;
+const itemPayload = (item) => {
+    const assignment = assignmentSummary(item.assignment);
+    const directiveArtifact = artifactSummary(item.directiveArtifact);
+    const responseArtifact = artifactSummary(item.responseArtifact);
+    return {
+        index: item.index,
+        role: item.role,
+        summonKind: item.summonKind,
+        status: item.status,
+        brief: item.brief,
+        stopReason: item.stopReason,
+        providerResponseCount: item.providerResponseCount,
+        ...(item.providerStatus ? { providerStatus: item.providerStatus } : {}),
+        ...(assignment ? { assignment } : {}),
+        ...(directiveArtifact ? { directiveArtifact } : {}),
+        ...(responseArtifact ? { responseArtifact } : {}),
+        ...(item.error ? { error: item.error } : {})
+    };
+};
+const buildFanoutPayload = (run, status, bounds, items) => ({
+    schemaVersion: 1,
+    kind: "fanout",
+    runId: run.runId,
+    createdAt: nowIso(),
+    status,
+    bounds,
+    safety: {
+        sidecarOnly: true,
+        readOnlyRolesOnly: true,
+        canSatisfyRequiredGates: false,
+        instruction: "Fan-out evidence is advisory. It cannot satisfy verifier, runtime QA, approval, or completion gates."
+    },
+    items: items.map(itemPayload)
+});
+const appendFanoutArtifact = async (run, status, bounds, items) => {
+    const latest = await loadRun(run.repoPath, run.runId);
+    const payload = buildFanoutPayload(latest, status, bounds, items);
+    const artifact = await writeRunArtifact({
+        repoPath: latest.repoPath,
+        runId: latest.runId,
+        kind: "fanout",
+        name: `fanout-${newId("fanout")}.json`,
+        content: `${JSON.stringify(payload, null, 2)}\n`,
+        summary: `Agent fan-out ${status}: ${bounds.executedItems}/${bounds.requestedItems} item(s)`
+    });
+    const updated = {
+        ...latest,
+        updatedAt: nowIso(),
+        artifacts: [...latest.artifacts, artifact],
+        events: [
+            ...latest.events,
+            createEvent("agent_fanout_completed", artifact.summary, {
+                status,
+                artifactRef: artifact.ref,
+                requestedItems: bounds.requestedItems,
+                executedItems: bounds.executedItems,
+                maxItems: bounds.maxItems
+            })
+        ]
+    };
+    await saveRun(updated);
+    return {
+        run: updated,
+        artifact
+    };
+};
+export const fanoutAgents = async (input) => {
+    const config = await loadConfig(input.repoPath);
+    const maxItems = resolveMaxItems(input.maxItems, config.defaults.fanoutMaxItems);
+    const items = normalizeItems(input.items, maxItems);
+    const initialRun = await loadRun(input.repoPath, input.runId);
+    if (initialRun.approvalRequired) {
+        throw new InputError(`Run ${initialRun.runId} is waiting for approval: ${initialRun.approvalReason ?? "approval required"}.`);
+    }
+    let currentRun = initialRun;
+    const results = [];
+    for (const [index, item] of items.entries()) {
+        try {
+            const result = await summonAgent({
+                repoPath: input.repoPath,
+                runId: input.runId,
+                role: item.role,
+                brief: item.brief,
+                ...(item.summonKind ? { summonKind: item.summonKind } : {}),
+                ...(item.persona ? { persona: item.persona } : {}),
+                ...(item.agent ? { agent: item.agent } : {}),
+                constraints: item.constraints ?? [],
+                evidenceRefs: item.evidenceRefs ?? []
+            });
+            const itemResult = resultFromSummon(index, item.brief, result);
+            results.push(itemResult);
+            currentRun = result.run;
+            if (itemResult.status !== "completed" && currentRun.approvalRequired) {
+                break;
+            }
+        }
+        catch (error) {
+            const itemResult = failedItem(index, item, error);
+            results.push(itemResult);
+            currentRun = await loadRun(input.repoPath, input.runId);
+            if (currentRun.approvalRequired) {
+                break;
+            }
+        }
+    }
+    const status = fanoutStatus(results);
+    const bounds = {
+        requestedItems: items.length,
+        maxItems,
+        hardMaxItems: hardFanoutMaxItems,
+        executedItems: results.length,
+        execution: "sequential"
+    };
+    const appended = await appendFanoutArtifact(currentRun, status, bounds, results);
+    return {
+        run: appended.run,
+        status,
+        bounds,
+        items: results,
+        artifact: appended.artifact
+    };
+};
+//# sourceMappingURL=fanout.js.map

package/dist/runtime/fanout.js.map

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

package/dist/runtime/gitEvidence.d.ts

@@ -0,0 +1,10 @@
+import { type ProtectedPathMatch } from "./protectedPaths.js";
+import type { RunArtifact, RunRecord } from "./types.js";
+export interface GitEvidenceResult {
+    run: RunRecord;
+    changedPaths: string[];
+    protectedChanges: ProtectedPathMatch[];
+    artifacts: RunArtifact[];
+}
+export declare const parseGitStatusPaths: (stdout: string) => string[];
+export declare const captureGitEvidence: (repoPathInput: string, runId: string) => Promise<GitEvidenceResult>;

package/dist/runtime/gitEvidence.js

@@ -0,0 +1,80 @@
+import { writeRunArtifact } from "./artifacts.js";
+import { runRuntimeCommand } from "./commandRunner.js";
+import { loadConfig } from "./config.js";
+import { newId, nowIso } from "./ids.js";
+import { findProtectedPathMatches } from "./protectedPaths.js";
+import { resolveRepoPath } from "./paths.js";
+import { loadRun, saveRun } from "./store.js";
+const parseStatusPath = (line) => {
+    const payload = line.slice(3).trim();
+    if (!payload)
+        return [];
+    if (payload.includes(" -> ")) {
+        return payload.split(" -> ").map((value) => value.trim()).filter(Boolean);
+    }
+    return [payload.replace(/^"|"$/g, "")];
+};
+export const parseGitStatusPaths = (stdout) => Array.from(new Set(stdout
+    .split("\n")
+    .filter((line) => line.trim().length > 0)
+    .flatMap(parseStatusPath))).sort((left, right) => left.localeCompare(right));
+export const captureGitEvidence = async (repoPathInput, runId) => {
+    const repoPath = resolveRepoPath(repoPathInput);
+    const config = await loadConfig(repoPath);
+    const statusResult = await runRuntimeCommand({
+        repoPath,
+        runId,
+        tool: "git_status",
+        command: "git",
+        args: ["status", "--short", "--untracked-files=all", "--", ".", ":(exclude).thehood"]
+    });
+    const diffResult = await runRuntimeCommand({
+        repoPath,
+        runId,
+        tool: "git_diff",
+        command: "git",
+        args: ["diff", "--no-ext-diff", "--", ".", ":(exclude).thehood"]
+    });
+    const changedPaths = parseGitStatusPaths(statusResult.stdout);
+    const protectedChanges = findProtectedPathMatches(changedPaths, config.defaults.protectedTestPaths);
+    const summaryArtifact = await writeRunArtifact({
+        repoPath,
+        runId,
+        kind: "metadata",
+        name: "git-evidence-summary.json",
+        content: `${JSON.stringify({
+            changedPaths,
+            protectedChanges,
+            statusRef: statusResult.event.stdoutRef,
+            diffRef: diffResult.event.stdoutRef
+        }, null, 2)}\n`,
+        summary: `Git evidence summary for ${changedPaths.length} changed path(s).`
+    });
+    const run = await loadRun(repoPath, runId);
+    const updated = {
+        ...run,
+        updatedAt: nowIso(),
+        artifacts: [...run.artifacts, summaryArtifact],
+        events: [
+            ...run.events,
+            {
+                id: newId("event"),
+                createdAt: nowIso(),
+                type: "git_evidence_captured",
+                message: `Captured git evidence for ${changedPaths.length} changed path(s).`,
+                data: {
+                    changedPathCount: changedPaths.length,
+                    protectedChangeCount: protectedChanges.length
+                }
+            }
+        ]
+    };
+    await saveRun(updated);
+    return {
+        run: updated,
+        changedPaths,
+        protectedChanges,
+        artifacts: [summaryArtifact]
+    };
+};
+//# sourceMappingURL=gitEvidence.js.map

package/dist/runtime/gitEvidence.js.map

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

package/dist/runtime/handoffs.d.ts

@@ -0,0 +1,32 @@
+import type { RunHandoffEvent, RunHandoffKind, RunRecord, RunState, RuntimeRole } from "./types.js";
+export interface CreateRunHandoffInput {
+    kind: RunHandoffKind;
+    reason: string;
+    stateAfter: RunState;
+    fromRole?: RuntimeRole | undefined;
+    toRole?: RuntimeRole | undefined;
+    gate?: string | undefined;
+    approvalEventId?: string | undefined;
+    artifactRefs?: string[] | undefined;
+}
+export interface RunHandoffSummary {
+    id: string;
+    createdAt: string;
+    kind: RunHandoffKind;
+    reason: string;
+    stateBefore: RunState;
+    stateAfter: RunState;
+    fromLabel?: string;
+    fromAssignment?: string;
+    toLabel?: string;
+    toAssignment?: string;
+    gate?: string;
+    artifactRefs?: string[];
+}
+export declare const roleLaneLabel: (role: RuntimeRole) => string;
+export declare const createRunHandoff: (run: RunRecord, input: CreateRunHandoffInput) => RunHandoffEvent;
+export declare const appendRunHandoffs: (run: RunRecord, handoffs: RunHandoffEvent[]) => RunRecord;
+export declare const latestRunHandoff: (run: RunRecord) => RunHandoffEvent | undefined;
+export declare const recentRunHandoffs: (run: RunRecord, limit: number) => RunHandoffEvent[];
+export declare const summarizeRunHandoff: (handoff: RunHandoffEvent) => RunHandoffSummary;
+export declare const recentRunHandoffSummaries: (run: RunRecord, limit: number) => RunHandoffSummary[];