@indexnetwork/protocol 14.3.2-rc.477.1 → 17.0.0-rc.479.1

package/dist/contacts/ports/contact.repository.port.d.ts

@@ -4,25 +4,18 @@
  * Injected boundary for contact management persistence. Implemented by
  * the host application and passed into the protocol layer at the composition root.
  *
- * Retains participant reachability semantics: importContacts, listContacts,
- * addContact, removeContact, and searchContacts scope all operations to the
- * owning user's personal network.
- *
- * IND-549: extracted from shared/interfaces/contact.interface.ts into the
- * contacts capability's dedicated ports layer.
+ * Retains participant reachability semantics: listContacts, removeContact,
+ * and searchContacts scope all operations to the owning user's personal
+ * network. Contact rows are created by the opportunity accept / start-chat
+ * flow, not through this port.
  */
-import type { ContactInput, ContactResult, ContactImportResult, ContactEntry, ContactSearchResult } from "../domain/index.js";
+import type { ContactEntry, ContactSearchResult } from "../domain/index.js";
 /**
  * Contact management operations used by chat tools.
  * Consumers must provide a concrete implementation (e.g. backed by ContactService).
  */
 export interface ContactServiceAdapter {
-    importContacts(ownerId: string, contacts: ContactInput[]): Promise<ContactImportResult>;
     listContacts(ownerId: string): Promise<ContactEntry[]>;
-    addContact(ownerId: string, email: string, options?: {
-        name?: string;
-        restore?: boolean;
-    }): Promise<ContactResult>;
     removeContact(ownerId: string, contactUserId: string): Promise<void>;
     searchContacts(ownerId: string, q: string, limit?: number): Promise<ContactSearchResult[]>;
 }

package/dist/contacts/ports/contact.repository.port.js

@@ -4,11 +4,9 @@
  * Injected boundary for contact management persistence. Implemented by
  * the host application and passed into the protocol layer at the composition root.
  *
- * Retains participant reachability semantics: importContacts, listContacts,
- * addContact, removeContact, and searchContacts scope all operations to the
- * owning user's personal network.
- *
- * IND-549: extracted from shared/interfaces/contact.interface.ts into the
- * contacts capability's dedicated ports layer.
+ * Retains participant reachability semantics: listContacts, removeContact,
+ * and searchContacts scope all operations to the owning user's personal
+ * network. Contact rows are created by the opportunity accept / start-chat
+ * flow, not through this port.
  */
 export {};

package/dist/contacts/ports/contact.tools.port.d.ts

@@ -2,8 +2,7 @@
  * contacts/ports — ContactToolDeps tool host port.
  *
  * Narrow port type consumed by createContactTools. The host provides a
- * ContactServiceAdapter and an optional contactsEnabled flag that gates
- * write-path tools (import_contacts, add_contact).
+ * ContactServiceAdapter.
  *
  * NOTE: This type is intentionally defined inline rather than derived from
  * ToolRegistryCompositionDeps, keeping the capability port independent from
@@ -19,5 +18,4 @@ import type { ContactServiceAdapter } from "./contact.repository.port.js";
 /** Host capabilities consumed by contact tools. */
 export type ContactToolDeps = {
     contactService: ContactServiceAdapter;
-    contactsEnabled?: boolean;
 };

package/dist/contacts/ports/contact.tools.port.js

@@ -2,8 +2,7 @@
  * contacts/ports — ContactToolDeps tool host port.
  *
  * Narrow port type consumed by createContactTools. The host provides a
- * ContactServiceAdapter and an optional contactsEnabled flag that gates
- * write-path tools (import_contacts, add_contact).
+ * ContactServiceAdapter.
  *
  * NOTE: This type is intentionally defined inline rather than derived from
  * ToolRegistryCompositionDeps, keeping the capability port independent from

package/dist/contacts/ports/index.d.ts

@@ -8,7 +8,7 @@
  * ## Port groups
  *
  * ### Persistence port
- * - ContactServiceAdapter — contact CRUD: import, list, add, remove, search.
+ * - ContactServiceAdapter — contact reads and removal: list, remove, search.
  *
  * ### Tool host port
  * - ContactToolDeps — host capabilities for contact management tools.

package/dist/contacts/ports/index.js

@@ -8,7 +8,7 @@
  * ## Port groups
  *
  * ### Persistence port
- * - ContactServiceAdapter — contact CRUD: import, list, add, remove, search.
+ * - ContactServiceAdapter — contact reads and removal: list, remove, search.
  *
  * ### Tool host port
  * - ContactToolDeps — host capabilities for contact management tools.

package/dist/discovery/hyde.frame.d.ts

@@ -78,11 +78,11 @@ export declare const HydeSourceFrameSchema: z.ZodObject<{
         evidence: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         name: string;
-        type: "location" | "organization" | "other" | "person" | "product" | "event";
+        type: "location" | "event" | "organization" | "other" | "person" | "product";
         evidence: string;
     }, {
         name: string;
-        type: "location" | "organization" | "other" | "person" | "product" | "event";
+        type: "location" | "event" | "organization" | "other" | "person" | "product";
         evidence: string;
     }>, "many">;
     domainVocabulary: z.ZodArray<z.ZodObject<{
@@ -111,7 +111,7 @@ export declare const HydeSourceFrameSchema: z.ZodObject<{
     }[];
     namedEntities: {
         name: string;
-        type: "location" | "organization" | "other" | "person" | "product" | "event";
+        type: "location" | "event" | "organization" | "other" | "person" | "product";
         evidence: string;
     }[];
     domainVocabulary: {
@@ -134,7 +134,7 @@ export declare const HydeSourceFrameSchema: z.ZodObject<{
     }[];
     namedEntities: {
         name: string;
-        type: "location" | "organization" | "other" | "person" | "product" | "event";
+        type: "location" | "event" | "organization" | "other" | "person" | "product";
         evidence: string;
     }[];
     domainVocabulary: {

package/dist/discovery/hyde.graph.d.ts

@@ -5,7 +5,7 @@ import type { EmbeddingGenerator } from '../shared/interfaces/embedder.interface
 import { type HydeGenerationMode } from './hyde.env.js';
 import { type HydeSourceFrame } from './hyde.frame.js';
 import type { HydeGenerateInput, HydeGeneratorOutput } from './hyde.generator.js';
-import { type HydeDocumentState } from './hyde.state.js';
+import { HydeGraphState, type HydeDocumentState } from './hyde.state.js';
 import type { LensInferenceInput, LensInferenceOutput } from './lens.inferrer.js';
 import { type HydeValidationInput, type HydeValidationOutput } from './hyde.validator.js';
 /** Narrow lens inferrer contract accepted by the graph. */
@@ -25,18 +25,29 @@ export interface HydeGraphOptions {
     mode?: HydeGenerationMode;
     validator?: HydeValidatorLike;
 }
+/** The graph's channel state, as every node sees it. */
+export type HydeState = typeof HydeGraphState.State;
+/** Everything the HyDE nodes reach for. */
+export interface HydeGraphDeps {
+    database: HydeGraphDatabase;
+    embedder: EmbeddingGenerator;
+    cache: HydeCache;
+    inferrer: HydeLensInferrerLike;
+    generator: HydeGeneratorLike;
+    options: HydeGraphOptions;
+    /** Resolved generation mode; decides whether the validate stage runs. */
+    mode: HydeGenerationMode;
+    /** Present only in frame-generation mode. */
+    validator?: HydeValidatorLike;
+}
 /** Factory for the HyDE generation graph. Existing five-argument calls remain valid. */
 export declare class HydeGraphFactory {
-    private database;
-    private embedder;
-    private cache;
-    private inferrer;
-    private generator;
-    private options;
+    /** Resolved dependency bag shared by every node. */
+    readonly deps: HydeGraphDeps;
     constructor(database: HydeGraphDatabase, embedder: EmbeddingGenerator, cache: HydeCache, inferrer: HydeLensInferrerLike, generator: HydeGeneratorLike, options?: HydeGraphOptions);
     createGraph(): import("@langchain/langgraph").CompiledStateGraph<{
         sourceType: "intent" | "context" | "query";
-        sourceId: import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined;
+        sourceId: import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | undefined;
         sourceText: string;
         profileContext: string | undefined;
         maxLenses: number;
@@ -52,7 +63,7 @@ export declare class HydeGraphFactory {
         agentTimings: DebugMetaAgent[];
     }, {
         sourceType?: "intent" | "context" | "query" | undefined;
-        sourceId?: import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined> | undefined;
+        sourceId?: import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | undefined> | undefined;
         sourceText?: string | undefined;
         profileContext?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         maxLenses?: number | import("@langchain/langgraph").OverwriteValue<number> | undefined;
@@ -66,13 +77,13 @@ export declare class HydeGraphFactory {
         hydeEmbeddings?: Record<string, number[]> | import("@langchain/langgraph").OverwriteValue<Record<string, number[]>> | undefined;
         error?: string | import("@langchain/langgraph").OverwriteValue<string | undefined> | undefined;
         agentTimings?: DebugMetaAgent[] | import("@langchain/langgraph").OverwriteValue<DebugMetaAgent[]> | undefined;
-    }, "__start__" | "infer_lenses" | "check_cache" | "generate_missing" | "embed" | "cache_results", {
+    }, "__start__" | "embed" | "infer_lenses" | "check_cache" | "generate_missing" | "cache_results", {
         sourceType: {
             (annotation: import("@langchain/langgraph").SingleReducer<"intent" | "context" | "query", "intent" | "context" | "query">): import("@langchain/langgraph").BaseChannel<"intent" | "context" | "query", "intent" | "context" | "query" | import("@langchain/langgraph").OverwriteValue<"intent" | "context" | "query">, unknown>;
             (): import("@langchain/langgraph").LastValue<"intent" | "context" | "query">;
             Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
         };
-        sourceId: import("@langchain/langgraph").BaseChannel<import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined, import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined> | undefined, unknown>;
+        sourceId: import("@langchain/langgraph").BaseChannel<import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | undefined, import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | undefined> | undefined, unknown>;
         sourceText: {
             (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
             (): import("@langchain/langgraph").LastValue<string>;
@@ -96,7 +107,7 @@ export declare class HydeGraphFactory {
             (): import("@langchain/langgraph").LastValue<"intent" | "context" | "query">;
             Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
         };
-        sourceId: import("@langchain/langgraph").BaseChannel<import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined, import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../shared/interfaces/database.interface.js").Id<"users"> | import("../shared/interfaces/database.interface.js").Id<"intents"> | undefined> | undefined, unknown>;
+        sourceId: import("@langchain/langgraph").BaseChannel<import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | undefined, import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | import("@langchain/langgraph").OverwriteValue<import("../shared/interfaces/database.entities.js").Id<"users"> | import("../shared/interfaces/database.entities.js").Id<"intents"> | undefined> | undefined, unknown>;
         sourceText: {
             (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BaseChannel<string, string | import("@langchain/langgraph").OverwriteValue<string>, unknown>;
             (): import("@langchain/langgraph").LastValue<string>;
@@ -148,3 +159,51 @@ export declare class HydeGraphFactory {
         cache_results: {};
     }, unknown, unknown, []>;
 }
+/** Node 1: Infer lenses from source text + optional profile context. */
+export declare function inferLensesNode(state: HydeState, deps: HydeGraphDeps): Promise<{
+    lenses: import("./lens.inferrer.js").Lens[];
+    sourceFrame: HydeSourceFrame;
+    frameFingerprint: string;
+    sourceTextHash: string;
+    generatedAt: string;
+    agentTimings: DebugMetaAgent[];
+} | {
+    lenses: import("./lens.inferrer.js").Lens[];
+    agentTimings: DebugMetaAgent[];
+    sourceFrame?: undefined;
+    frameFingerprint?: undefined;
+    sourceTextHash?: undefined;
+    generatedAt?: undefined;
+}>;
+/** Node 2: Check the mode-isolated cache/DB for matching documents. */
+export declare function checkCacheNode(state: HydeState, deps: HydeGraphDeps): Promise<{
+    hydeDocuments: {
+        [k: string]: HydeDocumentState;
+    };
+}>;
+/** Node 3: Generate all missing documents and return a complete snapshot. */
+export declare function generateMissingNode(state: HydeState, deps: HydeGraphDeps): Promise<{
+    hydeDocuments: {
+        [x: string]: HydeDocumentState;
+    };
+    agentTimings: DebugMetaAgent[];
+}>;
+/** Frame-v1 only: validate newly generated docs in one batch. */
+export declare function validateGeneratedNode(state: HydeState, deps: HydeGraphDeps): Promise<{
+    hydeDocuments: Record<string, HydeDocumentState>;
+    agentTimings?: undefined;
+} | {
+    hydeDocuments: {
+        [x: string]: HydeDocumentState;
+    };
+    agentTimings: DebugMetaAgent[];
+}>;
+/** Embed all accepted/cached documents that do not have embeddings. */
+export declare function embedNode(state: HydeState, deps: HydeGraphDeps): Promise<{
+    hydeDocuments: Record<string, HydeDocumentState>;
+    hydeEmbeddings: Record<string, number[]>;
+}>;
+/** Cache/persist only legacy docs or successfully validated frame-v1 docs. */
+export declare function cacheResultsNode(state: HydeState, deps: HydeGraphDeps): Promise<{}>;
+/** After the cache check: generate the missing documents, or skip straight to embedding. */
+export declare function shouldGenerate(state: HydeState): string;