audit-tools 0.33.3 → 0.33.4

package/dist/shared/dispatch/dispatchQuotaContract.d.ts

@@ -0,0 +1,720 @@
+/**
+ * The ONE dispatch-quota contract + emit core (unified-routing step H5).
+ *
+ * Replaces the kept-in-parity fork: audit's `DispatchQuota` (zod, literally
+ * annotated "Auditor-only type (not in shared)") vs remediate's
+ * `RemediationDispatchQuota` (compile-time only) — 12 identical fields maintained
+ * as two, with two version literals and two character-for-character emit wrappers
+ * (`finalizeDispatchQuota` ≡ `buildDispatchQuota`, the latter even commented
+ * "Mirrors audit's finalizeDispatchQuota"). One shared, runtime-validated contract
+ * with optional per-mode extensions; each orchestrator keeps only its thin
+ * assembly policy (audit: capacity fold + fanout/capable; remediate: schedule +
+ * phase), never the contract or the admission math.
+ */
+import { z } from "zod";
+import type { ReservationLedger } from "../quota/reservationLedger.js";
+import { type AdmissionPool, type AdmissionCandidate } from "./admissionLoop.js";
+import { type DispatchModelTier } from "../types/stepContract.js";
+/** The single contract version — both orchestrators emit and validate this. */
+export declare const DISPATCH_QUOTA_CONTRACT_VERSION: "dispatch-quota/v1";
+export declare const DispatchQuotaContractSchema: z.ZodObject<{
+    contract_version: z.ZodLiteral<"dispatch-quota/v1">;
+    run_id: z.ZodString;
+    model: z.ZodNullable<z.ZodString>;
+    resolved_limits: z.ZodObject<{
+        context_tokens: z.ZodNumber;
+        output_tokens: z.ZodNumber;
+        requests_per_minute: z.ZodNullable<z.ZodNumber>;
+        input_tokens_per_minute: z.ZodNullable<z.ZodNumber>;
+        output_tokens_per_minute: z.ZodNullable<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        context_tokens: number;
+        output_tokens: number;
+        requests_per_minute: number | null;
+        input_tokens_per_minute: number | null;
+        output_tokens_per_minute: number | null;
+    }, {
+        context_tokens: number;
+        output_tokens: number;
+        requests_per_minute: number | null;
+        input_tokens_per_minute: number | null;
+        output_tokens_per_minute: number | null;
+    }>;
+    confidence: z.ZodEnum<["high", "medium", "low"]>;
+    source: z.ZodEnum<["explicit_config", "discovered_capability", "static_metadata", "cli_flags", "provider_default", "learned", "default"]>;
+    host_concurrency_limit: z.ZodNullable<z.ZodObject<{
+        active_subagents: z.ZodNumber;
+        source: z.ZodEnum<["cli_flags", "host_reported", "session_config", "environment", "discovered_config", "known_default"]>;
+        description: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        source: "cli_flags" | "host_reported" | "session_config" | "environment" | "discovered_config" | "known_default";
+        active_subagents: number;
+        description: string;
+    }, {
+        source: "cli_flags" | "host_reported" | "session_config" | "environment" | "discovered_config" | "known_default";
+        active_subagents: number;
+        description: string;
+    }>>;
+    /**
+     * Admission control: the tool GRANTS the affordable admitted set
+     * (cost-first-capable, ledger-leased) — the granted set's size is the emergent
+     * admission width. See spec/audit/dispatch-admission-control.md.
+     */
+    admission: z.ZodObject<{
+        granted_packet_ids: z.ZodArray<z.ZodString, "many">;
+        declared_cap: z.ZodNullable<z.ZodNumber>;
+        leases: z.ZodArray<z.ZodObject<{
+            packet_id: z.ZodString;
+            pool_id: z.ZodString;
+            resource_key: z.ZodString;
+            lease_id: z.ZodString;
+            cost: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            pool_id: string;
+            cost: number;
+            packet_id: string;
+            resource_key: string;
+            lease_id: string;
+        }, {
+            pool_id: string;
+            cost: number;
+            packet_id: string;
+            resource_key: string;
+            lease_id: string;
+        }>, "many">;
+        explains: z.ZodArray<z.ZodObject<{
+            packet_id: z.ZodString;
+            pool_id: z.ZodNullable<z.ZodString>;
+            resource_key: z.ZodNullable<z.ZodString>;
+            admitted: z.ZodBoolean;
+            reason: z.ZodEnum<["admitted", "no_capable_pool", "budget_exhausted", "cap_reached"]>;
+            headroom_before: z.ZodOptional<z.ZodNumber>;
+            outstanding_before: z.ZodOptional<z.ZodNumber>;
+            cost: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            reason: "budget_exhausted" | "cap_reached" | "no_capable_pool" | "admitted";
+            pool_id: string | null;
+            cost: number;
+            admitted: boolean;
+            packet_id: string;
+            resource_key: string | null;
+            headroom_before?: number | undefined;
+            outstanding_before?: number | undefined;
+        }, {
+            reason: "budget_exhausted" | "cap_reached" | "no_capable_pool" | "admitted";
+            pool_id: string | null;
+            cost: number;
+            admitted: boolean;
+            packet_id: string;
+            resource_key: string | null;
+            headroom_before?: number | undefined;
+            outstanding_before?: number | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        leases: {
+            pool_id: string;
+            cost: number;
+            packet_id: string;
+            resource_key: string;
+            lease_id: string;
+        }[];
+        granted_packet_ids: string[];
+        declared_cap: number | null;
+        explains: {
+            reason: "budget_exhausted" | "cap_reached" | "no_capable_pool" | "admitted";
+            pool_id: string | null;
+            cost: number;
+            admitted: boolean;
+            packet_id: string;
+            resource_key: string | null;
+            headroom_before?: number | undefined;
+            outstanding_before?: number | undefined;
+        }[];
+    }, {
+        leases: {
+            pool_id: string;
+            cost: number;
+            packet_id: string;
+            resource_key: string;
+            lease_id: string;
+        }[];
+        granted_packet_ids: string[];
+        declared_cap: number | null;
+        explains: {
+            reason: "budget_exhausted" | "cap_reached" | "no_capable_pool" | "admitted";
+            pool_id: string | null;
+            cost: number;
+            admitted: boolean;
+            packet_id: string;
+            resource_key: string | null;
+            headroom_before?: number | undefined;
+            outstanding_before?: number | undefined;
+        }[];
+    }>;
+    cooldown_until: z.ZodNullable<z.ZodString>;
+    binding_cap: z.ZodOptional<z.ZodEnum<["rpm", "tpm", "token_budget", "cooldown", "host_concurrency", "none"]>>;
+    capacity_pools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        pool_id: z.ZodString;
+        rank: z.ZodOptional<z.ZodEnum<["small", "standard", "deep"]>>;
+        slots: z.ZodNumber;
+        model: z.ZodNullable<z.ZodString>;
+        confidence: z.ZodEnum<["high", "medium", "low"]>;
+        source: z.ZodEnum<["explicit_config", "discovered_capability", "static_metadata", "cli_flags", "provider_default", "learned", "default"]>;
+        resolved_limits: z.ZodObject<{
+            context_tokens: z.ZodNumber;
+            output_tokens: z.ZodNumber;
+            requests_per_minute: z.ZodNullable<z.ZodNumber>;
+            input_tokens_per_minute: z.ZodNullable<z.ZodNumber>;
+            output_tokens_per_minute: z.ZodNullable<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            context_tokens: number;
+            output_tokens: number;
+            requests_per_minute: number | null;
+            input_tokens_per_minute: number | null;
+            output_tokens_per_minute: number | null;
+        }, {
+            context_tokens: number;
+            output_tokens: number;
+            requests_per_minute: number | null;
+            input_tokens_per_minute: number | null;
+            output_tokens_per_minute: number | null;
+        }>;
+        host_concurrency_limit: z.ZodNullable<z.ZodObject<{
+            active_subagents: z.ZodNumber;
+            source: z.ZodEnum<["cli_flags", "host_reported", "session_config", "environment", "discovered_config", "known_default"]>;
+            description: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            source: "cli_flags" | "host_reported" | "session_config" | "environment" | "discovered_config" | "known_default";
+            active_subagents: number;
+            description: string;
+        }, {
+            source: "cli_flags" | "host_reported" | "session_config" | "environment" | "discovered_config" | "known_default";
+            active_subagents: number;
+            description: string;
+        }>>;
+        is_conversation_host: z.ZodBoolean;
+        cooldown_until: z.ZodNullable<z.ZodString>;
+        estimated_wave_tokens: z.ZodNumber;
+        binding_cap: z.ZodEnum<["rpm", "tpm", "token_budget", "cooldown", "host_concurrency", "none"]>;
+        remaining_token_budget: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        binding_window: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            label: z.ZodString;
+            reset_at: z.ZodNullable<z.ZodString>;
+            budget: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            reset_at: string | null;
+            budget: number;
+        }, {
+            label: string;
+            reset_at: string | null;
+            budget: number;
+        }>>>;
+        in_flight_tokens: z.ZodOptional<z.ZodNumber>;
+        calibrating: z.ZodOptional<z.ZodBoolean>;
+        quota_source_snapshot: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            remaining_pct: z.ZodNullable<z.ZodNumber>;
+            reset_at: z.ZodNullable<z.ZodString>;
+            requests_remaining: z.ZodNullable<z.ZodNumber>;
+            tokens_remaining: z.ZodNullable<z.ZodNumber>;
+            captured_at: z.ZodString;
+            source: z.ZodString;
+            windows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                label: z.ZodString;
+                remaining_pct: z.ZodNullable<z.ZodNumber>;
+                reset_at: z.ZodNullable<z.ZodString>;
+                tokens_remaining: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            }, "strict", z.ZodTypeAny, {
+                label: string;
+                remaining_pct: number | null;
+                reset_at: string | null;
+                tokens_remaining?: number | null | undefined;
+            }, {
+                label: string;
+                remaining_pct: number | null;
+                reset_at: string | null;
+                tokens_remaining?: number | null | undefined;
+            }>, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            remaining_pct: number | null;
+            reset_at: string | null;
+            tokens_remaining: number | null;
+            requests_remaining: number | null;
+            captured_at: string;
+            source: string;
+            windows?: {
+                label: string;
+                remaining_pct: number | null;
+                reset_at: string | null;
+                tokens_remaining?: number | null | undefined;
+            }[] | undefined;
+        }, {
+            remaining_pct: number | null;
+            reset_at: string | null;
+            tokens_remaining: number | null;
+            requests_remaining: number | null;
+            captured_at: string;
+            source: string;
+            windows?: {
+                label: string;
+                remaining_pct: number | null;
+                reset_at: string | null;
+                tokens_remaining?: number | null | undefined;
+            }[] | undefined;
+        }>>>;
+        quota_signal_degraded: z.ZodOptional<z.ZodBoolean>;
+        quota_coverage: z.ZodOptional<z.ZodEnum<["established", "reactive_only", "unestablished"]>>;
+        concurrency_cap: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        declared_cost_per_mtok: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        capability_rank: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        context_cap_tokens: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    }, "strict", z.ZodTypeAny, {
+        confidence: "high" | "low" | "medium";
+        model: string | null;
+        source: "explicit_config" | "discovered_capability" | "static_metadata" | "cli_flags" | "provider_default" | "learned" | "default";
+        cooldown_until: string | null;
+        pool_id: string;
+        slots: number;
+        resolved_limits: {
+            context_tokens: number;
+            output_tokens: number;
+            requests_per_minute: number | null;
+            input_tokens_per_minute: number | null;
+            output_tokens_per_minute: number | null;
+        };
+        host_concurrency_limit: {
+            source: "cli_flags" | "host_reported" | "session_config" | "environment" | "discovered_config" | "known_default";
+            active_subagents: number;
+            description: string;
+        } | null;
+        is_conversation_host: boolean;
+        estimated_wave_tokens: number;
+        binding_cap: "rpm" | "tpm" | "token_budget" | "cooldown" | "host_concurrency" | "none";
+        capability_rank?: number | null | undefined;
+        rank?: "deep" | "small" | "standard" | undefined;
+        calibrating?: boolean | undefined;
+        remaining_token_budget?: number | null | undefined;
+        binding_window?: {
+            label: string;
+            reset_at: string | null;
+            budget: number;
+        } | null | undefined;
+        in_flight_tokens?: number | undefined;
+        quota_source_snapshot?: {
+            remaining_pct: number | null;
+            reset_at: string | null;
+            tokens_remaining: number | null;
+            requests_remaining: number | null;
+            captured_at: string;
+            source: string;
+            windows?: {
+                label: string;
+                remaining_pct: number | null;
+                reset_at: string | null;
+                tokens_remaining?: number | null | undefined;
+            }[] | undefined;
+        } | null | undefined;
+        quota_signal_degraded?: boolean | undefined;
+        quota_coverage?: "established" | "reactive_only" | "unestablished" | undefined;
+        concurrency_cap?: number | null | undefined;
+        declared_cost_per_mtok?: number | null | undefined;
+        context_cap_tokens?: number | null | undefined;
+    }, {
+        confidence: "high" | "low" | "medium";
+        model: string | null;
+        source: "explicit_config" | "discovered_capability" | "static_metadata" | "cli_flags" | "provider_default" | "learned" | "default";
+        cooldown_until: string | null;
+        pool_id: string;
+        slots: number;
+        resolved_limits: {
+            context_tokens: number;
+            output_tokens: number;
+            requests_per_minute: number | null;
+            input_tokens_per_minute: number | null;
+            output_tokens_per_minute: number | null;
+        };
+        host_concurrency_limit: {
+            source: "cli_flags" | "host_reported" | "session_config" | "environment" | "discovered_config" | "known_default";
+            active_subagents: number;
+            description: string;
+        } | null;
+        is_conversation_host: boolean;
+        estimated_wave_tokens: number;
+        binding_cap: "rpm" | "tpm" | "token_budget" | "cooldown" | "host_concurrency" | "none";
+        capability_rank?: number | null | undefined;
+        rank?: "deep" | "small" | "standard" | undefined;
+        calibrating?: boolean | undefined;
+        remaining_token_budget?: number | null | undefined;
+        binding_window?: {
+            label: string;
+            reset_at: string | null;
+            budget: number;
+        } | null | undefined;
+        in_flight_tokens?: number | undefined;
+        quota_source_snapshot?: {
+            remaining_pct: number | null;
+            reset_at: string | null;
+            tokens_remaining: number | null;
+            requests_remaining: number | null;
+            captured_at: string;
+            source: string;
+            windows?: {
+                label: string;
+                remaining_pct: number | null;
+                reset_at: string | null;
+                tokens_remaining?: number | null | undefined;
+            }[] | undefined;
+        } | null | undefined;
+        quota_signal_degraded?: boolean | undefined;
+        quota_coverage?: "established" | "reactive_only" | "unestablished" | undefined;
+        concurrency_cap?: number | null | undefined;
+        declared_cost_per_mtok?: number | null | undefined;
+        context_cap_tokens?: number | null | undefined;
+    }>, "many">>;
+    quota_source_snapshot: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        remaining_pct: z.ZodNullable<z.ZodNumber>;
+        reset_at: z.ZodNullable<z.ZodString>;
+        requests_remaining: z.ZodNullable<z.ZodNumber>;
+        tokens_remaining: z.ZodNullable<z.ZodNumber>;
+        captured_at: z.ZodString;
+        source: z.ZodString;
+        windows: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            remaining_pct: z.ZodNullable<z.ZodNumber>;
+            reset_at: z.ZodNullable<z.ZodString>;
+            tokens_remaining: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+        }, "strict", z.ZodTypeAny, {
+            label: string;
+            remaining_pct: number | null;
+            reset_at: string | null;
+            tokens_remaining?: number | null | undefined;
+        }, {
+            label: string;
+            remaining_pct: number | null;
+            reset_at: string | null;
+            tokens_remaining?: number | null | undefined;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        remaining_pct: number | null;
+        reset_at: string | null;
+        tokens_remaining: number | null;
+        requests_remaining: number | null;
+        captured_at: string;
+        source: string;
+        windows?: {
+            label: string;
+            remaining_pct: number | null;
+            reset_at: string | null;
+            tokens_remaining?: number | null | undefined;
+        }[] | undefined;
+    }, {
+        remaining_pct: number | null;
+        reset_at: string | null;
+        tokens_remaining: number | null;
+        requests_remaining: number | null;
+        captured_at: string;
+        source: string;
+        windows?: {
+            label: string;
+            remaining_pct: number | null;
+            reset_at: string | null;
+            tokens_remaining?: number | null | undefined;
+        }[] | undefined;
+    }>>>;
+    backoff_state: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        consecutive_429_count: z.ZodNumber;
+        current_cooldown_ms: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        consecutive_429_count: number;
+        current_cooldown_ms: number;
+    }, {
+        consecutive_429_count: number;
+        current_cooldown_ms: number;
+    }>>>;
+    /** AUDIT: echo of the host-reported model roster (lowest rank first). */
+    host_model_roster: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        rank: z.ZodEnum<["small", "standard", "deep"]>;
+        context_tokens: z.ZodNumber;
+        output_tokens: z.ZodNumber;
+        model_id: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        context_tokens: number;
+        output_tokens: number;
+        rank: "deep" | "small" | "standard";
+        model_id?: string | undefined;
+    }, {
+        context_tokens: number;
+        output_tokens: number;
+        rank: "deep" | "small" | "standard";
+        model_id?: string | undefined;
+    }>, "many">>;
+    /** AUDIT: per-tier packet input budgets (context − output) from the roster. */
+    tier_budgets: z.ZodOptional<z.ZodRecord<z.ZodEnum<["small", "standard", "deep"]>, z.ZodNumber>>;
+    /** REMEDIATE: which dispatch phase this quota governs. */
+    phase: z.ZodOptional<z.ZodString>;
+    /** REMEDIATE: the wave's total estimated tokens. */
+    estimated_wave_tokens: z.ZodOptional<z.ZodNumber>;
+}, "strict", z.ZodTypeAny, {
+    confidence: "high" | "low" | "medium";
+    run_id: string;
+    contract_version: "dispatch-quota/v1";
+    model: string | null;
+    source: "explicit_config" | "discovered_capability" | "static_metadata" | "cli_flags" | "provider_default" | "learned" | "default";
+    cooldown_until: string | null;
+    resolved_limits: {
+        context_tokens: number;
+        output_tokens: number;
+        requests_per_minute: number | null;
+        input_tokens_per_minute: number | null;
+        output_tokens_per_minute: number | null;
+    };
+    host_concurrency_limit: {
+        source: "cli_flags" | "host_reported" | "session_config" | "environment" | "discovered_config" | "known_default";
+        active_subagents: number;
+        description: string;
+    } | null;
+    admission: {
+        leases: {
+            pool_id: string;
+            cost: number;
+            packet_id: string;
+            resource_key: string;
+            lease_id: string;
+        }[];
+        granted_packet_ids: string[];
+        declared_cap: number | null;
+        explains: {
+            reason: "budget_exhausted" | "cap_reached" | "no_capable_pool" | "admitted";
+            pool_id: string | null;
+            cost: number;
+            admitted: boolean;
+            packet_id: string;
+            resource_key: string | null;
+            headroom_before?: number | undefined;
+            outstanding_before?: number | undefined;
+        }[];
+    };
+    estimated_wave_tokens?: number | undefined;
+    binding_cap?: "rpm" | "tpm" | "token_budget" | "cooldown" | "host_concurrency" | "none" | undefined;
+    quota_source_snapshot?: {
+        remaining_pct: number | null;
+        reset_at: string | null;
+        tokens_remaining: number | null;
+        requests_remaining: number | null;
+        captured_at: string;
+        source: string;
+        windows?: {
+            label: string;
+            remaining_pct: number | null;
+            reset_at: string | null;
+            tokens_remaining?: number | null | undefined;
+        }[] | undefined;
+    } | null | undefined;
+    capacity_pools?: {
+        confidence: "high" | "low" | "medium";
+        model: string | null;
+        source: "explicit_config" | "discovered_capability" | "static_metadata" | "cli_flags" | "provider_default" | "learned" | "default";
+        cooldown_until: string | null;
+        pool_id: string;
+        slots: number;
+        resolved_limits: {
+            context_tokens: number;
+            output_tokens: number;
+            requests_per_minute: number | null;
+            input_tokens_per_minute: number | null;
+            output_tokens_per_minute: number | null;
+        };
+        host_concurrency_limit: {
+            source: "cli_flags" | "host_reported" | "session_config" | "environment" | "discovered_config" | "known_default";
+            active_subagents: number;
+            description: string;
+        } | null;
+        is_conversation_host: boolean;
+        estimated_wave_tokens: number;
+        binding_cap: "rpm" | "tpm" | "token_budget" | "cooldown" | "host_concurrency" | "none";
+        capability_rank?: number | null | undefined;
+        rank?: "deep" | "small" | "standard" | undefined;
+        calibrating?: boolean | undefined;
+        remaining_token_budget?: number | null | undefined;
+        binding_window?: {
+            label: string;
+            reset_at: string | null;
+            budget: number;
+        } | null | undefined;
+        in_flight_tokens?: number | undefined;
+        quota_source_snapshot?: {
+            remaining_pct: number | null;
+            reset_at: string | null;
+            tokens_remaining: number | null;
+            requests_remaining: number | null;
+            captured_at: string;
+            source: string;
+            windows?: {
+                label: string;
+                remaining_pct: number | null;
+                reset_at: string | null;
+                tokens_remaining?: number | null | undefined;
+            }[] | undefined;
+        } | null | undefined;
+        quota_signal_degraded?: boolean | undefined;
+        quota_coverage?: "established" | "reactive_only" | "unestablished" | undefined;
+        concurrency_cap?: number | null | undefined;
+        declared_cost_per_mtok?: number | null | undefined;
+        context_cap_tokens?: number | null | undefined;
+    }[] | undefined;
+    backoff_state?: {
+        consecutive_429_count: number;
+        current_cooldown_ms: number;
+    } | null | undefined;
+    host_model_roster?: {
+        context_tokens: number;
+        output_tokens: number;
+        rank: "deep" | "small" | "standard";
+        model_id?: string | undefined;
+    }[] | undefined;
+    tier_budgets?: Partial<Record<"deep" | "small" | "standard", number>> | undefined;
+    phase?: string | undefined;
+}, {
+    confidence: "high" | "low" | "medium";
+    run_id: string;
+    contract_version: "dispatch-quota/v1";
+    model: string | null;
+    source: "explicit_config" | "discovered_capability" | "static_metadata" | "cli_flags" | "provider_default" | "learned" | "default";
+    cooldown_until: string | null;
+    resolved_limits: {
+        context_tokens: number;
+        output_tokens: number;
+        requests_per_minute: number | null;
+        input_tokens_per_minute: number | null;
+        output_tokens_per_minute: number | null;
+    };
+    host_concurrency_limit: {
+        source: "cli_flags" | "host_reported" | "session_config" | "environment" | "discovered_config" | "known_default";
+        active_subagents: number;
+        description: string;
+    } | null;
+    admission: {
+        leases: {
+            pool_id: string;
+            cost: number;
+            packet_id: string;
+            resource_key: string;
+            lease_id: string;
+        }[];
+        granted_packet_ids: string[];
+        declared_cap: number | null;
+        explains: {
+            reason: "budget_exhausted" | "cap_reached" | "no_capable_pool" | "admitted";
+            pool_id: string | null;
+            cost: number;
+            admitted: boolean;
+            packet_id: string;
+            resource_key: string | null;
+            headroom_before?: number | undefined;
+            outstanding_before?: number | undefined;
+        }[];
+    };
+    estimated_wave_tokens?: number | undefined;
+    binding_cap?: "rpm" | "tpm" | "token_budget" | "cooldown" | "host_concurrency" | "none" | undefined;
+    quota_source_snapshot?: {
+        remaining_pct: number | null;
+        reset_at: string | null;
+        tokens_remaining: number | null;
+        requests_remaining: number | null;
+        captured_at: string;
+        source: string;
+        windows?: {
+            label: string;
+            remaining_pct: number | null;
+            reset_at: string | null;
+            tokens_remaining?: number | null | undefined;
+        }[] | undefined;
+    } | null | undefined;
+    capacity_pools?: {
+        confidence: "high" | "low" | "medium";
+        model: string | null;
+        source: "explicit_config" | "discovered_capability" | "static_metadata" | "cli_flags" | "provider_default" | "learned" | "default";
+        cooldown_until: string | null;
+        pool_id: string;
+        slots: number;
+        resolved_limits: {
+            context_tokens: number;
+            output_tokens: number;
+            requests_per_minute: number | null;
+            input_tokens_per_minute: number | null;
+            output_tokens_per_minute: number | null;
+        };
+        host_concurrency_limit: {
+            source: "cli_flags" | "host_reported" | "session_config" | "environment" | "discovered_config" | "known_default";
+            active_subagents: number;
+            description: string;
+        } | null;
+        is_conversation_host: boolean;
+        estimated_wave_tokens: number;
+        binding_cap: "rpm" | "tpm" | "token_budget" | "cooldown" | "host_concurrency" | "none";
+        capability_rank?: number | null | undefined;
+        rank?: "deep" | "small" | "standard" | undefined;
+        calibrating?: boolean | undefined;
+        remaining_token_budget?: number | null | undefined;
+        binding_window?: {
+            label: string;
+            reset_at: string | null;
+            budget: number;
+        } | null | undefined;
+        in_flight_tokens?: number | undefined;
+        quota_source_snapshot?: {
+            remaining_pct: number | null;
+            reset_at: string | null;
+            tokens_remaining: number | null;
+            requests_remaining: number | null;
+            captured_at: string;
+            source: string;
+            windows?: {
+                label: string;
+                remaining_pct: number | null;
+                reset_at: string | null;
+                tokens_remaining?: number | null | undefined;
+            }[] | undefined;
+        } | null | undefined;
+        quota_signal_degraded?: boolean | undefined;
+        quota_coverage?: "established" | "reactive_only" | "unestablished" | undefined;
+        concurrency_cap?: number | null | undefined;
+        declared_cost_per_mtok?: number | null | undefined;
+        context_cap_tokens?: number | null | undefined;
+    }[] | undefined;
+    backoff_state?: {
+        consecutive_429_count: number;
+        current_cooldown_ms: number;
+    } | null | undefined;
+    host_model_roster?: {
+        context_tokens: number;
+        output_tokens: number;
+        rank: "deep" | "small" | "standard";
+        model_id?: string | undefined;
+    }[] | undefined;
+    tier_budgets?: Partial<Record<"deep" | "small" | "standard", number>> | undefined;
+    phase?: string | undefined;
+}>;
+export type DispatchQuotaContract = z.infer<typeof DispatchQuotaContractSchema>;
+/**
+ * The shared emit core: run admission over the caller's pool set and assemble the
+ * validated contract. The caller supplies its resolved base fields + per-mode
+ * extensions; the admission math and the contract shape live HERE, once.
+ */
+export declare function assembleDispatchQuota(params: {
+    runId: string;
+    pools: AdmissionPool[];
+    packets: {
+        id: string;
+        inputTokens: number;
+        complexity: number;
+        requiredTier?: DispatchModelTier;
+    }[];
+    outputCap: number;
+    grantLeases: boolean;
+    ledger: ReservationLedger;
+    capable?: (pool: AdmissionPool, packet: AdmissionCandidate) => boolean;
+    dispatchBias?: number;
+    base: Omit<DispatchQuotaContract, "contract_version" | "run_id" | "admission">;
+}): Promise<DispatchQuotaContract>;
+//# sourceMappingURL=dispatchQuotaContract.d.ts.map