@indexnetwork/protocol 22.0.0-rc.499.1 → 64.0.0

package/dist/{shared → internal/shared}/observability/log.js

@@ -1,29 +1,20 @@
 /**
  * Protocol-internal logging module.
  *
- * Self-contained — no imports from outside the protocol library.
- * Ships with a minimal console-based default. The host application can
- * call `setLoggerFactory()` at startup to wire in a richer implementation
- * (e.g. the project-wide `log` utility with ANSI colors, context filtering,
- * and embedding redaction).
+ * The package emits through a host-provided logger factory. It intentionally
+ * has no console or vendor logger implementation; hosts wire their own logger.
  */
 // ═══════════════════════════════════════════════════════════════════════════════
 // DEFAULT IMPLEMENTATION
 // ═══════════════════════════════════════════════════════════════════════════════
 function defaultCreateLogger(_context, source) {
-    const prefix = `[${source}]`;
-    const emit = (sink, msg, meta) => sink(prefix, msg, ...(meta ? [sanitizeFn(meta)] : []));
+    void source;
     return {
-        // eslint-disable-next-line no-console
-        verbose: (msg, meta) => emit(console.debug, msg, meta),
-        // eslint-disable-next-line no-console
-        debug: (msg, meta) => emit(console.debug, msg, meta),
-        // eslint-disable-next-line no-console
-        info: (msg, meta) => emit(console.info, msg, meta),
-        // eslint-disable-next-line no-console
-        warn: (msg, meta) => emit(console.warn, msg, meta),
-        // eslint-disable-next-line no-console
-        error: (msg, meta) => emit(console.error, msg, meta),
+        verbose: () => { },
+        debug: () => { },
+        info: () => { },
+        warn: () => { },
+        error: () => { },
     };
 }
 /** Truncation limits for the default (host-less) sanitizer — never dump big payloads. */
@@ -78,7 +69,7 @@ let factoryGeneration = 0;
  * ```
  */
 export function setLoggerFactory(factory, sanitize) {
-    createLoggerFn = factory;
+    createLoggerFn = factory ?? defaultCreateLogger;
     if (sanitize)
         sanitizeFn = sanitize;
     factoryGeneration++;

package/dist/{shared → internal/shared}/observability/protocol.logger.d.ts

@@ -6,7 +6,7 @@
  */
 import type { LoggerWithSource } from "./log.js";
 export type { LoggerWithSource };
-/** Create a protocol logger for a given source (e.g. "ChatTools", "DiscoverNodes"). */
+/** Create a protocol logger for a given source (e.g. "IntentGraph", "DiscoverNodes"). */
 export declare function protocolLogger(source: string): LoggerWithSource;
 export interface CallLogOptions {
     /** Log full output on success (default: true). Set false for very large payloads. */

package/dist/{shared → internal/shared}/observability/protocol.logger.js

@@ -5,7 +5,7 @@
  * outputs (or summary) + duration at end.
  */
 import { log, sanitizeForLog } from "./log.js";
-/** Create a protocol logger for a given source (e.g. "ChatTools", "DiscoverNodes"). */
+/** Create a protocol logger for a given source (e.g. "IntentGraph", "DiscoverNodes"). */
 export function protocolLogger(source) {
     return log.protocol.from(source);
 }

package/dist/internal/shared/observability/request-context.d.ts

@@ -0,0 +1,29 @@
+import type { RequestContext, RequestContextStore } from "../../../platform/runtime/observability.js";
+/**
+ * Callback for streaming trace events from deep inside graph nodes back to
+ * the caller (typically chat.agent's stream pipeline). Kept as a single emitter
+ * to minimize AsyncLocalStorage plumbing.
+ */
+export type TraceEmitter = (event: {
+    type: "graph_start" | "graph_end" | "agent_start" | "agent_end";
+    name: string;
+    durationMs?: number;
+    summary?: string;
+} | {
+    type: "status";
+    message: string;
+}) => void;
+type ProtocolRequestContext = Omit<RequestContext, "traceEmitter"> & {
+    traceEmitter?: TraceEmitter;
+};
+/** Configure host-owned request storage once during host composition. */
+export declare function setRequestContextStore(next: RequestContextStore | undefined): void;
+/**
+ * Compatibility request-context facade. Storage is owned by the consuming host;
+ * without a configured store it deliberately behaves as an empty context.
+ */
+export declare const requestContext: {
+    getStore(): ProtocolRequestContext | undefined;
+    run<T>(context: ProtocolRequestContext, operation: () => T): T;
+};
+export {};

package/dist/internal/shared/observability/request-context.js

@@ -0,0 +1,17 @@
+let store;
+/** Configure host-owned request storage once during host composition. */
+export function setRequestContextStore(next) {
+    store = next;
+}
+/**
+ * Compatibility request-context facade. Storage is owned by the consuming host;
+ * without a configured store it deliberately behaves as an empty context.
+ */
+export const requestContext = {
+    getStore() {
+        return store?.getStore();
+    },
+    run(context, operation) {
+        return store ? store.run(context, operation) : operation();
+    },
+};

package/dist/{shared → internal/shared}/utils/social-label.d.ts

@@ -1,4 +1,4 @@
-import type { UserSocial } from '../interfaces/database.interface.js';
+import type { UserSocial } from '../../../platform/database.js';
 /**
  * Infers a canonical social label from a URL or handle string.
  *
@@ -15,7 +15,7 @@ export interface EnrichmentRequest {
     websites?: string[];
 }
 /**
- * Converts a `UserSocial[]` array into the flat shape expected by enrichment tools.
+ * Converts a `UserSocial[]` array into the flat shape expected by profile enrichment.
  * Custom-labelled entries are collected into `websites[]`.
  *
  * @param socials - Row array from `user_socials`.

package/dist/{shared → internal/shared}/utils/social-label.js

@@ -17,7 +17,7 @@ export function detectSocialLabel(value) {
     return 'custom';
 }
 /**
- * Converts a `UserSocial[]` array into the flat shape expected by enrichment tools.
+ * Converts a `UserSocial[]` array into the flat shape expected by profile enrichment.
  * Custom-labelled entries are collected into `websites[]`.
  *
  * @param socials - Row array from `user_socials`.

package/dist/platform/database/capabilities.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Capability-narrowed views of {@link Database}.
+ *
+ * Graphs depend on these rather than the whole port so a graph's data reach is
+ * visible in one line.
+ */
+import type { NegotiationContextDatabase } from './negotiation.js';
+import type { Database } from '../database.js';
+/**
+ * Composite database interface for a host composition that reaches every
+ * subgraph (OpportunityGraph, IntentGraph, NetworkGraph).
+ *
+ * Access layer: Both UserDatabase + SystemDatabase (orchestrates all operations)
+ */
+export type CompositeDatabase = Pick<Database, 'getProfile' | 'openCounterparties' | 'getActiveIntents' | 'getActiveIntentsAcrossNetworks' | 'getIntentsInNetworkForMember' | 'getUser' | 'updateUser' | 'getUserSocials' | 'setUserSocials' | 'saveProfile' | 'createIntent' | 'updateIntent' | 'archiveIntent' | 'deleteIntentNetworkAssociations' | 'expireOpportunitiesByIntentActor' | 'transitionIntentLifecycle' | 'compensateFailedResume' | 'createOpportunity' | 'createOpportunityIfNetworkEligible' | 'createOpportunityAndExpireIdsIfNetworkEligible' | 'persistIntentScopedOpportunityIfNetworkEligible' | 'updateOpportunityStatusIfNetworkEligible' | 'getOpportunity' | 'getOpportunitiesByIds' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'getOpportunitiesForUser' | 'updateOpportunityStatus' | 'getOrCreateDM' | 'getIntent' | 'getPublicNetworksNotJoined' | 'getUserNetworkIds' | 'getAssignmentNetworkMembershipsForUser' | 'getAssignmentNetworkIdsForUser' | 'getNetworkMemberships' | 'getNetworkMembership' | 'getActiveNetworkMembershipPairs' | 'getNetwork' | 'getNetworkWithPermissions' | 'getIntentForIndexing' | 'getNetworkMemberContext' | 'getNetworkAssignmentContext' | 'isIntentAssignedToNetwork' | 'assignIntentToNetwork' | 'assignIntentToNetworkIfMember' | 'unassignIntentFromNetwork' | 'getNetworkIdsForIntent' | 'getIntentNetworkScores' | 'getOwnedNetworks' | 'isNetworkOwner' | 'isNetworkMember' | 'getNetworkMembersForOwner' | 'getNetworkMembersForMember' | 'getMembersFromUserNetworks' | 'getNetworkIntentsForOwner' | 'getNetworkIntentsForMember' | 'updateNetworkSettings' | 'softDeleteNetwork' | 'deleteProfile' | 'getProfileByUserId' | 'createNetwork' | 'getNetworkMemberCount' | 'addMemberToNetwork' | 'removeMemberFromNetwork' | 'getUserContext' | 'searchIntentsByContextEmbedding'> & NegotiationContextDatabase;
+/**
+ * Database interface for opportunity reads and lifecycle operations.
+ *
+ * Access layer: SystemDatabase (cross-user opportunity operations)
+ */
+export type OpportunityDatabase = Pick<Database, 'getProfile' | 'getOpportunity' | 'getOpportunitiesForUser' | 'getNetwork' | 'getUser' | 'isNetworkMember' | 'isNetworkOwner' | 'getOrCreateDM' | 'updateOpportunityStatus'>;
+export type OpportunityControllerDatabase = Pick<Database, 'getOpportunity' | 'getOpportunitiesByIds' | 'findEnrichedReplacementOpportunities' | 'getOpportunitiesForUser' | 'getOpportunitiesForNetwork' | 'resolveOpportunityId' | 'updateOpportunityStatus' | 'createOpportunity' | 'createOpportunityAndExpireIds' | 'opportunityExistsBetweenActors' | 'findOpportunitiesByActors' | 'isNetworkOwner' | 'isNetworkMember' | 'getUser' | 'getNetwork' | 'getNetworkMemberships' | 'getProfile' | 'getActiveIntents' | 'getOrCreateDM' | 'unhideConversation'>;
+/**
+ * Database interface narrowed for Intent Graph operations.
+ * Provides state population (getActiveIntents), action execution (create/update/archive),
+ * and read operations (query intents; getIntentsInNetworkForMember for network-scoped reads).
+ *
+ * Access layer: UserDatabase (mutations on own intents) + SystemDatabase (network-scoped reads)
+ */
+export type IntentGraphDatabase = Pick<Database, 'getActiveIntents' | 'getActiveIntentsAcrossNetworks' | 'getIntentsInNetworkForMember' | 'createIntent' | 'updateIntent' | 'archiveIntent' | 'isNetworkMember' | 'getNetworkIntentsForMember' | 'getUser' | 'assignIntentToNetworkIfMember' | 'deleteIntentNetworkAssociations' | 'expireOpportunitiesByIntentActor' | 'transitionIntentLifecycle' | 'compensateFailedResume'>;
+/**
+ * Database interface narrowed for Network Graph CRUD operations.
+ * Handles create, read, update, delete of networks (communities).
+ *
+ * Access layer: UserDatabase (CRUD on own networks and memberships)
+ */
+export type NetworkGraphDatabase = Pick<Database, 'getNetworkMemberships' | 'getOwnedNetworks' | 'getPublicNetworksNotJoined' | 'isNetworkOwner' | 'isNetworkMember' | 'getNetwork' | 'createNetwork' | 'addMemberToNetwork' | 'updateNetworkSettings' | 'softDeleteNetwork' | 'getNetworkMemberCount'>;
+/**
+ * Database interface narrowed for Intent Network Graph operations.
+ * Provides intent/network context and assignment for intent–network evaluation.
+ * (Migrated from the old NetworkGraphDatabase.)
+ *
+ * Access layer: UserDatabase (own intent assignment) + SystemDatabase (network context)
+ */
+export type IntentNetworkGraphDatabase = Pick<Database, 'getIntentForIndexing' | 'getNetworkMemberContext' | 'getNetworkAssignmentContext' | 'getNetwork' | 'isIntentAssignedToNetwork' | 'assignIntentToNetworkIfMember' | 'unassignIntentFromNetwork' | 'getIntent' | 'isNetworkMember' | 'isNetworkOwner' | 'getNetworkIdsForIntent' | 'getNetworkIntentsForMember' | 'getIntentsInNetworkForMember'>;
+/**
+ * Database interface narrowed for Network Membership Graph operations.
+ * Handles CRUD for network memberships (add, list, remove members).
+ *
+ * Access layer: SystemDatabase (cross-user membership operations)
+ */
+export type NetworkMembershipGraphDatabase = Pick<Database, 'isNetworkMember' | 'isNetworkOwner' | 'getNetworkWithPermissions' | 'addMemberToNetwork' | 'removeMemberFromNetwork' | 'getNetworkMembersForMember'>;
+/**
+ * Database interface for Radar Graph (opportunity radar view).
+ * Load opportunities, enrich with profile/network, and support presenter context.
+ *
+ * Access layer: UserDatabase (own opportunities and profile)
+ */
+export type RadarGraphDatabase = Pick<Database, 'getOpportunitiesForUser' | 'getOpportunity' | 'getProfile' | 'getActiveIntents' | 'getNetwork' | 'getUser'> & NegotiationContextDatabase;

package/dist/{shared/interfaces/database.entities.d.ts → platform/database/entities.d.ts}

@@ -5,31 +5,49 @@
  * the port, the two access-scoped views, and every capability-narrowed alias in
  * one file. Import from `database.interface.js` — it re-exports all of them.
  */
-import type { ScopeMembership } from '../agent/tool.scope.js';
+import type { ScopeMembership } from '../../protocol/core.js';
+import type { OpportunityEvidence } from '../../protocol/schemas/network-assignment.schema.js';
 /** Branded string ID for type-safe entity references (keyed by Drizzle table name). */
 export type Id<T extends string = string> = string & {
     readonly __table?: T;
 };
-export interface OnboardingProfileSeed {
-    source: 'experiment_signup' | 'experiment_csv_import';
-    networkId: string;
-    capturedAt: string;
-    name?: string;
-    bio?: string;
-    location?: string;
-    socials?: {
-        label: string;
-        value: string;
-    }[];
+/**
+ * A pair discovery scored and is about to open.
+ *
+ * This is a payload, not a stored entity: discovery hands the host the pair and
+ * the host writes the opportunity and its negotiation. `pairKey` is what makes
+ * that idempotent — both principals' runs produce the same key, so the second
+ * one through finds the first one's negotiation instead of opening a second.
+ */
+export interface CreateIntentCounterpartyData {
+    pairKey: string;
+    networkId: Id<'networks'>;
+    intentA: Id<'intents'>;
+    intentB: Id<'intents'>;
+    userA: Id<'users'>;
+    userB: Id<'users'>;
+    score: number;
+    reasoning: string;
+    evidence: OpportunityEvidence[];
+}
+/**
+ * A pair that just became an opportunity with a negotiation beside it. The
+ * initiator is side A — whichever side's discovery run reached the pair first —
+ * and it owes the first turn.
+ */
+export interface OpenedNegotiation {
+    opportunityId: Id<'opportunities'>;
+    negotiationId: string;
+    initiatorUserId: Id<'users'>;
+    initiatorIntentId: Id<'intents'>;
 }
 export interface NetworkAssignmentContext {
     networkId: string;
-    indexPrompt: string | null;
+    networkPrompt: string | null;
     memberPrompt: string | null;
 }
 export interface AssignmentNetworkMembership extends ScopeMembership {
     networkId: string;
-    isPersonal: boolean;
 }
 /** Final-authority result for an existing intent-to-network assignment. */
 export type IntentNetworkFinalAssignmentResult = {
@@ -50,7 +68,6 @@ export interface OnboardingState {
     currentStep?: 'profile' | 'summary' | 'connections' | 'create_network' | 'invite_members' | 'join_networks' | 'first_signal' | 'complete';
     networkId?: string;
     invitationCode?: string;
-    profileSeeds?: OnboardingProfileSeed[];
 }
 /** Single social-link row from the user_socials table. */
 export interface UserSocial {
@@ -61,7 +78,7 @@ export interface UserSocial {
 }
 /** Detection metadata recorded when an opportunity is created. */
 export interface OpportunityDetection {
-    source: 'opportunity_graph' | 'chat' | 'manual' | 'cron' | 'member_added' | 'enrichment' | 'introducer_discovery';
+    source: 'opportunity_graph' | 'chat' | 'cron' | 'member_added';
     createdBy?: Id<'users'> | string;
     createdByName?: string;
     triggeredBy?: Id<'intents'>;
@@ -73,31 +90,13 @@ export interface OpportunityActor {
     networkId: Id<'networks'>;
     userId: Id<'users'>;
     intent?: Id<'intents'>;
-    /** Which premise grounded this match (set when discoverySource is 'premise-similarity'). */
-    premise?: Id<'premises'>;
     role: string;
-    /** Only set on role === 'introducer'. false until the introducer explicitly approves; true after approval. */
-    approved?: boolean;
-    /**
-     * ISO-8601 timestamp set the first time this actor advanced the opportunity's
-     * state (patient sending, agent accepting, peer "accepting" on draft = sending
-     * under the hood, peer accepting on pending, introducer sending). Once set,
-     * this actor has committed and cannot be the one to subsequently `accept` the
-     * same opportunity — enforced by the self-accept guard in `updateNode`.
-     */
-    actedAt?: string;
 }
 /** Individual signal contributing to an opportunity score. */
 export interface OpportunitySignal {
     type: string;
     weight: number;
     detail?: string;
-    /** Optional source question for reversible pool-preference provenance. */
-    questionId?: string;
-    /** Recipient provenance for pool-discriminator signals. */
-    recipientUserId?: string;
-    /** Intent-pool provenance for pool-discriminator signals. */
-    intentId?: string;
 }
 /** LLM-generated interpretation of an opportunity's category and confidence. */
 export interface OpportunityInterpretation {
@@ -136,12 +135,12 @@ export interface ActiveIntent {
     summary: string | null;
     /** When the intent was created */
     createdAt: Date;
-    /** Relevancy score for this intent in its index context (0.0–1.0, null if not scored) */
+    /** Relevancy score for this intent in its network context (0.0–1.0, null if not scored) */
     relevancyScore?: number | null;
 }
 /**
  * Input data for creating a new intent.
- * Supports the full intent pipeline including embedding and index association.
+ * Supports the full intent pipeline including embedding and network association.
  */
 export interface CreateIntentData {
     /** The user who owns this intent */
@@ -157,7 +156,7 @@ export interface CreateIntentData {
     /** Network IDs to associate with (optional, uses dynamic scoping if empty) */
     networkIds?: string[];
     /** Source type for provenance tracking */
-    sourceType?: 'file' | 'integration' | 'link' | 'discovery_form' | 'enrichment';
+    sourceType?: 'integration' | 'discovery_form' | 'enrichment';
     /** Source ID for provenance tracking */
     sourceId?: string;
     /** Confidence score from inference (0-1, required) */
@@ -192,7 +191,7 @@ export interface UpdateIntentData {
     embedding?: number[];
     /** Updated incognito status */
     isIncognito?: boolean;
-    /** Updated index associations (replaces existing) */
+    /** Updated network associations (replaces existing) */
     networkIds?: string[];
     /** Semantic entropy from verifier (0 specific -> 1 vague) */
     semanticEntropy?: number | null;
@@ -268,6 +267,28 @@ export interface ArchiveResult {
     /** Error message if failed */
     error?: string;
 }
+/** An intent's admission lifecycle status; null/legacy rows are ACTIVE. */
+export type IntentLifecycleStatus = 'ACTIVE' | 'PAUSED' | 'FULFILLED' | 'EXPIRED';
+/**
+ * Result of an atomic ACTIVE/PAUSED lifecycle transition.
+ */
+export type TransitionLifecycleResult = {
+    kind: 'success';
+    id: string;
+    status: 'ACTIVE' | 'PAUSED';
+    changed: boolean;
+    lifecycleVersionMs: number;
+} | {
+    kind: 'not_found';
+} | {
+    kind: 'scope_violation';
+} | {
+    kind: 'stale';
+} | {
+    kind: 'conflict';
+    status: IntentLifecycleStatus | null;
+    archived: boolean;
+};
 /**
  * Options for vector similarity search.
  */
@@ -278,76 +299,38 @@ export interface SimilarIntentSearchOptions {
     threshold?: number;
 }
 /**
- * Represents a user's membership in an index with full details.
- * Used for displaying network memberships in chat (index_query).
+ * Represents a user's membership in a network with full details.
+ * Used for displaying network memberships in chat (network_query).
  */
 export interface ActiveNetworkMembershipPair {
     userId: string;
     networkId: string;
 }
 export interface NetworkMembership {
-    /** Unique identifier of the index */
+    /** Unique identifier of the network */
     networkId: string;
-    /** Display title of the index */
+    /** Display title of the network */
     networkTitle: string;
-    /** Index description/prompt (what the community is about) */
-    indexPrompt: string | null;
+    /** Network description/prompt (what the community is about) */
+    networkPrompt: string | null;
     /** Member's permissions in this network */
     permissions: string[];
     /** Member's custom prompt (overrides network prompt for their intents) */
     memberPrompt: string | null;
     /** Whether new intents are auto-assigned to this network */
     autoAssign: boolean;
-    /** Whether this is the user's personal network ("My Network") */
-    isPersonal: boolean;
     /** When the user joined the network */
     joinedAt: Date;
 }
-export interface PremiseAssertion {
-    text: string;
-    tier: 'assertive' | 'contextual';
-    summary?: string;
-}
-export interface PremiseProvenance {
-    source: 'explicit' | 'enrichment' | 'integration' | 'onboarding';
-    sourceId?: string;
-    confidence: number;
-    timestamp: string;
-}
-export interface PremiseAnalysis {
-    speechActType: 'DECLARATIVE' | 'ASSERTIVE';
-    felicityAuthority: number;
-    felicitySincerity: number;
-    felicityClarity: number;
-    semanticEntropy: number;
-}
-export interface PremiseValidity {
-    validFrom?: string;
-    validUntil?: string;
-    volatile: boolean;
-}
-export interface PremiseRecord {
-    id: string;
-    userId: string;
-    assertion: PremiseAssertion;
-    provenance: PremiseProvenance;
-    analysis: PremiseAnalysis | null;
-    validity: PremiseValidity;
-    embedding: number[] | null;
-    status: 'ACTIVE' | 'RETRACTED' | 'EXPIRED';
-    createdAt: Date;
-    updatedAt: Date;
-    retractedAt: Date | null;
-}
 /**
- * Represents an index owned by the user with full details.
+ * Represents a network owned by the user with full details.
  */
-export interface OwnedIndex {
+export interface OwnedNetwork {
     /** Network ID */
     id: string;
     /** Display title */
     title: string;
-    /** Index purpose/scope prompt */
+    /** Network purpose/scope prompt */
     prompt: string | null;
     /** Cover image URL */
     imageUrl: string | null;
@@ -358,11 +341,9 @@ export interface OwnedIndex {
             code: string;
         } | null;
     };
-    /** Whether this is a personal network */
-    isPersonal: boolean;
-    /** When the index was created */
+    /** When the network was created */
     createdAt: Date;
-    /** When the index was last updated */
+    /** When the network was last updated */
     updatedAt: Date;
     /** Member count */
     memberCount: number;
@@ -382,7 +363,7 @@ export interface OwnedIndex {
 /**
  * Member details visible to network owners (and optionally to members with privacy rules).
  */
-export interface IndexMemberDetails {
+export interface NetworkMemberDetails {
     /** User ID */
     userId: string;
     /** User's display name */
@@ -405,7 +386,7 @@ export interface IndexMemberDetails {
 /**
  * Intent details visible to network owners.
  */
-export interface IndexedIntentDetails {
+export interface NetworkIntentDetails {
     /** Intent ID */
     id: string;
     /** Intent payload/description */
@@ -418,13 +399,13 @@ export interface IndexedIntentDetails {
     userName: string;
     /** When the intent was created */
     createdAt: Date;
-    /** Relevancy score for this intent in its index context (0.0–1.0, null if not scored) */
+    /** Relevancy score for this intent in its network context (0.0–1.0, null if not scored) */
     relevancyScore?: number | null;
 }
 /**
- * Options for updating index settings.
+ * Options for updating network settings.
  */
-export interface UpdateIndexSettingsData {
+export interface UpdateNetworkSettingsData {
     /** New title (optional) */
     title?: string;
     /** New prompt (optional) */
@@ -434,32 +415,7 @@ export interface UpdateIndexSettingsData {
     /** New join policy (optional) */
     joinPolicy?: 'anyone' | 'invite_only';
 }
-export type HydeSourceType = 'intent' | 'query' | 'context';
-export interface HydeDocument {
-    id: string;
-    sourceType: HydeSourceType;
-    sourceId: string | null;
-    sourceText: string | null;
-    strategy: string;
-    targetCorpus: string;
-    hydeText: string;
-    hydeEmbedding: number[];
-    context: Record<string, unknown> | null;
-    createdAt: Date;
-    expiresAt: Date | null;
-}
-export interface CreateHydeDocumentData {
-    sourceType: HydeSourceType;
-    sourceId?: string;
-    sourceText?: string;
-    strategy: string;
-    targetCorpus: string;
-    hydeText: string;
-    hydeEmbedding: number[];
-    context?: Record<string, unknown>;
-    expiresAt?: Date;
-}
-export type OpportunityStatus = 'latent' | 'draft' | 'negotiating' | 'pending' | 'stalled' | 'accepted' | 'rejected' | 'expired';
+export type OpportunityStatus = 'negotiating' | 'pending' | 'accepted' | 'rejected' | 'expired';
 /**
  * Minimal opportunity lifecycle evidence used to narrate an agent negotiation.
  * `acceptedByOwner` is true only when the authenticated owner is the persisted
@@ -477,6 +433,8 @@ export interface Opportunity {
     context: OpportunityContext;
     confidence: string;
     status: OpportunityStatus;
+    /** Actor ids with a `committed` event. Populated by the host on read. */
+    committedActorIds?: string[];
     createdAt: Date;
     updatedAt: Date;
     expiresAt: Date | null;
@@ -490,7 +448,7 @@ export interface OpportunityNetworkEligibility {
     /** When present, each actor network must remain assigned to this intent through commit. */
     triggerIntentId?: string;
 }
-export type OpportunityDedupConflictReason = 'same_trigger_recent_duplicate' | 'pair_active_negotiation';
+export type OpportunityDedupConflictReason = 'same_intent_pair_duplicate';
 export interface OpportunityDedupConflict {
     reason: OpportunityDedupConflictReason;
     existingOpportunityId: string;
@@ -523,6 +481,8 @@ export interface OpportunityQueryOptions {
     scopeType?: 'intent';
     scopeId?: string;
     role?: string;
+    /** When set, filter to opportunities this user is an actor on. Applied in the query so pagination counts only visible rows. */
+    actorUserId?: string;
     limit?: number;
     offset?: number;
     /** When set, include draft opportunities for this chat session. When unset, exclude all draft opportunities (e.g. radar view, API). */