@indexnetwork/protocol 21.1.0-rc.493.1 → 22.0.0-rc.495.1

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

@@ -20,11 +20,8 @@ import type { AgentDatabase } from "../../agents/agent.repository.port.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/question.persistence.port.js";
 import type { NegotiatorMemoryToolsHost } from "../interfaces/negotiator-memory.interface.js";
 import type { QuestionerEnqueueFn } from "../../questions/question.input.js";
-import type { PendingQuestionSummary } from "../schemas/pending-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;
@@ -147,39 +144,8 @@ interface ToolContextBindings {
      * Injected by the composition root when QUESTIONER_ENABLED=true.
      */
     questionerEnqueue?: QuestionerEnqueueFn;
-    /**
-     * Lookup pending questions for a user, optionally filtered by source,
-     * detection mode, selected intent scope, or capped by count.
-     */
-    findPendingQuestions?: (userId: string, filters?: {
-        sourceType?: string;
-        sourceId?: string;
-        scopeType?: 'intent';
-        scopeId?: string;
-        networkId?: string;
-        modes?: QuestionMode[];
-        purpose?: QuestionPurpose;
-        limit?: number;
-    }) => Promise<PendingQuestionSummary[]>;
-    /**
-     * Record the client's explicit answer to a pending question through the
-     * host's question-answer pipeline (atomic pending→answered flip + answered
-     * events). Returns false when the question is not pending for this user
-     * (already answered/dismissed, expired, or not theirs). Injected by the
-     * composition root — absent when question delivery is disabled.
-     */
-    answerPendingQuestion?: (userId: string, questionId: string, answer: {
-        selectedOptions: string[];
-        freeText?: string;
-    }) => Promise<boolean>;
     /** Negotiation-digest summarizer. Optional; consumers fall back to deterministic digests. */
     negotiationSummary?: NegotiationSummaryReader;
-    /**
-     * Host bridge for the orchestrator's blocking `ask_user_question` tool
-     * (synchronous chat-question persist + in-stream answer wait). Injected by
-     * the backend composition root; when absent the tool is not registered.
-     */
-    chatQuestions?: ChatQuestionsHost;
     /** Durable host persistence for verified intent proposals shown in chat. */
     intentProposalStore?: import('../../intents/intent.proposal.js').IntentProposalStore;
     /**
@@ -228,8 +194,6 @@ interface ToolContextBindings {
     frontendUrl?: string;
     /** API base URL for building opportunity accept links (e.g. https://protocol.index.network, optional). */
     apiBaseUrl?: string;
-    /** Persistence for structured questions generated by the QuestionerAgent (optional). */
-    questionerDatabase?: QuestionerDatabase;
     /** Optional host-side error reporter for swallowed protocol/tool errors. */
     reportToolError?: (error: unknown, report: ToolErrorReport) => void;
     /**
@@ -366,45 +330,8 @@ interface ToolDepsBindings {
      * composition root when QUESTIONER_ENABLED=true.
      */
     questionerEnqueue?: QuestionerEnqueueFn;
-    /**
-     * Lookup pending questions for a user, optionally filtered by source,
-     * detection mode, or capped by count (hosts apply `limit` SQL-side).
-     * Used by tools to attach contextually relevant questions to their results.
-     * Injected by the composition root — absent when question delivery is disabled.
-     */
-    findPendingQuestions?: (userId: string, filters?: {
-        sourceType?: string;
-        sourceId?: string;
-        /** Optional selected-intent scope. When `scopeType === 'intent'`, `scopeId` is the selected intent id. */
-        scopeType?: 'intent';
-        scopeId?: string;
-        /** Restrict to questions whose actor carries this network id. */
-        networkId?: string;
-        /** Restrict to questions whose detection mode is in this set. */
-        modes?: QuestionMode[];
-        /** Restrict to an internal generation purpose. */
-        purpose?: QuestionPurpose;
-        /** Maximum rows to return; hosts should apply this in the query. */
-        limit?: number;
-    }) => Promise<PendingQuestionSummary[]>;
-    /**
-     * Record the client's explicit answer to a pending question through the
-     * host's question-answer pipeline (atomic pending→answered flip + answered
-     * events). Returns false when the question is not pending for this user.
-     * Injected by the composition root — absent when question delivery is disabled.
-     */
-    answerPendingQuestion?: (userId: string, questionId: string, answer: {
-        selectedOptions: string[];
-        freeText?: string;
-    }) => Promise<boolean>;
     /** Negotiation-digest summarizer. Optional; consumers fall back to deterministic digests. */
     negotiationSummary?: NegotiationSummaryReader;
-    /**
-     * Host bridge for the orchestrator's blocking `ask_user_question` tool
-     * (synchronous chat-question persist + in-stream answer wait). Injected by
-     * the backend composition root; when absent the tool is not registered.
-     */
-    chatQuestions?: ChatQuestionsHost;
     /** Manages negotiation timeout jobs (optional — enables AI fallback on external agent timeout). */
     negotiationTimeoutQueue?: NegotiationTimeoutQueue;
     /** Agent registry database adapter (optional — absent when host does not support agents). */

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

@@ -9,7 +9,6 @@ import { createAgentTools } from '../../agents/agent.module.js';
 import { createNegotiationTools } from '../../negotiations/negotiation.module.js';
 import { createChatTools } from '../../chat/chat.tools.js';
 import { createPremiseTools } from '../../premises/premise.tools.js';
-import { createQuestionerTools } from '../../questions/question.module.js';
 import { protocolLogger } from '../observability/protocol.logger.js';
 import { requestContext } from '../observability/request-context.js';
 const logger = protocolLogger('ToolRegistry');
@@ -69,7 +68,6 @@ export function createToolRegistry(deps, options = {}) {
     createAgentTools(dt, deps);
     createNegotiationTools(dt, deps);
     createPremiseTools(dt, deps);
-    createQuestionerTools(dt, deps);
     if (deps.chatSession) {
         createChatTools(dt, deps);
     }

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

@@ -1,6 +1,6 @@
 import type { TraceEmitter } from "../observability/request-context.js";
 import type { RawToolDefinition, ResolvedToolContext } from "./tool.helpers.js";
-export type ToolTimeoutClass = "fast" | "bounded_slow" | "async_candidate" | "interactive";
+export type ToolTimeoutClass = "fast" | "bounded_slow" | "async_candidate";
 export type ToolRuntimeErrorCode = "TOOL_TIMEOUT" | "TOOL_CANCELLED" | "TOOL_OUTPUT_TOO_LARGE";
 export interface ToolTimeoutPolicy {
     class: ToolTimeoutClass;

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

@@ -3,11 +3,6 @@ import { requestContext } from "../observability/request-context.js";
 const FAST_TIMEOUT_MS = 10000;
 const BOUNDED_SLOW_TIMEOUT_MS = 45000;
 const ASYNC_CANDIDATE_TIMEOUT_MS = 50000;
-// Interactive tools deliberately block on human input (ask_user_question).
-// Must exceed the tool's own internal wait budget (QUESTIONER_CHAT_WAIT_TIMEOUT_MS,
-// default 4 min) so the tool returns a graceful timeout result instead of
-// being killed by the runtime.
-const INTERACTIVE_TIMEOUT_MS = 300000;
 const DEFAULT_MAX_OUTPUT_BYTES = 1000000;
 const FAST_TOOLS = new Set([
     "create_intent_index",
@@ -33,7 +28,6 @@ const FAST_TOOLS = new Set([
     "revoke_agent_permission",
     "retract_premise",
 ]);
-const INTERACTIVE_TOOLS = new Set(["ask_user_question"]);
 const ASYNC_CANDIDATE_TOOLS = new Set([
     "read_user_contexts",
     "preview_user_context",
@@ -64,19 +58,14 @@ function toolNameOutputEnv(toolName) {
 export function getToolTimeoutPolicy(toolName) {
     const classification = FAST_TOOLS.has(toolName)
         ? "fast"
-        : INTERACTIVE_TOOLS.has(toolName)
-            ? "interactive"
-            : ASYNC_CANDIDATE_TOOLS.has(toolName)
-                ? "async_candidate"
-                : "bounded_slow";
+        : ASYNC_CANDIDATE_TOOLS.has(toolName)
+            ? "async_candidate"
+            : "bounded_slow";
     let classDefault;
     switch (classification) {
         case "fast":
             classDefault = parsePositiveIntEnv("MCP_TOOL_TIMEOUT_FAST_MS", FAST_TIMEOUT_MS);
             break;
-        case "interactive":
-            classDefault = parsePositiveIntEnv("MCP_TOOL_TIMEOUT_INTERACTIVE_MS", INTERACTIVE_TIMEOUT_MS);
-            break;
         case "async_candidate":
             classDefault = parsePositiveIntEnv("MCP_TOOL_TIMEOUT_ASYNC_CANDIDATE_MS", ASYNC_CANDIDATE_TIMEOUT_MS);
             break;

package/dist/shared/observability/request-context.d.ts

@@ -9,11 +9,6 @@ export type TraceEmitter = (event: {
     name: string;
     durationMs?: number;
     summary?: string;
-} | {
-    type: "user_question";
-    questions: Array<{
-        id: string;
-    }>;
 } | {
     type: "status";
     message: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "21.1.0-rc.493.1",
+  "version": "22.0.0-rc.495.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/dist/opportunities/opportunity.pending-questions.d.ts

@@ -1,33 +0,0 @@
-import type { PendingQuestionSummary } from "../shared/schemas/pending-question.schema.js";
-/** Maximum pending questions attached to a single tool result. */
-export declare const MAX_PENDING_QUESTIONS = 3;
-export interface MergePendingQuestionsInput {
-    findPendingQuestions?: (userId: string, filters?: {
-        sourceType?: string;
-        sourceId?: string;
-        networkId?: string;
-        scopeType?: 'intent';
-        scopeId?: string;
-    }) => Promise<PendingQuestionSummary[]>;
-    userId: string;
-    sourceType?: string;
-    sourceId?: string;
-    /** Restrict to questions whose actor carries this network id. */
-    networkId?: string;
-    /** Optional selected-intent scope. */
-    scopeType?: 'intent';
-    scopeId?: string;
-    /** IDs already shown in this chat session — skip them. */
-    surfacedQuestionIds: Set<string>;
-}
-export interface MergePendingQuestionsResult {
-    /** Questions to attach to the tool result (under the `questions` key). */
-    questions: PendingQuestionSummary[];
-    /** IDs of the questions that were included (caller should add to surfacedQuestionIds). */
-    surfacedIds: string[];
-}
-/**
- * Query pending questions and filter out already-surfaced ones.
- * Returns at most MAX_PENDING_QUESTIONS entries.
- */
-export declare function mergePendingQuestions(input: MergePendingQuestionsInput): Promise<MergePendingQuestionsResult>;

package/dist/opportunities/opportunity.pending-questions.js

@@ -1,42 +0,0 @@
-/**
- * Helper for merging pending questions from the DB into tool results.
- * Extracted so it can be unit-tested independently of the tool handler.
- */
-import { protocolLogger } from "../shared/observability/protocol.logger.js";
-const logger = protocolLogger("PendingQuestions");
-/** Maximum pending questions attached to a single tool result. */
-export const MAX_PENDING_QUESTIONS = 3;
-/**
- * Query pending questions and filter out already-surfaced ones.
- * Returns at most MAX_PENDING_QUESTIONS entries.
- */
-export async function mergePendingQuestions(input) {
-    if (!input.findPendingQuestions) {
-        return { questions: [], surfacedIds: [] };
-    }
-    const hasFilters = Boolean(input.sourceType || input.networkId || input.scopeType);
-    const filters = hasFilters
-        ? {
-            ...(input.sourceType ? { sourceType: input.sourceType } : {}),
-            ...(input.sourceId ? { sourceId: input.sourceId } : {}),
-            ...(input.networkId ? { networkId: input.networkId } : {}),
-            ...(input.scopeType && input.scopeId ? { scopeType: input.scopeType, scopeId: input.scopeId } : {}),
-        }
-        : undefined;
-    let pending;
-    try {
-        pending = await input.findPendingQuestions(input.userId, filters);
-    }
-    catch (err) {
-        logger.warn('Failed to fetch pending questions, returning empty', { error: err });
-        return { questions: [], surfacedIds: [] };
-    }
-    // Deduplicate against already-surfaced IDs in this session
-    const fresh = pending.filter((q) => !input.surfacedQuestionIds.has(q.id));
-    const capped = fresh.slice(0, MAX_PENDING_QUESTIONS);
-    const publicQuestions = capped.map(({ actors: _actors, purpose: _purpose, ...question }) => question);
-    return {
-        questions: publicQuestions,
-        surfacedIds: capped.map((q) => q.id),
-    };
-}

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

@@ -1,28 +0,0 @@
-import { type QuestionGenerationResult } from "./question.schema.js";
-import { createStructuredModel } from "../shared/agent/model.config.js";
-import { type QuestionerInput } from "./question.input.js";
-export interface QuestionerAgentConfig {
-    /** Optional model config override. */
-    modelConfig?: Parameters<typeof createStructuredModel>[3];
-}
-/**
- * Stateless question-generation agent. Accepts a `QuestionerInput` envelope,
- * selects the preset for the given mode, invokes the LLM, and applies
- * guardrails (dedup + strategy diversity).
- */
-export declare class QuestionerAgent {
-    private model;
-    constructor(config?: QuestionerAgentConfig);
-    /**
-     * Generate up to 3 decision questions from the given input.
-     *
-     * @param input  Envelope with mode, userId, source info, and mode-specific context.
-     * @param options.signal  Optional AbortSignal to cancel the in-flight LLM call.
-     * @returns A result with parallel questions[] and strategies[] arrays,
-     *   or null when generation failed, guardrails dropped all candidates,
-     *   the LLM threw, or the call was aborted.
-     */
-    invoke(input: QuestionerInput, options?: {
-        signal?: AbortSignal;
-    }): Promise<QuestionGenerationResult | null>;
-}

package/dist/questions/question.agent.js

@@ -1,136 +0,0 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-/**
- * questions/question.agent — QuestionerAgent.
- *
- * Stateless, mode-driven agent that generates structured decision questions
- * from arbitrary protocol contexts.
- *
- * Follows the IndexNegotiator pattern: constructor takes optional config,
- * single public `invoke()` method receives the full context per call.
- * The LLM model is bound once at construction; the preset (system prompt +
- * builder) is selected per invocation based on `input.mode`.
- */
-import { HumanMessage, SystemMessage } from "@langchain/core/messages";
-import { QuestionGeneratorResponseSchema } from "./question.schema.js";
-import { createStructuredModel } from "../shared/agent/model.config.js";
-import { invokeWithAbortSignal } from "../shared/agent/model-signal.js";
-import { protocolLogger } from "../shared/observability/protocol.logger.js";
-import { Timed } from "../shared/observability/performance.js";
-import { getPreset } from "./question.presets.js";
-import { isValidQuestionerInputContract } from "./question.input.js";
-const logger = protocolLogger("QuestionerAgent");
-/** Maximum same-strategy questions allowed in a single emission. */
-const MAX_SAME_STRATEGY = 2;
-/**
- * Stateless question-generation agent. Accepts a `QuestionerInput` envelope,
- * selects the preset for the given mode, invokes the LLM, and applies
- * guardrails (dedup + strategy diversity).
- */
-export class QuestionerAgent {
-    constructor(config) {
-        this.model = createStructuredModel("questioner", QuestionGeneratorResponseSchema, {
-            name: "clarifying_questions",
-        }, config?.modelConfig);
-    }
-    /**
-     * Generate up to 3 decision questions from the given input.
-     *
-     * @param input  Envelope with mode, userId, source info, and mode-specific context.
-     * @param options.signal  Optional AbortSignal to cancel the in-flight LLM call.
-     * @returns A result with parallel questions[] and strategies[] arrays,
-     *   or null when generation failed, guardrails dropped all candidates,
-     *   the LLM threw, or the call was aborted.
-     */
-    async invoke(input, options) {
-        if (!isValidQuestionerInputContract(input)) {
-            logger.warn('QuestionerAgent rejected invalid mode/purpose/context contract', { mode: input.mode });
-            return null;
-        }
-        const preset = getPreset(input.mode, input.purpose);
-        const userMessage = preset.buildPrompt(input.context);
-        let raw;
-        try {
-            raw = await invokeWithAbortSignal(this.model, [new SystemMessage(preset.systemPrompt), new HumanMessage(userMessage)], options?.signal);
-        }
-        catch (err) {
-            const aborted = options?.signal?.aborted ?? false;
-            if (aborted) {
-                logger.info("QuestionerAgent aborted by signal", {
-                    mode: input.mode,
-                    reason: options?.signal?.reason instanceof Error
-                        ? options.signal.reason.message
-                        : String(options?.signal?.reason ?? "unknown"),
-                });
-            }
-            else {
-                logger.warn("QuestionerAgent LLM call failed", {
-                    mode: input.mode,
-                    error: err instanceof Error ? err.message : String(err),
-                });
-            }
-            return null;
-        }
-        const parsed = QuestionGeneratorResponseSchema.safeParse(raw);
-        if (!parsed.success) {
-            logger.warn("QuestionerAgent parse failed", {
-                mode: input.mode,
-                error: parsed.error.message,
-            });
-            return null;
-        }
-        const filtered = applyGuardrails(parsed.data.questions);
-        if (filtered.length === 0)
-            return null;
-        return {
-            questions: filtered.map(stripInternalMetadata),
-            strategies: filtered.map((q) => q.strategy),
-            underspecificationTypes: filtered.map((q) => q.underspecificationType),
-        };
-    }
-}
-__decorate([
-    Timed(),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object, Object]),
-    __metadata("design:returntype", Promise)
-], QuestionerAgent.prototype, "invoke", null);
-// --- Guardrails ---------------------------------------------------------------
-function applyGuardrails(questions) {
-    const dedupedByTitle = dedupByTitle(questions);
-    return enforceStrategyDiversity(dedupedByTitle);
-}
-function dedupByTitle(questions) {
-    const seen = new Set();
-    const out = [];
-    for (const q of questions) {
-        if (seen.has(q.title))
-            continue;
-        seen.add(q.title);
-        out.push(q);
-    }
-    return out;
-}
-function enforceStrategyDiversity(questions) {
-    const counts = new Map();
-    const out = [];
-    for (const q of questions) {
-        const n = counts.get(q.strategy) ?? 0;
-        if (n >= MAX_SAME_STRATEGY)
-            continue;
-        counts.set(q.strategy, n + 1);
-        out.push(q);
-    }
-    return out;
-}
-function stripInternalMetadata(q) {
-    const { strategy: _strategy, underspecificationType: _underspecificationType, ...publicShape } = q;
-    return publicShape;
-}

package/dist/questions/question.ask.tool.d.ts

@@ -1,12 +0,0 @@
-import type { DefineTool } from "../shared/agent/tool.helpers.js";
-import type { AskUserQuestionToolDeps } from "./question.tools.port.js";
-import { QuestionerAgent } from "./question.agent.js";
-/** Test seam: replace or reset the module-level QuestionerAgent singleton. */
-export declare function setQuestionerAgentForTesting(agent: QuestionerAgent | null): void;
-/**
- * Creates the chat-only `ask_user_question` tool.
- *
- * @param defineTool - Tool factory provided by the composition root.
- * @param deps       - Shared tool dependencies; requires `chatQuestions`.
- */
-export declare function createAskUserQuestionTools(defineTool: DefineTool, deps: AskUserQuestionToolDeps): readonly [any];