@claudexor/schema 1.0.1 → 2.1.1

package/dist/telemetry.d.ts

@@ -22,24 +22,24 @@ export declare const WebEvidenceRecord: z.ZodObject<{
     target: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     error_summary: z.ZodDefault<z.ZodNullable<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
-    status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+    status: "failed" | "none" | "attempted" | "satisfied" | "unverified";
     target: string | null;
     error_summary: string | null;
     tool: string | null;
     required: boolean;
-    attempted: boolean;
     policy: "off" | "auto" | "cached" | "live";
     effective_mode: "off" | "auto" | "cached" | "live";
+    attempted: boolean;
     satisfied: boolean;
 }, {
-    status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | undefined;
+    status?: "failed" | "none" | "attempted" | "satisfied" | "unverified" | undefined;
     target?: string | null | undefined;
     error_summary?: string | null | undefined;
     tool?: string | null | undefined;
     required?: boolean | undefined;
-    attempted?: boolean | undefined;
     policy?: "off" | "auto" | "cached" | "live" | undefined;
     effective_mode?: "off" | "auto" | "cached" | "live" | undefined;
+    attempted?: boolean | undefined;
     satisfied?: boolean | undefined;
 }>;
 export type WebEvidenceRecord = z.infer<typeof WebEvidenceRecord>;
@@ -52,16 +52,16 @@ export declare const ToolErrorRecord: z.ZodObject<{
     recovered: z.ZodDefault<z.ZodBoolean>;
     tool_use_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
 }, "strip", z.ZodTypeAny, {
-    kind: "file" | "web" | "command" | "mcp" | "search" | "other";
+    kind: "web" | "file" | "command" | "mcp" | "search" | "other";
     target: string | null;
-    tool: string;
     summary: string;
+    tool: string;
     recovered: boolean;
     tool_use_id: string | null;
 }, {
-    tool: string;
     summary: string;
-    kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
+    tool: string;
+    kind?: "web" | "file" | "command" | "mcp" | "search" | "other" | undefined;
     target?: string | null | undefined;
     recovered?: boolean | undefined;
     tool_use_id?: string | null | undefined;
@@ -92,14 +92,14 @@ export declare const AttemptOutcome: z.ZodObject<{
     tool_warnings_count: z.ZodDefault<z.ZodNumber>;
     status: z.ZodDefault<z.ZodEnum<["success", "success_with_warnings", "blocked", "failed"]>>;
 }, "strip", z.ZodTypeAny, {
-    status: "success" | "blocked" | "failed" | "success_with_warnings";
+    status: "failed" | "success" | "blocked" | "success_with_warnings";
     gates_passed: boolean | null;
     deliverable_present: boolean;
     harness_errored: boolean;
     web_required_unsatisfied: boolean;
     tool_warnings_count: number;
 }, {
-    status?: "success" | "blocked" | "failed" | "success_with_warnings" | undefined;
+    status?: "failed" | "success" | "blocked" | "success_with_warnings" | undefined;
     gates_passed?: boolean | null | undefined;
     deliverable_present?: boolean | undefined;
     harness_errored?: boolean | undefined;
@@ -107,6 +107,47 @@ export declare const AttemptOutcome: z.ZodObject<{
     tool_warnings_count?: number | undefined;
 }>;
 export type AttemptOutcome = z.infer<typeof AttemptOutcome>;
+/**
+ * Typed conformance receipt for a run started with an output schema, persisted
+ * as final/structured_output.yaml by the ONE engine validator. Surfaces project
+ * it (summary.outputConformance) and never re-validate the answer themselves.
+ */
+export declare const StructuredOutputConformance: z.ZodObject<{
+    schema_version: z.ZodLiteral<2>;
+    status: z.ZodEnum<["passed", "failed"]>;
+    reason: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    /** Present when the answer parsed as JSON at all (even non-conformant JSON
+     * is materialized to help the embedder debug and retry). */
+    output_path: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    generated_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: "passed" | "failed";
+    reason: string | null;
+    schema_version: 2;
+    output_path: string | null;
+    generated_at: string;
+}, {
+    status: "passed" | "failed";
+    schema_version: 2;
+    generated_at: string;
+    reason?: string | null | undefined;
+    output_path?: string | null | undefined;
+}>;
+export type StructuredOutputConformance = z.infer<typeof StructuredOutputConformance>;
+export declare const TokenUsage: z.ZodObject<{
+    input_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    output_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    cached_input_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    input_tokens: number | null;
+    output_tokens: number | null;
+    cached_input_tokens: number | null;
+}, {
+    input_tokens?: number | null | undefined;
+    output_tokens?: number | null | undefined;
+    cached_input_tokens?: number | null | undefined;
+}>;
+export type TokenUsage = z.infer<typeof TokenUsage>;
 export declare const AttemptTelemetryRecord: z.ZodObject<{
     attempt_id: z.ZodString;
     harness_id: z.ZodString;
@@ -116,6 +157,51 @@ export declare const AttemptTelemetryRecord: z.ZodObject<{
      * unverified, never as a guess.
      */
     observed_model: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    /**
+     * Auth route the attempt ACTUALLY ran under (route evidence, like
+     * observed_model): adapters disclose their chosen route as a typed
+     * `auth_route` payload on the started event, sourced from the credential
+     * material itself (codex: the seeded auth.json's own auth_mode; claude:
+     * the selected credentials/OAuth/api-key route). Null when never
+     * disclosed — subscription-vs-API quota attribution must treat that as
+     * unknown, never guess from manifests.
+     */
+    auth_mode: z.ZodDefault<z.ZodNullable<z.ZodEnum<["local_session", "api_key", "unknown"]>>>;
+    /** Concrete credential source the attempt disclosed alongside its route
+     * (route evidence; null = undisclosed, never guessed). */
+    auth_source: z.ZodDefault<z.ZodNullable<z.ZodEnum<["native_session", "oauth_token_env", "api_key_env", "api_key_flag", "provider_auth_file", "none"]>>>;
+    /** Credential profile the attempt ACTUALLY ran under (INV-135), from the
+     * adapter's per-event stamp; rotation makes this differ from the run's
+     * requested id. Null = engine-default credentials or never disclosed. */
+    profile_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    /** Model hint the engine actually SENT this attempt (requested side of the
+     * model x route truth; observed_model is the disclosed side). */
+    requested_model: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    request_requirements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        capability: z.ZodEnum<["browser", "path_deny"]>;
+        harness_id: z.ZodString;
+        eligible: z.ZodBoolean;
+        requested: z.ZodBoolean;
+        effective: z.ZodBoolean;
+        reason: z.ZodEnum<["not_requested", "effective", "manifest_unsupported", "web_policy_off", "access_profile_incompatible", "postdiff_only"]>;
+        evidence_refs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        requested: boolean;
+        effective: boolean;
+        harness_id: string;
+        reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
+        evidence_refs: string[];
+        eligible: boolean;
+        capability: "browser" | "path_deny";
+    }, {
+        requested: boolean;
+        effective: boolean;
+        harness_id: string;
+        reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
+        eligible: boolean;
+        capability: "browser" | "path_deny";
+        evidence_refs?: string[] | undefined;
+    }>, "many">>;
     web: z.ZodObject<{
         required: z.ZodDefault<z.ZodBoolean>;
         /** Requested policy for the run. */
@@ -129,24 +215,24 @@ export declare const AttemptTelemetryRecord: z.ZodObject<{
         target: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         error_summary: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
-        status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+        status: "failed" | "none" | "attempted" | "satisfied" | "unverified";
         target: string | null;
         error_summary: string | null;
         tool: string | null;
         required: boolean;
-        attempted: boolean;
         policy: "off" | "auto" | "cached" | "live";
         effective_mode: "off" | "auto" | "cached" | "live";
+        attempted: boolean;
         satisfied: boolean;
     }, {
-        status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | undefined;
+        status?: "failed" | "none" | "attempted" | "satisfied" | "unverified" | undefined;
         target?: string | null | undefined;
         error_summary?: string | null | undefined;
         tool?: string | null | undefined;
         required?: boolean | undefined;
-        attempted?: boolean | undefined;
         policy?: "off" | "auto" | "cached" | "live" | undefined;
         effective_mode?: "off" | "auto" | "cached" | "live" | undefined;
+        attempted?: boolean | undefined;
         satisfied?: boolean | undefined;
     }>;
     /** Bounded by the writer (most recent first when truncated; `tool_errors_total` keeps the true count). */
@@ -159,16 +245,16 @@ export declare const AttemptTelemetryRecord: z.ZodObject<{
         recovered: z.ZodDefault<z.ZodBoolean>;
         tool_use_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
-        kind: "file" | "web" | "command" | "mcp" | "search" | "other";
+        kind: "web" | "file" | "command" | "mcp" | "search" | "other";
         target: string | null;
-        tool: string;
         summary: string;
+        tool: string;
         recovered: boolean;
         tool_use_id: string | null;
     }, {
-        tool: string;
         summary: string;
-        kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
+        tool: string;
+        kind?: "web" | "file" | "command" | "mcp" | "search" | "other" | undefined;
         target?: string | null | undefined;
         recovered?: boolean | undefined;
         tool_use_id?: string | null | undefined;
@@ -199,48 +285,80 @@ export declare const AttemptTelemetryRecord: z.ZodObject<{
         tool_warnings_count: z.ZodDefault<z.ZodNumber>;
         status: z.ZodDefault<z.ZodEnum<["success", "success_with_warnings", "blocked", "failed"]>>;
     }, "strip", z.ZodTypeAny, {
-        status: "success" | "blocked" | "failed" | "success_with_warnings";
+        status: "failed" | "success" | "blocked" | "success_with_warnings";
         gates_passed: boolean | null;
         deliverable_present: boolean;
         harness_errored: boolean;
         web_required_unsatisfied: boolean;
         tool_warnings_count: number;
     }, {
-        status?: "success" | "blocked" | "failed" | "success_with_warnings" | undefined;
+        status?: "failed" | "success" | "blocked" | "success_with_warnings" | undefined;
         gates_passed?: boolean | null | undefined;
         deliverable_present?: boolean | undefined;
         harness_errored?: boolean | undefined;
         web_required_unsatisfied?: boolean | undefined;
         tool_warnings_count?: number | undefined;
     }>>;
+    /** Token usage summed across this attempt's usage events. */
+    usage: z.ZodDefault<z.ZodObject<{
+        input_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        output_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        cached_input_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        input_tokens: number | null;
+        output_tokens: number | null;
+        cached_input_tokens: number | null;
+    }, {
+        input_tokens?: number | null | undefined;
+        output_tokens?: number | null | undefined;
+        cached_input_tokens?: number | null | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
+    profile_id: string | null;
     harness_id: string;
     web: {
-        status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+        status: "failed" | "none" | "attempted" | "satisfied" | "unverified";
         target: string | null;
         error_summary: string | null;
         tool: string | null;
         required: boolean;
-        attempted: boolean;
         policy: "off" | "auto" | "cached" | "live";
         effective_mode: "off" | "auto" | "cached" | "live";
+        attempted: boolean;
         satisfied: boolean;
     };
+    usage: {
+        input_tokens: number | null;
+        output_tokens: number | null;
+        cached_input_tokens: number | null;
+    };
     observed_model: string | null;
     attempt_id: string;
     outcome: {
-        status: "success" | "blocked" | "failed" | "success_with_warnings";
+        status: "failed" | "success" | "blocked" | "success_with_warnings";
         gates_passed: boolean | null;
         deliverable_present: boolean;
         harness_errored: boolean;
         web_required_unsatisfied: boolean;
         tool_warnings_count: number;
     };
+    requested_model: string | null;
+    auth_mode: "unknown" | "api_key" | "local_session" | null;
+    auth_source: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null;
+    request_requirements: {
+        requested: boolean;
+        effective: boolean;
+        harness_id: string;
+        reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
+        evidence_refs: string[];
+        eligible: boolean;
+        capability: "browser" | "path_deny";
+    }[];
     tool_errors: {
-        kind: "file" | "web" | "command" | "mcp" | "search" | "other";
+        kind: "web" | "file" | "command" | "mcp" | "search" | "other";
         target: string | null;
-        tool: string;
         summary: string;
+        tool: string;
         recovered: boolean;
         tool_use_id: string | null;
     }[];
@@ -255,30 +373,48 @@ export declare const AttemptTelemetryRecord: z.ZodObject<{
 }, {
     harness_id: string;
     web: {
-        status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | undefined;
+        status?: "failed" | "none" | "attempted" | "satisfied" | "unverified" | undefined;
         target?: string | null | undefined;
         error_summary?: string | null | undefined;
         tool?: string | null | undefined;
         required?: boolean | undefined;
-        attempted?: boolean | undefined;
         policy?: "off" | "auto" | "cached" | "live" | undefined;
         effective_mode?: "off" | "auto" | "cached" | "live" | undefined;
+        attempted?: boolean | undefined;
         satisfied?: boolean | undefined;
     };
     attempt_id: string;
+    profile_id?: string | null | undefined;
+    usage?: {
+        input_tokens?: number | null | undefined;
+        output_tokens?: number | null | undefined;
+        cached_input_tokens?: number | null | undefined;
+    } | undefined;
     observed_model?: string | null | undefined;
     outcome?: {
-        status?: "success" | "blocked" | "failed" | "success_with_warnings" | undefined;
+        status?: "failed" | "success" | "blocked" | "success_with_warnings" | undefined;
         gates_passed?: boolean | null | undefined;
         deliverable_present?: boolean | undefined;
         harness_errored?: boolean | undefined;
         web_required_unsatisfied?: boolean | undefined;
         tool_warnings_count?: number | undefined;
     } | undefined;
+    requested_model?: string | null | undefined;
+    auth_mode?: "unknown" | "api_key" | "local_session" | null | undefined;
+    auth_source?: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null | undefined;
+    request_requirements?: {
+        requested: boolean;
+        effective: boolean;
+        harness_id: string;
+        reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
+        eligible: boolean;
+        capability: "browser" | "path_deny";
+        evidence_refs?: string[] | undefined;
+    }[] | undefined;
     tool_errors?: {
-        tool: string;
         summary: string;
-        kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
+        tool: string;
+        kind?: "web" | "file" | "command" | "mcp" | "search" | "other" | undefined;
         target?: string | null | undefined;
         recovered?: boolean | undefined;
         tool_use_id?: string | null | undefined;
@@ -319,24 +455,24 @@ export declare const RunTelemetry: z.ZodObject<{
         target: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         error_summary: z.ZodDefault<z.ZodNullable<z.ZodString>>;
     }, "strip", z.ZodTypeAny, {
-        status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+        status: "failed" | "none" | "attempted" | "satisfied" | "unverified";
         target: string | null;
         error_summary: string | null;
         tool: string | null;
         required: boolean;
-        attempted: boolean;
         policy: "off" | "auto" | "cached" | "live";
         effective_mode: "off" | "auto" | "cached" | "live";
+        attempted: boolean;
         satisfied: boolean;
     }, {
-        status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | undefined;
+        status?: "failed" | "none" | "attempted" | "satisfied" | "unverified" | undefined;
         target?: string | null | undefined;
         error_summary?: string | null | undefined;
         tool?: string | null | undefined;
         required?: boolean | undefined;
-        attempted?: boolean | undefined;
         policy?: "off" | "auto" | "cached" | "live" | undefined;
         effective_mode?: "off" | "auto" | "cached" | "live" | undefined;
+        attempted?: boolean | undefined;
         satisfied?: boolean | undefined;
     }>;
     attempts: z.ZodDefault<z.ZodArray<z.ZodObject<{
@@ -348,6 +484,51 @@ export declare const RunTelemetry: z.ZodObject<{
          * unverified, never as a guess.
          */
         observed_model: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        /**
+         * Auth route the attempt ACTUALLY ran under (route evidence, like
+         * observed_model): adapters disclose their chosen route as a typed
+         * `auth_route` payload on the started event, sourced from the credential
+         * material itself (codex: the seeded auth.json's own auth_mode; claude:
+         * the selected credentials/OAuth/api-key route). Null when never
+         * disclosed — subscription-vs-API quota attribution must treat that as
+         * unknown, never guess from manifests.
+         */
+        auth_mode: z.ZodDefault<z.ZodNullable<z.ZodEnum<["local_session", "api_key", "unknown"]>>>;
+        /** Concrete credential source the attempt disclosed alongside its route
+         * (route evidence; null = undisclosed, never guessed). */
+        auth_source: z.ZodDefault<z.ZodNullable<z.ZodEnum<["native_session", "oauth_token_env", "api_key_env", "api_key_flag", "provider_auth_file", "none"]>>>;
+        /** Credential profile the attempt ACTUALLY ran under (INV-135), from the
+         * adapter's per-event stamp; rotation makes this differ from the run's
+         * requested id. Null = engine-default credentials or never disclosed. */
+        profile_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        /** Model hint the engine actually SENT this attempt (requested side of the
+         * model x route truth; observed_model is the disclosed side). */
+        requested_model: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        request_requirements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            capability: z.ZodEnum<["browser", "path_deny"]>;
+            harness_id: z.ZodString;
+            eligible: z.ZodBoolean;
+            requested: z.ZodBoolean;
+            effective: z.ZodBoolean;
+            reason: z.ZodEnum<["not_requested", "effective", "manifest_unsupported", "web_policy_off", "access_profile_incompatible", "postdiff_only"]>;
+            evidence_refs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            requested: boolean;
+            effective: boolean;
+            harness_id: string;
+            reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
+            evidence_refs: string[];
+            eligible: boolean;
+            capability: "browser" | "path_deny";
+        }, {
+            requested: boolean;
+            effective: boolean;
+            harness_id: string;
+            reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
+            eligible: boolean;
+            capability: "browser" | "path_deny";
+            evidence_refs?: string[] | undefined;
+        }>, "many">>;
         web: z.ZodObject<{
             required: z.ZodDefault<z.ZodBoolean>;
             /** Requested policy for the run. */
@@ -361,24 +542,24 @@ export declare const RunTelemetry: z.ZodObject<{
             target: z.ZodDefault<z.ZodNullable<z.ZodString>>;
             error_summary: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
-            status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+            status: "failed" | "none" | "attempted" | "satisfied" | "unverified";
             target: string | null;
             error_summary: string | null;
             tool: string | null;
             required: boolean;
-            attempted: boolean;
             policy: "off" | "auto" | "cached" | "live";
             effective_mode: "off" | "auto" | "cached" | "live";
+            attempted: boolean;
             satisfied: boolean;
         }, {
-            status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | undefined;
+            status?: "failed" | "none" | "attempted" | "satisfied" | "unverified" | undefined;
             target?: string | null | undefined;
             error_summary?: string | null | undefined;
             tool?: string | null | undefined;
             required?: boolean | undefined;
-            attempted?: boolean | undefined;
             policy?: "off" | "auto" | "cached" | "live" | undefined;
             effective_mode?: "off" | "auto" | "cached" | "live" | undefined;
+            attempted?: boolean | undefined;
             satisfied?: boolean | undefined;
         }>;
         /** Bounded by the writer (most recent first when truncated; `tool_errors_total` keeps the true count). */
@@ -391,16 +572,16 @@ export declare const RunTelemetry: z.ZodObject<{
             recovered: z.ZodDefault<z.ZodBoolean>;
             tool_use_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
         }, "strip", z.ZodTypeAny, {
-            kind: "file" | "web" | "command" | "mcp" | "search" | "other";
+            kind: "web" | "file" | "command" | "mcp" | "search" | "other";
             target: string | null;
-            tool: string;
             summary: string;
+            tool: string;
             recovered: boolean;
             tool_use_id: string | null;
         }, {
-            tool: string;
             summary: string;
-            kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
+            tool: string;
+            kind?: "web" | "file" | "command" | "mcp" | "search" | "other" | undefined;
             target?: string | null | undefined;
             recovered?: boolean | undefined;
             tool_use_id?: string | null | undefined;
@@ -431,48 +612,80 @@ export declare const RunTelemetry: z.ZodObject<{
             tool_warnings_count: z.ZodDefault<z.ZodNumber>;
             status: z.ZodDefault<z.ZodEnum<["success", "success_with_warnings", "blocked", "failed"]>>;
         }, "strip", z.ZodTypeAny, {
-            status: "success" | "blocked" | "failed" | "success_with_warnings";
+            status: "failed" | "success" | "blocked" | "success_with_warnings";
             gates_passed: boolean | null;
             deliverable_present: boolean;
             harness_errored: boolean;
             web_required_unsatisfied: boolean;
             tool_warnings_count: number;
         }, {
-            status?: "success" | "blocked" | "failed" | "success_with_warnings" | undefined;
+            status?: "failed" | "success" | "blocked" | "success_with_warnings" | undefined;
             gates_passed?: boolean | null | undefined;
             deliverable_present?: boolean | undefined;
             harness_errored?: boolean | undefined;
             web_required_unsatisfied?: boolean | undefined;
             tool_warnings_count?: number | undefined;
         }>>;
+        /** Token usage summed across this attempt's usage events. */
+        usage: z.ZodDefault<z.ZodObject<{
+            input_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            output_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+            cached_input_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            input_tokens: number | null;
+            output_tokens: number | null;
+            cached_input_tokens: number | null;
+        }, {
+            input_tokens?: number | null | undefined;
+            output_tokens?: number | null | undefined;
+            cached_input_tokens?: number | null | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
+        profile_id: string | null;
         harness_id: string;
         web: {
-            status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+            status: "failed" | "none" | "attempted" | "satisfied" | "unverified";
             target: string | null;
             error_summary: string | null;
             tool: string | null;
             required: boolean;
-            attempted: boolean;
             policy: "off" | "auto" | "cached" | "live";
             effective_mode: "off" | "auto" | "cached" | "live";
+            attempted: boolean;
             satisfied: boolean;
         };
+        usage: {
+            input_tokens: number | null;
+            output_tokens: number | null;
+            cached_input_tokens: number | null;
+        };
         observed_model: string | null;
         attempt_id: string;
         outcome: {
-            status: "success" | "blocked" | "failed" | "success_with_warnings";
+            status: "failed" | "success" | "blocked" | "success_with_warnings";
             gates_passed: boolean | null;
             deliverable_present: boolean;
             harness_errored: boolean;
             web_required_unsatisfied: boolean;
             tool_warnings_count: number;
         };
+        requested_model: string | null;
+        auth_mode: "unknown" | "api_key" | "local_session" | null;
+        auth_source: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null;
+        request_requirements: {
+            requested: boolean;
+            effective: boolean;
+            harness_id: string;
+            reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
+            evidence_refs: string[];
+            eligible: boolean;
+            capability: "browser" | "path_deny";
+        }[];
         tool_errors: {
-            kind: "file" | "web" | "command" | "mcp" | "search" | "other";
+            kind: "web" | "file" | "command" | "mcp" | "search" | "other";
             target: string | null;
-            tool: string;
             summary: string;
+            tool: string;
             recovered: boolean;
             tool_use_id: string | null;
         }[];
@@ -487,30 +700,48 @@ export declare const RunTelemetry: z.ZodObject<{
     }, {
         harness_id: string;
         web: {
-            status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | undefined;
+            status?: "failed" | "none" | "attempted" | "satisfied" | "unverified" | undefined;
             target?: string | null | undefined;
             error_summary?: string | null | undefined;
             tool?: string | null | undefined;
             required?: boolean | undefined;
-            attempted?: boolean | undefined;
             policy?: "off" | "auto" | "cached" | "live" | undefined;
             effective_mode?: "off" | "auto" | "cached" | "live" | undefined;
+            attempted?: boolean | undefined;
             satisfied?: boolean | undefined;
         };
         attempt_id: string;
+        profile_id?: string | null | undefined;
+        usage?: {
+            input_tokens?: number | null | undefined;
+            output_tokens?: number | null | undefined;
+            cached_input_tokens?: number | null | undefined;
+        } | undefined;
         observed_model?: string | null | undefined;
         outcome?: {
-            status?: "success" | "blocked" | "failed" | "success_with_warnings" | undefined;
+            status?: "failed" | "success" | "blocked" | "success_with_warnings" | undefined;
             gates_passed?: boolean | null | undefined;
             deliverable_present?: boolean | undefined;
             harness_errored?: boolean | undefined;
             web_required_unsatisfied?: boolean | undefined;
             tool_warnings_count?: number | undefined;
         } | undefined;
+        requested_model?: string | null | undefined;
+        auth_mode?: "unknown" | "api_key" | "local_session" | null | undefined;
+        auth_source?: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null | undefined;
+        request_requirements?: {
+            requested: boolean;
+            effective: boolean;
+            harness_id: string;
+            reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
+            eligible: boolean;
+            capability: "browser" | "path_deny";
+            evidence_refs?: string[] | undefined;
+        }[] | undefined;
         tool_errors?: {
-            tool: string;
             summary: string;
-            kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
+            tool: string;
+            kind?: "web" | "file" | "command" | "mcp" | "search" | "other" | undefined;
             target?: string | null | undefined;
             recovered?: boolean | undefined;
             tool_use_id?: string | null | undefined;
@@ -524,55 +755,167 @@ export declare const RunTelemetry: z.ZodObject<{
             retry_delay_ms?: number | null | undefined;
         }[] | undefined;
     }>, "many">>;
+    request_requirements: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        capability: z.ZodEnum<["browser", "path_deny"]>;
+        harness_id: z.ZodString;
+        eligible: z.ZodBoolean;
+        requested: z.ZodBoolean;
+        effective: z.ZodBoolean;
+        reason: z.ZodEnum<["not_requested", "effective", "manifest_unsupported", "web_policy_off", "access_profile_incompatible", "postdiff_only"]>;
+        evidence_refs: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        requested: boolean;
+        effective: boolean;
+        harness_id: string;
+        reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
+        evidence_refs: string[];
+        eligible: boolean;
+        capability: "browser" | "path_deny";
+    }, {
+        requested: boolean;
+        effective: boolean;
+        harness_id: string;
+        reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
+        eligible: boolean;
+        capability: "browser" | "path_deny";
+        evidence_refs?: string[] | undefined;
+    }>, "many">>;
     /** Sum of attempt outcome warnings; surfaces render this separately from terminal state. */
     tool_warnings_total: z.ZodDefault<z.ZodNumber>;
+    /** Token usage summed across every attempt (candidates + synthesis), the
+     * same accounting scope as spendUsd. Each field null until some attempt
+     * reports it. Not a grand total (see TokenUsage). */
+    usage_totals: z.ZodDefault<z.ZodObject<{
+        input_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        output_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        cached_input_tokens: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        input_tokens: number | null;
+        output_tokens: number | null;
+        cached_input_tokens: number | null;
+    }, {
+        input_tokens?: number | null | undefined;
+        output_tokens?: number | null | undefined;
+        cached_input_tokens?: number | null | undefined;
+    }>>;
+    /** The run's auth ROUTE RECEIPT (INV-061 disclosure): requested preference,
+     * the effective route/source the deciding attempt disclosed, and a
+     * deterministic reason — computed ONCE here; summary/CLI project it
+     * verbatim. Null only on legacy artifacts written before this field. */
+    auth_route: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+        requested: z.ZodEnum<["subscription", "api_key", "auto"]>;
+        effective: z.ZodDefault<z.ZodNullable<z.ZodEnum<["local_session", "api_key", "unknown"]>>>;
+        source: z.ZodDefault<z.ZodNullable<z.ZodEnum<["native_session", "oauth_token_env", "api_key_env", "api_key_flag", "provider_auth_file", "none"]>>>;
+        reason: z.ZodEnum<["as_requested", "native_first", "no_native_session_fallback", "requested_route_unavailable", "undisclosed"]>;
+        harness_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        attempt_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        /** Credential profile the deciding attempt ran under (INV-135);
+         * null = engine-default credentials. */
+        profile_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        /** Typed model mismatch on the deciding attempt (Quiz-2a): the engine
+         * SENT requested but the stream DISCLOSED observed. Null when they
+         * match or either side is unknown — never inferred. Distinct from the
+         * reviewer-panel same_model_fallback route proof. */
+        model_mismatch: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+            requested: z.ZodString;
+            observed: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            requested: string;
+            observed: string;
+        }, {
+            requested: string;
+            observed: string;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        source: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null;
+        requested: "auto" | "subscription" | "api_key";
+        effective: "unknown" | "api_key" | "local_session" | null;
+        profile_id: string | null;
+        harness_id: string | null;
+        reason: "as_requested" | "native_first" | "no_native_session_fallback" | "requested_route_unavailable" | "undisclosed";
+        attempt_id: string | null;
+        model_mismatch: {
+            requested: string;
+            observed: string;
+        } | null;
+    }, {
+        requested: "auto" | "subscription" | "api_key";
+        reason: "as_requested" | "native_first" | "no_native_session_fallback" | "requested_route_unavailable" | "undisclosed";
+        source?: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null | undefined;
+        effective?: "unknown" | "api_key" | "local_session" | null | undefined;
+        profile_id?: string | null | undefined;
+        harness_id?: string | null | undefined;
+        attempt_id?: string | null | undefined;
+        model_mismatch?: {
+            requested: string;
+            observed: string;
+        } | null | undefined;
+    }>>>;
     generated_at: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    external_context_policy: "off" | "auto" | "cached" | "live";
     web: {
-        status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+        status: "failed" | "none" | "attempted" | "satisfied" | "unverified";
         target: string | null;
         error_summary: string | null;
         tool: string | null;
         required: boolean;
-        attempted: boolean;
         policy: "off" | "auto" | "cached" | "live";
         effective_mode: "off" | "auto" | "cached" | "live";
+        attempted: boolean;
         satisfied: boolean;
     };
     mode: "ask" | "plan" | "audit" | "agent" | "orchestrate";
     schema_version: 2;
+    external_context_policy: "off" | "auto" | "cached" | "live";
     run_id: string;
     task_id: string;
     web_required: boolean;
     attempts: {
+        profile_id: string | null;
         harness_id: string;
         web: {
-            status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+            status: "failed" | "none" | "attempted" | "satisfied" | "unverified";
             target: string | null;
             error_summary: string | null;
             tool: string | null;
             required: boolean;
-            attempted: boolean;
             policy: "off" | "auto" | "cached" | "live";
             effective_mode: "off" | "auto" | "cached" | "live";
+            attempted: boolean;
             satisfied: boolean;
         };
+        usage: {
+            input_tokens: number | null;
+            output_tokens: number | null;
+            cached_input_tokens: number | null;
+        };
         observed_model: string | null;
         attempt_id: string;
         outcome: {
-            status: "success" | "blocked" | "failed" | "success_with_warnings";
+            status: "failed" | "success" | "blocked" | "success_with_warnings";
             gates_passed: boolean | null;
             deliverable_present: boolean;
             harness_errored: boolean;
             web_required_unsatisfied: boolean;
             tool_warnings_count: number;
         };
+        requested_model: string | null;
+        auth_mode: "unknown" | "api_key" | "local_session" | null;
+        auth_source: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null;
+        request_requirements: {
+            requested: boolean;
+            effective: boolean;
+            harness_id: string;
+            reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
+            evidence_refs: string[];
+            eligible: boolean;
+            capability: "browser" | "path_deny";
+        }[];
         tool_errors: {
-            kind: "file" | "web" | "command" | "mcp" | "search" | "other";
+            kind: "web" | "file" | "command" | "mcp" | "search" | "other";
             target: string | null;
-            tool: string;
             summary: string;
+            tool: string;
             recovered: boolean;
             tool_use_id: string | null;
         }[];
@@ -585,61 +928,106 @@ export declare const RunTelemetry: z.ZodObject<{
             retry_delay_ms: number | null;
         }[];
     }[];
+    generated_at: string;
+    request_requirements: {
+        requested: boolean;
+        effective: boolean;
+        harness_id: string;
+        reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
+        evidence_refs: string[];
+        eligible: boolean;
+        capability: "browser" | "path_deny";
+    }[];
     requested_access: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native";
     effective_access: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native";
     effective_web_mode: "off" | "auto" | "cached" | "live";
     final_attempt_id: string | null;
     tool_warnings_total: number;
-    generated_at: string;
+    usage_totals: {
+        input_tokens: number | null;
+        output_tokens: number | null;
+        cached_input_tokens: number | null;
+    };
+    auth_route: {
+        source: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null;
+        requested: "auto" | "subscription" | "api_key";
+        effective: "unknown" | "api_key" | "local_session" | null;
+        profile_id: string | null;
+        harness_id: string | null;
+        reason: "as_requested" | "native_first" | "no_native_session_fallback" | "requested_route_unavailable" | "undisclosed";
+        attempt_id: string | null;
+        model_mismatch: {
+            requested: string;
+            observed: string;
+        } | null;
+    } | null;
 }, {
-    external_context_policy: "off" | "auto" | "cached" | "live";
     web: {
-        status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | undefined;
+        status?: "failed" | "none" | "attempted" | "satisfied" | "unverified" | undefined;
         target?: string | null | undefined;
         error_summary?: string | null | undefined;
         tool?: string | null | undefined;
         required?: boolean | undefined;
-        attempted?: boolean | undefined;
         policy?: "off" | "auto" | "cached" | "live" | undefined;
         effective_mode?: "off" | "auto" | "cached" | "live" | undefined;
+        attempted?: boolean | undefined;
         satisfied?: boolean | undefined;
     };
     mode: "ask" | "plan" | "audit" | "agent" | "orchestrate";
     schema_version: 2;
+    external_context_policy: "off" | "auto" | "cached" | "live";
     run_id: string;
     task_id: string;
+    generated_at: string;
     requested_access: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native";
     effective_access: "readonly" | "workspace_write" | "full" | "external_sandbox_full" | "inherit_native";
     effective_web_mode: "off" | "auto" | "cached" | "live";
-    generated_at: string;
     web_required?: boolean | undefined;
     attempts?: {
         harness_id: string;
         web: {
-            status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | undefined;
+            status?: "failed" | "none" | "attempted" | "satisfied" | "unverified" | undefined;
             target?: string | null | undefined;
             error_summary?: string | null | undefined;
             tool?: string | null | undefined;
             required?: boolean | undefined;
-            attempted?: boolean | undefined;
             policy?: "off" | "auto" | "cached" | "live" | undefined;
             effective_mode?: "off" | "auto" | "cached" | "live" | undefined;
+            attempted?: boolean | undefined;
             satisfied?: boolean | undefined;
         };
         attempt_id: string;
+        profile_id?: string | null | undefined;
+        usage?: {
+            input_tokens?: number | null | undefined;
+            output_tokens?: number | null | undefined;
+            cached_input_tokens?: number | null | undefined;
+        } | undefined;
         observed_model?: string | null | undefined;
         outcome?: {
-            status?: "success" | "blocked" | "failed" | "success_with_warnings" | undefined;
+            status?: "failed" | "success" | "blocked" | "success_with_warnings" | undefined;
             gates_passed?: boolean | null | undefined;
             deliverable_present?: boolean | undefined;
             harness_errored?: boolean | undefined;
             web_required_unsatisfied?: boolean | undefined;
             tool_warnings_count?: number | undefined;
         } | undefined;
+        requested_model?: string | null | undefined;
+        auth_mode?: "unknown" | "api_key" | "local_session" | null | undefined;
+        auth_source?: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null | undefined;
+        request_requirements?: {
+            requested: boolean;
+            effective: boolean;
+            harness_id: string;
+            reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
+            eligible: boolean;
+            capability: "browser" | "path_deny";
+            evidence_refs?: string[] | undefined;
+        }[] | undefined;
         tool_errors?: {
-            tool: string;
             summary: string;
-            kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
+            tool: string;
+            kind?: "web" | "file" | "command" | "mcp" | "search" | "other" | undefined;
             target?: string | null | undefined;
             recovered?: boolean | undefined;
             tool_use_id?: string | null | undefined;
@@ -653,8 +1041,35 @@ export declare const RunTelemetry: z.ZodObject<{
             retry_delay_ms?: number | null | undefined;
         }[] | undefined;
     }[] | undefined;
+    request_requirements?: {
+        requested: boolean;
+        effective: boolean;
+        harness_id: string;
+        reason: "effective" | "not_requested" | "manifest_unsupported" | "web_policy_off" | "access_profile_incompatible" | "postdiff_only";
+        eligible: boolean;
+        capability: "browser" | "path_deny";
+        evidence_refs?: string[] | undefined;
+    }[] | undefined;
     final_attempt_id?: string | null | undefined;
     tool_warnings_total?: number | undefined;
+    usage_totals?: {
+        input_tokens?: number | null | undefined;
+        output_tokens?: number | null | undefined;
+        cached_input_tokens?: number | null | undefined;
+    } | undefined;
+    auth_route?: {
+        requested: "auto" | "subscription" | "api_key";
+        reason: "as_requested" | "native_first" | "no_native_session_fallback" | "requested_route_unavailable" | "undisclosed";
+        source?: "native_session" | "oauth_token_env" | "api_key_env" | "api_key_flag" | "provider_auth_file" | "none" | null | undefined;
+        effective?: "unknown" | "api_key" | "local_session" | null | undefined;
+        profile_id?: string | null | undefined;
+        harness_id?: string | null | undefined;
+        attempt_id?: string | null | undefined;
+        model_mismatch?: {
+            requested: string;
+            observed: string;
+        } | null | undefined;
+    } | null | undefined;
 }>;
 export type RunTelemetry = z.infer<typeof RunTelemetry>;
 //# sourceMappingURL=telemetry.d.ts.map