@indexnetwork/protocol 66.0.0-rc.619.1 → 66.0.0-rc.623.1

package/dist/capabilities/intents.d.ts

@@ -73,6 +73,8 @@ export declare class Intents {
         archive: boolean;
         status: "active" | "paused" | undefined;
         expectedIntentFingerprint: string | undefined;
+        sourceType: string | null | undefined;
+        sourceId: string | null | undefined;
         networkId: string | undefined;
         networkIds: string[] | undefined;
         scopeType: import("../index.js").ScopeType | undefined;
@@ -123,6 +125,8 @@ export declare class Intents {
         archive?: boolean | import("@langchain/langgraph").OverwriteValue<boolean> | undefined;
         status?: "active" | "paused" | import("@langchain/langgraph").OverwriteValue<"active" | "paused" | undefined> | undefined;
         expectedIntentFingerprint?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
+        sourceType?: string | null | undefined;
+        sourceId?: string | null | undefined;
         networkId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         networkIds?: string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined;
         scopeType?: import("../index.js").ScopeType | import("@langchain/langgraph").OverwriteValue<import("../index.js").ScopeType | undefined> | undefined;
@@ -214,6 +218,16 @@ export declare class Intents {
         archive: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
         status: import("@langchain/langgraph").BaseChannel<"active" | "paused" | undefined, "active" | "paused" | import("@langchain/langgraph").OverwriteValue<"active" | "paused" | undefined> | undefined, unknown>;
         expectedIntentFingerprint: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        sourceType: {
+            (annotation: import("@langchain/langgraph").SingleReducer<string | null | undefined, string | null | undefined>): import("@langchain/langgraph").BaseChannel<string | null | undefined, string | import("@langchain/langgraph").OverwriteValue<string | null | undefined> | null | undefined, unknown>;
+            (): import("@langchain/langgraph").LastValue<string | null | undefined>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        sourceId: {
+            (annotation: import("@langchain/langgraph").SingleReducer<string | null | undefined, string | null | undefined>): import("@langchain/langgraph").BaseChannel<string | null | undefined, string | import("@langchain/langgraph").OverwriteValue<string | null | undefined> | null | undefined, unknown>;
+            (): import("@langchain/langgraph").LastValue<string | null | undefined>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
         networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         networkIds: import("@langchain/langgraph").BaseChannel<string[] | undefined, string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined, unknown>;
         scopeType: import("@langchain/langgraph").BaseChannel<import("../index.js").ScopeType | undefined, import("../index.js").ScopeType | import("@langchain/langgraph").OverwriteValue<import("../index.js").ScopeType | undefined> | undefined, unknown>;
@@ -326,6 +340,16 @@ export declare class Intents {
         archive: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
         status: import("@langchain/langgraph").BaseChannel<"active" | "paused" | undefined, "active" | "paused" | import("@langchain/langgraph").OverwriteValue<"active" | "paused" | undefined> | undefined, unknown>;
         expectedIntentFingerprint: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        sourceType: {
+            (annotation: import("@langchain/langgraph").SingleReducer<string | null | undefined, string | null | undefined>): import("@langchain/langgraph").BaseChannel<string | null | undefined, string | import("@langchain/langgraph").OverwriteValue<string | null | undefined> | null | undefined, unknown>;
+            (): import("@langchain/langgraph").LastValue<string | null | undefined>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        sourceId: {
+            (annotation: import("@langchain/langgraph").SingleReducer<string | null | undefined, string | null | undefined>): import("@langchain/langgraph").BaseChannel<string | null | undefined, string | import("@langchain/langgraph").OverwriteValue<string | null | undefined> | null | undefined, unknown>;
+            (): import("@langchain/langgraph").LastValue<string | null | undefined>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
         networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         networkIds: import("@langchain/langgraph").BaseChannel<string[] | undefined, string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined, unknown>;
         scopeType: import("@langchain/langgraph").BaseChannel<import("../index.js").ScopeType | undefined, import("../index.js").ScopeType | import("@langchain/langgraph").OverwriteValue<import("../index.js").ScopeType | undefined> | undefined, unknown>;

package/dist/internal/intents/graph/intent.graph.d.ts

@@ -31,6 +31,8 @@ export declare class IntentGraphFactory {
         archive: boolean;
         status: "active" | "paused" | undefined;
         expectedIntentFingerprint: string | undefined;
+        sourceType: string | null | undefined;
+        sourceId: string | null | undefined;
         networkId: string | undefined;
         networkIds: string[] | undefined;
         scopeType: import("../../../index.js").ScopeType | undefined;
@@ -81,6 +83,8 @@ export declare class IntentGraphFactory {
         archive?: boolean | import("@langchain/langgraph").OverwriteValue<boolean> | undefined;
         status?: "active" | "paused" | import("@langchain/langgraph").OverwriteValue<"active" | "paused" | undefined> | undefined;
         expectedIntentFingerprint?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
+        sourceType?: string | null | undefined;
+        sourceId?: string | null | undefined;
         networkId?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         networkIds?: string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined;
         scopeType?: import("../../../index.js").ScopeType | import("@langchain/langgraph").OverwriteValue<import("../../../index.js").ScopeType | undefined> | undefined;
@@ -172,6 +176,16 @@ export declare class IntentGraphFactory {
         archive: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
         status: import("@langchain/langgraph").BaseChannel<"active" | "paused" | undefined, "active" | "paused" | import("@langchain/langgraph").OverwriteValue<"active" | "paused" | undefined> | undefined, unknown>;
         expectedIntentFingerprint: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        sourceType: {
+            (annotation: import("@langchain/langgraph").SingleReducer<string | null | undefined, string | null | undefined>): import("@langchain/langgraph").BaseChannel<string | null | undefined, string | import("@langchain/langgraph").OverwriteValue<string | null | undefined> | null | undefined, unknown>;
+            (): import("@langchain/langgraph").LastValue<string | null | undefined>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        sourceId: {
+            (annotation: import("@langchain/langgraph").SingleReducer<string | null | undefined, string | null | undefined>): import("@langchain/langgraph").BaseChannel<string | null | undefined, string | import("@langchain/langgraph").OverwriteValue<string | null | undefined> | null | undefined, unknown>;
+            (): import("@langchain/langgraph").LastValue<string | null | undefined>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
         networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         networkIds: import("@langchain/langgraph").BaseChannel<string[] | undefined, string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined, unknown>;
         scopeType: import("@langchain/langgraph").BaseChannel<import("../../../index.js").ScopeType | undefined, import("../../../index.js").ScopeType | import("@langchain/langgraph").OverwriteValue<import("../../../index.js").ScopeType | undefined> | undefined, unknown>;
@@ -284,6 +298,16 @@ export declare class IntentGraphFactory {
         archive: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
         status: import("@langchain/langgraph").BaseChannel<"active" | "paused" | undefined, "active" | "paused" | import("@langchain/langgraph").OverwriteValue<"active" | "paused" | undefined> | undefined, unknown>;
         expectedIntentFingerprint: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+        sourceType: {
+            (annotation: import("@langchain/langgraph").SingleReducer<string | null | undefined, string | null | undefined>): import("@langchain/langgraph").BaseChannel<string | null | undefined, string | import("@langchain/langgraph").OverwriteValue<string | null | undefined> | null | undefined, unknown>;
+            (): import("@langchain/langgraph").LastValue<string | null | undefined>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
+        sourceId: {
+            (annotation: import("@langchain/langgraph").SingleReducer<string | null | undefined, string | null | undefined>): import("@langchain/langgraph").BaseChannel<string | null | undefined, string | import("@langchain/langgraph").OverwriteValue<string | null | undefined> | null | undefined, unknown>;
+            (): import("@langchain/langgraph").LastValue<string | null | undefined>;
+            Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+        };
         networkId: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
         networkIds: import("@langchain/langgraph").BaseChannel<string[] | undefined, string[] | import("@langchain/langgraph").OverwriteValue<string[] | undefined> | undefined, unknown>;
         scopeType: import("@langchain/langgraph").BaseChannel<import("../../../index.js").ScopeType | undefined, import("../../../index.js").ScopeType | import("@langchain/langgraph").OverwriteValue<import("../../../index.js").ScopeType | undefined> | undefined, unknown>;

package/dist/internal/intents/graph/intent.graph.execute.js

@@ -39,7 +39,8 @@ export async function executorNode(state, deps) {
                         payload,
                         confidence: 1.0,
                         inferenceType: 'explicit',
-                        sourceType: 'discovery_form',
+                        sourceType: state.sourceType ?? null,
+                        sourceId: state.sourceId ?? null,
                         embedding: flatEmbedding,
                         semanticEntropy: metadata?.semanticEntropy ?? null,
                         referentialAnchor: metadata?.referentialAnchor ?? null,
@@ -88,6 +89,8 @@ export async function executorNode(state, deps) {
                         felicityClarity: matchedVerifiedIntent?.verification?.felicity_scores.clarity ?? null,
                         intentMode: updateAction.intentMode ?? null,
                         speechActType: toSpeechActType(matchedVerifiedIntent?.verification?.classification),
+                        ...(state.sourceType !== undefined ? { sourceType: state.sourceType } : {}),
+                        ...(state.sourceId !== undefined ? { sourceId: state.sourceId } : {}),
                         ...(state.expectedIntentFingerprint !== undefined ? {
                             expectedIntentFingerprint: state.expectedIntentFingerprint,
                             expectedIntentUserId: state.userId,

package/dist/internal/intents/graph/intent.graph.state.d.ts

@@ -154,6 +154,18 @@ export declare const IntentGraphState: import("@langchain/langgraph").Annotation
      * updates. The database rechecks it while holding the final intent row lock.
      */
     expectedIntentFingerprint: import("@langchain/langgraph").BaseChannel<string | undefined, string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined, unknown>;
+    /** Client-owned label written on create or update. Undefined leaves it; null clears it. */
+    sourceType: {
+        (annotation: import("@langchain/langgraph").SingleReducer<string | null | undefined, string | null | undefined>): import("@langchain/langgraph").BaseChannel<string | null | undefined, string | import("@langchain/langgraph").OverwriteValue<string | null | undefined> | null | undefined, unknown>;
+        (): import("@langchain/langgraph").LastValue<string | null | undefined>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    /** Client-owned reference written on create or update. Undefined leaves it; null clears it. */
+    sourceId: {
+        (annotation: import("@langchain/langgraph").SingleReducer<string | null | undefined, string | null | undefined>): import("@langchain/langgraph").BaseChannel<string | null | undefined, string | import("@langchain/langgraph").OverwriteValue<string | null | undefined> | null | undefined, unknown>;
+        (): import("@langchain/langgraph").LastValue<string | null | undefined>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
     /**
      * Optional network scope (network ID) for read operations. Prep always
      * fetches ALL user intents via getActiveIntents(userId) regardless of network

package/dist/internal/intents/graph/intent.graph.state.js

@@ -64,6 +64,10 @@ export const IntentGraphState = Annotation.Root({
         reducer: (curr, next) => next ?? curr,
         default: () => undefined,
     }),
+    /** Client-owned label written on create or update. Undefined leaves it; null clears it. */
+    sourceType: (Annotation),
+    /** Client-owned reference written on create or update. Undefined leaves it; null clears it. */
+    sourceId: (Annotation),
     /**
      * Optional network scope (network ID) for read operations. Prep always
      * fetches ALL user intents via getActiveIntents(userId) regardless of network

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

@@ -29,6 +29,8 @@ export interface OpportunityCard {
     };
     /** Viewer's role in this opportunity (e.g. 'party', 'agent', 'patient', 'peer'). */
     viewerRole?: string;
+    /** This viewer already committed. Status can still be pending until the other person accepts. */
+    viewerCommitted?: boolean;
     /**
      * True for a skeleton card: identity fields are real but mainText/cta are
      * empty because the presenter was skipped. Never cached.

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

@@ -6,7 +6,7 @@
 import { protocolLogger } from '../shared/observability/protocol.logger.js';
 import { buildOpportunityCardCacheKey, gatherPresenterContext } from './opportunity.presentation.js';
 import { loadNegotiationContext } from './negotiation-context.loader.js';
-import { canUserSeeOpportunity, isActionableForViewer } from './opportunity.utils.js';
+import { canUserSeeOpportunity } from './opportunity.utils.js';
 import { getPrimaryActionLabel, SECONDARY_ACTION_LABEL } from './opportunity.labels.js';
 const logger = protocolLogger('OpportunityCards');
 const PRESENTATION_CONCURRENCY = 50;
@@ -30,6 +30,12 @@ function pickDisplayCounterpartActor(opportunity, viewerId) {
 function counterpartUserIds(opportunity, viewerId) {
     return new Set(opportunity.actors.map((a) => a.userId).filter((id) => id && id !== viewerId));
 }
+function viewerHasCommitted(opportunity, viewerId) {
+    return (opportunity.committedActorIds ?? []).includes(viewerId);
+}
+function stampViewerCommitted(card, viewerCommitted) {
+    return { ...card, viewerCommitted };
+}
 /**
  * Present one opportunity as a card for the viewer.
  *
@@ -46,13 +52,14 @@ export async function presentOpportunityCard(deps, opportunity, viewerId, option
     const counterpart = pickDisplayCounterpartActor(opportunity, viewerId);
     if (!counterpart)
         return null;
+    const viewerCommitted = viewerHasCommitted(opportunity, viewerId);
     const cacheable = opportunity.status !== 'negotiating';
     const cacheKey = buildOpportunityCardCacheKey(opportunity.id, viewerId, options.intentId);
     if (cacheable && !options.skeleton && !options.noCache) {
         try {
             const hit = await deps.cache.get(cacheKey);
             if (hit)
-                return { ...hit, status: opportunity.status };
+                return stampViewerCommitted({ ...hit, status: opportunity.status }, viewerCommitted);
         }
         catch (error) {
             logger.warn('card cache read failed, presenting', { opportunityId: opportunity.id, error });
@@ -78,7 +85,7 @@ export async function presentOpportunityCard(deps, opportunity, viewerId, option
         viewerRole,
     };
     if (options.skeleton) {
-        return { ...identity, mainText: '', cta: '', mutualIntentsLabel: 'Shared interests', presentationPending: true };
+        return stampViewerCommitted({ ...identity, mainText: '', cta: '', mutualIntentsLabel: 'Shared interests', presentationPending: true }, viewerCommitted);
     }
     const [context, negotiationContext] = await Promise.all([
         gatherPresenterContext(database, opportunity, viewerId, counterpart.userId, options.intentId),
@@ -89,14 +96,14 @@ export async function presentOpportunityCard(deps, opportunity, viewerId, option
         opportunityStatus: opportunity.status,
         ...(negotiationContext ? { negotiationContext } : {}),
     });
-    const card = {
+    const card = stampViewerCommitted({
         ...identity,
         mainText: presentation.personalizedSummary,
         cta: presentation.suggestedAction,
         headline: presentation.headline,
         mutualIntentsLabel: presentation.mutualIntentsLabel,
         narratorChip: { name: 'Index', text: presentation.narratorRemark },
-    };
+    }, viewerCommitted);
     if (cacheable) {
         await deps.cache.set(cacheKey, card).catch((error) => {
             logger.warn('card cache write failed', { opportunityId: opportunity.id, error });
@@ -124,8 +131,6 @@ export async function listOpportunityCards(deps, input) {
     const requested = new Set(input.statuses);
     const visible = raw
         .filter((opp) => requested.has(opp.status) && canUserSeeOpportunity(opp.actors, opp.status, viewerId))
-        .filter((opp) => opp.status !== 'pending'
-        || isActionableForViewer(opp.actors, opp.status, viewerId, opp.committedActorIds ?? []))
         .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
     const seen = new Set();
     const opportunities = visible.filter((opp) => {
@@ -146,7 +151,7 @@ export async function listOpportunityCards(deps, input) {
             cacheableOpps.forEach((opp, i) => {
                 const hit = hits[i];
                 if (hit)
-                    cached.set(opp.id, { ...hit, status: opp.status });
+                    cached.set(opp.id, stampViewerCommitted({ ...hit, status: opp.status }, viewerHasCommitted(opp, viewerId)));
             });
         }
         catch (error) {

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

@@ -155,10 +155,10 @@ export interface CreateIntentData {
     isIncognito?: boolean;
     /** Network IDs to associate with (optional, uses dynamic scoping if empty) */
     networkIds?: string[];
-    /** Source type for provenance tracking */
-    sourceType?: 'integration' | 'discovery_form' | 'enrichment';
-    /** Source ID for provenance tracking */
-    sourceId?: string;
+    /** Client-owned label, stored and returned unchanged */
+    sourceType?: string | null;
+    /** Client-owned reference, stored and returned unchanged */
+    sourceId?: string | null;
     /** Confidence score from inference (0-1, required) */
     confidence: number;
     /** How the intent was inferred */
@@ -191,6 +191,10 @@ export interface UpdateIntentData {
     embedding?: number[];
     /** Updated incognito status */
     isIncognito?: boolean;
+    /** Client-owned label; null clears it */
+    sourceType?: string | null;
+    /** Client-owned reference; null clears it */
+    sourceId?: string | null;
     /** Updated network associations (replaces existing) */
     networkIds?: string[];
     /** Semantic entropy from verifier (0 specific -> 1 vague) */
@@ -244,9 +248,9 @@ export interface IntentRecord extends CreatedIntent {
     archivedAt: Date | null;
     /** Embedding vector (may be null) */
     embedding?: number[] | null;
-    /** Source type for provenance */
+    /** Client-owned label */
     sourceType?: string | null;
-    /** Source ID for provenance */
+    /** Client-owned reference */
     sourceId?: string | null;
     /** Lifecycle admission state; null is a legacy active row. */
     status?: 'active' | 'paused' | null;

package/dist/platform/database/identity-queries.d.ts

@@ -85,7 +85,6 @@ export interface DatabaseIdentityQueries {
      *   payload: action.payload,
      *   confidence: action.score / 100,
      *   inferenceType: 'explicit',
-     *   sourceType: 'discovery_form'
      * });
      * ```
      */

package/dist/protocol/protocol.prompt.js

@@ -84,6 +84,10 @@ Identity is account/presentation metadata. Context is dynamic, scoped runtime st
 - Confidence (0-1, how well the inference captured the user's intent)
 - Inference type (explicit = user stated directly; implicit = system inferred)
 - Embedding (semantic vector for matching)
+- Source type and source ID (optional client-owned strings, set on create or update, stored and returned unchanged)
+
+### Source Fields
+Clients may set \`sourceType\` and \`sourceId\` to map their own records to a published signal. An agent that inferred an ambient intent can pass its local id as \`sourceId\` when the owner approves publishing it, then match the signal back by that value. Index does not interpret either field. Omit a field to leave it unchanged; null clears it.
 
 ### Signal Lifecycle
 1. User creates intent (explicit signal) or system infers from behavior (implicit)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indexnetwork/protocol",
-  "version": "66.0.0-rc.619.1",
+  "version": "66.0.0-rc.623.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",