@usefragments/core 1.0.0 → 1.2.0

package/dist/schemas/index.d.ts

@@ -1922,11 +1922,50 @@ declare const agentFindingSchema: z.ZodObject<{
     };
     code?: string | undefined;
 }>;
+declare const AGENT_FORMAT_SCHEMA_VERSION: "typestyle.agent.v2";
+declare const agentIntegritySchema: z.ZodObject<{
+    rulesLoaded: z.ZodNumber;
+    status: z.ZodEnum<["healthy", "degraded", "inert"]>;
+    healthy: z.ZodBoolean;
+    inert: z.ZodBoolean;
+    reasons: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    status: "healthy" | "degraded" | "inert";
+    rulesLoaded: number;
+    healthy: boolean;
+    inert: boolean;
+    reasons: string[];
+}, {
+    status: "healthy" | "degraded" | "inert";
+    rulesLoaded: number;
+    healthy: boolean;
+    inert: boolean;
+    reasons: string[];
+}>;
 declare const agentFormatSchema: z.ZodObject<{
-    schemaVersion: z.ZodLiteral<"typestyle.agent.v1">;
+    schemaVersion: z.ZodLiteral<"typestyle.agent.v2">;
     passed: z.ZodBoolean;
     score: z.ZodNumber;
     summary: z.ZodString;
+    integrity: z.ZodObject<{
+        rulesLoaded: z.ZodNumber;
+        status: z.ZodEnum<["healthy", "degraded", "inert"]>;
+        healthy: z.ZodBoolean;
+        inert: z.ZodBoolean;
+        reasons: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        status: "healthy" | "degraded" | "inert";
+        rulesLoaded: number;
+        healthy: boolean;
+        inert: boolean;
+        reasons: string[];
+    }, {
+        status: "healthy" | "degraded" | "inert";
+        rulesLoaded: number;
+        healthy: boolean;
+        inert: boolean;
+        reasons: string[];
+    }>;
     fix_first: z.ZodArray<z.ZodObject<{
         code: z.ZodOptional<z.ZodString>;
         ruleId: z.ZodString;
@@ -2348,8 +2387,15 @@ declare const agentFormatSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     passed: boolean;
     score: number;
-    schemaVersion: "typestyle.agent.v1";
+    schemaVersion: "typestyle.agent.v2";
     summary: string;
+    integrity: {
+        status: "healthy" | "degraded" | "inert";
+        rulesLoaded: number;
+        healthy: boolean;
+        inert: boolean;
+        reasons: string[];
+    };
     fix_first: {
         message: string;
         line: number;
@@ -2461,8 +2507,15 @@ declare const agentFormatSchema: z.ZodObject<{
 }, {
     passed: boolean;
     score: number;
-    schemaVersion: "typestyle.agent.v1";
+    schemaVersion: "typestyle.agent.v2";
     summary: string;
+    integrity: {
+        status: "healthy" | "degraded" | "inert";
+        rulesLoaded: number;
+        healthy: boolean;
+        inert: boolean;
+        reasons: string[];
+    };
     fix_first: {
         message: string;
         line: number;
@@ -2573,6 +2626,746 @@ declare const agentFormatSchema: z.ZodObject<{
     }[] | undefined;
 }>;
 type AgentFormat = z.infer<typeof agentFormatSchema>;
+declare const agentErrorEnvelopeSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"typestyle.agent.v2">;
+    passed: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+    }, {
+        code: string;
+        message: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    error: {
+        code: string;
+        message: string;
+    };
+    passed: false;
+    schemaVersion: "typestyle.agent.v2";
+}, {
+    error: {
+        code: string;
+        message: string;
+    };
+    passed: false;
+    schemaVersion: "typestyle.agent.v2";
+}>;
+type AgentErrorEnvelope = z.infer<typeof agentErrorEnvelopeSchema>;
+declare const agentOutputSchema: z.ZodUnion<[z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"typestyle.agent.v2">;
+    passed: z.ZodBoolean;
+    score: z.ZodNumber;
+    summary: z.ZodString;
+    integrity: z.ZodObject<{
+        rulesLoaded: z.ZodNumber;
+        status: z.ZodEnum<["healthy", "degraded", "inert"]>;
+        healthy: z.ZodBoolean;
+        inert: z.ZodBoolean;
+        reasons: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        status: "healthy" | "degraded" | "inert";
+        rulesLoaded: number;
+        healthy: boolean;
+        inert: boolean;
+        reasons: string[];
+    }, {
+        status: "healthy" | "degraded" | "inert";
+        rulesLoaded: number;
+        healthy: boolean;
+        inert: boolean;
+        reasons: string[];
+    }>;
+    fix_first: z.ZodArray<z.ZodObject<{
+        code: z.ZodOptional<z.ZodString>;
+        ruleId: z.ZodString;
+        filePath: z.ZodString;
+        line: z.ZodNumber;
+        col: z.ZodNumber;
+        severity: z.ZodEnum<["critical", "serious", "moderate", "minor"]>;
+        level: z.ZodEnum<["error", "warn"]>;
+        message: z.ZodString;
+        evidence: z.ZodArray<z.ZodType<FactEvidence, z.ZodTypeDef, FactEvidence>, "many">;
+        plan: z.ZodObject<{
+            tool: z.ZodEnum<["design_system/list_primitives", "design_system/conform", "design_system/prove_compliant"]>;
+            args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            confidence: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            tool: "design_system/list_primitives" | "design_system/conform" | "design_system/prove_compliant";
+            args: Record<string, unknown>;
+            confidence: number;
+        }, {
+            tool: "design_system/list_primitives" | "design_system/conform" | "design_system/prove_compliant";
+            args: Record<string, unknown>;
+            confidence: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        line: number;
+        ruleId: string;
+        severity: "critical" | "serious" | "moderate" | "minor";
+        level: "error" | "warn";
+        evidence: FactEvidence[];
+        filePath: string;
+        col: number;
+        plan: {
+            tool: "design_system/list_primitives" | "design_system/conform" | "design_system/prove_compliant";
+            args: Record<string, unknown>;
+            confidence: number;
+        };
+        code?: string | undefined;
+    }, {
+        message: string;
+        line: number;
+        ruleId: string;
+        severity: "critical" | "serious" | "moderate" | "minor";
+        level: "error" | "warn";
+        evidence: FactEvidence[];
+        filePath: string;
+        col: number;
+        plan: {
+            tool: "design_system/list_primitives" | "design_system/conform" | "design_system/prove_compliant";
+            args: Record<string, unknown>;
+            confidence: number;
+        };
+        code?: string | undefined;
+    }>, "many">;
+    remaining: z.ZodArray<z.ZodObject<{
+        code: z.ZodOptional<z.ZodString>;
+        ruleId: z.ZodString;
+        filePath: z.ZodString;
+        line: z.ZodNumber;
+        col: z.ZodNumber;
+        severity: z.ZodEnum<["critical", "serious", "moderate", "minor"]>;
+        level: z.ZodEnum<["error", "warn"]>;
+        message: z.ZodString;
+        evidence: z.ZodArray<z.ZodType<FactEvidence, z.ZodTypeDef, FactEvidence>, "many">;
+        plan: z.ZodObject<{
+            tool: z.ZodEnum<["design_system/list_primitives", "design_system/conform", "design_system/prove_compliant"]>;
+            args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            confidence: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            tool: "design_system/list_primitives" | "design_system/conform" | "design_system/prove_compliant";
+            args: Record<string, unknown>;
+            confidence: number;
+        }, {
+            tool: "design_system/list_primitives" | "design_system/conform" | "design_system/prove_compliant";
+            args: Record<string, unknown>;
+            confidence: number;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        line: number;
+        ruleId: string;
+        severity: "critical" | "serious" | "moderate" | "minor";
+        level: "error" | "warn";
+        evidence: FactEvidence[];
+        filePath: string;
+        col: number;
+        plan: {
+            tool: "design_system/list_primitives" | "design_system/conform" | "design_system/prove_compliant";
+            args: Record<string, unknown>;
+            confidence: number;
+        };
+        code?: string | undefined;
+    }, {
+        message: string;
+        line: number;
+        ruleId: string;
+        severity: "critical" | "serious" | "moderate" | "minor";
+        level: "error" | "warn";
+        evidence: FactEvidence[];
+        filePath: string;
+        col: number;
+        plan: {
+            tool: "design_system/list_primitives" | "design_system/conform" | "design_system/prove_compliant";
+            args: Record<string, unknown>;
+            confidence: number;
+        };
+        code?: string | undefined;
+    }>, "many">;
+    suppression_template: z.ZodObject<{
+        directive: z.ZodString;
+        requiredFields: z.ZodArray<z.ZodString, "many">;
+        example: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        directive: string;
+        requiredFields: string[];
+        example: string;
+    }, {
+        directive: string;
+        requiredFields: string[];
+        example: string;
+    }>;
+    budget: z.ZodObject<{
+        iteration: z.ZodNumber;
+        maxIterations: z.ZodNumber;
+        scoreDelta: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        iteration: number;
+        maxIterations: number;
+        scoreDelta: number;
+    }, {
+        iteration: number;
+        maxIterations: number;
+        scoreDelta: number;
+    }>;
+    findings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        ruleId: z.ZodString;
+        ruleVersion: z.ZodString;
+        severity: z.ZodEnum<["critical", "serious", "moderate", "minor"]>;
+        level: z.ZodEnum<["error", "warn"]>;
+        code: z.ZodOptional<z.ZodString>;
+        helpUrl: z.ZodOptional<z.ZodString>;
+        message: z.ZodString;
+        fingerprint: z.ZodString;
+        location: z.ZodObject<{
+            file: z.ZodString;
+            line: z.ZodNumber;
+            column: z.ZodNumber;
+            endLine: z.ZodOptional<z.ZodNumber>;
+            endColumn: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            file: string;
+            line: number;
+            column: number;
+            endLine?: number | undefined;
+            endColumn?: number | undefined;
+        }, {
+            file: string;
+            line: number;
+            column: number;
+            endLine?: number | undefined;
+            endColumn?: number | undefined;
+        }>;
+        evidence: z.ZodArray<z.ZodType<FactEvidence, z.ZodTypeDef, FactEvidence>, "many">;
+        fix: z.ZodOptional<z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+            kind: z.ZodLiteral<"replacePropValue">;
+            title: z.ZodString;
+            prop: z.ZodString;
+            value: z.ZodUnknown;
+            deterministic: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "replacePropValue";
+            title: string;
+            prop: string;
+            deterministic?: boolean | undefined;
+            value?: unknown;
+        }, {
+            kind: "replacePropValue";
+            title: string;
+            prop: string;
+            deterministic?: boolean | undefined;
+            value?: unknown;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"replaceStyleValue">;
+            title: z.ZodString;
+            property: z.ZodString;
+            value: z.ZodString;
+            deterministic: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            value: string;
+            kind: "replaceStyleValue";
+            title: string;
+            property: string;
+            deterministic?: boolean | undefined;
+        }, {
+            value: string;
+            kind: "replaceStyleValue";
+            title: string;
+            property: string;
+            deterministic?: boolean | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"replaceImport">;
+            title: z.ZodString;
+            from: z.ZodString;
+            to: z.ZodString;
+            deterministic: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "replaceImport";
+            title: string;
+            from: string;
+            to: string;
+            deterministic?: boolean | undefined;
+        }, {
+            kind: "replaceImport";
+            title: string;
+            from: string;
+            to: string;
+            deterministic?: boolean | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"replaceComponent">;
+            title: z.ZodString;
+            from: z.ZodString;
+            to: z.ZodString;
+            deterministic: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "replaceComponent";
+            title: string;
+            from: string;
+            to: string;
+            deterministic?: boolean | undefined;
+        }, {
+            kind: "replaceComponent";
+            title: string;
+            from: string;
+            to: string;
+            deterministic?: boolean | undefined;
+        }>, z.ZodObject<{
+            kind: z.ZodLiteral<"replaceClassToken">;
+            title: z.ZodString;
+            from: z.ZodString;
+            to: z.ZodNullable<z.ZodString>;
+            utility: z.ZodString;
+            deterministic: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "replaceClassToken";
+            title: string;
+            from: string;
+            to: string | null;
+            utility: string;
+            deterministic?: boolean | undefined;
+        }, {
+            kind: "replaceClassToken";
+            title: string;
+            from: string;
+            to: string | null;
+            utility: string;
+            deterministic?: boolean | undefined;
+        }>]>>;
+        attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        /**
+         * Product area this finding's file resolved to (topology layer). Optional —
+         * absent when the repo has no `topology` config. See `topology/resolve-area`.
+         */
+        area: z.ZodOptional<z.ZodObject<{
+            areaId: z.ZodString;
+            areaName: z.ZodString;
+            criticality: z.ZodEnum<["low", "medium", "high", "revenue", "regulated"]>;
+            owners: z.ZodArray<z.ZodString, "many">;
+            matchedGlob: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            areaId: string;
+            areaName: string;
+            criticality: "high" | "medium" | "low" | "revenue" | "regulated";
+            owners: string[];
+            matchedGlob: string;
+        }, {
+            areaId: string;
+            areaName: string;
+            criticality: "high" | "medium" | "low" | "revenue" | "regulated";
+            owners: string[];
+            matchedGlob: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        location: {
+            file: string;
+            line: number;
+            column: number;
+            endLine?: number | undefined;
+            endColumn?: number | undefined;
+        };
+        ruleId: string;
+        ruleVersion: string;
+        severity: "critical" | "serious" | "moderate" | "minor";
+        level: "error" | "warn";
+        fingerprint: string;
+        evidence: FactEvidence[];
+        code?: string | undefined;
+        helpUrl?: string | undefined;
+        fix?: {
+            kind: "replacePropValue";
+            title: string;
+            prop: string;
+            deterministic?: boolean | undefined;
+            value?: unknown;
+        } | {
+            value: string;
+            kind: "replaceStyleValue";
+            title: string;
+            property: string;
+            deterministic?: boolean | undefined;
+        } | {
+            kind: "replaceImport";
+            title: string;
+            from: string;
+            to: string;
+            deterministic?: boolean | undefined;
+        } | {
+            kind: "replaceComponent";
+            title: string;
+            from: string;
+            to: string;
+            deterministic?: boolean | undefined;
+        } | {
+            kind: "replaceClassToken";
+            title: string;
+            from: string;
+            to: string | null;
+            utility: string;
+            deterministic?: boolean | undefined;
+        } | undefined;
+        attributes?: Record<string, unknown> | undefined;
+        area?: {
+            areaId: string;
+            areaName: string;
+            criticality: "high" | "medium" | "low" | "revenue" | "regulated";
+            owners: string[];
+            matchedGlob: string;
+        } | undefined;
+    }, {
+        message: string;
+        location: {
+            file: string;
+            line: number;
+            column: number;
+            endLine?: number | undefined;
+            endColumn?: number | undefined;
+        };
+        ruleId: string;
+        ruleVersion: string;
+        severity: "critical" | "serious" | "moderate" | "minor";
+        level: "error" | "warn";
+        fingerprint: string;
+        evidence: FactEvidence[];
+        code?: string | undefined;
+        helpUrl?: string | undefined;
+        fix?: {
+            kind: "replacePropValue";
+            title: string;
+            prop: string;
+            deterministic?: boolean | undefined;
+            value?: unknown;
+        } | {
+            value: string;
+            kind: "replaceStyleValue";
+            title: string;
+            property: string;
+            deterministic?: boolean | undefined;
+        } | {
+            kind: "replaceImport";
+            title: string;
+            from: string;
+            to: string;
+            deterministic?: boolean | undefined;
+        } | {
+            kind: "replaceComponent";
+            title: string;
+            from: string;
+            to: string;
+            deterministic?: boolean | undefined;
+        } | {
+            kind: "replaceClassToken";
+            title: string;
+            from: string;
+            to: string | null;
+            utility: string;
+            deterministic?: boolean | undefined;
+        } | undefined;
+        attributes?: Record<string, unknown> | undefined;
+        area?: {
+            areaId: string;
+            areaName: string;
+            criticality: "high" | "medium" | "low" | "revenue" | "regulated";
+            owners: string[];
+            matchedGlob: string;
+        } | undefined;
+    }>, "many">>;
+    suppressions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        ruleId: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        expiresAt: z.ZodOptional<z.ZodString>;
+        expiresOn: z.ZodOptional<z.ZodString>;
+        scope: z.ZodDefault<z.ZodEnum<["line", "block", "file"]>>;
+        code: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        reason: string;
+        scope: "file" | "line" | "block";
+        code?: string | undefined;
+        ruleId?: string | undefined;
+        expiresAt?: string | undefined;
+        expiresOn?: string | undefined;
+    }, {
+        reason: string;
+        code?: string | undefined;
+        ruleId?: string | undefined;
+        expiresAt?: string | undefined;
+        expiresOn?: string | undefined;
+        scope?: "file" | "line" | "block" | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    passed: boolean;
+    score: number;
+    schemaVersion: "typestyle.agent.v2";
+    summary: string;
+    integrity: {
+        status: "healthy" | "degraded" | "inert";
+        rulesLoaded: number;
+        healthy: boolean;
+        inert: boolean;
+        reasons: string[];
+    };
+    fix_first: {
+        message: string;
+        line: number;
+        ruleId: string;
+        severity: "critical" | "serious" | "moderate" | "minor";
+        level: "error" | "warn";
+        evidence: FactEvidence[];
+        filePath: string;
+        col: number;
+        plan: {
+            tool: "design_system/list_primitives" | "design_system/conform" | "design_system/prove_compliant";
+            args: Record<string, unknown>;
+            confidence: number;
+        };
+        code?: string | undefined;
+    }[];
+    remaining: {
+        message: string;
+        line: number;
+        ruleId: string;
+        severity: "critical" | "serious" | "moderate" | "minor";
+        level: "error" | "warn";
+        evidence: FactEvidence[];
+        filePath: string;
+        col: number;
+        plan: {
+            tool: "design_system/list_primitives" | "design_system/conform" | "design_system/prove_compliant";
+            args: Record<string, unknown>;
+            confidence: number;
+        };
+        code?: string | undefined;
+    }[];
+    suppression_template: {
+        directive: string;
+        requiredFields: string[];
+        example: string;
+    };
+    budget: {
+        iteration: number;
+        maxIterations: number;
+        scoreDelta: number;
+    };
+    findings?: {
+        message: string;
+        location: {
+            file: string;
+            line: number;
+            column: number;
+            endLine?: number | undefined;
+            endColumn?: number | undefined;
+        };
+        ruleId: string;
+        ruleVersion: string;
+        severity: "critical" | "serious" | "moderate" | "minor";
+        level: "error" | "warn";
+        fingerprint: string;
+        evidence: FactEvidence[];
+        code?: string | undefined;
+        helpUrl?: string | undefined;
+        fix?: {
+            kind: "replacePropValue";
+            title: string;
+            prop: string;
+            deterministic?: boolean | undefined;
+            value?: unknown;
+        } | {
+            value: string;
+            kind: "replaceStyleValue";
+            title: string;
+            property: string;
+            deterministic?: boolean | undefined;
+        } | {
+            kind: "replaceImport";
+            title: string;
+            from: string;
+            to: string;
+            deterministic?: boolean | undefined;
+        } | {
+            kind: "replaceComponent";
+            title: string;
+            from: string;
+            to: string;
+            deterministic?: boolean | undefined;
+        } | {
+            kind: "replaceClassToken";
+            title: string;
+            from: string;
+            to: string | null;
+            utility: string;
+            deterministic?: boolean | undefined;
+        } | undefined;
+        attributes?: Record<string, unknown> | undefined;
+        area?: {
+            areaId: string;
+            areaName: string;
+            criticality: "high" | "medium" | "low" | "revenue" | "regulated";
+            owners: string[];
+            matchedGlob: string;
+        } | undefined;
+    }[] | undefined;
+    suppressions?: {
+        reason: string;
+        scope: "file" | "line" | "block";
+        code?: string | undefined;
+        ruleId?: string | undefined;
+        expiresAt?: string | undefined;
+        expiresOn?: string | undefined;
+    }[] | undefined;
+}, {
+    passed: boolean;
+    score: number;
+    schemaVersion: "typestyle.agent.v2";
+    summary: string;
+    integrity: {
+        status: "healthy" | "degraded" | "inert";
+        rulesLoaded: number;
+        healthy: boolean;
+        inert: boolean;
+        reasons: string[];
+    };
+    fix_first: {
+        message: string;
+        line: number;
+        ruleId: string;
+        severity: "critical" | "serious" | "moderate" | "minor";
+        level: "error" | "warn";
+        evidence: FactEvidence[];
+        filePath: string;
+        col: number;
+        plan: {
+            tool: "design_system/list_primitives" | "design_system/conform" | "design_system/prove_compliant";
+            args: Record<string, unknown>;
+            confidence: number;
+        };
+        code?: string | undefined;
+    }[];
+    remaining: {
+        message: string;
+        line: number;
+        ruleId: string;
+        severity: "critical" | "serious" | "moderate" | "minor";
+        level: "error" | "warn";
+        evidence: FactEvidence[];
+        filePath: string;
+        col: number;
+        plan: {
+            tool: "design_system/list_primitives" | "design_system/conform" | "design_system/prove_compliant";
+            args: Record<string, unknown>;
+            confidence: number;
+        };
+        code?: string | undefined;
+    }[];
+    suppression_template: {
+        directive: string;
+        requiredFields: string[];
+        example: string;
+    };
+    budget: {
+        iteration: number;
+        maxIterations: number;
+        scoreDelta: number;
+    };
+    findings?: {
+        message: string;
+        location: {
+            file: string;
+            line: number;
+            column: number;
+            endLine?: number | undefined;
+            endColumn?: number | undefined;
+        };
+        ruleId: string;
+        ruleVersion: string;
+        severity: "critical" | "serious" | "moderate" | "minor";
+        level: "error" | "warn";
+        fingerprint: string;
+        evidence: FactEvidence[];
+        code?: string | undefined;
+        helpUrl?: string | undefined;
+        fix?: {
+            kind: "replacePropValue";
+            title: string;
+            prop: string;
+            deterministic?: boolean | undefined;
+            value?: unknown;
+        } | {
+            value: string;
+            kind: "replaceStyleValue";
+            title: string;
+            property: string;
+            deterministic?: boolean | undefined;
+        } | {
+            kind: "replaceImport";
+            title: string;
+            from: string;
+            to: string;
+            deterministic?: boolean | undefined;
+        } | {
+            kind: "replaceComponent";
+            title: string;
+            from: string;
+            to: string;
+            deterministic?: boolean | undefined;
+        } | {
+            kind: "replaceClassToken";
+            title: string;
+            from: string;
+            to: string | null;
+            utility: string;
+            deterministic?: boolean | undefined;
+        } | undefined;
+        attributes?: Record<string, unknown> | undefined;
+        area?: {
+            areaId: string;
+            areaName: string;
+            criticality: "high" | "medium" | "low" | "revenue" | "regulated";
+            owners: string[];
+            matchedGlob: string;
+        } | undefined;
+    }[] | undefined;
+    suppressions?: {
+        reason: string;
+        code?: string | undefined;
+        ruleId?: string | undefined;
+        expiresAt?: string | undefined;
+        expiresOn?: string | undefined;
+        scope?: "file" | "line" | "block" | undefined;
+    }[] | undefined;
+}>, z.ZodObject<{
+    schemaVersion: z.ZodLiteral<"typestyle.agent.v2">;
+    passed: z.ZodLiteral<false>;
+    error: z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        code: string;
+        message: string;
+    }, {
+        code: string;
+        message: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    error: {
+        code: string;
+        message: string;
+    };
+    passed: false;
+    schemaVersion: "typestyle.agent.v2";
+}, {
+    error: {
+        code: string;
+        message: string;
+    };
+    passed: false;
+    schemaVersion: "typestyle.agent.v2";
+}>]>;
+type AgentOutput = z.infer<typeof agentOutputSchema>;
 declare function normalizeSeverity(severity: Severity | LegacySeverityLevel): Severity;
 declare function normalizeFinding(input: Omit<Finding, "level"> & {
     level?: Finding["level"];
@@ -2581,4 +3374,4 @@ declare function normalizeViolation(input: Omit<Violation, "level"> & {
     level?: Violation["level"];
 }): Violation;
 
-export { type AgentFormat, type FactEvidence, type FactLocation, type Finding, type FindingFix, type FindingReplaceClassTokenFix, type FindingReplaceComponentFix, type FindingReplaceImportFix, type FindingReplacePropValueFix, type FindingReplaceStyleValueFix, type Fix, type GovernanceVerdict, type GovernanceVerdictMetadata, LegacySeverityLevel, Severity, type SuppressionDirective, type ValidatorResult, type Violation, agentFindingSchema, agentFormatSchema, agentPlanSchema, factEvidenceSchema, factLocationSchema, findingFixSchema, findingReplaceClassTokenFixSchema, findingReplaceComponentFixSchema, findingReplaceImportFixSchema, findingReplacePropValueFixSchema, findingReplaceStyleValueFixSchema, findingSchema, fixSchema, governanceVerdictMetadataSchema, governanceVerdictSchema, normalizeFinding, normalizeSeverity, normalizeViolation, suppressionDirectiveSchema, validatorResultSchema, violationSchema };
+export { AGENT_FORMAT_SCHEMA_VERSION, type AgentErrorEnvelope, type AgentFormat, type AgentOutput, type FactEvidence, type FactLocation, type Finding, type FindingFix, type FindingReplaceClassTokenFix, type FindingReplaceComponentFix, type FindingReplaceImportFix, type FindingReplacePropValueFix, type FindingReplaceStyleValueFix, type Fix, type GovernanceVerdict, type GovernanceVerdictMetadata, LegacySeverityLevel, Severity, type SuppressionDirective, type ValidatorResult, type Violation, agentErrorEnvelopeSchema, agentFindingSchema, agentFormatSchema, agentIntegritySchema, agentOutputSchema, agentPlanSchema, factEvidenceSchema, factLocationSchema, findingFixSchema, findingReplaceClassTokenFixSchema, findingReplaceComponentFixSchema, findingReplaceImportFixSchema, findingReplacePropValueFixSchema, findingReplaceStyleValueFixSchema, findingSchema, fixSchema, governanceVerdictMetadataSchema, governanceVerdictSchema, normalizeFinding, normalizeSeverity, normalizeViolation, suppressionDirectiveSchema, validatorResultSchema, violationSchema };