@indexnetwork/protocol 22.0.0-rc.499.1 → 64.0.0

package/dist/questions/question.schema.d.ts

@@ -1,1529 +0,0 @@
-/**
- * questions/question.schema — canonical home for question value types and schemas.
- *
- * Defines the public structured shape consumed by frontend renderers and MCP
- * elicitation dispatch, plus internal generator, persistence, and delivery
- * envelopes used across the questions capability.
- */
-import { z } from "zod";
-import { UnderspecificationTypeSchema, type UnderspecificationType } from "../shared/schemas/underspecification.schema.js";
-import { QuestionOptionSchema, StructuredQuestionSchema, type QuestionOption } from "../shared/schemas/structured-question.schema.js";
-export { UnderspecificationTypeSchema };
-/**
- * The renderer-facing quartet (title/prompt/options/multiSelect) lives in
- * `shared/schemas/structured-question.schema.ts` so the negotiator can author a
- * question without `shared/` importing this capability. Re-exported here so
- * `questions/question.schema.js` stays the import site every caller already uses.
- */
-export { QuestionOptionSchema, StructuredQuestionSchema };
-export type { StructuredQuestion } from "../shared/schemas/structured-question.schema.js";
-export declare const QuestionSchema: z.ZodObject<{
-    title: z.ZodString;
-    prompt: z.ZodString;
-    options: z.ZodArray<z.ZodObject<{
-        label: z.ZodString;
-        description: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        label: string;
-        description: string;
-    }, {
-        label: string;
-        description: string;
-    }>, "many">;
-    multiSelect: z.ZodBoolean;
-} & {
-    /**
-     * Optional provenance line rendered as a muted chip above the prompt
-     * (e.g. "based on 18 people matching this intent"). Aggregate counts only —
-     * never individual identities (pool_discovery k-anonymity invariant).
-     *
-     * Declared `.nullable().optional()` (not bare `.optional()`) so the schema
-     * survives OpenAI/OpenRouter strict structured-output conversion, which
-     * rejects optional-without-nullable fields (see createStructuredModel in the
-     * questioner agent). The `.transform()` normalizes an LLM-returned `null`
-     * back to `undefined` so a null is NEVER persisted or treated as
-     * "evidence present": real string evidence flows through unchanged, while
-     * both `null` and omitted read as absent everywhere downstream
-     * (e.g. the intent-recovery `!question.evidence` selection filter and the
-     * pool_discovery provenance chip).
-     */
-    evidence: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | undefined, string | null | undefined>;
-}, "strip", z.ZodTypeAny, {
-    prompt: string;
-    options: {
-        label: string;
-        description: string;
-    }[];
-    title: string;
-    multiSelect: boolean;
-    evidence?: string | undefined;
-}, {
-    prompt: string;
-    options: {
-        label: string;
-        description: string;
-    }[];
-    title: string;
-    multiSelect: boolean;
-    evidence?: string | null | undefined;
-}>;
-export declare const QuestionStrategySchema: z.ZodEnum<["refine_intent", "surface_missing_detail", "open_adjacent_thread", "reflective_summary", "surface_emergent_knowledge"]>;
-export declare const QuestionWithStrategySchema: z.ZodObject<{
-    title: z.ZodString;
-    prompt: z.ZodString;
-    options: z.ZodArray<z.ZodObject<{
-        label: z.ZodString;
-        description: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        label: string;
-        description: string;
-    }, {
-        label: string;
-        description: string;
-    }>, "many">;
-    multiSelect: z.ZodBoolean;
-} & {
-    /**
-     * Optional provenance line rendered as a muted chip above the prompt
-     * (e.g. "based on 18 people matching this intent"). Aggregate counts only —
-     * never individual identities (pool_discovery k-anonymity invariant).
-     *
-     * Declared `.nullable().optional()` (not bare `.optional()`) so the schema
-     * survives OpenAI/OpenRouter strict structured-output conversion, which
-     * rejects optional-without-nullable fields (see createStructuredModel in the
-     * questioner agent). The `.transform()` normalizes an LLM-returned `null`
-     * back to `undefined` so a null is NEVER persisted or treated as
-     * "evidence present": real string evidence flows through unchanged, while
-     * both `null` and omitted read as absent everywhere downstream
-     * (e.g. the intent-recovery `!question.evidence` selection filter and the
-     * pool_discovery provenance chip).
-     */
-    evidence: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | undefined, string | null | undefined>;
-} & {
-    strategy: z.ZodEnum<["refine_intent", "surface_missing_detail", "open_adjacent_thread", "reflective_summary", "surface_emergent_knowledge"]>;
-    /** QUD repair category, or null when the question is not an underspecification repair. */
-    underspecificationType: z.ZodNullable<z.ZodEnum<["missing_constituent", "missing_constraint", "open_alternative_set"]>>;
-}, "strip", z.ZodTypeAny, {
-    prompt: string;
-    options: {
-        label: string;
-        description: string;
-    }[];
-    title: string;
-    multiSelect: boolean;
-    strategy: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge";
-    underspecificationType: "missing_constituent" | "missing_constraint" | "open_alternative_set" | null;
-    evidence?: string | undefined;
-}, {
-    prompt: string;
-    options: {
-        label: string;
-        description: string;
-    }[];
-    title: string;
-    multiSelect: boolean;
-    strategy: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge";
-    underspecificationType: "missing_constituent" | "missing_constraint" | "open_alternative_set" | null;
-    evidence?: string | null | undefined;
-}>;
-export declare const QuestionGeneratorResponseSchema: z.ZodObject<{
-    questions: z.ZodArray<z.ZodObject<{
-        title: z.ZodString;
-        prompt: z.ZodString;
-        options: z.ZodArray<z.ZodObject<{
-            label: z.ZodString;
-            description: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            label: string;
-            description: string;
-        }, {
-            label: string;
-            description: string;
-        }>, "many">;
-        multiSelect: z.ZodBoolean;
-    } & {
-        /**
-         * Optional provenance line rendered as a muted chip above the prompt
-         * (e.g. "based on 18 people matching this intent"). Aggregate counts only —
-         * never individual identities (pool_discovery k-anonymity invariant).
-         *
-         * Declared `.nullable().optional()` (not bare `.optional()`) so the schema
-         * survives OpenAI/OpenRouter strict structured-output conversion, which
-         * rejects optional-without-nullable fields (see createStructuredModel in the
-         * questioner agent). The `.transform()` normalizes an LLM-returned `null`
-         * back to `undefined` so a null is NEVER persisted or treated as
-         * "evidence present": real string evidence flows through unchanged, while
-         * both `null` and omitted read as absent everywhere downstream
-         * (e.g. the intent-recovery `!question.evidence` selection filter and the
-         * pool_discovery provenance chip).
-         */
-        evidence: z.ZodEffects<z.ZodOptional<z.ZodNullable<z.ZodString>>, string | undefined, string | null | undefined>;
-    } & {
-        strategy: z.ZodEnum<["refine_intent", "surface_missing_detail", "open_adjacent_thread", "reflective_summary", "surface_emergent_knowledge"]>;
-        /** QUD repair category, or null when the question is not an underspecification repair. */
-        underspecificationType: z.ZodNullable<z.ZodEnum<["missing_constituent", "missing_constraint", "open_alternative_set"]>>;
-    }, "strip", z.ZodTypeAny, {
-        prompt: string;
-        options: {
-            label: string;
-            description: string;
-        }[];
-        title: string;
-        multiSelect: boolean;
-        strategy: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge";
-        underspecificationType: "missing_constituent" | "missing_constraint" | "open_alternative_set" | null;
-        evidence?: string | undefined;
-    }, {
-        prompt: string;
-        options: {
-            label: string;
-            description: string;
-        }[];
-        title: string;
-        multiSelect: boolean;
-        strategy: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge";
-        underspecificationType: "missing_constituent" | "missing_constraint" | "open_alternative_set" | null;
-        evidence?: string | null | undefined;
-    }>, "many">;
-}, "strip", z.ZodTypeAny, {
-    questions: {
-        prompt: string;
-        options: {
-            label: string;
-            description: string;
-        }[];
-        title: string;
-        multiSelect: boolean;
-        strategy: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge";
-        underspecificationType: "missing_constituent" | "missing_constraint" | "open_alternative_set" | null;
-        evidence?: string | undefined;
-    }[];
-}, {
-    questions: {
-        prompt: string;
-        options: {
-            label: string;
-            description: string;
-        }[];
-        title: string;
-        multiSelect: boolean;
-        strategy: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge";
-        underspecificationType: "missing_constituent" | "missing_constraint" | "open_alternative_set" | null;
-        evidence?: string | null | undefined;
-    }[];
-}>;
-export type { QuestionOption };
-export type Question = z.infer<typeof QuestionSchema>;
-export type { UnderspecificationType };
-export type QuestionStrategy = z.infer<typeof QuestionStrategySchema>;
-export type QuestionWithStrategy = z.infer<typeof QuestionWithStrategySchema>;
-export type QuestionGeneratorResponse = z.infer<typeof QuestionGeneratorResponseSchema>;
-/**
- * Internal generator output: public questions plus parallel strategy and QUD
- * taxonomy arrays for metadata-only consumption. The generator emits this;
- * callers forward only `questions` to renderers.
- */
-export interface QuestionGenerationResult {
-    questions: Question[];
-    strategies: QuestionStrategy[];
-    underspecificationTypes: Array<UnderspecificationType | null>;
-}
-/** Internal reason a question was generated, orthogonal to mode and QUD metadata. */
-export declare const NegotiationQuestionPurposeSchema: z.ZodEnum<["uptake", "stalled_followup", "inflight_consultation"]>;
-export declare const QuestionPurposeSchema: z.ZodEnum<["uptake", "recovery", "stalled_followup", "inflight_consultation"]>;
-/**
- * Producer-supplied candidate binding. The API re-resolves every field from
- * authoritative rows before generation; callers cannot mint provenance.
- */
-export declare const NegotiationQuestionCandidateSchema: z.ZodEffects<z.ZodObject<{
-    readonly purpose: z.ZodEnum<["uptake", "stalled_followup", "inflight_consultation"]>;
-    readonly recipientUserId: z.ZodString;
-    readonly recipientIntentId: z.ZodString;
-    readonly opportunityId: z.ZodString;
-    readonly taskId: z.ZodOptional<z.ZodString>;
-    readonly networkId: z.ZodString;
-    /** Uptake only: exact low-authority counterparty eligibility binding. */
-    readonly counterpartyUserId: z.ZodOptional<z.ZodString>;
-    readonly counterpartyIntentId: z.ZodOptional<z.ZodString>;
-    readonly counterpartyFelicityAuthority: z.ZodOptional<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    networkId: string;
-    purpose: "uptake" | "stalled_followup" | "inflight_consultation";
-    recipientUserId: string;
-    recipientIntentId: string;
-    opportunityId: string;
-    counterpartyUserId?: string | undefined;
-    taskId?: string | undefined;
-    counterpartyIntentId?: string | undefined;
-    counterpartyFelicityAuthority?: number | undefined;
-}, {
-    networkId: string;
-    purpose: "uptake" | "stalled_followup" | "inflight_consultation";
-    recipientUserId: string;
-    recipientIntentId: string;
-    opportunityId: string;
-    counterpartyUserId?: string | undefined;
-    taskId?: string | undefined;
-    counterpartyIntentId?: string | undefined;
-    counterpartyFelicityAuthority?: number | undefined;
-}>, {
-    networkId: string;
-    purpose: "uptake" | "stalled_followup" | "inflight_consultation";
-    recipientUserId: string;
-    recipientIntentId: string;
-    opportunityId: string;
-    counterpartyUserId?: string | undefined;
-    taskId?: string | undefined;
-    counterpartyIntentId?: string | undefined;
-    counterpartyFelicityAuthority?: number | undefined;
-}, {
-    networkId: string;
-    purpose: "uptake" | "stalled_followup" | "inflight_consultation";
-    recipientUserId: string;
-    recipientIntentId: string;
-    opportunityId: string;
-    counterpartyUserId?: string | undefined;
-    taskId?: string | undefined;
-    counterpartyIntentId?: string | undefined;
-    counterpartyFelicityAuthority?: number | undefined;
-}>;
-/**
- * Durable server-only routing and freshness envelope for negotiation-family
- * questions. This object is stripped from every REST/MCP projection.
- */
-export declare const NegotiationQuestionProvenanceSchema: z.ZodEffects<z.ZodObject<{
-    intentFingerprint: z.ZodString;
-    opportunityStatus: z.ZodEnum<["latent", "draft", "negotiating", "pending", "stalled", "accepted", "rejected", "expired"]>;
-    opportunityUpdatedAt: z.ZodString;
-    taskState: z.ZodOptional<z.ZodEnum<["submitted", "working", "input_required", "completed", "canceled", "failed", "rejected", "auth_required", "waiting_for_agent", "claimed"]>>;
-    taskUpdatedAt: z.ZodOptional<z.ZodString>;
-    /** Stable per-generation position so retries dedupe without reducing cardinality. */
-    questionOrdinal: z.ZodNumber;
-    purpose: z.ZodEnum<["uptake", "stalled_followup", "inflight_consultation"]>;
-    recipientUserId: z.ZodString;
-    recipientIntentId: z.ZodString;
-    opportunityId: z.ZodString;
-    taskId: z.ZodOptional<z.ZodString>;
-    networkId: z.ZodString;
-    counterpartyUserId: z.ZodOptional<z.ZodString>;
-    counterpartyIntentId: z.ZodOptional<z.ZodString>;
-    counterpartyFelicityAuthority: z.ZodOptional<z.ZodNumber>;
-    version: z.ZodLiteral<1>;
-}, "strip", z.ZodTypeAny, {
-    networkId: string;
-    purpose: "uptake" | "stalled_followup" | "inflight_consultation";
-    recipientUserId: string;
-    recipientIntentId: string;
-    opportunityId: string;
-    version: 1;
-    intentFingerprint: string;
-    opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-    opportunityUpdatedAt: string;
-    questionOrdinal: number;
-    counterpartyUserId?: string | undefined;
-    taskId?: string | undefined;
-    counterpartyIntentId?: string | undefined;
-    counterpartyFelicityAuthority?: number | undefined;
-    taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
-    taskUpdatedAt?: string | undefined;
-}, {
-    networkId: string;
-    purpose: "uptake" | "stalled_followup" | "inflight_consultation";
-    recipientUserId: string;
-    recipientIntentId: string;
-    opportunityId: string;
-    version: 1;
-    intentFingerprint: string;
-    opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-    opportunityUpdatedAt: string;
-    questionOrdinal: number;
-    counterpartyUserId?: string | undefined;
-    taskId?: string | undefined;
-    counterpartyIntentId?: string | undefined;
-    counterpartyFelicityAuthority?: number | undefined;
-    taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
-    taskUpdatedAt?: string | undefined;
-}>, {
-    networkId: string;
-    purpose: "uptake" | "stalled_followup" | "inflight_consultation";
-    recipientUserId: string;
-    recipientIntentId: string;
-    opportunityId: string;
-    version: 1;
-    intentFingerprint: string;
-    opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-    opportunityUpdatedAt: string;
-    questionOrdinal: number;
-    counterpartyUserId?: string | undefined;
-    taskId?: string | undefined;
-    counterpartyIntentId?: string | undefined;
-    counterpartyFelicityAuthority?: number | undefined;
-    taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
-    taskUpdatedAt?: string | undefined;
-}, {
-    networkId: string;
-    purpose: "uptake" | "stalled_followup" | "inflight_consultation";
-    recipientUserId: string;
-    recipientIntentId: string;
-    opportunityId: string;
-    version: 1;
-    intentFingerprint: string;
-    opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-    opportunityUpdatedAt: string;
-    questionOrdinal: number;
-    counterpartyUserId?: string | undefined;
-    taskId?: string | undefined;
-    counterpartyIntentId?: string | undefined;
-    counterpartyFelicityAuthority?: number | undefined;
-    taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
-    taskUpdatedAt?: string | undefined;
-}>;
-export declare const QuestionModeSchema: z.ZodEnum<["intent", "negotiation", "negotiation_inflight", "chat", "pool_discovery"]>;
-/** One server-side candidate→side assignment (never serialized to clients). */
-export declare const QuestionPoolAssignmentSchema: z.ZodObject<{
-    opportunityId: z.ZodString;
-    side: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    opportunityId: string;
-    side: string;
-}, {
-    opportunityId: string;
-    side: string;
-}>;
-/**
- * One mined discriminator carried inside a pool_discovery question's
- * detection (the asked one plus ranked alternates for interview-mode
- * chaining). INTERNAL — the read path strips `detection.pool` before any
- * payload leaves the server.
- */
-export declare const QuestionPoolDiscriminatorSchema: z.ZodObject<{
-    label: z.ZodString;
-    questionSeed: z.ZodString;
-    sides: z.ZodArray<z.ZodString, "many">;
-    /** Verified-assignment count per side label. */
-    sideCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
-    voi: z.ZodNumber;
-    evidenceRate: z.ZodNumber;
-    /** Discriminator embedding retained for durable semantic novelty checks. */
-    embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
-    /** Model that generated `embedding`; mismatches must fall back to text. */
-    embeddingModel: z.ZodOptional<z.ZodString>;
-    /** Verified assignments only — the P3 re-rank input. */
-    assignments: z.ZodArray<z.ZodObject<{
-        opportunityId: z.ZodString;
-        side: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        opportunityId: string;
-        side: string;
-    }, {
-        opportunityId: string;
-        side: string;
-    }>, "many">;
-}, "strip", z.ZodTypeAny, {
-    label: string;
-    questionSeed: string;
-    sides: string[];
-    sideCounts: Record<string, number>;
-    voi: number;
-    evidenceRate: number;
-    assignments: {
-        opportunityId: string;
-        side: string;
-    }[];
-    embedding?: number[] | undefined;
-    embeddingModel?: string | undefined;
-}, {
-    label: string;
-    questionSeed: string;
-    sides: string[];
-    sideCounts: Record<string, number>;
-    voi: number;
-    evidenceRate: number;
-    assignments: {
-        opportunityId: string;
-        side: string;
-    }[];
-    embedding?: number[] | undefined;
-    embeddingModel?: string | undefined;
-}>;
-/** Pool snapshot stored on pool_discovery questions (server-side only). */
-export declare const QuestionPoolSnapshotSchema: z.ZodObject<{
-    poolSize: z.ZodNumber;
-    /** ISO-8601 timestamp of the mining pass. */
-    minedAt: z.ZodString;
-    /** Discovery run that produced the pool, when known. */
-    runId: z.ZodOptional<z.ZodString>;
-    /** Intent payload snippet (≤160 chars) — reused by chained questions' evidence chips. */
-    intentText: z.ZodOptional<z.ZodString>;
-    /** Stable hash of the full normalized payload + summary used for freshness. */
-    intentFingerprint: z.ZodOptional<z.ZodString>;
-    /** Exact bounded candidate pool. Optional for legacy rows/jobs created before IND-422. */
-    opportunityIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    /** The discriminator this question asks about. */
-    discriminator: z.ZodObject<{
-        label: z.ZodString;
-        questionSeed: z.ZodString;
-        sides: z.ZodArray<z.ZodString, "many">;
-        /** Verified-assignment count per side label. */
-        sideCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
-        voi: z.ZodNumber;
-        evidenceRate: z.ZodNumber;
-        /** Discriminator embedding retained for durable semantic novelty checks. */
-        embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
-        /** Model that generated `embedding`; mismatches must fall back to text. */
-        embeddingModel: z.ZodOptional<z.ZodString>;
-        /** Verified assignments only — the P3 re-rank input. */
-        assignments: z.ZodArray<z.ZodObject<{
-            opportunityId: z.ZodString;
-            side: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            opportunityId: string;
-            side: string;
-        }, {
-            opportunityId: string;
-            side: string;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        label: string;
-        questionSeed: string;
-        sides: string[];
-        sideCounts: Record<string, number>;
-        voi: number;
-        evidenceRate: number;
-        assignments: {
-            opportunityId: string;
-            side: string;
-        }[];
-        embedding?: number[] | undefined;
-        embeddingModel?: string | undefined;
-    }, {
-        label: string;
-        questionSeed: string;
-        sides: string[];
-        sideCounts: Record<string, number>;
-        voi: number;
-        evidenceRate: number;
-        assignments: {
-            opportunityId: string;
-            side: string;
-        }[];
-        embedding?: number[] | undefined;
-        embeddingModel?: string | undefined;
-    }>;
-    /** Remaining ranked discriminators for interview-mode chaining. */
-    alternates: z.ZodArray<z.ZodObject<{
-        label: z.ZodString;
-        questionSeed: z.ZodString;
-        sides: z.ZodArray<z.ZodString, "many">;
-        /** Verified-assignment count per side label. */
-        sideCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
-        voi: z.ZodNumber;
-        evidenceRate: z.ZodNumber;
-        /** Discriminator embedding retained for durable semantic novelty checks. */
-        embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
-        /** Model that generated `embedding`; mismatches must fall back to text. */
-        embeddingModel: z.ZodOptional<z.ZodString>;
-        /** Verified assignments only — the P3 re-rank input. */
-        assignments: z.ZodArray<z.ZodObject<{
-            opportunityId: z.ZodString;
-            side: z.ZodString;
-        }, "strip", z.ZodTypeAny, {
-            opportunityId: string;
-            side: string;
-        }, {
-            opportunityId: string;
-            side: string;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        label: string;
-        questionSeed: string;
-        sides: string[];
-        sideCounts: Record<string, number>;
-        voi: number;
-        evidenceRate: number;
-        assignments: {
-            opportunityId: string;
-            side: string;
-        }[];
-        embedding?: number[] | undefined;
-        embeddingModel?: string | undefined;
-    }, {
-        label: string;
-        questionSeed: string;
-        sides: string[];
-        sideCounts: Record<string, number>;
-        voi: number;
-        evidenceRate: number;
-        assignments: {
-            opportunityId: string;
-            side: string;
-        }[];
-        embedding?: number[] | undefined;
-        embeddingModel?: string | undefined;
-    }>, "many">;
-}, "strip", z.ZodTypeAny, {
-    poolSize: number;
-    minedAt: string;
-    discriminator: {
-        label: string;
-        questionSeed: string;
-        sides: string[];
-        sideCounts: Record<string, number>;
-        voi: number;
-        evidenceRate: number;
-        assignments: {
-            opportunityId: string;
-            side: string;
-        }[];
-        embedding?: number[] | undefined;
-        embeddingModel?: string | undefined;
-    };
-    alternates: {
-        label: string;
-        questionSeed: string;
-        sides: string[];
-        sideCounts: Record<string, number>;
-        voi: number;
-        evidenceRate: number;
-        assignments: {
-            opportunityId: string;
-            side: string;
-        }[];
-        embedding?: number[] | undefined;
-        embeddingModel?: string | undefined;
-    }[];
-    runId?: string | undefined;
-    intentFingerprint?: string | undefined;
-    intentText?: string | undefined;
-    opportunityIds?: string[] | undefined;
-}, {
-    poolSize: number;
-    minedAt: string;
-    discriminator: {
-        label: string;
-        questionSeed: string;
-        sides: string[];
-        sideCounts: Record<string, number>;
-        voi: number;
-        evidenceRate: number;
-        assignments: {
-            opportunityId: string;
-            side: string;
-        }[];
-        embedding?: number[] | undefined;
-        embeddingModel?: string | undefined;
-    };
-    alternates: {
-        label: string;
-        questionSeed: string;
-        sides: string[];
-        sideCounts: Record<string, number>;
-        voi: number;
-        evidenceRate: number;
-        assignments: {
-            opportunityId: string;
-            side: string;
-        }[];
-        embedding?: number[] | undefined;
-        embeddingModel?: string | undefined;
-    }[];
-    runId?: string | undefined;
-    intentFingerprint?: string | undefined;
-    intentText?: string | undefined;
-    opportunityIds?: string[] | undefined;
-}>;
-/** Internal delivery ledger for proactive pool-question pushes (IND-421). */
-export declare const QuestionPoolPushSchema: z.ZodObject<{
-    version: z.ZodLiteral<1>;
-    source: z.ZodLiteral<"pool_discovery">;
-    recipientId: z.ZodString;
-    intentId: z.ZodString;
-    cycleKey: z.ZodString;
-    messageId: z.ZodString;
-    /**
-     * Where a claimed push is delivered. The second slot names the negotiator
-     * surface: new claims write `negotiator_intent_chat` (the intent-pinned
-     * session). `negotiator_dm` is the legacy literal for rows persisted before
-     * the unscoped DM was removed — this schema is validated on read, so the
-     * union keeps those rows parsing instead of rejecting them. Read-compat
-     * only; nothing writes it.
-     */
-    surfaces: z.ZodTuple<[z.ZodLiteral<"personal_agent_badge">, z.ZodUnion<[z.ZodLiteral<"negotiator_intent_chat">, z.ZodLiteral<"negotiator_dm">]>], null>;
-    claimedAt: z.ZodString;
-    deliveryStatus: z.ZodEnum<["claimed", "delivered", "suppressed", "failed"]>;
-    conversationId: z.ZodOptional<z.ZodString>;
-    deliveredAt: z.ZodOptional<z.ZodString>;
-    suppressedAt: z.ZodOptional<z.ZodString>;
-    failure: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    source: "pool_discovery";
-    version: 1;
-    recipientId: string;
-    intentId: string;
-    cycleKey: string;
-    messageId: string;
-    surfaces: ["personal_agent_badge", "negotiator_intent_chat" | "negotiator_dm"];
-    claimedAt: string;
-    deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
-    conversationId?: string | undefined;
-    deliveredAt?: string | undefined;
-    suppressedAt?: string | undefined;
-    failure?: string | undefined;
-}, {
-    source: "pool_discovery";
-    version: 1;
-    recipientId: string;
-    intentId: string;
-    cycleKey: string;
-    messageId: string;
-    surfaces: ["personal_agent_badge", "negotiator_intent_chat" | "negotiator_dm"];
-    claimedAt: string;
-    deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
-    conversationId?: string | undefined;
-    deliveredAt?: string | undefined;
-    suppressedAt?: string | undefined;
-    failure?: string | undefined;
-}>;
-/** Durable request state for proactive pool-question delivery. */
-export declare const QuestionPoolPushRequestStatusSchema: z.ZodEnum<["requested", "suppressed"]>;
-/** Private snapshot for a post-discovery recovery refinement question. */
-export declare const QuestionRecoverySnapshotSchema: z.ZodObject<{
-    version: z.ZodLiteral<1>;
-    intentFingerprint: z.ZodString;
-    completionSource: z.ZodEnum<["intent_creation", "from_intent", "discovery_run"]>;
-    /** Privacy-safe aggregate only; raw negotiation evidence is never persisted. */
-    rejectedNegotiationCount: z.ZodOptional<z.ZodNumber>;
-    /** Bounded internal correlation id for an asynchronous discovery run. */
-    runId: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    version: 1;
-    intentFingerprint: string;
-    completionSource: "intent_creation" | "from_intent" | "discovery_run";
-    runId?: string | undefined;
-    rejectedNegotiationCount?: number | undefined;
-}, {
-    version: 1;
-    intentFingerprint: string;
-    completionSource: "intent_creation" | "from_intent" | "discovery_run";
-    runId?: string | undefined;
-    rejectedNegotiationCount?: number | undefined;
-}>;
-/** Internal reason a pending question was voided. */
-export declare const QuestionVoidedReasonSchema: z.ZodEnum<["pool_drift", "intent_edit", "recovery_drift", "negotiation_stale", "retired_mode"]>;
-/** Permanent reasons that terminalize an unclaimed proactive push request. */
-export declare const QuestionPoolPushRequestReasonSchema: z.ZodEnum<["question_lifecycle", "intent_lifecycle", "malformed_source", "malformed_actor", "malformed_pool", "malformed_cycle", "visited", "pool_size", "voi", "cycle_budget"]>;
-export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
-    /** Which preset mode generated this question. */
-    mode: z.ZodEnum<["intent", "negotiation", "negotiation_inflight", "chat", "pool_discovery"]>;
-    /** Internal reason for generation; independent of mode and QUD repair metadata. */
-    purpose: z.ZodOptional<z.ZodEnum<["uptake", "recovery", "stalled_followup", "inflight_consultation"]>>;
-    /** Exact negotiation recipient/intent/task routing provenance. Internal only. */
-    negotiation: z.ZodOptional<z.ZodEffects<z.ZodObject<{
-        intentFingerprint: z.ZodString;
-        opportunityStatus: z.ZodEnum<["latent", "draft", "negotiating", "pending", "stalled", "accepted", "rejected", "expired"]>;
-        opportunityUpdatedAt: z.ZodString;
-        taskState: z.ZodOptional<z.ZodEnum<["submitted", "working", "input_required", "completed", "canceled", "failed", "rejected", "auth_required", "waiting_for_agent", "claimed"]>>;
-        taskUpdatedAt: z.ZodOptional<z.ZodString>;
-        /** Stable per-generation position so retries dedupe without reducing cardinality. */
-        questionOrdinal: z.ZodNumber;
-        purpose: z.ZodEnum<["uptake", "stalled_followup", "inflight_consultation"]>;
-        recipientUserId: z.ZodString;
-        recipientIntentId: z.ZodString;
-        opportunityId: z.ZodString;
-        taskId: z.ZodOptional<z.ZodString>;
-        networkId: z.ZodString;
-        counterpartyUserId: z.ZodOptional<z.ZodString>;
-        counterpartyIntentId: z.ZodOptional<z.ZodString>;
-        counterpartyFelicityAuthority: z.ZodOptional<z.ZodNumber>;
-        version: z.ZodLiteral<1>;
-    }, "strip", z.ZodTypeAny, {
-        networkId: string;
-        purpose: "uptake" | "stalled_followup" | "inflight_consultation";
-        recipientUserId: string;
-        recipientIntentId: string;
-        opportunityId: string;
-        version: 1;
-        intentFingerprint: string;
-        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-        opportunityUpdatedAt: string;
-        questionOrdinal: number;
-        counterpartyUserId?: string | undefined;
-        taskId?: string | undefined;
-        counterpartyIntentId?: string | undefined;
-        counterpartyFelicityAuthority?: number | undefined;
-        taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
-        taskUpdatedAt?: string | undefined;
-    }, {
-        networkId: string;
-        purpose: "uptake" | "stalled_followup" | "inflight_consultation";
-        recipientUserId: string;
-        recipientIntentId: string;
-        opportunityId: string;
-        version: 1;
-        intentFingerprint: string;
-        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-        opportunityUpdatedAt: string;
-        questionOrdinal: number;
-        counterpartyUserId?: string | undefined;
-        taskId?: string | undefined;
-        counterpartyIntentId?: string | undefined;
-        counterpartyFelicityAuthority?: number | undefined;
-        taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
-        taskUpdatedAt?: string | undefined;
-    }>, {
-        networkId: string;
-        purpose: "uptake" | "stalled_followup" | "inflight_consultation";
-        recipientUserId: string;
-        recipientIntentId: string;
-        opportunityId: string;
-        version: 1;
-        intentFingerprint: string;
-        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-        opportunityUpdatedAt: string;
-        questionOrdinal: number;
-        counterpartyUserId?: string | undefined;
-        taskId?: string | undefined;
-        counterpartyIntentId?: string | undefined;
-        counterpartyFelicityAuthority?: number | undefined;
-        taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
-        taskUpdatedAt?: string | undefined;
-    }, {
-        networkId: string;
-        purpose: "uptake" | "stalled_followup" | "inflight_consultation";
-        recipientUserId: string;
-        recipientIntentId: string;
-        opportunityId: string;
-        version: 1;
-        intentFingerprint: string;
-        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-        opportunityUpdatedAt: string;
-        questionOrdinal: number;
-        counterpartyUserId?: string | undefined;
-        taskId?: string | undefined;
-        counterpartyIntentId?: string | undefined;
-        counterpartyFelicityAuthority?: number | undefined;
-        taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
-        taskUpdatedAt?: string | undefined;
-    }>>;
-    /** Entity type that triggered generation (e.g. "opportunity", "intent", "profile"). */
-    sourceType: z.ZodString;
-    /** ID of the triggering entity. */
-    sourceId: z.ZodString;
-    /** Optional intent ID that was the root cause. */
-    triggeredBy: z.ZodOptional<z.ZodString>;
-    /** ISO-8601 timestamp of generation. */
-    timestamp: z.ZodString;
-    /** Generation strategy persisted as internal metadata. */
-    strategy: z.ZodOptional<z.ZodEnum<["refine_intent", "surface_missing_detail", "open_adjacent_thread", "reflective_summary", "surface_emergent_knowledge"]>>;
-    /** QUD repair category persisted as internal metadata. */
-    underspecificationType: z.ZodOptional<z.ZodNullable<z.ZodEnum<["missing_constituent", "missing_constraint", "open_alternative_set"]>>>;
-    /** ID of the assistant message that triggered this question. Used by the frontend to anchor the question card inline. */
-    messageId: z.ZodOptional<z.ZodString>;
-    /** Durable server-only conversation session binding used to validate messageId. */
-    sessionId: z.ZodOptional<z.ZodString>;
-    /**
-     * pool_discovery only: the mined pool snapshot (assignments + alternates).
-     * INTERNAL — stripped from every client-facing read (web + MCP).
-     */
-    pool: z.ZodOptional<z.ZodObject<{
-        poolSize: z.ZodNumber;
-        /** ISO-8601 timestamp of the mining pass. */
-        minedAt: z.ZodString;
-        /** Discovery run that produced the pool, when known. */
-        runId: z.ZodOptional<z.ZodString>;
-        /** Intent payload snippet (≤160 chars) — reused by chained questions' evidence chips. */
-        intentText: z.ZodOptional<z.ZodString>;
-        /** Stable hash of the full normalized payload + summary used for freshness. */
-        intentFingerprint: z.ZodOptional<z.ZodString>;
-        /** Exact bounded candidate pool. Optional for legacy rows/jobs created before IND-422. */
-        opportunityIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        /** The discriminator this question asks about. */
-        discriminator: z.ZodObject<{
-            label: z.ZodString;
-            questionSeed: z.ZodString;
-            sides: z.ZodArray<z.ZodString, "many">;
-            /** Verified-assignment count per side label. */
-            sideCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
-            voi: z.ZodNumber;
-            evidenceRate: z.ZodNumber;
-            /** Discriminator embedding retained for durable semantic novelty checks. */
-            embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
-            /** Model that generated `embedding`; mismatches must fall back to text. */
-            embeddingModel: z.ZodOptional<z.ZodString>;
-            /** Verified assignments only — the P3 re-rank input. */
-            assignments: z.ZodArray<z.ZodObject<{
-                opportunityId: z.ZodString;
-                side: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                opportunityId: string;
-                side: string;
-            }, {
-                opportunityId: string;
-                side: string;
-            }>, "many">;
-        }, "strip", z.ZodTypeAny, {
-            label: string;
-            questionSeed: string;
-            sides: string[];
-            sideCounts: Record<string, number>;
-            voi: number;
-            evidenceRate: number;
-            assignments: {
-                opportunityId: string;
-                side: string;
-            }[];
-            embedding?: number[] | undefined;
-            embeddingModel?: string | undefined;
-        }, {
-            label: string;
-            questionSeed: string;
-            sides: string[];
-            sideCounts: Record<string, number>;
-            voi: number;
-            evidenceRate: number;
-            assignments: {
-                opportunityId: string;
-                side: string;
-            }[];
-            embedding?: number[] | undefined;
-            embeddingModel?: string | undefined;
-        }>;
-        /** Remaining ranked discriminators for interview-mode chaining. */
-        alternates: z.ZodArray<z.ZodObject<{
-            label: z.ZodString;
-            questionSeed: z.ZodString;
-            sides: z.ZodArray<z.ZodString, "many">;
-            /** Verified-assignment count per side label. */
-            sideCounts: z.ZodRecord<z.ZodString, z.ZodNumber>;
-            voi: z.ZodNumber;
-            evidenceRate: z.ZodNumber;
-            /** Discriminator embedding retained for durable semantic novelty checks. */
-            embedding: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
-            /** Model that generated `embedding`; mismatches must fall back to text. */
-            embeddingModel: z.ZodOptional<z.ZodString>;
-            /** Verified assignments only — the P3 re-rank input. */
-            assignments: z.ZodArray<z.ZodObject<{
-                opportunityId: z.ZodString;
-                side: z.ZodString;
-            }, "strip", z.ZodTypeAny, {
-                opportunityId: string;
-                side: string;
-            }, {
-                opportunityId: string;
-                side: string;
-            }>, "many">;
-        }, "strip", z.ZodTypeAny, {
-            label: string;
-            questionSeed: string;
-            sides: string[];
-            sideCounts: Record<string, number>;
-            voi: number;
-            evidenceRate: number;
-            assignments: {
-                opportunityId: string;
-                side: string;
-            }[];
-            embedding?: number[] | undefined;
-            embeddingModel?: string | undefined;
-        }, {
-            label: string;
-            questionSeed: string;
-            sides: string[];
-            sideCounts: Record<string, number>;
-            voi: number;
-            evidenceRate: number;
-            assignments: {
-                opportunityId: string;
-                side: string;
-            }[];
-            embedding?: number[] | undefined;
-            embeddingModel?: string | undefined;
-        }>, "many">;
-    }, "strip", z.ZodTypeAny, {
-        poolSize: number;
-        minedAt: string;
-        discriminator: {
-            label: string;
-            questionSeed: string;
-            sides: string[];
-            sideCounts: Record<string, number>;
-            voi: number;
-            evidenceRate: number;
-            assignments: {
-                opportunityId: string;
-                side: string;
-            }[];
-            embedding?: number[] | undefined;
-            embeddingModel?: string | undefined;
-        };
-        alternates: {
-            label: string;
-            questionSeed: string;
-            sides: string[];
-            sideCounts: Record<string, number>;
-            voi: number;
-            evidenceRate: number;
-            assignments: {
-                opportunityId: string;
-                side: string;
-            }[];
-            embedding?: number[] | undefined;
-            embeddingModel?: string | undefined;
-        }[];
-        runId?: string | undefined;
-        intentFingerprint?: string | undefined;
-        intentText?: string | undefined;
-        opportunityIds?: string[] | undefined;
-    }, {
-        poolSize: number;
-        minedAt: string;
-        discriminator: {
-            label: string;
-            questionSeed: string;
-            sides: string[];
-            sideCounts: Record<string, number>;
-            voi: number;
-            evidenceRate: number;
-            assignments: {
-                opportunityId: string;
-                side: string;
-            }[];
-            embedding?: number[] | undefined;
-            embeddingModel?: string | undefined;
-        };
-        alternates: {
-            label: string;
-            questionSeed: string;
-            sides: string[];
-            sideCounts: Record<string, number>;
-            voi: number;
-            evidenceRate: number;
-            assignments: {
-                opportunityId: string;
-                side: string;
-            }[];
-            embedding?: number[] | undefined;
-            embeddingModel?: string | undefined;
-        }[];
-        runId?: string | undefined;
-        intentFingerprint?: string | undefined;
-        intentText?: string | undefined;
-        opportunityIds?: string[] | undefined;
-    }>>;
-    /** Post-discovery intent recovery snapshot. Internal only. */
-    recovery: z.ZodOptional<z.ZodObject<{
-        version: z.ZodLiteral<1>;
-        intentFingerprint: z.ZodString;
-        completionSource: z.ZodEnum<["intent_creation", "from_intent", "discovery_run"]>;
-        /** Privacy-safe aggregate only; raw negotiation evidence is never persisted. */
-        rejectedNegotiationCount: z.ZodOptional<z.ZodNumber>;
-        /** Bounded internal correlation id for an asynchronous discovery run. */
-        runId: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        version: 1;
-        intentFingerprint: string;
-        completionSource: "intent_creation" | "from_intent" | "discovery_run";
-        runId?: string | undefined;
-        rejectedNegotiationCount?: number | undefined;
-    }, {
-        version: 1;
-        intentFingerprint: string;
-        completionSource: "intent_creation" | "from_intent" | "discovery_run";
-        runId?: string | undefined;
-        rejectedNegotiationCount?: number | undefined;
-    }>>;
-    /** Durable request marker written before enqueueing proactive delivery. Internal only. */
-    pushRequestedAt: z.ZodOptional<z.ZodString>;
-    /** Last bounded recovery sweep that selected this request. Internal only. */
-    pushRecoveryAttemptedAt: z.ZodOptional<z.ZodString>;
-    /** Durable request outcome. Internal only. */
-    pushRequestStatus: z.ZodOptional<z.ZodEnum<["requested", "suppressed"]>>;
-    /** Permanent suppression reason for an unclaimed request. Internal only. */
-    pushRequestReason: z.ZodOptional<z.ZodEnum<["question_lifecycle", "intent_lifecycle", "malformed_source", "malformed_actor", "malformed_pool", "malformed_cycle", "visited", "pool_size", "voi", "cycle_budget"]>>;
-    /** ISO-8601 timestamp at which an unclaimed request was suppressed. Internal only. */
-    pushRequestSuppressedAt: z.ZodOptional<z.ZodString>;
-    /** Internal proactive delivery state. Never serialize to public clients. */
-    push: z.ZodOptional<z.ZodObject<{
-        version: z.ZodLiteral<1>;
-        source: z.ZodLiteral<"pool_discovery">;
-        recipientId: z.ZodString;
-        intentId: z.ZodString;
-        cycleKey: z.ZodString;
-        messageId: z.ZodString;
-        /**
-         * Where a claimed push is delivered. The second slot names the negotiator
-         * surface: new claims write `negotiator_intent_chat` (the intent-pinned
-         * session). `negotiator_dm` is the legacy literal for rows persisted before
-         * the unscoped DM was removed — this schema is validated on read, so the
-         * union keeps those rows parsing instead of rejecting them. Read-compat
-         * only; nothing writes it.
-         */
-        surfaces: z.ZodTuple<[z.ZodLiteral<"personal_agent_badge">, z.ZodUnion<[z.ZodLiteral<"negotiator_intent_chat">, z.ZodLiteral<"negotiator_dm">]>], null>;
-        claimedAt: z.ZodString;
-        deliveryStatus: z.ZodEnum<["claimed", "delivered", "suppressed", "failed"]>;
-        conversationId: z.ZodOptional<z.ZodString>;
-        deliveredAt: z.ZodOptional<z.ZodString>;
-        suppressedAt: z.ZodOptional<z.ZodString>;
-        failure: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        source: "pool_discovery";
-        version: 1;
-        recipientId: string;
-        intentId: string;
-        cycleKey: string;
-        messageId: string;
-        surfaces: ["personal_agent_badge", "negotiator_intent_chat" | "negotiator_dm"];
-        claimedAt: string;
-        deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
-        conversationId?: string | undefined;
-        deliveredAt?: string | undefined;
-        suppressedAt?: string | undefined;
-        failure?: string | undefined;
-    }, {
-        source: "pool_discovery";
-        version: 1;
-        recipientId: string;
-        intentId: string;
-        cycleKey: string;
-        messageId: string;
-        surfaces: ["personal_agent_badge", "negotiator_intent_chat" | "negotiator_dm"];
-        claimedAt: string;
-        deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
-        conversationId?: string | undefined;
-        deliveredAt?: string | undefined;
-        suppressedAt?: string | undefined;
-        failure?: string | undefined;
-    }>>;
-    /** Internal reason this question was voided after pool or intent drift. */
-    voidedReason: z.ZodOptional<z.ZodEnum<["pool_drift", "intent_edit", "recovery_drift", "negotiation_stale", "retired_mode"]>>;
-    /** Authoritative successful-delivery ledger timestamp. Internal only. */
-    pushedAt: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    mode: "chat" | "intent" | "negotiation" | "negotiation_inflight" | "pool_discovery";
-    sourceType: string;
-    sourceId: string;
-    timestamp: string;
-    push?: {
-        source: "pool_discovery";
-        version: 1;
-        recipientId: string;
-        intentId: string;
-        cycleKey: string;
-        messageId: string;
-        surfaces: ["personal_agent_badge", "negotiator_intent_chat" | "negotiator_dm"];
-        claimedAt: string;
-        deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
-        conversationId?: string | undefined;
-        deliveredAt?: string | undefined;
-        suppressedAt?: string | undefined;
-        failure?: string | undefined;
-    } | undefined;
-    strategy?: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge" | undefined;
-    underspecificationType?: "missing_constituent" | "missing_constraint" | "open_alternative_set" | null | undefined;
-    recovery?: {
-        version: 1;
-        intentFingerprint: string;
-        completionSource: "intent_creation" | "from_intent" | "discovery_run";
-        runId?: string | undefined;
-        rejectedNegotiationCount?: number | undefined;
-    } | undefined;
-    purpose?: "uptake" | "stalled_followup" | "inflight_consultation" | "recovery" | undefined;
-    negotiation?: {
-        networkId: string;
-        purpose: "uptake" | "stalled_followup" | "inflight_consultation";
-        recipientUserId: string;
-        recipientIntentId: string;
-        opportunityId: string;
-        version: 1;
-        intentFingerprint: string;
-        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-        opportunityUpdatedAt: string;
-        questionOrdinal: number;
-        counterpartyUserId?: string | undefined;
-        taskId?: string | undefined;
-        counterpartyIntentId?: string | undefined;
-        counterpartyFelicityAuthority?: number | undefined;
-        taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
-        taskUpdatedAt?: string | undefined;
-    } | undefined;
-    messageId?: string | undefined;
-    triggeredBy?: string | undefined;
-    sessionId?: string | undefined;
-    pool?: {
-        poolSize: number;
-        minedAt: string;
-        discriminator: {
-            label: string;
-            questionSeed: string;
-            sides: string[];
-            sideCounts: Record<string, number>;
-            voi: number;
-            evidenceRate: number;
-            assignments: {
-                opportunityId: string;
-                side: string;
-            }[];
-            embedding?: number[] | undefined;
-            embeddingModel?: string | undefined;
-        };
-        alternates: {
-            label: string;
-            questionSeed: string;
-            sides: string[];
-            sideCounts: Record<string, number>;
-            voi: number;
-            evidenceRate: number;
-            assignments: {
-                opportunityId: string;
-                side: string;
-            }[];
-            embedding?: number[] | undefined;
-            embeddingModel?: string | undefined;
-        }[];
-        runId?: string | undefined;
-        intentFingerprint?: string | undefined;
-        intentText?: string | undefined;
-        opportunityIds?: string[] | undefined;
-    } | undefined;
-    pushRequestedAt?: string | undefined;
-    pushRecoveryAttemptedAt?: string | undefined;
-    pushRequestStatus?: "suppressed" | "requested" | undefined;
-    pushRequestReason?: "voi" | "question_lifecycle" | "intent_lifecycle" | "malformed_source" | "malformed_actor" | "malformed_pool" | "malformed_cycle" | "visited" | "pool_size" | "cycle_budget" | undefined;
-    pushRequestSuppressedAt?: string | undefined;
-    voidedReason?: "pool_drift" | "intent_edit" | "recovery_drift" | "negotiation_stale" | "retired_mode" | undefined;
-    pushedAt?: string | undefined;
-}, {
-    mode: "chat" | "intent" | "negotiation" | "negotiation_inflight" | "pool_discovery";
-    sourceType: string;
-    sourceId: string;
-    timestamp: string;
-    push?: {
-        source: "pool_discovery";
-        version: 1;
-        recipientId: string;
-        intentId: string;
-        cycleKey: string;
-        messageId: string;
-        surfaces: ["personal_agent_badge", "negotiator_intent_chat" | "negotiator_dm"];
-        claimedAt: string;
-        deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
-        conversationId?: string | undefined;
-        deliveredAt?: string | undefined;
-        suppressedAt?: string | undefined;
-        failure?: string | undefined;
-    } | undefined;
-    strategy?: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge" | undefined;
-    underspecificationType?: "missing_constituent" | "missing_constraint" | "open_alternative_set" | null | undefined;
-    recovery?: {
-        version: 1;
-        intentFingerprint: string;
-        completionSource: "intent_creation" | "from_intent" | "discovery_run";
-        runId?: string | undefined;
-        rejectedNegotiationCount?: number | undefined;
-    } | undefined;
-    purpose?: "uptake" | "stalled_followup" | "inflight_consultation" | "recovery" | undefined;
-    negotiation?: {
-        networkId: string;
-        purpose: "uptake" | "stalled_followup" | "inflight_consultation";
-        recipientUserId: string;
-        recipientIntentId: string;
-        opportunityId: string;
-        version: 1;
-        intentFingerprint: string;
-        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-        opportunityUpdatedAt: string;
-        questionOrdinal: number;
-        counterpartyUserId?: string | undefined;
-        taskId?: string | undefined;
-        counterpartyIntentId?: string | undefined;
-        counterpartyFelicityAuthority?: number | undefined;
-        taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
-        taskUpdatedAt?: string | undefined;
-    } | undefined;
-    messageId?: string | undefined;
-    triggeredBy?: string | undefined;
-    sessionId?: string | undefined;
-    pool?: {
-        poolSize: number;
-        minedAt: string;
-        discriminator: {
-            label: string;
-            questionSeed: string;
-            sides: string[];
-            sideCounts: Record<string, number>;
-            voi: number;
-            evidenceRate: number;
-            assignments: {
-                opportunityId: string;
-                side: string;
-            }[];
-            embedding?: number[] | undefined;
-            embeddingModel?: string | undefined;
-        };
-        alternates: {
-            label: string;
-            questionSeed: string;
-            sides: string[];
-            sideCounts: Record<string, number>;
-            voi: number;
-            evidenceRate: number;
-            assignments: {
-                opportunityId: string;
-                side: string;
-            }[];
-            embedding?: number[] | undefined;
-            embeddingModel?: string | undefined;
-        }[];
-        runId?: string | undefined;
-        intentFingerprint?: string | undefined;
-        intentText?: string | undefined;
-        opportunityIds?: string[] | undefined;
-    } | undefined;
-    pushRequestedAt?: string | undefined;
-    pushRecoveryAttemptedAt?: string | undefined;
-    pushRequestStatus?: "suppressed" | "requested" | undefined;
-    pushRequestReason?: "voi" | "question_lifecycle" | "intent_lifecycle" | "malformed_source" | "malformed_actor" | "malformed_pool" | "malformed_cycle" | "visited" | "pool_size" | "cycle_budget" | undefined;
-    pushRequestSuppressedAt?: string | undefined;
-    voidedReason?: "pool_drift" | "intent_edit" | "recovery_drift" | "negotiation_stale" | "retired_mode" | undefined;
-    pushedAt?: string | undefined;
-}>, {
-    mode: "chat" | "intent" | "negotiation" | "negotiation_inflight" | "pool_discovery";
-    sourceType: string;
-    sourceId: string;
-    timestamp: string;
-    push?: {
-        source: "pool_discovery";
-        version: 1;
-        recipientId: string;
-        intentId: string;
-        cycleKey: string;
-        messageId: string;
-        surfaces: ["personal_agent_badge", "negotiator_intent_chat" | "negotiator_dm"];
-        claimedAt: string;
-        deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
-        conversationId?: string | undefined;
-        deliveredAt?: string | undefined;
-        suppressedAt?: string | undefined;
-        failure?: string | undefined;
-    } | undefined;
-    strategy?: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge" | undefined;
-    underspecificationType?: "missing_constituent" | "missing_constraint" | "open_alternative_set" | null | undefined;
-    recovery?: {
-        version: 1;
-        intentFingerprint: string;
-        completionSource: "intent_creation" | "from_intent" | "discovery_run";
-        runId?: string | undefined;
-        rejectedNegotiationCount?: number | undefined;
-    } | undefined;
-    purpose?: "uptake" | "stalled_followup" | "inflight_consultation" | "recovery" | undefined;
-    negotiation?: {
-        networkId: string;
-        purpose: "uptake" | "stalled_followup" | "inflight_consultation";
-        recipientUserId: string;
-        recipientIntentId: string;
-        opportunityId: string;
-        version: 1;
-        intentFingerprint: string;
-        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-        opportunityUpdatedAt: string;
-        questionOrdinal: number;
-        counterpartyUserId?: string | undefined;
-        taskId?: string | undefined;
-        counterpartyIntentId?: string | undefined;
-        counterpartyFelicityAuthority?: number | undefined;
-        taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
-        taskUpdatedAt?: string | undefined;
-    } | undefined;
-    messageId?: string | undefined;
-    triggeredBy?: string | undefined;
-    sessionId?: string | undefined;
-    pool?: {
-        poolSize: number;
-        minedAt: string;
-        discriminator: {
-            label: string;
-            questionSeed: string;
-            sides: string[];
-            sideCounts: Record<string, number>;
-            voi: number;
-            evidenceRate: number;
-            assignments: {
-                opportunityId: string;
-                side: string;
-            }[];
-            embedding?: number[] | undefined;
-            embeddingModel?: string | undefined;
-        };
-        alternates: {
-            label: string;
-            questionSeed: string;
-            sides: string[];
-            sideCounts: Record<string, number>;
-            voi: number;
-            evidenceRate: number;
-            assignments: {
-                opportunityId: string;
-                side: string;
-            }[];
-            embedding?: number[] | undefined;
-            embeddingModel?: string | undefined;
-        }[];
-        runId?: string | undefined;
-        intentFingerprint?: string | undefined;
-        intentText?: string | undefined;
-        opportunityIds?: string[] | undefined;
-    } | undefined;
-    pushRequestedAt?: string | undefined;
-    pushRecoveryAttemptedAt?: string | undefined;
-    pushRequestStatus?: "suppressed" | "requested" | undefined;
-    pushRequestReason?: "voi" | "question_lifecycle" | "intent_lifecycle" | "malformed_source" | "malformed_actor" | "malformed_pool" | "malformed_cycle" | "visited" | "pool_size" | "cycle_budget" | undefined;
-    pushRequestSuppressedAt?: string | undefined;
-    voidedReason?: "pool_drift" | "intent_edit" | "recovery_drift" | "negotiation_stale" | "retired_mode" | undefined;
-    pushedAt?: string | undefined;
-}, {
-    mode: "chat" | "intent" | "negotiation" | "negotiation_inflight" | "pool_discovery";
-    sourceType: string;
-    sourceId: string;
-    timestamp: string;
-    push?: {
-        source: "pool_discovery";
-        version: 1;
-        recipientId: string;
-        intentId: string;
-        cycleKey: string;
-        messageId: string;
-        surfaces: ["personal_agent_badge", "negotiator_intent_chat" | "negotiator_dm"];
-        claimedAt: string;
-        deliveryStatus: "failed" | "claimed" | "delivered" | "suppressed";
-        conversationId?: string | undefined;
-        deliveredAt?: string | undefined;
-        suppressedAt?: string | undefined;
-        failure?: string | undefined;
-    } | undefined;
-    strategy?: "refine_intent" | "surface_missing_detail" | "open_adjacent_thread" | "reflective_summary" | "surface_emergent_knowledge" | undefined;
-    underspecificationType?: "missing_constituent" | "missing_constraint" | "open_alternative_set" | null | undefined;
-    recovery?: {
-        version: 1;
-        intentFingerprint: string;
-        completionSource: "intent_creation" | "from_intent" | "discovery_run";
-        runId?: string | undefined;
-        rejectedNegotiationCount?: number | undefined;
-    } | undefined;
-    purpose?: "uptake" | "stalled_followup" | "inflight_consultation" | "recovery" | undefined;
-    negotiation?: {
-        networkId: string;
-        purpose: "uptake" | "stalled_followup" | "inflight_consultation";
-        recipientUserId: string;
-        recipientIntentId: string;
-        opportunityId: string;
-        version: 1;
-        intentFingerprint: string;
-        opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
-        opportunityUpdatedAt: string;
-        questionOrdinal: number;
-        counterpartyUserId?: string | undefined;
-        taskId?: string | undefined;
-        counterpartyIntentId?: string | undefined;
-        counterpartyFelicityAuthority?: number | undefined;
-        taskState?: "rejected" | "waiting_for_agent" | "input_required" | "completed" | "failed" | "submitted" | "working" | "canceled" | "auth_required" | "claimed" | undefined;
-        taskUpdatedAt?: string | undefined;
-    } | undefined;
-    messageId?: string | undefined;
-    triggeredBy?: string | undefined;
-    sessionId?: string | undefined;
-    pool?: {
-        poolSize: number;
-        minedAt: string;
-        discriminator: {
-            label: string;
-            questionSeed: string;
-            sides: string[];
-            sideCounts: Record<string, number>;
-            voi: number;
-            evidenceRate: number;
-            assignments: {
-                opportunityId: string;
-                side: string;
-            }[];
-            embedding?: number[] | undefined;
-            embeddingModel?: string | undefined;
-        };
-        alternates: {
-            label: string;
-            questionSeed: string;
-            sides: string[];
-            sideCounts: Record<string, number>;
-            voi: number;
-            evidenceRate: number;
-            assignments: {
-                opportunityId: string;
-                side: string;
-            }[];
-            embedding?: number[] | undefined;
-            embeddingModel?: string | undefined;
-        }[];
-        runId?: string | undefined;
-        intentFingerprint?: string | undefined;
-        intentText?: string | undefined;
-        opportunityIds?: string[] | undefined;
-    } | undefined;
-    pushRequestedAt?: string | undefined;
-    pushRecoveryAttemptedAt?: string | undefined;
-    pushRequestStatus?: "suppressed" | "requested" | undefined;
-    pushRequestReason?: "voi" | "question_lifecycle" | "intent_lifecycle" | "malformed_source" | "malformed_actor" | "malformed_pool" | "malformed_cycle" | "visited" | "pool_size" | "cycle_budget" | undefined;
-    pushRequestSuppressedAt?: string | undefined;
-    voidedReason?: "pool_drift" | "intent_edit" | "recovery_drift" | "negotiation_stale" | "retired_mode" | undefined;
-    pushedAt?: string | undefined;
-}>;
-export declare const QuestionActorSchema: z.ZodObject<{
-    /** The user this question is for. */
-    userId: z.ZodString;
-    /** Optional network context. */
-    networkId: z.ZodOptional<z.ZodString>;
-    /** Actor's role in the question — currently always "subject". */
-    role: z.ZodLiteral<"subject">;
-}, "strip", z.ZodTypeAny, {
-    userId: string;
-    role: "subject";
-    networkId?: string | undefined;
-}, {
-    userId: string;
-    role: "subject";
-    networkId?: string | undefined;
-}>;
-export declare const QuestionAnswerSchema: z.ZodObject<{
-    /** Option labels the user selected. */
-    selectedOptions: z.ZodArray<z.ZodString, "many">;
-    /** Free-text input when the user chose "Other" or elaborated. */
-    freeText: z.ZodOptional<z.ZodString>;
-    /** User ID of the answerer. */
-    answeredBy: z.ZodString;
-    /** ISO-8601 timestamp of when the answer was submitted. */
-    answeredAt: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    selectedOptions: string[];
-    answeredBy: string;
-    answeredAt: string;
-    freeText?: string | undefined;
-}, {
-    selectedOptions: string[];
-    answeredBy: string;
-    answeredAt: string;
-    freeText?: string | undefined;
-}>;
-export type NegotiationQuestionPurpose = z.infer<typeof NegotiationQuestionPurposeSchema>;
-export type NegotiationQuestionCandidate = z.infer<typeof NegotiationQuestionCandidateSchema>;
-export type NegotiationQuestionProvenance = z.infer<typeof NegotiationQuestionProvenanceSchema>;
-export type QuestionPurpose = z.infer<typeof QuestionPurposeSchema>;
-export type QuestionMode = z.infer<typeof QuestionModeSchema>;
-export type QuestionDetection = z.infer<typeof QuestionDetectionSchema>;
-export type QuestionActor = z.infer<typeof QuestionActorSchema>;
-export type QuestionAnswer = z.infer<typeof QuestionAnswerSchema>;
-export type QuestionPoolAssignment = z.infer<typeof QuestionPoolAssignmentSchema>;
-export type QuestionPoolDiscriminator = z.infer<typeof QuestionPoolDiscriminatorSchema>;
-export type QuestionPoolSnapshot = z.infer<typeof QuestionPoolSnapshotSchema>;
-export type QuestionRecoverySnapshot = z.infer<typeof QuestionRecoverySnapshotSchema>;
-export type QuestionPoolPush = z.infer<typeof QuestionPoolPushSchema>;
-export type QuestionVoidedReason = z.infer<typeof QuestionVoidedReasonSchema>;
-export type QuestionPoolPushRequestStatus = z.infer<typeof QuestionPoolPushRequestStatusSchema>;
-export type QuestionPoolPushRequestReason = z.infer<typeof QuestionPoolPushRequestReasonSchema>;