@indexnetwork/protocol 6.12.0-rc.403.1 → 6.13.22-rc.405.1

package/dist/opportunity/opportunity.state.js

@@ -1,310 +1,5 @@
-import { Annotation } from "@langchain/langgraph";
 /**
- * Resolves the initial status for opportunities created in the persist node.
- *
- * Explicit `options.initialStatus` always wins (callers like the chat tool or
- * maintenance scripts override per-call). When the caller leaves it
- * undefined, the trigger drives the default:
- * - 'orchestrator' → 'negotiating' (chat-driven; negotiations run before the
- *   user sees a draft card).
- * - 'ambient' (or any other trigger) → 'pending' (long-standing default for
- *   queue- and intent-driven discovery).
- *
- * Lives here rather than in opportunity.graph.ts so unit tests can exercise
- * it without pulling in the full graph (and the evaluator's LLM requirements).
- *
- * @param trigger - The graph invocation's trigger
- * @param explicit - Caller-supplied initial status from options.initialStatus
+ * Thin backward-compat shim — IND-551.
+ * Canonical location: opportunity/domain/opportunity.state.ts
  */
-export function resolveInitialStatus(trigger, explicit) {
-    if (explicit !== undefined)
-        return explicit;
-    return trigger === 'orchestrator' ? 'negotiating' : 'pending';
-}
-/**
- * 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: () => ({}),
-    }),
-    /**
-     * Which flow triggered this graph invocation. See {@link OpportunityTrigger}
-     * for the exact branch behavior and {@link resolveInitialStatus} for the
-     * persist default when `options.initialStatus` is unset.
-     *
-     * - 'ambient' (default): queue-driven, persist default `pending`, 5-min
-     *   park window, no streaming, ignores abort.
-     * - 'orchestrator': chat-driven, persist default `negotiating`, 60s park
-     *   window, streams `opportunity_draft_ready` events, honors abort.
-     */
-    trigger: Annotation({
-        reducer: (curr, next) => next ?? curr,
-        default: () => 'ambient',
-    }),
-    /**
-     * Accepted opportunities the persist node discovered between the discoverer
-     * and a candidate actor (same pair, status='accepted'). The orchestrator
-     * branch populates this so the discover_opportunities tool (Task 7) can tell
-     * the LLM "these pairs are already connected, surface the existing chat
-     * rather than creating a new draft". Always empty for the ambient trigger.
-     *
-     * Left intentionally minimal — conversationId/URL resolution happens at
-     * Start Chat time (Task 8), not here.
-     */
-    dedupAlreadyAccepted: 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. Populated for ALL triggers (ambient + orchestrator) since the
-     * negotiate node's `onCandidateResolved` hook is unconditional; only the
-     * orchestrator streaming side-effects (opportunity_draft_ready emission)
-     * are trigger-gated. 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,
-    }),
-});
-//# sourceMappingURL=opportunity.state.js.map
+export * from "./domain/opportunity.state.js";

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

@@ -1,159 +1,5 @@
-import type { DefineTool, ToolDeps } from "../shared/agent/tool.helpers.js";
-import type { Opportunity } from "../shared/interfaces/database.interface.js";
-import type { ConnectLinkKind } from "../shared/interfaces/connect-link.interface.js";
 /**
- * Pure status × role → ConnectLinkKind matrix.
- *
- * Returns the kind of short-link the viewer can act on directly, or `null` if
- * no direct link makes sense for this combination. Non-null kinds map to:
- *
- * - `connect` — pending opp where viewer is a non-introducer party. Clicking
- *   flips the opp to accepted and opens the chat with the counterpart.
- * - `approve_introduction` — draft or latent opp where viewer is an unapproved
- *   introducer. Clicking flips approved=true and triggers negotiation. The
- *   `draft` case comes from `discover_opportunities` intro mode; the `latent`
- *   case comes from background-discovered connector-flow cards surfaced in
- *   `list_opportunities`. In both, status remains pre-send and the `/c/<code>`
- *   link is the only MCP path to approve.
- * - `outreach` — accepted opp where viewer is a non-introducer party.
- *   Clicking opens the existing chat (no state change).
- * - `send_direct` — draft or latent opp where viewer is a non-introducer
- *   party. Issued by `discover_opportunities` in direct (no-introducer)
- *   mode: the match has already passed evaluation, the row exists in
- *   draft state, and the sender just needs to release it. Clicking flips
- *   the opp straight to accepted and opens the chat with a greeting —
- *   same handler path as `connect`. The counterpart's side sees the new
- *   accepted opp and can engage or ignore.
+ * Thin backward-compat shim — IND-551.
+ * Canonical location: opportunity/application/opportunity.tools.ts
  */
-export declare function resolveActionableLinkKind(input: {
-    status: string;
-    viewerRole: string;
-    viewerApproved?: boolean;
-    viewerActedAt?: string | null;
-}): ConnectLinkKind | null;
-/**
- * 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;
-/**
- * Mint a short-link for `card` if the (status, viewerRole, viewerApproved)
- * combination is actionable; mutate the card in place with `acceptUrl`,
- * `profileUrl`, and `feedCategory`. No-op (and no DB call) if not actionable.
- *
- * Swallows mint errors after logging — the card is still returned without an
- * `acceptUrl`, matching the prior `list_opportunities` resilience behavior.
- */
-export declare function attachActionableLinks(card: Record<string, unknown> & {
-    opportunityId: string;
-    viewerRole: string;
-    status: string;
-}, opts: {
-    viewerId: string;
-    viewerApproved?: boolean;
-    viewerActedAt?: string | null;
-    counterpartUserId: string;
-    mintConnectLink: NonNullable<ToolDeps["mintConnectLink"]>;
-    frontendUrl: string | undefined;
-    preferredSurface?: 'telegram' | 'web';
-}): Promise<void>;
-/**
- * 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.presentHomeCard()
- * 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, isCounterpartGhost?: boolean): {
-    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;
-    isGhost: boolean;
-    secondParty?: {
-        name: string;
-        avatar?: string | null;
-        userId?: string;
-    };
-};
-/**
- * Minimal shape consumed by buildOpportunityPresentation for prose rendering.
- * Card data objects in the codebase carry additional frontend-only fields;
- * only these are surfaced to MCP agents.
- */
-type OpportunityCardLike = Record<string, unknown> & {
-    opportunityId: string;
-    userId?: string | undefined;
-    name?: string | undefined;
-    mainText?: string | undefined;
-    digestSummary?: string | undefined;
-    status?: string | undefined;
-    feedCategory?: string | undefined;
-    acceptUrl?: string | undefined;
-    profileUrl?: string | undefined;
-    /** Deep-link to the A2A negotiation trace that produced this opportunity. */
-    negotiationUrl?: string | undefined;
-    score?: number | undefined;
-    /** Digest-mode cooldown re-show — the user has seen this card before. */
-    redelivery?: boolean | undefined;
-};
-export declare function buildOpportunityPresentation(inputCards: OpportunityCardLike[], opts: {
-    isMcp: boolean;
-    leadIn: string;
-    label?: "opportunity" | "opportunities";
-    /** Include hidden digest metadata markers so scheduled brief tooling can confirm delivery. */
-    includeDigestMarkers?: boolean;
-}): 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 createOpportunityTools(defineTool: DefineTool, deps: ToolDeps): readonly [any, any, any, any, any, any];
-export {};
-//# sourceMappingURL=opportunity.tools.d.ts.map
+export * from "./application/opportunity.tools.js";