@indexnetwork/protocol 6.12.1-rc.404.1 → 6.14.0-rc.406.1

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

@@ -1,422 +1,5 @@
 /**
- * Question — public structured shape consumed by frontend renderers and MCP
- * elicitation dispatch. Mirrors the brainstorming AskUserQuestion skill so a
- * Question can be rendered identically across surfaces.
- *
- * `QuestionWithStrategy` extends the public shape with internal `strategy`
- * and QUD underspecification tags used by generator guardrails and persisted
- * metadata. Both tags are stripped before the public payload leaves the
- * generator — users never see them.
+ * @deprecated Canonical location: questions/domain/question.schema — retained
+ * for backward compatibility (IND-547).
  */
-import { z } from "zod";
-export const QuestionOptionSchema = z.object({
-    /** Display text. Suffix " (Recommended)" on the safest path; list it first. */
-    label: z.string().min(1).max(120),
-    /** Explains the consequence of choosing this option, not just its definition. */
-    description: z.string().min(1).max(280),
-});
-export const QuestionSchema = z.object({
-    /** ≤12 chars. Noun of the decision domain — e.g. "Stage", "Timing", "Role". */
-    title: z.string().min(1).max(12),
-    /** ≤2 sentences, ≤400 chars. Ends in a question mark. */
-    prompt: z.string().min(1).max(400),
-    /** 2–4 options. No explicit "Other" — clients provide that automatically. */
-    options: z.array(QuestionOptionSchema).min(2).max(4),
-    /** True when options are not mutually exclusive (priorities, bundles). */
-    multiSelect: z.boolean(),
-    /**
-     * 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.string().min(1).max(160).nullable().optional().transform((value) => value ?? undefined),
-});
-/** Canonical QUD repair categories for underspecified intents/questions. */
-export const UnderspecificationTypeSchema = z.enum([
-    "missing_constituent",
-    "missing_constraint",
-    "open_alternative_set",
-]);
-export const QuestionStrategySchema = z.enum([
-    "refine_intent",
-    "surface_missing_detail",
-    "open_adjacent_thread",
-    "reflective_summary",
-    "surface_emergent_knowledge",
-]);
-export const QuestionWithStrategySchema = QuestionSchema.extend({
-    strategy: QuestionStrategySchema,
-    /** QUD repair category, or null when the question is not an underspecification repair. */
-    underspecificationType: UnderspecificationTypeSchema.nullable(),
-});
-export const QuestionGeneratorResponseSchema = z.object({
-    questions: z.array(QuestionWithStrategySchema).max(3),
-});
-// ─── Persistence types (opportunity-style composable jsonb) ──────────────────
-/** Internal reason a question was generated, orthogonal to mode and QUD metadata. */
-export const NegotiationQuestionPurposeSchema = z.enum([
-    "uptake",
-    "stalled_followup",
-    "inflight_consultation",
-]);
-export const QuestionPurposeSchema = z.enum([
-    "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 const NegotiationQuestionCandidateSchema = z.object({
-    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),
-    /** 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(),
-}).superRefine((candidate, ctx) => {
-    const taskRequired = candidate.purpose !== "uptake";
-    if (taskRequired !== Boolean(candidate.taskId)) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            path: ["taskId"],
-            message: taskRequired
-                ? "task-backed negotiation questions require taskId"
-                : "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" });
-    }
-});
-/**
- * Durable server-only routing and freshness envelope for negotiation-family
- * questions. This object is stripped from every REST/MCP projection.
- */
-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),
-    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) => {
-    const taskRequired = provenance.purpose !== "uptake";
-    if (taskRequired && (!provenance.taskId || !provenance.taskState || !provenance.taskUpdatedAt)) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            path: ["taskId"],
-            message: "task-backed provenance requires task id, state, and updatedAt",
-        });
-    }
-    if (!taskRequired && (provenance.taskId || provenance.taskState || provenance.taskUpdatedAt)) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            path: ["taskId"],
-            message: "uptake provenance must not carry task fields",
-        });
-    }
-    if (provenance.purpose === "stalled_followup" && provenance.taskState !== "completed") {
-        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["taskState"], message: "follow-up task must be completed" });
-    }
-    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" });
-    }
-});
-export const QuestionModeSchema = z.enum([
-    "discovery",
-    "intent",
-    "enrichment",
-    "negotiation",
-    // Negotiator-initiated mid-negotiation client questions (ask_user action, P3).
-    // Distinct from "negotiation", which covers post-stall questions only.
-    "negotiation_inflight",
-    // Orchestrator-initiated mid-conversation questions (ask_user_question tool).
-    "chat",
-    // Pool-discriminator questions mined from the intent's candidate pool
-    // (IND-418). Synthesized deterministically — no generator LLM call.
-    "pool_discovery",
-]);
-/** One server-side candidate→side assignment (never serialized to clients). */
-export const QuestionPoolAssignmentSchema = z.object({
-    opportunityId: z.string().min(1),
-    side: z.string().min(1),
-});
-/**
- * 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 const QuestionPoolDiscriminatorSchema = z.object({
-    label: z.string().min(1),
-    questionSeed: z.string().min(1),
-    sides: z.array(z.string().min(1)).min(2).max(3),
-    /** Verified-assignment count per side label. */
-    sideCounts: z.record(z.string(), z.number()),
-    voi: z.number(),
-    evidenceRate: z.number(),
-    /** Discriminator embedding retained for durable semantic novelty checks. */
-    embedding: z.array(z.number().finite()).min(1).max(4096).optional(),
-    /** Model that generated `embedding`; mismatches must fall back to text. */
-    embeddingModel: z.string().min(1).optional(),
-    /** Verified assignments only — the P3 re-rank input. */
-    assignments: z.array(QuestionPoolAssignmentSchema),
-});
-/** Pool snapshot stored on pool_discovery questions (server-side only). */
-export const QuestionPoolSnapshotSchema = z.object({
-    poolSize: z.number().int().min(0),
-    /** ISO-8601 timestamp of the mining pass. */
-    minedAt: z.string().min(1),
-    /** Discovery run that produced the pool, when known. */
-    runId: z.string().optional(),
-    /** Intent payload snippet (≤160 chars) — reused by chained questions' evidence chips. */
-    intentText: z.string().optional(),
-    /** Stable hash of the full normalized payload + summary used for freshness. */
-    intentFingerprint: z.string().min(1).optional(),
-    /** Exact bounded candidate pool. Optional for legacy rows/jobs created before IND-422. */
-    opportunityIds: z.array(z.string().uuid()).optional(),
-    /** The discriminator this question asks about. */
-    discriminator: QuestionPoolDiscriminatorSchema,
-    /** Remaining ranked discriminators for interview-mode chaining. */
-    alternates: z.array(QuestionPoolDiscriminatorSchema),
-});
-/** Internal delivery ledger for proactive pool-question pushes (IND-421). */
-export const QuestionPoolPushSchema = z.object({
-    version: z.literal(1),
-    source: z.literal("pool_discovery"),
-    recipientId: z.string().min(1),
-    intentId: z.string().min(1),
-    cycleKey: z.string().min(1),
-    messageId: z.string().min(1),
-    surfaces: z.tuple([
-        z.literal("personal_agent_badge"),
-        z.literal("negotiator_dm"),
-    ]),
-    claimedAt: z.string().min(1),
-    deliveryStatus: z.enum(["claimed", "delivered", "suppressed", "failed"]),
-    conversationId: z.string().min(1).optional(),
-    deliveredAt: z.string().min(1).optional(),
-    suppressedAt: z.string().min(1).optional(),
-    failure: z.string().min(1).max(500).optional(),
-});
-/** Durable request state for proactive pool-question delivery. */
-export const QuestionPoolPushRequestStatusSchema = z.enum(["requested", "suppressed"]);
-/** Private snapshot for a post-discovery recovery refinement question. */
-export const QuestionRecoverySnapshotSchema = z.object({
-    version: z.literal(1),
-    intentFingerprint: z.string().regex(/^[a-f0-9]{64}$/),
-    completionSource: z.enum(["intent_creation", "from_intent", "discovery_run"]),
-    /** Privacy-safe aggregate only; raw negotiation evidence is never persisted. */
-    rejectedNegotiationCount: z.number().int().min(1).max(50).optional(),
-    /** Bounded internal correlation id for an asynchronous discovery run. */
-    runId: z.string().min(1).max(128).optional(),
-});
-/** Internal reason a pending question was voided. */
-export const QuestionVoidedReasonSchema = z.enum([
-    "pool_drift",
-    "intent_edit",
-    "recovery_drift",
-    "negotiation_stale",
-]);
-/** Permanent reasons that terminalize an unclaimed proactive push request. */
-export const QuestionPoolPushRequestReasonSchema = z.enum([
-    "question_lifecycle",
-    "intent_lifecycle",
-    "malformed_source",
-    "malformed_actor",
-    "malformed_pool",
-    "malformed_cycle",
-    "visited",
-    "pool_size",
-    "voi",
-    "cycle_budget",
-]);
-export const QuestionDetectionSchema = z.object({
-    /** Which preset mode generated this question. */
-    mode: QuestionModeSchema,
-    /** Internal reason for generation; independent of mode and QUD repair metadata. */
-    purpose: QuestionPurposeSchema.optional(),
-    /** Exact negotiation recipient/intent/task routing provenance. Internal only. */
-    negotiation: NegotiationQuestionProvenanceSchema.optional(),
-    /** Entity type that triggered generation (e.g. "opportunity", "intent", "profile"). */
-    sourceType: z.string().min(1),
-    /** ID of the triggering entity. */
-    sourceId: z.string().min(1),
-    /** Optional intent ID that was the root cause. */
-    triggeredBy: z.string().optional(),
-    /** ISO-8601 timestamp of generation. */
-    timestamp: z.string().min(1),
-    /** Generation strategy persisted as internal metadata. */
-    strategy: QuestionStrategySchema.optional(),
-    /** QUD repair category persisted as internal metadata. */
-    underspecificationType: UnderspecificationTypeSchema.nullable().optional(),
-    /** ID of the assistant message that triggered this question. Used by the frontend to anchor the question card inline. */
-    messageId: z.string().optional(),
-    /** Durable server-only conversation session binding used to validate messageId. */
-    sessionId: z.string().optional(),
-    /**
-     * pool_discovery only: the mined pool snapshot (assignments + alternates).
-     * INTERNAL — stripped from every client-facing read (web + MCP).
-     */
-    pool: QuestionPoolSnapshotSchema.optional(),
-    /** Post-discovery intent recovery snapshot. Internal only. */
-    recovery: QuestionRecoverySnapshotSchema.optional(),
-    /** Durable request marker written before enqueueing proactive delivery. Internal only. */
-    pushRequestedAt: z.string().min(1).optional(),
-    /** Last bounded recovery sweep that selected this request. Internal only. */
-    pushRecoveryAttemptedAt: z.string().min(1).optional(),
-    /** Durable request outcome. Internal only. */
-    pushRequestStatus: QuestionPoolPushRequestStatusSchema.optional(),
-    /** Permanent suppression reason for an unclaimed request. Internal only. */
-    pushRequestReason: QuestionPoolPushRequestReasonSchema.optional(),
-    /** ISO-8601 timestamp at which an unclaimed request was suppressed. Internal only. */
-    pushRequestSuppressedAt: z.string().min(1).optional(),
-    /** Internal proactive delivery state. Never serialize to public clients. */
-    push: QuestionPoolPushSchema.optional(),
-    /** Internal reason this question was voided after pool or intent drift. */
-    voidedReason: QuestionVoidedReasonSchema.optional(),
-    /** Authoritative successful-delivery ledger timestamp. Internal only. */
-    pushedAt: z.string().min(1).optional(),
-}).superRefine((detection, ctx) => {
-    const negotiationFamily = detection.mode === "negotiation" || detection.mode === "negotiation_inflight";
-    if (negotiationFamily !== Boolean(detection.negotiation)) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            path: ["negotiation"],
-            message: negotiationFamily
-                ? "negotiation-family detection requires exact provenance"
-                : "non-negotiation detection must not carry negotiation provenance",
-        });
-    }
-    if (detection.negotiation) {
-        if (detection.sourceType !== "opportunity" || detection.sourceId !== detection.negotiation.opportunityId) {
-            ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["sourceId"], message: "negotiation sourceId must equal opportunityId" });
-        }
-        if (detection.purpose !== detection.negotiation.purpose) {
-            ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["purpose"], message: "detection purpose must match negotiation provenance" });
-        }
-        if (detection.mode === "negotiation_inflight" && detection.negotiation.purpose !== "inflight_consultation") {
-            ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["negotiation", "purpose"], message: "inflight mode requires inflight purpose" });
-        }
-        if (detection.mode === "negotiation" && detection.negotiation.purpose === "inflight_consultation") {
-            ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["negotiation", "purpose"], message: "ordinary negotiation mode cannot carry inflight purpose" });
-        }
-    }
-    if (detection.mode === "pool_discovery"
-        && (!detection.triggeredBy?.trim() || detection.triggeredBy !== detection.sourceId)) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            path: ["triggeredBy"],
-            message: "pool_discovery triggeredBy must be non-empty and equal sourceId",
-        });
-    }
-    if (detection.purpose === "recovery") {
-        if (detection.mode !== "intent"
-            || detection.sourceType !== "intent"
-            || !detection.triggeredBy?.trim()
-            || detection.triggeredBy !== detection.sourceId
-            || !detection.recovery) {
-            ctx.addIssue({
-                code: z.ZodIssueCode.custom,
-                path: ["recovery"],
-                message: "recovery purpose requires intent mode/source, equal trigger provenance, and a recovery snapshot",
-            });
-        }
-    }
-    else if (detection.recovery) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            path: ["purpose"],
-            message: "recovery snapshot requires recovery purpose",
-        });
-    }
-    if (detection.pushRequestStatus && !detection.pushRequestedAt) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            path: ["pushRequestedAt"],
-            message: "push request state requires a request timestamp",
-        });
-    }
-    if (detection.pushRecoveryAttemptedAt && !detection.pushRequestedAt) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            path: ["pushRequestedAt"],
-            message: "push recovery attempts require a request timestamp",
-        });
-    }
-    if (detection.pushRequestStatus === "suppressed") {
-        if (!detection.pushRequestReason) {
-            ctx.addIssue({
-                code: z.ZodIssueCode.custom,
-                path: ["pushRequestReason"],
-                message: "suppressed push requests require a reason",
-            });
-        }
-        if (!detection.pushRequestSuppressedAt) {
-            ctx.addIssue({
-                code: z.ZodIssueCode.custom,
-                path: ["pushRequestSuppressedAt"],
-                message: "suppressed push requests require a timestamp",
-            });
-        }
-    }
-});
-export const QuestionActorSchema = z.object({
-    /** The user this question is for. */
-    userId: z.string().min(1),
-    /** Optional network context. */
-    networkId: z.string().optional(),
-    /** Actor's role in the question — currently always "subject". */
-    role: z.literal("subject"),
-});
-export const QuestionAnswerSchema = z.object({
-    /** Option labels the user selected. */
-    selectedOptions: z.array(z.string()),
-    /** Free-text input when the user chose "Other" or elaborated. */
-    freeText: z.string().optional(),
-    /** User ID of the answerer. */
-    answeredBy: z.string().min(1),
-    /** ISO-8601 timestamp of when the answer was submitted. */
-    answeredAt: z.string().min(1),
-});
-//# sourceMappingURL=question.schema.js.map
+export * from "../../questions/domain/question.schema.js";

package/dist/shared/ui/lucide.icon-catalog.d.ts

@@ -19,4 +19,3 @@ export declare function resolveHomeSectionIcon(name: string | undefined | null):
  * Return a formatted list of icon names for LLM prompts (comma-separated, truncated if needed).
  */
 export declare function getIconNamesForPrompt(maxItems?: number): string;
-//# sourceMappingURL=lucide.icon-catalog.d.ts.map

package/dist/shared/ui/lucide.icon-catalog.js

@@ -98,4 +98,3 @@ export function getIconNamesForPrompt(maxItems = 60) {
     const list = HOME_SECTION_ICON_NAMES.slice(0, maxItems);
     return list.join(', ');
 }
-//# sourceMappingURL=lucide.icon-catalog.js.map

package/dist/shared/utils/social-label.d.ts

@@ -22,4 +22,3 @@ export interface EnrichmentRequest {
  * @returns Flat enrichment request object (omits keys that have no value).
  */
 export declare function socialsToEnrichmentRequest(socials: UserSocial[]): EnrichmentRequest;
-//# sourceMappingURL=social-label.d.ts.map

package/dist/shared/utils/social-label.js

@@ -49,4 +49,3 @@ export function socialsToEnrichmentRequest(socials) {
     }
     return result;
 }
-//# sourceMappingURL=social-label.js.map

package/dist/shared/utils/telegram-handle.d.ts

@@ -5,4 +5,3 @@
  * Returns null if the result is not a valid Telegram handle (5-32 alphanumeric/underscore chars).
  */
 export declare function normalizeTelegramHandle(raw: string | null | undefined): string | null;
-//# sourceMappingURL=telegram-handle.d.ts.map

package/dist/shared/utils/telegram-handle.js

@@ -14,4 +14,3 @@ export function normalizeTelegramHandle(raw) {
         .split(/[/?#]/)[0];
     return stripped && /^[A-Za-z0-9_]{5,32}$/.test(stripped) ? stripped : null;
 }
-//# sourceMappingURL=telegram-handle.js.map

package/dist/signals/application/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * signals/application — signal lifecycle and graph orchestration seams.
+ *
+ * Houses the LangGraph factory, model-binding adapters (inferrer, clarifier,
+ * verifier, reconciler, indexer), and the tool-definition factory.
+ * Participant-facing runtime tool registration lives in the foreground shell
+ * (runtime/foreground/signals/intent.tools).
+ *
+ * Boundary: may import from signals/domain and signals/ports, plus
+ * only-when-needed LangGraph / model-binding seams inside this directory.
+ * Must not import host implementations.
+ */
+export { IntentGraphFactory, enforceIntentActionBoundary, buildExplicitUpdateActions } from "./intent.graph.js";
+export { ExplicitIntentInferrer, type InferredIntent, type InferrerOptions } from "./intent.inferrer.js";
+export { IntentClarifier } from "./intent.clarifier.js";
+export { SemanticVerifier, type SemanticVerifierOutput } from "./intent.verifier.js";
+export { IntentReconciler, type IntentReconcilerOutput, type NormalizedIntentAction } from "./intent.reconciler.js";
+export { IntentIndexer, IntentIndexerOutputSchema, type IntentIndexerOutput } from "./intent.indexer.js";
+export { createIntentTools, describeIntentUpdateFailure } from "./intent.tools.js";

package/dist/signals/application/index.js

@@ -0,0 +1,22 @@
+/**
+ * signals/application — signal lifecycle and graph orchestration seams.
+ *
+ * Houses the LangGraph factory, model-binding adapters (inferrer, clarifier,
+ * verifier, reconciler, indexer), and the tool-definition factory.
+ * Participant-facing runtime tool registration lives in the foreground shell
+ * (runtime/foreground/signals/intent.tools).
+ *
+ * Boundary: may import from signals/domain and signals/ports, plus
+ * only-when-needed LangGraph / model-binding seams inside this directory.
+ * Must not import host implementations.
+ */
+// ── Graph orchestration ───────────────────────────────────────────────────────
+export { IntentGraphFactory, enforceIntentActionBoundary, buildExplicitUpdateActions } from "./intent.graph.js";
+// ── Model-binding adapters ────────────────────────────────────────────────────
+export { ExplicitIntentInferrer } from "./intent.inferrer.js";
+export { IntentClarifier } from "./intent.clarifier.js";
+export { SemanticVerifier } from "./intent.verifier.js";
+export { IntentReconciler } from "./intent.reconciler.js";
+export { IntentIndexer, IntentIndexerOutputSchema } from "./intent.indexer.js";
+// ── Tool factory (signals layer) ──────────────────────────────────────────────
+export { createIntentTools, describeIntentUpdateFailure } from "./intent.tools.js";

package/dist/signals/application/intent.clarifier.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+declare const clarificationSchema: z.ZodDiscriminatedUnion<"needsClarification", [z.ZodObject<{
+    needsClarification: z.ZodLiteral<false>;
+    reason: z.ZodString;
+    suggestedDescription: z.ZodNullable<z.ZodString>;
+    clarificationMessage: z.ZodNullable<z.ZodString>;
+    underspecificationType: z.ZodNull;
+}, "strip", z.ZodTypeAny, {
+    reason: string;
+    underspecificationType: null;
+    needsClarification: false;
+    suggestedDescription: string | null;
+    clarificationMessage: string | null;
+}, {
+    reason: string;
+    underspecificationType: null;
+    needsClarification: false;
+    suggestedDescription: string | null;
+    clarificationMessage: string | null;
+}>, z.ZodObject<{
+    needsClarification: z.ZodLiteral<true>;
+    reason: z.ZodString;
+    suggestedDescription: z.ZodString;
+    clarificationMessage: z.ZodString;
+    underspecificationType: z.ZodEnum<["missing_constituent", "missing_constraint", "open_alternative_set"]>;
+}, "strip", z.ZodTypeAny, {
+    reason: string;
+    underspecificationType: "missing_constituent" | "missing_constraint" | "open_alternative_set";
+    needsClarification: true;
+    suggestedDescription: string;
+    clarificationMessage: string;
+}, {
+    reason: string;
+    underspecificationType: "missing_constituent" | "missing_constraint" | "open_alternative_set";
+    needsClarification: true;
+    suggestedDescription: string;
+    clarificationMessage: string;
+}>]>;
+export type IntentClarifierOutput = z.infer<typeof clarificationSchema>;
+export declare class IntentClarifier {
+    private readonly model;
+    private readonly suggestionModel;
+    private readonly clarificationDraftModel;
+    constructor();
+    /** Build the shared user prompt with intent, profile, and active-intent context. */
+    private buildPrompt;
+    invoke(description: string, profileContext: string, activeIntentsContext: string): Promise<IntentClarifierOutput>;
+    private generateSuggestion;
+    private generateClarificationDraft;
+}
+export {};