@indexnetwork/protocol 20.0.0-rc.484.1 → 21.0.0-rc.486.1

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

@@ -1,145 +0,0 @@
-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,
-    });
-}

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

@@ -1,31 +0,0 @@
-import { type ChatTools, type ResolvedToolContext, type ToolContext } from "../shared/agent/tool.factory.js";
-import type { UserDatabase } from "../shared/interfaces/database.interface.js";
-import type { ChatPersonaConfig } from "./chat.persona.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. */
-export declare const REPORTER_PERSONA_ID = "reporter";
-/**
- * Exact positive allowlist for the reporter persona. New shared tools remain
- * unavailable until they are explicitly reviewed here.
- */
-export declare const REPORTER_TOOL_NAMES: readonly ["read_intents", "search_intents", "read_user_contexts", "preview_user_context", "read_premises", "read_networks", "read_network_memberships", "read_pending_questions", "list_opportunities", "read_activity_summary"];
-interface ReporterToolBoundary {
-    context: ResolvedToolContext;
-    userDb: UserDatabase;
-    findPendingQuestions?: ToolContext["findPendingQuestions"];
-}
-/** Filters a shared registry through the reporter's positive allowlist. */
-export declare function filterReporterTools<T extends {
-    name: string;
-}>(tools: T[]): T[];
-/**
- * Replaces shared tools whose normal modes can enumerate other users with
- * reporter-safe, self-only read contracts. Opportunity listing is deliberately
- * aggregate-only: it never returns a counterpart name, row, or explanation.
- */
-export declare function narrowReporterTools(allowed: ChatTools, boundary: ReporterToolBoundary): ChatTools;
-/** Creates the reporter's context-bound, allowlisted toolset. */
-export declare function createReporterTools(deps: ToolContext, preResolvedContext?: ResolvedToolContext): Promise<ChatTools>;
-/** Restricted read-only Agent reporter persona. */
-export declare const REPORTER_PERSONA: ChatPersonaConfig;

package/dist/chat/reporter.persona.js

@@ -1,207 +0,0 @@
-import { tool } from "@langchain/core/tools";
-import { z } from "zod";
-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, resolveReporterDeterministicResponse } 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. */
-export const REPORTER_PERSONA_ID = "reporter";
-/**
- * Exact positive allowlist for the reporter persona. New shared tools remain
- * unavailable until they are explicitly reviewed here.
- */
-export const REPORTER_TOOL_NAMES = [
-    "read_intents",
-    "search_intents",
-    "read_user_contexts",
-    "preview_user_context",
-    "read_premises",
-    "read_networks",
-    "read_network_memberships",
-    "read_pending_questions",
-    "list_opportunities",
-    "read_activity_summary",
-];
-const REPORTER_TOOL_ALLOWLIST = new Set(REPORTER_TOOL_NAMES);
-/** Filters a shared registry through the reporter's positive allowlist. */
-export function filterReporterTools(tools) {
-    return tools.filter((candidate) => REPORTER_TOOL_ALLOWLIST.has(candidate.name));
-}
-function invokeSharedTool(sharedTool, input) {
-    return sharedTool.invoke(input);
-}
-/**
- * Replaces shared tools whose normal modes can enumerate other users with
- * reporter-safe, self-only read contracts. Opportunity listing is deliberately
- * aggregate-only: it never returns a counterpart name, row, or explanation.
- */
-export function narrowReporterTools(allowed, boundary) {
-    const { context, userDb } = boundary;
-    return allowed.map((sharedTool) => {
-        if (sharedTool.name === "read_intents") {
-            return tool(async (query) => {
-                const limit = query.limit ?? 100;
-                const page = query.page ?? 1;
-                const intents = await userDb.getActiveIntents();
-                const start = (page - 1) * limit;
-                return success({
-                    intents: intents.slice(start, start + limit),
-                    page,
-                    limit,
-                    total: intents.length,
-                });
-            }, {
-                name: "read_intents",
-                description: "Read the authenticated user's own active signals only.",
-                schema: z.object({
-                    limit: z.number().int().min(1).max(100).optional(),
-                    page: z.number().int().min(1).optional(),
-                }).strict(),
-            });
-        }
-        if (sharedTool.name === "search_intents") {
-            return tool(async (query) => success({
-                intents: await userDb.searchOwnIntents(query.query, query.limit ?? 20),
-            }), {
-                name: "search_intents",
-                description: "Search the authenticated user's own active signals only.",
-                schema: z.object({
-                    query: z.string().trim().min(1),
-                    limit: z.number().int().min(1).max(100).optional(),
-                }).strict(),
-            });
-        }
-        if (sharedTool.name === "read_user_contexts") {
-            return tool(async () => invokeSharedTool(sharedTool, {}), {
-                name: "read_user_contexts",
-                description: "Read the authenticated user's own identity and global context only.",
-                schema: z.object({}).strict(),
-            });
-        }
-        if (sharedTool.name === "read_premises") {
-            return tool(async (query) => invokeSharedTool(sharedTool, {
-                includeRetracted: query.includeRetracted ?? false,
-                userId: context.userId,
-            }), {
-                name: "read_premises",
-                description: "Read the authenticated user's own premises only.",
-                schema: z.object({ includeRetracted: z.boolean().optional() }).strict(),
-            });
-        }
-        if (sharedTool.name === "read_network_memberships") {
-            return tool(async () => invokeSharedTool(sharedTool, {}), {
-                name: "read_network_memberships",
-                description: "Read the authenticated user's own network memberships only.",
-                schema: z.object({}).strict(),
-            });
-        }
-        if (sharedTool.name === "read_networks") {
-            return tool(async () => invokeSharedTool(sharedTool, { userId: context.userId }), {
-                name: "read_networks",
-                description: "Read networks available to the authenticated user.",
-                schema: z.object({}).strict(),
-            });
-        }
-        if (sharedTool.name === "read_pending_questions") {
-            return tool(async (query) => {
-                if (!boundary.findPendingQuestions)
-                    return error("Question lookup is not available.");
-                const questions = await boundary.findPendingQuestions(context.userId, {
-                    modes: ["intent"],
-                    limit: query.limit ?? 10,
-                });
-                return success({ questions: questions.slice(0, query.limit ?? 10) });
-            }, {
-                name: "read_pending_questions",
-                description: "Read the user's own non-negotiation pending questions; answering is unavailable here.",
-                schema: z.object({ limit: z.number().int().min(1).max(10).optional() }).strict(),
-            });
-        }
-        if (sharedTool.name === "list_opportunities") {
-            return tool(async (query) => {
-                const scopedNetworkId = focusedNetworkId(context);
-                if (scopedNetworkId && query.networkId && query.networkId !== scopedNetworkId) {
-                    return error("This chat is scoped to a different network.");
-                }
-                const activeIntents = await userDb.getActiveIntents();
-                const intentById = new Map(activeIntents.map((intent) => [intent.id, intent]));
-                const opportunities = await userDb.getOpportunitiesForUser({
-                    ...(query.networkId || scopedNetworkId ? { networkId: query.networkId || scopedNetworkId } : {}),
-                    statuses: ["draft", "pending", "latent"],
-                    limit: 100,
-                });
-                const counts = new Map();
-                const seen = new Set();
-                for (const opportunity of opportunities) {
-                    const ownIntentIds = new Set(opportunity.actors
-                        .filter((actor) => actor.userId === context.userId && actor.intent && intentById.has(actor.intent))
-                        .map((actor) => actor.intent));
-                    if (ownIntentIds.size === 0)
-                        continue;
-                    seen.add(opportunity.id);
-                    for (const intentId of ownIntentIds) {
-                        const intent = intentById.get(intentId);
-                        if (!intent)
-                            continue;
-                        const existing = counts.get(intentId) ?? {
-                            intentId,
-                            title: intent.summary?.trim() || intent.payload,
-                            count: 0,
-                        };
-                        existing.count += 1;
-                        counts.set(intentId, existing);
-                    }
-                }
-                return success({
-                    found: seen.size > 0,
-                    count: seen.size,
-                    bySignal: [...counts.values()],
-                });
-            }, {
-                name: "list_opportunities",
-                description: "Report current opportunity counts by the user's own signal, without counterpart identities or rows.",
-                schema: z.object({ networkId: z.string().uuid().optional() }).strict(),
-            });
-        }
-        return sharedTool;
-    });
-}
-/** Creates the reporter's context-bound, allowlisted toolset. */
-export async function createReporterTools(deps, preResolvedContext) {
-    const explicitScope = deps.scopeType && deps.scopeId
-        ? { scopeType: deps.scopeType, scopeId: deps.scopeId }
-        : scopeFromNetworkId(deps.networkId);
-    const resolvedContext = preResolvedContext ?? await resolveChatContext({
-        database: deps.database,
-        userId: deps.userId,
-        networkId: explicitScope.scopeType === "network" ? explicitScope.scopeId : deps.networkId,
-        sessionId: deps.sessionId,
-        actionToolsEnabled: deps.actionToolsEnabled,
-    });
-    if (explicitScope.scopeType && explicitScope.scopeId) {
-        resolvedContext.scopeType = explicitScope.scopeType;
-        resolvedContext.scopeId = explicitScope.scopeId;
-    }
-    const userDb = deps.userDb ?? deps.createUserDatabase(deps.database, resolvedContext.userId);
-    const allowed = filterReporterTools(await createChatTools(deps, resolvedContext));
-    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 = {
-    id: REPORTER_PERSONA_ID,
-    buildSystemContent: (ctx, iterCtx) => buildReporterSystemContent(ctx, iterCtx),
-    createTools: (deps, preResolvedContext) => createReporterTools(deps, preResolvedContext),
-    resolveDeterministicResponse: (_ctx, iterCtx) => resolveReporterDeterministicResponse(iterCtx),
-    loopBehaviors: {
-        hallucinationRecovery: false,
-    },
-};

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

@@ -1,24 +0,0 @@
-import type { ResolvedToolContext } from "../shared/agent/tool.factory.js";
-import type { IterationContext } from "./chat.prompt.modules.js";
-/** Stable marker used by the Agent surface to request its opening briefing. */
-export declare const REPORTER_BRIEFING_KICKOFF = "reporter-briefing-kickoff";
-/**
- * Recognizes the explicit opening briefing marker without putting ordinary
- * reporter conversations into briefing mode accidentally.
- *
- * @param message - Latest user message in the current turn
- * @returns Whether this turn is the Agent-surface briefing kickoff
- */
-export declare function isReporterBriefingKickoff(message?: string): boolean;
-/** Recognizes a short acknowledgement only when a prior proposal is visible. */
-export declare function isReporterActionConfirmation(message?: string, hasPriorProposal?: boolean): boolean;
-/** Deterministic reporter response for contextual typed acknowledgements. */
-export declare function resolveReporterDeterministicResponse(iterCtx: IterationContext): string | null;
-/**
- * Builds the read-only reporter persona prompt.
- *
- * @param ctx - Resolved authenticated user context
- * @param iterCtx - Current agent-loop context used for briefing kickoff
- * @returns Complete reporter system content
- */
-export declare function buildReporterSystemContent(ctx: ResolvedToolContext, iterCtx?: IterationContext): string;

package/dist/chat/reporter.prompt.js

@@ -1,149 +0,0 @@
-/** Stable marker used by the Agent surface to request its opening briefing. */
-export const REPORTER_BRIEFING_KICKOFF = "reporter-briefing-kickoff";
-/**
- * Recognizes the explicit opening briefing marker without putting ordinary
- * reporter conversations into briefing mode accidentally.
- *
- * @param message - Latest user message in the current turn
- * @returns Whether this turn is the Agent-surface briefing kickoff
- */
-export function isReporterBriefingKickoff(message) {
-    const normalized = message?.trim().toLocaleLowerCase()
-        .replace(/[–—]/g, "-")
-        .replace(/^_+|_+$/g, "");
-    if (!normalized)
-        return false;
-    return normalized === REPORTER_BRIEFING_KICKOFF;
-}
-/** Recognizes a short acknowledgement only when a prior proposal is visible. */
-export function isReporterActionConfirmation(message, hasPriorProposal = false) {
-    const normalized = message?.trim().toLocaleLowerCase()
-        .replace(/[.!?,;:]+$/g, "")
-        .replace(/\s+/g, " ");
-    if (!normalized || !hasPriorProposal)
-        return false;
-    return new Set([
-        "i confirm",
-        "confirm",
-        "confirm it",
-        "approve",
-        "approved",
-        "approve it",
-        "i approve",
-        "yes",
-        "yes i confirm",
-        "yes please",
-        "please do it",
-        "proceed",
-        "go ahead",
-    ]).has(normalized);
-}
-/** Deterministic reporter response for contextual typed acknowledgements. */
-export function resolveReporterDeterministicResponse(iterCtx) {
-    if (!isReporterActionConfirmation(iterCtx.currentMessage, iterCtx.hasPriorAgentActionProposal === true))
-        return null;
-    return "Use the visible proposal card's Confirm control to approve this request. I won't run or recreate it from a chat acknowledgement.";
-}
-function buildBriefingGuidance(iterCtx) {
-    if (!isReporterBriefingKickoff(iterCtx?.currentMessage))
-        return "";
-    return `
-
-## Opening briefing
-This is the Agent-surface briefing kickoff. Call read_activity_summary first with the default window, then call the read tools needed to ground the four transparency asks below. Present one concise briefing covering:
-1. summarize all my signals;
-2. what did you do today?;
-3. how do I look to others?;
-4. what should I sharpen?
-Do 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.`;
-}
-function buildTurnGuidance(iterCtx) {
-    const currentMessage = iterCtx?.currentMessage;
-    const confirmation = isReporterActionConfirmation(currentMessage, iterCtx?.hasPriorAgentActionProposal === true);
-    return `
-
-## Turn discipline
-- The detailed four-section opening briefing is reserved for the exact reporter-briefing-kickoff marker. Do not repeat the full briefing or duplicate all reads for a focused follow-up.
-- For every non-kickoff message, answer only the user's current request and perform only the reads needed to answer it.
-${confirmation ? `- This message is only a natural-language acknowledgement. Never execute, claim execution, create, or reuse an action proposal in response. Do not call read_activity_summary or propose_cleanup_actions. Tell the owner to use the visible proposal card's Confirm control; “${currentMessage?.trim()}” is not endpoint confirmation.` : ""}`;
-}
-/**
- * Builds the read-only reporter persona prompt.
- *
- * @param ctx - Resolved authenticated user context
- * @param iterCtx - Current agent-loop context used for briefing kickoff
- * @returns Complete reporter system content
- */
-export function buildReporterSystemContent(ctx, iterCtx) {
-    const userContext = JSON.stringify(ctx.user, null, 2);
-    const profileContext = ctx.userProfile
-        ? JSON.stringify(ctx.userProfile, null, 2)
-        : "null";
-    const membershipContext = JSON.stringify(ctx.userNetworks.map((network) => ({
-        id: network.networkId,
-        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}.
-
-${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 read_activity_summary 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.
-${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 read_activity_summary 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.
-
-## Four transparency asks
-Be ready to answer:
-- “summarize all my signals” — read the user's own signals and describe their current themes without inventing a synthesis.
-- “what did you do today?” — report only grounded activity counts from the requested window.
-- “how do I look to others?” — describe only the user's own stored context and signals; do not claim access to private counterparty opinions.
-- “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.
-
-## Allowed capabilities
-- Own signal reads: read_intents, search_intents.
-- Own context reads: read_user_contexts, preview_user_context, read_premises.
-- Own community context: read_networks, read_network_memberships.
-- Own pending-question reads: read_pending_questions (never answer them).
-- Aggregate activity reporting: read_activity_summary.
-- 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}
-
-### User record
-\`\`\`json
-${userContext}
-\`\`\`
-
-### User context
-\`\`\`json
-${profileContext}
-\`\`\`
-
-### Current memberships
-\`\`\`json
-${membershipContext}
-\`\`\`
-
-Only 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.${buildTurnGuidance(iterCtx)}${buildBriefingGuidance(iterCtx)}`;
-}

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

@@ -1,39 +0,0 @@
-/**
- * questions/application — orchestrators, agents, env, tools, and presets.
- *
- * Re-exports the orchestration tier of the questions capability: the
- * QuestionerAgent, env accessors, generation presets, and adapter tool
- * factories.
- *
- * ## Foreground adapters (participant-directed, authenticated)
- *
- * - {@link createQuestionerTools} — `read_pending_questions` and
- *   `answer_pending_question` MCP tools for authenticated answer/dismiss paths.
- * - {@link createAskUserQuestionTools} — blocking chat `ask_user_question`
- *   tool for inline chat orchestrator questions.
- *
- * ## Ambient adapters (background generation)
- *
- * Recovery, pool, uptake, inflight, and push generation are scheduled via
- * the QuestionerQueue (backend). They consume {@link QuestionerEnqueueFn}
- * injected from the composition root and call QuestionerAgent.invoke() with
- * the appropriate mode context. The ports for these adapters are declared in
- * `questions/ports/question.persistence.port.ts`.
- *
- * ## Boundary
- *
- * Imports from questions/domain, questions/ports, shared/ infrastructure,
- * and narrow capability facades (negotiation.questions.facade) — never from
- * runtime/, host implementations, or other capability internals.
- *
- * IND-547: canonical application layer for the questions capability.
- */
-export { isValidQuestionerInputContract, } from "./question.input.js";
-export type { QuestionerInput, QuestionerContext, QuestionerEnqueuePayload, QuestionerEnqueueFn, IntentContext, RecoveryIntentContext, NegotiationContext, PostStallNegotiationContext, UptakeNegotiationContext, NegotiationInflightContext, ChatContext, PoolDiscoveryContext, PostStallQuestionerInput, InflightQuestionerInput, UptakeQuestionerInput, RecoveryQuestionerInput, } from "./question.input.js";
-export { QuestionerAgent } from "./question.agent.js";
-export type { QuestionerAgentConfig } from "./question.agent.js";
-export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, chatQuestionWaitTimeoutMs, intentQuestionDailyCap, CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT, UPTAKE_AUTHORITY_THRESHOLD_DEFAULT, INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS, } from "./question.env.js";
-export { getPreset } from "./question.presets.js";
-export type { QuestionerPreset } from "./question.presets.js";
-export { createQuestionerTools } from "./question.tools.js";
-export { createAskUserQuestionTools, setQuestionerAgentForTesting } from "./question.ask.tool.js";

package/dist/questions/application/index.js

@@ -1,41 +0,0 @@
-/**
- * questions/application — orchestrators, agents, env, tools, and presets.
- *
- * Re-exports the orchestration tier of the questions capability: the
- * QuestionerAgent, env accessors, generation presets, and adapter tool
- * factories.
- *
- * ## Foreground adapters (participant-directed, authenticated)
- *
- * - {@link createQuestionerTools} — `read_pending_questions` and
- *   `answer_pending_question` MCP tools for authenticated answer/dismiss paths.
- * - {@link createAskUserQuestionTools} — blocking chat `ask_user_question`
- *   tool for inline chat orchestrator questions.
- *
- * ## Ambient adapters (background generation)
- *
- * Recovery, pool, uptake, inflight, and push generation are scheduled via
- * the QuestionerQueue (backend). They consume {@link QuestionerEnqueueFn}
- * injected from the composition root and call QuestionerAgent.invoke() with
- * the appropriate mode context. The ports for these adapters are declared in
- * `questions/ports/question.persistence.port.ts`.
- *
- * ## Boundary
- *
- * Imports from questions/domain, questions/ports, shared/ infrastructure,
- * and narrow capability facades (negotiation.questions.facade) — never from
- * runtime/, host implementations, or other capability internals.
- *
- * IND-547: canonical application layer for the questions capability.
- */
-// ── Domain input types + validation ──────────────────────────────────────────
-export { isValidQuestionerInputContract, } from "./question.input.js";
-// ── Agent ─────────────────────────────────────────────────────────────────────
-export { QuestionerAgent } from "./question.agent.js";
-// ── Env ───────────────────────────────────────────────────────────────────────
-export { isQuestionerEnabled, isUptakeGuardEnabled, uptakeAuthorityThreshold, chatQuestionWaitTimeoutMs, intentQuestionDailyCap, CHAT_QUESTION_WAIT_TIMEOUT_MS_DEFAULT, UPTAKE_AUTHORITY_THRESHOLD_DEFAULT, INTENT_QUESTION_DAILY_CAP_DEFAULT, INTENT_QUESTION_DAILY_WINDOW_HOURS, } from "./question.env.js";
-// ── Presets ───────────────────────────────────────────────────────────────────
-export { getPreset } from "./question.presets.js";
-// ── Foreground adapter tools ──────────────────────────────────────────────────
-export { createQuestionerTools } from "./question.tools.js";
-export { createAskUserQuestionTools, setQuestionerAgentForTesting } from "./question.ask.tool.js";

package/dist/questions/application/question.qud.d.ts

@@ -1,12 +0,0 @@
-/**
- * questions/application/question.qud — Questions Under Discussion taxonomy.
- *
- * Shared QUD taxonomy contract for structured question-generation prompts.
- * Every Questioner mode uses this block because the structured output schema
- * requires the internal metadata field; intent and discovery are the primary
- * consumers of non-null classifications.
- *
- * IND-547: canonical home — previously questioner/questioner.qud.ts.
- * Legacy path is a thin compatibility shim pointing here.
- */
-export declare const QUD_UNDERSPECIFICATION_RULES = "QUD underspecification taxonomy. For every structured question, emit a required `underspecificationType` field. Use exactly one category only when the question repairs that kind of underspecification:\n- missing_constituent: an absent core participant, entity, or outcome (who/what).\n- missing_constraint: the core target exists, but a ranking boundary is missing (where/when/how/how much).\n- open_alternative_set: an unresolved choice among materially different interpretations or scopes.\nUse null for adjacent, reflective, emergent, or any other question that does not repair underspecification. Strategy and underspecification type are orthogonal: `strategy` describes the conversational move; `underspecificationType` describes the QUD defect repaired. Never infer one mechanically from the other.";