martin-loop 0.1.5 → 1.3.0

package/dist/vendor/core/workflow-artifacts.d.ts

@@ -0,0 +1,99 @@
+import { type LoopLifecycleState, type LoopRecord, type MachineState } from "../contracts/index.js";
+import { type SignedAgentReceipt } from "./agent/receipts.js";
+import { type AttestationVerificationResult } from "./attestation/sign.js";
+import { type ContextUtilityScoreArtifact } from "./context-utility.js";
+export interface WorkflowArtifactPaths {
+    runRoot: string;
+    contractPath: string;
+    statePath: string;
+    loopRecordPath: string;
+    loopRecordSignaturePath: string;
+    loopRecordPublicKeyPath: string;
+    ledgerPath: string;
+    artifactsRoot: string;
+    contextUtilityScorePath: string;
+    workflowReceiptPath: string;
+    workflowHandoffJsonPath: string;
+    workflowHandoffMarkdownPath: string;
+}
+export interface WorkflowHandoffSourceDigest {
+    path: string;
+    kind: "contract" | "state" | "ledger" | "artifact";
+    sha256: string;
+}
+export interface WorkflowHandoffCompaction {
+    schemaVersion: "martin.workflow.handoff.compaction.v1";
+    sourceManifestDigest: string;
+    sources: WorkflowHandoffSourceDigest[];
+    state: {
+        phase?: MachineState["phase"];
+        currentAttempt?: number;
+        activeModel?: string;
+        lastFailureSurface?: string;
+        openAlerts: string[];
+    };
+    verification: {
+        status: "verified" | "unverified";
+        summary: string;
+        attemptIndex?: number;
+    };
+    verificationPlan?: WorkflowVerificationPlanSummary;
+    contextUtility?: ContextUtilityScoreArtifact;
+    touchedSurfaces: string[];
+    blockers: string[];
+    nextPrompt: string;
+}
+export interface WorkflowVerificationPlanSummary {
+    tier?: string;
+    mustPassAll: boolean;
+    requiredChecks: string[];
+    optionalChecks: string[];
+    requiredVerifiers: string[];
+    summary: string;
+}
+export interface WorkflowHandoffArtifact {
+    schemaVersion: "martin.workflow.handoff.v1";
+    loopId: string;
+    workspaceId: string;
+    projectId: string;
+    status: LoopRecord["status"];
+    lifecycleState: LoopLifecycleState;
+    objective: string;
+    verificationPlan: string[];
+    attemptCount: number;
+    actualUsd: number;
+    reportedTotalUsd: number;
+    ledgerHash: string;
+    verificationStatus: "passed" | "blocked";
+    nextAction: string;
+    runRoot: string;
+    loopRecordPath: string;
+    workflowReceiptPath: string;
+    ledgerPath: string;
+    compaction: WorkflowHandoffCompaction;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface PersistedWorkflowArtifacts {
+    paths: WorkflowArtifactPaths;
+    ledgerHash: string;
+    receipt: SignedAgentReceipt;
+    handoff: WorkflowHandoffArtifact;
+}
+export interface WorkflowHandoffVerificationResult {
+    ok: boolean;
+    reason?: string;
+    changedSources: string[];
+    attestation?: AttestationVerificationResult;
+}
+export declare function resolveWorkflowArtifactPaths(runsRoot: string, loopId: string): WorkflowArtifactPaths;
+export declare function persistWorkflowArtifacts(input: {
+    loop: LoopRecord;
+    runsRoot: string;
+    martinHome: string;
+}): Promise<PersistedWorkflowArtifacts>;
+export declare function buildWorkflowHandoffArtifact(loop: LoopRecord, paths: WorkflowArtifactPaths, ledgerHash: string, compaction: WorkflowHandoffCompaction): WorkflowHandoffArtifact;
+export declare function renderWorkflowHandoffMarkdown(handoff: WorkflowHandoffArtifact): string;
+export declare function computeLedgerHash(ledgerPath: string): Promise<string>;
+export declare function compactWorkflowHandoffSources(paths: WorkflowArtifactPaths): Promise<WorkflowHandoffCompaction>;
+export declare function verifyWorkflowHandoffForResume(runRoot: string): Promise<WorkflowHandoffVerificationResult>;