@indexnetwork/protocol 13.2.0-rc.466.1 → 14.0.0-rc.468.1

package/CHANGELOG.md

@@ -20,6 +20,45 @@ went 6.7.1 → 8.0.2 with no 7.x in between because the whole 7.x line shipped a
 prereleases between the two promotions. To track every change, read `rc`; to
 pin a supported release, use `latest`.
 
+## 13.2.1 - 2026-08-16
+
+No public API change: all 441 exported symbols are byte-identical to 13.2.0, and
+`src/index.ts` is untouched. This is internal structure only.
+
+### Removed
+
+- Removed the IND-543 outer shells — `src/public/`, `src/platform/`,
+  `src/runtime/foreground/`, and `src/runtime/background/`. All four were
+  declaration-only placeholders with zero inbound imports; `runtime/background`
+  and `public` consisted of nothing but a header comment. The only thing
+  referencing them was a spec asserting that they existed.
+- Removed eight unused capability barrels (`signals/index.ts`,
+  `communities/index.ts`, `contacts/index.ts`, `questions/index.ts`,
+  `opportunity/index.ts`, `negotiation/index.ts`, `integrations/index.ts`,
+  `participant-agents/index.ts`). Each was `export * from "./public/index.js"`
+  with no importers — every real consumer already went to `public/` directly.
+- Removed `src/shared/ui/`, which contained no source, only a `tests/tsconfig.json`.
+- Removed the `ambient-background`, `neutral-platform`, and
+  `public-compatibility` capability classifications, which existed solely to
+  describe the deleted shells.
+
+### Changed
+
+- Resolved the tool-composition shim inversion. `tool.registry.ts` and
+  `tool.factory.ts` were implemented in `runtime/foreground/composition/` and
+  re-exported from `shared/agent/` through modules marked `@deprecated` — but
+  all 25 importers used the deprecated path. The implementations now live at
+  `shared/agent/tool.registry.ts` and `shared/agent/tool.factory.ts`, and the
+  indirection is gone. `mcp.server.ts` was the one direct consumer of the old
+  location and now resolves to the same single home.
+- `signals/application/intent.tools.ts` is imported directly by the tool
+  factory; the `runtime/foreground/signals/intent.tools.ts` pass-through
+  re-export that sat between them is removed.
+- Replaced `architecture/tests/runtime-shells.spec.ts` with
+  `architecture/tests/package-entry.spec.ts`, which asserts the invariants that
+  outlived the shells: `src/index.ts` is the sole `package.json` export, and the
+  tool composition root has exactly one implementation.
+
 ## 13.2.0 - 2026-08-16
 
 ### Added
@@ -93,6 +132,16 @@ pin a supported release, use `latest`.
 
 ## [Unreleased]
 
+### Removed
+
+- **Breaking (14.0.0):** remove the `orchestrator` chat persona. `ORCHESTRATOR_PERSONA_ID` and `ORCHESTRATOR_PERSONA` are gone from the public API, and the orchestrator system prompt (`buildSystemContent`) and its conditional prompt-module registry are deleted. `ChatPersonaLoopBehaviors.hallucinationRecovery` is retained — it is opted into by the onboarding, signal and negotiator personas, not just the removed one.
+- Remove the never-emitted `question_generator_start` / `question_generator_end` stream events and the `DebugMetaDiscoveryQuestions` debug payload, which had no producer.
+
+### Changed
+
+- **Breaking:** `ChatGraphFactory` and `ChatAgent.create()` now require a `ChatPersonaConfig`. There is no default persona; callers name the persona they drive.
+- `DebugMetaOrchestratorNegotiations` keeps its name and wire key deliberately. It is read back out of persisted message debug metadata, so renaming it would drop the negotiation pointer for every historical message. It is populated for every persona whose tools can start a negotiation, not only the persona it is named after.
+
 ### Changed
 
 - The eval ops sign-in callback accepts only the `api_key` field (protocol

package/dist/capabilities/participant-agents.facade.d.ts

@@ -10,7 +10,7 @@
  *
  * 2. **Runtime personas, chat graph, and tool-composition seams** — sourced
  *    from chat/ (runtime foreground; not owned by participant-agents module):
- *    - `ChatGraphFactory`, `ORCHESTRATOR_PERSONA_ID`, persona factories, etc.
+ *    - `ChatGraphFactory`, persona ids and factories, etc.
  *    - `ChatTitleGenerator`, `ChatInterruptClassifier`, `ChatSummarizer`, etc.
  *
  * Runtime personas, chat/MCP transport, authentication, and all-capability
@@ -22,7 +22,6 @@
 export { createAgentTools, SYSTEM_AGENT_IDS } from "../participant-agents/public/index.js";
 export type { AgentToolDeps } from "../participant-agents/public/index.js";
 export { ChatGraphFactory } from "../chat/chat.graph.js";
-export { ORCHESTRATOR_PERSONA_ID } from "../chat/chat.persona.js";
 export type { ChatPersonaConfig } from "../chat/chat.persona.js";
 export { NEGOTIATOR_PERSONA_ID, createNegotiatorPersona } from "../chat/negotiator.persona.js";
 export { SIGNAL_PERSONA_ID, SIGNAL_PERSONA, SIGNAL_NEW_SIGNAL_KICKOFF, SIGNAL_TOOL_NAMES, createSignalTools, filterSignalTools, narrowSignalTools } from "../chat/signal.persona.js";

package/dist/capabilities/participant-agents.facade.js

@@ -10,7 +10,7 @@
  *
  * 2. **Runtime personas, chat graph, and tool-composition seams** — sourced
  *    from chat/ (runtime foreground; not owned by participant-agents module):
- *    - `ChatGraphFactory`, `ORCHESTRATOR_PERSONA_ID`, persona factories, etc.
+ *    - `ChatGraphFactory`, persona ids and factories, etc.
  *    - `ChatTitleGenerator`, `ChatInterruptClassifier`, `ChatSummarizer`, etc.
  *
  * Runtime personas, chat/MCP transport, authentication, and all-capability
@@ -23,7 +23,6 @@
 export { createAgentTools, SYSTEM_AGENT_IDS } from "../participant-agents/public/index.js";
 // ── Runtime chat graph ────────────────────────────────────────────────────────
 export { ChatGraphFactory } from "../chat/chat.graph.js";
-export { ORCHESTRATOR_PERSONA_ID } from "../chat/chat.persona.js";
 export { NEGOTIATOR_PERSONA_ID, createNegotiatorPersona } from "../chat/negotiator.persona.js";
 export { SIGNAL_PERSONA_ID, SIGNAL_PERSONA, SIGNAL_NEW_SIGNAL_KICKOFF, SIGNAL_TOOL_NAMES, createSignalTools, filterSignalTools, narrowSignalTools } from "../chat/signal.persona.js";
 export { REPORTER_PERSONA_ID, REPORTER_PERSONA, REPORTER_BRIEFING_KICKOFF, REPORTER_TOOL_NAMES, createReporterTools, filterReporterTools, narrowReporterTools } from "../chat/reporter.persona.js";

package/dist/chat/chat-streaming.types.d.ts

@@ -4,8 +4,8 @@
  * These types define the structure of events sent during streaming chat responses.
  * Events are sent as Server-Sent Events (SSE) with JSON payloads.
  */
-import type { Question, QuestionStrategy } from "../questions/domain/question.schema.js";
-export type ChatStreamEventType = "status" | "routing" | "thinking" | "subgraph_start" | "subgraph_result" | "token" | "done" | "error" | "tool_start" | "tool_end" | "agent_thinking" | "tool_activity" | "iteration_start" | "llm_start" | "llm_end" | "response_complete" | "response_reset" | "debug_meta" | "graph_start" | "graph_end" | "phase_start" | "phase_end" | "agent_start" | "agent_end" | "hallucination_detected" | "negotiation_session_start" | "negotiation_session_end" | "negotiation_turn" | "negotiation_outcome" | "chat_summarizer_start" | "chat_summarizer_end" | "question_generator_start" | "question_generator_end" | "decision_questions" | "user_question" | "steer_or_queue";
+import type { Question } from "../questions/domain/question.schema.js";
+export type ChatStreamEventType = "status" | "routing" | "thinking" | "subgraph_start" | "subgraph_result" | "token" | "done" | "error" | "tool_start" | "tool_end" | "agent_thinking" | "tool_activity" | "iteration_start" | "llm_start" | "llm_end" | "response_complete" | "response_reset" | "debug_meta" | "graph_start" | "graph_end" | "phase_start" | "phase_end" | "agent_start" | "agent_end" | "hallucination_detected" | "negotiation_session_start" | "negotiation_session_end" | "negotiation_turn" | "negotiation_outcome" | "chat_summarizer_start" | "chat_summarizer_end" | "decision_questions" | "user_question" | "steer_or_queue";
 /**
  * Base interface for all chat stream events.
  */
@@ -143,7 +143,7 @@ export interface DoneEvent extends ChatStreamEventBase {
     suggestions?: ChatSuggestion[];
     /** Optional rich opportunity cards returned by tools */
     opportunityCards?: OpportunityCardPayload[];
-    /** Decision questions to render (orchestrator flow only). */
+    /** Decision questions to render, harvested from any tool result carrying `questions`. */
     decisionQuestions?: Question[];
 }
 /**
@@ -326,19 +326,20 @@ export interface DebugMetaLlm {
 /**
  * Negotiation sessions recorded during this turn.
  */
+/**
+ * Negotiations started during a chat turn, keyed by opportunity.
+ *
+ * Named for the retired orchestrator persona; the key is deliberately
+ * unchanged because it is read back out of persisted message debug metadata
+ * (see debug.controller's negotiation hydration). Renaming it would drop the
+ * pointer for every historical message and silently fall back to the
+ * time-window heuristic. Populated for every persona whose tools can start a
+ * negotiation, not just the persona it is named after.
+ */
 export interface DebugMetaOrchestratorNegotiations {
     /** Opportunity IDs for which a negotiation_session_start was emitted. */
     opportunityIds: string[];
 }
-/**
- * Decision-question generation debug data.
- */
-export interface DebugMetaDiscoveryQuestions {
-    inputMode: "transcripts" | "insights";
-    finalCount: number;
-    strategies: QuestionStrategy[];
-    durationMs: number;
-}
 /**
  * Debug meta event - per-turn graph and tool usage for copy debug.
  */
@@ -349,8 +350,6 @@ export interface DebugMetaEvent extends ChatStreamEventBase {
     tools: DebugMetaToolCall[];
     llm: DebugMetaLlm;
     orchestratorNegotiations?: DebugMetaOrchestratorNegotiations;
-    /** Decision-question generation debug data. */
-    discoveryQuestions?: DebugMetaDiscoveryQuestions;
 }
 /** Graph start event — emitted when a LangGraph sub-graph begins inside a tool. */
 export interface GraphStartEvent extends ChatStreamEventBase {
@@ -449,27 +448,6 @@ export interface ChatSummarizerEndEvent extends ChatStreamEventBase {
         durationMs: number;
     };
 }
-export interface QuestionGeneratorStartEvent extends ChatStreamEventBase {
-    type: "question_generator_start";
-    payload: {
-        inputMode: "transcripts" | "insights";
-        negotiationCount: number;
-        hasChatContext: boolean;
-        truncated?: {
-            originalCount: number;
-            keptCount: number;
-        };
-    };
-}
-export interface QuestionGeneratorEndEvent extends ChatStreamEventBase {
-    type: "question_generator_end";
-    payload: {
-        finalCount: number;
-        strategies: QuestionStrategy[];
-        durationMs: number;
-        inputMode: "transcripts" | "insights";
-    };
-}
 export interface DecisionQuestionsEvent extends ChatStreamEventBase {
     type: "decision_questions";
     questions: Question[];
@@ -484,7 +462,7 @@ export interface UserQuestionPayload {
     id: string;
 }
 /**
- * User question event — emitted when the orchestrator's ask_user_question
+ * User question event — emitted when a persona's ask_user_question
  * tool persisted chat-mode questions and is now blocking the turn awaiting
  * the user's inline answer.
  */
@@ -507,7 +485,7 @@ export interface SteerOrQueueEvent extends ChatStreamEventBase {
 /**
  * Union type of all chat stream events.
  */
-export type ChatStreamEvent = StatusEvent | RoutingEvent | ThinkingEvent | SubgraphStartEvent | SubgraphResultEvent | TokenEvent | DoneEvent | ErrorEvent | ToolStartEvent | ToolEndEvent | AgentThinkingEvent | ToolActivityEvent | IterationStartEvent | LlmStartEvent | LlmEndEvent | ResponseCompleteEvent | ResponseResetEvent | HallucinationDetectedEvent | DebugMetaEvent | GraphStartEvent | GraphEndEvent | PhaseStartEvent | PhaseEndEvent | AgentStartEvent | AgentEndEvent | NegotiationSessionStartEvent | NegotiationSessionEndEvent | NegotiationTurnEvent | NegotiationOutcomeEvent | ChatSummarizerStartEvent | ChatSummarizerEndEvent | QuestionGeneratorStartEvent | QuestionGeneratorEndEvent | DecisionQuestionsEvent | UserQuestionEvent | SteerOrQueueEvent;
+export type ChatStreamEvent = StatusEvent | RoutingEvent | ThinkingEvent | SubgraphStartEvent | SubgraphResultEvent | TokenEvent | DoneEvent | ErrorEvent | ToolStartEvent | ToolEndEvent | AgentThinkingEvent | ToolActivityEvent | IterationStartEvent | LlmStartEvent | LlmEndEvent | ResponseCompleteEvent | ResponseResetEvent | HallucinationDetectedEvent | DebugMetaEvent | GraphStartEvent | GraphEndEvent | PhaseStartEvent | PhaseEndEvent | AgentStartEvent | AgentEndEvent | NegotiationSessionStartEvent | NegotiationSessionEndEvent | NegotiationTurnEvent | NegotiationOutcomeEvent | ChatSummarizerStartEvent | ChatSummarizerEndEvent | DecisionQuestionsEvent | UserQuestionEvent | SteerOrQueueEvent;
 /**
  * Formats a chat stream event as an SSE message. If JSON.stringify throws (e.g. circular ref,
  * non-serializable value), returns a minimal error event so the stream stays valid.
@@ -624,7 +602,7 @@ export declare function createHallucinationDetectedEvent(sessionId: string, bloc
 /**
  * Creates a formatted debug meta event (per-turn graph and tool usage).
  */
-export declare function createDebugMetaEvent(sessionId: string, graph: string, iterations: number, tools: DebugMetaToolCall[], llm: DebugMetaLlm, orchestratorNegotiations?: DebugMetaOrchestratorNegotiations, discoveryQuestions?: DebugMetaDiscoveryQuestions): DebugMetaEvent;
+export declare function createDebugMetaEvent(sessionId: string, graph: string, iterations: number, tools: DebugMetaToolCall[], llm: DebugMetaLlm, orchestratorNegotiations?: DebugMetaOrchestratorNegotiations): DebugMetaEvent;
 /**
  * Creates a graph start event emitted when a LangGraph sub-graph begins inside a tool.
  */
@@ -649,8 +627,6 @@ export declare function createNegotiationTurnEvent(sessionId: string, payload: O
 export declare function createNegotiationOutcomeEvent(sessionId: string, payload: Omit<NegotiationOutcomeEvent, "type" | "sessionId" | "timestamp">): NegotiationOutcomeEvent;
 export declare function createChatSummarizerStartEvent(sessionId: string, payload: ChatSummarizerStartEvent["payload"]): ChatSummarizerStartEvent;
 export declare function createChatSummarizerEndEvent(sessionId: string, payload: ChatSummarizerEndEvent["payload"]): ChatSummarizerEndEvent;
-export declare function createQuestionGeneratorStartEvent(sessionId: string, payload: QuestionGeneratorStartEvent["payload"]): QuestionGeneratorStartEvent;
-export declare function createQuestionGeneratorEndEvent(sessionId: string, payload: QuestionGeneratorEndEvent["payload"]): QuestionGeneratorEndEvent;
 export declare function createDecisionQuestionsEvent(sessionId: string, payload: {
     questions: Question[];
 }): DecisionQuestionsEvent;

package/dist/chat/chat-streaming.types.js

@@ -223,14 +223,13 @@ export function createHallucinationDetectedEvent(sessionId, blockType, tool) {
 /**
  * Creates a formatted debug meta event (per-turn graph and tool usage).
  */
-export function createDebugMetaEvent(sessionId, graph, iterations, tools, llm, orchestratorNegotiations, discoveryQuestions) {
+export function createDebugMetaEvent(sessionId, graph, iterations, tools, llm, orchestratorNegotiations) {
     return createStreamEvent("debug_meta", sessionId, {
         graph,
         iterations,
         tools,
         llm,
         ...(orchestratorNegotiations !== undefined && { orchestratorNegotiations }),
-        ...(discoveryQuestions !== undefined && { discoveryQuestions }),
     });
 }
 // ════════════════════════════════════════════════════════════════════════════
@@ -284,12 +283,6 @@ export function createChatSummarizerStartEvent(sessionId, payload) {
 export function createChatSummarizerEndEvent(sessionId, payload) {
     return createStreamEvent("chat_summarizer_end", sessionId, { payload });
 }
-export function createQuestionGeneratorStartEvent(sessionId, payload) {
-    return createStreamEvent("question_generator_start", sessionId, { payload });
-}
-export function createQuestionGeneratorEndEvent(sessionId, payload) {
-    return createStreamEvent("question_generator_end", sessionId, { payload });
-}
 export function createDecisionQuestionsEvent(sessionId, payload) {
     return createStreamEvent("decision_questions", sessionId, payload);
 }

package/dist/chat/chat.agent.d.ts

@@ -1,8 +1,8 @@
 import { BaseMessage } from "@langchain/core/messages";
 import type { ToolContext } from "../shared/agent/tool.factory.js";
-import { type ChatPersonaConfig } from "./chat.persona.js";
-import type { DebugMetaToolCall, DebugMetaLlm, DebugMetaOrchestratorNegotiations, DebugMetaDiscoveryQuestions } from "./chat-streaming.types.js";
-import type { Question, QuestionStrategy } from "../questions/domain/question.schema.js";
+import type { ChatPersonaConfig } from "./chat.persona.js";
+import type { DebugMetaToolCall, DebugMetaLlm, DebugMetaOrchestratorNegotiations } from "./chat-streaming.types.js";
+import type { Question } from "../questions/domain/question.schema.js";
 export { ITERATION_NUDGE } from "./chat.prompt.js";
 /**
  * Writer callback for streaming custom data out of the graph node.
@@ -138,25 +138,6 @@ export type AgentStreamEvent = {
     payload: {
         durationMs: number;
     };
-} | {
-    type: "question_generator_start";
-    payload: {
-        inputMode: "transcripts" | "insights";
-        negotiationCount: number;
-        hasChatContext: boolean;
-        truncated?: {
-            originalCount: number;
-            keptCount: number;
-        };
-    };
-} | {
-    type: "question_generator_end";
-    payload: {
-        finalCount: number;
-        strategies: QuestionStrategy[];
-        durationMs: number;
-        inputMode: "transcripts" | "insights";
-    };
 };
 /**
  * Soft limit: After this many iterations, inject a nudge message.
@@ -226,9 +207,9 @@ export declare class ChatAgent {
      *
      * @param context - Tool context (database, userId, scope, deps)
      * @param persona - Persona config (prompt builder, toolset, loop behaviors).
-     *                  Defaults to the orchestrator persona.
+     *                  Required — there is no default persona.
      */
-    static create(context: ToolContext, persona?: ChatPersonaConfig): Promise<ChatAgent>;
+    static create(context: ToolContext, persona: ChatPersonaConfig): Promise<ChatAgent>;
     /**
      * Run a single iteration of the agent loop.
      *
@@ -317,7 +298,6 @@ export declare class ChatAgent {
             tools: DebugMetaToolCall[];
             llm: DebugMetaLlm;
             orchestratorNegotiations?: DebugMetaOrchestratorNegotiations;
-            discoveryQuestions?: DebugMetaDiscoveryQuestions;
         };
     }>;
 }

package/dist/chat/chat.agent.js

@@ -11,7 +11,6 @@ import { AIMessage, SystemMessage, ToolMessage } from "@langchain/core/messages"
 import { resolveChatContext } from "../shared/agent/tool.helpers.js";
 import { scopeFromNetworkId } from "../shared/agent/tool.scope.js";
 import { ITERATION_NUDGE } from "./chat.prompt.js";
-import { ORCHESTRATOR_PERSONA } from "./chat.persona.js";
 import { extractRecentToolCalls } from "./chat.prompt.modules.js";
 import { protocolLogger } from "../shared/observability/protocol.logger.js";
 import { createModel } from "../shared/agent/model.config.js";
@@ -192,9 +191,9 @@ export class ChatAgent {
      *
      * @param context - Tool context (database, userId, scope, deps)
      * @param persona - Persona config (prompt builder, toolset, loop behaviors).
-     *                  Defaults to the orchestrator persona.
+     *                  Required — there is no default persona.
      */
-    static async create(context, persona = ORCHESTRATOR_PERSONA) {
+    static async create(context, persona) {
         const { networkId: legacyNetworkId } = context;
         const explicitScope = context.scopeType && context.scopeId
             ? { scopeType: context.scopeType, scopeId: context.scopeId }
@@ -442,7 +441,6 @@ export class ChatAgent {
         let debugSteps;
         let graphTimings;
         let decisionQuestions;
-        let discoveryQuestionsDebug;
         try {
             const parsed = JSON.parse(normalized);
             const payload = parsed.success && parsed.data != null ? parsed.data : parsed;
@@ -472,31 +470,9 @@ export class ChatAgent {
                 catch { /* keep original if can't clean */ }
             }
             const rawQuestions = payload.questions ?? parsed.questions;
-            const rawQuestionDebug = payload._discoveryQuestionsDebug
-                ?? parsed._discoveryQuestionsDebug;
             if (Array.isArray(rawQuestions)) {
                 decisionQuestions = rawQuestions;
             }
-            if (rawQuestionDebug && typeof rawQuestionDebug === "object") {
-                discoveryQuestionsDebug = rawQuestionDebug;
-            }
-            // `_discoveryQuestionsDebug` is internal trace data — strip from the LLM-facing
-            // tool result. `questions` is intentionally kept visible so the agent can
-            // follow the prompt addendum and reference the decision prompts in its reply.
-            if (discoveryQuestionsDebug !== undefined) {
-                try {
-                    const cleaned = JSON.parse(normalized);
-                    const stripFrom = (obj) => {
-                        delete obj._discoveryQuestionsDebug;
-                    };
-                    stripFrom(cleaned);
-                    if (cleaned.data && typeof cleaned.data === "object") {
-                        stripFrom(cleaned.data);
-                    }
-                    normalized = JSON.stringify(cleaned);
-                }
-                catch { /* keep original */ }
-            }
         }
         catch {
             /* not JSON, keep default */
@@ -507,7 +483,6 @@ export class ChatAgent {
             debugSteps,
             graphTimings,
             ...(decisionQuestions !== undefined ? { decisionQuestions } : {}),
-            ...(discoveryQuestionsDebug !== undefined ? { discoveryQuestionsDebug } : {}),
         };
     }
     /**
@@ -566,9 +541,8 @@ export class ChatAgent {
      */
     async streamRun(initialMessages, writer, signal) {
         const llm = { calls: 0, totalDurationMs: 0, resets: [], hallucinations: [] };
-        const orchestratorNegotiationIds = new Set();
+        const negotiationIds = new Set();
         let lastLlmStart = 0;
-        let latestDiscoveryQuestionsDebug;
         const emit = (event) => {
             if (event.type === "llm_start") {
                 llm.calls += 1;
@@ -587,7 +561,7 @@ export class ChatAgent {
                 llm.hallucinations.push({ blockType: event.blockType, tool: event.tool, at: Date.now() });
             }
             else if (event.type === "negotiation_session_start") {
-                orchestratorNegotiationIds.add(event.opportunityId);
+                negotiationIds.add(event.opportunityId);
             }
             try {
                 writer?.(event);
@@ -743,8 +717,6 @@ export class ChatAgent {
                         const toolDurationMs = Date.now() - toolStart;
                         let resultStr = typeof result === "string" ? result : JSON.stringify(result);
                         const normalized = await this.normalizeToolResult(tc.name, resultStr, tc.args);
-                        if (normalized.discoveryQuestionsDebug)
-                            latestDiscoveryQuestionsDebug = normalized.discoveryQuestionsDebug;
                         resultStr = normalized.resultStr;
                         result = resultStr;
                         if (normalized.decisionQuestions && normalized.decisionQuestions.length > 0) {
@@ -835,8 +807,8 @@ export class ChatAgent {
             // directly instead of calling the corresponding tool. These blocks
             // lack valid proposalIds / data and won't work in the frontend.
             // Auto-invoke the correct tool directly instead of re-asking the LLM.
-            // Persona-gated: only personas with hallucinationRecovery enabled (orchestrator)
-            // run detection/auto-invoke — other personas never trigger this branch.
+            // Persona-gated: only personas with hallucinationRecovery enabled run
+            // detection/auto-invoke — other personas never trigger this branch.
             const hallucinatedBlock = this.persona.loopBehaviors.hallucinationRecovery
                 ? this.detectHallucinatedBlock(iterationText, toolsDebug, iterCtx.currentMessage)
                 : null;
@@ -887,9 +859,6 @@ export class ChatAgent {
                         // Mirror the main tool loop's handling: forward decision questions
                         // and capture debug metadata even when the discovery tool was invoked
                         // via the hallucination-recovery path.
-                        if (normalized.discoveryQuestionsDebug) {
-                            latestDiscoveryQuestionsDebug = normalized.discoveryQuestionsDebug;
-                        }
                         if (normalized.decisionQuestions && normalized.decisionQuestions.length > 0) {
                             const { fresh: freshHallucination, newIds: newIdsHallucination } = deduplicateQuestions(normalized.decisionQuestions, surfacedQuestionIds);
                             if (freshHallucination.length > 0) {
@@ -1044,10 +1013,9 @@ export class ChatAgent {
                     iterations: iterationCount,
                     tools: toolsDebug,
                     llm,
-                    ...(orchestratorNegotiationIds.size > 0 && {
-                        orchestratorNegotiations: { opportunityIds: [...orchestratorNegotiationIds] },
+                    ...(negotiationIds.size > 0 && {
+                        orchestratorNegotiations: { opportunityIds: [...negotiationIds] },
                     }),
-                    ...(latestDiscoveryQuestionsDebug && { discoveryQuestions: latestDiscoveryQuestionsDebug }),
                 },
             };
         }
@@ -1062,10 +1030,9 @@ export class ChatAgent {
                     iterations: iterationCount,
                     tools: toolsDebug,
                     llm,
-                    ...(orchestratorNegotiationIds.size > 0 && {
-                        orchestratorNegotiations: { opportunityIds: [...orchestratorNegotiationIds] },
+                    ...(negotiationIds.size > 0 && {
+                        orchestratorNegotiations: { opportunityIds: [...negotiationIds] },
                     }),
-                    ...(latestDiscoveryQuestionsDebug && { discoveryQuestions: latestDiscoveryQuestionsDebug }),
                 },
             };
         }
@@ -1100,10 +1067,9 @@ export class ChatAgent {
                 iterations: iterationCount,
                 tools: toolsDebug,
                 llm,
-                ...(orchestratorNegotiationIds.size > 0 && {
-                    orchestratorNegotiations: { opportunityIds: [...orchestratorNegotiationIds] },
+                ...(negotiationIds.size > 0 && {
+                    orchestratorNegotiations: { opportunityIds: [...negotiationIds] },
                 }),
-                ...(latestDiscoveryQuestionsDebug && { discoveryQuestions: latestDiscoveryQuestionsDebug }),
             },
         };
     }

package/dist/chat/chat.graph.d.ts

@@ -1,6 +1,6 @@
 import { BaseCheckpointSaver } from "@langchain/langgraph";
 import { BaseMessage } from "@langchain/core/messages";
-import { type ChatPersonaConfig } from "./chat.persona.js";
+import type { ChatPersonaConfig } from "./chat.persona.js";
 import type { ChatGraphCompositeDatabase } from "../shared/interfaces/database.interface.js";
 import type { Embedder } from "../shared/interfaces/embedder.interface.js";
 import type { Scraper } from "../shared/interfaces/scraper.interface.js";
@@ -27,12 +27,12 @@ export declare class ChatGraphFactory {
     private scraper;
     private chatSession;
     private protocolDeps;
-    /** Persona driving this graph's agent loop. Defaults to the orchestrator. */
+    /** Persona driving this graph's agent loop. Required — there is no default. */
     private persona;
     private streamingService;
     constructor(database: ChatGraphCompositeDatabase, embedder: Embedder, scraper: Scraper, chatSession: ChatSessionReader, protocolDeps: ProtocolDeps, 
-    /** Persona driving this graph's agent loop. Defaults to the orchestrator. */
-    persona?: ChatPersonaConfig);
+    /** Persona driving this graph's agent loop. Required — there is no default. */
+    persona: ChatPersonaConfig);
     /**
      * Returns a sibling factory sharing all dependencies but driven by a
      * different persona. Used to derive per-session persona factories (e.g. the
@@ -181,7 +181,6 @@ export declare class ChatGraphFactory {
                 tools: import("./chat-streaming.types.js").DebugMetaToolCall[];
                 llm: import("./chat-streaming.types.js").DebugMetaLlm;
                 orchestratorNegotiations?: import("./chat-streaming.types.js").DebugMetaOrchestratorNegotiations;
-                discoveryQuestions?: import("./chat-streaming.types.js").DebugMetaDiscoveryQuestions;
             };
             error?: undefined;
         } | {
@@ -332,7 +331,6 @@ export declare class ChatGraphFactory {
                 tools: import("./chat-streaming.types.js").DebugMetaToolCall[];
                 llm: import("./chat-streaming.types.js").DebugMetaLlm;
                 orchestratorNegotiations?: import("./chat-streaming.types.js").DebugMetaOrchestratorNegotiations;
-                discoveryQuestions?: import("./chat-streaming.types.js").DebugMetaDiscoveryQuestions;
             };
             error?: undefined;
         } | {

package/dist/chat/chat.graph.js

@@ -2,7 +2,6 @@ import { StateGraph, START, END } from "@langchain/langgraph";
 import { HumanMessage } from "@langchain/core/messages";
 import { ChatGraphState } from "./chat.state.js";
 import { ChatAgent } from "./chat.agent.js";
-import { ORCHESTRATOR_PERSONA } from "./chat.persona.js";
 import { protocolLogger } from "../shared/observability/protocol.logger.js";
 import { truncateToTokenLimit, MAX_CONTEXT_TOKENS } from "./chat.utils.js";
 import { ChatStreamer } from "./chat.streamer.js";
@@ -40,8 +39,8 @@ const RETRY_DELAY_MS = 800;
  */
 export class ChatGraphFactory {
     constructor(database, embedder, scraper, chatSession, protocolDeps, 
-    /** Persona driving this graph's agent loop. Defaults to the orchestrator. */
-    persona = ORCHESTRATOR_PERSONA) {
+    /** Persona driving this graph's agent loop. Required — there is no default. */
+    persona) {
         this.database = database;
         this.embedder = embedder;
         this.scraper = scraper;

package/dist/chat/chat.persona.d.ts

@@ -1,22 +1,23 @@
-import { type ChatTools, type ToolContext, type ResolvedToolContext } from "../shared/agent/tool.factory.js";
+import type { ChatTools, ToolContext, ResolvedToolContext } from "../shared/agent/tool.factory.js";
 import type { IterationContext } from "./chat.prompt.modules.js";
 /**
- * Orchestrator-specific behaviors that live in the agent loop itself
- * (not in the prompt or toolset). Each persona opts in explicitly.
+ * Behaviors that live in the agent loop itself (not in the prompt or toolset).
+ * Each persona opts in explicitly.
  */
 export interface ChatPersonaLoopBehaviors {
     /**
      * Detect hallucinated ```opportunity / ```intent_proposal code blocks in model
      * text, auto-invoke the corresponding tool, and strip unbacked blocks from the
      * final response. Only meaningful for personas whose toolset can legitimately
-     * produce those blocks.
+     * produce those blocks — enabled for onboarding, signal and negotiator, off
+     * for reporter.
      */
     hallucinationRecovery: boolean;
 }
 /**
  * Persona configuration injected into `ChatAgent.create()`.
  *
- * A persona bundles the three orchestrator-coupled seams of the chat runtime:
+ * A persona bundles the three persona-coupled seams of the chat runtime:
  * system-prompt construction, toolset creation, and loop behaviors.
  */
 export interface ChatPersonaConfig {
@@ -34,21 +35,6 @@ export interface ChatPersonaConfig {
      * deterministic safety redirects derived entirely from iteration context.
      */
     resolveDeterministicResponse?: (ctx: ResolvedToolContext, iterCtx: IterationContext) => string | null;
-    /** Orchestrator-specific loop behaviors this persona opts into. */
+    /** Loop behaviors this persona opts into. */
     loopBehaviors: ChatPersonaLoopBehaviors;
 }
-/** Persona id for the default orchestrator ("You are Index…"). */
-export declare const ORCHESTRATOR_PERSONA_ID = "orchestrator";
-/**
- * The orchestrator persona — exactly the pre-personafication wiring:
- * `buildSystemContent` from chat.prompt, `createChatTools` from tool.factory,
- * and all loop behaviors enabled.
- *
- * Both functions delegate lazily (arrow wrappers) instead of capturing the
- * imported symbols at module-load time. This preserves ESM live-binding
- * semantics: the pre-refactor code read `createChatTools` through its import
- * binding at call time, which is what lets test suites swap the module via
- * `mock.module` — a snapshot in this object literal would pin whichever
- * version was loaded first.
- */
-export declare const ORCHESTRATOR_PERSONA: ChatPersonaConfig;

package/dist/chat/chat.persona.js

@@ -1,24 +1 @@
-import { createChatTools } from "../shared/agent/tool.factory.js";
-import { buildSystemContent } from "./chat.prompt.js";
-/** Persona id for the default orchestrator ("You are Index…"). */
-export const ORCHESTRATOR_PERSONA_ID = "orchestrator";
-/**
- * The orchestrator persona — exactly the pre-personafication wiring:
- * `buildSystemContent` from chat.prompt, `createChatTools` from tool.factory,
- * and all loop behaviors enabled.
- *
- * Both functions delegate lazily (arrow wrappers) instead of capturing the
- * imported symbols at module-load time. This preserves ESM live-binding
- * semantics: the pre-refactor code read `createChatTools` through its import
- * binding at call time, which is what lets test suites swap the module via
- * `mock.module` — a snapshot in this object literal would pin whichever
- * version was loaded first.
- */
-export const ORCHESTRATOR_PERSONA = {
-    id: ORCHESTRATOR_PERSONA_ID,
-    buildSystemContent: (ctx, iterCtx) => buildSystemContent(ctx, iterCtx),
-    createTools: (deps, preResolvedContext) => createChatTools(deps, preResolvedContext),
-    loopBehaviors: {
-        hallucinationRecovery: true,
-    },
-};
+export {};

package/dist/chat/chat.prompt.d.ts

@@ -1,17 +1,4 @@
-import type { ResolvedToolContext } from "../shared/agent/tool.factory.js";
-import type { IterationContext } from "./chat.prompt.modules.js";
 /**
  * Nudge message injected after SOFT_ITERATION_LIMIT iterations.
  */
 export declare const ITERATION_NUDGE = "[System Note: You've made several tool calls. Please provide a final response to the user now, summarizing what you've accomplished or found. If you need more information from the user, ask for it in your response.]";
-/**
- * Builds the full system prompt for the chat agent.
- * Composes core, onboarding, scoping, and dynamic modules into a single
- * prompt string. Without iterCtx only core sections are included; modules
- * are omitted, producing a leaner first-iteration prompt.
- *
- * @param ctx - Resolved tool context for the current session
- * @param iterCtx - Optional iteration context for dynamic module resolution
- * @returns The complete system prompt string
- */
-export declare function buildSystemContent(ctx: ResolvedToolContext, iterCtx?: IterationContext): string;