@indexnetwork/protocol 6.14.0-rc.406.1 → 6.15.0-rc.407.1

package/CHANGELOG.md

@@ -12,6 +12,11 @@ See [STABILITY.md](./STABILITY.md) for the public-contract and tier definitions.
 
 ## [Unreleased]
 
+### Added
+- Add the injected `IntentProposalStore` host boundary so web proposal cards are
+  emitted only after the normalized description, optional network scope, and
+  complete verifier output have been durably bound to their owner.
+
 ## [6.14.0] — 2026-07-25
 
 ### Added

package/dist/capabilities/signals.tools.port.d.ts

@@ -1,5 +1,5 @@
 import type { ToolRegistryCompositionDeps } from "../shared/agent/tool.helpers.js";
 /** Host capabilities consumed by signal and intent tools. */
-export type IntentToolDeps = Pick<ToolRegistryCompositionDeps, "userDb" | "systemDb"> & {
+export type IntentToolDeps = Pick<ToolRegistryCompositionDeps, "userDb" | "systemDb"> & Pick<ToolRegistryCompositionDeps, "intentProposalStore"> & {
     graphs: Pick<ToolRegistryCompositionDeps["graphs"], "intent" | "intentIndex" | "profile">;
 };

package/dist/runtime/foreground/composition/tool.factory.js

@@ -172,6 +172,7 @@ export async function createChatTools(deps, preResolvedContext) {
         ...(deps.chatQuestions && { chatQuestions: deps.chatQuestions }),
         ...(deps.chatSession && { chatSession: deps.chatSession }),
         ...(deps.getUserContextText && { getUserContextText: deps.getUserContextText }),
+        ...(deps.intentProposalStore && { intentProposalStore: deps.intentProposalStore }),
         graphs: {
             profile: profileGraph,
             intent: intentGraph,

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

@@ -207,6 +207,8 @@ interface ToolContextBindings {
     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('../../signals/domain/intent.proposal.js').IntentProposalStore;
     /**
      * Host bridge for the negotiator persona's `remember`/`forget` memory
      * tools (P5.4). Injected by the composition root only when negotiator
@@ -384,6 +386,8 @@ interface ToolDepsBindings {
     userDb: UserDatabase;
     /** Context-bound database for LLM/system operations on cross-user resources within shared networks. */
     systemDb: SystemDatabase;
+    /** Durable host persistence for verified intent proposals shown in chat. */
+    intentProposalStore?: import('../../signals/domain/intent.proposal.js').IntentProposalStore;
     scraper: Scraper;
     embedder: import('../interfaces/embedder.interface.js').Embedder;
     cache: Cache;

package/dist/signals/application/intent.graph.js

@@ -3,6 +3,7 @@ import { IntentGraphState } from "../domain/intent.state.js";
 import { ExplicitIntentInferrer } from "./intent.inferrer.js";
 import { SemanticVerifier } from "./intent.verifier.js";
 import { DEFAULT_SPECIFICITY_WARNING } from "../domain/signal.specificity.js";
+import { normalizeIntentDescription } from "../domain/intent.proposal.js";
 import { IntentReconciler } from "./intent.reconciler.js";
 import { getAbortSignalConfig } from "../../shared/agent/model-signal.js";
 import { protocolLogger } from "../../shared/observability/protocol.logger.js";
@@ -497,18 +498,6 @@ export class IntentGraphFactory {
                 };
             });
         };
-        /** Strip URLs and "More details at [url]" from intent payloads before persisting. */
-        const sanitizePayload = (payload) => {
-            if (!payload || typeof payload !== "string")
-                return payload;
-            const out = payload
-                .replace(/\s*More details at\s*:?\s*https?:\/\/[^\s"'<>)\]]+/gi, "")
-                .replace(/\s*See\s+https?:\/\/[^\s"'<>)\]]+\s+for\s+more[^.]*\.?/gi, "")
-                .replace(/https?:\/\/[^\s"'<>)\]]+/g, "")
-                .replace(/\s{2,}/g, " ")
-                .trim();
-            return out.replace(/[.,;]\s*$/, "").trim() || payload;
-        };
         /**
          * Generate a flat embedding for an intent payload, swallowing failures so
          * persistence can continue without an embedding. `intentId` is logging-only
@@ -554,14 +543,14 @@ export class IntentGraphFactory {
                 const verifiedIntentByPayload = new Map();
                 for (const verifiedIntent of state.verifiedIntents) {
                     verifiedIntentByPayload.set(verifiedIntent.description, verifiedIntent);
-                    verifiedIntentByPayload.set(sanitizePayload(verifiedIntent.description), verifiedIntent);
+                    verifiedIntentByPayload.set(normalizeIntentDescription(verifiedIntent.description), verifiedIntent);
                 }
                 for (const action of actions) {
                     const actionType = action.type.toLowerCase();
                     try {
                         if (actionType === 'create') {
                             const createAction = action;
-                            const sanitizedPayload = sanitizePayload(createAction.payload);
+                            const sanitizedPayload = normalizeIntentDescription(createAction.payload);
                             const matchedVerifiedIntent = verifiedIntentByPayload.get(createAction.payload) ||
                                 verifiedIntentByPayload.get(sanitizedPayload);
                             // Generate embedding for the intent payload
@@ -610,7 +599,7 @@ export class IntentGraphFactory {
                         }
                         else if (actionType === 'update') {
                             const updateAction = action;
-                            const sanitizedPayload = sanitizePayload(updateAction.payload);
+                            const sanitizedPayload = normalizeIntentDescription(updateAction.payload);
                             const matchedVerifiedIntent = verifiedIntentByPayload.get(updateAction.payload) ||
                                 verifiedIntentByPayload.get(sanitizedPayload);
                             // Regenerate embedding for the updated payload

package/dist/signals/application/intent.tools.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { IntentClarifier } from "./intent.clarifier.js";
 import { DEFAULT_SPECIFICITY_WARNING } from "../domain/signal.specificity.js";
+import { normalizeIntentDescription } from "../domain/intent.proposal.js";
 import { protocolLogger } from "../../shared/observability/protocol.logger.js";
 import { traceGraph } from "../../shared/observability/trace.js";
 import { success, error, UUID_REGEX } from "../../shared/agent/tool.helpers.js";
@@ -265,7 +266,7 @@ export function createIntentTools(defineTool, deps) {
             "**What to pass:** A clear, concept-based description of what the user is looking for (e.g. 'Looking for an AI/ML co-founder in Berlin', " +
             "'Need a designer for a mobile app project'). If the user provided a URL, scrape it with scrape_url first and synthesize the content into a description.\n\n" +
             "**What happens:** The system runs inference (extracting structured intents), verification (checking specificity and speech-act type), " +
-            "and returns a proposal widget. The proposal is NOT yet persisted — the user must approve it first.\n\n" +
+            "and durably stores an owner-scoped proposal containing the exact normalized description, optional network scope, and complete verifier output before returning a proposal widget. The intent itself is NOT yet persisted — the user must approve the proposal first.\n\n" +
             "**Returns:** An intent_proposal code block that MUST be included verbatim in the response. The frontend renders it as an interactive " +
             "card the user can approve or skip. On approval, the intent is persisted, indexed, and discovery begins.\n\n" +
             "**Next steps after approval:** The intent is automatically linked to relevant indexes. Call discover_opportunities(searchQuery) to explicitly trigger discovery, " +
@@ -419,13 +420,32 @@ export function createIntentTools(defineTool, deps) {
                 });
             }
             // ── Proposal path (for web chat with interactive cards) ──
-            // Build intent_proposal code fences for each verified intent
-            const proposalBlocks = verified.map((v) => {
+            // Persist complete verifier output before emitting any usable card.
+            if (!deps.intentProposalStore) {
+                return error("Verified intent proposals are unavailable because durable proposal storage is not configured.");
+            }
+            const proposals = [];
+            const proposalBlocks = [];
+            for (const v of verified) {
+                if (!v.verification) {
+                    return error("Intent verification produced no authoritative analysis; no proposal was created.", debugSteps);
+                }
                 const proposalId = crypto.randomUUID();
+                const normalizedDescription = normalizeIntentDescription(v.description);
                 const isBroad = isBroadAttributiveIntent(v);
+                proposals.push({
+                    proposalId,
+                    userId: context.userId,
+                    description: normalizedDescription,
+                    ...(effectiveIndexId ? { networkId: effectiveIndexId } : {}),
+                    analysis: {
+                        verifierOutput: v.verification,
+                        combinedScore: v.score ?? null,
+                    },
+                });
                 const data = {
                     proposalId,
-                    description: v.description,
+                    description: normalizedDescription,
                     ...(effectiveIndexId ? { networkId: effectiveIndexId } : {}),
                     confidence: v.score != null ? Math.round(v.score * 100) / 100 : null,
                     speechActType: v.verification?.classification ?? null,
@@ -434,10 +454,11 @@ export function createIntentTools(defineTool, deps) {
                     missingSelectionalConstraints: v.verification?.missing_selectional_constraints ?? [],
                     specificityWarning: isBroad ? specificityWarningFor(v) : normalizeSpecificityWarning(v.verification?.specificity_warning),
                 };
-                return ("```intent_proposal\n" +
+                proposalBlocks.push("```intent_proposal\n" +
                     sanitizeJsonForCodeFence(JSON.stringify(data)) +
                     "\n```");
-            });
+            }
+            await deps.intentProposalStore.createProposals(proposals);
             const blocksText = proposalBlocks.join("\n\n");
             return success({
                 proposed: true,

package/dist/signals/domain/intent.proposal.d.ts

@@ -0,0 +1,35 @@
+/** Verifier output retained verbatim across the host persistence boundary. */
+export interface IntentProposalVerifierOutput {
+    reasoning: string;
+    classification: "COMMISSIVE" | "DIRECTIVE" | "ASSERTIVE" | "EXPRESSIVE" | "DECLARATION" | "UNKNOWN";
+    felicity_scores: {
+        clarity: number;
+        authority: number;
+        sincerity: number;
+    };
+    semantic_entropy: number;
+    referential_anchor: string | null;
+    referential_breadth: "narrow" | "moderate" | "broad";
+    missing_selectional_constraints: Array<"role" | "outcome" | "location" | "timeframe" | "domain" | "concrete_need">;
+    specificity_warning: string | null;
+    flags: string[];
+}
+/** Complete server-authoritative analysis captured for a verified intent proposal. */
+export interface IntentProposalAnalysis {
+    verifierOutput: IntentProposalVerifierOutput;
+    combinedScore: number | null;
+}
+/** One proposal persisted by the host before its display card is emitted. */
+export interface PersistableIntentProposal {
+    proposalId: string;
+    userId: string;
+    description: string;
+    networkId?: string;
+    analysis: IntentProposalAnalysis;
+}
+/** Host persistence boundary for durable, owner-scoped intent proposals. */
+export interface IntentProposalStore {
+    createProposals(proposals: PersistableIntentProposal[]): Promise<void>;
+}
+/** Normalize intent text exactly as the direct graph write path does. */
+export declare function normalizeIntentDescription(description: string): string;

package/dist/signals/domain/intent.proposal.js

@@ -0,0 +1,12 @@
+/** Normalize intent text exactly as the direct graph write path does. */
+export function normalizeIntentDescription(description) {
+    if (!description || typeof description !== "string")
+        return description;
+    const normalized = description
+        .replace(/\s*More details at\s*:?\s*https?:\/\/[^\s"'<>)\]]+/gi, "")
+        .replace(/\s*See\s+https?:\/\/[^\s"'<>)\]]+\s+for\s+more[^.]*\.?/gi, "")
+        .replace(/https?:\/\/[^\s"'<>)\]]+/g, "")
+        .replace(/\s{2,}/g, " ")
+        .trim();
+    return normalized.replace(/[.,;]\s*$/, "").trim() || description;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "6.14.0-rc.406.1",
+  "version": "6.15.0-rc.407.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",