@indexnetwork/protocol 22.0.0-rc.499.1 → 64.0.0-rc.604.2

package/dist/opportunities/opportunity.state.js

@@ -1,256 +0,0 @@
-import { Annotation } from "@langchain/langgraph";
-/**
- * Opportunity Graph State Annotation
- */
-export const OpportunityGraphState = Annotation.Root({
-    // ─── Input Fields (Required) ───
-    userId: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => '',
-    }),
-    searchQuery: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    networkId: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /**
-     * Optional set of indexes discovery may search within (e.g. a network-scoped
-     * agent's reachable networks: the bound network plus the user's personal network).
-     * The scope node intersects this with the user's actual memberships. Ignored
-     * when `networkId` is set (single-network override). When unset, discovery
-     * spans all of the user's networks.
-     */
-    indexScope: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /** Optional intent to use as discovery source and for triggeredBy. When set, used for search text (if query empty) and persist. */
-    triggerIntentId: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /** Optional: restrict discovery to this specific user ID only (direct connection). */
-    targetUserId: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /** Optional: discover on behalf of this user (introducer flow). When set, prep/eval use this user's profile/intents; userId becomes the introducer. */
-    onBehalfOfUserId: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    options: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => ({}),
-    }),
-    /**
-     * Operation mode controls graph flow:
-     * - 'create': Existing discover pipeline (Prep → Scope → Discovery → Evaluation → Ranking → Persist)
-     * - 'create_introduction': Introduction path (validation → evaluation → persist) for chat-driven intros
-     * - 'continue_discovery': Pagination path (Prep → Evaluation → Ranking → Persist) using pre-loaded candidates
-     * - 'read': List opportunities filtered by userId and optionally networkId (fast path)
-     * - 'update': Change opportunity status (accept, reject, etc.)
-     * - 'delete': Expire/archive an opportunity
-     * - 'send': Promote latent opportunity to pending + queue notification
-     * - 'negotiate_existing': Load an existing opportunity by opportunityId and run bilateral negotiation.
-     *   Used after introducer approval to trigger the normal negotiation flow.
-     * - 'approve_introduction': Mark the caller as having approved a latent introducer opportunity,
-     *   then enqueue a negotiate_existing job for that opportunity.
-     *
-     * Defaults to 'create' for backward compatibility.
-     */
-    operationMode: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => 'create',
-    }),
-    /** Introduction mode: pre-gathered entities (profiles + intents per party). */
-    introductionEntities: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => [],
-    }),
-    /** Introduction mode: optional hint from the introducer. */
-    introductionHint: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /** When set (e.g. chat scope), networkId must match this. */
-    requiredNetworkId: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /** Set by intro_evaluation; used by persist to build manual detection and introducer actor. */
-    introductionContext: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /** Target opportunity ID for update/delete/send modes. */
-    opportunityId: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /** New status for update mode (e.g. 'accepted', 'rejected'). */
-    newStatus: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    // ─── Intermediate Fields (Accumulated) ───
-    /** User's indexed intents with hyde documents (from prep) */
-    indexedIntents: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => [],
-    }),
-    /** User's network memberships (from prep) */
-    userNetworks: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => [],
-    }),
-    /** Target indexes to search within (from scope) */
-    targetNetworks: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => [],
-    }),
-    /** Per-index relevancy scores for dedup tie-breaking. Background path: from intent_indexes. Chat path: transient from IntentIndexer. */
-    indexRelevancyScores: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => ({}),
-    }),
-    /** Whether discovery used intent (path A) or user context (path B/C). Used by persist for triggeredBy. In-memory routing state only; never persisted. */
-    discoverySource: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => 'intent',
-    }),
-    /** Resolved intent ID used for this discovery run (when discoverySource is 'intent'). Set by intent-resolution. */
-    resolvedTriggerIntentId: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /** Asker's profile (from prep). Used for profile-as-source discovery and evaluation. */
-    sourceProfile: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => null,
-    }),
-    /** User's active premises with embeddings (from prep). Used for premise-to-premise discovery path D. */
-    sourcePremises: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => [],
-    }),
-    /** User context embeddings per network (from prep). Used for context-to-intent discovery. */
-    sourceContexts: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => [],
-    }),
-    /** Resolved intent is in at least one target index (path A vs C). */
-    resolvedIntentInIndex: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => false,
-    }),
-    /** Create-intent signal: when true, tool should return createIntentSuggested so agent can auto-call create_intent. */
-    createIntentSuggested: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => false,
-    }),
-    /** Suggested description for create_intent when createIntentSuggested is true. */
-    suggestedIntentDescription: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /** HyDE embeddings per lens label (from discovery) */
-    hydeEmbeddings: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => ({}),
-    }),
-    /** Candidate matches from semantic search (from discovery) */
-    candidates: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => [],
-    }),
-    /** Candidates not yet evaluated (for pagination -- cached in Redis by caller). */
-    remainingCandidates: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => [],
-    }),
-    /** Discovery session ID for pagination (maps to Redis cache key). */
-    discoveryId: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => null,
-    }),
-    /** Evaluated candidates with scores (from evaluation; legacy) */
-    evaluatedCandidates: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => [],
-    }),
-    /** Evaluated opportunities with actors (from entity-bundle evaluator) */
-    evaluatedOpportunities: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => [],
-    }),
-    // ─── Output Fields (Overwrite per turn) ───
-    /** Final ranked and persisted opportunities */
-    opportunities: Annotation({
-        reducer: (curr, next) => next,
-        default: () => [],
-    }),
-    /** Discovery path: pairs skipped because an opportunity already exists between viewer and candidate (no duplicate created). */
-    existingBetweenActors: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => [],
-    }),
-    /** Typed persist-node counts used by queue telemetry. */
-    persistenceOutcome: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /** Positive exact-successor receipt for a fenced continuation. */
-    negotiationContinuationReceipt: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => undefined,
-    }),
-    /** Error message if any step fails */
-    error: Annotation({
-        reducer: (curr, next) => next,
-        default: () => undefined,
-    }),
-    /** Output for read mode: enriched list of opportunities. */
-    readResult: Annotation({
-        reducer: (curr, next) => next,
-        default: () => undefined,
-    }),
-    /** Output for update/delete/send modes. */
-    mutationResult: Annotation({
-        reducer: (curr, next) => next,
-        default: () => undefined,
-    }),
-    // ─── Trace Output ───
-    /**
-     * Accumulated trace entries from each graph node.
-     * Used for observability: surfaces internal processing steps (search query, HyDE strategies,
-     * candidates found, evaluation results) to the frontend.
-     */
-    trace: Annotation({
-        reducer: (curr, next) => [...curr, ...(next || [])],
-        default: () => [],
-    }),
-    /** Timing records for each agent invocation within this graph run. */
-    agentTimings: Annotation({
-        reducer: (acc, val) => [...acc, ...val],
-        default: () => [],
-    }),
-    /**
-     * Per-candidate negotiation records captured by `negotiateNode`. Populated
-     * regardless of accept/reject so the question generator sees a complete
-     * picture. Empty when the negotiate node was skipped (no opportunities to
-     * negotiate).
-     */
-    discoveryNegotiations: Annotation({
-        reducer: (curr, next) => [...curr, ...(next || [])],
-        default: () => [],
-    }),
-    /** Aggregate counters across `discoveryNegotiations`. Built in the negotiate node. */
-    discoverySummary: Annotation({
-        reducer: (_curr, next) => next ?? null,
-        default: () => null,
-    }),
-});

package/dist/opportunities/opportunity.tools.cards.d.ts

@@ -1,138 +0,0 @@
-/**
- * Card rendering and link minting for the opportunity tools.
- *
- * These are the pieces both `list_opportunities` and the mutation tools reach
- * for: the deep links, the minimal fallback card, and the small guards that
- * shape tool error payloads.
- */
-import { type OpportunityOwnerAction, type OpportunityOwnerApprovalVerdict } from "./opportunity.owner-approval.js";
-export declare function stripLeadingNarratorName(remark: string, narratorName: string): string;
-import type { Opportunity } from "../shared/interfaces/database.interface.js";
-export declare const logger: import("../shared/observability/log.js").LoggerWithSource;
-/**
- * Build the agent-facing profile link for a counterpart — always the Index web
- * profile URL with `?link_preview=false`. Returns `undefined` only if
- * `frontendUrl` is not configured.
- *
- * The `?link_preview=false` hint is honored by chat-gateway runtimes (e.g.
- * OpenClaw's Telegram delivery) that strip link previews when present in the
- * URL; consistent placement matters more than Telegram's own handling.
- *
- * Trailing slashes on frontendUrl are stripped before concatenation.
- */
-export declare function buildProfileUrl(counterpartUserId: string, frontendUrl: string | undefined): string | undefined;
-/**
- * Build the deep-link to an opportunity's A2A negotiation trace
- * (`/chat/:conversationId`) so users can see *what negotiation led to* the
- * surfaced opportunity (EDG-50/EDG-51). Returns `undefined` when `frontendUrl`
- * is unset or there is no negotiation conversation to link to.
- *
- * The `?link_preview=false` hint mirrors `buildProfileUrl` — chat-gateway
- * runtimes (e.g. Telegram delivery) strip link previews when it is present.
- * Trailing slashes on `frontendUrl` are stripped before concatenation.
- */
-export declare function buildNegotiationUrl(conversationId: string | undefined, frontendUrl: string | undefined): string | undefined;
-/**
- * Build the agent-facing deep link for an opportunity — the canonical
- * `https://index.network/o/<id>` universal link. Returns `undefined` when
- * `frontendUrl` is unset or there is no opportunity id.
- *
- * This is the *only* place the protocol mints an opportunity deep link. It is
- * a navigation link, not an authority: opening it raises the opportunity card
- * in the Index macOS app when installed and a static Index landing page
- * otherwise. Acceptance stays an authenticated call.
- *
- * No `?link_preview=false` hint here (unlike `buildProfileUrl`): the Hermes
- * plugin mints the identical bare form for payloads the protocol does not
- * touch, and keeping the two byte-identical is what makes its never-overwrite
- * rule invisible.
- */
-export declare function buildOpportunityAppUrl(opportunityId: string, frontendUrl: string | undefined): string | undefined;
-/**
- * Attach the agent-facing profile link for a counterpart to `card` (mutates
- * in place). Every counterpart has a profile page worth linking to — without
- * this, the agent gets a name with no URL attached and tends to fabricate
- * one. Accept/act guidance is plain text ("accept in the Index app"); no
- * actionable URLs are minted here.
- */
-export declare function attachProfileLink(card: Record<string, unknown> & {
-    opportunityId: string;
-}, opts: {
-    counterpartUserId: string;
-    frontendUrl: string | undefined;
-}): void;
-/**
- * Attach the opportunity deep link to `card` (mutates in place) so every MCP
- * client — Claude Desktop, the CLI, the web, Hermes — can hand the user one
- * clickable link to the card instead of fabricating one from an id.
- */
-export declare function attachOpportunityAppLink(card: Record<string, unknown> & {
-    opportunityId: string;
-}, opts: {
-    frontendUrl: string | undefined;
-}): void;
-/**
- * IND-593: stable fail-closed denial for the owner-approval boundary. The
- * `missing` reason carries the fresh, server-derived interaction challenge the
- * owner must explicitly approve; all other reasons carry no challenge.
- */
-export declare function ownerApprovalDenial(opportunityId: string, action: OpportunityOwnerAction, verdict: Extract<OpportunityOwnerApprovalVerdict, {
-    kind: 'denied';
-}>): string;
-/**
- * Maximum number of opportunity cards to show per chat response.
- * Sized for `selectByComposition` to fill both feed buckets — up to 3
- * connection + 3 connector-flow per the digest/ambient prompt rules.
- */
-export declare const CHAT_DISPLAY_LIMIT = 6;
-/**
- * Build minimal opportunity card data for chat without calling the LLM presenter.
- * Uses only required fields from the opportunity record and counterpart name/avatar
- * so list_opportunities and discovery return quickly.
- *
- * Note: narratorChip.text is generated via regex heuristics (narratorRemarkFromReasoning)
- * rather than the OpportunityPresenter LLM. If narrator quality becomes an issue again,
- * consider making this function async and delegating to OpportunityPresenter.presentCard()
- * which already produces a high-quality narratorRemark via LLM (used by the home graph
- * and discovery pipeline). The trade-off is 5-20s latency per card.
- *
- * Exported for use in tests (opportunity.tools.spec.ts).
- */
-export declare function buildMinimalOpportunityCard(opp: Opportunity, viewerId: string, counterpartUserId: string, counterpartName: string, counterpartAvatar: string | null, introducerName?: string | null, introducerAvatar?: string | null, viewerName?: string, secondPartyName?: string, secondPartyAvatar?: string | null, secondPartyUserId?: string): {
-    opportunityId: string;
-    userId: string;
-    name: string;
-    avatar: string | null;
-    mainText: string;
-    cta: string;
-    headline: string;
-    primaryActionLabel: string;
-    secondaryActionLabel: string;
-    mutualIntentsLabel: string;
-    narratorChip: {
-        name: string;
-        text: string;
-        avatar?: string | null;
-        userId?: string;
-    };
-    viewerRole: string;
-    score: number | undefined;
-    status: string;
-    secondParty?: {
-        name: string;
-        avatar?: string | null;
-        userId?: string;
-    };
-};
-/**
- * Stable, retry-classified error codes for `confirm_opportunity_delivery`.
- *
- * The plain `error()` envelope only carries a human message, which forced
- * callers (the Hermes digest sweep) to treat every failure — permanent or
- * transient — as retryable, and made "already delivered but never confirmed"
- * impossible to distinguish from "opportunity deleted". Each code carries an
- * explicit `retryable` flag so deterministic callers can retry transient
- * failures and drop permanent ones instead of re-spamming the ledger.
- */
-export type ConfirmDeliveryErrorCode = "unauthenticated" | "ledger_unavailable" | "invalid_opportunity_id" | "opportunity_not_found" | "not_authorized" | "confirm_failed";
-export declare function confirmDeliveryError(code: ConfirmDeliveryErrorCode, retryable: boolean, message: string): string;

package/dist/opportunities/opportunity.tools.cards.js

@@ -1,212 +0,0 @@
-/**
- * Card rendering and link minting for the opportunity tools.
- *
- * These are the pieces both `list_opportunities` and the mutation tools reach
- * for: the deep links, the minimal fallback card, and the small guards that
- * shape tool error payloads.
- */
-import { MINIMAL_MAIN_TEXT_MAX_CHARS, getPrimaryActionLabel, SECONDARY_ACTION_LABEL } from "./opportunity.labels.js";
-import { narratorRemarkFromReasoning, safeFallbackSummary } from "./opportunity.presentation.js";
-export function stripLeadingNarratorName(remark, narratorName) {
-    let t = remark.trim();
-    if (!t || !narratorName.trim())
-        return remark;
-    const name = narratorName.trim();
-    const nameLower = name.toLowerCase();
-    for (;;) {
-        const lower = t.toLowerCase();
-        if (!lower.startsWith(nameLower))
-            break;
-        // Require a word boundary after the name so a short name like "Al" does not
-        // mangle a longer word ("Always …" → "ways …"). The char after the name must
-        // be a separator (sentence/clause punctuation or whitespace) or end of string.
-        // Keep this set in sync with the separator stripped from `rest` below.
-        const boundary = t.charAt(name.length);
-        if (boundary && !/[\s.:,\-–—]/.test(boundary))
-            break;
-        const rest = t.slice(name.length).replace(/^\s*[.:,\-–—]\s*/i, '').trim();
-        if (rest.length === 0 || rest === t)
-            break;
-        t = rest;
-    }
-    return t;
-}
-import { protocolLogger } from "../shared/observability/protocol.logger.js";
-export const logger = protocolLogger("ChatTools:Opportunity");
-/**
- * Build the agent-facing profile link for a counterpart — always the Index web
- * profile URL with `?link_preview=false`. Returns `undefined` only if
- * `frontendUrl` is not configured.
- *
- * The `?link_preview=false` hint is honored by chat-gateway runtimes (e.g.
- * OpenClaw's Telegram delivery) that strip link previews when present in the
- * URL; consistent placement matters more than Telegram's own handling.
- *
- * Trailing slashes on frontendUrl are stripped before concatenation.
- */
-export function buildProfileUrl(counterpartUserId, frontendUrl) {
-    // The profile link is always the Index web profile, regardless of the
-    // counterpart's socials.
-    if (!frontendUrl)
-        return undefined;
-    const base = frontendUrl.replace(/\/+$/, "");
-    return `${base}/u/${counterpartUserId}?link_preview=false`;
-}
-/**
- * Build the deep-link to an opportunity's A2A negotiation trace
- * (`/chat/:conversationId`) so users can see *what negotiation led to* the
- * surfaced opportunity (EDG-50/EDG-51). Returns `undefined` when `frontendUrl`
- * is unset or there is no negotiation conversation to link to.
- *
- * The `?link_preview=false` hint mirrors `buildProfileUrl` — chat-gateway
- * runtimes (e.g. Telegram delivery) strip link previews when it is present.
- * Trailing slashes on `frontendUrl` are stripped before concatenation.
- */
-export function buildNegotiationUrl(conversationId, frontendUrl) {
-    if (!frontendUrl || !conversationId)
-        return undefined;
-    const base = frontendUrl.replace(/\/+$/, "");
-    return `${base}/chat/${conversationId}?link_preview=false`;
-}
-/**
- * Build the agent-facing deep link for an opportunity — the canonical
- * `https://index.network/o/<id>` universal link. Returns `undefined` when
- * `frontendUrl` is unset or there is no opportunity id.
- *
- * This is the *only* place the protocol mints an opportunity deep link. It is
- * a navigation link, not an authority: opening it raises the opportunity card
- * in the Index macOS app when installed and a static Index landing page
- * otherwise. Acceptance stays an authenticated call.
- *
- * No `?link_preview=false` hint here (unlike `buildProfileUrl`): the Hermes
- * plugin mints the identical bare form for payloads the protocol does not
- * touch, and keeping the two byte-identical is what makes its never-overwrite
- * rule invisible.
- */
-export function buildOpportunityAppUrl(opportunityId, frontendUrl) {
-    if (!frontendUrl || !opportunityId)
-        return undefined;
-    const base = frontendUrl.replace(/\/+$/, "");
-    return `${base}/o/${opportunityId}`;
-}
-/**
- * Attach the agent-facing profile link for a counterpart to `card` (mutates
- * in place). Every counterpart has a profile page worth linking to — without
- * this, the agent gets a name with no URL attached and tends to fabricate
- * one. Accept/act guidance is plain text ("accept in the Index app"); no
- * actionable URLs are minted here.
- */
-export function attachProfileLink(card, opts) {
-    const profileUrl = buildProfileUrl(opts.counterpartUserId, opts.frontendUrl);
-    if (profileUrl)
-        card.profileUrl = profileUrl;
-}
-/**
- * Attach the opportunity deep link to `card` (mutates in place) so every MCP
- * client — Claude Desktop, the CLI, the web, Hermes — can hand the user one
- * clickable link to the card instead of fabricating one from an id.
- */
-export function attachOpportunityAppLink(card, opts) {
-    const appUrl = buildOpportunityAppUrl(card.opportunityId, opts.frontendUrl);
-    if (appUrl)
-        card.appUrl = appUrl;
-}
-/**
- * IND-593: stable fail-closed denial for the owner-approval boundary. The
- * `missing` reason carries the fresh, server-derived interaction challenge the
- * owner must explicitly approve; all other reasons carry no challenge.
- */
-export function ownerApprovalDenial(opportunityId, action, verdict) {
-    return JSON.stringify({
-        success: false,
-        error: `Owner approval required for this opportunity ${action} (${verdict.reason}).`,
-        approval: {
-            code: "owner_approval_required",
-            reason: verdict.reason,
-            opportunityId,
-            action,
-            ...(verdict.challenge
-                ? { interactionId: verdict.challenge.interactionId, expiresAt: verdict.challenge.expiresAt }
-                : {}),
-        },
-    });
-}
-/**
- * Maximum number of opportunity cards to show per chat response.
- * Sized for `selectByComposition` to fill both feed buckets — up to 3
- * connection + 3 connector-flow per the digest/ambient prompt rules.
- */
-export const CHAT_DISPLAY_LIMIT = 6;
-/**
- * Build minimal opportunity card data for chat without calling the LLM presenter.
- * Uses only required fields from the opportunity record and counterpart name/avatar
- * so list_opportunities and discovery return quickly.
- *
- * Note: narratorChip.text is generated via regex heuristics (narratorRemarkFromReasoning)
- * rather than the OpportunityPresenter LLM. If narrator quality becomes an issue again,
- * consider making this function async and delegating to OpportunityPresenter.presentCard()
- * which already produces a high-quality narratorRemark via LLM (used by the home graph
- * and discovery pipeline). The trade-off is 5-20s latency per card.
- *
- * Exported for use in tests (opportunity.tools.spec.ts).
- */
-export function buildMinimalOpportunityCard(opp, viewerId, counterpartUserId, counterpartName, counterpartAvatar, introducerName, introducerAvatar, viewerName, secondPartyName, secondPartyAvatar, secondPartyUserId) {
-    const viewerActor = opp.actors.find((a) => a.userId === viewerId);
-    const viewerRole = viewerActor?.role ?? "party";
-    const introducerActor = opp.actors.find((a) => a.role === "introducer" && a.userId !== viewerId);
-    const viewerIsIntroducer = opp.actors.some((a) => a.role === "introducer" && a.userId === viewerId);
-    const reasoning = opp.interpretation?.reasoning ?? "";
-    // Shared sanitization standard — see opportunity.safe-presentation.ts.
-    const mainText = safeFallbackSummary(reasoning, {
-        counterpartName,
-        viewerName,
-        introducerName: introducerName ?? undefined,
-        maxChars: MINIMAL_MAIN_TEXT_MAX_CHARS,
-        emptyText: "A suggested connection.",
-    });
-    const score = typeof opp.interpretation?.confidence === "number"
-        ? opp.interpretation.confidence
-        : undefined;
-    const narratorName = viewerIsIntroducer
-        ? "You"
-        : introducerName?.trim() || (introducerActor ? "Someone" : "Index");
-    const primaryActionLabel = getPrimaryActionLabel(viewerRole);
-    return {
-        opportunityId: opp.id,
-        userId: counterpartUserId,
-        name: counterpartName,
-        avatar: counterpartAvatar,
-        mainText,
-        cta: "Start a conversation to connect.",
-        headline: viewerIsIntroducer && secondPartyName
-            ? `${counterpartName} → ${secondPartyName}`
-            : `Connection with ${counterpartName}`,
-        primaryActionLabel,
-        secondaryActionLabel: SECONDARY_ACTION_LABEL,
-        mutualIntentsLabel: "Suggested connection",
-        narratorChip: {
-            name: narratorName,
-            text: narratorRemarkFromReasoning(reasoning, counterpartName, viewerName),
-            ...(viewerIsIntroducer
-                ? { userId: viewerId, avatar: null }
-                : introducerActor
-                    ? { userId: introducerActor.userId, avatar: introducerAvatar ?? null }
-                    : {}),
-        },
-        viewerRole,
-        score,
-        status: opp.status ?? "latent",
-        ...(viewerIsIntroducer && secondPartyName
-            ? {
-                secondParty: {
-                    name: secondPartyName,
-                    ...(secondPartyAvatar != null ? { avatar: secondPartyAvatar } : {}),
-                    ...(secondPartyUserId ? { userId: secondPartyUserId } : {}),
-                },
-            }
-            : {}),
-    };
-}
-export function confirmDeliveryError(code, retryable, message) {
-    return JSON.stringify({ success: false, error: message, code, retryable });
-}

package/dist/opportunities/opportunity.tools.d.ts

@@ -1,12 +0,0 @@
-/**
- * The opportunity tool registry: list, update, and delivery confirmation.
- *
- * `list_opportunities` lives in `opportunity.tools.list.ts` and the shared card
- * and link helpers in `opportunity.tools.cards.ts`; this file wires the three
- * tools together and owns the two mutation tools.
- */
-import type { DefineTool } from "../shared/agent/tool.helpers.js";
-import type { OpportunityToolDeps } from "./opportunity.tools.port.js";
-export { buildOpportunityPresentation } from "./opportunity.presentation.js";
-export { attachOpportunityAppLink, attachProfileLink, buildMinimalOpportunityCard, buildNegotiationUrl, buildOpportunityAppUrl, buildProfileUrl } from "./opportunity.tools.cards.js";
-export declare function createOpportunityTools(defineTool: DefineTool, deps: OpportunityToolDeps): readonly [any, any, any];