@intutic/shared-types 2.4.0 → 2.5.1

package/dist/responses/observability.d.ts

@@ -0,0 +1,3222 @@
+/**
+ * Responses of the control plane routes in incidents.ts, traces.ts, findings.ts, integrity.ts, inventory.ts, usage.ts and loops.ts.
+ *
+ * @module
+ */
+import { z } from 'zod';
+/** A governance incident, as `GET /api/v1/incidents/:id` maps its `governance_incidents` row. */
+export declare const IncidentResponse: z.ZodObject<{
+    incident_id: z.ZodString;
+    workspace_id: z.ZodString;
+    trace_id: z.ZodNullable<z.ZodString>;
+    session_id: z.ZodNullable<z.ZodString>;
+    severity: z.ZodEnum<["LOW", "MEDIUM", "HIGH", "CRITICAL"]>;
+    anomaly_type: z.ZodEnum<[import("../enums.js").IncidentType, ...import("../enums.js").IncidentType[]]>;
+    description: z.ZodString;
+    resolution_status: z.ZodNullable<z.ZodString>;
+    resolved_by: z.ZodNullable<z.ZodString>;
+    resolved_at: z.ZodNullable<z.ZodString>;
+    escalation_chain: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    created_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+    workspace_id: string;
+    session_id: string | null;
+    created_at: string;
+    incident_id: string;
+    trace_id: string | null;
+    anomaly_type: import("../enums.js").IncidentType;
+    resolution_status: string | null;
+    resolved_by: string | null;
+    resolved_at: string | null;
+    escalation_chain: Record<string, unknown> | null;
+}, {
+    description: string;
+    severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+    workspace_id: string;
+    session_id: string | null;
+    created_at: string;
+    incident_id: string;
+    trace_id: string | null;
+    anomaly_type: import("../enums.js").IncidentType;
+    resolution_status: string | null;
+    resolved_by: string | null;
+    resolved_at: string | null;
+    escalation_chain: Record<string, unknown> | null;
+}>;
+export type IncidentResponse = z.infer<typeof IncidentResponse>;
+/** `GET /api/v1/incidents/:id`. */
+export declare const IncidentDetailResponse: z.ZodObject<{
+    data: z.ZodObject<{
+        incident_id: z.ZodString;
+        workspace_id: z.ZodString;
+        trace_id: z.ZodNullable<z.ZodString>;
+        session_id: z.ZodNullable<z.ZodString>;
+        severity: z.ZodEnum<["LOW", "MEDIUM", "HIGH", "CRITICAL"]>;
+        anomaly_type: z.ZodEnum<[import("../enums.js").IncidentType, ...import("../enums.js").IncidentType[]]>;
+        description: z.ZodString;
+        resolution_status: z.ZodNullable<z.ZodString>;
+        resolved_by: z.ZodNullable<z.ZodString>;
+        resolved_at: z.ZodNullable<z.ZodString>;
+        escalation_chain: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        created_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+        workspace_id: string;
+        session_id: string | null;
+        created_at: string;
+        incident_id: string;
+        trace_id: string | null;
+        anomaly_type: import("../enums.js").IncidentType;
+        resolution_status: string | null;
+        resolved_by: string | null;
+        resolved_at: string | null;
+        escalation_chain: Record<string, unknown> | null;
+    }, {
+        description: string;
+        severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+        workspace_id: string;
+        session_id: string | null;
+        created_at: string;
+        incident_id: string;
+        trace_id: string | null;
+        anomaly_type: import("../enums.js").IncidentType;
+        resolution_status: string | null;
+        resolved_by: string | null;
+        resolved_at: string | null;
+        escalation_chain: Record<string, unknown> | null;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        description: string;
+        severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+        workspace_id: string;
+        session_id: string | null;
+        created_at: string;
+        incident_id: string;
+        trace_id: string | null;
+        anomaly_type: import("../enums.js").IncidentType;
+        resolution_status: string | null;
+        resolved_by: string | null;
+        resolved_at: string | null;
+        escalation_chain: Record<string, unknown> | null;
+    };
+}, {
+    data: {
+        description: string;
+        severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+        workspace_id: string;
+        session_id: string | null;
+        created_at: string;
+        incident_id: string;
+        trace_id: string | null;
+        anomaly_type: import("../enums.js").IncidentType;
+        resolution_status: string | null;
+        resolved_by: string | null;
+        resolved_at: string | null;
+        escalation_chain: Record<string, unknown> | null;
+    };
+}>;
+export type IncidentDetailResponse = z.infer<typeof IncidentDetailResponse>;
+/** How much of a ranked review queue the audit budget covers (`services/reviewPriority.ts` `describeBudget`). */
+export declare const ReviewBudgetResponse: z.ZodObject<{
+    budget: z.ZodNumber;
+    matched: z.ZodNumber;
+    withheld: z.ZodNumber;
+    overBudget: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    budget: number;
+    matched: number;
+    withheld: number;
+    overBudget: boolean;
+}, {
+    budget: number;
+    matched: number;
+    withheld: number;
+    overBudget: boolean;
+}>;
+export type ReviewBudgetResponse = z.infer<typeof ReviewBudgetResponse>;
+/** One row of the incident list: the incident with its rank. */
+export declare const IncidentListRowResponse: z.ZodObject<{
+    incident_id: z.ZodString;
+    workspace_id: z.ZodString;
+    trace_id: z.ZodNullable<z.ZodString>;
+    session_id: z.ZodNullable<z.ZodString>;
+    severity: z.ZodEnum<["LOW", "MEDIUM", "HIGH", "CRITICAL"]>;
+    anomaly_type: z.ZodEnum<[import("../enums.js").IncidentType, ...import("../enums.js").IncidentType[]]>;
+    description: z.ZodString;
+    resolution_status: z.ZodNullable<z.ZodString>;
+    resolved_by: z.ZodNullable<z.ZodString>;
+    resolved_at: z.ZodNullable<z.ZodString>;
+    escalation_chain: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    created_at: z.ZodString;
+} & {
+    review_priority: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+    workspace_id: string;
+    session_id: string | null;
+    created_at: string;
+    incident_id: string;
+    trace_id: string | null;
+    anomaly_type: import("../enums.js").IncidentType;
+    resolution_status: string | null;
+    resolved_by: string | null;
+    resolved_at: string | null;
+    escalation_chain: Record<string, unknown> | null;
+    review_priority: number;
+}, {
+    description: string;
+    severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+    workspace_id: string;
+    session_id: string | null;
+    created_at: string;
+    incident_id: string;
+    trace_id: string | null;
+    anomaly_type: import("../enums.js").IncidentType;
+    resolution_status: string | null;
+    resolved_by: string | null;
+    resolved_at: string | null;
+    escalation_chain: Record<string, unknown> | null;
+    review_priority: number;
+}>;
+export type IncidentListRowResponse = z.infer<typeof IncidentListRowResponse>;
+/**
+ * `GET /api/v1/incidents`. A page of 20 or more rows is TOON-encoded: the rows
+ * are one string under `data`, and `listProperty` names where a decoder puts
+ * them (`data` again).
+ */
+export declare const IncidentListResponse: z.ZodUnion<[z.ZodObject<{
+    listProperty: z.ZodLiteral<"data">;
+    rowCase: z.ZodLiteral<"snake">;
+} & {
+    format: z.ZodLiteral<"toon">;
+    data: z.ZodString;
+    meta: z.ZodObject<{
+        total: z.ZodNumber;
+        page: z.ZodNumber;
+        limit: z.ZodNumber;
+        audit: z.ZodObject<{
+            budget: z.ZodNumber;
+            matched: z.ZodNumber;
+            withheld: z.ZodNumber;
+            overBudget: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            budget: number;
+            matched: number;
+            withheld: number;
+            overBudget: boolean;
+        }, {
+            budget: number;
+            matched: number;
+            withheld: number;
+            overBudget: boolean;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        audit: {
+            budget: number;
+            matched: number;
+            withheld: number;
+            overBudget: boolean;
+        };
+        total: number;
+        page: number;
+    }, {
+        limit: number;
+        audit: {
+            budget: number;
+            matched: number;
+            withheld: number;
+            overBudget: boolean;
+        };
+        total: number;
+        page: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    data: string;
+    listProperty: "data";
+    rowCase: "snake";
+    format: "toon";
+    meta: {
+        limit: number;
+        audit: {
+            budget: number;
+            matched: number;
+            withheld: number;
+            overBudget: boolean;
+        };
+        total: number;
+        page: number;
+    };
+}, {
+    data: string;
+    listProperty: "data";
+    rowCase: "snake";
+    format: "toon";
+    meta: {
+        limit: number;
+        audit: {
+            budget: number;
+            matched: number;
+            withheld: number;
+            overBudget: boolean;
+        };
+        total: number;
+        page: number;
+    };
+}>, z.ZodObject<{
+    listProperty: z.ZodLiteral<"data">;
+    rowCase: z.ZodLiteral<"snake">;
+} & {
+    data: z.ZodArray<z.ZodObject<{
+        incident_id: z.ZodString;
+        workspace_id: z.ZodString;
+        trace_id: z.ZodNullable<z.ZodString>;
+        session_id: z.ZodNullable<z.ZodString>;
+        severity: z.ZodEnum<["LOW", "MEDIUM", "HIGH", "CRITICAL"]>;
+        anomaly_type: z.ZodEnum<[import("../enums.js").IncidentType, ...import("../enums.js").IncidentType[]]>;
+        description: z.ZodString;
+        resolution_status: z.ZodNullable<z.ZodString>;
+        resolved_by: z.ZodNullable<z.ZodString>;
+        resolved_at: z.ZodNullable<z.ZodString>;
+        escalation_chain: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        created_at: z.ZodString;
+    } & {
+        review_priority: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+        workspace_id: string;
+        session_id: string | null;
+        created_at: string;
+        incident_id: string;
+        trace_id: string | null;
+        anomaly_type: import("../enums.js").IncidentType;
+        resolution_status: string | null;
+        resolved_by: string | null;
+        resolved_at: string | null;
+        escalation_chain: Record<string, unknown> | null;
+        review_priority: number;
+    }, {
+        description: string;
+        severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+        workspace_id: string;
+        session_id: string | null;
+        created_at: string;
+        incident_id: string;
+        trace_id: string | null;
+        anomaly_type: import("../enums.js").IncidentType;
+        resolution_status: string | null;
+        resolved_by: string | null;
+        resolved_at: string | null;
+        escalation_chain: Record<string, unknown> | null;
+        review_priority: number;
+    }>, "many">;
+    meta: z.ZodObject<{
+        total: z.ZodNumber;
+        page: z.ZodNumber;
+        limit: z.ZodNumber;
+        audit: z.ZodObject<{
+            budget: z.ZodNumber;
+            matched: z.ZodNumber;
+            withheld: z.ZodNumber;
+            overBudget: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            budget: number;
+            matched: number;
+            withheld: number;
+            overBudget: boolean;
+        }, {
+            budget: number;
+            matched: number;
+            withheld: number;
+            overBudget: boolean;
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        limit: number;
+        audit: {
+            budget: number;
+            matched: number;
+            withheld: number;
+            overBudget: boolean;
+        };
+        total: number;
+        page: number;
+    }, {
+        limit: number;
+        audit: {
+            budget: number;
+            matched: number;
+            withheld: number;
+            overBudget: boolean;
+        };
+        total: number;
+        page: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        description: string;
+        severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+        workspace_id: string;
+        session_id: string | null;
+        created_at: string;
+        incident_id: string;
+        trace_id: string | null;
+        anomaly_type: import("../enums.js").IncidentType;
+        resolution_status: string | null;
+        resolved_by: string | null;
+        resolved_at: string | null;
+        escalation_chain: Record<string, unknown> | null;
+        review_priority: number;
+    }[];
+    listProperty: "data";
+    rowCase: "snake";
+    meta: {
+        limit: number;
+        audit: {
+            budget: number;
+            matched: number;
+            withheld: number;
+            overBudget: boolean;
+        };
+        total: number;
+        page: number;
+    };
+}, {
+    data: {
+        description: string;
+        severity: "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+        workspace_id: string;
+        session_id: string | null;
+        created_at: string;
+        incident_id: string;
+        trace_id: string | null;
+        anomaly_type: import("../enums.js").IncidentType;
+        resolution_status: string | null;
+        resolved_by: string | null;
+        resolved_at: string | null;
+        escalation_chain: Record<string, unknown> | null;
+        review_priority: number;
+    }[];
+    listProperty: "data";
+    rowCase: "snake";
+    meta: {
+        limit: number;
+        audit: {
+            budget: number;
+            matched: number;
+            withheld: number;
+            overBudget: boolean;
+        };
+        total: number;
+        page: number;
+    };
+}>]>;
+export type IncidentListResponse = z.infer<typeof IncidentListResponse>;
+/**
+ * One trace in the list (`traceQueryService.ts` `listTraces`). `breakGlass` and
+ * `breakGlassRequestId` are always sent; they are optional here because
+ * `TraceSummary` declares them so.
+ */
+export declare const TraceSummaryResponse: z.ZodObject<{
+    traceId: z.ZodString;
+    timestamp: z.ZodString;
+    requestedModel: z.ZodString;
+    actualModelRouted: z.ZodString;
+    enforcementAction: z.ZodString;
+    complianceScore: z.ZodNumber;
+    actualCostUsd: z.ZodNumber;
+    anomalyDetected: z.ZodNullable<z.ZodString>;
+    breakGlass: z.ZodOptional<z.ZodBoolean>;
+    breakGlassRequestId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    requestedModel: string;
+    actualModelRouted: string;
+    actualCostUsd: number;
+    complianceScore: number;
+    enforcementAction: string;
+    anomalyDetected: string | null;
+    traceId: string;
+    timestamp: string;
+    breakGlass?: boolean | undefined;
+    breakGlassRequestId?: string | null | undefined;
+}, {
+    requestedModel: string;
+    actualModelRouted: string;
+    actualCostUsd: number;
+    complianceScore: number;
+    enforcementAction: string;
+    anomalyDetected: string | null;
+    traceId: string;
+    timestamp: string;
+    breakGlass?: boolean | undefined;
+    breakGlassRequestId?: string | null | undefined;
+}>;
+export type TraceSummaryResponse = z.infer<typeof TraceSummaryResponse>;
+/**
+ * `GET /api/v1/traces`. A page of 20 or more rows is TOON-encoded: the rows are
+ * one string under `data`, and `listProperty: 'traces'` names where a decoder
+ * puts them.
+ */
+export declare const TraceListResponse: z.ZodUnion<[z.ZodObject<{
+    listProperty: z.ZodLiteral<"traces">;
+    rowCase: z.ZodLiteral<"camel">;
+} & {
+    format: z.ZodLiteral<"toon">;
+    data: z.ZodString;
+    total: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    data: string;
+    listProperty: "traces";
+    rowCase: "camel";
+    total: number;
+    format: "toon";
+}, {
+    data: string;
+    listProperty: "traces";
+    rowCase: "camel";
+    total: number;
+    format: "toon";
+}>, z.ZodObject<{
+    listProperty: z.ZodLiteral<"traces">;
+    rowCase: z.ZodLiteral<"camel">;
+} & {
+    traces: z.ZodArray<z.ZodObject<{
+        traceId: z.ZodString;
+        timestamp: z.ZodString;
+        requestedModel: z.ZodString;
+        actualModelRouted: z.ZodString;
+        enforcementAction: z.ZodString;
+        complianceScore: z.ZodNumber;
+        actualCostUsd: z.ZodNumber;
+        anomalyDetected: z.ZodNullable<z.ZodString>;
+        breakGlass: z.ZodOptional<z.ZodBoolean>;
+        breakGlassRequestId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        requestedModel: string;
+        actualModelRouted: string;
+        actualCostUsd: number;
+        complianceScore: number;
+        enforcementAction: string;
+        anomalyDetected: string | null;
+        traceId: string;
+        timestamp: string;
+        breakGlass?: boolean | undefined;
+        breakGlassRequestId?: string | null | undefined;
+    }, {
+        requestedModel: string;
+        actualModelRouted: string;
+        actualCostUsd: number;
+        complianceScore: number;
+        enforcementAction: string;
+        anomalyDetected: string | null;
+        traceId: string;
+        timestamp: string;
+        breakGlass?: boolean | undefined;
+        breakGlassRequestId?: string | null | undefined;
+    }>, "many">;
+    total: z.ZodNumber;
+    limit: z.ZodNumber;
+    offset: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    traces: {
+        requestedModel: string;
+        actualModelRouted: string;
+        actualCostUsd: number;
+        complianceScore: number;
+        enforcementAction: string;
+        anomalyDetected: string | null;
+        traceId: string;
+        timestamp: string;
+        breakGlass?: boolean | undefined;
+        breakGlassRequestId?: string | null | undefined;
+    }[];
+    limit: number;
+    offset: number;
+    listProperty: "traces";
+    rowCase: "camel";
+    total: number;
+}, {
+    traces: {
+        requestedModel: string;
+        actualModelRouted: string;
+        actualCostUsd: number;
+        complianceScore: number;
+        enforcementAction: string;
+        anomalyDetected: string | null;
+        traceId: string;
+        timestamp: string;
+        breakGlass?: boolean | undefined;
+        breakGlassRequestId?: string | null | undefined;
+    }[];
+    limit: number;
+    offset: number;
+    listProperty: "traces";
+    rowCase: "camel";
+    total: number;
+}>]>;
+export type TraceListResponse = z.infer<typeof TraceListResponse>;
+/**
+ * `GET /api/v1/traces/:id` (`traceQueryService.ts` `getTraceById`). Every field
+ * is always sent; the ones marked optional are optional because `TraceDetail`
+ * declares them so.
+ */
+export declare const TraceDetailResponse: z.ZodObject<{
+    traceId: z.ZodString;
+    sessionId: z.ZodString;
+    requestId: z.ZodString;
+    timestamp: z.ZodString;
+    sopEffectiveDate: z.ZodString;
+    requestedModel: z.ZodString;
+    actualModelRouted: z.ZodString;
+    routingTier: z.ZodString;
+    complexityScore: z.ZodNumber;
+    rawInputTokens: z.ZodNumber;
+    compressedInputTokens: z.ZodNumber;
+    outputTokens: z.ZodNumber;
+    rawCostUsd: z.ZodNumber;
+    actualCostUsd: z.ZodNumber;
+    savingsUsd: z.ZodNumber;
+    tokenUtility: z.ZodNullable<z.ZodString>;
+    tokenUtilityClassifiedBy: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    tokenUtilityScore: z.ZodNullable<z.ZodNumber>;
+    complianceScore: z.ZodNumber;
+    enforcementAction: z.ZodString;
+    anomalyDetected: z.ZodNullable<z.ZodString>;
+    anomalyConfidenceScore: z.ZodNullable<z.ZodNumber>;
+    taxonomyMetadata: z.ZodUnknown;
+    rootCauseAttribution: z.ZodUnknown;
+    correctivePromptCard: z.ZodUnknown;
+    reasoningTokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    cacheReadInputTokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    cacheCreationInputTokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    toolCallMetrics: z.ZodOptional<z.ZodUnknown>;
+    changeManifest: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        tool: z.ZodString;
+        op: z.ZodEnum<["write", "edit", "delete", "move", "execute", "read", "fetch", "unknown"]>;
+        target: z.ZodString;
+        target_kind: z.ZodEnum<["path", "url", "command", "opaque"]>;
+        risk: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        bytes: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        tool: string;
+        target: string;
+        op: "unknown" | "read" | "write" | "edit" | "delete" | "move" | "execute" | "fetch";
+        target_kind: "path" | "url" | "command" | "opaque";
+        risk?: string[] | undefined;
+        bytes?: number | undefined;
+    }, {
+        tool: string;
+        target: string;
+        op: "unknown" | "read" | "write" | "edit" | "delete" | "move" | "execute" | "fetch";
+        target_kind: "path" | "url" | "command" | "opaque";
+        risk?: string[] | undefined;
+        bytes?: number | undefined;
+    }>, "many">>>;
+    responseIntegrity: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    qualityFault: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    routingShadowModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    upstreamAttempts: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        model: z.ZodString;
+        provider: z.ZodString;
+        outcome: z.ZodString;
+        status: z.ZodOptional<z.ZodNumber>;
+        latencyMs: z.ZodNumber;
+        backoffMs: z.ZodOptional<z.ZodNumber>;
+        serverDelay: z.ZodOptional<z.ZodBoolean>;
+        stopped: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        model: string;
+        provider: string;
+        latencyMs: number;
+        outcome: string;
+        status?: number | undefined;
+        stopped?: string | undefined;
+        backoffMs?: number | undefined;
+        serverDelay?: boolean | undefined;
+    }, {
+        model: string;
+        provider: string;
+        latencyMs: number;
+        outcome: string;
+        status?: number | undefined;
+        stopped?: string | undefined;
+        backoffMs?: number | undefined;
+        serverDelay?: boolean | undefined;
+    }>, "many">>>;
+    upstreamFallback: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        fromModel: z.ZodString;
+        toModel: z.ZodString;
+        toProvider: z.ZodString;
+        cacheAffinityBroken: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        fromModel: string;
+        toModel: string;
+        toProvider: string;
+        cacheAffinityBroken?: boolean | undefined;
+    }, {
+        fromModel: string;
+        toModel: string;
+        toProvider: string;
+        cacheAffinityBroken?: boolean | undefined;
+    }>>>;
+    breakGlass: z.ZodOptional<z.ZodBoolean>;
+    breakGlassRequestId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    steps: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        logId: z.ZodString;
+        toolName: z.ZodString;
+        toolArguments: z.ZodUnknown;
+        riskCategory: z.ZodNullable<z.ZodString>;
+        verdict: z.ZodString;
+        confidence: z.ZodNumber;
+        reason: z.ZodString;
+        loopDetected: z.ZodBoolean;
+        latencyMs: z.ZodNullable<z.ZodNumber>;
+        timestamp: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        confidence: number;
+        reason: string;
+        verdict: string;
+        toolName: string;
+        riskCategory: string | null;
+        timestamp: string;
+        logId: string;
+        loopDetected: boolean;
+        latencyMs: number | null;
+        toolArguments?: unknown;
+    }, {
+        confidence: number;
+        reason: string;
+        verdict: string;
+        toolName: string;
+        riskCategory: string | null;
+        timestamp: string;
+        logId: string;
+        loopDetected: boolean;
+        latencyMs: number | null;
+        toolArguments?: unknown;
+    }>, "many">>;
+    findings: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        findingId: z.ZodString;
+        detectorId: z.ZodString;
+        anomalyKind: z.ZodString;
+        severity: z.ZodString;
+        disposition: z.ZodString;
+        confidence: z.ZodNumber;
+        reason: z.ZodString;
+        shadowed: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        confidence: number;
+        reason: string;
+        severity: string;
+        findingId: string;
+        detectorId: string;
+        anomalyKind: string;
+        disposition: string;
+        shadowed: boolean;
+    }, {
+        confidence: number;
+        reason: string;
+        severity: string;
+        findingId: string;
+        detectorId: string;
+        anomalyKind: string;
+        disposition: string;
+        shadowed: boolean;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    requestId: string;
+    sopEffectiveDate: string;
+    requestedModel: string;
+    actualModelRouted: string;
+    routingTier: string;
+    complexityScore: number;
+    rawInputTokens: number;
+    compressedInputTokens: number;
+    outputTokens: number;
+    rawCostUsd: number;
+    actualCostUsd: number;
+    tokenUtility: string | null;
+    tokenUtilityScore: number | null;
+    complianceScore: number;
+    enforcementAction: string;
+    anomalyDetected: string | null;
+    anomalyConfidenceScore: number | null;
+    traceId: string;
+    timestamp: string;
+    savingsUsd: number;
+    taxonomyMetadata?: unknown;
+    rootCauseAttribution?: unknown;
+    correctivePromptCard?: unknown;
+    findings?: {
+        confidence: number;
+        reason: string;
+        severity: string;
+        findingId: string;
+        detectorId: string;
+        anomalyKind: string;
+        disposition: string;
+        shadowed: boolean;
+    }[] | undefined;
+    breakGlass?: boolean | undefined;
+    breakGlassRequestId?: string | null | undefined;
+    tokenUtilityClassifiedBy?: string | null | undefined;
+    reasoningTokens?: number | null | undefined;
+    cacheReadInputTokens?: number | null | undefined;
+    cacheCreationInputTokens?: number | null | undefined;
+    toolCallMetrics?: unknown;
+    changeManifest?: {
+        tool: string;
+        target: string;
+        op: "unknown" | "read" | "write" | "edit" | "delete" | "move" | "execute" | "fetch";
+        target_kind: "path" | "url" | "command" | "opaque";
+        risk?: string[] | undefined;
+        bytes?: number | undefined;
+    }[] | null | undefined;
+    responseIntegrity?: number | null | undefined;
+    qualityFault?: string | null | undefined;
+    routingShadowModel?: string | null | undefined;
+    upstreamAttempts?: {
+        model: string;
+        provider: string;
+        latencyMs: number;
+        outcome: string;
+        status?: number | undefined;
+        stopped?: string | undefined;
+        backoffMs?: number | undefined;
+        serverDelay?: boolean | undefined;
+    }[] | null | undefined;
+    upstreamFallback?: {
+        fromModel: string;
+        toModel: string;
+        toProvider: string;
+        cacheAffinityBroken?: boolean | undefined;
+    } | null | undefined;
+    steps?: {
+        confidence: number;
+        reason: string;
+        verdict: string;
+        toolName: string;
+        riskCategory: string | null;
+        timestamp: string;
+        logId: string;
+        loopDetected: boolean;
+        latencyMs: number | null;
+        toolArguments?: unknown;
+    }[] | undefined;
+}, {
+    sessionId: string;
+    requestId: string;
+    sopEffectiveDate: string;
+    requestedModel: string;
+    actualModelRouted: string;
+    routingTier: string;
+    complexityScore: number;
+    rawInputTokens: number;
+    compressedInputTokens: number;
+    outputTokens: number;
+    rawCostUsd: number;
+    actualCostUsd: number;
+    tokenUtility: string | null;
+    tokenUtilityScore: number | null;
+    complianceScore: number;
+    enforcementAction: string;
+    anomalyDetected: string | null;
+    anomalyConfidenceScore: number | null;
+    traceId: string;
+    timestamp: string;
+    savingsUsd: number;
+    taxonomyMetadata?: unknown;
+    rootCauseAttribution?: unknown;
+    correctivePromptCard?: unknown;
+    findings?: {
+        confidence: number;
+        reason: string;
+        severity: string;
+        findingId: string;
+        detectorId: string;
+        anomalyKind: string;
+        disposition: string;
+        shadowed: boolean;
+    }[] | undefined;
+    breakGlass?: boolean | undefined;
+    breakGlassRequestId?: string | null | undefined;
+    tokenUtilityClassifiedBy?: string | null | undefined;
+    reasoningTokens?: number | null | undefined;
+    cacheReadInputTokens?: number | null | undefined;
+    cacheCreationInputTokens?: number | null | undefined;
+    toolCallMetrics?: unknown;
+    changeManifest?: {
+        tool: string;
+        target: string;
+        op: "unknown" | "read" | "write" | "edit" | "delete" | "move" | "execute" | "fetch";
+        target_kind: "path" | "url" | "command" | "opaque";
+        risk?: string[] | undefined;
+        bytes?: number | undefined;
+    }[] | null | undefined;
+    responseIntegrity?: number | null | undefined;
+    qualityFault?: string | null | undefined;
+    routingShadowModel?: string | null | undefined;
+    upstreamAttempts?: {
+        model: string;
+        provider: string;
+        latencyMs: number;
+        outcome: string;
+        status?: number | undefined;
+        stopped?: string | undefined;
+        backoffMs?: number | undefined;
+        serverDelay?: boolean | undefined;
+    }[] | null | undefined;
+    upstreamFallback?: {
+        fromModel: string;
+        toModel: string;
+        toProvider: string;
+        cacheAffinityBroken?: boolean | undefined;
+    } | null | undefined;
+    steps?: {
+        confidence: number;
+        reason: string;
+        verdict: string;
+        toolName: string;
+        riskCategory: string | null;
+        timestamp: string;
+        logId: string;
+        loopDetected: boolean;
+        latencyMs: number | null;
+        toolArguments?: unknown;
+    }[] | undefined;
+}>;
+export type TraceDetailResponse = z.infer<typeof TraceDetailResponse>;
+/** One detector finding (`detector_findings`), snake_cased by the list route. */
+export declare const FindingResponse: z.ZodObject<{
+    finding_id: z.ZodString;
+    trace_id: z.ZodString;
+    session_id: z.ZodNullable<z.ZodString>;
+    loop_run_id: z.ZodNullable<z.ZodString>;
+    detector_id: z.ZodString;
+    anomaly_kind: z.ZodString;
+    severity: z.ZodString;
+    disposition: z.ZodString;
+    confidence: z.ZodNumber;
+    reason: z.ZodString;
+    harness: z.ZodNullable<z.ZodString>;
+    shadowed: z.ZodBoolean;
+    suppressed: z.ZodBoolean;
+    outcome: z.ZodNullable<z.ZodEnum<["TRUE_POSITIVE", "FALSE_POSITIVE"]>>;
+    outcome_by: z.ZodNullable<z.ZodString>;
+    outcome_at: z.ZodNullable<z.ZodString>;
+    outcome_note: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    confidence: number;
+    reason: string;
+    harness: string | null;
+    severity: string;
+    session_id: string | null;
+    created_at: string;
+    trace_id: string;
+    disposition: string;
+    shadowed: boolean;
+    outcome: "FALSE_POSITIVE" | "TRUE_POSITIVE" | null;
+    finding_id: string;
+    loop_run_id: string | null;
+    detector_id: string;
+    anomaly_kind: string;
+    suppressed: boolean;
+    outcome_by: string | null;
+    outcome_at: string | null;
+    outcome_note: string | null;
+}, {
+    confidence: number;
+    reason: string;
+    harness: string | null;
+    severity: string;
+    session_id: string | null;
+    created_at: string;
+    trace_id: string;
+    disposition: string;
+    shadowed: boolean;
+    outcome: "FALSE_POSITIVE" | "TRUE_POSITIVE" | null;
+    finding_id: string;
+    loop_run_id: string | null;
+    detector_id: string;
+    anomaly_kind: string;
+    suppressed: boolean;
+    outcome_by: string | null;
+    outcome_at: string | null;
+    outcome_note: string | null;
+}>;
+export type FindingResponse = z.infer<typeof FindingResponse>;
+/** `GET /api/v1/findings`. */
+export declare const FindingListResponse: z.ZodObject<{
+    findings: z.ZodArray<z.ZodObject<{
+        finding_id: z.ZodString;
+        trace_id: z.ZodString;
+        session_id: z.ZodNullable<z.ZodString>;
+        loop_run_id: z.ZodNullable<z.ZodString>;
+        detector_id: z.ZodString;
+        anomaly_kind: z.ZodString;
+        severity: z.ZodString;
+        disposition: z.ZodString;
+        confidence: z.ZodNumber;
+        reason: z.ZodString;
+        harness: z.ZodNullable<z.ZodString>;
+        shadowed: z.ZodBoolean;
+        suppressed: z.ZodBoolean;
+        outcome: z.ZodNullable<z.ZodEnum<["TRUE_POSITIVE", "FALSE_POSITIVE"]>>;
+        outcome_by: z.ZodNullable<z.ZodString>;
+        outcome_at: z.ZodNullable<z.ZodString>;
+        outcome_note: z.ZodNullable<z.ZodString>;
+        created_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        confidence: number;
+        reason: string;
+        harness: string | null;
+        severity: string;
+        session_id: string | null;
+        created_at: string;
+        trace_id: string;
+        disposition: string;
+        shadowed: boolean;
+        outcome: "FALSE_POSITIVE" | "TRUE_POSITIVE" | null;
+        finding_id: string;
+        loop_run_id: string | null;
+        detector_id: string;
+        anomaly_kind: string;
+        suppressed: boolean;
+        outcome_by: string | null;
+        outcome_at: string | null;
+        outcome_note: string | null;
+    }, {
+        confidence: number;
+        reason: string;
+        harness: string | null;
+        severity: string;
+        session_id: string | null;
+        created_at: string;
+        trace_id: string;
+        disposition: string;
+        shadowed: boolean;
+        outcome: "FALSE_POSITIVE" | "TRUE_POSITIVE" | null;
+        finding_id: string;
+        loop_run_id: string | null;
+        detector_id: string;
+        anomaly_kind: string;
+        suppressed: boolean;
+        outcome_by: string | null;
+        outcome_at: string | null;
+        outcome_note: string | null;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    findings: {
+        confidence: number;
+        reason: string;
+        harness: string | null;
+        severity: string;
+        session_id: string | null;
+        created_at: string;
+        trace_id: string;
+        disposition: string;
+        shadowed: boolean;
+        outcome: "FALSE_POSITIVE" | "TRUE_POSITIVE" | null;
+        finding_id: string;
+        loop_run_id: string | null;
+        detector_id: string;
+        anomaly_kind: string;
+        suppressed: boolean;
+        outcome_by: string | null;
+        outcome_at: string | null;
+        outcome_note: string | null;
+    }[];
+}, {
+    findings: {
+        confidence: number;
+        reason: string;
+        harness: string | null;
+        severity: string;
+        session_id: string | null;
+        created_at: string;
+        trace_id: string;
+        disposition: string;
+        shadowed: boolean;
+        outcome: "FALSE_POSITIVE" | "TRUE_POSITIVE" | null;
+        finding_id: string;
+        loop_run_id: string | null;
+        detector_id: string;
+        anomaly_kind: string;
+        suppressed: boolean;
+        outcome_by: string | null;
+        outcome_at: string | null;
+        outcome_note: string | null;
+    }[];
+}>;
+export type FindingListResponse = z.infer<typeof FindingListResponse>;
+/** `POST /api/v1/findings/:findingId/adjudicate`. */
+export declare const FindingAdjudicationResponse: z.ZodObject<{
+    finding_id: z.ZodString;
+    outcome: z.ZodEnum<["TRUE_POSITIVE", "FALSE_POSITIVE"]>;
+}, "strip", z.ZodTypeAny, {
+    outcome: "FALSE_POSITIVE" | "TRUE_POSITIVE";
+    finding_id: string;
+}, {
+    outcome: "FALSE_POSITIVE" | "TRUE_POSITIVE";
+    finding_id: string;
+}>;
+export type FindingAdjudicationResponse = z.infer<typeof FindingAdjudicationResponse>;
+/** `GET /api/v1/findings/stats`: precision per detector, over adjudicated findings. */
+export declare const FindingStatsResponse: z.ZodObject<{
+    detectors: z.ZodArray<z.ZodObject<{
+        detector_id: z.ZodString;
+        anomaly_kind: z.ZodString;
+        shadowed: z.ZodBoolean;
+        total_findings: z.ZodNumber;
+        adjudicated: z.ZodNumber;
+        false_positives: z.ZodNumber;
+        false_positive_rate: z.ZodNullable<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        adjudicated: number;
+        shadowed: boolean;
+        detector_id: string;
+        anomaly_kind: string;
+        total_findings: number;
+        false_positives: number;
+        false_positive_rate: number | null;
+    }, {
+        adjudicated: number;
+        shadowed: boolean;
+        detector_id: string;
+        anomaly_kind: string;
+        total_findings: number;
+        false_positives: number;
+        false_positive_rate: number | null;
+    }>, "many">;
+    caveats: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    detectors: {
+        adjudicated: number;
+        shadowed: boolean;
+        detector_id: string;
+        anomaly_kind: string;
+        total_findings: number;
+        false_positives: number;
+        false_positive_rate: number | null;
+    }[];
+    caveats: string[];
+}, {
+    detectors: {
+        adjudicated: number;
+        shadowed: boolean;
+        detector_id: string;
+        anomaly_kind: string;
+        total_findings: number;
+        false_positives: number;
+        false_positive_rate: number | null;
+    }[];
+    caveats: string[];
+}>;
+export type FindingStatsResponse = z.infer<typeof FindingStatsResponse>;
+/** `GET /api/v1/findings/response-echo/report` (`responseInjectionCorpusService.ts`). */
+export declare const ResponseEchoReportResponse: z.ZodObject<{
+    window: z.ZodObject<{
+        since: z.ZodString;
+        until: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        since: string;
+        until: string;
+    }, {
+        since: string;
+        until: string;
+    }>;
+    tracesIngested: z.ZodNumber;
+    refusal: z.ZodNullable<z.ZodString>;
+    patterns: z.ZodArray<z.ZodObject<{
+        pattern: z.ZodEnum<["override-instructions", "reveal-system-prompt", "role-reassignment", "guardrail-bypass", "instruction-boundary-forgery"]>;
+        findings: z.ZodNumber;
+        adjudicated: z.ZodNumber;
+        truePositives: z.ZodNumber;
+        falsePositives: z.ZodNumber;
+        falsePositiveRate: z.ZodNullable<z.ZodNumber>;
+        refusal: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        findings: number;
+        pattern: "override-instructions" | "reveal-system-prompt" | "role-reassignment" | "guardrail-bypass" | "instruction-boundary-forgery";
+        adjudicated: number;
+        falsePositives: number;
+        falsePositiveRate: number | null;
+        refusal: string | null;
+        truePositives: number;
+    }, {
+        findings: number;
+        pattern: "override-instructions" | "reveal-system-prompt" | "role-reassignment" | "guardrail-bypass" | "instruction-boundary-forgery";
+        adjudicated: number;
+        falsePositives: number;
+        falsePositiveRate: number | null;
+        refusal: string | null;
+        truePositives: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    window: {
+        since: string;
+        until: string;
+    };
+    tracesIngested: number;
+    refusal: string | null;
+    patterns: {
+        findings: number;
+        pattern: "override-instructions" | "reveal-system-prompt" | "role-reassignment" | "guardrail-bypass" | "instruction-boundary-forgery";
+        adjudicated: number;
+        falsePositives: number;
+        falsePositiveRate: number | null;
+        refusal: string | null;
+        truePositives: number;
+    }[];
+}, {
+    window: {
+        since: string;
+        until: string;
+    };
+    tracesIngested: number;
+    refusal: string | null;
+    patterns: {
+        findings: number;
+        pattern: "override-instructions" | "reveal-system-prompt" | "role-reassignment" | "guardrail-bypass" | "instruction-boundary-forgery";
+        adjudicated: number;
+        falsePositives: number;
+        falsePositiveRate: number | null;
+        refusal: string | null;
+        truePositives: number;
+    }[];
+}>;
+export type ResponseEchoReportResponse = z.infer<typeof ResponseEchoReportResponse>;
+/** A sealed Merkle root as `GET /api/v1/integrity/roots` selects it (raw SQL, so snake_case and Postgres timestamp text). */
+export declare const IntegrityRootSummaryResponse: z.ZodObject<{
+    root_id: z.ZodString;
+    loop_run_id: z.ZodNullable<z.ZodString>;
+    leaf_schema_version: z.ZodNumber;
+    merkle_root: z.ZodString;
+    leaf_count: z.ZodNumber;
+    first_trace_at: z.ZodString;
+    last_trace_at: z.ZodString;
+    signature_alg: z.ZodNullable<z.ZodString>;
+    signing_key_id: z.ZodNullable<z.ZodString>;
+    sealed_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    loop_run_id: string | null;
+    root_id: string;
+    leaf_schema_version: number;
+    merkle_root: string;
+    leaf_count: number;
+    first_trace_at: string;
+    last_trace_at: string;
+    signature_alg: string | null;
+    signing_key_id: string | null;
+    sealed_at: string;
+}, {
+    loop_run_id: string | null;
+    root_id: string;
+    leaf_schema_version: number;
+    merkle_root: string;
+    leaf_count: number;
+    first_trace_at: string;
+    last_trace_at: string;
+    signature_alg: string | null;
+    signing_key_id: string | null;
+    sealed_at: string;
+}>;
+export type IntegrityRootSummaryResponse = z.infer<typeof IntegrityRootSummaryResponse>;
+/** `GET /api/v1/integrity/roots`: the workspace's sealed roots, newest first (at most 50). */
+export declare const IntegrityRootListResponse: z.ZodObject<{
+    listProperty: z.ZodLiteral<"data">;
+    rowCase: z.ZodLiteral<"snake">;
+} & {
+    ok: z.ZodLiteral<true>;
+    data: z.ZodArray<z.ZodObject<{
+        root_id: z.ZodString;
+        loop_run_id: z.ZodNullable<z.ZodString>;
+        leaf_schema_version: z.ZodNumber;
+        merkle_root: z.ZodString;
+        leaf_count: z.ZodNumber;
+        first_trace_at: z.ZodString;
+        last_trace_at: z.ZodString;
+        signature_alg: z.ZodNullable<z.ZodString>;
+        signing_key_id: z.ZodNullable<z.ZodString>;
+        sealed_at: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        loop_run_id: string | null;
+        root_id: string;
+        leaf_schema_version: number;
+        merkle_root: string;
+        leaf_count: number;
+        first_trace_at: string;
+        last_trace_at: string;
+        signature_alg: string | null;
+        signing_key_id: string | null;
+        sealed_at: string;
+    }, {
+        loop_run_id: string | null;
+        root_id: string;
+        leaf_schema_version: number;
+        merkle_root: string;
+        leaf_count: number;
+        first_trace_at: string;
+        last_trace_at: string;
+        signature_alg: string | null;
+        signing_key_id: string | null;
+        sealed_at: string;
+    }>, "many">;
+    leafSchemaVersion: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    ok: true;
+    data: {
+        loop_run_id: string | null;
+        root_id: string;
+        leaf_schema_version: number;
+        merkle_root: string;
+        leaf_count: number;
+        first_trace_at: string;
+        last_trace_at: string;
+        signature_alg: string | null;
+        signing_key_id: string | null;
+        sealed_at: string;
+    }[];
+    listProperty: "data";
+    rowCase: "snake";
+    leafSchemaVersion: number;
+}, {
+    ok: true;
+    data: {
+        loop_run_id: string | null;
+        root_id: string;
+        leaf_schema_version: number;
+        merkle_root: string;
+        leaf_count: number;
+        first_trace_at: string;
+        last_trace_at: string;
+        signature_alg: string | null;
+        signing_key_id: string | null;
+        sealed_at: string;
+    }[];
+    listProperty: "data";
+    rowCase: "snake";
+    leafSchemaVersion: number;
+}>;
+export type IntegrityRootListResponse = z.infer<typeof IntegrityRootListResponse>;
+/** Every column of a `trace_merkle_roots` row (`SELECT *`). */
+export declare const IntegrityRootRowResponse: z.ZodObject<{
+    root_id: z.ZodString;
+    loop_run_id: z.ZodNullable<z.ZodString>;
+    leaf_schema_version: z.ZodNumber;
+    merkle_root: z.ZodString;
+    leaf_count: z.ZodNumber;
+    first_trace_at: z.ZodString;
+    last_trace_at: z.ZodString;
+    signature_alg: z.ZodNullable<z.ZodString>;
+    signing_key_id: z.ZodNullable<z.ZodString>;
+    sealed_at: z.ZodString;
+} & {
+    workspace_id: z.ZodString;
+    sample_preimage: z.ZodString;
+    signature: z.ZodNullable<z.ZodString>;
+    previous_root: z.ZodNullable<z.ZodString>;
+    signing_preimage_version: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    workspace_id: string;
+    loop_run_id: string | null;
+    root_id: string;
+    leaf_schema_version: number;
+    merkle_root: string;
+    leaf_count: number;
+    first_trace_at: string;
+    last_trace_at: string;
+    signature_alg: string | null;
+    signing_key_id: string | null;
+    sealed_at: string;
+    sample_preimage: string;
+    signature: string | null;
+    previous_root: string | null;
+    signing_preimage_version: number;
+}, {
+    workspace_id: string;
+    loop_run_id: string | null;
+    root_id: string;
+    leaf_schema_version: number;
+    merkle_root: string;
+    leaf_count: number;
+    first_trace_at: string;
+    last_trace_at: string;
+    signature_alg: string | null;
+    signing_key_id: string | null;
+    sealed_at: string;
+    sample_preimage: string;
+    signature: string | null;
+    previous_root: string | null;
+    signing_preimage_version: number;
+}>;
+export type IntegrityRootRowResponse = z.infer<typeof IntegrityRootRowResponse>;
+/** One leaf of a sealed root. */
+export declare const IntegrityLeafResponse: z.ZodObject<{
+    trace_id: z.ZodString;
+    leaf_index: z.ZodNumber;
+    leaf_hash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    trace_id: string;
+    leaf_index: number;
+    leaf_hash: string;
+}, {
+    trace_id: string;
+    leaf_index: number;
+    leaf_hash: string;
+}>;
+export type IntegrityLeafResponse = z.infer<typeof IntegrityLeafResponse>;
+/** `GET /api/v1/integrity/roots/:rootId`: the root and the leaves it covers, in order. */
+export declare const IntegrityRootDetailResponse: z.ZodObject<{
+    listProperty: z.ZodLiteral<"leaves">;
+    rowCase: z.ZodLiteral<"snake">;
+} & {
+    ok: z.ZodLiteral<true>;
+    root: z.ZodObject<{
+        root_id: z.ZodString;
+        loop_run_id: z.ZodNullable<z.ZodString>;
+        leaf_schema_version: z.ZodNumber;
+        merkle_root: z.ZodString;
+        leaf_count: z.ZodNumber;
+        first_trace_at: z.ZodString;
+        last_trace_at: z.ZodString;
+        signature_alg: z.ZodNullable<z.ZodString>;
+        signing_key_id: z.ZodNullable<z.ZodString>;
+        sealed_at: z.ZodString;
+    } & {
+        workspace_id: z.ZodString;
+        sample_preimage: z.ZodString;
+        signature: z.ZodNullable<z.ZodString>;
+        previous_root: z.ZodNullable<z.ZodString>;
+        signing_preimage_version: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        workspace_id: string;
+        loop_run_id: string | null;
+        root_id: string;
+        leaf_schema_version: number;
+        merkle_root: string;
+        leaf_count: number;
+        first_trace_at: string;
+        last_trace_at: string;
+        signature_alg: string | null;
+        signing_key_id: string | null;
+        sealed_at: string;
+        sample_preimage: string;
+        signature: string | null;
+        previous_root: string | null;
+        signing_preimage_version: number;
+    }, {
+        workspace_id: string;
+        loop_run_id: string | null;
+        root_id: string;
+        leaf_schema_version: number;
+        merkle_root: string;
+        leaf_count: number;
+        first_trace_at: string;
+        last_trace_at: string;
+        signature_alg: string | null;
+        signing_key_id: string | null;
+        sealed_at: string;
+        sample_preimage: string;
+        signature: string | null;
+        previous_root: string | null;
+        signing_preimage_version: number;
+    }>;
+    leaves: z.ZodArray<z.ZodObject<{
+        trace_id: z.ZodString;
+        leaf_index: z.ZodNumber;
+        leaf_hash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        trace_id: string;
+        leaf_index: number;
+        leaf_hash: string;
+    }, {
+        trace_id: string;
+        leaf_index: number;
+        leaf_hash: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    ok: true;
+    listProperty: "leaves";
+    rowCase: "snake";
+    leaves: {
+        trace_id: string;
+        leaf_index: number;
+        leaf_hash: string;
+    }[];
+    root: {
+        workspace_id: string;
+        loop_run_id: string | null;
+        root_id: string;
+        leaf_schema_version: number;
+        merkle_root: string;
+        leaf_count: number;
+        first_trace_at: string;
+        last_trace_at: string;
+        signature_alg: string | null;
+        signing_key_id: string | null;
+        sealed_at: string;
+        sample_preimage: string;
+        signature: string | null;
+        previous_root: string | null;
+        signing_preimage_version: number;
+    };
+}, {
+    ok: true;
+    listProperty: "leaves";
+    rowCase: "snake";
+    leaves: {
+        trace_id: string;
+        leaf_index: number;
+        leaf_hash: string;
+    }[];
+    root: {
+        workspace_id: string;
+        loop_run_id: string | null;
+        root_id: string;
+        leaf_schema_version: number;
+        merkle_root: string;
+        leaf_count: number;
+        first_trace_at: string;
+        last_trace_at: string;
+        signature_alg: string | null;
+        signing_key_id: string | null;
+        sealed_at: string;
+        sample_preimage: string;
+        signature: string | null;
+        previous_root: string | null;
+        signing_preimage_version: number;
+    };
+}>;
+export type IntegrityRootDetailResponse = z.infer<typeof IntegrityRootDetailResponse>;
+/** `POST /api/v1/integrity/roots/:rootId/recompute` (`traceRootSweep.ts` `recomputeRoot`). A mismatch is an answer, so every verdict is a 200. */
+export declare const IntegrityRecomputeResponse: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    verdict: z.ZodEnum<["match", "mismatch", "missing_traces"]>;
+    storedRoot: z.ZodString;
+    recomputedRoot: z.ZodNullable<z.ZodString>;
+    changedTraceIds: z.ZodArray<z.ZodString, "many">;
+    missingTraceIds: z.ZodArray<z.ZodString, "many">;
+    retentionExpired: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    ok: true;
+    verdict: "match" | "mismatch" | "missing_traces";
+    storedRoot: string;
+    recomputedRoot: string | null;
+    changedTraceIds: string[];
+    missingTraceIds: string[];
+    retentionExpired: boolean;
+}, {
+    ok: true;
+    verdict: "match" | "mismatch" | "missing_traces";
+    storedRoot: string;
+    recomputedRoot: string | null;
+    changedTraceIds: string[];
+    missingTraceIds: string[];
+    retentionExpired: boolean;
+}>;
+export type IntegrityRecomputeResponse = z.infer<typeof IntegrityRecomputeResponse>;
+/**
+ * `GET /api/v1/integrity/chain` (`traceRootSweep.ts` `verifyRootChain`). A
+ * break answers 409 with this same body (`ok: false`, `breaks` filled); a 200
+ * never carries a break.
+ */
+export declare const IntegrityChainResponse: z.ZodObject<{
+    ok: z.ZodBoolean;
+    workspaceId: z.ZodString;
+    rootsWalked: z.ZodNumber;
+    rootsNotWalked: z.ZodNumber;
+    unchainedRootIds: z.ZodArray<z.ZodString, "many">;
+    breaks: z.ZodArray<z.ZodObject<{
+        rootId: z.ZodString;
+        namedPrevious: z.ZodString;
+        precedingRootId: z.ZodString;
+        precedingMerkleRoot: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        rootId: string;
+        namedPrevious: string;
+        precedingRootId: string;
+        precedingMerkleRoot: string;
+    }, {
+        rootId: string;
+        namedPrevious: string;
+        precedingRootId: string;
+        precedingMerkleRoot: string;
+    }>, "many">;
+    intact: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    workspaceId: string;
+    ok: boolean;
+    rootsWalked: number;
+    rootsNotWalked: number;
+    unchainedRootIds: string[];
+    breaks: {
+        rootId: string;
+        namedPrevious: string;
+        precedingRootId: string;
+        precedingMerkleRoot: string;
+    }[];
+    intact: boolean;
+}, {
+    workspaceId: string;
+    ok: boolean;
+    rootsWalked: number;
+    rootsNotWalked: number;
+    unchainedRootIds: string[];
+    breaks: {
+        rootId: string;
+        namedPrevious: string;
+        precedingRootId: string;
+        precedingMerkleRoot: string;
+    }[];
+    intact: boolean;
+}>;
+export type IntegrityChainResponse = z.infer<typeof IntegrityChainResponse>;
+/**
+ * `GET /api/v1/integrity/config-chain` (`harnessConfigService.ts`
+ * `verifyConfigChain`). A break or an edited body answers 409 with this same
+ * body; a 200 never carries either.
+ */
+export declare const IntegrityConfigChainResponse: z.ZodObject<{
+    ok: z.ZodBoolean;
+    workspaceId: z.ZodString;
+    harnessType: z.ZodNullable<z.ZodString>;
+    snapshotsWalked: z.ZodNumber;
+    snapshotsNotWalked: z.ZodNumber;
+    unchainedSnapshotIds: z.ZodArray<z.ZodString, "many">;
+    breaks: z.ZodArray<z.ZodObject<{
+        snapshotId: z.ZodString;
+        harnessType: z.ZodString;
+        filePath: z.ZodString;
+        namedPrevious: z.ZodString;
+        precedingSnapshotId: z.ZodString;
+        precedingContentHash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        harnessType: string;
+        filePath: string;
+        namedPrevious: string;
+        snapshotId: string;
+        precedingSnapshotId: string;
+        precedingContentHash: string;
+    }, {
+        harnessType: string;
+        filePath: string;
+        namedPrevious: string;
+        snapshotId: string;
+        precedingSnapshotId: string;
+        precedingContentHash: string;
+    }>, "many">;
+    contentMismatches: z.ZodArray<z.ZodObject<{
+        snapshotId: z.ZodString;
+        harnessType: z.ZodString;
+        filePath: z.ZodString;
+        storedHash: z.ZodString;
+        recomputedHash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        harnessType: string;
+        filePath: string;
+        snapshotId: string;
+        storedHash: string;
+        recomputedHash: string;
+    }, {
+        harnessType: string;
+        filePath: string;
+        snapshotId: string;
+        storedHash: string;
+        recomputedHash: string;
+    }>, "many">;
+    snapshotsWithoutContent: z.ZodNumber;
+    intact: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    workspaceId: string;
+    harnessType: string | null;
+    ok: boolean;
+    breaks: {
+        harnessType: string;
+        filePath: string;
+        namedPrevious: string;
+        snapshotId: string;
+        precedingSnapshotId: string;
+        precedingContentHash: string;
+    }[];
+    intact: boolean;
+    snapshotsWalked: number;
+    snapshotsNotWalked: number;
+    unchainedSnapshotIds: string[];
+    contentMismatches: {
+        harnessType: string;
+        filePath: string;
+        snapshotId: string;
+        storedHash: string;
+        recomputedHash: string;
+    }[];
+    snapshotsWithoutContent: number;
+}, {
+    workspaceId: string;
+    harnessType: string | null;
+    ok: boolean;
+    breaks: {
+        harnessType: string;
+        filePath: string;
+        namedPrevious: string;
+        snapshotId: string;
+        precedingSnapshotId: string;
+        precedingContentHash: string;
+    }[];
+    intact: boolean;
+    snapshotsWalked: number;
+    snapshotsNotWalked: number;
+    unchainedSnapshotIds: string[];
+    contentMismatches: {
+        harnessType: string;
+        filePath: string;
+        snapshotId: string;
+        storedHash: string;
+        recomputedHash: string;
+    }[];
+    snapshotsWithoutContent: number;
+}>;
+export type IntegrityConfigChainResponse = z.infer<typeof IntegrityConfigChainResponse>;
+/** `GET /api/v1/inventory/summary` (`devInventoryService.ts` `summarize`). */
+export declare const InventorySummaryResponse: z.ZodObject<{
+    data: z.ZodObject<{
+        devices: z.ZodNumber;
+        staleDevices: z.ZodNumber;
+        harnesses: z.ZodNumber;
+        governedHarnesses: z.ZodNumber;
+        governedPercent: z.ZodNullable<z.ZodNumber>;
+        ungovernedHarnesses: z.ZodNumber;
+        staleGates: z.ZodNumber;
+        unverifiedHarnesses: z.ZodNumber;
+        mcpServers: z.ZodNumber;
+        ungovernedMcpServers: z.ZodNumber;
+        skills: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        harnesses: number;
+        devices: number;
+        staleDevices: number;
+        governedHarnesses: number;
+        governedPercent: number | null;
+        ungovernedHarnesses: number;
+        staleGates: number;
+        unverifiedHarnesses: number;
+        mcpServers: number;
+        ungovernedMcpServers: number;
+        skills: number;
+    }, {
+        harnesses: number;
+        devices: number;
+        staleDevices: number;
+        governedHarnesses: number;
+        governedPercent: number | null;
+        ungovernedHarnesses: number;
+        staleGates: number;
+        unverifiedHarnesses: number;
+        mcpServers: number;
+        ungovernedMcpServers: number;
+        skills: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        harnesses: number;
+        devices: number;
+        staleDevices: number;
+        governedHarnesses: number;
+        governedPercent: number | null;
+        ungovernedHarnesses: number;
+        staleGates: number;
+        unverifiedHarnesses: number;
+        mcpServers: number;
+        ungovernedMcpServers: number;
+        skills: number;
+    };
+}, {
+    data: {
+        harnesses: number;
+        devices: number;
+        staleDevices: number;
+        governedHarnesses: number;
+        governedPercent: number | null;
+        ungovernedHarnesses: number;
+        staleGates: number;
+        unverifiedHarnesses: number;
+        mcpServers: number;
+        ungovernedMcpServers: number;
+        skills: number;
+    };
+}>;
+export type InventorySummaryResponse = z.infer<typeof InventorySummaryResponse>;
+/** One machine (`devInventoryService.ts` `InventoryDeviceRow`). */
+export declare const InventoryDeviceResponse: z.ZodObject<{
+    deviceId: z.ZodString;
+    hostname: z.ZodString;
+    platform: z.ZodString;
+    cliVersion: z.ZodNullable<z.ZodString>;
+    reportedBy: z.ZodNullable<z.ZodString>;
+    workspace: z.ZodNullable<z.ZodString>;
+    guardProbes: z.ZodNullable<z.ZodObject<{
+        total: z.ZodNumber;
+        failed: z.ZodNumber;
+        ranAt: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        failed: number;
+        total: number;
+        ranAt: number;
+    }, {
+        failed: number;
+        total: number;
+        ranAt: number;
+    }>>;
+    firstSeenAt: z.ZodString;
+    lastSeenAt: z.ZodString;
+    stale: z.ZodBoolean;
+    disconnectedAt: z.ZodNullable<z.ZodString>;
+    harnesses: z.ZodNumber;
+    ungovernedHarnesses: z.ZodNumber;
+    staleGates: z.ZodNumber;
+    mcpServers: z.ZodNumber;
+    ungovernedMcpServers: z.ZodNumber;
+    skills: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    workspace: string | null;
+    stale: boolean;
+    harnesses: number;
+    deviceId: string;
+    platform: string;
+    ungovernedHarnesses: number;
+    staleGates: number;
+    mcpServers: number;
+    ungovernedMcpServers: number;
+    skills: number;
+    hostname: string;
+    cliVersion: string | null;
+    reportedBy: string | null;
+    guardProbes: {
+        failed: number;
+        total: number;
+        ranAt: number;
+    } | null;
+    firstSeenAt: string;
+    lastSeenAt: string;
+    disconnectedAt: string | null;
+}, {
+    workspace: string | null;
+    stale: boolean;
+    harnesses: number;
+    deviceId: string;
+    platform: string;
+    ungovernedHarnesses: number;
+    staleGates: number;
+    mcpServers: number;
+    ungovernedMcpServers: number;
+    skills: number;
+    hostname: string;
+    cliVersion: string | null;
+    reportedBy: string | null;
+    guardProbes: {
+        failed: number;
+        total: number;
+        ranAt: number;
+    } | null;
+    firstSeenAt: string;
+    lastSeenAt: string;
+    disconnectedAt: string | null;
+}>;
+export type InventoryDeviceResponse = z.infer<typeof InventoryDeviceResponse>;
+/** One harness on one machine (`InventoryHarnessRow`). */
+export declare const InventoryHarnessResponse: z.ZodObject<{
+    itemId: z.ZodString;
+    deviceId: z.ZodString;
+    hostname: z.ZodString;
+    deviceStale: z.ZodBoolean;
+    firstSeenAt: z.ZodString;
+    lastSeenAt: z.ZodString;
+} & {
+    harness: z.ZodString;
+    version: z.ZodNullable<z.ZodString>;
+    configured: z.ZodBoolean;
+    gateKind: z.ZodEnum<["hook", "sdk", "none", "delegated", "bridge"]>;
+    gateInstalled: z.ZodNullable<z.ZodBoolean>;
+    gateFile: z.ZodNullable<z.ZodString>;
+    lastHookEventAt: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<["governed", "ungoverned", "gate_stale", "unverified"]>;
+    reason: z.ZodNullable<z.ZodEnum<["no_gate_mechanism", "not_connected", "gate_missing", "guards_disabled", "gate_silent", "awaiting_first_event", "gate_not_observable", "disconnected"]>>;
+    reasonText: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "governed" | "ungoverned" | "gate_stale" | "unverified";
+    reason: "guards_disabled" | "no_gate_mechanism" | "not_connected" | "gate_missing" | "gate_silent" | "awaiting_first_event" | "gate_not_observable" | "disconnected" | null;
+    harness: string;
+    deviceId: string;
+    version: string | null;
+    hostname: string;
+    firstSeenAt: string;
+    lastSeenAt: string;
+    itemId: string;
+    deviceStale: boolean;
+    configured: boolean;
+    gateKind: "hook" | "sdk" | "none" | "delegated" | "bridge";
+    gateInstalled: boolean | null;
+    gateFile: string | null;
+    lastHookEventAt: string | null;
+    reasonText: string | null;
+}, {
+    status: "governed" | "ungoverned" | "gate_stale" | "unverified";
+    reason: "guards_disabled" | "no_gate_mechanism" | "not_connected" | "gate_missing" | "gate_silent" | "awaiting_first_event" | "gate_not_observable" | "disconnected" | null;
+    harness: string;
+    deviceId: string;
+    version: string | null;
+    hostname: string;
+    firstSeenAt: string;
+    lastSeenAt: string;
+    itemId: string;
+    deviceStale: boolean;
+    configured: boolean;
+    gateKind: "hook" | "sdk" | "none" | "delegated" | "bridge";
+    gateInstalled: boolean | null;
+    gateFile: string | null;
+    lastHookEventAt: string | null;
+    reasonText: string | null;
+}>;
+export type InventoryHarnessResponse = z.infer<typeof InventoryHarnessResponse>;
+/** One MCP server on one machine (`InventoryMcpServerRow`). */
+export declare const InventoryMcpServerResponse: z.ZodObject<{
+    itemId: z.ZodString;
+    deviceId: z.ZodString;
+    hostname: z.ZodString;
+    deviceStale: z.ZodBoolean;
+    firstSeenAt: z.ZodString;
+    lastSeenAt: z.ZodString;
+} & {
+    server: z.ZodString;
+    harness: z.ZodString;
+    transport: z.ZodEnum<["stdio", "http", "sse", "unknown"]>;
+    endpoint: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<["governed", "ungoverned"]>;
+    reason: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "governed" | "ungoverned";
+    reason: string | null;
+    endpoint: string | null;
+    harness: string;
+    server: string;
+    deviceId: string;
+    hostname: string;
+    firstSeenAt: string;
+    lastSeenAt: string;
+    itemId: string;
+    deviceStale: boolean;
+    transport: "unknown" | "stdio" | "http" | "sse";
+}, {
+    status: "governed" | "ungoverned";
+    reason: string | null;
+    endpoint: string | null;
+    harness: string;
+    server: string;
+    deviceId: string;
+    hostname: string;
+    firstSeenAt: string;
+    lastSeenAt: string;
+    itemId: string;
+    deviceStale: boolean;
+    transport: "unknown" | "stdio" | "http" | "sse";
+}>;
+export type InventoryMcpServerResponse = z.infer<typeof InventoryMcpServerResponse>;
+/** One skill bundle on one machine (`InventorySkillRow`). */
+export declare const InventorySkillResponse: z.ZodObject<{
+    itemId: z.ZodString;
+    deviceId: z.ZodString;
+    hostname: z.ZodString;
+    deviceStale: z.ZodBoolean;
+    firstSeenAt: z.ZodString;
+    lastSeenAt: z.ZodString;
+} & {
+    name: z.ZodString;
+    source: z.ZodString;
+    sha256: z.ZodNullable<z.ZodString>;
+    scanned: z.ZodBoolean;
+    clean: z.ZodBoolean;
+    findingsCount: z.ZodNumber;
+    scriptCount: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    source: string;
+    sha256: string | null;
+    clean: boolean;
+    deviceId: string;
+    hostname: string;
+    firstSeenAt: string;
+    lastSeenAt: string;
+    itemId: string;
+    deviceStale: boolean;
+    scanned: boolean;
+    findingsCount: number;
+    scriptCount: number;
+}, {
+    name: string;
+    source: string;
+    sha256: string | null;
+    clean: boolean;
+    deviceId: string;
+    hostname: string;
+    firstSeenAt: string;
+    lastSeenAt: string;
+    itemId: string;
+    deviceStale: boolean;
+    scanned: boolean;
+    findingsCount: number;
+    scriptCount: number;
+}>;
+export type InventorySkillResponse = z.infer<typeof InventorySkillResponse>;
+/** One `intutic disconnect` a machine reported (`deviceDisconnectService.ts` `DeviceDisconnectRow`). */
+export declare const DeviceDisconnectRowResponse: z.ZodObject<{
+    disconnectId: z.ZodString;
+    hostname: z.ZodString;
+    fingerprint: z.ZodString;
+    scope: z.ZodEnum<["machine", "harness"]>;
+    harnesses: z.ZodArray<z.ZodString, "many">;
+    memberId: z.ZodNullable<z.ZodString>;
+    reportedBy: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    scope: "harness" | "machine";
+    memberId: string | null;
+    harnesses: string[];
+    createdAt: string;
+    disconnectId: string;
+    hostname: string;
+    reportedBy: string | null;
+    fingerprint: string;
+}, {
+    scope: "harness" | "machine";
+    memberId: string | null;
+    harnesses: string[];
+    createdAt: string;
+    disconnectId: string;
+    hostname: string;
+    reportedBy: string | null;
+    fingerprint: string;
+}>;
+export type DeviceDisconnectRowResponse = z.infer<typeof DeviceDisconnectRowResponse>;
+/** `GET /api/v1/inventory/devices`. */
+export declare const InventoryDeviceListResponse: z.ZodObject<{
+    listProperty: z.ZodLiteral<"data">;
+    rowCase: z.ZodLiteral<"camel">;
+} & {
+    data: z.ZodArray<z.ZodObject<{
+        deviceId: z.ZodString;
+        hostname: z.ZodString;
+        platform: z.ZodString;
+        cliVersion: z.ZodNullable<z.ZodString>;
+        reportedBy: z.ZodNullable<z.ZodString>;
+        workspace: z.ZodNullable<z.ZodString>;
+        guardProbes: z.ZodNullable<z.ZodObject<{
+            total: z.ZodNumber;
+            failed: z.ZodNumber;
+            ranAt: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            failed: number;
+            total: number;
+            ranAt: number;
+        }, {
+            failed: number;
+            total: number;
+            ranAt: number;
+        }>>;
+        firstSeenAt: z.ZodString;
+        lastSeenAt: z.ZodString;
+        stale: z.ZodBoolean;
+        disconnectedAt: z.ZodNullable<z.ZodString>;
+        harnesses: z.ZodNumber;
+        ungovernedHarnesses: z.ZodNumber;
+        staleGates: z.ZodNumber;
+        mcpServers: z.ZodNumber;
+        ungovernedMcpServers: z.ZodNumber;
+        skills: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        workspace: string | null;
+        stale: boolean;
+        harnesses: number;
+        deviceId: string;
+        platform: string;
+        ungovernedHarnesses: number;
+        staleGates: number;
+        mcpServers: number;
+        ungovernedMcpServers: number;
+        skills: number;
+        hostname: string;
+        cliVersion: string | null;
+        reportedBy: string | null;
+        guardProbes: {
+            failed: number;
+            total: number;
+            ranAt: number;
+        } | null;
+        firstSeenAt: string;
+        lastSeenAt: string;
+        disconnectedAt: string | null;
+    }, {
+        workspace: string | null;
+        stale: boolean;
+        harnesses: number;
+        deviceId: string;
+        platform: string;
+        ungovernedHarnesses: number;
+        staleGates: number;
+        mcpServers: number;
+        ungovernedMcpServers: number;
+        skills: number;
+        hostname: string;
+        cliVersion: string | null;
+        reportedBy: string | null;
+        guardProbes: {
+            failed: number;
+            total: number;
+            ranAt: number;
+        } | null;
+        firstSeenAt: string;
+        lastSeenAt: string;
+        disconnectedAt: string | null;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        workspace: string | null;
+        stale: boolean;
+        harnesses: number;
+        deviceId: string;
+        platform: string;
+        ungovernedHarnesses: number;
+        staleGates: number;
+        mcpServers: number;
+        ungovernedMcpServers: number;
+        skills: number;
+        hostname: string;
+        cliVersion: string | null;
+        reportedBy: string | null;
+        guardProbes: {
+            failed: number;
+            total: number;
+            ranAt: number;
+        } | null;
+        firstSeenAt: string;
+        lastSeenAt: string;
+        disconnectedAt: string | null;
+    }[];
+    listProperty: "data";
+    rowCase: "camel";
+}, {
+    data: {
+        workspace: string | null;
+        stale: boolean;
+        harnesses: number;
+        deviceId: string;
+        platform: string;
+        ungovernedHarnesses: number;
+        staleGates: number;
+        mcpServers: number;
+        ungovernedMcpServers: number;
+        skills: number;
+        hostname: string;
+        cliVersion: string | null;
+        reportedBy: string | null;
+        guardProbes: {
+            failed: number;
+            total: number;
+            ranAt: number;
+        } | null;
+        firstSeenAt: string;
+        lastSeenAt: string;
+        disconnectedAt: string | null;
+    }[];
+    listProperty: "data";
+    rowCase: "camel";
+}>;
+export type InventoryDeviceListResponse = z.infer<typeof InventoryDeviceListResponse>;
+/** `GET /api/v1/inventory/harnesses` (JSON; `?format=csv` answers text). */
+export declare const InventoryHarnessListResponse: z.ZodObject<{
+    listProperty: z.ZodLiteral<"data">;
+    rowCase: z.ZodLiteral<"camel">;
+} & {
+    data: z.ZodArray<z.ZodObject<{
+        itemId: z.ZodString;
+        deviceId: z.ZodString;
+        hostname: z.ZodString;
+        deviceStale: z.ZodBoolean;
+        firstSeenAt: z.ZodString;
+        lastSeenAt: z.ZodString;
+    } & {
+        harness: z.ZodString;
+        version: z.ZodNullable<z.ZodString>;
+        configured: z.ZodBoolean;
+        gateKind: z.ZodEnum<["hook", "sdk", "none", "delegated", "bridge"]>;
+        gateInstalled: z.ZodNullable<z.ZodBoolean>;
+        gateFile: z.ZodNullable<z.ZodString>;
+        lastHookEventAt: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<["governed", "ungoverned", "gate_stale", "unverified"]>;
+        reason: z.ZodNullable<z.ZodEnum<["no_gate_mechanism", "not_connected", "gate_missing", "guards_disabled", "gate_silent", "awaiting_first_event", "gate_not_observable", "disconnected"]>>;
+        reasonText: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "governed" | "ungoverned" | "gate_stale" | "unverified";
+        reason: "guards_disabled" | "no_gate_mechanism" | "not_connected" | "gate_missing" | "gate_silent" | "awaiting_first_event" | "gate_not_observable" | "disconnected" | null;
+        harness: string;
+        deviceId: string;
+        version: string | null;
+        hostname: string;
+        firstSeenAt: string;
+        lastSeenAt: string;
+        itemId: string;
+        deviceStale: boolean;
+        configured: boolean;
+        gateKind: "hook" | "sdk" | "none" | "delegated" | "bridge";
+        gateInstalled: boolean | null;
+        gateFile: string | null;
+        lastHookEventAt: string | null;
+        reasonText: string | null;
+    }, {
+        status: "governed" | "ungoverned" | "gate_stale" | "unverified";
+        reason: "guards_disabled" | "no_gate_mechanism" | "not_connected" | "gate_missing" | "gate_silent" | "awaiting_first_event" | "gate_not_observable" | "disconnected" | null;
+        harness: string;
+        deviceId: string;
+        version: string | null;
+        hostname: string;
+        firstSeenAt: string;
+        lastSeenAt: string;
+        itemId: string;
+        deviceStale: boolean;
+        configured: boolean;
+        gateKind: "hook" | "sdk" | "none" | "delegated" | "bridge";
+        gateInstalled: boolean | null;
+        gateFile: string | null;
+        lastHookEventAt: string | null;
+        reasonText: string | null;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        status: "governed" | "ungoverned" | "gate_stale" | "unverified";
+        reason: "guards_disabled" | "no_gate_mechanism" | "not_connected" | "gate_missing" | "gate_silent" | "awaiting_first_event" | "gate_not_observable" | "disconnected" | null;
+        harness: string;
+        deviceId: string;
+        version: string | null;
+        hostname: string;
+        firstSeenAt: string;
+        lastSeenAt: string;
+        itemId: string;
+        deviceStale: boolean;
+        configured: boolean;
+        gateKind: "hook" | "sdk" | "none" | "delegated" | "bridge";
+        gateInstalled: boolean | null;
+        gateFile: string | null;
+        lastHookEventAt: string | null;
+        reasonText: string | null;
+    }[];
+    listProperty: "data";
+    rowCase: "camel";
+}, {
+    data: {
+        status: "governed" | "ungoverned" | "gate_stale" | "unverified";
+        reason: "guards_disabled" | "no_gate_mechanism" | "not_connected" | "gate_missing" | "gate_silent" | "awaiting_first_event" | "gate_not_observable" | "disconnected" | null;
+        harness: string;
+        deviceId: string;
+        version: string | null;
+        hostname: string;
+        firstSeenAt: string;
+        lastSeenAt: string;
+        itemId: string;
+        deviceStale: boolean;
+        configured: boolean;
+        gateKind: "hook" | "sdk" | "none" | "delegated" | "bridge";
+        gateInstalled: boolean | null;
+        gateFile: string | null;
+        lastHookEventAt: string | null;
+        reasonText: string | null;
+    }[];
+    listProperty: "data";
+    rowCase: "camel";
+}>;
+export type InventoryHarnessListResponse = z.infer<typeof InventoryHarnessListResponse>;
+/** `GET /api/v1/inventory/mcp-servers` (JSON; `?format=csv` answers text). */
+export declare const InventoryMcpServerListResponse: z.ZodObject<{
+    listProperty: z.ZodLiteral<"data">;
+    rowCase: z.ZodLiteral<"camel">;
+} & {
+    data: z.ZodArray<z.ZodObject<{
+        itemId: z.ZodString;
+        deviceId: z.ZodString;
+        hostname: z.ZodString;
+        deviceStale: z.ZodBoolean;
+        firstSeenAt: z.ZodString;
+        lastSeenAt: z.ZodString;
+    } & {
+        server: z.ZodString;
+        harness: z.ZodString;
+        transport: z.ZodEnum<["stdio", "http", "sse", "unknown"]>;
+        endpoint: z.ZodNullable<z.ZodString>;
+        status: z.ZodEnum<["governed", "ungoverned"]>;
+        reason: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "governed" | "ungoverned";
+        reason: string | null;
+        endpoint: string | null;
+        harness: string;
+        server: string;
+        deviceId: string;
+        hostname: string;
+        firstSeenAt: string;
+        lastSeenAt: string;
+        itemId: string;
+        deviceStale: boolean;
+        transport: "unknown" | "stdio" | "http" | "sse";
+    }, {
+        status: "governed" | "ungoverned";
+        reason: string | null;
+        endpoint: string | null;
+        harness: string;
+        server: string;
+        deviceId: string;
+        hostname: string;
+        firstSeenAt: string;
+        lastSeenAt: string;
+        itemId: string;
+        deviceStale: boolean;
+        transport: "unknown" | "stdio" | "http" | "sse";
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        status: "governed" | "ungoverned";
+        reason: string | null;
+        endpoint: string | null;
+        harness: string;
+        server: string;
+        deviceId: string;
+        hostname: string;
+        firstSeenAt: string;
+        lastSeenAt: string;
+        itemId: string;
+        deviceStale: boolean;
+        transport: "unknown" | "stdio" | "http" | "sse";
+    }[];
+    listProperty: "data";
+    rowCase: "camel";
+}, {
+    data: {
+        status: "governed" | "ungoverned";
+        reason: string | null;
+        endpoint: string | null;
+        harness: string;
+        server: string;
+        deviceId: string;
+        hostname: string;
+        firstSeenAt: string;
+        lastSeenAt: string;
+        itemId: string;
+        deviceStale: boolean;
+        transport: "unknown" | "stdio" | "http" | "sse";
+    }[];
+    listProperty: "data";
+    rowCase: "camel";
+}>;
+export type InventoryMcpServerListResponse = z.infer<typeof InventoryMcpServerListResponse>;
+/** `GET /api/v1/inventory/skills`. */
+export declare const InventorySkillListResponse: z.ZodObject<{
+    listProperty: z.ZodLiteral<"data">;
+    rowCase: z.ZodLiteral<"camel">;
+} & {
+    data: z.ZodArray<z.ZodObject<{
+        itemId: z.ZodString;
+        deviceId: z.ZodString;
+        hostname: z.ZodString;
+        deviceStale: z.ZodBoolean;
+        firstSeenAt: z.ZodString;
+        lastSeenAt: z.ZodString;
+    } & {
+        name: z.ZodString;
+        source: z.ZodString;
+        sha256: z.ZodNullable<z.ZodString>;
+        scanned: z.ZodBoolean;
+        clean: z.ZodBoolean;
+        findingsCount: z.ZodNumber;
+        scriptCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        source: string;
+        sha256: string | null;
+        clean: boolean;
+        deviceId: string;
+        hostname: string;
+        firstSeenAt: string;
+        lastSeenAt: string;
+        itemId: string;
+        deviceStale: boolean;
+        scanned: boolean;
+        findingsCount: number;
+        scriptCount: number;
+    }, {
+        name: string;
+        source: string;
+        sha256: string | null;
+        clean: boolean;
+        deviceId: string;
+        hostname: string;
+        firstSeenAt: string;
+        lastSeenAt: string;
+        itemId: string;
+        deviceStale: boolean;
+        scanned: boolean;
+        findingsCount: number;
+        scriptCount: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        name: string;
+        source: string;
+        sha256: string | null;
+        clean: boolean;
+        deviceId: string;
+        hostname: string;
+        firstSeenAt: string;
+        lastSeenAt: string;
+        itemId: string;
+        deviceStale: boolean;
+        scanned: boolean;
+        findingsCount: number;
+        scriptCount: number;
+    }[];
+    listProperty: "data";
+    rowCase: "camel";
+}, {
+    data: {
+        name: string;
+        source: string;
+        sha256: string | null;
+        clean: boolean;
+        deviceId: string;
+        hostname: string;
+        firstSeenAt: string;
+        lastSeenAt: string;
+        itemId: string;
+        deviceStale: boolean;
+        scanned: boolean;
+        findingsCount: number;
+        scriptCount: number;
+    }[];
+    listProperty: "data";
+    rowCase: "camel";
+}>;
+export type InventorySkillListResponse = z.infer<typeof InventorySkillListResponse>;
+/** `GET /api/v1/inventory/disconnects`, newest first. */
+export declare const DeviceDisconnectListResponse: z.ZodObject<{
+    listProperty: z.ZodLiteral<"data">;
+    rowCase: z.ZodLiteral<"camel">;
+} & {
+    data: z.ZodArray<z.ZodObject<{
+        disconnectId: z.ZodString;
+        hostname: z.ZodString;
+        fingerprint: z.ZodString;
+        scope: z.ZodEnum<["machine", "harness"]>;
+        harnesses: z.ZodArray<z.ZodString, "many">;
+        memberId: z.ZodNullable<z.ZodString>;
+        reportedBy: z.ZodNullable<z.ZodString>;
+        createdAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        scope: "harness" | "machine";
+        memberId: string | null;
+        harnesses: string[];
+        createdAt: string;
+        disconnectId: string;
+        hostname: string;
+        reportedBy: string | null;
+        fingerprint: string;
+    }, {
+        scope: "harness" | "machine";
+        memberId: string | null;
+        harnesses: string[];
+        createdAt: string;
+        disconnectId: string;
+        hostname: string;
+        reportedBy: string | null;
+        fingerprint: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        scope: "harness" | "machine";
+        memberId: string | null;
+        harnesses: string[];
+        createdAt: string;
+        disconnectId: string;
+        hostname: string;
+        reportedBy: string | null;
+        fingerprint: string;
+    }[];
+    listProperty: "data";
+    rowCase: "camel";
+}, {
+    data: {
+        scope: "harness" | "machine";
+        memberId: string | null;
+        harnesses: string[];
+        createdAt: string;
+        disconnectId: string;
+        hostname: string;
+        reportedBy: string | null;
+        fingerprint: string;
+    }[];
+    listProperty: "data";
+    rowCase: "camel";
+}>;
+export type DeviceDisconnectListResponse = z.infer<typeof DeviceDisconnectListResponse>;
+/** One member's usage (`finopsService.ts` `getMemberUsage`). */
+export declare const MemberUsageRowResponse: z.ZodObject<{
+    models: z.ZodArray<z.ZodString, "many">;
+    activeDays: z.ZodNumber;
+    totalCostUsd: z.ZodNumber;
+    totalRawCostUsd: z.ZodNumber;
+    totalInputTokens: z.ZodNumber;
+    totalOutputTokens: z.ZodNumber;
+    traceCount: z.ZodNumber;
+    memberId: z.ZodNullable<z.ZodString>;
+    displayName: z.ZodNullable<z.ZodString>;
+    email: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    email: string | null;
+    displayName: string | null;
+    models: string[];
+    memberId: string | null;
+    activeDays: number;
+    totalCostUsd: number;
+    totalRawCostUsd: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    traceCount: number;
+}, {
+    email: string | null;
+    displayName: string | null;
+    models: string[];
+    memberId: string | null;
+    activeDays: number;
+    totalCostUsd: number;
+    totalRawCostUsd: number;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    traceCount: number;
+}>;
+export type MemberUsageRowResponse = z.infer<typeof MemberUsageRowResponse>;
+/** `GET /api/v1/usage/members`. */
+export declare const MemberUsageListResponse: z.ZodObject<{
+    listProperty: z.ZodLiteral<"members">;
+    rowCase: z.ZodLiteral<"camel">;
+} & {
+    scope: z.ZodEnum<["workspace", "self"]>;
+    members: z.ZodArray<z.ZodObject<{
+        models: z.ZodArray<z.ZodString, "many">;
+        activeDays: z.ZodNumber;
+        totalCostUsd: z.ZodNumber;
+        totalRawCostUsd: z.ZodNumber;
+        totalInputTokens: z.ZodNumber;
+        totalOutputTokens: z.ZodNumber;
+        traceCount: z.ZodNumber;
+        memberId: z.ZodNullable<z.ZodString>;
+        displayName: z.ZodNullable<z.ZodString>;
+        email: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        email: string | null;
+        displayName: string | null;
+        models: string[];
+        memberId: string | null;
+        activeDays: number;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+    }, {
+        email: string | null;
+        displayName: string | null;
+        models: string[];
+        memberId: string | null;
+        activeDays: number;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    members: {
+        email: string | null;
+        displayName: string | null;
+        models: string[];
+        memberId: string | null;
+        activeDays: number;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+    }[];
+    scope: "workspace" | "self";
+    listProperty: "members";
+    rowCase: "camel";
+}, {
+    members: {
+        email: string | null;
+        displayName: string | null;
+        models: string[];
+        memberId: string | null;
+        activeDays: number;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+    }[];
+    scope: "workspace" | "self";
+    listProperty: "members";
+    rowCase: "camel";
+}>;
+export type MemberUsageListResponse = z.infer<typeof MemberUsageListResponse>;
+/** `GET /api/v1/usage/teams` (`getTeamUsage`): per SCIM group. */
+export declare const TeamUsageListResponse: z.ZodObject<{
+    listProperty: z.ZodLiteral<"teams">;
+    rowCase: z.ZodLiteral<"camel">;
+} & {
+    scimGroups: z.ZodBoolean;
+    teams: z.ZodArray<z.ZodObject<{
+        totalCostUsd: z.ZodNumber;
+        totalRawCostUsd: z.ZodNumber;
+        totalInputTokens: z.ZodNumber;
+        totalOutputTokens: z.ZodNumber;
+        traceCount: z.ZodNumber;
+        groupId: z.ZodString;
+        displayName: z.ZodString;
+        memberCount: z.ZodNumber;
+        activeMembers: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        displayName: string;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+        groupId: string;
+        memberCount: number;
+        activeMembers: number;
+    }, {
+        displayName: string;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+        groupId: string;
+        memberCount: number;
+        activeMembers: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    listProperty: "teams";
+    rowCase: "camel";
+    teams: {
+        displayName: string;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+        groupId: string;
+        memberCount: number;
+        activeMembers: number;
+    }[];
+    scimGroups: boolean;
+}, {
+    listProperty: "teams";
+    rowCase: "camel";
+    teams: {
+        displayName: string;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+        groupId: string;
+        memberCount: number;
+        activeMembers: number;
+    }[];
+    scimGroups: boolean;
+}>;
+export type TeamUsageListResponse = z.infer<typeof TeamUsageListResponse>;
+/** `GET /api/v1/usage/branches` (`getBranchUsage`). */
+export declare const BranchUsageListResponse: z.ZodObject<{
+    listProperty: z.ZodLiteral<"branches">;
+    rowCase: z.ZodLiteral<"camel">;
+} & {
+    scope: z.ZodEnum<["workspace", "self"]>;
+    branches: z.ZodArray<z.ZodObject<{
+        lastCallAt: z.ZodString;
+        totalCostUsd: z.ZodNumber;
+        totalRawCostUsd: z.ZodNumber;
+        totalInputTokens: z.ZodNumber;
+        totalOutputTokens: z.ZodNumber;
+        traceCount: z.ZodNumber;
+        repo: z.ZodNullable<z.ZodString>;
+        branch: z.ZodNullable<z.ZodString>;
+        commitCount: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        branch: string | null;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+        repo: string | null;
+        commitCount: number;
+        lastCallAt: string;
+    }, {
+        branch: string | null;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+        repo: string | null;
+        commitCount: number;
+        lastCallAt: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    scope: "workspace" | "self";
+    listProperty: "branches";
+    rowCase: "camel";
+    branches: {
+        branch: string | null;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+        repo: string | null;
+        commitCount: number;
+        lastCallAt: string;
+    }[];
+}, {
+    scope: "workspace" | "self";
+    listProperty: "branches";
+    rowCase: "camel";
+    branches: {
+        branch: string | null;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+        repo: string | null;
+        commitCount: number;
+        lastCallAt: string;
+    }[];
+}>;
+export type BranchUsageListResponse = z.infer<typeof BranchUsageListResponse>;
+/** `GET /api/v1/usage/commits` (`getCommitUsage`). */
+export declare const CommitUsageListResponse: z.ZodObject<{
+    listProperty: z.ZodLiteral<"commits">;
+    rowCase: z.ZodLiteral<"camel">;
+} & {
+    scope: z.ZodEnum<["workspace", "self"]>;
+    commits: z.ZodArray<z.ZodObject<{
+        firstCallAt: z.ZodString;
+        lastCallAt: z.ZodString;
+        totalCostUsd: z.ZodNumber;
+        totalRawCostUsd: z.ZodNumber;
+        totalInputTokens: z.ZodNumber;
+        totalOutputTokens: z.ZodNumber;
+        traceCount: z.ZodNumber;
+        repo: z.ZodNullable<z.ZodString>;
+        branch: z.ZodNullable<z.ZodString>;
+        commit: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        commit: string | null;
+        branch: string | null;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+        repo: string | null;
+        lastCallAt: string;
+        firstCallAt: string;
+    }, {
+        commit: string | null;
+        branch: string | null;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+        repo: string | null;
+        lastCallAt: string;
+        firstCallAt: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    scope: "workspace" | "self";
+    listProperty: "commits";
+    rowCase: "camel";
+    commits: {
+        commit: string | null;
+        branch: string | null;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+        repo: string | null;
+        lastCallAt: string;
+        firstCallAt: string;
+    }[];
+}, {
+    scope: "workspace" | "self";
+    listProperty: "commits";
+    rowCase: "camel";
+    commits: {
+        commit: string | null;
+        branch: string | null;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+        repo: string | null;
+        lastCallAt: string;
+        firstCallAt: string;
+    }[];
+}>;
+export type CommitUsageListResponse = z.infer<typeof CommitUsageListResponse>;
+/** `GET /api/v1/usage/pull-requests` (`getPullRequestUsage`, `getPullRequestSources`). */
+export declare const PullRequestUsageListResponse: z.ZodObject<{
+    listProperty: z.ZodLiteral<"pullRequests">;
+    rowCase: z.ZodLiteral<"camel">;
+} & {
+    scope: z.ZodEnum<["workspace", "self"]>;
+    github: z.ZodObject<{
+        connector: z.ZodBoolean;
+        webhook: z.ZodBoolean;
+        apiHost: z.ZodString;
+        noAccessRepos: z.ZodArray<z.ZodString, "many">;
+        mappedPullRequests: z.ZodNumber;
+        lastCheckedAt: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        webhook: boolean;
+        connector: boolean;
+        apiHost: string;
+        noAccessRepos: string[];
+        mappedPullRequests: number;
+        lastCheckedAt: string | null;
+    }, {
+        webhook: boolean;
+        connector: boolean;
+        apiHost: string;
+        noAccessRepos: string[];
+        mappedPullRequests: number;
+        lastCheckedAt: string | null;
+    }>;
+    pullRequests: z.ZodArray<z.ZodObject<{
+        memberCount: z.ZodNumber;
+        firstCallAt: z.ZodString;
+        lastCallAt: z.ZodString;
+        totalCostUsd: z.ZodNumber;
+        totalRawCostUsd: z.ZodNumber;
+        totalInputTokens: z.ZodNumber;
+        totalOutputTokens: z.ZodNumber;
+        traceCount: z.ZodNumber;
+        repo: z.ZodString;
+        number: z.ZodNumber;
+        title: z.ZodString;
+        author: z.ZodNullable<z.ZodString>;
+        state: z.ZodEnum<["open", "closed", "merged"]>;
+        headBranch: z.ZodString;
+        baseBranch: z.ZodNullable<z.ZodString>;
+        url: z.ZodString;
+        openedAt: z.ZodString;
+        mergedAt: z.ZodNullable<z.ZodString>;
+        closedAt: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        number: number;
+        url: string;
+        title: string;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+        memberCount: number;
+        repo: string;
+        lastCallAt: string;
+        firstCallAt: string;
+        author: string | null;
+        state: "open" | "closed" | "merged";
+        headBranch: string;
+        baseBranch: string | null;
+        openedAt: string;
+        mergedAt: string | null;
+        closedAt: string | null;
+    }, {
+        number: number;
+        url: string;
+        title: string;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+        memberCount: number;
+        repo: string;
+        lastCallAt: string;
+        firstCallAt: string;
+        author: string | null;
+        state: "open" | "closed" | "merged";
+        headBranch: string;
+        baseBranch: string | null;
+        openedAt: string;
+        mergedAt: string | null;
+        closedAt: string | null;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    scope: "workspace" | "self";
+    github: {
+        webhook: boolean;
+        connector: boolean;
+        apiHost: string;
+        noAccessRepos: string[];
+        mappedPullRequests: number;
+        lastCheckedAt: string | null;
+    };
+    listProperty: "pullRequests";
+    rowCase: "camel";
+    pullRequests: {
+        number: number;
+        url: string;
+        title: string;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+        memberCount: number;
+        repo: string;
+        lastCallAt: string;
+        firstCallAt: string;
+        author: string | null;
+        state: "open" | "closed" | "merged";
+        headBranch: string;
+        baseBranch: string | null;
+        openedAt: string;
+        mergedAt: string | null;
+        closedAt: string | null;
+    }[];
+}, {
+    scope: "workspace" | "self";
+    github: {
+        webhook: boolean;
+        connector: boolean;
+        apiHost: string;
+        noAccessRepos: string[];
+        mappedPullRequests: number;
+        lastCheckedAt: string | null;
+    };
+    listProperty: "pullRequests";
+    rowCase: "camel";
+    pullRequests: {
+        number: number;
+        url: string;
+        title: string;
+        totalCostUsd: number;
+        totalRawCostUsd: number;
+        totalInputTokens: number;
+        totalOutputTokens: number;
+        traceCount: number;
+        memberCount: number;
+        repo: string;
+        lastCallAt: string;
+        firstCallAt: string;
+        author: string | null;
+        state: "open" | "closed" | "merged";
+        headBranch: string;
+        baseBranch: string | null;
+        openedAt: string;
+        mergedAt: string | null;
+        closedAt: string | null;
+    }[];
+}>;
+export type PullRequestUsageListResponse = z.infer<typeof PullRequestUsageListResponse>;
+/** `POST /api/v1/usage/pull-requests/refresh` (`syncWorkspacePullRequests`). */
+export declare const PullRequestRefreshResponse: z.ZodObject<{
+    checked: z.ZodNumber;
+    notModified: z.ZodNumber;
+    pullRequests: z.ZodNumber;
+    noAccess: z.ZodNumber;
+    rateLimited: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    pullRequests: number;
+    checked: number;
+    notModified: number;
+    noAccess: number;
+    rateLimited: boolean;
+}, {
+    pullRequests: number;
+    checked: number;
+    notModified: number;
+    noAccess: number;
+    rateLimited: boolean;
+}>;
+export type PullRequestRefreshResponse = z.infer<typeof PullRequestRefreshResponse>;
+/** A `loop_runs` row. */
+export declare const LoopRunResponse: z.ZodObject<{
+    loopRunId: z.ZodString;
+    workspaceId: z.ZodString;
+    name: z.ZodString;
+    status: z.ZodEnum<["ACTIVE", "PENDING_REVIEW", "COMPLETED", "FAILED", "KILLED"]>;
+    startedBy: z.ZodNullable<z.ZodString>;
+    reviewReason: z.ZodNullable<z.ZodString>;
+    reviewedBy: z.ZodNullable<z.ZodString>;
+    reviewedAt: z.ZodNullable<z.ZodString>;
+    reviewNote: z.ZodNullable<z.ZodString>;
+    totalTokenCostUsd: z.ZodString;
+    budgetLimitUsd: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    workspaceId: string;
+    status: "COMPLETED" | "FAILED" | "PENDING_REVIEW" | "ACTIVE" | "KILLED";
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+    loopRunId: string;
+    startedBy: string | null;
+    reviewReason: string | null;
+    reviewedBy: string | null;
+    reviewedAt: string | null;
+    reviewNote: string | null;
+    totalTokenCostUsd: string;
+    budgetLimitUsd: string;
+}, {
+    workspaceId: string;
+    status: "COMPLETED" | "FAILED" | "PENDING_REVIEW" | "ACTIVE" | "KILLED";
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+    loopRunId: string;
+    startedBy: string | null;
+    reviewReason: string | null;
+    reviewedBy: string | null;
+    reviewedAt: string | null;
+    reviewNote: string | null;
+    totalTokenCostUsd: string;
+    budgetLimitUsd: string;
+}>;
+export type LoopRunResponse = z.infer<typeof LoopRunResponse>;
+/** `POST /api/v1/loops/start` and `GET /api/v1/loops/:loopRunId`. */
+export declare const LoopRunEnvelopeResponse: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    loop: z.ZodObject<{
+        loopRunId: z.ZodString;
+        workspaceId: z.ZodString;
+        name: z.ZodString;
+        status: z.ZodEnum<["ACTIVE", "PENDING_REVIEW", "COMPLETED", "FAILED", "KILLED"]>;
+        startedBy: z.ZodNullable<z.ZodString>;
+        reviewReason: z.ZodNullable<z.ZodString>;
+        reviewedBy: z.ZodNullable<z.ZodString>;
+        reviewedAt: z.ZodNullable<z.ZodString>;
+        reviewNote: z.ZodNullable<z.ZodString>;
+        totalTokenCostUsd: z.ZodString;
+        budgetLimitUsd: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        workspaceId: string;
+        status: "COMPLETED" | "FAILED" | "PENDING_REVIEW" | "ACTIVE" | "KILLED";
+        name: string;
+        createdAt: string;
+        updatedAt: string;
+        loopRunId: string;
+        startedBy: string | null;
+        reviewReason: string | null;
+        reviewedBy: string | null;
+        reviewedAt: string | null;
+        reviewNote: string | null;
+        totalTokenCostUsd: string;
+        budgetLimitUsd: string;
+    }, {
+        workspaceId: string;
+        status: "COMPLETED" | "FAILED" | "PENDING_REVIEW" | "ACTIVE" | "KILLED";
+        name: string;
+        createdAt: string;
+        updatedAt: string;
+        loopRunId: string;
+        startedBy: string | null;
+        reviewReason: string | null;
+        reviewedBy: string | null;
+        reviewedAt: string | null;
+        reviewNote: string | null;
+        totalTokenCostUsd: string;
+        budgetLimitUsd: string;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    ok: true;
+    loop: {
+        workspaceId: string;
+        status: "COMPLETED" | "FAILED" | "PENDING_REVIEW" | "ACTIVE" | "KILLED";
+        name: string;
+        createdAt: string;
+        updatedAt: string;
+        loopRunId: string;
+        startedBy: string | null;
+        reviewReason: string | null;
+        reviewedBy: string | null;
+        reviewedAt: string | null;
+        reviewNote: string | null;
+        totalTokenCostUsd: string;
+        budgetLimitUsd: string;
+    };
+}, {
+    ok: true;
+    loop: {
+        workspaceId: string;
+        status: "COMPLETED" | "FAILED" | "PENDING_REVIEW" | "ACTIVE" | "KILLED";
+        name: string;
+        createdAt: string;
+        updatedAt: string;
+        loopRunId: string;
+        startedBy: string | null;
+        reviewReason: string | null;
+        reviewedBy: string | null;
+        reviewedAt: string | null;
+        reviewNote: string | null;
+        totalTokenCostUsd: string;
+        budgetLimitUsd: string;
+    };
+}>;
+export type LoopRunEnvelopeResponse = z.infer<typeof LoopRunEnvelopeResponse>;
+/** `GET /api/v1/loops`, newest first. */
+export declare const LoopRunListResponse: z.ZodObject<{
+    listProperty: z.ZodLiteral<"loops">;
+    rowCase: z.ZodLiteral<"camel">;
+} & {
+    ok: z.ZodLiteral<true>;
+    loops: z.ZodArray<z.ZodObject<{
+        loopRunId: z.ZodString;
+        workspaceId: z.ZodString;
+        name: z.ZodString;
+        status: z.ZodEnum<["ACTIVE", "PENDING_REVIEW", "COMPLETED", "FAILED", "KILLED"]>;
+        startedBy: z.ZodNullable<z.ZodString>;
+        reviewReason: z.ZodNullable<z.ZodString>;
+        reviewedBy: z.ZodNullable<z.ZodString>;
+        reviewedAt: z.ZodNullable<z.ZodString>;
+        reviewNote: z.ZodNullable<z.ZodString>;
+        totalTokenCostUsd: z.ZodString;
+        budgetLimitUsd: z.ZodString;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        workspaceId: string;
+        status: "COMPLETED" | "FAILED" | "PENDING_REVIEW" | "ACTIVE" | "KILLED";
+        name: string;
+        createdAt: string;
+        updatedAt: string;
+        loopRunId: string;
+        startedBy: string | null;
+        reviewReason: string | null;
+        reviewedBy: string | null;
+        reviewedAt: string | null;
+        reviewNote: string | null;
+        totalTokenCostUsd: string;
+        budgetLimitUsd: string;
+    }, {
+        workspaceId: string;
+        status: "COMPLETED" | "FAILED" | "PENDING_REVIEW" | "ACTIVE" | "KILLED";
+        name: string;
+        createdAt: string;
+        updatedAt: string;
+        loopRunId: string;
+        startedBy: string | null;
+        reviewReason: string | null;
+        reviewedBy: string | null;
+        reviewedAt: string | null;
+        reviewNote: string | null;
+        totalTokenCostUsd: string;
+        budgetLimitUsd: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    ok: true;
+    listProperty: "loops";
+    rowCase: "camel";
+    loops: {
+        workspaceId: string;
+        status: "COMPLETED" | "FAILED" | "PENDING_REVIEW" | "ACTIVE" | "KILLED";
+        name: string;
+        createdAt: string;
+        updatedAt: string;
+        loopRunId: string;
+        startedBy: string | null;
+        reviewReason: string | null;
+        reviewedBy: string | null;
+        reviewedAt: string | null;
+        reviewNote: string | null;
+        totalTokenCostUsd: string;
+        budgetLimitUsd: string;
+    }[];
+}, {
+    ok: true;
+    listProperty: "loops";
+    rowCase: "camel";
+    loops: {
+        workspaceId: string;
+        status: "COMPLETED" | "FAILED" | "PENDING_REVIEW" | "ACTIVE" | "KILLED";
+        name: string;
+        createdAt: string;
+        updatedAt: string;
+        loopRunId: string;
+        startedBy: string | null;
+        reviewReason: string | null;
+        reviewedBy: string | null;
+        reviewedAt: string | null;
+        reviewNote: string | null;
+        totalTokenCostUsd: string;
+        budgetLimitUsd: string;
+    }[];
+}>;
+export type LoopRunListResponse = z.infer<typeof LoopRunListResponse>;
+/** `POST /api/v1/loops/:loopRunId/complete`. */
+export declare const LoopRunCompleteResponse: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    outcome: z.ZodEnum<["SUCCEEDED", "FAILED"]>;
+}, "strip", z.ZodTypeAny, {
+    ok: true;
+    outcome: "FAILED" | "SUCCEEDED";
+}, {
+    ok: true;
+    outcome: "FAILED" | "SUCCEEDED";
+}>;
+export type LoopRunCompleteResponse = z.infer<typeof LoopRunCompleteResponse>;
+/** `POST /api/v1/loops/:loopRunId/kill`. */
+export declare const LoopRunKillResponse: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+}, "strip", z.ZodTypeAny, {
+    ok: true;
+}, {
+    ok: true;
+}>;
+export type LoopRunKillResponse = z.infer<typeof LoopRunKillResponse>;
+/** `POST /api/v1/loops/:loopRunId/review`: the run's status after the review. */
+export declare const LoopRunReviewResponse: z.ZodObject<{
+    ok: z.ZodLiteral<true>;
+    status: z.ZodEnum<["ACTIVE", "KILLED"]>;
+}, "strip", z.ZodTypeAny, {
+    status: "ACTIVE" | "KILLED";
+    ok: true;
+}, {
+    status: "ACTIVE" | "KILLED";
+    ok: true;
+}>;
+export type LoopRunReviewResponse = z.infer<typeof LoopRunReviewResponse>;
+//# sourceMappingURL=observability.d.ts.map