@indexnetwork/protocol 20.0.0-rc.484.1 → 21.0.0-rc.486.1

package/dist/questions/{domain/question.schema.d.ts → question.schema.d.ts}

@@ -1,14 +1,12 @@
 /**
- * questions/domain/question.schema — canonical home for question value types and schemas.
+ * 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.
- *
- * IND-547: canonical question schema in the questions domain layer.
  */
 import { z } from "zod";
-import { UnderspecificationTypeSchema, type UnderspecificationType } from "../../shared/schemas/underspecification.schema.js";
+import { UnderspecificationTypeSchema, type UnderspecificationType } from "../shared/schemas/underspecification.schema.js";
 export { UnderspecificationTypeSchema };
 export declare const QuestionOptionSchema: z.ZodObject<{
     /** Display text. Suffix " (Recommended)" on the safest path; list it first. */
@@ -256,24 +254,24 @@ export declare const QuestionPurposeSchema: z.ZodEnum<["uptake", "recovery", "st
  * authoritative rows before generation; callers cannot mint provenance.
  */
 export declare const NegotiationQuestionCandidateSchema: z.ZodEffects<z.ZodObject<{
-    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;
+    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. */
-    counterpartyUserId: z.ZodOptional<z.ZodString>;
-    counterpartyIntentId: z.ZodOptional<z.ZodString>;
-    counterpartyFelicityAuthority: z.ZodOptional<z.ZodNumber>;
+    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;
-    taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
+    taskId?: string | undefined;
     counterpartyIntentId?: string | undefined;
     counterpartyFelicityAuthority?: number | undefined;
 }, {
@@ -282,8 +280,8 @@ export declare const NegotiationQuestionCandidateSchema: z.ZodEffects<z.ZodObjec
     recipientUserId: string;
     recipientIntentId: string;
     opportunityId: string;
-    taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
+    taskId?: string | undefined;
     counterpartyIntentId?: string | undefined;
     counterpartyFelicityAuthority?: number | undefined;
 }>, {
@@ -292,8 +290,8 @@ export declare const NegotiationQuestionCandidateSchema: z.ZodEffects<z.ZodObjec
     recipientUserId: string;
     recipientIntentId: string;
     opportunityId: string;
-    taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
+    taskId?: string | undefined;
     counterpartyIntentId?: string | undefined;
     counterpartyFelicityAuthority?: number | undefined;
 }, {
@@ -302,8 +300,8 @@ export declare const NegotiationQuestionCandidateSchema: z.ZodEffects<z.ZodObjec
     recipientUserId: string;
     recipientIntentId: string;
     opportunityId: string;
-    taskId?: string | undefined;
     counterpartyUserId?: string | undefined;
+    taskId?: string | undefined;
     counterpartyIntentId?: string | undefined;
     counterpartyFelicityAuthority?: number | undefined;
 }>;
@@ -312,24 +310,23 @@ export declare const NegotiationQuestionCandidateSchema: z.ZodEffects<z.ZodObjec
  * questions. This object is stripped from every REST/MCP projection.
  */
 export declare const NegotiationQuestionProvenanceSchema: z.ZodEffects<z.ZodObject<{
-    version: z.ZodLiteral<1>;
+    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;
-    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>;
-    /** Uptake only: exact low-authority counterparty eligibility binding. */
     counterpartyUserId: z.ZodOptional<z.ZodString>;
     counterpartyIntentId: z.ZodOptional<z.ZodString>;
     counterpartyFelicityAuthority: z.ZodOptional<z.ZodNumber>;
-    /** Stable per-generation position so retries dedupe without reducing cardinality. */
-    questionOrdinal: z.ZodNumber;
+    version: z.ZodLiteral<1>;
 }, "strip", z.ZodTypeAny, {
     networkId: string;
     purpose: "uptake" | "stalled_followup" | "inflight_consultation";
@@ -341,8 +338,8 @@ export declare const NegotiationQuestionProvenanceSchema: z.ZodEffects<z.ZodObje
     opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
     opportunityUpdatedAt: string;
     questionOrdinal: number;
-    taskId?: string | undefined;
     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;
@@ -358,8 +355,8 @@ export declare const NegotiationQuestionProvenanceSchema: z.ZodEffects<z.ZodObje
     opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
     opportunityUpdatedAt: string;
     questionOrdinal: number;
-    taskId?: string | undefined;
     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;
@@ -375,8 +372,8 @@ export declare const NegotiationQuestionProvenanceSchema: z.ZodEffects<z.ZodObje
     opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
     opportunityUpdatedAt: string;
     questionOrdinal: number;
-    taskId?: string | undefined;
     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;
@@ -392,8 +389,8 @@ export declare const NegotiationQuestionProvenanceSchema: z.ZodEffects<z.ZodObje
     opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
     opportunityUpdatedAt: string;
     questionOrdinal: number;
-    taskId?: string | undefined;
     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;
@@ -740,24 +737,23 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
     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<{
-        version: z.ZodLiteral<1>;
+        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;
-        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>;
-        /** Uptake only: exact low-authority counterparty eligibility binding. */
         counterpartyUserId: z.ZodOptional<z.ZodString>;
         counterpartyIntentId: z.ZodOptional<z.ZodString>;
         counterpartyFelicityAuthority: z.ZodOptional<z.ZodNumber>;
-        /** Stable per-generation position so retries dedupe without reducing cardinality. */
-        questionOrdinal: z.ZodNumber;
+        version: z.ZodLiteral<1>;
     }, "strip", z.ZodTypeAny, {
         networkId: string;
         purpose: "uptake" | "stalled_followup" | "inflight_consultation";
@@ -769,8 +765,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
         opportunityUpdatedAt: string;
         questionOrdinal: number;
-        taskId?: string | undefined;
         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;
@@ -786,8 +782,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
         opportunityUpdatedAt: string;
         questionOrdinal: number;
-        taskId?: string | undefined;
         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;
@@ -803,8 +799,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
         opportunityUpdatedAt: string;
         questionOrdinal: number;
-        taskId?: string | undefined;
         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;
@@ -820,8 +816,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
         opportunityUpdatedAt: string;
         questionOrdinal: number;
-        taskId?: string | undefined;
         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;
@@ -1161,8 +1157,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
         opportunityUpdatedAt: string;
         questionOrdinal: number;
-        taskId?: string | undefined;
         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;
@@ -1255,8 +1251,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
         opportunityUpdatedAt: string;
         questionOrdinal: number;
-        taskId?: string | undefined;
         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;
@@ -1349,8 +1345,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
         opportunityUpdatedAt: string;
         questionOrdinal: number;
-        taskId?: string | undefined;
         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;
@@ -1443,8 +1439,8 @@ export declare const QuestionDetectionSchema: z.ZodEffects<z.ZodObject<{
         opportunityStatus: "latent" | "draft" | "negotiating" | "pending" | "stalled" | "accepted" | "rejected" | "expired";
         opportunityUpdatedAt: string;
         questionOrdinal: number;
-        taskId?: string | undefined;
         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;

package/dist/questions/{domain/question.schema.js → question.schema.js}

@@ -1,14 +1,12 @@
 /**
- * questions/domain/question.schema — canonical home for question value types and schemas.
+ * 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.
- *
- * IND-547: canonical question schema in the questions domain layer.
  */
 import { z } from "zod";
-import { UnderspecificationTypeSchema } from "../../shared/schemas/underspecification.schema.js";
+import { UnderspecificationTypeSchema } from "../shared/schemas/underspecification.schema.js";
 export { UnderspecificationTypeSchema };
 export const QuestionOptionSchema = z.object({
     /** Display text. Suffix " (Recommended)" on the safest path; list it first. */
@@ -71,10 +69,11 @@ export const QuestionPurposeSchema = z.enum([
     "inflight_consultation",
 ]);
 /**
- * Producer-supplied candidate binding. The API re-resolves every field from
- * authoritative rows before generation; callers cannot mint provenance.
+ * Routing fields every negotiation-family binding carries. The provenance
+ * envelope extends this with freshness and ordinal fields; the candidate is
+ * exactly this shape.
  */
-export const NegotiationQuestionCandidateSchema = z.object({
+const negotiationQuestionBinding = {
     purpose: NegotiationQuestionPurposeSchema,
     recipientUserId: z.string().min(1),
     recipientIntentId: z.string().min(1),
@@ -85,7 +84,29 @@ export const NegotiationQuestionCandidateSchema = z.object({
     counterpartyUserId: z.string().min(1).optional(),
     counterpartyIntentId: z.string().min(1).optional(),
     counterpartyFelicityAuthority: z.number().min(0).max(100).optional(),
-}).superRefine((candidate, ctx) => {
+};
+/**
+ * Counterparty eligibility is carried by uptake bindings and ONLY by uptake
+ * bindings — exactly present on uptake, entirely absent otherwise. Identical on
+ * the candidate and the provenance envelope, so both delegate here.
+ */
+function refineCounterpartyEligibility(binding, ctx) {
+    const path = ["counterpartyUserId"];
+    if (binding.purpose === "uptake") {
+        if (!binding.counterpartyUserId || !binding.counterpartyIntentId || binding.counterpartyFelicityAuthority === undefined) {
+            ctx.addIssue({ code: z.ZodIssueCode.custom, path, message: "uptake bindings require exact counterparty eligibility" });
+        }
+        return;
+    }
+    if (binding.counterpartyUserId || binding.counterpartyIntentId || binding.counterpartyFelicityAuthority !== undefined) {
+        ctx.addIssue({ code: z.ZodIssueCode.custom, path, message: "only uptake bindings carry counterparty eligibility" });
+    }
+}
+/**
+ * Producer-supplied candidate binding. The API re-resolves every field from
+ * authoritative rows before generation; callers cannot mint provenance.
+ */
+export const NegotiationQuestionCandidateSchema = z.object(negotiationQuestionBinding).superRefine((candidate, ctx) => {
     const taskRequired = candidate.purpose !== "uptake";
     if (taskRequired !== Boolean(candidate.taskId)) {
         ctx.addIssue({
@@ -96,13 +117,7 @@ export const NegotiationQuestionCandidateSchema = z.object({
                 : "uptake questions must not carry a synthetic taskId",
         });
     }
-    const hasCounterparty = Boolean(candidate.counterpartyUserId) || Boolean(candidate.counterpartyIntentId);
-    if (candidate.purpose === "uptake" && (!candidate.counterpartyUserId || !candidate.counterpartyIntentId || candidate.counterpartyFelicityAuthority === undefined)) {
-        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["counterpartyUserId"], message: "uptake questions require exact counterparty provenance" });
-    }
-    if (candidate.purpose !== "uptake" && (hasCounterparty || candidate.counterpartyFelicityAuthority !== undefined)) {
-        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["counterpartyUserId"], message: "only uptake questions carry counterparty provenance" });
-    }
+    refineCounterpartyEligibility(candidate, ctx);
 });
 /**
  * Durable server-only routing and freshness envelope for negotiation-family
@@ -110,21 +125,12 @@ export const NegotiationQuestionCandidateSchema = z.object({
  */
 export const NegotiationQuestionProvenanceSchema = z.object({
     version: z.literal(1),
-    purpose: NegotiationQuestionPurposeSchema,
-    recipientUserId: z.string().min(1),
-    recipientIntentId: z.string().min(1),
-    opportunityId: z.string().min(1),
-    taskId: z.string().min(1).optional(),
-    networkId: z.string().min(1),
+    ...negotiationQuestionBinding,
     intentFingerprint: z.string().min(1),
     opportunityStatus: z.enum(["latent", "draft", "negotiating", "pending", "stalled", "accepted", "rejected", "expired"]),
     opportunityUpdatedAt: z.string().datetime(),
     taskState: z.enum(["submitted", "working", "input_required", "completed", "canceled", "failed", "rejected", "auth_required", "waiting_for_agent", "claimed"]).optional(),
     taskUpdatedAt: z.string().datetime().optional(),
-    /** Uptake only: exact low-authority counterparty eligibility binding. */
-    counterpartyUserId: z.string().min(1).optional(),
-    counterpartyIntentId: z.string().min(1).optional(),
-    counterpartyFelicityAuthority: z.number().min(0).max(100).optional(),
     /** Stable per-generation position so retries dedupe without reducing cardinality. */
     questionOrdinal: z.number().int().min(0).max(2),
 }).superRefine((provenance, ctx) => {
@@ -149,13 +155,7 @@ export const NegotiationQuestionProvenanceSchema = z.object({
     if (provenance.purpose === "inflight_consultation" && provenance.taskState !== "input_required") {
         ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["taskState"], message: "inflight task must be input_required" });
     }
-    const hasCounterparty = Boolean(provenance.counterpartyUserId) || Boolean(provenance.counterpartyIntentId);
-    if (provenance.purpose === "uptake" && (!provenance.counterpartyUserId || !provenance.counterpartyIntentId || provenance.counterpartyFelicityAuthority === undefined)) {
-        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["counterpartyUserId"], message: "uptake provenance requires exact counterparty eligibility" });
-    }
-    if (provenance.purpose !== "uptake" && (hasCounterparty || provenance.counterpartyFelicityAuthority !== undefined)) {
-        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["counterpartyUserId"], message: "only uptake provenance carries counterparty eligibility" });
-    }
+    refineCounterpartyEligibility(provenance, ctx);
 });
 export const QuestionModeSchema = z.enum([
     "intent",

package/dist/questions/{application/question.tools.d.ts → question.tools.d.ts}

@@ -1,5 +1,5 @@
-import type { DefineTool } from "../../shared/agent/tool.helpers.js";
-import type { QuestionerToolDeps } from "../ports/question.tools.port.js";
+import type { DefineTool } from "../shared/agent/tool.helpers.js";
+import type { QuestionerToolDeps } from "./question.tools.port.js";
 /**
  * Creates MCP tool definitions for the questioner domain.
  *

package/dist/questions/{application/question.tools.js → question.tools.js}

@@ -1,5 +1,5 @@
 /**
- * questions/application/question.tools — foreground adapter: MCP question tools.
+ * questions/question.tools — foreground adapter: MCP question tools.
  *
  * Creates MCP tool definitions for the questions domain. Exposes
  * `read_pending_questions` and `answer_pending_question` for retrieving and
@@ -9,14 +9,11 @@
  * Foreground adapter: these tools respond to authenticated user actions
  * (read, answer, dismiss). Ambient delivery adapters are handled separately
  * via the QuestionerQueue.
- *
- * IND-547: canonical home — previously questioner/questioner.tools.ts.
- * Legacy path is a thin compatibility shim pointing here.
  */
 import { z } from "zod";
-import { error, success } from "../../shared/agent/tool.helpers.js";
-import { focusedIntentId, focusedNetworkId, focusedNetworkLabel } from "../../shared/agent/tool.scope.js";
-import { callerMayAccessQuestionMode } from "../../shared/agent/activity-projection.js";
+import { error, success } from "../shared/agent/tool.helpers.js";
+import { focusedIntentId, focusedNetworkId, focusedNetworkLabel } from "../shared/agent/tool.scope.js";
+import { callerMayAccessQuestionMode } from "../shared/agent/activity-projection.js";
 /**
  * Detection modes whose questions derive solely from the caller's own data
  * (profile gaps, own intents, own discovery sessions). Negotiation-mode

package/dist/questions/{ports/question.tools.port.d.ts → question.tools.port.d.ts}

@@ -1,13 +1,11 @@
 /**
- * questions/ports/question.tools.port — host capabilities injected into question tools.
+ * questions/question.tools.port — host capabilities injected into question tools.
  *
  * Declares the narrow port types consumed by the foreground adapter tools
  * (question delivery and chat-inline ask_user_question) without importing
  * the full ToolRegistryCompositionDeps interface.
- *
- * IND-547: canonical tool-host port.
  */
-import type { ToolRegistryCompositionDeps } from "../../shared/agent/tool.helpers.js";
+import type { ToolRegistryCompositionDeps } from "../shared/agent/tool.helpers.js";
 /** Host capabilities consumed by asynchronous question delivery tools. */
 export type QuestionerToolDeps = Pick<ToolRegistryCompositionDeps, "answerPendingQuestion" | "findPendingQuestions" | "reportToolError">;
 /** Host capabilities consumed by the blocking, chat-only question tool. */

package/dist/shared/agent/tool.factory.js

@@ -50,7 +50,6 @@ export async function createChatTools(deps, preResolvedContext) {
             userId: deps.userId,
             networkId: explicitScope.scopeType === 'network' ? explicitScope.scopeId : deps.networkId,
             sessionId: deps.sessionId,
-            actionToolsEnabled: deps.actionToolsEnabled,
         }));
     if (!preResolvedContext && explicitScope.scopeType && explicitScope.scopeId) {
         resolvedContext.scopeType = explicitScope.scopeType;

package/dist/shared/agent/tool.helpers.d.ts

@@ -20,11 +20,11 @@ import type { AgentDatabase } from "../../agents/ports/index.js";
 import type { NegotiationTimeoutQueue } from "../interfaces/negotiation-events.interface.js";
 import type { AgentDispatcher } from "../interfaces/agent-dispatcher.interface.js";
 import type { DeliveryLedger } from "../interfaces/delivery-ledger.interface.js";
-import type { ChatQuestionsHost, QuestionerDatabase } from "../../questions/ports/index.js";
+import type { ChatQuestionsHost, QuestionerDatabase } from "../../questions/question.persistence.port.js";
 import type { NegotiatorMemoryToolsHost } from "../interfaces/negotiator-memory.interface.js";
-import type { QuestionerEnqueueFn } from "../../questions/application/question.input.js";
+import type { QuestionerEnqueueFn } from "../../questions/question.input.js";
 import type { PendingQuestionSummary } from "../schemas/pending-question.schema.js";
-import type { QuestionMode, QuestionPurpose } from "../../questions/domain/question.schema.js";
+import type { QuestionMode, QuestionPurpose } from "../../questions/question.schema.js";
 import type { EnrichmentRunQueue, EnrichmentRunStore } from "../interfaces/enrichment-run.interface.js";
 import type { McpActivityCaller } from "./activity-projection.js";
 export type IdentityContext = UserIdentity | null;
@@ -98,8 +98,6 @@ export interface ResolvedToolContext {
      * which are owner-trusted and receive the full owner view.
      */
     mcpCaller?: McpActivityCaller;
-    /** True only when the gated reporter cleanup-action proposal tool is registered. */
-    actionToolsEnabled?: boolean;
 }
 /**
  * Dependencies passed when creating tools for a user session.
@@ -137,8 +135,6 @@ interface ToolContextBindings {
     intentQueue: IntentGraphQueue;
     /** Contact management operations. */
     contactService: ContactServiceAdapter;
-    /** True only when the gated reporter cleanup-action proposal tool is registered. */
-    actionToolsEnabled?: boolean;
     /** Chat session reader for loading conversation history. */
     chatSession: ChatSessionReader;
     /** Read-through chat-session digest. Optional; consumers fall back to undefined `chatContext`. */
@@ -184,8 +180,6 @@ interface ToolContextBindings {
      * the backend composition root; when absent the tool is not registered.
      */
     chatQuestions?: ChatQuestionsHost;
-    /** Optional durable persistence for reporter cleanup-action proposals. */
-    actionProposalStore?: import('../../chat/reporter.action.contracts.js').AgentActionProposalStore;
     /** Durable host persistence for verified intent proposals shown in chat. */
     intentProposalStore?: import('../../intents/intent.proposal.js').IntentProposalStore;
     /**
@@ -292,8 +286,6 @@ export declare function resolveChatContext(params: {
     networkId?: string;
     /** Chat session ID for draft opportunities (stored as context.conversationId). */
     sessionId?: string;
-    /** Reporter action gate forwarded into the persona prompt/context. */
-    actionToolsEnabled?: boolean;
 }): Promise<ResolvedToolContext>;
 /**
  * Type for the `defineTool` closure created in `createChatTools`.

package/dist/shared/agent/tool.helpers.js

@@ -16,7 +16,7 @@ export class ChatContextAccessError extends Error {
  * This preloads user identity, profile, network memberships, and scoped index role.
  */
 export async function resolveChatContext(params) {
-    const { database, userId, networkId, sessionId, actionToolsEnabled } = params;
+    const { database, userId, networkId, sessionId } = params;
     const [user, rawProfile, userNetworks, globalContext] = await Promise.all([
         database.getUser(userId),
         database.getProfile(userId),
@@ -93,7 +93,6 @@ export async function resolveChatContext(params) {
         scopedMembershipRole,
         isOnboarding: !(user.onboarding?.completedAt),
         hasName,
-        actionToolsEnabled,
         ...(sessionId !== undefined ? { sessionId } : {}),
     };
 }

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

@@ -3,7 +3,7 @@
  * in tool results. Omits internal fields (actors, answer, status) that
  * are not needed by the chat agent or MCP client.
  */
-import type { QuestionMode, QuestionPurpose } from "../../questions/domain/question.schema.js";
+import type { QuestionMode, QuestionPurpose } from "../../questions/question.schema.js";
 export interface PendingQuestionSummary {
     id: string;
     title: string;

package/dist/shared/schemas/underspecification.schema.d.ts

@@ -5,7 +5,7 @@ import { z } from "zod";
  * Shared between signals (the intent clarifier decides whether an utterance is
  * underspecified) and questions (which records the category on the question it
  * raises). It lives here rather than inside either capability because both need
- * it: filing it under `questions/domain` meant the signals clarifier had to
+ * it: filing it under `questions/` meant the signals clarifier had to
  * import the whole questions capability — LLM agents and tools included — to
  * reach a three-value enum.
  */

package/dist/shared/schemas/underspecification.schema.js

@@ -5,7 +5,7 @@ import { z } from "zod";
  * Shared between signals (the intent clarifier decides whether an utterance is
  * underspecified) and questions (which records the category on the question it
  * raises). It lives here rather than inside either capability because both need
- * it: filing it under `questions/domain` meant the signals clarifier had to
+ * it: filing it under `questions/` meant the signals clarifier had to
  * import the whole questions capability — LLM agents and tools included — to
  * reach a three-value enum.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "20.0.0-rc.484.1",
+  "version": "21.0.0-rc.486.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/dist/chat/reporter.action.contracts.d.ts

@@ -1,36 +0,0 @@
-export type AgentCleanupActionType = "retract_premise" | "narrow_signal" | "pause_signal";
-export interface AgentActionProposalSnapshot {
-    status: string;
-    updatedAt?: string;
-    payload?: string;
-    summary?: string | null;
-    assertionText?: string;
-}
-interface AgentActionProposalActionBase {
-    entityId: string;
-    currentState: string;
-    proposedOperation: string;
-    evidence?: string;
-    skipped?: boolean;
-    reason?: string;
-    snapshot?: AgentActionProposalSnapshot;
-    description?: string;
-}
-export type AgentActionProposalAction = (AgentActionProposalActionBase & {
-    type: "retract_premise";
-}) | (AgentActionProposalActionBase & {
-    type: "narrow_signal";
-}) | (AgentActionProposalActionBase & {
-    type: "pause_signal";
-});
-export interface AgentActionProposal {
-    proposalId: string;
-    userId: string;
-    conversationId?: string;
-    actions: AgentActionProposalAction[];
-}
-/** Host persistence bridge for proposals; the reporter tool never mutates domain rows. */
-export interface AgentActionProposalStore {
-    createProposal(proposal: AgentActionProposal): Promise<void>;
-}
-export {};

package/dist/chat/reporter.action.contracts.js

@@ -1 +0,0 @@
-export {};

package/dist/chat/reporter.action.tools.d.ts

@@ -1,17 +0,0 @@
-import type { ChatGraphCompositeDatabase, UserDatabase } from "../shared/interfaces/database.interface.js";
-import type { ChatTools, ResolvedToolContext, ToolContext } from "../shared/agent/tool.factory.js";
-import type { AgentActionProposalStore } from "./reporter.action.contracts.js";
-export type { AgentActionProposal, AgentActionProposalAction, AgentActionProposalSnapshot, AgentActionProposalStore, AgentCleanupActionType, } from "./reporter.action.contracts.js";
-export declare const AGENT_ACTION_PROPOSAL_FENCE = "agent_action_proposal";
-/**
- * Creates the reporter-only proposal tool. It validates owner state and records
- * snapshots, but intentionally has no mutation dependency.
- */
-export declare function createProposeCleanupActionsTool(input: {
-    database: ChatGraphCompositeDatabase;
-    userDb: UserDatabase;
-    context: ResolvedToolContext;
-    store: AgentActionProposalStore;
-}): ChatTools[number];
-/** Build the optional action tool from the host-provided ToolContext. */
-export declare function createReporterActionTool(deps: ToolContext, context: ResolvedToolContext, userDb: UserDatabase): ChatTools[number] | null;