@indexnetwork/protocol 6.5.1-rc.385.1 → 6.6.0-rc.386.1

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

@@ -0,0 +1,146 @@
+import { tool } from "@langchain/core/tools";
+import { z } from "zod";
+import { success } from "../shared/agent/tool.helpers.js";
+export const AGENT_ACTION_PROPOSAL_FENCE = "agent_action_proposal";
+const actionInputSchema = z.discriminatedUnion("type", [
+    z.object({
+        type: z.literal("retract_premise"),
+        premiseId: z.string().trim().min(1),
+    }).strict(),
+    z.object({
+        type: z.literal("narrow_signal"),
+        intentId: z.string().trim().min(1),
+        description: z.string().trim().min(1),
+    }).strict(),
+    z.object({
+        type: z.literal("pause_signal"),
+        intentId: z.string().trim().min(1),
+        evidence: z.string().trim().min(1, "pause_signal evidence is required"),
+    }).strict(),
+]);
+const proposeCleanupActionsSchema = z.object({
+    actions: z.array(actionInputSchema).min(1).max(5),
+}).strict();
+function isFullUuid(value) {
+    return z.string().uuid().safeParse(value).success;
+}
+function skippedAction(action, entityId, proposedOperation, reason) {
+    return {
+        type: action.type,
+        entityId,
+        currentState: "UNKNOWN",
+        proposedOperation,
+        skipped: true,
+        reason,
+        ...(action.type === "pause_signal" ? { evidence: action.evidence } : {}),
+    };
+}
+/**
+ * Creates the reporter-only proposal tool. It validates owner state and records
+ * snapshots, but intentionally has no mutation dependency.
+ */
+export function createProposeCleanupActionsTool(input) {
+    const { database, userDb, context, store } = input;
+    return tool(async (query) => {
+        const proposalId = crypto.randomUUID();
+        const actions = [];
+        for (const action of query.actions) {
+            const entityId = action.type === "retract_premise" ? action.premiseId : action.intentId;
+            const operation = action.type === "retract_premise"
+                ? "RETRACT_PREMISE"
+                : action.type === "narrow_signal" ? "NARROW_SIGNAL" : "PAUSE_SIGNAL";
+            if (!isFullUuid(entityId)) {
+                actions.push(skippedAction(action, entityId, operation, "A full UUID is required; suffixes and ambiguous IDs are not accepted."));
+                continue;
+            }
+            if (action.type === "retract_premise") {
+                const premise = await database.getPremise(entityId).catch(() => null);
+                if (!premise || premise.userId !== context.userId) {
+                    actions.push(skippedAction(action, entityId, operation, "Premise not found or not owned by the authenticated user."));
+                    continue;
+                }
+                if (premise.status !== "ACTIVE") {
+                    actions.push({
+                        type: action.type,
+                        entityId,
+                        currentState: premise.status,
+                        proposedOperation: operation,
+                        skipped: true,
+                        reason: `Premise is already ${premise.status}.`,
+                    });
+                    continue;
+                }
+                actions.push({
+                    type: action.type,
+                    entityId,
+                    currentState: premise.status,
+                    proposedOperation: operation,
+                    snapshot: { status: premise.status, updatedAt: premise.updatedAt.toISOString(), assertionText: premise.assertion.text },
+                });
+                continue;
+            }
+            const intent = await userDb.getIntent(entityId).catch(() => null);
+            if (!intent) {
+                actions.push(skippedAction(action, entityId, operation, "Signal not found or not owned by the authenticated user."));
+                continue;
+            }
+            const status = intent.status ?? "ACTIVE";
+            if (intent.archivedAt || status === "FULFILLED" || status === "EXPIRED") {
+                actions.push({
+                    type: action.type,
+                    entityId,
+                    currentState: intent.archivedAt ? "ARCHIVED" : status,
+                    proposedOperation: operation,
+                    ...(action.type === "pause_signal" ? { evidence: action.evidence } : {}),
+                    skipped: true,
+                    reason: "Signal is archived or terminal and cannot be changed.",
+                });
+                continue;
+            }
+            actions.push({
+                type: action.type,
+                entityId,
+                currentState: status,
+                proposedOperation: operation,
+                ...(action.type === "pause_signal" ? { evidence: action.evidence } : {}),
+                ...(action.type === "narrow_signal" ? { description: action.description } : {}),
+                snapshot: {
+                    status,
+                    updatedAt: intent.updatedAt.toISOString(),
+                    payload: intent.payload,
+                    summary: intent.summary,
+                },
+            });
+        }
+        await store.createProposal({
+            proposalId,
+            userId: context.userId,
+            ...(context.sessionId ? { conversationId: context.sessionId } : {}),
+            actions,
+        });
+        const renderedActions = actions.map(({ snapshot: _snapshot, ...entry }) => entry);
+        const block = `\`\`\`${AGENT_ACTION_PROPOSAL_FENCE}\n${JSON.stringify({ proposalId, actions: renderedActions })}\n\`\`\``;
+        return success({
+            proposed: true,
+            proposalId,
+            actions: renderedActions,
+            message: `IMPORTANT: Include this \`\`\`agent_action_proposal code block EXACTLY as-is in your response. It is a REQUEST for owner confirmation; it performs no mutation until the owner confirms it in the UI:\n\n${block}`,
+        });
+    }, {
+        name: "propose_cleanup_actions",
+        description: "Prepare owner-confirmed cleanup actions from same-turn grounded reads. This tool never mutates data.",
+        schema: proposeCleanupActionsSchema,
+    });
+}
+/** Build the optional action tool from the host-provided ToolContext. */
+export function createReporterActionTool(deps, context, userDb) {
+    if (!deps.actionToolsEnabled || !deps.actionProposalStore)
+        return null;
+    return createProposeCleanupActionsTool({
+        database: deps.database,
+        userDb,
+        context,
+        store: deps.actionProposalStore,
+    });
+}
+//# sourceMappingURL=reporter.action.tools.js.map

package/dist/chat/reporter.action.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporter.action.tools.js","sourceRoot":"/","sources":["chat/reporter.action.tools.ts"],"names":[],"mappings":"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","sourcesContent":["import { tool } from \"@langchain/core/tools\";\nimport { z } from \"zod\";\n\nimport type { ChatGraphCompositeDatabase, UserDatabase } from \"../shared/interfaces/database.interface.js\";\nimport type { ChatTools, ResolvedToolContext, ToolContext } from \"../shared/agent/tool.factory.js\";\nimport { success } from \"../shared/agent/tool.helpers.js\";\n\nexport const AGENT_ACTION_PROPOSAL_FENCE = \"agent_action_proposal\";\n\nexport type AgentCleanupActionType = \"retract_premise\" | \"narrow_signal\" | \"pause_signal\";\n\nexport interface AgentActionProposalSnapshot {\n  status: string;\n  updatedAt?: string;\n  payload?: string;\n  summary?: string | null;\n  assertionText?: string;\n}\n\ninterface AgentActionProposalActionBase {\n  entityId: string;\n  currentState: string;\n  proposedOperation: string;\n  evidence?: string;\n  skipped?: boolean;\n  reason?: string;\n  snapshot?: AgentActionProposalSnapshot;\n  description?: string;\n}\n\nexport type AgentActionProposalAction =\n  | (AgentActionProposalActionBase & { type: \"retract_premise\" })\n  | (AgentActionProposalActionBase & { type: \"narrow_signal\" })\n  | (AgentActionProposalActionBase & { type: \"pause_signal\" });\n\nexport interface AgentActionProposal {\n  proposalId: string;\n  userId: string;\n  conversationId?: string;\n  actions: AgentActionProposalAction[];\n}\n\n/** Host persistence bridge for proposals; the reporter tool never mutates domain rows. */\nexport interface AgentActionProposalStore {\n  createProposal(proposal: AgentActionProposal): Promise<void>;\n}\n\nconst actionInputSchema = z.discriminatedUnion(\"type\", [\n  z.object({\n    type: z.literal(\"retract_premise\"),\n    premiseId: z.string().trim().min(1),\n  }).strict(),\n  z.object({\n    type: z.literal(\"narrow_signal\"),\n    intentId: z.string().trim().min(1),\n    description: z.string().trim().min(1),\n  }).strict(),\n  z.object({\n    type: z.literal(\"pause_signal\"),\n    intentId: z.string().trim().min(1),\n    evidence: z.string().trim().min(1, \"pause_signal evidence is required\"),\n  }).strict(),\n]);\n\nconst proposeCleanupActionsSchema = z.object({\n  actions: z.array(actionInputSchema).min(1).max(5),\n}).strict();\n\ntype ActionInput = z.infer<typeof actionInputSchema>;\n\nfunction isFullUuid(value: string): boolean {\n  return z.string().uuid().safeParse(value).success;\n}\n\nfunction skippedAction(\n  action: ActionInput,\n  entityId: string,\n  proposedOperation: string,\n  reason: string,\n): AgentActionProposalAction {\n  return {\n    type: action.type,\n    entityId,\n    currentState: \"UNKNOWN\",\n    proposedOperation,\n    skipped: true,\n    reason,\n    ...(action.type === \"pause_signal\" ? { evidence: action.evidence } : {}),\n  };\n}\n\n/**\n * Creates the reporter-only proposal tool. It validates owner state and records\n * snapshots, but intentionally has no mutation dependency.\n */\nexport function createProposeCleanupActionsTool(input: {\n  database: ChatGraphCompositeDatabase;\n  userDb: UserDatabase;\n  context: ResolvedToolContext;\n  store: AgentActionProposalStore;\n}): ChatTools[number] {\n  const { database, userDb, context, store } = input;\n\n  return tool(\n    async (query: { actions: ActionInput[] }) => {\n      const proposalId = crypto.randomUUID();\n      const actions: AgentActionProposalAction[] = [];\n\n      for (const action of query.actions) {\n        const entityId = action.type === \"retract_premise\" ? action.premiseId : action.intentId;\n        const operation = action.type === \"retract_premise\"\n          ? \"RETRACT_PREMISE\"\n          : action.type === \"narrow_signal\" ? \"NARROW_SIGNAL\" : \"PAUSE_SIGNAL\";\n\n        if (!isFullUuid(entityId)) {\n          actions.push(skippedAction(action, entityId, operation, \"A full UUID is required; suffixes and ambiguous IDs are not accepted.\"));\n          continue;\n        }\n\n        if (action.type === \"retract_premise\") {\n          const premise = await database.getPremise(entityId).catch(() => null);\n          if (!premise || premise.userId !== context.userId) {\n            actions.push(skippedAction(action, entityId, operation, \"Premise not found or not owned by the authenticated user.\"));\n            continue;\n          }\n          if (premise.status !== \"ACTIVE\") {\n            actions.push({\n              type: action.type,\n              entityId,\n              currentState: premise.status,\n              proposedOperation: operation,\n              skipped: true,\n              reason: `Premise is already ${premise.status}.`,\n            });\n            continue;\n          }\n          actions.push({\n            type: action.type,\n            entityId,\n            currentState: premise.status,\n            proposedOperation: operation,\n            snapshot: { status: premise.status, updatedAt: premise.updatedAt.toISOString(), assertionText: premise.assertion.text },\n          });\n          continue;\n        }\n\n        const intent = await userDb.getIntent(entityId).catch(() => null);\n        if (!intent) {\n          actions.push(skippedAction(action, entityId, operation, \"Signal not found or not owned by the authenticated user.\"));\n          continue;\n        }\n        const status = intent.status ?? \"ACTIVE\";\n        if (intent.archivedAt || status === \"FULFILLED\" || status === \"EXPIRED\") {\n          actions.push({\n            type: action.type,\n            entityId,\n            currentState: intent.archivedAt ? \"ARCHIVED\" : status,\n            proposedOperation: operation,\n            ...(action.type === \"pause_signal\" ? { evidence: action.evidence } : {}),\n            skipped: true,\n            reason: \"Signal is archived or terminal and cannot be changed.\",\n          });\n          continue;\n        }\n        actions.push({\n          type: action.type,\n          entityId,\n          currentState: status,\n          proposedOperation: operation,\n          ...(action.type === \"pause_signal\" ? { evidence: action.evidence } : {}),\n          ...(action.type === \"narrow_signal\" ? { description: action.description } : {}),\n          snapshot: {\n            status,\n            updatedAt: intent.updatedAt.toISOString(),\n            payload: intent.payload,\n            summary: intent.summary,\n          },\n        });\n      }\n\n      await store.createProposal({\n        proposalId,\n        userId: context.userId,\n        ...(context.sessionId ? { conversationId: context.sessionId } : {}),\n        actions,\n      });\n\n      const renderedActions = actions.map(({ snapshot: _snapshot, ...entry }) => entry);\n      const block = `\\`\\`\\`${AGENT_ACTION_PROPOSAL_FENCE}\\n${JSON.stringify({ proposalId, actions: renderedActions })}\\n\\`\\`\\``;\n      return success({\n        proposed: true,\n        proposalId,\n        actions: renderedActions,\n        message: `IMPORTANT: Include this \\`\\`\\`agent_action_proposal code block EXACTLY as-is in your response. It is a REQUEST for owner confirmation; it performs no mutation until the owner confirms it in the UI:\\n\\n${block}`,\n      });\n    },\n    {\n      name: \"propose_cleanup_actions\",\n      description: \"Prepare owner-confirmed cleanup actions from same-turn grounded reads. This tool never mutates data.\",\n      schema: proposeCleanupActionsSchema,\n    },\n  ) as ChatTools[number];\n}\n\n/** Build the optional action tool from the host-provided ToolContext. */\nexport function createReporterActionTool(\n  deps: ToolContext,\n  context: ResolvedToolContext,\n  userDb: UserDatabase,\n): ChatTools[number] | null {\n  if (!deps.actionToolsEnabled || !deps.actionProposalStore) return null;\n  return createProposeCleanupActionsTool({\n    database: deps.database,\n    userDb,\n    context,\n    store: deps.actionProposalStore,\n  });\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"reporter.persona.d.ts","sourceRoot":"/","sources":["chat/reporter.persona.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9H,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAE/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,uFAAuF;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,kOAWtB,CAAC;AAIX,UAAU,oBAAoB;IAC5B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,oBAAoB,CAAC,EAAE,WAAW,CAAC,sBAAsB,CAAC,CAAC;CAC5D;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAE/E;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,oBAAoB,GAC7B,SAAS,CAkKX;AAED,iEAAiE;AACjE,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,WAAW,EACjB,kBAAkB,CAAC,EAAE,mBAAmB,GACvC,OAAO,CAAC,SAAS,CAAC,CAwBpB;AAED,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,EAAE,iBAQ9B,CAAC"}
+{"version":3,"file":"reporter.persona.d.ts","sourceRoot":"/","sources":["chat/reporter.persona.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,KAAK,SAAS,EAAE,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAE9H,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAE/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAI3D,uFAAuF;AACvF,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAEjE,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,aAAa,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,mBAAmB,kOAWtB,CAAC;AAIX,UAAU,oBAAoB;IAC5B,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,YAAY,CAAC;IACrB,oBAAoB,CAAC,EAAE,WAAW,CAAC,sBAAsB,CAAC,CAAC;CAC5D;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAE/E;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,EAClB,QAAQ,EAAE,oBAAoB,GAC7B,SAAS,CAkKX;AAED,iEAAiE;AACjE,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,WAAW,EACjB,kBAAkB,CAAC,EAAE,mBAAmB,GACvC,OAAO,CAAC,SAAS,CAAC,CA0BpB;AAED,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,EAAE,iBAQ9B,CAAC"}

package/dist/chat/reporter.persona.js

@@ -4,6 +4,7 @@ import { createChatTools } from "../shared/agent/tool.factory.js";
 import { error, resolveChatContext, success } from "../shared/agent/tool.helpers.js";
 import { focusedNetworkId, scopeFromNetworkId } from "../shared/agent/tool.scope.js";
 import { buildReporterSystemContent } from "./reporter.prompt.js";
+import { createReporterActionTool } from "./reporter.action.tools.js";
 /** Public kickoff marker used by the Agent surface to request its opening briefing. */
 export { REPORTER_BRIEFING_KICKOFF } from "./reporter.prompt.js";
 /** Stable persona id persisted for read-only Agent reporting sessions. */
@@ -179,6 +180,7 @@ export async function createReporterTools(deps, preResolvedContext) {
         networkId: explicitScope.scopeType === "network" ? explicitScope.scopeId : deps.networkId,
         sessionId: deps.sessionId,
         contactsEnabled: deps.contactsEnabled,
+        actionToolsEnabled: deps.actionToolsEnabled,
     });
     if (explicitScope.scopeType && explicitScope.scopeId) {
         resolvedContext.scopeType = explicitScope.scopeType;
@@ -186,11 +188,13 @@ export async function createReporterTools(deps, preResolvedContext) {
     }
     const userDb = deps.userDb ?? deps.createUserDatabase(deps.database, resolvedContext.userId);
     const allowed = filterReporterTools(await createChatTools(deps, resolvedContext));
-    return narrowReporterTools(allowed, {
+    const narrowed = narrowReporterTools(allowed, {
         context: resolvedContext,
         userDb,
         findPendingQuestions: deps.findPendingQuestions,
     });
+    const actionTool = createReporterActionTool(deps, resolvedContext, userDb);
+    return actionTool ? [...narrowed, actionTool] : narrowed;
 }
 /** Restricted read-only Agent reporter persona. */
 export const REPORTER_PERSONA = {

package/dist/chat/reporter.persona.js.map

@@ -1 +1 @@
-{"version":3,"file":"reporter.persona.js","sourceRoot":"/","sources":["chat/reporter.persona.ts"],"names":[],"mappings":"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","sourcesContent":["import { tool } from \"@langchain/core/tools\";\nimport { z } from \"zod\";\n\nimport { createChatTools, type ChatTools, type ResolvedToolContext, type ToolContext } from \"../shared/agent/tool.factory.js\";\nimport { error, resolveChatContext, success } from \"../shared/agent/tool.helpers.js\";\nimport type { UserDatabase } from \"../shared/interfaces/database.interface.js\";\nimport { focusedNetworkId, scopeFromNetworkId } from \"../shared/agent/tool.scope.js\";\nimport type { ChatPersonaConfig } from \"./chat.persona.js\";\nimport { buildReporterSystemContent } from \"./reporter.prompt.js\";\n\n/** Public kickoff marker used by the Agent surface to request its opening briefing. */\nexport { REPORTER_BRIEFING_KICKOFF } from \"./reporter.prompt.js\";\n\n/** Stable persona id persisted for read-only Agent reporting sessions. */\nexport const REPORTER_PERSONA_ID = \"reporter\";\n\n/**\n * Exact positive allowlist for the reporter persona. New shared tools remain\n * unavailable until they are explicitly reviewed here.\n */\nexport const REPORTER_TOOL_NAMES = [\n  \"read_intents\",\n  \"search_intents\",\n  \"read_user_contexts\",\n  \"preview_user_context\",\n  \"read_premises\",\n  \"read_networks\",\n  \"read_network_memberships\",\n  \"read_pending_questions\",\n  \"list_opportunities\",\n  \"report_agent_activity\",\n] as const;\n\nconst REPORTER_TOOL_ALLOWLIST: ReadonlySet<string> = new Set(REPORTER_TOOL_NAMES);\n\ninterface ReporterToolBoundary {\n  context: ResolvedToolContext;\n  userDb: UserDatabase;\n  findPendingQuestions?: ToolContext[\"findPendingQuestions\"];\n}\n\n/** Filters a shared registry through the reporter's positive allowlist. */\nexport function filterReporterTools<T extends { name: string }>(tools: T[]): T[] {\n  return tools.filter((candidate) => REPORTER_TOOL_ALLOWLIST.has(candidate.name));\n}\n\nfunction invokeSharedTool(sharedTool: { invoke: (input: unknown) => unknown }, input: unknown): Promise<string> {\n  return sharedTool.invoke(input) as Promise<string>;\n}\n\n/**\n * Replaces shared tools whose normal modes can enumerate other users with\n * reporter-safe, self-only read contracts. Opportunity listing is deliberately\n * aggregate-only: it never returns a counterpart name, row, or explanation.\n */\nexport function narrowReporterTools(\n  allowed: ChatTools,\n  boundary: ReporterToolBoundary,\n): ChatTools {\n  const { context, userDb } = boundary;\n\n  return allowed.map((sharedTool) => {\n    if (sharedTool.name === \"read_intents\") {\n      return tool(\n        async (query: { limit?: number; page?: number }) => {\n          const limit = query.limit ?? 100;\n          const page = query.page ?? 1;\n          const intents = await userDb.getActiveIntents();\n          const start = (page - 1) * limit;\n          return success({\n            intents: intents.slice(start, start + limit),\n            page,\n            limit,\n            total: intents.length,\n          });\n        },\n        {\n          name: \"read_intents\",\n          description: \"Read the authenticated user's own active signals only.\",\n          schema: z.object({\n            limit: z.number().int().min(1).max(100).optional(),\n            page: z.number().int().min(1).optional(),\n          }).strict(),\n        },\n      );\n    }\n\n    if (sharedTool.name === \"search_intents\") {\n      return tool(\n        async (query: { query: string; limit?: number }) => success({\n          intents: await userDb.searchOwnIntents(query.query, query.limit ?? 20),\n        }),\n        {\n          name: \"search_intents\",\n          description: \"Search the authenticated user's own active signals only.\",\n          schema: z.object({\n            query: z.string().trim().min(1),\n            limit: z.number().int().min(1).max(100).optional(),\n          }).strict(),\n        },\n      );\n    }\n\n    if (sharedTool.name === \"read_user_contexts\") {\n      return tool(\n        async () => invokeSharedTool(sharedTool, {}),\n        {\n          name: \"read_user_contexts\",\n          description: \"Read the authenticated user's own identity and global context only.\",\n          schema: z.object({}).strict(),\n        },\n      );\n    }\n\n    if (sharedTool.name === \"read_premises\") {\n      return tool(\n        async (query: { includeRetracted?: boolean }) => invokeSharedTool(sharedTool, {\n          includeRetracted: query.includeRetracted ?? false,\n          userId: context.userId,\n        }),\n        {\n          name: \"read_premises\",\n          description: \"Read the authenticated user's own premises only.\",\n          schema: z.object({ includeRetracted: z.boolean().optional() }).strict(),\n        },\n      );\n    }\n\n    if (sharedTool.name === \"read_network_memberships\") {\n      return tool(\n        async () => invokeSharedTool(sharedTool, {}),\n        {\n          name: \"read_network_memberships\",\n          description: \"Read the authenticated user's own network memberships only.\",\n          schema: z.object({}).strict(),\n        },\n      );\n    }\n\n    if (sharedTool.name === \"read_networks\") {\n      return tool(\n        async () => invokeSharedTool(sharedTool, { userId: context.userId }),\n        {\n          name: \"read_networks\",\n          description: \"Read networks available to the authenticated user.\",\n          schema: z.object({}).strict(),\n        },\n      );\n    }\n\n    if (sharedTool.name === \"read_pending_questions\") {\n      return tool(\n        async (query: { limit?: number }) => {\n          if (!boundary.findPendingQuestions) return error(\"Question lookup is not available.\");\n          const questions = await boundary.findPendingQuestions(context.userId, {\n            modes: [\"enrichment\", \"intent\", \"discovery\"],\n            limit: query.limit ?? 10,\n          });\n          return success({ questions: questions.slice(0, query.limit ?? 10) });\n        },\n        {\n          name: \"read_pending_questions\",\n          description: \"Read the user's own non-negotiation pending questions; answering is unavailable here.\",\n          schema: z.object({ limit: z.number().int().min(1).max(10).optional() }).strict(),\n        },\n      );\n    }\n\n    if (sharedTool.name === \"list_opportunities\") {\n      return tool(\n        async (query: { networkId?: string }) => {\n          const scopedNetworkId = focusedNetworkId(context);\n          if (scopedNetworkId && query.networkId && query.networkId !== scopedNetworkId) {\n            return error(\"This chat is scoped to a different network.\");\n          }\n          const activeIntents = await userDb.getActiveIntents();\n          const intentById = new Map(activeIntents.map((intent) => [intent.id, intent]));\n          const opportunities = await userDb.getOpportunitiesForUser({\n            ...(query.networkId || scopedNetworkId ? { networkId: query.networkId || scopedNetworkId } : {}),\n            statuses: [\"draft\", \"pending\", \"latent\"],\n            limit: 100,\n          });\n          const counts = new Map<string, { intentId: string; title: string; count: number }>();\n          const seen = new Set<string>();\n          for (const opportunity of opportunities) {\n            const ownIntentIds = new Set(\n              opportunity.actors\n                .filter((actor) => actor.userId === context.userId && actor.intent && intentById.has(actor.intent))\n                .map((actor) => actor.intent as string),\n            );\n            if (ownIntentIds.size === 0) continue;\n            seen.add(opportunity.id);\n            for (const intentId of ownIntentIds) {\n              const intent = intentById.get(intentId);\n              if (!intent) continue;\n              const existing = counts.get(intentId) ?? {\n                intentId,\n                title: intent.summary?.trim() || intent.payload,\n                count: 0,\n              };\n              existing.count += 1;\n              counts.set(intentId, existing);\n            }\n          }\n          return success({\n            found: seen.size > 0,\n            count: seen.size,\n            bySignal: [...counts.values()],\n          });\n        },\n        {\n          name: \"list_opportunities\",\n          description: \"Report current opportunity counts by the user's own signal, without counterpart identities or rows.\",\n          schema: z.object({ networkId: z.string().uuid().optional() }).strict(),\n        },\n      );\n    }\n\n    return sharedTool;\n  }) as ChatTools;\n}\n\n/** Creates the reporter's context-bound, allowlisted toolset. */\nexport async function createReporterTools(\n  deps: ToolContext,\n  preResolvedContext?: ResolvedToolContext,\n): Promise<ChatTools> {\n  const explicitScope = deps.scopeType && deps.scopeId\n    ? { scopeType: deps.scopeType, scopeId: deps.scopeId }\n    : scopeFromNetworkId(deps.networkId);\n  const resolvedContext = preResolvedContext ?? await resolveChatContext({\n    database: deps.database,\n    userId: deps.userId,\n    networkId: explicitScope.scopeType === \"network\" ? explicitScope.scopeId : deps.networkId,\n    sessionId: deps.sessionId,\n    contactsEnabled: deps.contactsEnabled,\n  });\n  if (explicitScope.scopeType && explicitScope.scopeId) {\n    resolvedContext.scopeType = explicitScope.scopeType;\n    resolvedContext.scopeId = explicitScope.scopeId;\n  }\n\n  const userDb = deps.userDb ?? deps.createUserDatabase(deps.database, resolvedContext.userId);\n  const allowed = filterReporterTools(await createChatTools(deps, resolvedContext)) as ChatTools;\n\n  return narrowReporterTools(allowed, {\n    context: resolvedContext,\n    userDb,\n    findPendingQuestions: deps.findPendingQuestions,\n  });\n}\n\n/** Restricted read-only Agent reporter persona. */\nexport const REPORTER_PERSONA: ChatPersonaConfig = {\n  id: REPORTER_PERSONA_ID,\n  buildSystemContent: (ctx, iterCtx) => buildReporterSystemContent(ctx, iterCtx),\n  createTools: (deps, preResolvedContext) => createReporterTools(deps, preResolvedContext),\n  loopBehaviors: {\n    createIntentCallback: false,\n    hallucinationRecovery: false,\n  },\n};\n"]}
+{"version":3,"file":"reporter.persona.js","sourceRoot":"/","sources":["chat/reporter.persona.ts"],"names":[],"mappings":"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","sourcesContent":["import { tool } from \"@langchain/core/tools\";\nimport { z } from \"zod\";\n\nimport { createChatTools, type ChatTools, type ResolvedToolContext, type ToolContext } from \"../shared/agent/tool.factory.js\";\nimport { error, resolveChatContext, success } from \"../shared/agent/tool.helpers.js\";\nimport type { UserDatabase } from \"../shared/interfaces/database.interface.js\";\nimport { focusedNetworkId, scopeFromNetworkId } from \"../shared/agent/tool.scope.js\";\nimport type { ChatPersonaConfig } from \"./chat.persona.js\";\nimport { buildReporterSystemContent } from \"./reporter.prompt.js\";\nimport { createReporterActionTool } from \"./reporter.action.tools.js\";\n\n/** Public kickoff marker used by the Agent surface to request its opening briefing. */\nexport { REPORTER_BRIEFING_KICKOFF } from \"./reporter.prompt.js\";\n\n/** Stable persona id persisted for read-only Agent reporting sessions. */\nexport const REPORTER_PERSONA_ID = \"reporter\";\n\n/**\n * Exact positive allowlist for the reporter persona. New shared tools remain\n * unavailable until they are explicitly reviewed here.\n */\nexport const REPORTER_TOOL_NAMES = [\n  \"read_intents\",\n  \"search_intents\",\n  \"read_user_contexts\",\n  \"preview_user_context\",\n  \"read_premises\",\n  \"read_networks\",\n  \"read_network_memberships\",\n  \"read_pending_questions\",\n  \"list_opportunities\",\n  \"report_agent_activity\",\n] as const;\n\nconst REPORTER_TOOL_ALLOWLIST: ReadonlySet<string> = new Set(REPORTER_TOOL_NAMES);\n\ninterface ReporterToolBoundary {\n  context: ResolvedToolContext;\n  userDb: UserDatabase;\n  findPendingQuestions?: ToolContext[\"findPendingQuestions\"];\n}\n\n/** Filters a shared registry through the reporter's positive allowlist. */\nexport function filterReporterTools<T extends { name: string }>(tools: T[]): T[] {\n  return tools.filter((candidate) => REPORTER_TOOL_ALLOWLIST.has(candidate.name));\n}\n\nfunction invokeSharedTool(sharedTool: { invoke: (input: unknown) => unknown }, input: unknown): Promise<string> {\n  return sharedTool.invoke(input) as Promise<string>;\n}\n\n/**\n * Replaces shared tools whose normal modes can enumerate other users with\n * reporter-safe, self-only read contracts. Opportunity listing is deliberately\n * aggregate-only: it never returns a counterpart name, row, or explanation.\n */\nexport function narrowReporterTools(\n  allowed: ChatTools,\n  boundary: ReporterToolBoundary,\n): ChatTools {\n  const { context, userDb } = boundary;\n\n  return allowed.map((sharedTool) => {\n    if (sharedTool.name === \"read_intents\") {\n      return tool(\n        async (query: { limit?: number; page?: number }) => {\n          const limit = query.limit ?? 100;\n          const page = query.page ?? 1;\n          const intents = await userDb.getActiveIntents();\n          const start = (page - 1) * limit;\n          return success({\n            intents: intents.slice(start, start + limit),\n            page,\n            limit,\n            total: intents.length,\n          });\n        },\n        {\n          name: \"read_intents\",\n          description: \"Read the authenticated user's own active signals only.\",\n          schema: z.object({\n            limit: z.number().int().min(1).max(100).optional(),\n            page: z.number().int().min(1).optional(),\n          }).strict(),\n        },\n      );\n    }\n\n    if (sharedTool.name === \"search_intents\") {\n      return tool(\n        async (query: { query: string; limit?: number }) => success({\n          intents: await userDb.searchOwnIntents(query.query, query.limit ?? 20),\n        }),\n        {\n          name: \"search_intents\",\n          description: \"Search the authenticated user's own active signals only.\",\n          schema: z.object({\n            query: z.string().trim().min(1),\n            limit: z.number().int().min(1).max(100).optional(),\n          }).strict(),\n        },\n      );\n    }\n\n    if (sharedTool.name === \"read_user_contexts\") {\n      return tool(\n        async () => invokeSharedTool(sharedTool, {}),\n        {\n          name: \"read_user_contexts\",\n          description: \"Read the authenticated user's own identity and global context only.\",\n          schema: z.object({}).strict(),\n        },\n      );\n    }\n\n    if (sharedTool.name === \"read_premises\") {\n      return tool(\n        async (query: { includeRetracted?: boolean }) => invokeSharedTool(sharedTool, {\n          includeRetracted: query.includeRetracted ?? false,\n          userId: context.userId,\n        }),\n        {\n          name: \"read_premises\",\n          description: \"Read the authenticated user's own premises only.\",\n          schema: z.object({ includeRetracted: z.boolean().optional() }).strict(),\n        },\n      );\n    }\n\n    if (sharedTool.name === \"read_network_memberships\") {\n      return tool(\n        async () => invokeSharedTool(sharedTool, {}),\n        {\n          name: \"read_network_memberships\",\n          description: \"Read the authenticated user's own network memberships only.\",\n          schema: z.object({}).strict(),\n        },\n      );\n    }\n\n    if (sharedTool.name === \"read_networks\") {\n      return tool(\n        async () => invokeSharedTool(sharedTool, { userId: context.userId }),\n        {\n          name: \"read_networks\",\n          description: \"Read networks available to the authenticated user.\",\n          schema: z.object({}).strict(),\n        },\n      );\n    }\n\n    if (sharedTool.name === \"read_pending_questions\") {\n      return tool(\n        async (query: { limit?: number }) => {\n          if (!boundary.findPendingQuestions) return error(\"Question lookup is not available.\");\n          const questions = await boundary.findPendingQuestions(context.userId, {\n            modes: [\"enrichment\", \"intent\", \"discovery\"],\n            limit: query.limit ?? 10,\n          });\n          return success({ questions: questions.slice(0, query.limit ?? 10) });\n        },\n        {\n          name: \"read_pending_questions\",\n          description: \"Read the user's own non-negotiation pending questions; answering is unavailable here.\",\n          schema: z.object({ limit: z.number().int().min(1).max(10).optional() }).strict(),\n        },\n      );\n    }\n\n    if (sharedTool.name === \"list_opportunities\") {\n      return tool(\n        async (query: { networkId?: string }) => {\n          const scopedNetworkId = focusedNetworkId(context);\n          if (scopedNetworkId && query.networkId && query.networkId !== scopedNetworkId) {\n            return error(\"This chat is scoped to a different network.\");\n          }\n          const activeIntents = await userDb.getActiveIntents();\n          const intentById = new Map(activeIntents.map((intent) => [intent.id, intent]));\n          const opportunities = await userDb.getOpportunitiesForUser({\n            ...(query.networkId || scopedNetworkId ? { networkId: query.networkId || scopedNetworkId } : {}),\n            statuses: [\"draft\", \"pending\", \"latent\"],\n            limit: 100,\n          });\n          const counts = new Map<string, { intentId: string; title: string; count: number }>();\n          const seen = new Set<string>();\n          for (const opportunity of opportunities) {\n            const ownIntentIds = new Set(\n              opportunity.actors\n                .filter((actor) => actor.userId === context.userId && actor.intent && intentById.has(actor.intent))\n                .map((actor) => actor.intent as string),\n            );\n            if (ownIntentIds.size === 0) continue;\n            seen.add(opportunity.id);\n            for (const intentId of ownIntentIds) {\n              const intent = intentById.get(intentId);\n              if (!intent) continue;\n              const existing = counts.get(intentId) ?? {\n                intentId,\n                title: intent.summary?.trim() || intent.payload,\n                count: 0,\n              };\n              existing.count += 1;\n              counts.set(intentId, existing);\n            }\n          }\n          return success({\n            found: seen.size > 0,\n            count: seen.size,\n            bySignal: [...counts.values()],\n          });\n        },\n        {\n          name: \"list_opportunities\",\n          description: \"Report current opportunity counts by the user's own signal, without counterpart identities or rows.\",\n          schema: z.object({ networkId: z.string().uuid().optional() }).strict(),\n        },\n      );\n    }\n\n    return sharedTool;\n  }) as ChatTools;\n}\n\n/** Creates the reporter's context-bound, allowlisted toolset. */\nexport async function createReporterTools(\n  deps: ToolContext,\n  preResolvedContext?: ResolvedToolContext,\n): Promise<ChatTools> {\n  const explicitScope = deps.scopeType && deps.scopeId\n    ? { scopeType: deps.scopeType, scopeId: deps.scopeId }\n    : scopeFromNetworkId(deps.networkId);\n  const resolvedContext = preResolvedContext ?? await resolveChatContext({\n    database: deps.database,\n    userId: deps.userId,\n    networkId: explicitScope.scopeType === \"network\" ? explicitScope.scopeId : deps.networkId,\n    sessionId: deps.sessionId,\n    contactsEnabled: deps.contactsEnabled,\n    actionToolsEnabled: deps.actionToolsEnabled,\n  });\n  if (explicitScope.scopeType && explicitScope.scopeId) {\n    resolvedContext.scopeType = explicitScope.scopeType;\n    resolvedContext.scopeId = explicitScope.scopeId;\n  }\n\n  const userDb = deps.userDb ?? deps.createUserDatabase(deps.database, resolvedContext.userId);\n  const allowed = filterReporterTools(await createChatTools(deps, resolvedContext)) as ChatTools;\n  const narrowed = narrowReporterTools(allowed, {\n    context: resolvedContext,\n    userDb,\n    findPendingQuestions: deps.findPendingQuestions,\n  });\n  const actionTool = createReporterActionTool(deps, resolvedContext, userDb);\n  return actionTool ? [...narrowed, actionTool] as ChatTools : narrowed;\n}\n\n/** Restricted read-only Agent reporter persona. */\nexport const REPORTER_PERSONA: ChatPersonaConfig = {\n  id: REPORTER_PERSONA_ID,\n  buildSystemContent: (ctx, iterCtx) => buildReporterSystemContent(ctx, iterCtx),\n  createTools: (deps, preResolvedContext) => createReporterTools(deps, preResolvedContext),\n  loopBehaviors: {\n    createIntentCallback: false,\n    hallucinationRecovery: false,\n  },\n};\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"reporter.prompt.d.ts","sourceRoot":"/","sources":["chat/reporter.prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,+EAA+E;AAC/E,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AAErE;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAYnE;AAgBD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,mBAAmB,EACxB,OAAO,CAAC,EAAE,gBAAgB,GACzB,MAAM,CA8DR"}
+{"version":3,"file":"reporter.prompt.d.ts","sourceRoot":"/","sources":["chat/reporter.prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,+EAA+E;AAC/E,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AAErE;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAYnE;AAgBD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,mBAAmB,EACxB,OAAO,CAAC,EAAE,gBAAgB,GACzB,MAAM,CA6ER"}

package/dist/chat/reporter.prompt.js

@@ -50,15 +50,30 @@ export function buildReporterSystemContent(ctx, iterCtx) {
         title: network.networkTitle,
         isPersonal: network.isPersonal,
     })), null, 2);
+    const roleGuidance = ctx.actionToolsEnabled
+        ? "Your role is to report what the user's Index agent has done and what the user's own signals currently communicate. You may prepare a cleanup-action request from grounded same-turn reads, but you never change anything in chat."
+        : "Your role is to report what the user's Index agent has done and what the user's own signals currently communicate. You observe; you never change anything. Suggestions such as pausing or merging a signal are recommendations for the user to carry out through existing product UI, never actions for this persona.";
+    const mutationRule = ctx.actionToolsEnabled
+        ? "- Never mutate data in chat. You may call propose_cleanup_actions only after same-turn owner-scoped reads; it creates a REQUEST block and never executes an action. The owner must confirm through the product UI."
+        : "- Never create, update, delete, confirm, answer, remember, forget, assign, discover, negotiate, scrape, or otherwise mutate data. Do not ask the user a question through a tool.";
+    const actionGuidance = ctx.actionToolsEnabled ? `
+
+## Cleanup-action requests
+- You may propose only retract_premise, narrow_signal, and pause_signal actions grounded in read results from this same turn.
+- Resolve references through owner-scoped read tools and pass exact full UUIDs only; never use suffixes, guesses, or IDs from another user.
+- pause_signal requires non-empty evidence recorded from this turn, such as zero live opportunities plus the owner's statement.
+- The proposal block is a REQUEST for owner confirmation. Never narrate an action as completed and never mutate inside chat.
+- Do not propose actions for counterparties or expose counterparty identity.
+` : "";
     return `You are Agent, the user's private read-only activity reporter for ${ctx.userName}.
 
-Your role is to report what the user's Index agent has done and what the user's own signals currently communicate. You observe; you never change anything. Suggestions such as pausing or merging a signal are recommendations for the user to carry out through existing product UI, never actions for this persona.
+${roleGuidance}${actionGuidance}
 
 ## Hard rules
 - Every factual claim, number, status, or trend must come from a tool result in the current turn. Never invent, estimate, or reuse an unverified metric.
 - Use report_agent_activity for activity counts and read_intents/read_user_contexts/read_premises/read_networks/read_network_memberships/read_pending_questions for the underlying current state.
 - Counterparties are identity-free aggregate data only: never reveal names, IDs, transcripts, message text, or per-counterparty rows. Do not infer what another person thinks from a match or negotiation.
-- Never create, update, delete, confirm, answer, remember, forget, assign, discover, negotiate, scrape, or otherwise mutate data. Do not ask the user a question through a tool.
+${mutationRule}
 - Do not write observed behavior back as a preference or premise. The user decides whether to act on a suggestion.
 - If opportunity information is relevant, use only the restricted list_opportunities result or report_agent_activity result. Do not expose raw evaluator reasoning, matchReason, or internal JSON. Any opportunity copy must be presenter-backed; this persona's list view is aggregate-only.
 - Be transparent about missing data and the reporting window. Keep the response concise, calm, and useful without hype.
@@ -76,7 +91,7 @@ Be ready to answer:
 - Own community context: read_networks, read_network_memberships.
 - Own pending-question reads: read_pending_questions (never answer them).
 - Aggregate activity reporting: report_agent_activity.
-- Aggregate current opportunity reporting: list_opportunities (no counterpart identities or rows).
+- Aggregate current opportunity reporting: list_opportunities (no counterpart identities or rows).${ctx.actionToolsEnabled ? "\n- Cleanup-action requests: propose_cleanup_actions (request only; owner confirmation is required)." : ""}
 
 ## Session identity (preloaded)
 - User: ${ctx.userName} (${ctx.userEmail}), id: ${ctx.userId}

package/dist/chat/reporter.prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"reporter.prompt.js","sourceRoot":"/","sources":["chat/reporter.prompt.ts"],"names":[],"mappings":"AAGA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,yBAAyB,GAAG,2BAA2B,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,MAAM,UAAU,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC,iBAAiB,EAAE;SACnD,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAE9B,OAAO,IAAI,GAAG,CAAC;QACb,yBAAyB;QACzB,mBAAmB;QACnB,mBAAmB;QACnB,gBAAgB;KACjB,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,qBAAqB,CAAC,OAA0B;IACvD,IAAI,CAAC,yBAAyB,CAAC,OAAO,EAAE,cAAc,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnE,OAAO;;;;;;;;0JAQiJ,CAAC;AAC3J,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CACxC,GAAwB,EACxB,OAA0B;IAE1B,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,cAAc,GAAG,GAAG,CAAC,WAAW;QACpC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC,CAAC,MAAM,CAAC;IACX,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CACtC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjC,EAAE,EAAE,OAAO,CAAC,SAAS;QACrB,KAAK,EAAE,OAAO,CAAC,YAAY;QAC3B,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC,CAAC,EACH,IAAI,EACJ,CAAC,CACF,CAAC;IAEF,OAAO,qEAAqE,GAAG,CAAC,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA6BhF,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,SAAS,UAAU,GAAG,CAAC,MAAM;;;;EAI1D,WAAW;;;;;EAKX,cAAc;;;;;EAKd,iBAAiB;;;sMAGmL,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;AACvO,CAAC","sourcesContent":["import type { ResolvedToolContext } from \"../shared/agent/tool.factory.js\";\nimport type { IterationContext } from \"./chat.prompt.modules.js\";\n\n/** Stable marker used by the Agent surface to request its opening briefing. */\nexport const REPORTER_BRIEFING_KICKOFF = \"reporter-briefing-kickoff\";\n\n/**\n * Recognizes the explicit opening briefing marker without putting ordinary\n * reporter conversations into briefing mode accidentally.\n *\n * @param message - Latest user message in the current turn\n * @returns Whether this turn is the Agent-surface briefing kickoff\n */\nexport function isReporterBriefingKickoff(message?: string): boolean {\n  const normalized = message?.trim().toLocaleLowerCase()\n    .replace(/[–—]/g, \"-\")\n    .replace(/^_+|_+$/g, \"\");\n  if (!normalized) return false;\n\n  return new Set([\n    REPORTER_BRIEFING_KICKOFF,\n    \"reporter-briefing\",\n    \"reporter briefing\",\n    \"agent briefing\",\n  ]).has(normalized);\n}\n\nfunction buildBriefingGuidance(iterCtx?: IterationContext): string {\n  if (!isReporterBriefingKickoff(iterCtx?.currentMessage)) return \"\";\n\n  return `\n\n## Opening briefing\nThis is the Agent-surface briefing kickoff. Call report_agent_activity first with the default window, then call the read tools needed to ground the four transparency asks below. Present one concise briefing covering:\n1. summarize all my signals;\n2. what did you do today?;\n3. how do I look to others?;\n4. what should I sharpen?\nDo not claim a metric unless it appears in a tool result from this turn. If a section has no grounded data, say that plainly rather than filling the gap.`;\n}\n\n/**\n * Builds the read-only reporter persona prompt.\n *\n * @param ctx - Resolved authenticated user context\n * @param iterCtx - Current agent-loop context used for briefing kickoff\n * @returns Complete reporter system content\n */\nexport function buildReporterSystemContent(\n  ctx: ResolvedToolContext,\n  iterCtx?: IterationContext,\n): string {\n  const userContext = JSON.stringify(ctx.user, null, 2);\n  const profileContext = ctx.userProfile\n    ? JSON.stringify(ctx.userProfile, null, 2)\n    : \"null\";\n  const membershipContext = JSON.stringify(\n    ctx.userNetworks.map((network) => ({\n      id: network.networkId,\n      title: network.networkTitle,\n      isPersonal: network.isPersonal,\n    })),\n    null,\n    2,\n  );\n\n  return `You are Agent, the user's private read-only activity reporter for ${ctx.userName}.\n\nYour role is to report what the user's Index agent has done and what the user's own signals currently communicate. You observe; you never change anything. Suggestions such as pausing or merging a signal are recommendations for the user to carry out through existing product UI, never actions for this persona.\n\n## Hard rules\n- Every factual claim, number, status, or trend must come from a tool result in the current turn. Never invent, estimate, or reuse an unverified metric.\n- Use report_agent_activity for activity counts and read_intents/read_user_contexts/read_premises/read_networks/read_network_memberships/read_pending_questions for the underlying current state.\n- Counterparties are identity-free aggregate data only: never reveal names, IDs, transcripts, message text, or per-counterparty rows. Do not infer what another person thinks from a match or negotiation.\n- Never create, update, delete, confirm, answer, remember, forget, assign, discover, negotiate, scrape, or otherwise mutate data. Do not ask the user a question through a tool.\n- Do not write observed behavior back as a preference or premise. The user decides whether to act on a suggestion.\n- If opportunity information is relevant, use only the restricted list_opportunities result or report_agent_activity result. Do not expose raw evaluator reasoning, matchReason, or internal JSON. Any opportunity copy must be presenter-backed; this persona's list view is aggregate-only.\n- Be transparent about missing data and the reporting window. Keep the response concise, calm, and useful without hype.\n\n## Four transparency asks\nBe ready to answer:\n- “summarize all my signals” — read the user's own signals and describe their current themes without inventing a synthesis.\n- “what did you do today?” — report only grounded activity counts from the requested window.\n- “how do I look to others?” — describe only the user's own stored context and signals; do not claim access to private counterparty opinions.\n- “what should I sharpen?” — suggest possible signal/context improvements based on observed gaps in the returned data, clearly label them as suggestions, and point the user to existing UI. Never apply them.\n\n## Allowed capabilities\n- Own signal reads: read_intents, search_intents.\n- Own context reads: read_user_contexts, preview_user_context, read_premises.\n- Own community context: read_networks, read_network_memberships.\n- Own pending-question reads: read_pending_questions (never answer them).\n- Aggregate activity reporting: report_agent_activity.\n- Aggregate current opportunity reporting: list_opportunities (no counterpart identities or rows).\n\n## Session identity (preloaded)\n- User: ${ctx.userName} (${ctx.userEmail}), id: ${ctx.userId}\n\n### User record\n\\`\\`\\`json\n${userContext}\n\\`\\`\\`\n\n### User context\n\\`\\`\\`json\n${profileContext}\n\\`\\`\\`\n\n### Current memberships\n\\`\\`\\`json\n${membershipContext}\n\\`\\`\\`\n\nOnly the identity, context, and membership metadata above are preloaded. Signals, premises, questions, and activity are not preloaded: call the appropriate read/report tool before describing them.${buildBriefingGuidance(iterCtx)}`;\n}\n"]}
+{"version":3,"file":"reporter.prompt.js","sourceRoot":"/","sources":["chat/reporter.prompt.ts"],"names":[],"mappings":"AAGA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,yBAAyB,GAAG,2BAA2B,CAAC;AAErE;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,MAAM,UAAU,GAAG,OAAO,EAAE,IAAI,EAAE,CAAC,iBAAiB,EAAE;SACnD,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAE9B,OAAO,IAAI,GAAG,CAAC;QACb,yBAAyB;QACzB,mBAAmB;QACnB,mBAAmB;QACnB,gBAAgB;KACjB,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,qBAAqB,CAAC,OAA0B;IACvD,IAAI,CAAC,yBAAyB,CAAC,OAAO,EAAE,cAAc,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnE,OAAO;;;;;;;;0JAQiJ,CAAC;AAC3J,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CACxC,GAAwB,EACxB,OAA0B;IAE1B,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,cAAc,GAAG,GAAG,CAAC,WAAW;QACpC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC,CAAC,MAAM,CAAC;IACX,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CACtC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjC,EAAE,EAAE,OAAO,CAAC,SAAS;QACrB,KAAK,EAAE,OAAO,CAAC,YAAY;QAC3B,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC,CAAC,EACH,IAAI,EACJ,CAAC,CACF,CAAC;IACF,MAAM,YAAY,GAAG,GAAG,CAAC,kBAAkB;QACzC,CAAC,CAAC,mOAAmO;QACrO,CAAC,CAAC,uTAAuT,CAAC;IAC5T,MAAM,YAAY,GAAG,GAAG,CAAC,kBAAkB;QACzC,CAAC,CAAC,oNAAoN;QACtN,CAAC,CAAC,kLAAkL,CAAC;IACvL,MAAM,cAAc,GAAG,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC;;;;;;;;CAQjD,CAAC,CAAC,CAAC,EAAE,CAAC;IAEL,OAAO,qEAAqE,GAAG,CAAC,QAAQ;;EAExF,YAAY,GAAG,cAAc;;;;;;EAM7B,YAAY;;;;;;;;;;;;;;;;;;oGAkBsF,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,sGAAsG,CAAC,CAAC,CAAC,EAAE;;;UAG9N,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,SAAS,UAAU,GAAG,CAAC,MAAM;;;;EAI1D,WAAW;;;;;EAKX,cAAc;;;;;EAKd,iBAAiB;;;sMAGmL,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;AACvO,CAAC","sourcesContent":["import type { ResolvedToolContext } from \"../shared/agent/tool.factory.js\";\nimport type { IterationContext } from \"./chat.prompt.modules.js\";\n\n/** Stable marker used by the Agent surface to request its opening briefing. */\nexport const REPORTER_BRIEFING_KICKOFF = \"reporter-briefing-kickoff\";\n\n/**\n * Recognizes the explicit opening briefing marker without putting ordinary\n * reporter conversations into briefing mode accidentally.\n *\n * @param message - Latest user message in the current turn\n * @returns Whether this turn is the Agent-surface briefing kickoff\n */\nexport function isReporterBriefingKickoff(message?: string): boolean {\n  const normalized = message?.trim().toLocaleLowerCase()\n    .replace(/[–—]/g, \"-\")\n    .replace(/^_+|_+$/g, \"\");\n  if (!normalized) return false;\n\n  return new Set([\n    REPORTER_BRIEFING_KICKOFF,\n    \"reporter-briefing\",\n    \"reporter briefing\",\n    \"agent briefing\",\n  ]).has(normalized);\n}\n\nfunction buildBriefingGuidance(iterCtx?: IterationContext): string {\n  if (!isReporterBriefingKickoff(iterCtx?.currentMessage)) return \"\";\n\n  return `\n\n## Opening briefing\nThis is the Agent-surface briefing kickoff. Call report_agent_activity first with the default window, then call the read tools needed to ground the four transparency asks below. Present one concise briefing covering:\n1. summarize all my signals;\n2. what did you do today?;\n3. how do I look to others?;\n4. what should I sharpen?\nDo not claim a metric unless it appears in a tool result from this turn. If a section has no grounded data, say that plainly rather than filling the gap.`;\n}\n\n/**\n * Builds the read-only reporter persona prompt.\n *\n * @param ctx - Resolved authenticated user context\n * @param iterCtx - Current agent-loop context used for briefing kickoff\n * @returns Complete reporter system content\n */\nexport function buildReporterSystemContent(\n  ctx: ResolvedToolContext,\n  iterCtx?: IterationContext,\n): string {\n  const userContext = JSON.stringify(ctx.user, null, 2);\n  const profileContext = ctx.userProfile\n    ? JSON.stringify(ctx.userProfile, null, 2)\n    : \"null\";\n  const membershipContext = JSON.stringify(\n    ctx.userNetworks.map((network) => ({\n      id: network.networkId,\n      title: network.networkTitle,\n      isPersonal: network.isPersonal,\n    })),\n    null,\n    2,\n  );\n  const roleGuidance = ctx.actionToolsEnabled\n    ? \"Your role is to report what the user's Index agent has done and what the user's own signals currently communicate. You may prepare a cleanup-action request from grounded same-turn reads, but you never change anything in chat.\"\n    : \"Your role is to report what the user's Index agent has done and what the user's own signals currently communicate. You observe; you never change anything. Suggestions such as pausing or merging a signal are recommendations for the user to carry out through existing product UI, never actions for this persona.\";\n  const mutationRule = ctx.actionToolsEnabled\n    ? \"- Never mutate data in chat. You may call propose_cleanup_actions only after same-turn owner-scoped reads; it creates a REQUEST block and never executes an action. The owner must confirm through the product UI.\"\n    : \"- Never create, update, delete, confirm, answer, remember, forget, assign, discover, negotiate, scrape, or otherwise mutate data. Do not ask the user a question through a tool.\";\n  const actionGuidance = ctx.actionToolsEnabled ? `\n\n## Cleanup-action requests\n- You may propose only retract_premise, narrow_signal, and pause_signal actions grounded in read results from this same turn.\n- Resolve references through owner-scoped read tools and pass exact full UUIDs only; never use suffixes, guesses, or IDs from another user.\n- pause_signal requires non-empty evidence recorded from this turn, such as zero live opportunities plus the owner's statement.\n- The proposal block is a REQUEST for owner confirmation. Never narrate an action as completed and never mutate inside chat.\n- Do not propose actions for counterparties or expose counterparty identity.\n` : \"\";\n\n  return `You are Agent, the user's private read-only activity reporter for ${ctx.userName}.\n\n${roleGuidance}${actionGuidance}\n\n## Hard rules\n- Every factual claim, number, status, or trend must come from a tool result in the current turn. Never invent, estimate, or reuse an unverified metric.\n- Use report_agent_activity for activity counts and read_intents/read_user_contexts/read_premises/read_networks/read_network_memberships/read_pending_questions for the underlying current state.\n- Counterparties are identity-free aggregate data only: never reveal names, IDs, transcripts, message text, or per-counterparty rows. Do not infer what another person thinks from a match or negotiation.\n${mutationRule}\n- Do not write observed behavior back as a preference or premise. The user decides whether to act on a suggestion.\n- If opportunity information is relevant, use only the restricted list_opportunities result or report_agent_activity result. Do not expose raw evaluator reasoning, matchReason, or internal JSON. Any opportunity copy must be presenter-backed; this persona's list view is aggregate-only.\n- Be transparent about missing data and the reporting window. Keep the response concise, calm, and useful without hype.\n\n## Four transparency asks\nBe ready to answer:\n- “summarize all my signals” — read the user's own signals and describe their current themes without inventing a synthesis.\n- “what did you do today?” — report only grounded activity counts from the requested window.\n- “how do I look to others?” — describe only the user's own stored context and signals; do not claim access to private counterparty opinions.\n- “what should I sharpen?” — suggest possible signal/context improvements based on observed gaps in the returned data, clearly label them as suggestions, and point the user to existing UI. Never apply them.\n\n## Allowed capabilities\n- Own signal reads: read_intents, search_intents.\n- Own context reads: read_user_contexts, preview_user_context, read_premises.\n- Own community context: read_networks, read_network_memberships.\n- Own pending-question reads: read_pending_questions (never answer them).\n- Aggregate activity reporting: report_agent_activity.\n- Aggregate current opportunity reporting: list_opportunities (no counterpart identities or rows).${ctx.actionToolsEnabled ? \"\\n- Cleanup-action requests: propose_cleanup_actions (request only; owner confirmation is required).\" : \"\"}\n\n## Session identity (preloaded)\n- User: ${ctx.userName} (${ctx.userEmail}), id: ${ctx.userId}\n\n### User record\n\\`\\`\\`json\n${userContext}\n\\`\\`\\`\n\n### User context\n\\`\\`\\`json\n${profileContext}\n\\`\\`\\`\n\n### Current memberships\n\\`\\`\\`json\n${membershipContext}\n\\`\\`\\`\n\nOnly the identity, context, and membership metadata above are preloaded. Signals, premises, questions, and activity are not preloaded: call the appropriate read/report tool before describing them.${buildBriefingGuidance(iterCtx)}`;\n}\n"]}

package/dist/shared/agent/tool.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.factory.d.ts","sourceRoot":"/","sources":["shared/agent/tool.factory.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,mBAAmB,EAAmE,MAAM,mBAAmB,CAAC;AAiBhJ,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACxF,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAQlD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,WAAW,EACjB,kBAAkB,CAAC,EAAE,mBAAmB,kBAiOzC;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC"}
+{"version":3,"file":"tool.factory.d.ts","sourceRoot":"/","sources":["shared/agent/tool.factory.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,mBAAmB,EAAmE,MAAM,mBAAmB,CAAC;AAiBhJ,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACxF,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAQlD;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,WAAW,EACjB,kBAAkB,CAAC,EAAE,mBAAmB,kBAkOzC;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"tool.factory.js","sourceRoot":"/","sources":["shared/agent/tool.factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAG7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,6BAA6B,EAAE,MAAM,8CAA8C,CAAC;AAC7F,OAAO,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAIrE,OAAO,EAA6D,kBAAkB,EAAE,KAAK,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAChJ,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAMrF,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;AAE3C,kFAAkF;AAClF,eAAe;AACf,kFAAkF;AAElF;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAiB,EACjB,kBAAwC;IAExC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAE7C,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO;QAClD,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE;QACtD,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEvC,8EAA8E;IAC9E,6EAA6E;IAC7E,uEAAuE;IACvE,MAAM,eAAe,GACnB,kBAAkB;QAClB,CAAC,MAAM,kBAAkB,CAAC;YACxB,QAAQ;YACR,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,aAAa,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS;YACzF,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,eAAe,EAAE,IAAI,CAAC,eAAe;SACtC,CAAC,CAAC,CAAC;IAEN,IAAI,CAAC,kBAAkB,IAAI,aAAa,CAAC,SAAS,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;QAC5E,eAAe,CAAC,SAAS,GAAG,aAAa,CAAC,SAAS,CAAC;QACpD,eAAe,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC;IAClD,CAAC;IAED,MAAM,iBAAiB,GAAG,uBAAuB,CAAC;QAChD,WAAW,EAAE,eAAe,CAAC,YAAY;QACzC,GAAG,CAAC,eAAe,CAAC,SAAS,IAAI,eAAe,CAAC,OAAO;YACtD,CAAC,CAAC,EAAE,SAAS,EAAE,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE;YAC5E,CAAC,CAAC,EAAE,CAAC;KACR,CAAC,CAAC;IAEH,8EAA8E;IAC9E;;;OAGG;IACH,SAAS,UAAU,CAAsB,IAKxC;QACC,OAAO,IAAI,CACT,KAAK,EAAE,KAAiB,EAAE,EAAE;YAC1B,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE;gBAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,OAAO,EAAE,EAAE,MAAM,EAAE,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE;gBACnH,KAAK,EAAE,qBAAqB,CAAC,KAAK,CAAC;aACpC,CAAC,CAAC;YACH,IAAI,CAAC;gBACH,OAAO,MAAM,iBAAiB,CAAC;oBAC7B,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAmB,EAAE,CAAC,EAAE;oBACtG,OAAO,EAAE,eAAe;oBACxB,KAAK;iBACN,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,aAAa,EAAE;oBAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACxD,CAAC,CAAC;gBACH,MAAM,aAAa,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;gBACpD,IAAI,aAAa;oBAAE,OAAO,aAAa,CAAC;gBACxC,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAChE,OAAO,KAAK,CAAC,qBAAqB,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC,EACD,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,CAC7E,CAAC;IACJ,CAAC;IAED,8EAA8E;IAE9E,2EAA2E;IAC3E,MAAM,mBAAmB,GAAoC,IAAI,CAAC,iBAAiB;QACjF,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAkB,CAAC;YACjC,GAAG,KAAK;YACR,GAAG,CAAC,eAAe,CAAC,SAAS,IAAI,eAAe,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO;gBACxE,CAAC,CAAC,EAAE,SAAS,EAAE,eAAe,CAAC,SAAS,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE;gBAC5E,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,eAAe,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7G,CAAC;QACJ,CAAC,CAAC,SAAS,CAAC;IAEd,MAAM,WAAW,GAAG,IAAI,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC,WAAW,EAAE,CAAC;IACpH,MAAM,YAAY,GAAG,IAAI,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/E,MAAM,YAAY,GAAG,IAAI,sBAAsB,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,mBAAmB,EAAE,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IACnI,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IACjC,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAC;IACxC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;IAC1C,MAAM,iBAAiB,GAAG,IAAI,gBAAgB,CAC5C,QAAwC,EACxC,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,aAAa,CACd,CAAC,WAAW,EAAE,CAAC;IAChB,MAAM,gBAAgB,GAAG,IAAI,CAAC,eAAe;QAC3C,CAAC,CAAC,IAAI,uBAAuB,CACzB,IAAI,CAAC,mBAAmB,EACxB,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,uBAAuB,EAC5B,mBAAmB,CACpB,CAAC,WAAW,EAAE;QACjB,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,gBAAgB,GAAG,IAAI,uBAAuB,CAClD,QAAQ,EACR,QAAQ,EACR,iBAAiB,EACjB,SAAS,EAAE,sBAAsB;IACjC,SAAS,EAAE,oBAAoB;IAC/B,gBAAgB,EAChB,IAAI,CAAC,eAAe,EACpB,IAAI,CAAC,sBAAsB,EAC3B,IAAI,CAAC,yBAAyB,CAC/B,CAAC,WAAW,EAAE,CAAC;IAChB,MAAM,YAAY,GAAG,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACrE,MAAM,sBAAsB,GAAG,IAAI,6BAA6B,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACzF,MAAM,kBAAkB,GAAG,IAAI,yBAAyB,CAAC,QAAQ,EAAE,IAAI,aAAa,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAEtG,8EAA8E;IAC9E,oFAAoF;IACpF,0FAA0F;IAC1F,iEAAiE;IACjE,EAAE;IACF,8EAA8E;IAC9E,+EAA+E;IAC/E,2BAA2B;IAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IACxF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,oBAAoB,CAAC,QAAQ,EAAE,eAAe,CAAC,MAAM,EAAE,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAE3H,8EAA8E;IAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACrC,MAAM,QAAQ,GAAa;QACzB,QAAQ;QACR,MAAM;QACN,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,KAAK;QACL,WAAW;QACX,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;QAC7C,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,mBAAmB,EAAE,IAAI,CAAC,mBAAmB;QAC7C,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;QACrD,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,6BAA6B,EAAE,IAAI,CAAC,6BAA6B;QACjE,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,yBAAyB,EAAE,IAAI,CAAC,yBAAyB;QACzD,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;QAC3C,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,iBAAiB,IAAI,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC5E,GAAG,CAAC,mBAAmB,IAAI,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,CAAC;QACtE,GAAG,CAAC,IAAI,CAAC,oBAAoB,IAAI,EAAE,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,EAAE,CAAC;QACrF,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC/E,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1D,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC/E,MAAM,EAAE;YACN,OAAO,EAAE,YAAY;YACrB,MAAM,EAAE,WAAW;YACnB,KAAK,EAAE,YAAY;YACnB,iBAAiB,EAAE,sBAAsB;YACzC,WAAW,EAAE,kBAAkB;YAC/B,WAAW,EAAE,gBAAgB;YAC7B,OAAO,EAAE,YAAY;SACtB;KACF,CAAC;IAEF,6EAA6E;IAC7E,MAAM,YAAY,GAAG,qBAAqB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,iBAAiB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC1D,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACtE,MAAM,gBAAgB,GAAG,IAAI,CAAC,eAAe;QAC3C,CAAC,CAAC,sBAAsB,CAAC,UAAU,EAAE,QAAQ,CAAC;QAC9C,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,YAAY,GAAG,kBAAkB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,eAAe,GAAG,qBAAqB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACpE,+EAA+E;IAC/E,gEAAgE;IAChE,MAAM,oBAAoB,GAAG,IAAI,CAAC,aAAa;QAC7C,CAAC,CAAC,0BAA0B,CAAC,UAAU,EAAE,QAAQ,CAAC;QAClD,CAAC,CAAC,EAAE,CAAC;IAEP,oFAAoF;IACpF,uCAAuC;IACvC,MAAM,6BAA6B,GAAG,IAAI,GAAG,CAAC;QAC5C,8BAA8B;KAC/B,CAAC,CAAC;IACH,MAAM,uBAAuB,GAAG,gBAAgB,CAAC,MAAM,CACrD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,6BAA6B,CAAC,GAAG,CAAE,CAAsB,CAAC,IAAI,CAAC,CACxE,CAAC;IAEF,OAAO;QACL,GAAG,YAAY;QACf,GAAG,WAAW;QACd,GAAG,YAAY;QACf,GAAG,uBAAuB;QAC1B,GAAG,YAAY;QACf,GAAG,gBAAgB;QACnB,GAAG,YAAY;QACf,GAAG,UAAU;QACb,GAAG,gBAAgB;QACnB,GAAG,YAAY;QACf,GAAG,eAAe;QAClB,GAAG,oBAAoB;KACxB,CAAC;AACJ,CAAC","sourcesContent":["import { tool } from \"@langchain/core/tools\";\nimport { z } from \"zod\";\nimport type { HydeGraphDatabase } from \"../interfaces/database.interface.js\";\nimport { IntentGraphFactory } from \"../../intent/intent.graph.js\";\nimport { EnrichmentGraphFactory } from \"../../enrichment/enrichment.graph.js\";\nimport { OpportunityGraphFactory } from \"../../opportunity/opportunity.graph.js\";\nimport { HydeGraphFactory } from \"../hyde/hyde.graph.js\";\nimport { HydeGenerator } from \"../hyde/hyde.generator.js\";\nimport { LensInferrer } from \"../hyde/lens.inferrer.js\";\nimport { NetworkGraphFactory } from \"../../network/network.graph.js\";\nimport { NetworkMembershipGraphFactory } from \"../../network/membership/membership.graph.js\";\nimport { IntentNetworkGraphFactory } from \"../../network/indexer/indexer.graph.js\";\nimport { IntentIndexer } from \"../../intent/intent.indexer.js\";\nimport { NegotiationGraphFactory } from \"../../negotiation/negotiation.graph.js\";\nimport { PremiseGraphFactory } from \"../../premise/premise.graph.js\";\nimport { protocolLogger } from \"../observability/protocol.logger.js\";\n\nimport type { QuestionerEnqueueFn } from \"../../questioner/questioner.types.js\";\n\nimport { type ToolContext, type ResolvedToolContext, type ToolDeps, resolveChatContext, error, redactSensitiveFields } from \"./tool.helpers.js\";\nimport { deriveAllowedNetworkIds, scopeFromNetworkId } from \"./tool.scope.js\";\nimport { invokeToolRuntime, toolRuntimeErrorToResult } from \"./tool.runtime.js\";\nimport { createEnrichmentTools } from \"../../enrichment/enrichment.tools.js\";\nimport { createIntentTools } from \"../../intent/intent.tools.js\";\nimport { createNetworkTools } from \"../../network/network.tools.js\";\nimport { createOpportunityTools } from \"../../opportunity/opportunity.tools.js\";\nimport { createUtilityTools } from \"./utility.tools.js\";\nimport { createIntegrationTools } from \"../../integration/integration.tools.js\";\nimport { createContactTools } from \"../../contact/contact.tools.js\";\nimport { createAgentTools } from \"../../agent/agent.tools.js\";\nimport { createNegotiationTools } from \"../../negotiation/negotiation.tools.js\";\nimport { createPremiseTools } from \"../../premise/premise.tools.js\";\nimport { createQuestionerTools } from \"../../questioner/questioner.tools.js\";\nimport { createAskUserQuestionTools } from \"../../questioner/questioner.ask.tool.js\";\n\n// Re-export types for consumers\nexport type { ToolContext, ResolvedToolContext, ProtocolDeps } from \"./tool.helpers.js\";\nexport type { ToolDeps } from \"./tool.helpers.js\";\n\nconst logger = protocolLogger(\"ChatTools\");\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// TOOL FACTORY\n// ═══════════════════════════════════════════════════════════════════════════════\n\n/**\n * Creates all chat tools bound to a specific user context.\n * Resolves user/network identity from DB at init time.\n * Tools are created fresh for each user session to ensure proper isolation.\n *\n * All external dependencies (cache, integration, queue, etc.) are provided\n * via the `deps` parameter — the protocol lib never imports concrete adapters.\n */\nexport async function createChatTools(\n  deps: ToolContext,\n  preResolvedContext?: ResolvedToolContext\n) {\n  const { database, embedder, scraper } = deps;\n\n  const explicitScope = deps.scopeType && deps.scopeId\n    ? { scopeType: deps.scopeType, scopeId: deps.scopeId }\n    : scopeFromNetworkId(deps.networkId);\n\n  // ─── Resolve context from DB ───────────────────────────────────────────────\n  // resolveChatContext still accepts a networkId because it loads scoped index\n  // presentation metadata; the canonical request scope is explicitScope.\n  const resolvedContext =\n    preResolvedContext ??\n    (await resolveChatContext({\n      database,\n      userId: deps.userId,\n      networkId: explicitScope.scopeType === 'network' ? explicitScope.scopeId : deps.networkId,\n      sessionId: deps.sessionId,\n      contactsEnabled: deps.contactsEnabled,\n    }));\n\n  if (!preResolvedContext && explicitScope.scopeType && explicitScope.scopeId) {\n    resolvedContext.scopeType = explicitScope.scopeType;\n    resolvedContext.scopeId = explicitScope.scopeId;\n  }\n\n  const allowedNetworkIds = deriveAllowedNetworkIds({\n    memberships: resolvedContext.userNetworks,\n    ...(resolvedContext.scopeType && resolvedContext.scopeId\n      ? { scopeType: resolvedContext.scopeType, scopeId: resolvedContext.scopeId }\n      : {}),\n  });\n\n  // ─── Tool wrapper ──────────────────────────────────────────────────────────\n  /**\n   * Standardized tool factory. Auto-injects resolved context and\n   * provides uniform logging / error handling for every tool.\n   */\n  function defineTool<T extends z.ZodType>(opts: {\n    name: string;\n    description: string;\n    querySchema: T;\n    handler: (input: { context: ResolvedToolContext; query: z.infer<T> }) => Promise<string>;\n  }) {\n    return tool(\n      async (query: z.infer<T>) => {\n        logger.info('Tool invoked', {\n          toolName: opts.name,\n          context: { userId: resolvedContext.userId, scopeType: resolvedContext.scopeType, scopeId: resolvedContext.scopeId },\n          query: redactSensitiveFields(query),\n        });\n        try {\n          return await invokeToolRuntime({\n            toolName: opts.name,\n            tool: { handler: async ({ context, query }) => opts.handler({ context, query: query as z.infer<T> }) },\n            context: resolvedContext,\n            query,\n          });\n        } catch (err) {\n          logger.error('Tool failed', {\n            toolName: opts.name,\n            error: err instanceof Error ? err.message : String(err),\n          });\n          const runtimeResult = toolRuntimeErrorToResult(err);\n          if (runtimeResult) return runtimeResult;\n          const reason = err instanceof Error ? err.message : String(err);\n          return error(`Failed to execute ${opts.name}: ${reason}`);\n        }\n      },\n      { name: opts.name, description: opts.description, schema: opts.querySchema }\n    );\n  }\n\n  // ─── Compile subgraphs ─────────────────────────────────────────────────────\n\n  // Wrap questionerEnqueue to include scoped/session context when available.\n  const sessionAwareEnqueue: QuestionerEnqueueFn | undefined = deps.questionerEnqueue\n    ? (input) => deps.questionerEnqueue!({\n        ...input,\n        ...(resolvedContext.scopeType && resolvedContext.scopeId && !input.scopeId\n          ? { scopeType: resolvedContext.scopeType, scopeId: resolvedContext.scopeId }\n          : {}),\n        ...(resolvedContext.sessionId && !input.conversationId ? { conversationId: resolvedContext.sessionId } : {}),\n      })\n    : undefined;\n\n  const intentGraph = new IntentGraphFactory(database, embedder, deps.intentQueue, sessionAwareEnqueue).createGraph();\n  const premiseGraph = new PremiseGraphFactory(database, embedder).createGraph();\n  const profileGraph = new EnrichmentGraphFactory(database, scraper, deps.enricher, sessionAwareEnqueue, premiseGraph).createGraph();\n  const hydeCache = deps.hydeCache;\n  const lensInferrer = new LensInferrer();\n  const hydeGenerator = new HydeGenerator();\n  const compiledHydeGraph = new HydeGraphFactory(\n    database as unknown as HydeGraphDatabase,\n    embedder,\n    hydeCache,\n    lensInferrer,\n    hydeGenerator\n  ).createGraph();\n  const negotiationGraph = deps.agentDispatcher\n    ? new NegotiationGraphFactory(\n        deps.negotiationDatabase,\n        deps.agentDispatcher,\n        deps.negotiationTimeoutQueue,\n        sessionAwareEnqueue,\n      ).createGraph()\n    : undefined;\n  const opportunityGraph = new OpportunityGraphFactory(\n    database,\n    embedder,\n    compiledHydeGraph,\n    undefined, // evaluator (default)\n    undefined, // queueNotification\n    negotiationGraph,\n    deps.agentDispatcher,\n    deps.queueNegotiateExisting,\n    deps.stampNewbornOpportunities,\n  ).createGraph();\n  const networkGraph = new NetworkGraphFactory(database).createGraph();\n  const networkMembershipGraph = new NetworkMembershipGraphFactory(database).createGraph();\n  const intentNetworkGraph = new IntentNetworkGraphFactory(database, new IntentIndexer()).createGraph();\n\n  // ─── Create context-bound databases ────────────────────────────────────────\n  // Use injected instances when provided (e.g. tests). Otherwise create from the same\n  // database used for graphs so that scope checks (e.g. ensureScopedMembership, opportunity\n  // update) use the same adapter as the rest of the tool pipeline.\n  //\n  // The systemDb's DB-level clamp derives concrete allowed network IDs from the\n  // focused scope envelope plus memberships, rather than consuming a transported\n  // legacy indexScope array.\n  const userDb = deps.userDb ?? deps.createUserDatabase(database, resolvedContext.userId);\n  const systemDb = deps.systemDb ?? deps.createSystemDatabase(database, resolvedContext.userId, allowedNetworkIds, embedder);\n\n  // ─── Assemble dependencies ─────────────────────────────────────────────────\n  const cache = deps.cache;\n  const integration = deps.integration;\n  const toolDeps: ToolDeps = {\n    database,\n    userDb,\n    systemDb,\n    scraper,\n    embedder,\n    cache,\n    integration,\n    contactService: deps.contactService,\n    contactsEnabled: deps.contactsEnabled,\n    integrationImporter: deps.integrationImporter,\n    enricher: deps.enricher,\n    negotiationDatabase: deps.negotiationDatabase,\n    negotiationTimeoutQueue: deps.negotiationTimeoutQueue,\n    agentDatabase: deps.agentDatabase,\n    grantDefaultSystemPermissions: deps.grantDefaultSystemPermissions,\n    agentDispatcher: deps.agentDispatcher,\n    stampNewbornOpportunities: deps.stampNewbornOpportunities,\n    deliveryLedger: deps.deliveryLedger,\n    discoveryRuns: deps.discoveryRuns,\n    discoveryRunQueue: deps.discoveryRunQueue,\n    enrichmentRuns: deps.enrichmentRuns,\n    enrichmentRunQueue: deps.enrichmentRunQueue,\n    mintConnectToken: deps.mintConnectToken,\n    mintConnectLink: deps.mintConnectLink,\n    frontendUrl: deps.frontendUrl,\n    apiBaseUrl: deps.apiBaseUrl,\n    ...(deps.chatSummary && { chatSummary: deps.chatSummary }),\n    ...(deps.questionGenerator && { questionGenerator: deps.questionGenerator }),\n    ...(sessionAwareEnqueue && { questionerEnqueue: sessionAwareEnqueue }),\n    ...(deps.findPendingQuestions && { findPendingQuestions: deps.findPendingQuestions }),\n    ...(deps.negotiationSummary && { negotiationSummary: deps.negotiationSummary }),\n    ...(deps.chatQuestions && { chatQuestions: deps.chatQuestions }),\n    ...(deps.chatSession && { chatSession: deps.chatSession }),\n    ...(deps.getUserContextText && { getUserContextText: deps.getUserContextText }),\n    graphs: {\n      profile: profileGraph,\n      intent: intentGraph,\n      index: networkGraph,\n      networkMembership: networkMembershipGraph,\n      intentIndex: intentNetworkGraph,\n      opportunity: opportunityGraph,\n      premise: premiseGraph,\n    },\n  };\n\n  // ─── Create domain tools ──────────────────────────────────────────────────\n  const profileTools = createEnrichmentTools(defineTool, toolDeps);\n  const intentTools = createIntentTools(defineTool, toolDeps);\n  const networkTools = createNetworkTools(defineTool, toolDeps);\n  const opportunityTools = createOpportunityTools(defineTool, toolDeps);\n  const utilityTools = createUtilityTools(defineTool, toolDeps);\n  const contactTools = createContactTools(defineTool, toolDeps);\n  const agentTools = createAgentTools(defineTool, toolDeps);\n  const integrationTools = createIntegrationTools(defineTool, toolDeps);\n  const negotiationTools = deps.agentDispatcher\n    ? createNegotiationTools(defineTool, toolDeps)\n    : [];\n  const premiseTools = createPremiseTools(defineTool, toolDeps);\n  const questionerTools = createQuestionerTools(defineTool, toolDeps);\n  // Blocking mid-conversation questions — chat-only (never in the MCP registry),\n  // and only when the host provides the ChatQuestionsHost bridge.\n  const askUserQuestionTools = deps.chatQuestions\n    ? createAskUserQuestionTools(defineTool, toolDeps)\n    : [];\n\n  // confirm_opportunity_delivery is an OpenClaw-delivery ledger write and must not be\n  // callable from regular chat sessions.\n  const chatOpportunityToolExclusions = new Set([\n    \"confirm_opportunity_delivery\",\n  ]);\n  const opportunityToolsForChat = opportunityTools.filter(\n    (t) => !chatOpportunityToolExclusions.has((t as { name: string }).name)\n  );\n\n  return [\n    ...profileTools,\n    ...intentTools,\n    ...networkTools,\n    ...opportunityToolsForChat,\n    ...utilityTools,\n    ...integrationTools,\n    ...contactTools,\n    ...agentTools,\n    ...negotiationTools,\n    ...premiseTools,\n    ...questionerTools,\n    ...askUserQuestionTools,\n  ];\n}\n\n/**\n * Type for the tools array returned by createChatTools.\n */\nexport type ChatTools = Awaited<ReturnType<typeof createChatTools>>;\n"]}
+{"version":3,"file":"tool.factory.js","sourceRoot":"/","sources":["shared/agent/tool.factory.ts"],"names":[],"mappings":"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","sourcesContent":["import { tool } from \"@langchain/core/tools\";\nimport { z } from \"zod\";\nimport type { HydeGraphDatabase } from \"../interfaces/database.interface.js\";\nimport { IntentGraphFactory } from \"../../intent/intent.graph.js\";\nimport { EnrichmentGraphFactory } from \"../../enrichment/enrichment.graph.js\";\nimport { OpportunityGraphFactory } from \"../../opportunity/opportunity.graph.js\";\nimport { HydeGraphFactory } from \"../hyde/hyde.graph.js\";\nimport { HydeGenerator } from \"../hyde/hyde.generator.js\";\nimport { LensInferrer } from \"../hyde/lens.inferrer.js\";\nimport { NetworkGraphFactory } from \"../../network/network.graph.js\";\nimport { NetworkMembershipGraphFactory } from \"../../network/membership/membership.graph.js\";\nimport { IntentNetworkGraphFactory } from \"../../network/indexer/indexer.graph.js\";\nimport { IntentIndexer } from \"../../intent/intent.indexer.js\";\nimport { NegotiationGraphFactory } from \"../../negotiation/negotiation.graph.js\";\nimport { PremiseGraphFactory } from \"../../premise/premise.graph.js\";\nimport { protocolLogger } from \"../observability/protocol.logger.js\";\n\nimport type { QuestionerEnqueueFn } from \"../../questioner/questioner.types.js\";\n\nimport { type ToolContext, type ResolvedToolContext, type ToolDeps, resolveChatContext, error, redactSensitiveFields } from \"./tool.helpers.js\";\nimport { deriveAllowedNetworkIds, scopeFromNetworkId } from \"./tool.scope.js\";\nimport { invokeToolRuntime, toolRuntimeErrorToResult } from \"./tool.runtime.js\";\nimport { createEnrichmentTools } from \"../../enrichment/enrichment.tools.js\";\nimport { createIntentTools } from \"../../intent/intent.tools.js\";\nimport { createNetworkTools } from \"../../network/network.tools.js\";\nimport { createOpportunityTools } from \"../../opportunity/opportunity.tools.js\";\nimport { createUtilityTools } from \"./utility.tools.js\";\nimport { createIntegrationTools } from \"../../integration/integration.tools.js\";\nimport { createContactTools } from \"../../contact/contact.tools.js\";\nimport { createAgentTools } from \"../../agent/agent.tools.js\";\nimport { createNegotiationTools } from \"../../negotiation/negotiation.tools.js\";\nimport { createPremiseTools } from \"../../premise/premise.tools.js\";\nimport { createQuestionerTools } from \"../../questioner/questioner.tools.js\";\nimport { createAskUserQuestionTools } from \"../../questioner/questioner.ask.tool.js\";\n\n// Re-export types for consumers\nexport type { ToolContext, ResolvedToolContext, ProtocolDeps } from \"./tool.helpers.js\";\nexport type { ToolDeps } from \"./tool.helpers.js\";\n\nconst logger = protocolLogger(\"ChatTools\");\n\n// ═══════════════════════════════════════════════════════════════════════════════\n// TOOL FACTORY\n// ═══════════════════════════════════════════════════════════════════════════════\n\n/**\n * Creates all chat tools bound to a specific user context.\n * Resolves user/network identity from DB at init time.\n * Tools are created fresh for each user session to ensure proper isolation.\n *\n * All external dependencies (cache, integration, queue, etc.) are provided\n * via the `deps` parameter — the protocol lib never imports concrete adapters.\n */\nexport async function createChatTools(\n  deps: ToolContext,\n  preResolvedContext?: ResolvedToolContext\n) {\n  const { database, embedder, scraper } = deps;\n\n  const explicitScope = deps.scopeType && deps.scopeId\n    ? { scopeType: deps.scopeType, scopeId: deps.scopeId }\n    : scopeFromNetworkId(deps.networkId);\n\n  // ─── Resolve context from DB ───────────────────────────────────────────────\n  // resolveChatContext still accepts a networkId because it loads scoped index\n  // presentation metadata; the canonical request scope is explicitScope.\n  const resolvedContext =\n    preResolvedContext ??\n    (await resolveChatContext({\n      database,\n      userId: deps.userId,\n      networkId: explicitScope.scopeType === 'network' ? explicitScope.scopeId : deps.networkId,\n      sessionId: deps.sessionId,\n      contactsEnabled: deps.contactsEnabled,\n      actionToolsEnabled: deps.actionToolsEnabled,\n    }));\n\n  if (!preResolvedContext && explicitScope.scopeType && explicitScope.scopeId) {\n    resolvedContext.scopeType = explicitScope.scopeType;\n    resolvedContext.scopeId = explicitScope.scopeId;\n  }\n\n  const allowedNetworkIds = deriveAllowedNetworkIds({\n    memberships: resolvedContext.userNetworks,\n    ...(resolvedContext.scopeType && resolvedContext.scopeId\n      ? { scopeType: resolvedContext.scopeType, scopeId: resolvedContext.scopeId }\n      : {}),\n  });\n\n  // ─── Tool wrapper ──────────────────────────────────────────────────────────\n  /**\n   * Standardized tool factory. Auto-injects resolved context and\n   * provides uniform logging / error handling for every tool.\n   */\n  function defineTool<T extends z.ZodType>(opts: {\n    name: string;\n    description: string;\n    querySchema: T;\n    handler: (input: { context: ResolvedToolContext; query: z.infer<T> }) => Promise<string>;\n  }) {\n    return tool(\n      async (query: z.infer<T>) => {\n        logger.info('Tool invoked', {\n          toolName: opts.name,\n          context: { userId: resolvedContext.userId, scopeType: resolvedContext.scopeType, scopeId: resolvedContext.scopeId },\n          query: redactSensitiveFields(query),\n        });\n        try {\n          return await invokeToolRuntime({\n            toolName: opts.name,\n            tool: { handler: async ({ context, query }) => opts.handler({ context, query: query as z.infer<T> }) },\n            context: resolvedContext,\n            query,\n          });\n        } catch (err) {\n          logger.error('Tool failed', {\n            toolName: opts.name,\n            error: err instanceof Error ? err.message : String(err),\n          });\n          const runtimeResult = toolRuntimeErrorToResult(err);\n          if (runtimeResult) return runtimeResult;\n          const reason = err instanceof Error ? err.message : String(err);\n          return error(`Failed to execute ${opts.name}: ${reason}`);\n        }\n      },\n      { name: opts.name, description: opts.description, schema: opts.querySchema }\n    );\n  }\n\n  // ─── Compile subgraphs ─────────────────────────────────────────────────────\n\n  // Wrap questionerEnqueue to include scoped/session context when available.\n  const sessionAwareEnqueue: QuestionerEnqueueFn | undefined = deps.questionerEnqueue\n    ? (input) => deps.questionerEnqueue!({\n        ...input,\n        ...(resolvedContext.scopeType && resolvedContext.scopeId && !input.scopeId\n          ? { scopeType: resolvedContext.scopeType, scopeId: resolvedContext.scopeId }\n          : {}),\n        ...(resolvedContext.sessionId && !input.conversationId ? { conversationId: resolvedContext.sessionId } : {}),\n      })\n    : undefined;\n\n  const intentGraph = new IntentGraphFactory(database, embedder, deps.intentQueue, sessionAwareEnqueue).createGraph();\n  const premiseGraph = new PremiseGraphFactory(database, embedder).createGraph();\n  const profileGraph = new EnrichmentGraphFactory(database, scraper, deps.enricher, sessionAwareEnqueue, premiseGraph).createGraph();\n  const hydeCache = deps.hydeCache;\n  const lensInferrer = new LensInferrer();\n  const hydeGenerator = new HydeGenerator();\n  const compiledHydeGraph = new HydeGraphFactory(\n    database as unknown as HydeGraphDatabase,\n    embedder,\n    hydeCache,\n    lensInferrer,\n    hydeGenerator\n  ).createGraph();\n  const negotiationGraph = deps.agentDispatcher\n    ? new NegotiationGraphFactory(\n        deps.negotiationDatabase,\n        deps.agentDispatcher,\n        deps.negotiationTimeoutQueue,\n        sessionAwareEnqueue,\n      ).createGraph()\n    : undefined;\n  const opportunityGraph = new OpportunityGraphFactory(\n    database,\n    embedder,\n    compiledHydeGraph,\n    undefined, // evaluator (default)\n    undefined, // queueNotification\n    negotiationGraph,\n    deps.agentDispatcher,\n    deps.queueNegotiateExisting,\n    deps.stampNewbornOpportunities,\n  ).createGraph();\n  const networkGraph = new NetworkGraphFactory(database).createGraph();\n  const networkMembershipGraph = new NetworkMembershipGraphFactory(database).createGraph();\n  const intentNetworkGraph = new IntentNetworkGraphFactory(database, new IntentIndexer()).createGraph();\n\n  // ─── Create context-bound databases ────────────────────────────────────────\n  // Use injected instances when provided (e.g. tests). Otherwise create from the same\n  // database used for graphs so that scope checks (e.g. ensureScopedMembership, opportunity\n  // update) use the same adapter as the rest of the tool pipeline.\n  //\n  // The systemDb's DB-level clamp derives concrete allowed network IDs from the\n  // focused scope envelope plus memberships, rather than consuming a transported\n  // legacy indexScope array.\n  const userDb = deps.userDb ?? deps.createUserDatabase(database, resolvedContext.userId);\n  const systemDb = deps.systemDb ?? deps.createSystemDatabase(database, resolvedContext.userId, allowedNetworkIds, embedder);\n\n  // ─── Assemble dependencies ─────────────────────────────────────────────────\n  const cache = deps.cache;\n  const integration = deps.integration;\n  const toolDeps: ToolDeps = {\n    database,\n    userDb,\n    systemDb,\n    scraper,\n    embedder,\n    cache,\n    integration,\n    contactService: deps.contactService,\n    contactsEnabled: deps.contactsEnabled,\n    integrationImporter: deps.integrationImporter,\n    enricher: deps.enricher,\n    negotiationDatabase: deps.negotiationDatabase,\n    negotiationTimeoutQueue: deps.negotiationTimeoutQueue,\n    agentDatabase: deps.agentDatabase,\n    grantDefaultSystemPermissions: deps.grantDefaultSystemPermissions,\n    agentDispatcher: deps.agentDispatcher,\n    stampNewbornOpportunities: deps.stampNewbornOpportunities,\n    deliveryLedger: deps.deliveryLedger,\n    discoveryRuns: deps.discoveryRuns,\n    discoveryRunQueue: deps.discoveryRunQueue,\n    enrichmentRuns: deps.enrichmentRuns,\n    enrichmentRunQueue: deps.enrichmentRunQueue,\n    mintConnectToken: deps.mintConnectToken,\n    mintConnectLink: deps.mintConnectLink,\n    frontendUrl: deps.frontendUrl,\n    apiBaseUrl: deps.apiBaseUrl,\n    ...(deps.chatSummary && { chatSummary: deps.chatSummary }),\n    ...(deps.questionGenerator && { questionGenerator: deps.questionGenerator }),\n    ...(sessionAwareEnqueue && { questionerEnqueue: sessionAwareEnqueue }),\n    ...(deps.findPendingQuestions && { findPendingQuestions: deps.findPendingQuestions }),\n    ...(deps.negotiationSummary && { negotiationSummary: deps.negotiationSummary }),\n    ...(deps.chatQuestions && { chatQuestions: deps.chatQuestions }),\n    ...(deps.chatSession && { chatSession: deps.chatSession }),\n    ...(deps.getUserContextText && { getUserContextText: deps.getUserContextText }),\n    graphs: {\n      profile: profileGraph,\n      intent: intentGraph,\n      index: networkGraph,\n      networkMembership: networkMembershipGraph,\n      intentIndex: intentNetworkGraph,\n      opportunity: opportunityGraph,\n      premise: premiseGraph,\n    },\n  };\n\n  // ─── Create domain tools ──────────────────────────────────────────────────\n  const profileTools = createEnrichmentTools(defineTool, toolDeps);\n  const intentTools = createIntentTools(defineTool, toolDeps);\n  const networkTools = createNetworkTools(defineTool, toolDeps);\n  const opportunityTools = createOpportunityTools(defineTool, toolDeps);\n  const utilityTools = createUtilityTools(defineTool, toolDeps);\n  const contactTools = createContactTools(defineTool, toolDeps);\n  const agentTools = createAgentTools(defineTool, toolDeps);\n  const integrationTools = createIntegrationTools(defineTool, toolDeps);\n  const negotiationTools = deps.agentDispatcher\n    ? createNegotiationTools(defineTool, toolDeps)\n    : [];\n  const premiseTools = createPremiseTools(defineTool, toolDeps);\n  const questionerTools = createQuestionerTools(defineTool, toolDeps);\n  // Blocking mid-conversation questions — chat-only (never in the MCP registry),\n  // and only when the host provides the ChatQuestionsHost bridge.\n  const askUserQuestionTools = deps.chatQuestions\n    ? createAskUserQuestionTools(defineTool, toolDeps)\n    : [];\n\n  // confirm_opportunity_delivery is an OpenClaw-delivery ledger write and must not be\n  // callable from regular chat sessions.\n  const chatOpportunityToolExclusions = new Set([\n    \"confirm_opportunity_delivery\",\n  ]);\n  const opportunityToolsForChat = opportunityTools.filter(\n    (t) => !chatOpportunityToolExclusions.has((t as { name: string }).name)\n  );\n\n  return [\n    ...profileTools,\n    ...intentTools,\n    ...networkTools,\n    ...opportunityToolsForChat,\n    ...utilityTools,\n    ...integrationTools,\n    ...contactTools,\n    ...agentTools,\n    ...negotiationTools,\n    ...premiseTools,\n    ...questionerTools,\n    ...askUserQuestionTools,\n  ];\n}\n\n/**\n * Type for the tools array returned by createChatTools.\n */\nexport type ChatTools = Awaited<ReturnType<typeof createChatTools>>;\n"]}

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

@@ -104,6 +104,8 @@ export interface ResolvedToolContext {
      * are also de-registered). Fail-closed: treat only `true` as enabled.
      */
     contactsEnabled?: boolean;
+    /** True only when the gated reporter cleanup-action proposal tool is registered. */
+    actionToolsEnabled?: boolean;
 }
 /**
  * Dependencies passed when creating tools for a user session.
@@ -149,6 +151,8 @@ export interface ToolContext {
      * contact tools are always registered.
      */
     contactsEnabled?: boolean;
+    /** True only when the gated reporter cleanup-action proposal tool is registered. */
+    actionToolsEnabled?: boolean;
     /** Chat session reader for loading conversation history. */
     chatSession: ChatSessionReader;
     /** Read-through chat-session digest. Optional; consumers fall back to undefined `chatContext`. */
@@ -196,6 +200,8 @@ export interface ToolContext {
      * the backend composition root; when absent the tool is not registered.
      */
     chatQuestions?: ChatQuestionsHost;
+    /** Optional durable persistence for reporter cleanup-action proposals. */
+    actionProposalStore?: import('../../chat/reporter.action.tools.js').AgentActionProposalStore;
     /**
      * Host bridge for the negotiator persona's `remember`/`forget` memory
      * tools (P5.4). Injected by the composition root only when negotiator
@@ -310,6 +316,8 @@ export declare function resolveChatContext(params: {
     sessionId?: string;
     /** CONTACTS_ENABLED flag, forwarded onto the resolved context for prompt gating. */
     contactsEnabled?: boolean;
+    /** Reporter action gate forwarded into the persona prompt/context. */
+    actionToolsEnabled?: boolean;
 }): Promise<ResolvedToolContext>;
 /**
  * Type for the `defineTool` closure created in `createChatTools`.