@claudexor/schema 1.0.0

package/dist/telemetry.d.ts

@@ -0,0 +1,660 @@
+import { z } from "zod";
+/**
+ * Run telemetry artifact (`final/telemetry.yaml`).
+ *
+ * The orchestrator is the ONLY computer of web/tool evidence. Surfaces
+ * (control-api, CLI, app) project this artifact; they must not re-derive
+ * evidence from raw events. Legacy runs without the artifact render an honest
+ * "telemetry unavailable" state instead of a recomputed guess.
+ */
+export declare const WebEvidenceStatus: z.ZodEnum<["none", "attempted", "satisfied", "failed", "unverified"]>;
+export type WebEvidenceStatus = z.infer<typeof WebEvidenceStatus>;
+export declare const WebEvidenceRecord: z.ZodObject<{
+    required: z.ZodDefault<z.ZodBoolean>;
+    /** Requested policy for the run. */
+    policy: z.ZodDefault<z.ZodEnum<["off", "auto", "cached", "live"]>>;
+    /** Mode actually executed by the harness route (e.g. claude `cached` upgrades to `live`, disclosed). */
+    effective_mode: z.ZodDefault<z.ZodEnum<["off", "auto", "cached", "live"]>>;
+    attempted: z.ZodDefault<z.ZodBoolean>;
+    satisfied: z.ZodDefault<z.ZodBoolean>;
+    status: z.ZodDefault<z.ZodEnum<["none", "attempted", "satisfied", "failed", "unverified"]>>;
+    tool: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    target: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    error_summary: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+    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";
+    satisfied: boolean;
+}, {
+    status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | 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;
+    satisfied?: boolean | undefined;
+}>;
+export type WebEvidenceRecord = z.infer<typeof WebEvidenceRecord>;
+export declare const ToolErrorRecord: z.ZodObject<{
+    tool: z.ZodString;
+    kind: z.ZodDefault<z.ZodEnum<["web", "file", "command", "mcp", "search", "other"]>>;
+    target: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    summary: z.ZodString;
+    /** True when a later successful result of the same tool exists in the same attempt. */
+    recovered: z.ZodDefault<z.ZodBoolean>;
+    tool_use_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    kind: "file" | "web" | "command" | "mcp" | "search" | "other";
+    target: string | null;
+    tool: string;
+    summary: string;
+    recovered: boolean;
+    tool_use_id: string | null;
+}, {
+    tool: string;
+    summary: string;
+    kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
+    target?: string | null | undefined;
+    recovered?: boolean | undefined;
+    tool_use_id?: string | null | undefined;
+}>;
+export type ToolErrorRecord = z.infer<typeof ToolErrorRecord>;
+export declare const TransientFailureRecord: z.ZodObject<{
+    kind: z.ZodDefault<z.ZodEnum<["network", "stream_disconnect", "service_unavailable", "timeout", "unknown"]>>;
+    retry_delay_ms: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    kind: "unknown" | "network" | "stream_disconnect" | "service_unavailable" | "timeout";
+    retry_delay_ms: number | null;
+}, {
+    kind?: "unknown" | "network" | "stream_disconnect" | "service_unavailable" | "timeout" | undefined;
+    retry_delay_ms?: number | null | undefined;
+}>;
+export type TransientFailureRecord = z.infer<typeof TransientFailureRecord>;
+export declare const AttemptOutcomeStatus: z.ZodEnum<["success", "success_with_warnings", "blocked", "failed"]>;
+export type AttemptOutcomeStatus = z.infer<typeof AttemptOutcomeStatus>;
+/**
+ * Contract/outcome truth for one attempt. Tool errors are tracked separately
+ * from whether the attempt produced the work product the intent asked for.
+ */
+export declare const AttemptOutcome: z.ZodObject<{
+    deliverable_present: z.ZodDefault<z.ZodBoolean>;
+    gates_passed: z.ZodDefault<z.ZodNullable<z.ZodBoolean>>;
+    harness_errored: z.ZodDefault<z.ZodBoolean>;
+    web_required_unsatisfied: z.ZodDefault<z.ZodBoolean>;
+    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";
+    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;
+    gates_passed?: boolean | null | undefined;
+    deliverable_present?: boolean | undefined;
+    harness_errored?: boolean | undefined;
+    web_required_unsatisfied?: boolean | undefined;
+    tool_warnings_count?: number | undefined;
+}>;
+export type AttemptOutcome = z.infer<typeof AttemptOutcome>;
+export declare const AttemptTelemetryRecord: z.ZodObject<{
+    attempt_id: z.ZodString;
+    harness_id: z.ZodString;
+    /**
+     * Model identity the harness stream actually reported (route evidence).
+     * Null when the stream never disclosed one; surfaces must render that as
+     * unverified, never as a guess.
+     */
+    observed_model: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    web: z.ZodObject<{
+        required: z.ZodDefault<z.ZodBoolean>;
+        /** Requested policy for the run. */
+        policy: z.ZodDefault<z.ZodEnum<["off", "auto", "cached", "live"]>>;
+        /** Mode actually executed by the harness route (e.g. claude `cached` upgrades to `live`, disclosed). */
+        effective_mode: z.ZodDefault<z.ZodEnum<["off", "auto", "cached", "live"]>>;
+        attempted: z.ZodDefault<z.ZodBoolean>;
+        satisfied: z.ZodDefault<z.ZodBoolean>;
+        status: z.ZodDefault<z.ZodEnum<["none", "attempted", "satisfied", "failed", "unverified"]>>;
+        tool: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        target: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        error_summary: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+        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";
+        satisfied: boolean;
+    }, {
+        status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | 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;
+        satisfied?: boolean | undefined;
+    }>;
+    /** Bounded by the writer (most recent first when truncated; `tool_errors_total` keeps the true count). */
+    tool_errors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        tool: z.ZodString;
+        kind: z.ZodDefault<z.ZodEnum<["web", "file", "command", "mcp", "search", "other"]>>;
+        target: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        summary: z.ZodString;
+        /** True when a later successful result of the same tool exists in the same attempt. */
+        recovered: z.ZodDefault<z.ZodBoolean>;
+        tool_use_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "file" | "web" | "command" | "mcp" | "search" | "other";
+        target: string | null;
+        tool: string;
+        summary: string;
+        recovered: boolean;
+        tool_use_id: string | null;
+    }, {
+        tool: string;
+        summary: string;
+        kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
+        target?: string | null | undefined;
+        recovered?: boolean | undefined;
+        tool_use_id?: string | null | undefined;
+    }>, "many">>;
+    tool_errors_total: z.ZodDefault<z.ZodNumber>;
+    unrecovered_tool_errors: z.ZodDefault<z.ZodNumber>;
+    /** tool_result events that arrived WITHOUT a status field (never treated as ok). */
+    statusless_tool_results: z.ZodDefault<z.ZodNumber>;
+    /** Native lines/events the adapter could not parse or did not recognize (never silently zero). */
+    dropped_events: z.ZodDefault<z.ZodNumber>;
+    /** Adapter-declared transient failures that informed bounded retry policy. */
+    transient_failures: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodDefault<z.ZodEnum<["network", "stream_disconnect", "service_unavailable", "timeout", "unknown"]>>;
+        retry_delay_ms: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "unknown" | "network" | "stream_disconnect" | "service_unavailable" | "timeout";
+        retry_delay_ms: number | null;
+    }, {
+        kind?: "unknown" | "network" | "stream_disconnect" | "service_unavailable" | "timeout" | undefined;
+        retry_delay_ms?: number | null | undefined;
+    }>, "many">>;
+    /** Contract/outcome projection for this attempt. */
+    outcome: z.ZodDefault<z.ZodObject<{
+        deliverable_present: z.ZodDefault<z.ZodBoolean>;
+        gates_passed: z.ZodDefault<z.ZodNullable<z.ZodBoolean>>;
+        harness_errored: z.ZodDefault<z.ZodBoolean>;
+        web_required_unsatisfied: z.ZodDefault<z.ZodBoolean>;
+        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";
+        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;
+        gates_passed?: boolean | null | undefined;
+        deliverable_present?: boolean | undefined;
+        harness_errored?: boolean | undefined;
+        web_required_unsatisfied?: boolean | undefined;
+        tool_warnings_count?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    harness_id: string;
+    web: {
+        status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+        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";
+        satisfied: boolean;
+    };
+    observed_model: string | null;
+    attempt_id: string;
+    outcome: {
+        status: "success" | "blocked" | "failed" | "success_with_warnings";
+        gates_passed: boolean | null;
+        deliverable_present: boolean;
+        harness_errored: boolean;
+        web_required_unsatisfied: boolean;
+        tool_warnings_count: number;
+    };
+    tool_errors: {
+        kind: "file" | "web" | "command" | "mcp" | "search" | "other";
+        target: string | null;
+        tool: string;
+        summary: string;
+        recovered: boolean;
+        tool_use_id: string | null;
+    }[];
+    tool_errors_total: number;
+    unrecovered_tool_errors: number;
+    statusless_tool_results: number;
+    dropped_events: number;
+    transient_failures: {
+        kind: "unknown" | "network" | "stream_disconnect" | "service_unavailable" | "timeout";
+        retry_delay_ms: number | null;
+    }[];
+}, {
+    harness_id: string;
+    web: {
+        status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | 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;
+        satisfied?: boolean | undefined;
+    };
+    attempt_id: string;
+    observed_model?: string | null | undefined;
+    outcome?: {
+        status?: "success" | "blocked" | "failed" | "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;
+    tool_errors?: {
+        tool: string;
+        summary: string;
+        kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
+        target?: string | null | undefined;
+        recovered?: boolean | undefined;
+        tool_use_id?: string | null | undefined;
+    }[] | undefined;
+    tool_errors_total?: number | undefined;
+    unrecovered_tool_errors?: number | undefined;
+    statusless_tool_results?: number | undefined;
+    dropped_events?: number | undefined;
+    transient_failures?: {
+        kind?: "unknown" | "network" | "stream_disconnect" | "service_unavailable" | "timeout" | undefined;
+        retry_delay_ms?: number | null | undefined;
+    }[] | undefined;
+}>;
+export type AttemptTelemetryRecord = z.infer<typeof AttemptTelemetryRecord>;
+export declare const RunTelemetry: z.ZodObject<{
+    schema_version: z.ZodLiteral<2>;
+    run_id: z.ZodString;
+    task_id: z.ZodString;
+    mode: z.ZodEnum<["ask", "plan", "audit", "agent", "orchestrate"]>;
+    requested_access: z.ZodEnum<["readonly", "workspace_write", "full", "external_sandbox_full", "inherit_native"]>;
+    effective_access: z.ZodEnum<["readonly", "workspace_write", "full", "external_sandbox_full", "inherit_native"]>;
+    external_context_policy: z.ZodEnum<["off", "auto", "cached", "live"]>;
+    effective_web_mode: z.ZodEnum<["off", "auto", "cached", "live"]>;
+    web_required: z.ZodDefault<z.ZodBoolean>;
+    /** Attempt whose output became the final answer/patch; null when no attempt succeeded. */
+    final_attempt_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    /** Run-level web evidence: the final attempt's evidence, else the most severe attempt evidence. */
+    web: z.ZodObject<{
+        required: z.ZodDefault<z.ZodBoolean>;
+        /** Requested policy for the run. */
+        policy: z.ZodDefault<z.ZodEnum<["off", "auto", "cached", "live"]>>;
+        /** Mode actually executed by the harness route (e.g. claude `cached` upgrades to `live`, disclosed). */
+        effective_mode: z.ZodDefault<z.ZodEnum<["off", "auto", "cached", "live"]>>;
+        attempted: z.ZodDefault<z.ZodBoolean>;
+        satisfied: z.ZodDefault<z.ZodBoolean>;
+        status: z.ZodDefault<z.ZodEnum<["none", "attempted", "satisfied", "failed", "unverified"]>>;
+        tool: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        target: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        error_summary: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+        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";
+        satisfied: boolean;
+    }, {
+        status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | 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;
+        satisfied?: boolean | undefined;
+    }>;
+    attempts: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        attempt_id: z.ZodString;
+        harness_id: z.ZodString;
+        /**
+         * Model identity the harness stream actually reported (route evidence).
+         * Null when the stream never disclosed one; surfaces must render that as
+         * unverified, never as a guess.
+         */
+        observed_model: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        web: z.ZodObject<{
+            required: z.ZodDefault<z.ZodBoolean>;
+            /** Requested policy for the run. */
+            policy: z.ZodDefault<z.ZodEnum<["off", "auto", "cached", "live"]>>;
+            /** Mode actually executed by the harness route (e.g. claude `cached` upgrades to `live`, disclosed). */
+            effective_mode: z.ZodDefault<z.ZodEnum<["off", "auto", "cached", "live"]>>;
+            attempted: z.ZodDefault<z.ZodBoolean>;
+            satisfied: z.ZodDefault<z.ZodBoolean>;
+            status: z.ZodDefault<z.ZodEnum<["none", "attempted", "satisfied", "failed", "unverified"]>>;
+            tool: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            target: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            error_summary: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+            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";
+            satisfied: boolean;
+        }, {
+            status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | 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;
+            satisfied?: boolean | undefined;
+        }>;
+        /** Bounded by the writer (most recent first when truncated; `tool_errors_total` keeps the true count). */
+        tool_errors: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            tool: z.ZodString;
+            kind: z.ZodDefault<z.ZodEnum<["web", "file", "command", "mcp", "search", "other"]>>;
+            target: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+            summary: z.ZodString;
+            /** True when a later successful result of the same tool exists in the same attempt. */
+            recovered: z.ZodDefault<z.ZodBoolean>;
+            tool_use_id: z.ZodDefault<z.ZodNullable<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "file" | "web" | "command" | "mcp" | "search" | "other";
+            target: string | null;
+            tool: string;
+            summary: string;
+            recovered: boolean;
+            tool_use_id: string | null;
+        }, {
+            tool: string;
+            summary: string;
+            kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
+            target?: string | null | undefined;
+            recovered?: boolean | undefined;
+            tool_use_id?: string | null | undefined;
+        }>, "many">>;
+        tool_errors_total: z.ZodDefault<z.ZodNumber>;
+        unrecovered_tool_errors: z.ZodDefault<z.ZodNumber>;
+        /** tool_result events that arrived WITHOUT a status field (never treated as ok). */
+        statusless_tool_results: z.ZodDefault<z.ZodNumber>;
+        /** Native lines/events the adapter could not parse or did not recognize (never silently zero). */
+        dropped_events: z.ZodDefault<z.ZodNumber>;
+        /** Adapter-declared transient failures that informed bounded retry policy. */
+        transient_failures: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            kind: z.ZodDefault<z.ZodEnum<["network", "stream_disconnect", "service_unavailable", "timeout", "unknown"]>>;
+            retry_delay_ms: z.ZodDefault<z.ZodNullable<z.ZodNumber>>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "unknown" | "network" | "stream_disconnect" | "service_unavailable" | "timeout";
+            retry_delay_ms: number | null;
+        }, {
+            kind?: "unknown" | "network" | "stream_disconnect" | "service_unavailable" | "timeout" | undefined;
+            retry_delay_ms?: number | null | undefined;
+        }>, "many">>;
+        /** Contract/outcome projection for this attempt. */
+        outcome: z.ZodDefault<z.ZodObject<{
+            deliverable_present: z.ZodDefault<z.ZodBoolean>;
+            gates_passed: z.ZodDefault<z.ZodNullable<z.ZodBoolean>>;
+            harness_errored: z.ZodDefault<z.ZodBoolean>;
+            web_required_unsatisfied: z.ZodDefault<z.ZodBoolean>;
+            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";
+            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;
+            gates_passed?: boolean | null | undefined;
+            deliverable_present?: boolean | undefined;
+            harness_errored?: boolean | undefined;
+            web_required_unsatisfied?: boolean | undefined;
+            tool_warnings_count?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        harness_id: string;
+        web: {
+            status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+            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";
+            satisfied: boolean;
+        };
+        observed_model: string | null;
+        attempt_id: string;
+        outcome: {
+            status: "success" | "blocked" | "failed" | "success_with_warnings";
+            gates_passed: boolean | null;
+            deliverable_present: boolean;
+            harness_errored: boolean;
+            web_required_unsatisfied: boolean;
+            tool_warnings_count: number;
+        };
+        tool_errors: {
+            kind: "file" | "web" | "command" | "mcp" | "search" | "other";
+            target: string | null;
+            tool: string;
+            summary: string;
+            recovered: boolean;
+            tool_use_id: string | null;
+        }[];
+        tool_errors_total: number;
+        unrecovered_tool_errors: number;
+        statusless_tool_results: number;
+        dropped_events: number;
+        transient_failures: {
+            kind: "unknown" | "network" | "stream_disconnect" | "service_unavailable" | "timeout";
+            retry_delay_ms: number | null;
+        }[];
+    }, {
+        harness_id: string;
+        web: {
+            status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | 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;
+            satisfied?: boolean | undefined;
+        };
+        attempt_id: string;
+        observed_model?: string | null | undefined;
+        outcome?: {
+            status?: "success" | "blocked" | "failed" | "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;
+        tool_errors?: {
+            tool: string;
+            summary: string;
+            kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
+            target?: string | null | undefined;
+            recovered?: boolean | undefined;
+            tool_use_id?: string | null | undefined;
+        }[] | undefined;
+        tool_errors_total?: number | undefined;
+        unrecovered_tool_errors?: number | undefined;
+        statusless_tool_results?: number | undefined;
+        dropped_events?: number | undefined;
+        transient_failures?: {
+            kind?: "unknown" | "network" | "stream_disconnect" | "service_unavailable" | "timeout" | undefined;
+            retry_delay_ms?: number | null | undefined;
+        }[] | undefined;
+    }>, "many">>;
+    /** Sum of attempt outcome warnings; surfaces render this separately from terminal state. */
+    tool_warnings_total: z.ZodDefault<z.ZodNumber>;
+    generated_at: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    external_context_policy: "off" | "auto" | "cached" | "live";
+    web: {
+        status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+        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";
+        satisfied: boolean;
+    };
+    mode: "ask" | "plan" | "audit" | "agent" | "orchestrate";
+    schema_version: 2;
+    run_id: string;
+    task_id: string;
+    web_required: boolean;
+    attempts: {
+        harness_id: string;
+        web: {
+            status: "none" | "failed" | "attempted" | "unverified" | "satisfied";
+            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";
+            satisfied: boolean;
+        };
+        observed_model: string | null;
+        attempt_id: string;
+        outcome: {
+            status: "success" | "blocked" | "failed" | "success_with_warnings";
+            gates_passed: boolean | null;
+            deliverable_present: boolean;
+            harness_errored: boolean;
+            web_required_unsatisfied: boolean;
+            tool_warnings_count: number;
+        };
+        tool_errors: {
+            kind: "file" | "web" | "command" | "mcp" | "search" | "other";
+            target: string | null;
+            tool: string;
+            summary: string;
+            recovered: boolean;
+            tool_use_id: string | null;
+        }[];
+        tool_errors_total: number;
+        unrecovered_tool_errors: number;
+        statusless_tool_results: number;
+        dropped_events: number;
+        transient_failures: {
+            kind: "unknown" | "network" | "stream_disconnect" | "service_unavailable" | "timeout";
+            retry_delay_ms: number | null;
+        }[];
+    }[];
+    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;
+}, {
+    external_context_policy: "off" | "auto" | "cached" | "live";
+    web: {
+        status?: "none" | "failed" | "attempted" | "unverified" | "satisfied" | 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;
+        satisfied?: boolean | undefined;
+    };
+    mode: "ask" | "plan" | "audit" | "agent" | "orchestrate";
+    schema_version: 2;
+    run_id: string;
+    task_id: 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;
+            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;
+            satisfied?: boolean | undefined;
+        };
+        attempt_id: string;
+        observed_model?: string | null | undefined;
+        outcome?: {
+            status?: "success" | "blocked" | "failed" | "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;
+        tool_errors?: {
+            tool: string;
+            summary: string;
+            kind?: "file" | "web" | "command" | "mcp" | "search" | "other" | undefined;
+            target?: string | null | undefined;
+            recovered?: boolean | undefined;
+            tool_use_id?: string | null | undefined;
+        }[] | undefined;
+        tool_errors_total?: number | undefined;
+        unrecovered_tool_errors?: number | undefined;
+        statusless_tool_results?: number | undefined;
+        dropped_events?: number | undefined;
+        transient_failures?: {
+            kind?: "unknown" | "network" | "stream_disconnect" | "service_unavailable" | "timeout" | undefined;
+            retry_delay_ms?: number | null | undefined;
+        }[] | undefined;
+    }[] | undefined;
+    final_attempt_id?: string | null | undefined;
+    tool_warnings_total?: number | undefined;
+}>;
+export type RunTelemetry = z.infer<typeof RunTelemetry>;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB;;;;;;;GAOG;AAEH,eAAO,MAAM,iBAAiB,uEAI3B,CAAC;AACJ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,iBAAiB;;IAG1B,oCAAoC;;IAEpC,wGAAwG;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW4B,CAAC;AACzI,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,eAAe;;;;;IAMxB,uFAAuF;;;;;;;;;;;;;;;;;EAIlC,CAAC;AAC1D,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,sBAAsB;;;;;;;;;EAQqD,CAAC;AACzF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E,eAAO,MAAM,oBAAoB,sEAEyD,CAAC;AAC3F,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;EAS2F,CAAC;AACvH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,sBAAsB;;;IAI/B;;;;OAIG;;;;QArEH,oCAAoC;;QAEpC,wGAAwG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA0ExG,0GAA0G;;;;;;QAtD1G,uFAAuF;;;;;;;;;;;;;;;;;;;;IA6DvF,oFAAoF;;IAOpF,kGAAkG;;IAOlG,8EAA8E;;;;;;;;;;;IAK9E,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAGyD,CAAC;AAClH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E,eAAO,MAAM,YAAY;;;;;;;;;;IAWrB,0FAA0F;;IAI1F,mGAAmG;;;QA3HnG,oCAAoC;;QAEpC,wGAAwG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA+DxG;;;;WAIG;;;;YArEH,oCAAoC;;YAEpC,wGAAwG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QA0ExG,0GAA0G;;;;;;YAtD1G,uFAAuF;;;;;;;;;;;;;;;;;;;;QA6DvF,oFAAoF;;QAOpF,kGAAkG;;QAOlG,8EAA8E;;;;;;;;;;;QAK9E,oDAAoD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAwBpD,4FAA4F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAW7F,CAAC;AACJ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}