@indexnetwork/protocol 0.1.0

package/dist/support/opportunity.sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunity.sanitize.js","sourceRoot":"","sources":["../../src/support/opportunity.sanitize.ts"],"names":[],"mappings":"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"}

package/dist/support/opportunity.utils.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Opportunity graph utilities: role derivation from corpus type.
+ * Used by the opportunity graph to map lens corpus to opportunity actor roles.
+ *
+ * With lens-based HyDE, strategy selection is handled automatically by the
+ * LensInferrer agent. This file provides corpus-to-role mapping for opportunity actors.
+ */
+import type { HydeTargetCorpus } from '../agents/lens.inferrer.js';
+/** Actor roles in the opportunity model (agent / patient / peer). */
+export type OpportunityActorRole = 'agent' | 'patient' | 'peer';
+/** Result of mapping a corpus to source and candidate roles. */
+export interface DerivedRoles {
+    sourceRole: OpportunityActorRole;
+    candidateRole: OpportunityActorRole;
+}
+/**
+ * Derive actor roles from the corpus type of a lens match.
+ *
+ * When a candidate is found via:
+ * - "profiles" corpus → found by who they are → candidate can help → agent
+ * - "intents" corpus → found by what they need → candidate needs something → patient
+ *
+ * @param corpus - The target corpus that produced the match ('profiles' | 'intents')
+ * @returns Roles for the source (intent owner) and the candidate (matched user/intent)
+ */
+export declare function deriveRolesFromCorpus(corpus: HydeTargetCorpus): DerivedRoles;
+/**
+ * Validates opportunity actors: if an opportunity has an introducer, it must have
+ * one or two non-introducer actors (1 = 1:1 intro e.g. "I want to connect with X";
+ * 2 = introducer connecting two others).
+ *
+ * @param actors - Array of actors with at least a role and optional userId
+ * @throws Error when the actor set is invalid
+ */
+export declare function validateOpportunityActors(actors: Array<{
+    userId?: string;
+    role: string;
+}>): void;
+/**
+ * Role-based visibility (Latent Opportunity Lifecycle).
+ * A user can see an opportunity iff they are an actor and the rule below allows it.
+ *
+ * Compact Visibility Rule (from lifecycle doc):
+ * - Introducer or peer: always see.
+ * - Patient or party: see if (status is not latent, or there is no introducer).
+ * - Agent: see if (status is accepted/rejected/expired, or (status is not latent and there is no introducer)).
+ */
+export declare function canUserSeeOpportunity(actors: Array<{
+    userId: string;
+    role: string;
+}>, status: string, userId: string): boolean;
+/**
+ * Whether an opportunity should appear on the Home feed for the viewer (actionable = has a pending action).
+ * Encodes the role-visibility matrix from the Latent Opportunity Lifecycle.
+ */
+export declare function isActionableForViewer(actors: Array<{
+    userId: string;
+    role: string;
+}>, status: string, viewerId: string): boolean;
+/** Feed category for home composition. */
+export type FeedCategory = 'connection' | 'connector-flow' | 'expired';
+/** Soft targets for home feed composition. */
+export declare const FEED_SOFT_TARGETS: {
+    readonly connection: 3;
+    readonly connectorFlow: 2;
+    readonly expired: 2;
+};
+/**
+ * Classify an actionable opportunity into a feed category.
+ * Assumes the opportunity already passed isActionableForViewer or is expired.
+ *
+ * @param opp - Opportunity with actors and status
+ * @param viewerId - The viewing user's ID
+ * @returns Feed category
+ */
+export declare function classifyOpportunity(opp: {
+    actors: Array<{
+        userId: string;
+        role: string;
+    }>;
+    status: string;
+}, viewerId: string): FeedCategory;
+/**
+ * Select opportunities for the home feed using soft composition targets.
+ * Fills each category up to its target, then redistributes unused slots
+ * to categories that have more items available. Preserves input order.
+ *
+ * @param opportunities - Pre-sorted opportunities (by confidence/recency)
+ * @param viewerId - The viewing user's ID
+ * @returns Composition-balanced subset
+ */
+export declare function selectByComposition<T extends {
+    actors: Array<{
+        userId: string;
+        role: string;
+    }>;
+    status: string;
+}>(opportunities: T[], viewerId: string): T[];
+//# sourceMappingURL=opportunity.utils.d.ts.map

package/dist/support/opportunity.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunity.utils.d.ts","sourceRoot":"","sources":["../../src/support/opportunity.utils.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAKnE,qEAAqE;AACrE,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEhE,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,oBAAoB,CAAC;IACjC,aAAa,EAAE,oBAAoB,CAAC;CACrC;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,YAAY,CAW5E;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,KAAK,CAAC;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAShG;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAC/C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,OAAO,CAiBT;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAC/C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAyBT;AAED,0CAA0C;AAC1C,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAEvE,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB;;;;CAIpB,CAAC;AAEX;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE;IAAE,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACxE,QAAQ,EAAE,MAAM,GACf,YAAY,CAKd;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC/G,aAAa,EAAE,CAAC,EAAE,EAClB,QAAQ,EAAE,MAAM,GACf,CAAC,EAAE,CAwDL"}

package/dist/support/opportunity.utils.js

@@ -0,0 +1,184 @@
+/**
+ * Opportunity graph utilities: role derivation from corpus type.
+ * Used by the opportunity graph to map lens corpus to opportunity actor roles.
+ *
+ * With lens-based HyDE, strategy selection is handled automatically by the
+ * LensInferrer agent. This file provides corpus-to-role mapping for opportunity actors.
+ */
+import { log } from './log.js';
+const logger = log.graph.from('SelectByComposition');
+/**
+ * Derive actor roles from the corpus type of a lens match.
+ *
+ * When a candidate is found via:
+ * - "profiles" corpus → found by who they are → candidate can help → agent
+ * - "intents" corpus → found by what they need → candidate needs something → patient
+ *
+ * @param corpus - The target corpus that produced the match ('profiles' | 'intents')
+ * @returns Roles for the source (intent owner) and the candidate (matched user/intent)
+ */
+export function deriveRolesFromCorpus(corpus) {
+    switch (corpus) {
+        case 'profiles':
+            // Source seeks someone who can help → source is patient, candidate can help → agent
+            return { sourceRole: 'patient', candidateRole: 'agent' };
+        case 'intents':
+            // Source offers or needs; candidate has complementary goal → source is agent, candidate is patient
+            return { sourceRole: 'agent', candidateRole: 'patient' };
+        default:
+            return { sourceRole: 'peer', candidateRole: 'peer' };
+    }
+}
+/**
+ * Validates opportunity actors: if an opportunity has an introducer, it must have
+ * one or two non-introducer actors (1 = 1:1 intro e.g. "I want to connect with X";
+ * 2 = introducer connecting two others).
+ *
+ * @param actors - Array of actors with at least a role and optional userId
+ * @throws Error when the actor set is invalid
+ */
+export function validateOpportunityActors(actors) {
+    const introducerCount = actors.filter((a) => a.role === 'introducer').length;
+    const nonIntroducerCount = actors.filter((a) => a.role !== 'introducer').length;
+    if (introducerCount > 0 && (nonIntroducerCount < 1 || nonIntroducerCount > 2)) {
+        throw new Error('An opportunity with an introducer must have one or two other actors.');
+    }
+}
+/**
+ * Role-based visibility (Latent Opportunity Lifecycle).
+ * A user can see an opportunity iff they are an actor and the rule below allows it.
+ *
+ * Compact Visibility Rule (from lifecycle doc):
+ * - Introducer or peer: always see.
+ * - Patient or party: see if (status is not latent, or there is no introducer).
+ * - Agent: see if (status is accepted/rejected/expired, or (status is not latent and there is no introducer)).
+ */
+export function canUserSeeOpportunity(actors, status, userId) {
+    const hasIntroducer = actors.some((a) => a.role === 'introducer');
+    const userRoles = actors.filter((a) => a.userId === userId).map((a) => a.role);
+    if (userRoles.length === 0)
+        return false;
+    return userRoles.some((role) => {
+        if (role === 'introducer')
+            return true;
+        if (role === 'peer')
+            return true;
+        if (role === 'patient' || role === 'party')
+            return status !== 'latent' || !hasIntroducer;
+        if (role === 'agent')
+            return (['accepted', 'rejected', 'expired'].includes(status) ||
+                (status !== 'latent' && !hasIntroducer));
+        return false;
+    });
+}
+/**
+ * Whether an opportunity should appear on the Home feed for the viewer (actionable = has a pending action).
+ * Encodes the role-visibility matrix from the Latent Opportunity Lifecycle.
+ */
+export function isActionableForViewer(actors, status, viewerId) {
+    const viewerActors = actors.filter((a) => a.userId === viewerId);
+    if (viewerActors.length === 0)
+        return false;
+    const hasIntroducer = actors.some((a) => a.role === 'introducer');
+    return viewerActors.some(({ role }) => {
+        switch (role) {
+            case 'introducer':
+                return status === 'latent';
+            case 'patient':
+            case 'party':
+                return hasIntroducer
+                    ? status === 'pending'
+                    : status === 'latent';
+            case 'agent':
+                return hasIntroducer
+                    ? status === 'accepted'
+                    : status === 'pending';
+            case 'peer':
+                return status === 'latent' || status === 'pending';
+            default:
+                return false;
+        }
+    });
+}
+/** Soft targets for home feed composition. */
+export const FEED_SOFT_TARGETS = {
+    connection: 3,
+    connectorFlow: 2,
+    expired: 2,
+};
+/**
+ * Classify an actionable opportunity into a feed category.
+ * Assumes the opportunity already passed isActionableForViewer or is expired.
+ *
+ * @param opp - Opportunity with actors and status
+ * @param viewerId - The viewing user's ID
+ * @returns Feed category
+ */
+export function classifyOpportunity(opp, viewerId) {
+    if (opp.status === 'expired')
+        return 'expired';
+    const viewerIsIntroducer = opp.actors.some((a) => a.userId === viewerId && a.role === 'introducer');
+    if (viewerIsIntroducer)
+        return 'connector-flow';
+    return 'connection';
+}
+/**
+ * Select opportunities for the home feed using soft composition targets.
+ * Fills each category up to its target, then redistributes unused slots
+ * to categories that have more items available. Preserves input order.
+ *
+ * @param opportunities - Pre-sorted opportunities (by confidence/recency)
+ * @param viewerId - The viewing user's ID
+ * @returns Composition-balanced subset
+ */
+export function selectByComposition(opportunities, viewerId) {
+    const buckets = {
+        connection: [],
+        'connector-flow': [],
+        expired: [],
+    };
+    for (const opp of opportunities) {
+        const category = classifyOpportunity(opp, viewerId);
+        buckets[category].push(opp);
+    }
+    const targets = {
+        connection: FEED_SOFT_TARGETS.connection,
+        'connector-flow': FEED_SOFT_TARGETS.connectorFlow,
+        expired: FEED_SOFT_TARGETS.expired,
+    };
+    // First pass: fill each category up to its target
+    const selected = {
+        connection: buckets.connection.slice(0, targets.connection),
+        'connector-flow': buckets['connector-flow'].slice(0, targets['connector-flow']),
+        expired: buckets.expired.slice(0, targets.expired),
+    };
+    // Calculate unused slots and remaining items
+    const totalTarget = targets.connection + targets['connector-flow'] + targets.expired;
+    const usedSlots = selected.connection.length + selected['connector-flow'].length + selected.expired.length;
+    let unusedSlots = totalTarget - usedSlots;
+    // Second pass: redistribute unused slots to categories with remaining items
+    // Priority: connection > connector-flow > expired
+    const redistOrder = ['connection', 'connector-flow', 'expired'];
+    for (const category of redistOrder) {
+        if (unusedSlots <= 0)
+            break;
+        const remaining = buckets[category].slice(selected[category].length);
+        const take = Math.min(remaining.length, unusedSlots);
+        selected[category].push(...remaining.slice(0, take));
+        unusedSlots -= take;
+    }
+    // Merge in category priority order: connection > connector-flow > expired
+    // Within each category, preserve original input order
+    const indexMap = new Map(opportunities.map((opp, i) => [opp, i]));
+    const sortByOriginal = (a, b) => (indexMap.get(a) ?? 0) - (indexMap.get(b) ?? 0);
+    selected.connection.sort(sortByOriginal);
+    selected['connector-flow'].sort(sortByOriginal);
+    selected.expired.sort(sortByOriginal);
+    logger.info(`[selectByComposition] input=${opportunities.length} buckets: connection=${buckets.connection.length} connector-flow=${buckets['connector-flow'].length} expired=${buckets.expired.length} → selected: connection=${selected.connection.length} connector-flow=${selected['connector-flow'].length} expired=${selected.expired.length}`);
+    return [
+        ...selected.connection,
+        ...selected['connector-flow'],
+        ...selected.expired,
+    ];
+}
+//# sourceMappingURL=opportunity.utils.js.map

package/dist/support/opportunity.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opportunity.utils.js","sourceRoot":"","sources":["../../src/support/opportunity.utils.ts"],"names":[],"mappings":"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"}

package/dist/support/performance.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Simple performance timing utilities for the protocol library.
+ * Standalone — no external dependencies.
+ */
+type TimingCallback = (name: string, durationMs: number) => void;
+/** Set a global callback for timing events (e.g. for aggregation/logging). */
+export declare function setTimingCallback(cb: TimingCallback | undefined): void;
+/**
+ * Wraps an async function with timing measurement.
+ * Reports duration to the global timing callback if set.
+ */
+export declare function timed<T>(name: string, fn: () => Promise<T>): Promise<T>;
+/**
+ * Method decorator that wraps an async method with timing measurement.
+ * Uses `ClassName.methodName` as the timing label.
+ */
+export declare function Timed(): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
+export {};
+//# sourceMappingURL=performance.d.ts.map

package/dist/support/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../src/support/performance.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,KAAK,cAAc,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;AAIjE,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,cAAc,GAAG,SAAS,QAE/D;AAED;;;GAGG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAU7E;AAED;;;GAGG;AAEH,wBAAgB,KAAK,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,KAAK,IAAI,CAWlG"}

package/dist/support/performance.js

@@ -0,0 +1,43 @@
+/**
+ * Simple performance timing utilities for the protocol library.
+ * Standalone — no external dependencies.
+ */
+let onTiming;
+/** Set a global callback for timing events (e.g. for aggregation/logging). */
+export function setTimingCallback(cb) {
+    onTiming = cb;
+}
+/**
+ * Wraps an async function with timing measurement.
+ * Reports duration to the global timing callback if set.
+ */
+export async function timed(name, fn) {
+    const start = performance.now();
+    try {
+        const result = await fn();
+        onTiming?.(name, performance.now() - start);
+        return result;
+    }
+    catch (err) {
+        onTiming?.(name, performance.now() - start);
+        throw err;
+    }
+}
+/**
+ * Method decorator that wraps an async method with timing measurement.
+ * Uses `ClassName.methodName` as the timing label.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function Timed() {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return function (_target, propertyKey, descriptor) {
+        const original = descriptor.value;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        descriptor.value = function (...args) {
+            const className = this.constructor.name;
+            const name = `${className}.${propertyKey}`;
+            return timed(name, () => original.apply(this, args));
+        };
+    };
+}
+//# sourceMappingURL=performance.js.map

package/dist/support/performance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.js","sourceRoot":"","sources":["../../src/support/performance.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,IAAI,QAAoC,CAAC;AAEzC,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,EAA8B;IAC9D,QAAQ,GAAG,EAAE,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAI,IAAY,EAAE,EAAoB;IAC/D,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;QAC5C,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;QAC5C,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,8DAA8D;AAC9D,MAAM,UAAU,KAAK;IACnB,8DAA8D;IAC9D,OAAO,UAAU,OAAY,EAAE,WAAmB,EAAE,UAA8B;QAChF,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC;QAClC,8DAA8D;QAC9D,UAAU,CAAC,KAAK,GAAG,UAAqB,GAAG,IAAW;YACpD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YACxC,MAAM,IAAI,GAAG,GAAG,SAAS,IAAI,WAAW,EAAE,CAAC;YAC3C,OAAO,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/support/profile.enrichment-display-name.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Decides whether to set {@link users.name} from Parallel `enrichment.identity.name` for ghost users.
+ * @remarks Real users (Google login, etc.) are never touched. Ghost users always get
+ * their name enriched when Parallel returns a non-empty name that isn't an email.
+ */
+/**
+ * @param user - Current user row (must include `email`, `name`, `isGhost`)
+ * @param enrichedName - `enrichment.identity.name` from Parallel (may be untrimmed)
+ * @returns True if `users.name` should be updated to the enriched full name
+ */
+export declare function shouldEnrichGhostDisplayNameFromParallel(user: {
+    name: string;
+    email: string;
+    isGhost?: boolean | null;
+}, enrichedName: string): boolean;
+//# sourceMappingURL=profile.enrichment-display-name.d.ts.map

package/dist/support/profile.enrichment-display-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.enrichment-display-name.d.ts","sourceRoot":"","sources":["../../src/support/profile.enrichment-display-name.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,wBAAgB,wCAAwC,CACtD,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE,EAC/D,YAAY,EAAE,MAAM,GACnB,OAAO,CAST"}

package/dist/support/profile.enrichment-display-name.js

@@ -0,0 +1,22 @@
+/**
+ * Decides whether to set {@link users.name} from Parallel `enrichment.identity.name` for ghost users.
+ * @remarks Real users (Google login, etc.) are never touched. Ghost users always get
+ * their name enriched when Parallel returns a non-empty name that isn't an email.
+ */
+/**
+ * @param user - Current user row (must include `email`, `name`, `isGhost`)
+ * @param enrichedName - `enrichment.identity.name` from Parallel (may be untrimmed)
+ * @returns True if `users.name` should be updated to the enriched full name
+ */
+export function shouldEnrichGhostDisplayNameFromParallel(user, enrichedName) {
+    if (!user.isGhost)
+        return false;
+    const trimmed = enrichedName.trim();
+    if (!trimmed || trimmed.includes("@"))
+        return false;
+    const current = user.name.trim();
+    if (current === trimmed.toLowerCase())
+        return false;
+    return true;
+}
+//# sourceMappingURL=profile.enrichment-display-name.js.map

package/dist/support/profile.enrichment-display-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.enrichment-display-name.js","sourceRoot":"","sources":["../../src/support/profile.enrichment-display-name.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,UAAU,wCAAwC,CACtD,IAA+D,EAC/D,YAAoB;IAEpB,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAChC,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAEpD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACjC,IAAI,OAAO,KAAK,OAAO,CAAC,WAAW,EAAE;QAAE,OAAO,KAAK,CAAC;IAEpD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/support/protocol.logger.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Protocol-layer logging: call-scoped inputs, outputs, and context for debugging.
+ * Use protocolLogger('ComponentName') for the logger, then wrap calls with
+ * withCallLogging. All protocol code should log inputs at call start and
+ * outputs (or summary) + duration at end.
+ */
+import type { LoggerWithSource } from "./log.js";
+export type { LoggerWithSource };
+/** Create a protocol logger for a given source (e.g. "ChatTools", "DiscoverNodes"). */
+export declare function protocolLogger(source: string): LoggerWithSource;
+export interface CallLogOptions {
+    /** Log full output on success (default: true). Set false for very large payloads. */
+    logOutput?: boolean;
+    /** Extra context to include in both start and end (e.g. userId, indexId). */
+    context?: Record<string, unknown>;
+}
+/**
+ * Wraps an async call with consistent logging: inputs at start, outputs + duration at end,
+ * error + duration on failure. All payloads are sanitized (embeddings redacted).
+ */
+export declare function withCallLogging<T>(logger: LoggerWithSource, callName: string, inputs: Record<string, unknown>, fn: () => Promise<T>, options?: CallLogOptions): Promise<T>;
+//# sourceMappingURL=protocol.logger.d.ts.map

package/dist/support/protocol.logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.logger.d.ts","sourceRoot":"","sources":["../../src/support/protocol.logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAEjC,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAE/D;AAED,MAAM,WAAW,cAAc;IAC7B,qFAAqF;IACrF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,CAAC,EACrC,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC,CA2BZ"}

package/dist/support/protocol.logger.js

@@ -0,0 +1,44 @@
+/**
+ * Protocol-layer logging: call-scoped inputs, outputs, and context for debugging.
+ * Use protocolLogger('ComponentName') for the logger, then wrap calls with
+ * withCallLogging. All protocol code should log inputs at call start and
+ * outputs (or summary) + duration at end.
+ */
+import { log, sanitizeForLog } from "./log.js";
+/** Create a protocol logger for a given source (e.g. "ChatTools", "DiscoverNodes"). */
+export function protocolLogger(source) {
+    return log.protocol.from(source);
+}
+/**
+ * Wraps an async call with consistent logging: inputs at start, outputs + duration at end,
+ * error + duration on failure. All payloads are sanitized (embeddings redacted).
+ */
+export async function withCallLogging(logger, callName, inputs, fn, options = {}) {
+    const { logOutput = true, context = {} } = options;
+    const start = Date.now();
+    const sanitizedInputs = sanitizeForLog(inputs);
+    logger.verbose(`[Call] ${callName} start`, { inputs: sanitizedInputs, ...context });
+    try {
+        const result = await fn();
+        const durationMs = Date.now() - start;
+        const outMeta = {
+            durationMs,
+            ...context,
+        };
+        if (logOutput) {
+            outMeta.output = sanitizeForLog(result);
+        }
+        logger.verbose(`[Call] ${callName} end`, outMeta);
+        return result;
+    }
+    catch (err) {
+        const durationMs = Date.now() - start;
+        logger.error(`[Call] ${callName} failed`, {
+            error: err,
+            durationMs,
+            ...context,
+        });
+        throw err;
+    }
+}
+//# sourceMappingURL=protocol.logger.js.map

package/dist/support/protocol.logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.logger.js","sourceRoot":"","sources":["../../src/support/protocol.logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAK/C,uFAAuF;AACvF,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AASD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAwB,EACxB,QAAgB,EAChB,MAA+B,EAC/B,EAAoB,EACpB,UAA0B,EAAE;IAE5B,MAAM,EAAE,SAAS,GAAG,IAAI,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,eAAe,GAAG,cAAc,CAAC,MAAM,CAA4B,CAAC;IAC1E,MAAM,CAAC,OAAO,CAAC,UAAU,QAAQ,QAAQ,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAEpF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACtC,MAAM,OAAO,GAA4B;YACvC,UAAU;YACV,GAAG,OAAO;SACX,CAAC;QACF,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,UAAU,QAAQ,MAAM,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,UAAU,QAAQ,SAAS,EAAE;YACxC,KAAK,EAAE,GAAG;YACV,UAAU;YACV,GAAG,OAAO;SACX,CAAC,CAAC;QACH,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/support/request-context.d.ts

@@ -0,0 +1,19 @@
+import { AsyncLocalStorage } from "async_hooks";
+/** Callback for streaming graph/agent trace events from deep inside graph nodes. */
+export type TraceEmitter = (event: {
+    type: "graph_start" | "graph_end" | "agent_start" | "agent_end";
+    name: string;
+    durationMs?: number;
+    summary?: string;
+}) => void;
+interface RequestContext {
+    originUrl?: string;
+    traceEmitter?: TraceEmitter;
+}
+/**
+ * AsyncLocalStorage for propagating request-scoped context through the protocol layer.
+ * The host application is responsible for calling `requestContext.run()` to set the context.
+ */
+export declare const requestContext: AsyncLocalStorage<RequestContext>;
+export {};
+//# sourceMappingURL=request-context.d.ts.map

package/dist/support/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/support/request-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,oFAAoF;AACpF,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE;IACjC,IAAI,EAAE,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,WAAW,CAAC;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,KAAK,IAAI,CAAC;AAEX,UAAU,cAAc;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,mCAA0C,CAAC"}

package/dist/support/request-context.js

@@ -0,0 +1,7 @@
+import { AsyncLocalStorage } from "async_hooks";
+/**
+ * AsyncLocalStorage for propagating request-scoped context through the protocol layer.
+ * The host application is responsible for calling `requestContext.run()` to set the context.
+ */
+export const requestContext = new AsyncLocalStorage();
+//# sourceMappingURL=request-context.js.map

package/dist/support/request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../../src/support/request-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAehD;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,iBAAiB,EAAkB,CAAC"}

package/dist/tools/contact.tools.d.ts

@@ -0,0 +1,7 @@
+import type { DefineTool, ToolDeps } from './tool.helpers.js';
+/**
+ * Creates contact management tools for the chat agent.
+ * Enables importing, listing, and managing the user's network.
+ */
+export declare function createContactTools(defineTool: DefineTool, deps: ToolDeps): any[];
+//# sourceMappingURL=contact.tools.d.ts.map

package/dist/tools/contact.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contact.tools.d.ts","sourceRoot":"","sources":["../../src/tools/contact.tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG9D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,SAkHxE"}