@agent-finops/core 0.8.0 → 0.9.0

package/dist/projectEconomics.d.ts

@@ -0,0 +1,617 @@
+import { z } from "zod";
+export declare const OWNERSHIP_SUGGESTION_V0_KIND: "aibill.ownership_suggestion";
+export declare const CONFIRMED_OWNERSHIP_V0_KIND: "aibill.confirmed_ownership";
+export declare const APPROVAL_EVENT_V0_KIND: "aibill.approval_event";
+export declare const ACCEPTED_OUTCOME_V0_KIND: "aibill.accepted_outcome";
+export declare const PROJECT_ECONOMICS_RECEIPT_V0_KIND: "aibill.project_economics_receipt";
+export declare const PROJECT_ECONOMICS_V0_VERSION: "0.1.0";
+export declare const MAX_APPROVAL_EVENTS_V0 = 256;
+export declare const MAX_OUTCOME_CHECK_REFS_V0 = 64;
+export declare const MAX_PROJECT_COST_LINES_V0 = 32;
+/** Opaque privacy-reduced reference; the source-native value is never persisted. */
+export declare const projectEconomicsReferenceSchema: z.ZodString;
+export declare const projectEconomicsEvidenceValues: readonly ["verified", "observed", "calculated", "user_declared", "modeled", "missing"];
+export declare const projectEconomicsEvidenceSchema: z.ZodEnum<{
+    verified: "verified";
+    missing: "missing";
+    observed: "observed";
+    calculated: "calculated";
+    user_declared: "user_declared";
+    modeled: "modeled";
+}>;
+export type ProjectEconomicsEvidence = z.infer<typeof projectEconomicsEvidenceSchema>;
+declare const ownershipSuggestionBodySchema: z.ZodObject<{
+    kind: z.ZodLiteral<"aibill.ownership_suggestion">;
+    schemaVersion: z.ZodLiteral<"0.1.0">;
+    status: z.ZodLiteral<"suggested">;
+    generatedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    projectRef: z.ZodString;
+    suggestedHumanRef: z.ZodOptional<z.ZodString>;
+    suggestedTeamRef: z.ZodOptional<z.ZodString>;
+    suggestedClientRef: z.ZodOptional<z.ZodString>;
+    suggestedCostCenterRef: z.ZodOptional<z.ZodString>;
+    source: z.ZodEnum<{
+        git_metadata: "git_metadata";
+        codeowners: "codeowners";
+        repository_metadata: "repository_metadata";
+    }>;
+    evidence: z.ZodLiteral<"observed">;
+    requiresUserConfirmation: z.ZodLiteral<true>;
+}, z.core.$strict>;
+export type OwnershipSuggestionV0DraftInput = z.input<typeof ownershipSuggestionBodySchema>;
+export declare const ownershipSuggestionV0Schema: z.ZodObject<{
+    kind: z.ZodLiteral<"aibill.ownership_suggestion">;
+    schemaVersion: z.ZodLiteral<"0.1.0">;
+    status: z.ZodLiteral<"suggested">;
+    generatedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    projectRef: z.ZodString;
+    suggestedHumanRef: z.ZodOptional<z.ZodString>;
+    suggestedTeamRef: z.ZodOptional<z.ZodString>;
+    suggestedClientRef: z.ZodOptional<z.ZodString>;
+    suggestedCostCenterRef: z.ZodOptional<z.ZodString>;
+    source: z.ZodEnum<{
+        git_metadata: "git_metadata";
+        codeowners: "codeowners";
+        repository_metadata: "repository_metadata";
+    }>;
+    evidence: z.ZodLiteral<"observed">;
+    requiresUserConfirmation: z.ZodLiteral<true>;
+    id: z.ZodString;
+}, z.core.$strict>;
+export type OwnershipSuggestionV0 = z.infer<typeof ownershipSuggestionV0Schema>;
+declare const confirmedOwnershipBodySchema: z.ZodObject<{
+    kind: z.ZodLiteral<"aibill.confirmed_ownership">;
+    schemaVersion: z.ZodLiteral<"0.1.0">;
+    status: z.ZodLiteral<"confirmed">;
+    projectRef: z.ZodString;
+    humanOwnerRef: z.ZodString;
+    teamRef: z.ZodString;
+    clientRef: z.ZodOptional<z.ZodString>;
+    costCenterRef: z.ZodOptional<z.ZodString>;
+    confirmation: z.ZodObject<{
+        evidence: z.ZodLiteral<"user_declared">;
+        confirmedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        confirmedByRef: z.ZodString;
+        locallyStored: z.ZodLiteral<true>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ConfirmedOwnershipV0DraftInput = z.input<typeof confirmedOwnershipBodySchema>;
+export declare const confirmedOwnershipV0Schema: z.ZodObject<{
+    kind: z.ZodLiteral<"aibill.confirmed_ownership">;
+    schemaVersion: z.ZodLiteral<"0.1.0">;
+    status: z.ZodLiteral<"confirmed">;
+    projectRef: z.ZodString;
+    humanOwnerRef: z.ZodString;
+    teamRef: z.ZodString;
+    clientRef: z.ZodOptional<z.ZodString>;
+    costCenterRef: z.ZodOptional<z.ZodString>;
+    confirmation: z.ZodObject<{
+        evidence: z.ZodLiteral<"user_declared">;
+        confirmedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        confirmedByRef: z.ZodString;
+        locallyStored: z.ZodLiteral<true>;
+    }, z.core.$strict>;
+    id: z.ZodString;
+}, z.core.$strict>;
+export type ConfirmedOwnershipV0 = z.infer<typeof confirmedOwnershipV0Schema>;
+declare const approvalEventBodySchema: z.ZodObject<{
+    kind: z.ZodLiteral<"aibill.approval_event">;
+    schemaVersion: z.ZodLiteral<"0.1.0">;
+    sequence: z.ZodNumber;
+    previousEventId: z.ZodNullable<z.ZodString>;
+    approvedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    decision: z.ZodLiteral<"approved">;
+    attestation: z.ZodObject<{
+        scope: z.ZodLiteral<"local_self_attested">;
+        evidence: z.ZodLiteral<"user_declared">;
+        approverIdentityRef: z.ZodString;
+        approverRoleRef: z.ZodString;
+        rbacVerified: z.ZodLiteral<false>;
+    }, z.core.$strict>;
+    references: z.ZodObject<{
+        actionRef: z.ZodString;
+        changeRef: z.ZodString;
+        rollbackRef: z.ZodString;
+        canaryRef: z.ZodString;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ApprovalEventV0DraftInput = z.input<typeof approvalEventBodySchema>;
+export declare const approvalEventV0Schema: z.ZodObject<{
+    kind: z.ZodLiteral<"aibill.approval_event">;
+    schemaVersion: z.ZodLiteral<"0.1.0">;
+    sequence: z.ZodNumber;
+    previousEventId: z.ZodNullable<z.ZodString>;
+    approvedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    decision: z.ZodLiteral<"approved">;
+    attestation: z.ZodObject<{
+        scope: z.ZodLiteral<"local_self_attested">;
+        evidence: z.ZodLiteral<"user_declared">;
+        approverIdentityRef: z.ZodString;
+        approverRoleRef: z.ZodString;
+        rbacVerified: z.ZodLiteral<false>;
+    }, z.core.$strict>;
+    references: z.ZodObject<{
+        actionRef: z.ZodString;
+        changeRef: z.ZodString;
+        rollbackRef: z.ZodString;
+        canaryRef: z.ZodString;
+    }, z.core.$strict>;
+    id: z.ZodString;
+}, z.core.$strict>;
+export type ApprovalEventV0 = z.infer<typeof approvalEventV0Schema>;
+declare const acceptedOutcomeBodySchema: z.ZodObject<{
+    kind: z.ZodLiteral<"aibill.accepted_outcome">;
+    schemaVersion: z.ZodLiteral<"0.1.0">;
+    platform: z.ZodLiteral<"github">;
+    outcomeType: z.ZodEnum<{
+        task: "task";
+        pull_request: "pull_request";
+    }>;
+    repositoryRef: z.ZodString;
+    workUnitRef: z.ZodString;
+    state: z.ZodEnum<{
+        merged: "merged";
+        accepted: "accepted";
+    }>;
+    stateEvidence: z.ZodEnum<{
+        verified: "verified";
+        observed: "observed";
+        user_declared: "user_declared";
+    }>;
+    acceptedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    commit: z.ZodObject<{
+        commitRef: z.ZodString;
+        evidence: z.ZodEnum<{
+            verified: "verified";
+            observed: "observed";
+        }>;
+    }, z.core.$strict>;
+    checks: z.ZodObject<{
+        status: z.ZodLiteral<"passed">;
+        evidence: z.ZodEnum<{
+            verified: "verified";
+            observed: "observed";
+        }>;
+        evidenceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    businessDescription: z.ZodOptional<z.ZodObject<{
+        value: z.ZodString;
+        evidence: z.ZodLiteral<"user_declared">;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type AcceptedOutcomeV0DraftInput = z.input<typeof acceptedOutcomeBodySchema>;
+export declare const acceptedOutcomeV0Schema: z.ZodObject<{
+    kind: z.ZodLiteral<"aibill.accepted_outcome">;
+    schemaVersion: z.ZodLiteral<"0.1.0">;
+    platform: z.ZodLiteral<"github">;
+    outcomeType: z.ZodEnum<{
+        task: "task";
+        pull_request: "pull_request";
+    }>;
+    repositoryRef: z.ZodString;
+    workUnitRef: z.ZodString;
+    state: z.ZodEnum<{
+        merged: "merged";
+        accepted: "accepted";
+    }>;
+    stateEvidence: z.ZodEnum<{
+        verified: "verified";
+        observed: "observed";
+        user_declared: "user_declared";
+    }>;
+    acceptedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    commit: z.ZodObject<{
+        commitRef: z.ZodString;
+        evidence: z.ZodEnum<{
+            verified: "verified";
+            observed: "observed";
+        }>;
+    }, z.core.$strict>;
+    checks: z.ZodObject<{
+        status: z.ZodLiteral<"passed">;
+        evidence: z.ZodEnum<{
+            verified: "verified";
+            observed: "observed";
+        }>;
+        evidenceRefs: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+    businessDescription: z.ZodOptional<z.ZodObject<{
+        value: z.ZodString;
+        evidence: z.ZodLiteral<"user_declared">;
+    }, z.core.$strict>>;
+    id: z.ZodString;
+}, z.core.$strict>;
+export type AcceptedOutcomeV0 = z.infer<typeof acceptedOutcomeV0Schema>;
+export declare const projectCostBasisValues: readonly ["provider_billed", "subscription_included", "api_equivalent_estimate", "user_declared", "missing"];
+export declare const projectCostBasisSchema: z.ZodEnum<{
+    missing: "missing";
+    user_declared: "user_declared";
+    provider_billed: "provider_billed";
+    subscription_included: "subscription_included";
+    api_equivalent_estimate: "api_equivalent_estimate";
+}>;
+export type ProjectCostBasis = z.infer<typeof projectCostBasisSchema>;
+declare const projectEconomicsReceiptBodySchema: z.ZodObject<{
+    kind: z.ZodLiteral<"aibill.project_economics_receipt">;
+    schemaVersion: z.ZodLiteral<"0.1.0">;
+    generatedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    scope: z.ZodObject<{
+        projectRef: z.ZodString;
+        workUnitRef: z.ZodString;
+    }, z.core.$strict>;
+    ownership: z.ZodObject<{
+        kind: z.ZodLiteral<"aibill.confirmed_ownership">;
+        schemaVersion: z.ZodLiteral<"0.1.0">;
+        status: z.ZodLiteral<"confirmed">;
+        projectRef: z.ZodString;
+        humanOwnerRef: z.ZodString;
+        teamRef: z.ZodString;
+        clientRef: z.ZodOptional<z.ZodString>;
+        costCenterRef: z.ZodOptional<z.ZodString>;
+        confirmation: z.ZodObject<{
+            evidence: z.ZodLiteral<"user_declared">;
+            confirmedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+            confirmedByRef: z.ZodString;
+            locallyStored: z.ZodLiteral<true>;
+        }, z.core.$strict>;
+        id: z.ZodString;
+    }, z.core.$strict>;
+    costs: z.ZodObject<{
+        lines: z.ZodArray<z.ZodObject<{
+            sourceRef: z.ZodString;
+            basis: z.ZodEnum<{
+                missing: "missing";
+                user_declared: "user_declared";
+                provider_billed: "provider_billed";
+                subscription_included: "subscription_included";
+                api_equivalent_estimate: "api_equivalent_estimate";
+            }>;
+            amountUsd: z.ZodNullable<z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>>;
+            evidence: z.ZodEnum<{
+                verified: "verified";
+                missing: "missing";
+                observed: "observed";
+                calculated: "calculated";
+                user_declared: "user_declared";
+                modeled: "modeled";
+            }>;
+        }, z.core.$strict>>;
+        coverage: z.ZodObject<{
+            status: z.ZodEnum<{
+                missing: "missing";
+                complete: "complete";
+                partial: "partial";
+            }>;
+            coveredRecords: z.ZodNumber;
+            eligibleRecords: z.ZodNumber;
+            evidence: z.ZodEnum<{
+                verified: "verified";
+                missing: "missing";
+                observed: "observed";
+                calculated: "calculated";
+            }>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    action: z.ZodObject<{
+        wasteFindingRef: z.ZodString;
+        tokenExperimentRef: z.ZodString;
+        tokenExperimentRevisionRef: z.ZodString;
+        approvalEvent: z.ZodObject<{
+            kind: z.ZodLiteral<"aibill.approval_event">;
+            schemaVersion: z.ZodLiteral<"0.1.0">;
+            sequence: z.ZodNumber;
+            previousEventId: z.ZodNullable<z.ZodString>;
+            approvedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+            decision: z.ZodLiteral<"approved">;
+            attestation: z.ZodObject<{
+                scope: z.ZodLiteral<"local_self_attested">;
+                evidence: z.ZodLiteral<"user_declared">;
+                approverIdentityRef: z.ZodString;
+                approverRoleRef: z.ZodString;
+                rbacVerified: z.ZodLiteral<false>;
+            }, z.core.$strict>;
+            references: z.ZodObject<{
+                actionRef: z.ZodString;
+                changeRef: z.ZodString;
+                rollbackRef: z.ZodString;
+                canaryRef: z.ZodString;
+            }, z.core.$strict>;
+            id: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    outcome: z.ZodObject<{
+        kind: z.ZodLiteral<"aibill.accepted_outcome">;
+        schemaVersion: z.ZodLiteral<"0.1.0">;
+        platform: z.ZodLiteral<"github">;
+        outcomeType: z.ZodEnum<{
+            task: "task";
+            pull_request: "pull_request";
+        }>;
+        repositoryRef: z.ZodString;
+        workUnitRef: z.ZodString;
+        state: z.ZodEnum<{
+            merged: "merged";
+            accepted: "accepted";
+        }>;
+        stateEvidence: z.ZodEnum<{
+            verified: "verified";
+            observed: "observed";
+            user_declared: "user_declared";
+        }>;
+        acceptedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        commit: z.ZodObject<{
+            commitRef: z.ZodString;
+            evidence: z.ZodEnum<{
+                verified: "verified";
+                observed: "observed";
+            }>;
+        }, z.core.$strict>;
+        checks: z.ZodObject<{
+            status: z.ZodLiteral<"passed">;
+            evidence: z.ZodEnum<{
+                verified: "verified";
+                observed: "observed";
+            }>;
+            evidenceRefs: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        businessDescription: z.ZodOptional<z.ZodObject<{
+            value: z.ZodString;
+            evidence: z.ZodLiteral<"user_declared">;
+        }, z.core.$strict>>;
+        id: z.ZodString;
+    }, z.core.$strict>;
+    measuredTokenResult: z.ZodObject<{
+        status: z.ZodEnum<{
+            measured_token_reduction: "measured_token_reduction";
+            no_measured_change: "no_measured_change";
+            regressed: "regressed";
+            inconclusive: "inconclusive";
+        }>;
+        baselineMedianTokens: z.ZodNullable<z.ZodNumber>;
+        postChangeMedianTokens: z.ZodNullable<z.ZodNumber>;
+        baselineSessions: z.ZodNumber;
+        postChangeSessions: z.ZodNumber;
+        reductionPercent: z.ZodNullable<z.ZodNumber>;
+        metricEvidence: z.ZodEnum<{
+            missing: "missing";
+            calculated: "calculated";
+        }>;
+        matchingEvidence: z.ZodEnum<{
+            verified: "verified";
+            missing: "missing";
+            observed: "observed";
+            user_declared: "user_declared";
+        }>;
+        qualityStatus: z.ZodEnum<{
+            regressed: "regressed";
+            held: "held";
+            insufficient: "insufficient";
+        }>;
+        qualityEvidence: z.ZodEnum<{
+            verified: "verified";
+            missing: "missing";
+            observed: "observed";
+            user_declared: "user_declared";
+        }>;
+    }, z.core.$strict>;
+    billReconciliation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"not_attempted">;
+        evidence: z.ZodLiteral<"missing">;
+    }, z.core.$strict>, z.ZodObject<{
+        status: z.ZodLiteral<"partial">;
+        evidence: z.ZodLiteral<"verified">;
+        providerBillRef: z.ZodString;
+        coveragePercent: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        matchedAmountUsd: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        varianceUsd: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>], "status">;
+    claims: z.ZodObject<{
+        roi: z.ZodLiteral<"not_claimed">;
+        invoiceReconciled: z.ZodLiteral<false>;
+        rbacVerified: z.ZodLiteral<false>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ProjectEconomicsReceiptV0DraftInput = z.input<typeof projectEconomicsReceiptBodySchema>;
+export declare const projectEconomicsReceiptV0Schema: z.ZodObject<{
+    kind: z.ZodLiteral<"aibill.project_economics_receipt">;
+    schemaVersion: z.ZodLiteral<"0.1.0">;
+    generatedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    scope: z.ZodObject<{
+        projectRef: z.ZodString;
+        workUnitRef: z.ZodString;
+    }, z.core.$strict>;
+    ownership: z.ZodObject<{
+        kind: z.ZodLiteral<"aibill.confirmed_ownership">;
+        schemaVersion: z.ZodLiteral<"0.1.0">;
+        status: z.ZodLiteral<"confirmed">;
+        projectRef: z.ZodString;
+        humanOwnerRef: z.ZodString;
+        teamRef: z.ZodString;
+        clientRef: z.ZodOptional<z.ZodString>;
+        costCenterRef: z.ZodOptional<z.ZodString>;
+        confirmation: z.ZodObject<{
+            evidence: z.ZodLiteral<"user_declared">;
+            confirmedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+            confirmedByRef: z.ZodString;
+            locallyStored: z.ZodLiteral<true>;
+        }, z.core.$strict>;
+        id: z.ZodString;
+    }, z.core.$strict>;
+    costs: z.ZodObject<{
+        lines: z.ZodArray<z.ZodObject<{
+            sourceRef: z.ZodString;
+            basis: z.ZodEnum<{
+                missing: "missing";
+                user_declared: "user_declared";
+                provider_billed: "provider_billed";
+                subscription_included: "subscription_included";
+                api_equivalent_estimate: "api_equivalent_estimate";
+            }>;
+            amountUsd: z.ZodNullable<z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>>;
+            evidence: z.ZodEnum<{
+                verified: "verified";
+                missing: "missing";
+                observed: "observed";
+                calculated: "calculated";
+                user_declared: "user_declared";
+                modeled: "modeled";
+            }>;
+        }, z.core.$strict>>;
+        coverage: z.ZodObject<{
+            status: z.ZodEnum<{
+                missing: "missing";
+                complete: "complete";
+                partial: "partial";
+            }>;
+            coveredRecords: z.ZodNumber;
+            eligibleRecords: z.ZodNumber;
+            evidence: z.ZodEnum<{
+                verified: "verified";
+                missing: "missing";
+                observed: "observed";
+                calculated: "calculated";
+            }>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    action: z.ZodObject<{
+        wasteFindingRef: z.ZodString;
+        tokenExperimentRef: z.ZodString;
+        tokenExperimentRevisionRef: z.ZodString;
+        approvalEvent: z.ZodObject<{
+            kind: z.ZodLiteral<"aibill.approval_event">;
+            schemaVersion: z.ZodLiteral<"0.1.0">;
+            sequence: z.ZodNumber;
+            previousEventId: z.ZodNullable<z.ZodString>;
+            approvedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+            decision: z.ZodLiteral<"approved">;
+            attestation: z.ZodObject<{
+                scope: z.ZodLiteral<"local_self_attested">;
+                evidence: z.ZodLiteral<"user_declared">;
+                approverIdentityRef: z.ZodString;
+                approverRoleRef: z.ZodString;
+                rbacVerified: z.ZodLiteral<false>;
+            }, z.core.$strict>;
+            references: z.ZodObject<{
+                actionRef: z.ZodString;
+                changeRef: z.ZodString;
+                rollbackRef: z.ZodString;
+                canaryRef: z.ZodString;
+            }, z.core.$strict>;
+            id: z.ZodString;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    outcome: z.ZodObject<{
+        kind: z.ZodLiteral<"aibill.accepted_outcome">;
+        schemaVersion: z.ZodLiteral<"0.1.0">;
+        platform: z.ZodLiteral<"github">;
+        outcomeType: z.ZodEnum<{
+            task: "task";
+            pull_request: "pull_request";
+        }>;
+        repositoryRef: z.ZodString;
+        workUnitRef: z.ZodString;
+        state: z.ZodEnum<{
+            merged: "merged";
+            accepted: "accepted";
+        }>;
+        stateEvidence: z.ZodEnum<{
+            verified: "verified";
+            observed: "observed";
+            user_declared: "user_declared";
+        }>;
+        acceptedAt: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        commit: z.ZodObject<{
+            commitRef: z.ZodString;
+            evidence: z.ZodEnum<{
+                verified: "verified";
+                observed: "observed";
+            }>;
+        }, z.core.$strict>;
+        checks: z.ZodObject<{
+            status: z.ZodLiteral<"passed">;
+            evidence: z.ZodEnum<{
+                verified: "verified";
+                observed: "observed";
+            }>;
+            evidenceRefs: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+        businessDescription: z.ZodOptional<z.ZodObject<{
+            value: z.ZodString;
+            evidence: z.ZodLiteral<"user_declared">;
+        }, z.core.$strict>>;
+        id: z.ZodString;
+    }, z.core.$strict>;
+    measuredTokenResult: z.ZodObject<{
+        status: z.ZodEnum<{
+            measured_token_reduction: "measured_token_reduction";
+            no_measured_change: "no_measured_change";
+            regressed: "regressed";
+            inconclusive: "inconclusive";
+        }>;
+        baselineMedianTokens: z.ZodNullable<z.ZodNumber>;
+        postChangeMedianTokens: z.ZodNullable<z.ZodNumber>;
+        baselineSessions: z.ZodNumber;
+        postChangeSessions: z.ZodNumber;
+        reductionPercent: z.ZodNullable<z.ZodNumber>;
+        metricEvidence: z.ZodEnum<{
+            missing: "missing";
+            calculated: "calculated";
+        }>;
+        matchingEvidence: z.ZodEnum<{
+            verified: "verified";
+            missing: "missing";
+            observed: "observed";
+            user_declared: "user_declared";
+        }>;
+        qualityStatus: z.ZodEnum<{
+            regressed: "regressed";
+            held: "held";
+            insufficient: "insufficient";
+        }>;
+        qualityEvidence: z.ZodEnum<{
+            verified: "verified";
+            missing: "missing";
+            observed: "observed";
+            user_declared: "user_declared";
+        }>;
+    }, z.core.$strict>;
+    billReconciliation: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        status: z.ZodLiteral<"not_attempted">;
+        evidence: z.ZodLiteral<"missing">;
+    }, z.core.$strict>, z.ZodObject<{
+        status: z.ZodLiteral<"partial">;
+        evidence: z.ZodLiteral<"verified">;
+        providerBillRef: z.ZodString;
+        coveragePercent: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        matchedAmountUsd: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
+        varianceUsd: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>], "status">;
+    claims: z.ZodObject<{
+        roi: z.ZodLiteral<"not_claimed">;
+        invoiceReconciled: z.ZodLiteral<false>;
+        rbacVerified: z.ZodLiteral<false>;
+    }, z.core.$strict>;
+    id: z.ZodString;
+}, z.core.$strict>;
+export type ProjectEconomicsReceiptV0 = z.infer<typeof projectEconomicsReceiptV0Schema>;
+export declare function createProjectEconomicsReference(namespace: string, sourceNativeValue: string): string;
+export declare function createOwnershipSuggestionV0(input: OwnershipSuggestionV0DraftInput): OwnershipSuggestionV0;
+export declare function parseOwnershipSuggestionV0(value: unknown): OwnershipSuggestionV0;
+export declare function createConfirmedOwnershipV0(input: ConfirmedOwnershipV0DraftInput): ConfirmedOwnershipV0;
+export declare function parseConfirmedOwnershipV0(value: unknown): ConfirmedOwnershipV0;
+export declare function createApprovalEventV0(input: ApprovalEventV0DraftInput): ApprovalEventV0;
+export declare function parseApprovalEventV0(value: unknown): ApprovalEventV0;
+/**
+ * Append one event without mutating history. Sequence, previous digest, and
+ * monotonic time are derived from the already-validated append-only chain.
+ */
+export declare function appendApprovalEventV0(history: readonly ApprovalEventV0[], input: Omit<ApprovalEventV0DraftInput, "sequence" | "previousEventId">): ApprovalEventV0[];
+export declare function createAcceptedOutcomeV0(input: AcceptedOutcomeV0DraftInput): AcceptedOutcomeV0;
+export declare function parseAcceptedOutcomeV0(value: unknown): AcceptedOutcomeV0;
+export declare function createProjectEconomicsReceiptV0(input: ProjectEconomicsReceiptV0DraftInput): ProjectEconomicsReceiptV0;
+export declare function parseProjectEconomicsReceiptV0(value: unknown): ProjectEconomicsReceiptV0;
+/** Stable one-line JSON for local persistence or transport. */
+export declare function serializeProjectEconomicsReceiptV0(receipt: ProjectEconomicsReceiptV0): string;
+export declare function deserializeProjectEconomicsReceiptV0(serialized: string): ProjectEconomicsReceiptV0;
+export {};
+//# sourceMappingURL=projectEconomics.d.ts.map