@indexnetwork/protocol 22.0.0-rc.498.1 → 64.0.0-rc.604.2

package/dist/shared/schemas/negotiation-state.schema.d.ts

@@ -1,343 +0,0 @@
-/**
- * Negotiation state DTOs extracted from negotiations/negotiation.state.ts for
- * consumption by shared interfaces. This shared module owns the DTO schemas;
- * LangGraph Annotation.Root stays in the domain file.
- */
-import { z } from "zod";
-/**
- * Union of every negotiation turn action across protocol versions.
- *
- * v1 vocabulary: `propose | accept | reject | counter | question`.
- * v2 (client-advocate seat rules) renames `propose`→`outreach` and splits
- * `reject` into `withdraw` (initiator seat) / `decline` (counterparty seat).
- * Which subset is valid for a given turn depends on the task's
- * `protocolVersion` and the acting user's seat — see
- * `negotiations/negotiation.protocol.ts` for the seat-scoped schemas.
- */
-export declare const NEGOTIATION_ACTIONS: readonly ["propose", "accept", "reject", "counter", "question", "outreach", "withdraw", "decline", "ask_user"];
-export type NegotiationAction = (typeof NEGOTIATION_ACTIONS)[number];
-/** Negotiation seat under the v2 client-advocate protocol. */
-export type NegotiationSeat = "initiator" | "counterparty";
-/** Negotiation protocol version stamped on task metadata. */
-export type NegotiationProtocolVersion = "v1" | "v2";
-/** Closed, content-free reasons that select server-owned consultation copy. */
-export declare const NEGOTIATION_CONSULTATION_REASONS: readonly ["unresolved_owner_constraint", "consequential_disclosure_permission", "repeated_non_convergence", "insufficient_commitment_authority"];
-export declare const NegotiationConsultationReasonSchema: z.ZodEnum<["unresolved_owner_constraint", "consequential_disclosure_permission", "repeated_non_convergence", "insufficient_commitment_authority"]>;
-export type NegotiationConsultationReason = z.infer<typeof NegotiationConsultationReasonSchema>;
-/**
- * Payload for a v2 `ask_user` action.
- *
- * `reason` stays the closed enum it has always been: it is admission metadata
- * for the deterministic consultation policy, not copy. `question` is the
- * channel through which the user's own personal agent — the only thing that
- * should be writing questions — hands over the question it authored from the
- * negotiation it is actually having. Free-form keys beyond these two are still
- * rejected by `.strict()`.
- */
-export declare const AskUserPayloadSchema: z.ZodObject<{
-    reason: z.ZodEnum<["unresolved_owner_constraint", "consequential_disclosure_permission", "repeated_non_convergence", "insufficient_commitment_authority"]>;
-    /**
-     * The question the negotiating agent wrote, in the structured shape the UI
-     * already renders. Optional: v1 turns, external agents, and the existing
-     * enum-only path must all keep validating, so a payload of `{ reason }`
-     * alone stays byte-identical in and out.
-     *
-     * Declared `.nullable().optional()` (not bare `.optional()`) so the enclosing
-     * turn schemas survive OpenAI/OpenRouter strict structured-output conversion,
-     * which rejects optional-without-nullable fields — the same constraint
-     * documented on `QuestionSchema.evidence`. The `.transform()` normalizes an
-     * LLM-returned `null` back to `undefined`, so a null is never persisted and
-     * `null` and omitted read as absent identically downstream.
-     */
-    question: z.ZodEffects<z.ZodOptional<z.ZodNullable<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;
-    }, "strip", z.ZodTypeAny, {
-        prompt: string;
-        options: {
-            label: string;
-            description: string;
-        }[];
-        title: string;
-        multiSelect: boolean;
-    }, {
-        prompt: string;
-        options: {
-            label: string;
-            description: string;
-        }[];
-        title: string;
-        multiSelect: boolean;
-    }>>>, {
-        prompt: string;
-        options: {
-            label: string;
-            description: string;
-        }[];
-        title: string;
-        multiSelect: boolean;
-    } | undefined, {
-        prompt: string;
-        options: {
-            label: string;
-            description: string;
-        }[];
-        title: string;
-        multiSelect: boolean;
-    } | null | undefined>;
-}, "strict", z.ZodTypeAny, {
-    reason: "unresolved_owner_constraint" | "consequential_disclosure_permission" | "repeated_non_convergence" | "insufficient_commitment_authority";
-    question?: {
-        prompt: string;
-        options: {
-            label: string;
-            description: string;
-        }[];
-        title: string;
-        multiSelect: boolean;
-    } | undefined;
-}, {
-    reason: "unresolved_owner_constraint" | "consequential_disclosure_permission" | "repeated_non_convergence" | "insufficient_commitment_authority";
-    question?: {
-        prompt: string;
-        options: {
-            label: string;
-            description: string;
-        }[];
-        title: string;
-        multiSelect: boolean;
-    } | null | undefined;
-}>;
-export type AskUserPayload = z.infer<typeof AskUserPayloadSchema>;
-export declare const NegotiationTurnSchema: z.ZodObject<{
-    action: z.ZodEnum<["propose", "accept", "reject", "counter", "question", "outreach", "withdraw", "decline", "ask_user"]>;
-    assessment: z.ZodObject<{
-        reasoning: z.ZodString;
-        suggestedRoles: z.ZodObject<{
-            ownUser: z.ZodEnum<["agent", "patient", "peer"]>;
-            otherUser: z.ZodEnum<["agent", "patient", "peer"]>;
-        }, "strip", z.ZodTypeAny, {
-            ownUser: "agent" | "patient" | "peer";
-            otherUser: "agent" | "patient" | "peer";
-        }, {
-            ownUser: "agent" | "patient" | "peer";
-            otherUser: "agent" | "patient" | "peer";
-        }>;
-    }, "strip", z.ZodTypeAny, {
-        reasoning: string;
-        suggestedRoles: {
-            ownUser: "agent" | "patient" | "peer";
-            otherUser: "agent" | "patient" | "peer";
-        };
-    }, {
-        reasoning: string;
-        suggestedRoles: {
-            ownUser: "agent" | "patient" | "peer";
-            otherUser: "agent" | "patient" | "peer";
-        };
-    }>;
-    message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    /** Present when action is `ask_user` (v2, P3.2). */
-    askUser: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        reason: z.ZodEnum<["unresolved_owner_constraint", "consequential_disclosure_permission", "repeated_non_convergence", "insufficient_commitment_authority"]>;
-        /**
-         * The question the negotiating agent wrote, in the structured shape the UI
-         * already renders. Optional: v1 turns, external agents, and the existing
-         * enum-only path must all keep validating, so a payload of `{ reason }`
-         * alone stays byte-identical in and out.
-         *
-         * Declared `.nullable().optional()` (not bare `.optional()`) so the enclosing
-         * turn schemas survive OpenAI/OpenRouter strict structured-output conversion,
-         * which rejects optional-without-nullable fields — the same constraint
-         * documented on `QuestionSchema.evidence`. The `.transform()` normalizes an
-         * LLM-returned `null` back to `undefined`, so a null is never persisted and
-         * `null` and omitted read as absent identically downstream.
-         */
-        question: z.ZodEffects<z.ZodOptional<z.ZodNullable<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;
-        }, "strip", z.ZodTypeAny, {
-            prompt: string;
-            options: {
-                label: string;
-                description: string;
-            }[];
-            title: string;
-            multiSelect: boolean;
-        }, {
-            prompt: string;
-            options: {
-                label: string;
-                description: string;
-            }[];
-            title: string;
-            multiSelect: boolean;
-        }>>>, {
-            prompt: string;
-            options: {
-                label: string;
-                description: string;
-            }[];
-            title: string;
-            multiSelect: boolean;
-        } | undefined, {
-            prompt: string;
-            options: {
-                label: string;
-                description: string;
-            }[];
-            title: string;
-            multiSelect: boolean;
-        } | null | undefined>;
-    }, "strict", z.ZodTypeAny, {
-        reason: "unresolved_owner_constraint" | "consequential_disclosure_permission" | "repeated_non_convergence" | "insufficient_commitment_authority";
-        question?: {
-            prompt: string;
-            options: {
-                label: string;
-                description: string;
-            }[];
-            title: string;
-            multiSelect: boolean;
-        } | undefined;
-    }, {
-        reason: "unresolved_owner_constraint" | "consequential_disclosure_permission" | "repeated_non_convergence" | "insufficient_commitment_authority";
-        question?: {
-            prompt: string;
-            options: {
-                label: string;
-                description: string;
-            }[];
-            title: string;
-            multiSelect: boolean;
-        } | null | undefined;
-    }>>>;
-}, "strip", z.ZodTypeAny, {
-    action: "propose" | "accept" | "reject" | "counter" | "question" | "outreach" | "withdraw" | "decline" | "ask_user";
-    assessment: {
-        reasoning: string;
-        suggestedRoles: {
-            ownUser: "agent" | "patient" | "peer";
-            otherUser: "agent" | "patient" | "peer";
-        };
-    };
-    message?: string | null | undefined;
-    askUser?: {
-        reason: "unresolved_owner_constraint" | "consequential_disclosure_permission" | "repeated_non_convergence" | "insufficient_commitment_authority";
-        question?: {
-            prompt: string;
-            options: {
-                label: string;
-                description: string;
-            }[];
-            title: string;
-            multiSelect: boolean;
-        } | undefined;
-    } | null | undefined;
-}, {
-    action: "propose" | "accept" | "reject" | "counter" | "question" | "outreach" | "withdraw" | "decline" | "ask_user";
-    assessment: {
-        reasoning: string;
-        suggestedRoles: {
-            ownUser: "agent" | "patient" | "peer";
-            otherUser: "agent" | "patient" | "peer";
-        };
-    };
-    message?: string | null | undefined;
-    askUser?: {
-        reason: "unresolved_owner_constraint" | "consequential_disclosure_permission" | "repeated_non_convergence" | "insufficient_commitment_authority";
-        question?: {
-            prompt: string;
-            options: {
-                label: string;
-                description: string;
-            }[];
-            title: string;
-            multiSelect: boolean;
-        } | null | undefined;
-    } | null | undefined;
-}>;
-export type NegotiationTurn = z.infer<typeof NegotiationTurnSchema>;
-export declare const NegotiationOutcomeSchema: z.ZodObject<{
-    hasOpportunity: z.ZodBoolean;
-    agreedRoles: z.ZodArray<z.ZodObject<{
-        userId: z.ZodString;
-        role: z.ZodEnum<["agent", "patient", "peer"]>;
-    }, "strip", z.ZodTypeAny, {
-        userId: string;
-        role: "agent" | "patient" | "peer";
-    }, {
-        userId: string;
-        role: "agent" | "patient" | "peer";
-    }>, "many">;
-    reasoning: z.ZodString;
-    turnCount: z.ZodNumber;
-    reason: z.ZodOptional<z.ZodEnum<["turn_cap", "timeout", "screened_out"]>>;
-}, "strip", z.ZodTypeAny, {
-    reasoning: string;
-    hasOpportunity: boolean;
-    agreedRoles: {
-        userId: string;
-        role: "agent" | "patient" | "peer";
-    }[];
-    turnCount: number;
-    reason?: "timeout" | "turn_cap" | "screened_out" | undefined;
-}, {
-    reasoning: string;
-    hasOpportunity: boolean;
-    agreedRoles: {
-        userId: string;
-        role: "agent" | "patient" | "peer";
-    }[];
-    turnCount: number;
-    reason?: "timeout" | "turn_cap" | "screened_out" | undefined;
-}>;
-export type NegotiationOutcome = z.infer<typeof NegotiationOutcomeSchema>;
-/** Context each agent receives about its user. */
-export interface UserNegotiationContext {
-    id: string;
-    intents: Array<{
-        id: string;
-        title: string;
-        description: string;
-        confidence: number;
-    }>;
-    profile: {
-        name?: string;
-        bio?: string;
-        location?: string;
-        interests?: string[];
-        skills?: string[];
-    };
-}
-/** Seed assessment from the evaluator pre-filter. */
-export interface SeedAssessment {
-    reasoning: string;
-    valencyRole: string;
-    actors?: Array<{
-        userId: string;
-        role: string;
-    }>;
-}

package/dist/shared/schemas/negotiation-state.schema.js

@@ -1,81 +0,0 @@
-/**
- * Negotiation state DTOs extracted from negotiations/negotiation.state.ts for
- * consumption by shared interfaces. This shared module owns the DTO schemas;
- * LangGraph Annotation.Root stays in the domain file.
- */
-import { z } from "zod";
-import { StructuredQuestionSchema } from "./structured-question.schema.js";
-// ─── Zod schemas (available for runtime validation) ───────────────────────────
-/**
- * Union of every negotiation turn action across protocol versions.
- *
- * v1 vocabulary: `propose | accept | reject | counter | question`.
- * v2 (client-advocate seat rules) renames `propose`→`outreach` and splits
- * `reject` into `withdraw` (initiator seat) / `decline` (counterparty seat).
- * Which subset is valid for a given turn depends on the task's
- * `protocolVersion` and the acting user's seat — see
- * `negotiations/negotiation.protocol.ts` for the seat-scoped schemas.
- */
-export const NEGOTIATION_ACTIONS = [
-    "propose", "accept", "reject", "counter", "question",
-    "outreach", "withdraw", "decline",
-    "ask_user",
-];
-/** Closed, content-free reasons that select server-owned consultation copy. */
-export const NEGOTIATION_CONSULTATION_REASONS = [
-    "unresolved_owner_constraint",
-    "consequential_disclosure_permission",
-    "repeated_non_convergence",
-    "insufficient_commitment_authority",
-];
-export const NegotiationConsultationReasonSchema = z.enum(NEGOTIATION_CONSULTATION_REASONS);
-/**
- * Payload for a v2 `ask_user` action.
- *
- * `reason` stays the closed enum it has always been: it is admission metadata
- * for the deterministic consultation policy, not copy. `question` is the
- * channel through which the user's own personal agent — the only thing that
- * should be writing questions — hands over the question it authored from the
- * negotiation it is actually having. Free-form keys beyond these two are still
- * rejected by `.strict()`.
- */
-export const AskUserPayloadSchema = z.object({
-    reason: NegotiationConsultationReasonSchema,
-    /**
-     * The question the negotiating agent wrote, in the structured shape the UI
-     * already renders. Optional: v1 turns, external agents, and the existing
-     * enum-only path must all keep validating, so a payload of `{ reason }`
-     * alone stays byte-identical in and out.
-     *
-     * Declared `.nullable().optional()` (not bare `.optional()`) so the enclosing
-     * turn schemas survive OpenAI/OpenRouter strict structured-output conversion,
-     * which rejects optional-without-nullable fields — the same constraint
-     * documented on `QuestionSchema.evidence`. The `.transform()` normalizes an
-     * LLM-returned `null` back to `undefined`, so a null is never persisted and
-     * `null` and omitted read as absent identically downstream.
-     */
-    question: StructuredQuestionSchema.nullable().optional().transform((value) => value ?? undefined),
-}).strict();
-export const NegotiationTurnSchema = z.object({
-    action: z.enum(NEGOTIATION_ACTIONS),
-    assessment: z.object({
-        reasoning: z.string(),
-        suggestedRoles: z.object({
-            ownUser: z.enum(["agent", "patient", "peer"]),
-            otherUser: z.enum(["agent", "patient", "peer"]),
-        }),
-    }),
-    message: z.string().nullable().optional(),
-    /** Present when action is `ask_user` (v2, P3.2). */
-    askUser: AskUserPayloadSchema.nullable().optional(),
-});
-export const NegotiationOutcomeSchema = z.object({
-    hasOpportunity: z.boolean(),
-    agreedRoles: z.array(z.object({
-        userId: z.string(),
-        role: z.enum(["agent", "patient", "peer"]),
-    })),
-    reasoning: z.string(),
-    turnCount: z.number(),
-    reason: z.enum(["turn_cap", "timeout", "screened_out"]).optional(),
-});

package/dist/shared/schemas/question-block.fixture.d.ts

@@ -1,12 +0,0 @@
-/**
- * Canonical question-message fixture for the question block contract.
- *
- * `questionMessageFixture` is a literal — not derived from the serializer — so
- * a serializer change that would alter the wire format breaks the spec loudly.
- * The web client's steps-UI tests should import this via
- * `@indexnetwork/protocol/question-block/fixture` instead of minting their own.
- */
-import type { QuestionBlock } from "./question-block.schema.js";
-export declare const questionProseFixture: string;
-export declare const questionBlockFixture: QuestionBlock;
-export declare const questionMessageFixture: string;

package/dist/shared/schemas/question-block.fixture.js

@@ -1,39 +0,0 @@
-export const questionProseFixture = [
-    "I moved three conversations forward on your search for a technical co-founder.",
-    "Two of them are waiting on details only you can give — answer here and I will",
-    "pick the negotiations back up.",
-].join("\n");
-export const questionBlockFixture = {
-    version: 1,
-    questions: [
-        {
-            prompt: "Both counterparts asked about equity: what range are you prepared to offer a founding engineer?",
-            opportunityId: "0b0e8a9c-6d3f-4d6a-9f2e-1c5b7a4d8e01",
-            alsoUnblocks: ["7f3d2c1b-8a90-4e5f-b6c7-d8e9f0a1b2c3"],
-        },
-        {
-            prompt: "The Berlin robotics lab wants to know whether you can be on-site one week per month.",
-            opportunityId: "4a5b6c7d-8e9f-4a1b-8c2d-3e4f5a6b7c8d",
-        },
-    ],
-};
-export const questionMessageFixture = `${questionProseFixture}
-
-\`\`\`index-questions
-{
-  "version": 1,
-  "questions": [
-    {
-      "prompt": "Both counterparts asked about equity: what range are you prepared to offer a founding engineer?",
-      "opportunityId": "0b0e8a9c-6d3f-4d6a-9f2e-1c5b7a4d8e01",
-      "alsoUnblocks": [
-        "7f3d2c1b-8a90-4e5f-b6c7-d8e9f0a1b2c3"
-      ]
-    },
-    {
-      "prompt": "The Berlin robotics lab wants to know whether you can be on-site one week per month.",
-      "opportunityId": "4a5b6c7d-8e9f-4a1b-8c2d-3e4f5a6b7c8d"
-    }
-  ]
-}
-\`\`\``;

package/dist/shared/schemas/question-block.schema.d.ts

@@ -1,111 +0,0 @@
-/**
- * The question block: the rendering contract between the negotiator's
- * question-message and the web client's steps UI, and the routing contract
- * for answers (docs/plans/2026-08-18-conversational-questions.md).
- *
- * The block is a *view* of the currently-parked negotiations for one intent
- * scope, regenerated fresh on every change — it is not a persistence schema
- * and must never grow state (answered flags, timestamps, question ids).
- * A question's identity is its primary negotiation reference: the id of the
- * opportunity row the negotiation runs on. Task re-resolution from that row
- * is server-side and never encoded here — deliberately, because a snapshotted
- * task id would go stale: answer routing branches on what it re-resolves
- * (an `input_required` task → mid-flight consult, answered via the exact
- * continuation's successor task; a completed task on a stalled opportunity
- * with a trailing ask_user gap → post-stall park, answered via a retry).
- *
- * This module must stay browser-safe: it may import zod and nothing else.
- * It is exposed to the web client via the `@indexnetwork/protocol/question-block`
- * subpath export (see STABILITY.md).
- */
-import { z } from "zod";
-/** Info string of the fenced section that carries the block in a message body. */
-export declare const QUESTION_BLOCK_MARKER = "index-questions";
-/** Bump when the block shape changes; parsers fail closed on unknown versions. */
-export declare const QUESTION_BLOCK_VERSION = 1;
-export declare const QuestionBlockQuestionSchema: z.ZodObject<{
-    /** Agent-authored question text, rendered as one step. */
-    prompt: z.ZodString;
-    /** Primary negotiation this question unparks; doubles as the question's identity. */
-    opportunityId: z.ZodString;
-    /** Further negotiations parked on the same gap that this answer also unparks. */
-    alsoUnblocks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-}, "strict", z.ZodTypeAny, {
-    prompt: string;
-    opportunityId: string;
-    alsoUnblocks?: string[] | undefined;
-}, {
-    prompt: string;
-    opportunityId: string;
-    alsoUnblocks?: string[] | undefined;
-}>;
-export type QuestionBlockQuestion = z.infer<typeof QuestionBlockQuestionSchema>;
-export declare const QuestionBlockSchema: z.ZodEffects<z.ZodObject<{
-    version: z.ZodLiteral<1>;
-    questions: z.ZodArray<z.ZodObject<{
-        /** Agent-authored question text, rendered as one step. */
-        prompt: z.ZodString;
-        /** Primary negotiation this question unparks; doubles as the question's identity. */
-        opportunityId: z.ZodString;
-        /** Further negotiations parked on the same gap that this answer also unparks. */
-        alsoUnblocks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strict", z.ZodTypeAny, {
-        prompt: string;
-        opportunityId: string;
-        alsoUnblocks?: string[] | undefined;
-    }, {
-        prompt: string;
-        opportunityId: string;
-        alsoUnblocks?: string[] | undefined;
-    }>, "many">;
-}, "strict", z.ZodTypeAny, {
-    questions: {
-        prompt: string;
-        opportunityId: string;
-        alsoUnblocks?: string[] | undefined;
-    }[];
-    version: 1;
-}, {
-    questions: {
-        prompt: string;
-        opportunityId: string;
-        alsoUnblocks?: string[] | undefined;
-    }[];
-    version: 1;
-}>, {
-    questions: {
-        prompt: string;
-        opportunityId: string;
-        alsoUnblocks?: string[] | undefined;
-    }[];
-    version: 1;
-}, {
-    questions: {
-        prompt: string;
-        opportunityId: string;
-        alsoUnblocks?: string[] | undefined;
-    }[];
-    version: 1;
-}>;
-export type QuestionBlock = z.infer<typeof QuestionBlockSchema>;
-/** A parsed question-message: the agent's prose and the block that followed it. */
-export interface ParsedQuestionMessage {
-    prose: string;
-    block: QuestionBlock;
-}
-/**
- * Embed a block after the agent's prose. The block is always the terminal
- * section of the body: prose, a blank line, then a fenced section whose info
- * string is the marker. The fence is lengthened past any backtick run in the
- * payload so the payload can never close it early.
- *
- * Throws on a block that fails the schema — serializing an invalid block is a
- * producer bug, not a rendering condition.
- */
-export declare function serializeQuestionMessage(prose: string, block: QuestionBlock): string;
-/**
- * Extract the block from a message body. Fails closed: any body that does not
- * end in exactly one well-formed, schema-valid block returns null, and the
- * caller renders the whole body as plain text — never a broken steps UI.
- */
-export declare function parseQuestionMessage(body: string): ParsedQuestionMessage | null;