rivet-design 0.12.1 → 0.12.3

package/dist/mcp/agent-variants/contracts.d.ts

@@ -8866,97 +8866,555 @@ export type ReportVariantBriefsInput = {
     briefs: Brief[];
     bindings?: VariantContextBinding[];
 };
-export declare const approveVariantBriefsInput: {
+export declare const commitVariantInput: {
     sessionId: z.ZodString;
-    briefIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    variantId: z.ZodString;
     confirmedByUser: z.ZodOptional<z.ZodBoolean>;
     bypassRequestedByUser: z.ZodOptional<z.ZodBoolean>;
     bypassReason: z.ZodOptional<z.ZodString>;
-    selections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+};
+export type CommitVariantInput = {
+    sessionId: string;
+    variantId: string;
+    confirmedByUser?: boolean;
+    bypassRequestedByUser?: boolean;
+    bypassReason?: string;
+};
+export type CommitVariantOutput = {
+    stage: Stage;
+    enqueued: boolean;
+    duplicate: boolean;
+    changedFilesCount: number;
+    payloadKind?: 'diff' | 'diff-applied' | 'project-created';
+    destinationPath?: string;
+} | {
+    stage: 'failed';
+    errorCode: ErrorCode;
+    message: string;
+};
+export declare const continueVariantsAction: z.ZodOptional<z.ZodEnum<["check", "wait", "request_work", "refine_variant"]>>;
+export declare const continueVariantsInput: {
+    sessionId: z.ZodString;
+    clientRequestId: z.ZodOptional<z.ZodString>;
+    action: z.ZodOptional<z.ZodEnum<["check", "wait", "request_work", "refine_variant"]>>;
+    requestedLeaseCount: z.ZodOptional<z.ZodNumber>;
+    workItemIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    variantId: z.ZodOptional<z.ZodString>;
+    instruction: z.ZodOptional<z.ZodString>;
+};
+export type ContinueVariantsInput = {
+    sessionId: string;
+    clientRequestId?: string;
+    action?: 'check' | 'wait' | 'request_work' | 'refine_variant';
+    requestedLeaseCount?: number;
+    workItemIds?: string[];
+    variantId?: string;
+    instruction?: string;
+};
+export declare const reportVariantCompleteStatus: z.ZodEnum<["running", "succeeded", "failed", "cancelled"]>;
+export declare const reportVariantCompleteInput: {
+    sessionId: z.ZodString;
+    workItemId: z.ZodString;
+    leaseId: z.ZodString;
+    attempt: z.ZodNumber;
+    status: z.ZodEnum<["running", "succeeded", "failed", "cancelled"]>;
+    output: z.ZodOptional<z.ZodUnknown>;
+    error: z.ZodOptional<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+    }, {
+        code: string;
+        message: string;
+    }>>;
+    terminalChunk: z.ZodOptional<z.ZodString>;
+    tokensIn: z.ZodOptional<z.ZodNumber>;
+    tokensOut: z.ZodOptional<z.ZodNumber>;
+    model: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+};
+export type ReportVariantCompleteInput = {
+    sessionId: string;
+    workItemId: string;
+    leaseId: string;
+    attempt: number;
+    status: 'running' | 'succeeded' | 'failed' | 'cancelled';
+    output?: unknown;
+    error?: {
+        code: string;
+        message: string;
+    };
+    terminalChunk?: string;
+    tokensIn?: number;
+    tokensOut?: number;
+    model?: string;
+    title?: string;
+    description?: string;
+};
+/**
+ * Unified hand-back tool that replaces `report_variant_briefs`,
+ * `report_source_plan`, and `report_variant_complete`. The three share the
+ * lease header (sessionId/workItemId/attempt/leaseId) and differ only by
+ * payload, so they collapse behind a `kind` discriminator — the same pattern
+ * `continue_variants(action=...)` uses. Because `mcp.tool()` takes a flat
+ * ZodRawShape (not a top-level discriminated union), all payload fields are
+ * optional here and the handler validates the per-kind requirements at runtime
+ * (e.g. `kind:'status'` requires `leaseId` + `status`).
+ */
+export declare const reportWorkItemInput: {
+    kind: z.ZodEnum<["brief", "source_plan", "status"]>;
+    sessionId: z.ZodString;
+    workItemId: z.ZodString;
+    attempt: z.ZodNumber;
+    leaseId: z.ZodOptional<z.ZodString>;
+    briefs: z.ZodOptional<z.ZodArray<z.ZodObject<{
         briefId: z.ZodString;
-        bodyOverride: z.ZodOptional<z.ZodString>;
+        label: z.ZodString;
+        body: z.ZodString;
+        /**
+         * Optional per-brief visual reference URL. Uses the same synchronous
+         * network-target guard as inspiration URLs before downstream agents fetch it.
+         */
+        visualReferenceUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        briefId: string;
+        body: string;
+        visualReferenceUrl?: string | undefined;
+    }, {
+        label: string;
+        briefId: string;
+        body: string;
+        visualReferenceUrl?: string | undefined;
+    }>, "many">>;
+    bindings: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+        kind: z.ZodLiteral<"global">;
+        sourceIds: z.ZodArray<z.ZodString, "many">;
+        actionIds: z.ZodArray<z.ZodString, "many">;
+        metadataIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "global";
+        sourceIds: string[];
+        actionIds: string[];
+        metadataIds?: string[] | undefined;
+    }, {
+        kind: "global";
+        sourceIds: string[];
+        actionIds: string[];
+        metadataIds?: string[] | undefined;
+    }>, z.ZodObject<{
+        kind: z.ZodLiteral<"slot">;
+        slotIndex: z.ZodNumber;
+        sourceIds: z.ZodArray<z.ZodString, "many">;
+        actionIds: z.ZodArray<z.ZodString, "many">;
+        metadataIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "slot";
+        sourceIds: string[];
+        actionIds: string[];
+        slotIndex: number;
+        metadataIds?: string[] | undefined;
+    }, {
+        kind: "slot";
+        sourceIds: string[];
+        actionIds: string[];
+        slotIndex: number;
+        metadataIds?: string[] | undefined;
+    }>]>, "many">>;
+    sourcePlan: z.ZodOptional<z.ZodObject<{
+        actions: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<["extract_design_system", "describe_motion"]>;
+            sourceIds: z.ZodArray<z.ZodString, "many">;
+            reason: z.ZodString;
+            outputMetadataIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            reason: string;
+            kind: "extract_design_system" | "describe_motion";
+            id: string;
+            sourceIds: string[];
+            outputMetadataIds?: string[] | undefined;
+        }, {
+            reason: string;
+            kind: "extract_design_system" | "describe_motion";
+            id: string;
+            sourceIds: string[];
+            outputMetadataIds?: string[] | undefined;
+        }>, "many">;
+        metadata: z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            id: z.ZodString;
+            sourceIds: z.ZodArray<z.ZodString, "many">;
+            actionId: z.ZodOptional<z.ZodString>;
+            producedBy: z.ZodEnum<["rivet", "agent", "browser", "skill"]>;
+            path: z.ZodOptional<z.ZodString>;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        } & {
+            kind: z.ZodLiteral<"design_system">;
+            data: z.ZodObject<{
+                designMarkdown: z.ZodOptional<z.ZodString>;
+                /**
+                 * Provenance for the design system: `captured` = derived from rendered
+                 * browser evidence (e.g. `capture_design_evidence`); `partial` = some
+                 * evidence, gaps filled by inference; `inferred` = no rendered evidence
+                 * (static fetch / native inspection only). Keeps DESIGN.md honest about
+                 * extracted-vs-guessed values.
+                 */
+                evidenceStatus: z.ZodOptional<z.ZodEnum<["captured", "partial", "inferred"]>>;
+                sourceFindings: z.ZodArray<z.ZodString, "many">;
+                sectionInventory: z.ZodArray<z.ZodString, "many">;
+                visualObservations: z.ZodArray<z.ZodString, "many">;
+                sourceRoles: z.ZodArray<z.ZodObject<{
+                    sourceId: z.ZodString;
+                    role: z.ZodEnum<["primary", "inspiration", "competitor"]>;
+                    rationale: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    sourceId: string;
+                    role: "primary" | "inspiration" | "competitor";
+                    rationale?: string | undefined;
+                }, {
+                    sourceId: string;
+                    role: "primary" | "inspiration" | "competitor";
+                    rationale?: string | undefined;
+                }>, "many">;
+                qualityBar: z.ZodArray<z.ZodString, "many">;
+                risks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                sourceFindings: string[];
+                sectionInventory: string[];
+                visualObservations: string[];
+                sourceRoles: {
+                    sourceId: string;
+                    role: "primary" | "inspiration" | "competitor";
+                    rationale?: string | undefined;
+                }[];
+                qualityBar: string[];
+                designMarkdown?: string | undefined;
+                evidenceStatus?: "captured" | "partial" | "inferred" | undefined;
+                risks?: string[] | undefined;
+            }, {
+                sourceFindings: string[];
+                sectionInventory: string[];
+                visualObservations: string[];
+                sourceRoles: {
+                    sourceId: string;
+                    role: "primary" | "inspiration" | "competitor";
+                    rationale?: string | undefined;
+                }[];
+                qualityBar: string[];
+                designMarkdown?: string | undefined;
+                evidenceStatus?: "captured" | "partial" | "inferred" | undefined;
+                risks?: string[] | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "design_system";
+            id: string;
+            data: {
+                sourceFindings: string[];
+                sectionInventory: string[];
+                visualObservations: string[];
+                sourceRoles: {
+                    sourceId: string;
+                    role: "primary" | "inspiration" | "competitor";
+                    rationale?: string | undefined;
+                }[];
+                qualityBar: string[];
+                designMarkdown?: string | undefined;
+                evidenceStatus?: "captured" | "partial" | "inferred" | undefined;
+                risks?: string[] | undefined;
+            };
+            sourceIds: string[];
+            producedBy: "rivet" | "agent" | "browser" | "skill";
+            path?: string | undefined;
+            actionId?: string | undefined;
+            warnings?: string[] | undefined;
+        }, {
+            kind: "design_system";
+            id: string;
+            data: {
+                sourceFindings: string[];
+                sectionInventory: string[];
+                visualObservations: string[];
+                sourceRoles: {
+                    sourceId: string;
+                    role: "primary" | "inspiration" | "competitor";
+                    rationale?: string | undefined;
+                }[];
+                qualityBar: string[];
+                designMarkdown?: string | undefined;
+                evidenceStatus?: "captured" | "partial" | "inferred" | undefined;
+                risks?: string[] | undefined;
+            };
+            sourceIds: string[];
+            producedBy: "rivet" | "agent" | "browser" | "skill";
+            path?: string | undefined;
+            actionId?: string | undefined;
+            warnings?: string[] | undefined;
+        }>, z.ZodObject<{
+            id: z.ZodString;
+            sourceIds: z.ZodArray<z.ZodString, "many">;
+            actionId: z.ZodOptional<z.ZodString>;
+            producedBy: z.ZodEnum<["rivet", "agent", "browser", "skill"]>;
+            path: z.ZodOptional<z.ZodString>;
+            warnings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        } & {
+            kind: z.ZodLiteral<"motion_guidance">;
+            data: z.ZodObject<{
+                motionMarkdown: z.ZodOptional<z.ZodString>;
+                notes: z.ZodArray<z.ZodString, "many">;
+                timings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                notes: string[];
+                motionMarkdown?: string | undefined;
+                timings?: string[] | undefined;
+            }, {
+                notes: string[];
+                motionMarkdown?: string | undefined;
+                timings?: string[] | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "motion_guidance";
+            id: string;
+            data: {
+                notes: string[];
+                motionMarkdown?: string | undefined;
+                timings?: string[] | undefined;
+            };
+            sourceIds: string[];
+            producedBy: "rivet" | "agent" | "browser" | "skill";
+            path?: string | undefined;
+            actionId?: string | undefined;
+            warnings?: string[] | undefined;
+        }, {
+            kind: "motion_guidance";
+            id: string;
+            data: {
+                notes: string[];
+                motionMarkdown?: string | undefined;
+                timings?: string[] | undefined;
+            };
+            sourceIds: string[];
+            producedBy: "rivet" | "agent" | "browser" | "skill";
+            path?: string | undefined;
+            actionId?: string | undefined;
+            warnings?: string[] | undefined;
+        }>]>, "many">;
+        bindings: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"global">;
+            sourceIds: z.ZodArray<z.ZodString, "many">;
+            actionIds: z.ZodArray<z.ZodString, "many">;
+            metadataIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "global";
+            sourceIds: string[];
+            actionIds: string[];
+            metadataIds?: string[] | undefined;
+        }, {
+            kind: "global";
+            sourceIds: string[];
+            actionIds: string[];
+            metadataIds?: string[] | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"slot">;
+            slotIndex: z.ZodNumber;
+            sourceIds: z.ZodArray<z.ZodString, "many">;
+            actionIds: z.ZodArray<z.ZodString, "many">;
+            metadataIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "slot";
+            sourceIds: string[];
+            actionIds: string[];
+            slotIndex: number;
+            metadataIds?: string[] | undefined;
+        }, {
+            kind: "slot";
+            sourceIds: string[];
+            actionIds: string[];
+            slotIndex: number;
+            metadataIds?: string[] | undefined;
+        }>]>, "many">>;
+        executionPlan: z.ZodObject<{
+            mode: z.ZodEnum<["static_preview", "vite_app"]>;
+            confidence: z.ZodEnum<["low", "medium", "high"]>;
+            reason: z.ZodString;
+            assetPlan: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                source: z.ZodString;
+                destination: z.ZodString;
+                referenceAs: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                destination: string;
+                source: string;
+                referenceAs: string;
+            }, {
+                destination: string;
+                source: string;
+                referenceAs: string;
+            }>, "many">>;
+            runtimeRequirements: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            userQuestion: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "static_preview" | "vite_app";
+            reason: string;
+            confidence: "low" | "medium" | "high";
+            assetPlan?: {
+                destination: string;
+                source: string;
+                referenceAs: string;
+            }[] | undefined;
+            runtimeRequirements?: string[] | undefined;
+            userQuestion?: string | undefined;
+        }, {
+            mode: "static_preview" | "vite_app";
+            reason: string;
+            confidence: "low" | "medium" | "high";
+            assetPlan?: {
+                destination: string;
+                source: string;
+                referenceAs: string;
+            }[] | undefined;
+            runtimeRequirements?: string[] | undefined;
+            userQuestion?: string | undefined;
+        }>;
     }, "strip", z.ZodTypeAny, {
-        briefId: string;
-        bodyOverride?: string | undefined;
+        executionPlan: {
+            mode: "static_preview" | "vite_app";
+            reason: string;
+            confidence: "low" | "medium" | "high";
+            assetPlan?: {
+                destination: string;
+                source: string;
+                referenceAs: string;
+            }[] | undefined;
+            runtimeRequirements?: string[] | undefined;
+            userQuestion?: string | undefined;
+        };
+        actions: {
+            reason: string;
+            kind: "extract_design_system" | "describe_motion";
+            id: string;
+            sourceIds: string[];
+            outputMetadataIds?: string[] | undefined;
+        }[];
+        metadata: ({
+            kind: "design_system";
+            id: string;
+            data: {
+                sourceFindings: string[];
+                sectionInventory: string[];
+                visualObservations: string[];
+                sourceRoles: {
+                    sourceId: string;
+                    role: "primary" | "inspiration" | "competitor";
+                    rationale?: string | undefined;
+                }[];
+                qualityBar: string[];
+                designMarkdown?: string | undefined;
+                evidenceStatus?: "captured" | "partial" | "inferred" | undefined;
+                risks?: string[] | undefined;
+            };
+            sourceIds: string[];
+            producedBy: "rivet" | "agent" | "browser" | "skill";
+            path?: string | undefined;
+            actionId?: string | undefined;
+            warnings?: string[] | undefined;
+        } | {
+            kind: "motion_guidance";
+            id: string;
+            data: {
+                notes: string[];
+                motionMarkdown?: string | undefined;
+                timings?: string[] | undefined;
+            };
+            sourceIds: string[];
+            producedBy: "rivet" | "agent" | "browser" | "skill";
+            path?: string | undefined;
+            actionId?: string | undefined;
+            warnings?: string[] | undefined;
+        })[];
+        bindings?: ({
+            kind: "global";
+            sourceIds: string[];
+            actionIds: string[];
+            metadataIds?: string[] | undefined;
+        } | {
+            kind: "slot";
+            sourceIds: string[];
+            actionIds: string[];
+            slotIndex: number;
+            metadataIds?: string[] | undefined;
+        })[] | undefined;
     }, {
-        briefId: string;
-        bodyOverride?: string | undefined;
-    }>, "many">>;
-};
-export type ApproveVariantBriefsInput = {
-    sessionId: string;
-    briefIds?: string[];
-    confirmedByUser?: boolean;
-    bypassRequestedByUser?: boolean;
-    bypassReason?: string;
-    selections?: Array<{
-        briefId: string;
-        bodyOverride?: string;
-    }>;
-};
-export type ApproveVariantBriefsOutput = {
-    stage: 'work_items_ready';
-    approvedCount: number;
-    codeGenWorkItemIds: string[];
-    scaffoldBaseWorkItemId: string | null;
-    nextAction: 'continue_variants';
-} | {
-    stage: 'failed';
-    errorCode: ErrorCode;
-    message: string;
-};
-export declare const commitVariantInput: {
-    sessionId: z.ZodString;
-    variantId: z.ZodString;
-    confirmedByUser: z.ZodOptional<z.ZodBoolean>;
-    bypassRequestedByUser: z.ZodOptional<z.ZodBoolean>;
-    bypassReason: z.ZodOptional<z.ZodString>;
-};
-export type CommitVariantInput = {
-    sessionId: string;
-    variantId: string;
-    confirmedByUser?: boolean;
-    bypassRequestedByUser?: boolean;
-    bypassReason?: string;
-};
-export type CommitVariantOutput = {
-    stage: Stage;
-    enqueued: boolean;
-    duplicate: boolean;
-    changedFilesCount: number;
-    payloadKind?: 'diff' | 'diff-applied' | 'project-created';
-    destinationPath?: string;
-} | {
-    stage: 'failed';
-    errorCode: ErrorCode;
-    message: string;
-};
-export declare const continueVariantsAction: z.ZodOptional<z.ZodEnum<["check", "wait", "request_work", "refine_variant"]>>;
-export declare const continueVariantsInput: {
-    sessionId: z.ZodString;
-    clientRequestId: z.ZodOptional<z.ZodString>;
-    action: z.ZodOptional<z.ZodEnum<["check", "wait", "request_work", "refine_variant"]>>;
-    requestedLeaseCount: z.ZodOptional<z.ZodNumber>;
-    workItemIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    variantId: z.ZodOptional<z.ZodString>;
-    instruction: z.ZodOptional<z.ZodString>;
-};
-export type ContinueVariantsInput = {
-    sessionId: string;
-    clientRequestId?: string;
-    action?: 'check' | 'wait' | 'request_work' | 'refine_variant';
-    requestedLeaseCount?: number;
-    workItemIds?: string[];
-    variantId?: string;
-    instruction?: string;
-};
-export declare const reportVariantCompleteStatus: z.ZodEnum<["running", "succeeded", "failed", "cancelled"]>;
-export declare const reportVariantCompleteInput: {
-    sessionId: z.ZodString;
-    workItemId: z.ZodString;
-    leaseId: z.ZodString;
-    attempt: z.ZodNumber;
-    status: z.ZodEnum<["running", "succeeded", "failed", "cancelled"]>;
+        executionPlan: {
+            mode: "static_preview" | "vite_app";
+            reason: string;
+            confidence: "low" | "medium" | "high";
+            assetPlan?: {
+                destination: string;
+                source: string;
+                referenceAs: string;
+            }[] | undefined;
+            runtimeRequirements?: string[] | undefined;
+            userQuestion?: string | undefined;
+        };
+        actions: {
+            reason: string;
+            kind: "extract_design_system" | "describe_motion";
+            id: string;
+            sourceIds: string[];
+            outputMetadataIds?: string[] | undefined;
+        }[];
+        metadata: ({
+            kind: "design_system";
+            id: string;
+            data: {
+                sourceFindings: string[];
+                sectionInventory: string[];
+                visualObservations: string[];
+                sourceRoles: {
+                    sourceId: string;
+                    role: "primary" | "inspiration" | "competitor";
+                    rationale?: string | undefined;
+                }[];
+                qualityBar: string[];
+                designMarkdown?: string | undefined;
+                evidenceStatus?: "captured" | "partial" | "inferred" | undefined;
+                risks?: string[] | undefined;
+            };
+            sourceIds: string[];
+            producedBy: "rivet" | "agent" | "browser" | "skill";
+            path?: string | undefined;
+            actionId?: string | undefined;
+            warnings?: string[] | undefined;
+        } | {
+            kind: "motion_guidance";
+            id: string;
+            data: {
+                notes: string[];
+                motionMarkdown?: string | undefined;
+                timings?: string[] | undefined;
+            };
+            sourceIds: string[];
+            producedBy: "rivet" | "agent" | "browser" | "skill";
+            path?: string | undefined;
+            actionId?: string | undefined;
+            warnings?: string[] | undefined;
+        })[];
+        bindings?: ({
+            kind: "global";
+            sourceIds: string[];
+            actionIds: string[];
+            metadataIds?: string[] | undefined;
+        } | {
+            kind: "slot";
+            sourceIds: string[];
+            actionIds: string[];
+            slotIndex: number;
+            metadataIds?: string[] | undefined;
+        })[] | undefined;
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<["running", "succeeded", "failed", "cancelled"]>>;
     output: z.ZodOptional<z.ZodUnknown>;
     error: z.ZodOptional<z.ZodObject<{
         code: z.ZodString;
@@ -8975,12 +9433,16 @@ export declare const reportVariantCompleteInput: {
     title: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
 };
-export type ReportVariantCompleteInput = {
+export type ReportWorkItemInput = {
+    kind: 'brief' | 'source_plan' | 'status';
     sessionId: string;
     workItemId: string;
-    leaseId: string;
     attempt: number;
-    status: 'running' | 'succeeded' | 'failed' | 'cancelled';
+    leaseId?: string;
+    briefs?: Brief[];
+    bindings?: VariantContextBinding[];
+    sourcePlan?: SourcePlanArtifact;
+    status?: 'running' | 'succeeded' | 'failed' | 'cancelled';
     output?: unknown;
     error?: {
         code: string;
@@ -8995,20 +9457,12 @@ export type ReportVariantCompleteInput = {
 };
 export declare const cancelVariantsInput: {
     sessionId: z.ZodString;
+    variantId: z.ZodOptional<z.ZodString>;
     reason: z.ZodOptional<z.ZodString>;
 };
 export type CancelVariantsInput = {
     sessionId: string;
-    reason?: string;
-};
-export declare const cancelVariantInput: {
-    sessionId: z.ZodString;
-    variantId: z.ZodString;
-    reason: z.ZodOptional<z.ZodString>;
-};
-export type CancelVariantInput = {
-    sessionId: string;
-    variantId: string;
+    variantId?: string;
     reason?: string;
 };
 export type CancelVariantOutput = {
@@ -9285,7 +9739,7 @@ export type StartVariantsOutput = {
      *  time. `> 0` means the agent should keep draining via
      *  watch_for_changes / get_pending_changes. */
     pendingVariantRequests?: number;
-    nextAction: 'report_variant_complete';
+    nextAction: 'report_work_item';
 } | {
     sessionId: string;
     stage: 'awaiting_source_plan';
@@ -9301,7 +9755,7 @@ export type StartVariantsOutput = {
     stage: 'awaiting_briefs';
     mode: 'zero_to_one';
     briefWorkItem: BriefWorkItemDescriptor;
-    nextAction: 'report_variant_briefs';
+    nextAction: 'report_work_item';
     destinationPath?: string;
     visualEditor?: VisualEditorAttachment;
     editorNextAction?: VisualEditorWatchAction;
@@ -9354,7 +9808,7 @@ export type ProposeVariantsOutput = {
     sessionId: string;
     stage: 'awaiting_briefs';
     briefWorkItem: BriefWorkItemDescriptor;
-    nextAction: 'report_variant_briefs';
+    nextAction: 'report_work_item';
     visualEditor?: VisualEditorAttachment;
 } | {
     stage: 'cancelled';
@@ -9384,7 +9838,7 @@ export type ReportSourcePlanOutput = {
         assetCount: number;
         runtimeRequirementCount: number;
     };
-    nextAction: 'report_variant_briefs';
+    nextAction: 'report_work_item';
 } | {
     stage: 'failed';
     errorCode: ErrorCode;
@@ -9508,11 +9962,17 @@ export declare const listPastVariantsInput: {
     projectPath: z.ZodOptional<z.ZodString>;
     limit: z.ZodOptional<z.ZodNumber>;
     status: z.ZodOptional<z.ZodEnum<["completed", "committed", "rejected", "cancelled", "removed"]>>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    variantId: z.ZodOptional<z.ZodString>;
+    includeBody: z.ZodOptional<z.ZodBoolean>;
 };
 export type ListPastVariantsInput = {
     projectPath?: string;
     limit?: number;
     status?: z.infer<typeof variantHistoryStatusSchema>;
+    sessionId?: string;
+    variantId?: string;
+    includeBody?: boolean;
 };
 export type PastVariantArtifact = {
     kind: 'diff';